JoinResourceGroup - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Descripción de la operación

Descripción

Un recurso es una entidad de servicio en la nube que usted crea en Alibaba Cloud. Por ejemplo, una instancia de ECS, una interfaz de red elástica de ECS o una imagen de ECS pueden ser recursos. Un grupo de recursos es una colección de infraestructura para proyectos, entornos o pilas. La gestión de recursos en un grupo de recursos le permite monitorear y ejecutar tareas de manera centralizada, lo que le evita la molestia de cambiar entre múltiples servicios de Alibaba Cloud.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

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}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ResourceType	string	No	El tipo de recurso de ECS. Valores válidos: instance: instancia. disk: almacenamiento de bloques. snapshot: instantánea. image: imagen. securitygroup: security group. ddh: host dedicado. ddhcluster: clúster de hosts dedicados. eni: interfaz de red elástica. keypair: par de claves SSH. launchtemplate: plantilla de lanzamiento. command: comando de Cloud Assistant. activation: código de activación de instancia administrada de Cloud Assistant. managedinstance: instancia administrada de Cloud Assistant. Los valores anteriores distinguen entre mayúsculas y minúsculas.	securitygroup
ResourceId	string	No	El ID del recurso. Por ejemplo, cuando ResourceType se establece en instance, ResourceId se puede interpretar como InstanceId.	sg-bp67acfmxazb4p****
RegionId	string	No	El ID de región del recurso. Puede llamar a DescribeRegions para consultar la lista más reciente de regiones.	cn-hangzhou
ResourceGroupId	string	No	El ID del grupo de recursos de destino.	rg-bp67acfmxazb4p****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	EntityExists.AssociatedTransferTasks	An associated transfer task is in progress. Try again later.	An incomplete security group migration task exists. 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.	The resource has already been added to another resource group.
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.	Operation not allowed while resource group is being created or deleted.
404	InvalidResourceType.NotFound	The ResourceType provided does not exist in our records.	The specified resource type does not exist.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	The specified resource group does not exist.
404	InvalidResourceId.NotFound	The ResourceId provided does not exist in our records.	The specified resource does not exist.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.