この操作では、ECSリソースまたはサービスをリソースグループに追加します。

説明

リソースは、ECSインスタンス、elastic network interface (ENI) 、イメージなど、Alibaba cloudで作成するクラウドサービスエンティティです。 リソースグループは、プロジェクト、環境、またはスタックのインフラストラクチャのコレクションです。 リソースグループでは、Alibaba Cloudサービスを切り替えることなく、一元的にリソースを管理し、タスクを監視および実行できます。

デバッグ

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

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 JoinResourceGroup

実行する操作です。 値をJoinResourceGroupに設定します。
ResourceType String 任意 securitygroup

ECSリソースのタイプ。 設定可能な値は以下のとおりです。

  • インスタンス: instance
  • ディスク: Elastic Block Storageデバイス
  • snapshot: snapshot
  • 画像: 画像
  • securitygroup: セキュリティグループ
  • ddh: 専用ホスト
  • ddhcluster: 専用ホストクラスター
  • eni: ENI
  • keypair: SSHキーペア
  • launchtemplate: 起動テンプレート

これらの値は大文字と小文字を区別します。

ResourceId String 任意 sg-bp67acfmxazb4p****

リソースの ID。 このパラメーターは、ResourceTypeの値によって異なります。 たとえば、ResourceTypeがinstanceに設定されている場合、ResourceIdはInstanceIdとして解釈できます。

RegionId String 任意 cn-hangzhou

リソースのリージョンID。 DescribeRegions を呼び出すと、最新のリージョンリストを照会できます。

ResourceGroupId String 任意 rg-bp67acfmxazb4p****

リソースを追加するリソースグループのID。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

リクエストの ID です。

例

リクエストの例

https://ecs.aliyuncs.com/?Action=JoinResourceGroup
&RegionId=cn-hangzhou
&RsourceType=securitygroup
&ResourceId=sg-bp67acfmxazb4p ****
&ResourceGroupId=rg-bp67acfmxazb4p ****
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

<JoinResourceGroupResponse>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</JoinResourceGroupResponse>

JSON 形式 

{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
403 MissingParameter この要求を処理するために必須の入力パラメータ "ResourceId" は指定されていません。 ResourceIdパラメーターが指定されていない場合に返されるエラーメッセージ。
403 MissingParameter このリクエストを処理するために必須の入力パラメーター "ResourceGroupId" が指定されていません。 ResourceGroupIdパラメーターが指定されていない場合に返されるエラーメッセージ。
403 MissingParameter このリクエスト処理に必須の入力パラメータ "RegionId" が指定されていません。 RegionIdパラメーターが指定されていない場合に返されるエラーメッセージ。
404 InvalidResourceType.NotFound 指定されたResourceTypeはレコードに存在しません。 指定されたResourceTypeパラメーターが存在しない場合に返されるエラーメッセージ。
404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records. 指定されたResourceGroupIdパラメーターが存在しない場合に返されるエラーメッセージ。
404 InvalidResourceId.NotFound 指定されたResourceIdはレコードに存在しません。 指定されたResourceIdパラメーターが存在しない場合に返されるエラーメッセージ。
403 InvalidResourceGroup.Duplicate 指定されたResourceIdには、レコードにResourceGroupがあります。 指定されたリソースがすでに別のリソースグループに追加されている場合に返されるエラーメッセージ。

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