すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:ModifyDedicatedHostAutoRenewAttribute

最終更新日:Apr 04, 2026

1 つ以上のサブスクリリプションの専用ホストの自動更新を有効または無効にします。

操作説明

  • サブスクリプションの専用ホストの自動更新を有効にすると、システムは専用ホストの有効期限が切れる 9 日前の 08:00:00 (UTC+8) に更新料金の引き落としを試み、専用ホストを更新します。 この引き落としに失敗した場合、システムは翌日以降、専用ホストの有効期限が切れるか、支払いが完了するまで、毎日同じ時刻に引き落としを試みます。 アカウントの残高が十分であることを確認してください。

  • サブスクリプションの専用ホストは、そのホスト上で実行されているサブスクリプションの Elastic Compute Service (ECS) インスタンスと共に自動更新できます。 詳細については、`AutoRenewWithEcs` パラメーターの説明をご参照ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ecs:ModifyDedicatedHostAutoRenewAttribute

update

*DedicatedHost

acs:ecs:{#regionId}:{#accountId}:ddh/{#ddhId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

DedicatedHostIds

string

必須

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

dh-bp165p6xk2tlw61e****

RegionId

string

必須

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

cn-hangzhou

Duration

integer

任意

更新期間。

  • `PeriodUnit` が Month に設定されている場合の有効な値:1 および 12

  • `PeriodUnit` が Year に設定されている場合の有効な値:1 および 12

1

PeriodUnit

string

任意

更新期間の単位。 有効な値:

  • Month

  • Year

デフォルト値:Month

Month

AutoRenew

boolean

任意

サブスクリプションを自動更新するかどうかを指定します。 有効な値:

  • true

  • false

デフォルト値:false

false

RenewalStatus

string

任意

サブスクリプションの専用ホストを自動更新するかどうかを指定します。 RenewalStatus パラメーターは AutoRenew パラメーターより優先されます。 有効な値:

  • AutoRenewal:専用ホストは自動的に更新されます。

  • Normal:専用ホストは自動更新されず、更新通知が送信されます。

  • NotRenewal:専用ホストは自動更新されず、有効期限の通知も送信されません。 現在のサブスクリプション期間が終了する 3 日前に、更新しない旨の通知が自動的に送信されます。 このパラメーターの値を NotRenewal から Normal に変更し、RenewDedicatedHosts 操作を呼び出して専用ホストを手動で更新できます。 または、このパラメーターを AutoRenewal に設定して専用ホストを更新することもできます。

Normal

AutoRenewWithEcs

string

任意

サブスクリプションの専用ホストを、そのホスト上で実行されているサブスクリプションの ECS インスタンスと共に自動更新するかどうかを指定します。

サブスクリプションの専用ホスト上で実行されているサブスクリプションの ECS インスタンスの自動更新が有効になっている場合、このパラメーターを指定して、サブスクリプションの ECS インスタンスと共に専用ホストを自動更新できます。 ご利用の専用ホスト上で実行されているサブスクリプションの ECS インスタンスが自動更新される際、専用ホストの有効期限が更新後のインスタンスの有効期限より早い場合、サブスクリプションの専用ホストも自動的に更新されます。 次の点にご注意ください:

サブスクリプションの専用ホストが、そのホスト上で実行されているサブスクリプションの ECS インスタンスと共に自動更新されるように設定されている場合、システムは更新後のインスタンスの有効期限を確認し、専用ホストの最小更新期間を選択して、専用ホストが更新後のインスタンスの有効期限よりも後に終了するように更新します。 サポートされている更新期間の詳細については、PeriodUnit および Duration パラメーターの説明をご参照ください。

たとえば、専用ホストの有効期限が今年の 1 月 15 日であるとします。 専用ホスト上で実行されているサブスクリプションの ECS インスタンスは、同年の 11 月 15 日まで自動更新されるように設定されています。 専用ホストの有効期限は、ECS インスタンスの有効期限より 10 か月早いです。 この場合、システムは専用ホストの更新期間として 12 か月 (Duration の値が 12、PeriodUnit の値が Month に基づいて計算された最小期間) を選択します。 これにより、専用ホストの有効期限が ECS インスタンスよりも後になります。

有効な値:

  • AutoRenewWithEcs:サブスクリプションの専用ホストを、そのホスト上で実行されているサブスクリプションの ECS インスタンスと共に自動更新します。

  • StopRenewWithEcs:サブスクリプションの専用ホストを、そのホスト上で実行されているサブスクリプションの ECS インスタンスと共に自動更新しません。

  • NoOperation:専用ホストの現在の設定を変更しません。

説明

このパラメーターを AutoRenewWithEcs に設定する場合は、AutoRenew が true に設定され、専用ホストの自動更新が有効になっていることを確認してください。 そうでない場合、サブスクリプションの専用ホストは、そのホスト上で実行されているサブスクリプションの ECS インスタンスと共に自動更新されません。

デフォルト値:NoOperation。

StopRenewWithEcs

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID。

2A4EA075-CB5B-41B7-B0EB-70D339F6****

成功レスポンス

JSONJSON

{
  "RequestId": "2A4EA075-CB5B-41B7-B0EB-70D339F6****"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

403 MissingParameter.DedicatedHostId DedicatedHostId should not be null.
403 InvalidParameter.ToManyDedicatedHostIds DedicatedHostId should be less than 100.
403 InvalidParameter.InvalidDedicatedHostId %s
403 IncorrectHostStatus The current status of the resource does not support this operation.
403 ChargeTypeViolation Pay-As-You-Go dedicated host do not support this operation.
403 InvalidParameter.Duration %s
403 InvalidParameter.RenewalStatus %s
403 InvalidPeriodUnit.ValueNotSupported The specified parameter PeriodUnit is not valid.
403 InvalidParameter.AutoRenewWithEcs The value of parameter AutoRenewWithEcs is invalid.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。