この操作では、1つ以上のサブスクリプション専用ホストを更新します。
説明
デフォルトでは、サブスクリプション専用ホストを更新するときに最初に控除可能なバウチャーが使用されます。 アカウントがクレジットの支払い方法をサポートしていることを確認する必要があります。
リクエストパラメーター
| パラメーター | データ型 | 必須／任意 | 例 | 説明 |
|---|---|---|---|---|
| 操作 | String | 必須 | RenewDedicatedHosts |
実行する操作です。 Set the value to RenewDedicatedHosts. |
| DedicatedHostIds | String | 必須 | dh-bp199lyny9b3 **** |
The IDs of dedicated hosts. 最大100のサブスクリプション専用ホストのIDを指定できます。 JSON配列で専用ホストIDを指定します。
例: |
| 期間 | Integer | 必須 | 1 |
サブスクリプション専用ホストの更新期間。 有効な値については、 |
| RegionId | String | 必須 | cn-hangzhou |
専用ホストのリージョンID。 DescribeRegions を呼び出すと、最新のリージョンリストを照会できます。 |
| PeriodUnit | String | 任意 | 月 |
課金サイクルの単位です。 デフォルト値：Month 。 設定可能な値は以下のとおりです。
|
| ClientTokend | String | 任意 | 123e4567-e89b-12d3-a456-426655440000 |
リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、値が異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを使用でき、長さは64文字を超えることはできません。 詳細については、「べき等性を確保する方法」をご参照ください。 |
レスポンスパラメーター
| パラメーター | データ型 | 例 | 説明 |
|---|---|---|---|
| RequestId | String | 2A4EA075-CB5B-41B7-B0EB-70D339F64DE7 |
リクエストの ID です。 |
例
リクエストの例
http(s):// ecs.aliyuncs.com/? アクション=RenewDedicatedHosts
&DedicatedHostIds=dh-bp199lyny9b3 ****
&期間=1
&RegionId=cn-hangzhou
&<共通リクエストパラメーター>正常に処理された場合のレスポンス例
XML 形式
<RenewDedicatedHostsResponse>
<RequestId>2A4EA075-CB5B-41B7-B0EB-70D339F64DE7</RequestId>
</RenewDedicatedHostsResponse>JSON 形式
{
"RequestId":"2A4EA075-CB5B-41B7-B0EB-70D339F64DE7"
}エラーコード
| HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
|---|---|---|---|
| 400 | IdempotenceParamNotMatch | 以前のリクエストのクライアントトークンが使用されていますが、同一のリクエストではありません。 | The error message returned because the specified client token in this request is not identical to the one used in the previous request. |
| 400 | InvalidClientToken.ValueNotSupported | The ClientToken provided is invalid. | 指定されたClientTokenパラメーターが無効な場合に返されるエラーメッセージ。 |
| 403 | ChargeTypeViolation | 従量課金専用ホストはこの操作をサポートしていません。 | 従量課金の専用ホストが現在の操作をサポートしていない場合に返されるエラーメッセージ。 |
| 403 | IncorrectHostStatus | The current status of the resource does not support this operation. | リソースの現在のステータスで該当の操作がサポートされていない場合に返されるエラーメッセージ。 |
| 400 | InvalidPeriod | The specified period is not valid. | 指定された Period パラメーターが無効な場合に返されるエラーメッセージ。 |
| 403 | LastTokenProcessing | 最後のトークンリクエストは処理中です。 | 前のトークンリクエストが処理中の場合に返されるエラーメッセージ。 しばらくしてから再試行します。 |
| 400 | InvalidPeriodUnit.ValueNotSupported | The specified parameter PeriodUnit is not valid. | 指定された PeriodUnit パラメーターが無効な場合に返されるエラーメッセージ。 |
| 400 | InvalidDedicatedHostId.NotFound | The specified DedicatedHostId does not exist. | 指定された専用ホストが存在しない場合に返されるエラーメッセージ。 |
| 400 | InvalidStatus.Upgrading | 専用ホストはアップグレード中です。後でお試しください。 | 指定された専用ホストがアップグレード中の場合に返されるエラーメッセージ。 しばらくしてから再試行します。 |
| 500 | InternalError | 不明なエラーにより、リクエスト処理が失敗しました。 | 内部エラーが発生した場合に返されるエラーメッセージです。 しばらくしてから再試行します。 問題が解決しない場合、チケットを起票し、サポートセンターへお問い合わせください。 |
| 400 | LastOrderProcessing | 前の注文の処理が完了していません。しばらくしてからもう一度お試しください。 | 前の注文が処理中の場合に返されるエラーメッセージ。 しばらくしてから再試行します。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。