CreateLocationObjectStorage - AWS DataSync

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

CreateLocationObjectStorage

為自我管理的物件儲存貯體建立端點。如需有關自我管理物件儲存位置的詳細資訊,請參閱建立物件儲存位置

請求語法

{ "AccessKey": "string", "AgentArns": [ "string" ], "BucketName": "string", "SecretKey": "string", "ServerHostname": "string", "ServerPort": number, "ServerProtocol": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

請求參數

如需所有動作常見的參數相關資訊,請參閱一般參數

請求接受採用 JSON 格式的下列資料。

AccessKey

選用。如果需要登入資料才能存取自我管理的物件儲存伺服器,則會使用存取金鑰。如果您的物件儲存需要使用者名稱和密碼來進行驗證,請分別使用 AccessKeySecretKey 來提供使用者名稱和密碼。

類型:字串

長度限制:長度下限為 8。長度上限為 200。

模式:^.+$

必要:否

AgentArns

與自我管理物件儲存伺服器位置相關聯之代理程式的 Amazon Resource Name (ARN)。

類型:字串陣列

陣列成員:項目數下限為 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

選用。如果需要登入資料才能存取自我管理的物件儲存伺服器,則會使用私密金鑰。如果您的物件儲存需要使用者名稱和密碼來進行驗證,請分別使用 AccessKeySecretKey 來提供使用者名稱和密碼。

類型:字串

長度限制:長度下限為 8。長度上限為 200。

模式:^.+$

必要:否

ServerHostname

自我管理物件儲存伺服器的名稱。這個值是物件儲存伺服器的 IP 地址或網域名稱服務 (DNS) 名稱。代理程式會使用此主機名稱來掛載網路中的物件儲存伺服器。

類型:字串

長度限制:長度上限為 255。

模式:^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$

必要:是

ServerPort

自我管理物件儲存伺服器接受傳入網路流量的連接埠。伺服器連接埠預設為 TCP 80 (HTTP) 或 TCP 443 (HTTPS)。如果您的自我管理物件儲存伺服器需要自訂連接埠,您可以指定一個。

類型:整數

有效範圍:最小值為 1。最大值為 65536。

必要:否

ServerProtocol

物件儲存伺服器的通訊協定。有效值為 HTTP 或 HTTPS。

類型:字串

有效值: HTTPS | HTTP

必要:否

Subdirectory

自我管理物件儲存體伺服器上用來讀取資料的子目錄。

類型:字串

長度限制:長度上限為 4096。

模式:^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$

必要:否

Tags

代表您要新增至位置之標籤的鍵值對。此數值可以是空字串。建議您使用標籤來命名資源。

類型:陣列TagListEntry對象

陣列成員:項目數下限為 0。項目數上限為 50。

必要:否

回應語法

{ "LocationArn": "string" }

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

LocationArn

與自我管理物件儲存伺服器位置相關聯之代理程式的 Amazon Resource Name (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}$

Errors

如需所有動作常見的錯誤相關資訊,請參閱常見錯誤

InternalException

當錯誤發生時,就會擲出此例外狀況AWS DataSync服務。

HTTP 狀態碼:500

InvalidRequestException

當客戶端提交格式不正確的請求時,就會擲出此例外狀況。

HTTP 狀態碼:400

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: