기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateLocationObjectStorage
전송을 위해 액세스할 AWS DataSync 수 있는 오브젝트 스토리지 시스템의 엔드포인트를 생성합니다. 자세한 내용은 오브젝트 스토리지를 위한 위치 만들기를 참조하십시오.
요청 구문
{
"AccessKey": "string",
"AgentArns": [ "string" ],
"BucketName": "string",
"SecretKey": "string",
"ServerCertificate": blob,
"ServerHostname": "string",
"ServerPort": number,
"ServerProtocol": "string",
"Subdirectory": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}요청 파라미터
모든 작업에 공통적인 파라미터 정보는 범용 파라미터 항목을 참조하십시오.
요청은 JSON 형식의 다음 데이터를 받습니다.
- AccessKey
-
객체 스토리지 서버에 인증하는 데 자격 증명이 필요한 경우 액세스 키(예: 사용자 이름)를 지정합니다.
유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다.
패턴:
^.+$필수 항목 여부: 아니요
- AgentArns
-
사용자의 위치와 안전하게 연결할 수 있는 DataSync 에이전트의 Amazon 리소스 이름 (ARN) 을 지정합니다.
유형: 문자열 배열
배열 멤버: 최소 항목 수는 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
-
전송과 관련된 객체 스토리지 버킷의 이름을 지정합니다.
유형: String
길이 제약: 최소 길이 3. 최대 길이 63.
패턴:
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$필수 항목 여부: 예
- SecretKey
-
객체 스토리지 서버에 인증하는 데 자격 증명이 필요한 경우 보안 암호 키(예: 암호)를 지정합니다.
유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다.
패턴:
^.+$필수 항목 여부: 아니요
- ServerCertificate
-
오브젝트 스토리지 서버의 인증서에 서명하는 데 사용되는 인증서가 포함된 파일을 지정합니다 (예:
file:///home/user/.ssh/storage_sys_certificate.pem). 지정하는 파일에는 다음이 포함되어야 합니다.-
서명 인증 기관 (CA) 의 인증서
-
모든 중간 인증서
-
base64 인코딩
-
A
.pem익스텐션
파일은 최대 32768바이트일 수 있습니다 (base64 인코딩 이전).
이 파라미터를 사용하려면
ServerProtocol를HTTPS구성하십시오.유형: Base64로 인코딩된 이진 데이터 객체
길이 제약: 최대 길이는 32768입니다.
필수 항목 여부: 아니요
-
- ServerHostname
-
객체 스토리지 서버의 도메인 이름 또는 IP 주소를 지정합니다. DataSync에이전트는 이 호스트 이름을 사용하여 객체 스토리지 서버를 네트워크에 탑재합니다.
유형: String
길이 제약: 최대 길이는 255입니다.
패턴:
^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$필수 항목 여부: 예
- ServerPort
-
객체 스토리지 서버가 인바운드 네트워크 트래픽을 수락하는 포트(예: 포트 443)를 지정합니다.
유형: Integer
유효한 범위: 최소값 1. 최대값은 65536입니다.
필수 항목 여부: 아니요
- ServerProtocol
-
객체 스토리지 서버의 통신에 사용되는 프로토콜을 지정합니다.
유형: String
유효한 값:
HTTPS | HTTP필수 항목 여부: 아니요
- Subdirectory
-
객체 스토리지 서버의 객체 접두사를 지정합니다. 소스 위치인 경우 이 접두사가 있는 DataSync 객체만 복사합니다. 대상 위치인 경우 이 접두사가 있는 모든 객체를 DataSync 씁니다.
유형: String
길이 제약: 최대 길이는 4096입니다.
패턴:
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$필수 항목 여부: 아니요
- Tags
-
리소스에 추가하려는 태그를 나타내는 키-값 페어를 지정합니다. 태그는 리소스 관리, 필터링 및 검색에 도움이 됩니다. 위치에 대한 이름 태그를 생성하는 것이 좋습니다.
유형: TagListEntry 객체 배열
배열 멤버: 최소 항목 수는 0개입니다. 최대 항목 수 50개.
필수 항목 여부: 아니요
응답 구문
{
"LocationArn": "string"
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- LocationArn
-
생성한 오브젝트 스토리지 시스템 위치의 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}$
오류
모든 작업에 공통적으로 나타나는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.
- InternalException
-
이 예외는 AWS DataSync 서비스에 오류가 발생할 때 발생합니다.
HTTP 상태 코드: 500
- InvalidRequestException
-
클라이언트가 잘못된 형식의 요청을 제출하면 이 예외가 발생합니다.
HTTP 상태 코드: 400
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
