JoinResourceGroup

介面說明

資源是您在阿里雲建立的雲端服務實體，例如，一台 ECS 執行個體、一個 ECS 彈性網路卡或者一份 ECS 映像等都可以是資源。資源群組是專案、環境或者堆疊的基礎設施集合，在資源群組裡管理資源能集中監控和執行任務，免去了您在多種阿里雲服務間反覆查看的負擔。

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作

存取層級

資源類型

條件關鍵字

關聯操作

ecs:JoinResourceGroup

update

DedicatedHost

acs:ecs:{#regionId}:{#accountId}:ddh/{#ddhId}

Disk

acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

NetworkInterface

acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}

Image

acs:ecs:{#regionId}:{#accountId}:image/{#imageId}

Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

KeyPair

acs:ecs:{#regionId}:{#accountId}:keypair/{#keypairId}

LaunchTemplate

acs:ecs:{#regionId}:{#accountId}:launchtemplate/{#launchtemplateId}

SecurityGroup

acs:ecs:{#regionId}:{#accountId}:securitygroup/{#securitygroupId}

Snapshot

acs:ecs:{#regionId}:{#accountId}:snapshot/{#SnapshotId}

無

名稱	類型	必填	描述	樣本值
ResourceType	string	否	ECS 資源的類型。取值範圍： instance：執行個體。 disk：區塊儲存。 snapshot：快照。 image：映像。 securitygroup：安全性群組。 ddh：專有宿主機。 ddhcluster：專有宿主機叢集。 eni：彈性網路卡。 keypair：金鑰對。 launchtemplate：啟動範本。 command：雲端助手命令。 activation：雲端助手託管執行個體啟用碼。 managedinstance：雲端助手託管執行個體。以上參數取值均大小寫敏感。	securitygroup
ResourceId	string	否	資源類型的 ID 標識符。例如，當 ResourceType=instance 時，則 ResourceId 可以理解為 InstanceId。	sg-bp67acfmxazb4p****
RegionId	string	否	資源所在的地域 ID。您可以呼叫 DescribeRegions 查看最新的阿里雲地域列表。	cn-hangzhou
ResourceGroupId	string	否	目標資源群組 ID。	rg-bp67acfmxazb4p****

正常返回樣本

JSON格式

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

異常返回樣本

JSON格式

{
    "RequestId": "C0003E8B-B930-4F59-ADC0-0E20xxxxxxxx"
}

HTTP status code	錯誤碼	錯誤資訊
400	EntityExists.AssociatedTransferTasks	An associated transfer task is in progress. Try again later.
403	MissingParameter	The input parameter "ResourceId" that is mandatory for processing this request is not supplied.
403	InvalidResourceGroup.Duplicate	The ResourceId provided has a ResourceGroup in our records.
403	InvalidRegionId.ResourceGroup	The specified region does not support resource group yet.
403	InvalidStatus.ResourceGroup	You cannot perform an operation on a resource group that is being created or deleted.
404	InvalidResourceType.NotFound	The ResourceType provided does not exist in our records.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.
404	InvalidResourceId.NotFound	The ResourceId provided does not exist in our records.

訪問錯誤中心查看更多錯誤碼。

更多資訊，參考變更詳情。