Method: projects.locations.collections.dataConnector.startConnectorRun

DataConnector의 즉각적인 동기화 프로세스를 시작합니다. 서드 파티 커넥터 사용자는 동기화할 항목을 지정해야 합니다. FHIR 커넥터는 데이터를 동기화해야 하는 시점을 나타내는 타임스탬프를 제공해야 합니다.

HTTP 요청

POST https://discoveryengine.googleapis.com/v1alpha/{parent=projects/*/locations/*/collections/*/dataConnector}:startConnectorRun

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. projects/{project}/locations/{location}/collections/ {collectionId}/dataConnector 형식의 커넥터 이름

요청 본문

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

JSON 표현 
{
  "entities": [
    string
  ],
  "healthcareFhirResourceTypes": [
    string
  ],
  "forceRefreshContent": boolean,
  "syncIdentity": boolean,
  "syncSinceTimestamp": string
}
필드
entities[]

string

동기화해야 하는 서드 파티 커넥터 항목을 지정합니다. 지정하지 않으면 모든 항목이 동기화됩니다.
healthcareFhirResourceTypes[]

string

가져올 FHIR 리소스 유형입니다. 리소스 유형은 모든 지원되는 FHIR 리소스 유형의 하위 집합이어야 합니다. 비어 있는 경우 지원되는 모든 FHIR 리소스 유형으로 기본 설정됩니다.
forceRefreshContent

boolean

(선택사항) 문서의 비구조화 콘텐츠를 강제로 새로고침할지 여부입니다.

true로 설정된 경우 참조 콘텐츠의 업데이트 상태와 관계없이 문서의 콘텐츠 부분이 새로고침됩니다.
syncIdentity

boolean

true인 경우 ID 동기화를 트리거합니다.
syncSinceTimestamp

string (Timestamp format)

스트리밍/일괄 데이터 커넥터의 데이터를 동기화해야 하는 시점을 나타내는 타임스탬프입니다. 이 필드는 Healthcare Connector에만 사용됩니다.

생성된 출력은 항상 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"입니다.

응답 본문

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

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

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

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • discoveryengine.dataConnectors.startConnectorRun

자세한 내용은 IAM 문서를 참조하세요.