CreateAlias - AWS Lambda

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: