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

# CreateAddress
<a name="API_CreateAddress"></a>

**注意**  
 AWS Snowball 邊緣 不再提供給新客戶。新客戶應探索[AWS DataSync](https://aws.amazon.com/datasync/)線上傳輸、用於安全實體傳輸的[AWS 資料傳輸終端機](https://aws.amazon.com/data-transfer-terminal/)，或 AWS 合作夥伴解決方案。對於邊緣運算，請探索 [AWS Outposts](https://aws.amazon.com/outposts/)。

為要運送的 Snow 裝置建立地址。地址會在建立時驗證。您提供的地址必須位於您區域的可用區域內。如果地址無效或不支援，則會擲回例外狀況。如果透過 `cli-input-json`選項以 JSON 檔案的形式提供地址，請包含完整的檔案路徑。例如 `--cli-input-json file://create-address.json`。

## 請求語法
<a name="API_CreateAddress_RequestSyntax"></a>

```
{
   "Address": { 
      "AddressId": "string",
      "City": "string",
      "Company": "string",
      "Country": "string",
      "IsRestricted": boolean,
      "Landmark": "string",
      "Name": "string",
      "PhoneNumber": "string",
      "PostalCode": "string",
      "PrefectureOrDistrict": "string",
      "StateOrProvince": "string",
      "Street1": "string",
      "Street2": "string",
      "Street3": "string",
      "Type": "string"
   }
}
```

## 請求參數
<a name="API_CreateAddress_RequestParameters"></a>

如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。

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

 ** [Address](#API_CreateAddress_RequestSyntax) **   <a name="Snowball-CreateAddress-request-Address"></a>
您希望 Snow 裝置運送的地址。  
類型：[Address](API_Address.md) 物件  
必要：是

## 回應語法
<a name="API_CreateAddress_ResponseSyntax"></a>

```
{
   "AddressId": "string"
}
```

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

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

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

 ** [AddressId](#API_CreateAddress_ResponseSyntax) **   <a name="Snowball-CreateAddress-response-AddressId"></a>
針對特定地址自動產生的 ID。建立任務時，您將使用此 ID，以指定您希望該任務的 Snow 裝置運送到哪個地址。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`.*`

## 錯誤
<a name="API_CreateAddress_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。

 ** InvalidAddressException **   
提供的地址無效。請洽詢您區域的電信業者，然後再試一次。  
HTTP 狀態碼：400

 ** UnsupportedAddressException **   
地址位於您所在區域的可用區域之外，或發生錯誤。請向您所在區域的電信業者檢查地址，然後再試一次。如果問題仍然存在，請聯絡 支援。  
HTTP 狀態碼：400

## 另請參閱
<a name="API_CreateAddress_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/snowball-2016-06-30/CreateAddress) 
+  [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/snowball-2016-06-30/CreateAddress) 
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/CreateAddress) 
+  [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/CreateAddress) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/CreateAddress) 
+  [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snowball-2016-06-30/CreateAddress) 
+  [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/snowball-2016-06-30/CreateAddress) 
+  [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/CreateAddress) 
+  [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/CreateAddress) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/CreateAddress)