기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # CreateLocationFsxWindows Amazon FSx for Windows File Server 파일 시스템의 전송 *위치를* 생성합니다.이 위치를 데이터 전송의 소스 또는 대상으로 사용할 AWS DataSync 수 있습니다. 시작하려면 먼저 DataSync에서 [FSx for Windows File Server 파일 시스템에 액세스](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-location-access)하는 방법을 이해해야 합니다. ## 구문 요청 ``` { "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" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [CmkSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) ** DataSync가 고객 관리형 보안 암호에 대한 구성 정보를 지정합니다. 여기에는 DataSync가 고객 관리형 보안 암호로 특정 FSx Windows 스토리지 위치에 액세스하는 데 사용하는 암호가 포함됩니다 AWS KMS key. 이 파라미터를 `CreateLocationFsxWindows` 요청의 일부로 포함하는 경우 KMS 키 ARN만 제공합니다. DataSync는 `Password`에 대해 지정한와 함께이 KMS 키를 사용하여 위치 액세스 자격 증명을 저장하는 DataSync 관리형 보안 암호를 생성합니다. DataSync에 지정한 KMS 키에 액세스할 수 있는 권한이 있는지 확인합니다. 자세한 내용은 [ 사용자 지정으로 암호화된 서비스 관리형 보안 암호 사용을 참조하세요 AWS KMS key](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). `CmkSecretConfig`(`Password` 포함) 또는 `CustomSecretConfig`(`Password` 제외)을 사용하여 `CreateLocationFsxWindows` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 필수 여부: 아니요 ** [CustomSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) ** FSx for Windows File Server 스토리지 위치의 암호가 Secrets Manager에 일반 텍스트로 저장되는 고객 관리형 Secrets Manager 보안 암호의 구성 정보를 지정합니다. 이 구성에는 보안 암호 ARN과 보안 암호에 대한 액세스를 제공하는 IAM 역할의 ARN이 포함됩니다. 자세한 내용은 [ 관리하는 보안 암호 사용을 참조하세요](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). `CmkSecretConfig`(`Password` 포함) 또는 `CustomSecretConfig`(`Password` 제외)을 사용하여 `CreateLocationFsxWindows` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 필수 여부: 아니요 ** [Domain](#API_CreateLocationFsxWindows_RequestSyntax) ** FSx for Windows File Server 파일 시스템이 속한 Windows 도메인의 이름을 지정합니다. 환경에 여러 Active Directory 도메인이 있는 경우 이 파라미터를 구성하면 DataSync가 올바른 파일 시스템에 연결되게 할 수 있습니다. 유형: 문자열 길이 제약: 최대 길이는 253입니다. 패턴: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` 필수 여부: 아니요 ** [FsxFilesystemArn](#API_CreateLocationFsxWindows_RequestSyntax) ** 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](#API_CreateLocationFsxWindows_RequestSyntax) ** FSx for Windows File Server 파일 시스템의 파일, 폴더, 파일 메타베이터를 탑재하고 이에 액세스할 수 있는 권한이 있는 사용자의 암호를 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 104입니다. 패턴: `^.{0,104}$` 필수 여부: 아니요 ** [SecurityGroupArns](#API_CreateLocationFsxWindows_RequestSyntax) ** 파일 시스템의 기본 설정 서브넷에 대한 액세스를 제공하는 Amazon EC2 보안 그룹의 ARN을 지정합니다. 지정한 보안 그룹은 파일 시스템의 보안 그룹과 통신할 수 있어야 합니다. 파일 시스템 액세스를 위한 보안 그룹 구성에 대한 자세한 내용은 [https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html)를 참조하세요. 보안 그룹 자체 내 내부 연결을 허용하지 않는 보안 그룹을 선택한 경우 다음 중 하나를 수행합니다. + 보안 그룹 자체 내 통신을 허용하도록 보안 그룹 구성을 구성합니다. + 탑재 대상의 보안 그룹과 통신할 수 있는 다른 보안 그룹을 선택합니다. 타입: 문자열 배열 배열 구성원: 최소수는 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](#API_CreateLocationFsxWindows_RequestSyntax) ** 슬래시를 사용하여 파일 시스템에 대한 탑재 경로를 지정합니다. DataSync가 데이터를 읽거나 쓰는 위치입니다(소스 위치인지 대상 위치인지에 따라 다름). 유형: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$` 필수 여부: 아니요 ** [Tags](#API_CreateLocationFsxWindows_RequestSyntax) ** AWS 리소스를 분류, 필터링 및 검색하는 데 도움이 되는 레이블을 지정합니다. 위치에 대한 이름 태그를 하나 이상 생성하는 것이 좋습니다. 타입: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ** [User](#API_CreateLocationFsxWindows_RequestSyntax) ** FSx for Windows File Server 파일 시스템의 파일, 폴더, 파일 메타베이터를 탑재하고 이에 액세스할 수 있는 권한이 있는 사용자를 지정합니다. 전송에 적합한 수준의 액세스 권한을 가진 사용자를 선택하는 방법에 대한 자세한 내용은 FSx for Windows File Server 위치에 [필요한 권한](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions)을 참조하세요. 유형: 문자열 길이 제약: 최대 길이는 104입니다. 패턴: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 필수 여부: 예 ## 응답 구문 ``` { "LocationArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [LocationArn](#API_CreateLocationFsxWindows_ResponseSyntax) ** 생성한 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}$` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/CreateLocationFsxWindows) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxWindows)