Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
GetLegalHold
Cette action renvoie les détails d'une conservation légale spécifiée. Les détails constituent le corps d'une conservation légale sous JSON forme de format, en plus des métadonnées.
Syntaxe de la requête
GET /legal-holds/legalHoldId
/ HTTP/1.1
URIParamètres de demande
La demande utilise les URI paramètres suivants.
- legalHoldId
-
L'identifiant de la retenue légale.
Obligatoire : oui
Corps de la demande
La demande n’a pas de corps de requête.
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"CancelDescription": "string",
"CancellationDate": number,
"CreationDate": number,
"Description": "string",
"LegalHoldArn": "string",
"LegalHoldId": "string",
"RecoveryPointSelection": {
"DateRange": {
"FromDate": number,
"ToDate": number
},
"ResourceIdentifiers": [ "string" ],
"VaultNames": [ "string" ]
},
"RetainRecordUntil": number,
"Status": "string",
"Title": "string"
}
Eléments de réponse
Si l'action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées sous JSON forme formatée par le service.
- CancelDescription
-
La raison de la levée de la suspension légale.
Type : String
- CancellationDate
-
Heure à laquelle le blocage légal a été annulé.
Type : Timestamp
- CreationDate
-
Heure à laquelle le blocage légal a été créé.
Type : Timestamp
- Description
-
Description de la détention légale.
Type : String
- LegalHoldArn
-
Le cadre ARN de la détention légale spécifiée. Le format du ARN dépend du type de ressource.
Type : String
- LegalHoldId
-
L'identifiant de la retenue légale.
Type : String
- RecoveryPointSelection
-
Les critères d'attribution d'un ensemble de ressources, tels que les types de ressources ou les coffres-forts de sauvegarde.
Type : objet RecoveryPointSelection
- RetainRecordUntil
-
Date et heure jusqu'à laquelle le dossier de conservation légal est conservé.
Type : Timestamp
- Status
-
État de la suspension légale.
Type : String
Valeurs valides :
CREATING | ACTIVE | CANCELING | CANCELED
- Title
-
Titre de la retenue légale.
Type : String
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- InvalidParameterValueException
-
Indique une erreur avec la valeur d'un paramètre. Par exemple, la valeur est hors de portée.
HTTPCode de statut : 400
- MissingParameterValueException
-
Indique qu'un paramètre obligatoire est manquant.
HTTPCode de statut : 400
- ResourceNotFoundException
-
Aucune ressource requise pour l'action n'existe.
HTTPCode de statut : 400
- ServiceUnavailableException
-
La demande a échoué en raison d'une défaillance temporaire du serveur.
HTTPCode de statut : 500
consultez aussi
Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :