DescribeLocationS3 - AWS DataSync
요청 구문요청 파라미터응답 구문응답 요소오류예시참고 항목

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

DescribeLocationS3

Amazon S3 버킷 위치에 대한 버킷 이름과 같은 메타데이터를 반환합니다.

요청 구문

{
   "LocationArn": "string"
}

요청 파라미터

모든 작업에 공통적인 파라미터에 대한 자세한 내용은 일반 파라미터 를 참조하세요.

요청은 JSON 형식의 다음 데이터를 받습니다.

LocationArn

설명하려는 Amazon S3 버킷 위치의 Amazon 리소스 이름 (ARN) 입니다.

유형: String

길이 제약: 최대 길이는 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}$

Required: Yes

응답 구문

{
   "AgentArns": [ "string" ],
   "CreationTime": number,
   "LocationArn": "string",
   "LocationUri": "string",
   "S3Config": { 
      "BucketAccessRoleArn": "string"
   },
   "S3StorageClass": "string"
}

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

AgentArns

DataSync아웃포스트에서 사용하는 경우 AWS 아웃포스트에 배포된 EC2 에이전트의 Amazon 리소스 이름 (ARN). AWSOutpost에서 DataSync 에이전트를 시작하는 방법에 대한 자세한 내용은 DataSync에이전트 배포를 참조하십시오. AWS Outposts

유형: 문자열 배열

배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 20개입니다.

길이 제약: 최대 길이는 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}$

CreationTime

Amazon S3 버킷 위치가 생성된 시간입니다.

유형: Timestamp

LocationArn

Amazon S3 버킷 또는 액세스 포인트의 Amazon 리소스 이름 (ARN) 입니다.

유형: String

길이 제약: 최대 길이는 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}$

LocationUri

설명된 Amazon S3 위치의 URL입니다.

유형: String

길이 제약: 최대 길이는 460입니다.

패턴: ^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$

S3Config

Amazon S3 버킷에 액세스하는 데 사용되는 AWS Identity and Access Management(IAM) 역할의 Amazon 리소스 이름(ARN)입니다.

이러한 역할 사용에 대한 자세한 내용은 AWS DataSync사용자 설명서의 Amazon S3 위치 생성을 참조하세요.

유형: S3Config 객체

S3StorageClass

이 위치가 태스크 대상으로 사용될 때 파일을 저장하려는 Amazon S3 스토리지 클래스입니다. S3 스토리지 클래스에 대한 자세한 내용은 Amazon S3 스토리지 클래스를 참조하세요. 일부 스토리지 클래스에는 S3 스토리지 비용에 영향을 미칠 수 있는 동작이 있습니다. 자세한 내용은 에서 S3 스토리지 클래스 작업 시 고려 사항 을 참조하세요DataSync.

유형: String

유효한 값: STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL

오류

모든 작업에 공통적으로 나타나는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.

InternalException

이 예외는 AWS DataSync 서비스에 오류가 발생할 때 발생합니다.

HTTP 상태 코드: 500

InvalidRequestException

클라이언트가 잘못된 형식의 요청을 제출하면 이 예외가 발생합니다.

HTTP 상태 코드: 400

예시

예

다음 예는 샘플 요청에 지정된 S3 위치에 대한 정보를 반환합니다.

예제 요청

{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3"
}

예

이 예제는 DescribeLocation S3의 한 가지 사용법을 보여줍니다.

샘플 응답

{
   "CreationTime": 1532660733.39,
   "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3",
   "LocationUri": "MyBucket.",
   "S3Config": { 
      "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/MyBucketAccessRole",
   }
    "S3StorageClass": "STANDARD"
}

참고 항목

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.