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"
}URIParametri della richiesta
La richiesta non utilizza alcun URI parametro.
Corpo della richiesta
La richiesta accetta i seguenti dati nel JSON formato.
- Description
-
La descrizione della custodia 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 UTF -8 lettere, numeri, spazi e i seguenti caratteri: + - =. _: /.
Tipo: mappatura stringa a stringa
Campo obbligatorio: no
- Title
-
Il titolo del deposito 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'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.
I seguenti dati vengono restituiti in JSON formato dal servizio.
- CreationDate
-
L'ora in cui è stata creata la conservazione a fini legali.
Tipo: Timestamp
- Description
-
La descrizione della custodia legale.
Tipo: stringa
- LegalHoldArn
-
L'Amazon Resource Name (ARN) del deposito legale.
Tipo: stringa
- LegalHoldId
-
L'ID del deposito 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 del deposito 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.
HTTPCodice di stato: 400
- LimitExceededException
-
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
HTTPCodice di stato: 400
- MissingParameterValueException
-
Indica che manca un parametro obbligatorio.
HTTPCodice di stato: 400
- ServiceUnavailableException
-
La richiesta non è riuscita a causa di un errore temporaneo del server.
HTTPCodice di stato: 500
Vedi anche
Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
