CreateLocationObjectStorage - AWS DataSync
구문 요청요청 파라미터응답 구문응답 요소오류참고

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

CreateLocationObjectStorage

객체 스토리지 시스템의 전송 위치를 생성합니다.이 위치를 데이터 전송을 위한 소스 또는 대상으로 사용할 AWS DataSync 수 있습니다. DataSync 에이전트를 사용하거나 사용하지 않고 전송할 수 있습니다.

시작하기 전에 DataSync가 객체 스토리지 시스템과 함께 작동하기 위한 사전 조건을 이해해야 합니다.

구문 요청

{
   "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"
      }
   ]
}

요청 파라미터

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 공통 파라미터를 참조하세요.

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

AccessKey

객체 스토리지 서버에 인증하는 데 자격 증명이 필요한 경우, 액세스 키(예: 사용자 이름)를 지정합니다.

유형: 문자열

길이 제한: 최소 길이는 0. 최대 길이는 200입니다.

패턴: ^.*$

필수 여부: 아니요

AgentArns

(선택 사항) 객체 스토리지 시스템과 연결할 수 있는 DataSync 에이전트의 Amazon 리소스 이름(ARNs)을 지정합니다. 에이전트 없는 클라우드 간 전송을 설정하는 경우이 파라미터에 값을 지정할 필요가 없습니다.

참고

스토리지 위치를 처음 생성할 때이 파라미터를 올바르게 구성해야 합니다. 에이전트를 생성한 후에는 스토리지 위치에서 에이전트를 추가하거나 제거할 수 없습니다.

타입: 문자열 배열

배열 구성원: 최소수는 1개입니다. 최대 항목 수는 4개입니다.

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

필수 여부: 아니요

BucketName

전송과 관련된 객체 스토리지 버킷의 이름을 지정합니다.

타입: 문자열

길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 63입니다.

패턴: ^[a-zA-Z0-9_\-\+\.\(\)\$\p{Zs}]+$

필수 여부: 예

CmkSecretConfig

DataSync가 고객 관리형를 사용하여 특정 객체 스토리지 위치에 액세스하는 데 사용하는 SecretKey를 포함하는 DataSync 관리형 보안 암호의 구성 정보를 지정합니다 AWS KMS key.

CreateLocationObjectStorage 요청의 일부로이 파라미터가 포함된 경우 KMS 키 ARN만 제공합니다. DataSync는이 KMS 키를 SecretKey 파라미터에 지정한 값과 함께 사용하여 DataSync 관리형 보안 암호를 생성하여 위치 액세스 자격 증명을 저장합니다.

DataSync에 지정한 KMS 키에 액세스할 수 있는 권한이 있는지 확인합니다.

참고

CmkSecretConfig ( 포함SecretKey) 또는 CustomSecretConfig ( 제외SecretKey)를 사용하여 CreateLocationObjectStorage 요청에 대한 자격 증명을 제공할 수 있습니다. 동일한 요청에 대해 두 파라미터를 모두 제공하지 마십시오.

유형: CmkSecretConfig객체

필수 여부: 아니요

CustomSecretConfig

특정 객체 스토리지 위치의 보안 키가 일반 텍스트로 저장되는 고객 관리형 Secrets Manager 보안 암호의 구성 정보를 지정합니다. 이 구성에는 보안 암호 ARN과 보안 암호에 대한 액세스를 제공하는 IAM 역할의 ARN이 포함됩니다.

참고

CmkSecretConfig ( 포함SecretKey) 또는 CustomSecretConfig ( 제외SecretKey)를 사용하여 CreateLocationObjectStorage 요청에 대한 자격 증명을 제공할 수 있습니다. 동일한 요청에 대해 두 파라미터를 모두 제공하지 마십시오.

유형: CustomSecretConfig객체

필수 여부: 아니요

SecretKey

객체 스토리지 서버에 인증하는 데 자격 증명이 필요한 경우, 보안 암호 키(예: 암호)를 지정합니다.

참고

를 사용하여 보안 암호를 제공SecretKey하지만 CmkSecretConfig 또는를 사용하여 보안 암호 구성 세부 정보를 제공하지 않는 경우 CustomSecretConfig DataSync는 AWS 계정의 Secrets Manager 보안 암호를 사용하여 토큰을 저장합니다.

유형: 문자열

길이 제한: 최소 길이는 0. 최대 길이는 200입니다.

패턴: ^.*$

필수 여부: 아니요

ServerCertificate

시스템이 프라이빗 또는 자체 서명 인증 기관(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

DataSync 에이전트가 연결하는 객체 스토리지 서버의 도메인 이름 또는 IP 버전 4(IPv4) 주소를 지정합니다.

유형: 문자열

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

패턴: ^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$

필수 여부: 예

ServerPort

객체 스토리지 서버가 인바운드 네트워크 트래픽을 수락하는 포트(예: 포트 443)를 지정합니다.

타입: 정수

유효 범위: 최소값 1. 최대값은 65536입니다.

필수 여부: 아니요

ServerProtocol

객체 스토리지 서버의 통신에 사용되는 프로토콜을 지정합니다. 지정하지 않은 경우 기본값은 HTTPS입니다.

타입: 문자열

유효 값: HTTPS | HTTP

필수 여부: 아니요

Subdirectory

객체 스토리지 서버의 객체 접두사를 지정합니다. 소스 위치인 경우, DataSync는 이 접두사가 있는 객체만 복사합니다. 목적지 위치인 경우, DataSync는 이 접두사가 있는 모든 객체를 씁니다.

타입: 문자열

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

패턴: ^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$

필수 여부: 아니요

Tags

리소스에 추가하려는 태그를 나타내는 키-값 쌍를 지정합니다. 태그는 리소스 관리, 필터링 및 검색에 도움이 됩니다. 위치에 이름 태그를 생성하는 것이 좋습니다.

타입: TagListEntry객체 배열

배열 구성원: 최소수는 0개입니다. 최대수 50개.

필수 여부: 아니요

응답 구문

{
   "LocationArn": "string"
}

응답 요소

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

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

LocationArn

생성한 오브젝트 스토리지 시스템 위치의 ARN을 지정합니다.

타입: 문자열

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

오류

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 일반적인 오류섹션을 참조하세요.

InternalException

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

HTTP 상태 코드: 500

InvalidRequestException

이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다.

HTTP 상태 코드: 400

참고

언어별 AWS SDKs