You need to enable JavaScript to run this app.
Elastic Compute Service

Elastic Compute Service

Copy page
Download PDF
API Reference
API release notes
Copy page
Download PDF
API release notes
This topic describes OpenAPI updates for ECS.​
tip​
For more historical updates, see Historical change records.​
September 2026​
​
API​
Change record​
Associated feature​
Release regions​
Added response parameter:​
  • Added the VrdmaCrossS2BandwidthMbps parameter to the Network structure​
Instance​
All​
Added request parameter: LifecycleStatus.N​
Image​
​
​
August 2026​
​
API​
Change record​
Associated feature​
Release regions​
Added new error code: OperationDenied.EnableJumboFrameForceDisabled.​
Instance​
All​
Added response parameter: The LifecycleStatus parameter is added to the Image structure.​
Image​
​
​
July 2026​
​
API​
Change record​
Associated feature​
Release regions​
Added request parameter:​
  • CpuOptions.TopologyType​
  • EnablePrimaryInterfaceHighBandwidthType​
Instance​
All​
Added request parameter: CpuOptions.TopologyType.​
​
​
Added response parameter: The TopologyType parameter is added to the CpuOptionsRes structure.​
​
​
Added response parameter: The MarketplacelmageBillType parameter is added to the Image structure.​
Image​
​
​
May 2026​
​
API​
Change record​
Associated feature​
Release regions​
Modified error messages for the error codes:​
  • InvalidEipAddressChargeType.Malformed​
  • InvalidHttpTokens.Malformed​
  • InvalidImageForConfidentialComputing.UnSupported​
  • InvalidInstanceTypeForConfidentialComputing.NotSupported​
  • LimitExceeded.MaximumEipBandwidth​
  • LimitExceeded.MinimumEipBandwidth​
  • QuotaExceeded.MaximumEipAddresses​
  • InvalidNetworkInterfacesVpc.Conflict​
  • InvalidAffinityGroupSize.CountMismatch​
  • InvalidAffinityGroupSize.DeploymentSetIdMismatch​
  • InvalidAffinityGroupSize.MinCountMismatch​
  • InvalidSecurityProtectionInstance.SpecMismatch​
Instance​
All​
Modified descriptions for the error codes:​
  • InvalidEipAddressChargeType.Malformed​
  • LimitExceeded.MaximumEipBandwidth​
  • LimitExceeded.MinimumEipBandwidth​
  • InvalidNetworkInterfacesVpc.Conflict​
  • InvalidSecurityProtectionInstance.SpecMismatch​
​
​
Modified descriptions for the error codes:​
  • InvalidStoppedMode.ChargeTypeMismatch​
  • InvalidStoppedMode.InstanceTypeMismatch​
​
​
Modified descriptions for the error codes:​
  • InvalidStoppedMode.ChargeTypeMismatch​
  • InvalidStoppedMode.InstanceTypeMismatch​
​
​
The description of the error code "InvalidInstance.DependenceAnycastEipExit" is modified.​
​
​
The description of the error code "InvalidHttpTokens.Malformed" is modified.​
​
​
Modified descriptions for the error codes:​
  • InvalidSnapshotIdOrSnapshotGroupIdForCreateImage.UnSupported​
  • LimitExceeded.MaximumSystemVolumeSize​
Image​
​
The description of the error code "LimitExceeded.MaximumImageSize" is modified.​
​
​
The description of the error code "LimitExceeded.MaximumImageSize" is modified.​
​
​
​
​
April 2026​
​
API​
Change record​
Associated feature​
Release regions​
Added error codes: OperationDenied.NotSupportPaypal, OperationDenied.MainAccountNotSupportPaypal.​
Instance​
All​
Added request and response parameters: ScheduledInstanceId.​
​
​
​
February 2026​
January 2026​
​
API​
Change record​
Associated feature​
Release regions​
Added new error code: QuotaExceeded.MaximumVolumes.​
Instance​
All​
Added new error code: InvalidActionOrVersion.​
​
​
The description of the request parameter EnableJumboFrame is changed.​
​
​
​
December 2025​
​
API​
Change record​
Associated feature​
Release regions​
Added new error code: InvalidImageSharePermissionForRemove.UnSupported.​
Image​
All​
The description of the error code "InvalidInstance.RequestForbidden" is modified.​
​
​
Added new error code: InvalidImageStatus.​
​
​
The description of the error code "RequestForbidden" is modified.​
Instance​
​
The description of the error code "InvalidInstance.RequestForbidden" is modified.​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
November 2025​
​
API​
Change record​
Associated feature​
Release regions​
Added new error codes: OperationDenied.AccountCountryAreaInvalid, OperationDenied.AccountDeleted, OperationDenied.AccountTaxNoInvalid, OperationDenied.NotOpeningQualified, OperationDenied.RiskInterception, InvalidChargeTypeForDeletionProtection.Unsupported, InvalidEnableVrdma.JumboFrameMismatch.​
Instance​
All​
Added new error code: InvalidOperation.DeletionProtection.​
​
​
Added batch operation error code: InvalidOperation.DeletionProtection​
​
​
Added new error codes: OperationDenied.AccountCountryAreaInvalid, OperationDenied.AccountDeleted, OperationDenied.AccountTaxNoInvalid, OperationDenied.AccountWeakVerified, OperationDenied.NotOpeningQualified, OperationDenied.RiskInterception, ​
InvalidChargeTypeForDeletionProtection.Unsupported.​
​
​
Added a new error code:​
InvalidChargeTypeForDeletionProtection.Unsupported​
InvalidDisableJumboFrame.VrdmaMismatch.​
​
​
​
September 2025​
​
API​
Change record​
Associated feature​
Release regions​
Added request parameters: ProjectName, Tags.N.Key, and Tags.N.Value.​
HPC cluster​
All​
  • Added request parameters: ProjectName, TagFilters.N.Key, and TagFilters.N.Values.N.​
  • Added response parameters: ProjectName and Tags.​
​
​
Added new error code: LimitExceeded.TaskConcurrent.​
Image​
​
Added response parameter: RdmaNetworkInterfaceDetails.​
Instance​
China (Beijing)​
Added new APIs.​
Monitoring​
All​
Added new APIs.​
​
​
​
August 2025​
​
API​
Change record​
Associated feature​
Release regions​
Added new APIs.​
Instance​
All​
The request parameter "NetworkOptions.EnableJumboFrame" is added.​
​
​
The response parameter "IsSupportJumboFrame" is added.​
​
​
The response parameter "EnableJumboFrame" is added.​
​
​
  • The request parameter "EnableJumboFrame" is added.​
  • The error code "InvaliDescribeInstancesdEnableJumboFrameForModifyInstanceAttribute.Unsupported" is added.​
​
​
Added response parameters: Volumes.N.ExtraPerformanceTypeId, Volumes.N.ExtraPerformanceIOPS, Volumes.N.ExtraPerformanceThroughputMB, and Volumes.N.SnapshotId. All parameters are optional.​
Instance launch template​
All​
Added response parameters: Volumes.N.ExtraPerformanceTypeId, Volumes.N.ExtraPerformanceIOPS, and Volumes.N.ExtraPerformanceThroughputMB. All parameters are optional.​
​
​
​
​
​
​
July 2025​
​
API​
Change record​
Associated feature​
Release regions​
  • Added request parameter: HttpTokens.​
  • The description of the request parameter "CpuMaxFrequency" is modified.​
  • Added new error codes: InvalidHttpTokens.Malformed, InvalidHttpTokensForImage.Unsupported, QuotaExceeded.MaximumEipInterfaceLimit, InvalidExtraPerformanceValue.Malformed, InvalidVolumeKindForExtraPerformance.Unsupported, LimitExceeded.ExtraPerformance, and InvalidVolumeStatus.​
Instance​
All​
A new interface (Beta).​
​
​
Added response parameter: MetadataOptions.HttpTokens.​
​
​
Added request parameter: HttpTokens.​
​
​
Added new APIs.​
​
​
Added new error code: InvalidConfiguration.Unsupported.​
​
​
The description of the response parameter "Status" is modified.​
​
​
Added new APIs.​
Image​
​
Added response parameter: The ProductCode parameter is added to the Images structure, which indicates the product code of the marketplace image.​
​
​
Added request parameters: Tags.N.Key and Tags.N.Value, which indicate the tag key and value of the target image.​
​
​
Added new APIs.​
HPC cluster​
​
​
June 2025​
​
API​
Change record​
Associated feature​
Release regions​
Added request parameter: DeletionProtection.​
Instance​
All​
Added request parameter: DeletionProtection.​
​
​
Added response parameters: DeletionProtection and VolumeId.​
​
​
Added response parameter: HpcClusterId.​
​
​
Added request parameter: DeletionProtection.​
​
​
Added new error code: LimitExceeded.ExportImageOneday.​
Image​
​
​
April 2025​
​
API​
Change record​
Associated feature​
Release regions​
  • The request parameter "AffinityGroupSize" (optional, Beta) is added.​
  • The value range of the request parameter "DeploymentSetGroupNumber" is updated.​
  • Added new error codes: InvalidInstanceTypeForAffinityGroupSize.Unsupported, InvalidInstanceTypeForNonAffinityGroup.Unsupported, InvalidSecurityGroupStatus, QuotaExceeded.MaximumEipAddresses, InvalidAffinityGroupSize.CountMismatch, InvalidAffinityGroupSize.DeploymentSetIdMismatch, InvalidAffinityGroupSize.MinCountMismatch, and InvalidInstanceChargeType.AffinityGroupSizeMismatch.​
  • The description of the error code "OperationDenied.TrafficModeNotAuthorized" is updated.​
Instance​
All​
Added new error code: InvalidSecurityGroupStatus.​
​
​
Added new error code: OperationDenied.AffinityGroupInstance.​
​
​
​
Added new error code: InvalidStoppedModeForAffinityGroupInstance.Unsupported.​
​
​
Updated response parameter: "InvalidStoppedModeForAffinityGroupInstance.Unsupported" is added to the Error structure.​
​
​
  • Added request parameter (optional): AffinityGroupIds.N. Updated request parameter: DeploymentSetGroupNumbers.​
  • The response parameter "AffinityGroupId" is added.​
  • The error code "LimitExceeded.MaximumAffinityGroupIds" is added.​
​
​
Added response parameters: AffinityGroupSizes and IsSupportAffinityGroup. RdmaProductName is added to the RDMA structure.​
​
​
Added new error codes: InvalidAffinityGroupInstanceForModifyInstanceChargeType.Unsupported, and OperationDenied.AffinityGroupInstance.​
​
​
Added new error code: InvalidAffinityGroupInstanceForModifyInstanceSpec.Unsupported.​
​
​
Added request parameter:​
ImportDataVolumes.N.DataVolumeUrl, optional.​
Added a new error code:​
400, LimitExceeded.MaximumImportDataVolumes.​
Image​
​
The values of GroupCount and Granularity are updated.​
Deployment set​
​
The Granularity description is updated.​
​
​
The value range of DeploymentSetGroupNumber is updated.​
​
​
The request parameter "AccountId" is deleted.​
HPC cluster​
​
Added request parameters (both optional): LaunchTemplateTags.N.Key and LaunchTemplateTags.N.Value.​
Launch template​
​
Added response parameter: LaunchTemplateTags.​
​
​
​
February 2025​
​
API​
Change record​
Associated feature​
Release regions​
  • Added request parameter (optional, Beta): CpuMaxFrequency.​
  • Added new error codes: InvalidNetworkInterfaceType, InvalidSubnetStatus, LimitExceeded.MaximumHighPerformanceNetworkInterfaces, and OperationDenied.TrafficModeNotAuthorized.​
Instance​
All​
Added response parameter: SecurityGroupIds.​
​
​
Added new error code: LimitExceeded.MaximumHighPerformanceNetworkInterfaces.​
​
​
  • Added request parameter (optional): MinCount and CpuMaxFrequency (Beta).​
  • Added new error code: InvalidMinCount.Malformed.​
​
​
  • Added request parameters: EffectiveAt, RscAutoRenew, RscAutoRenewPeriod, ReservedStorageCapacityName, ReservedCapacity, and VolumeType.​
  • Added response parameter: ReservedStorageCapacityId.​
  • Added new error codes: InvalidReservedStorageCapacityName.Malformed, InvalidVolumeType.Malformed, LimitExceeded.ReservedCapacitySize, and OperationDenied.ReservedStorageCapacityNotAvailable.​
​
​
  • Modified request parameter: ResourceIds.N is optional.​
  • Added new error code: MissingParameter.ResourceType.​
Tag​
​
Added request parameter: Eip.ReleaseWithInstance. Optional.​
Instance launch template​
​
New response parameter: Eip.ReleaseWithInstance.​
​
​
  • Added enumeration values of the request parameter "EventTypes.N": InstanceFileSystemFailure.StopAndRepair:Succeeded, InstanceFileSystemFailure.StopAndRepair:Failed, ElasticScheduledInstance.Create, MemoryRiskDetected:Succeeded, DiskError.ReplaceDisk:Succeeded, SystemFailure.Redeploy:Failed, SystemMaintenance.Redeploy:Failed​
  • Naming optimizations of the following enumeration values for the request parameter "EventTypes.N": DiskError.Redeploy, SystemFailure.Redeploy, SystemMaintenance.Redeploy, InstanceFailure​
Event monitoring​
​
  • Added enumeration values of the request parameter "Types.N": InstanceFileSystemFailure_StopAndRepair, ElasticScheduledInstance, MemoryRiskDetected, SystemFailure_Repair, SystemMaintenance_StopAndRepair​
  • Naming optimizations of the following enumeration values for the request parameter "Types.N": SystemFailure, DiskError_Redeploy, SystemMaintenance, InstanceFailure​
​
​
Added new APIs.​
HPC cluster​
​
​
December 2024​
​
API​
Change record​
Associated feature​
Added request parameter (optional): LaunchTemplateProjectName.​
Launch template​
  • Added request parameter (optional): LaunchTemplateProjectName.​
  • Added response parameter: LaunchTemplateProjectName.​
​
Added new APIs.​
Tag​
​
November 2024​
​
API​
Change record​
Associated feature​
Added request parameter:​
ImageReleaseVersion (optional), which indicates the specific version of the public image to be used.​
Instance​
The request parameter InstanceTypeIds.N is modified, with the length limit of N increased from 10 to 100.​
​
The response parameter ReleaseStatus is added, which indicates the release reservation status of the Elastic Scheduled Instances (ESI).​
​
Modified request parameter: ResourceType supports the new value keypair.​
Tag​
  • Added request parameters (optional): Tags.N.Key and Tags.N.Value, which indicate the tag key and tag value associated with the key pair.​
  • Added new error codes: InvalidTagKey.Malformed, InvalidTagValue.Malformed, LimitExceeded.MaximumTags, and InvalidTagKey.Conflict.​
Key pair​
  • Added request parameters (optional): TagFilters.N.Key and TagFilters.N.Value, which are used to search for resources based on tag keys and tag values.​
  • Added response parameters: Key and Value are added to the Tag structure.​
  • Added new error codes: InvalidTagFilterKey.Malformed, InvalidTagFilterValue.Malformed, LimitExceeded.MaximumTagFilterKeys, LimitExceeded.MaximumTagFilterResults, LimitExceeded.MaximumTagFilterValues, and InvalidTagFilterKey.Conflict.​
​
  • Added request parameter:​
  • ImageReleaseVersion (optional), which indicates the specific version of the public image to be used.​
  • Added new error code: LimitExceeded.MaximumVolumes.​
Image​
Added request parameter (optional): TagFilters.N.Values.N.​
Cloud assistant​
​
​
All currently existing error codes are added.​
​
​
October 2024​
​
API​
Change record​
Associated feature​
  • Added request parameter (Beta, optional): NetworkInterfaces.N.Ipv6AddressCount, which indicates the number of IPv6 addresses assigned to the primary network interface.​
  • Added new error codes: InvalidIpv6AddressCount.Malformed and InvalidSubnet.DisableIPv6.​
Instance​
Added response parameter: Ipv6Addresses is added to the NetworkInterfaces structure. The response parameter "Ipv6Addresses" indicates the IPv6 address assigned to the network interface.​
​
​
September 2024​
​
API​
Change record​
Associated feature​
The description of the StoppedMode parameter is modified.​
Instance​
The description of the Password parameter is modified.​
​
  • The request parameter Ipv6Addresses.N (optional) is added, which indicates the instance IPv6 address.​
  • Added new error codes: LimitExceeded.MaximumIpv6Addresses and InvalidActionOrVersion.​
​
  • Added request parameters (optional): Volumes.N.ExtraPerformanceIOPS, Volumes.N.ExtraPerformanceThroughputMB, and Volumes.N.ExtraPerformanceTypeId. They indicate the extra performance of the volume.​
  • Added new error codes:​
  • IPv6-related: InvalidIPv6OnlySubnet.Unsupported, InvalidSubnetImage.Mismatch, InvalidIpv6OnlyNetworkInterfaceAndIpv4NetworkInterface.Mismatch.​
  • Quota and authentication-related: QuotaExceeded.MaximumGeneralCpus, QuotaExceeded.MaximumGpuBasicNums, QuotaExceeded.MaximumHighPerformanceGpus, QuotaExceeded.MaximumLocalVolumeCpus, QuotaExceeded.MaximumReservedInstanceGeneralCpus, QuotaExceeded.MaximumReservedInstanceGpuBasicNums, QuotaExceeded.MaximumReservedInstanceHighPerformanceGpus, QuotaExceeded.MaximumReservedInstanceLocalVolumeCpus, NotPaymentQualified.​
  • Extra performance-related: InvalidExtraPerformanceTypeId.Malformed, InvalidSystemVolumeForExtraPerformance.Unsupported, InvalidVolumeSizeForExtraPerformance.Unsupported, InvalidVolumeTypeForExtraPerformance.Unsupported, LimitExceeded.ExtraPerformanceThroughput, LimitExceeded.MaximumExtraPerformanceIOPS, LimitExceeded.MaximumExtraPerformanceThroughputMB, LimitExceeded.MinimumExtraPerformanceIOPS, LimitExceeded.MinimumExtraPerformanceThroughputMB.​
​
Added new error codes: OperationDenied.InstanceIsSnapshotRollback and InvalidActionOrVersion.​
​
Added new error code: InvalidActionOrVersion.​
​
Added new error codes: QuotaExceeded.MaximumGeneralCpus, QuotaExceeded.MaximumGpuBasicNums, QuotaExceeded.MaximumHighPerformanceGpus, QuotaExceeded.MaximumLocalVolumeCpus, QuotaExceeded.MaximumReservedInstanceGeneralCpus, QuotaExceeded.MaximumReservedInstanceGpuBasicNums, QuotaExceeded.MaximumReservedInstanceHighPerformanceGpus, QuotaExceeded.MaximumReservedInstanceLocalVolumeCpus, and DryRunOperation.​
​
Added new error codes: QuotaExceeded.MaximumGeneralCpus, QuotaExceeded.MaximumGpuBasicNums, QuotaExceeded.MaximumHighPerformanceGpus, QuotaExceeded.MaximumLocalVolumeCpus, QuotaExceeded.MaximumReservedInstanceGeneralCpus, QuotaExceeded.MaximumReservedInstanceGpuBasicNums, QuotaExceeded.MaximumReservedInstanceHighPerformanceGpus, and QuotaExceeded.MaximumReservedInstanceLocalVolumeCpus.​
​
  • Added request parameters (optional): Volumes.N.ExtraPerformanceIOPS, Volumes.N.ExtraPerformanceThroughputMB, and Volumes.N.ExtraPerformanceTypeId. They indicate the extra performance of the volume.​
  • Added new error codes:​
  • Quota-related: QuotaExceeded.MaximumGeneralCpus, QuotaExceeded.MaximumGpuBasicNums, QuotaExceeded.MaximumHighPerformanceGpus, QuotaExceeded.MaximumLocalVolumeCpus, QuotaExceeded.MaximumReservedInstanceGeneralCpus, QuotaExceeded.MaximumReservedInstanceGpuBasicNums, QuotaExceeded.MaximumReservedInstanceHighPerformanceGpus, and QuotaExceeded.MaximumReservedInstanceLocalVolumeCpus.​
  • Extra performance-related: InvalidExtraPerformanceTypeId.Malformed, InvalidSystemVolumeForExtraPerformance.Unsupported, InvalidVolumeSizeForExtraPerformance.Unsupported, InvalidVolumeTypeForExtraPerformance.Unsupported, LimitExceeded.ExtraPerformanceThroughput, LimitExceeded.MaximumExtraPerformanceIOPS, LimitExceeded.MaximumExtraPerformanceThroughputMB, LimitExceeded.MinimumExtraPerformanceIOPS, and LimitExceeded.MinimumExtraPerformanceThroughputMB.​
​
  • Added request parameter (optional): Description, which indicates RI descriptions.​
  • Added new error codes: QuotaExceeded.MaximumGeneralCpus, QuotaExceeded.MaximumGpuBasicNums, QuotaExceeded.MaximumHighPerformanceGpus, QuotaExceeded.MaximumLocalVolumeCpus, QuotaExceeded.MaximumReservedInstanceGeneralCpus, QuotaExceeded.MaximumReservedInstanceGpuBasicNums, QuotaExceeded.MaximumReservedInstanceHighPerformanceGpus, QuotaExceeded.MaximumReservedInstanceLocalVolumeCpus, and InvalidInstanceDescription.Malformed.​
​
Added response parameter: Description, which indicates the RI description.​
​
Added new error code: 412 (OperationDenied.SnapshotServiceUnavailable)​
Image​
Added new error code: 400 (LimitExceeded.MaximumSnapshotCount)​
​
Added new error code: 412 (OperationDenied.SnapshotServiceUnavailable)​
​
The following response parameters are added to the "DescribeImageNextTokenResponse.Images" structure:​
  • IsInstallRunCommandAgent, which indicates whether the cloud assistant Agent is installed in the public image.​
  • Kernel, which indicates the image kernel version.​
​
​
August 2024​
​
API​
Release time​
Change record​
Associated feature​
August 2024​
Added new APIs.​
Instance launch template​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
July 2024​
​
API​
Release time​
Change record​
Associated feature​
2024-07-30​
Added new error codes: LimitExceeded.MaximumSecurityProtectionTypes, OperationDenied.PurchaseLimited, and InvalidTenancy.InstanceTypeIdMismatch.​
Instance​
​
Added new error codes: LimitExceeded.MaximumVolumes, OperationDenied.InstanceHasUnfinishedOrder, and OperationDenied.InstanceIsSnapshotRollback.​
​
​
Added new error code: OperationDenied.InstanceIsSnapshotRollback.​
​
​
Added new error codes: Insufficient.Balance, and OperationDenied.SpecifiedSecurityGroupNotAuthorized.​
​
​
Added new error code: InvalidReservedInstance.ProjectMismatch.​
​
​
  • Added new error codes: InvalidImageForCreateScheduledInstance.UnSupported, LimitExceeded.MaximumSecurityProtectionTypes, OperationDenied.ImageNotSnapshot, Insufficient.ScheduledInstanceDeliveryCapacity, and Insufficient.VolumePoolCapacity.​
  • The description of the error code "Insufficient.ScheduledInstanceCapacity" is modified.​
​
​
  • Added request parameter:​
  • ImageId parameter, which can be used to query the instance types that can be created based on the image.​
  • Added a new error code:​
  • InvalidImage.NotFound.​
​
​
Added response parameter:​
The LicenseType parameter is added to the Images structure. The "LicenseType" parameter indicates the image license type.​
Image​
​
  • Added request parameter:​
  • The CreateWholeImage parameter is added, which indicates whether to create the whole image.​
  • Added a new error code:​
  • 400, InvalidVolumeTypeForCreateImage.Unsupported​
​
​
  • Added request parameter:​
  • The LicenseType parameter is added, which indicates the image license type.​
  • Added a new error code:​
  • 400, InvalidImageFormat.Malformed.​
​
​
Added value of request parameter:​
Added value of the request parameter EventTypes.N: SystemFailure.Stop.Succeeded. This indicates that the instance is stopped successfully due to a system failure.​
Event monitoring​
​
Added value of request parameter:​
Added value of the request parameter EventTypes.N: SystemFailure.Stop.Succeeded. This indicates that the instance is stopped successfully due to a system failure.​
​
​
May 2024​
​
API​
Release time​
Change record​
Associated feature​
2024-05-21​
  • Added a new error code:​
  • InvalidBandwidthPackageStatus​
  • QuotaExceeded.BandwidthPackage​
  • RequestForbidden​
  • InvalidISP.BandwidthPackageMismatch​
  • InvalidInstanceTenancy.DeploymentSetIdMismatch​
  • Modified error code: The description of InvalidSnapshotStatus is modified to "The status of the specified snapshot does not support this operation".​
Instance​
​
The error code "InvalidInstance.RequestForbidden" is added.​
​
​
  • Added a new error code:​
  • InvalidBandwidthPackageStatus​
  • QuotaExceeded.BandwidthPackage​
  • RequestForbidden​
  • InvalidISP.BandwidthPackageMismatch​
  • Modified error code: The description of InvalidSnapshotStatus is modified to "The status of the specified snapshot does not support this operation".​
Elastic Scheduled Instances​
​
The error code "InvalidInstanceType.NotFound" is added.​
​
​
  • Added a new error code:​
  • InvalidSnapshotStatus​
Image​
​
  • Added new error code:​
  • InvalidPlatformVersion.Malformed​
​
​
  • Added request parameter:​
  • Platform: Indicates the version of the image operating system.​
​
​
  • Added a new error code:​
  • InvalidInstance.RequestForbidden​
  • InvalidDedicatedHostStatus.Unsupported​
  • InvalidInstanceForReplaceSystemVolume.Unsupported​
  • InvalidSnapshotStatus​
  • InvalidDedicatedHost.Expired​
  • Updated error code:​
  • After being modified, the description of InvalidSnapshotStatus is "The status of the specified snapshot does not support this request".​
​
​
The error code "InvalidDedicatedHostInstanceForModifyInstanceDeploymentSet.Unsupported" is added.​
Deployment set​
May 23, 2024​
  • Added request parameter:​
  • ContentEncoding, which indicates whether the command content is Base64 encoded.​
Cloud assistant​
​
  • Added request parameter:​
  • ContentEncoding, which indicates whether the command content is Base64 encoded.​
​
​
  • Added request parameter:​
  • ContentEncoding, which indicates whether the returned command content is Base64 encoded.​
​
​
  • Added request parameter:​
  • ContentEncoding, which indicates whether the returned command content is Base64 encoded.​
​
​
  • Added request parameter:​
  • ContentEncoding, which indicates whether the returned command content is Base64 encoded.​
​
​
March 2024​
​
API​
Release time​
Change record​
Associated feature​
2024-03-22​
  • Added request parameters (optional):​
  • EipAddress.ReleaseWithInstance, which specifies whether the EIP is released together with the instance when the instance is created.​
  • Volumes.N.SnapshotId, which indicates using the snapshot to create the volume. Only data volumes are supported.​
  • EipAddress.SecurityProtectionInstanceId and EipAddress.SecurityProtectionTypes.N. They indicate the security properties of the EIP.​
  • Added a new error code:​
  • InvalidSnapshotStatus​
  • InvalidVolumeTypeForSnapshot.UnSupported​
  • InvalidSnapshot.NotFound​
  • InvalidSnapshotZoneId.Mismatch​
  • InvalidReleaseWithInstance.ChargeTypeMismatch​
  • LimitExceeded.MaximumEipBandwidth​
  • InvalidSecurityProtectionTypes.Malformed​
  • InvalidSecurityProtectionTypes.BandwidthPackageIdMismatch​
  • OperationDenied.SpecifiedSecurityGroupNotAuthorized​
Instance​
​
  • Added request parameter (optional): EipAddresses.N, which indicates that querying the instance by the EIP address is supported.​
  • Added response parameter: IpAddress, which indicates the EIP address associated with the instance.​
  • Added new error codes: LimitExceeded.PrimaryIpAddresses, and LimitExceeded.MaximumEipAddresses.​
​
​
  • Added request parameters (optional):​
  • EipAddress.ReleaseWithInstance, which specifies whether the EIP is released together with the instance when the instance is created.​
  • Volumes.N.SnapshotId, which indicates using the snapshot to create the volume. Only data volumes are supported.​
  • EipAddress.SecurityProtectionInstanceId and EipAddress.SecurityProtectionTypes.N. They indicate the security properties of the EIP.​
  • Added a new error code:​
  • InvalidSnapshotStatus​
  • InvalidVolumeTypeForSnapshot.UnSupported​
  • InvalidSnapshot.NotFound​
  • InvalidSnapshotZoneId.Mismatch​
  • InvalidReleaseWithInstance.ChargeTypeMismatch​
  • LimitExceeded.MaximumEipBandwidth​
  • InvalidSecurityProtectionTypes.Malformed​
  • InvalidSecurityProtectionTypes.BandwidthPackageIdMismatch​
  • OperationDenied.SpecifiedSecurityGroupNotAuthorized​
Elastic Scheduled Instances​
​
  • Added request parameters (optional): ImageId and KeyPairName, which indicate that querying ESIs by image IDs or key pair names is supported.​
  • Added response parameters: ReleaseWithInstance and SecurityProtectionInstanceId. The former parameter indicates whether the EIP is released with the instance, and the latter parameter indicates the ID of the security protection package.​
​
​
A new interface for querying the latest release time of Elastic Scheduled Instances-Segmented (Scheduled delivery).​
​
​
A new interface for initiating the image inspection process.​
Image​
​
  • Added request parameter:​
  • NeedDetection, which indicates whether to detect the image.​
  • SnapshotGroupId, which indicates creating the custom image by using the snapshot or snapshot consistency group.​
  • SnapshotId, which indicates using the system volume snapshot to create a custom image.​
  • Updated request parameters:​
  • The InstanceId parameter is changed to an optional parameter.​
  • The usage limits of Tags.N.Key are increased: the key cannot start with sys: in any combination of uppercase or lowercase letters.​
  • Added a new error code:​
  • 400: InvalidPlatformForDetect.UnSupported. This indicates that the specified image platform does not support detection.​
  • 400: InvalidSnapshotIdOrSnapshotGroupIdForCreateImage.UnSupported. This indicates you can not create a custom image with the specified snapshot or consistency group.​
  • 400: LimitExceeded.MaximumSnapshotGroupTotalSize. This indicates the capacity of the specified snapshot consistency group exceeds the limit.​
  • 404: InvalidSnapshotGroupId.NotFound. This indicates the specified snapshot consistency group ID does not exist.​
  • 404: InvalidSnapshotId.NotFound. This indicates the specified snapshot ID does not exist.​
  • 412: OperationDenied.SnapshotServiceUnavailable. This indicates the specified operation was denied because the snapshot service is not activated.​
​
​
  • Added request parameter:​
  • NeedDetection, which indicates whether to detect the image.​
  • Updated request parameter:​
  • Tags.N.Key argument increases limit, does not support any case of starting with sys:​
  • Added a new error code:​
  • 400: InvalidPlatformForDetect.UnSupported. This indicates that the specified image platform does not support detection.​
​
​
  • Added response parameter:​
  • The following structures are added to the Images structure:​
  • The DetectionResults structure, which indicates the image detection result.​
  • The Snapshots structure, which indicates snapshot information associated with the image.​
​
​
  • Added request parameter:​
  • DeleteBindedSnapshots, which indicates whether to delete the corresponding snapshot or the snapshot consistency group when the image is deleted.​
​
​
January 2024​
​
API​
Release time​
Change record​
Associated feature​
2024-01-12​
Added request parameters (optional): EipAddress.ChargeType, EipAddress.ISP, EipAddress.BandwidthMbps, and EipAddress.BandwidthPackageId. The parameters indicate that when you create an instance, an EIP can be associated with it.​
Instance​
​
Added new error code: InvalidStoppedModeForScheduledInstance.Unsupported.​
​
​
​
​
​
Added new error code: InvalidScheduledInstanceForModifyInstanceSpec.Unsupported.​
​
​
Added new error code: InvalidScheduledInstanceForModifyInstanceChargeType.Unsupported.​
​
​
  • Added request parameter (optional): ScheduledInstanceId, which indicates the ID of the ESI order.​
  • Modified response parameter: "Segmented" is added to ElasticScheduledInstanceType. "Segmented" indicates Elastic Scheduled Instances-Segmented.​
  • Added response parameter: ScheduledInstanceId, which indicates the ID of the ESI order.​
​
​
  • Added request parameter (optional): ElasticScheduledInstanceType, which indicates the ESI type.​
  • Added new error code: InvalidElasticScheduledInstanceType.Malformed.​
​
​
A new interface for creating ESIs.​
Elastic Scheduled Instances​
​
A new interface for querying Elastic Scheduled Instance (ESI) orders.​
​
​
A new interface for canceling reservations.​
​
​
A new interface for fetching the reservation status of ESIs.​
​
​
Modified request parameter: The ResourceType parameter supports the value "scheduledinstance" which indicates ESIs can be managed by tags.​
Tag​
​
​
​
​
​
​
​
Added new error code: InvalidScheduledInstanceForModifyInstanceDeploymentSet.Unsupported.​
Deployment set​
​
Added new error code: Insufficient.VolumePoolCapacity.​
RI​
2024-01-11​
A new interface for upgrading the cloud assistant Agent of ECS instances to the latest version.​
Cloud assistant​
​
A new interface for uninstalling the cloud assistant Agent of ECS instances.​
​
​
Modified request parameter:​
Added enumeration values of the Status parameter:​
  • Lost: heartbeat timeout​
  • ReadyReboot: pending restart​
  • InstallFailed: installation failure​
  • Uninstalling: ongoing uninstallation​
  • Initializing: initialization​
​
​
​
Last updated: 2026.09.17 10:11:01