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

Adiciona membros a um IP Address Manager (IPAM).

Descrição da operação

Apenas o administrador delegado de uma instância IPAM em um diretório de recursos pode realizar o gerenciamento de múltiplas contas.
Um administrador delegado do IPAM pode usar uma instância IPAM em apenas uma região para gerenciamento de múltiplas contas. É possível adicionar no máximo 1.000 contas de membros.

Importante
Se você adicionar uma pasta como membro, o sistema contará todas as contas de membros do diretório de recursos que estão na pasta.
Os membros podem ser do tipo Folder ou Account.
- Folder: O administrador delegado do IPAM pode visualizar o uso de IP na região efetiva do IPAM para todas as contas de membros do diretório de recursos na pasta.
- Account: O administrador delegado do IPAM pode visualizar o uso de IP na região efetiva do IPAM para a conta de membro especificada do diretório de recursos.
Um membro gerenciado não pode compartilhar sua descoberta de recursos com o administrador delegado do IPAM. O administrador delegado do IPAM não pode adicionar um membro se esse membro já tiver compartilhado sua descoberta de recursos.
Adicionar o primeiro membro ativa o serviço confiável do IPAM para o diretório de recursos.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

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 hospedada do IPAM. Chame a operação DescribeRegions para obter o ID da região.	cn-hangzhou
DryRun	boolean	Não	Especifica se deve ser realizado um dry run. Valores válidos: true: Realiza um dry run. A solicitação é verificada quanto a parâmetros obrigatórios, formato da solicitação e limites do serviço. Os membros não são adicionados ao serviço confiável do IPAM. Se a verificação for aprovada, o código de erro DryRunOperation é retornado. Se a verificação falhar, um erro é retornado. false (Padrão): Envia uma solicitação. Se a solicitação passar na verificação, os membros são adicionados ao serviço confiável do IPAM e um código de status HTTP 2xx é retornado.	false
ClientToken	string	Não	Um token de cliente para garantir a idempotência da solicitação. Gere um valor exclusivo do seu cliente para cada solicitação. O parâmetro ClientToken suporta apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará o RequestId da solicitação de API como o ClientToken. O RequestId pode ser diferente para cada solicitação de API.	123e4567-e89b-12d3-a456-426655440000
Members	array<object>	Sim	Os membros gerenciados pelo serviço confiável do IPAM.
	object	Não
MemberId	string	Não	O ID do membro. ID da Pasta: O ID da pasta. UID da Conta: O UID de uma conta de membro no diretório de recursos.	fd-ccccncASqa
MemberType	string	Não	O tipo de membro. Valores válidos: Folder: Uma pasta. Account: Uma conta de membro em um diretório de recursos. Valores válidos: Account : Uma conta de membro em um diretório de recursos. Folder : Uma pasta em um diretório de recursos.	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.	The Member Id and Member Type of [%s] in the input Members do not match.
400	OperationDenied.MemberExistInIpamRDService	The operation is not allowed because %s is under the management of the IPAM.	The input parameter %s has already been managed by IPAM trusted service. The same member cannot be managed repeatedly.
400	QuotaExceeded.MemberAccount	The operation is not allowed because the number of % managed by IPAM has exceeded the limit, %s/%s.	The member account managed by IPAM trusted service exceeds the quota limit.
400	OperationDenied.IpamResourceDiscoveryAlreadySharedWithAdmin	The operation is not allowed because the resource discovery has been shared with the IPAM delegated administrator by %s.	The IPAM Trusted Service does not allow the management of accounts that have already shared their resource discovery with the delegated administrator.
400	OperationDenied.IpamRDServiceAlreadyEnabledInOtherRegion	The operation is not allowed because the IPAM Resource Directory service is already enabled in another region.	Only one IPAM instance can be selected to manage resource directory members.
400	OperationDenied.AccountNotRDEntity	The operation is not allowed because the caller does not belong to the resource directory.	The caller does not belong to any resource directory and is not allowed to manage IPAM trusted service members.
400	OperationDenied.NotDelegatedAdminAccount	The operation is not allowed because the caller is not the delegated IPAM admin for the resource directory.	The caller is not the delegated administrator of the IPAM trusted service in the resource directory. IPAM trusted service members are not allowed to be managed.
400	OperationDenied.IpamNotExist	The operation is not allowed because the IPAM does not exist.	IPAM does not exist in the current region. IPAM trusted service members cannot be managed.
400	OperationDenied.DelegateAdminAsMember	The operation is not allowed because the IPAM delegate administrator cannot be a member.	IPAM delegated administrators cannot add themselves as members of the IPAM trusted service.
400	OperationDenied.NoServicePrincipalAdminPrivileges	The operation is not allowed because the caller is not the delegated IPAM admin for the resource directory.	The caller is not the delegated administrator of the IPAM trusted service in the resource directory. IPAM trusted service members are not allowed to be managed.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.