Method: projects.locations.identityMappingStores.purgeIdentityMappings

Exclui as entradas de mapeamento de identidade especificadas ou todas de um repositório de mapeamento de identidade.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
identityMappingStore

string

Obrigatório. O nome do armazenamento de mapeamento de identidade de onde as entradas de mapeamento de identidade serão excluídas. Formato: projects/{project}/locations/{location}/identityMappingStores/{identityMappingStore}

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação 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
}
Campos
filter

string

Filtre os mapeamentos de identidade correspondentes a serem excluídos. O campo qualificado para filtragem é: * updateTime: no formato ISO 8601 "zulu". * externalId

Exemplos:

  • Excluir todos os mapeamentos de identidade atualizados em um período: updateTime > "2012-04-23T18:25:43.511Z" AND updateTime < "2012-04-23T18:30:43.511Z"
  • Excluindo todos os mapeamentos de identidade para um determinado externalId: externalId = "id1"
  • Excluir todos os mapeamentos de identidade em um armazenamento de mapeamento de identidade: *

Os campos de filtragem têm um AND implícito. Não pode ser usado com a origem. Um erro será gerado se ambos forem fornecidos.
Campo de união source. A origem da entrada. source pode ser apenas de um dos tipos a seguir:
inlineSource

object (InlineSource)

A origem in-line de onde as entradas de mapeamento de identidade serão excluídas.
force

boolean

Realiza a limpeza. Se force for definido como "false", retorne a contagem de limpeza esperada sem excluir nenhum mapeamento de identidade. Esse campo só é compatível com a exclusão permanente com filtro. Para a origem de entrada, esse campo é ignorado, e os dados são excluídos independente do valor dele.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso identityMappingStore:

  • discoveryengine.identityMappingStores.purgeIdentityMappings

Para mais informações, consulte a documentação do IAM.

InlineSource

A origem in-line de onde as entradas de mapeamento de identidade serão excluídas.

Representação JSON 
{
  "identityMappingEntries": [
    {
      object (IdentityMappingEntry)
    }
  ]
}
Campos
identityMappingEntries[]

object (IdentityMappingEntry)

É possível excluir no máximo 10.000 entradas por vez.