StartTaskExecution - AWS DataSync
요청 구문요청 파라미터응답 구문응답 요소오류예시참고 항목

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

StartTaskExecution

AWS DataSync태스크를 시작합니다. 각 작업에 대해 한 번에 하나의 작업 실행만 실행할 수 있습니다.

작업 실행에는 여러 단계가 있습니다. 자세한 내용을 알아보려면 태스크 실행 상태를 참조하세요.

중요

Amazon S3 위치 간에 데이터를 전송하려는 경우 시작하기 전에 S3 요청 요금 및 DataSync요금 페이지에 어떤 영향을 미칠 DataSync 수 있는지 검토하십시오.

요청 구문

{
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "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"
}

요청 파라미터

모든 작업에 공통적인 파라미터에 대한 자세한 내용은 범용 파라미터를 참조하십시오.

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

Excludes

태스크에서 제외할 파일을 결정하는 필터 규칙 목록을 지정합니다. 목록에는 제외할 패턴으로 구성된 단일 필터 문자열이 들어 있습니다. 패턴은 "|"(즉, 파이프)로 구분됩니다(예: "/folder1|/folder2").

유형: FilterRule 객체 배열

배열 멤버: 최소 항목 수는 0개입니다. 최대 항목 수는 1개입니다.

필수 항목 여부: 아니요

Includes

태스크 실행 중 포함시킬 파일을 결정하는 필터 규칙 목록을 지정합니다. 패턴에는 포함시킬 패턴으로 구성된 단일 필터 문자열이 포함되어야 합니다. 패턴은 "|"(즉, 파이프)로 구분됩니다(예: "/folder1|/folder2").

유형: FilterRule 객체 배열

배열 멤버: 최소 항목 수는 0개입니다. 최대 항목 수는 1개입니다.

필수 항목 여부: 아니요

OverrideOptions

AWS DataSync작업 설정을 구성합니다. 이러한 옵션에는 파일, 객체 및 관련 메타데이터를 DataSync 처리하는 방법이 포함됩니다. 또한 데이터 무결성을 DataSync 검증하는 방법을 지정하고 작업에 대한 대역폭 제한을 설정하는 등의 옵션을 지정할 수 있습니다.

각 작업 설정에는 기본값이 있습니다. 꼭 필요한 경우가 아니면 작업을 시작하기 Options 전에 이러한 설정을 구성하지 않아도 됩니다.

유형: Options 객체

필수 항목 여부: 아니요

Tags

태스크 실행을 나타내는 Amazon 리소스 이름 (ARN) 에 적용할 태그를 지정합니다.

태그 는 리소스를 관리, 필터링 및 검색하는 데 도움이 되는 키-값 페어입니다. DataSync

유형: TagListEntry 객체 배열

배열 멤버: 최소 항목 수는 0개입니다. 최대 항목 수 50개.

필수 항목 여부: 아니요

TaskArn

시작할 태스크의 Amazon 리소스 이름 (ARN) 을 지정합니다.

유형: String

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

패턴: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]*:[0-9]{12}:task/task-[0-9a-f]{17}$

Required: Yes

응답 구문

{
   "TaskExecutionArn": "string"
}

응답 요소

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

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

TaskExecutionArn

실행 중인 태스크 실행의 ARN입니다.

유형: String

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

패턴: ^arn:(aws|aws-cn|aws-us-gov|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}$

오류

모든 작업에 공통적으로 나타나는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.

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"
}

참고 항목

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.