# Listar instâncias do recurso Concessão de Acesso do S3
<a name="access-grants-instance-list"></a>

Você também pode listar as instâncias do recurso Concessão de Acesso do S3, incluindo as instâncias compartilhadas com você por meio do AWS Resource Access Manager (AWS RAM).

É possível listar as instâncias do recurso Concessão de Acesso do S3 usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), a API REST do Amazon S3 ou os SDKs da AWS.

## Usar o console do S3
<a name="access-grants-instance-list-console"></a>

**Como listar instâncias do recurso Concessão de Acesso do S3**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação, escolha **Access Grants**.

1. Na página **Concessões de Acesso do S3**, escolha a região que contém a instância da funcionalidade Concessões de Acesso do S3 com a qual você deseja trabalhar.

1. A página **Concessões de Acesso do S3** lista as instâncias da funcionalidade Concessões de Acesso do S3 e todas as instâncias entre contas que foram compartilhadas com sua conta. Para ver os detalhes de uma instância, escolha **Visualizar detalhes**. 

## Como usar o AWS CLI
<a name="access-grants-instance-list-cli"></a>

Para instalar a AWS CLI, consulte [Instalar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) no *Guia do usuário da AWS Command Line Interface*. 

Para usar o comando a seguir, substitua os `user input placeholders` por suas próprias informações.

**Example : listar todas as instâncias da funcionalidade Concessões de Acesso do S3 para uma conta**  
Essa ação lista as instâncias da funcionalidade Concessões de Acesso do S3 para uma conta. Você só pode ter uma instância da funcionalidade Concessões de Acesso do S3 por Região da AWS. Essa ação também lista outras instâncias da funcionalidade Concessões de Acesso do S3 entre contas às quais sua conta tem acesso.   

```
aws s3control list-access-grants-instances \
 --account-id 111122223333 \
 --region us-east-2
```
Resposta:  

```
{
    "AccessGrantsInstanceArn": "arn:aws:s3:us-east-2: 111122223333:access-grants/default",
    "AccessGrantsInstanceId": "default",
    "CreatedAt": "2023-05-31T17:54:07.893000+00:00"
}
```

## Uso da API REST
<a name="access-grants-instance-list-rest-api"></a>

Para obter informações sobre o suporte à API REST do Amazon S3 para gerenciar instâncias da funcionalidade Concessões de Acesso do S3, consulte as seguintes seções na *Referência da API do Amazon Simple Storage Service*:
+  [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessGrantsInstances.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessGrantsInstances.html) 

## Usar SDKs da AWS
<a name="access-grants-instance-list-using-sdk"></a>

Esta seção fornece exemplos de como obter os detalhes de uma instância da funcionalidade Concessões de Acesso do S3 usando os AWS SDKs.

Para usar os exemplos a seguir, substitua `user input placeholders` por suas próprias informações.

------
#### [ Java ]

**Example : listar todas as instâncias da funcionalidade Concessões de Acesso do S3 para uma conta**  
Essa ação lista as instâncias da funcionalidade Concessões de Acesso do S3 para uma conta. Você só pode ter uma instância da funcionalidade Concessões de Acesso do S3 por região. Essa ação também pode listar outras instâncias da funcionalidade Concessões de Acesso do S3 entre contas às quais sua conta tem acesso.   

```
public void listAccessGrantsInstances() {
ListAccessGrantsInstancesRequest listRequest = ListAccessGrantsInstancesRequest.builder()
.accountId("111122223333")
.build();
ListAccessGrantsInstancesResponse listResponse = s3Control.listAccessGrantsInstances(listRequest);
LOGGER.info("ListAccessGrantsInstancesResponse: " + listResponse);
}
```
Resposta:  

```
ListAccessGrantsInstancesResponse(
AccessGrantsInstancesList=[
ListAccessGrantsInstanceEntry(
AccessGrantsInstanceId=default,
AccessGrantsInstanceArn=arn:aws:s3:us-east-2:111122223333:access-grants/default,
CreatedAt=2023-06-07T04:28:11.728Z
)
]
)
```

------