기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateLocationAzureBlob
Microsoft Azure Blob 스토리지 컨테이너의 전송 위치를 생성합니다.이 위치를 전송 소스 또는 대상으로 사용할 AWS DataSync 수 있습니다. 컨테이너에 연결하는 DataSync 에이전트를 사용하거나 사용하지 않고 전송할 수 있습니다.
시작하기 전에 DataSync가 Azure Blob Storage에 액세스하는 방법과 액세스 계층 및 Blob 유형을 처리하는 방법을 알고 있어야 합니다.
구문 요청
{
"AccessTier": "string",
"AgentArns": [ "string" ],
"AuthenticationType": "string",
"BlobType": "string",
"CmkSecretConfig": {
"KmsKeyArn": "string",
"SecretArn": "string"
},
"ContainerUrl": "string",
"CustomSecretConfig": {
"SecretAccessRoleArn": "string",
"SecretArn": "string"
},
"SasConfiguration": {
"Token": "string"
},
"Subdirectory": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}요청 파라미터
모든 작업에 공통되는 파라미터에 대한 자세한 설명은 공통 파라미터를 참조하세요.
요청은 JSON 형식으로 다음 데이터를 받습니다.
- AccessTier
-
객체 또는 파일이 전송되어야 할 액세스 계층을 지정합니다. 이는 해당 위치를 전송 대상으로 사용하는 경우에만 적용됩니다. 자세한 내용은 액세스 티어를 참조하세요.
타입: 문자열
유효 값:
HOT | COOL | ARCHIVE필수 여부: 아니요
- AgentArns
-
(선택 사항) Azure Blob 스토리지 컨테이너와 연결할 수 있는 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}$필수 여부: 아니요
- AuthenticationType
-
DataSync가 Azure Blob Storage에 액세스하는 데 사용하는 인증 방법을 지정합니다. DataSync는 공유 액세스 서명(SAS)을 사용하여 블롭 스토리지에 액세스할 수 있습니다.
타입: 문자열
유효 값:
SAS | NONE필수 사항 여부: 예
- BlobType
-
개체 또는 파일을 Azure Blob Storage로 전송할 때 사용할 블롭 유형을 지정합니다. 현재 DataSync는 데이터를 블록으로 Azure Blob Storage로 이동하는 것만 지원합니다. 블롭 유형에 대한 자세한 내용은 Azure Blob Storage 설명서
를 참조하세요. 타입: 문자열
유효 값:
BLOCK필수 여부: 아니요
- CmkSecretConfig
-
DataSync가 고객 관리형를 사용하여 특정 AzureBlob 스토리지 위치에 액세스하는 데 사용하는 인증 토큰을 포함하는 DataSync 관리형 보안 암호의 구성 정보를 지정합니다 AWS KMS key.
CreateLocationAzureBlob요청의 일부로이 파라미터가 포함된 경우 KMS 키 ARN만 제공합니다. DataSync는이 KMS 키를에 대해 지정한 인증 토큰과 함께 사용하여 DataSync 관리형 보안 암호를 생성SasConfiguration하여 위치 액세스 자격 증명을 저장합니다.DataSync에 지정한 KMS 키에 액세스할 수 있는 권한이 있는지 확인합니다.
참고
CmkSecretConfig( 포함SasConfiguration) 또는CustomSecretConfig( 제외SasConfiguration)를 사용하여CreateLocationAzureBlob요청에 대한 자격 증명을 제공할 수 있습니다. 동일한 요청에 대해 두 파라미터를 모두 제공하지 마십시오.유형: CmkSecretConfig객체
필수 여부: 아니요
- ContainerUrl
-
전송과 관련된 Azure Blob 저장소 컨테이너의 URL을 지정합니다.
유형: 문자열
길이 제약 조건: 최대 길이는 325입니다.
패턴:
^https:\/\/[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}\/[a-z0-9](-?[a-z0-9]){2,62}$필수 여부: 예
- CustomSecretConfig
-
AzureBlob 스토리지 위치의 인증 토큰이 일반 텍스트로 저장되는 고객 관리형 Secrets Manager 보안 암호의 구성 정보를 지정합니다. 이 구성에는 보안 암호 ARN과 보안 암호에 대한 액세스를 제공하는 IAM 역할의 ARN이 포함됩니다.
참고
CmkSecretConfig( 포함SasConfiguration) 또는CustomSecretConfig( 제외SasConfiguration)를 사용하여CreateLocationAzureBlob요청에 대한 자격 증명을 제공할 수 있습니다. 동일한 요청에 대해 두 파라미터를 모두 제공하지 마십시오.유형: CustomSecretConfig객체
필수 여부: 아니요
- SasConfiguration
-
DataSync가 Azure Blob Storage에 액세스할 수 있도록 허용하는 SAS 구성을 지정합니다.
참고
를 사용하여 인증 토큰을 제공
SasConfiguration하지만CmkSecretConfig또는를 사용하여 보안 암호 구성 세부 정보를 제공하지 않는 경우CustomSecretConfigDataSync는 AWS 계정의 보안 암호 관리자 보안 암호를 사용하여 토큰을 저장합니다.유형: AzureBlobSasConfiguration객체
필수 여부: 아니요
- Subdirectory
-
컨테이너의 가상 디렉터리로의 전송을 제한하려는 경우(예:
/my/images) 경로 세그먼트를 지정합니다.유형: 문자열
길이 제약: 최대 길이 1024.
패턴:
^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$필수 여부: 아니요
- Tags
-
AWS 리소스를 분류, 필터링 및 검색하는 데 도움이 되는 레이블을 지정합니다. 전송 위치에 대한 이름 태그를 적어도 하나 작성하는 것이 좋습니다.
유형: TagListEntry객체 배열
배열 구성원: 최소수는 0개입니다. 최대수 50개.
필수 여부: 아니요
응답 구문
{
"LocationArn": "string"
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- LocationArn
-
생성한 Azure Blob 저장소 전송 위치의 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
