本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # UpdateLocationObjectStorage 修改您正在使用之物件儲存體傳輸位置的下列組態參數 AWS DataSync。如需詳細資訊，請參閱[使用物件儲存系統設定 DataSync 傳輸](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html)。 ## 請求語法 ``` { "AccessKey": "string", "AgentArns": [ "string" ], "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "LocationArn": "string", "SecretKey": "string", "ServerCertificate": blob, "ServerHostname": "string", "ServerPort": number, "ServerProtocol": "string", "Subdirectory": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [AccessKey](#API_UpdateLocationObjectStorage_RequestSyntax) ** 如果需要憑證才能與物件儲存伺服器進行驗證，請指定存取金鑰 (例如，使用者名稱)。類型：字串長度限制：長度下限為 0。長度上限為 200。模式：`^.*$` 必要：否 ** [AgentArns](#API_UpdateLocationObjectStorage_RequestSyntax) ** （選用）指定可與物件儲存系統連線之 DataSync 代理程式的 Amazon Resource Name (ARNs)。如果您要設定無代理程式跨雲端傳輸，則不需要為此參數指定值。您無法在最初建立代理程式之後，從儲存位置新增或移除代理程式。類型：字串陣列陣列成員：項目數下限為 1。最多 8 個項目。長度限制：長度上限為 128。模式：`^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$` 必要：否 ** [CmkSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) ** 指定 DataSync 受管秘密的組態資訊，例如身分驗證字符或一組憑證，供 DataSync 用來存取特定傳輸位置，以及客戶受管 AWS KMS key。類型：[CmkSecretConfig](API_CmkSecretConfig.md) 物件必要：否 ** [CustomSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) ** 指定客戶受管秘密的組態資訊，例如 DataSync 用來存取特定傳輸位置的身分驗證字符或一組登入資料，以及提供秘密存取權的客戶受管 AWS Identity and Access Management (IAM) 角色。類型：[CustomSecretConfig](API_CustomSecretConfig.md) 物件必要：否 ** [LocationArn](#API_UpdateLocationObjectStorage_RequestSyntax) ** 指定您要更新之物件儲存系統位置的 ARN。類型：字串長度限制：長度上限為 128。模式：`^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$` 必要：是 ** [SecretKey](#API_UpdateLocationObjectStorage_RequestSyntax) ** 如果需要憑證才能與物件儲存伺服器進行驗證，請指定私密金鑰 (例如，密碼)。如果您使用提供秘密`SecretKey`，但未使用 `CmkSecretConfig`或提供秘密組態詳細資訊`CustomSecretConfig`，則 DataSync 會使用您 AWS 帳戶的 Secrets Manager 秘密來存放字符。類型：字串長度限制：長度下限為 0。長度上限為 200。模式：`^.*$` 必要：否 ** [ServerCertificate](#API_UpdateLocationObjectStorage_RequestSyntax) ** 如果系統使用私有或自我簽署憑證授權單位 (CA)，則指定 DataSync 的憑證鏈來驗證物件儲存系統。您必須指定具有完整憑證鏈的單一`.pem`檔案（例如 `file:///home/user/.ssh/object_storage_certificates.pem`)。憑證鏈可能包括： + 物件儲存系統的憑證 + 所有中繼憑證（如果有的話） + 簽署 CA 的根憑證您可以將憑證串連至`.pem`檔案（在 base64 編碼之前最多可達 32768 個位元組）。下列範例`cat`命令會建立包含三個憑證`object_storage_certificates.pem`的檔案： `cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem` 若要使用此參數，請將 `ServerProtocol`設定為 `HTTPS`。更新此參數不會影響您正在進行的任務。類型：Base64 編碼的二進位資料物件長度限制：長度上限為 32768。必要：否 ** [ServerHostname](#API_UpdateLocationObjectStorage_RequestSyntax) ** 指定 DataSync 代理程式連線之物件儲存伺服器的網域名稱或 IP 地址 (IPv4 或 IPv6)。類型：字串長度限制：長度上限為 255。模式：`^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` 必要：否 ** [ServerPort](#API_UpdateLocationObjectStorage_RequestSyntax) ** 指定物件儲存伺服器接受傳入網路流量的連接埠 (例如，連接埠 443)。類型：整數有效範圍：最小值為 1。最大值為 65536。必要：否 ** [ServerProtocol](#API_UpdateLocationObjectStorage_RequestSyntax) ** 指定物件儲存伺服器用來通訊的通訊協定。類型：字串有效值:`HTTPS | HTTP` 必要：否 ** [Subdirectory](#API_UpdateLocationObjectStorage_RequestSyntax) ** 指定物件儲存伺服器的物件字首。如果這是來源位置，DataSync 只會複製具有此字首的物件。如果這是目的地位置，DataSync 會寫入具有此字首的所有物件。類型：字串長度限制：長度上限為 4096。模式：`^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` 必要：否 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InternalException ** 當服務發生錯誤時，就會擲出此 AWS DataSync 例外狀況。 HTTP 狀態碼：500 ** InvalidRequestException ** 當用戶端提交格式不正確的請求時，會擲回此例外狀況。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationObjectStorage)