API发布历史

RunInstances

2024-03-22

• 新增请求参数（可选）：

  • EipAddress.ReleaseWithInstance，表示创建实例时是否选择公网IP随实例释放。

  • Volumes.N.SnapshotId，表示使用快照创建云盘，仅支持创建数据盘。

  • EipAddress.SecurityProtectionInstanceId、EipAddress.SecurityProtectionTypes.N，表示公网IP的安全防护属性。

• 新增错误码：

  • InvalidSnapshotStatus

  • InvalidVolumeTypeForSnapshot.UnSupported

  • InvalidSnapshot.NotFound

  • InvalidSnapshotZoneId.Mismatch

  • InvalidReleaseWithInstance.ChargeTypeMismatch

  • LimitExceeded.MaximumEipBandwidth

  • InvalidSecurityProtectionTypes.Malformed

  • InvalidSecurityProtectionTypes.BandwidthPackageIdMismatch

  • OperationDenied.SpecifiedSecurityGroupNotAuthorized

实例

DescribeInstances

• 新增请求参数（可选）：EipAddresses.N，表示支持按公网IP地址查询实例。
• 新增返回数据：IpAddress，表示实例绑定的公网IP地址。
• 新增错误码：LimitExceeded.PrimaryIpAddresses、LimitExceeded.MaximumEipAddresses。

CreateScheduledInstances

• 新增请求参数（可选）：

  • EipAddress.ReleaseWithInstance，表示创建实例时是否选择公网IP随实例释放。

  • Volumes.N.SnapshotId，表示使用快照创建云盘，仅支持创建数据盘。

  • EipAddress.SecurityProtectionInstanceId、EipAddress.SecurityProtectionTypes.N，表示公网IP的安全防护属性。

• 新增错误码：

  • InvalidSnapshotStatus

  • InvalidVolumeTypeForSnapshot.UnSupported

  • InvalidSnapshot.NotFound

  • InvalidSnapshotZoneId.Mismatch

  • InvalidReleaseWithInstance.ChargeTypeMismatch

  • LimitExceeded.MaximumEipBandwidth

  • InvalidSecurityProtectionTypes.Malformed

  • InvalidSecurityProtectionTypes.BandwidthPackageIdMismatch

  • OperationDenied.SpecifiedSecurityGroupNotAuthorized

弹性预约实例

DescribeScheduledInstances

• 新增请求参数（可选）：ImageId、KeyPairName，表示支持按镜像ID或密钥对名称查询弹性预约实例。

• 新增返回数据ReleaseWithInstance、SecurityProtectionInstanceId，表示公网IP是否随实例释放以及安全防护包的ID。

CreateImage

• 新增请求参数：
  • NeedDetection，表示是否进行镜像检测。
  • SnapshotGroupId，表示使用快照一致性组创建自定义镜像。
  • SnapshotId，表示使用系统盘快照创建自定义镜像。
• 更新请求参数：
  • InstanceId，调整为非必填参数。
  • Tags.N.Key，增加使用限制，不支持任何大小写形式sys:开头。
• 新增错误码：
  • 400，InvalidPlatformForDetect.UnSupported，指定的镜像平台不支持检测。
  • 400，InvalidSnapshotIdOrSnapshotGroupIdForCreateImage.UnSupported，指定的快照或一致性组不支持创建自定义镜像。
  • 400，LimitExceeded.MaximumSnapshotGroupTotalSize，指定的快照一致性组容量超过限制。
  • 404，InvalidSnapshotGroupId.NotFound，指定的快照一致性组Id不存在。
  • 404，InvalidSnapshotId.NotFound，指定的快照Id不存在。
  • 412，OperationDenied.SnapshotServiceUnavailable，指定的操作被拒绝，因为快照服务未开通。

ImportImage

• 新增请求参数：
  • NeedDetection参数，表示是否进行镜像检测。
• 更新请求参数：
  • Tags.N.Key参数增加使用限制，不支持任何大小写形式sys:开头。
• 新增错误码：
  • 400，InvalidPlatformForDetect.UnSupported，指定的镜像平台不支持检测。

DescribeImages

• 新增返回参数：
  • Images结构新增：
    • DetectionResults结构，表示镜像的检测结果。
    • Snapshots结构，表示镜像关联的快照信息。

DeleteImages

• 新增请求参数：
  • DeleteBindedSnapshots，表示删除镜像是否同时删除快照或快照一致性组。

DescribeInstances

• 新增请求参数：ScheduledInstanceId（可选），表示弹性预约单ID。
• 变更返回数据：ElasticScheduledInstanceType新增取值Segmented，表示弹性预约实例-时段型。
• 新增返回数据：ScheduledInstanceId，表示弹性预约单ID。

DescribeAvailableResource

• 新增请求参数：ElasticScheduledInstanceType（可选），表示弹性预约实例类型。
• 新增错误码：InvalidElasticScheduledInstanceType.Malformed。

DescribeCloudAssistantStatus

变更请求参数：
Status参数新增枚举值：

• Lost表示心跳超时
• ReadyReboot表示待重启
• InstallFailed安装失败
• Uninstalling卸载中
• Initializing初始化

实例

DescribeInstances

• 新增返回数据：
  • 新增ElasticScheduledInstanceType，表示是否为弹性预约实例。

全部

DescribeAvailableResource

• 变更请求参数：

  • DestinationResource新增取值VolumeType，表示待查询的资源类型为云盘。

  • 新增VolumeType，表示待查询的云盘类型。

• 新增错误码：

  • InvalidVolumeType.Malformed

RunInstances

• 变更请求参数：
  • 补充Period默认取值为1。

镜像

DescribeImages

• 新增请求参数：
  • 新增IsLTS（可选），表示公共镜像是否长期维护。
• 新增返回数据：
  • 新增IsLTS，表示公共镜像是否长期维护。

监控

DescribeEventTypes

• 变更请求参数：
  • Types.N参数新增枚举值InstanceOOM表示实例内存OOM。

DescribeSystemEvents

• 变更请求参数：
  • Types.N参数新增枚举值InstanceOOM表示实例内存OOM。

CreateSubscription

变更请求参数：

• Types.N参数新增枚举值：
  • InstanceOOM:Succeeded表示实例内存OOM。
  • SystemFailure.Redeploy:Inquiring表示系统故障，导致实例重新部署：待响应

ModifySubscriptionEventTypes

变更请求参数：

• Types.N参数新增枚举值：
  • InstanceOOM:Succeeded表示实例内存OOM。
  • SystemFailure.Redeploy:Inquiring表示系统故障，导致实例重新部署：待响应

批量作业

CreateCommand

• 更新请求参数：
  • Type参数新增枚举值，Bat表示创建一个Bat脚本；PowerShell表示创建一个PowerShell脚本。

全部

ModifyCommand

• 更新请求参数：
  • Type参数新增枚举值，Bat表示创建一个Bat脚本；PowerShell表示创建一个PowerShell脚本。

DescribeCommands

• 新增请求参数：
  • OrderAscending参数，表示指定返回命令按升序或降序排列。

RunCommand

• 新增请求参数：
  • EnableParameter参数，表示创建的命令是否使用自定义参数。
  • ParameterDefinitions.N.Name参数，表示自定义参数名称。
  • ParameterDefinitions.N.Type参数，表示自定义参数类型。
  • ParameterDefinitions.N.Required参数，表示自定义参数是否必填。
  • ParameterDefinitions.N.DefaultValue参数，表示自定义参数默认值。
  • ParameterDefinitions.N.MinLength参数，表示自定义参数值（字符串）的最小长度。
  • ParameterDefinitions.N.MaxLength参数，表示自定义参数值（字符串）的最大长度。
  • ParameterDefinitions.N.MinValue参数，表示自定义参数值（数值）的最小值。
  • ParameterDefinitions.N.MaxValue参数，表示自定义参数值（数值）的最大值。
  • ParameterDefinitions.N.DecimalPrecision参数，表示自定义参数值（数值）允许的小数点后位数。
  • Parameters参数，表示命令中包含的自定义参数具体值。
• 更新请求参数：
  • Type参数新增枚举值，Bat表示创建一个Bat脚本；PowerShell表示创建一个PowerShell脚本。

实例

RunInstances

• 新增请求参数：

  • 新增专有宿主机相关参数（可选、邀测）：Placement.Tenancy、Placement.DedicatedHostId、Placement.Affinity、Placement.DedicatedHostClusterId

• 新增错误码：

  • InvalidInstanceType.ImageMismatch

  • Insufficient.VolumePoolCapacity

  • InvalidPlacementAffinity.Malformed

  • InvalidPlacementTenancy.Malformed

  • InvalidDedicatedHost.NotFound

  • InvalidDedicatedHostCluster.NotFound

  • InvalidDedicatedHost.InstanceTypeIdMismatch

  • InvalidTenancy.DedicatedHostIdMismatch

  • InvalidDedicatedHostClusterId.DedicatedHostIdMismatch

  • InvalidDedicatedHost.InstanceTypeIdMismatch

全部

ModifyInstanceChargeType

• 新增请求参数：

  • AutoRenew（可选），包年包月实例到期后是否自动续费。

  • AutoRenewPeriod（可选），每次自动续费的时长。

• 新增错误码：

  • InvalidSpotStrategyForModifyInstanceChargeType.Unsupported

ModifyInstanceSpec

• 新增错误码：
  • InvalidSpotStrategyForModifyInstanceSpec.Unsupported

DescribeInstances

• 新增请求参数：

  • DedicatedHostId、DedicatedHostClusterId（可选，邀测），表示专有宿主机ID、专有宿主机集群ID。

• 新增返回数据：

  • Instance结构中新增Placement结构，表示专有宿主机实例信息，具体参数如下：
    • Affinity表示实例是否关联专有宿主机。
    • DedicatedHostId表示实例所在的专有宿主机ID。
    • Tenancy表示是否在专有宿主机上创建实例。
    • DedicatedHostClusterId表示实例所在的专有宿主机集群ID。

DescribeAvailableResource

• 变更请求参数：
  • DestinationResource新增取值DedicatedHost，表示专有宿主机规格。

监控

DescribeEventTypes

• 变更请求参数：
  • Types.N参数新增取值:
    • InfrastructureUpgrade_Redeploy表示基础设施升级，实例重新部署
    • DiskErrorDetected表示硬盘异常
    • DiskError_ReplaceDisk表示硬盘异常，更换硬盘

DescribeSystemEvents

• 变更请求参数：
  • Types.N参数新增取值:
    • InfrastructureUpgrade_Redeploy表示基础设施升级，实例重新部署
    • DiskErrorDetected表示硬盘异常
    • DiskError_ReplaceDisk表示硬盘异常，更换硬盘

• 新增请求参数：
  • Category，表示事件类别。
• 新增错误码：
  • 400，InvalidCategory.Malformed，指定的Category不合法。

CreateSubscription

• 变更请求参数：
  • Types.N参数新增取值:
    • DiskErrorDetected:Inquiring，表示硬盘异常：待响应。

ModifySubscriptionEventTypes

• 变更请求参数：
  • Types.N参数新增取值:
    • DiskErrorDetected:Inquiring，表示硬盘异常：待响应。

实例

RunInstances

• 变更请求参数：

  • SpotStrategy新增取值SpotWithPriceLimit，表示设置了出价上限的抢占式实例。

  • 新增SpotPriceLimit（可选），表示抢占式实例每小时的最高价格，仅SpotStrategy=SpotWithPriceLimit时生效。

• 变更错误码：

  • 新增InvalidSpotPriceLimit.Malformed。
  • 删除InvalidSpotStrategy。

全部

DescribeInstances

• 变更返回数据：

  • SpotStrategy，表示设置了出价上限的抢占式实例。

  • 新增SpotPriceLimit，表示抢占式实例每小时的最高价格，仅SpotStrategy=SpotWithPriceLimit时返回该参数。

运维

GetConsoleOutput

新增错误码：

• FlowLimitExceeded

镜像

CreateImage

• 删除错误码：
  • MissingParameter.InstanceId
• 新增错误码：
  • InvalidParameterCombination

全部

ReplaceSystemVolume

• 新增错误码：
  • InvalidImage.HostnameMismatch

监控

DescribeEventTypes

• 变更请求参数：
  • Types.N参数新增取值：
    • DeploymentSet_Modify表示修改实例部署集
    • ServerMigrationTask表示服务器迁移任务
    • ServerMigration_FirstSync表示服务器迁移，全量数据同步
    • ServerMigration_AdditionalSync表示服务器迁移，增量数据同步
    • GpuRiskDetected表示GPU运行存在风险

DescribeSystemEvents

• 变更请求参数：
  • Types.N参数新增取值：
    • ApplicationFailure表示应用异常
    • DeploymentSet_Modify表示修改实例部署集
    • ServerMigrationTask表示服务器迁移任务
    • ServerMigration_FirstSync表示服务器迁移，全量数据同步
    • ServerMigration_AdditionalSync表示服务器迁移，增量数据同步
    • GpuRiskDetected表示GPU运行存在风险
  • Status.N参数新增取值：
    • Pending表示已暂停
    • Recovered表示已恢复

CreateSubscription

• 变更请求参数：
  • EventTypes.N参数新增取值：
    • SystemMaintenance.Redeploy:Inquiring表示系统维护，实例重新部署：待响应
    • SystemMaintenance.Redeploy:Succeeded表示系统维护，实例重新部署：执行成功
    • ServerMigrationTask:Executing表示服务器迁移任务：执行中
    • ServerMigrationTask:Pending表示服务器迁移任务：已暂停
    • ServerMigrationTask:Recovered表示服务器迁移任务：已恢复
    • ServerMigrationTask:Succeeded表示服务器迁移任务：执行成功
    • ServerMigrationTask:Failed表示服务器迁移任务：执行失败
    • ServerMigration.FirstSync:Succeeded表示服务器迁移，全量数据同步：执行成功
    • ServerMigration.FirstSync:Failed表示服务器迁移，全量数据同步：执行失败
    • ServerMigration.AdditionalSync:Succeeded表示服务器迁移，增量数据同步：执行成功
    • ServerMigration.AdditionalSync:Failed表示服务器迁移，增量数据同步：执行失败
    • GpuRiskDetected:Succeeded表示GPU运行存在风险：执行成功

ModifySubscriptionEventTypes

• 变更请求参数：
  • EventTypes.N参数新增取值：
    • SystemMaintenance.Redeploy:Inquiring表示系统维护，实例重新部署：待响应
    • SystemMaintenance.Redeploy:Succeeded表示系统维护，实例重新部署：执行成功
    • ServerMigrationTask:Executing表示服务器迁移任务：执行中
    • ServerMigrationTask:Pending表示服务器迁移任务：已暂停
    • ServerMigrationTask:Recovered表示服务器迁移任务：已恢复
    • ServerMigrationTask:Succeeded表示服务器迁移任务：执行成功
    • ServerMigrationTask:Failed表示服务器迁移任务：执行失败
    • ServerMigration.FirstSync:Succeeded表示服务器迁移，全量数据同步：执行成功
    • ServerMigration.FirstSync:Failed表示服务器迁移，全量数据同步：执行失败
    • ServerMigration.AdditionalSync:Succeeded表示服务器迁移，增量数据同步：执行成功
    • ServerMigration.AdditionalSync:Failed表示服务器迁移，增量数据同步：执行失败
    • GpuRiskDetected:Succeeded表示GPU运行存在风险：执行成功

实例

ModifyInstanceAttribute

• 新增请求参数：

  • Hostname（可选），表示实例的主机名。

• 新增错误码：

  • InvalidHostname.Malformed

RunInstances

• 新增请求参数：
  • InstallRunCommandAgent（可选），表示创建实例时是否安装批量作业Agent。

DescribeAvailableResource

• 变更请求参数：

  • 新增VolumeType（可选），表示要查询的云盘类型。

  • DestinationResource新增取值VolumeType，表示要查询的云盘类型。

• 新增错误码：

  • InvalidVolumeType.Malformed

密钥对

DeleteKeyPairs

• 修改接口说明：

  • 密钥对删除逻辑优化：仅支持删除未绑定实例的密钥对。

• 新增错误码：

  • InvalidKeyPair.InUse

镜像

CopyImage

• 变更返回数据：
  • 删除TaskId参数，可前往复制镜像目标地域查看复制进度。

全部

DescribeTasks

• 新增请求参数：
  • 新增ResourceIds.N，表示资源ID。

监控

DescribeSystemEvents

• 新增请求参数：
  • SystemEvents结构新增ExtraInfo参数，表示系统事件的扩展信息。

实例

RunInstances

• 修改错误码：
  • LimitExceeded.MaximumSubnetIps修改描述为指定子网的IP地址数量已经达到最大限制。
• 新增错误码：
  • InvalidImage.InstanceTypeMismatch
  • InvalidDeploymentSetGroupNumber
• 新增请求参数：
  • DeploymentSetGroupNumber（可选），表示部署集组的序号。

全部

DescribeInstances

• 新增请求参数：

  • DeploymentSetGroupNumbers.N（可选），表示使用部署集组号，查询对应部署集组内的实例。

• 新增返回数据：

  • Instance结构新增DeploymentSetGroupNumber，表示部署集组序号。

• 新增错误码：

  • LimitExceeded.MaximumDeploymentSetGroupNumbers

StartInstance
StopInstance
RebootInstance
DeleteInstance
ModifyInstanceSpec

• 新增请求参数：

  • DryRun（可选），表示仅检查参数是否合法或检查通过后直接执行接口操作。

• 新增错误码：

  • DryRunOperation

StartInstance
DeleteInstance

• 新增错误码：
  • InvalidArgument

ModifyInstanceSpec

• 新增错误码：
  • InvalidImage.InstanceTypeMismatch
  • InvalidArgument

DescribeAvailableResource

• 变更请求参数：
  • InstanceChargeType（可选），新增取值ReservedInstance。

DescribeSpotAdvice

新增接口，用于查询指定可用区下，抢占式实例近30天的实例平均释放率、平均折扣率等信息。

密钥对

CreateKeyPair
ImportKeyPair

• 新增请求参数：

  • ProjectName（可选），表示资源所属项目。

• 新增错误码：

  • InvalidProject.NotFound

DescribeKeyPairs

• 新增请求参数：

  • ProjectName（可选），表示资源所属项目。

• 新增返回数据：

  • KeyPair结构新增ProjectName参数，表示密钥对绑定的项目名称。

标签

CreateTags
DeleteTags
DescribeTags

• 变更请求参数：
  • ResourceType（必填），新增取值image和reservedinstance，表示镜像和预留实例券支持标签功能。

DescribeImages

• 新增请求参数：
  • TagFilters.N.Key（可选），表示镜像标签的标签键。
  • TagFilters.N.Values.N（可选），表示镜像标签的标签值。
• 新增返回数据：
  • Images结构新增Tags结构，表示镜像绑定的标签信息，具体参数如下。
    • 增加Key参数，表示镜像的标签键。
    • 增加Value参数，表示镜像的标签值。
• 新增错误码：
  • LimitExceeded.MaximumTagFilterKeys
  • LimitExceeded.MaximumTagFilterValues
  • InvalidTagFilterKey.Malformed
  • InvalidTagFilterValue.Malformed
  • LimitExceeded.MaximumTagFilterResults
  • InvalidTagFilterKey.Conflict

CreateImage

• 新增请求参数：
  • Tags.N.Key（可选），表示镜像标签的标签键。
  • Tags.N.Value（可选），表示镜像标签的标签值。
• 新增错误码：
  • InvalidTagKey.Malformed
  • InvalidTagValue.Malformed
  • LimitExceeded.MaximumTags
  • InvalidTagKey.Conflict

ImportImage

• 新增请求参数：
  • Tags.N.Key（可选），表示镜像标签的标签键。
  • Tags.N.Value（可选），镜像标签的标签值。
• 新增错误码：
  • InvalidTagKey.Malformed
  • InvalidTagValue.Malformed
  • LimitExceeded.MaximumTags
  • InvalidTagKey.Conflict

DescribeTasks

• 变更返回数据：
  • Tasks结构Type参数，新增枚举值CopyImage（邀测）。

ReplaceSystemVolume

• 新增请求参数：
  • DryRun（可选），表示是否只预检此次请求。
• 新增错误码：
  • DryRunOperation