Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CreateLegalHold
Crea un blocco legale su un punto di ripristino (backup). Un blocco a fini legali è una limitazione alla modifica o eliminazione di un backup fino a quando un utente autorizzato non annulla il blocco a fini legali. Qualsiasi azione volta a eliminare o dissociare un punto di ripristino non andrà a buon fine e genererà un errore se sul punto di ripristino sono presenti uno o più blocchi a fini legali attivi.
Sintassi della richiesta
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"
}Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- Description
-
La descrizione della conservazione legale.
Tipo: stringa
Campo obbligatorio: sì
- IdempotencyToken
-
Questa è una stringa scelta dall'utente utilizzata per distinguere tra chiamate altrimenti identiche. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.
Tipo: string
Campo obbligatorio: no
- RecoveryPointSelection
-
I criteri per assegnare un insieme di risorse, ad esempio i tipi di risorse o gli archivi di backup.
Tipo: oggetto RecoveryPointSelection
Campo obbligatorio: no
- Tags
-
Tag opzionali da includere. Un tag è una coppia chiave-valore che puoi utilizzare per gestire, filtrare e cercare le risorse. I caratteri consentiti includono lettere UTF-8, numeri, spazi e i caratteri seguenti: + - = . _ : /.
Tipo: mappatura stringa a stringa
Campo obbligatorio: no
- Title
-
Il titolo della custodia legale.
Tipo: stringa
Campo obbligatorio: sì
Sintassi della risposta
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"
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- CreationDate
-
L'ora in cui è stata creata la custodia legale.
Tipo: Timestamp
- Description
-
La descrizione del blocco legale.
Tipo: stringa
- LegalHoldArn
-
L'Amazon Resource Name (ARN) della custodia legale.
Tipo: stringa
- LegalHoldId
-
L'ID del blocco a fini legali.
Tipo: stringa
- RecoveryPointSelection
-
I criteri da assegnare a un insieme di risorse, ad esempio i tipi di risorse o gli archivi di backup.
Tipo: oggetto RecoveryPointSelection
- Status
-
Lo stato della custodia legale.
Tipo: stringa
Valori validi:
CREATING | ACTIVE | CANCELING | CANCELED - Title
-
Il titolo della custodia legale.
Tipo: stringa
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InvalidParameterValueException
-
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
- Context
- Type
Codice di stato HTTP: 400
- LimitExceededException
-
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
- Context
- Type
Codice di stato HTTP: 400
- MissingParameterValueException
-
Indica che manca un parametro obbligatorio.
- Context
- Type
Codice di stato HTTP: 400
- ServiceUnavailableException
-
La richiesta non è riuscita a causa di un errore temporaneo del server.
- Context
- Type
Codice di stato HTTP: 500
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
