本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
CreateReturnShippingLabel
建立將用於將 Snow 裝置退還給 AWS的運送標籤。
請求語法
{
"JobId": "string
",
"ShippingOption": "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}
必要:是
- ShippingOption
-
特定工作的運送速度。此速度並不代表裝置返回的速度。 AWS這個速度代表它在運輸過程中移動到目的地的速度。區域託運速度如下:
類型:字串
有效值:
SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD
必要:否
回應語法
{
"Status": "string"
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- Status
-
要返回的 Snow 裝置上任務的狀態資訊 AWS。
類型:字串
有效值:
InProgress | TimedOut | Succeeded | Failed
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- ConflictException
-
當您調用
CreateReturnShippingLabel
多次時,其他請求未完成時,您會得到此異常。HTTP 狀態碼:400
- InvalidInputCombinationException
-
Job 或叢集建立失敗。一個或多個輸入無效。請確認CreateCluster:SnowballType值支援您的CreateJob:JobType,然後再試一次。
HTTP 狀態碼:400
- InvalidJobStateException
-
無法執行動作,因為工作的目前狀態不允許執行該動作。
HTTP 狀態碼:400
- InvalidResourceException
-
找不到指定的資源。請檢查您上次要求中提供的資訊,然後再試一次。
HTTP 狀態碼:400
- ReturnShippingLabelAlreadyExistsException
-
如果您致電
CreateReturnShippingLabel
且有效的退件運送標籤已存在,則會收到此例外狀況。在這種情況下,請DescribeReturnShippingLabel
使用來獲取 URL。HTTP 狀態碼:400
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: