Verificador de nomes de bucket do S3
Verificar um nome de bucket
Verifica as regras no seu navegador, também off-line. Ele não sabe se outra conta já tem o nome: só criando o bucket dá para saber.
O nome de um bucket de uso geral do S3 precisa ter de 3 a 63 caracteres entre letras minúsculas, números, pontos e hifens, começar e terminar com letra ou número, não ter dois pontos seguidos, não parecer um endereço IP e evitar os prefixos reservados xn--, sthree- e amzn-s3-demo- e os sufixos -s3alias, --ol-s3, .mrap, --x-s3 e --table-s3. Evite pontos, a menos que o bucket hospede apenas um site estático.
Regras de nomenclatura de buckets do S3
Todo bucket novo de uso geral, em qualquer região, precisa seguir todas estas regras:
- Entre 3 e 63 caracteres.
- Apenas letras minúsculas, números, pontos (
.) e hifens (-). - Começa e termina com letra ou número.
- Sem dois pontos seguidos.
- Sem formato de endereço IP, como
192.168.5.4. - Não começa com
xn--,sthree-nemamzn-s3-demo-. - Não termina com
-s3alias(reservado para aliases de pontos de acesso),--ol-s3(aliases de Object Lambda Access Points),.mrap(Multi-Region Access Points),--x-s3(buckets de diretório) nem--table-s3(buckets do S3 Tables). - Termina com
-ansó quando você o cria no namespace regional da sua conta (veja abaixo).
Válido: amzn-s3-demo-bucket aparece na documentação da AWS, mas você não pode criá-lo por causa do prefixo reservado; app-assets-prod-2026 ou logs-a1b2c3d4 servem. Inválido: my_bucket (sublinhado), MyBucket (maiúsculas), example..com (pontos seguidos), my-bucket- (termina com hífen).
Antes de 1 de março de 2018, buckets no Leste dos EUA (Norte da Virgínia) podiam ter nomes de até 255 caracteres com maiúsculas e sublinhados. Alguns ainda existem, por isso você pode vê-los em contas antigas; não é possível criar novos.
Pontos em nomes de bucket e HTTPS
Pontos são válidos, mas causam problemas. As URLs no estilo de hospedagem virtual do S3 colocam o nome do bucket no nome do host, https://bucket-name.s3.region-code.amazonaws.com, e os certificados de segurança que o S3 usa para hospedagem virtual não funcionam para nomes de bucket com pontos. Então uma solicitação para https://logs.example.com.s3.amazonaws.com falha na validação do certificado, a menos que você mesmo valide o certificado. Buckets com pontos também não podem usar o Transfer Acceleration.
A AWS recomenda pontos apenas para buckets usados só para hospedagem de site estático, servido por HTTP. Se você quer um domínio próprio com HTTPS, coloque o CloudFront na frente do bucket; aí o nome do bucket nem precisa corresponder ao domínio.
Nomes globais e o namespace regional da conta
Os nomes de buckets de uso geral ficam em um namespace compartilhado por todas as contas da AWS de uma partição: aws, aws-cn (China), aws-us-gov (GovCloud US) e aws-eusc (European Sovereign Cloud). Se alguém já tem o nome, você não consegue criá-lo e recebe BucketAlreadyExists. Quando um bucket é excluído, o nome pode voltar a ficar disponível, mas não necessariamente logo nem nunca, e outra conta pode pegá-lo e receber solicitações destinadas ao bucket antigo. A AWS recomenda esvaziar um bucket de que você não precisa mais em vez de excluí-lo, se isso importar.
Você pode evitar conflitos criando o bucket no namespace regional da sua conta, uma parte reservada do namespace global em que só a sua conta pode criar buckets. Esses nomes seguem um padrão fixo: seu próprio prefixo, depois o ID de 12 dígitos da sua conta, a região e -an:
aws s3api create-bucket \
--bucket amzn-s3-demo-bucket-111122223333-us-west-1-an \
--bucket-namespace account-regional \
--region us-west-1 \
--create-bucket-configuration LocationConstraint=us-west-1
Substitua o prefixo de exemplo (ele é reservado) e use o ID da sua conta e a sua região. O verificador acima reconhece nomes nesse formato e lembra a qual conta e região eles pertencem.
Como escolher um bom nome de bucket
- Difícil de adivinhar. Se o seu código cria buckets, adicione um sufixo único, como um GUID:
uuidgen | tr -d - | tr '[:upper:]' '[:lower:]'gera 32 caracteres minúsculos, e o código deve saber lidar com um nome já usado. - Sem segredos. O nome aparece em URLs, no DNS e em logs. Não inclua nomes de clientes nem nada sensível.
- Evite "AWS" e "Amazon". A AWS recomenda escolher um nome relacionado a você e não associado a outros.
- Acerte de primeira. Não é possível renomear um bucket nem movê-lo para outra região. O único jeito é criar um bucket novo e copiar, por exemplo com
aws s3 sync s3://old-bucket s3://new-bucket.
Fontes
Perguntas frequentes
Quais são as regras de nomenclatura de buckets do S3?
De 3 a 63 caracteres; apenas letras minúsculas, números, pontos e hifens; começar e terminar com letra ou número; sem dois pontos seguidos; sem formato de endereço IP; sem começar com xn--, sthree- ou amzn-s3-demo-; e sem terminar com -s3alias, --ol-s3, .mrap, --x-s3 ou --table-s3. Nomes que terminam com -an são apenas para buckets no namespace regional da sua conta.
Nomes de bucket do S3 podem ter maiúsculas ou sublinhados?
Não mais. Antes de 1 de março de 2018, buckets no Leste dos EUA (Norte da Virgínia) podiam ter nomes de até 255 caracteres com maiúsculas e sublinhados, e alguns ainda existem, mas todo bucket novo em qualquer região segue as regras atuais.
Devo usar pontos em um nome de bucket?
Só para um bucket usado apenas para hospedagem de site estático. Com um ponto no nome, as solicitações HTTPS no estilo de hospedagem virtual falham na validação do certificado, a menos que você mesmo valide o certificado, e o bucket não pode usar o Transfer Acceleration.
Por que o meu nome de bucket já está em uso?
Os nomes de buckets de uso geral compartilham um único namespace entre todas as contas da AWS da partição, então outra pessoa pode ter o nome. O nome de um bucket excluído pode não voltar a ficar disponível logo, ou nunca. Adicione algo único, como um sufixo aleatório, ou crie o bucket no namespace regional da sua conta.
Posso renomear um bucket do S3?
Não. O nome e a região de um bucket são definidos na criação. Crie um bucket novo com o nome que você quer, copie os objetos (por exemplo com aws s3 sync) e depois exclua o bucket antigo.
Este verificador confere se o nome está livre?
Não. Ele verifica as regras de nomenclatura no seu navegador e não envia nada, então não consegue ver os buckets de outras contas. Criar o bucket é o único teste confiável para saber se um nome está disponível.
O S3 tem uma tela própria no CloudConsole: navegue por buckets e objetos e visualize arquivos em todas as suas contas e regiões, no iPhone e no Android, com as credenciais guardadas no celular.
Sobre o app →