Skip to main content
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Operações e detalhes de implementação do bucket S3 no StorageGRID

Colaboradores netapp-pcarriga netapp-lhalbert netapp-perveilerk netapp-jsnyder
PDFs

O sistema StorageGRID suporta um máximo de 20.000 buckets para cada conta de locatário S3.

Cada grade pode ter um máximo de 100.000 baldes.

Se vários clientes tiverem até 5.000 buckets cada, cada Storage Node na grade deverá ter no mínimo 64 GB de RAM.

As restrições de nome de bucket seguem as restrições da região AWS US Standard, mas você deve restringi-las ainda mais às convenções de nomenclatura DNS para dar suporte a solicitações no estilo de hospedagem virtual do S3.

Consulte as informações a seguir para obter mais informações:

As operações ListObjects (GET Bucket) e ListObjectVersions (versões do objeto GET Bucket) oferecem suporte ao StorageGRID"valores de consistência" .

Você pode verificar se as atualizações do último tempo de acesso estão habilitadas ou desabilitadas para buckets individuais. Consulte "OBTER último tempo de acesso do Bucket".

A tabela a seguir descreve como o StorageGRID implementa as operações de bucket da API REST do S3. Para realizar qualquer uma dessas operações, as credenciais de acesso necessárias devem ser fornecidas para a conta.

Operação Implementação

CreateBucket

Cria um novo balde. Ao criar o balde, você se torna o proprietário do balde.

Nota: buckets de diretório S3 não são suportados.

  • Os nomes dos buckets devem estar em conformidade com as seguintes regras:

    • Deve ser exclusivo em cada sistema StorageGRID (não apenas exclusivo na conta do locatário).

    • Deve ser compatível com DNS.

    • Deve conter pelo menos 3 e não mais de 63 carateres.

    • Pode ser uma série de uma ou mais etiquetas, com etiquetas adjacentes separadas por um período. Cada rótulo deve começar e terminar com uma letra minúscula ou um número e só pode usar letras minúsculas, números e hífens.

    • Não deve se parecer com um endereço IP formatado em texto.

    • Não deve usar períodos em solicitações de estilo hospedadas virtuais. Os períodos causarão problemas com a verificação do certificado curinga do servidor.

  • Por padrão, os intervalos são criados na us-east-1 região; no entanto, você pode usar o LocationConstraint elemento de solicitação no corpo da solicitação para especificar uma região diferente. Ao usar o LocationConstraint elemento, você deve especificar o nome exato de uma região que foi definida usando o Gerenciador de Grade ou a API de Gerenciamento de Grade. Contacte o administrador do sistema se não souber o nome da região que deve utilizar.

    Nota: Ocorrerá um erro se a sua solicitação CreateBucket usar uma região que não foi definida no StorageGRID.

  • Você pode incluir o x-amz-bucket-object-lock-enabled cabeçalho da solicitação para criar um bucket com S3 Object Lock ativado. Consulte "Use a API REST do S3 para configurar o bloqueio de objetos do S3".

    O S3 Object Lock requer o versionamento de buckets, que é ativado automaticamente quando você cria o bucket com o S3 Object Lock habilitado.

    Você pode habilitar o S3 Object Lock ao criar o bucket ou posteriormente.

DeleteBucket

Elimina o balde.

DeleteBucketCors

Exclui a configuração CORS para o bucket.

DeleteBucketEncryption

Exclui a criptografia padrão do intervalo. Os objetos criptografados existentes permanecem criptografados, mas todos os novos objetos adicionados ao bucket não são criptografados.

DeleteBucketLifecycle

Exclui a configuração do ciclo de vida do bucket. Consulte "Crie a configuração do ciclo de vida do S3".

DeleteBucketPolicy

Exclui a política anexada ao bucket.

DeleteBucketReplication

Exclui a configuração de replicação anexada ao bucket.

DeleteBucketTagging

Usa o tagging subrecurso para remover todas as tags de um bucket.

Atenção: Se uma tag de política ILM não padrão estiver definida para este bucket, haverá uma NTAP-SG-ILM-BUCKET-TAG tag de bucket com um valor atribuído a ela. Não envie uma solicitação DeleteBucketTagging se houver uma NTAP-SG-ILM-BUCKET-TAG tag de bucket. Em vez disso, envie uma solicitação PutBucketTagging contendo apenas a NTAP-SG-ILM-BUCKET-TAG tag e seu valor atribuído para remover todas as outras tags do bucket. Não modifique nem remova a NTAP-SG-ILM-BUCKET-TAG tag do bucket.

GetBucketAcl

Retorna uma resposta positiva e a ID, DisplayName e permissão do proprietário do bucket, indicando que o proprietário tem acesso total ao bucket.

GetBucketCors

Retorna a cors configuração para o bucket.

GetBucketEncryption

Retorna a configuração de criptografia padrão para o bucket.

GetBucketLifecycleConfiguration

(Anteriormente chamado GET Bucket Lifecycle)

Retorna a configuração do ciclo de vida do bucket. Consulte "Crie a configuração do ciclo de vida do S3".

GetBucketlocalização

Retorna a região que foi definida usando o LocationConstraint elemento na solicitação CreateBucket. Se a região do bucket for us-east-1 (padrão), um valor vazio será retornado para LocationConstraint.

GetBucketNotificationConfiguration

(Anteriormente chamado GET Bucket notificação)

Retorna a configuração de notificação anexada ao bucket.

Política de GetBucketPolicy

Retorna a política anexada ao bucket.

GetBucketReplication

Retorna a configuração de replicação anexada ao bucket.

GetBucketTagging

Usa o tagging subrecurso para retornar todas as tags para um bucket.

Atenção: Se uma tag de política ILM não padrão estiver definida para este bucket, haverá uma NTAP-SG-ILM-BUCKET-TAG tag de bucket com um valor atribuído a ela. Não modifique nem remova esta tag.

GetBucketControle de versão

Essa implementação usa versioning o subrecurso para retornar o estado de controle de versão de um bucket.

  • Blank: O controle de versão nunca foi habilitado (bucket é "não versionado")

  • Habilitado: O controle de versão está habilitado

  • Suspenso: O controle de versão foi ativado anteriormente e está suspenso

GetObjectLockConfiguration

Retorna o modo de retenção padrão do bucket e o período de retenção padrão, se configurado.

Consulte "Use a API REST do S3 para configurar o bloqueio de objetos do S3".

Balde para a cabeça

Determina se existe um intervalo e você tem permissão para acessá-lo.

Esta operação retorna:

  • x-ntap-sg-bucket-id: O UUID do bucket no formato UUID.

  • x-ntap-sg-trace-id: O ID de rastreamento exclusivo da solicitação associada.

ListObjects e ListObjectsV2

(Anteriormente chamado GET Bucket)

Retorna alguns ou todos (até 1.000) dos objetos em um bucket. A Classe de armazenamento para objetos pode ter um de dois valores, mesmo que o objeto tenha sido ingerido com a REDUCED_REDUNDANCY opção de classe de armazenamento:

  • STANDARD, Que indica que o objeto está armazenado em um pool de storage que consiste em nós de storage.

  • GLACIER, Que indica que o objeto foi movido para o bucket externo especificado pelo pool de armazenamento em nuvem.

Se o intervalo contiver um grande número de chaves excluídas que tenham o mesmo prefixo, a resposta pode incluir algumas CommonPrefixes que não contêm chaves.

Para as solicitações HeadObject e ListObject, o StorageGRID retorna os registros de data e hora LastModified com precisão diferente, enquanto a AWS retorna os registros de data e hora com a mesma precisão, conforme mostrado nos exemplos a seguir:

  • StorageGRID HeadObject: "Última modificação": "2024-09-26T16:43:24+00:00"

  • Objeto de lista StorageGRID : "Última modificação": "2024-09-26T16:43:24.931000+00:00"

  • AWS HeadObject: "Última modificação": "2023-10-17T00:19:54+00:00"

  • AWS ListObject: "Última modificação": "2023-10-17T00:19:54+00:00"

ListObjectVersions

(Anteriormente CHAMADO OBTER versões de objetos bucket)

Com ACESSO DE LEITURA em um bucket, o uso dessa operação com o versions subrecurso lista metadados de todas as versões de objetos no bucket.

PutBucketCors

Define a configuração do CORS para um bucket de modo que o bucket possa atender às solicitações de origem cruzada. O compartilhamento de recursos de origem cruzada (CORS) é um mecanismo de segurança que permite que aplicativos da Web do cliente em um domínio acessem recursos em um domínio diferente. Por exemplo, suponha que você use um bucket S3 chamado images para armazenar gráficos. Ao definir a configuração CORS para o images intervalo, pode permitir que as imagens nesse intervalo sejam apresentadas no website http://www.example.com.

PutBucketEncryption

Define o estado de encriptação predefinido de um intervalo existente. Quando a criptografia no nível do bucket está ativada, todos os novos objetos adicionados ao bucket são criptografados. O StorageGRID suporta criptografia no lado do servidor com chaves gerenciadas pelo StorageGRID. Ao especificar a regra de configuração de criptografia do lado do servidor, defina o SSEAlgorithm parâmetro como AES256, e não use o KMSMasterKeyID parâmetro.

A configuração de criptografia padrão do bucket é ignorada se a solicitação de upload de objeto já especificar criptografia (ou seja, se a solicitação incluir o x-amz-server-side-encryption-* cabeçalho da solicitação).

PutBucketLifecycleConfiguration

(Anteriormente chamado PUT Bucket Lifecycle)

Cria uma nova configuração de ciclo de vida para o bucket ou substitui uma configuração de ciclo de vida existente. O StorageGRID dá suporte a até 1.000 regras de ciclo de vida em uma configuração de ciclo de vida. Cada regra pode incluir os seguintes elementos XML:

  • Expiração (dias, Data, ExpiredObjectDeleteMarker)

  • Não-currentVersionExpiration (NewerNoncurrentVersions, NoncurrentDays)

  • Filtro (prefixo, Tag)

  • Estado

  • ID

O StorageGRID não oferece suporte a essas ações:

  • AbortIncompleteMultipartUpload

  • Transição

Consulte "Crie a configuração do ciclo de vida do S3". Para entender como a ação de expiração no ciclo de vida do bucket interage com as instruções de posicionamento do ILM, consulte "Como o ILM opera ao longo da vida de um objeto".

Nota: A configuração do ciclo de vida do bucket pode ser usada com buckets que têm o S3 Object Lock ativado, mas a configuração do ciclo de vida do bucket não é suportada para buckets compatíveis com o legado.

PutBucketNotificationConfiguration

(Anteriormente chamada DE NOTIFICAÇÃO PUT Bucket)

Configura notificações para o bucket usando o XML de configuração de notificação incluído no corpo da solicitação. Você deve estar ciente dos seguintes detalhes de implementação:

  • O StorageGRID oferece suporte a tópicos do Amazon Simple Notification Service (Amazon SNS), tópicos do Kafka ou endpoints de webhook como destinos. Os endpoints do Simple Queue Service (SQS) ou do AWS Lambda não são suportados.

  • O destino das notificações deve ser especificado como a URNA de um endpoint do StorageGRID. Os endpoints podem ser criados usando o Gerenciador do Locatário ou a API de Gerenciamento do Locatário.

    O endpoint deve existir para que a configuração de notificação seja bem-sucedida. Se o endpoint não existir, um 400 Bad Request erro é retornado com o código InvalidArgument.

  • Não é possível configurar uma notificação para os seguintes tipos de eventos. Esses tipos de eventos são não suportados.

    • s3:ReducedRedundancyLostObject

    • s3:ObjectRestore:Completed

  • As notificações de eventos enviadas do StorageGRID usam o formato JSON padrão, exceto que elas não incluem algumas chaves e usam valores específicos para outras, como mostrado na lista a seguir:

    • EventSource

      sgws:s3

    • AwsRegion

      não incluído

    • x-amz-id-2

      não incluído

    • arn

      urn:sgws:s3:::bucket_name

Política de PutBucketPolicy

Define a política associada ao bucket. Consulte "Use políticas de acesso de grupo e bucket".

PutBucketReplication

Configura "Replicação do StorageGRID CloudMirror" para o bucket usando o XML de configuração de replicação fornecido no corpo da solicitação. Para a replicação do CloudMirror, você deve estar ciente dos seguintes detalhes de implementação:

  • StorageGRID suporta apenas a V1 da configuração de replicação. Isso significa que StorageGRID não suporta o uso do Filter elemento para regras e segue as convenções da V1 para exclusão de versões de objetos. Para detalhes, consulte "Guia do usuário do Amazon Simple Storage Service: Configuração de replicação".

  • A replicação do bucket pode ser configurada em buckets versionados ou não versionados.

  • Você pode especificar um intervalo de destino diferente em cada regra do XML de configuração de replicação. Um bucket de origem pode ser replicado para mais de um bucket de destino.

  • Os buckets de destino devem ser especificados como o URN dos endpoints do StorageGRID, conforme especificado no Tenant Manager ou na API de Gerenciamento de Tenant. Consulte "Configurar a replicação do CloudMirror".

    O endpoint deve existir para que a configuração de replicação seja bem-sucedida. Se o endpoint não existir, a solicitação falhará como um 400 Bad Request. a mensagem de erro indica: Unable to save the replication policy. The specified endpoint URN does not exist: URN.

  • Não é necessário especificar um Role no XML de configuração. Este valor não é usado pelo StorageGRID e será ignorado se enviado.

  • Se você omitir a classe de armazenamento do XML de configuração, o StorageGRID usará a STANDARD classe de armazenamento por padrão.

  • Se você excluir um objeto do bucket de origem ou excluir o bucket de origem, o comportamento de replicação entre regiões é o seguinte:

    • Se você excluir o objeto ou o bucket antes que ele tenha sido replicado, o objeto/bucket não será replicado e você não será notificado.

    • Se você excluir o objeto ou o bucket depois que ele foi replicado, o StorageGRID segue o comportamento padrão de exclusão do Amazon S3 para V1 TB de replicação entre regiões.

PutBucketTagging

Usa o tagging subrecurso para adicionar ou atualizar um conjunto de tags para um bucket. Ao adicionar etiquetas de bucket, esteja ciente das seguintes limitações:

  • O StorageGRID e o Amazon S3 suportam até 50 tags para cada bucket.

  • As tags associadas a um bucket devem ter chaves de tag exclusivas. Uma chave de tag pode ter até 128 carateres Unicode de comprimento.

  • Os valores de tag podem ter até 256 carateres Unicode de comprimento.

  • Chave e valores são sensíveis a maiúsculas e minúsculas.

Atenção: Se uma tag de política ILM não padrão for definida para este bucket, haverá uma NTAP-SG-ILM-BUCKET-TAG tag de bucket com um valor atribuído a ela. Certifique-se de que a NTAP-SG-ILM-BUCKET-TAG tag de bucket esteja incluída com o valor atribuído em todas as solicitações PutBucketTagging. Não modifique nem remova esta tag.

Nota: Esta operação irá substituir quaisquer tags atuais que o bucket já tenha. Se quaisquer tags existentes forem omitidas do conjunto, essas tags serão removidas para o intervalo.

PutBucketControle de versão

Usa o versioning subrecurso para definir o estado de controle de versão de um bucket existente. Você pode definir o estado de controle de versão com um dos seguintes valores:

  • Habilitado: Permite o controle de versão dos objetos no bucket. Todos os objetos adicionados ao bucket recebem um ID de versão exclusivo.

  • Suspenso: Desativa o controle de versão dos objetos no bucket. Todos os objetos adicionados ao bucket recebem o ID da versão null .

PutObjectLockConfiguration

  • Configura ou remove o modo de retenção padrão do bucket e o período de retenção padrão.

  • Se o administrador da grid tiver concedido permissão, habilita o S3 Object Lock nos buckets existentes.

Se o período de retenção padrão for modificado, a data de retenção das versões existentes do objeto permanece a mesma e não é recalculada usando o novo período de retenção padrão.

Consulte "Use a API REST do S3 para configurar o bloqueio de objetos do S3" para obter informações detalhadas.