最近更新时间:2024.03.22 08:34:55
首次发布时间:2023.11.21 10:21:45
调用 ModifyReservedInstances 接口更改预留实例券,包括更改预留实例券属性、拆分/合并预留实例券等。
说明
名称 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyReservedInstances | 要执行的操作,取值:ModifyReservedInstances。 |
Version | String | 是 | 2020-04-01 | API的版本,取值: 2020-04-01。 |
RegionId | String | 否 | cn-beijing | 原预留实例券所属的地域ID。 您可以调用 DescribeRegions 接口查看地域ID。 |
ReservedInstanceIds.N | String | 是 | ReservedInstanceIds.1=ecsri-ycsimi9g465p****&ReservedInstanceIds.2=ecsri-ycsimi2db0l8j0wr**** | 原预留实例券ID,最多支持10个。
|
Configurations.N.ReservedInstanceName | String | 是 | Configurations.1.ReservedInstanceName=reserved-instance-test | 目标预留实例券的名称。
|
Configurations.N.InstanceCount | String | 否 | Configurations.1.InstanceCount=2 | 目标预留实例券可以抵扣的按量计费实例数量,最多支持100台。传入0时或者不传,会默认为1。
|
Configurations.N.InstanceTypeId | String | 否 | Configurations.1.InstanceTypeId=ecs.g3i.xlarge | 目标预留实例券可以匹配的实例规格ID。
|
Configurations.N.Scope | String | 否 | Configurations.1.Scope=ZonalRI | 目标预留实例券的类型,取值:
说明
|
Configurations.N.ZoneId | String | 否 | Configurations.1.ZoneId=cn-beijing-a | 目标预留实例券所在的可用区ID。
说明
|
AutoRenew | Boolean | 否 | true | 目标预留实例券到期后是否自动续费,取值:
说明 启用自动续费后,本次生成的所有目标券在到期前,平台将自动扣除续费费用,无需手动续费。 |
AutoRenewPeriod | Integer | 否 | 1 | 每次自动续费的时长。
|
ProjectName | String | 否 | project_a | 资源所属项目,一个资源只能归属于一个项目。
|
Tags.N.Key | String | 否 | Tags.1.Key=k1&Tags.2.Key=k2 | 用户标签的标签键。
命名规则如下:
说明 同一资源的标签键不允许重复。 |
Tags.N.Value | String | 否 | Tags.1.Value=v1&Tags.2.Value=v2 | 用户标签的标签值。
命名规则如下:
说明 如果传入该参数,则必须先传入 |
ClientToken | String | 否 | 333456899ff**** | 保证请求幂等性。由客户端自动生成一个参数值,确保不同请求间该参数值唯一,避免当调用API超时或服务器内部错误时,客户端多次重试导致重复性操作。 |
Configurations.N.HpcClusterId | String | 否 | Configurations.1.HpcClusterId=hpcCluster-1 | 高性能计算集群ID。
说明 仅当预留实例券对应的实例规格为高性能计算GPU型时,该参数生效。 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
ReservedInstanceIds | List | ["ecsri-ycspipybqpl8j084****","ecsri-ecsri-yccazceloyf80n48****"] | 预留实例券ID。 |
GET /?Action=ModifyReservedInstances&Version=2020-04-01&ReservedInstanceIds.1=ecsri-ycsimi9g465p****&ReservedInstanceIds.2=ecsri-ycsimi2db0l8j0wr****&Configurations.1.ReservedInstanceName=reserved-instance-test&Configurations.1.InstanceTypeId=ecs.g3i.xlarge&Configurations.1.InstanceCount=2&Configurations.1.Scope=ZonalRI&Configurations.1.ZoneId=cn-beijing-a HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing-a ServiceName: ecs
{ "ResponseMetadata": { "RequestId": "20231120161355D7AA5622C4F5C000****", "Action": "ModifyReservedInstances", "Version": "2020-04-01", "Service": "ecs", "Region": "cn-beijing" }, "Result": { "ReservedInstanceIds": [ "ecsri-ycspipybqpl8j084****" ] } }
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | IdempotentParameterMismatch | The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical. | 幂等参数不一致。 |
400 | InvalidClientToken.Malformed | The specified ClientToken is malformed. | 指定的ClientToken不合法。 |
400 | InvalidInstanceStatus | The status of the specified instance does not support this request. | 当前实例的状态不支持此操作。 |
400 | InvalidInstanceTypeAndInstanceCount | The specified InstanceType And InstanceCount is invalid. | 指定的实例规格和实例数量不合法。 |
400 | InvalidInstanceTypeForCreateReservedInstance.Unsupported | The specified InstanceType does not support creation of reserved instances. | 指定的实例规格不支持创建预留实例券。 |
400 | InvalidPeriod | The specified period is not valid. | 指定的计费周期个数不合法。 |
400 | InvalidReservedInstanceIds.ZoneMismatch | The specified ReservedInstanceIds are in different Availability Zones. | 指定预留实例券不属于同一个可用区。 |
400 | InvalidReservedInstanceModifyStatus.Unsupported | The modify status of the specified reserved instance does not support this request. | 当前预留实例的更改状态不支持此操作。 |
400 | InvalidReservedInstanceName.Malformed | The specified ReservedInstanceName is malformed. | 指定的ReservedInstanceName不合法。 |
400 | InvalidReservedInstanceStatus | The status of the specified reserved instance does not support this request. | 当前预留实例的状态不支持此操作。 |
400 | InvalidScope.Malformed | The specified Scope is malformed. | 指定的预留实例券类型不合法。 |
400 | InvalidTagKey.Malformed | The specified TagKey is malformed. | 指定的标签键不合法。 |
400 | InvalidTagValue.Malformed | The specified TagValue is malformed. | 指定的标签值不合法。 |
400 | LimitExceeded.MaximumConfigurations | The number of specified Configurations exceeds the maximum limit. | 指定的Configurations超过最大限制。 |
400 | LimitExceeded.MaximumInstanceCount | The number of specified InstanceCount exceeds the maximum limit. | 指定的InstanceCount超过最大限制。 |
400 | LimitExceeded.MaximumReservedInstanceIds | The number of specified ReservedInstanceIds exceeds the maximum limit. | 指定的ReservedInstanceIds超过最大限制。 |
400 | LimitExceeded.MaximumTags | You've reached the limit on the number of tags that you can create. | 指定的标签数量超过最大限制。 |
400 | LimitExceeded.MinimumInstanceCount | The number of specified InstanceCount exceeds the minimum limit. | 指定的InstanceCount超过最小限制。 |
400 | MissingParameter.Configurations | The required parameter Configurations is not supplied. | 预留实例券配置不能为空。 |
400 | MissingParameter.ReservedInstanceIds | The required parameter ReservedInstanceIds is not supplied. | 参数ReservedInstanceIds不能为空。 |
400 | MissingParameter.ReservedInstanceName | The required parameter ReservedInstanceName is not supplied. | 参数ReservedInstanceName不能为空。 |
400 | MissingParameter.ZoneId | The required parameter ZoneId is not supplied. | 可用区ID不能为空。 |
400 | QuotaExceeded.MaximumReservedInstanceCpus | You've reached the limit on the number of reserved instance CPU that you can create, please submit ticket to request an increase in quota. | 预留实例数量配额不足,请提工单申请提高配额。 |
400 | QuotaExceeded.MaximumReservedInstanceTypeInstances | You've reached the limit on the number of reserved instance type instances that you can create, please submit ticket to request an increase in quota. | 预留规格实例数量配额不足,请提工单申请提高配额。 |
404 | InvalidHpcCluster.NotFound | The specified HpcCluster does not exist. | 指定的高性能集群不存在。 |
404 | InvalidInstance.NotFound | The specified instance does not exist. | 指定的实例不存在。 |
404 | InvalidInstanceType.NotFound | The specified InstanceType does not exist. | 指定的实例规格不存在。 |
404 | InvalidProject.NotFound | The specified Project does not exist. | 指定的Project不存在。 |
404 | InvalidRegion.NotFound | The specified region does not exist. | 指定的Region不存在。 |
404 | InvalidReservedInstance.NotFound | The specified reserved instance does not exist. | 指定的预留实例不存在。 |
404 | InvalidZone.NotFound | The specified zone does not exist. | 指定的可用区不存在。 |
409 | InvalidTagKey.Conflict | The specified TagKey already exists. | 指定的标签键已存在。 |
412 | IdempotentProcessing | The request uses the same client token as a previous one that is still in process. | 先前的幂等请求仍在处理中,请稍后重试。 |
412 | InvalidReservedInstanceModifyStatus.ComputeFactorMismatch | The compute factor of the specified reserved instances does not match. | 变更前后预留实例计算力因子不相等。 |
412 | InvalidReservedInstanceModifyStatus.ExpiredTimeMismatch | The expired time of the specified reserved instances does not match. | 预留实例到期时间不相等。 |
412 | InvalidReservedInstanceModifyStatus.InstanceTypeFamilyMismatch | The instancetype family of the specified reserved instances does not match. | 预留实例规格族不相等。 |
500 | Insufficient.InstanceCapacity | There is not enough capacity to fulfill your request. | 当前资源不足,请稍后重试或选择其它实例规格。 |
500 | InternalError | An internal error has occurred. | 内部错误,请重试。如果多次尝试失败,请提交工单。 |