# CreateAlias
<a name="API_CreateAlias"></a>

Lambda 함수 버전의 [별칭](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)을 생성합니다. 별칭을 사용하여 클라이언트에 다른 버전을 호출하도록 업데이트할 수 있는 함수 식별자를 제공합니다.

별칭을 매핑하여 두 버전 간에 호출 요청을 분할할 수도 있습니다. `RoutingConfig` 파라미터를 사용하여 수신하는 두 번째 버전과 호출 요청의 백분율을 지정합니다.

## 요청 구문
<a name="API_CreateAlias_RequestSyntax"></a>

```
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 요청 파라미터
<a name="API_CreateAlias_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [FunctionName](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-FunctionName"></a>
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-_]+))?`   
필수 항목 여부: 예

## 요청 본문
<a name="API_CreateAlias_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Description](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-Description"></a>
별칭에 대한 설명.  
유형: 문자열  
길이 제약: 최소 길이는 0. 최대 길이 256.  
필수 항목 여부: 아니요

 ** [FunctionVersion](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-FunctionVersion"></a>
별칭이 호출하는 함수 버전입니다.  
유형: String  
길이 제약: 최소 길이 1. 최대 길이는 1024입니다.  
패턴: `(\$LATEST|[0-9]+)`   
필수 항목 여부: 예

 ** [Name](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-Name"></a>
별칭의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
Pattern: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)`   
필수 항목 여부: 예

 ** [RoutingConfig](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-RoutingConfig"></a>
별칭의 [라우팅 구성](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html#configuring-alias-routing)입니다.  
유형: [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) 객체  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_CreateAlias_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

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

## 응답 요소
<a name="API_CreateAlias_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 201 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [AliasArn](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-AliasArn"></a>
별칭의 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](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-Description"></a>
별칭에 대한 설명.  
유형: 문자열  
길이 제약: 최소 길이는 0. 최대 길이는 256입니다.

 ** [FunctionVersion](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-FunctionVersion"></a>
별칭이 호출하는 함수 버전입니다.  
유형: String  
길이 제약: 최소 길이 1. 최대 길이는 1024입니다.  
Pattern: `(\$LATEST|[0-9]+)` 

 ** [Name](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-Name"></a>
별칭의 이름.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
Pattern: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)` 

 ** [RevisionId](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-RevisionId"></a>
별칭을 업데이트할 때 변경되는 고유 식별자입니다.  
유형: 문자열

 ** [RoutingConfig](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-RoutingConfig"></a>
별칭의 [라우팅 구성](https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html)입니다.  
유형: [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md) 객체

## Errors
<a name="API_CreateAlias_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
요청의 파라미터 중 하나가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceConflictException **   
리소스가 이미 있거나 다른 작업이 진행 중입니다.  
HTTP 상태 코드: 409

 ** ResourceNotFoundException **   
요청에 지정된 리소스가 없습니다.  
HTTP 상태 코드: 404

 ** ServiceException **   
AWS Lambda 서비스에 내부 오류가 발생했습니다.  
HTTP 상태 코드: 500

 ** TooManyRequestsException **   
요청 처리량 제한을 초과했습니다. 자세한 내용은 [Lambda 할당량](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)을 참조하세요.  
HTTP Status Code: 429

## 참고
<a name="API_CreateAlias_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 설명은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateAlias) 
+  [JavaScript V3용 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateAlias) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateAlias)