Sintaxis de la solicitud Parámetros de solicitud del URI Cuerpo de la solicitud Sintaxis de la respuesta Elementos de respuesta Errores Véase también

CreateLegalHold

Crea una retención legal en un punto de recuperación (copia de seguridad). Una retención legal es una restricción a la modificación o eliminación de una copia de seguridad hasta que un usuario autorizado cancele la retención legal. Toda acción que se lleve a cabo para eliminar o disociar un punto de recuperación dará lugar a un error si hay una o más retenciones legales activas en el punto de recuperación.

Sintaxis de la solicitud


POST /legal-holds/ HTTP/1.1
Content-type: application/json

{
   "Description": "string",
   "IdempotencyToken": "string",
   "RecoveryPointSelection": { 
      "DateRange": { 
         "FromDate": number,
         "ToDate": number
      },
      "ResourceIdentifiers": [ "string" ],
      "VaultNames": [ "string" ]
   },
   "Tags": { 
      "string" : "string" 
   },
   "Title": "string"
}

Parámetros de solicitud del URI

La solicitud no utiliza ningún parámetro de URI.

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

Description

La descripción de la cadena de la retención legal.

Tipo: cadena

Obligatorio: sí

IdempotencyToken

Se trata de una cadena elegida por el usuario que se utiliza para distinguir entre llamadas que, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.

Tipo: cadena

Requerido: no

RecoveryPointSelection

Los criterios para asignar un conjunto de recursos, como los tipos de recursos o los almacenes de copias de seguridad.

Tipo: objeto RecoveryPointSelection

Obligatorio: no

Tags

Etiquetas opcionales que se incluirán. Una etiqueta es un par clave-valor que puede utilizar para administrar, filtrar y buscar sus recursos. Los caracteres permitidos incluyen espacios, números y letras en UTF-8, además de los siguientes caracteres especiales: + - = . _ : /.

Tipo: mapa de cadena a cadena

Obligatorio: no

Title

El título de la retención legal.

Tipo: cadena

Obligatorio: sí

Sintaxis de la respuesta


HTTP/1.1 200
Content-type: application/json

{
   "CreationDate": number,
   "Description": "string",
   "LegalHoldArn": "string",
   "LegalHoldId": "string",
   "RecoveryPointSelection": { 
      "DateRange": { 
         "FromDate": number,
         "ToDate": number
      },
      "ResourceIdentifiers": [ "string" ],
      "VaultNames": [ "string" ]
   },
   "Status": "string",
   "Title": "string"
}