本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateReturnShippingLabel
注意
自 2025 年 11 月 7 日起， AWS Snowball 邊緣 僅適用於現有客戶。如果您想要使用 AWS Snowball 邊緣，請在該日期之前註冊。新客戶應探索AWS DataSync
建立將用於將 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多次時，就會收到此例外狀況。- ConflictResource
-
當您呼叫一次
CreateReturnShippingLabel以上的其他請求未完成時，您會取得此資源。
HTTP 狀態碼：400
- InvalidInputCombinationException
-
任務或叢集建立失敗。一或多個輸入無效。確認 CreateCluster：SnowballType 值支援您的 CreateJob：JobType，然後再試一次。
HTTP 狀態碼：400
- InvalidJobStateException
-
無法執行動作，因為任務的目前狀態不允許執行該動作。
HTTP 狀態碼：400
- InvalidResourceException
-
找不到指定的資源。請檢查您在上一個請求中提供的資訊，然後再試一次。
- ResourceType
-
提供的資源值無效。
HTTP 狀態碼：400
- ReturnShippingLabelAlreadyExistsException
-
如果您呼叫
CreateReturnShippingLabel且已存在有效的退回運送標籤，則會收到此例外狀況。在此情況下，請使用DescribeReturnShippingLabel取得 URL。HTTP 狀態碼：400
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
