기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # CreateLocationObjectStorage 객체 스토리지 시스템의 전송 *위치를* 생성합니다.이 위치를 데이터 전송을 위한 소스 또는 대상으로 사용할 AWS DataSync 수 있습니다. [DataSync 에이전트](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#when-agent-required)를 사용하거나 사용하지 않고 전송할 수 있습니다. 시작하기 전에 DataSync가 객체 스토리지 시스템과 함께 작동하기 위한 [사전 조건](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html#create-object-location-prerequisites)을 이해해야 합니다. ## 구문 요청 ``` { "AccessKey": "string", "AgentArns": [ "string" ], "BucketName": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "SecretKey": "string", "ServerCertificate": blob, "ServerHostname": "string", "ServerPort": number, "ServerProtocol": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AccessKey](#API_CreateLocationObjectStorage_RequestSyntax) ** 객체 스토리지 서버에 인증하는 데 자격 증명이 필요한 경우, 액세스 키(예: 사용자 이름)를 지정합니다. 유형: 문자열 길이 제한: 최소 길이는 0. 최대 길이는 200입니다. 패턴: `^.*$` 필수 여부: 아니요 ** [AgentArns](#API_CreateLocationObjectStorage_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}$` 필수 여부: 아니요 ** [BucketName](#API_CreateLocationObjectStorage_RequestSyntax) ** 전송과 관련된 객체 스토리지 버킷의 이름을 지정합니다. 타입: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 63입니다. 패턴: `^[a-zA-Z0-9_\-\+\.\$\p{Zs}]+$` 필수 여부: 예 ** [CmkSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) ** DataSync 관리형 보안 암호의 구성 정보를 지정합니다. 이는 DataSync가 고객 관리형 AWS KMS key와 함께 특정 객체 스토리지 위치에 액세스하는 데 사용하는 `SecretKey`를 포함합니다. 이 파라미터를 `CreateLocationObjectStorage` 요청의 일부로 포함하는 경우 KMS 키 ARN만 제공합니다. DataSync는이 KMS 키를 `SecretKey` 파라미터에 지정한 값과 함께 사용하여 DataSync 관리형 보안 암호를 생성하고 위치 액세스 자격 증명을 저장합니다. DataSync에 지정한 KMS 키에 액세스할 수 있는 권한이 있는지 확인합니다. 자세한 내용은 [ 사용자 지정으로 암호화된 서비스 관리형 보안 암호 사용을 참조하세요 AWS KMS key](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). `CmkSecretConfig`(`SecretKey` 포함) 또는 `CustomSecretConfig`(`SecretKey` 제외)을 사용하여 `CreateLocationObjectStorage` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 필수 여부: 아니요 ** [CustomSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) ** 특정 객체 스토리지 위치의 보안 키가 Secrets Manager에 일반 텍스트로 저장되는 고객 관리형 Secrets Manager 보안 암호의 구성 정보를 지정합니다. 이 구성에는 보안 암호 ARN과 보안 암호에 대한 액세스를 제공하는 IAM 역할의 ARN이 포함됩니다. 자세한 내용은 [ 관리하는 보안 암호 사용을 참조하세요](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). `CmkSecretConfig`(`SecretKey` 포함) 또는 `CustomSecretConfig`(`SecretKey` 제외)을 사용하여 `CreateLocationObjectStorage` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 필수 여부: 아니요 ** [SecretKey](#API_CreateLocationObjectStorage_RequestSyntax) ** 객체 스토리지 서버에 인증하는 데 자격 증명이 필요한 경우, 보안 암호 키(예: 암호)를 지정합니다. 를 사용하여 보안 암호를 제공`SecretKey`하지만 `CmkSecretConfig` 또는를 사용하여 보안 암호 구성 세부 정보를 제공하지 않는 경우 `CustomSecretConfig` DataSync는 AWS 계정의 Secrets Manager 보안 암호를 사용하여 토큰을 저장합니다. 유형: 문자열 길이 제한: 최소 길이는 0. 최대 길이는 200입니다. 패턴: `^.*$` 필수 여부: 아니요 ** [ServerCertificate](#API_CreateLocationObjectStorage_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_CreateLocationObjectStorage_RequestSyntax) ** DataSync 에이전트가 연결될 객체 스토리지 서버의 도메인 이름 또는 IP 주소(IPv4 또는 IPv6)를 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 255입니다. 패턴: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` 필수 여부: 예 ** [ServerPort](#API_CreateLocationObjectStorage_RequestSyntax) ** 객체 스토리지 서버가 인바운드 네트워크 트래픽을 수락하는 포트(예: 포트 443)를 지정합니다. 타입: 정수 유효 범위: 최소값 1. 최대값은 65536입니다. 필수 여부: 아니요 ** [ServerProtocol](#API_CreateLocationObjectStorage_RequestSyntax) ** 객체 스토리지 서버의 통신에 사용되는 프로토콜을 지정합니다. 지정하지 않은 경우 기본값은 `HTTPS`입니다. 타입: 문자열 유효 값: `HTTPS | HTTP` 필수 여부: 아니요 ** [Subdirectory](#API_CreateLocationObjectStorage_RequestSyntax) ** 객체 스토리지 서버의 객체 접두사를 지정합니다. 소스 위치인 경우, DataSync는 이 접두사가 있는 객체만 복사합니다. 목적지 위치인 경우, DataSync는 이 접두사가 있는 모든 객체를 씁니다. 타입: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` 필수 여부: 아니요 ** [Tags](#API_CreateLocationObjectStorage_RequestSyntax) ** 리소스에 추가하려는 태그를 나타내는 키-값 쌍을 지정합니다. 태그는 리소스 관리, 필터링 및 검색에 도움이 됩니다. 위치에 이름 태그를 생성하는 것이 좋습니다. 타입: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ## 응답 구문 ``` { "LocationArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [LocationArn](#API_CreateLocationObjectStorage_ResponseSyntax) ** 생성한 오브젝트 스토리지 시스템 위치의 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}$` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류 유형](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/CreateLocationObjectStorage) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationObjectStorage)