本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateLocationObjectStorage
為自我管理的物件儲存貯體建立端點。如需有關自我管理物件儲存位置的詳細資訊，請參閱建立物件儲存位置。
請求語法
{
"AccessKey": "string",
"AgentArns": [ "string" ],
"BucketName": "string",
"SecretKey": "string",
"ServerHostname": "string",
"ServerPort": number,
"ServerProtocol": "string",
"Subdirectory": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}請求參數
如需所有動作常見的參數相關資訊，請參閱一般參數。
請求接受採用 JSON 格式的下列資料。
- AccessKey
-
選用。如果需要登入資料才能存取自我管理的物件儲存伺服器，則會使用存取金鑰。如果您的物件儲存需要使用者名稱和密碼來進行驗證，請分別使用
AccessKey和SecretKey來提供使用者名稱和密碼。類型：字串
長度限制：長度下限為 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
-
選用。如果需要登入資料才能存取自我管理的物件儲存伺服器，則會使用私密金鑰。如果您的物件儲存需要使用者名稱和密碼來進行驗證，請分別使用
AccessKey和SecretKey來提供使用者名稱和密碼。類型：字串
長度限制：長度下限為 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 的詳細資訊，請參閱下列說明：
