CreateAggregator - Cloud Config - Centro de documentación de Alibaba Cloud

Crea un grupo de cuentas. La cuenta de administración o una cuenta de administrador delegado en un directorio de recursos puede crear grupos de cuentas para administrar de forma centralizada los recursos, los paquetes de cumplimiento y las reglas de varios miembros.

Descripción de la operación

Límites

Una cuenta de administración o de administrador delegado puede crear hasta 5 grupos de cuentas. Cada grupo de cuentas puede contener hasta 200 cuentas miembro.

Información general

Para obtener más información sobre los conceptos y escenarios comunes de los grupos de cuentas, así como el impacto de los cambios en las cuentas miembro de un directorio de recursos en Cloud Config, consulte Visión general.

Cloud Config admite los siguientes tipos de grupos de cuentas:

Grupo de cuentas global: Un grupo de cuentas global contiene todos los miembros del directorio de recursos y detecta y sincroniza automáticamente los cambios de miembros en el directorio de recursos. Una cuenta de administración o de administrador delegado solo puede crear un grupo de cuentas global.
Grupo de cuentas personalizado: Cuando una cuenta de administración o de administrador delegado crea un grupo de cuentas personalizado, selecciona manualmente todas o algunas de las cuentas miembro del directorio de recursos.
- Cuando se agrega un nuevo miembro al directorio de recursos, el grupo de cuentas personalizado no realiza la sincronización automática. La cuenta de administración o de administrador delegado debe agregar manualmente el nuevo miembro al grupo de cuentas.
- Cuando se elimina un miembro del directorio de recursos, la cuenta de administración o de administrador delegado ya no tiene permisos para administrar el cumplimiento de ese miembro. El grupo de cuentas personalizado detecta automáticamente este cambio y elimina al miembro del grupo de cuentas personalizado.
Grupo de cuentas basado en carpetas: Después de que una cuenta de administración o de administrador delegado selecciona una carpeta para crear un grupo de cuentas, el grupo de cuentas detecta automáticamente y sincroniza los cambios de miembros en la carpeta. Los miembros de un grupo de cuentas basado en carpetas siempre se mantienen consistentes con la carpeta.

Cada vez que una cuenta de administración o de administrador delegado crea un grupo de cuentas basado en carpetas, solo se puede seleccionar una carpeta no vacía.

Descripción de la operación

Este tema proporciona un ejemplo de cómo una cuenta de administración crea un grupo de cuentas personalizado denominado CUSTOM. El nombre del grupo de cuentas es Test_Group y la descripción del grupo de cuentas es Test group. La información de las cuentas miembro es la siguiente:

El ID de la cuenta miembro es 171322098523**** y el nombre de la cuenta miembro es Alice.
El ID de la cuenta miembro es 100532098349**** y el nombre de la cuenta miembro es Tom.

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

config:CreateAggregator

create

*Agregador.

acs:config:*:{#accountId}:aggregator/*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
AggregatorName	string	Sí	El nombre del grupo de cuentas.	Example_Aggregator
Description	string	No	La descripción del grupo de cuentas.	Agregador de ejemplo utilizado para demostrar cómo crear un agregador
AggregatorAccounts	array<object>	No	Todas las cuentas miembro en el grupo de cuentas. Nota Si `AggregatorType` se establece en `RD`, este parámetro puede dejarse vacío, lo que indica que todos los miembros del directorio de recursos se agregan al grupo de cuentas global. Si `AggregatorType` se establece en `FOLDER`, este parámetro puede dejarse vacío, lo que indica que todos los miembros de una carpeta específica del directorio de recursos se agregan al grupo de cuentas basado en carpetas.
	object	No	La información de la cuenta miembro.
AccountId	integer	No	El ID de la cuenta miembro. Para obtener información sobre cómo obtener el ID de la cuenta miembro, consulte ListAccounts.	171322098523****
AccountName	string	No	El nombre de la cuenta miembro. Para obtener información sobre cómo obtener el nombre de la cuenta miembro, consulte ListAccounts.	Alice
AccountType	string	No	La afiliación de la cuenta miembro. Solo se admite `ResourceDirectory` (directorio de recursos).	ResourceDirectory
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero debe asegurarse de que el token sea único entre diferentes solicitudes. El parámetro ClientToken solo admite caracteres ASCII y no puede superar los 64 caracteres de longitud.	1594295238-f9361358-5843-4294-8d30-b5183fac****
AggregatorType	string	No	El tipo de grupo de cuentas. Valores válidos: RD: grupo de cuentas global. FOLDER: grupo de cuentas basado en carpetas. También debe especificar FolderId. Para obtener información sobre cómo obtener el ID de la carpeta, consulte ListAccounts. CUSTOM (valor predeterminado): grupo de cuentas personalizado. También debe especificar AccountId y AccountType en AggregatorAccounts.	CUSTOM
FolderId	string	No	El ID de la carpeta para vincular. Se admiten varios ID de carpeta. Separe varios ID de carpeta con comas (,). Este parámetro es obligatorio si AggregatorType se establece en `FOLDER`.	fd-brHdgv**,fd-brHdgk**
Tag	array<object>	No	Las etiquetas del recurso. Puede agregar hasta 20 etiquetas.
	object	No	Las etiquetas del recurso. Puede agregar hasta 20 etiquetas.
Key	string	No	La clave de etiqueta del recurso. Puede especificar hasta 20 claves de etiqueta. La clave de etiqueta no puede ser una cadena vacía. La clave de etiqueta puede tener hasta 128 caracteres de longitud y no puede comenzar con aliyun o acs:. La clave de etiqueta no puede contener http:// o https://.	key-1
Value	string	No	El valor de etiqueta del recurso. Puede especificar hasta 20 valores de etiqueta. El valor de etiqueta puede ser una cadena vacía. El valor de etiqueta puede tener hasta 128 caracteres de longitud y no puede comenzar con `aliyun` o `acs:`. El valor de etiqueta no puede contener `http://` o `https://`.	value-1

Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
RequestId	string	El ID de la solicitud.	8195B664-9565-4685-89AC-8B5F04B44B92
AggregatorId	string	El ID del grupo de cuentas.	ca-dacf86d8314e00eb****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "8195B664-9565-4685-89AC-8B5F04B44B92",
  "AggregatorId": "ca-dacf86d8314e00eb****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error
400	Invalid.AggregatorAccounts.Empty	You must specify AggregatorAccounts.
400	Invalid.AggregatorAccounts.Value	The specified AggregatorAccounts is invalid.
400	Invalid.AccountType.Value	The specified AccountType is invalid.
400	AggregatorExceedMaxCount	The maximum number of aggregator is exceeded.
400	AggregatorAccountListDuplicated	The aggregator account list is duplicated.
400	AggregatorAccountListItemDuplicated	The aggregator account list item is duplicated.
400	AggregatorNameDuplicated	The aggregator name is duplicated.
403	NoPermissionCreateAggregator	You are not authorized to create the aggregator.
404	AccountNotExisted	Your account does not exist.
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.

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.