1つ以上のサブスクリプション専用ホストの自動更新状態を照会します。

リクエストパラメーター

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

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

DedicatedHostIds String 必須 dh-bp165p6xk2tlw61e ****,dh-bp1f9vxmno ****

専用ホストのID。 最大100のサブスクリプション専用ホストIDを指定できます。 ID が複数ある場合は、カンマ (,) で区切ります。

RegionId String 必須 cn-hangzhou

専用ホストのリージョンID。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

リクエストの ID です。

DedicatedHostRenewAttributes DedicatedHostRenewAttributeの配列

専用ホストの自動更新属性の詳細。

DedicatedHostRenewAttribute
PeriodUnit String 月

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

  • 週
  • 月
有効期間 Integer 0

自動更新期間。

DedicatedHostId String dh-bp165p6xk2tlw61e ****

専用ホストの ID。

RenewalStatus String 通常

サブスクリプション専用ホストが自動的に更新されるかどうかを示します。 設定可能な値は以下のとおりです。

  • AutoRenewal: 専用ホストは自動的に更新されます。
  • 通常: 専用ホストは自動的に更新されず、更新の通知を受け取ります。
  • NotRenewal: 専用ホストは更新されず、有効期限通知は送信されません。 更新の通知は、専用ホストの有効期限が切れる3日前に自動的に送信されます。 専用ホストのこのパラメーターの値をNotRenewalからNormalに変更し、RenewDedicatedHosts操作を呼び出して手動で更新できます。 または、このパラメーターをAutoRenewalに設定して、専用ホストを自動的に更新するように設定することもできます。
AutoRenewEnabled Boolean false

サブスクリプション専用ホストが自動的に更新されるかどうかを示します。 設定可能な値は以下のとおりです。

  • true: 専用ホストが自動的に更新されます。
  • false: 専用ホストは自動的に更新されません。
AutoRenewWithEcs String StopRenewWithEcs

更新されたインスタンスの新しい有効期限が専用ホストの有効期限よりも遅い場合、サブスクリプション専用ホストが、その上でホストされているサブスクリプションElastic Compute Service (ECS) インスタンスとともに自動的に更新されるかどうかを示します。 設定可能な値は以下のとおりです。

  • AutoRenewWithEcs: サブスクリプション専用ホストは、ホストされているサブスクリプションECSインスタンスとともに自動的に更新されます。
  • StopRenewWithEcs: サブスクリプション専用ホストは、ホストされているサブスクリプションECSインスタンスとともに自動的に更新されません。

例

リクエストの例

https://ecs.aliyuncs.com/?Action=DescribeDedicatedHostAutoRenew
&RegionId=cn-hangzhou
&DedicatedHostIds=dh-bp165p6xk2tlw61e **** 、dh-bp1f9vxmno ****
&<共通リクエストパラメーター>

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

XML 形式 

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

<DescribeDedicatedHostAutoRenewResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
    <DedicatedHostRenewAttributes>
        <DedicatedHostRenewAttribute>
            <AutoRenewEnabled>false</AutoRenewEnabled>
            <DedicatedHostId>dh-bp165p6xk2tlw61e****</DedicatedHostId>
            <RenewalStatus>Normal</RenewalStatus>
            <AutoRenewWithEcs>StopRenewWithEcs</AutoRenewWithEcs>
            <Duration>0</Duration>
            <PeriodUnit>Month</PeriodUnit>
        </DedicatedHostRenewAttribute>
        <DedicatedHostRenewAttribute>
            <AutoRenewEnabled>true</AutoRenewEnabled>
            <DedicatedHostId>dh-bp1f9vxmno ****</DedicatedHostId>
            <RenewalStatus>AutoRenewal</RenewalStatus>
            <AutoRenewWithEcs>StopRenewWithEcs</AutoRenewWithEcs>
            <Duration>1</Duration>
            <PeriodUnit>Month</PeriodUnit>
        </DedicatedHostRenewAttribute>
    </DedicatedHostRenewAttributes>
</DescribeDedicatedHostAutoRenewResponse>

JSON 形式 

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

{
  "RequestId" : "04F0F334-1335-436C-A1D7-6C044FE73368" 、
  "DedicatedHostRenewAttributes" : {
    "DedicatedHostRenewAttribute" : [ {
      "AutoRenewEnabled" : false、
      "DedicatedHostId" : "dh-bp165p6xk2tlw61e ****" 、
      "RenewalStatus" : "通常" 、
      "AutoRenewWithEcs" : "StopRenewWithEcs" 、
      "期間" : 0,
      "PeriodUnit" : "Month"
    }, {
      "AutoRenewEnabled" : true、
      "DedicatedHostId" : "dh-bp1f9vxmno****",
      "RenewalStatus" : "AutoRenewal" 、
      "AutoRenewWithEcs" : "StopRenewWithEcs",
      "期間" : 1,
      "PeriodUnit" : "月"
    } ]
  }
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
403 MissingParameter.DedicatedHostId DedicatedHostId should not be null. DedicatedHostIdsパラメーターが指定されていない場合に返されるエラーメッセージ。
403 InvalidParameter.ToManyDedicatedHostIds DedicatedHostIdは100未満にする必要があります。 DedicatedHostIdsパラメーターに100を超える専用ホストIDが指定されている場合に返されるエラーメッセージ。
403 InvalidParameter.InvalidDedicatedHostId %s 指定されたDedicatedHostIdsパラメーターが無効な場合に返されるエラーメッセージ。
403 IncorrectDedicatedHostStatus The current status of the resource does not support this operation. この操作が、現在のステータスにある専用ホストではサポートされていない場合に返されるエラーメッセージ。
403 ChargeTypeViolation 従量課金専用ホストはこの操作をサポートしていません。 従量課金の専用ホストがこの操作をサポートしていない場合に返されるエラーメッセージ。

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