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

Elasticsearch:UpdateInstanceChargeType

最終更新日:Mar 17, 2025

UpdateInstanceChargeType を呼び出して、従量課金インスタンスの課金方法をサブスクリプションに変更します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

リクエストヘッダー

この操作では、共通のリクエストパラメーターのみを使用します。 詳細については、「共通パラメーター」をご参照ください。

リクエスト構文

POST /openapi/instances/[InstanceId]/actions/convert-pay-type HTTPS|HTTP

リクエストパラメーター

パラメータータイプ必須説明
InstanceIdStringはいes-cn-0pp1jxvcl000z****

インスタンス ID。

clientTokenStringいいえ5A2CFF0E-5718-45B5-9D4D-70B3FF****

リクエストの冪等性を保証するためにクライアントによって生成された一意のトークン。 クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。

リクエスト本文

課金方法をサブスクリプションに変換した後のインスタンスの課金情報を指定するには、リクエスト本文で次のパラメーターも指定する必要があります。

パラメーター

タイプ

必須

説明

paymentInfo

配列

はい

変換後のインスタンスの課金情報。

└duration

整数

はい

1

インスタンスの支払い期間。 pricingCycle パラメーターが Year に設定されている場合は 1 ~ 3 。 pricingCycle パラメーターが Month に設定されている場合は 1 ~ 9 。

└pricingCycle

文字列

はい

Year

インスタンスの課金サイクル。 有効な値: Year と Month 。

paymentType

文字列

はい

prepaid

インスタンスの課金方法。 従量課金インスタンスの機能のみをサブスクリプションインスタンスに変換できます。 したがって、このパラメーターは prepaid に設定されます。

説明 └ は子パラメーターを示します。

例:


{
  "paymentInfo":{ 
       "duration":1,
       "pricingCycle":"Month"
    },
  "paymentType":"prepaid"
}
            

レスポンスパラメーター

パラメータータイプ説明
RequestIdString5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1D****

リクエスト ID。

Resultブール値true

結果を返します:

  • true: 変換成功
  • false: 変換失敗

リクエストの例

POST /openapi/instances/es-cn-0pp1jxvcl000z****/actions/convert-pay-type HTTP/1.1
共通リクエストパラメーター
{
  "paymentInfo":{ 
       "duration":1,
       "pricingCycle":"Month"
    },
  "paymentType":"prepaid"
}

成功レスポンスの例

JSON 形式

{
    "Result":true,
    "RequestId":"3760F67B-691D-4663-B4E5-6783554F****"
}

エラーコード

HttpCodeエラーコードエラーメッセージ説明
400InstanceNotFoundThe instanceId provided does not exist.指定されたインスタンスが見つからないために返されたエラーメッセージ。 インスタンスの状態を確認してください。

エラーコードの一覧については、API エラーセンターをご覧ください。