専用ホストの課金方法を変更します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 ModifyDedicatedHostsChargeType

実行する操作です。 値をModifyDedicatedHostsChargeTypeに設定します。

DedicatedHostIds String 必須 ["dh-bp181e5064b5sotr ****" 、"dh-bp18064b5sotrr9c ****"]

専用ホストのID。 この値は、最大20個の専用ホストIDで構成されるJSON配列にすることができます。 専用ホストIDはコンマ (,) で区切ります。

RegionId String 必須 cn-hangzhou

専用ホストのリージョンID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

期間 Integer 任意 1

サブスクリプション専用ホストの更新期間。 設定可能な値は以下のとおりです。

  • PeriodUnitがWeekに設定されている場合、Periodの有効な値は1、2、3、4です。
  • PeriodUnitがMonthに設定されている場合、Periodの有効値は1、2、3、4、5、6、7、8、9、12、24、36、48、60です。
PeriodUnit String 任意 月

更新期間の単位 (Period) 。 設定可能な値は以下のとおりです。

  • 週
  • 月

デフォルト値：Month 。

DryRun Boolean 任意 false

実際にリクエストを行わずに、リクエストの有効性を確認するかどうかを指定します。 設定可能な値は以下のとおりです。

  • true: リクエストの有効性はチェックされますが、リクエストは行われません。 チェック項目には、AccessKeyペアが有効かどうか、RAMユーザーに必要な権限が付与されているかどうか、および必要なパラメーターが指定されているかどうかが含まれます。 チェックが失敗した場合、対応するエラーが返されます。 チェックが成功すると、DryRunOperationエラーコードが返されます。
  • false: リクエストの有効性がチェックされます。 チェックが成功すると、2XX HTTPステータスコードが返され、リクエストが行われます。

規定値: false

AutoPay Boolean 任意 false

自動支払いを有効にするかどうかを指定します。 設定可能な値は以下のとおりです。

  • true：自動支払いを有効化します。 アカウントの残高が十分であることをご確認ください。 それ以外の場合、注文は無効になり、キャンセルする必要があります。
  • false: 注文は生成されますが、支払いは行われません。

Default value: true.

注 アカウントの残高が不足している場合は、AutoPayパラメーターをfalseに設定して未払いの注文を生成できます。 それから、順序の支払をすることができます。
DedicatedHostChargeType String 任意 PrePaid

専用ホストの新しい課金方法。 設定可能な値は以下のとおりです。

  • PrePaid: 課金方法を従量課金からサブスクリプションに変更します。
  • PostPaid: 課金方法をサブスクリプションから従量課金に変更します。

デフォルト値は、Prepaid です。

ClientTokend String 任意 e4567-e89b-12d3-a456-426655440000

リクエストのべき等性を保証するために使用されるクライアントトークンです。 クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 ClientToken値にはASCII文字のみを使用でき、長さは64文字を超えることはできません。 詳細については、「べき等性を確保する方法」をご参照ください。

詳細料金 Boolean 任意 false

課金方法がサブスクリプションから従量課金に変更されたときに、注文の課金詳細を返すかどうかを指定します。

規定値: false

レスポンスパラメーター

パラメーター データ型 例 説明
OrderId String 20413515388 ****

注文 ID

RequestId String B61C08E5-403A-46A2-96C1-F7B1216DB10C

リクエストの ID です。

FeeOfInstances FeeOfInstanceの配列

注文の料金についての詳細。

FeeOfInstance
InstanceId String dh-bp181e5064b5sotrr ****

専用ホストの ID。

Currency String CNY

請求書の通貨の単位。

Alibaba Cloud Chinaサイト (aliyun.com): CNY。

Alibaba Cloud国際サイト (alibabacloud.com): USD

料金 String 0

コスト値。

例

リクエストの例

https://ecs.aliyuncs.com/?Action=ModifyDedicatedHostsChargeType
&RegionId=cn-hangzhou
&InstanceIds=["dh-bp181e5064b5sotr ****" 、"dh-bpe5064b5sotrr9c ****"]
&期間=1
&PeriodUnit=月
&AutoPay=false
&IncludeAllDisks=true
&ClientToken=e4567-e89b-12d3-a456-426655440000
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyDedicatedHostsChargeTypeResponse>
    <RequestId>B61C08E5-403A-46A2-96C1-F7B1216DB10C</RequestId>
    <OrderId>20413515388 ****</OrderId>
    <FeeOfInstances>
        <FeeOfInstance>
            <料金> 0</料金>
            <InstanceId>dh-bp181e5064b5sotr ****</InstanceId>
            <Currency>CNY</Currency>
        </FeeOfInstance>
        <FeeOfInstance>
            <料金> 0</料金>
            <InstanceId>dh-bp181e5064b5sotr ****</InstanceId>
            <Currency>CNY</Currency>
        </FeeOfInstance>
    </FeeOfInstances>
</ModifyDedicatedHostsChargeTypeResponse>

JSON 形式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "B61C08E5-403A-46A2-96C1-F7B1216DB10C" 、
  "OrderId" : "20413515388 ****" 、
  "FeeOfInstances" : {
    "FeeOfInstance" : [ {
      "料金" : "0" 、
      "InstanceId" : "dh-bp181e5064b5sotr ****" 、
      「通貨」: 「CNY」
    }, {
      "料金" : "0" 、
      "InstanceId" : "dh-bp181e5064b5sotr ****" 、
      「通貨」: 「CNY」
    } ]
  }
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 InvalidParameter.InstanceIds 指定されたInstanceIdsは無効です。 指定されたInstanceIdsパラメーターが無効な場合に返されるエラーメッセージ。
400 InvalidParameter %s 指定されたパラメーターが無効な場合に返されるエラーメッセージ。
400 InvalidStatus.ValueNotSupported %s リソースの現在のステータスで該当の操作がサポートされていない場合に返されるエラーメッセージ。
400 InvalidInstanceChargeType.ValueNotSupported %s 指定されたDedicatedHostChargeTypeパラメーターが無効な場合に返されるエラーメッセージ。
400 ExpiredInstance 指定されたインスタンスの有効期限が切れています。 指定されたインスタンスの有効期限が切れた場合に返されるエラーメッセージ。
400 InstancesIdQuotaExceed インスタンスの最大数を超えています。 インスタンスの最大数に達した場合に返されるエラーメッセージ。
400 InvalidClientToken.ValueNotSupported The ClientToken provided is invalid. 指定されたClientTokenパラメーターが無効な場合に返されるエラーメッセージ。
400 ReleaseTimeHaveBeenSet 指定されたインスタンスはリリース時刻に設定されています。 指定されたインスタンスに自動リリース時間が設定されている場合に返されるエラーメッセージ。
400 Throttling リクエストの抑制によりリクエストが拒否されました。5分後に再度お試しください。 リクエストが抑制された場合に返されるエラーメッセージ。 5分後にもう一度お試しください。
400 Throttling %s スロットリングによりリクエストが拒否された場合に返されるエラーメッセージ。
400 QuotaExceed.AfterpayInstance The maximum number of Pay-As-You-Go instances is exceeded: %s 指定されたインスタンスタイプの従量課金インスタンスを作成するにはリソースが不足している場合に返されるエラーメッセージ。 作成するインスタンスの数を削減してください。
400 QuotaExceed.RufundVcpu 払い戻しvcpuの最大数を超えています: % s 払い戻し額の計算に使用されるvCPUの数が上限を超えた場合に返されるエラーメッセージ。 制限の詳細については、エラーメッセージの % sプレースホルダーの戻り値をご参照ください。
400 InvalidPeriod.UnitMismatch 指定されたPeriodはPeriodUnitと関連付けられている必要があります。 指定されたPeriodパラメーターの値がPeriodUnitパラメーターで決定された有効な値の範囲外である場合に返されるエラーメッセージ。
400 InvalidImageType.NotSupported %s 指定されたイメージタイプが無効な場合に返されるエラーメッセージ。 このイメージタイプがリージョンでサポートされているかどうかを確認します。
400 InvalidPeriod.ExceededDedicatedHost Instance expired date can't exceed dedicated host expired date. インスタンスの有効期限が専用ホストの有効期限よりも遅い場合に返されるエラーメッセージ。
400 InvalidSystemDiskCategory.ValueNotSupported %s 指定されたシステムディスクカテゴリには操作が適用できない場合に返されるエラーメッセージ。
500 InternalError The request processing has failed due to some unknown error, exception or failure. 内部エラーが発生した場合に返されるエラーメッセージです。 しばらくしてから再試行します。 エラーが解決しない場合は、チケットを起票してください。
500 InternalError 不明なエラーにより、リクエスト処理が失敗しました。 内部エラーが発生した場合に返されるエラーメッセージです。 しばらくしてから再試行します。 エラーが解決しない場合は、チケットを起票してください。
403 InvalidInstanceType.ValueNotSupported The specified InstanceType does not exist or beyond the permitted range. 指定されたインスタンスタイプが存在しない場合、または指定されたインスタンスタイプのインスタンスを管理する権限がない場合に返されるエラーメッセージ。
403 InstanceType.Offline %s インスタンスタイプが廃止されている場合、またはインスタンスタイプのリソースが不足している場合に、操作がサポートされていない場合に返されるエラーメッセージ。
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance. アカウントの残高が不十分な場合に返されるエラーメッセージ。 アカウントに資金を追加して、もう一度お試しください。
403 Account.Arrearage Your account has an outstanding payment. アカウントに料金滞納がある場合に返されるエラーメッセージ。
403 InvalidParameter.NotMatch %s 指定されたパラメーターが無効な場合に返されるエラーメッセージ。 パラメーターの競合が存在するかどうかを確認します。
403 InvalidAction %s 操作が無効な場合に返されるエラーメッセージ。
403 QuotaExceed.PostPaidDisk Living postPaid disks quota exceeded. 従量課金ディスクの最大数に達した場合に返されるエラーメッセージ。
403 ImageNotSupportInstanceType 指定された instanceType は、マーケットプレースイメージのインスタンスで非対応の instanceType です。 指定されたAlibaba Cloud Marketplaceイメージがインスタンスタイプをサポートしていない場合に返されるエラーメッセージ。
403 InvalidInstanceType.PhasedOut このinstanceTypeは提供されなくなりました。 指定されたインスタンスタイプが廃止された場合に返されるエラーメッセージ。
403 RealNameAuthenticationError Your account has not passed the real-name authentication yet. 実名登録が完了していない場合に返されるエラーメッセージ。 実名登録を完了して、もう一度お試しください。
404 InvalidInstanceId.NotFound 指定されたinstanceIdは存在しません。 指定されたインスタンスが存在しない場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。