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
<a name="API_GetLegalHold"></a>

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 au format JSON, en plus des métadonnées.

## Syntaxe de la demande
<a name="API_GetLegalHold_RequestSyntax"></a>

```
GET /legal-holds/legalHoldId/ HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetLegalHold_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [legalHoldId](#API_GetLegalHold_RequestSyntax) **   <a name="Backup-GetLegalHold-request-uri-LegalHoldId"></a>
L'identifiant de la retenue légale.  
Obligatoire : oui

## Corps de la demande
<a name="API_GetLegalHold_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetLegalHold_ResponseSyntax"></a>

```
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
<a name="API_GetLegalHold_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [CancelDescription](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-CancelDescription"></a>
La raison de la levée de la suspension légale.  
Type : Chaîne

 ** [CancellationDate](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-CancellationDate"></a>
Heure à laquelle le blocage légal a été annulé.  
Type : Timestamp

 ** [CreationDate](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-CreationDate"></a>
Heure à laquelle la mise en attente légale a été créée.  
Type : Timestamp

 ** [Description](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-Description"></a>
Description de la détention légale.  
Type : Chaîne

 ** [LegalHoldArn](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-LegalHoldArn"></a>
L'ARN du framework pour la conservation légale spécifiée. Le format de l'ARN dépend du type de ressource.  
Type : Chaîne

 ** [LegalHoldId](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-LegalHoldId"></a>
L'identifiant de la retenue légale.  
Type : Chaîne

 ** [RecoveryPointSelection](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-RecoveryPointSelection"></a>
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](API_RecoveryPointSelection.md)

 ** [RetainRecordUntil](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-RetainRecordUntil"></a>
Date et heure jusqu'à laquelle le dossier de conservation légal est conservé.  
Type : Timestamp

 ** [Status](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-Status"></a>
Le statut de la suspension légale.  
Type : Chaîne  
Valeurs valides : `CREATING | ACTIVE | CANCELING | CANCELED` 

 ** [Title](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-Title"></a>
Titre de la retenue légale.  
Type : Chaîne

## Erreurs
<a name="API_GetLegalHold_Errors"></a>

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).

 ** InvalidParameterValueException **   
Indique une erreur avec la valeur d'un paramètre. Par exemple, la valeur est hors de portée.    
 ** Context **   
  
 ** Type **   

Code d’état HTTP : 400

 ** MissingParameterValueException **   
Indique qu'un paramètre obligatoire est manquant.    
 ** Context **   
  
 ** Type **   

Code d’état HTTP : 400

 ** ResourceNotFoundException **   
Aucune ressource requise pour l'action n'existe.    
 ** Context **   
  
 ** Type **   

Code d’état HTTP : 400

 ** ServiceUnavailableException **   
La demande a échoué en raison d'une défaillance temporaire du serveur.    
 ** Context **   
  
 ** Type **   

Code d’état HTTP : 500

## Voir aussi
<a name="API_GetLegalHold_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetLegalHold)