AddLayerVersionPermission - AWS Lambda

AddLayerVersionPermission

Adiciona permissões à política baseada em recursos de uma versão de uma camada do AWS Lambda. Use essa ação para conceder permissão de uso da camada a outras contas. É possível conceder permissão para uma única conta, todas as contas em uma organização ou para todas as contas da AWS.

Para revogar a permissão, chameRemoveLayerVersionPermission com o ID da instrução que você especificou quando adicionou essa permissão.

Sintaxe da Solicitação

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 da Solicitação de URI

A solicitação usa os seguintes parâmetros de URI:

LayerName

O nome ou o nome de recurso da Amazon (ARN) da camada.

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 140.

Padrão: (arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+)|[a-zA-Z0-9-_]+

Exigido: Sim

RevisionId

Atualize a política somente se o ID da revisão corresponder ao ID especificado. Use essa opção para evitar a modificação de uma política que foi alterada desde a última leitura.

VersionNumber

O número da versão.

Obrigatório: sim

Corpo da Solicitação

A solicitação aceita os dados a seguir no formato JSON.

Action

A ação da API que concede acesso à camada. Por exemplo, lambda:GetLayerVersion.

Tipo: string

Restrições de tamanho: tamanho máximo de 22.

Padrão: lambda:GetLayerVersion

Exigido: Sim

OrganizationId

Com o principal definido como *, conceda permissão a todas as contas na organização especificada.

Tipo: string

Restrições de tamanho: tamanho máximo de 34.

Padrão: o-[a-z0-9]{10,32}

Obrigatório: não

Principal

Um ID de conta ou * para conceder permissão de uso da camada a todas as contas de uma organização ou a todas as contas da AWS (se organizationId não for especificado). Para o último caso, certifique-se de que você realmente deseja que todas as contas da AWS tenham permissão de uso para essa camada.

Tipo: string

Padrão: \d{12}|\*|arn:(aws[a-zA-Z-]*):iam::\d{12}:root

Exigido: Sim

StatementId

Um identificador que distingue uma política de outras na mesma versão de camada.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.

Padrão: ([a-zA-Z0-9-_]+)

Exigido: Sim

Sintaxe da Resposta

HTTP/1.1 201 Content-type: application/json { "RevisionId": "string", "Statement": "string" }

Elementos de Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 201.

Os dados a seguir são retornados no formato JSON pelo serviço.

RevisionId

Um identificador exclusivo da revisão atual da política.

Tipo: string

Statement

A declaração da permissão.

Tipo: string

Erros

Para obter informações sobre os erros que todas as ações retornam, consulte Erros comuns.

InvalidParameterValueException

Um dos parâmetros da solicitação não é válido.

Código de Status HTTP: 400

PolicyLengthExceededException

A política de permissões do recurso é muito grande. Para obter mais informações, consulte Cotas do Lambda.

Código de Status HTTP: 400

PreconditionFailedException

O RevisionId fornecido não corresponde ao RevisionId mais recente da função ou do alias do Lambda. Chame a operação de API GetFunction ou GetAlias para recuperar o RevisionId mais recente para o recurso.

Código de status HTTP: 412

ResourceConflictException

O recurso já existe ou outra operação está em andamento.

Código de status HTTP: 409

ResourceNotFoundException

O recurso especificado na solicitação não existe.

Código de Status HTTP: 404

ServiceException

O serviço AWS Lambda encontrou um erro interno.

Código de Status HTTP: 500

TooManyRequestsException

O limite de throughput da solicitação foi excedido. Para obter mais informações, consulte Cotas do Lambda.

Código de status HTTP: 429

Ver também

Para mais informações sobre como usar essa API em um dos AWS SDKs de idiomas específicos, consulte o seguinte: