You need to enable JavaScript to run this app.
导航

2022年

最近更新时间2023.11.20 15:56:52

首次发布时间2023.11.20 15:56:52

本文介绍了云服务器ECS的产品OpenAPI 2022年变更信息。

2022年12月13日

模块
接口名称
变更记录
发布地域

实例

RunInstances

  • 新增错误码:
    • QuotaExceeded.MaximumSecurityGroupIps

    • InvalidVolumeTypes.Mismatch

全部

DescribeInstanceTypes

  • 变更返回数据:
    • Processor结构新增ModelBaseFrequencyTurboFrequency,表示实例规格族的CPU型号、主频和睿频。

    • Network结构新增MaximumBandwidthMbpsMaximumThroughputKpps,表示网络带宽能力和网络收发包能力。

镜像

DescribeImages
CreateImage
ImportImage

  • 新增请求参数:
    • 新增 ProjectName(可选),表示资源所属项目。
  • 新增错误码:
    • InvalidProject.NotFound

DescribeImages

变更返回数据:

  • Images结构新增ProjectName,表示资源所属项目。

监控

DescribeSystemEvents

变更请求参数:

  • Types.N 新增取值RebootInstance,表示实例重启事件。

2022年11月15日

模块
接口名称
变更记录
发布地域

实例

RunInstances

  • 新增请求参数:

    • 新增KeepImageCredential(可选),表示是否使用预设密码/密钥对登录实例。

    • 新增SpotStrategy(可选),表示按量计费的抢占式策略。

  • 新增错误码:

    • InvalidInstanceTypeForCreateSpotInstance.Unsupported

    • InvalidSpotStrategy

    • InvalidSpotStrategy.Malformed

    • InvalidImageId.KeepImageCredentialMismatch

    • InvalidKeyPairName.KeepImageCredentialMismatch

    • InvalidPassword.KeepImageCredentialMismatch

全部

StartInstances
StartInstance
StopInstances
StopInstance

  • 新增错误码:
    • Insufficient.InstanceCapacity

DescribeInstanceTypes
DescribeInstances
DescribeInstancesIamRoles
DeleteInstances
RebootInstances
StartInstances
StopInstances

  • 新增错误码:
    • FlowLimitExceeded

密钥对

DeleteKeyPairs
DescribeKeyPairs

  • 新增错误码:
    • FlowLimitExceeded

地域

DescribeZones

  • 新增错误码:
    • FlowLimitExceeded

镜像

CreateImage

  • 新增错误码:
    • InvalidInstance.NotFound

ReplaceSystemVolume

  • 新增请求参数:
    • 新增KeepImageCredential(可选),表示是否使用预设密码/密钥对登录实例。
  • 新增错误码:
    • InvalidImageId.KeepImageCredentialMismatch
    • InvalidKeyPairName.KeepImageCredentialMismatch
    • InvalidPassword.KeepImageCredentialMismatch
    • InvalidArgument
监控DescribeSystemEvents新增接口,用于查询实例的系统事件信息。
UpdateSystemEvents新增接口,用于修改系统事件状态。

2022年10月25日

模块接口名称变更记录发布地域

实例

RunInstances

  • 变更错误码:
    • 增加QuotaExceeded.MaximumInstanceTypeInstances
    • 更新InvalidTagKey.Malformed、InvalidTagValue.Malformed

全部

DescribeInstances

  • 变更返回数据:
    • Instance结构中新增SpotStrategy参数,表示按量计费的抢占式策略。

标签

CreateTags

  • 变更错误码:
    • InvalidTagKey.Malformed
    • InvalidTagValue.Malformed

DeleteTags

  • 变更错误码:
    • InvalidTagKey.Malformed

云盘

DeleteVolume

  • 变更请求参数:
    • 新增幂等参数ClientToken参数(可选),保证不同请求之间的唯一性。
  • 新增错误码:
    • InternalErr
    • IdempotentTimeout
    • IdempotentParameterMismatch
    • IdempotentProcessing
    • IdempotentInvalidClientToken

2022年09月15日

模块接口名称变更记录发布地域

实例

RunInstances

  • 变更请求参数:
    • 增加Tags.N.Key参数(可选),表示实例的标签键。
    • 增加Tags.N.Value参数(可选),表示实例的标签值。
  • 新增错误码:
    • Insufficient.AclCapacity
    • LimitExceeded.MaximumTags
    • InvalidTagKey.Malformed
    • InvalidTagValue.Malformed
    • 409,InvalidTagKey.Conflict

全部

DescribeInstances

  • 变更请求参数:
    • 增加TagFilters.N.Key参数(可选),表示实例的标签键。
    • 增加TagFilters.N.Values.N参数(可选),表示实例的标签值。
  • 变更返回数据:
    • Instance结构中增加Tags结构,表示实例绑定的标签信息以及CPU配置详情,具体参数如下。
      • 增加Key参数,表示实例的标签键。
      • 增加Value参数,表示实例的标签值。
    • Instance结构中新增CpuOptions结构,表示CPU配置详情。具体参数如下。
      • 增加CoreCount参数,表示CPU物理核心数。
      • 增加ThreadsPerCore参数,表示CPU每核线程数,用于决定CPU是否开启超线程。
  • 新增错误码:
    • LimitExceeded.MaximumTagFilterKeys
    • LimitExceeded.MaximumTagFilterValues
    • InvalidTagFilterKey.Malformed
    • InvalidTagValue.Malformed
    • LimitExceeded.MaximumTagFilterResults
    • InvalidTagFilterKey.Conflict
    • InvalidCpuOptionsCoreCount.Malformed
    • InvalidCpuOptionsThreadsPerCore.Malformed
    • OperationDenied.InstanceIsCreatingImage

StartInstance
StartInstances
StopInstance
StopInstances
RebootInstance
RebootInstances
DeleteInstance
DeleteInstances

  • 新增错误码:
    • OperationDenied.ResourceLocked
    • OperationDenied.ResourceCreatedByOtherService
    • OperationDenied.InstanceIsCreatingImage

ModifyInstanceChargeType

  • 新增错误码:
    • OperationDenied.ResourceLocked
    • OperationDenied.ResourceCreatedByOtherService

ModifyInstanceSpec

  • 新增错误码:
    • OperationDenied.ResourceCreatedByOtherService
    • OperationDenied.InstanceIsCreatingImage

ModifyInstanceAttribute

  • 新增错误码:
    • OperationDenied.ResourceCreatedByOtherService

RenewInstance

  • 新增错误码:
    • OperationDenied.ResourceLocked

DescribeInstanceTypes

  • 变更返回数据:
    • InstanceType结构中新增Network结构,表示实例规格的网络信息,具体参数如下。
      • 增加MaximumNetworkInterfaces参数,表示实例规格支持挂载的网卡数量上限。
      • 增加MaximumPrivateIpv4AddressesPerNetworkInterface参数,表示单网卡的IPv4地址数量上限。
      • 增加MaximumQueuesPerNetworkInterface参数,表示主网卡和辅助网卡支持的最大队列数。
    • MaximumCount参数新增取值4,表示突发性能实例t2支持的云盘数量上限。

DescribeInstanceVncUrl

  • 新增接口说明:
    • 提供生成固定noVNC URL网页客户端链接的操作说明。
  • 错误码变更:
    • InvalidInstanceStatus对应错误信息优化。

DescribeInstanceECSTerminalUrl

  • 错误码变更:
    • InvalidInstanceStatus对应错误信息优化。

DescribeInstancesIamRoles

  • 错误码变更:
    • LimitExceeded.MaximumInstanceIds对应错误信息优化。
镜像CreateImage新增接口,用于通过实例创建自定义镜像。

ImportImage

  • 新增错误码:
    • LimitExceeded.MaximumImageCount

DeleteImages

  • 新增错误码:
    • OperationDenied.ImageIsCopying
    • OperationDenied.ImageIsExporting

ReplaceSystemVolume

  • 错误码变更:
    • InvalidInstanceStatus对应错误信息优化。
  • 新增错误码:
    • OperationDenied.ResourceLocked
    • OperationDenied.InstanceIsCreatingImage
    • OperationDenied.ResourceCreatedByOtherService

DescribeTasks

  • 新增错误码:
    • LimitExceeded.MaximumMaxResults
    • LimitExceeded.MinimumMaxResults

地域

DescribeZones

  • 错误码变更:
    • LimitExceeded.MaximumZoneIds对应错误信息优化。

密钥对

CreateKeyPair
DescribeKeyPairs
DeleteKeyPairs

  • 错误码变更:
    • InvalidKeyPairName.Conflict对应错误信息优化。
    • LimitExceeded.MaximumKeyPairs对应错误信息优化。

ModifyKeyPairAttribute

  • 错误码变更:
    • MissingParameter.Description对应错误信息优化。

AttachKeyPair

  • 错误码变更:
    • InvalidInstanceStatus对应错误信息优化。
    • InvalidResetAuthenticationAgent.NotFound对应错误信息优化。

DetachKeyPair

  • 错误码变更:
    • LimitExceeded.MaximumInstanceIds对应错误信息优化。
标签CreateTags新增接口,为一个或多个资源绑定标签。
DeleteTags新增接口,为一个或多个资源解绑标签。
DescribeTags新增接口,查询一个或多个资源已绑定的标签信息。
云盘ModifyVolumeChargeType新增接口,用于修改云盘计费方式。

2022年08月02日

模块接口名称变更记录
发布地域

实例

RunInstances

  • 变更请求参数:
    新增ProjectName参数(可选),表示资源所属项目。
  • 新增错误码:
    InvalidProject.NotFound
全部

DescribeInstances

  • 变更请求参数/返回数据:
    新增ProjectName参数(可选),表示资源所属项目。
  • 新增错误码:
    InvalidProject.NotFound

云盘

CreateVolume

  • 变更请求参数:
    新增ProjectName参数(可选),表示资源所属项目。
  • 新增错误码:
    InvalidProject.NotFound

DescribeVolumes

  • 变更请求参数/返回数据:
    新增ProjectName参数(可选),表示资源所属项目。

2022年07月12日

模块接口名称变更记录发布地域

实例

RunInstances

  • 变更请求参数:
    • 新增MinCount参数(可选),表示ECS实例最小购买数量。
    • 新增DryRun参数(可选),表示仅检查实例参数是否合法或检查通过后直接创建实例。
    • 新增CreditSpecification参数(可选),表示突发性能实例的运行模式。
    • 优化Description参数的规则描述。
  • 新增错误码:
    • InvalidMinCount.Malformed
    • DryRunOperation
    • InvalidCreditSpecification.Malformed
    • InvalidCreditSpecification.InstanceTypeIdMismatch

全部

DescribeInstances

  • 新增返回数据:
    • Instance结构新增本地盘信息LocalVolumes
    • Instance结构新增EipAddress参数 ,表示实例绑定的公网IP。
  • 变更错误码:
    • LimitExceeded.MaximumInvalidInstanceTypeFamilies修改为LimitExceeded.MaximumInstanceTypeFamilies

DescribeInstanceTypes

  • 新增返回数据:
    • Memory结构新增EncryptedSize参数,表示加密内存大小。
    • 新增BaselineCredit参数:表示突发性能实例的CPU基准性能。
    • 新增InitialCredit参数:表示创建突发性能实例时一次性获得的CPU积分。

ModifyInstanceSpec

  • 新增错误码:
    • LimitExceeded.MaximumNetworkInterfaces

ModifyInstanceAttribute

  • 请求参数变更:
    • 优化Description参数的规则描述。
StartInstances新增接口,用于批量启动实例。
StopInstances新增接口,用于批量停止实例。
RebootInstances新增接口,用于批量重启实例。
DeleteInstances新增接口,用于批量删除实例。
AssociateInstanceIamRole新增接口,用于为实例绑定IAM角色。
DisassociateInstanceIamRole新增接口,用于将IAM角色从实例解绑。
DescribeInstancesIamRoles新增接口, 用于查询实例已经绑定的IAM角色。
DescribeInstanceTypeFamilies新增接口,用于查询实例规格族的信息。
DescribeInstanceECSTerminalUrl新增接口,用于查询 ECS Terminal 管理终端地址。

镜像

DescribeImages

  • 变更请求参数
    • ImageIds.N参数长度限制为100。
    • Status.N参数长度限制10。
  • 变更返回数据:
    • Image结构新增ImageOwnerId参数,表示共享者的账号ID,仅查询共享镜像时返回。
    • Architecture参数新增取值arm64。
  • 新增错误码:
    • LimitExceeded.MaximumImageIds
    • LimitExceeded.MaximumStatus
ImportImage新增接口,用于导入自定义镜像。
ModifyImageSharePermission新增接口,用于修改镜像的共享权限。
DescribeImageSharePermission新增接口,用于查询自定义镜像已经共享的所有用户。
ModifyImageAttribute新增接口,用于更改镜像的描述。
DeleteImages新增接口,用于删除自定义镜像。
DescribeTasks新增接口,用于查询异步请求的进度。
密钥对ImportKeyPair新增接口,用于导入密钥对。
CreateKeyPair新增接口,用于创建密钥对,并生成私钥信息。
DescribeKeyPairs新增接口,用于查询密钥对信息。
DeleteKeyPairs新增接口,用于批量删除密钥对。
ModifyKeyPairAttribute新增接口,用于修改密钥对描述信息。
AttachKeyPair新增接口,用于绑定密钥对到实例。
DetachKeyPair新增接口,用于将密钥对从实例解绑。
地域DescribeZones新增接口,用于查询可用区的ID。

云盘

CreateVolume

  • 变更请求参数:
    • 新增幂等参数ClientToken参数(可选),保证不同请求之间的唯一性。
    • VolumeType参数新增ESSD_FlexPL取值。
  • 新增错误码:
    • ErrorCreateIdempotencyFailed
    • ErrorUpdtaeIdempotencyFailed
    • ErrorIdempotencyStatusFailed
    • ErrorIdempotencyStatusTimeout
    • ErrorInvalidIdempotencyParam
    • ErrorInvalidIdempotencyAccount
    • ErrorInvalidIdempotencyAction
    • ErrorInvalidIdempotencyBusy
    • ErrorLoadIdempotencyFailed

ExtendVolume

  • 变更请求参数:
    • 新增幂等参数ClientToken参数(可选),保证不同请求之间的唯一性。
  • 新增错误码:
    • OtherTradeError

DescribeVolumes

  • 变更请求参数:
    • VolumeType参数新增ESSD_FlexPL取值。

2022年06月10日

模块
接口名称
变更记录
发布地域

实例

RunInstances

  • 错误码变更:
    QuotaExceeded.MaximumNetworkInterfaces对应错误信息优化。

全部

ModifyInstanceSpec

  • 错误码变更:
    QuotaExceeded.MaximumInstanceCpus对应错误信息优化。

DescribeInstances

  • 返回数据变更:
    Instance结构中新增参数Uuid,表示实例全局唯一ID。

DescribeInstanceTypes

  • 返回数据变更:
    Volume结构中新增参数MaximumCount,表示实例挂载云盘的数量上限。

ReplaceSystemVolume

  • 增加使用限制:
    只允许关机状态的实例更换操作系统。
镜像ExportImage新增接口,用于导出自定义镜像。

2022年05月13日

模块
接口名称
变更记录
发布地域
实例全部接口错误码增加中文信息。全部

RunInstances

  • 请求参数变更:
    • 使用InstanceTypeId替换原InstanceType,表示实例规格。
    • 使用Hostname替换原HostName,表示实例的主机名。
    • SecurityEnhancementStrategy取值为Active时,对公共镜像开启安全加固。
    • Volumes.N.Size更新系统盘及数据盘容量取值范围。
  • 错误码变更:
    • 新增错误码PendingVerification、QuotaExceeded.MaximumNetworkInterfaces、QuotaExceeded.MaximumSecurityGroupNetworkInterfaces、QuotaExceeded.MaximumVolumes、QuotaExceeded.MaximumInstances。
    • LimitExceeded.MaximumSystemVolumeSize变更为LimitExceeded.SystemVolumeSize。
    • LimitExceeded.MaximumDataVolumeSize变更为LimitExceeded.DataVolumeSize。
    • 错误码InvalidParameterCombination对应错误信息优化。

StopInstance

  • 请求参数变更:
    • StoppedMode 补充该参数不传或传入空值时,实例停机后继续收费。
    • 新增ForceStop参数(可选),支持实例强制关机。
  • 错误码变更:
    • 新增错误码InvalidArgument。

RebootInstance

  • 请求参数变更:
    新增ForceStop参数(可选),支持实例重启前强制关机。
  • 错误码变更:
    新增错误码InvalidArgument。

ModifyInstanceSpec

  • 请求参数变更:
    使用InstanceTypeId替换原InstanceType,表示修改后实例的规格。
  • 错误码变更:
    新增错误码MissingParameter.InstanceTypeId、OperationDenied.ResourceLocked、InvalidInstance.Expired、InvalidImage.InstanceTypeMismatch。

ModifyInstanceChargeType

  • 错误码变更:
    新增错误码InvalidInstance.Expired。

ModifyInstanceAttribute

  • 错误码变更:
    新增错误码InvalidInstanceStatus、InvalidResetAuthenticationAgent.NotFound。

DescribeInstances

  • 请求参数变更:
    使用InstanceTypeIds.N替换原InstanceTypes.N,表示实例规格。
  • 返回参数变更:
    Instance结构返回Hostname替换原HostName,表示实例主机名。

DescribeAvailableResource

  • 请求参数变更:
    使用InstanceTypeId替换原InstanceType,表示要查询的实例规格。

DescribeInstanceTypes

  • 请求参数变更:
    使用InstanceTypeIds.N替换原InstanceTypes.N,表示要查询的实例规格。

ReplaceSystemVolume

  • 新增错误码:MissingParameter.InstanceId、MissingParameter.VolumeType、InvalidVolumeSize.ImageSizeMismatch、LimitExceeded.SystemVolumeSize。

镜像

DescribeImages

  • 错误码变更:
    • 错误码InvalidOsType.Malformed、InvalidVisibility.Malformed对应错误信息更新。
    • 错误码IInvalidInstanceTypeId.NotFound更新为InvalidInstanceType.NotFound,对应错误信息更新。

2022年04月08日

模块
接口名称
变更记录
发布地域
实例全部接口错误码优化。全部

DescribeInstances

  • 新增返回数据:
    • Instance结构中原Id变更为InstanceId,表示实例的ID。
    • Instance结构中新增OsNameOsType,表示实例镜像操作系统的名称和类型。
    • Instance结构中新增CpusMemorySize,表示CPU的数量和内存的大小。
  • 使用MaxResultsNextToken参数进行分页查询,原PageSizePageNumber分页查询不再使用。

全部

DescribeInstanceTypes

  • 新增返回数据:
    InstanceType结构新增Volume结构,含SupportedVolumeTypes参数,表示支持的云盘类型。
  • 使用MaxResultsNextToken参数进行分页查询,原PageSizePageNumber分页查询不再使用。

全部

ModifyInstanceChargeType请求参数InstanceIds.N,增加N取值最大为20,表示调用一次接口最多支持修改20个实例。全部

DescribeAvailableResource

  • 变更请求参数:
    ZoneId参数描述变更,表示可用区ID。默认为空,表示返回当前地域(RegionId)下的所有可用区中所有符合条件的资源。

全部

镜像

DescribeImages

  • 使用MaxResultsNextToken参数进行分页查询,原PageSizePageNumber分页查询不再使用。
  • 错误码优化。

全部