기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # AWS DataSync API AWS Management Console 및 외에도 AWS DataSync API를 사용하여 SDK로 DataSync를 구성하고 관리할 AWS CLI수 있습니다. [AWS SDKs](https://aws.amazon.com/developer/tools/) **Topics** + [ # 작업 ](API_Operations.md) + [ # 데이터 타입 ](API_Types.md) + [ # 일반적인 오류 ](CommonErrors.md) + [ # 공통 파라미터 ](CommonParameters.md) # 작업 다음 작업이 지원됩니다. + [CancelTaskExecution](API_CancelTaskExecution.md) + [CreateAgent](API_CreateAgent.md) + [CreateLocationAzureBlob](API_CreateLocationAzureBlob.md) + [CreateLocationEfs](API_CreateLocationEfs.md) + [CreateLocationFsxLustre](API_CreateLocationFsxLustre.md) + [CreateLocationFsxOntap](API_CreateLocationFsxOntap.md) + [CreateLocationFsxOpenZfs](API_CreateLocationFsxOpenZfs.md) + [CreateLocationFsxWindows](API_CreateLocationFsxWindows.md) + [CreateLocationHdfs](API_CreateLocationHdfs.md) + [CreateLocationNfs](API_CreateLocationNfs.md) + [CreateLocationObjectStorage](API_CreateLocationObjectStorage.md) + [CreateLocationS3](API_CreateLocationS3.md) + [CreateLocationSmb](API_CreateLocationSmb.md) + [CreateTask](API_CreateTask.md) + [DeleteAgent](API_DeleteAgent.md) + [DeleteLocation](API_DeleteLocation.md) + [DeleteTask](API_DeleteTask.md) + [DescribeAgent](API_DescribeAgent.md) + [DescribeLocationAzureBlob](API_DescribeLocationAzureBlob.md) + [DescribeLocationEfs](API_DescribeLocationEfs.md) + [DescribeLocationFsxLustre](API_DescribeLocationFsxLustre.md) + [DescribeLocationFsxOntap](API_DescribeLocationFsxOntap.md) + [DescribeLocationFsxOpenZfs](API_DescribeLocationFsxOpenZfs.md) + [DescribeLocationFsxWindows](API_DescribeLocationFsxWindows.md) + [DescribeLocationHdfs](API_DescribeLocationHdfs.md) + [DescribeLocationNfs](API_DescribeLocationNfs.md) + [DescribeLocationObjectStorage](API_DescribeLocationObjectStorage.md) + [DescribeLocationS3](API_DescribeLocationS3.md) + [DescribeLocationSmb](API_DescribeLocationSmb.md) + [DescribeTask](API_DescribeTask.md) + [DescribeTaskExecution](API_DescribeTaskExecution.md) + [ListAgents](API_ListAgents.md) + [ListLocations](API_ListLocations.md) + [ListTagsForResource](API_ListTagsForResource.md) + [ListTaskExecutions](API_ListTaskExecutions.md) + [ListTasks](API_ListTasks.md) + [StartTaskExecution](API_StartTaskExecution.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateAgent](API_UpdateAgent.md) + [UpdateLocationAzureBlob](API_UpdateLocationAzureBlob.md) + [UpdateLocationEfs](API_UpdateLocationEfs.md) + [UpdateLocationFsxLustre](API_UpdateLocationFsxLustre.md) + [UpdateLocationFsxOntap](API_UpdateLocationFsxOntap.md) + [UpdateLocationFsxOpenZfs](API_UpdateLocationFsxOpenZfs.md) + [UpdateLocationFsxWindows](API_UpdateLocationFsxWindows.md) + [UpdateLocationHdfs](API_UpdateLocationHdfs.md) + [UpdateLocationNfs](API_UpdateLocationNfs.md) + [UpdateLocationObjectStorage](API_UpdateLocationObjectStorage.md) + [UpdateLocationS3](API_UpdateLocationS3.md) + [UpdateLocationSmb](API_UpdateLocationSmb.md) + [UpdateTask](API_UpdateTask.md) + [UpdateTaskExecution](API_UpdateTaskExecution.md) # CancelTaskExecution 진행 중인 AWS DataSync 작업 실행을 중지합니다. 일부 파일의 전송이 갑자기 중단되었습니다. 대상으로 전송된 파일 콘텐츠가 불완전하거나 원본 파일과 일치하지 않을 수 있습니다. 하지만 동일한 작업을 사용하여 새 작업 실행을 시작하고 완료하도록 허용하면 대상의 파일 콘텐츠가 완전하고 일관되게 유지됩니다. 이는 작업 실행을 방해하는 다른 예상치 못한 오류에도 적용됩니다. 이러한 모든 경우에 DataSync는 다음 작업 실행 시작 시 전송을 성공적으로 완료합니다. ## 구문 요청 ``` { "TaskExecutionArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [TaskExecutionArn](#API_CancelTaskExecution_RequestSyntax) ** 중지할 작업 실행의 Amazon 리소스 이름(ARN) 입니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/CancelTaskExecution) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CancelTaskExecution) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CancelTaskExecution) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CancelTaskExecution) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CancelTaskExecution) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CancelTaskExecution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CancelTaskExecution) # CreateAgent 스토리지 환경에 배포하는 AWS DataSync 에이전트를 활성화합니다. 활성화 프로세스는 에이전트를와 연결합니다 AWS 계정. 아직 에이전트를 배포하지 않은 경우 [Do I need a DataSync agent?](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html) 섹션을 참조하세요. ## 구문 요청 ``` { "ActivationKey": "string", "AgentName": "string", "SecurityGroupArns": [ "string" ], "SubnetArns": [ "string" ], "Tags": [ { "Key": "string", "Value": "string" } ], "VpcEndpointId": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ActivationKey](#API_CreateAgent_RequestSyntax) ** 사용자 DataSync 에이전트의 활성화 키를 지정합니다. 활성화 키가 없는 경우 [에이전트 활성화](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html)를 참조하세요. 유형: 문자열 길이 제약 조건: 최대 길이는 29. 패턴: `[A-Z0-9]{5}(-[A-Z0-9]{5}){4}` 필수 여부: 예 ** [AgentName](#API_CreateAgent_RequestSyntax) ** 사용자 에이전트의 이름을 지정합니다. 기억할 수 있는 이름을 지정하는 것이 좋습니다. 유형: 문자열 길이 제약: 최소 길이는 0. 최대 길이는 256입니다. 패턴: `^[a-zA-Z0-9\s+=._:@/-]+$` 필수 여부: 아니요 ** [SecurityGroupArns](#API_CreateAgent_RequestSyntax) ** 에이전트와 VPC 서비스 엔드포인트 간의 트래픽을 허용하는 보안 그룹의 Amazon 리소스 이름(ARN)을 지정합니다. 하나의 ARN만 지정할 수 있습니다. 유형: 문자열 배열 배열 멤버: 고정된 항목 수는 1개입니다. 길이 제약: 최대 길이는 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]+$` 필수 여부: 아니요 ** [SubnetArns](#API_CreateAgent_RequestSyntax) ** VPC 서비스 엔드포인트가 위치한 서브넷의 ARN을 지정합니다. 하나의 ARN만 지정할 수 있습니다. 유형: 문자열 배열 배열 멤버: 고정된 항목 수는 1개입니다. 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:subnet/subnet-[a-f0-9]+$` 필수 여부: 아니요 ** [Tags](#API_CreateAgent_RequestSyntax) ** AWS 리소스를 분류, 필터링 및 검색하는 데 도움이 되는 레이블을 지정합니다. 에이전트에 대한 태그를 적어도 하나 이상 만드는 것이 좋습니다. 타입: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ** [VpcEndpointId](#API_CreateAgent_RequestSyntax) ** 사용 중인 [VPC 서비스 엔드포인트](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#datasync-in-vpc)의 ID를 지정합니다. 예를 들어 VPC 엔드포인트 ID는 `vpce-01234d5aff67890e1`과 같습니다. 사용하는 VPC 서비스 엔드포인트에는 DataSync 서비스 이름(예: `com.amazonaws.us-east-2.datasync`)이 포함되어야 합니다. 유형: String 패턴: `^vpce-[0-9a-f]{17}$` 필수 여부: 아니요 ## 응답 구문 ``` { "AgentArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [AgentArn](#API_CreateAgent_ResponseSyntax) ** 방금 활성화한 에이전트의 ARN. [ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html) 작업을 사용하여 AWS 계정 및의 에이전트 목록을 반환합니다 AWS 리전. 유형: 문자열 길이 제약: 최대 길이는 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}$` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](CommonErrors.md)섹션을 참조하세요. ** InternalException ** 이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다. HTTP 상태 코드: 500 ** InvalidRequestException ** 이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다. HTTP 상태 코드: 400 ## 예 ### 예 요청 다음 예제는 DataSync 에이전트를 활성화합니다. ``` { "ActivationKey": "AAAAA-1AAAA-BB1CC-33333-EEEEE", "AgentName": "MyAgent", "Tags": [{ "Key": "Job", "Value": "TransferJob-1" }] } ``` ### 샘플 응답 응답은 활성화된 에이전트의 ARN을 반환합니다. ``` { "AgentArn": "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44baca3" } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateAgent) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateAgent) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateAgent) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateAgent) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateAgent) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateAgent) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateAgent) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateAgent) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateAgent) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateAgent) # 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) # CreateLocationEfs Amazon EFS 파일 시스템의 전송 *위치*를 생성합니다. AWS DataSync 는 이 위치를 데이터 전송을 위한 소스 또는 대상으로 사용할 수 있습니다. 시작하려면 먼저 DataSync에서 [Amazon EFS 파일 시스템에 액세스](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-access)하는 방법을 이해해야 합니다. ## 구문 요청 ``` { "AccessPointArn": "string", "Ec2Config": { "SecurityGroupArns": [ "string" ], "SubnetArn": "string" }, "EfsFilesystemArn": "string", "FileSystemAccessRoleArn": "string", "InTransitEncryption": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AccessPointArn](#API_CreateLocationEfs_RequestSyntax) ** DataSync가 Amazon EFS 파일 시스템을 탑재하는 데 사용하는 액세스 포인트의 Amazon 리소스 이름(ARN)을 지정합니다. 자세한 내용은 [Accessing restricted file systems](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam) 섹션을 참조하세요. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$` 필수 여부: 아니요 ** [Ec2Config](#API_CreateLocationEfs_RequestSyntax) ** DataSync가 Amazon EFS 파일 시스템의 [탑재 대상](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) 중 하나에 연결하는 데 사용하는 서브넷 및 보안 그룹을 지정합니다. 타입: [Ec2Config](API_Ec2Config.md)객체 필수 항목 여부: 예 ** [EfsFilesystemArn](#API_CreateLocationEfs_RequestSyntax) ** Amazon EFS 파일 시스템에 대한 ARN을 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]{8,40}$` 필수 여부: 예 ** [FileSystemAccessRoleArn](#API_CreateLocationEfs_RequestSyntax) ** DataSync가 Amazon EFS 파일 시스템에 액세스할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할을 지정합니다. 이 역할 생성에 대한 자세한 내용은 [Creating a DataSync IAM role for file system access](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role) 섹션을 참조하세요. 유형: 문자열 길이 제약: 최대 길이 2048. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` 필수 여부: 아니요 ** [InTransitEncryption](#API_CreateLocationEfs_RequestSyntax) ** DataSync가 Amazon EFS 파일 시스템으로 또는 파일 시스템에서 데이터를 전송할 때 Transport Layer Security(TLS) 1.2 암호화를 사용할지 여부를 지정합니다. `AccessPointArn`을 사용하여 액세스 지점을 지정하거나 `FileSystemAccessRoleArn`을 사용하여 IAM 역할을 지정하는 경우 이 파라미터를 `TLS1_2`로 설정해야 합니다. 타입: 문자열 유효 값: `NONE | TLS1_2` 필수 여부: 아니요 ** [Subdirectory](#API_CreateLocationEfs_RequestSyntax) ** Amazon EFS 파일 시스템에 대한 탑재 경로를 지정합니다. DataSync가 파일 시스템의 데이터를 읽거나 쓰는 위치입니다(소스 위치인지 대상 위치인지에 따라 다름). 기본적으로 DataSync는 루트 디렉터리(또는 사용자가 `AccessPointArn`을 사용하여 루트 디렉터리를 제공하는 경우 [액세스 포인트](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html))를 사용합니다. 전방향 슬래시(예: `/path/to/folder`)를 사용하여 하위 디렉터리를 포함할 수도 있습니다. 유형: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` 필수 여부: 아니요 ** [Tags](#API_CreateLocationEfs_RequestSyntax) ** 리소스에 추가하려는 태그를 나타내는 키-값 쌍을 지정합니다. 값은 빈 문자열일 수도 있습니다. 이 값은 리소스 관리, 필터링 및 검색에 도움이 됩니다. 위치에 대한 이름 태그를 생성하는 것이 좋습니다. 타입: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ## 응답 구문 ``` { "LocationArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [LocationArn](#API_CreateLocationEfs_ResponseSyntax) ** 사용자가 생성하는 Amazon EFS 파일 시스템 위치의 Amazon 리소스 이름(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 ## 예 ### 예 요청 다음 예제에서는 Amazon EFS 파일 시스템에 대해 위치를 생성합니다. ``` { "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:11122233344:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:11122233344:security-group/sg-1234567890abcdef2" ] }, "EfsFilesystemArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:file-system/fs-021345abcdef6789", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] } ``` ### 샘플 요청: 제한된 Amazon EFS 파일 시스템에 대해 위치 생성 다음 예제에서는 액세스가 제한된 Amazon EFS 파일 시스템에 대해 위치를 생성합니다. 이런 종류의 시나리오에서는 요청에 `AccessPointArn``FileSystemAccessRoleArn`, 및 `InTransitEncryption`값을 지정해야 할 수 있습니다. ``` { "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0", "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2" ] }, "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew", "InTransitEncryption": "TLS1_2", "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890", "LocationUri": "efs://us-east-2.fs-021345abcdef6789/", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] } ``` ### 샘플 응답 응답은 Amazon EFS 파일 시스템의 위치 ARN을 반환합니다. ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationEfs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationEfs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationEfs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationEfs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationEfs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationEfs) # CreateLocationFsxLustre Amazon FSx for Lustre 파일 시스템의 전송 *위치를* 생성합니다.이 위치를 데이터 전송을 위한 소스 또는 대상으로 사용할 AWS DataSync 수 있습니다. 시작하려면 먼저 DataSync에서 [FSx for Lustre 파일 시스템에 액세스](https://docs.aws.amazon.com/datasync/latest/userguide/create-lustre-location.html#create-lustre-location-access)하는 방법을 이해해야 합니다. ## 구문 요청 ``` { "FsxFilesystemArn": "string", "SecurityGroupArns": [ "string" ], "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [FsxFilesystemArn](#API_CreateLocationFsxLustre_RequestSyntax) ** FSx for Lustre 파일 시스템의 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]+$` 필수 여부: 예 ** [SecurityGroupArns](#API_CreateLocationFsxLustre_RequestSyntax) ** FSx for Lustre 파일 시스템에 대한 액세스 권한을 제공하는 최대 5개 보안 그룹의 Amazon 리소스 이름(ARN)을 지정합니다. 보안 그룹은 파일 시스템의 포트에 액세스할 수 있어야 합니다. 또한 파일 시스템은 보안 그룹의 액세스를 허용해야 합니다. 파일 시스템 액세스에 대한 자세한 내용은 [https://docs.aws.amazon.com/fsx/latest/LustreGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/LustreGuide/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_CreateLocationFsxLustre_RequestSyntax) ** FSx for Lustre 파일 시스템에 대한 탑재 경로를 지정합니다. 경로에는 하위 디렉터리가 포함될 수 있습니다. 위치가 소스로 사용되는 경우 DataSync는 마운트 경로에서 데이터를 읽습니다. 위치가 대상으로 사용되는 경우 DataSync는 데이터를 탑재 경로에 기록합니다. 이 파라미터를 포함하지 않으면 DataSync는 파일 시스템의 루트 디렉터리(`/`)를 사용합니다. 유형: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` 필수 여부: 아니요 ** [Tags](#API_CreateLocationFsxLustre_RequestSyntax) ** AWS 리소스를 분류, 필터링 및 검색하는 데 도움이 되는 레이블을 지정합니다. 위치에 대한 이름 태그를 하나 이상 생성하는 것이 좋습니다. 타입: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ## 응답 구문 ``` { "LocationArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [LocationArn](#API_CreateLocationFsxLustre_ResponseSyntax) ** 생성한 FSx for Lustre 파일 시스템 위치의 Amazon 리소스 이름(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/CreateLocationFsxLustre) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxLustre) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxLustre) # CreateLocationFsxOntap Amazon FSx for NetApp ONTAP 파일 시스템의 전송 *위치를* 생성합니다.이 위치를 데이터 전송을 위한 소스 또는 대상으로 사용할 AWS DataSync 수 있습니다. 시작하려면 먼저 DataSync에서 [FSx for ONTAP 파일 시스템에 액세스하는 방법](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access)을 이해해야 합니다. ## 구문 요청 ``` { "Protocol": { "NFS": { "MountOptions": { "Version": "string" } }, "SMB": { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "MountOptions": { "Version": "string" }, "Password": "string", "User": "string" } }, "SecurityGroupArns": [ "string" ], "StorageVirtualMachineArn": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [Protocol](#API_CreateLocationFsxOntap_RequestSyntax) ** 가 Amazon FSx 파일 시스템에 액세스하는 데 AWS DataSync 사용하는 데이터 전송 프로토콜을 지정합니다. 타입: [FsxProtocol](API_FsxProtocol.md)객체 필수 여부: 예 ** [SecurityGroupArns](#API_CreateLocationFsxOntap_RequestSyntax) ** 파일 시스템의 선호 서브넷에 대한 액세스를 제공하는 Amazon EC2 보안 그룹을 지정합니다. 보안 그룹은 (사용 중인 프로토콜에 따라) 다음 포트에서 아웃바운드 트래픽을 허용해야 합니다: + **NFS(Network File System)**: TCP 포트 111, 635 및 2,049 + **SMB(Server Message Block)**: TCP 포트 445 파일 시스템의 보안 그룹은 동일한 포트에서 인바운드 트래픽도 허용해야 합니다. 타입: 문자열 배열 배열 구성원: 최소수는 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]+$` 필수 여부: 예 ** [StorageVirtualMachineArn](#API_CreateLocationFsxOntap_RequestSyntax) ** 데이터를 복사하려는 파일 시스템에서 스토리지 가상 머신(SVM)의 ARN을 지정합니다. 타입: 문자열 길이 제약: 최대 길이는 162입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:storage-virtual-machine/fs-[0-9a-f]+/svm-[0-9a-f]{17,}$` 필수 여부: 예 ** [Subdirectory](#API_CreateLocationFsxOntap_RequestSyntax) ** 데이터를 주고 받을 SVM에 파일 공유 경로를 지정합니다. 정션 경로(탑재 지점이라고도 함), qtree 경로(NFS 파일 공유의 경우) 또는 공유 이름(SMB 파일 공유의 경우)을 지정할 수 있습니다. 예를 들어, 탑재 경로는 `/vol1`, `/vol1/tree1`또는 `/share1`일 수 있습니다. SVM의 루트 볼륨에 정션 경로를 지정하지 않습니다. 자세한 설명은 *Amazon FSx for NetApp ONTAP User Guide*(Amazon FSx for NetApp ONTAP 사용자 가이드)의 [Managing FSx for ONTAP storage virtual machines](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html)(FSx for ONTAP 스토리지 가상 머신 관리)를 참조하세요. 타입: 문자열 길이 제약: 최대 길이는 255입니다. 패턴: `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$` 필수 여부: 아니요 ** [Tags](#API_CreateLocationFsxOntap_RequestSyntax) ** AWS 리소스를 분류, 필터링 및 검색하는 데 도움이 되는 레이블을 지정합니다. 위치에 대한 이름 태그를 하나 이상 생성하는 것이 좋습니다. 타입: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ## 응답 구문 ``` { "LocationArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [LocationArn](#API_CreateLocationFsxOntap_ResponseSyntax) ** 생성한 FSx for ONTAP 파일 시스템 위치에 대해 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/CreateLocationFsxOntap) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxOntap) # CreateLocationFsxOpenZfs Amazon FSx for OpenZFS 파일 시스템의 전송 *위치를* 생성합니다.이 위치를 데이터 전송을 위한 소스 또는 대상으로 사용할 AWS DataSync 수 있습니다. 시작하려면 먼저 DataSync에서 [FSx for OpenZFS 파일 시스템에 액세스하는 방법](https://docs.aws.amazon.com/datasync/latest/userguide/create-openzfs-location.html#create-openzfs-access)을 이해해야 합니다. **참고** `SMB`와 관련된 요청 파라미터는 `CreateLocationFsxOpenZfs`작업에서 지원되지 않습니다. ## 구문 요청 ``` { "FsxFilesystemArn": "string", "Protocol": { "NFS": { "MountOptions": { "Version": "string" } }, "SMB": { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "MountOptions": { "Version": "string" }, "Password": "string", "User": "string" } }, "SecurityGroupArns": [ "string" ], "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [FsxFilesystemArn](#API_CreateLocationFsxOpenZfs_RequestSyntax) ** FSx for OpenZFS 파일 시스템의 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]+$` 필수 여부: 예 ** [Protocol](#API_CreateLocationFsxOpenZfs_RequestSyntax) ** 가 파일 시스템에 액세스하는 데 AWS DataSync 사용하는 프로토콜 유형입니다. 타입: [FsxProtocol](API_FsxProtocol.md)객체 필수 여부: 예 ** [SecurityGroupArns](#API_CreateLocationFsxOpenZfs_RequestSyntax) ** FSx for OpenZFS 파일 시스템을 구성하는 데 사용되는 보안 그룹의 ARN입니다. 타입: 문자열 배열 배열 구성원: 최소수는 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_CreateLocationFsxOpenZfs_RequestSyntax) ** `/fsx`로 시작해야 하는 위치 경로의 하위 디렉터리입니다. DataSync는 이 하위 디렉터리를 사용하여 데이터를 읽거나 씁니다(파일 시스템이 소스 위치인지 목적지 위치인지에 따라 다름). 타입: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[^\u0000\u0085\u2028\u2029\r\n]{1,4096}$` 필수 여부: 아니요 ** [Tags](#API_CreateLocationFsxOpenZfs_RequestSyntax) ** 리소스에 추가하려는 태그를 나타내는 키-값 쌍입니다. 값은 빈 문자열일 수도 있습니다. 이 값은 리소스 관리, 필터링 및 검색에 도움이 됩니다. 위치에 대한 이름 태그를 생성하는 것이 좋습니다. 타입: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ## 응답 구문 ``` { "LocationArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [LocationArn](#API_CreateLocationFsxOpenZfs_ResponseSyntax) ** 생성한 FSx for OpenZFS 파일 시스템 위치를 위한 FSx의 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/CreateLocationFsxOpenZfs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxOpenZfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) # 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) # CreateLocationHdfs 하둡 분산 파일 시스템(HDFS)의 전송 *위치를* 생성합니다.는이 위치를 데이터 전송을 위한 소스 또는 대상으로 사용할 AWS DataSync 수 있습니다. 시작하기 전에 먼저 DataSync가 [HDFS 클러스터에 액세스](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html#accessing-hdfs)하는 방법을 이해해야 합니다. ## 구문 요청 ``` { "AgentArns": [ "string" ], "AuthenticationType": "string", "BlockSize": number, "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "KerberosKeytab": blob, "KerberosKrb5Conf": blob, "KerberosPrincipal": "string", "KmsKeyProviderUri": "string", "NameNodes": [ { "Hostname": "string", "Port": number } ], "QopConfiguration": { "DataTransferProtection": "string", "RpcProtection": "string" }, "ReplicationFactor": number, "SimpleUser": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AgentArns](#API_CreateLocationHdfs_RequestSyntax) ** HDFS 클러스터에 연결할 수 있는 DataSync 에이전트의 Amazon 리소스 이름(ARN)입니다. 타입: 문자열 배열 배열 구성원: 최소수는 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_CreateLocationHdfs_RequestSyntax) ** 사용자 ID를 결정하는 데 사용되는 인증 타입. 타입: 문자열 유효 값: `SIMPLE | KERBEROS` 필수 사항 여부: 예 ** [BlockSize](#API_CreateLocationHdfs_RequestSyntax) ** HDFS 클러스터에 쓸 데이터 블록의 크기입니다. 블록 크기는 512바이트의 배수여야 합니다. 기본 블록 크기는 128메비바이트(MiB)입니다. 유형: 정수 유효한 범위: 최소값은 1048576입니다. 최대값은 1073741824입니다. 필수 여부: 아니요 ** [CmkSecretConfig](#API_CreateLocationHdfs_RequestSyntax) ** DataSync가 고객 관리형으로 특정 Hadoop 분산 파일 시스템(HDFS) 스토리지 위치에 액세스하는 데 사용하는 Kerberos 키탭을 포함하는 DataSync 관리형 보안 암호의 구성 정보를 지정합니다 AWS KMS key. 이 파라미터를 `CreateLocationHdfs` 요청의 일부로 포함하는 경우 KMS 키 ARN만 제공합니다. DataSync는 `KerberosKeytab`에 대해 지정한와 함께이 KMS 키를 사용하여 위치 액세스 자격 증명을 저장하는 DataSync 관리형 보안 암호를 생성합니다. DataSync에 지정한 KMS 키에 액세스할 수 있는 권한이 있는지 확인합니다. 자세한 내용은 [ 사용자 지정으로 암호화된 서비스 관리형 보안 암호 사용을 참조하세요 AWS KMS key](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). `CmkSecretConfig`(`KerberosKeytab` 포함) 또는 `CustomSecretConfig`(`KerberosKeytab` 제외)을 사용하여 `CreateLocationHdfs` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 필수 여부: 아니요 ** [CustomSecretConfig](#API_CreateLocationHdfs_RequestSyntax) ** HDFS 스토리지 위치의 Kerberos 키 탭이 Secrets Manager의 이진수에 저장되는 고객 관리형 Secrets Manager 보안 암호에 대한 구성 정보를 지정합니다. 이 구성에는 보안 암호 ARN과 보안 암호에 대한 액세스를 제공하는 IAM 역할의 ARN이 포함됩니다. 자세한 내용은 [ 관리하는 보안 암호 사용을 참조하세요](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). `CmkSecretConfig`(`KerberosKeytab` 포함) 또는 `CustomSecretConfig`(`KerberosKeytab` 제외)을 사용하여 `CreateLocationHdfs` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 필수 여부: 아니요 ** [KerberosKeytab](#API_CreateLocationHdfs_RequestSyntax) ** 정의된 Kerberos 보안 주체와 암호화된 키 간의 매핑이 포함된 Kerberos 키 테이블(keytab)입니다. 파일 주소를 제공하여 파일에서 키탭을 로드할 수 있습니다. `AuthenticationType`에 `KERBEROS`가 지정된 경우 이 파라미터가 필요합니다. 타입: Base64로 인코딩된 이진 데이터 객체 길이 제약: 최대 길이는 65536입니다. 필수 여부: 아니요 ** [KerberosKrb5Conf](#API_CreateLocationHdfs_RequestSyntax) ** Kerberos 구성 정보가 포함된 `krb5.conf` 파일입니다. 파일 주소를 제공하여 `krb5.conf`파일을 로드할 수 있습니다. AWS CLI를 사용하는 경우, base64 인코딩을 자동으로 수행합니다. 그렇지 않으면 base64 인코딩 형식의 텍스트를 제공하십시오. `AuthenticationType`에 `KERBEROS`가 지정된 경우 이 파라미터가 필요합니다. 타입: Base64로 인코딩된 이진 데이터 객체 길이 제약: 최대 길이는 131072입니다. 필수 여부: 아니요 ** [KerberosPrincipal](#API_CreateLocationHdfs_RequestSyntax) ** HDFS 클러스터의 파일 및 폴더에 대한 액세스 권한이 있는 Kerberos 보안 주체입니다. `AuthenticationType`에 `KERBEROS`가 지정된 경우 이 파라미터가 필요합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `^.+$` 필수 여부: 아니요 ** [KmsKeyProviderUri](#API_CreateLocationHdfs_RequestSyntax) ** HDFS 클러스터의 키 관리 서버(KMS)의 URI입니다. 타입: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 255. 패턴: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$` 필수 여부: 아니요 ** [NameNodes](#API_CreateLocationHdfs_RequestSyntax) ** HDFS 네임스페이스를 관리하는 NameNode입니다. NameNode는 파일 및 디렉터리 열기, 닫기 및 이름 바꾸기와 같은 작업을 수행합니다. NameNode에는 데이터 블록을 DataNode에 매핑하기 위한 정보가 들어 있습니다. 하나의 NameNode만 사용할 수 있습니다. 타입: [HdfsNameNode](API_HdfsNameNode.md)객체 배열 어레이 멤버: 최소 항목 수 1개. 필수 항목 여부: 예 ** [QopConfiguration](#API_CreateLocationHdfs_RequestSyntax) ** QOP(Quality of Protection) 구성은 Hadoop 분산 파일 시스템(HDFS) 클러스터에 구성된 원격 프로시저 호출(RPC) 및 데이터 전송 방지 설정을 지정합니다. `QopConfiguration`이 지정되지 않은 경우 `RpcProtection` 및 `DataTransferProtection`은 기본적으로 `PRIVACY`로 설정됩니다. `RpcProtection` 또는 `DataTransferProtection`을 설정하면 다른 파라미터는 동일한 값을 가정합니다. 유형: [QopConfiguration](API_QopConfiguration.md)객체 필수 여부: 아니요 ** [ReplicationFactor](#API_CreateLocationHdfs_RequestSyntax) ** HDFS 클러스터에 쓸 때 데이터를 복제할 DataNode의 수입니다. 기본적으로 데이터는 3개의 DataNode에 복제됩니다. 타입: 정수 유효 범위: 최소값 1. 최대값은 512입니다. 필수 여부: 아니요 ** [SimpleUser](#API_CreateLocationHdfs_RequestSyntax) ** 호스트 운영 체제에서 클라이언트를 식별하는 데 사용되는 사용자 이름입니다. `AuthenticationType`에 `SIMPLE`가 지정된 경우 이 파라미터가 필요합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$` 필수 여부: 아니요 ** [Subdirectory](#API_CreateLocationHdfs_RequestSyntax) ** HDFS 클러스터의 하위 디렉터리입니다. 이 하위 디렉터리는 HDFS 클러스터에서 데이터를 읽거나 쓰는 데 사용됩니다. 하위 디렉터리를 지정하지 않으면 기본적으로 `/`로 설정됩니다. 유형: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` 필수 여부: 아니요 ** [Tags](#API_CreateLocationHdfs_RequestSyntax) ** 위치에 추가하려는 태그를 나타내는 키-값 쌍입니다. 값은 빈 문자열일 수도 있습니다. 태그를 사용하여 리소스의 이름을 지정하는 것이 좋습니다. 타입: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ## 응답 구문 ``` { "LocationArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [LocationArn](#API_CreateLocationHdfs_ResponseSyntax) ** 생성하는 소스 HDFS 클러스터 위치의 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/CreateLocationHdfs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationHdfs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationHdfs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationHdfs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationHdfs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationHdfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationHdfs) # CreateLocationNfs NFS(Network File System) 파일 서버의 전송 *위치를* 생성합니다.이 위치를 데이터 전송을 위한 소스 또는 대상으로 사용할 AWS DataSync 수 있습니다. 시작하기 전에 먼저 DataSync가 [NFS 파일 서버에 액세스](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs)하는 방법을 이해해야 합니다. ## 구문 요청 ``` { "MountOptions": { "Version": "string" }, "OnPremConfig": { "AgentArns": [ "string" ] }, "ServerHostname": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [MountOptions](#API_CreateLocationNfs_RequestSyntax) ** DataSync가 NFS 파일 서버를 탑재하는 데 사용할 수 있는 옵션을 지정합니다. 유형: [NfsMountOptions](API_NfsMountOptions.md)객체 필수 여부: 아니요 ** [OnPremConfig](#API_CreateLocationNfs_RequestSyntax) ** NFS 파일 서버에 연결할 수 있는 DataSync 에이전트의 Amazon 리소스 이름(ARN)을 지정합니다. 하나 이상의 에이전트를 지정할 수 있습니다. 자세한 내용은 [Using multiple DataSync agents](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents) 섹션을 참조하세요. 타입: [OnPremConfig](API_OnPremConfig.md)객체 필수 항목 여부: 예 ** [ServerHostname](#API_CreateLocationNfs_RequestSyntax) ** DataSync 에이전트가 연결될 NFS 파일 서버의 DNS 이름 또는 IP 주소(IPv4 또는 IPv6)를 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 255입니다. 패턴: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` 필수 여부: 예 ** [Subdirectory](#API_CreateLocationNfs_RequestSyntax) ** DataSync에서 탑재할 NFS 파일 서버의 내보내기 경로를 지정합니다. 이 경로(또는 경로의 하위 디렉터리)는 DataSync가 데이터를 전송하고 전송 받는 곳입니다. DataSync용 내보내기 구성에 대한 자세한 내용은 [NFS 파일 서버 액세스](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs)를 참조하세요. 유형: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\p{Zs}]+$` 필수 여부: 예 ** [Tags](#API_CreateLocationNfs_RequestSyntax) ** AWS 리소스를 분류, 필터링 및 검색하는 데 도움이 되는 레이블을 지정합니다. 위치에 이름 태그를 하나 이상 생성하는 것이 좋습니다. 타입: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ## 응답 구문 ``` { "LocationArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [LocationArn](#API_CreateLocationNfs_ResponseSyntax) ** NFS 파일 서버용으로 생성한 전송 위치의 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 ## 예 ### 예제 다음 예제에서는 NFS 파일 서버에 대한 DataSync 전송 위치를 생성합니다. #### 샘플 요청 ``` { "MountOptions": { "Version": : "NFS4_0" }, "OnPremConfig": { "AgentArn": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ] }, "ServerHostname": "MyServer@amazon.com", "Subdirectory": "/MyFolder", "Tags": [ { "Key": "Name", "Value": "FileSystem-1" } ] } ``` ### 예제 응답은 NFS 위치의 ARN을 반환합니다. #### 샘플 응답 ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa" } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationNfs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationNfs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationNfs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationNfs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationNfs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationNfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationNfs) # CreateLocationObjectStorage 객체 스토리지 시스템의 전송 *위치를* 생성합니다.이 위치를 데이터 전송을 위한 소스 또는 대상으로 사용할 AWS DataSync 수 있습니다. [DataSync 에이전트](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#when-agent-required)를 사용하거나 사용하지 않고 전송할 수 있습니다. 시작하기 전에 DataSync가 객체 스토리지 시스템과 함께 작동하기 위한 [사전 조건](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html#create-object-location-prerequisites)을 이해해야 합니다. ## 구문 요청 ``` { "AccessKey": "string", "AgentArns": [ "string" ], "BucketName": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "SecretKey": "string", "ServerCertificate": blob, "ServerHostname": "string", "ServerPort": number, "ServerProtocol": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AccessKey](#API_CreateLocationObjectStorage_RequestSyntax) ** 객체 스토리지 서버에 인증하는 데 자격 증명이 필요한 경우, 액세스 키(예: 사용자 이름)를 지정합니다. 유형: 문자열 길이 제한: 최소 길이는 0. 최대 길이는 200입니다. 패턴: `^.*$` 필수 여부: 아니요 ** [AgentArns](#API_CreateLocationObjectStorage_RequestSyntax) ** (선택 사항) 객체 스토리지 시스템과 연결할 수 있는 DataSync 에이전트의 Amazon 리소스 이름(ARN)을 지정합니다. 에이전트 없는 클라우드 간 전송을 설정하는 경우 이 파라미터에 값을 지정할 필요가 없습니다. 스토리지 위치를 처음 생성할 때 이 파라미터를 올바르게 구성해야 합니다. 에이전트를 생성한 후에는 스토리지 위치에서 에이전트를 추가하거나 제거할 수 없습니다. 타입: 문자열 배열 배열 구성원: 최소수는 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}$` 필수 여부: 아니요 ** [BucketName](#API_CreateLocationObjectStorage_RequestSyntax) ** 전송과 관련된 객체 스토리지 버킷의 이름을 지정합니다. 타입: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 63입니다. 패턴: `^[a-zA-Z0-9_\-\+\.\$\p{Zs}]+$` 필수 여부: 예 ** [CmkSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) ** DataSync 관리형 보안 암호의 구성 정보를 지정합니다. 이는 DataSync가 고객 관리형 AWS KMS key와 함께 특정 객체 스토리지 위치에 액세스하는 데 사용하는 `SecretKey`를 포함합니다. 이 파라미터를 `CreateLocationObjectStorage` 요청의 일부로 포함하는 경우 KMS 키 ARN만 제공합니다. DataSync는이 KMS 키를 `SecretKey` 파라미터에 지정한 값과 함께 사용하여 DataSync 관리형 보안 암호를 생성하고 위치 액세스 자격 증명을 저장합니다. DataSync에 지정한 KMS 키에 액세스할 수 있는 권한이 있는지 확인합니다. 자세한 내용은 [ 사용자 지정으로 암호화된 서비스 관리형 보안 암호 사용을 참조하세요 AWS KMS key](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). `CmkSecretConfig`(`SecretKey` 포함) 또는 `CustomSecretConfig`(`SecretKey` 제외)을 사용하여 `CreateLocationObjectStorage` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 필수 여부: 아니요 ** [CustomSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) ** 특정 객체 스토리지 위치의 보안 키가 Secrets Manager에 일반 텍스트로 저장되는 고객 관리형 Secrets Manager 보안 암호의 구성 정보를 지정합니다. 이 구성에는 보안 암호 ARN과 보안 암호에 대한 액세스를 제공하는 IAM 역할의 ARN이 포함됩니다. 자세한 내용은 [ 관리하는 보안 암호 사용을 참조하세요](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). `CmkSecretConfig`(`SecretKey` 포함) 또는 `CustomSecretConfig`(`SecretKey` 제외)을 사용하여 `CreateLocationObjectStorage` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 필수 여부: 아니요 ** [SecretKey](#API_CreateLocationObjectStorage_RequestSyntax) ** 객체 스토리지 서버에 인증하는 데 자격 증명이 필요한 경우, 보안 암호 키(예: 암호)를 지정합니다. 를 사용하여 보안 암호를 제공`SecretKey`하지만 `CmkSecretConfig` 또는를 사용하여 보안 암호 구성 세부 정보를 제공하지 않는 경우 `CustomSecretConfig` DataSync는 AWS 계정의 Secrets Manager 보안 암호를 사용하여 토큰을 저장합니다. 유형: 문자열 길이 제한: 최소 길이는 0. 최대 길이는 200입니다. 패턴: `^.*$` 필수 여부: 아니요 ** [ServerCertificate](#API_CreateLocationObjectStorage_RequestSyntax) ** 시스템이 프라이빗 또는 자체 서명 인증 기관(CA)을 사용하는 경우 DataSync가 객체 스토리지 시스템으로 인증하기 위한 인증서 체인을 지정합니다. 전체 인증서 체인(예: `file:///home/user/.ssh/object_storage_certificates.pem`)이 있는 단일 `.pem` 파일을 지정해야 합니다. 인증서 체인에는 다음이 포함될 수 있습니다. + 객체 스토리지 시스템의 인증서 + 모든 중간 인증서(있는 경우) + 서명 CA의 루트 인증서 인증서를 `.pem` 파일로 연결할 수 있습니다(base64 인코딩 전 최대 32,768바이트). 다음 예제의 `cat` 명령은 세 개의 인증서가 포함된 `object_storage_certificates.pem` 파일을 생성합니다. `cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem` 이 파라미터를 사용하려면 `ServerProtocol`를 `HTTPS`로 구성하세요. 타입: Base64로 인코딩된 이진 데이터 객체 길이 제약: 최대 길이는 32768입니다. 필수 여부: 아니요 ** [ServerHostname](#API_CreateLocationObjectStorage_RequestSyntax) ** DataSync 에이전트가 연결될 객체 스토리지 서버의 도메인 이름 또는 IP 주소(IPv4 또는 IPv6)를 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 255입니다. 패턴: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` 필수 여부: 예 ** [ServerPort](#API_CreateLocationObjectStorage_RequestSyntax) ** 객체 스토리지 서버가 인바운드 네트워크 트래픽을 수락하는 포트(예: 포트 443)를 지정합니다. 타입: 정수 유효 범위: 최소값 1. 최대값은 65536입니다. 필수 여부: 아니요 ** [ServerProtocol](#API_CreateLocationObjectStorage_RequestSyntax) ** 객체 스토리지 서버의 통신에 사용되는 프로토콜을 지정합니다. 지정하지 않은 경우 기본값은 `HTTPS`입니다. 타입: 문자열 유효 값: `HTTPS | HTTP` 필수 여부: 아니요 ** [Subdirectory](#API_CreateLocationObjectStorage_RequestSyntax) ** 객체 스토리지 서버의 객체 접두사를 지정합니다. 소스 위치인 경우, DataSync는 이 접두사가 있는 객체만 복사합니다. 목적지 위치인 경우, DataSync는 이 접두사가 있는 모든 객체를 씁니다. 타입: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` 필수 여부: 아니요 ** [Tags](#API_CreateLocationObjectStorage_RequestSyntax) ** 리소스에 추가하려는 태그를 나타내는 키-값 쌍을 지정합니다. 태그는 리소스 관리, 필터링 및 검색에 도움이 됩니다. 위치에 이름 태그를 생성하는 것이 좋습니다. 타입: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ## 응답 구문 ``` { "LocationArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [LocationArn](#API_CreateLocationObjectStorage_ResponseSyntax) ** 생성한 오브젝트 스토리지 시스템 위치의 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/CreateLocationObjectStorage) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationObjectStorage) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationObjectStorage) # CreateLocationS3 Amazon S3 버킷의 전송 *위치*를 생성합니다. AWS DataSync 는 이 위치를 데이터 전송을 위한 소스 또는 대상으로 사용할 수 있습니다. **중요** 시작하기 전에 다음 주제를 읽어보시기 바랍니다. [Amazon S3 위치의 스토리지 클래스 고려 사항](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) [DataSync 사용 시 S3 요청 비용 평가](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) 자세한 내용은 [Configuring transfers with Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html) 섹션을 참조하세요. ## 구문 요청 ``` { "AgentArns": [ "string" ], "S3BucketArn": "string", "S3Config": { "BucketAccessRoleArn": "string" }, "S3StorageClass": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AgentArns](#API_CreateLocationS3_RequestSyntax) ** (Amazon S3 on Outposts만 해당) Outpost에 있는 DataSync 에이전트의 Amazon 리소스 이름(ARN)을 지정합니다. 자세한 내용은 [ DataSync 에이전트 배포를 참조하세요 AWS Outposts](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent). 타입: 문자열 배열 배열 구성원: 최소수는 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}$` 필수 여부: 아니요 ** [S3BucketArn](#API_CreateLocationS3_RequestSyntax) ** 위치로 사용할 S3 버킷의 ARN을 지정합니다. (나중에 DataSync 작업을 생성할 때 이 위치가 전송 소스인지 대상인지를 지정합니다.) S3 버킷이 AWS Outposts 리소스에 있는 경우 Amazon S3 액세스 포인트를 지정해야 합니다. 자세한 내용은 *Amazon S3 사용 설명서*에서 [Amazon S3 액세스 포인트를 사용한 데이터 액세스 관리](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html)를 참조하세요. 유형: 문자열 길이 제약: 최대 길이는 268입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$` 필수 여부: 예 ** [S3Config](#API_CreateLocationS3_RequestSyntax) ** DataSync가 S3 버킷에 액세스하는 데 사용하는 (IAM) 역할의 Amazon 리소스 이름 AWS Identity and Access Management (ARN)을 지정합니다. 자세한 내용은 [DataSync에 S3 버킷 액세스 권한 제공](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access)을 참조하세요. 타입: [S3Config](API_S3Config.md)객체 필수 항목 여부: 예 ** [S3StorageClass](#API_CreateLocationS3_RequestSyntax) ** Amazon S3가 전송 대상일 때 객체가 사용할 스토리지 클래스를 지정합니다. 의 버킷 AWS 리전의 경우 스토리지 클래스의 기본값은 입니다`STANDARD`. 의 버킷 AWS Outposts의 경우 스토리지 클래스의 기본값은 입니다`OUTPOSTS`. 자세한 내용은 [Storage class considerations with Amazon S3 transfers](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) 섹션을 참조하세요. 타입: 문자열 유효 값: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` 필수 여부: 아니요 ** [Subdirectory](#API_CreateLocationS3_RequestSyntax) ** DataSync가 읽거나 쓰는 S3 버킷의 접두사를 입력합니다(버킷이 소스인지 대상 위치인지에 따라 다름). DataSync는 슬래시(`/`)로 시작하거나 `//`, `/./` 또는 `/../` 패턴을 포함하는 접두사가 있는 객체를 전송할 수 없습니다. 예제: + `/photos` + `photos//2006/January` + `photos/./2006/February` + `photos/../2006/March` 유형: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` 필수 여부: 아니요 ** [Tags](#API_CreateLocationS3_RequestSyntax) ** AWS 리소스를 분류, 필터링 및 검색하는 데 도움이 되는 레이블을 지정합니다. 전송 위치에 대한 이름 태그를 적어도 하나 작성하는 것이 좋습니다. 유형: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ## 응답 구문 ``` { "LocationArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [LocationArn](#API_CreateLocationS3_ResponseSyntax) ** 사용자가 생성한 S3 위치의 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/CreateLocationS3) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationS3) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationS3) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationS3) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationS3) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationS3) # CreateLocationSmb SMB(Server Message Block) 파일 서버의 전송 *위치를* 생성합니다.이 위치를 데이터 전송을 위한 소스 또는 대상으로 사용할 AWS DataSync 수 있습니다. 시작하기 전에 먼저 DataSync가 SMB 파일 서버에 액세스하는 방법을 이해해야 합니다. 자세한 내용은 [DataSync에 SMB 파일 서버 액세스 권한 제공](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)을 참조하세요. ## 구문 요청 ``` { "AgentArns": [ "string" ], "AuthenticationType": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "DnsIpAddresses": [ "string" ], "Domain": "string", "KerberosKeytab": blob, "KerberosKrb5Conf": blob, "KerberosPrincipal": "string", "MountOptions": { "Version": "string" }, "Password": "string", "ServerHostname": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "User": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AgentArns](#API_CreateLocationSmb_RequestSyntax) ** SMB 파일 서버에 연결할 수 있는 DataSync 에이전트(또는 에이전트들)를 지정합니다. 에이전트의 Amazon 리소스 이름(ARN)을 사용하여 에이전트를 지정합니다. 타입: 문자열 배열 배열 구성원: 최소수는 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_CreateLocationSmb_RequestSyntax) ** DataSync가 SMB 파일 서버에 연결하는 데 사용하는 인증 프로토콜을 지정합니다. DataSync는 `NTLM`(기본값) 및 `KERBEROS` 인증을 지원합니다. 자세한 내용은 [DataSync에 SMB 파일 서버 액세스 권한 제공](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)을 참조하세요. 타입: 문자열 유효 값: `NTLM | KERBEROS` 필수 여부: 아니요 ** [CmkSecretConfig](#API_CreateLocationSmb_RequestSyntax) ** DataSync가 고객 관리형를 사용하여 특정 SMB 스토리지 위치에 액세스하는 데 사용하는 `Password` 또는 `KerberosKeytab` (각각 `NTLM` (기본값) 및 `KERBEROS` 인증 유형) 중 하나인 DataSync 관리형 보안 암호에 대한 구성 정보를 지정합니다 AWS KMS key. 이 파라미터를 `CreateLocationSmbRequest` 요청의 일부로 포함하는 경우 KMS 키 ARN만 제공합니다. DataSync는이 KMS 키를 `Password` 또는 `KerberosKeytab` 사용자가 지정한와 함께 사용하여 DataSync 관리형 보안 암호를 생성하여 위치 액세스 자격 증명을 저장합니다. DataSync에 지정한 KMS 키에 액세스할 수 있는 권한이 있는지 확인합니다. 자세한 내용은 [ 사용자 지정으로 암호화된 서비스 관리형 보안 암호 사용을 참조하세요 AWS KMS key](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). `CmkSecretConfig` ( `Password` 또는와 함께`KerberosKeytab`) 또는 `CustomSecretConfig` ( `Password` 및 없이`KerberosKeytab`)를 사용하여 `CreateLocationSmbRequest` 요청에 대한 자격 증명을 제공할 수 있습니다. 동일한 요청에 대해 `CmkSecretConfig` 및 `CustomSecretConfig` 파라미터를 모두 제공하지 마십시오. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 필수 여부: 아니요 ** [CustomSecretConfig](#API_CreateLocationSmb_RequestSyntax) ** SMB 스토리지 위치 보안 인증 정보가 Secrets Manager에 일반 텍스트(용) 또는 바이너리(용`Password`)로 저장되는 고객 관리형 Secrets Manager 보안 암호의 구성 정보를 지정합니다`KerberosKeytab`. 이 구성에는 보안 암호 ARN과 보안 암호에 대한 액세스를 제공하는 IAM 역할의 ARN이 포함됩니다. 자세한 내용은 [ 관리하는 보안 암호 사용을 참조하세요](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). `CmkSecretConfig`(`SasConfiguration` 포함) 또는 `CustomSecretConfig`(`SasConfiguration` 제외)을 사용하여 `CreateLocationSmbRequest` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 필수 여부: 아니요 ** [DnsIpAddresses](#API_CreateLocationSmb_RequestSyntax) ** SMB 파일 서버가 속한 DNS 서버의 IPv4 또는 IPv6 주소를 지정합니다. 이 파라미터는 `AuthenticationType`이 `KERBEROS`로 설정된 경우에만 적용됩니다. 환경에 여러 도메인이 있는 경우 이 파라미터를 구성하면 DataSync가 올바른 SMB 파일 서버에 연결되도록 할 수 있습니다. 유형: 문자열 배열 배열 멤버: 최대 항목 수는 2개입니다. 길이 제약: 최소 길이는 7입니다. 최대 길이는 39입니다. 패턴: `\A((25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z` 필수 여부: 아니요 ** [Domain](#API_CreateLocationSmb_RequestSyntax) ** SMB 파일 서버가 속한 Windows 도메인 이름을 지정합니다. 이 파라미터는 `AuthenticationType`이 `NTLM`로 설정된 경우에만 적용됩니다. 환경에 여러 도메인이 있는 경우 이 파라미터를 구성하면 DataSync가 올바른 파일 서버에 연결되도록 할 수 있습니다. 유형: 문자열 길이 제약: 최대 길이는 253입니다. 패턴: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` 필수 여부: 아니요 ** [KerberosKeytab](#API_CreateLocationSmb_RequestSyntax) ** Kerberos 보안 주체와 암호화 키 간의 매핑을 포함하는 Kerberos 키 테이블(keytab) 파일을 지정합니다. 작업 실행 오류를 방지하려면 키탭 파일을 생성하는 데 사용하는 Kerberos 보안 주체가 `KerberosPrincipal`에 지정한 것과 정확히 일치하는지 확인합니다. 타입: Base64로 인코딩된 이진 데이터 객체 길이 제약: 최대 길이는 65536입니다. 필수 여부: 아니요 ** [KerberosKrb5Conf](#API_CreateLocationSmb_RequestSyntax) ** Kerberos 영역 구성을 정의하는 Kerberos 구성 파일(`krb5.conf`)을 지정합니다. 파일은 반드시 base64로 인코딩되어야 합니다. 를 사용하는 경우 AWS CLI인코딩이 수행됩니다. 타입: Base64로 인코딩된 이진 데이터 객체 길이 제약: 최대 길이는 131072입니다. 필수 여부: 아니요 ** [KerberosPrincipal](#API_CreateLocationSmb_RequestSyntax) ** Kerberos 영역에서 SMB 파일 서버의 파일, 폴더, 파일 메타데이터에 액세스할 수 있는 권한을 가진 Kerberos 보안 주체를 지정합니다. Kerberos 보안 주체는 `HOST/kerberosuser@MYDOMAIN.ORG`처럼 보일 수 있습니다. 보안 주체 이름은 대/소문자를 구분합니다. 이 파라미터에 대해 지정한 보안 주체가 키탭 파일 생성에 사용하는 보안 주체와 정확히 일치하지 않으면 DataSync 작업 실행이 실패합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `^.+$` 필수 여부: 아니요 ** [MountOptions](#API_CreateLocationSmb_RequestSyntax) ** DataSync가 SMB 파일 서버에 액세스하는 데 사용하는 SMB 프로토콜의 버전을 지정합니다. 타입: [SmbMountOptions](API_SmbMountOptions.md)객체 필수 여부: 아니요 ** [Password](#API_CreateLocationSmb_RequestSyntax) ** 사용자 SMB 파일 서버를 탑재하고 전송과 관련된 파일과 폴더에 액세스할 수 있는 권한이 있는 사용자의 암호를 지정합니다. 이 파라미터는 `AuthenticationType`이 `NTLM`로 설정된 경우에만 적용됩니다. 유형: 문자열 길이 제약: 최대 길이는 104입니다. 패턴: `^.{0,104}$` 필수 여부: 아니요 ** [ServerHostname](#API_CreateLocationSmb_RequestSyntax) ** DataSync 에이전트가 연결될 SMB 파일 서버의 도메인 이름 또는 IP 주소(IPv4 또는 IPv6)를 지정합니다. Kerberos 인증을 사용하는 경우 도메인 이름을 지정해야 합니다. 유형: 문자열 길이 제약: 최대 길이는 255입니다. 패턴: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` 필수 여부: 예 ** [Subdirectory](#API_CreateLocationSmb_RequestSyntax) ** DataSync가 데이터를 읽거나 쓸 SMB 파일 서버에서 내보낸 공유의 이름을 지정합니다. 공유 경로에 하위 디렉토리(예: `/path/to/subdirectory`)를 포함할 수 있습니다. 네트워크의 다른 SMB 클라이언트도 이 경로를 마운트할 수 있는지 확인하세요. 하위 디렉터리의 모든 데이터를 복사하려면 DataSync가 SMB 공유를 마운트하고 모든 데이터에 액세스할 수 있어야 합니다. 자세한 내용은 [DataSync에 SMB 파일 서버 액세스 권한 제공](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)을 참조하세요. 유형: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` 필수 여부: 예 ** [Tags](#API_CreateLocationSmb_RequestSyntax) ** AWS 리소스를 분류, 필터링 및 검색하는 데 도움이 되는 레이블을 지정합니다. 위치에 대한 이름 태그를 하나 이상 생성하는 것이 좋습니다. 타입: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ** [User](#API_CreateLocationSmb_RequestSyntax) ** SMB 파일 서버의 파일, 폴더, 파일 메타데이터를 탑재하고 액세스할 수 있는 사용자를 지정합니다. 이 파라미터는 `AuthenticationType`이 `NTLM`로 설정된 경우에만 적용됩니다. 전송에 적합한 수준의 액세스 권한을 가진 사용자를 선택하는 방법에 대한 자세한 내용은 [SMB 파일 서버에 대한 DataSync 액세스 제공](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)을 참조하세요. 유형: 문자열 길이 제약: 최대 길이는 104입니다. 패턴: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 필수 여부: 아니요 ## 응답 구문 ``` { "LocationArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [LocationArn](#API_CreateLocationSmb_ResponseSyntax) ** 귀하가 생성한 SMB 위치의 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 ## 예 ### 예 요청 다음 예에서는 SMB 파일 서버의 위치를 생성합니다. ``` { "AgentArns":[ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs", "arn:aws:datasync:us-east-2:111222333444:agent/agent-2345noo35nnee1123ovo3" ], "Domain":"AMAZON", "MountOptions":{ "Version":"SMB3" }, "Password":"string", "ServerHostname":"MyServer.amazon.com", "Subdirectory":"share", "Tags":[ { "Key":"department", "Value":"finance" } ], "User":"user-1" } ``` ### 샘플 응답 응답은 SMB 파일 서버의 위치 ARN을 반환합니다. ``` { "LocationArn": "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49" } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationSmb) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationSmb) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationSmb) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationSmb) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationSmb) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationSmb) # CreateTask AWS DataSync 가 데이터를 이동하는 위치와 방법을 정의하는 *작업*을 구성합니다. 작업에는 소스 위치, 대상 위치, 전송 옵션(예: 대역폭 제한, 예약 등)이 포함됩니다. **중요** Amazon S3 위치와 데이터를 주고받을 계획이라면 시작하기 전에 [DataSync가 S3 요청 요금에 미치는 영향](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) 및 [DataSync](https://aws.amazon.com/datasync/pricing/) 요금 페이지를 검토하세요. ## 구문 요청 ``` { "CloudWatchLogGroupArn": "string", "DestinationLocationArn": "string", "Excludes": [ { "FilterType": "string", "Value": "string" } ], "Includes": [ { "FilterType": "string", "Value": "string" } ], "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "string" } } }, "Name": "string", "Options": { "Atime": "string", "BytesPerSecond": number, "Gid": "string", "LogLevel": "string", "Mtime": "string", "ObjectTags": "string", "OverwriteMode": "string", "PosixPermissions": "string", "PreserveDeletedFiles": "string", "PreserveDevices": "string", "SecurityDescriptorCopyFlags": "string", "TaskQueueing": "string", "TransferMode": "string", "Uid": "string", "VerifyMode": "string" }, "Schedule": { "ScheduleExpression": "string", "Status": "string" }, "SourceLocationArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TaskMode": "string", "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "string", "S3BucketArn": "string", "Subdirectory": "string" } }, "ObjectVersionIds": "string", "OutputType": "string", "Overrides": { "Deleted": { "ReportLevel": "string" }, "Skipped": { "ReportLevel": "string" }, "Transferred": { "ReportLevel": "string" }, "Verified": { "ReportLevel": "string" } }, "ReportLevel": "string" } } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [CloudWatchLogGroupArn](#API_CreateTask_RequestSyntax) ** 작업을 모니터링하기 위한 Amazon CloudWatch 로그 그룹의 Amazon 리소스 이름(ARN)을 지정합니다. 확장 모드 작업의 경우 아무것도 지정할 필요가 없습니다. DataSync는 `/aws/datasync`라는 CloudWatch 로그 그룹에 로그를 자동으로 전송합니다. 자세한 내용은 [CloudWatch Logs를 사용하여 데이터 전송 모니터링](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html)을 참조하세요. 유형: 문자열 길이 제약 조건: 최대 길이는 562입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` 필수 여부: 아니요 ** [DestinationLocationArn](#API_CreateTask_RequestSyntax) ** 전송 대상 위치의 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}$` 필수 여부: 예 ** [Excludes](#API_CreateTask_RequestSyntax) ** DataSync가 전송하지 않도록 소스 위치의 파일, 객체 및 폴더를 정의하는 제외 필터를 지정합니다. 자세한 내용과 예제는 [Specifying what DataSync transfers by using filters](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) 섹션을 참조하세요. 타입: [FilterRule](API_FilterRule.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대 항목 수는 1개입니다. 필수 여부: 아니요 ** [Includes](#API_CreateTask_RequestSyntax) ** DataSync로 전송하려는 소스 위치의 파일, 객체, 폴더를 정의하는 포함 필터를 지정합니다. 자세한 내용과 예제는 [Specifying what DataSync transfers by using filters](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) 섹션을 참조하세요. 타입: [FilterRule](API_FilterRule.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대 항목 수는 1개입니다. 필수 여부: 아니요 ** [ManifestConfig](#API_CreateTask_RequestSyntax) ** DataSync에서 전송하려는 파일 또는 객체 목록인 매니페스트를 구성합니다. 자세한 내용과 구성 예제는 [Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) 섹션을 참조하세요. 이 파라미터를 사용할 때는 발신자 자격 증명(DataSync를 사용하는 역할)에 `iam:PassRole` 권한이 있어야 합니다. [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess) 정책에는 이 권한이 포함됩니다. 유형: [ManifestConfig](API_ManifestConfig.md)객체 필수 여부: 아니요 ** [Name](#API_CreateTask_RequestSyntax) ** 작업의 이름을 지정합니다. 유형: 문자열 길이 제약: 최소 길이는 0. 최대 길이는 256입니다. 패턴: `^[a-zA-Z0-9\s+=._:@/-]+$` 필수 여부: 아니요 ** [Options](#API_CreateTask_RequestSyntax) ** 파일 메타데이터 보존, 데이터 무결성 확인 등의 작업 설정을 지정합니다. 유형: [Options](API_Options.md)객체 필수 여부: 아니요 ** [Schedule](#API_CreateTask_RequestSyntax) ** 작업을 실행할 일정을 지정합니다. 자세한 내용을 알아보려면 [태스크 예약](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html)을 참조하십시오. 유형: [TaskSchedule](API_TaskSchedule.md)객체 필수 여부: 아니요 ** [SourceLocationArn](#API_CreateTask_RequestSyntax) ** 전송 소스 위치의 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}$` 필수 여부: 예 ** [Tags](#API_CreateTask_RequestSyntax) ** 작업에 적용할 태그를 지정합니다. 태그**는 DataSync 리소스를 관리, 필터링 및 검색하는 데 도움이 되는 키-값 페어입니다. 유형: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ** [TaskMode](#API_CreateTask_RequestSyntax) ** 데이터 전송을 위해 다음 작업 모드 중 하나를 지정합니다. + `ENHANCED` - 기본 모드보다 성능이 뛰어난 객체를 사실상 무제한으로 전송합니다. 확장 모드 작업은 데이터를 병렬로 나열, 준비, 전송, 확인하여 데이터 전송 프로세스를 최적화합니다. 확장 모드는 현재 Amazon S3 위치 간 전송, 에이전트 없이 Azure Blob과 Amazon S3 간 전송, 에이전트 없이 다른 클라우드와 Amazon S3 간 전송에 사용할 수 있습니다. **참고** 확장 모드 작업을 생성하려면 `CreateTask` 작업을 호출하는 데 사용하는 IAM 역할에 `iam:CreateServiceLinkedRole` 권한이 있어야 합니다. + `BASIC`(기본값) - AWS 스토리지와 지원되는 다른 모든 DataSync 위치 간에 파일 또는 객체를 전송합니다. 기본 모드 작업에는 데이터세트의 파일, 객체, 디렉터리 수에 대한 [할당량](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html)이 적용됩니다. 기본 모드는 데이터를 순차적으로 준비, 전송, 확인하므로 대부분의 워크로드에서 확장 모드보다 느립니다. 자세한 내용은 [작업 모드 차이점 이해](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences)를 참조하세요. 타입: 문자열 유효 값: `BASIC | ENHANCED` 필수 여부: 아니요 ** [TaskReportConfig](#API_CreateTask_RequestSyntax) ** DataSync 전송에 대한 세부 정보를 제공하는 작업 보고서를 구성할 방법을 지정합니다. 자세한 내용은 [Monitoring your DataSync transfers with task reports](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) 섹션을 참조하세요. 이 파라미터를 사용할 때는 발신자 자격 증명(DataSync를 사용하는 역할)에 `iam:PassRole` 권한이 있어야 합니다. [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess) 정책에는 이 권한이 포함됩니다. 유형: [TaskReportConfig](API_TaskReportConfig.md)객체 필수 항목 여부: 아니요 ## 응답 구문 ``` { "TaskArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [TaskArn](#API_CreateTask_ResponseSyntax) ** 작업의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](CommonErrors.md)섹션을 참조하세요. ** InternalException ** 이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다. HTTP 상태 코드: 500 ** InvalidRequestException ** 이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다. HTTP 상태 코드: 400 ## 예 ### 확장 모드 작업에 대한 샘플 요청 다음 예시에서는 확장 모드를 사용하는 DataSync 작업을 생성합니다. 기본 모드 작업을 생성할 때와 달리 Amazon CloudWatch 로그 그룹을 지정할 필요가 없습니다. 확장 모드 작업에서 DataSync는 작업 로그를 `/aws/datasync`라는 이름의 로그 그룹으로 자동 전송합니다. 해당 로그 그룹이에 없는 경우 AWS 리전 DataSync는 작업을 생성할 때 사용자를 대신하여 로그 그룹을 생성합니다. ``` { "SourceLocationArn": "arn:aws:datasync:us-east-1:111222333444:location/1111aaaa2222bbbb3", "DestinationLocationArn": "arn:aws:datasync:us-east-1:111222333444:location/0000zzzz1111yyyy2", "Name": "My Enhanced mode task", "TaskMode": "ENHANCED", "Options": { "TransferMode": "CHANGED", "VerifyMode": "ONLY_FILES_TRANSFERRED", "ObjectTags": "PRESERVE", "LogLevel": "TRANSFER" } } ``` ### 기본 모드 작업에 대한 샘플 요청 다음 예시에서는 기본 모드를 사용하는 DataSync 작업을 생성합니다. ``` { "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-1111aaaa2222bbbb3", "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-0000zzzz1111yyyy2", "Name": "My Basic mode task", "TaskMode": "BASIC", "Options": { "Atime": "BEST_EFFORT", "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "ONLY_FILES_TRANSFERRED" }, "Schedule": { "ScheduleExpression": "0 12 ? * SUN,WED *" }, "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group:/log-group-name:*", "Tags": [ { "Key": "Name", "Value": "Migration-wave-1" } ] } ``` ### 샘플 응답 다음 응답은 생성된 작업의 ARN을 포함합니다. ``` { "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateTask) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateTask) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateTask) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateTask) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateTask) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateTask) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateTask) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateTask) # DeleteAgent 에서 AWS DataSync 에이전트 리소스를 제거합니다 AWS 계정. 이 작업(취소할 수 없음)은 에이전트의 가상 머신 또는 Amazon EC2 인스턴스를 스토리지 환경에서 제거하지 않는다는 점에 유의하세요. 다음 단계에서는 스토리지 환경에서 VM 또는 인스턴스를 삭제하거나 이를 [새 에이전트 활성화](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html)에 재 사용할 수 있습니다. ## 구문 요청 ``` { "AgentArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AgentArn](#API_DeleteAgent_RequestSyntax) ** 삭제할 에이전트의 Amazon 리소스 이름(ARN)입니다. `ListAgents` 작업을 사용하여 계정 및의 에이전트 목록을 반환합니다 AWS 리전. 유형: 문자열 길이 제약: 최대 길이는 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}$` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/DeleteAgent) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteAgent) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteAgent) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteAgent) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteAgent) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteAgent) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteAgent) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteAgent) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteAgent) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteAgent) # DeleteLocation 전송 위치 리소스를 삭제합니다 AWS DataSync. ## 구문 요청 ``` { "LocationArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_DeleteLocation_RequestSyntax) ** 삭제할 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/DeleteLocation) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteLocation) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteLocation) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteLocation) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteLocation) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteLocation) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteLocation) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteLocation) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteLocation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteLocation) # DeleteTask 전송 작업 리소스를 삭제합니다 AWS DataSync. ## 구문 요청 ``` { "TaskArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [TaskArn](#API_DeleteTask_RequestSyntax) ** 삭제하려는 작업의 Amazon 리소스 이름(ARN)을 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/DeleteTask) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteTask) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteTask) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteTask) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteTask) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteTask) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteTask) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteTask) # DescribeAgent 이름, 서비스 엔드포인트 유형 및 상태와 같은 AWS DataSync 에이전트에 대한 정보를 반환합니다. ## 구문 요청 ``` { "AgentArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AgentArn](#API_DescribeAgent_RequestSyntax) ** 정보를 원하는 DataSync 에이전트의 Amazon 리소스 이름(ARN) 을 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 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}$` 필수 여부: 예 ## 응답 구문 ``` { "AgentArn": "string", "CreationTime": number, "EndpointType": "string", "LastConnectionTime": number, "Name": "string", "Platform": { "Version": "string" }, "PrivateLinkConfig": { "PrivateLinkEndpoint": "string", "SecurityGroupArns": [ "string" ], "SubnetArns": [ "string" ], "VpcEndpointId": "string" }, "Status": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [AgentArn](#API_DescribeAgent_ResponseSyntax) ** 에이전트의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이는 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}$` ** [CreationTime](#API_DescribeAgent_ResponseSyntax) ** 에이전트가 [활성화](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html)된 시간. 유형: 타임스탬프 ** [EndpointType](#API_DescribeAgent_ResponseSyntax) ** 사용자 에이전트가 연결된 [서비스 엔드포인트](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html)의 유형입니다. 타입: 문자열 유효 값: `PUBLIC | PRIVATE_LINK | FIPS | FIPS_PRIVATE_LINK` ** [LastConnectionTime](#API_DescribeAgent_ResponseSyntax) ** 에이전트가 DataSync 서비스와 마지막으로 통신한 시간입니다. 유형: 타임스탬프 ** [Name](#API_DescribeAgent_ResponseSyntax) ** 에이전트의 이름입니다. 유형: 문자열 길이 제약: 최소 길이는 0. 최대 길이는 256입니다. 패턴: `^[a-zA-Z0-9\s+=._:@/-]+$` ** [Platform](#API_DescribeAgent_ResponseSyntax) ** 에이전트에 대한 플랫폼 관련 세부 정보(예: 버전 번호) 유형: [Platform](API_Platform.md)객체 ** [PrivateLinkConfig](#API_DescribeAgent_ResponseSyntax) ** 에이전트가 [VPC 서비스 엔드포인트](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc)에 연결할 때 사용하는 네트워크 구성입니다. 유형: [PrivateLinkConfig](API_PrivateLinkConfig.md)객체 ** [Status](#API_DescribeAgent_ResponseSyntax) ** 에이전트의 상태. + 상태가 `ONLINE`이면 에이전트가 제대로 구성되어 사용할 준비가 된 것입니다. + 상태가 `OFFLINE`이면 에이전트가 5분 이상 동안 DataSync와 연락이 끊긴 것입니다. 몇 가지 원인이 있을 수 있습니다. 자세한 내용은 [에이전트가 오프라인 상태인 경우 어떻게 하나요?](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline) 를 확인하세요. 타입: 문자열 유효 값: `ONLINE | OFFLINE` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](CommonErrors.md)섹션을 참조하세요. ** InternalException ** 이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다. HTTP 상태 코드: 500 ** InvalidRequestException ** 이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다. HTTP 상태 코드: 400 ## 예 ### 예 요청 다음 예는 요청에 지정된 에이전트에 대한 정보를 반환합니다. ``` { "AgentArn": "arn:aws:datasync:us-east-2:111122223333:agent/agent-1234567890abcdef0" } ``` ### 샘플 응답 다음 예제 응답은 공용 서비스 엔드포인트를 사용하는 에이전트를 설명합니다. ``` { "AgentArn": "arn:aws:datasync:us-east-2:111122223333:agent/agent-1234567890abcdef0", "Name": "Data center migration agent", "Status": "ONLINE", "LastConnectionTime": "2022-10-17T17:21:35.540000+00:00", "CreationTime": "2022-10-05T20:52:29.499000+00:00", "EndpointType": "PUBLIC", "Platform": { "Version": "2" } } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeAgent) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeAgent) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeAgent) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeAgent) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeAgent) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeAgent) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeAgent) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeAgent) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeAgent) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeAgent) # DescribeLocationAzureBlob Microsoft Azure Blob Storage의 AWS DataSync 전송 위치가 구성되는 방법에 대한 세부 정보를 제공합니다. ## 구문 요청 ``` { "LocationArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_DescribeLocationAzureBlob_RequestSyntax) ** Azure Blob 스토리지 전송 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ## 응답 구문 ``` { "AccessTier": "string", "AgentArns": [ "string" ], "AuthenticationType": "string", "BlobType": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CreationTime": number, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "LocationArn": "string", "LocationUri": "string", "ManagedSecretConfig": { "SecretArn": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [AccessTier](#API_DescribeLocationAzureBlob_ResponseSyntax) ** 객체 또는 파일을 전송하려는 액세스 티어. 이는 해당 위치를 전송 대상으로 사용하는 경우에만 적용됩니다. 자세한 내용은 [액세스 티어](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers)를 참조하세요. 타입: 문자열 유효 값: `HOT | COOL | ARCHIVE` ** [AgentArns](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Azure Blob 스토리지 컨테이너와 연결할 수 있는 DataSync 에이전트의 ARN 타입: 문자열 배열 배열 구성원: 최소수는 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_DescribeLocationAzureBlob_ResponseSyntax) ** DataSync가 Azure Blob 스토리지에 액세스하는 데 사용하는 인증 방법입니다. DataSync는 공유 액세스 서명(SAS)을 사용하여 블롭 스토리지에 액세스할 수 있습니다. 타입: 문자열 유효 값: `SAS | NONE` ** [BlobType](#API_DescribeLocationAzureBlob_ResponseSyntax) ** 개체 또는 파일을 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_DescribeLocationAzureBlob_ResponseSyntax) ** DataSync 관리형 보안 암호의 구성 정보를 설명하며, 여기에는 DataSync가 고객 관리형 AWS KMS key와 함께 특정 스토리지 위치에 액세스하는 데 사용하는 인증 토큰이 포함됩니다. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 ** [CreationTime](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Azure Blob Storage 전송 위치가 생성된 시간입니다. 유형: 타임스탬프 ** [CustomSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) ** DataSync가 보안 암호에 대한 액세스를 제공하는 고객 관리형 AWS Identity and Access Management (IAM) 역할을 사용하여 특정 스토리지 위치에 액세스하는 데 사용하는 인증 토큰과 같은 고객 관리형 보안 암호의 구성 정보를 설명합니다. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 ** [LocationArn](#API_DescribeLocationAzureBlob_ResponseSyntax) ** Azure 블럽 스토리지 전송 위치의 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}$` ** [LocationUri](#API_DescribeLocationAzureBlob_ResponseSyntax) ** 전송과 관련된 Azure Blob 스토리지 컨테이너의 URL. 타입: 문자열 길이 제약: 최대 길이는 4360입니다. 패턴: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [ManagedSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) ** DataSync 관리형 보안 암호의 구성 정보를 설명하며, 여기에는 DataSync가 특정 스토리지 위치에 액세스하는 데 사용하는 인증 토큰이 포함됩니다. DataSync는 기본 AWS관리형 KMS 키를 사용하여이 보안 암호를 암호화합니다 AWS Secrets Manager. 타입: [ManagedSecretConfig](API_ManagedSecretConfig.md) 객체 ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/DescribeLocationAzureBlob) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationAzureBlob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationAzureBlob) # DescribeLocationEfs Amazon EFS 파일 시스템의 AWS DataSync 전송 위치를 구성하는 방법에 대한 세부 정보를 제공합니다. ## 구문 요청 ``` { "LocationArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_DescribeLocationEfs_RequestSyntax) ** 정보를 확인하려는 Amazon EFS 파일 시스템 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ## 응답 구문 ``` { "AccessPointArn": "string", "CreationTime": number, "Ec2Config": { "SecurityGroupArns": [ "string" ], "SubnetArn": "string" }, "FileSystemAccessRoleArn": "string", "InTransitEncryption": "string", "LocationArn": "string", "LocationUri": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [AccessPointArn](#API_DescribeLocationEfs_ResponseSyntax) ** DataSync가 Amazon EFS 파일 시스템에 액세스하는 데 사용하는 액세스 지점의 ARN입니다. 자세한 내용은 [Accessing restricted file systems](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam) 섹션을 참조하세요. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$` ** [CreationTime](#API_DescribeLocationEfs_ResponseSyntax) ** 위치가 생성된 시간. 유형: 타임스탬프 ** [Ec2Config](#API_DescribeLocationEfs_ResponseSyntax) ** 가 Amazon EFS 파일 시스템의 [탑재 대상](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) 중 하나에 연결하는 데 AWS DataSync 사용하는 서브넷 및 보안 그룹입니다. 유형: [Ec2Config](API_Ec2Config.md)객체 ** [FileSystemAccessRoleArn](#API_DescribeLocationEfs_ResponseSyntax) ** DataSync가 Amazon EFS 파일 시스템에 액세스할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할입니다. 자세한 내용은 [Creating a DataSync IAM role for file system access](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role) 섹션을 참조하세요. 유형: 문자열 길이 제약: 최대 길이 2048. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` ** [InTransitEncryption](#API_DescribeLocationEfs_ResponseSyntax) ** DataSync가 Amazon EFS 파일 시스템으로 또는 파일 시스템에서 데이터를 전송할 때 Transport Layer Security(TLS) 암호화를 사용하는지 여부를 나타냅니다. 타입: 문자열 유효 값: `NONE | TLS1_2` ** [LocationArn](#API_DescribeLocationEfs_ResponseSyntax) ** Amazon EFS 파일 시스템 위치의 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}$` ** [LocationUri](#API_DescribeLocationEfs_ResponseSyntax) ** Amazon EFS 파일 시스템 위치의 URL입니다. 타입: 문자열 길이 제약: 최대 길이는 4360입니다. 패턴: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](CommonErrors.md)섹션을 참조하세요. ** InternalException ** 이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다. HTTP 상태 코드: 500 ** InvalidRequestException ** 이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다. HTTP 상태 코드: 400 ## 예 ### 예 요청 다음의 예는 특정 Amazon EFS 파일 시스템 위치에 대한 정보를 가져오는 방법을 알려줍니다. ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" } ``` ### 샘플 응답 다음 예에서는 Amazon EFS 파일 시스템의 위치 세부 정보를 반환합니다. ``` { "CreationTime": 1653319021.353, "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2" ] }, "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890", "LocationUri": "efs://us-east-2.fs-021345abcdef6789/" } ``` ### 샘플 응답: 제한된 Amazon EFS 파일 시스템의 위치 설명 다음 예는 `AccessPointArn`, `FileSystemAccessRoleArn`, `InTransitEncryption`요소를 포함하여 액세스가 제한된 Amazon EFS 파일 시스템에 대한 위치 세부 정보를 반환합니다. ``` { "CreationTime": 1653319021.353, "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0", "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2" ] }, "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew", "InTransitEncryption": "TLS1_2", "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890", "LocationUri": "efs://us-east-2.fs-021345abcdef6789/", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationEfs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationEfs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationEfs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationEfs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationEfs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationEfs) # DescribeLocationFsxLustre Amazon FSx for Lustre 파일 시스템의 AWS DataSync 전송 위치가 구성되는 방법에 대한 세부 정보를 제공합니다. ## 구문 요청 ``` { "LocationArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_DescribeLocationFsxLustre_RequestSyntax) ** 설명할 FSx for Lustre 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ## 응답 구문 ``` { "CreationTime": number, "LocationArn": "string", "LocationUri": "string", "SecurityGroupArns": [ "string" ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [CreationTime](#API_DescribeLocationFsxLustre_ResponseSyntax) ** FSx for Lustre 위치가 생성된 시간입니다. 타입: Timestamp ** [LocationArn](#API_DescribeLocationFsxLustre_ResponseSyntax) ** FSx for Lustre 위치의 Amazon 리소스 이름(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}$` ** [LocationUri](#API_DescribeLocationFsxLustre_ResponseSyntax) ** FSx for Lustre 위치의 URI입니다. 타입: 문자열 길이 제약: 최대 길이는 4360입니다. 패턴: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [SecurityGroupArns](#API_DescribeLocationFsxLustre_ResponseSyntax) ** FSx for Lustre 파일 시스템에 대해 구성된 보안 그룹의 Amazon 리소스 이름(ARN)입니다. 타입: 문자열 배열 배열 구성원: 최소수는 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]+$` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/DescribeLocationFsxLustre) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxLustre) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxLustre) # DescribeLocationFsxOntap Amazon FSx for NetApp ONTAP 파일 시스템의 AWS DataSync 전송 위치가 구성되는 방법에 대한 세부 정보를 제공합니다. **참고** 위치에서 SMB를 사용하는 경우 `DescribeLocationFsxOntap`작업은 실제로 `Password`를 반환하지 않습니다. ## 구문 요청 ``` { "LocationArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_DescribeLocationFsxOntap_RequestSyntax) ** 정보를 확인하려는 FSx for ONTAP 파일 시스템 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ## 응답 구문 ``` { "CreationTime": number, "FsxFilesystemArn": "string", "LocationArn": "string", "LocationUri": "string", "Protocol": { "NFS": { "MountOptions": { "Version": "string" } }, "SMB": { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "MountOptions": { "Version": "string" }, "Password": "string", "User": "string" } }, "SecurityGroupArns": [ "string" ], "StorageVirtualMachineArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [CreationTime](#API_DescribeLocationFsxOntap_ResponseSyntax) ** 위치가 생성된 시간. 유형: 타임스탬프 ** [FsxFilesystemArn](#API_DescribeLocationFsxOntap_ResponseSyntax) ** FSx for ONTAP 파일 시스템의 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]+$` ** [LocationArn](#API_DescribeLocationFsxOntap_ResponseSyntax) ** FSx for ONTAP 파일 시스템 위치의 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}$` ** [LocationUri](#API_DescribeLocationFsxOntap_ResponseSyntax) ** FSx for ONTAP 파일 시스템 위치의 URI(균일 리소스 식별자). 유형: 문자열 길이 제약: 최대 길이는 4360입니다. 패턴: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [Protocol](#API_DescribeLocationFsxOntap_ResponseSyntax) ** 가 Amazon FSx 파일 시스템에 액세스하는 데 AWS DataSync 사용하는 데이터 전송 프로토콜을 지정합니다. 유형: [FsxProtocol](API_FsxProtocol.md)객체 ** [SecurityGroupArns](#API_DescribeLocationFsxOntap_ResponseSyntax) ** DataSync가 FSx for ONTAP 파일 시스템에 액세스하는 데 사용하는 보안 그룹. 타입: 문자열 배열 배열 구성원: 최소수는 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]+$` ** [StorageVirtualMachineArn](#API_DescribeLocationFsxOntap_ResponseSyntax) ** 데이터를 복사할 FSx for ONTAP 파일 시스템의 스토리지 가상 머신(SVM)의 ARN. 유형: 문자열 길이 제약: 최대 길이는 162입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:storage-virtual-machine/fs-[0-9a-f]+/svm-[0-9a-f]{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/DescribeLocationFsxOntap) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxOntap) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxOntap) # DescribeLocationFsxOpenZfs Amazon FSx for OpenZFS 파일 시스템의 AWS DataSync 전송 위치가 구성되는 방법에 대한 세부 정보를 제공합니다. **참고** `SMB`와 관련된 응답 요소는 `DescribeLocationFsxOpenZfs`작업에서 지원되지 않습니다. ## 구문 요청 ``` { "LocationArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_DescribeLocationFsxOpenZfs_RequestSyntax) ** 설명할 FSx for OpenZFS 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ## 응답 구문 ``` { "CreationTime": number, "LocationArn": "string", "LocationUri": "string", "Protocol": { "NFS": { "MountOptions": { "Version": "string" } }, "SMB": { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "MountOptions": { "Version": "string" }, "Password": "string", "User": "string" } }, "SecurityGroupArns": [ "string" ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [CreationTime](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) ** FSx for OpenZFS 위치가 생성된 시간입니다. 유형: 타임스탬프 ** [LocationArn](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) ** FSx for OpenZFS 위치의 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}$` ** [LocationUri](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) ** FSx for OpenZFS 위치의 통합 리소스 식별자(URI)입니다. 예시: `fsxz://us-west-2.fs-1234567890abcdef02/fsx/folderA/folder` 유형: 문자열 길이 제약: 최대 길이는 4360입니다. 패턴: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [Protocol](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) ** 가 파일 시스템에 액세스하는 데 AWS DataSync 사용하는 프로토콜 유형입니다. 유형: [FsxProtocol](API_FsxProtocol.md)객체 ** [SecurityGroupArns](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) ** FSx for OpenZFS 파일 시스템을 구성하는 보안 그룹의 ARN입니다. 타입: 문자열 배열 배열 구성원: 최소수는 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]+$` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/DescribeLocationFsxOpenZfs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) # DescribeLocationFsxWindows Amazon FSx for Windows File Server 파일 시스템의 AWS DataSync 전송 위치를 구성하는 방법에 대한 세부 정보를 제공합니다. ## 구문 요청 ``` { "LocationArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_DescribeLocationFsxWindows_RequestSyntax) ** FSx for Windows File Server 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ## 응답 구문 ``` { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CreationTime": number, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "LocationArn": "string", "LocationUri": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "SecurityGroupArns": [ "string" ], "User": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [CmkSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) ** DataSync가 고객 관리형를 사용하여 특정 스토리지 위치에 액세스하는 데 사용하는 등 `Password` DataSync 관리형 보안 암호의 구성 정보를 설명합니다 AWS KMS key. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 ** [CreationTime](#API_DescribeLocationFsxWindows_ResponseSyntax) ** FSx for Windows File Server가 생성된 시간입니다. 유형: 타임스탬프 ** [CustomSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) ** `Password` DataSync가 보안 암호에 대한 액세스를 제공하는 고객 관리형(IAM) 역할을 사용하여 특정 스토리지 위치에 액세스하는 데 사용하는 등 고객 관리형 AWS Identity and Access Management 보안 암호에 대한 구성 정보를 설명합니다. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 ** [Domain](#API_DescribeLocationFsxWindows_ResponseSyntax) ** FSx for Windows File Server 파일 시스템이 속한 Microsoft Active Directory 도메인의 이름입니다. 유형: 문자열 길이 제약: 최대 길이는 253입니다. 패턴: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` ** [LocationArn](#API_DescribeLocationFsxWindows_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}$` ** [LocationUri](#API_DescribeLocationFsxWindows_ResponseSyntax) ** FSx for Windows File Server 위치의 Uniform Resource Identifier(URI)입니다. 유형: 문자열 길이 제약: 최대 길이는 4360입니다. 패턴: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [ManagedSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) ** DataSync가 특정 스토리지 위치에 액세스하는 데 사용하는와 같은 `Password` DataSync 관리형 보안 암호의 구성 정보를 설명합니다. DataSync는 기본 AWS관리형 KMS 키를 사용하여이 보안 암호를 암호화합니다 AWS Secrets Manager. 유형: [ManagedSecretConfig](API_ManagedSecretConfig.md)객체 ** [SecurityGroupArns](#API_DescribeLocationFsxWindows_ResponseSyntax) ** 파일 시스템의 기본 설정 서브넷에 대한 액세스를 제공하는 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]+$` ** [User](#API_DescribeLocationFsxWindows_ResponseSyntax) ** FSx for Windows File Server 파일 시스템을 마운트하고 액세스할 수 있는 권한이 있는 사용자입니다. 유형: 문자열 길이 제약: 최대 길이는 104입니다. 패턴: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/DescribeLocationFsxWindows) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxWindows) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxWindows) # DescribeLocationHdfs 하둡 분산 파일 시스템(HDFS)의 AWS DataSync 전송 위치가 구성되는 방법에 대한 세부 정보를 제공합니다. ## 구문 요청 ``` { "LocationArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_DescribeLocationHdfs_RequestSyntax) ** HDFS 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ## 응답 구문 ``` { "AgentArns": [ "string" ], "AuthenticationType": "string", "BlockSize": number, "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CreationTime": number, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "KerberosPrincipal": "string", "KmsKeyProviderUri": "string", "LocationArn": "string", "LocationUri": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "NameNodes": [ { "Hostname": "string", "Port": number } ], "QopConfiguration": { "DataTransferProtection": "string", "RpcProtection": "string" }, "ReplicationFactor": number, "SimpleUser": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [AgentArns](#API_DescribeLocationHdfs_ResponseSyntax) ** HDFS 클러스터와 연결할 수 있는 DataSync 에이전트의 ARN입니다. 타입: 문자열 배열 배열 구성원: 최소수는 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_DescribeLocationHdfs_ResponseSyntax) ** 사용자 ID를 결정하는 데 사용되는 인증 타입. 타입: 문자열 유효 값: `SIMPLE | KERBEROS` ** [BlockSize](#API_DescribeLocationHdfs_ResponseSyntax) ** HDFS 클러스터에 쓸 데이터 블록의 크기. 타입: 정수 유효한 범위: 최소값은 1048576입니다. 최대값은 1073741824입니다. ** [CmkSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) ** DataSync가 고객 관리형를 사용하여 특정 스토리지 위치에 액세스하는 데 사용하는 등 `KerberosKeytab` DataSync 관리형 보안 암호의 구성 정보를 설명합니다 AWS KMS key. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 ** [CreationTime](#API_DescribeLocationHdfs_ResponseSyntax) ** HDFS 위치가 생성된 시간입니다. 유형: 타임스탬프 ** [CustomSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) ** `KerberosKeytab` DataSync가 보안 암호에 대한 액세스를 제공하는 고객 관리형(IAM) 역할을 사용하여 특정 스토리지 위치에 액세스하는 데 사용하는 등 고객 관리형 AWS Identity and Access Management 보안 암호에 대한 구성 정보를 설명합니다. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 ** [KerberosPrincipal](#API_DescribeLocationHdfs_ResponseSyntax) ** HDFS 클러스터의 파일 및 폴더에 대한 액세스 권한이 있는 Kerberos 보안 주체입니다. 이 파라미터는(`AuthenticationType`이)가(`KERBEROS`으)로 정의된 경우에 사용됩니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `^.+$` ** [KmsKeyProviderUri](#API_DescribeLocationHdfs_ResponseSyntax) ** HDFS 클러스터의 키 관리 서버(KMS)의 URI입니다. 타입: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 255. 패턴: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$` ** [LocationArn](#API_DescribeLocationHdfs_ResponseSyntax) ** HDFS 위치의 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}$` ** [LocationUri](#API_DescribeLocationHdfs_ResponseSyntax) ** HDFS 위치의 URI입니다. 유형: 문자열 길이 제약: 최대 길이는 4360입니다. 패턴: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [ManagedSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) ** DataSync가 특정 스토리지 위치에 액세스하는 데 사용하는와 같은 `KerberosKeytab` DataSync 관리형 보안 암호의 구성 정보를 설명합니다. DataSync는 기본 AWS관리형 KMS 키를 사용하여이 보안 암호를 암호화합니다 AWS Secrets Manager. 유형: [ManagedSecretConfig](API_ManagedSecretConfig.md)객체 ** [NameNodes](#API_DescribeLocationHdfs_ResponseSyntax) ** HDFS 네임스페이스를 관리하는 NameNode입니다. 타입: [HdfsNameNode](API_HdfsNameNode.md)객체 배열 어레이 멤버: 최소 항목 수 1개. ** [QopConfiguration](#API_DescribeLocationHdfs_ResponseSyntax) ** Quality of Protection(QOP) 구성은 HDFS 클러스터에 구성된 Remote Procedure Call(RPC) 및 데이터 전송 방지 설정을 지정합니다. 유형: [QopConfiguration](API_QopConfiguration.md)객체 ** [ReplicationFactor](#API_DescribeLocationHdfs_ResponseSyntax) ** HDFS 클러스터에 쓸 때 데이터를 복제할 DataNode의 수입니다. 타입: 정수 유효 범위: 최소값 1. 최대값은 512입니다. ** [SimpleUser](#API_DescribeLocationHdfs_ResponseSyntax) ** 호스트 운영 체제에서 클라이언트를 식별하는 사용자 이름입니다. 이 파라미터는(`AuthenticationType`이)가(`SIMPLE`으)로 정의된 경우에 사용됩니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/DescribeLocationHdfs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationHdfs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationHdfs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationHdfs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationHdfs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationHdfs) # DescribeLocationNfs NFS(Network File System) 파일 서버의 AWS DataSync 전송 위치가 구성되는 방법에 대한 세부 정보를 제공합니다. ## 구문 요청 ``` { "LocationArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_DescribeLocationNfs_RequestSyntax) ** 정보를 원하는 NFS 위치의 Amazon 리소스 이름 (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}$` 필수 여부: 예 ## 응답 구문 ``` { "CreationTime": number, "LocationArn": "string", "LocationUri": "string", "MountOptions": { "Version": "string" }, "OnPremConfig": { "AgentArns": [ "string" ] } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [CreationTime](#API_DescribeLocationNfs_ResponseSyntax) ** NFS 위치가 생성된 시간입니다. 유형: 타임스탬프 ** [LocationArn](#API_DescribeLocationNfs_ResponseSyntax) ** NFS 위치의 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}$` ** [LocationUri](#API_DescribeLocationNfs_ResponseSyntax) ** NFS 위치의 URI입니다. 유형: 문자열 길이 제약: 최대 길이는 4360입니다. 패턴: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [MountOptions](#API_DescribeLocationNfs_ResponseSyntax) ** DataSync가 사용자 NFS 파일 서버를 탑재하는 데 사용하는 탑재 옵션입니다. 유형: [NfsMountOptions](API_NfsMountOptions.md)객체 ** [OnPremConfig](#API_DescribeLocationNfs_ResponseSyntax) ** NFS(Network File System) 파일 서버에 연결할 수 있는 AWS DataSync 에이전트입니다. 타입: [OnPremConfig](API_OnPremConfig.md) 객체 ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](CommonErrors.md)섹션을 참조하세요. ** InternalException ** 이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다. HTTP 상태 코드: 500 ** InvalidRequestException ** 이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다. HTTP 상태 코드: 400 ## 예 ### 예제 다음 예는 샘플 요청에 지정된 NFS 위치에 대한 정보를 반환합니다. #### 샘플 요청 ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa" } ``` ### 예제 이 예제에서는 DescribeLocationNFS의 한 가지 사용법을 보여줍니다. #### 샘플 응답 ``` { "CreationTime": 1532660733.39, "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa", "LocationUri": "hostname.amazon.com", "OnPremConfig": { "AgentArns": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ] } } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationNfs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationNfs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationNfs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationNfs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationNfs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationNfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationNfs) # DescribeLocationObjectStorage 객체 스토리지 시스템의 AWS DataSync 전송 위치를 구성하는 방법에 대한 세부 정보를 제공합니다. ## 구문 요청 ``` { "LocationArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_DescribeLocationObjectStorage_RequestSyntax) ** 객체 스토리지 시스템 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ## 응답 구문 ``` { "AccessKey": "string", "AgentArns": [ "string" ], "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CreationTime": number, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "LocationArn": "string", "LocationUri": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "ServerCertificate": blob, "ServerPort": number, "ServerProtocol": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [AccessKey](#API_DescribeLocationObjectStorage_ResponseSyntax) ** 객체 스토리지 시스템 인증에 필요한 액세스 키(예: 사용자 이름). 유형: 문자열 길이 제한: 최소 길이는 0. 최대 길이는 200입니다. 패턴: `^.*$` ** [AgentArns](#API_DescribeLocationObjectStorage_ResponseSyntax) ** 객체 스토리지 시스템과 연결할 수 있는 DataSync 에이전트의 ARN입니다. 타입: 문자열 배열 배열 구성원: 최소수는 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}$` ** [CmkSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) ** DataSync 관리형 보안 암호의 구성 정보를 설명하며, 여기에는 DataSync가 특정 전송 위치에 액세스하는 데 사용하는 인증 토큰 또는 자격 증명 세트와 고객 관리형 AWS KMS key가 포함됩니다. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 ** [CreationTime](#API_DescribeLocationObjectStorage_ResponseSyntax) ** 위치가 생성된 시간. 유형: 타임스탬프 ** [CustomSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) ** DataSync가 특정 전송 위치에 액세스하는 데 사용하는 인증 토큰 또는 자격 증명 세트, 보안 암호에 대한 액세스를 제공하는 고객 관리형 AWS Identity and Access Management (IAM) 역할과 같은 고객 관리형 보안 암호의 구성 정보를 설명합니다. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 ** [LocationArn](#API_DescribeLocationObjectStorage_ResponseSyntax) ** 오브젝트 스토리지 시스템 위치의 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}$` ** [LocationUri](#API_DescribeLocationObjectStorage_ResponseSyntax) ** 객체 스토리지 시스템 위치의 URI입니다. 유형: 문자열 길이 제약: 최대 길이는 4360입니다. 패턴: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [ManagedSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) ** DataSync 관리형 보안 암호의 구성 정보를 설명하며, 여기에는 DataSync가 특정 전송 위치에 액세스하는 데 사용하는 인증 토큰 또는 자격 증명 세트가 포함됩니다. DataSync는 기본 AWS관리형 KMS 키를 사용하여이 보안 암호를 암호화합니다 AWS Secrets Manager. 유형: [ManagedSecretConfig](API_ManagedSecretConfig.md)객체 ** [ServerCertificate](#API_DescribeLocationObjectStorage_ResponseSyntax) ** 시스템이 프라이빗 또는 자체 서명 인증 기관(CA)을 사용하는 경우 DataSync가 객체 스토리지 시스템으로 인증하기 위한 인증서 체인입니다. 타입: Base64로 인코딩된 이진 데이터 객체 길이 제약 조건: 최대 길이는 32768입니다. ** [ServerPort](#API_DescribeLocationObjectStorage_ResponseSyntax) ** 객체 스토리지 서버가 인바운드 네트워크 트래픽을 수락하는 포트 (예: 포트 443). 타입: 정수 유효 범위: 최소값 1. 최댓값은 65536입니다. ** [ServerProtocol](#API_DescribeLocationObjectStorage_ResponseSyntax) ** 객체 스토리지 시스템이 통신에 사용하는 프로토콜. 타입: 문자열 유효 값: `HTTPS | HTTP` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/DescribeLocationObjectStorage) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationObjectStorage) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationObjectStorage) # DescribeLocationS3 S3 버킷의 AWS DataSync 전송 위치가 구성되는 방법에 대한 세부 정보를 제공합니다. ## 구문 요청 ``` { "LocationArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_DescribeLocationS3_RequestSyntax) ** Amazon S3 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ## 응답 구문 ``` { "AgentArns": [ "string" ], "CreationTime": number, "LocationArn": "string", "LocationUri": "string", "S3Config": { "BucketAccessRoleArn": "string" }, "S3StorageClass": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [AgentArns](#API_DescribeLocationS3_ResponseSyntax) ** Amazon S3 on Outposts 작업을 사용할 때 Outpost에 배포된 DataSync 에이전트의 ARN입니다. 자세한 내용은 [ DataSync 에이전트 배포를 참조하세요 AWS Outposts](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent). 타입: 문자열 배열 배열 구성원: 최소수는 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}$` ** [CreationTime](#API_DescribeLocationS3_ResponseSyntax) ** Amazon S3 위치가 생성된 시간입니다. 유형: 타임스탬프 ** [LocationArn](#API_DescribeLocationS3_ResponseSyntax) ** Amazon S3 위치의 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}$` ** [LocationUri](#API_DescribeLocationS3_ResponseSyntax) ** 설명된 Amazon S3 위치의 URL입니다. 타입: 문자열 길이 제약: 최대 길이는 4360입니다. 패턴: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [S3Config](#API_DescribeLocationS3_ResponseSyntax) ** DataSync가 S3 버킷에 액세스하는 데 사용하는 (IAM) 역할의 Amazon 리소스 이름 AWS Identity and Access Management (ARN)을 지정합니다. 자세한 내용은 [DataSync에 S3 버킷 액세스 권한 제공](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access)을 참조하세요. 유형: [S3Config](API_S3Config.md)객체 ** [S3StorageClass](#API_DescribeLocationS3_ResponseSyntax) ** Amazon S3가 대상 위치인 경우 객체에 대해 선택한 스토리지 클래스입니다. 일부 스토리지 클래스에는 Amazon S3 스토리지 비용에 영향을 미칠 수 있는 동작이 있습니다. 자세한 내용은 [Storage class considerations with Amazon S3 transfers](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) 섹션을 참조하세요. 타입: 문자열 유효 값: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](CommonErrors.md)섹션을 참조하세요. ** InternalException ** 이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다. HTTP 상태 코드: 500 ** InvalidRequestException ** 이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다. HTTP 상태 코드: 400 ## 예 ### 예제 다음 예제는 샘플 요청에 지정된 Amazon S3 위치에 대한 정보를 반환합니다. #### 샘플 요청 ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3" } ``` ### 예제 이 예에서는 DescribeLocations3의 한 가지 사용법을 보여줍니다. #### 샘플 응답 ``` { "CreationTime": 1532660733.39, "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3", "LocationUri": "s3://amzn-s3-demo-bucket", "S3Config": { "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/amzn-s3-demo-bucket-access-role", } "S3StorageClass": "STANDARD" } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationS3) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationS3) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationS3) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationS3) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationS3) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationS3) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationS3) # DescribeLocationSmb SMB(Server Message Block) 파일 서버의 AWS DataSync 전송 위치를 구성하는 방법에 대한 세부 정보를 제공합니다. ## 구문 요청 ``` { "LocationArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_DescribeLocationSmb_RequestSyntax) ** 정보를 원하는 SMB 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ## 응답 구문 ``` { "AgentArns": [ "string" ], "AuthenticationType": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CreationTime": number, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "DnsIpAddresses": [ "string" ], "Domain": "string", "KerberosPrincipal": "string", "LocationArn": "string", "LocationUri": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "MountOptions": { "Version": "string" }, "User": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [AgentArns](#API_DescribeLocationSmb_ResponseSyntax) ** 사용자의 SMB 파일 서버와 연결할 수 있는 DataSync 에이전트의 ARN입니다. 타입: 문자열 배열 배열 구성원: 최소수는 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_DescribeLocationSmb_ResponseSyntax) ** DataSync가 SMB 파일 서버에 연결하는 데 사용하는 인증 프로토콜입니다. 타입: 문자열 유효 값: `NTLM | KERBEROS` ** [CmkSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) ** DataSync가 고객 관리형를 사용하여 특정 스토리지 위치에 액세스하는 데 사용하는 `Password` 또는와 같은 `KerberosKeytab` DataSync 관리형 보안 암호의 구성 정보를 설명합니다 AWS KMS key. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 ** [CreationTime](#API_DescribeLocationSmb_ResponseSyntax) ** SMB 위치가 생성된 시간입니다. 유형: 타임스탬프 ** [CustomSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) ** `KerberosKeytab` DataSync가 보안 암호에 대한 액세스를 제공하는 고객 관리형 AWS Identity and Access Management (IAM) 역할을 사용하여 특정 스토리지 위치에 액세스하는 데 사용하는 `Password` 또는와 같은 고객 관리형 보안 암호의 구성 정보를 설명합니다. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 ** [DnsIpAddresses](#API_DescribeLocationSmb_ResponseSyntax) ** SMB 파일 서버가 속한 DNS 서버의 IPv4 또는 IPv6 주소입니다. 이 값은 `AuthenticationType`이 `KERBEROS`로 설정된 경우에만 적용됩니다. 유형: 문자열 배열 배열 멤버: 최대 항목 수는 2개입니다. 길이 제약: 최소 길이는 7입니다. 최대 길이는 39입니다. 패턴: `\A((25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z` ** [Domain](#API_DescribeLocationSmb_ResponseSyntax) ** SMB 파일 서버가 속한 Windows 도메인의 이름입니다. 이 값은 `AuthenticationType`이 `NTLM`로 설정된 경우에만 적용됩니다. 유형: 문자열 길이 제약: 최대 길이는 253입니다. 패턴: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` ** [KerberosPrincipal](#API_DescribeLocationSmb_ResponseSyntax) ** SMB 파일 서버의 파일, 폴더, 파일 메타데이터에 액세스할 권한이 있는 Kerberos 보안 주체입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `^.+$` ** [LocationArn](#API_DescribeLocationSmb_ResponseSyntax) ** SMB 위치의 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}$` ** [LocationUri](#API_DescribeLocationSmb_ResponseSyntax) ** SMB 위치의 URI입니다. 유형: 문자열 길이 제약: 최대 길이는 4360입니다. 패턴: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [ManagedSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) ** DataSync가 특정 스토리지 위치에 액세스하는 데 사용하는 `Password` 또는와 같은 `KerberosKeytab` DataSync 관리형 보안 암호의 구성 정보를 설명합니다. DataSync는 기본 AWS관리형 KMS 키를 사용하여이 보안 암호를 암호화합니다 AWS Secrets Manager. 유형: [ManagedSecretConfig](API_ManagedSecretConfig.md)객체 ** [MountOptions](#API_DescribeLocationSmb_ResponseSyntax) ** DataSync가 SMB 파일 서버에 액세스하는 데 사용하는 SMB 프로토콜의 버전입니다. 유형: [SmbMountOptions](API_SmbMountOptions.md)객체 ** [User](#API_DescribeLocationSmb_ResponseSyntax) ** SMB 파일 서버의 파일, 폴더, 파일 메타데이터를 탑재하고 액세스할 수 있는 사용자입니다. 이 값은 `AuthenticationType`이 `NTLM`로 설정된 경우에만 적용됩니다. 유형: 문자열 길이 제약: 최대 길이는 104입니다. 패턴: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](CommonErrors.md)섹션을 참조하세요. ** InternalException ** 이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다. HTTP 상태 코드: 500 ** InvalidRequestException ** 이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다. HTTP 상태 코드: 400 ## 예 ### 예제 이 예에서는 DescribeLocationSMB의 한 가지 사용법을 보여줍니다. #### 예 요청 ``` { "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49" } ``` ### 예제 이 예에서는 DescribeLocationSMB의 한 가지 사용법을 보여줍니다. #### 샘플 응답 ``` { "AgentArns":[ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0bc3b3dc9bbc15145", "arn:aws:datasync:us-east-2:111222333444:agent/agent-04b3fe3d261a18c8f" ], "CreationTime":"1532660733.39", "Domain":"AMAZON", "LocationArn":"arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49", "LocationUri":"smb://hostname.amazon.com/share", "MountOptions":{ "Version":"SMB3" }, "User":"user-1" } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationSmb) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationSmb) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationSmb) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationSmb) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationSmb) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationSmb) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationSmb) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationSmb) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationSmb) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationSmb) # DescribeTask AWS DataSync 가 데이터를 전송하는 위치와 방법을 정의하는 *작업*에 대한 정보를 제공합니다. ## 구문 요청 ``` { "TaskArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [TaskArn](#API_DescribeTask_RequestSyntax) ** 정보를 원하는 전송의 Amazon 리소스 이름(ARN)을 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$` 필수 여부: 예 ## 응답 구문 ``` { "CloudWatchLogGroupArn": "string", "CreationTime": number, "CurrentTaskExecutionArn": "string", "DestinationLocationArn": "string", "DestinationNetworkInterfaceArns": [ "string" ], "ErrorCode": "string", "ErrorDetail": "string", "Excludes": [ { "FilterType": "string", "Value": "string" } ], "Includes": [ { "FilterType": "string", "Value": "string" } ], "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "string" } } }, "Name": "string", "Options": { "Atime": "string", "BytesPerSecond": number, "Gid": "string", "LogLevel": "string", "Mtime": "string", "ObjectTags": "string", "OverwriteMode": "string", "PosixPermissions": "string", "PreserveDeletedFiles": "string", "PreserveDevices": "string", "SecurityDescriptorCopyFlags": "string", "TaskQueueing": "string", "TransferMode": "string", "Uid": "string", "VerifyMode": "string" }, "Schedule": { "ScheduleExpression": "string", "Status": "string" }, "ScheduleDetails": { "DisabledBy": "string", "DisabledReason": "string", "StatusUpdateTime": number }, "SourceLocationArn": "string", "SourceNetworkInterfaceArns": [ "string" ], "Status": "string", "TaskArn": "string", "TaskMode": "string", "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "string", "S3BucketArn": "string", "Subdirectory": "string" } }, "ObjectVersionIds": "string", "OutputType": "string", "Overrides": { "Deleted": { "ReportLevel": "string" }, "Skipped": { "ReportLevel": "string" }, "Transferred": { "ReportLevel": "string" }, "Verified": { "ReportLevel": "string" } }, "ReportLevel": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [CloudWatchLogGroupArn](#API_DescribeTask_ResponseSyntax) ** 작업을 모니터링하기 위한 Amazon CloudWatch 로그 그룹의 Amazon 리소스 이름(ARN)입니다. 자세한 내용은 [CloudWatch Logs를 사용하여 데이터 전송 모니터링](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html)을 참조하세요. 유형: 문자열 길이 제약 조건: 최대 길이는 562입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` ** [CreationTime](#API_DescribeTask_ResponseSyntax) ** 작업이 생성된 시각입니다. 유형: 타임스탬프 ** [CurrentTaskExecutionArn](#API_DescribeTask_ResponseSyntax) ** 가장 최근 작업 실행의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` ** [DestinationLocationArn](#API_DescribeTask_ResponseSyntax) ** 전송 대상 위치의 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}$` ** [DestinationNetworkInterfaceArns](#API_DescribeTask_ResponseSyntax) ** DataSync가 대상 위치에 생성한 [네트워크 인터페이스](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces)의 ARN입니다. 유형: 문자열 배열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$` ** [ErrorCode](#API_DescribeTask_ResponseSyntax) ** 작업에 문제가 있는 경우 오류 코드를 사용하여 문제를 해결할 수 있습니다. 자세한 내용은 [Troubleshooting issues with DataSync transfers](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html) 섹션을 참조하세요. 유형: 문자열 ** [ErrorDetail](#API_DescribeTask_ResponseSyntax) ** 작업에 문제가 있는 경우 오류 세부 정보를 사용하여 문제를 해결할 수 있습니다. 자세한 내용은 [Troubleshooting issues with DataSync transfers](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html) 섹션을 참조하세요. 유형: 문자열 ** [Excludes](#API_DescribeTask_ResponseSyntax) ** DataSync가 전송하지 않도록 소스 위치의 파일, 객체 및 폴더를 정의하는 제외 필터입니다. 자세한 내용과 예제는 [Specifying what DataSync transfers by using filters](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) 섹션을 참조하세요. 타입: [FilterRule](API_FilterRule.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대 항목 수는 1개입니다. ** [Includes](#API_DescribeTask_ResponseSyntax) ** DataSync가 전송할 소스 위치의 파일, 객체 및 폴더를 정의하는 포함 필터입니다. 자세한 내용과 예제는 [Specifying what DataSync transfers by using filters](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) 섹션을 참조하세요. 타입: [FilterRule](API_FilterRule.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대 항목 수는 1개입니다. ** [ManifestConfig](#API_DescribeTask_ResponseSyntax) ** DataSync가 전송할 파일 또는 객체를 나열하는 매니페스트의 구성입니다. 자세한 내용은 [Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) 섹션을 참조하세요. 유형: [ManifestConfig](API_ManifestConfig.md)객체 ** [Name](#API_DescribeTask_ResponseSyntax) ** 작업의 이름입니다. 유형: 문자열 길이 제약: 최소 길이는 0. 최대 길이는 256입니다. 패턴: `^[a-zA-Z0-9\s+=._:@/-]+$` ** [Options](#API_DescribeTask_ResponseSyntax) ** 작업의 설정입니다. 예를 들어 보존되는 파일 메타데이터, 전송 종료 시 데이터 무결성 확인 방법, 대역폭 제한 등 여러 옵션이 있습니다. 유형: [Options](API_Options.md)객체 ** [Schedule](#API_DescribeTask_ResponseSyntax) ** 작업을 실행할 일정입니다. 자세한 내용을 알아보려면 [태스크 예약](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html)을 참조하십시오. 유형: [TaskSchedule](API_TaskSchedule.md)객체 ** [ScheduleDetails](#API_DescribeTask_ResponseSyntax) ** [작업 일정](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html)에 대한 세부 정보입니다. 유형: [TaskScheduleDetails](API_TaskScheduleDetails.md)객체 ** [SourceLocationArn](#API_DescribeTask_ResponseSyntax) ** 전송 소스 위치의 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}$` ** [SourceNetworkInterfaceArns](#API_DescribeTask_ResponseSyntax) ** DataSync가 소스 위치에 생성한 [네트워크 인터페이스](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces)의 ARN입니다. 유형: 문자열 배열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$` ** [Status](#API_DescribeTask_ResponseSyntax) ** 작업의 상태입니다. 각 상태의 의미에 대한 자세한 내용은 [Task statuses](https://docs.aws.amazon.com/datasync/latest/userguide/create-task-how-to.html#understand-task-creation-statuses) 섹션을 참조하세요. 타입: 문자열 유효 값: `AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE` ** [TaskArn](#API_DescribeTask_ResponseSyntax) ** 작업의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$` ** [TaskMode](#API_DescribeTask_ResponseSyntax) ** 사용 중인 작업 모드입니다. 자세한 내용은 [데이터 전송을 위한 작업 모드 선택](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)을 참조하세요. 타입: 문자열 유효 값: `BASIC | ENHANCED` ** [TaskReportConfig](#API_DescribeTask_ResponseSyntax) ** DataSync 전송에 대한 세부 정보를 제공하는 작업 보고서 구성입니다. 자세한 내용은 [Monitoring your DataSync transfers with task reports](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) 섹션을 참조하세요. 타입: [TaskReportConfig](API_TaskReportConfig.md) 객체 ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](CommonErrors.md)섹션을 참조하세요. ** InternalException ** 이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다. HTTP 상태 코드: 500 ** InvalidRequestException ** 이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다. HTTP 상태 코드: 400 ## 예 ### 예 요청 다음 예시에서는 정보를 가져올 DataSync 작업의 ARN을 지정합니다. ``` { "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ### 샘플 응답 다음 예시에서는 `DescribeTask` 응답을 보여 줍니다. ``` { "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026", "Name": "MyTask", "TaskMode": "BASIC", "Status": "RUNNING", "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-1111aaaa2222bbbb3", "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-0000zzzz1111yyyy2", "CurrentTaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f", "CreationTime": 1532660733.39, "Options": { "Atime": "BEST_EFFORT", "BytesPerSecond": 1000, "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group:/log-group-name:*" } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeTask) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTask) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTask) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTask) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTask) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTask) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTask) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTask) # DescribeTaskExecution AWS DataSync 작업 실행에 대한 정보를 제공합니다. 이 작업을 사용하면 진행 중인 데이터 전송 상황을 모니터링하거나 전송 결과를 확인할 수 있습니다. **참고** 일부 `DescribeTaskExecution` 응답 요소는 특정 작업 모드에만 적용됩니다. 자세한 내용은 [작업 모드 차이 이해](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences) 및 [데이터 전송 성능 카운터 이해](https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-counters.html)를 참조하세요. ## 구문 요청 ``` { "TaskExecutionArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [TaskExecutionArn](#API_DescribeTaskExecution_RequestSyntax) ** 정보를 원하는 작업 진행의 Amazon 리소스 이름(ARN)을 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` 필수 여부: 예 ## 응답 구문 ``` { "BytesCompressed": number, "BytesTransferred": number, "BytesWritten": number, "EndTime": number, "EstimatedBytesToTransfer": number, "EstimatedFilesToDelete": number, "EstimatedFilesToTransfer": number, "EstimatedFoldersToDelete": number, "EstimatedFoldersToTransfer": number, "Excludes": [ { "FilterType": "string", "Value": "string" } ], "FilesDeleted": number, "FilesFailed": { "Delete": number, "Prepare": number, "Transfer": number, "Verify": number }, "FilesListed": { "AtDestinationForDelete": number, "AtSource": number }, "FilesPrepared": number, "FilesSkipped": number, "FilesTransferred": number, "FilesVerified": number, "FoldersDeleted": number, "FoldersFailed": { "Delete": number, "List": number, "Prepare": number, "Transfer": number, "Verify": number }, "FoldersListed": { "AtDestinationForDelete": number, "AtSource": number }, "FoldersPrepared": number, "FoldersSkipped": number, "FoldersTransferred": number, "FoldersVerified": number, "Includes": [ { "FilterType": "string", "Value": "string" } ], "LaunchTime": number, "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "string" } } }, "Options": { "Atime": "string", "BytesPerSecond": number, "Gid": "string", "LogLevel": "string", "Mtime": "string", "ObjectTags": "string", "OverwriteMode": "string", "PosixPermissions": "string", "PreserveDeletedFiles": "string", "PreserveDevices": "string", "SecurityDescriptorCopyFlags": "string", "TaskQueueing": "string", "TransferMode": "string", "Uid": "string", "VerifyMode": "string" }, "ReportResult": { "ErrorCode": "string", "ErrorDetail": "string", "Status": "string" }, "Result": { "ErrorCode": "string", "ErrorDetail": "string", "PrepareDuration": number, "PrepareStatus": "string", "TotalDuration": number, "TransferDuration": number, "TransferStatus": "string", "VerifyDuration": number, "VerifyStatus": "string" }, "StartTime": number, "Status": "string", "TaskExecutionArn": "string", "TaskMode": "string", "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "string", "S3BucketArn": "string", "Subdirectory": "string" } }, "ObjectVersionIds": "string", "OutputType": "string", "Overrides": { "Deleted": { "ReportLevel": "string" }, "Skipped": { "ReportLevel": "string" }, "Transferred": { "ReportLevel": "string" }, "Verified": { "ReportLevel": "string" } }, "ReportLevel": "string" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [BytesCompressed](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 압축(가능한 경우) 후 네트워크를 통해 전송하는 물리적 바이트 수입니다. 일반적으로 이 수치는 데이터를 압축할 수 없는 경우를 제외하고 [BytesTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesTransferred)보다 작습니다. 타입: Long ** [BytesTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 압축(가능한 경우) 전에 네트워크에 전송하는 바이트 수입니다. 네트워크를 통해 전송된 바이트 수는 [BytesCompressed](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesCompressed) 섹션을 참조하세요. 타입: Long ** [BytesWritten](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 실제로 대상 위치에 기록한 논리적 바이트 수입니다. 타입: Long ** [EndTime](#API_DescribeTaskExecution_ResponseSyntax) ** 전송 작업이 종료되는 시간입니다. 유형: 타임스탬프 ** [EstimatedBytesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 대상 위치에 기록할 것으로 예상되는 논리적 바이트 수입니다. 타입: Long ** [EstimatedFilesToDelete](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 대상 위치에서 삭제할 것으로 예상되는 파일, 객체, 디렉터리 수입니다. 소스에 없는 대상의 데이터를 삭제하도록 [작업을 구성](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)하지 않는 경우 값은 항상 `0`입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)의 경우이 카운터에는 파일 또는 객체만 포함됩니다. 디렉터리는 [EstimatedFoldersToDelete](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete)에 포함됩니다. 타입: Long ** [EstimatedFilesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** 네트워크를 통해 DataSync가 전송할 것으로 예상되는 파일, 객체, 디렉터리 수입니다. 이 값은 DataSync가 전송을 [준비](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)하는 동안 계산됩니다. 계산 방법은 주로 작업의 [전송 모드](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) 구성에 따라 달라집니다. + `TranserMode`이 `CHANGED`로 설정된 경우 - 계산은 소스와 대상의 위치 콘텐츠를 비교하고 이를 바탕으로 전송해야 하는 차이를 결정합니다. 차이점은 다음과 같습니다. + 소스 위치에 추가되거나 수정된 모든 항목입니다. + 두 위치 모두에 있고 초기 전송 후 대상에서 수정된 모든 항목([OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)가 `NEVER`로 설정된 경우 제외)입니다. + **(기본 작업 모드 전용)** DataSync가 삭제할 것으로 예상되는 항목의 수입니다([PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)이 `REMOVE`로 설정된 경우). + `TranserMode`가 `ALL`로 설정된 경우 - 계산은 DataSync가 소스 위치에서 찾는 항목만 기반으로 합니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)의 경우이 카운터에는 파일 또는 객체만 포함됩니다. 디렉터리는 [EstimatedFoldersToTransfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer)에 포함됩니다. 타입: Long ** [EstimatedFoldersToDelete](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 대상 위치에서 삭제할 것으로 예상되는 디렉터리 수입니다. 소스에 없는 대상의 데이터를 삭제하도록 [작업을 구성](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)하지 않는 경우 값은 항상 `0`입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 타입: Long ** [EstimatedFoldersToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 네트워크를 통해 전송할 것으로 예상되는 디렉터리 수입니다. 이 값은 DataSync가 전송할 디렉터리를 [준비](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)할 때 계산됩니다. 계산 방법은 주로 작업의 [전송 모드](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) 구성에 따라 달라집니다. + `TranserMode`이 `CHANGED`로 설정된 경우 - 계산은 소스와 대상의 위치 콘텐츠를 비교하고 이를 바탕으로 전송해야 하는 차이를 결정합니다. 차이점은 다음과 같습니다. + 소스 위치에 추가되거나 수정된 모든 항목입니다. + 두 위치 모두에 있고 초기 전송 후 대상에서 수정된 모든 항목([OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)가 `NEVER`로 설정된 경우 제외)입니다. + `TranserMode`가 `ALL`로 설정된 경우 - 계산은 DataSync가 소스 위치에서 찾는 항목만 기반으로 합니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 타입: Long ** [Excludes](#API_DescribeTaskExecution_ResponseSyntax) ** 전송 중 특정 데이터를 제외하는 필터 규칙의 목록입니다. 자세한 내용과 예제는 [DataSync에서 전송된 데이터 필터링](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)을 참조하십시오. 유형: [FilterRule](API_FilterRule.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대 항목 수는 1개입니다. ** [FilesDeleted](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 실제로 대상 위치에서 삭제한 파일, 객체, 디렉터리 수입니다. 소스에 없는 대상의 데이터를 삭제하도록 [작업을 구성](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)하지 않는 경우 값은 항상 `0`입니다. [향상된 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)의 경우이 카운터에는 파일 또는 객체만 포함됩니다. 디렉터리는 [FoldersDeleted](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersDeleted)에 포함됩니다. 타입: Long ** [FilesFailed](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 작업 실행 중에 준비, 전송, 확인 및 삭제하지 못하는 파일 또는 객체의 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 유형: [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md)객체 ** [FilesListed](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 사용자 위치에서 찾는 파일 또는 객체의 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 유형: [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md)객체 ** [FilesPrepared](#API_DescribeTaskExecution_ResponseSyntax) ** 소스 위치와 대상 위치를 비교한 후 DataSync가 전송을 시도할 파일 또는 객체의 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. [모든 데이터를 전송](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode)하도록 작업을 구성하는 경우 이 카운터를 사용할 수 없습니다. 이 시나리오에서 DataSync는 위치 간의 차이를 비교하지 않고 소스의 모든 데이터를 대상으로 복사합니다. 타입: Long ** [FilesSkipped](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 전송 중에 건너뛴 파일, 객체, 디렉터리의 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)의 경우이 카운터에는 파일 또는 객체만 포함됩니다. 디렉터리는 [FoldersSkipped](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersSkipped)에 포함됩니다. 타입: Long ** [FilesTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 네트워크를 통해 실제로 전송한 파일, 객체, 디렉터리 수입니다. 이 값은 작업 실행 중 소스에서 무언가를 읽어 네트워크를 통해 전송할 때 주기적으로 업데이트됩니다. DataSync가 무언가를 전송하지 못하면 이 값은 `EstimatedFilesToTransfer`보다 작을 수 있습니다. 경우에 따라 이 값은 `EstimatedFilesToTransfer`보다 클 수도 있습니다. 이 요소는 일부 위치 유형에서 구현 방식에 따라 달라지므로 이를 정확한 지표로서 사용하거나 작업 실행을 모니터링하는 데 사용하지 마세요. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)의 경우이 카운터에는 파일 또는 객체만 포함됩니다. 디렉터리는 [FoldersTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersTransferred)에 포함됩니다. 타입: Long ** [FilesVerified](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 전송 중에 확인한 파일, 객체, 디렉터리의 수입니다. [전송된 데이터만 확인하도록](https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html) 작업을 구성하면 DataSync는 전송에 실패한 일부 상황이나 파일에서 디렉터리를 확인하지 않습니다. [향상된 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)의 경우이 카운터에는 파일 또는 객체만 포함됩니다. 디렉터리는 [FoldersVerified](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersVerified)에 포함됩니다. 타입: Long ** [FoldersDeleted](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 대상 위치에서 실제로 삭제하는 디렉터리 수입니다. 소스에 없는 대상의 데이터를 삭제하도록 [작업을 구성](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)하지 않는 경우 값은 항상 `0`입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 타입: Long ** [FoldersFailed](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 작업 실행 중에 나열, 준비, 전송, 확인 및 삭제하지 못하는 디렉터리 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 유형: [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md)객체 ** [FoldersListed](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 사용자 위치에서 찾는 디렉터리 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 유형: [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md)객체 ** [FoldersPrepared](#API_DescribeTaskExecution_ResponseSyntax) ** 소스 위치와 대상 위치를 비교한 후 DataSync가 전송을 시도할 디렉터리 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. [모든 데이터를 전송](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode)하도록 작업을 구성하는 경우 이 카운터를 사용할 수 없습니다. 이 시나리오에서 DataSync는 위치 간의 차이를 비교하지 않고 소스의 모든 데이터를 대상으로 복사합니다. 타입: Long ** [FoldersSkipped](#API_DescribeTaskExecution_ResponseSyntax) ** 전송 중에 DataSync가 건너뛰는 디렉터리 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 타입: Long ** [FoldersTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 네트워크를 통해 실제로 전송하는 디렉터리 수입니다. 이 값은 작업 실행 중 소스에서 무언가를 읽어 네트워크를 통해 전송할 때 주기적으로 업데이트됩니다. DataSync가 무언가를 전송하지 못하면 이 값은 `EstimatedFoldersToTransfer`보다 작을 수 있습니다. 경우에 따라 이 값은 `EstimatedFoldersToTransfer`보다 클 수도 있습니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 타입: Long ** [FoldersVerified](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 전송 중에 확인하는 디렉터리 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 타입: Long ** [Includes](#API_DescribeTaskExecution_ResponseSyntax) ** 전송 중 특정 데이터를 포함하는 필터 규칙의 목록입니다. 자세한 내용과 예제는 [DataSync에서 전송된 데이터 필터링](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)을 참조하십시오. 유형: [FilterRule](API_FilterRule.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대 항목 수는 1개입니다. ** [LaunchTime](#API_DescribeTaskExecution_ResponseSyntax) ** 작업 실행이 실제로 시작되는 시간입니다. 대기열에 추가되지 않은 작업의 경우 `LaunchTime` 및 `StartTime`은 일반적으로 같습니다. 대기 중인 작업의 경우, 일반적으로 먼저 대기 중인 작업의 실행이 완료된 후에 새 작업이 시작되므로 `LaunchTime`이 `StartTime`보다 늦습니다. 유형: 타임스탬프 ** [ManifestConfig](#API_DescribeTaskExecution_ResponseSyntax) ** 전송할 파일 또는 객체를 나열하는 매니페스트의 구성입니다. 자세한 내용은 [Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) 섹션을 참조하세요. 유형: [ManifestConfig](API_ManifestConfig.md)객체 ** [Options](#API_DescribeTaskExecution_ResponseSyntax) ** 전송 작업이 구성된 방식을 나타냅니다. 이러한 옵션에는 DataSync가 전송 중에 파일, 객체 및 관련 메타데이터 처리 방법이 포함됩니다. 또한 다른 옵션 중에서 데이터 무결성을 확인하고, 작업에 대한 대역폭 제한 설정 방법을 지정할 수 있습니다. 각 옵션에는 기본값이 있습니다. 필요한 경우가 아니라면 [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)을 호출하기 전에 이러한 옵션을 구성하지 않아도 됩니다. 각 작업 실행에 대해 작업 옵션을 재정의할 수도 있습니다. 예를 들어 개별 실행에 대해 `LogLevel`을 조정할 수 있습니다. 유형: [Options](API_Options.md)객체 ** [ReportResult](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 전송에 대한 전체 [작업 보고서](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)를 생성했는지 여부를 나타냅니다. 유형: [ReportResult](API_ReportResult.md)객체 ** [Result](#API_DescribeTaskExecution_ResponseSyntax) ** 작업 실행 결과입니다. 유형: [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md)객체 ** [StartTime](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 작업 실행을 시작하기 위해 요청을 전송하는 시간입니다. 대기열에 추가되지 않은 작업의 경우 `LaunchTime` 및 `StartTime`은 일반적으로 같습니다. 대기 중인 작업의 경우, 일반적으로 먼저 대기 중인 작업의 실행이 완료된 후에 새 작업이 시작되므로 `LaunchTime`이 `StartTime`보다 늦습니다. 유형: 타임스탬프 ** [Status](#API_DescribeTaskExecution_ResponseSyntax) ** 작업 실행 상태입니다. 작업 실행 상태에 대한 자세한 내용은 [작업 실행 상태](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)를 참조하세요. 타입: 문자열 유효 값: `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR` ** [TaskExecutionArn](#API_DescribeTaskExecution_ResponseSyntax) ** 정보를 원했던 작업 실행의 ARN입니다. `TaskExecutionArn`은 계층적이며 실행된 작업의 `TaskArn`를 포함합니다. 예를 들어, ARN `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b`이 있는 `TaskExecution`값은 ARN으로 작업 `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2`을 실행했습니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` ** [TaskMode](#API_DescribeTaskExecution_ResponseSyntax) ** 사용 중인 작업 모드입니다. 자세한 내용은 [데이터 전송을 위한 작업 모드 선택](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)을 참조하세요. 타입: 문자열 유효 값: `BASIC | ENHANCED` ** [TaskReportConfig](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync 전송에 대한 세부 정보를 제공하는 작업 보고서 구성입니다. 자세한 내용은 [작업 보고서 생성](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)을 참조하십시오. 타입: [TaskReportConfig](API_TaskReportConfig.md) 객체 ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](CommonErrors.md)섹션을 참조하세요. ** InternalException ** 이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다. HTTP 상태 코드: 500 ** InvalidRequestException ** 이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다. HTTP 상태 코드: 400 ## 예 ### 예 요청 이 예제는 `DescribeTaskExecution`요청을 보여줍니다. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1" } ``` ### 확장 모드 작업 실행에 대한 샘플 응답 1 다음 예시에서는 확장 모드를 사용하는 DataSync 작업 실행을 설명합니다. 해당 실행은 또한 제외 및 포함 필터를 사용하여 특정 데이터를 전송합니다. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "Status": "SUCCESS", "Options": { "VerifyMode": "ONLY_FILES_TRANSFERRED", "OverwriteMode": "ALWAYS", "Atime": "BEST_EFFORT", "Mtime": "PRESERVE", "Uid": "NONE", "Gid": "NONE", "PreserveDeletedFiles": "PRESERVE", "PreserveDevices": "NONE", "PosixPermissions": "NONE", "BytesPerSecond": -1, "TaskQueueing": "ENABLED", "LogLevel": "BASIC", "TransferMode": "CHANGED", "SecurityDescriptorCopyFlags": "NONE", "ObjectTags": "PRESERVE" }, "Excludes": [{ "FilterType": "SIMPLE_PATTERN", "Value": "/archive-files" }], "Includes": [{ "FilterType": "SIMPLE_PATTERN", "Value": "/files" }], "StartTime": "2024-10-16T11:19:56.844000-04:00", "EstimatedFilesToTransfer": 7, "EstimatedFoldersToTransfer": 2, "EstimatedBytesToTransfer": 30, "FilesTransferred": 7, "FoldersTransferred": 2, "BytesWritten": 30, "BytesTransferred": 30, "BytesCompressed": 30, "Result": { "PrepareDuration": 0, "PrepareStatus": "SUCCESS", "TotalDuration": 3310, "TransferDuration": 0, "TransferStatus": "SUCCESS", "VerifyDuration": 0, "VerifyStatus": "SUCCESS" }, "FilesDeleted": 0, "FilesSkipped": 0, "FilesVerified": 7, "EstimatedFilesToDelete": 0, "TaskMode": "ENHANCED", "FilesPrepared": 7, "FilesListed": { "AtSource": 7, "AtDestinationForDelete": 0 }, "FilesFailed": { "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 }, "FoldersDeleted": 0, "FoldersSkipped": 0, "FoldersVerified": 2, "FoldersPrepared": 2, "FoldersListed": { "AtSource": 2, "AtDestinationForDelete": 0 }, "FoldersFailed": { "List": 0, "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 } } ``` ### 확장 모드 작업 실행에 대한 샘플 응답 2 다음 예시에서는 확장 모드를 사용하는 또 다른 DataSync 작업 실행을 설명합니다. 이 경우 해당 실행은 필터 대신 매니페스트를 사용하여 특정 데이터를 전송합니다. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "Status": "SUCCESS", "Options": { "VerifyMode": "ONLY_FILES_TRANSFERRED", "OverwriteMode": "ALWAYS", "Atime": "BEST_EFFORT", "Mtime": "PRESERVE", "Uid": "NONE", "Gid": "NONE", "PreserveDeletedFiles": "PRESERVE", "PreserveDevices": "NONE", "PosixPermissions": "NONE", "BytesPerSecond": -1, "TaskQueueing": "ENABLED", "LogLevel": "TRANSFER", "TransferMode": "CHANGED", "SecurityDescriptorCopyFlags": "NONE", "ObjectTags": "PRESERVE" }, "Excludes": [], "Includes": [], "ManifestConfig": { "Action": "TRANSFER", "Format": "CSV", "S3AccessRoleArn": "arn:aws:iam::111222333444:role/service-role/DataSyncS3ManifestAccess", "S3Bucket": "arn:aws:s3:::manifests-datasync", "VersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG", "Source": { "S3": { "ManifestObjectPath": "manifest-folder/manifest-versioned-files", "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-manifest-role/DataSyncS3ManifestAccess", "S3BucketArn": "arn:aws:s3:::manifests-datasync", "ManifestObjectVersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG" } } }, "StartTime": "2024-10-16T09:29:56.757000-04:00", "EstimatedFilesToTransfer": 1, "EstimatedFoldersToTransfer": 0, "EstimatedBytesToTransfer": 6, "FilesTransferred": 1, "FoldersTransferred": 1, "BytesWritten": 6, "BytesTransferred": 6, "BytesCompressed": 6, "Result": { "PrepareDuration": 0, "PrepareStatus": "SUCCESS", "TotalDuration": 3089, "TransferDuration": 0, "TransferStatus": "SUCCESS", "VerifyDuration": 0, "VerifyStatus": "SUCCESS" }, "TaskReportConfig": { "Destination": { "S3": { "Subdirectory": "reports/", "S3BucketArn": "arn:aws:s3:::my-task-report", "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-task-report-role/DataSyncTaskReportS3BucketAccess" } }, "OutputType": "STANDARD", "ReportLevel": "SUCCESSES_AND_ERRORS", "ObjectVersionIds": "INCLUDE" }, "FilesDeleted": 0, "FilesSkipped": 0, "FilesVerified": 1, "ReportResult": { "Status": "SUCCESS" }, "EstimatedFilesToDelete": 0, "TaskMode": "ENHANCED", "FilesPrepared": 1, "FilesListed": { "AtSource": 1, "AtDestinationForDelete": 0 }, "FilesFailed": { "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 }, "FoldersDeleted": 0, "FoldersSkipped": 0, "FoldersVerified": 0, "FoldersPrepared": 0, "FoldersListed": { "AtSource": 0, "AtDestinationForDelete": 0 }, "FoldersFailed": { "List": 0, "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 } } ``` ### 기본 모드 작업 실행에 대한 샘플 응답 다음 예시에서는 기본 모드를 사용하는 DataSync 작업 실행을 설명합니다. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "BytesCompressed": 3500, "BytesTransferred": 5000, "BytesWritten": 5000, "EstimatedBytesToTransfer": 5000, "EstimatedFilesToDelete": 10, "EstimatedFilesToTransfer": 100, "FilesDeleted": 10, "FilesSkipped": 0, "FilesTransferred": 100, "FilesVerified": 100, "Result": { "PrepareDuration": 100, "PrepareStatus": "SUCCESS", "TransferDuration": 60, "TransferStatus": "SUCCESS", "VerifyDuration": 30, "VerifyStatus": "SUCCESS" }, "StartTime": "2024-10-16T11:19:56.844000-04:00", "Status": "SUCCESS", "OverrideOptions": { "Atime": "BEST_EFFORT", "BytesPerSecond": "1000", "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-datasync-role", "S3BucketArn": "arn:aws:s3:::my-task-reports-bucket/*", "Subdirectory": "reports" } }, "ObjectVersionIds": "INCLUDE", "OutputType": "STANDARD", "Overrides": { "Deleted": { "ReportLevel": "ERRORS_ONLY" }, "Skipped": { "ReportLevel": "SUCCESSES_AND_ERRORS" }, "Transferred": { "ReportLevel": "ERRORS_ONLY" }, "Verified": { "ReportLevel": "ERRORS_ONLY" } }, "ReportLevel": "ERRORS_ONLY" } } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeTaskExecution) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTaskExecution) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTaskExecution) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTaskExecution) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTaskExecution) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTaskExecution) # ListAgents 요청에 AWS 리전 지정된의 AWS 계정 에 속하는 AWS DataSync 에이전트 목록을 반환합니다. 페이지 매김을 사용하면 응답에서 반환되는 상담원 수를 줄일 수 있습니다. 응답에서 상담원 목록이 잘린 경우, 응답에는 다음 상담원 페이지를 가져오도록 요청에서 지정할 수 있는 마커가 포함됩니다. `ListAgents`은 결국 일관성을 갖습니다. 즉, 작업을 실행한 결과에 에이전트를 방금 만들거나 삭제했다는 사실이 반영되지 않을 수 있습니다. 예컨대, [CreateAgent](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateAgent.html)를 사용하여 에이전트를 만든 다음 즉시 `ListAgents`를 실행하면, 해당 에이전트가 목록에 바로 표시되지 않을 수 있습니다. 이와 같은 상황에서는 [DescribeAgent](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeAgent.html)를 사용하여 에이전트가 생성(또는 삭제) 되었는지 언제든지 확인할 수 있습니다. ## 구문 요청 ``` { "MaxResults": number, "NextToken": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [MaxResults](#API_ListAgents_RequestSyntax) ** 응답에 표시할 수 있는 최대 DataSync 에이전트 수를 지정합니다. 기본적으로 응답에는 최대 100개의 에이전트가 표시됩니다. 타입: Integer 유효 범위: 최소값은 0입니다. 최댓값은 100입니다. 필수 여부: 아니요 ** [NextToken](#API_ListAgents_RequestSyntax) ** 응답에서 다음 결과 목록의 시작 위치를 표시하는 불투명 문자열을 지정합니다. 타입: 문자열 길이 제약 조건: 최대 길이는 65,535입니다. 패턴: `[a-zA-Z0-9=_-]+` 필수 여부: 아니요 ## 응답 구문 ``` { "Agents": [ { "AgentArn": "string", "Name": "string", "Platform": { "Version": "string" }, "Status": "string" } ], "NextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Agents](#API_ListAgents_ResponseSyntax) ** 요청에 AWS 리전 지정된의 AWS 계정 에 있는 DataSync 에이전트 목록입니다. 목록은 에이전트의 Amazon 리소스 이름(ARN) 순으로 정렬됩니다. 타입: [AgentListEntry](API_AgentListEntry.md)객체 배열 ** [NextToken](#API_ListAgents_ResponseSyntax) ** 응답에서 다음 결과 목록을 시작할 위치를 표시하는 불투명한 문자열입니다. 타입: 문자열 길이 제약 조건: 최대 길이는 65,535입니다. 패턴: `[a-zA-Z0-9=_-]+` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/ListAgents) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListAgents) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListAgents) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListAgents) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListAgents) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListAgents) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListAgents) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListAgents) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListAgents) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListAgents) # ListLocations 소스 및 목적지 위치의 목록을 반환합니다. 응답에 반환된 위치보다 많은 위치가 있는 경우,(즉, 응답에서 상담원의 잘린 목록만 반환되는 경우) 응답에는 다음 위치 페이지를 가져오기 위한 요청에서 지정할 수 있는 토큰이 포함됩니다. ## 구문 요청 ``` { "Filters": [ { "Name": "string", "Operator": "string", "Values": [ "string" ] } ], "MaxResults": number, "NextToken": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [Filters](#API_ListLocations_RequestSyntax) ** API 필터를 사용하여 `ListLocations`에 의해 반환되는 리소스 목록의 범위를 좁힐 수 있습니다. 예컨대, 특정 소스 위치에서 모든 작업을 검색하려면 필터 이름 `LocationType S3`및 `Operator Equals`과 함께 `ListLocations`을 사용할 수 있습니다. 타입: [LocationFilter](API_LocationFilter.md)객체 배열 필수 여부: 아니요 ** [MaxResults](#API_ListLocations_RequestSyntax) ** 반환할 위치의 최대수. 타입: Integer 유효 범위: 최소값은 0입니다. 최댓값은 100입니다. 필수 여부: 아니요 ** [NextToken](#API_ListLocations_RequestSyntax) ** 다음 위치 목록을 시작할 위치를 표시하는 불투명한 문자열입니다. 타입: 문자열 길이 제약 조건: 최대 길이는 65,535입니다. 패턴: `[a-zA-Z0-9=_-]+` 필수 여부: 아니요 ## 응답 구문 ``` { "Locations": [ { "LocationArn": "string", "LocationUri": "string" } ], "NextToken": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [Locations](#API_ListLocations_ResponseSyntax) ** 위치 목록이 포함된 배열입니다. 타입: [LocationListEntry](API_LocationListEntry.md)객체 배열 ** [NextToken](#API_ListLocations_ResponseSyntax) ** 다음 위치 목록 반환을 시작할 위치를 표시하는 불투명 문자열입니다. 타입: 문자열 길이 제약 조건: 최대 길이는 65,535입니다. 패턴: `[a-zA-Z0-9=_-]+` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/ListLocations) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListLocations) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListLocations) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListLocations) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListLocations) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListLocations) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListLocations) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListLocations) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListLocations) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListLocations) # ListTagsForResource AWS 리소스와 연결된 모든 태그를 반환합니다. ## 구문 요청 ``` { "MaxResults": number, "NextToken": "string", "ResourceArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [MaxResults](#API_ListTagsForResource_RequestSyntax) ** 귀하가 응답에서 몇 개의 결과를 원하는지를 지정합니다. 유형: 정수 유효 범위: 최소값은 0입니다. 최댓값은 100입니다. 필수 여부: 아니요 ** [NextToken](#API_ListTagsForResource_RequestSyntax) ** 응답에서 다음 결과 목록의 시작 위치를 표시하는 불투명 문자열을 지정합니다. 타입: 문자열 길이 제약 조건: 최대 길이는 65,535입니다. 패턴: `[a-zA-Z0-9=_-]+` 필수 여부: 아니요 ** [ResourceArn](#API_ListTagsForResource_RequestSyntax) ** 태그 정보를 사용하려는 리소스의 Amazon 리소스 이름(ARN)을 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:(((agent|task|location)/(agent|task|loc)-[a-z0-9]{17}(/execution/exec-[a-f0-9]{17})?)|(system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?))$` 필수 여부: 예 ## 응답 구문 ``` { "NextToken": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [NextToken](#API_ListTagsForResource_ResponseSyntax) ** 응답에서 다음 결과 목록을 시작할 위치를 표시하는 불투명한 문자열입니다. 타입: 문자열 길이 제약 조건: 최대 길이는 65,535입니다. 패턴: `[a-zA-Z0-9=_-]+` ** [Tags](#API_ListTagsForResource_ResponseSyntax) ** 지정된 리소스에 적용되는 태그의 배열입니다. 타입: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대 항목 수는 55개입니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/ListTagsForResource) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTagsForResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTagsForResource) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTagsForResource) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTagsForResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTagsForResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTagsForResource) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTagsForResource) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTagsForResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTagsForResource) # ListTaskExecutions AWS DataSync 전송 작업에 대한 실행 목록을 반환합니다. ## 구문 요청 ``` { "MaxResults": number, "NextToken": "string", "TaskArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [MaxResults](#API_ListTaskExecutions_RequestSyntax) ** 응답에서 원하는 결과 수를 지정합니다. 유형: 정수 유효 범위: 최소값은 0입니다. 최댓값은 100입니다. 필수 여부: 아니요 ** [NextToken](#API_ListTaskExecutions_RequestSyntax) ** 응답에서 다음 결과 목록이 시작하는 위치를 표시하는 불투명 문자열을 지정합니다. 유형: 문자열 길이 제약 조건: 최대 길이는 65,535입니다. 패턴: `[a-zA-Z0-9=_-]+` 필수 여부: 아니요 ** [TaskArn](#API_ListTaskExecutions_RequestSyntax) ** 실행 정보를 원하는 작업의 Amazon 리소스 이름(ARN)을 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$` 필수 여부: 아니요 ## 응답 구문 ``` { "NextToken": "string", "TaskExecutions": [ { "Status": "string", "TaskExecutionArn": "string", "TaskMode": "string" } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [NextToken](#API_ListTaskExecutions_ResponseSyntax) ** 응답에서 다음 결과 목록을 시작할 위치를 표시하는 불투명한 문자열입니다. 타입: 문자열 길이 제약 조건: 최대 길이는 65,535입니다. 패턴: `[a-zA-Z0-9=_-]+` ** [TaskExecutions](#API_ListTaskExecutions_ResponseSyntax) ** 작업의 실행 목록입니다. 타입: [TaskExecutionListEntry](API_TaskExecutionListEntry.md) 객체 배열 ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/ListTaskExecutions) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTaskExecutions) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTaskExecutions) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTaskExecutions) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTaskExecutions) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTaskExecutions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTaskExecutions) # ListTasks 생성한 AWS DataSync 작업 목록을 반환합니다. ## 구문 요청 ``` { "Filters": [ { "Name": "string", "Operator": "string", "Values": [ "string" ] } ], "MaxResults": number, "NextToken": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [Filters](#API_ListTasks_RequestSyntax) ** API 필터를 사용하여 `ListTasks`에 의해 반환되는 리소스 목록의 범위를 좁힐 수 있습니다. 예를 들어 특정 소스 위치의 모든 작업을 검색하려면 필터 이름 `LocationId`(와)과 해당 위치의 ARN `Operator Equals`(을)를 `ListTasks`(와)과 함께 사용할 수 있습니다. 타입: [TaskFilter](API_TaskFilter.md)객체 배열 필수: 아니요 ** [MaxResults](#API_ListTasks_RequestSyntax) ** 반환할 최대 열 수입니다. 유형: 정수 유효 범위: 최소값은 0입니다. 최댓값은 100입니다. 필수 여부: 아니요 ** [NextToken](#API_ListTasks_RequestSyntax) ** 다음 작업 목록을 시작할 위치를 나타내는 불투명한 문자열입니다. 유형: 문자열 길이 제약 조건: 최대 길이는 65,535입니다. 패턴: `[a-zA-Z0-9=_-]+` 필수 여부: 아니요 ## 응답 구문 ``` { "NextToken": "string", "Tasks": [ { "Name": "string", "Status": "string", "TaskArn": "string", "TaskMode": "string" } ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [NextToken](#API_ListTasks_ResponseSyntax) ** 다음 작업 목록 반환을 시작할 위치를 나타내는 불투명한 문자열입니다. 유형: 문자열 길이 제약 조건: 최대 길이는 65,535입니다. 패턴: `[a-zA-Z0-9=_-]+` ** [Tasks](#API_ListTasks_ResponseSyntax) ** 반환되는 모든 작업의 목록입니다. 타입: [TaskListEntry](API_TaskListEntry.md) 객체 배열 ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/ListTasks) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTasks) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTasks) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTasks) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTasks) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTasks) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTasks) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTasks) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTasks) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTasks) # StartTaskExecution AWS DataSync 전송 작업을 시작합니다. 각 작업에 대해 한 번에 하나의 작업 실행만 수행할 수 있습니다. 작업 실행에는 여러 단계가 있습니다. 자세한 내용은 [작업 실행 상태](https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#understand-task-execution-statuses)를 참조하십시오. **중요** Amazon S3 위치와 데이터를 주고받을 계획이라면 시작하기 전에 [DataSync가 S3 요청 요금에 미치는 영향](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) 및 [DataSync 요금 페이지](https://aws.amazon.com/datasync/pricing/)를 검토하십시오. ## 구문 요청 ``` { "Excludes": [ { "FilterType": "string", "Value": "string" } ], "Includes": [ { "FilterType": "string", "Value": "string" } ], "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "string" } } }, "OverrideOptions": { "Atime": "string", "BytesPerSecond": number, "Gid": "string", "LogLevel": "string", "Mtime": "string", "ObjectTags": "string", "OverwriteMode": "string", "PosixPermissions": "string", "PreserveDeletedFiles": "string", "PreserveDevices": "string", "SecurityDescriptorCopyFlags": "string", "TaskQueueing": "string", "TransferMode": "string", "Uid": "string", "VerifyMode": "string" }, "Tags": [ { "Key": "string", "Value": "string" } ], "TaskArn": "string", "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "string", "S3BucketArn": "string", "Subdirectory": "string" } }, "ObjectVersionIds": "string", "OutputType": "string", "Overrides": { "Deleted": { "ReportLevel": "string" }, "Skipped": { "ReportLevel": "string" }, "Transferred": { "ReportLevel": "string" }, "Verified": { "ReportLevel": "string" } }, "ReportLevel": "string" } } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [Excludes](#API_StartTaskExecution_RequestSyntax) ** 작업에서 제외할 파일을 결정하는 필터 규칙 목록을 지정합니다. 목록에는 제외할 패턴으로 구성된 단일 필터 문자열이 포함됩니다. 패턴은 "\$1"(즉, 파이프)로 구분됩니다(예: `"/folder1|/folder2"`). 유형: [FilterRule](API_FilterRule.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대 항목 수는 1개입니다. 필수 여부: 아니요 ** [Includes](#API_StartTaskExecution_RequestSyntax) ** 작업 실행 중 포함시킬 파일을 결정하는 필터 규칙 목록을 지정합니다. 패턴에는 포함시킬 패턴으로 구성된 단일 필터 문자열을 포함해야 합니다. 패턴은 "\$1"(즉, 파이프)로 구분됩니다(예: `"/folder1|/folder2"`). 유형: [FilterRule](API_FilterRule.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대 항목 수는 1개입니다. 필수 여부: 아니요 ** [ManifestConfig](#API_StartTaskExecution_RequestSyntax) ** DataSync에서 전송하려는 파일 또는 객체 목록인 매니페스트를 구성합니다. 자세한 내용과 구성 예제는 [Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) 섹션을 참조하세요. 이 파라미터를 사용할 때는 발신자 자격 증명(DataSync를 사용하는 역할)에 `iam:PassRole` 권한이 있어야 합니다. [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess) 정책에는 이 권한이 포함됩니다. 매니페스트 구성을 제거하려면 이 파라미터를 빈 값으로 지정합니다. 유형: [ManifestConfig](API_ManifestConfig.md)객체 필수 여부: 아니요 ** [OverrideOptions](#API_StartTaskExecution_RequestSyntax) ** 전송 작업이 구성된 방식을 나타냅니다. 이러한 옵션에는 DataSync가 전송 중에 파일, 객체 및 관련 메타데이터 처리 방법이 포함됩니다. 또한 다른 옵션 중에서 데이터 무결성을 확인하고, 작업에 대한 대역폭 제한 설정 방법을 지정할 수 있습니다. 각 옵션에는 기본값이 있습니다. 필요한 경우가 아니라면 [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)을 호출하기 전에 이러한 옵션을 구성하지 않아도 됩니다. 각 작업 실행에 대해 작업 옵션을 재정의할 수도 있습니다. 예를 들어 개별 실행에 대해 `LogLevel`을 조정할 수 있습니다. 유형: [Options](API_Options.md)객체 필수 여부: 아니요 ** [Tags](#API_StartTaskExecution_RequestSyntax) ** 작업 실행을 나타내는 Amazon 리소스 이름(ARN)에 적용할 태그를 지정합니다. 태그**는 DataSync 리소스를 관리, 필터링 및 검색하는 데 도움이 되는 키-값 페어입니다. 유형: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ** [TaskArn](#API_StartTaskExecution_RequestSyntax) ** 시작할 작업의 Amazon 리소스 이름(ARN)을 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$` 필수 여부: 예 ** [TaskReportConfig](#API_StartTaskExecution_RequestSyntax) ** DataSync 전송에 대한 세부 정보를 제공하는 작업 보고서를 구성할 방법을 지정합니다. 자세한 내용은 [Monitoring your DataSync transfers with task reports](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) 섹션을 참조하세요. 이 파라미터를 사용할 때는 발신자 자격 증명(DataSync를 사용하는 역할)에 `iam:PassRole` 권한이 있어야 합니다. [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess) 정책에는 이 권한이 포함됩니다. 작업 보고서 구성을 제거하려면 이 파라미터를 비어 있음으로 지정합니다. 유형: [TaskReportConfig](API_TaskReportConfig.md)객체 필수 항목 여부: 아니요 ## 응답 구문 ``` { "TaskExecutionArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [TaskExecutionArn](#API_StartTaskExecution_ResponseSyntax) ** 수행 중인 작업 실행의 ARN입니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](CommonErrors.md)섹션을 참조하세요. ** InternalException ** 이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다. HTTP 상태 코드: 500 ** InvalidRequestException ** 이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다. HTTP 상태 코드: 400 ## 예 ### 예 요청 다음 예제에서는 지정된 작업의 기본 옵션을 사용하여 작업 실행을 시작합니다. ``` { "OverrideOptions": { "Atime": "BEST_EFFORT", "BytesPerSecond": 1000, "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ### 샘플 응답 이 예제에서는 StartTaskExecution의 한 가지 사용법을 보여줍니다. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f" } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/StartTaskExecution) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/StartTaskExecution) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/StartTaskExecution) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/StartTaskExecution) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/StartTaskExecution) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/StartTaskExecution) # TagResource AWS 리소스에 *태그를* 적용합니다. 태그는 귀하의 리소스를 관리, 필터링 및 검색하는 데 도움이 되는 키-값 쌍입니다. 여기에는 위치, 작업 및 작업 실행과 같은 AWS DataSync 리소스가 포함됩니다. ## 구문 요청 ``` { "ResourceArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [ResourceArn](#API_TagResource_RequestSyntax) ** 태그를 적용할 리소스의 Amazon 리소스 이름(ARN) 을 지정합니다. 타입: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:(((agent|task|location)/(agent|task|loc)-[a-z0-9]{17}(/execution/exec-[a-f0-9]{17})?)|(system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?))$` 필수 여부: 예 ** [Tags](#API_TagResource_RequestSyntax) ** 귀하가 리소스에 적용하고자 하는 태그를 지정합니다. 타입: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/TagResource) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/TagResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TagResource) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/TagResource) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TagResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/TagResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/TagResource) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/TagResource) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/TagResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TagResource) # UntagResource AWS 리소스에서 태그를 제거합니다. ## 구문 요청 ``` { "Keys": [ "string" ], "ResourceArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [Keys](#API_UntagResource_RequestSyntax) ** 태에서 제거하려는 키를 지정합니다. 타입: 문자열 배열 배열 멤버: 최소수는 1개입니다. 최대수 50개. 길이 제약: 최소 길이 1. 최대 길이는 256입니다. 패턴: `^[a-zA-Z0-9\s+=._:/-]+$` 필수 여부: 예 ** [ResourceArn](#API_UntagResource_RequestSyntax) ** 태그를 제거할 리소스의 Amazon 리소스 이름(ARN)을 지정합니다. 타입: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:(((agent|task|location)/(agent|task|loc)-[a-z0-9]{17}(/execution/exec-[a-f0-9]{17})?)|(system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?))$` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/UntagResource) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UntagResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UntagResource) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UntagResource) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UntagResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UntagResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UntagResource) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UntagResource) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UntagResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UntagResource) # UpdateAgent AWS DataSync 에이전트의 이름을 업데이트합니다. ## 구문 요청 ``` { "AgentArn": "string", "Name": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AgentArn](#API_UpdateAgent_RequestSyntax) ** 업데이트할 에이전트의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이는 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}$` 필수 여부: 예 ** [Name](#API_UpdateAgent_RequestSyntax) ** 에이전트를 구성하기 위해 사용하고자 하는 이름. 유형: 문자열 길이 제약: 최소 길이는 0. 최대 길이는 256입니다. 패턴: `^[a-zA-Z0-9\s+=._:@/-]+$` 필수 여부: 아니요 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/UpdateAgent) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateAgent) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateAgent) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateAgent) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateAgent) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateAgent) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateAgent) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateAgent) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateAgent) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateAgent) # UpdateLocationAzureBlob 사용 중인 Microsoft Azure Blob 스토리지 전송 위치의 다음 구성을 수정합니다 AWS DataSync. 자세한 내용은 [Azure Blob 스토리지를 사용하는 DataSync 전송 구성](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html)을 참조하세요. ## 구문 요청 ``` { "AccessTier": "string", "AgentArns": [ "string" ], "AuthenticationType": "string", "BlobType": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "LocationArn": "string", "SasConfiguration": { "Token": "string" }, "Subdirectory": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AccessTier](#API_UpdateLocationAzureBlob_RequestSyntax) ** 객체 또는 파일이 전송되어야 할 액세스 계층을 지정합니다. 이는 해당 위치를 전송 대상으로 사용하는 경우에만 적용됩니다. 자세한 내용은 [액세스 티어](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers)를 참조하세요. 타입: 문자열 유효 값: `HOT | COOL | ARCHIVE` 필수 여부: 아니요 ** [AgentArns](#API_UpdateLocationAzureBlob_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_UpdateLocationAzureBlob_RequestSyntax) ** DataSync가 Azure Blob Storage에 액세스하는 데 사용하는 인증 방법을 지정합니다. DataSync는 공유 액세스 서명(SAS)을 사용하여 블롭 스토리지에 액세스할 수 있습니다. 타입: 문자열 유효 값: `SAS | NONE` 필수 여부: 아니요 ** [BlobType](#API_UpdateLocationAzureBlob_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_UpdateLocationAzureBlob_RequestSyntax) ** DataSync 관리형 보안 암호의 구성 정보를 지정하며, 여기에는 DataSync가 특정 전송 위치에 액세스하는 데 사용하는 인증 토큰 또는 자격 증명 세트와 고객 관리형 AWS KMS key가 포함됩니다. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 필수 여부: 아니요 ** [CustomSecretConfig](#API_UpdateLocationAzureBlob_RequestSyntax) ** DataSync가 특정 전송 위치에 액세스하는 데 사용하는 인증 토큰 또는 자격 증명 세트, 보안 암호에 대한 액세스를 제공하는 고객 관리형 AWS Identity and Access Management (IAM) 역할과 같은 고객 관리형 보안 암호의 구성 정보를 지정합니다. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 필수 여부: 아니요 ** [LocationArn](#API_UpdateLocationAzureBlob_RequestSyntax) ** 업데이트하는 Azure Blob Storage 전송 위치의 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}$` 필수 여부: 예 ** [SasConfiguration](#API_UpdateLocationAzureBlob_RequestSyntax) ** DataSync가 Azure Blob Storage에 액세스할 수 있도록 허용하는 SAS 구성을 지정합니다. 유형: [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md)객체 필수 여부: 아니요 ** [Subdirectory](#API_UpdateLocationAzureBlob_RequestSyntax) ** 컨테이너의 가상 디렉터리로의 전송을 제한하려는 경우(예:`/my/images`) 경로 세그먼트를 지정합니다. 유형: 문자열 길이 제약: 최대 길이 1024. 패턴: `^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$` 필수 여부: 아니요 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/UpdateLocationAzureBlob) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationAzureBlob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationAzureBlob) # UpdateLocationEfs 사용 중인 Amazon EFS 전송 위치의 다음 구성 파라미터를 수정합니다 AWS DataSync. 자세한 내용은 [Amazon EFS를 사용하는 DataSync 전송 구성](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html)을 참조하세요. ## 구문 요청 ``` { "AccessPointArn": "string", "FileSystemAccessRoleArn": "string", "InTransitEncryption": "string", "LocationArn": "string", "Subdirectory": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AccessPointArn](#API_UpdateLocationEfs_RequestSyntax) ** DataSync가 Amazon EFS 파일 시스템을 탑재하는 데 사용하는 액세스 포인트의 Amazon 리소스 이름(ARN)을 지정합니다. 자세한 내용은 [제한된 Amazon EFS 파일 시스템 액세스](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam) 섹션을 참조하세요. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `(^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$)|(^$)` 필수 여부: 아니요 ** [FileSystemAccessRoleArn](#API_UpdateLocationEfs_RequestSyntax) ** DataSync가 Amazon EFS 파일 시스템에 액세스할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할을 지정합니다. 이 역할 생성에 대한 자세한 내용은 [Amazon EFS 파일 시스템 액세스를 위한 DataSync IAM 역할 생성](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role)을 참조하세요. 유형: 문자열 길이 제약: 최대 길이 2048. 패턴: `(^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$)|(^$)` 필수 여부: 아니요 ** [InTransitEncryption](#API_UpdateLocationEfs_RequestSyntax) ** DataSync가 Amazon EFS 파일 시스템으로 또는 파일 시스템에서 데이터를 전송할 때 Transport Layer Security(TLS) 1.2 암호화를 사용할지 여부를 지정합니다. `AccessPointArn`을 사용하여 액세스 지점을 지정하거나 `FileSystemAccessRoleArn`을 사용하여 IAM 역할을 지정하는 경우 이 파라미터를 `TLS1_2`로 설정해야 합니다. 타입: 문자열 유효 값: `NONE | TLS1_2` 필수 여부: 아니요 ** [LocationArn](#API_UpdateLocationEfs_RequestSyntax) ** 업데이트하려는 Amazon EFS 전송 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ** [Subdirectory](#API_UpdateLocationEfs_RequestSyntax) ** Amazon EFS 파일 시스템에 대한 탑재 경로를 지정합니다. DataSync가 파일 시스템의 데이터를 읽거나 쓰는 위치입니다(소스 위치인지 대상 위치인지에 따라 다름). 기본적으로 DataSync는 루트 디렉터리(또는 사용자가 `AccessPointArn`을 사용하여 루트 디렉터리를 제공하는 경우 [액세스 포인트](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html))를 사용합니다. 전방향 슬래시(예: `/path/to/folder`)를 사용하여 하위 디렉터리를 포함할 수도 있습니다. 유형: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` 필수 여부: 아니요 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/UpdateLocationEfs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationEfs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationEfs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationEfs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationEfs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationEfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationEfs) # UpdateLocationFsxLustre 사용 중인 Amazon FSx for Lustre 전송 위치의 다음 구성 파라미터를 수정합니다 AWS DataSync. 자세한 내용은 [Amazon FSx for Lustre를 사용하는 DataSync 전송 구성](https://docs.aws.amazon.com/datasync/latest/userguide/create-lustre-location.html)을 참조하세요. ## 구문 요청 ``` { "LocationArn": "string", "Subdirectory": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_UpdateLocationFsxLustre_RequestSyntax) ** 업데이트하려는 FSx for Lustre 전송 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ** [Subdirectory](#API_UpdateLocationFsxLustre_RequestSyntax) ** FSx for Lustre 파일 시스템에 대한 탑재 경로를 지정합니다. 경로에는 하위 디렉터리가 포함될 수 있습니다. 위치가 소스로 사용되는 경우 DataSync는 마운트 경로에서 데이터를 읽습니다. 위치가 대상으로 사용되는 경우 DataSync는 데이터를 탑재 경로에 기록합니다. 이 파라미터를 포함하지 않으면 DataSync는 파일 시스템의 루트 디렉터리(`/`)를 사용합니다. 유형: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` 필수 여부: 아니요 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/UpdateLocationFsxLustre) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxLustre) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxLustre) # UpdateLocationFsxOntap 사용 중인 Amazon FSx for NetApp ONTAP 전송 위치의 다음 구성 파라미터를 수정합니다 AWS DataSync. 자세한 내용은 [FSx for ONTAP을 사용하는 DataSync 전송 구성](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html)을 참조하세요. ## 구문 요청 ``` { "LocationArn": "string", "Protocol": { "NFS": { "MountOptions": { "Version": "string" } }, "SMB": { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "MountOptions": { "Version": "string" }, "Password": "string", "User": "string" } }, "Subdirectory": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_UpdateLocationFsxOntap_RequestSyntax) ** 업데이트하려는 FSx for ONTAP 전송 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ** [Protocol](#API_UpdateLocationFsxOntap_RequestSyntax) ** DataSync가 Amazon FSx 파일 시스템에 액세스하는 데 사용하는 데이터 전송 프로토콜을 지정합니다. 유형: [FsxUpdateProtocol](API_FsxUpdateProtocol.md)객체 필수 여부: 아니요 ** [Subdirectory](#API_UpdateLocationFsxOntap_RequestSyntax) ** 데이터를 주고 받을 스토리지 가상 머신(SVM)에 파일 공유 경로를 지정합니다. 정션 경로(탑재 지점이라고도 함), qtree 경로(NFS 파일 공유의 경우) 또는 공유 이름(SMB 파일 공유의 경우)을 지정할 수 있습니다. 예를 들어, 탑재 경로는 `/vol1`, `/vol1/tree1`또는 `/share1`일 수 있습니다. SVM의 루트 볼륨에 정션 경로를 지정하지 않습니다. 자세한 설명은 *Amazon FSx for NetApp ONTAP User Guide*(Amazon FSx for NetApp ONTAP 사용자 가이드)의 [Managing FSx for ONTAP storage virtual machines](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html)(FSx for ONTAP 스토리지 가상 머신 관리)를 참조하세요. 타입: 문자열 길이 제약: 최대 길이는 255입니다. 패턴: `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$` 필수 여부: 아니요 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/UpdateLocationFsxOntap) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxOntap) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxOntap) # UpdateLocationFsxOpenZfs 사용 중인 Amazon FSx for OpenZFS 전송 위치의 다음 구성 파라미터를 수정합니다 AWS DataSync. 자세한 내용은 [FSx for OpenZFS를 사용하는 DataSync 전송 구성](https://docs.aws.amazon.com/datasync/latest/userguide/create-openzfs-location.html)을 참조하세요. **참고** `SMB`와 관련된 요청 파라미터는 `UpdateLocationFsxOpenZfs`작업에서 지원되지 않습니다. ## 구문 요청 ``` { "LocationArn": "string", "Protocol": { "NFS": { "MountOptions": { "Version": "string" } }, "SMB": { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "MountOptions": { "Version": "string" }, "Password": "string", "User": "string" } }, "Subdirectory": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_UpdateLocationFsxOpenZfs_RequestSyntax) ** 업데이트하려는 FSx for OpenZFS 전송 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ** [Protocol](#API_UpdateLocationFsxOpenZfs_RequestSyntax) ** 가 Amazon FSx 파일 시스템에 액세스하는 데 AWS DataSync 사용하는 데이터 전송 프로토콜을 지정합니다. 유형: [FsxProtocol](API_FsxProtocol.md)객체 필수 여부: 아니요 ** [Subdirectory](#API_UpdateLocationFsxOpenZfs_RequestSyntax) ** `/fsx`로 시작해야 하는 위치 경로의 하위 디렉터리를 지정합니다. DataSync는 이 하위 디렉터리를 사용하여 데이터를 읽거나 씁니다(파일 시스템이 소스 위치인지 목적지 위치인지에 따라 다름). 타입: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` 필수 여부: 아니요 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/UpdateLocationFsxOpenZfs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) # UpdateLocationFsxWindows 사용 중인 Amazon FSx for Windows File Server 전송 위치의 다음 구성 파라미터를 수정합니다 AWS DataSync. 자세한 내용은 [FSx for Windows File Server를 사용한 DataSync 전송 구성](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html)을 참조하세요. ## 구문 요청 ``` { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "LocationArn": "string", "Password": "string", "Subdirectory": "string", "User": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [CmkSecretConfig](#API_UpdateLocationFsxWindows_RequestSyntax) ** DataSync가 특정 전송 위치에 액세스하는 데 DataSync 사용하는 `Password` 또는 자격 증명 세트와 고객 관리형 보안 암호에 대한 구성 정보를 지정합니다 AWS KMS key. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 필수 여부: 아니요 ** [CustomSecretConfig](#API_UpdateLocationFsxWindows_RequestSyntax) ** DataSync가 특정 전송 위치에 액세스하는 데 사용하는 `Password` 또는 자격 증명 세트와 보안 암호에 대한 액세스를 제공하는 고객 관리형 AWS Identity and Access Management (IAM) 역할과 같은 고객 관리형 보안 암호의 구성 정보를 지정합니다. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 필수 여부: 아니요 ** [Domain](#API_UpdateLocationFsxWindows_RequestSyntax) ** FSx for Windows File Server 파일 시스템이 속한 Windows 도메인의 이름을 지정합니다. 환경에 여러 Active Directory 도메인이 있는 경우 이 파라미터를 구성하면 DataSync가 올바른 파일 시스템에 연결되게 할 수 있습니다. 유형: 문자열 길이 제약: 최대 길이는 253입니다. 패턴: `^([A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252})?$` 필수 여부: 아니요 ** [LocationArn](#API_UpdateLocationFsxWindows_RequestSyntax) ** 업데이트하려는 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}$` 필수 여부: 예 ** [Password](#API_UpdateLocationFsxWindows_RequestSyntax) ** FSx for Windows File Server 파일 시스템의 파일, 폴더, 파일 메타베이터를 탑재하고 이에 액세스할 수 있는 권한이 있는 사용자의 암호를 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 104입니다. 패턴: `^.{0,104}$` 필수 여부: 아니요 ** [Subdirectory](#API_UpdateLocationFsxWindows_RequestSyntax) ** 슬래시를 사용하여 파일 시스템에 대한 탑재 경로를 지정합니다. DataSync는 이 하위 디렉터리를 사용하여 데이터를 읽거나 씁니다(파일 시스템이 소스 위치인지 목적지 위치인지에 따라 다름). 타입: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` 필수 여부: 아니요 ** [User](#API_UpdateLocationFsxWindows_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}$` 필수 여부: 아니요 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/UpdateLocationFsxWindows) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxWindows) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxWindows) # UpdateLocationHdfs 사용 중인 Hadoop 분산 파일 시스템(HDFS) 전송 위치의 다음 구성 파라미터를 수정합니다 AWS DataSync. 자세한 내용은 [HDFS 클러스터를 사용하는 DataSync 전송 구성](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html)을 참조하세요. ## 구문 요청 ``` { "AgentArns": [ "string" ], "AuthenticationType": "string", "BlockSize": number, "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "KerberosKeytab": blob, "KerberosKrb5Conf": blob, "KerberosPrincipal": "string", "KmsKeyProviderUri": "string", "LocationArn": "string", "NameNodes": [ { "Hostname": "string", "Port": number } ], "QopConfiguration": { "DataTransferProtection": "string", "RpcProtection": "string" }, "ReplicationFactor": number, "SimpleUser": "string", "Subdirectory": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AgentArns](#API_UpdateLocationHdfs_RequestSyntax) ** HDFS 클러스터에 연결할 수 있는 DataSync 에이전트의 Amazon 리소스 이름(ARN)입니다. 타입: 문자열 배열 배열 구성원: 최소수는 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_UpdateLocationHdfs_RequestSyntax) ** 사용자 ID를 결정하는 데 사용되는 인증 타입. 타입: 문자열 유효 값: `SIMPLE | KERBEROS` 필수 여부: 아니요 ** [BlockSize](#API_UpdateLocationHdfs_RequestSyntax) ** HDFS 클러스터에 쓸 데이터 블록의 크기입니다. 타입: 정수 유효한 범위: 최소값은 1048576입니다. 최대값은 1073741824입니다. 필수 여부: 아니요 ** [CmkSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) ** DataSync가 특정 전송 위치에 액세스하는 데 DataSync 사용하는 `KerberosKeytab` 또는 자격 증명 세트와 고객 관리형 보안 암호에 대한 구성 정보를 지정합니다 AWS KMS key. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 필수 여부: 아니요 ** [CustomSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) ** DataSync가 특정 전송 위치에 액세스하는 데 사용하는 `KerberosKeytab` 또는 자격 증명 세트와 보안 암호에 대한 액세스를 제공하는 고객 관리형 AWS Identity and Access Management (IAM) 역할과 같은 고객 관리형 보안 암호의 구성 정보를 지정합니다. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 필수 여부: 아니요 ** [KerberosKeytab](#API_UpdateLocationHdfs_RequestSyntax) ** 정의된 Kerberos 보안 주체와 암호화된 키 간의 매핑이 포함된 Kerberos 키 테이블(keytab)입니다. 파일 주소를 제공하여 파일에서 키탭을 로드할 수 있습니다. 타입: Base64로 인코딩된 이진 데이터 객체 길이 제약: 최대 길이는 65536입니다. 필수 여부: 아니요 ** [KerberosKrb5Conf](#API_UpdateLocationHdfs_RequestSyntax) ** Kerberos 구성 정보가 포함된 `krb5.conf` 파일입니다. 파일 주소를 제공하여 `krb5.conf`파일을 로드할 수 있습니다. AWS CLI를 사용하는 경우, base64 인코딩을 자동으로 수행합니다. 그렇지 않으면 base64 인코딩 형식의 텍스트를 제공하십시오. 타입: Base64로 인코딩된 이진 데이터 객체 길이 제약: 최대 길이는 131072입니다. 필수 여부: 아니요 ** [KerberosPrincipal](#API_UpdateLocationHdfs_RequestSyntax) ** HDFS 클러스터의 파일 및 폴더에 대한 액세스 권한이 있는 Kerberos 보안 주체입니다. 타입: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `^.+$` 필수 여부: 아니요 ** [KmsKeyProviderUri](#API_UpdateLocationHdfs_RequestSyntax) ** HDFS 클러스터의 키 관리 서버(KMS)의 URI입니다. 타입: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 255. 패턴: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$` 필수 여부: 아니요 ** [LocationArn](#API_UpdateLocationHdfs_RequestSyntax) ** 소스 HDFS 클러스터 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ** [NameNodes](#API_UpdateLocationHdfs_RequestSyntax) ** HDFS 네임스페이스를 관리하는 NameNode입니다. NameNode는 파일 및 디렉터리 열기, 닫기 및 이름 바꾸기와 같은 작업을 수행합니다. NameNode에는 데이터 블록을 DataNode에 매핑하기 위한 정보가 들어 있습니다. 하나의 NameNode만 사용할 수 있습니다. 타입: [HdfsNameNode](API_HdfsNameNode.md)객체 배열 배열 구성원: 최소수는 1개입니다. 필수 여부: 아니요 ** [QopConfiguration](#API_UpdateLocationHdfs_RequestSyntax) ** QOP(Quality of Protection) 구성은 Hadoop 분산 파일 시스템(HDFS) 클러스터에 구성된 원격 프로시저 호출(RPC) 및 데이터 전송 개인 정보 보호 설정을 지정합니다. 타입: [QopConfiguration](API_QopConfiguration.md)객체 필수 여부: 아니요 ** [ReplicationFactor](#API_UpdateLocationHdfs_RequestSyntax) ** HDFS 클러스터에 쓸 때 데이터를 복제할 DataNode의 수입니다. 타입: 정수 유효 범위: 최소값 1. 최대값은 512입니다. 필수 여부: 아니요 ** [SimpleUser](#API_UpdateLocationHdfs_RequestSyntax) ** 호스트 운영 체제에서 클라이언트를 식별하는 데 사용되는 사용자 이름입니다. 타입: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$` 필수 여부: 아니요 ** [Subdirectory](#API_UpdateLocationHdfs_RequestSyntax) ** HDFS 클러스터의 하위 디렉터리입니다. 이 하위 디렉터리는 HDFS 클러스터에서 데이터를 읽거나 쓰는 데 사용됩니다. 타입: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` 필수 여부: 아니요 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/UpdateLocationHdfs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationHdfs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationHdfs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationHdfs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationHdfs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationHdfs) # UpdateLocationNfs 사용 중인 NFS(Network File System) 전송 위치의 다음 구성 파라미터를 수정합니다 AWS DataSync. 자세한 내용은 [NFS 파일 서버를 사용하는 전송 구성](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html)을 참조하세요. ## 구문 요청 ``` { "LocationArn": "string", "MountOptions": { "Version": "string" }, "OnPremConfig": { "AgentArns": [ "string" ] }, "ServerHostname": "string", "Subdirectory": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_UpdateLocationNfs_RequestSyntax) ** 업데이트하려는 NFS 전송 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ** [MountOptions](#API_UpdateLocationNfs_RequestSyntax) ** DataSync가 NFS 프로토콜을 사용하여 위치에 액세스하는 방법을 지정합니다. 타입: [NfsMountOptions](API_NfsMountOptions.md)객체 필수 여부: 아니요 ** [OnPremConfig](#API_UpdateLocationNfs_RequestSyntax) ** NFS(Network File System) 파일 서버에 연결할 수 있는 AWS DataSync 에이전트입니다. 유형: [OnPremConfig](API_OnPremConfig.md)객체 필수 여부: 아니요 ** [ServerHostname](#API_UpdateLocationNfs_RequestSyntax) ** DataSync 에이전트가 연결될 NFS 파일 서버의 DNS 이름 또는 IP 주소(IPv4 또는 IPv6)를 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 255입니다. 패턴: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` 필수 여부: 아니요 ** [Subdirectory](#API_UpdateLocationNfs_RequestSyntax) ** DataSync에서 탑재할 NFS 파일 서버의 내보내기 경로를 지정합니다. 이 경로(또는 경로의 하위 디렉터리)는 DataSync가 데이터를 전송하고 전송 받는 곳입니다. DataSync용 내보내기 구성에 대한 자세한 내용은 [NFS 파일 서버 액세스](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs)를 참조하세요. 유형: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\p{Zs}]+$` 필수 여부: 아니요 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/UpdateLocationNfs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationNfs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationNfs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationNfs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationNfs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationNfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationNfs) # UpdateLocationObjectStorage 사용 중인 객체 스토리지 전송 위치의 다음 구성 파라미터를 수정합니다 AWS DataSync. 자세한 내용은 [객체 스토리지 시스템을 사용하는 DataSync 전송 구성](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html)을 참조하세요. ## 구문 요청 ``` { "AccessKey": "string", "AgentArns": [ "string" ], "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "LocationArn": "string", "SecretKey": "string", "ServerCertificate": blob, "ServerHostname": "string", "ServerPort": number, "ServerProtocol": "string", "Subdirectory": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AccessKey](#API_UpdateLocationObjectStorage_RequestSyntax) ** 객체 스토리지 서버에 인증하는 데 자격 증명이 필요한 경우, 액세스 키(예: 사용자 이름)를 지정합니다. 유형: 문자열 길이 제한: 최소 길이는 0. 최대 길이는 200입니다. 패턴: `^.*$` 필수 여부: 아니요 ** [AgentArns](#API_UpdateLocationObjectStorage_RequestSyntax) ** (선택 사항) 객체 스토리지 시스템과 연결할 수 있는 DataSync 에이전트의 Amazon 리소스 이름(ARN)을 지정합니다. 에이전트 없는 클라우드 간 전송을 설정하는 경우 이 파라미터에 값을 지정할 필요가 없습니다. 에이전트를 처음 생성한 후에는 스토리지 위치에서 에이전트를 추가하거나 제거할 수 없습니다. 타입: 문자열 배열 배열 구성원: 최소수는 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}$` 필수 여부: 아니요 ** [CmkSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) ** DataSync 관리형 보안 암호의 구성 정보를 지정하며, 여기에는 DataSync가 특정 전송 위치에 액세스하는 데 사용하는 인증 토큰 또는 자격 증명 세트와 고객 관리형 AWS KMS key가 포함됩니다. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 필수 여부: 아니요 ** [CustomSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) ** DataSync가 특정 전송 위치에 액세스하는 데 사용하는 인증 토큰 또는 자격 증명 세트, 보안 암호에 대한 액세스를 제공하는 고객 관리형 AWS Identity and Access Management (IAM) 역할과 같은 고객 관리형 보안 암호의 구성 정보를 지정합니다. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 필수 여부: 아니요 ** [LocationArn](#API_UpdateLocationObjectStorage_RequestSyntax) ** 업데이트하려는 오브젝트 스토리지 시스템 위치의 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}$` 필수 여부: 예 ** [SecretKey](#API_UpdateLocationObjectStorage_RequestSyntax) ** 객체 스토리지 서버에 인증하는 데 자격 증명이 필요한 경우, 보안 암호 키(예: 암호)를 지정합니다. 를 사용하여 보안 암호를 제공`SecretKey`하지만 `CmkSecretConfig` 또는를 사용하여 보안 암호 구성 세부 정보를 제공하지 않는 경우 `CustomSecretConfig` DataSync는 AWS 계정의 Secrets Manager 보안 암호를 사용하여 토큰을 저장합니다. 유형: 문자열 길이 제한: 최소 길이는 0. 최대 길이는 200입니다. 패턴: `^.*$` 필수 여부: 아니요 ** [ServerCertificate](#API_UpdateLocationObjectStorage_RequestSyntax) ** 시스템이 프라이빗 또는 자체 서명 인증 기관(CA)을 사용하는 경우 DataSync가 객체 스토리지 시스템으로 인증하기 위한 인증서 체인을 지정합니다. 전체 인증서 체인(예: `file:///home/user/.ssh/object_storage_certificates.pem`)이 있는 단일 `.pem` 파일을 지정해야 합니다. 인증서 체인에는 다음이 포함될 수 있습니다. + 객체 스토리지 시스템의 인증서 + 모든 중간 인증서(있는 경우) + 서명 CA의 루트 인증서 인증서를 `.pem` 파일로 연결할 수 있습니다(base64 인코딩 전 최대 32,768바이트). 다음 예제의 `cat` 명령은 세 개의 인증서가 포함된 `object_storage_certificates.pem` 파일을 생성합니다. `cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem` 이 파라미터를 사용하려면(`ServerProtocol`을)를(`HTTPS`으)로 구성하세요. 이 파라미터를 업데이트해도 진행 중인 작업은 방해되지 않습니다. 타입: Base64로 인코딩된 이진 데이터 객체 길이 제약: 최대 길이는 32768입니다. 필수 여부: 아니요 ** [ServerHostname](#API_UpdateLocationObjectStorage_RequestSyntax) ** DataSync 에이전트가 연결될 객체 스토리지 서버의 도메인 이름 또는 IP 주소(IPv4 또는 IPv6)를 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 255입니다. 패턴: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` 필수 여부: 아니요 ** [ServerPort](#API_UpdateLocationObjectStorage_RequestSyntax) ** 객체 스토리지 서버가 인바운드 네트워크 트래픽을 수락하는 포트(예: 포트 443)를 지정합니다. 타입: 정수 유효 범위: 최소값 1. 최대값은 65536입니다. 필수 여부: 아니요 ** [ServerProtocol](#API_UpdateLocationObjectStorage_RequestSyntax) ** 객체 스토리지 서버의 통신에 사용되는 프로토콜을 지정합니다. 타입: 문자열 유효 값: `HTTPS | HTTP` 필수 여부: 아니요 ** [Subdirectory](#API_UpdateLocationObjectStorage_RequestSyntax) ** 객체 스토리지 서버의 객체 접두사를 지정합니다. 소스 위치인 경우, DataSync는 이 접두사가 있는 객체만 복사합니다. 목적지 위치인 경우, DataSync는 이 접두사가 있는 모든 객체를 씁니다. 타입: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` 필수 여부: 아니요 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/UpdateLocationObjectStorage) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationObjectStorage) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationObjectStorage) # UpdateLocationS3 사용 중인 Amazon S3 전송 위치의 다음 구성 파라미터를 수정합니다 AWS DataSync. **중요** 시작하기 전에 다음 주제를 읽어보시기 바랍니다. [Amazon S3 위치의 스토리지 클래스 고려 사항](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) [DataSync 사용 시 S3 요청 비용 평가](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) ## 구문 요청 ``` { "LocationArn": "string", "S3Config": { "BucketAccessRoleArn": "string" }, "S3StorageClass": "string", "Subdirectory": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [LocationArn](#API_UpdateLocationS3_RequestSyntax) ** 업데이트하려는 Amazon S3 전송 위치의 Amazon 리소스 이름(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}$` 필수 여부: 예 ** [S3Config](#API_UpdateLocationS3_RequestSyntax) ** DataSync가 S3 버킷에 액세스하는 데 사용하는 (IAM) 역할의 Amazon 리소스 이름 AWS Identity and Access Management (ARN)을 지정합니다. 자세한 내용은 [DataSync에 S3 버킷 액세스 권한 제공](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access)을 참조하세요. 유형: [S3Config](API_S3Config.md)객체 필수 여부: 아니요 ** [S3StorageClass](#API_UpdateLocationS3_RequestSyntax) ** Amazon S3가 전송 대상일 때 객체가 사용할 스토리지 클래스를 지정합니다. 의 버킷 AWS 리전의 경우 스토리지 클래스의 기본값은 입니다`STANDARD`. 의 버킷 AWS Outposts의 경우 스토리지 클래스의 기본값은 입니다`OUTPOSTS`. 자세한 내용은 [Storage class considerations with Amazon S3 transfers](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) 섹션을 참조하세요. 타입: 문자열 유효 값: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` 필수 여부: 아니요 ** [Subdirectory](#API_UpdateLocationS3_RequestSyntax) ** DataSync가 읽거나 쓰는 S3 버킷의 접두사를 입력합니다(버킷이 소스인지 대상 위치인지에 따라 다름). DataSync는 슬래시(`/`)로 시작하거나 `//`, `/./` 또는 `/../` 패턴을 포함하는 접두사가 있는 객체를 전송할 수 없습니다. 예제: + `/photos` + `photos//2006/January` + `photos/./2006/February` + `photos/../2006/March` 유형: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` 필수 여부: 아니요 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/UpdateLocationS3) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationS3) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationS3) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationS3) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationS3) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationS3) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationS3) # UpdateLocationSmb 사용 중인 SMB(Server Message Block) 전송 위치의 다음 구성 파라미터를 수정합니다 AWS DataSync. 자세한 내용은 [SMB 파일 서버를 사용하는 DataSync 전송 구성](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html)을 참조하세요. ## 구문 요청 ``` { "AgentArns": [ "string" ], "AuthenticationType": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "DnsIpAddresses": [ "string" ], "Domain": "string", "KerberosKeytab": blob, "KerberosKrb5Conf": blob, "KerberosPrincipal": "string", "LocationArn": "string", "MountOptions": { "Version": "string" }, "Password": "string", "ServerHostname": "string", "Subdirectory": "string", "User": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AgentArns](#API_UpdateLocationSmb_RequestSyntax) ** SMB 파일 서버에 연결할 수 있는 DataSync 에이전트(또는 에이전트들)를 지정합니다. 에이전트의 Amazon 리소스 이름(ARN)을 사용하여 에이전트를 지정합니다. 타입: 문자열 배열 배열 구성원: 최소수는 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_UpdateLocationSmb_RequestSyntax) ** DataSync가 SMB 파일 서버에 연결하는 데 사용하는 인증 프로토콜을 지정합니다. DataSync는 `NTLM`(기본값) 및 `KERBEROS` 인증을 지원합니다. 자세한 내용은 [DataSync에 SMB 파일 서버 액세스 권한 제공](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)을 참조하세요. 타입: 문자열 유효 값: `NTLM | KERBEROS` 필수 여부: 아니요 ** [CmkSecretConfig](#API_UpdateLocationSmb_RequestSyntax) ** DataSync가 특정 전송 위치 및 고객 관리형에 액세스하는 데 사용하는 `Password` `KerberosKeytab` 또는 자격 증명 세트와 같은 DataSync 관리형 보안 암호의 구성 정보를 지정합니다 AWS KMS key. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 필수 여부: 아니요 ** [CustomSecretConfig](#API_UpdateLocationSmb_RequestSyntax) ** DataSync가 특정 전송 위치에 액세스하는 데 사용하는 `Password` `KerberosKeytab` 또는 자격 증명 세트와 보안 암호에 대한 액세스를 제공하는 고객 관리형 AWS Identity and Access Management (IAM) 역할과 같은 고객 관리형 보안 암호의 구성 정보를 지정합니다. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 필수 여부: 아니요 ** [DnsIpAddresses](#API_UpdateLocationSmb_RequestSyntax) ** SMB 파일 서버가 속한 DNS 서버의 IP 주소(IPv4 또는 IPv6)를 지정합니다. 이 파라미터는 `AuthenticationType`이 `KERBEROS`로 설정된 경우에만 적용됩니다. 환경에 여러 도메인이 있는 경우 이 파라미터를 구성하면 DataSync가 올바른 SMB 파일 서버에 연결되도록 할 수 있습니다. 유형: 문자열 배열 배열 멤버: 최대 항목 수는 2개입니다. 길이 제약: 최소 길이는 7입니다. 최대 길이는 39입니다. 패턴: `\A((25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z` 필수 여부: 아니요 ** [Domain](#API_UpdateLocationSmb_RequestSyntax) ** SMB 파일 서버가 속한 Windows 도메인 이름을 지정합니다. 이 파라미터는 `AuthenticationType`이 `NTLM`로 설정된 경우에만 적용됩니다. 환경에 여러 도메인이 있는 경우 이 파라미터를 구성하면 DataSync가 올바른 파일 서버에 연결되도록 할 수 있습니다. 유형: 문자열 길이 제약: 최대 길이는 253입니다. 패턴: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` 필수 여부: 아니요 ** [KerberosKeytab](#API_UpdateLocationSmb_RequestSyntax) ** Kerberos 보안 주체와 암호화 키 간의 매핑을 포함하는 Kerberos 키 테이블(keytab) 파일을 지정합니다. 작업 실행 오류를 방지하려면 키탭 파일을 생성하는 데 사용하는 Kerberos 보안 주체가 `KerberosPrincipal`에 지정한 것과 정확히 일치하는지 확인합니다. 타입: Base64로 인코딩된 이진 데이터 객체 길이 제약: 최대 길이는 65536입니다. 필수 여부: 아니요 ** [KerberosKrb5Conf](#API_UpdateLocationSmb_RequestSyntax) ** Kerberos 영역 구성을 정의하는 Kerberos 구성 파일(`krb5.conf`)을 지정합니다. 파일은 반드시 base64로 인코딩되어야 합니다. 를 사용하는 경우 AWS CLI인코딩이 수행됩니다. 타입: Base64로 인코딩된 이진 데이터 객체 길이 제약: 최대 길이는 131072입니다. 필수 여부: 아니요 ** [KerberosPrincipal](#API_UpdateLocationSmb_RequestSyntax) ** Kerberos 영역에서 SMB 파일 서버의 파일, 폴더, 파일 메타데이터에 액세스할 수 있는 권한을 가진 Kerberos 보안 주체를 지정합니다. Kerberos 보안 주체는 `HOST/kerberosuser@MYDOMAIN.ORG`처럼 보일 수 있습니다. 보안 주체 이름은 대/소문자를 구분합니다. 이 파라미터에 대해 지정한 보안 주체가 키탭 파일 생성에 사용하는 보안 주체와 정확히 일치하지 않으면 DataSync 작업 실행이 실패합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `^.+$` 필수 여부: 아니요 ** [LocationArn](#API_UpdateLocationSmb_RequestSyntax) ** 업데이트하려는 SMB 위치의 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}$` 필수 여부: 예 ** [MountOptions](#API_UpdateLocationSmb_RequestSyntax) ** 가 SMB 파일 서버에 액세스하는 데 AWS DataSync 사용하는 SMB(Server Message Block) 프로토콜의 버전을 지정합니다. 유형: [SmbMountOptions](API_SmbMountOptions.md)객체 필수 여부: 아니요 ** [Password](#API_UpdateLocationSmb_RequestSyntax) ** 사용자 SMB 파일 서버를 탑재하고 전송과 관련된 파일과 폴더에 액세스할 수 있는 권한이 있는 사용자의 암호를 지정합니다. 이 파라미터는 `AuthenticationType`이 `NTLM`로 설정된 경우에만 적용됩니다. 유형: 문자열 길이 제약: 최대 길이는 104입니다. 패턴: `^.{0,104}$` 필수 여부: 아니요 ** [ServerHostname](#API_UpdateLocationSmb_RequestSyntax) ** DataSync 에이전트가 연결될 SMB 파일 서버의 도메인 이름 또는 IP 주소(IPv4 또는 IPv6)를 지정합니다. Kerberos 인증을 사용하는 경우 도메인 이름을 지정해야 합니다. 유형: 문자열 길이 제약: 최대 길이는 255입니다. 패턴: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` 필수 여부: 아니요 ** [Subdirectory](#API_UpdateLocationSmb_RequestSyntax) ** DataSync가 데이터를 읽거나 쓸 SMB 파일 서버에서 내보낸 공유의 이름을 지정합니다. 공유 경로에 하위 디렉토리(예: `/path/to/subdirectory`)를 포함할 수 있습니다. 네트워크의 다른 SMB 클라이언트도 이 경로를 마운트할 수 있는지 확인하세요. 지정된 하위 디렉터리의 모든 데이터를 복사하려면 DataSync가 SMB 공유를 탑재하고 모든 데이터에 액세스할 수 있어야 합니다. 자세한 내용은 [DataSync에 SMB 파일 서버 액세스 권한 제공](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)을 참조하세요. 유형: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` 필수 여부: 아니요 ** [User](#API_UpdateLocationSmb_RequestSyntax) ** SMB 파일 서버를 탑재할 수 있는 사용자 이름을 지정하고 전송과 관련된 파일 및 폴더에 액세스할 권한이 있는 사용자 이름을 지정합니다. 이 파라미터는 `AuthenticationType`이 `NTLM`로 설정된 경우에만 적용됩니다. 전송에 적합한 수준의 액세스 권한을 가진 사용자를 선택하는 방법에 대한 자세한 내용은 [SMB 파일 서버에 대한 DataSync 액세스 제공](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)을 참조하세요. 유형: 문자열 길이 제약: 최대 길이는 104입니다. 패턴: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 필수 여부: 아니요 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/UpdateLocationSmb) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationSmb) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationSmb) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationSmb) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationSmb) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationSmb) # UpdateTask AWS DataSync 이 데이터를 이동하는 위치와 방법을 정의하는 *작업*의 구성을 업데이트합니다. ## 구문 요청 ``` { "CloudWatchLogGroupArn": "string", "Excludes": [ { "FilterType": "string", "Value": "string" } ], "Includes": [ { "FilterType": "string", "Value": "string" } ], "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "string" } } }, "Name": "string", "Options": { "Atime": "string", "BytesPerSecond": number, "Gid": "string", "LogLevel": "string", "Mtime": "string", "ObjectTags": "string", "OverwriteMode": "string", "PosixPermissions": "string", "PreserveDeletedFiles": "string", "PreserveDevices": "string", "SecurityDescriptorCopyFlags": "string", "TaskQueueing": "string", "TransferMode": "string", "Uid": "string", "VerifyMode": "string" }, "Schedule": { "ScheduleExpression": "string", "Status": "string" }, "TaskArn": "string", "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "string", "S3BucketArn": "string", "Subdirectory": "string" } }, "ObjectVersionIds": "string", "OutputType": "string", "Overrides": { "Deleted": { "ReportLevel": "string" }, "Skipped": { "ReportLevel": "string" }, "Transferred": { "ReportLevel": "string" }, "Verified": { "ReportLevel": "string" } }, "ReportLevel": "string" } } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [CloudWatchLogGroupArn](#API_UpdateTask_RequestSyntax) ** 작업을 모니터링하기 위한 Amazon CloudWatch 로그 그룹의 Amazon 리소스 이름(ARN)을 지정합니다. 확장 모드 작업의 경우 `/aws/datasync`를 로그 그룹 이름으로 사용해야 합니다. 예제: `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*` 자세한 내용은 [CloudWatch Logs를 사용하여 데이터 전송 모니터링](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html)을 참조하세요. 유형: 문자열 길이 제약 조건: 최대 길이는 562입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` 필수 여부: 아니요 ** [Excludes](#API_UpdateTask_RequestSyntax) ** DataSync가 전송하지 않도록 소스 위치의 파일, 객체 및 폴더를 정의하는 제외 필터를 지정합니다. 자세한 내용과 예제는 [Specifying what DataSync transfers by using filters](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) 섹션을 참조하세요. 타입: [FilterRule](API_FilterRule.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대 항목 수는 1개입니다. 필수 여부: 아니요 ** [Includes](#API_UpdateTask_RequestSyntax) ** DataSync가 전송하도록 소스 위치의 파일, 객체 및 폴더를 정의하는 포함 필터를 지정합니다. 자세한 내용과 예제는 [Specifying what DataSync transfers by using filters](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) 섹션을 참조하세요. 타입: [FilterRule](API_FilterRule.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대 항목 수는 1개입니다. 필수 여부: 아니요 ** [ManifestConfig](#API_UpdateTask_RequestSyntax) ** DataSync에서 전송하려는 파일 또는 객체 목록인 매니페스트를 구성합니다. 자세한 내용과 구성 예제는 [Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) 섹션을 참조하세요. 이 파라미터를 사용할 때는 발신자 자격 증명(DataSync를 사용하는 IAM 역할)에 `iam:PassRole` 권한이 있어야 합니다. [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess) 정책에는 이 권한이 포함됩니다. 매니페스트 구성을 제거하려면 이 파라미터를 비어 있음으로 지정합니다. 유형: [ManifestConfig](API_ManifestConfig.md)객체 필수 여부: 아니요 ** [Name](#API_UpdateTask_RequestSyntax) ** 작업의 이름을 지정합니다. 유형: 문자열 길이 제약: 최소 길이는 0. 최대 길이는 256입니다. 패턴: `^[a-zA-Z0-9\s+=._:@/-]+$` 필수 여부: 아니요 ** [Options](#API_UpdateTask_RequestSyntax) ** 전송 작업이 구성된 방식을 나타냅니다. 이러한 옵션에는 DataSync가 전송 중에 파일, 객체 및 관련 메타데이터 처리 방법이 포함됩니다. 또한 다른 옵션 중에서 데이터 무결성을 확인하고, 작업에 대한 대역폭 제한 설정 방법을 지정할 수 있습니다. 각 옵션에는 기본값이 있습니다. 필요한 경우가 아니라면 [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)을 호출하기 전에 이러한 옵션을 구성하지 않아도 됩니다. 각 작업 실행에 대해 작업 옵션을 재정의할 수도 있습니다. 예를 들어 개별 실행에 대해 `LogLevel`을 조정할 수 있습니다. 유형: [Options](API_Options.md)객체 필수 여부: 아니요 ** [Schedule](#API_UpdateTask_RequestSyntax) ** 작업을 실행할 일정을 지정합니다. 자세한 내용을 알아보려면 [태스크 예약](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html)을 참조하십시오. 유형: [TaskSchedule](API_TaskSchedule.md)객체 필수 여부: 아니요 ** [TaskArn](#API_UpdateTask_RequestSyntax) ** 업데이트하려는 작업의 ARN을 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$` 필수 여부: 예 ** [TaskReportConfig](#API_UpdateTask_RequestSyntax) ** DataSync 전송에 대한 세부 정보를 제공하는 작업 보고서를 구성할 방법을 지정합니다. 자세한 내용은 [Monitoring your DataSync transfers with task reports](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) 섹션을 참조하세요. 이 파라미터를 사용할 때는 발신자 자격 증명(DataSync를 사용하는 IAM 역할)에 `iam:PassRole` 권한이 있어야 합니다. [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess) 정책에는 이 권한이 포함됩니다. 작업 보고서 구성을 제거하려면 이 파라미터를 비어 있음으로 지정합니다. 유형: [TaskReportConfig](API_TaskReportConfig.md)객체 필수 여부: 아니요 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/UpdateTask) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTask) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTask) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTask) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTask) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTask) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTask) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTask) # UpdateTaskExecution 실행 중인 AWS DataSync 작업 실행의 구성을 업데이트합니다. **참고** `UpdateTaskExecution`를 사용하여 현재 수정할 수 있는 유일한 `Option`은 ` [BytesPerSecond](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-BytesPerSecond) `으로 실행 중이거나 대기중인 작업 실행의 대역폭을 제한하는 것입니다. ## 구문 요청 ``` { "Options": { "Atime": "string", "BytesPerSecond": number, "Gid": "string", "LogLevel": "string", "Mtime": "string", "ObjectTags": "string", "OverwriteMode": "string", "PosixPermissions": "string", "PreserveDeletedFiles": "string", "PreserveDevices": "string", "SecurityDescriptorCopyFlags": "string", "TaskQueueing": "string", "TransferMode": "string", "Uid": "string", "VerifyMode": "string" }, "TaskExecutionArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [Options](#API_UpdateTaskExecution_RequestSyntax) ** 전송 작업이 구성된 방식을 나타냅니다. 이러한 옵션에는 DataSync가 전송 중에 파일, 객체 및 관련 메타데이터 처리 방법이 포함됩니다. 또한 다른 옵션 중에서 데이터 무결성을 확인하고, 작업에 대한 대역폭 제한 설정 방법을 지정할 수 있습니다. 각 옵션에는 기본값이 있습니다. 필요한 경우가 아니라면 [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)을 호출하기 전에 이러한 옵션을 구성하지 않아도 됩니다. 각 작업 실행에 대해 작업 옵션을 재정의할 수도 있습니다. 예를 들어 개별 실행에 대해 `LogLevel`을 조정할 수 있습니다. 타입: [Options](API_Options.md)객체 필수 항목 여부: 예 ** [TaskExecutionArn](#API_UpdateTaskExecution_RequestSyntax) ** 업데이트하려는 태스크 실행의 Amazon 리소스 이름(ARN) 을 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` 필수 여부: 예 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](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/UpdateTaskExecution) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTaskExecution) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTaskExecution) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTaskExecution) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTaskExecution) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTaskExecution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTaskExecution) # 데이터 타입 다음 데이터 타입이 지원됩니다. + [AgentListEntry](API_AgentListEntry.md) + [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md) + [CmkSecretConfig](API_CmkSecretConfig.md) + [CustomSecretConfig](API_CustomSecretConfig.md) + [Ec2Config](API_Ec2Config.md) + [FilterRule](API_FilterRule.md) + [FsxProtocol](API_FsxProtocol.md) + [FsxProtocolNfs](API_FsxProtocolNfs.md) + [FsxProtocolSmb](API_FsxProtocolSmb.md) + [FsxUpdateProtocol](API_FsxUpdateProtocol.md) + [FsxUpdateProtocolSmb](API_FsxUpdateProtocolSmb.md) + [HdfsNameNode](API_HdfsNameNode.md) + [LocationFilter](API_LocationFilter.md) + [LocationListEntry](API_LocationListEntry.md) + [ManagedSecretConfig](API_ManagedSecretConfig.md) + [ManifestConfig](API_ManifestConfig.md) + [NfsMountOptions](API_NfsMountOptions.md) + [OnPremConfig](API_OnPremConfig.md) + [Options](API_Options.md) + [Platform](API_Platform.md) + [PrivateLinkConfig](API_PrivateLinkConfig.md) + [QopConfiguration](API_QopConfiguration.md) + [ReportDestination](API_ReportDestination.md) + [ReportDestinationS3](API_ReportDestinationS3.md) + [ReportOverride](API_ReportOverride.md) + [ReportOverrides](API_ReportOverrides.md) + [ReportResult](API_ReportResult.md) + [S3Config](API_S3Config.md) + [S3ManifestConfig](API_S3ManifestConfig.md) + [SmbMountOptions](API_SmbMountOptions.md) + [SourceManifestConfig](API_SourceManifestConfig.md) + [TagListEntry](API_TagListEntry.md) + [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md) + [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md) + [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md) + [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md) + [TaskExecutionListEntry](API_TaskExecutionListEntry.md) + [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md) + [TaskFilter](API_TaskFilter.md) + [TaskListEntry](API_TaskListEntry.md) + [TaskReportConfig](API_TaskReportConfig.md) + [TaskSchedule](API_TaskSchedule.md) + [TaskScheduleDetails](API_TaskScheduleDetails.md) # AgentListEntry [ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html) 작업을 호출할 때 AWS DataSync 에이전트 목록(또는 배열)의 단일 항목을 나타냅니다. ## 내용 ** AgentArn ** DataSync 에이전트의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이는 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}$` 필수 여부: 아니요 ** Name ** 에이전트의 이름. 유형: 문자열 길이 제약: 최소 길이는 0. 최대 길이는 256입니다. 패턴: `^[a-zA-Z0-9\s+=._:@/-]+$` 필수 여부: 아니요 ** Platform ** 에이전트에 대한 플랫폼 관련 세부 정보(예: 버전 번호) 유형: [Platform](API_Platform.md)객체 필수 여부: 아니요 ** Status ** 에이전트의 상태. + 상태가 `ONLINE`이면 에이전트가 제대로 구성되어 사용할 준비가 된 것입니다. + 상태가 `OFFLINE`이면 에이전트가 5분 이상 동안 DataSync와 연락이 끊긴 것입니다. 몇 가지 원인이 있을 수 있습니다. 자세한 내용은 [에이전트가 오프라인 상태인 경우 어떻게 하나요?](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline) 를 확인하세요. 타입: 문자열 유효 값: `ONLINE | OFFLINE` 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/AgentListEntry) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/AgentListEntry) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/AgentListEntry) # AzureBlobSasConfiguration AWS DataSync이 사용자 Microsoft Azure Blob 스토리지에 액세스하게 해 주는 공유 액세스 서명(SAS) 구성입니다. 자세한 내용은 Azure Blob 스토리지에 액세스하기 위한 [SAS 토큰](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-sas-tokens)을 참조하세요. ## 내용 ** Token ** Azure Blob 스토리지에 액세스할 수 있는 권한을 제공하는 SAS 토큰을 지정합니다. 토큰은 스토리지 리소스 URI와 물음표 뒤에 오는 SAS URI 문자열의 일부입니다. 토큰은 다음과 같은 형태입니다: `sp=r&st=2023-12-20T14:54:52Z&se=2023-12-20T22:54:52Z&spr=https&sv=2021-06-08&sr=c&sig=aBBKDWQvyuVcTPH9EBp%2FXTI9E%2F%2Fmq171%2BZU178wcwqU%3D` 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 255. 패턴: `^.+$` 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/AzureBlobSasConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/AzureBlobSasConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/AzureBlobSasConfiguration) # CmkSecretConfig DataSync가 고객 관리형를 사용하여 특정 스토리지 위치에 액세스하는 데 사용하는 인증 토큰, 보안 암호 키, 암호 또는 Kerberos 키 탭과 같은 DataSync 관리형 보안 암호의 구성 정보를 지정합니다 AWS KMS key. **참고** `CmkSecretConfig` 또는 `CustomSecretConfig`을 사용하여 `CreateLocation` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요. ## 내용 ** KmsKeyArn ** DataSync AWS KMS key 가에 대해 저장된 DataSync 관리형 보안 암호를 암호화하는 데 사용하는 고객 관리형 보안 암호의 ARN을 지정합니다`SecretArn`. DataSync는이 키를에 제공합니다 AWS Secrets Manager. 유형: 문자열 길이 제약: 최대 길이 2048. 패턴: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):kms:[a-z\-0-9]+:[0-9]{12}:key/.*|)$` 필수 여부: 아니요 ** SecretArn ** 특정 스토리지 위치에 액세스하는 데 사용되는 DataSync 관리형 AWS Secrets Manager 보안 암호의 ARN을 지정합니다. 이 속성은 DataSync에서 읽기 전용으로 생성됩니다. DataSync는 `KmsKeyArn`에 지정한 KMS 키로 이 보안 암호를 암호화합니다. 유형: 문자열 길이 제약: 최대 길이 2048. 패턴: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$` 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CmkSecretConfig) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CmkSecretConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CmkSecretConfig) # CustomSecretConfig 스토리지 위치 보안 인증 정보가 Secrets Manager에 일반 텍스트(인증 토큰, 보안 키 또는 암호의 경우) 또는 바이너리(Kerberos 키 탭의 경우)로 저장되는 고객 관리형 Secrets Manager 보안 암호의 구성 정보를 지정합니다. 이 구성에는 보안 암호 ARN과 보안 암호에 대한 액세스를 제공하는 IAM 역할의 ARN이 포함됩니다. **참고** `CmkSecretConfig` 또는 `CustomSecretConfig`을 사용하여 `CreateLocation` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요. ## 내용 ** SecretAccessRoleArn ** DataSync가에 지정된 보안 암호에 액세스하는 데 사용하는 AWS Identity and Access Management 역할의 ARN을 지정합니다`SecretArn`. 유형: 문자열 길이 제약: 최대 길이 2048. 패턴: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/[a-zA-Z0-9+=,.@_-]+|)$` 필수 여부: 아니요 ** SecretArn ** AWS Secrets Manager 보안 암호의 ARN을 지정합니다. 유형: 문자열 길이 제약: 최대 길이 2048. 패턴: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$` 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CustomSecretConfig) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CustomSecretConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CustomSecretConfig) # Ec2Config 가 Amazon EFS 파일 시스템의 [탑재 대상](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) 중 하나에 연결하는 데 AWS DataSync 사용하는 서브넷 및 보안 그룹입니다. ## 내용 ** SecurityGroupArns ** Amazon EFS 파일 시스템의 탑재 대상과 연결된 보안 그룹의 Amazon 리소스 이름(ARN)을 지정합니다. 타입: 문자열 배열 배열 구성원: 최소수는 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]+$` 필수 여부: 예 ** SubnetArn ** DataSync가 전송 중 트래픽 관리를 위한 [네트워크 인터페이스](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces)를 생성하는 서브넷의 ARN을 지정합니다. 서브넷은 다음 위치에 있어야 합니다. + Amazon EFS 파일 시스템과 동일한 Virtual Private Cloud(VPC) + Amazon EFS 파일 시스템에 대한 하나 이상의 탑재 대상과 동일한 가용 영역 파일 시스템 탑재 대상을 포함하는 서브넷을 지정할 필요가 없습니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:subnet/subnet-[a-f0-9]+$` 필수 여부: 예 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Ec2Config) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Ec2Config) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Ec2Config) # FilterRule 소스에서 대상으로 파일을 전송할 때 포함시키거나 제외시킬 파일, 폴더 및 객체를 지정합니다. ## 내용 ** FilterType ** 적용할 필터 규칙의 유형입니다. AWS DataSync는 SIMPLE\$1PATTERN 규칙 유형만 지원합니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^[A-Z0-9_]+$` 유효 값: `SIMPLE_PATTERN` 필수 여부: 아니요 ** Value ** 포함하거나 제외할 패턴으로 구성된 단일 필터 문자열입니다. 패턴은 “\$1" (즉, 파이프) 로 구분됩니다. 예를 들면 다음과 같습니다. `/folder1|/folder2` 유형: 문자열 길이 제약 조건: 최대 길이는 102,400입니다. 패턴: `^[^\x00]+$` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FilterRule) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FilterRule) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FilterRule) # FsxProtocol AWS DataSync가 Amazon FSx 파일 시스템에 액세스하는 데 사용하는 데이터 전송 프로토콜을 지정합니다. ## 내용 ** NFS ** DataSync가 FSx for OpenZFS 파일 시스템 또는 FSx for ONTAP 파일 시스템의 스토리지 가상 머신(SVM)에 액세스하는 데 사용하는 네트워크 파일 시스템(NFS) 프로토콜 구성을 지정합니다. 유형: [FsxProtocolNfs](API_FsxProtocolNfs.md)객체 필수 여부: 아니요 ** SMB ** DataSync가 FSx for ONTAP 파일 시스템의 SVM에 액세스하는 데 사용하는 Server Message Block(SMB) 프로토콜 구성을 지정합니다. 유형: [FsxProtocolSmb](API_FsxProtocolSmb.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocol) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocol) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocol) # FsxProtocolNfs DataSync가 FSx for OpenZFS 파일 시스템 또는 FSx for ONTAP 파일 시스템의 스토리지 가상 머신(SVM)에 액세스하는 데 사용하는 네트워크 파일 시스템(NFS) 프로토콜 구성을 지정합니다. ## 내용 ** MountOptions ** DataSync가 NFS 프로토콜을 사용하여 위치에 액세스하는 방법을 지정합니다. 타입: [NfsMountOptions](API_NfsMountOptions.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocolNfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocolNfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocolNfs) # FsxProtocolSmb 가 Amazon FSx for NetApp ONTAP 파일 시스템의 스토리지 가상 머신(SVM)에 액세스하는 데 AWS DataSync 사용하는 서버 메시지 블록(SMB) 프로토콜 구성을 지정합니다. 자세한 내용은 [DataSync에 FSx for ONTAP 파일 서버 액세스 권한 제공](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access)을 참조하세요. ## 내용 ** User ** SVM에 파일, 폴더 및 메타데이터를 탑재하고 이에 액세스할 수 있는 사용자를 지정합니다. 전송에 적합한 수준의 액세스 권한을 가진 사용자를 선택하는 방법에 대한 자세한 내용은 [SMB 프로토콜 사용](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb)을 참조하세요. 유형: 문자열 길이 제약: 최대 길이는 104입니다. 패턴: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 필수 여부: 예 ** CmkSecretConfig ** DataSync 관리형 보안 암호에 대한 구성 정보를 지정합니다. 여기에는 DataSync가 고객 관리형 보안 암호로 특정 FSx for ONTAP 스토리지 위치(SMB 사용)에 액세스하는 데 사용하는 암호가 포함됩니다 AWS KMS key. 이 파라미터를 `CreateLocationFsxOntap` 요청의 일부로 포함하는 경우 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` 제외)을 사용하여 `CreateLocationFsxOntap` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 필수 여부: 아니요 ** CustomSecretConfig ** FSx for ONTAP 스토리지 위치(SMB 사용)의 암호가 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` 제외)을 사용하여 `CreateLocationFsxOntap` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 필수 여부: 아니요 ** Domain ** 스토리지 가상 머신(SVM)이 속한 Windows 도메인의 이름을 지정합니다. 환경에 여러 도메인이 있는 경우 이 설정을 구성하면 DataSync가 올바른 SVM에 연결되게 할 수 있습니다. 환경에 여러 Active Directory 도메인이 있는 경우 이 파라미터를 구성하면 DataSync가 올바른 SVM에 연결되도록 할 수 있습니다. 유형: 문자열 길이 제약: 최대 길이는 253입니다. 패턴: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` 필수 여부: 아니요 ** ManagedSecretConfig ** DataSync가 특정 스토리지 위치에 액세스하는 데 사용하는와 같은 `Password` DataSync 관리형 보안 암호의 구성 정보를 설명합니다. DataSync는 기본 AWS관리형 KMS 키를 사용하여이 보안 암호를 암호화합니다 AWS Secrets Manager. `CreateLocation` 요청에이 정보를 제공하지 마십시오. `ManagedSecretConfig`는 ReadOnly 속성이며 `DescribeLocation` 응답에만 채워집니다. 유형: [ManagedSecretConfig](API_ManagedSecretConfig.md)객체 필수 여부: 아니요 ** MountOptions ** 가 SMB 파일 서버에 액세스하는 데 AWS DataSync 사용하는 SMB(Server Message Block) 프로토콜의 버전을 지정합니다. 유형: [SmbMountOptions](API_SmbMountOptions.md)객체 필수 여부: 아니요 ** Password ** SVM에 액세스할 수 있는 권한이 있는 사용자의 암호를 지정합니다. 타입: 문자열 길이 제약: 최대 길이는 104입니다. 패턴: `^.{0,104}$` 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocolSmb) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocolSmb) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocolSmb) # FsxUpdateProtocol AWS DataSync가 Amazon FSx 파일 시스템에 액세스하는 데 사용하는 데이터 전송 프로토콜을 지정합니다. **참고** FSx for ONTAP 위치에 대한 네트워크 파일 시스템(NFS) 프로토콜 구성은 업데이트할 수 없습니다. DataSync는 현재 이 위치 유형에 대해 NFS 버전 3만 지원합니다. ## 내용 ** NFS ** DataSync가 FSx for OpenZFS 파일 시스템 또는 FSx for ONTAP 파일 시스템의 스토리지 가상 머신(SVM)에 액세스하는 데 사용하는 네트워크 파일 시스템(NFS) 프로토콜 구성을 지정합니다. 유형: [FsxProtocolNfs](API_FsxProtocolNfs.md)객체 필수 여부: 아니요 ** SMB ** DataSync가 FSx for ONTAP 파일 시스템의 스토리지 가상 머신(SVM)에 액세스하는 데 사용하는 SMB(Server Message Block) 프로토콜 구성을 지정합니다. 유형: [FsxUpdateProtocolSmb](API_FsxUpdateProtocolSmb.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxUpdateProtocol) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxUpdateProtocol) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxUpdateProtocol) # FsxUpdateProtocolSmb 가 Amazon FSx for NetApp ONTAP 파일 시스템의 스토리지 가상 머신(SVM)에 액세스하는 데 AWS DataSync 사용하는 서버 메시지 블록(SMB) 프로토콜 구성을 지정합니다. 자세한 내용은 [DataSync에 FSx for ONTAP 파일 서버 액세스 권한 제공](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access)을 참조하세요. ## 내용 ** CmkSecretConfig ** DataSync가 특정 전송 위치에 액세스하는 데 DataSync 사용하는 `Password` 또는 자격 증명 세트와 고객 관리형 보안 암호에 대한 구성 정보를 지정합니다 AWS KMS key. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 필수 여부: 아니요 ** CustomSecretConfig ** DataSync가 특정 전송 위치에 액세스하는 데 사용하는 `Password` 또는 자격 증명 세트와 같은 고객 관리형 보안 암호의 구성 정보를 지정합니다. 이 구성에는 보안 암호 ARN과 보안 암호에 대한 액세스를 제공하는 IAM 역할의 ARN이 포함됩니다. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 필수 여부: 아니요 ** Domain ** 스토리지 가상 머신(SVM)이 속한 Windows 도메인의 이름을 지정합니다. 환경에 여러 Active Directory 도메인이 있는 경우 이 파라미터를 구성하면 DataSync가 올바른 SVM에 연결되도록 할 수 있습니다. 유형: 문자열 길이 제약: 최대 길이는 253입니다. 패턴: `^([A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252})?$` 필수 여부: 아니요 ** MountOptions ** 가 SMB 파일 서버에 액세스하는 데 AWS DataSync 사용하는 SMB(Server Message Block) 프로토콜의 버전을 지정합니다. 유형: [SmbMountOptions](API_SmbMountOptions.md)객체 필수 여부: 아니요 ** Password ** SVM에 액세스할 수 있는 권한이 있는 사용자의 암호를 지정합니다. 타입: 문자열 길이 제약: 최대 길이는 104입니다. 패턴: `^.{0,104}$` 필수 여부: 아니요 ** User ** SVM에 파일, 폴더 및 메타데이터를 탑재하고 이에 액세스할 수 있는 사용자를 지정합니다. 전송에 적합한 수준의 액세스 권한을 가진 사용자를 선택하는 방법에 대한 자세한 내용은 [SMB 프로토콜 사용](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb)을 참조하세요. 유형: 문자열 길이 제약: 최대 길이는 104입니다. 패턴: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxUpdateProtocolSmb) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxUpdateProtocolSmb) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxUpdateProtocolSmb) # HdfsNameNode Hadoop 분산 파일 시스템(HDFS)의 NameNode입니다. NameNode는 파일 시스템의 네임스페이스를 관리합니다. NameNode는 파일 및 디렉터리 열기, 닫기 및 이름 바꾸기와 같은 작업을 수행합니다. NameNode에는 데이터 블록을 DataNode에 매핑하기 위한 정보가 들어 있습니다. ## 내용 ** Hostname ** HDFS 클러스터에 있는 NameNode의 호스트 이름입니다. 이 값은 NameNode의 IP 주소 또는 도메인 이름 서비스(DNS) 이름입니다. 온프레미스에 설치된 에이전트는 이 호스트 이름을 사용하여 네트워크의 NameNode와 통신합니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 255. 패턴: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$` 필수 여부: 예 ** Port ** NameNode가 클라이언트 요청을 수신하는 데 사용하는 포트입니다. 타입: 정수 유효 범위: 최소값 1. 최댓값은 65536입니다. 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/HdfsNameNode) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/HdfsNameNode) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/HdfsNameNode) # LocationFilter `ListLocations`에 의해 반환되는 리소스 목록의 범위를 좁히세요. 예컨대, 모든 Amazon S3 위치를 보려면 `"Name": "LocationType"`, `"Operator": "Equals"`및 `"Values": "S3"`을 사용하여 필터를 생성하세요. 자세한 설명은 [리소스 필터링](https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html)을 참조하세요. ## 내용 ** Name ** 사용 중인 필터의 이름입니다. 각 API 호출은 사용할 수 있는 필터 목록(예: `ListLocations`의 경우`LocationType`) 을 지원합니다. 타입: 문자열 유효 값: `LocationUri | LocationType | CreationTime` 필수 여부: 예 ** Operator ** 필터 값을 비교하는 데 사용되는 연산자(예: `Equals`또는`Contains`). 타입: 문자열 유효 값: `Equals | NotEquals | In | LessThanOrEqual | LessThan | GreaterThanOrEqual | GreaterThan | Contains | NotContains | BeginsWith` 필수 여부: 예 ** Values ** 필터링할 값입니다. 예컨대, Amazon S3 위치만 표시할 수 있습니다. 타입: 문자열 배열 길이 제약: 최소 길이 1. 최대 길이는 255. 패턴: `^[0-9a-zA-Z_\ \-\:\*\.\\/\?-]*$` 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/LocationFilter) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/LocationFilter) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/LocationFilter) # LocationListEntry 위치 목록에 있는 단일 항목을 표시합니다. `LocationListEntry`은 [ListLocation](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListLocations.html) 작업이 호출될 때 위치 목록이 포함된 배열을 반환합니다. ## 내용 ** LocationArn ** 해당 위치의 Amazon 리소스 이름(ARN). 네트워크 파일 시스템(NFS) 또는 Amazon EFS의 경우, 위치는 내보내기 경로입니다. Amazon S3의 경우, 위치는 탑재하여 위치의 루트로 사용하려는 접두사 경로입니다. 타입: 문자열 길이 제약: 최대 길이는 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}$` 필수 여부: 아니요 ** LocationUri ** 위치의 URI 목록을 표시합니다. `LocationUri`[ListLocation](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListLocations.html) 작업이 호출될 때 위치 목록이 포함된 배열을 반환합니다. 형식: `TYPE://GLOBAL_ID/SUBDIR`. TYPE은 위치 타입(예: `nfs`또는`s3`) 을 지정합니다. GLOBAL\$1ID는 위치를 뒷받침하는 리소스의 글로벌 고유 식별자입니다. EFS의 한 예는 `us-east-2.fs-abcd1234`입니다. Amazon S3의 예로는 버킷 명칭을 들 수 있습니다(예:`myBucket`). NFS의 예로는 유효한 IPv4, IPv6 주소 또는 DNS를 준수하는 호스트 이름이 있습니다. SUBDIR은 유효한 파일 시스템 경로로, \$1nix 규칙과 같이 슬래시로 구분됩니다. NFS 및 Amazon EFS의 경우, 위치를 탑재하기 위한 내보내기 경로입니다. Amazon S3의 경우, 이것은 탑재하여 위치의 루트로 취급하려는 접두사 경로입니다. 타입: 문자열 길이 제약: 최대 길이는 4360입니다. 패턴: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/LocationListEntry) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/LocationListEntry) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/LocationListEntry) # ManagedSecretConfig DataSync 관리형 보안 암호의 구성 정보를 지정하며, 여기에는 DataSync가 특정 전송 위치에 액세스하는 데 사용하는 인증 토큰 또는 자격 증명 세트가 포함됩니다. DataSync는 기본 AWS관리형 KMS 키를 사용하여이 보안 암호를 암호화합니다 AWS Secrets Manager. ## 내용 ** SecretArn ** AWS Secrets Manager 보안 암호의 ARN을 지정합니다. 유형: 문자열 길이 제약: 최대 길이 2048. 패턴: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$` 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ManagedSecretConfig) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ManagedSecretConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ManagedSecretConfig) # ManifestConfig AWS DataSync에서 전송하려는 파일 또는 객체 목록인 매니페스트를 구성합니다. 자세한 내용과 구성 예제는 [Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) 섹션을 참조하세요. ## 내용 ** Action ** DataSync가 매니페스트를 사용하는 대상을 지정합니다. 타입: 문자열 유효 값: `TRANSFER` 필수 여부: 아니요 ** Format ** 매니페스트의 파일 형식을 지정합니다. 자세한 내용은 [Creating a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-create) 섹션을 참조하세요. 타입: 문자열 유효 값: `CSV` 필수 여부: 아니요 ** Source ** DataSync에서 사용할 매니페스트와 호스팅 위치를 지정합니다. 2024년 2월 7일 이후에 새 매니페스트를 구성하는 경우 이 파라미터를 지정해야 합니다. 그렇지 않으면 DataSync에 대한 IAM 역할이 없어 매니페스트를 호스팅하는 S3 버킷에 액세스할 수 있다는 400 상태 코드와 `ValidationException` 오류가 표시됩니다. 자세한 내용은 [Providing DataSync access to your manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-access) 섹션을 참조하세요. 유형: [SourceManifestConfig](API_SourceManifestConfig.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ManifestConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ManifestConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ManifestConfig) # NfsMountOptions DataSync가 NFS 프로토콜을 사용하여 위치에 액세스하는 방법을 지정합니다. ## 내용 ** Version ** NFS 공유를 탑재할 때 DataSync에서 사용할 NFS 버전을 지정합니다. 서버가 지정된 버전 사용을 거부하면 태스크가 실패합니다. 다음과 같은 옵션을 지정할 수 있습니다: + `AUTOMATIC`(기본값): DataSync는 NFS 버전 4.1을 선택합니다. + `NFS3`: 서버에 비동기 쓰기를 허용하는 상태 비저장 프로토콜 버전입니다. + `NFSv4_0`: 위임 및 의사 파일 시스템을 지원하는 방화벽 친화적인 상태 저장 프로토콜 버전입니다. + `NFSv4_1`: 세션, 디렉토리 위임 및 병렬 데이터 처리를 지원하는 상태 저장 프로토콜 버전입니다. NFS 버전 4.1에는 버전 4.0에서 사용할 수 있는 모든 기능이 포함되어 있습니다. DataSync는 현재 Amazon FSx for NetApp ONTAP 위치에 대해 NFS 버전 3만 지원합니다. 타입: 문자열 유효 값: `AUTOMATIC | NFS3 | NFS4_0 | NFS4_1` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/NfsMountOptions) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/NfsMountOptions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/NfsMountOptions) # OnPremConfig NFS(Network File System) 파일 서버에 연결할 수 있는 AWS DataSync 에이전트입니다. ## 내용 ** AgentArns ** NFS 파일 서버에 연결할 수 있는 DataSync 에이전트의 Amazon 리소스 이름(ARN)입니다. 하나 이상의 에이전트를 지정할 수 있습니다. 자세한 내용은 [Using multiple DataSync agents](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents) 섹션을 참조하세요. 타입: 문자열 배열 배열 구성원: 최소수는 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}$` 필수 여부: 예 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/OnPremConfig) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/OnPremConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/OnPremConfig) # Options 전송 작업이 구성된 방식을 나타냅니다. 이러한 옵션에는 DataSync가 전송 중에 파일, 객체 및 관련 메타데이터 처리 방법이 포함됩니다. 또한 다른 옵션 중에서 데이터 무결성을 확인하고, 작업에 대한 대역폭 제한 설정 방법을 지정할 수 있습니다. 각 옵션에는 기본값이 있습니다. 필요한 경우가 아니라면 [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)을 호출하기 전에 이러한 옵션을 구성하지 않아도 됩니다. 각 작업 실행에 대해 작업 옵션을 재정의할 수도 있습니다. 예를 들어 개별 실행에 대해 `LogLevel`을 조정할 수 있습니다. ## 내용 ** Atime ** 파일을 마지막으로 읽거나 쓴 시간을 나타내는 메타데이터를 보존할지 여부를 지정합니다. `Atime`의 동작은 플랫폼 전체에서 완전히 표준이 아니므로 DataSync는 최선의 노력을 다해야 이러한 작업을 수행할 수 있을 뿐입니다. + `BEST_EFFORT`(기본값) - DataSync는 원본 `Atime` 속성을 모든 소스 파일(즉, 작업 실행의 `PREPARING` 단계 이전 버전)에 보존하려고 시도합니다. 이 옵션이 권장됩니다. + `NONE` - `Atime`을 무시합니다. `Atime`이 `BEST_EFFORT`로 설정된 경우 `Mtime`이 `PRESERVE`로 설정되어야 합니다. `Atime`이 `NONE`으로 설정된 경우 `Mtime`도 `NONE`이어야 합니다. 타입: 문자열 유효 값: `NONE | BEST_EFFORT` 필수 여부: 아니요 ** BytesPerSecond ** DataSync 작업에 의해 사용되는 대역폭을 제한합니다. 예를 들어 DataSync에서 최대 1MB를 사용하기를 원하면 이 값을 `1048576`(`=1024*1024`) 로 설정합니다. 타입: Long 유효한 범위: 최소값은 -1입니다. 필수 여부: 아니요 ** Gid ** 파일 소유자의 POSIX 그룹 ID (GID)를 지정합니다. + `INT_VALUE`(기본값) - 사용자 ID(UID)와 GID의 정수 값을 보존합니다(권장). + `NONE` - UID와 GID를 무시합니다. 자세한 내용은 [Understanding how DataSync handles file and object metadata](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html) 섹션을 참조하세요. 타입: 문자열 유효 값: `NONE | INT_VALUE | NAME | BOTH` 필수 여부: 아니요 ** LogLevel ** DataSync가 Amazon CloudWatch Logs 로그 그룹에 게시하는 로그 유형을 지정합니다. 로그 그룹을 지정하려면 [CloudWatchLogGroupArn](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html#DataSync-CreateTask-request-CloudWatchLogGroupArn)을 참조하세요. + `BASIC` - 기본 정보(예: 전송 오류)만 포함된 로그를 게시합니다. + `TRANSFER` - DataSync 작업이 전송하는 모든 파일 또는 객체에 대한 로그를 게시하고 데이터 무결성 검사를 수행합니다. + `OFF` - 로그가 게시되지 않습니다. 타입: 문자열 유효 값: `OFF | BASIC | TRANSFER` 필수 여부: 아니요 ** Mtime ** 작업 실행 `PREPARING` 단계 이전에 파일이 마지막으로 쓰여진 시간을 나타내는 메타데이터의 보존 여부를 지정합니다. 이 옵션은 태스크를 두 번 이상 실행해야 하는 경우에 필요합니다. + `PRESERVE`(기본값) - 원래 `Mtime`을 보존합니다(권장). + `NONE` - `Mtime`을 무시합니다. `Mtime`이 `PRESERVE`로 설정된 경우 `Atime`이 `BEST_EFFORT`로 설정되어야 합니다. `Mtime`이 `NONE`으로 설정된 경우 `Atime`도 `NONE`으로 설정되어야 합니다. 타입: 문자열 유효 값: `NONE | PRESERVE` 필수 여부: 아니요 ** ObjectTags ** 객체 스토리지 시스템 간에 전송할 때 DataSync가 객체 태그(기본 동작)의 `PRESERVE` 여부를 지정합니다. DataSync 태스크에서 객체 태그를 무시하도록 하려면 `NONE` 값을 지정합니다. 타입: 문자열 유효 값: `PRESERVE | NONE` 필수 여부: 아니요 ** OverwriteMode ** DataSync가 대상 위치의 데이터를 수정할지 또는 보존할지 여부를 지정합니다. + `ALWAYS`(기본값) - DataSync는 소스 데이터(메타데이터 포함)가 변경될 때 대상 위치의 데이터를 수정합니다. DataSync에서 객체를 덮어쓰는 경우, 특정 Amazon S3 스토리지 클래스(예: 검색 또는 조기 삭제)에 대한 추가 요금이 발생할 수 있습니다. 자세한 내용은 [Storage class considerations with Amazon S3 transfers](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) 섹션을 참조하세요. + `NEVER` - DataSync는 소스 데이터가 변경된 경우에도 대상 위치의 데이터를 덮어쓰지 않습니다. 이 옵션을 사용하여 대상의 파일 또는 객체에 대한 변경 사항을 덮어쓰지 않도록 보호할 수 있습니다. 타입: 문자열 유효 값: `ALWAYS | NEVER` 필수 여부: 아니요 ** PosixPermissions ** 파일의 읽기, 쓰기 또는 실행과 같은 특정 목적을 위해 파일에 액세스할 수 있는 사용자 또는 그룹을 지정하는 값입니다. 자세한 내용은 [Understanding how DataSync handles file and object metadata](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html) 섹션을 참조하세요. + `PRESERVE`(기본값) - POSIX 스타일 권한을 보존합니다(권장). + `NONE` - POSIX 스타일 권한을 무시합니다. DataSync는 소스 위치의 기존 권한을 보존할 수 있습니다. 타입: 문자열 유효 값: `NONE | PRESERVE` 필수 여부: 아니요 ** PreserveDeletedFiles ** 소스 파일 시스템에 존재하지 않는 목적지 장소에 파일을 보존할지 여부를 지정하는 값입니다. 이 옵션은 Amazon S3 스토리지 비용에 영향을 줄 수 있습니다. 작업에서 객체를 삭제하는 경우 특정 스토리지 클래스에 대한 최소 스토리지 기간 요금이 발생할 수 있습니다. 자세한 내용은 [DataSync에서 Amazon S3 스토리지 클래스 작업 시 고려 사항](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes)을 참조하세요. + `PRESERVE`(기본값) - 대상 파일을 무시합니다(권장). + `REMOVE` - 소스에 없는 대상 파일을 삭제합니다. 이 파라미터를 `REMOVE`로 설정하면, `TransferMode`를 `ALL`으로 설정할 수 없습니다. 모든 데이터를 전송할 때 DataSync는 목적지 위치를 스캔하지 않으므로 무엇을 삭제해야 할지 모릅니다. 타입: 문자열 유효 값: `PRESERVE | REMOVE` 필수 여부: 아니요 ** PreserveDevices ** DataSync가 소스 위치에서 블록 및 문자 장치의 메타데이터를 보존해야 하는지 여부와 목적지에 해당 장치 이름과 메타데이터를 사용하여 파일을 다시 생성해야 하는지 여부를 지정하십시오. DataSync는 이러한 디바이스의 이름과 메타데이터만 복사합니다. DataSync는 터미널이 아니고 EOF(파일 끝) 마커를 반환하지 않으므로 이러한 장치의 실제 내용을 복사할 수 없습니다. + `NONE`(기본값) - 특수 디바이스를 무시합니다(권장). + `PRESERVE` - 문자 및 블록 디바이스 메타데이터를 보존합니다. 이 옵션은 현재 Amazon EFS를 위해 지원되지는 않습니다. 타입: 문자열 유효 값: `NONE | PRESERVE` 필수 여부: 아니요 ** SecurityDescriptorCopyFlags ** 소스에서 목적지 객체로 복사로 복사되는 SMB 보안 설명자의 구성 요소를 지정합니다. 이 값은 SMB와 Amazon FSx for Windows File Server 위치 간이나, 두 개의 Windows File Server용 FSx 위치 간의 전송에만 사용됩니다. 자세한 내용은 [Understanding how DataSync handles file and object metadata](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html) 섹션을 참조하세요. + `OWNER_DACL`(기본값) - 복사된 각 객체에 대해 DataSync는 다음 메타데이터를 복사합니다. + 객체 소유자 + 객체에 대한 액세스 권한을 부여할지 여부를 결정하는 NTFS 임의 액세스 제어 목록(DACL)입니다. DataSync는 이 옵션을 사용하여 NTFS 시스템 액세스 제어 목록(SACLs)을 복사하지 않습니다. + `OWNER_DACL_SACL` - 복사된 각 객체에 대해 DataSync는 다음 메타데이터를 복사합니다. + 객체 소유자 + 객체에 대한 액세스 권한을 부여할지 여부를 결정하는 NTFS 임의 액세스 제어 목록(DACL)입니다. + SACL은 관리자가 보안 객체에 액세스하려는 시도를 로깅하는 데 사용됩니다. SACL을 복사하려면 DataSync가 SMB 위치에 액세스하는 데 사용하는 Windows 사용자에게 추가 권한을 부여해야 합니다. 올바른 권한을 가진 사용자를 선택하는 방법에 대한 자세한 내용은 [SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions), [FSx for Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) 또는 [FSx for ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb)에 필요한 권한(전송 시 위치 유형에 따라 다름)을 참조하세요. + `NONE` - SMB 보안 설명자 구성 요소는 복사되지 않습니다. 대상 객체는 대상 위치에 액세스하기 위해 제공된 사용자가 소유합니다. DACL 및 SACL은 대상 서버의 구성을 기반으로 설정됩니다. 타입: 문자열 유효 값: `NONE | OWNER_DACL | OWNER_DACL_SACL` 필수 여부: 아니요 ** TaskQueueing ** [여러 작업을 실행할 때](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#running-multiple-tasks)의 특정 시나리오 동안에 전송 작업을 대기열에 넣을지 여부를 지정합니다. 기본 값은 `ENABLED`입니다. 타입: 문자열 유효 값: `ENABLED | DISABLED` 필수 여부: 아니요 ** TransferMode ** DataSync가 초기 복사 후 위치 간에 달라진 데이터(메타데이터 포함)만 전송할지 아니면 작업을 실행할 때마다 모든 데이터를 전송할지 지정합니다. 반복 전송을 계획한다면 이전 작업 실행 이후 변경된 내용만 전송하는 것이 좋을 수 있습니다. + `CHANGED`(기본값) - 최초 전체 전송 후 DataSync는 소스 위치와 대상 위치 간에 서로 다른 데이터와 메타데이터만 복사합니다. + `ALL` - DataSync는 위치 간의 차이를 비교하지 않고 소스의 모든 데이터를 대상으로 복사합니다. 타입: 문자열 유효 값: `CHANGED | ALL` 필수 여부: 아니요 ** Uid ** 파일 소유자의 POSIX 사용자 ID (UID)를 지정합니다. + `INT_VALUE`(기본값) - UID와 그룹 ID(GID)의 정수 값을 보존합니다(권장). + `NONE` - UID와 GID를 무시합니다. 자세한 내용은 [DataSync에서 복사한 메타데이터](https://docs.aws.amazon.com/datasync/latest/userguide/special-files.html#metadata-copied)를 참조하세요. 타입: 문자열 유효 값: `NONE | INT_VALUE | NAME | BOTH` 필수 여부: 아니요 ** VerifyMode ** 전송이 완료된 후 DataSync의 데이터 무결성 검사 여부와 검사 방식을 지정합니다. + `ONLY_FILES_TRANSFERRED`(권장) - DataSync는 소스 위치에서 전송된 데이터(메타데이터 포함)의 체크섬을 계산합니다. 전송이 완료된 후 DataSync는 이 체크섬을 대상 위치에서 해당 데이터에 대해 계산한 체크섬과 비교합니다. **참고** [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)의 기본 옵션입니다. S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive 스토리지 클래스로 전송하는 경우 이 옵션을 사용하는 것이 좋습니다. 자세한 내용은 [Amazon S3 위치의 스토리지 클래스 고려 사항](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes)을 참조하세요. + `POINT_IN_TIME_CONSISTENT` - 전송 종료 시 DataSync는 전체 소스와 대상을 검사하여 두 위치가 완전히 동기화되었는지 확인합니다. **참고** 이는 [기본 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)의 기본 옵션이며 현재 확장 모드 작업에서는 지원하지 않습니다. [매니페스트](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)를 사용하는 경우 DataSync는 매니페스트에 나열된 항목만 스캔하고 확인합니다. S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive 스토리지 클래스로 전송하는 경우 이 옵션을 사용할 수 없습니다. 자세한 내용은 [Amazon S3 위치의 스토리지 클래스 고려 사항](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes)을 참조하세요. + `NONE` - DataSync는 전송 중에만 데이터 무결성 검사를 수행합니다. 다른 옵션과 달리 전송이 끝날 때 추가 확인은 없습니다. 타입: 문자열 유효 값: `POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE` 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Options) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Options) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Options) # Platform AWS DataSync에이전트에 대한 플랫폼 관련 세부 정보(예: 버전 번호) ## 내용 ** Version ** DataSync 에이전트의 버전입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `^[a-zA-Z0-9\s+=._:@/-]+$` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Platform) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Platform) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Platform) # PrivateLinkConfig AWS DataSync 에이전트가 [Virtual Private Cloud(VPC) 서비스 엔드포인트](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc)를 AWS 사용하여에 연결하는 방법을 지정합니다. VPC 엔드포인트를 사용하는 에이전트는 퍼블릭 인터넷을 통해 액세스할 수 없습니다. ## 내용 ** PrivateLinkEndpoint ** [AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-share-your-services.html)가 제공하는 에이전트가 연결할 VPC 엔드포인트를 지정합니다. 유형: 문자열 길이 제약: 최소 길이는 7입니다. 최대 길이는 15입니다. 패턴: `\A(25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}\z` 필수 여부: 아니요 ** SecurityGroupArns ** 사용자 VPC 엔드포인트의 DataSync 액세스를 제공하는 보안 그룹의 Amazon 리소스 이름(ARN)을 지정합니다. 하나의 ARN만 지정할 수 있습니다. 유형: 문자열 배열 배열 멤버: 고정된 항목 수는 1개입니다. 길이 제약: 최대 길이는 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]+$` 필수 여부: 아니요 ** SubnetArns ** VPC 엔드포인트가 위치한 서브넷의 ARN을 지정합니다. 하나의 ARN만 지정할 수 있습니다. 유형: 문자열 배열 배열 멤버: 고정된 항목 수는 1개입니다. 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:subnet/subnet-[a-f0-9]+$` 필수 여부: 아니요 ** VpcEndpointId ** 에이전트가 연결되는 VPC 엔드포인트의 ID를 지정합니다. 유형: String 패턴: `^vpce-[0-9a-f]{17}$` 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/PrivateLinkConfig) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/PrivateLinkConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/PrivateLinkConfig) # QopConfiguration QOP(Quality of Protection) 구성은 Hadoop 분산 파일 시스템(HDFS) 클러스터에 구성된 원격 프로시저 호출(RPC) 및 데이터 전송 개인 정보 보호 설정을 지정합니다. ## 내용 ** DataTransferProtection ** HDFS 클러스터에 구성된 데이터 전송 보호 설정입니다. 이 설정은 Hadoop 클러스터의 `hdfs-site.xml` 파일에 있는 `dfs.data.transfer.protection` 설정에 해당합니다. 타입: 문자열 유효 값: `DISABLED | AUTHENTICATION | INTEGRITY | PRIVACY` 필수 여부: 아니요 ** RpcProtection ** HDFS 클러스터에 구성되는 RPC 보호 설정. 이 설정은 Hadoop 클러스터의 `core-site.xml` 파일에 있는 `hadoop.rpc.protection` 설정에 해당합니다. 타입: 문자열 유효 값: `DISABLED | AUTHENTICATION | INTEGRITY | PRIVACY` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/QopConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/QopConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/QopConfiguration) # ReportDestination DataSync가 [작업 보고서](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)를 업로드하는 위치를 지정합니다. ## 내용 ** S3 ** DataSync가 작업 보고서를 업로드하는 Amazon S3 버킷을 지정합니다. 유형: [ReportDestinationS3](API_ReportDestinationS3.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportDestination) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportDestination) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportDestination) # ReportDestinationS3 DataSync가 [작업 보고서](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)를 업로드하는 Amazon S3 버킷을 지정합니다. ## 내용 ** BucketAccessRoleArn ** DataSync가 S3 버킷에 작업 보고서를 업로드할 수 있도록 허용하는 IAM 정책의 Amazon 리소스 이름(ARN)을 지정합니다. 자세한 내용은 [DataSync가 Amazon S3 버킷에 작업 보고서를 업로드하도록 허용](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)을 참조하세요. 유형: 문자열 길이 제약: 최대 길이 2048. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` 필수 여부: 예 ** S3BucketArn ** DataSync가 보고서를 업로드하는 S3 버킷의 ARN을 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 268입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$` 필수 여부: 예 ** Subdirectory ** 보고서의 버킷 접두사를 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportDestinationS3) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportDestinationS3) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportDestinationS3) # ReportOverride DataSync [작업 보고서](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)의 특정 측면에 대한 세부 수준을 지정합니다. ## 내용 ** ReportLevel ** 작업 보고서에 오류만 포함할지 아니면 성공과 오류를 포함할지를 지정합니다. 예를 들어, 보고서에는 대부분 전송에서 잘 진행되지 않은 내용만 포함될 수 있습니다(`ERRORS_ONLY`). 동시에 [작업 필터](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)가 제대로 작동하는지도 확인하려고 합니다. 이 경우 DataSync가 성공적으로 건너뛰었던 파일 목록과 전송하지 않은 파일이 전송되었는지를 확인할 수 있습니다(`SUCCESSES_AND_ERRORS`). 타입: 문자열 유효 값: `ERRORS_ONLY | SUCCESSES_AND_ERRORS` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportOverride) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportOverride) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportOverride) # ReportOverrides DataSync [작업 보고서](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)의 각 측면에 포함된 세부 수준입니다. ## 내용 ** Deleted ** DataSync가 대상 위치에서 삭제를 시도한 파일, 객체 및 디렉터리에 대한 보고 수준을 지정합니다. 이는 소스에 없는 대상의 데이터를 삭제하도록 [작업을 구성한](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) 경우에만 적용됩니다. 유형: [ReportOverride](API_ReportOverride.md)객체 필수 여부: 아니요 ** Skipped ** DataSync가 전송 중에 건너뛰려고 시도한 파일, 개체 및 디렉터리에 대한 보고 수준을 지정합니다. 유형: [ReportOverride](API_ReportOverride.md)객체 필수 여부: 아니요 ** Transferred ** DataSync가 전송을 시도한 파일, 개체 및 디렉터리에 대한 보고 수준을 지정합니다. 유형: [ReportOverride](API_ReportOverride.md)객체 필수 여부: 아니요 ** Verified ** 전송 종료 시 DataSync가 확인을 시도한 파일, 객체 및 디렉터리에 대한 보고 수준을 지정합니다. 유형: [ReportOverride](API_ReportOverride.md)객체 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportOverrides) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportOverrides) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportOverrides) # ReportResult DataSync가 전송을 위한 전체 [작업 보고서](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)를 생성했는지 여부를 표시합니다. ## 내용 ** ErrorCode ** DataSync가 전체 보고서를 생성할 수 없는 경우, 오류와 관련된 코드를 표시합니다. 타입: 문자열 필수 여부: 아니요 ** ErrorDetail ** 보고서 생성 문제에 대한 세부 정보를 제공합니다. 타입: 문자열 필수 여부: 아니요 ** Status ** DataSync가 보고서를 계속 작성 중인지, 보고서를 만들었는지, 전체 보고서를 생성할 수 없는지 여부를 표시합니다. 타입: 문자열 유효 값: `PENDING | SUCCESS | ERROR` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportResult) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportResult) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportResult) # S3Config DataSync가 S3 버킷에 액세스하는 데 사용하는 (IAM) 역할의 Amazon 리소스 이름 AWS Identity and Access Management (ARN)을 지정합니다. 자세한 내용은 [DataSync에 S3 버킷 액세스 권한 제공](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access)을 참조하세요. ## 내용 ** BucketAccessRoleArn ** DataSync가 S3 버킷에 액세스하는 데 사용하는 IAM 역할의 ARN을 지정합니다. 유형: 문자열 길이 제약: 최대 길이 2048. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` 필수 여부: 예 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/S3Config) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/S3Config) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/S3Config) # S3ManifestConfig 사용할 매니페스트를 호스팅할 S3 버킷 AWS DataSync 을 지정합니다. 자세한 내용과 구성 예제는 [Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) 섹션을 참조하세요. ## 내용 ** BucketAccessRoleArn ** DataSync가 매니페스트에 액세스할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할을 지정합니다. 자세한 내용은 [Providing DataSync access to your manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-access) 섹션을 참조하세요. 유형: 문자열 길이 제약: 최대 길이 2048. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` 필수 여부: 예 ** ManifestObjectPath ** 매니페스트의 Amazon S3 객체 키를 지정합니다. 여기에는 접두사(예: `prefix/my-manifest.csv`)가 포함될 수 있습니다. 유형: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` 필수 여부: 예 ** S3BucketArn ** 매니페스트를 호스팅하는 S3 버킷의 Amazon 리소스 이름(ARN)을 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 268입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$` 필수 여부: 예 ** ManifestObjectVersionId ** DataSync에서 사용할 매니페스트의 객체 버전 ID를 지정합니다. 이를 설정하지 않으면 DataSync는 최신 버전의 객체를 사용합니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 100. 패턴: `^.+$` 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/S3ManifestConfig) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/S3ManifestConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/S3ManifestConfig) # SmbMountOptions AWS DataSync가 SMB 파일 서버에 액세스하는 데 사용하는 서버 메시지 블록(SMB) 프로토콜의 버전을 지정합니다. ## 내용 ** Version ** 기본적으로 DataSync는 SMB 파일 서버와의 협상을 기반으로 SMB 프로토콜 버전을 자동으로 선택합니다. 특정 SMB 버전을 사용하도록 DataSync를 구성할 수도 있지만 DataSync가 SMB 파일 서버와 자동으로 협상하는 데 문제가 있는 경우에만 이렇게 하는 것이 좋습니다. SMB 버전을 구성하기 위한 옵션은 다음과 같습니다. + `AUTOMATIC`(기본값): DataSync와 SMB 파일 서버는 2.1과 3.1.1 사이에서 상호 지원하는 SMB의 최상위 버전을 협상합니다. 이는 권장되는 옵션입니다. 대신 파일 서버에서 지원하지 않는 특정 버전을 선택하면 `Operation Not Supported` 오류가 발생할 수 있습니다. + `SMB3`: 프로토콜 협상을 SMB 버전 3.0.2로만 제한합니다. + `SMB2`: 프로토콜 협상을 SMB 버전 2.1로만 제한합니다. + `SMB2_0`: 프로토콜 협상을 SMB 버전 2.0으로만 제한합니다. + `SMB1`: 프로토콜 협상을 SMB 버전 1.0으로만 제한합니다. **참고** [Amazon FSx for NetApp ONTAP 위치를 생성](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateLocationFsxOntap.html)할 때는 `SMB1`옵션을 사용할 수 없습니다. 타입: 문자열 유효 값: `AUTOMATIC | SMB2 | SMB3 | SMB1 | SMB2_0` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/SmbMountOptions) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/SmbMountOptions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/SmbMountOptions) # SourceManifestConfig AWS DataSync에서 사용할 매니페스트와 호스팅 위치를 지정합니다. 자세한 내용과 구성 예제는 [Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) 섹션을 참조하세요. ## 내용 ** S3 ** 매니페스트를 호스팅하는 S3 버킷을 지정합니다. 타입: [S3ManifestConfig](API_S3ManifestConfig.md)객체 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/SourceManifestConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/SourceManifestConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/SourceManifestConfig) # TagListEntry AWS 리소스에 적용된 단일 태그를 나타내는 키-값 페어입니다. ## 내용 ** Key ** AWS리소스 태그의 키입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `^[a-zA-Z0-9\s+=._:/-]+$` 필수 여부: 예 ** Value ** AWS리소스 태그의 값입니다. 유형: 문자열 길이 제약: 최소 길이는 0. 최대 길이는 256입니다. 패턴: `^[a-zA-Z0-9\s+=._:@/-]+$` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TagListEntry) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TagListEntry) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TagListEntry) # TaskExecutionFilesFailedDetail 작업 실행 중에 DataSync가 준비, 전송, 확인 및 삭제하지 못하는 파일 또는 객체 수입니다. **참고** [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. ## 내용 ** Delete ** 작업 실행 중에 DataSync가 삭제하지 못하는 파일 또는 객체의 수입니다. 유형: Long 필수 여부: 아니요 ** Prepare ** 작업 실행 중에 DataSync가 준비하지 못하는 파일 또는 객체의 수입니다. 유형: Long 필수 여부: 아니요 ** Transfer ** 작업 실행 중에 DataSync가 전송하지 못하는 파일 또는 객체의 수입니다. 유형: Long 필수 여부: 아니요 ** Verify ** 작업 실행 중에 DataSync가 확인하지 못한 파일 또는 객체의 수입니다. 유형: Long 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFilesFailedDetail) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFilesFailedDetail) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFilesFailedDetail) # TaskExecutionFilesListedDetail DataSync가 사용자 위치에서 찾는 파일 또는 객체의 수입니다. **참고** [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. ## 내용 ** AtDestinationForDelete ** DataSync가 대상 위치에서 찾는 파일 또는 객체의 수입니다. 이 카운터는 대상에서 소스에 없는 데이터를 삭제하도록 [작업을 구성](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-file-object-handling)한 경우에만 적용됩니다. 유형: Long 필수 여부: 아니요 ** AtSource ** DataSync가 소스 위치에서 찾는 파일 또는 객체의 수입니다. + [매니페스트](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)를 사용하면 DataSync는 매니페스트에 있는 항목(소스 위치의 모든 항목 아님)만 나열합니다. + 포함 [필터](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)를 사용하면 DataSync는 소스 위치에서 필터와 일치하는 항목만 나열합니다. + 제외 필터를 사용하면 DataSync는 필터를 적용하기 전에 소스 위치에 있는 모든 항목을 나열합니다. 유형: Long 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFilesListedDetail) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFilesListedDetail) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFilesListedDetail) # TaskExecutionFoldersFailedDetail DataSync가 작업 실행 중에 나열, 준비, 전송, 확인 및 삭제하지 못하는 디렉터리 수입니다. **참고** [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. ## 내용 ** Delete ** 작업 실행 중에 DataSync가 삭제하지 못하는 디렉터리 수입니다. 유형: Long 필수 여부: 아니요 ** List ** 작업 실행 중에 DataSync가 나열하지 못하는 디렉터리 수입니다. 유형: Long 필수 여부: 아니요 ** Prepare ** 작업 실행 중에 DataSync가 준비하지 못하는 디렉터리 수입니다. 유형: Long 필수 여부: 아니요 ** Transfer ** 작업 실행 중에 DataSync가 전송하지 못하는 디렉터리 수입니다. 유형: Long 필수 여부: 아니요 ** Verify ** 작업 실행 중에 DataSync가 확인하지 못한 디렉터리 수입니다. 유형: Long 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) # TaskExecutionFoldersListedDetail DataSync가 사용자 위치에서 찾는 디렉터리 수입니다. **참고** [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. ## 내용 ** AtDestinationForDelete ** DataSync가 대상 위치에서 찾는 디렉터리 수입니다. 이 카운터는 대상에서 소스에 없는 데이터를 삭제하도록 [작업을 구성](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-file-object-handling)한 경우에만 적용됩니다. 유형: Long 필수 여부: 아니요 ** AtSource ** DataSync가 소스 위치에서 찾는 디렉터리 수입니다. + [매니페스트](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)를 사용하면 DataSync는 매니페스트에 있는 항목(소스 위치의 모든 항목 아님)만 나열합니다. + 포함 [필터](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)를 사용하면 DataSync는 소스 위치에서 필터와 일치하는 항목만 나열합니다. + 제외 필터를 사용하면 DataSync는 필터를 적용하기 전에 소스 위치에 있는 모든 항목을 나열합니다. 유형: Long 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFoldersListedDetail) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFoldersListedDetail) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFoldersListedDetail) # TaskExecutionListEntry [ListTaskExecutions](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListTaskExecutions.html) 작업과 함께 반환되는 AWS DataSync 작업 실행 목록의 단일 항목을 나타냅니다. ## 내용 ** Status ** 작업의 실행 상태. 자세한 내용은 [작업 실행 상태](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)를 참조하십시오. 타입: 문자열 유효 값: `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR` 필수 여부: 아니요 ** TaskExecutionArn ** 작업 실행의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` 필수 여부: 아니요 ** TaskMode ** 사용 중인 작업 모드입니다. 자세한 내용은 [데이터 전송을 위한 작업 모드 선택](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)을 참조하세요. 타입: 문자열 유효 값: `BASIC | ENHANCED` 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionListEntry) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionListEntry) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionListEntry) # TaskExecutionResultDetail AWS DataSync 작업 실행 결과에 대한 자세한 정보를 제공합니다. ## 내용 ** ErrorCode ** 작업 실행 동안 DataSync에서 발생한 오류입니다. 이 정보를 사용하면 [문제 해결](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html)에 도움이 됩니다. 유형: 문자열 필수 여부: 아니요 ** ErrorDetail ** 작업을 실행하는 동안 DataSync에서 발생한 오류에 대한 자세한 설명입니다. 이 정보를 사용하면 [문제 해결](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html)에 도움이 됩니다. 유형: 문자열 필수 여부: 아니요 ** PrepareDuration ** 작업 실행이 `PREPARING` 단계에 있었던 시간(밀리초 단위)입니다. 자세한 내용은 [작업 실행 상태](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)를 참조하십시오. 확장 모드 작업의 경우 값은 항상 `0`입니다. 자세한 내용은 [DataSync가 데이터 전송을 준비하는 방법](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-datasync-prepares)을 참조하세요. 타입: Long 유효 범위: 최소값은 0입니다. 필수 여부: 아니요 ** PrepareStatus ** 작업 실행에서 `PREPARING` 단계의 상태입니다. 자세한 내용은 [작업 실행 상태](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)를 참조하십시오. 타입: 문자열 유효 값: `PENDING | SUCCESS | ERROR` 필수 여부: 아니요 ** TotalDuration ** 작업 실행이 실행된 시간(밀리초 단위)입니다. 타입: Long 유효 범위: 최소값은 0입니다. 필수 여부: 아니요 ** TransferDuration ** 작업 실행이 `TRANSFERRING` 단계에 있었던 시간(밀리초 단위)입니다. 자세한 내용은 [작업 실행 상태](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)를 참조하십시오. 확장 모드 작업의 경우 값은 항상 `0`입니다. 자세한 내용은 [DataSync가 데이터를 전송하는 방법](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-datasync-transfers)을 참조하세요. 타입: Long 유효 범위: 최소값은 0입니다. 필수 여부: 아니요 ** TransferStatus ** 작업 실행에서 `TRANSFERRING` 단계의 상태입니다. 자세한 내용은 [작업 실행 상태](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)를 참조하십시오. 타입: 문자열 유효 값: `PENDING | SUCCESS | ERROR` 필수 여부: 아니요 ** VerifyDuration ** 작업 실행이 `VERIFYING` 단계에 있었던 시간(밀리초 단위)입니다. 자세한 내용은 [작업 실행 상태](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)를 참조하십시오. 확장 모드 작업의 경우 값은 항상 `0`입니다. 자세한 내용은 [DataSync가 데이터의 무결성을 확인하는 방법](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-verifying-works)을 참조하세요. 타입: Long 유효 범위: 최소값은 0입니다. 필수 여부: 아니요 ** VerifyStatus ** 작업 실행에서 `VERIFYING` 단계의 상태입니다. 자세한 내용은 [작업 실행 상태](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)를 참조하십시오. 타입: 문자열 유효 값: `PENDING | SUCCESS | ERROR` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionResultDetail) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionResultDetail) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionResultDetail) # TaskFilter API 필터를 사용하여(`ListTasks`이)가 반환한 리소스 목록의 범위를 좁힐 수 있습니다. 예를 들어 소스 위치의 모든 작업을 검색하려면 필터 이름(`LocationId`와)과 해당 위치의 ARN(`Operator Equals`을)를(`ListTasks`와)과 함께 사용할 수 있습니다. 자세한 내용은 [DataSync 리소스 필터링](https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html)을 참조하세요. ## 내용 ** Name ** 사용 중인 필터의 이름입니다. 각 API 직접 호출은 해당 호출에 사용할 수 있는 필터 목록을 지원합니다. 예를 들어 `LocationId`의 경우 `ListTasks`입니다. 타입: 문자열 유효 값: `LocationId | CreationTime` 필수 여부: 예 ** Operator ** 필터 값을 비교하는 데 사용되는 연산자(예: `Equals`또는`Contains`). 타입: 문자열 유효 값: `Equals | NotEquals | In | LessThanOrEqual | LessThan | GreaterThanOrEqual | GreaterThan | Contains | NotContains | BeginsWith` 필수 여부: 예 ** Values ** 필터링할 값입니다. 예를 들어 특정 대상 위치의 작업만 표시하기를 원할 수 있습니다. 유형: 문자열 배열 길이 제약: 최소 길이 1. 최대 길이는 255. 패턴: `^[0-9a-zA-Z_\ \-\:\*\.\\/\?-]*$` 필수 여부: 예 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskFilter) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskFilter) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskFilter) # TaskListEntry 작업 목록에 있는 단일 항목을 나타냅니다. `TaskListEntry`은 [ListTasks](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListTasks.html) 작업이 직접 호출되면 작업 목록이 포함된 배열을 반환합니다. 작업에는 동기화할 소스 및 대상 파일 시스템과 작업에 사용할 옵션이 포함됩니다. ## 내용 ** Name ** 태스크의 이름입니다. 유형: 문자열 길이 제약: 최소 길이는 0. 최대 길이는 256입니다. 패턴: `^[a-zA-Z0-9\s+=._:@/-]+$` 필수 여부: 아니요 ** Status ** 작업의 상태입니다. 타입: 문자열 유효 값: `AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE` 필수 여부: 아니요 ** TaskArn ** 작업의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$` 필수 여부: 아니요 ** TaskMode ** 사용 중인 작업 모드입니다. 자세한 내용은 [데이터 전송을 위한 작업 모드 선택](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)을 참조하세요. 타입: 문자열 유효 값: `BASIC | ENHANCED` 필수 여부: 아니요 ## 참고 언어별 AWS SDKs + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskListEntry) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskListEntry) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskListEntry) # TaskReportConfig 사용자 AWS DataSync전송에 대한 세부 정보를 제공하는 작업 보고서 구성 방법을 지정합니다. 자세한 내용은 [작럽 보고서](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) 단원을 참조하십시오. ## 내용 ** Destination ** DataSync가 작업 보고서를 업로드하는 Amazon S3 버킷을 지정합니다. 자세한 내용은 [작업 보고서](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html#task-report-access) 단원을 참조하십시오. 유형: [ReportDestination](API_ReportDestination.md)객체 필수 여부: 아니요 ** ObjectVersionIds ** 작업 보고서에 S3 버킷으로 전송된 각 객체의 새 버전 포함 여부를 지정합니다. 이는 [버킷의 버전 관리를 활성화](https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html)한 경우에만 적용됩니다. 이 값을 `INCLUDE`로 설정하면 작업 실행 기간이 늘어날 수 있다는 점에 유의하세요. 타입: 문자열 유효 값: `INCLUDE | NONE` 필수 여부: 아니요 ** OutputType ** 원하는 작업 보고서 유형을 지정합니다. + `SUMMARY_ONLY`: 전송된 파일, 개체, 디렉터리 수, 전송 기간 등 작업에 필요한 세부 정보를 제공합니다. + `STANDARD`: 전송, 건너뛰기, 확인된 파일, 개체 및 디렉터리의 전체 목록을 포함하여 작업에 대한 전체 세부 정보를 제공합니다. 타입: 문자열 유효 값: `SUMMARY_ONLY | STANDARD` 필수 여부: 아니요 ** Overrides ** 작업 보고서 측면에 대한 보고 수준을 사용자 지정합니다. 예를 들어 보고서에는 일반적으로 오류만 포함될 수 있지만 DataSync가 대상 위치에서 삭제를 시도한 파일에 대해서만 성공 및 오류 목록을 표시하도록 지정할 수 있습니다. 유형: [ReportOverrides](API_ReportOverrides.md)객체 필수 여부: 아니요 ** ReportLevel ** 작업 보고서에 전송 문제가 발생한 부분만 포함할지 아니면 성공 및 실패 항목의 목록만 포함할지를 지정합니다. + `ERRORS_ONLY`: 보고서에는 DataSync가 전송, 건너뛰기, 확인 및 삭제하지 못한 항목이 표시됩니다. + `SUCCESSES_AND_ERRORS`: 보고서에는 DataSync가 전송, 건너뛰기, 확인 및 삭제할 수 있었던 항목과 할 수 없었던 항목이 표시됩니다. 타입: 문자열 유효 값: `ERRORS_ONLY | SUCCESSES_AND_ERRORS` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskReportConfig) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskReportConfig) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskReportConfig) # TaskSchedule [일정](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html)(최소 1시간 간격)에 따라 실행되도록 AWS DataSync 작업을 구성합니다. ## 내용 ** ScheduleExpression ** Cron 및 Rate 표현식을 사용하여 작업 일정을 지정합니다. 특정 시간 및 날짜에 실행되는 작업 일정에 Cron 표현식을 사용합니다. 예를 들어 다음 Cron 표현식은 매월 첫 번째 수요일 오전 8시에 실행되는 작업 일정을 생성합니다. `cron(0 8 * * 3#1)` 정기적으로 실행되는 작업 일정에 Rate 표현식을 사용합니다. 예를 들어 다음 Rate 표현식은 12시간마다 실행되는 작업 일정을 생성합니다. `rate(12 hours)` Cron 표현식 및 Rate 표현식 구문에 대한 자세한 내용은 [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html)를 참조하세요. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `^[a-zA-Z0-9\ \_\*\?\,\|\^\-\/\#\s\+]*$` 필수 여부: 예 ** Status ** 작업 일정을 활성화할지 아니면 비활성화할지 지정합니다. 일정은 기본적으로 활성화되어 있지만 비활성화해야 하는 상황이 있을 수 있습니다. 예를 들어 작업 문제를 해결하거나 스토리지 시스템에서 유지 관리를 수행하려면 반복 전송을 일시 중지해야 할 수 있습니다. 동일한 오류로 작업이 반복적으로 실패하면 DataSync가 일정을 자동으로 비활성화할 수 있습니다. 자세한 내용은 [TaskScheduleDetails](https://docs.aws.amazon.com/datasync/latest/userguide/API_TaskScheduleDetails.html) 섹션을 참조하세요. 타입: 문자열 유효 값: `ENABLED | DISABLED` 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskSchedule) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskSchedule) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskSchedule) # TaskScheduleDetails AWS DataSync [작업 일정](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html)에 대한 정보를 제공합니다. ## 내용 ** DisabledBy ** 작업 일정이 비활성화된 방식을 나타냅니다. + `USER` - [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html) 작업 또는 DataSync 콘솔을 사용하여 일정을 수동으로 비활성화했습니다. + `SERVICE` - 동일한 오류로 작업이 반복적으로 실패했기 때문에 DataSync에서 일정을 자동으로 비활성화했습니다. 타입: 문자열 유효 값: `USER | SERVICE` 필수 여부: 아니요 ** DisabledReason ** 작업 일정이 비활성화된 경우 이유를 제공합니다. `USER`에서 일정을 비활성화하면 `Manually disabled by user.` 메시지가 표시됩니다. `SERVICE`에서 일정을 비활성화하면 작업이 계속 실패하는 이유를 이해하는 데 도움이 되는 오류 메시지가 표시됩니다. DataSync 오류 해결에 대한 자세한 내용은 [Troubleshooting issues with DataSync transfers](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html) 섹션을 참조하세요. 유형: 문자열 길이 제약: 최대 길이는 8192입니다. 패턴: `^[\w\s.,'?!:;\/=|<>()-]*$` 필수 여부: 아니요 ** StatusUpdateTime ** 작업 일정의 상태가 마지막으로 변경된 시간을 나타냅니다. 예를 들어 반복되는 오류로 인해 DataSync가 자동으로 일정을 비활성화하는 경우 일정이 비활성화된 시기를 확인할 수 있습니다. 유형: 타임스탬프 필수 여부: 아니요 ## 참고 언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오. + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskScheduleDetails) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskScheduleDetails) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskScheduleDetails) # 일반적인 오류 이 단원에는 모든 AWS서비스의 API 작업에 대한 일반 오류가 나와 있습니다. 이 서비스의 API 작업에 대한 오류는 해당 API 작업 항목을 참조하세요. **AccessDeniedException** 이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다. HTTP 상태 코드: 400 **IncompleteSignature** 요청 서명이 AWS표준을 준수하지 않습니다. HTTP 상태 코드: 400 **InternalFailure** 알 수 없는 오류, 예외 또는 장애 때문에 요청 처리가 실패했습니다. HTTP 상태 코드: 500 **InvalidAction** 요청된 동작 또는 작업이 유효하지 않습니다. 작업을 올바로 입력했는지 확인합니다. HTTP 상태 코드: 400 **InvalidClientTokenId** 제공된 X.509 인증서 또는 AWS액세스 키 ID가 AWS의 레코드에 존재하지 않습니다. HTTP 상태 코드: 403 **NotAuthorized** 이 작업을 수행하려면 권한이 있어야 합니다. HTTP 상태 코드: 400 **OptInRequired** AWS 액세스 키 ID는 서비스에 대한 구독이 필요합니다. HTTP 상태 코드: 403 **RequestExpired** 요청이 요청상의 날짜 스탬프로부터 15분 이상, 또는 요청 만료 날짜(예: 미리 서명된 URL)로부터 15분 이상 경과한 후 서비스에 도달했거나, 요청상의 날짜 스탬프가 15분 이상 미래입니다. HTTP 상태 코드: 400 **ServiceUnavailable** 서버의 일시적 장애로 인해 요청이 실패했습니다. HTTP 상태 코드: 503 **ThrottlingException** 요청 제한 때문에 요청이 거부되었습니다. HTTP 상태 코드: 400 **ValidationError** 입력이 AWS서비스에서 지정한 제약에 충족되지 않습니다. HTTP 상태 코드: 400 # 공통 파라미터 다음 목록에는 모든 작업이 쿼리 문자열을 사용하여 Signature Version 4 요청에 서명하는 데 사용하는 파라미터가 포함되어 있습니다. 작업별 파라미터는 그 작업에 대한 항목에 나열되어 있습니다. Signature Version 4에 대한 자세한 내용은 **IAM 사용 설명서의 [AWSAPI 요청에 서명](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)을 참조하세요. **Action** 수행할 작업입니다. 타입: 문자열 필수 항목 여부: 예 **Version** 요청이 작성되는 API 버전으로 YYYY-MM-DD 형식으로 표시됩니다. 타입: 문자열 필수 항목 여부: 예 **X-Amz-Algorithm** 요청 서명을 생성하는 데 사용된 해시 알고리즘입니다. 조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다. 타입: 문자열 유효 값: `AWS4-HMAC-SHA256` 필수 항목 여부: 조건부 **X-Amz-Credential** 자격 증명 범위 값이며 액세스 키, 날짜, 대상으로 하는 리전, 요청하는 서비스 및 종료 문자열("aws4\$1request")이 포함된 문자열입니다. 값은 다음 형식으로 표시됩니다. *access\$1key*/*YYYYMMDD*/*region*/*service*/aws4\$1request. 자세한 내용은 **IAM 사용 설명서의 [서명된 AWSAPI 요청 생성](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)을 참조하세요. 조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다. 타입: 문자열 필수 항목 여부: 조건부 **X-Amz-Date** 서명을 만드는 데 사용되는 날짜입니다. 형식은 ISO 8601 기본 형식(YYYYMMDD'T'HHMMSS'Z')이어야 합니다. 예를 들어 다음 날짜 시간은 유효한 X-Amz-Date 값: `20120325T120000Z`. 조건: X-Amz-Date는 모든 요청에서 옵션이지만 서명 요청에 사용되는 날짜보다 우선할 때 사용됩니다. 날짜 헤더가 ISO 8601 기본 형식으로 지정된 경우 X-Amz-Date가 필요하지 않습니다. X-Amz-Date를 사용하는 경우 항상 Date 헤더의 값을 재정의합니다. 자세한 내용은 **IAM 사용 설명서의 [AWSAPI 요청 서명의 요소](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html)를 참조하세요. 타입: 문자열 필수 항목 여부: 조건부 **X-Amz-Security-Token** AWS Security Token Service(AWS STS)에 대한 호출을 통해 받은 임시 보안 토큰입니다. AWS STS의 임시 보안 인증 정보를 지원하는 서비스 목록은 **IAM 사용 설명서의 [IAM으로 작업하는 AWS 서비스](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)를 참조하세요. 조건: AWS STS의 임시 보안 인증 정보를 사용하는 경우 보안 토큰을 포함시켜야 합니다. 타입: 문자열 필수 항목 여부: 조건부 **X-Amz-Signature** 서명할 문자열과 파생된 서명 키에서 계산된 16진수로 인코딩된 서명을 지정합니다. 조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다. 타입: 문자열 필수 항목 여부: 조건부 **X-Amz-SignedHeaders** 표준 요청의 일부로 포함된 모든 HTTP 헤더를 지정합니다. 서명된 헤더 지정에 대한 자세한 내용은 **IAM 사용 설명서의 [서명된 AWSAPI 요청 생성](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)을 참조하세요. 조건: HTTP 권한 부여 헤더 대신 쿼리 문자열에 인증 정보를 포함하는 경우 이 파라미터를 지정합니다. 타입: 문자열 필수 항목 여부: 조건부