GetLegalHold - AWS Backup

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 :