mgwutil update-address コマンドは、エージェントの追加、削除、または設定によって、指定されたデータアドレスのエージェント構成を更新します。このコマンドは柔軟な操作を提供し、成功または失敗の結果を明確に返します。
コマンドフォーマット
mgwutil update-address <address-name> [--add-agent <value>] [--delete-agent <value>] [--set-agent <value>]パラメーターの説明
パラメーター | 必須 | 説明 |
address-name | はい | 更新するデータアドレスの名前。 |
--add-agent | いいえ | 追加するエージェント。 |
--delete-agent | いいえ | 削除するエージェント。 |
--set-agent | いいえ | 設定するエージェント。 |
使用例
説明
追加 (--add-agent)、削除 (--delete-agent)、または設定 (--set-agent) のいずれかの操作を指定する必要があります。
エージェントの追加
--add-agent パラメーターを使用して、新しいエージェントをデータアドレスに追加します。
mgwutil update-address mgwutil-address --add-agent "agent2,agent3"エージェントの削除
--delete-agent パラメーターを使用して、特定のエージェントをデータアドレスから削除します。
mgwutil update-address mgwutil-address --delete-agent "agent2,agent3"エージェントの更新
指定したエージェントのデータアドレスを更新するには、--set-agent パラメーターを使用します。
mgwutil update-address mgwutil-address --set-agent "agent1,agent2,agent3"出力
成功応答
{
"Code": "success" ,
"StatusCode": 200,
"LogTime": "2025-12-25 17:51:37",
"Data": {"AgentList" : "agent2,agent3"}
}失敗応答
{
"Code": "fail",
"StatusCode": 404,
"LogTime": "2026-01-16 11:55:52",
"ErrorMsg": "SDKError: StatusCode: 404 Code: NoSuchImportAddress Message: The specified import address does not exist Data: {'AccessDeniedDetail':null,'Recommend':null,'ecCode':null,'hostId':'1****96****9***5.cn-hangzhou.mgw.aliyuncs.com','requestId':'6969B6C84B18D73634B86340','statusCode':404} ",
"ErrorCode": "NoSuchImportAddress",
"RequestId": "6969B6C84B18D73634B86340"
}エラーコード
説明
エラーコードはエラーのカテゴリを表します。詳細については、エラーメッセージ (ErrorMsg) をご参照ください。
このエラーコードは、共通エラーコード の 1 つです。
ErrorCode | 説明 |
NoSuchImportAddress | 指定されたデータアドレスが存在しません。データアドレス名が正しいこと、およびデータアドレスが作成済みであることを確認してください。 |