UpdateAlias
Lambda 関数エイリアスの設定を更新します。
リクエストの構文
PUT /2015-03-31/functions/FunctionName
/aliases/Name
HTTP/1.1
Content-type: application/json
{
"Description": "string
",
"FunctionVersion": "string
",
"RevisionId": "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-_]+))?
必須: はい
-
- Name
-
エイリアスの名前。
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン:
(?!^[0-9]+$)([a-zA-Z0-9-_]+)
必須: はい
リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
- Description
-
エイリアスの説明。
型: 文字列
長さの制限: 最小長は 0 です。最大長は 256 です。
必須: いいえ
- FunctionVersion
-
エイリアスが呼び出す関数バージョン。
型: 文字列
長さの制限: 最小長は 1 です。最大長は 1,024 です。
パターン:
(\$LATEST|[0-9]+)
必須: いいえ
- RevisionId
-
リビジョン ID が指定された ID と一致する場合にのみ、関数を更新します。このオプションを使用して、最終読み取りから変更されたエイリアスが変更されないようにします。
型: 文字列
必須: いいえ
- RoutingConfig
-
エイリアスのルーティング設定。
タイプ: AliasRoutingConfiguration オブジェクト
必須: いいえ
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"AliasArn": "string",
"Description": "string",
"FunctionVersion": "string",
"Name": "string",
"RevisionId": "string",
"RoutingConfig": {
"AdditionalVersionWeights": {
"string" : number
}
}
}
レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- AliasArn
-
エイリアスの Amazon リソースネーム (ARN)。
型: 文字列
パターン:
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
-
エイリアスの説明。
型: 文字列
長さの制限: 最小長は 0 です。最大長は 256 です。
- FunctionVersion
-
エイリアスが呼び出す関数バージョン。
型: 文字列
長さの制限: 最小長は 1 です。最大長は 1,024 です。
パターン:
(\$LATEST|[0-9]+)
- Name
-
エイリアスの名前。
型: 文字列
長さの制限: 最小長は 1 です。最大長は 128 です。
パターン:
(?!^[0-9]+$)([a-zA-Z0-9-_]+)
- RevisionId
-
エイリアスを更新するときに変更される一意の識別子。
型: 文字列
- RoutingConfig
-
エイリアスのルーティング設定。
型: AliasRoutingConfiguration オブジェクト
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- InvalidParameterValueException
-
リクエストに含まれているパラメータの 1 つが無効です。
HTTP ステータスコード:400
- PreconditionFailedException
-
指定された RevisionId が、Lambda 関数またはエイリアスの最新 RevisionId と一致しません。
GetFunction
またはGetAlias
API 操作を呼び出して、リソースの最新の RevisionId を取得します。HTTP ステータスコード: 412
- ResourceConflictException
-
リソースが既に存在しているか、別のオペレーションが進行中です。
HTTP ステータスコード: 409
- ResourceNotFoundException
-
リクエストで指定されたリソースは存在しません。
HTTP ステータスコード: 404
- ServiceException
-
AWS Lambda サービスで内部エラーが発生しました。
HTTP ステータスコード: 500
- TooManyRequestsException
-
リクエストスループット制限を超えました。詳細については、「Lambda クォータ」を参照してください。
HTTP ステータスコード: 429
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。