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

Agrega permisos a la política basada en recursos de una versión de una [capa de AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html). Utilice esta acción para conceder permisos de uso de capa a otras cuentas. Puede conceder permiso a una única cuenta, a todas las cuentas de una organización o a todas las cuentas de AWS. 

Para revocar el permiso, llame a [RemoveLayerVersionPermission](API_RemoveLayerVersionPermission.md) con el ID de instrucción que especificó al agregarlo.

## Sintaxis de la solicitud
<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"
}
```

## Parámetros de solicitud del URI
<a name="API_AddLayerVersionPermission_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [LayerName](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-LayerName"></a>
El nombre o nombre de recurso de Amazon (ARN) de la capa.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 140 caracteres.  
Patrón: `(arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+`   
Obligatorio: sí

 ** [RevisionId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-RevisionId"></a>
Actualice la directiva solo si el ID de revisión coincide con el ID especificado. Utilice esta opción para evitar la modificación de una política que haya cambiado desde que lo leyó por última vez.

 ** [VersionNumber](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-VersionNumber"></a>
Número de versión.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_AddLayerVersionPermission_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [Action](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-Action"></a>
La acción de API que concede acceso a la capa. Por ejemplo, `lambda:GetLayerVersion`.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 22 caracteres.  
Patrón: `lambda:GetLayerVersion`   
Obligatorio: sí

 ** [OrganizationId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-OrganizationId"></a>
Con el principal establecido en `*`, concede permiso a todas las cuentas de la organización especificada.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 34 caracteres.  
Patrón: `o-[a-z0-9]{10,32}`   
Obligatorio: no

 ** [Principal](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-Principal"></a>
Un ID de cuenta o `*` para conceder permiso de uso de capa a todas las cuentas de una organización o a todas las cuentas de AWS (si no se especifica `organizationId`). En el último caso, asegúrese de que realmente desea que todas las cuentas de AWS tengan permiso de uso para esta capa.   
Tipo: String  
Patrón: `\d{12}|\*|arn:(aws[a-zA-Z-]*):iam::\d{12}:root`   
Obligatorio: sí

 ** [StatementId](#API_AddLayerVersionPermission_RequestSyntax) **   <a name="lambda-AddLayerVersionPermission-request-StatementId"></a>
Un identificador que distingue la política de otras en la misma versión de capa.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `([a-zA-Z0-9-_]+)`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_AddLayerVersionPermission_ResponseSyntax"></a>

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

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

## Elementos de respuesta
<a name="API_AddLayerVersionPermission_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 201.

El servicio devuelve los datos siguientes en formato JSON.

 ** [RevisionId](#API_AddLayerVersionPermission_ResponseSyntax) **   <a name="lambda-AddLayerVersionPermission-response-RevisionId"></a>
Un identificador único para la revisión actual de la política.  
Tipo: cadena

 ** [Statement](#API_AddLayerVersionPermission_ResponseSyntax) **   <a name="lambda-AddLayerVersionPermission-response-Statement"></a>
La instrucción de permiso.  
Tipo: cadena

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

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InvalidParameterValueException **   
Uno de los parámetros de la solicitud no es válido.  
Código de estado HTTP: 400

 ** PolicyLengthExceededException **   
La política de permisos para el recurso es demasiado grande. Para obtener más información, consulte [Cuotas de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).  
Código de estado HTTP: 400

 ** PreconditionFailedException **   
El RevisionId proporcionado no coincide con el RevisionId más reciente para la función o alias de Lambda. Llame a la operación de la API `GetFunction` o `GetAlias` para recuperar la última versión de RevisionId para su recurso.  
Código de estado HTTP: 412

 ** ResourceConflictException **   
El recurso ya existe o hay otra operación en marcha.  
Código de estado HTTP: 409

 ** ResourceNotFoundException **   
El recurso especificado en la solicitud no existe.  
Código de estado HTTP: 404

 ** ServiceException **   
El servicio AWS Lambda detectó un error interno.  
Código de estado HTTP: 500

 ** TooManyRequestsException **   
Se ha superado el límite de rendimiento de la solicitud. Para obtener más información, consulte [Cuotas de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Código de estado HTTP: 429

## Véase también
<a name="API_AddLayerVersionPermission_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/AddLayerVersionPermission) 
+  [SDK de AWS para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/AddLayerVersionPermission) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/AddLayerVersionPermission)