REST 리소스: projects.locations.transferConfigs

리소스: TransferConfig

데이터 전송 구성을 나타냅니다. 전송 구성에는 데이터 전송을 수행하는 데 필요한 모든 메타데이터가 포함됩니다. 예를 들어 destinationDatasetId는 데이터가 저장되어야 하는 위치를 지정합니다. 새 전송 구성을 만들 때 필요한 경우 지정된 destinationDatasetId가 생성되고 적절한 데이터 소스 서비스 계정과 공유됩니다.

JSON 표현 

{
  "name": string,
  "displayName": string,
  "dataSourceId": string,
  "params": {
    object
  },
  "schedule": string,
  "scheduleOptions": {
    object (ScheduleOptions)
  },
  "dataRefreshWindowDays": integer,
  "disabled": boolean,
  "updateTime": string,
  "nextRunTime": string,
  "state": enum (TransferState),
  "userId": string,
  "datasetRegion": string,
  "notificationPubsubTopic": string,
  "emailPreferences": {
    object (EmailPreferences)
  },
  "destinationDatasetId": string
}
필드
name

string

전송 구성의 리소스 이름입니다. 전송 구성 이름의 형식은 projects/{projectId}/locations/{region}/transferConfigs/{configId}입니다. 이름은 CreateTransferConfigRequest에 지정된 configId를 기반으로 projectId 및 리전과 함께 자동으로 생성됩니다. configId를 제공하지 않으면 일반적으로 configId에 해당하는 uuid가 생성되지만 반드시 그렇거나 그래야 하는 것은 아닙니다.
displayName

string

데이터 전송의 사용자 지정 표시 이름입니다.
dataSourceId

string

데이터 소스 ID입니다. 데이터 전송이 생성된 후에는 변경할 수 없습니다.
params

object (Struct format)

데이터 전송별 매개변수입니다.
schedule

string

데이터 전송 일정. 데이터 소스가 맞춤 일정을 지원하지 않는 경우 비어 있어야 합니다. 비어 있으면 데이터 소스의 기본값이 사용됩니다. 지정된 시간은 UTC 형식입니다. 유효한 형식의 예를 들면 1st,3rd monday of month 15:30, every wed,fri of jan,jun 13:15, first sunday of quarter 00:00입니다. 형식에 대한 자세한 설명은 https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format을 참조하세요. 참고: 단위는 최소 8시간이거나 빈도가 더 낮아야 합니다.
scheduleOptions

object (ScheduleOptions)

데이터 전송 일정을 맞춤설정하는 옵션입니다.
dataRefreshWindowDays

integer

데이터를 자동으로 새로 고치기 위해 확인할 과거의 날짜 수입니다. 예를 들어 dataRefreshWindowDays = 10이면 BigQuery는 매일 [오늘-1]의 데이터만 수집하지 않고 [오늘-10, 오늘-1]의 데이터를 다시 수집합니다. 데이터 소스가 이 기능을 지원하는 경우에만 유효합니다. 기본값을 사용하려면 이 값을 0으로 설정합니다.
disabled

boolean

이 구성의 사용이 중지되었는지 여부입니다. true로 설정하면 지정된 전송의 실행이 예약되지 않습니다.
updateTime

string (Timestamp format)

출력 전용. 데이터 전송 수정 시간입니다. 입력 시 서버에서 무시됩니다.
nextRunTime

string (Timestamp format)

출력 전용. 다음에 데이터 전송이 실행되는 시간입니다.
state

enum (TransferState)

출력 전용. 가장 최근에 업데이트된 전송 실행의 상태입니다.
userId

string (int64 format)

지원이 중단되었습니다. 전송이 처리되는 사용자의 고유 ID입니다.
datasetRegion

string

출력 전용. BigQuery 데이터 세트가 있는 리전입니다.
notificationPubsubTopic

string

이 전송 구성과 연결된 전송 실행이 완료된 후 알림을 전송할 Pub/Sub 주제입니다.
emailPreferences

object (EmailPreferences)

이러한 환경설정에 따라 이 전송 구성의 소유자 이메일 주소로 이메일 알림이 전송됩니다.
destinationDatasetId

string

BigQuery 대상 데이터 세트 ID입니다.

ScheduleOptions

데이터 전송 일정을 맞춤설정하는 옵션입니다.

JSON 표현 

{
  "disableAutoScheduling": boolean,
  "startTime": string,
  "endTime": string
}
필드
disableAutoScheduling

boolean

true이면 이 구성의 데이터 전송 실행 자동 예약이 사용 중지됩니다. transferConfigs.startManualRuns API를 사용하여 임시로 실행을 시작할 수 있습니다. 자동 예약이 사용 중지되면 TransferConfig.schedule 필드가 무시됩니다.
startTime

string (Timestamp format)

전송 실행 예약 시작 시간을 지정합니다. 첫 번째 실행은 일정 문자열에 정의된 반복 패턴에 따라 시작 시간 또는 그 이후에 예약됩니다. 시작 시간은 언제든지 변경할 수 있습니다. 데이터 전송을 직접 트리거할 수 있는 시간은 이 옵션으로 제한되지 않습니다.
endTime

string (Timestamp format)

전송 실행 예약 중지 시간을 정의합니다. 종료 시간 또는 그 이후에는 전송 실행을 예약할 수 없습니다. 종료 시간은 언제든지 변경할 수 있습니다. 데이터 전송을 직접 트리거할 수 있는 시간은 이 옵션으로 제한되지 않습니다.

메서드

create

 새 데이터 전송 구성을 만듭니다.

delete

 연결된 전송 실행 및 로그를 포함하여 데이터 전송 구성을 삭제합니다.

get

 데이터 전송 구성에 대한 정보를 반환합니다.

list

 프로젝트의 모든 데이터 전송에 대한 정보를 반환합니다.

patch

 데이터 전송 구성을 업데이트합니다.

scheduleRuns
(deprecated)

 시간 범위 [start_time, end_time]의 전송 실행을 만듭니다.

startManualRuns

 현재 시간과 동일한 schedule_time을 사용하여 직접 전송 실행을 시작합니다.