Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

Membuat [alias](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html) untuk versi fungsi Lambda. Gunakan alias untuk menyediakan klien dengan pengidentifikasi fungsi yang dapat Anda perbarui untuk memanggil versi yang berbeda.

Anda juga dapat memetakan alias untuk membagi permintaan pemanggilan di antara dua versi. Gunakan parameter `RoutingConfig` untuk menentukan versi kedua dan persentase permintaan pemanggilan yang diterima.

## Minta Sintaks
<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 
      }
   }
}
```

## Parameter Permintaan URI
<a name="API_CreateAlias_RequestParameters"></a>

Permintaan menggunakan parameter URI berikut.

 ** [FunctionName](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-FunctionName"></a>
Nama fungsi Lambda.  

**Format nama**
+  **Nama fungsi** - `MyFunction`.
+  **ARN Fungsi** - `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
+  **ARN sebagian** - `123456789012:function:MyFunction`.
Batas panjang hanya berlaku untuk ARN penuh. Jika Anda hanya menentukan nama fungsi, panjang nama dibatasi hingga 64 karakter.  
Panjang Batasan: Panjang minimum 1. Panjang maksimum 140.  
Pola: `(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-_]+))?`   
Wajib: Ya

## Isi Permintaan
<a name="API_CreateAlias_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [Description](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-Description"></a>
Deskripsi alias.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 256.  
Diperlukan: Tidak

 ** [FunctionVersion](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-FunctionVersion"></a>
Versi fungsi yang alias panggilan.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024.  
Pola: `(\$LATEST|[0-9]+)`   
Diperlukan: Ya

 ** [Name](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-Name"></a>
Nama alias.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.  
Pola: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)`   
Diperlukan: Ya

 ** [RoutingConfig](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-RoutingConfig"></a>
[Konfigurasi perutean](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html#configuring-alias-routing) alias.  
Tipe: Objek [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md).  
Wajib: Tidak

## Sintaksis Respons
<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 
      }
   }
}
```

## Elemen Respons
<a name="API_CreateAlias_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respon HTTP 201.

Layanan mengembalikan data berikut dalam format JSON.

 ** [AliasArn](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-AliasArn"></a>
Amazon Resource Name (ARN) alias.  
Tipe: String  
Pola: `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>
Deskripsi alias.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 256.

 ** [FunctionVersion](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-FunctionVersion"></a>
Versi fungsi yang alias panggilan.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024.  
Pola: `(\$LATEST|[0-9]+)` 

 ** [Name](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-Name"></a>
Nama alias.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.  
Pola: `(?!^[0-9]+$)([a-zA-Z0-9-_]+)` 

 ** [RevisionId](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-RevisionId"></a>
Pengidentifikasi unik yang berubah saat Anda memperbarui alias.  
Jenis: String

 ** [RoutingConfig](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-RoutingConfig"></a>
[Konfigurasi perutean](https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html) alias.  
Tipe: Objek [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md).

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

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** InvalidParameterValueException **   
Salah satu parameter dalam permintaan tidak valid.  
Kode Status HTTP: 400

 ** ResourceConflictException **   
Sumber daya sudah ada, atau operasi lain sedang berlangsung.  
Kode Status HTTP: 409

 ** ResourceNotFoundException **   
Sumber daya yang ditentukan dalam permintaan tidak ada.  
Kode Status HTTP: 404

 ** ServiceException **   
Layanan AWS Lambda mengalami kesalahan internal.  
Kode Status HTTP: 500

 ** TooManyRequestsException **   
Batas throughput permintaan terlampaui. Untuk informasi lebih lanjut, lihat Kuota [Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Kode Status HTTP: 429

## Lihat Juga
<a name="API_CreateAlias_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:
+  [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). 
+  [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateAlias) 
+  [AWSSDK untuk V3 JavaScript ](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)