コレクターによってインストールされた ECS マシンを更新するには、ModifyDeployMachine を呼び出します。
デバッグ
リクエストヘッダー
この操作では、共通リクエストヘッダーのみを使用します。詳細については、「共通リクエストパラメーター」をご参照ください。
リクエスト構造
POST /openapi/collectors/[ResId]/actions/modify-deploy-machines HTTP/1.1
リクエストパラメーター
| パラメーター | タイプ | 位置 | 必須 | 例 | 説明 |
| ResId | 文字列 | パス | はい | ct-cn-xb1i7q79u65nk**** | コレクター ID。 |
| ClientToken | 文字列 | クエリ | いいえ | 5A2CFF0E-5718-45B5-9D4D-70B3FF**** | このパラメーターは、リクエストのべき等性を確保するために使用されます。このパラメーターの値はクライアントによって生成され、異なるリクエスト間で一意です。最大長は 64 ASCII 文字です。 |
RequestBody
ターゲット ECS インスタンスの情報を指定するには、RequestBody に次のパラメーターを入力する必要があります。
パラメーター | タイプ | 必須 | 例 | 説明 |
machines | リスト | はい | ターゲット ECS インスタンス情報。 | |
└instanceId | 文字列 | はい | i-bp11u91xgubypcuz**** | インスタンスの ID。 |
type | 文字列 | はい | ECSInstanceId | コレクターがデプロイされるマシンのタイプ。 ECSInstanceId（ECS マシンデプロイメント）のみがサポートされています。 |
configType | 文字列 | はい | collectorDeployMachine | 構成のタイプ。 collectorDeployMachine（コレクターのデプロイマシン）のみがサポートされています。 |
レスポンスパラメーター
| パラメーター | タイプ | 例 | 説明 |
| RequestId | 文字列 | C37CE536-6C0F-4778-9B59-6D94C7F7EB63 | リクエストの ID。 |
| Result | ブール値 | true | 更新が成功したかどうか:
|
例
リクエストの例
POST /openapi/collectors/ct-cn-xb1i7q79u65nk **** /actions/modify-deploy-machines HTTP/1.1 public request header {"machines":[ {"instanceId":"i-bp1ei8ysh7orb6eq ****"}, {"instanceId":"i-bp12plyjhrv7eobp ****"} ], "type":"ECSInstanceId", "configType":"collectorDeployMachine"}
成功レスポンスの例
JSON 形式
{ "Result": true, "RequestId": "C37CE536-6C0F-4778-9B59-6D94C7F7EB63" }
エラーコード
エラーコードのリストについては、 API エラーセンター をご覧ください。