Method: projects.locations.identityMappingStores.purgeIdentityMappings

ID 매핑 스토어에서 지정된 ID 매핑 항목 또는 모든 ID 매핑 항목을 삭제합니다.

HTTP 요청

POST https://discoveryengine.googleapis.com/v1alpha/{identityMappingStore=projects/*/locations/*/identityMappingStores/*}:purgeIdentityMappings

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

경로 매개변수

매개변수
identityMappingStore

string

필수 항목입니다. ID 매핑 항목을 삭제할 ID 매핑 저장소의 이름입니다. 형식: projects/{project}/locations/{location}/identityMappingStores/{identityMappingStore}

요청 본문

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

JSON 표현 
{
  "filter": string,

  // Union field source can be only one of the following:
  "inlineSource": {
    object (InlineSource)
  }
  // End of list of possible types for union field source.
  "force": boolean
}
필드
filter

string

삭제할 일치하는 ID 매핑을 필터링합니다. 필터링할 수 있는 필드는 다음과 같습니다. * updateTime: ISO 8601 'zulu' 형식 * externalId

예:

  • 특정 기간에 업데이트된 모든 ID 매핑 삭제: updateTime > "2012-04-23T18:25:43.511Z" AND updateTime < "2012-04-23T18:30:43.511Z"
  • 지정된 externalId의 모든 ID 매핑 삭제: externalId = "id1"
  • ID 매핑 저장소 내의 모든 ID 매핑 삭제: *

필터링 필드에는 암시적 AND가 있다고 가정됩니다. 소스와 함께 사용해서는 안 됩니다. 두 매개변수가 모두 제공되면 오류가 발생합니다.
통합 필드 source. 입력 소스입니다. source은 다음 중 하나여야 합니다.
inlineSource

object (InlineSource)

ID 매핑 항목을 삭제할 인라인 소스입니다.
force

boolean

실제로 삭제를 실행합니다. force가 false로 설정되면 ID 매핑을 삭제하지 않고 예상되는 삭제 횟수를 반환합니다. 이 필드는 필터로 삭제하는 경우에만 지원됩니다. 입력 소스의 경우 이 필드는 무시되며 이 필드의 값과 관계없이 데이터가 삭제됩니다.

응답 본문

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

승인 범위

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

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

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

IAM 권한

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

  • discoveryengine.identityMappingStores.purgeIdentityMappings

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

InlineSource

ID 매핑 항목을 삭제할 인라인 소스입니다.

JSON 표현 
{
  "identityMappingEntries": [
    {
      object (IdentityMappingEntry)
    }
  ]
}
필드
identityMappingEntries[]

object (IdentityMappingEntry)

한 번에 최대 10,000개의 항목을 삭제할 수 있습니다.