本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
CreateLocationObjectStorage
建立物件儲存系統的端點AWS DataSync可以訪問轉移。如需詳細資訊,請參閱「」為對象存儲創建位置。
請求語法
{
"AccessKey": "string
",
"AgentArns": [ "string
" ],
"BucketName": "string
",
"SecretKey": "string
",
"ServerHostname": "string
",
"ServerPort": number
,
"ServerProtocol": "string
",
"Subdirectory": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
]
}
請求參數
有關所有動作共用的參數的信息,請參閲一般參數。
請求接受採用 JSON 格式的下列資料。
- AccessKey
-
如果需要憑據才能通過對象存儲服務器進行身份驗證,則指定訪問密鑰(例如,用户名)。
類型:字串
長度限制:長度下限為 8。長度上限為 200。
模式:
^.+$
:必要 否
- AgentArns
-
的 Amazon Resource Name (ARN)。 DataSync 代理,可以安全地連接到您的位置。
類型:字串陣列
陣列成員:項目數下限為 1。項目數上限為 4。
長度限制:長度上限為 128。
模式:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$
:必要 是
- BucketName
-
指定傳輸中涉及的對象存儲桶的名稱。
類型:字串
長度限制:長度下限為 3。長度上限為 63。
模式:
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$
:必要 是
- SecretKey
-
如果需要憑據才能通過對象存儲服務器進行身份驗證,則指定私有密鑰(例如密碼)。
類型:字串
長度限制:長度下限為 8。長度上限為 200。
模式:
^.+$
:必要 否
- ServerHostname
-
物件儲存伺服器的網域名稱或 IP 地址。一個 DataSync 代理程式會使用此主機名稱在網路中掛載物件儲存伺服器。
類型:字串
長度限制:長度上限為 255。
模式:
^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$
:必要 是
- ServerPort
-
指定物件儲存伺服器接受傳入網路流量的連接口(例如端口 443)。
類型:整數
有效範圍:最小值為 1。最大值為 65536。
:必要 否
- ServerProtocol
-
指定物件儲存伺服器的通訊協定。
類型:字串
有效值:
HTTPS | HTTP
:必要 否
- Subdirectory
-
指定對象存儲服務器的對象前綴。如果這是源位置, DataSync 僅複製帶有此前綴的對象。如果這是目標位置, DataSync 使用此前綴寫入所有物件。
類型:字串
長度限制:長度上限為 4096。
模式:
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$
:必要 否
- Tags
-
指定代表您要新增至資源之標籤的鍵值對。標籤可協助您管理、篩選和搜尋資源。建議您為位置建立名稱標籤。
類型:的陣列TagListEntry對象
陣列成員:項目數下限為 0。項目數上限為 50。
:必要 否
回應語法
{
"LocationArn": "string"
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- LocationArn
-
指定您創建的對象存儲系統位置的 ARN。
類型:字串
長度限制:長度上限為 128。
模式:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$
錯誤
如需所有動作常見的錯誤相關資訊,請參閱常見錯誤。
- InternalException
-
當AWS DataSync服務。
HTTP 狀態碼:500
- InvalidRequestException
-
當客户端提交格式錯誤的請求時,就會擲出此例外狀況。
HTTP 狀態碼:400
另請參閱
如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: