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.
Pattern:
(?!^[0-9]+$)([a-zA-Z0-9-_]+)
필수 항목 여부: 예
요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
- Description
-
별칭에 대한 설명.
유형: 문자열
길이 제약: 최소 길이는 0. 최대 길이 256.
필수 항목 여부: 아니요
- FunctionVersion
-
별칭이 호출하는 함수 버전입니다.
유형: String
길이 제약: 최소 길이 1. 최대 길이는 1024입니다.
패턴:
(\$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)입니다.
유형: String
패턴:
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
-
별칭이 호출하는 함수 버전입니다.
유형: String
길이 제약: 최소 길이 1. 최대 길이는 1024입니다.
Pattern:
(\$LATEST|[0-9]+)
- Name
-
별칭의 이름.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
Pattern:
(?!^[0-9]+$)([a-zA-Z0-9-_]+)
- RevisionId
-
별칭을 업데이트할 때 변경되는 고유 식별자입니다.
유형: 문자열
- RoutingConfig
-
별칭의 라우팅 구성입니다.
유형: AliasRoutingConfiguration 객체
Errors
모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- InvalidParameterValueException
-
요청의 파라미터 중 하나가 유효하지 않습니다.
HTTP 상태 코드: 400
- PreconditionFailedException
-
제공된 RevisionId가 Lambda 함수 또는 별칭에 대한 최신 RevisionId와 일치하지 않습니다. 리소스의 최신 RevisionId를 검색하려면
GetFunction
또는GetAlias
API 작업을 호출합니다.HTTP 상태 코드: 412
- ResourceConflictException
-
리소스가 이미 있거나 다른 작업이 진행 중입니다.
HTTP 상태 코드: 409
- ResourceNotFoundException
-
요청에 지정된 리소스가 없습니다.
HTTP 상태 코드: 404
- ServiceException
-
AWS Lambda 서비스에 내부 오류가 발생했습니다.
HTTP 상태 코드: 500
- TooManyRequestsException
-
요청 처리량 제한을 초과했습니다. 자세한 내용은 Lambda 할당량을 참조하세요.
HTTP Status Code: 429
참고
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 설명은 다음을 참조하세요.