REST Resource: transferJobs

리소스: TransferJob

이 리소스는 주기적으로 실행되는 전송 작업의 구성을 나타냅니다.

JSON 표현
{
  "name": string,
  "description": string,
  "projectId": string,
  "transferSpec": {
    object (TransferSpec)
  },
  "replicationSpec": {
    object (ReplicationSpec)
  },
  "notificationConfig": {
    object (NotificationConfig)
  },
  "loggingConfig": {
    object (LoggingConfig)
  },
  "schedule": {
    object (Schedule)
  },
  "eventStream": {
    object (EventStream)
  },
  "status": enum (Status),
  "creationTime": string,
  "lastModificationTime": string,
  "deletionTime": string,
  "latestOperationName": string
}
필드
name

string

작업이 생성될 때 할당되는 전송 프로젝트 내의 고유한 이름입니다. CreateTransferJobRequest에서 이 필드가 비어 있으면 Storage Transfer Service에서 고유한 이름을 할당합니다. 그렇지 않으면 지정된 이름이 이 작업의 고유한 이름으로 사용됩니다.

지정된 이름이 작업에서 사용 중이면 ALREADY_EXISTS 오류가 발생하여 생성 요청이 실패합니다.

이 이름은 "transferJobs/" 접두사로 시작하고 문자 또는 숫자로 끝나야 하며 128자(영문 기준) 이하여야 합니다. PosixFilesystem이 포함된 전송의 경우 이 이름은 특히 transferJobs/OPI로 시작해야 합니다. 다른 모든 전송 유형의 경우 이 이름이 transferJobs/OPI로 시작하면 안 됩니다.

비PosixFilesystem 예: "transferJobs/^(?!OPI)[A-Za-z0-9-._~]*[A-Za-z0-9]$"

PosixFilesystem 예: "transferJobs/OPI^[A-Za-z0-9-._~]*[A-Za-z0-9]$"

애플리케이션은 OPI와 관련된 이름 지정 요구사항의 시행에 의존해서는 안 됩니다.

잘못된 작업 이름은 INVALID_ARGUMENT 오류와 함께 실패합니다.

description

string

사용자가 작업에 대해 제공한 설명입니다. Unicode로 인코딩된 경우 최대 길이는 1,024바이트입니다.

projectId

string

작업을 소유한 Google Cloud 프로젝트의 ID입니다.

transferSpec

object (TransferSpec)

전송 사양

replicationSpec

object (ReplicationSpec)

복제 사양

notificationConfig

object (NotificationConfig)

알림 구성

loggingConfig

object (LoggingConfig)

로깅 구성입니다.

schedule

object (Schedule)

전송 작업의 일정을 지정합니다. 이 필드는 선택 사항입니다. 이 필드가 설정되지 않으면 transferJobs.run을 호출하거나 비어 있지 않은 일정을 갖도록 작업을 업데이트하지 않는 한 작업이 전송을 실행하지 않습니다.

eventStream

object (EventStream)

이벤트 기반 전송의 전송 작업에 대한 이벤트 스트림을 지정합니다. EventStream가 지정되면 Schedule 필드는 무시됩니다.

status

enum (Status)

작업 상태입니다. 이 값은 CreateTransferJobRequests에 지정해야 합니다.

참고: 새 작업 상태의 효과는 후속 작업 실행 중에 적용됩니다. 예를 들어 작업 상태를 ENABLED에서 DISABLED로 변경하고 전송에서 생성된 작업이 실행 중인 경우 상태 변경은 현재 작업에 영향을 미치지 않습니다.

creationTime

string (Timestamp format)

출력 전용입니다. 전송 작업이 생성된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

lastModificationTime

string (Timestamp format)

출력 전용입니다. 전송 작업이 마지막으로 수정된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

deletionTime

string (Timestamp format)

출력 전용입니다. 전송 작업이 삭제된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

latestOperationName

string

이 JobConfig에서 가장 최근에 시작된 TransferOperation의 이름입니다. 이 JobConfig에 대해 TransferOperation이 생성된 경우 표시됩니다.

ReplicationSpec

버킷 간 복제 작업의 구성을 지정합니다. 교차 버킷 복제는 새 객체 또는 업데이트된 객체를 소스 Cloud Storage 버킷에서 대상 Cloud Storage 버킷으로 복사합니다. 새 버킷 간 복제 작업은 소스 버킷의 기존 객체를 복사하지 않습니다.

JSON 표현
{
  "objectConditions": {
    object (ObjectConditions)
  },
  "transferOptions": {
    object (