# Desenvolvimento com buckets de diretório
<a name="s3-express-developing"></a>

Depois de criar o bucket de diretório, você pode começar a desfrutar imediatamente de leituras e gravações de latência muito baixa. Você pode se comunicar com o bucket de diretório usando uma conexão de endpoint em uma nuvem privada virtual (VPC) ou pode usar operações de API zonais e regionais para gerenciar objetos e buckets de diretório. É possível trabalhar com buckets de diretório usando os AWS SDKs, o console do Amazon S3, a AWS Command Line Interface (AWS CLI) e APIs REST do Amazon S3.

**Topics**
+ [Endpoints regionais e zonais para buckets de diretório](s3-express-Regions-and-Zones.md)
+ [Trabalhar com buckets de diretório usando o console do S3, a AWS CLI e AWS SDKs](s3-express-SDKs.md)
+ [Operações de API de bucket de diretório](s3-express-APIs.md)

# Endpoints regionais e zonais para buckets de diretório
<a name="s3-express-Regions-and-Zones"></a>

 Para acessar endpoints regionais e zonais de buckets de diretório por meio de sua nuvem privada virtual (VPC), é possível usar endpoints da VPC de gateway. Depois de criar um endpoint de gateway, é possível adicioná-lo como um destino na tabela de rotas para o tráfego destinado da VPC ao bucket. Não há cobrança adicional pelo uso de endpoints do gateway. Para obter mais informações sobre como configurar endpoints de VPC do gateway, consulte [Rede para buckets de diretório](s3-express-networking.md).

 As operações de API no nível do bucket (ambiente de gerenciamento) estão disponíveis por meio de um endpoint regional e são chamadas de operações de API do endpoint regional. Exemplos de operações de API de endpoint regional são `CreateBucket` e `DeleteBucket`. 

Você usa operações de API de endpoint zonal (nível de objeto ou plano de dados) para fazer upload e gerenciar objetos. As operações de API de endpoint zonal estão disponíveis por meio de um endpoint zonal. Exemplos de operações de API zonais são `PutObject` e `CopyObject`.

Para ter mais informações sobre os endpoints regionais e zonais para buckets de diretório em zonas de disponibilidade, consulte [Endpoints regionais e zonais para buckets de diretório em uma zona de disponibilidade](endpoint-directory-buckets-AZ.md).

Para ter mais informações sobre os endpoints regionais e zonais para buckets de diretório em zonas locais, consulte [Conceitos para buckets de diretório em zonas locais](s3-lzs-for-directory-buckets.md).


| Nome da região | Região | IDs de zona de disponibilidade | Endpoint regional | Endpoint zonal | 
| --- | --- | --- | --- | --- | 
|  Leste dos EUA (Norte da Virgínia)  |  `us-east-1`  |  `use1-az4` `use1-az5` `use1-az6`  |  `s3express-control.us-east-1.amazonaws.com` `s3express-control-dualstack.us-east-1.amazonaws.com `  |  `s3express-use1-az4.us-east-1.amazonaws.com` `s3express-use1-az4.dualstack.us-east-1.amazonaws.com` `s3express-use1-az5.us-east-1.amazonaws.com` `s3express-use1-az5.dualstack.us-east-1.amazonaws.com` `s3express-use1-az6.us-east-1.amazonaws.com` `s3express-use1-az6.dualstack.us-east-1.amazonaws.com`  | 
|  Leste dos EUA (Ohio)  |  `us-east-2`  |  `use2-az1` `use2-az2`  |  `s3express-control.us-east-2.amazonaws.com` `s3express-control-dualstack.us-east-2.amazonaws.com`  |  `s3express-use2-az1.us-east-2.amazonaws.com` `s3express-use2-az1.dualstack.us-east-2.amazonaws.com` `s3express-use2-az2.us-east-2.amazonaws.com` `s3express-use2-az2.dualstack.us-east-2.amazonaws.com`  | 
|  Oeste dos EUA (Oregon)  |  `us-west-2`  |  `usw2-az1` `usw2-az3` `usw2-az4`  |  `s3express-control.us-west-2.amazonaws.com` `s3express-control-dualstack.us-west-2.amazonaws.com`  |  `s3express-usw2-az1.us-west-2.amazonaws.com` `s3express-usw2-az1.dualstack.us-west-2.amazonaws.com` `s3express-usw2-az3.us-west-2.amazonaws.com` `s3express-usw2-az3.dualstack.us-west-2.amazonaws.com` `s3express-usw2-az4.us-west-2.amazonaws.com` `s3express-usw2-az4.dualstack.us-west-2.amazonaws.com`  | 
|  Ásia-Pacífico (Mumbai)  |  `ap-south-1`  |  `aps1-az1` `aps1-az3`  |  `s3express-control.ap-south-1.amazonaws.com` `s3express-control-dualstack.ap-south-1.amazonaws.com`  |  `s3express-aps1-az1.ap-south-1.amazonaws.com` `s3express-aps1-az1.dualstack.ap-south-1.amazonaws.com` `s3express-aps1-az3.ap-south-1.amazonaws.com` `s3express-aps1-az3.dualstack.ap-south-1.amazonaws.com`  | 
|  Ásia-Pacífico (Tóquio)  |  `ap-northeast-1`  |  `apne1-az1` `apne1-az4`  |  `s3express-control.ap-northeast-1.amazonaws.com` `s3express-control-dualstack.ap-northeast-1.amazonaws.com`  |  `s3express-apne1-az1.ap-northeast-1.amazonaws.com` `s3express-apne1-az1.dualstack.ap-northeast-1.amazonaws.com` `s3express-apne1-az4.ap-northeast-1.amazonaws.com` `s3express-apne1-az4.dualstack.ap-northeast-1.amazonaws.com`  | 
|  Europa (Irlanda)  |  `eu-west-1`  |  `euw1-az1` `euw1-az3`  |  `s3express-control.eu-west-1.amazonaws.com` `s3express-control-dualstack.eu-west-1.amazonaws.com`  |  `s3express-euw1-az1.eu-west-1.amazonaws.com` `s3express-euw1-az1.dualstack.eu-west-1.amazonaws.com` `s3express-euw1-az3.eu-west-1.amazonaws.com` `s3express-euw1-az3.dualstack.eu-west-1.amazonaws.com`  | 
|  Europa (Estocolmo)  |  `eu-north-1`  |  `eun1-az1` `eun1-az2` `eun1-az3`  |  `s3express-control.eu-north-1.amazonaws.com` `s3express-control-dualstack.eu-north-1.amazonaws.com`  |  `s3express-eun1-az1.eu-north-1.amazonaws.com` `s3express-eun1-az1.dualstack.eu-north-1.amazonaws.com` `s3express-eun1-az2.eu-north-1.amazonaws.com` `s3express-eun1-az2.dualstack.eu-north-1.amazonaws.com` `s3express-eun1-az3.eu-north-1.amazonaws.com` `s3express-eun1-az3.dualstack.eu-north-1.amazonaws.com`  | 

# Trabalhar com buckets de diretório usando o console do S3, a AWS CLI e AWS SDKs
<a name="s3-express-SDKs"></a>

Você pode trabalhar com a classe de armazenamento S3 Express One Zone e os buckets de diretório usando os AWS SDKs, o console do Amazon S3, a AWS CLI (AWS Command Line Interface) e a API REST do Amazon S3.

## Console do S3
<a name="s3-express-getting-started-console"></a>



Para começar a usar o console do S3, siga estas etapas:
+ [Criar buckets de diretório em uma zona de disponibilidade](directory-bucket-create.md)
+ [Esvaziar um bucket de diretório](directory-bucket-empty.md)
+ [Excluir um bucket de diretório](directory-bucket-delete.md)

Para ver um tutorial completo, consulte [Tutorial: Conceitos básicos da classe S3 Express One Zone](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-getting-started.html). 

## AWS SDKs
<a name="s3-express-getting-started-accessing-sdks"></a>

A classe S3 Express One Zone é compatível com os seguintes AWS SDKs:
+ AWS SDK para C\$1\$1
+ AWS SDK para Go v2
+ AWS SDK for Java 2.x
+ AWS SDK para JavaScript v3
+ AWS SDK para .NET
+ AWS SDK para PHP
+ AWS SDK para Python (Boto3)
+ AWS SDK para Ruby
+ AWS SDK para Kotlin
+ AWS SDK para Rust

Ao trabalhar com a classe S3 Express One Zone, recomendamos usar a versão mais recente dos AWS SDKs. Os AWS SDKs compatíveis com a classe S3 Express One Zone lidam com o estabelecimento, a atualização e o encerramento de sessões em seu nome. Isso significa que você pode começar imediatamente a usar as operações de API depois de fazer download e instalar os AWS SDKs e configurar as permissões necessárias do IAM. Para obter mais informações, consulte [Autorizar operações de API de endpoint regional com o IAM](s3-express-security-iam.md).

Para obter informações sobre os AWS SDKs, inclusive sobre como baixá-los e instalá-los, consulte [Aprenda a criar na AWS](https://aws.amazon.com/developer/tools/).

Para obter exemplos de AWS SDK, consulte os seguintes tópicos:
+ [Criar buckets de diretório em uma zona de disponibilidade](directory-bucket-create.md)
+ [Esvaziar um bucket de diretório](directory-bucket-empty.md)
+ [Excluir um bucket de diretório](directory-bucket-delete.md)

## AWS Command Line Interface (AWS CLI)
<a name="s3-express-getting-started-cli"></a>

Você pode usar a AWS Command Line Interface (AWS CLI) para criar buckets de diretório e usar as operações de API de endpoint regional e zonal compatíveis com a classe S3 Express One Zone. 

Para começar a usar a AWS CLI, consulte [Conceitos básicos da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) na *Referência de comandos da AWS CLI*.

**nota**  
Para usar buckets de diretório com os [comandos `aws s3` de alto nível](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html), atualize a AWS CLI para a versão mais recente. Para obter mais informações sobre como instalar e configurar a AWS CLI, consulte [Instalar ou atualize para a versão mais recente da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) na *Referência de comandos da AWS CLI*.

Para obter exemplos da AWS CLI, consulte os seguintes tópicos:
+ [Criar buckets de diretório em uma zona de disponibilidade](directory-bucket-create.md)
+ [Esvaziar um bucket de diretório](directory-bucket-empty.md)
+ [Excluir um bucket de diretório](directory-bucket-delete.md)

# Operações de API de bucket de diretório
<a name="s3-express-APIs"></a>

Para gerenciar bucket de diretório, você pode usar operações de API de endpoint regional (nível de bucket ou ambiente de gerenciamento). Para gerenciar objetos nos buckets de diretório, você poderá usar operações de API de endpoint zonal (nível do objeto ou plano de dados). Para obter mais informações, consulte [Rede para buckets de diretório](s3-express-networking.md) e [Endpoints e endpoints de VPC do gateway](directory-bucket-high-performance.md#s3-express-overview-endpoints).

**Operações de API de endpoint regional**  
As seguintes operações de API de endpoint regional são compatíveis com buckets de diretório: 
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessPoint.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessPoint.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPoint.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPoint.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPointPolicy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPointPolicy.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPointScope.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPointScope.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketPolicy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketPolicy.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPoint.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPoint.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPointPolicy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPointPolicy.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPointScope.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPointScope.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicy.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessPointsForDirectoryBuckets.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessPointsForDirectoryBuckets.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListDirectoryBuckets.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListDirectoryBuckets.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutAccessPointPolicy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutAccessPointPolicy.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutAccessPointScope.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutAccessPointScope.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketPolicy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketPolicy.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html)

**Operações de API de endpoint zonal**  
As seguintes operações de API de endpoint zonal podem ser usadas para buckets de diretório: 
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjects.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjects.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_RenameObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_RenameObject.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html)