AddIpamMembers - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Adiciona membros a serem gerenciados pelo serviço confiável do IPAM.

Descrição da operação

O gerenciamento de várias contas no IPAM só pode ser realizado pelo administrador delegado do IPAM de um diretório de recursos.
O administrador delegado do IPAM pode selecionar uma instância do IPAM em apenas uma região para o gerenciamento de várias contas. O número total de contas de membros gerenciados não pode exceder 1.000.
Importante Quando o membro gerenciado é do tipo Folder, o número de contas de membros gerenciados é calculado com base no número de contas de membros do diretório de recursos contidas no folder.
Os tipos de membros gerenciados incluem Folder e Account:
- Folder: O administrador delegado do IPAM pode visualizar o uso de endereços IP de todas as contas de membros do diretório de recursos sob o folder na região onde o IPAM tem efeito.
- Account: O administrador delegado do IPAM pode visualizar o uso de endereços IP de uma conta especificada do diretório de recursos na região onde o IPAM tem efeito.
Os membros gerenciados não têm permissão para compartilhar a descoberta de recursos com o administrador delegado do IPAM. O administrador delegado do IPAM também não tem permissão para gerenciar membros que já compartilharam sua descoberta de recursos com o administrador.
Depois que o administrador delegado do IPAM adiciona um membro gerenciado pela primeira vez, o serviço confiável do IPAM para o diretório de recursos é ativado.

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

vpc:AddIpamMembers

create

*Todos os recursos.

*

Nenhuma

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região onde o IPAM está hospedado. Você pode chamar a operação DescribeRegions para consultar os IDs das regiões.	cn-hangzhou
DryRun	boolean	Não	Especifica se deve ser realizada apenas uma pré-verificação da solicitação. Valores válidos: true: envia uma solicitação de verificação. Os membros não são adicionados para serem gerenciados pelo serviço confiável do IPAM. O sistema verifica se os parâmetros obrigatórios foram especificados, se o formato da solicitação é válido e se os limites de serviço foram atendidos. Se a solicitação falhar na verificação, um erro será retornado. Se a solicitação passar na verificação, o código de erro DryRunOperation será retornado. false (padrão): envia uma solicitação regular. Se a solicitação passar na verificação, um código de status HTTP 2xx será retornado e os membros serão adicionados para serem gerenciados pelo serviço confiável do IPAM.	false
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 valor, mas deve garantir que ele seja exclusivo entre diferentes solicitações. O token de cliente pode conter apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como o ClientToken. O RequestId de cada solicitação de API pode ser diferente.	123e4567-e89b-12d3-a456-426655440000
Members	array<object>	Sim	Os membros a serem gerenciados pelo serviço confiável do IPAM.
	object	Não
MemberId	string	Não	O ID do membro. Folder ID: o ID do folder. Account UID: o UID das contas de membros no diretório de recursos.	fd-ccccncASqa
MemberType	string	Não	O tipo do membro. Valores válidos: Folder: folder. Account: contas de membros no diretório de recursos. Valores válidos: Account : Contas de membros no folder de recursos. Folder : Folder.	Folder

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	BaseResult.
RequestId	string	O ID da solicitação.	BB2C39DE-CEB8-595A-981A-F2EFCBE7324E

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "BB2C39DE-CEB8-595A-981A-F2EFCBE7324E"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	OperationDenied.MemberIdNotMatchMemberType	The operation is not allowed because the Member ID and Member Type of members [%s] in the input parameters do not match.	O ID do membro e o tipo de membro de %s no parâmetro Members não correspondem.
400	OperationDenied.MemberExistInIpamRDService	The operation is not allowed because %s is under the management of the IPAM.	O membro %s já é gerenciado pelo serviço confiável do IPAM. Você não pode gerenciar o mesmo membro repetidamente.
400	QuotaExceeded.MemberAccount	The operation is not allowed because the number of % managed by IPAM has exceeded the limit, %s/%s.	O número de contas de membro gerenciadas pelo serviço confiável do IPAM excede a cota.
400	OperationDenied.IpamResourceDiscoveryAlreadySharedWithAdmin	The operation is not allowed because the resource discovery has been shared with the IPAM delegated administrator by %s.	O serviço confiável do IPAM não pode gerenciar contas que já compartilharam sua descoberta de recursos com um administrador delegado.
400	OperationDenied.IpamRDServiceAlreadyEnabledInOtherRegion	The operation is not allowed because the IPAM Resource Directory service is already enabled in another region.	Você pode selecionar apenas uma instância IPAM em uma única região para gerenciar os membros do diretório de recursos.
400	OperationDenied.AccountNotRDEntity	The operation is not allowed because the caller does not belong to the resource directory.	O chamador não pertence a nenhum diretório de recursos. O gerenciamento de membros do serviço confiável do IPAM não é permitido.
400	OperationDenied.NotDelegatedAdminAccount	The operation is not allowed because the caller is not the delegated IPAM admin for the resource directory.	O chamador não é o administrador delegado do serviço confiável do IPAM para o diretório de recursos atual. Você não pode gerenciar os membros do serviço confiável do IPAM.
400	OperationDenied.IpamNotExist	The operation is not allowed because the IPAM does not exist.	O IPAM não existe na região atual. O gerenciamento de membros do serviço confiável do IPAM não é permitido.
400	OperationDenied.DelegateAdminAsMember	The operation is not allowed because the IPAM delegate administrator cannot be a member.	Um administrador delegado do IPAM não pode adicionar a si mesmo como membro do serviço confiável do IPAM.
400	OperationDenied.NoServicePrincipalAdminPrivileges	The operation is not allowed because the caller is not the delegated IPAM admin for the resource directory.	O chamador não é o administrador delegado do serviço confiável do IPAM para o diretório de recursos atual. Você não pode gerenciar os membros do serviço confiável do IPAM.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.