本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
DescribeReturnShippingLabel
注意
自 2025 年 11 月 7 日起, AWS Snowball 邊緣 僅適用於現有客戶。如果您想要使用 AWS Snowball 邊緣,請在該日期之前註冊。新客戶應探索AWS DataSync
要送回的 Snow 裝置運送標籤資訊 AWS。
請求語法
{
"JobId": "string"
}
請求參數
如需所有動作的一般參數資訊,請參閱《Common Parameters》。
請求接受採用 JSON 格式的下列資料。
- JobId
-
自動產生的任務 ID,例如
JID123e4567-e89b-12d3-a456-426655440000。類型:字串
長度限制:固定長度為 39。
模式:
(M|J)ID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}必要:是
回應語法
{
"ExpirationDate": number,
"ReturnShippingLabelURI": "string",
"Status": "string"
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- ExpirationDate
-
目前傳回運送標籤的過期日期。
類型:Timestamp
- ReturnShippingLabelURI
-
用於下載送回運送標籤的預先簽章 Amazon S3 URI。
類型:字串
長度限制:長度下限為 1。長度上限為 1024。
模式:
.* - Status
-
要傳回之 Snow 裝置上的任務狀態資訊 AWS。
類型:字串
有效值:
InProgress | TimedOut | Succeeded | Failed
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- ConflictException
-
當您在未完成其他請求時呼叫
CreateReturnShippingLabel多次時,就會收到此例外狀況。- ConflictResource
-
當您呼叫一次
CreateReturnShippingLabel以上的其他請求未完成時,您會取得此資源。
HTTP 狀態碼:400
- InvalidJobStateException
-
無法執行動作,因為任務的目前狀態不允許執行該動作。
HTTP 狀態碼:400
- InvalidResourceException
-
找不到指定的資源。請檢查您在上次請求中提供的資訊,然後再試一次。
- ResourceType
-
提供的資源值無效。
HTTP 狀態碼:400
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱下列內容: