Skip to main content
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Operaciones en bloques

Colaboradores

El sistema StorageGRID admite un máximo de 1,000 bloques para cada cuenta de inquilino de S3.

Las restricciones de nombre de bloque siguen las restricciones de región estándar de AWS EE.UU., pero debe restringirlas a las convenciones de nomenclatura DNS para admitir solicitudes virtuales de estilo hospedado de S3.

En la siguiente sección, se ofrece más información:

Las operaciones ListObjects (GET Bucket) y ListObjectVersions (GET Bucket object versions) admiten StorageGRID "valores de coherencia".

Puede comprobar si las actualizaciones a la hora del último acceso están habilitadas o deshabilitadas para grupos individuales. Consulte "HORA de último acceso al bloque DE GET".

En la siguiente tabla se describe cómo StorageGRID implementa operaciones de bloque de API DE REST de S3. Para realizar alguna de estas operaciones, se deben proporcionar las credenciales de acceso necesarias para la cuenta.

Funcionamiento Implementación

CreateBucket

Crea un nuevo cucharón. Al crear la cuchara, se convierte en el propietario de la cuchara.

  • Los nombres de los bloques deben cumplir con las siguientes reglas:

    • Debe ser único en cada sistema StorageGRID (no solo dentro de la cuenta de inquilino).

    • Debe ser compatible con DNS.

    • Debe incluir al menos 3 y no más de 63 caracteres.

    • Puede ser una serie de una o más etiquetas, con etiquetas adyacentes separadas por un punto. Cada etiqueta debe comenzar y terminar con una letra minúscula o un número y solo puede utilizar letras minúsculas, números y guiones.

    • No debe ser una dirección IP con formato de texto.

    • No debe utilizar periodos en solicitudes de estilo alojadas virtuales. Los períodos provocarán problemas en la verificación del certificado comodín del servidor.

  • De forma predeterminada, los bloques se crean en la us-east-1 región; sin embargo, puede utilizar la LocationConstraint elemento de solicitud en el cuerpo de solicitud para especificar una región diferente. Cuando utilice la LocationConstraint Elemento, debe especificar el nombre exacto de una región que se ha definido mediante el Administrador de grid o la API de gestión de grid. Póngase en contacto con el administrador del sistema si no conoce el nombre de región que debe utilizar.

    Nota: Se producirá un error si su solicitud de CreateBucket utiliza una región que no se ha definido en StorageGRID.

  • Puede incluir el x-amz-bucket-object-lock-enabled Solicite el encabezado para crear un bucket con el bloqueo de objetos S3 habilitado. Consulte "Use la API REST DE S3 para configurar el bloqueo de objetos de S3".

    Debe habilitar S3 Object Lock cuando crea el bloque. No puede agregar o deshabilitar S3 Object Lock después de crear un bucket. S3 Object Lock requiere el control de versiones de bloques, que se habilita automáticamente al crear el bloque.

DeleteBucket

Elimina el cucharón.

DeleteBucketCors

Elimina la configuración de CORS para el cucharón.

DeleteBucketEncryption

Elimina el cifrado predeterminado del depósito. Los objetos cifrados existentes permanecen cifrados, pero todos los objetos nuevos agregados al depósito no están cifrados.

DeleteBucketLifecycle

Elimina la configuración del ciclo de vida del depósito. Consulte "Cree una configuración del ciclo de vida de S3".

DeleteBucketPolicy

Suprime la política asociada al depósito.

DeleteBucketReplication

Suprime la configuración de replicación asociada al depósito.

DeleteBucketTagging

Utiliza la tagging subrecurso para quitar todas las etiquetas de un bloque.

Precaución: Si se establece una etiqueta de política de ILM no predeterminada para este depósito, habrá un NTAP-SG-ILM-BUCKET-TAG etiqueta de segmento con un valor asignado. No emita una solicitud DeleteBucketTagging si hay un NTAP-SG-ILM-BUCKET-TAG etiqueta del cucharón. En su lugar, emita una solicitud PutBucketTagging con solo el NTAP-SG-ILM-BUCKET-TAG etiqueta y su valor asignado para eliminar todas las demás etiquetas del depósito. No modifique ni elimine el NTAP-SG-ILM-BUCKET-TAG etiqueta del cucharón.

GetBucketAcl

Devuelve una respuesta positiva y el ID, DisplayName y el permiso del propietario del depósito, lo que indica que el propietario tiene acceso completo al depósito.

GetBucketCors

Devuelve el cors configuración del bloque.

GetBucketEncryption

Devuelve la configuración de cifrado predeterminada para el depósito.

GetBucketLifecycleConfiguration

(Anteriormente llamado GET Bucket Lifecycle)

Devuelve la configuración del ciclo de vida del cucharón. Consulte "Cree una configuración del ciclo de vida de S3".

GetBucketLocation

Devuelve la región que se ha definido mediante el LocationConstraint En la solicitud CreateBucket. Si la región del cucharón es us-east-1, se devuelve una cadena vacía para la región.

GetBucketNotificationConfiguration

(Con el nombre anterior, GET Bucket notification)

Devuelve la configuración de notificación adjunta al depósito.

GetBucketPolicy

Devuelve la política adjunta al depósito.

GetBucketReplication

Devuelve la configuración de replicación asociada al bloque.

Etiquetado de GetBucketTagging

Utiliza la tagging subrecurso para devolver todas las etiquetas de un bloque.

Precaución: Si se establece una etiqueta de política de ILM no predeterminada para este depósito, habrá un NTAP-SG-ILM-BUCKET-TAG etiqueta de segmento con un valor asignado. No modifique ni elimine esta etiqueta.

GetBucketVersioning

Esta implementación usa la versioning subrecurso para devolver el estado de control de versiones de un bloque.

  • BLANK: El control de versiones nunca se ha activado (el bloque no está versionado)

  • Activado: El control de versiones está activado

  • Suspendido: El control de versiones se ha habilitado anteriormente y se ha suspendido

GetObjectLockConfiguration

Devuelve el modo de retención predeterminado del depósito y el período de retención predeterminado, si está configurado.

Segmento de cabeza

Determina si existe un bloque y tiene permiso para acceder a él.

Esta operación devuelve:

  • x-ntap-sg-bucket-id: El UUID del bloque en formato UUID.

  • x-ntap-sg-trace-id: El ID de traza único de la solicitud asociada.

ListObjects y ListObjectsV2

(Anteriormente denominado GET Bucket)

Devuelve algunos o todos (hasta 1.000) de los objetos de un cubo. La clase de almacenamiento para los objetos puede tener cualquiera de dos valores, incluso si el objeto se ingirió con la REDUCED_REDUNDANCY opción de clase de almacenamiento:

  • STANDARD, Que indica que el objeto se almacena en una agrupación de almacenamiento que consta de nodos de almacenamiento.

  • GLACIER, Que indica que el objeto se ha movido al bloque externo especificado por el grupo de almacenamiento en la nube.

Si el bloque contiene un gran número de claves eliminadas que tienen el mismo prefijo, la respuesta podría incluir algunas CommonPrefixes que no contienen claves.

ListObjectVersions

(Versiones de objeto GET Bucket con nombre anterior)

Con acceso DE LECTURA en un bloque, usando esta operación con el versions subrecurso enumera los metadatos de todas las versiones de objetos del bloque.

A cargo de PutBucketCors

Establece la configuración de CORS para un depósito para que éste pueda atender solicitudes de origen cruzado. El uso compartido de recursos de origen cruzado (CORS) es un mecanismo de seguridad que permite a las aplicaciones web de cliente de un dominio acceder a los recursos de un dominio diferente. Por ejemplo, supongamos que se utiliza un bloque de S3 llamado images para almacenar gráficos. Mediante el ajuste de la configuración de CORS para images bloque, puede permitir que las imágenes de ese bloque se muestren en el sitio web http://www.example.com.

PutBucketEncryption

Establece el estado de cifrado predeterminado de un depósito existente. Cuando se habilita el cifrado a nivel de bloque, se cifran todos los objetos nuevos que se añadan al bloque.StorageGRID admite el cifrado en el lado del servidor con claves gestionadas por StorageGRID. Al especificar la regla de configuración de cifrado del servidor, defina la SSEAlgorithm parámetro a. AES256, y no utilice el KMSMasterKeyID parámetro.

La configuración de cifrado predeterminada de bloque se omite si la solicitud de carga de objeto ya especifica cifrado (es decir, si la solicitud incluye la x-amz-server-side-encryption-* encabezado de solicitud).

PutBucketLifecycleConfiguration

(Anteriormente llamado PUT Bucket Lifecycle)

Crea una nueva configuración de ciclo de vida para el bloque o sustituye a una configuración de ciclo de vida existente. StorageGRID admite hasta 1,000 reglas de ciclo de vida en una configuración del ciclo de vida. Cada regla puede incluir los siguientes elementos XML:

  • Caducidad (días, fecha, ExpiredObjectDeleteMarker)

  • Caducidad de versiones sin corriente (NewerNoncurrentVersions, NoncurrentDays)

  • Filtro (prefijo, etiqueta)

  • Estado

  • ID

StorageGRID no admite estas acciones:

  • AbortEncompleteMultipartUpload

  • Transición

Consulte "Cree una configuración del ciclo de vida de S3". Para comprender cómo la acción de caducidad en un ciclo de vida de bloques interactúa con las instrucciones de ubicación de ILM, consulte "Cómo funciona ILM a lo largo de la vida de un objeto".

Nota: La configuración del ciclo de vida de la cuchara se puede utilizar con cucharones que tengan habilitado el bloqueo de objetos S3, pero la configuración del ciclo de vida de la cuchara no es compatible con cucharones legados compatibles.

PutBucketNotificationConfiguration

(Anteriormente denominado notificación PUT Bucket)

Configura las notificaciones para el depósito mediante el XML de configuración de notificación incluido en el cuerpo de la solicitud. Debe tener en cuenta los siguientes detalles de implementación:

  • StorageGRID admite los temas Kafka o Amazon Simple Notification Service (Amazon SNS) como destinos. No se admiten los puntos finales de Simple Queue Service (SQS) o Amazon Lambda.

  • El destino de las notificaciones debe especificarse como URN de un extremo de StorageGRID. Se pueden crear extremos con el administrador de inquilinos o la API de gestión de inquilinos.

    El extremo debe existir para que la configuración de la notificación se realice correctamente. Si el extremo no existe, un 400 Bad Request se devuelve un error con el código InvalidArgument.

  • No puede configurar una notificación para los siguientes tipos de evento. Estos tipos de evento no son compatibles.

    • s3:ReducedRedundancyLostObject

    • s3:ObjectRestore:Completed

  • Las notificaciones de eventos enviadas desde StorageGRID utilizan el formato JSON estándar, excepto que no incluyen algunas claves y utilizan valores específicos para otros, como se muestra en la lista siguiente:

    • EventSource

      sgws:s3

    • * AwsRegion*

      no incluido

    • x-amz-id-2

      no incluido

    • arn

      urn:sgws:s3:::bucket_name

Política de PutBucketPolicy

Define la política asociada al depósito. Consulte "Utilice las políticas de acceso de bloques y grupos".

PutBucketReplication

Configura "Replicación de CloudMirror de StorageGRID" Para el depósito que utiliza el XML de configuración de replicación proporcionado en el cuerpo de la solicitud. Para la replicación de CloudMirror, debe tener en cuenta los siguientes detalles de la implementación:

  • StorageGRID solo admite V1 de la configuración de replicación. Esto significa que StorageGRID no admite el uso de Filter Elemento para reglas y sigue las convenciones V1 para eliminar versiones de objetos. Para obtener más información, consulte "Guía del usuario de Amazon Simple Storage Service: Configuración de replicación".

  • La replicación de bloques se puede configurar en bloques con versiones o sin versiones.

  • Puede especificar un segmento de destino diferente en cada regla del XML de configuración de replicación. Un bloque de origen puede replicar en más de un bloque de destino.

  • Los bloques de destino se deben especificar como URN de extremos StorageGRID tal y como se especifica en el administrador de inquilinos o la API de gestión de inquilinos. Consulte "Configure la replicación de CloudMirror".

    El extremo debe existir para que la configuración de replicación se complete correctamente. Si el extremo no existe, la solicitud falla como un 400 Bad Request. El mensaje de error indica: Unable to save the replication policy. The specified endpoint URN does not exist: URN.

  • No es necesario especificar un Role En el XML de configuración. StorageGRID no utiliza este valor y se ignorará si se envía.

  • Si omite la clase de almacenamiento del XML de configuración, StorageGRID utiliza STANDARD clase de almacenamiento de forma predeterminada.

  • Si elimina un objeto del bloque de origen o elimina el propio bloque de origen, el comportamiento de replicación entre regiones es el siguiente:

    • Si elimina el objeto o bloque antes de que se haya replicado, el objeto o bloque no se replicará y no se le notificará.

    • Si elimina el objeto o bloque después de haber sido replicado, StorageGRID sigue el comportamiento estándar de eliminación de Amazon S3 para V1 de replicación entre regiones.

PutBucketTagging

Utiliza la tagging subrecurso para agregar o actualizar un conjunto de etiquetas para un bloque. Al añadir etiquetas de bloque, tenga en cuenta las siguientes limitaciones:

  • Tanto StorageGRID como Amazon S3 admiten hasta 50 etiquetas por cada bloque.

  • Las etiquetas asociadas con un bloque deben tener claves de etiqueta únicas. Una clave de etiqueta puede tener hasta 128 caracteres Unicode de longitud.

  • Los valores de etiqueta pueden tener una longitud máxima de 256 caracteres Unicode.

  • La clave y los valores distinguen entre mayúsculas y minúsculas.

Precaución: Si se establece una etiqueta de política de ILM no predeterminada para este depósito, habrá un NTAP-SG-ILM-BUCKET-TAG etiqueta de segmento con un valor asignado. Compruebe que la NTAP-SG-ILM-BUCKET-TAG La etiqueta de cubo se incluye con el valor asignado en todas las solicitudes de PutBucketTagging. No modifique ni elimine esta etiqueta.

Nota: Esta operación sobrescribirá cualquier etiqueta actual que el cubo ya tenga. Si se omite alguna etiqueta existente del conjunto, esas etiquetas se eliminarán para el cucharón.

PutBucketVersioning

Utiliza la versioning subrecurso para establecer el estado de control de versiones de un bloque existente. Puede establecer el estado de control de versiones con uno de los siguientes valores:

  • Enabled: Activa el control de versiones de los objetos del bloque. Todos los objetos que se agregan al bloque reciben un ID de versión único.

  • Suspendido: Desactiva el control de versiones de los objetos del bloque. Todos los objetos agregados al bloque reciben el ID de versión null.

PutObjectLockConfiguration

Configura o elimina el modo de retención predeterminado y el período de retención predeterminado.

Si se modifica el período de retención predeterminado, la fecha de retención hasta la de las versiones de objeto existentes seguirá siendo la misma y no se volverá a calcular utilizando el nuevo período de retención predeterminado.

Consulte "Use la API REST DE S3 para configurar el bloqueo de objetos de S3" para obtener información detallada.