# Obter os detalhes de uma instância do recurso Concessão de Acesso do S3
<a name="access-grants-instance-view"></a>

É possível obter os detalhes de uma instância do recurso Concessão de Acesso do Amazon S3 em determinada Região da AWS. É possível obter os detalhes da instância 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 e os SDKs da AWS.

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

**Como obter os detalhes de uma instância 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-view-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 : obter os detalhes de uma instância da funcionalidade Concessões de Acesso do S3**  

```
aws s3control get-access-grants-instance \
 --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-view-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_GetAccessGrantsInstance.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessGrantsInstance.html) 
+  [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessGrantsInstanceForPrefix.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessGrantsInstanceForPrefix.html) 

## Usar SDKs da AWS
<a name="access-grants-instance-view-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 : obter uma instância da funcionalidade Concessões de Acesso do S3**  

```
public void getAccessGrantsInstance() {
GetAccessGrantsInstanceRequest getRequest = GetAccessGrantsInstanceRequest.builder()
.accountId("111122223333")
.build();
GetAccessGrantsInstanceResponse getResponse = s3Control.getAccessGrantsInstance(getRequest);
LOGGER.info("GetAccessGrantsInstanceResponse: " + getResponse);
}
```
Resposta:  

```
GetAccessGrantsInstanceResponse(
AccessGrantsInstanceArn=arn:aws:s3:us-east-2: 111122223333:access-grants/default,
CreatedAt=2023-06-07T01:46:20.507Z)
```

------