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

Elasticsearch:Logstash の更新

最終更新日:Mar 17, 2025

RenewLogstash を呼び出して、インスタンスを更新します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer を使用すると、API 操作の検索、API 操作の呼び出し、SDK サンプルコードの動的生成を行うことができます。

リクエストヘッダー

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

リクエスト構文

POST /openapi/logstashes/[InstanceId]/actions/renew HTTPS|HTTP

リクエストパラメーター

パラメーター タイプ 必須 説明
InstanceId 文字列 はい ls-cn-n6w1o5jq****

インスタンス ID。

clientToken 文字列 いいえ 5A2CFF0E-5718-45B5-9D4D-70B3FF****

リクエストの冪等性を保証するためにクライアントによって生成された一意のトークン。 このパラメーターの値はクライアントによって生成され、異なるリクエスト間で一意です。 最大長は 64 ASCII 文字です。

リクエスト本文

リクエスト本文に次のパラメーターを入力します。

フィールド

タイプ

必須

説明

duration

整数

はい

1

サブスクリプション クラスターの更新期間。

pricingCycle が Year に設定されている場合、有効な値は 1 ~ 3 です。

pricingCycle が Month に設定されている場合、有効な値は 1 ~ 9 です。

pricingCycle

文字列

はい

Year

更新の課金サイクル。 有効な値:Year および Month。

サンプルコード:

{
    "duration":1,
    "pricingCycle":"Year"
}

レスポンスパラメーター

パラメーター タイプ 説明
RequestId 文字列 F99407AB-2FA9-489E-A259-40CF6DC****

リクエスト ID。

Result ブール値 true

返された結果:

  • true: 更新成功
  • false: 更新失敗

サンプルリクエスト

POST /openapi/logstashes/ls-cn-n6w1o5jq****/actions/renew HTTP/1.1
共通リクエストヘッダー
{
    "duration":1,
    "pricingCycle":"Year"
}

サンプルの成功レスポンス

JSON 構文

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

エラーコード

HTTP コード エラーコード エラーメッセージ 説明
400 InstanceNotFound 指定された instanceId は存在しません。 インスタンスが見つからないために返されたエラーメッセージ。 インスタンスの状態を確認してください。

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