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.

# ValidatePolicy
<a name="API_ValidatePolicy"></a>

Demande la validation d'une politique et renvoie une liste des résultats. Les résultats vous aident à identifier les problèmes et à fournir des recommandations pratiques pour les résoudre et vous permettent de créer des politiques fonctionnelles conformes aux meilleures pratiques en matière de sécurité. 

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

```
POST /policy/validation?maxResults=maxResults&nextToken=nextToken HTTP/1.1
Content-type: application/json

{
   "locale": "string",
   "policyDocument": "string",
   "policyType": "string",
   "validatePolicyResourceType": "string"
}
```

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

La demande utilise les paramètres URI suivants.

 ** [maxResults](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-uri-maxResults"></a>
Le nombre maximum de résultats à renvoyer dans la réponse.

 ** [nextToken](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-uri-nextToken"></a>
Un jeton utilisé pour la pagination des résultats renvoyés.

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

Cette demande accepte les données suivantes au format JSON.

 ** [locale](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-locale"></a>
Les paramètres régionaux à utiliser pour localiser les résultats.  
Type : Chaîne  
Valeurs valides : `DE | EN | ES | FR | IT | JA | KO | PT_BR | ZH_CN | ZH_TW`   
Obligatoire : non

 ** [policyDocument](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-policyDocument"></a>
Le document de politique JSON à utiliser comme contenu pour la politique.  
Type : Chaîne  
Obligatoire : oui

 ** [policyType](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-policyType"></a>
Type de politique à valider. Les politiques d'identité accordent des autorisations aux principaux IAM. Les politiques d'identité incluent des politiques gérées et intégrées pour les rôles, les utilisateurs et les groupes IAM.  
Les politiques relatives aux ressources accordent des autorisations sur AWS les ressources. Les politiques relatives aux ressources incluent des politiques de confiance pour les rôles IAM et des politiques de compartiment pour les compartiments Amazon S3. Vous pouvez fournir une entrée générique telle qu'une politique d'identité ou une politique de ressources ou une entrée spécifique telle qu'une politique gérée ou une politique de compartiment Amazon S3.   
Les politiques de contrôle des services (SCPs) sont un type de politique organisationnelle attachée à une AWS organisation, à une unité organisationnelle (UO) ou à un compte.  
Type : Chaîne  
Valeurs valides : `IDENTITY_POLICY | RESOURCE_POLICY | SERVICE_CONTROL_POLICY | RESOURCE_CONTROL_POLICY`   
Obligatoire : oui

 ** [validatePolicyResourceType](#API_ValidatePolicy_RequestSyntax) **   <a name="accessanalyzer-ValidatePolicy-request-validatePolicyResourceType"></a>
Type de ressource à associer à votre politique de ressources. Spécifiez une valeur pour le type de ressource de validation des politiques uniquement si le type de stratégie est`RESOURCE_POLICY`. Par exemple, pour valider une politique de ressources à associer à un compartiment Amazon S3, vous pouvez choisir le type `AWS::S3::Bucket` de ressource de validation de la politique.  
Pour les types de ressources qui ne sont pas pris en charge en tant que valeurs valides, IAM Access Analyzer exécute des contrôles de stratégie qui s'appliquent à toutes les politiques de ressources. Par exemple, pour valider une politique de ressource à associer à une clé KMS, ne spécifiez pas de valeur pour le type de ressource de validation des politiques et IAM Access Analyzer exécutera des vérifications de politique qui s'appliquent à toutes les politiques de ressources.  
Type : Chaîne  
Valeurs valides : `AWS::S3::Bucket | AWS::S3::AccessPoint | AWS::S3::MultiRegionAccessPoint | AWS::S3ObjectLambda::AccessPoint | AWS::IAM::AssumeRolePolicyDocument | AWS::DynamoDB::Table`   
Obligatoire : non

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

```
HTTP/1.1 200
Content-type: application/json

{
   "findings": [ 
      { 
         "findingDetails": "string",
         "findingType": "string",
         "issueCode": "string",
         "learnMoreLink": "string",
         "locations": [ 
            { 
               "path": [ 
                  { ... }
               ],
               "span": { 
                  "end": { 
                     "column": number,
                     "line": number,
                     "offset": number
                  },
                  "start": { 
                     "column": number,
                     "line": number,
                     "offset": number
                  }
               }
            }
         ]
      }
   ],
   "nextToken": "string"
}
```

## Eléments de réponse
<a name="API_ValidatePolicy_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.

 ** [findings](#API_ValidatePolicy_ResponseSyntax) **   <a name="accessanalyzer-ValidatePolicy-response-findings"></a>
Liste des résultats d'une politique renvoyée par IAM Access Analyzer sur la base de sa suite de vérifications des politiques.  
Type : tableau d’objets [ValidatePolicyFinding](API_ValidatePolicyFinding.md)

 ** [nextToken](#API_ValidatePolicy_ResponseSyntax) **   <a name="accessanalyzer-ValidatePolicy-response-nextToken"></a>
Un jeton utilisé pour la pagination des résultats renvoyés.  
Type : Chaîne

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

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

 ** AccessDeniedException **   
Vous ne disposez pas d’un accès suffisant pour effectuer cette action.  
Code d’état HTTP : 403

 ** InternalServerException **   
Erreur de serveur interne.    
 ** retryAfterSeconds **   
Les secondes à attendre pour réessayer.
Code d’état HTTP : 500

 ** ThrottlingException **   
Erreur de dépassement de la limite d'étranglement.    
 ** retryAfterSeconds **   
Les secondes à attendre pour réessayer.
Code d’état HTTP : 429

 ** ValidationException **   
Erreur d'exception de validation.    
 ** fieldList **   
Liste des champs qui n'ont pas été validés.  
 ** reason **   
La raison de cette exception.
Code d’état HTTP : 400

## Voir aussi
<a name="API_ValidatePolicy_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/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/ValidatePolicy) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/ValidatePolicy)