すべてのプロダクト
Search

このプロダクト

    :CreateOrUpdateAssetGroup

    ドキュメントセンター

    :CreateOrUpdateAssetGroup

    最終更新日:Sep 01, 2022

    サーバーグループを作成するか、サーバーグループにサーバーを追加または削除します。

    操作の説明

    サーバーは1つのサーバーグループにのみ属することができます。 If you call the CreateOrUpdateAssetGroup operation and the server specified in request parameters belongs to Server Group A, the server is removed from Server Group A and then added to the newly created or specified server group after the call is complete.

    権限付与情報

    There is currently no authorization information disclosed in the API.

    リクエストパラメーター

    パラメーターデータ型必須／任意説明例
    Uuids文字列任意

    The UUID of the server in the server group that you want to create or the server group for which you want to add or remove servers. 複数のUUIDはコンマ (,) で区切ります。

    NoteYou can call the DescribeCloudCenterInstances operation to query the UUIDs of servers.
    		aq12-***,s23 ***
    GroupName文字列任意

    The name of the server group that you want to create or the server group for which you want to add or remove a server.

    NoteTo modify the mapping between a server and a server group, you must provide the name of the server group. DescribeAllGroups操作を呼び出して、サーバーグループの名前を照会できます。 If you do not configure GroupID when you call this operation, a server group is created. この場合、GroupNameを設定する必要があります。
    		テスト
    GroupIdLong任意

    The ID of the server group for which you want to add to or remove servers.

    注アセットとアセットグループ間のマッピングを変更するには、アセットグループのIDを指定する必要があります。 DescribeAllGroupsを呼び出して、IDを照会できます。 この操作を呼び出すときにこのパラメーターを設定しないと、アセットグループが作成されます。
    		55426

    次に、CreateOrUpdateAssetGroup操作を呼び出してサーバーグループを作成し、サーバーグループにサーバーを追加またはサーバーグループからサーバーを削除するときのリクエストパラメーターの構成の違いを示します。

    • サーバーグループの作成: GroupIdを設定する必要はありませんが、GroupNameを設定する必要があります。 The Uuids parameter is optional.
    • サーバーをサーバーグループに追加または削除する: GroupIdとUuidsの両方を設定する必要があります。 The GroupName parameter is optional.

    すべてのAlibaba Cloud API操作に共通のリクエストパラメーターを含める必要があります。 共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。 サンプルリクエストの詳細については、このトピックの「例」セクションを参照してください。

    レスポンスパラメーター

    パラメーターデータ型説明例
    オブジェクト
    GroupIdLong

    The ID of the server group.

    		9935302
    RequestId文字列

    リクエストのID。問題の特定とトラブルシューティングに使用されます。

    		E70074C8-DFB4-44C5-96C7-909DD231D6 8A

    例

    リクエスト例

    
http(s):// [エンドポイント]/?Action=CreateOrUpdateAssetGroup
&Uuids=aq12-*** 、s23 ***
&GroupName=テスト
&GroupId=55426
&共通リクエストパラメータ

    通常リターン例

    JSON形式

    {
  "GroupId": 9935302,
  "RequestId": "E70074C8-DFB4-44C5-96C7-909DD231D68A"
}

    エラーコード

    Http codeエラーコードエラーメッセージ
    400GroupNameRepeatedグループ名の繰り返し
    400IllegalParam違法なパラム
    500ServerErrorServerError

    For a list of error codes, visit the API error center.