ModifyDedicatedHostsChargeType - Elastic Compute Service - Alibaba Cloud ドキュメントセンター

専用ホストの支払い方法を変更します。

今すぐお試しください

この 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:ModifyDedicatedHostsChargeType

update

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
DedicatedHostIds	string	必須	専用ホストの ID。値は、最大 20 個の専用ホスト ID で構成される JSON 配列です。 ID はコンマ (,) で区切ります。	["dh-bp181e5064b5sotr**","dh-bp18064b5sotrr9c**"]
RegionId	string	必須	専用ホストが属するリージョンの ID。 DescribeRegions 操作を呼び出して、最新のリージョンリストを照会できます。	cn-hangzhou
Period	integer	任意	サブスクリプション方式の専用ホストの更新期間。有効値： `PeriodUnit` を Week に設定した場合、`Period` の有効値は 1、2、3、4 です。 `PeriodUnit` を Month に設定した場合、`Period` の有効値は 1、2、3、4、5、6、7、8、9、12、24、36、48、60 です。	1
PeriodUnit	string	任意	`Period` で指定された更新期間の単位。有効値： Week Month デフォルト値：Month。	Month
DryRun	boolean	任意	ドライランのみを実行するかどうかを指定します。有効な値： true: ドライランのみを実行します。システムは、無効な AccessKey ペア、権限のない Resource Access Management (RAM) ユーザー、不足しているパラメーター値など、リクエストに潜在的な問題がないかチェックします。リクエストがドライランに失敗すると、エラーメッセージが返されます。リクエストがドライランに成功すると、`DryRunOperation` エラーコードが返されます。 false: ドライランを実行し、実際のリクエストも実行します。リクエストがドライランに成功すると、2xx の HTTP ステータスコードが返され、操作が実行されます。 NFS ボリュームが読み取り専用モードに設定されているかどうかを示します。デフォルト値： false。	false
AutoPay	boolean	任意	支払いを自動的に完了するかどうかを指定します。有効値： true：支払いが自動的に完了します。アカウントの残高が十分であることを確認してください。残高が不足している場合、注文は無効になり、キャンセルする必要があります。 false：注文は生成されますが、支払いは行われません。デフォルト値：true。説明アカウントの残高が不足している場合は、`AutoPay` を `false` に設定して未払いの注文を生成できます。その後、注文の支払いを行うことができます。	false
DedicatedHostChargeType	string	任意	専用ホストの新しい支払い方法。有効値： PrePaid：支払い方法を従量課金からサブスクリプションに変更します。 PostPaid：支払い方法をサブスクリプションから従量課金に変更します。デフォルト値：PrePaid。	PrePaid
ClientToken	string	任意	リクエストのべき等性を保証するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、トークンが異なるリクエスト間で一意であることを確認する必要があります。 `token` には ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性の確保」をご参照ください。	e4567-e89b-12d3-a456-426655440000
DetailFee	boolean	任意	課金方法をサブスクリプションから従量課金に変更する際に、注文の課金詳細を返すかどうかを指定します。 NFS ボリュームを読み取り専用モードに設定するかどうかを指定します。デフォルト値は false です。	false

レスポンスフィールド

フィールド	型	説明	例
	object
OrderId	string	注文の ID。このパラメーターは、支払い方法がサブスクリプションに変更された場合にのみ返されます。	20413515388****
RequestId	string	リクエスト ID。	B61C08E5-403A-46A2-96C1-F7B1216DB10C
FeeOfInstances	object
FeeOfInstance	array<object>	注文の料金に関する詳細。
	object
InstanceId	string	専用ホストの ID。	dh-bp181e5064b5sotrr****
Currency	string	請求書の通貨単位。 Alibaba Cloud 中国サイト (aliyun.com)：CNY Alibaba Cloud 国際サイト (alibabacloud.com)：USD	CNY
Fee	string	請求額。	0

例

成功レスポンス

JSONJSON

{
  "OrderId": "20413515388****",
  "RequestId": "B61C08E5-403A-46A2-96C1-F7B1216DB10C",
  "FeeOfInstances": {
    "FeeOfInstance": [
      {
        "InstanceId": "dh-bp181e5064b5sotrr****",
        "Currency": "CNY",
        "Fee": "0"
      }
    ]
  }
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	InvalidParameter.InstanceIds	The specified InstanceIds are invalid.
400	InvalidParameter	%s
400	InvalidStatus.ValueNotSupported	%s
400	InvalidInstanceChargeType.ValueNotSupported	%s
400	InvalidSpotStrategy	The specified spotStrategy is not valid.
400	ExpiredInstance	The specified instance has expired.
400	InstancesIdQuotaExceed	The maximum number of Instances is exceeded.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.
400	InvalidInstance.UnpaidOrder	The specified instance has unpaid order.
400	ReleaseTimeHaveBeenSet	The specified instance has been set released time.
400	Throttling	Request was denied due to request throttling, please try again after 5 minutes.
400	InvalidPeriod.UnitMismatch	The specified Period must be correlated with the PeriodUnit.
400	InvalidImageType.NotSupported	%s
400	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.
400	InvalidSystemDiskCategory.ValueNotSupported	%s
400	InvalidAccountStatus.PayAmountLimitExceeded	Your account is being restricted, due to no default payment method is set or you has not being authorized.
400	QuotaExceed.AfterpayInstance	The maximum number of Pay-As-You-Go instances is exceeded.
400	QuotaExceed.RufundVcpu	The maximum number of refunded vcpu is exceeded: %s .
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
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	The specified instanceType is not supported by instance with marketplace image.
403	InvalidInstanceType.PhasedOut	This instanceType is no longer offered.
403	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.
403	InvalidOperation.NotSupport	Instance on dedicated host not support modify charge type.
404	InvalidInstanceId.NotFound	The specified instanceId does not exist.
404	InvalidDedicatedHostId.NotFound	The specified Dedicated Host does not exist.

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

変更履歴

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