Documentación de Oracle Cloud Infrastructure

Creación de una regla de retención de Object Storage

Cree una regla de retención para un cubo de Object Storage.

Importante

El bloqueo de una regla de retención es una operación irreversible. Ni siquiera un administrador de arrendamiento ni los Servicios de Soporte Oracle pueden suprimir una regla bloqueada. Existe un retraso obligatorio de 14 días para bloquear una regla. Este retraso le permite probar, modificar o suprimir minuciosamente la regla o el bloqueo de la regla antes de que ésta se bloquee de forma permanente.

Una regla está activa en el momento de su creación. El bloqueo solo controla si la regla en sí se puede modificar. Una vez bloqueada una regla, solo se permite realizar aumentos en la duración. Se impide la modificación del objeto y la regla solo se puede suprimir mediante la supresión del cubo. Un cubo debe estar vacío para que se pueda suprimir.

Le recomendamos que configure avisos para usted durante 7 días y 3 días antes de que finalice el período de 14 días para eliminar la regla si no está seguro de usarla.

    1. En la página de lista Cubos, seleccione el cubo de Object Storage con el que desea trabajar. Si necesita ayuda para buscar la página de lista o el cubo de Object Storage, consulte Enumeración de cubos.
    2. En la página de detalles, seleccione Reglas de retención.
    3. Seleccione Crear regla.
    4. Introduzca la siguiente información:

      • Nombre: Introduzca un nombre para la regla. El sistema genera un nombre de regla que refleja el año, mes, día y hora actuales, por ejemplo, retention-rule-20200229-1002. Si cambia este nombre, utilice letras, números, guiones, caracteres de subrayado y puntos.

      • Tipo de retención: seleccione el tipo de regla de retención que desea crear:

        • Las reglas de límite temporal tienen una duración definida por el usuario. Se impide la modificación del objeto durante el período de duración especificado. La duración se aplica a cada objeto individualmente y se basa en el registro de hora Última Modificación del objeto. Introduzca valores para la configuración de Duración de retención que aparece.

        • Las reglas indefinidas no tienen una duración ni una caducidad. Se impide la modificación de objetos hasta que se suprima una regla indefinida.

      • Duración de retención: (solo reglas de tipo de límite temporal) introduzca valores para el importe de tiempo de importe de tiempo de retención y la unidad de tiempo de unidad de tiempo de retención en Días o Años.

      • Activar bloqueo de regla de retención: (opcional) seleccione la casilla de control para bloquear la regla. Cuando una regla está bloqueada, solo se permite un aumento en la duración de la retención y la regla solo se puede suprimir mediante la supresión del cubo. Un cubo debe estar vacío para suprimirlo.

    5. Haga clic en Crear.

    La regla se muestra en la lista Reglas de retención.

  • Utilice el comando oci osholding-rule create y los parámetros necesarios para crear una regla de retención para un cubo:

    oci os retention-rule create --bucket-name bucket_name [OPTIONS]

    Por ejemplo:

    oci os retention-rule create --display-name LegalHold
{
  "data": {
    "duration": null,
    "etag": "7f51ef6c-3fca-48f7-9060-c129911c1a50",
    "id": "5772c87f-6723-4ecc-b44c-bef86643be92",
    "time-created": "2020-03-25T14:53:20.792000+00:00",
    "time-modified": "2020-03-25T14:53:20.792000+00:00",
    "time-rule-locked": null
  },
  "etag": "7f51ef6c-3fca-48f7-9060-c129911c1a50"
}

    Asignación de un nombre mostrado a la regla de retención

    Incluya el parámetro display-name para proporcionar un nombre especificado por el usuario para la regla de retención. Los nombres pueden ser útiles para identificar reglas de retención. Por ejemplo:

    oci os retention-rule create --bucket-name MyBucket --display-name LegalHold
{
  "data": {
    "display-name": "LegalHold",
    "duration": null,
    "etag": "7f51ef6c-3fca-48f7-9060-c129911c1a50",
    "id": "5772c87f-6723-4ecc-b44c-bef86643be92",
    "time-created": "2020-03-25T14:53:20.792000+00:00",
    "time-modified": "2020-03-25T14:53:20.792000+00:00",
    "time-rule-locked": null
  },
  "etag": "7f51ef6c-3fca-48f7-9060-c129911c1a50"
}

    Creación de una regla de retención de límite temporal

    Incluya los parámetros time-amount y time-unit para definir un período de tiempo en días o años durante el tiempo que se aplica la regla de retención. Por ejemplo:

    oci os retention-rule create --bucket-name MyBucket --time-amount 5 --time-unit days
{
  "data": {
    "duration": {
      "time-amount": 5,
      "time-unit": "DAYS"
    },
    "etag": "efb9178f-4213-49f7-878d-7bbe57decc0b",
    "id": "89f4ca0c-4ad9-4fa5-8005-95e7741c531c",
    "time-created": "2020-03-25T15:08:01.601000+00:00",
    "time-modified": "2020-03-25T15:08:01.601000+00:00",
    "time-rule-locked": null
  },
  "etag": "efb9178f-4213-49f7-878d-7bbe57decc0b"
}

    Si no especifica una unidad ni una cantidad de tiempo, no hay límite de tiempo y los objetos del bloque se conservan de forma indefinida.

    Bloqueo de la regla de retención

    Incluya el parámetro time-rule-locked y un registro de hora de fecha después del cual esta regla esté bloqueada y solo se puede suprimir suprimiendo el cubo. Por ejemplo:

    oci os retention-rule create --bucket-name MyBucket --time-rule-locked 2017-09-15T20:30:00.123Z
{
  "data": {
    "etag": "efb9178f-4213-49f7-878d-7bbe57decc0b",
    "id": "89f4ca0c-4ad9-4fa5-8005-95e7741c531c",
    "time-created": "2020-03-25T15:08:01.601000+00:00",
    "time-modified": "2020-03-25T15:08:01.601000+00:00",
    "time-rule-locked": 2017-09-15T20:30:00.123Z
  },
  "etag": "efb9178f-4213-49f7-878d-7bbe57decc0b"
}

    Consulte oci osholding-rule create para conocer los formatos de registro de hora de fecha soportados que puede utilizar con este parámetro.

    Después de bloquear una regla, solo se permiten aumentos en la duración y ninguna otra propiedad se puede cambiar. No puede actualizar esta propiedad para reglas que están en estado bloqueado. Especificar cuando no se especifica una duración se considera un error.

    Para obtener una lista completa de parámetros y valores para los comandos de la CLI, consulte la Referencia de comandos de CLI.

  • Ejecute la operación CreateRetentionRule para crear una regla de retención para un cubo.