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 (seorganizationId
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
ouGetAlias
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: