Method: projects.locations.identityMappingStores.purgeIdentityMappings

指定された ID マッピング エントリまたはすべての ID マッピング エントリを ID マッピング ストアから削除します。

HTTP リクエスト

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

この URL では gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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 件です