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

[AWS Lambda レイヤー](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)のバージョンのリソースベースポリシーに許可を追加します。レイヤーの使用に関するアクセス許可を他のアカウントに付与するには、このアクションを使用します。アクセス許可は、組織内の 1 つのアカウント、すべてのアカウント、またはすべての AWS アカウントに付与することができます。

許可を取り消すには、追加時に指定したステートメント ID で [RemoveLayerVersionPermission](API_RemoveLayerVersionPermission.md) を呼び出します。

## リクエストの構文
<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"
}
```

## URI リクエストパラメータ
<a name="API_AddLayerVersionPermission_RequestParameters"></a>

リクエストでは、次の URI パラメータを使用します。

 ** [LayerName](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-LayerName"></a>
レイヤーの名前または Amazon リソースネーム (ARN)。  
長さの制限: 最小長は 1 です。最大長は 140 です。  
Pattern: `(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+`   
必須: はい

 ** [RevisionId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-RevisionId"></a>
リビジョン ID が指定した ID と一致する場合にのみ、ポリシーを更新します。このオプションを使用して、最終読み取りから変更されたポリシーを変更しないようにします。

 ** [VersionNumber](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-VersionNumber"></a>
バージョン番号。  
必須: はい

## リクエストボディ
<a name="API_AddLayerVersionPermission_RequestBody"></a>

リクエストは以下の JSON 形式のデータを受け入れます。

 ** [Action](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-Action"></a>
レイヤーへのアクセスを許可する API アクション。例えば、`lambda:GetLayerVersion` です。  
型: 文字列  
長さの制限: 最大長は 22 です。  
Pattern: `lambda:GetLayerVersion`   
必須: はい

 ** [OrganizationId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-OrganizationId"></a>
プリンシパルを `*` に設定して、指定された組織のすべてのアカウントにアクセス許可を付与します。  
型: 文字列  
長さの制限: 最大長は 34 です。  
Pattern: `o-[a-z0-9]{10,32}`   
必須: いいえ

 ** [Principal](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-Principal"></a>
組織内のすべてのアカウント、またはすべての AWS アカウント (`organizationId` が指定されていない場合) にレイヤーの使用のためのアクセス許可を付与するためのアカウント ID、または `*`。後者の場合、本当にすべての AWS アカウントにこのレイヤー使用のためのアクセス許可を付与するかどうかを確認してください。  
型: 文字列  
Pattern: `\d{12}|\*|arn:(aws[a-zA-Z-]*):iam::\d{12}:root`   
必須: はい

 ** [StatementId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-StatementId"></a>
同じレイヤーバージョンの他のポリシーと区別する識別子。  
型: 文字列  
長さの制限: 最小長は 1 です。最大長は 100 です。  
Pattern: `([a-zA-Z0-9-_]+)`   
必須：はい

## レスポンスの構文
<a name="API_AddLayerVersionPermission_ResponseSyntax"></a>

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

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

## レスポンス要素
<a name="API_AddLayerVersionPermission_ResponseElements"></a>

アクションが成功すると、HTTP 201 レスポンスが返されます。

サービスから以下のデータが JSON 形式で返されます。

 ** [RevisionId](#API_AddLayerVersionPermission_ResponseSyntax) **   <a name="lambda-AddLayerVersionPermission-response-RevisionId"></a>
ポリシーの現在のリビジョンにおける一意の識別子。  
型: 文字列

 ** [Statement](#API_AddLayerVersionPermission_ResponseSyntax) **   <a name="lambda-AddLayerVersionPermission-response-Statement"></a>
アクセス許可ステートメント。  
型: 文字列

## エラー
<a name="API_AddLayerVersionPermission_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InvalidParameterValueException **   
リクエストに含まれているパラメータの 1 つが無効です。  
HTTP ステータスコード：400

 ** PolicyLengthExceededException **   
リソースのアクセス許可ポリシーが大きすぎます。詳細については、「[Lambda クォータ](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html)」を参照してください。  
HTTP ステータスコード：400

 ** PreconditionFailedException **   
指定された RevisionId が、Lambda 関数またはエイリアスの最新 RevisionId と一致しません。`GetFunction` または `GetAlias` API 操作を呼び出して、リソースの最新の RevisionId を取得します。  
HTTP ステータスコード: 412

 ** ResourceConflictException **   
リソースが既に存在しているか、別のオペレーションが進行中です。  
HTTP ステータスコード: 409

 ** ResourceNotFoundException **   
リクエストで指定されたリソースは存在しません。  
HTTP ステータスコード: 404

 ** ServiceException **   
AWS Lambda サービスで内部エラーが発生しました。  
HTTP ステータスコード: 500

 ** TooManyRequestsException **   
リクエストスループット制限を超えました。詳細については、「[Lambda クォータ](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)」を参照してください。  
HTTP ステータスコード: 429

## 以下の資料も参照してください。
<a name="API_AddLayerVersionPermission_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  「[AWS コマンドラインインターフェイス](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/AddLayerVersionPermission)」 
+  「[AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/AddLayerVersionPermission)」 
+  「[AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/AddLayerVersionPermission)」 
+  「[AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/AddLayerVersionPermission)」 
+  「[AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/AddLayerVersionPermission)」 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/AddLayerVersionPermission) 
+  「[AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/AddLayerVersionPermission)」 
+  「[AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/AddLayerVersionPermission)」 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/AddLayerVersionPermission)