本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
UpdateLocationObjectStorage
更新存AWS DataSync取傳輸之現有物件儲存位置的某些參數。如需建立自我管理物件儲存位置的相關資訊，請參閱建立物件儲存體的位置。
請求語法
{
"AccessKey": "string",
"AgentArns": [ "string" ],
"LocationArn": "string",
"SecretKey": "string",
"ServerCertificate": blob,
"ServerPort": number,
"ServerProtocol": "string",
"Subdirectory": "string"
}請求參數
如需有關所有動作共用之參數的資訊，請參閱一般參數。
請求接受採用 JSON 格式的下列資料。
- AccessKey
-
如果需要憑證才能與物件儲存伺服器進行驗證，請指定存取金鑰 (例如，使用者名稱)。
類型：字串
長度限制：長度下限為 1。長度上限為 200。
模式：
^.+$必要：否
- AgentArns
-
指定可以與位置安全連線之DataSync代理程式的 Amazon Resource Resource Val( 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}$必要：否
- 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}$必要：是
- SecretKey
-
如果需要憑證才能與物件儲存伺服器進行驗證，請指定私密金鑰 (例如，密碼)。
類型：字串
長度限制：長度下限為 1。長度上限為 200。
模式：
^.+$必要：否
- ServerCertificate
-
指定要與使用私人或自我簽署憑證授權單位 (CA) 的物件儲存系統進行驗證的憑證。您必須指定 Base64 編碼的
.pem檔案 (例如，file:///home/user/.ssh/storage_sys_certificate.pem)。憑證最多可達 32768 個位元組 (在編碼 Base64 之前)。若要使用此參數，請
ServerProtocol將設定為HTTPS。更新憑證不會干擾您正在進行的工作。
類型：Base64 編碼的二進位資料物件
長度上限為 32768。
必要：否
- ServerPort
-
指定物件儲存伺服器接受傳入網路流量的連接埠 (例如，連接埠 443)。
類型：整數
有效範圍：最小值為 1。最大值為 65536。
必要：否
- ServerProtocol
-
指定物件儲存伺服器用來通訊的通訊協定。
類型：字串
有效值:
HTTPS | HTTP必要：否
- Subdirectory
-
指定物件儲存伺服器的物件字首。如果這是來源位置，DataSync只會複製具有此字首的物件。如果這是目的地位置，DataSync寫入具有此字首的所有物件。
類型：字串
長度上限為 4096。
模式：
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$必要：否
回應元素
如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。
錯誤
如需所有動作常見的錯誤相關資訊，請參閱常見錯誤。
- InternalException
-
當在AWS DataSync服務中發生錯誤時，拋出此異常。
HTTP 狀態碼：500
- InvalidRequestException
-
當客戶端提交格式錯誤的請求時，拋出此異常。
HTTP 狀態碼：400
另請參閱
如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
