# Excluir uma instância da funcionalidade Concessões de Acesso do S3
<a name="access-grants-instance-delete"></a>

Você pode excluir uma instância da funcionalidade Concessões de Acesso do Amazon S3 de uma Região da AWS em sua conta. No entanto, antes de excluir uma instância da funcionalidade Concessões de Acesso do S3, é necessário fazer o seguinte:
+ Exclua todos os recursos na instância da funcionalidade Concessões de Acesso do S3, incluindo todas as concessões e locais. Para obter mais informações, consulte [Delete a grant](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-grant-delete.html) e [Delete a location](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-grant-location.html).
+ Se você associou uma instância do Centro de Identidade do AWS IAM à sua instância da funcionalidade Concessões de Acesso do S3, deverá desassociar a instância do Centro de Identidade do IAM. Para obter mais informações, consulte [Associar ou desassociar uma instância do Centro de Identidade do IAM](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-instance-idc.html).

**Importante**  
Se você excluir uma instância da funcionalidade Concessões de Acesso do S3, a exclusão será permanente e não poderá ser desfeita. Todos os beneficiários que receberam acesso por meio das concessões nessa instância da funcionalidade Concessões de Acesso do S3 perderão o acesso aos dados do S3. 

Você pode excluir uma instância da funcionalidade Concessões 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 AWS SDKs.

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

**Como excluir uma instância da funcionalidade Concessões 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. Escolha **Visualizar detalhes** da instância. 

1. Na página de detalhes da instância, escolha **Excluir instância** no canto superior direito. 

1. Na caixa de diálogo exibida, escolha **Excluir**. Essa ação não pode ser desfeita.

## Como usar o AWS CLI
<a name="access-grants-instance-delete-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.

**nota**  
Antes de excluir uma instância da funcionalidade Concessões de Acesso do S3, primeiro é necessário excluir todas as concessões e locais criados na instância da funcionalidade Concessões de Acesso do S3. Se você associou uma instância do Centro de Identidade do IAM à sua instância da funcionalidade Concessões de Acesso do S3, deverá desassociá-la primeiro.

**Example : excluir uma instância da funcionalidade Concessões de Acesso do S3**  

```
aws s3control delete-access-grants-instance \
--account-id 111122223333 \
--profile access-grants-profile \
--region us-east-2 \
--endpoint-url https://s3-control.us-east-2.amazonaws.com \
 
 // No response body
```

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

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

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

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

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

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

**nota**  
Antes de excluir uma instância da funcionalidade Concessões de Acesso do S3, primeiro é necessário excluir todas as concessões e locais criados na instância da funcionalidade Concessões de Acesso do S3. Se você associou uma instância do Centro de Identidade do IAM à sua instância da funcionalidade Concessões de Acesso do S3, deverá desassociá-la primeiro.

**Example : excluir uma instância da funcionalidade Concessões de Acesso do S3**  

```
public void deleteAccessGrantsInstance() {
DeleteAccessGrantsInstanceRequest deleteRequest = DeleteAccessGrantsInstanceRequest.builder()
.accountId("111122223333")
.build();
DeleteAccessGrantsInstanceResponse deleteResponse = s3Control.deleteAccessGrantsInstance(deleteRequest);
LOGGER.info("DeleteAccessGrantsInstanceResponse: " + deleteResponse);
}
```

------