O AWS SDK for 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á.

Gerenciar usuários do IAM

Criação de um usuário

Crie um usuário do IAM fornecendo o nome de usuário para o método createUser do AmazonIdentityManagementClient, diretamente ou usando um objeto CreateUserRequest que contém o nome do usuário.

Importações

import com.amazonaws.services.identitymanagement.AmazonIdentityManagement;
import com.amazonaws.services.identitymanagement.AmazonIdentityManagementClientBuilder;
import com.amazonaws.services.identitymanagement.model.CreateUserRequest;
import com.amazonaws.services.identitymanagement.model.CreateUserResult;

Código da

final AmazonIdentityManagement iam =
    AmazonIdentityManagementClientBuilder.defaultClient();

CreateUserRequest request = new CreateUserRequest()
    .withUserName(username);

CreateUserResult response = iam.createUser(request);

Veja o exemplo completo no GitHub.

Listar usuários

Para listar os usuários do IAM da conta, crie um ListUsersRequest e passe para o método listUsers do AmazonIdentityManagementClient. Você pode recuperar a lista de usuários chamando getUsers no objeto ListUsersResult retornado.

A lista de usuários retornados por listUsers é paginada. Você pode verificar se há mais resultados a serem recuperados chamando o método getIsTruncated do objeto de resposta. Se ele retornar true, chame o método setMarker() do objeto da solicitação, passando o valor de retorno do método getMarker() do objeto de resposta.

Importações

import com.amazonaws.services.identitymanagement.AmazonIdentityManagement;
import com.amazonaws.services.identitymanagement.AmazonIdentityManagementClientBuilder;
import com.amazonaws.services.identitymanagement.model.ListUsersRequest;
import com.amazonaws.services.identitymanagement.model.ListUsersResult;
import com.amazonaws.services.identitymanagement.model.User;

Código da

final AmazonIdentityManagement iam =
    AmazonIdentityManagementClientBuilder.defaultClient();

boolean done = false;
ListUsersRequest request = new ListUsersRequest();

while(!done) {
    ListUsersResult response = iam.listUsers(request);

    for(User user : response.getUsers()) {
        System.out.format("Retrieved user %s", user.getUserName());
    }

    request.setMarker(response.getMarker());

    if(!response.getIsTruncated()) {
        done = true;
    }
}

Veja o exemplo completo no GitHub.

Atualizar um usuário

Para atualizar um usuário, chame o método updateUser do objeto do AmazonIdentityManagementClient, que utiliza um objeto UpdateUserRequest que pode ser usado por você para alterar o nome ou o caminho do usuário.

Importações

import com.amazonaws.services.identitymanagement.AmazonIdentityManagement;
import com.amazonaws.services.identitymanagement.AmazonIdentityManagementClientBuilder;
import com.amazonaws.services.identitymanagement.model.UpdateUserRequest;
import com.amazonaws.services.identitymanagement.model.UpdateUserResult;

Código da

final AmazonIdentityManagement iam =
    AmazonIdentityManagementClientBuilder.defaultClient();

UpdateUserRequest request = new UpdateUserRequest()
    .withUserName(cur_name)
    .withNewUserName(new_name);

UpdateUserResult response = iam.updateUser(request);

Veja o exemplo completo no GitHub.

Excluir um usuário

Para excluir um usuário, chame a solicitação deleteUser do AmazonIdentityManagementClient com um objeto UpdateUserRequest definido com o nome de usuário a ser excluído.

Importações

import com.amazonaws.services.identitymanagement.AmazonIdentityManagement;
import com.amazonaws.services.identitymanagement.AmazonIdentityManagementClientBuilder;
import com.amazonaws.services.identitymanagement.model.DeleteConflictException;
import com.amazonaws.services.identitymanagement.model.DeleteUserRequest;

Código da

final AmazonIdentityManagement iam =
    AmazonIdentityManagementClientBuilder.defaultClient();

DeleteUserRequest request = new DeleteUserRequest()
    .withUserName(username);

try {
    iam.deleteUser(request);
} catch (DeleteConflictException e) {
    System.out.println("Unable to delete user. Verify user is not" +
            " associated with any resources");
    throw e;
}

Veja o exemplo completo no GitHub.

Mais informações