CreateAggregator - Cloud Config: Central de Documentação do Alibaba Cloud

Cria um grupo de contas. A conta de gerenciamento ou uma conta de administrador delegado em um diretório de recursos pode criar grupos de contas para gerenciar centralmente recursos, pacotes de conformidade e regras para vários membros.

Descrição da operação

Limites

Uma conta de gerenciamento ou conta de administrador delegado pode criar até 5 grupos de contas. Cada grupo de contas pode conter até 200 contas de membros.

Informações básicas

Para obter mais informações sobre os conceitos e cenários comuns de grupos de contas, e o impacto das alterações de contas de membros em um diretório de recursos no Cloud Config, consulte Visão geral.

O Cloud Config suporta os seguintes tipos de grupos de contas:

Grupo de contas global: Um grupo de contas global contém todos os membros do diretório de recursos e detecta e sincroniza automaticamente as alterações de membros no diretório de recursos. Uma conta de gerenciamento ou conta de administrador delegado pode criar apenas um grupo de contas global.
Grupo de contas personalizado: Quando uma conta de gerenciamento ou conta de administrador delegado cria um grupo de contas personalizado, ela seleciona manualmente todas ou algumas contas de membros do diretório de recursos.
- Quando um novo membro é adicionado ao diretório de recursos, o grupo de contas personalizado não realiza sincronização automática. A conta de gerenciamento ou conta de administrador delegado deve adicionar manualmente o novo membro ao grupo de contas.
- Quando um membro é removido do diretório de recursos, a conta de gerenciamento ou conta de administrador delegado não tem mais as permissões para gerenciar a conformidade desse membro. O grupo de contas personalizado detecta automaticamente essa alteração e remove o membro do grupo de contas personalizado.
Grupo de contas baseado em pasta: Depois que uma conta de gerenciamento ou conta de administrador delegado seleciona uma pasta para criar um grupo de contas, o grupo de contas detecta e executa automaticamente a sincronização das alterações de membros na pasta. Os membros em um grupo de contas baseado em pasta sempre permanecem consistentes com a pasta.

Cada vez que uma conta de gerenciamento ou conta de administrador delegado cria um grupo de contas baseado em pasta, apenas uma pasta não vazia pode ser selecionada.

Descrição da operação

Este tópico fornece um exemplo de como uma conta de gerenciamento cria um grupo de contas personalizado chamado CUSTOM. O nome do grupo de contas é Test_Group e a descrição do grupo de contas é Test group. As informações das contas de membros são as seguintes:

O ID da conta de membro é 171322098523**** e o nome da conta de membro é Alice.
O ID da conta de membro é 100532098349**** e o nome da conta de membro é Tom.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

config:CreateAggregator

create

*Agregador.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
AggregatorName	string	Sim	O nome do grupo de contas.	Example_Aggregator
Description	string	Não	A descrição do grupo de contas.	Agregador de exemplo usado para demonstrar como criar um agregador
AggregatorAccounts	array<object>	Não	Todas as contas de membros no grupo de contas. Nota Se `AggregatorType` estiver definido como `RD`, este parâmetro pode ser deixado vazio, o que indica que todos os membros do diretório de recursos são adicionados ao grupo de contas global. Se `AggregatorType` estiver definido como `FOLDER`, este parâmetro pode ser deixado vazio, o que indica que todos os membros em uma pasta específica do diretório de recursos são adicionados ao grupo de contas baseado em pasta.
	object	Não	As informações da conta de membro.
AccountId	integer	Não	O ID da conta de membro. Para obter informações sobre como obter o ID da conta de membro, consulte ListAccounts.	171322098523****
AccountName	string	Não	O nome da conta de membro. Para obter informações sobre como obter o nome da conta de membro, consulte ListAccounts.	Alice
AccountType	string	Não	A afiliação da conta de membro. Apenas `ResourceDirectory` (diretório de recursos) é suportado.	ResourceDirectory
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja único entre diferentes solicitações. O parâmetro ClientToken suporta apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento.	1594295238-f9361358-5843-4294-8d30-b5183fac****
AggregatorType	string	Não	O tipo do grupo de contas. Valores válidos: RD: grupo de contas global. FOLDER: grupo de contas baseado em pasta. Você também deve especificar FolderId. Para obter informações sobre como obter o ID da pasta, consulte ListAccounts. CUSTOM (padrão): grupo de contas personalizado. Você também deve especificar AccountId e AccountType em AggregatorAccounts.	CUSTOM
FolderId	string	Não	O ID da pasta a ser vinculada. Vários IDs de pasta são suportados. Separe vários IDs de pasta com vírgulas (,). Este parâmetro é obrigatório se AggregatorType estiver definido como `FOLDER`.	fd-brHdgv**,fd-brHdgk**
Tag	array<object>	Não	As tags do recurso. Você pode adicionar até 20 tags.
	object	Não	As tags do recurso. Você pode adicionar até 20 tags.
Key	string	Não	A chave da tag do recurso. Você pode especificar até 20 chaves de tag. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 128 caracteres de comprimento e não pode começar com aliyun ou acs:. A chave da tag não pode conter http:// ou https://.	key-1
Value	string	Não	O valor da tag do recurso. Você pode especificar até 20 valores de tag. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres de comprimento e não pode começar com `aliyun` ou `acs:`. O valor da tag não pode conter `http://` ou `https://`.	value-1

Para obter mais informações sobre parâmetros de solicitação comuns, consulte Parâmetros comuns.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	8195B664-9565-4685-89AC-8B5F04B44B92
AggregatorId	string	O ID do grupo de contas.	ca-dacf86d8314e00eb****

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
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 Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.