Method: projects.locations.dataAgents.patch

단일 DataAgent 파라미터를 업데이트합니다.

HTTP 요청

PATCH https://geminidataanalytics.googleapis.com/v1beta/{dataAgent.name=projects/*/locations/*/dataAgents/*}

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

경로 매개변수

매개변수
dataAgent.name

string

선택사항. 식별자. DataAgent의 고유 리소스 이름입니다. 형식: projects/{project}/locations/{location}/dataAgents/{dataAgentId} {dataAgent}은 리소스 ID이며 63자 이하여야 하고 https://google.aip.dev/122#resource-id-segments에 설명된 형식과 일치해야 합니다.

예: projects/1234567890/locations/us-central1/dataAgents/my-agent

이 필드는 자동으로 추론되고 {parent}/dataAgents/{dataAgentId}로 덮어쓰이므로 에이전트 생성 중에 이 필드를 설정하지 않는 것이 좋습니다.

쿼리 매개변수

파라미터
updateMask

string (FieldMask format)

선택사항. 필드 마스크는 업데이트로 DataAgent 리소스에서 덮어쓸 필드를 지정하는 데 사용됩니다. updateMask에 지정된 필드는 전체 요청이 아닌 해당 리소스를 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다. 사용자가 마스크를 제공하지 않으면 요청에서 기본값이 아닌 모든 필드를 덮어씁니다. 와일드카드 마스크를 제공하면 모든 필드를 덮어씁니다.

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

string

선택사항. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

요청 본문

요청 본문에 DataAgent의 인스턴스가 포함됩니다.

응답 본문

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

승인 범위

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

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

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

IAM 권한

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

  • geminidataanalytics.dataAgents.update

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