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--.

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

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

• O nome do bucket não deve iniciar com o prefixo amzn-s3-demo-.

• 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 não podem terminar com o sufixo .mrap. Esse sufixo é reservado para nomes de ponto de acesso de várias regiões. Para ter mais informações, consulte Regras para nomear pontos de acesso multirregionais do Amazon S3.

• Os nomes de bucket não podem terminar com o sufixo --x-s3. Esse sufixo é reservado para buckets de diretório. Para ter mais informações, consulte Regras de nomenclatura de buckets de diretório.

• 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.

Importante

• 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. Observe que, depois que você exclui um bucket, outra Conta da AWS na mesma partição pode usar o mesmo nome de bucket.

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

• amzn-s3-demo-bucket1

• amzn-s3-demo-bucket

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:

• example.com

• www.example.com

• my.example.s3.bucket

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

• amzn_s3_demo_bucket (contém sublinhados)

• AmznS3DemoBucket (contém letras maiúsculas)

• amzn-s3-demo-bucket- (termina com um hífen)

Regras de nomenclatura de buckets de diretório

As regras de nomenclatura a seguir se aplicam a buckets de diretório.

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

• O nome deve ter entre 3 (mín.) e 63 (máx.) 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.

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

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

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

• O nome do bucket não deve iniciar com o prefixo amzn-s3-demo-.

• 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 não podem terminar com o sufixo .mrap. Esse sufixo é reservado para nomes de ponto de acesso de várias regiões. Para ter mais informações, consulte Regras para nomear pontos de acesso multirregionais do Amazon S3.

nota

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

Ao criar um bucket de diretório usando uma API, é necessário 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.