本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# CreateAppClient
<a name="API_CreateAppClient"></a>


|  | 
| --- |
| 生產力的 The AWS AppFabric 功能處於預覽狀態，可能會有所變更。 | 

建立 AppClient。

**Topics**
+ [請求內文](#API_CreateAppClient_request)
+ [回應元素](#API_CreateAppClient_response)

## 請求內文
<a name="API_CreateAppClient_request"></a>

請求接受採用 JSON 格式的下列資料。


| 參數 | Description | 
| --- | --- | 
| **appName** | 應用程式的名稱。<br />類型：字串<br />長度限制：長度下限為 1。長度上限為 255。<br />必要：是 | 
| **clientToken** | 指定您提供的唯一、區分大小寫的識別符，以確保請求的冪等性。這可讓您安全地重試請求，而不會意外再次執行相同的操作。將相同的值傳遞給稍後的 操作呼叫，也需要您為所有其他參數傳遞相同的值。我們建議您使用 [UUID 類型的值](https://wikipedia.org/wiki/Universally_unique_identifier)。<br />如果您未提供此值，則 會為您 AWS 產生隨機值。<br />如果您使用相同的 重試操作`ClientToken`，但使用不同的參數，則重試會失敗並顯示`IdempotentParameterMismatch`錯誤。<br />類型：字串<br />模式：`[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`<br />必要：否 | 
| **customerManagedKeyIdentifier** | 由 客戶受管金鑰 產生的 ARN AWS Key Management Service。金鑰用於加密資料。<br />如果未指定金鑰，則會 AWS 受管金鑰 使用 。要指派給資源之標籤或標籤的鍵值對映射。<br />如需 AWS 擁有的金鑰 和客戶受管金鑰的詳細資訊，請參閱《 *AWS Key Management Service 開發人員指南*》中的[客戶金鑰和 AWS 金鑰](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt)。<br />類型：字串<br />長度限制：長度下限為 1。長度上限為 1011。<br />模式：`arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`<br />必要：否 | 
| **description** | 應用程式的說明。<br />類型：字串<br />必要：是 | 
| **iconUrl** | AppClient 圖示或標誌的 URL。<br />類型：字串<br />必要：否 | 
| **redirectUrls** | 授權後將最終使用者重新導向至 的 URI。您最多可以新增 5 個 redirectUrls。例如 `https://localhost:8080`。<br />類型：字串陣列<br />陣列成員：項目數下限為 1。項目數上限為 5。<br />長度限制：長度下限為 1。長度上限為 2048。<br />模式：`(http\|https):\/\/[-a-zA-Z0-9_:.\/]+`<br />必要：是 | 
| **starterUserEmails** | 允許存取以接收洞見的使用者的入門電子郵件地址，直到 AppClient 驗證為止。<br />類型：字串陣列<br />陣列成員：固定項目數為 1。<br />長度限制：長度下限為 0。長度上限為 320。<br />模式：`[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*`<br />必要：是 | 
| **tags** | 要指派給資源之標籤或標籤的鍵值對映射。<br />類型：標籤物件陣列<br />陣列成員：項目數下限為 0。項目數上限為 50。<br />必要：否 | 

## 回應元素
<a name="API_CreateAppClient_response"></a>

如果動作成功，則服務傳回 HTTP 201 回應。

服務會傳回下列 JSON 格式的資料。


| 參數 | Description | 
| --- | --- | 
| **appClientSummary** | 包含 AppClient 的摘要。<br />類型：[AppClientSummary](API_AppClientSummary.md) 物件 |