Trabalhar com buckets de diretório
Os buckets de diretório organizam os dados de forma hierárquica em diretórios, ao contrário da estrutura de armazenamento plana dos buckets de uso geral. Não há limites de prefixo para os buckets de diretório, e diretórios individuais podem ser escalados horizontalmente.
Você pode criar até cem buckets de diretório em cada uma de suas Contas da AWS, sem limite no número de objetos que podem ser armazenados em um bucket. A cota de buckets é aplicada a cada região na Conta da AWS. Se for preciso aumentar esse limite para a aplicação, entre em contato com o Suporte.
Importante
Os buckets de diretório em zonas de disponibilidade que não tiverem nenhuma atividade de solicitação por um período de pelo noventa dias passarão para um estado inativo. Enquanto estiver inativo, um bucket de diretório ficará temporariamente inacessível para leituras e gravações. Os buckets inativos retêm todo o armazenamento, os metadados de objetos e os metadados de bucket. As cobranças de armazenamento existentes se aplicam aos buckets inativos. Se você fizer uma solicitação de acesso a um bucket inativo, o bucket passará para um estado ativo, normalmente em alguns minutos. Durante esse período de transição, as leituras e gravações retornarão um código de erro HTTP 503 (Service Unavailable). Isso não se aplica a buckets em zonas locais.
Há vários tipos de bucket do Amazon S3. Antes de criar um bucket, escolha o tipo de bucket que melhor se adapte aos requisitos de performance e da aplicação. Para obter mais informações sobre os vários tipos de bucket e os casos de uso apropriados para cada um, consulte Buckets.
Os tópicos a seguir fornecem informações sobre buckets de diretório. Para obter mais informações sobre os buckets de uso geral, consulte Visão geral dos buckets de uso geral.
Consulte mais informações sobre buckets de diretório nos tópicos a seguir.
Nomes de bucket de diretório
Um nome de bucket de diretório consiste em um nome base que você fornece e um sufixo que contém o ID da zona (zona de disponibilidade ou zona local) em que o bucket está localizado. Os nomes de bucket de diretório devem usar o seguinte formato e seguir as regras de nomenclatura para buckets de diretório:
bucket-base-name--zone-id--x-s3
Por exemplo, o seguinte nome de bucket de diretório contém o ID da zona de disponibilidade usw2-az1:
bucket-base-name--usw2-az1--x-s3
Para obter mais informações, consulte Regras de nomenclatura de buckets de diretório.
Diretórios
Os buckets de diretório organizam os dados de forma hierárquica em diretórios, ao contrário da estrutura de organização plana dos buckets de uso geral.
Com um namespace hierárquico, o delimitador na chave de objeto é importante. O único delimitador compatível é a barra (/). Os diretórios são determinados pelos limites de delimitador. Por exemplo, a chave de objeto dir1/dir2/file1.txt resulta na criação automática dos diretórios dir1/ e dir2/, além da adição do objeto file1.txt ao diretório /dir2 no caminho dir1/dir2/file1.txt.
O modelo de indexação de buckets de diretório retorna resultados não organizados para a operação de API ListObjectsV2. Se precisar limitar os resultados a uma subseção do bucket, você poderá especificar um caminho de subdiretório no parâmetro prefix, como prefix=dir1/.
Nomes de chave
Para buckets de diretório, os subdiretórios que são comuns a várias chaves de objeto são criados com a primeira chave de objeto. As chaves de objeto adicionais para o mesmo subdiretório usam o subdiretório criado anteriormente. Esse modelo oferece flexibilidade na escolha de chaves de objeto mais adequadas à aplicação, com o mesmo suporte a diretórios esparsos e densos.
Gerenciamento de acesso
Os buckets de diretório têm todas as configurações da funcionalidade Bloqueio de Acesso Público do S3 habilitadas por padrão no nível do bucket. A Propriedade de Objetos do S3 está definida como Imposto pelo proprietário do bucket e as listas de controle de acesso (ACLs) estão desabilitadas. Essas configurações não podem ser modificadas.
Por padrão, os usuários não têm permissões para os buckets de diretório. Para conceder permissões de acesso a buckets de diretório, você pode usar o IAM para criar usuários ou perfis e anexar permissões a essas identidades. Para obter mais informações, consulte Autorizar operações de API de endpoint regional com o IAM.
Você também pode controlar o acesso aos buckets de diretório por meio de pontos de acesso. Os pontos de acesso simplificam o gerenciamento do acesso a dados em escala para conjuntos de dados compartilhados no Amazon S3. Pontos de acesso são nomes de host exclusivos que você cria para impor permissões e controles de rede distintos a todas as solicitações feitas por meio de um ponto de acesso. Para obter mais informações, consulte Gerenciar o acesso a conjuntos de dados compartilhados em buckets de diretório por meio de pontos de acesso.
Buckets de diretório
As cotas, também chamadas de limites, correspondem ao número máximo de recursos ou operações de serviço para uma Conta da AWS. A seguir são apresentadas as cotas dos buckets de diretório. Para ter mais informações sobre cotas no Amazon S3, consulte as cotas do Amazon S3.
| Name | Padrão | Ajustável | Descrição |
|---|---|---|---|
| Buckets de diretório | Cada conta: 100 | Sim |
O número de buckets de diretório do Amazon S3 que você pode criar em uma conta. |
| TPS de leitura por bucket de diretório | Cada bucket de diretório: até 200 mil TPS de leitura | Para solicitar um aumento na cota, entre em contato com o Support |
O número de solicitações GET/HEAD por segundo por bucket de diretório. |
| TPS de gravação por bucket de diretório | Cada bucket de diretório: até 100 mil TPS de gravação | Para solicitar um aumento na cota, entre em contato com o Support |
O número de solicitações PUT/DELETE por segundo por bucket de diretório. |
Criar e usar buckets de diretório
Para obter mais informações sobre como trabalhar com buckets de diretório, consulte os tópicos a seguir.
