CreateLocationObjectStorage - AWS DataSync

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

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 的詳細資訊,請參閱下列說明: