

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.

# CreateArchiveRule
<a name="API_CreateArchiveRule"></a>

Crée une règle d'archivage pour l'analyseur spécifié. Les règles d'archivage archivent automatiquement les nouvelles découvertes qui répondent aux critères que vous définissez lors de la création de la règle.

Pour en savoir plus sur les clés de filtre que vous pouvez utiliser pour créer une règle d'archivage, voir les [clés de filtre d'IAM Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-reference-filter-keys.html) dans le guide de l'utilisateur d'**IAM**.

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

```
PUT /analyzer/analyzerName/archive-rule HTTP/1.1
Content-type: application/json

{
   "clientToken": "string",
   "filter": { 
      "string" : { 
         "contains": [ "string" ],
         "eq": [ "string" ],
         "exists": boolean,
         "neq": [ "string" ]
      }
   },
   "ruleName": "string"
}
```

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

La demande utilise les paramètres URI suivants.

 ** [analyzerName](#API_CreateArchiveRule_RequestSyntax) **   <a name="accessanalyzer-CreateArchiveRule-request-uri-analyzerName"></a>
Nom de l'analyseur créé.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 255 caractères.  
Modèle : `[A-Za-z][A-Za-z0-9_.-]*`   
Obligatoire : oui

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

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

 ** [clientToken](#API_CreateArchiveRule_RequestSyntax) **   <a name="accessanalyzer-CreateArchiveRule-request-clientToken"></a>
Un jeton client.  
Type : chaîne  
Obligatoire : non

 ** [filter](#API_CreateArchiveRule_RequestSyntax) **   <a name="accessanalyzer-CreateArchiveRule-request-filter"></a>
Critères de la règle.  
Type : mappage entre chaîne et [Criterion](API_Criterion.md) objet  
Obligatoire : oui

 ** [ruleName](#API_CreateArchiveRule_RequestSyntax) **   <a name="accessanalyzer-CreateArchiveRule-request-ruleName"></a>
Nom de la règle à créer.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255 caractères.  
Modèle : `[A-Za-z][A-Za-z0-9_.-]*`   
Obligatoire : oui

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

```
HTTP/1.1 200
```

## Eléments de réponse
<a name="API_CreateArchiveRule_ResponseElements"></a>

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

## Erreurs
<a name="API_CreateArchiveRule_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

 ** ConflictException **   
Une erreur liée à une exception de conflit.    
 ** resourceId **   
ID de la ressource.  
 ** resourceType **   
Type de ressource.
Code d’état HTTP : 409

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

 ** ResourceNotFoundException **   
La ressource spécifiée est introuvable.    
 ** resourceId **   
ID de la ressource.  
 ** resourceType **   
Type de la ressource.
Code d’état HTTP :404

 ** ServiceQuotaExceededException **   
Le devis de service s'est avéré erroné.    
 ** resourceId **   
L'ID de la ressource.  
 ** resourceType **   
Type de ressource.
Code d'état HTTP : 402

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