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

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

CreateLocationFsxWindows

Amazon FSx for Windows File Server 파일 시스템의 전송 위치를 생성합니다.이 위치를 데이터 전송의 소스 또는 대상으로 사용할 AWS DataSync 수 있습니다.

시작하려면 먼저 DataSync에서 FSx for Windows File Server 파일 시스템에 액세스하는 방법을 이해해야 합니다.

구문 요청

{
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "Domain": "string",
   "FsxFilesystemArn": "string",
   "Password": "string",
   "SecurityGroupArns": [ "string" ],
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "User": "string"
}

요청 파라미터

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

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

CmkSecretConfig

DataSync가 고객 관리형 보안 암호에 대한 구성 정보를 지정합니다. 여기에는 DataSync가 고객 관리형 보안 암호로 특정 FSx Windows 스토리지 위치에 액세스하는 데 사용하는 암호가 포함됩니다 AWS KMS key.

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

DataSync에 지정한 KMS 키에 액세스할 수 있는 권한이 있는지 확인합니다. 자세한 내용은 사용자 지정으로 암호화된 서비스 관리형 보안 암호 사용을 참조하세요 AWS KMS key.

참고

CmkSecretConfig(Password 포함) 또는 CustomSecretConfig(Password 제외)을 사용하여 CreateLocationFsxWindows 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요.

유형: CmkSecretConfig객체

필수 여부: 아니요

CustomSecretConfig

FSx for Windows File Server 스토리지 위치의 암호가 Secrets Manager에 일반 텍스트로 저장되는 고객 관리형 Secrets Manager 보안 암호의 구성 정보를 지정합니다. 이 구성에는 보안 암호 ARN과 보안 암호에 대한 액세스를 제공하는 IAM 역할의 ARN이 포함됩니다. 자세한 내용은 관리하는 보안 암호 사용을 참조하세요.

참고

CmkSecretConfig(Password 포함) 또는 CustomSecretConfig(Password 제외)을 사용하여 CreateLocationFsxWindows 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요.

유형: CustomSecretConfig객체

필수 여부: 아니요

Domain

FSx for Windows File Server 파일 시스템이 속한 Windows 도메인의 이름을 지정합니다.

환경에 여러 Active Directory 도메인이 있는 경우 이 파라미터를 구성하면 DataSync가 올바른 파일 시스템에 연결되게 할 수 있습니다.

유형: 문자열

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

패턴: ^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$

필수 여부: 아니요

FsxFilesystemArn

FSx for Windows File Server 파일 시스템의 Amazon 리소스 이름(ARN)을 지정합니다.

유형: 문자열

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

패턴: ^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$

필수 여부: 예

Password

FSx for Windows File Server 파일 시스템의 파일, 폴더, 파일 메타베이터를 탑재하고 이에 액세스할 수 있는 권한이 있는 사용자의 암호를 지정합니다.

유형: 문자열

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

패턴: ^.{0,104}$

필수 여부: 아니요

SecurityGroupArns

파일 시스템의 기본 설정 서브넷에 대한 액세스를 제공하는 Amazon EC2 보안 그룹의 ARN을 지정합니다.

지정한 보안 그룹은 파일 시스템의 보안 그룹과 통신할 수 있어야 합니다. 파일 시스템 액세스를 위한 보안 그룹 구성에 대한 자세한 내용은 Amazon FSx for Windows File Server 사용 설명서를 참조하세요.

참고

보안 그룹 자체 내 내부 연결을 허용하지 않는 보안 그룹을 선택한 경우 다음 중 하나를 수행합니다.

  • 보안 그룹 자체 내 통신을 허용하도록 보안 그룹 구성을 구성합니다.

  • 탑재 대상의 보안 그룹과 통신할 수 있는 다른 보안 그룹을 선택합니다.

타입: 문자열 배열

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

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

패턴: ^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$

필수 여부: 예

Subdirectory

슬래시를 사용하여 파일 시스템에 대한 탑재 경로를 지정합니다. DataSync가 데이터를 읽거나 쓰는 위치입니다(소스 위치인지 대상 위치인지에 따라 다름).

유형: 문자열

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

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

필수 여부: 아니요

Tags

AWS 리소스를 분류, 필터링 및 검색하는 데 도움이 되는 레이블을 지정합니다. 위치에 대한 이름 태그를 하나 이상 생성하는 것이 좋습니다.

타입: TagListEntry객체 배열

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

필수 여부: 아니요

User

FSx for Windows File Server 파일 시스템의 파일, 폴더, 파일 메타베이터를 탑재하고 이에 액세스할 수 있는 권한이 있는 사용자를 지정합니다.

전송에 적합한 수준의 액세스 권한을 가진 사용자를 선택하는 방법에 대한 자세한 내용은 FSx for Windows File Server 위치에 필요한 권한을 참조하세요.

유형: 문자열

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

패턴: ^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$

필수 여부: 예

응답 구문

{
   "LocationArn": "string"
}

응답 요소

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

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

LocationArn

생성한 FSx for Windows File Server 파일 시스템의 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}$

오류

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

InternalException

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

HTTP 상태 코드: 500

InvalidRequestException

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

HTTP 상태 코드: 400

참고

언어별 AWS SDKs