기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # CreateLocationAzureBlob Microsoft Azure Blob 스토리지 컨테이너의 전송 *위치를* 생성합니다.이 위치를 전송 소스 또는 대상으로 사용할 AWS DataSync 수 있습니다. 컨테이너에 연결하는 [DataSync 에이전트](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-creating-agent)를 사용하거나 사용하지 않고 전송할 수 있습니다. 시작하기 전에 [DataSync가 Azure Blob Storage에 액세스하는 방법](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access)과 [액세스 계층](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers) 및 [Blob 유형](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#blob-types)을 처리하는 방법을 알고 있어야 합니다. ## 구문 요청 ``` { "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" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AccessTier](#API_CreateLocationAzureBlob_RequestSyntax) ** 객체 또는 파일이 전송되어야 할 액세스 계층을 지정합니다. 이는 해당 위치를 전송 대상으로 사용하는 경우에만 적용됩니다. 자세한 내용은 [액세스 티어](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers)를 참조하세요. 타입: 문자열 유효 값: `HOT | COOL | ARCHIVE` 필수 여부: 아니요 ** [AgentArns](#API_CreateLocationAzureBlob_RequestSyntax) ** (선택 사항) 사용자 Azure Blob 스토리지 컨테이너와 연결할 수 있는 DataSync 에이전트의 Amazon 리소스 이름(ARN)을 지정합니다. 에이전트 없는 클라우드 간 전송을 설정하는 경우 이 파라미터에 값을 지정할 필요가 없습니다. 하나 이상의 에이전트를 지정할 수 있습니다. 자세한 내용은 [전송에 복수 에이전트 사용](https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html)을 참조하세요. 스토리지 위치를 처음 생성할 때 이 파라미터를 올바르게 구성해야 합니다. 에이전트를 생성한 후에는 스토리지 위치에서 에이전트를 추가하거나 제거할 수 없습니다. 타입: 문자열 배열 배열 구성원: 최소수는 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}$` 필수 여부: 아니요 ** [AuthenticationType](#API_CreateLocationAzureBlob_RequestSyntax) ** DataSync가 Azure Blob Storage에 액세스하는 데 사용하는 인증 방법을 지정합니다. DataSync는 공유 액세스 서명(SAS)을 사용하여 블롭 스토리지에 액세스할 수 있습니다. 타입: 문자열 유효 값: `SAS | NONE` 필수 사항 여부: 예 ** [BlobType](#API_CreateLocationAzureBlob_RequestSyntax) ** 개체 또는 파일을 Azure Blob Storage로 전송할 때 사용할 블롭 유형을 지정합니다. 현재 DataSync는 데이터를 블록으로 Azure Blob Storage로 이동하는 것만 지원합니다. 블롭 유형에 대한 자세한 내용은 [Azure Blob Storage 설명서](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs)를 참조하세요. 타입: 문자열 유효 값: `BLOCK` 필수 여부: 아니요 ** [CmkSecretConfig](#API_CreateLocationAzureBlob_RequestSyntax) ** DataSync 관리형 보안 암호의 구성 정보를 지정합니다. 이는 DataSync가 고객 관리형 AWS KMS key와 함께 특정 AzureBlob 스토리지 위치에 액세스하는 데 사용하는 인증 토큰을 포함합니다. 이 파라미터를 `CreateLocationAzureBlob` 요청의 일부로 포함하는 경우 KMS 키 ARN만 제공합니다. DataSync는 이 KMS 키를 `SasConfiguration`에 지정한 인증 토큰과 함께 사용하여 DataSync 관리형 보안 암호를 생성하고 위치 액세스 자격 증명을 저장합니다. DataSync에 지정한 KMS 키에 액세스할 수 있는 권한이 있는지 확인합니다. 자세한 내용은 [ 사용자 지정으로 암호화된 서비스 관리형 보안 암호 사용을 참조하세요 AWS KMS key](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). `CmkSecretConfig`(`SasConfiguration` 포함) 또는 `CustomSecretConfig`(`SasConfiguration` 제외)을 사용하여 `CreateLocationAzureBlob` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 필수 여부: 아니요 ** [ContainerUrl](#API_CreateLocationAzureBlob_RequestSyntax) ** 전송과 관련된 Azure Blob 저장소 컨테이너의 URL을 지정합니다. 유형: 문자열 길이 제약 조건: 최대 길이는 325입니다. 패턴: `^https:\/\/[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}\/[a-z0-9](-?[a-z0-9]){2,62}$` 필수 여부: 예 ** [CustomSecretConfig](#API_CreateLocationAzureBlob_RequestSyntax) ** AzureBlob 스토리지 위치의 인증 토큰이 Secrets Manager에 일반 텍스트로 저장되는 고객 관리형 Secrets Manager 보안 암호의 구성 정보를 지정합니다. 이 구성에는 보안 암호 ARN과 보안 암호에 대한 액세스를 제공하는 IAM 역할의 ARN이 포함됩니다. 자세한 내용은 [ 관리하는 보안 암호 사용을 참조하세요](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). `CmkSecretConfig`(`SasConfiguration` 포함) 또는 `CustomSecretConfig`(`SasConfiguration` 제외)을 사용하여 `CreateLocationAzureBlob` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 필수 여부: 아니요 ** [SasConfiguration](#API_CreateLocationAzureBlob_RequestSyntax) ** DataSync가 Azure Blob Storage에 액세스할 수 있도록 허용하는 SAS 구성을 지정합니다. `SasConfiguration`을 사용하여 인증 토큰을 제공하지만 `CmkSecretConfig` 또는 `CustomSecretConfig`을 사용하여 보안 암호 구성 세부 정보를 제공하지 않는 경우, DataSync는 AWS 계정의 Secrets Manager 보안 암호를 사용하여 토큰을 저장합니다. 유형: [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md)객체 필수 여부: 아니요 ** [Subdirectory](#API_CreateLocationAzureBlob_RequestSyntax) ** 컨테이너의 가상 디렉터리로의 전송을 제한하려는 경우(예:`/my/images`) 경로 세그먼트를 지정합니다. 유형: 문자열 길이 제약: 최대 길이 1024. 패턴: `^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$` 필수 여부: 아니요 ** [Tags](#API_CreateLocationAzureBlob_RequestSyntax) ** AWS 리소스를 분류, 필터링 및 검색하는 데 도움이 되는 레이블을 지정합니다. 전송 위치에 대한 이름 태그를 적어도 하나 작성하는 것이 좋습니다. 유형: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ## 응답 구문 ``` { "LocationArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [LocationArn](#API_CreateLocationAzureBlob_ResponseSyntax) ** 생성한 Azure Blob 저장소 전송 위치의 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/CreateLocationAzureBlob) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationAzureBlob)