CreateAlias
Cria um alias para uma versão da função do Lambda. Use alias para fornecer aos clientes um identificador de função que você pode atualizar para invocar uma versão diferente.
Você também pode mapear um alias para dividir solicitações de invocação entre duas versões. Use o parâmetro RoutingConfig
para especificar uma segunda versão e a porcentagem de solicitações de invocação que ela recebe.
Sintaxe da Solicitação
POST /2015-03-31/functions/FunctionName
/aliases HTTP/1.1
Content-type: application/json
{
"Description": "string
",
"FunctionVersion": "string
",
"Name": "string
",
"RoutingConfig": {
"AdditionalVersionWeights": {
"string
" : number
}
}
}
Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
- FunctionName
-
O nome da função do Lambda.
Formatos de nome
-
Nome da função -
MyFunction
. -
ARN da função -
arn:aws:lambda:us-west-2:123456789012:function:MyFunction
. -
ARN parcial:
123456789012:function:MyFunction
.
A restrição de comprimento se aplica apenas ao ARN completo. Se você especificar apenas o nome da função, ele será limitado a 64 caracteres.
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 140.
Padrão:
(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?
Exigido: Sim
-
Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
- Description
-
Uma descrição do alias.
Tipo: String
Restrições de comprimento: comprimento mínimo 0. Comprimento máximo de 256.
Obrigatório: não
- FunctionVersion
-
A versão da função que o alias invoca.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 1024.
Padrão:
(\$LATEST|[0-9]+)
Exigido: Sim
- Name
-
O nome do alias.
Tipo: String
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 128.
Padrão:
(?!^[0-9]+$)([a-zA-Z0-9-_]+)
Exigido: Sim
- RoutingConfig
-
A configuração de roteamento do alias.
Tipo: objeto AliasRoutingConfiguration
Obrigatório: não
Sintaxe da Resposta
HTTP/1.1 201
Content-type: application/json
{
"AliasArn": "string",
"Description": "string",
"FunctionVersion": "string",
"Name": "string",
"RevisionId": "string",
"RoutingConfig": {
"AdditionalVersionWeights": {
"string" : number
}
}
}
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.
- AliasArn
-
O nome do recurso da Amazon (ARN) do alarme do alias.
Tipo: string
Padrão:
arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?
- Description
-
Uma descrição do alias.
Tipo: String
Restrições de comprimento: comprimento mínimo 0. Comprimento máximo de 256.
- FunctionVersion
-
A versão da função que o alias invoca.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 1024.
Padrão:
(\$LATEST|[0-9]+)
- Name
-
O nome do alias.
Tipo: String
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 128.
Padrão:
(?!^[0-9]+$)([a-zA-Z0-9-_]+)
- RevisionId
-
Um identificador exclusivo que muda ao atualizar o alias.
Tipo: string
- RoutingConfig
-
A configuração de roteamento do alias.
Tipo: objeto AliasRoutingConfiguration
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
- 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: