기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 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" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AccessKey](#API_UpdateLocationObjectStorage_RequestSyntax) ** 객체 스토리지 서버에 인증하는 데 자격 증명이 필요한 경우, 액세스 키(예: 사용자 이름)를 지정합니다. 유형: 문자열 길이 제한: 최소 길이는 0. 최대 길이는 200입니다. 패턴: `^.*$` 필수 여부: 아니요 ** [AgentArns](#API_UpdateLocationObjectStorage_RequestSyntax) ** (선택 사항) 객체 스토리지 시스템과 연결할 수 있는 DataSync 에이전트의 Amazon 리소스 이름(ARN)을 지정합니다. 에이전트 없는 클라우드 간 전송을 설정하는 경우 이 파라미터에 값을 지정할 필요가 없습니다. 에이전트를 처음 생성한 후에는 스토리지 위치에서 에이전트를 추가하거나 제거할 수 없습니다. 타입: 문자열 배열 배열 구성원: 최소수는 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가 객체 스토리지 시스템으로 인증하기 위한 인증서 체인을 지정합니다. 전체 인증서 체인(예: `file:///home/user/.ssh/object_storage_certificates.pem`)이 있는 단일 `.pem` 파일을 지정해야 합니다. 인증서 체인에는 다음이 포함될 수 있습니다. + 객체 스토리지 시스템의 인증서 + 모든 중간 인증서(있는 경우) + 서명 CA의 루트 인증서 인증서를 `.pem` 파일로 연결할 수 있습니다(base64 인코딩 전 최대 32,768바이트). 다음 예제의 `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 + [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 SDK for C\$1\$1](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationObjectStorage)