Ao criar um bucket de uso geral, você escolhe seu nome e a Região da AWS onde criá-lo. Depois de criar um bucket de uso geral, não é necessário alterar o nome nem a região. As seções a seguir fornecem informações sobre a nomenclatura de buckets de uso geral, incluindo regras de nomenclatura, práticas recomendadas e um exemplo para criar um bucket de uso geral com um nome que inclui um identificador único universal (GUID).
Consulte as regras de nomenclatura de buckets de diretório em Regras de nomenclatura de buckets de diretório.
Para obter informações sobre nomes de chave de objeto, consulte Criar nomes de chave de objeto.
Tópicos
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 hifens (-). -
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
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 Alias de ponto de acesso. -
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 buckets usados com a funcionalidade Aceleração de Transferências do Amazon S3 não podem ter pontos (
.) nos 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. No momento, a AWS tem três partições:
aws(regiões comerciais),aws-cn(regiões da China) eaws-us-gov(regiões 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. Depois que você excluir um bucket, esteja ciente de que outra Conta da AWS na mesma partição poderá usar o mesmo nome de bucket para um novo bucket e, portanto, potencialmente receber solicitações destinadas ao bucket excluído. Para evitar que isso aconteça, ou se quiser continuar a usar o mesmo nome do bucket, não exclua o bucket. Recomendamos que você esvazie o bucket e o mantenha, bloqueando quaisquer solicitações de bucket conforme necessário.
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.
Exemplos de nomes de buckets de uso geral
Os nomes de bucket a seguir mostram exemplos de quais caracteres são permitidos em nomes de bucket de uso geral: a–z, 0–9 e hifens (-). O prefixo reservado amzn-s3-demo- é usado aqui somente para fins ilustrativos. Como é um prefixo reservado, não é possível criar nomes de bucket que comecem com amzn-s3-demo-.
-
amzn-s3-demo-bucket1-a1b2c3d4-5678-90ab-cdef-example11111 -
amzn-s3-demo-bucket
Os exemplos de nomes de bucket a seguir são válidos, mas não recomendados para usos que não sejam hospedagem de sites estáticos porque contêm pontos (.):
-
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-(começa com o prefixoamzn-s3-demo-e termina com um hífen) -
example..com(contém dois pontos consecutivos) -
192.168.5.4(corresponde ao formato de um endereço IP)
Práticas recomendadas
Ao nomear buckets, considere as práticas recomendadas de nomenclatura de buckets a seguir.
Escolha um esquema de nomenclatura de bucket que não seja suscetível a causar conflitos de nomenclatura
Se a sua aplicação cria buckets automaticamente, escolha um esquema de nomenclatura de bucket que não seja suscetível a causar conflitos de nomenclatura. Certifique-se de que a lógica do seu aplicativo escolha um nome de bucket diferente, caso um nome de bucket já esteja em uso.
Anexe identificadores únicos universais (GUIDs) aos nomes de bucket
Recomendamos que você crie nomes de bucket que não sejam previsíveis. Não escreva código presumindo que o nome do bucket escolhido esteja disponível, a menos que você já tenha criado o bucket. Um método para criar nomes de bucket que não sejam previsíveis é acrescentar um identificador único universal (GUID) ao nome do bucket, por exemplo, amzn-s3-demo-bucket-a1b2c3d4-5678-90ab-cdef-example11111. Para ter mais informações, consulte Criar um bucket que usa um GUID no nome.
Evite usar pontos (.) em nomes de bucket
Para alcançar a melhor compatibilidade, recomendamos evitar o uso de pontos (.) em nomes de bucket, 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 no estilo de host virtual por HTTPS, a menos que execute a própria validação de certificado. 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.
Escolha um nome relevante
Ao nomear um bucket, recomendamos que você escolha um nome que seja relevante para você ou para sua empresa. Evite usar nomes associados a outros. Por exemplo, evite usar AWS ou Amazon no nome do bucket.
Não exclua buckets com o intuito de reutilizar os nomes de bucket
Se um bucket estiver vazio, você poderá excluí-lo. Depois de excluído, o nome do bucket fica disponível para reutilização. No entanto, não há garantia de que você poderá reutilizar o nome imediatamente ou de forma alguma. Após a exclusão de um bucket, pode levar algum tempo até que você possa reutilizar o nome. Além disso, outra Conta da AWS pode criar um bucket com o mesmo nome antes que você consiga reutilizar o nome.
Depois que você excluir um bucket, esteja ciente de que outra Conta da AWS na mesma partição poderá usar o mesmo nome de bucket para um novo bucket e, portanto, potencialmente receber solicitações destinadas ao bucket excluído. Para evitar que isso aconteça, ou se quiser continuar a usar o mesmo nome do bucket, não exclua o bucket. Recomendamos que você esvazie o bucket e o mantenha, bloqueando quaisquer solicitações de bucket conforme necessário.
Criar um bucket que usa um GUID no nome
Os exemplos a seguir mostram como criar um bucket de uso geral que usa um GUID no final do nome.
O exemplo da AWS CLI a seguir cria um bucket na região Oeste dos EUA (N. da Califórnia) (us-west-1) com um exemplo de nome de bucket que usa um identificador único universal (GUID). Para usar esse exemplo de comando, substitua os user input placeholders
aws s3api create-bucket \ --bucketamzn-s3-demo-bucket1$(uuidgen | tr -d - | tr '[:upper:]' '[:lower:]' ) \ --regionus-west-1\ --create-bucket-configuration LocationConstraint=us-west-1
O exemplo a seguir mostra como criar um bucket com um GUID no final do nome na região Leste dos EUA (Norte da Virgínia) (us-east-1) usando o AWS SDK para Java. Para usar esse exemplo, substitua os user input placeholders
import com.amazonaws.regions.Regions;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.Bucket;
import com.amazonaws.services.s3.model.CreateBucketRequest;
import java.util.List;
import java.util.UUID;
public class CreateBucketWithUUID {
public static void main(String[] args) {
final AmazonS3 s3 = AmazonS3ClientBuilder.standard().withRegion(Regions.US_EAST_1).build();
String bucketName = "amzn-s3-demo-bucket" + UUID.randomUUID().toString().replace("-", "");
CreateBucketRequest createRequest = new CreateBucketRequest(bucketName);
System.out.println(bucketName);
s3.createBucket(createRequest);
}
} 