

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.

# AddLayerVersionPermission
<a name="API_AddLayerVersionPermission"></a>

Ajoute des autorisations à la stratégie basée sur une ressource d’une version d’une [couche AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html). Utilisez cette action pour accorder une autorisations d’utilisation des couches à d’autres comptes. Vous pouvez accorder une autorisation à un compte, à tous les comptes d’une organisation ou à tous les comptes AWS. 

Pour révoquer une autorisation, appelez [RemoveLayerVersionPermission](API_RemoveLayerVersionPermission.md) avec l’ID d’instruction que vous avez spécifié lors de son ajout.

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

```
POST /2018-10-31/layers/LayerName/versions/VersionNumber/policy?RevisionId=RevisionId HTTP/1.1
Content-type: application/json

{
   "Action": "string",
   "OrganizationId": "string",
   "Principal": "string",
   "StatementId": "string"
}
```

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

La demande utilise les paramètres URI suivants.

 ** [LayerName](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-LayerName"></a>
Nom ou Amazon Resource Name (ARN) de la couche.  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 140.  
Modèle : `(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+`   
Obligatoire : oui

 ** [RevisionId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-RevisionId"></a>
Ne mettez à jour la stratégie que si l’ID de révision correspond à l’ID spécifié. Utilisez cette option pour éviter de modifier une stratégie qui a changé depuis la dernière lecture.

 ** [VersionNumber](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-VersionNumber"></a>
Numéro de version.  
Obligatoire : oui

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

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

 ** [Action](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-Action"></a>
Action d’API qui accorde l’accès à la couche. Par exemple, `lambda:GetLayerVersion`.  
Type : chaîne  
Contraintes de longueur : Longueur maximum de 22.  
Modèle : `lambda:GetLayerVersion`   
Obligatoire : oui

 ** [OrganizationId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-OrganizationId"></a>
Avec le principal défini sur `*`, accordez l’autorisation à tous les comptes de l’organisation spécifiée.  
Type : chaîne  
Contraintes de longueur : Longueur maximum de 34.  
Modèle : `o-[a-z0-9]{10,32}`   
Obligatoire : non

 ** [Principal](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-Principal"></a>
ID de compte ou `*` pour accorder une autorisation d’utilisation de couche à tous les comptes d’une organisation ou à tous les comptes AWS (si `organizationId` n’est pas spécifié). Dans le dernier cas, assurez-vous que vous voulez vraiment que tous les comptes AWS aient l’autorisation d’utilisation de cette couche.   
Type : chaîne  
Modèle : `\d{12}|\*|arn:(aws[a-zA-Z-]*):iam::\d{12}:root`   
Obligatoire : oui

 ** [StatementId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-StatementId"></a>
Identifiant distinguant la stratégie des autres stratégies sur la même version de couche.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `([a-zA-Z0-9-_]+)`   
Obligatoire : oui

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

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

{
   "RevisionId": "string",
   "Statement": "string"
}
```

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

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

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

 ** [RevisionId](#API_AddLayerVersionPermission_ResponseSyntax) **   <a name="lambda-AddLayerVersionPermission-response-RevisionId"></a>
Identifiant unique de la révision actuelle de la stratégie.  
Type : chaîne

 ** [Statement](#API_AddLayerVersionPermission_ResponseSyntax) **   <a name="lambda-AddLayerVersionPermission-response-Statement"></a>
Instruction d’autorisation.  
Type : chaîne

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

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

 ** InvalidParameterValueException **   
L’un des paramètres dans la demande n’est pas valide.  
Code d’état HTTP : 400

 ** PolicyLengthExceededException **   
La stratégie d’autorisations pour la ressource est trop volumineuse. Pour plus d’informations, consultez [Quotas Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).  
Code d’état HTTP : 400

 ** PreconditionFailedException **   
La valeur RevisionId fournie ne correspond pas à la dernière version de RevisionId la fonction ou de l'alias Lambda. Appelez l'opération `GetFunction` ou l'`GetAlias`API pour récupérer la dernière version RevisionId de votre ressource.  
Code d’état HTTP : 412

 ** ResourceConflictException **   
La ressource existe déjà ou une autre opération est en cours.  
Code d’état HTTP : 409

 ** ResourceNotFoundException **   
La ressource spécifiée dans la demande n’existe pas.  
Code d’état HTTP : 404

 ** ServiceException **   
Le service AWS Lambda a rencontré une erreur interne.  
Code d’état HTTP : 500

 ** TooManyRequestsException **   
La limite de débit de demande a été dépassée. Pour plus d’informations, consultez [Quotas Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Code d’état HTTP : 429

## consultez aussi
<a name="API_AddLayerVersionPermission_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/AddLayerVersionPermission) 
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/AddLayerVersionPermission) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/AddLayerVersionPermission) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWSSDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/AddLayerVersionPermission) 
+  [Kit AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/AddLayerVersionPermission) 
+  [Kit AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/AddLayerVersionPermission) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/AddLayerVersionPermission) 