기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 작업 다음 작업이 지원됩니다. + [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)