**Aviso**: novas inscrições de clientes e atualizações de conta não estão mais disponíveis para a Amazon. WorkDocs Saiba mais sobre as etapas de migração aqui: [Como migrar dados de WorkDocs](https://aws.amazon.com/blogs/business-productivity/how-to-migrate-content-from-amazon-workdocs).

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á.

# Conecte-se WorkDocs com as credenciais de usuário do IAM e consulte os usuários
<a name="connect-workdocs-iam"></a>

O código a seguir mostra como usar as credenciais de API de um usuário do IAM para fazer chamadas de API. Nesse caso, o usuário da API e o WorkDocs site pertencem à mesma AWS conta.

**nota**  
Para maior segurança, crie usuários federados em vez de usuários do IAM sempre que possível.

Certifique-se de que o usuário do IAM tenha recebido acesso à WorkDocs API por meio de uma política apropriada do IAM.

A amostra de código usa a [DescribeUsers](https://docs.aws.amazon.com/workdocs/latest/APIReference/API_DescribeUsers.html)API para pesquisar usuários e obter metadados para os usuários. Os metadados dos usuários fornecem detalhes como o primeiro nome, sobrenome, ID do usuário e ID da pasta raiz. O ID da pasta raiz é especialmente útil se você deseja executar qualquer operação de upload ou download de conteúdo em nome do usuário.

O código exige que você obtenha uma ID WorkDocs da organização.

Siga estas etapas para obter uma ID da WorkDocs organização no AWS console:

**Como obter um ID de organização**

1. No painel de navegação do [console do AWS Directory Service](https://console.aws.amazon.com/directoryservicev2/), escolha **Diretórios**.

1. Anote o valor **do ID do diretório** que corresponde ao seu WorkDocs site. Essa é a ID da organização do site.

O exemplo a seguir mostra como usar credenciais do IAM para fazer chamadas de API.

```
import java.util.ArrayList;
import java.util.List;

import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.AWSStaticCredentialsProvider;
import com.amazonaws.auth.BasicAWSCredentials;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.workdocs.AmazonWorkDocs;
import com.amazonaws.services.workdocs.AmazonWorkDocsClient;
import com.amazonaws.services.workdocs.model.DescribeUsersRequest;
import com.amazonaws.services.workdocs.model.DescribeUsersResult;
import com.amazonaws.services.workdocs.model.User;

public class GetUserDemo {

  public static void main(String[] args) throws Exception {
    AWSCredentials longTermCredentials =
        new BasicAWSCredentials("{{accessKey}}", "{{secretKey}}");
    AWSStaticCredentialsProvider staticCredentialProvider =
        new AWSStaticCredentialsProvider(longTermCredentials);

    AmazonWorkDocs workDocs =
        AmazonWorkDocsClient.builder().withCredentials(staticCredentialProvider)
            .withRegion(Regions.US_WEST_2).build();

    List<User> wdUsers = new ArrayList<>();
    DescribeUsersRequest request = new DescribeUsersRequest();
	
    // The OrganizationId used here is an example and it should be replaced 
	   // with the OrganizationId of your WorkDocs site.
    request.setOrganizationId("{{d-123456789c}}");
    request.setQuery("{{joe}}");
	
    String marker = null;
    do {
      request.setMarker(marker);
      DescribeUsersResult result = workDocs.describeUsers(request);
      wdUsers.addAll(result.getUsers());
      marker = result.getMarker();
    } while (marker != null);
	
    System.out.println("List of users matching the query string: {{joe}} ");
    
	for (User wdUser : wdUsers) {
      System.out.printf("Firstname:%s | Lastname:%s | Email:%s | root-folder-id:%s\n",
          wdUser.getGivenName(), wdUser.getSurname(), wdUser.getEmailAddress(),
          wdUser.getRootFolderId());
    }
  }
}
```