リクエストの構文 URI リクエストパラメータリクエストボディレスポンスの構文レスポンス要素エラー以下の資料も参照してください。

CreateAlias

Lambda 関数バージョンのエイリアスを作成します。エイリアスを使用して、別のバージョンを呼び出すために更新できる関数識別子をクライアントに提供します。

エイリアスをマッピングして、2 つのバージョン間で呼び出しリクエストを分割することもできます。RoutingConfig パラメータを使用して、2 番目のバージョンとそのバージョンが受信する呼び出しリクエストの割合を指定します。

リクエストの構文


POST /2015-03-31/functions/FunctionName/aliases HTTP/1.1
Content-type: application/json

{
   "Description": "string",
   "FunctionVersion": "string",
   "Name": "string",
   "RoutingConfig": { 
      "AdditionalVersionWeights": { 
         "string" : number 
      }
   }
}

URI リクエストパラメータ

リクエストでは、次の URI パラメータを使用します。

FunctionName

Lambda 関数の名前

名前の形式

関数名 - MyFunction。
関数 ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction。
一部の ARN - 123456789012:function:MyFunction。

完全な ARN にのみ適用される長さの制限。関数名のみを指定する場合、64 文字の長さに制限されます。

長さの制限: 最小長は 1 です。最大長は 140 です。

Pattern: (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-_]+))?

必須: はい

リクエストボディ

リクエストは以下の JSON 形式のデータを受け入れます。

Description

エイリアスの説明。

型: 文字列

長さの制限: 最小長は 0 です。最大長は 256 です。

必須: いいえ

FunctionVersion

エイリアスが呼び出す関数バージョン。

型: 文字列

長さの制限: 最小長は 1 です。最大長は 1,024 です。

Pattern: (\$LATEST|[0-9]+)

必須: はい

Name

エイリアスの名前。

型: 文字列

長さの制限: 最小長は 1 です。最大長は 128 です。

パターン: (?!^[0-9]+$)([a-zA-Z0-9-_]+)

必須: はい

RoutingConfig

エイリアスのルーティング設定。

タイプ: AliasRoutingConfiguration オブジェクト

必須: いいえ

レスポンスの構文


HTTP/1.1 201
Content-type: application/json

{
   "AliasArn": "string",
   "Description": "string",
   "FunctionVersion": "string",
   "Name": "string",
   "RevisionId": "string",
   "RoutingConfig": { 
      "AdditionalVersionWeights": { 
         "string" : number 
      }
   }
}