Regras de nomeação de bucket

As seguintes regras se aplicam à nomenclatura de buckets de uso geral e buckets de diretório no Amazon S3:

Regras de nomenclatura de buckets de uso geral

As seguintes regras de nomenclatura se aplicam à buckets de uso geral:

• Os nomes dos buckets devem ter entre 3 (mínimo)e 63 (máximo) caracteres.

• Os nomes dos buckets podem consistir apenas em letras minúsculas, números, pontos (.) e hífens (-).

• Os nomes dos buckets devem começar e terminar com uma letra ou um número.

• O nome do bucket não deve conter pontos adjacentes.

• Os nomes de bucket não devem ser formatados como um endereço IP (por exemplo, 192.168.5.4).

• O nome do bucket não deve iniciar com o prefixo xn--.

• Os nomes do bucket não devem iniciar com os prefixos sthree- e sthree-configurator.

• Os nomes de bucket não podem terminar com o sufixo -s3alias. Esse sufixo se reserva a nomes de alias de ponto de acesso. Para ter mais informações, consulte Usar um alias em estilo de bucket para seu ponto de acesso de bucket do S3.

• Os nomes de bucket não podem terminar com o sufixo --ol-s3. Esse sufixo é reservado a nomes de alias de ponto de acesso de objeto do Lambda. Para ter mais informações, consulte Como usar um alias no estilo do bucket para o ponto de acesso do Object Lambda do bucket do S3.

• Os nomes de bucket devem ser exclusivos em todas as Contas da AWS e em todas as Regiões da AWS dentro de uma partição. Uma partição é um agrupamento de regiões. Atualmente, a AWS tem três partições: aws (regiões padrão), aws-cn (regiões da China) e aws-us-gov (AWS GovCloud (US)).

• Um nome de bucket não pode ser usado por outra Conta da AWS na mesma partição enquanto o bucket não for excluído.

• Os buckets usados com o Amazon S3 Transfer Acceleration não podem ter pontos (.) em seus nomes. Para obter mais informações sobre o Transfer Acceleration, consulte Configurar transferências de arquivos rápidas e seguras usando o Amazon S3 Transfer Acceleration.

Para obter a melhor compatibilidade, recomendamos evitar o uso de pontos (.) em nomes de buckets, exceto em buckets usados apenas para hospedagem de sites estáticos. Se você incluir pontos no nome de um bucket, não poderá usar o endereçamento em estilo de host virtual por HTTPS, a menos que execute sua própria validação de certificado. Isso ocorre porque os certificados de segurança usados para hospedagem virtual de buckets não funcionam para buckets com pontos nos nomes.

Essa limitação não afeta os buckets usados para hospedagem de sites estáticos, pois essa hospedagem só está disponível via HTTP. Para obter mais informações sobre o endereçamento no estilo de hospedagem virtual, consulte Hospedagem virtual de buckets. Para obter mais informações sobre hospedagem de sites estáticos, consulte Hospedagem de um site estático usando o Amazon S3.

nota

Antes de 1º de março de 2018, os buckets criados na região Leste dos EUA (Norte da Virgínia) podiam ter nomes com até 255 caracteres e incluíam letras maiúsculas e sublinhados. A partir de 1º de março de 2018, os novos buckets na região Leste dos EUA (Norte da Virgínia) devem estar em conformidade com as mesmas regras aplicadas em todas as outras regiões.

Para obter informações sobre nomes de chave de objeto, consulte Criar nomes de chave de objeto.

Exemplos de nomes de buckets de uso geral

Os seguintes exemplos de nomes de buckets são válidos e seguem as diretrizes de nomenclatura recomendadas:

• docexamplebucket1

• log-delivery-march-2020

• my-hosted-content

Os nomes de buckets de exemplo a seguir são válidos, mas não recomendados para usos que não sejam hospedagem de sites estáticos:

• docexamplewebsite.com

• www.docexamplewebsite.com

• my.example.s3.bucket

Os nomes de buckets de exemplo a seguir não são válidos:

• doc_example_bucket (contém sublinhados)

• DocExampleBucket (contém letras maiúsculas)

• doc-example-bucket- (termina com um hífen)

Regras de nomenclatura de buckets de diretório

Os nomes dos buckets de diretório devem:

• Ser únicos dentro da Região da AWS e da zona de disponibilidade escolhidas.

• Ter entre 3 e 63 caracteres, incluindo o sufixo.

• Consistir em letras minúsculas, números e hifens (-).

• Inicie e termine com uma letra ou um número.

• Deve incluir o seguinte sufixo: --azid--x-s3.

nota

Quando você cria um bucket de diretório usando o console, um sufixo é adicionado automaticamente ao nome base que você fornece. Esse sufixo inclui o ID da zona de disponibilidade que você escolheu.

Ao criar um bucket de diretório usando uma API, você deve fornecer o sufixo completo, incluindo o ID da zona de disponibilidade, na solicitação. Consulte uma lista de IDs de zona de disponibilidade em Zonas de disponibilidade e regiões da classe S3 Express One Zone.