Usar aliases de conta do IAM - AWS SDK para Java 1.x

O AWS SDK para Java 1.x chegou end-of-support em 31 de dezembro de 2025. Recomendamos que você migre para o AWS SDK for Java 2.x para continuar recebendo novos recursos, melhorias de disponibilidade e atualizações de segurança.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Usar aliases de conta do IAM

Se deseja que o URL para sua página de login contenha o nome da sua empresa (ou outro identificador amigável) em vez do ID da sua Conta da AWS, você pode criar um alias para o Conta da AWS.

nota

A AWS dá suporte a exatamente um alias por conta.

Criar um alias da conta

Para criar um alias de conta, chame o método createAccountAlias do AmazonIdentityManagementClient com um objeto CreateAccountAliasRequest que contém o nome de alias.

Importações

import com.amazonaws.services.identitymanagement.AmazonIdentityManagement; import com.amazonaws.services.identitymanagement.AmazonIdentityManagementClientBuilder; import com.amazonaws.services.identitymanagement.model.CreateAccountAliasRequest; import com.amazonaws.services.identitymanagement.model.CreateAccountAliasResult;

Código da

final AmazonIdentityManagement iam = AmazonIdentityManagementClientBuilder.defaultClient(); CreateAccountAliasRequest request = new CreateAccountAliasRequest() .withAccountAlias(alias); CreateAccountAliasResult response = iam.createAccountAlias(request);

Veja o exemplo completo no GitHub.

Listar aliases de conta

Para listar o alias da conta, se houver, chame o método listAccountAliases do AmazonIdentityManagementClient.

nota

O ListAccountAliasesResult retornado dá suporte aos mesmos métodos getIsTruncated e getMarker como outros métodos list do AWS SDK para Java, mas uma Conta da AWS pode ter somente um alias de conta.

importações

import com.amazonaws.services.identitymanagement.AmazonIdentityManagement; import com.amazonaws.services.identitymanagement.AmazonIdentityManagementClientBuilder; import com.amazonaws.services.identitymanagement.model.ListAccountAliasesResult;

código

final AmazonIdentityManagement iam = AmazonIdentityManagementClientBuilder.defaultClient(); ListAccountAliasesResult response = iam.listAccountAliases(); for (String alias : response.getAccountAliases()) { System.out.printf("Retrieved account alias %s", alias); }

Veja o exemplo completo no GitHub.

Excluir um alias de conta

Para excluir o alias da sua conta, chame o método deleteAccountAlias do AmazonIdentityManagementClient. Ao excluir um alias de conta, você deve fornecer o nome usando um objeto DeleteAccountAliasRequest.

importações

import com.amazonaws.services.identitymanagement.AmazonIdentityManagement; import com.amazonaws.services.identitymanagement.AmazonIdentityManagementClientBuilder; import com.amazonaws.services.identitymanagement.model.DeleteAccountAliasRequest; import com.amazonaws.services.identitymanagement.model.DeleteAccountAliasResult;

Código da

final AmazonIdentityManagement iam = AmazonIdentityManagementClientBuilder.defaultClient(); DeleteAccountAliasRequest request = new DeleteAccountAliasRequest() .withAccountAlias(alias); DeleteAccountAliasResult response = iam.deleteAccountAlias(request);

Veja o exemplo completo no GitHub.

Mais informações