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

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

UpdateTask

작업과 연결된 메타데이터를 업데이트합니다.

요청 구문

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

요청 파라미터

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

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

CloudWatchLogGroupArn

AmazonCloudWatch 로그 그룹의 리소스 이름에 사용되는 Amazon 리소스 이름 (ARN) 입니다.

유형: String

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

패턴: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$

필수 항목 여부: 아니요

Excludes

전송 중 특정 데이터를 제외하는 필터 규칙의 목록을 지정합니다. 자세한 내용과 예제는 전송된 데이터 필터링 을 참조하세요DataSync.

유형: FilterRule 객체 배열

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

필수 항목 여부: 아니요

Includes

전송 중 특정 데이터를 포함하는 필터 규칙의 목록을 지정합니다. 자세한 내용과 예제는 전송된 데이터 필터링 을 참조하세요DataSync.

유형: FilterRule 객체 배열

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

필수 항목 여부: 아니요

Name

업데이트할 작업의 이름입니다.

유형: String

길이 제약: 최소 길이는 1입니다. 최대 길이 256.

Pattern: ^[a-zA-Z0-9\s+=._:@/-]+$

필수 항목 여부: 아니요

Options

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

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

유형: Options 객체

필수 항목 여부: 아니요

Schedule

소스에서 대상 위치로 파일을 주기적으로 전송하는 데 사용되는 일정을 지정합니다. 매시간, 일별, 주별 또는 특정 요일에 실행되도록 작업을 구성할 수 있습니다. 작업을 실행할 날짜 또는 시간을 제어할 수 있습니다. 지정한 시간은 UTC 시간입니다. 자세한 내용을 알아보려면 태스크 예약을 참조하세요.

유형: TaskSchedule 객체

필수 항목 여부: 아니요

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

필수 항목 여부: 예

응답 요소

작업이 성공하면 서비스가 비어있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

오류

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

InternalException

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

HTTP 상태 코드: 500

InvalidRequestException

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

HTTP 상태 코드: 400

참고 항목

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