기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # CreateLocationS3 Amazon S3 버킷의 전송 *위치*를 생성합니다. AWS DataSync 는 이 위치를 데이터 전송을 위한 소스 또는 대상으로 사용할 수 있습니다. **중요** 시작하기 전에 다음 주제를 읽어보시기 바랍니다. [Amazon S3 위치의 스토리지 클래스 고려 사항](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) [DataSync 사용 시 S3 요청 비용 평가](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) 자세한 내용은 [Configuring transfers with Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html) 섹션을 참조하세요. ## 구문 요청 ``` { "AgentArns": [ "string" ], "S3BucketArn": "string", "S3Config": { "BucketAccessRoleArn": "string" }, "S3StorageClass": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AgentArns](#API_CreateLocationS3_RequestSyntax) ** (Amazon S3 on Outposts만 해당) Outpost에 있는 DataSync 에이전트의 Amazon 리소스 이름(ARN)을 지정합니다. 자세한 내용은 [ DataSync 에이전트 배포를 참조하세요 AWS Outposts](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent). 타입: 문자열 배열 배열 구성원: 최소수는 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}$` 필수 여부: 아니요 ** [S3BucketArn](#API_CreateLocationS3_RequestSyntax) ** 위치로 사용할 S3 버킷의 ARN을 지정합니다. (나중에 DataSync 작업을 생성할 때 이 위치가 전송 소스인지 대상인지를 지정합니다.) S3 버킷이 AWS Outposts 리소스에 있는 경우 Amazon S3 액세스 포인트를 지정해야 합니다. 자세한 내용은 *Amazon S3 사용 설명서*에서 [Amazon S3 액세스 포인트를 사용한 데이터 액세스 관리](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html)를 참조하세요. 유형: 문자열 길이 제약: 최대 길이는 268입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$` 필수 여부: 예 ** [S3Config](#API_CreateLocationS3_RequestSyntax) ** DataSync가 S3 버킷에 액세스하는 데 사용하는 (IAM) 역할의 Amazon 리소스 이름 AWS Identity and Access Management (ARN)을 지정합니다. 자세한 내용은 [DataSync에 S3 버킷 액세스 권한 제공](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access)을 참조하세요. 타입: [S3Config](API_S3Config.md)객체 필수 항목 여부: 예 ** [S3StorageClass](#API_CreateLocationS3_RequestSyntax) ** Amazon S3가 전송 대상일 때 객체가 사용할 스토리지 클래스를 지정합니다. 의 버킷 AWS 리전의 경우 스토리지 클래스의 기본값은 입니다`STANDARD`. 의 버킷 AWS Outposts의 경우 스토리지 클래스의 기본값은 입니다`OUTPOSTS`. 자세한 내용은 [Storage class considerations with Amazon S3 transfers](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) 섹션을 참조하세요. 타입: 문자열 유효 값: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` 필수 여부: 아니요 ** [Subdirectory](#API_CreateLocationS3_RequestSyntax) ** DataSync가 읽거나 쓰는 S3 버킷의 접두사를 입력합니다(버킷이 소스인지 대상 위치인지에 따라 다름). DataSync는 슬래시(`/`)로 시작하거나 `//`, `/./` 또는 `/../` 패턴을 포함하는 접두사가 있는 객체를 전송할 수 없습니다. 예제: + `/photos` + `photos//2006/January` + `photos/./2006/February` + `photos/../2006/March` 유형: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$` 필수 여부: 아니요 ** [Tags](#API_CreateLocationS3_RequestSyntax) ** AWS 리소스를 분류, 필터링 및 검색하는 데 도움이 되는 레이블을 지정합니다. 전송 위치에 대한 이름 태그를 적어도 하나 작성하는 것이 좋습니다. 유형: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ## 응답 구문 ``` { "LocationArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [LocationArn](#API_CreateLocationS3_ResponseSyntax) ** 사용자가 생성한 S3 위치의 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/CreateLocationS3) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationS3) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationS3) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationS3) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationS3) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationS3)