本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
DescribeAddresses
注意
AWS Snowball 邊緣 不再提供給新客戶。新客戶應探索AWS DataSync
傳回指定數量的ADDRESS物件。在其中一個美國區域呼叫此 API,將從所有美國區域中與此帳戶相關聯的所有地址清單中傳回地址。
請求語法
{
"MaxResults": number,
"NextToken": "string"
}
請求參數
如需所有動作的一般參數資訊,請參閱《Common Parameters》。
請求接受採用 JSON 格式的下列資料。
- MaxResults
-
要傳回的
ADDRESS物件數量。類型:整數
有效範圍:最小值為 0。最大值為 100。
必要:否
- NextToken
-
HTTP 請求是無狀態的。若要識別物件清單中的「下一個」
ADDRESS物件,您可以選擇指定 的值NextToken做為傳回地址清單的起點。類型:字串
長度限制:長度下限為 1。長度上限為 1024。
模式:
.*必要:否
回應語法
{
"Addresses": [
{
"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"
}
],
"NextToken": "string"
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- InvalidNextTokenException
-
NextToken字串發生意外變更,且操作已停止。執行操作而不變更NextToken字串,然後再試一次。HTTP 狀態碼:400
- InvalidResourceException
-
找不到指定的資源。請檢查您在上次請求中提供的資訊,然後再試一次。
- ResourceType
-
提供的資源值無效。
HTTP 狀態碼:400
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱下列內容: