Documentación de Oracle Cloud Infrastructure

Creación de una regla de retención de datos 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 Oracle Support pueden suprimir una regla bloqueada. Ya existe un retraso obligatorio de 14 días para que se bloquee una regla. Este retraso le permite probar, actualizar o suprimir la regla o el bloqueo de la regla antes del bloqueo 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 cambiar. 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, consulte Listado de cubos.
    2. En la página de detalles, seleccione Políticas y busque la sección 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 regla de detención: seleccione el tipo 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 Última modificación del registro de hora del objeto. Introduzca los valores para la configuración de Duración de retención que aparecen.

        • 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 la cantidad 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 retención y la regla solo se puede eliminar mediante la supresión del cubo. Para suprimir un cubo, debe estar vacío.

    5. Seleccione Crear regla.
    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"
}

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

    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.

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