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: stringa
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:
