Method: transferJobs.patch

전송 작업을 업데이트합니다. 작업의 전송 사양을 업데이트해도 이미 실행 중인 전송 작업에는 영향을 미치지 않습니다.

참고: 이 RPC를 사용하여 작업의 status 필드를 수정할 수 있습니다 (예: 작업 상태를 DELETED, DISABLED 또는 ENABLED로 설정).

HTTP 요청

PATCH https://storagetransfer.googleapis.com/v1/{jobName=transferJobs/**}

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
jobName

string

필수 입력란입니다. 업데이트할 작업의 이름입니다.

승인을 처리하려면 지정된 리소스 jobName에 대해 다음과 같은 IAM 권한이 필요합니다.

  • storagetransfer.jobs.update

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "projectId": string,
  "transferJob": {
    object (TransferJob)
  },
  "updateTransferJobFieldMask": string
}
필드
projectId

string

필수 입력란입니다. 작업을 소유한 Google Cloud 프로젝트의 ID입니다.
transferJob

object (TransferJob)

필수 입력란입니다. 업데이트할 작업입니다. transferJob는 description, transferSpec, notificationConfig, loggingConfig, status 중 하나 이상의 필드를 지정해야 합니다. 다른 필드를 지정하는 UpdateTransferJobRequest는 INVALID_ARGUMENT 오류와 함께 거부됩니다. 작업 상태를 DELETED로 업데이트하려면 storagetransfer.jobs.delete 권한이 필요합니다.
updateTransferJobFieldMask

string (FieldMask format)

이 요청에서 업데이트할 transferJob의 필드의 필드 마스크입니다. transferJob에서 업데이트할 수 있는 필드는 description, transferSpec, notificationConfig, loggingConfig, status입니다. 작업의 transferSpec를 업데이트하려면 전체 전송 사양을 제공해야 합니다. 필수 입력란이 누락된 불완전한 사양은 INVALID_ARGUMENT 오류와 함께 거부됩니다.

정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"

응답 본문

성공한 경우 응답 본문에 TransferJob의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참고하세요.