Indexers - Get

Serviço:: Search Service

Versão da API:: 2026-04-01

Recupera uma definição de indexador.

GET {endpoint}/indexers('{indexerName}')?api-version=2026-04-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
endpoint	path	True	string (uri)	A URL do ponto de extremidade do serviço de pesquisa.
indexerName	path	True	string	O nome do indexador.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
Accept		Accept	O cabeçalho Aceitar.
x-ms-client-request-id		string (uuid)	Um identificador de cadeia de caracteres opaco, globalmente exclusivo e gerado pelo cliente para a solicitação.

Respostas

Nome	Tipo	Description
200 OK	SearchIndexer	A solicitação foi bem-sucedida.
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

api-key

Tipo: apiKey
Em: header

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Escopos

Nome	Description
https://search.azure.com/.default

Exemplos

SearchServiceGetIndexer

Solicitação de exemplo

HTTP

GET https://exampleservice.search.windows.net/indexers('myindexer')?api-version=2026-04-01

Resposta de exemplo

Código de status:: 200

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "myindexer",
  "description": "Description of the indexer",
  "dataSourceName": "indexertestdatasource",
  "skillsetName": "myskillset",
  "targetIndexName": "example-index",
  "disabled": false,
  "schedule": {
    "interval": "P1D",
    "startTime": "2024-06-06T00:01:50.265Z"
  },
  "parameters": {
    "batchSize": 10,
    "maxFailedItems": 10,
    "maxFailedItemsPerBatch": 5,
    "configuration": {}
  },
  "fieldMappings": [
    {
      "sourceFieldName": "/document",
      "targetFieldName": "name",
      "mappingFunction": {
        "name": "base64Encode"
      }
    }
  ],
  "outputFieldMappings": [
    {
      "sourceFieldName": "/document",
      "targetFieldName": "name",
      "mappingFunction": {
        "name": "base64Encode"
      }
    }
  ]
}

Definições

Nome	Description
Accept	O cabeçalho Aceitar.
BlobIndexerDataToExtract	Especifica os dados a serem extraídos do armazenamento de blobs do Azure e informa ao indexador quais dados extrair do conteúdo da imagem quando "imageAction" é definido como um valor diferente de "none". Isso se aplica ao conteúdo de imagem inserido em um .PDF ou outro aplicativo, ou a arquivos de imagem, como .jpg e .png, em blobs do Azure.
BlobIndexerImageAction	Determina como processar imagens inseridas e arquivos de imagem no armazenamento de blobs do Azure. Definir a configuração "imageAction" como qualquer valor diferente de "none" requer que um conjunto de habilidades também seja anexado a esse indexador.
BlobIndexerParsingMode	Representa o modo de análise para indexação de uma fonte de dados de blob do Azure.
BlobIndexerPDFTextRotationAlgorithm	Determina o algoritmo para extração de texto de arquivos PDF no armazenamento de blobs do Azure.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta comum de erro para todas as APIs do Azure Resource Manager devolver detalhes de erro em operações falhadas. (Isso também segue o formato de resposta de erro OData.).
FieldMapping	Define um mapeamento entre um campo em uma fonte de dados e um campo de destino em um índice.
FieldMappingFunction	Representa uma função que transforma um valor de uma fonte de dados antes da indexação.
IndexerExecutionEnvironment	Especifica o ambiente no qual o indexador deve ser executado.
IndexingParameters	Representa parâmetros para a execução do indexador.
IndexingParametersConfiguration	Um dicionário de propriedades de configuração específicas do indexador. Cada nome é o nome de uma propriedade específica. Cada valor deve ser de um tipo primitivo.
IndexingSchedule	Representa um agendamento para a execução do indexador.
SearchIndexer	Representa um indexador.
SearchIndexerDataNoneIdentity	Limpa a propriedade de identidade de uma fonte de dados.
SearchIndexerDataUserAssignedIdentity	Especifica a identidade de uma fonte de dados a ser usada.
SearchResourceEncryptionKey	Uma chave de criptografia gerenciada pelo cliente no Azure Key Vault. As chaves que você cria e gerencia podem ser usadas para criptografar ou descriptografar dados em repouso, como índices e mapas de sinônimos.

Accept

Enumeração

O cabeçalho Aceitar.

Valor	Description
application/json;odata.metadata=minimal

BlobIndexerDataToExtract

Enumeração

Especifica os dados a serem extraídos do armazenamento de blobs do Azure e informa ao indexador quais dados extrair do conteúdo da imagem quando "imageAction" é definido como um valor diferente de "none". Isso se aplica ao conteúdo de imagem inserido em um .PDF ou outro aplicativo, ou a arquivos de imagem, como .jpg e .png, em blobs do Azure.

Valor	Description
storageMetadata	Indexa apenas as propriedades de blob padrão e os metadados especificados pelo usuário.
allMetadata	Extrai metadados fornecidos pelo subsistema de armazenamento de blobs do Azure e os metadados específicos do tipo conteúdo (por exemplo, metadados exclusivos para apenas .png arquivos são indexados).
contentAndMetadata	Extrai todos os metadados e conteúdo textual de cada blob.

BlobIndexerImageAction

Enumeração

Determina como processar imagens inseridas e arquivos de imagem no armazenamento de blobs do Azure. Definir a configuração "imageAction" como qualquer valor diferente de "none" requer que um conjunto de habilidades também seja anexado a esse indexador.

Valor	Description
none	Ignora imagens inseridas ou arquivos de imagem no conjunto de dados. Esse é o padrão.
generateNormalizedImages	Extrai texto de imagens (por exemplo, a palavra "PARAR" de um sinal de parada de tráfego) e insere-o no campo de conteúdo. Essa ação requer que "dataToExtract" seja definido como "contentAndMetadata". Uma imagem normalizada refere-se ao processamento adicional que resulta em saída de imagem uniforme, dimensionada e girada para promover a renderização consistente quando você inclui imagens nos resultados da pesquisa visual. Essas informações são geradas para cada imagem quando você usa essa opção.
generateNormalizedImagePerPage	Extrai texto de imagens (por exemplo, a palavra "PARAR" de um sinal de parada de tráfego) e insere-o no campo de conteúdo, mas trata arquivos PDF de forma diferente, pois cada página será renderizada como uma imagem e normalizada de acordo, em vez de extrair imagens inseridas. Tipos de arquivo não PDF serão tratados da mesma forma que se "generateNormalizedImages" foi definido.

BlobIndexerParsingMode

Enumeração

Representa o modo de análise para indexação de uma fonte de dados de blob do Azure.

Valor	Description
default	Definido como padrão para o processamento de arquivo normal.
text	Defina como texto para melhorar o desempenho de indexação em arquivos de texto sem formatação no armazenamento de blobs.
delimitedText	Defina como delimititedText quando os blobs forem arquivos CSV sem formatação.
json	Defina como json para extrair conteúdo estruturado de arquivos JSON.
jsonArray	Defina como jsonArray para extrair elementos individuais de uma matriz JSON como documentos separados.
jsonLines	Defina como jsonLines para extrair entidades JSON individuais, separadas por uma nova linha, como documentos separados.
markdown	Defina como markdown para extrair conteúdo de arquivos markdown.

BlobIndexerPDFTextRotationAlgorithm

Enumeração

Determina o algoritmo para extração de texto de arquivos PDF no armazenamento de blobs do Azure.

Valor	Description
none	Aproveita a extração normal de texto. Esse é o padrão.
detectAngles	Pode produzir uma extração de texto melhor e mais legível de arquivos PDF que têm texto girado dentro deles. Observe que pode haver um pequeno impacto na velocidade de desempenho quando esse parâmetro é usado. Esse parâmetro só se aplica a arquivos PDF e somente a PDFs com texto inserido. Se o texto girado aparecer dentro de uma imagem inserida no PDF, esse parâmetro não se aplicará.

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info		As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta comum de erro para todas as APIs do Azure Resource Manager devolver detalhes de erro em operações falhadas. (Isso também segue o formato de resposta de erro OData.).

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

FieldMapping

Objeto

Define um mapeamento entre um campo em uma fonte de dados e um campo de destino em um índice.

Nome	Tipo	Description
mappingFunction	FieldMappingFunction	Uma função a ser aplicada a cada valor de campo de origem antes da indexação.
sourceFieldName	string	O nome do campo na fonte de dados.
targetFieldName	string	O nome do campo de destino no índice. O mesmo que o nome do campo de origem por padrão.

FieldMappingFunction

Objeto

Representa uma função que transforma um valor de uma fonte de dados antes da indexação.

Nome	Tipo	Description
name	string	O nome da função de mapeamento de campo.
parameters		Um dicionário de pares de nome/valor de parâmetro a serem passados para a função. Cada valor deve ser de um tipo primitivo.

IndexerExecutionEnvironment

Enumeração

Especifica o ambiente no qual o indexador deve ser executado.

Valor	Description
standard	Indica que o serviço de pesquisa pode determinar onde o indexador deve ser executado. Esse é o ambiente padrão quando nada é especificado e é o valor recomendado.
private	Indica que o indexador deve ser executado com o ambiente provisionado especificamente para o serviço de pesquisa. Isso só deve ser especificado como o ambiente de execução se o indexador precisar acessar recursos com segurança por meio de recursos de link privado compartilhados.

IndexingParameters

Objeto

Representa parâmetros para a execução do indexador.

Nome	Tipo	Valor padrão	Description
batchSize	integer (int32)		O número de itens que são lidos da fonte de dados e indexados como um único lote para melhorar o desempenho. O padrão depende do tipo de fonte de dados.
configuration	IndexingParametersConfiguration		Um dicionário de propriedades de configuração específicas do indexador. Cada nome é o nome de uma propriedade específica. Cada valor deve ser de um tipo primitivo.
maxFailedItems	integer (int32)	0	O número máximo de itens que podem falhar na indexação para que a execução do indexador ainda seja considerado bem-sucedido. -1 significa sem limite. O padrão é 0.
maxFailedItemsPerBatch	integer (int32)	0	O número máximo de itens em um único lote que podem falhar na indexação para que o lote ainda seja considerado bem-sucedido. -1 significa sem limite. O padrão é 0.

IndexingParametersConfiguration

Objeto

Um dicionário de propriedades de configuração específicas do indexador. Cada nome é o nome de uma propriedade específica. Cada valor deve ser de um tipo primitivo.

Nome	Tipo	Valor padrão	Description
allowSkillsetToReadFileData	boolean	False	Se for true, criará um caminho //document//file_data que é um objeto que representa os dados de arquivo originais baixados da fonte de dados do blob. Isso permite que você passe os dados de arquivo originais para uma habilidade personalizada para processamento dentro do pipeline de enriquecimento ou para a habilidade de Extração de Documentos.
dataToExtract	BlobIndexerDataToExtract	contentAndMetadata	Especifica os dados a serem extraídos do armazenamento de blobs do Azure e informa ao indexador quais dados extrair do conteúdo da imagem quando "imageAction" é definido como um valor diferente de "none". Isso se aplica ao conteúdo de imagem inserido em um .PDF ou outro aplicativo, ou a arquivos de imagem, como .jpg e .png, em blobs do Azure.
delimitedTextDelimiter	string		Para blobs CSV, especifica o delimitador de caractere único de fim de linha para arquivos CSV em que cada linha inicia um novo documento (por exemplo, "\|").
delimitedTextHeaders	string		Para blobs CSV, especifica uma lista delimitada por vírgulas de cabeçalhos de coluna, útil para mapear campos de origem para campos de destino em um índice.
documentRoot	string		Para matrizes JSON, considerando um documento estruturado ou semiestruturado, você pode especificar um caminho para a matriz usando essa propriedade.
excludedFileNameExtensions	string		Lista delimitada por vírgulas de extensões de nome de arquivo a serem ignoradas ao processar do armazenamento de blobs do Azure. Por exemplo, você pode excluir ".png, .mp4" para ignorar esses arquivos durante a indexação.
executionEnvironment	IndexerExecutionEnvironment	standard	Especifica o ambiente no qual o indexador deve ser executado.
failOnUnprocessableDocument	boolean	False	Para blobs do Azure, defina como false se você quiser continuar indexando se um documento falhar na indexação.
failOnUnsupportedContentType	boolean	False	Para blobs do Azure, defina como false se você quiser continuar indexando quando um tipo de conteúdo sem suporte for encontrado e você não souber todos os tipos de conteúdo (extensões de arquivo) com antecedência.
firstLineContainsHeaders	boolean	True	Para blobs CSV, indica que a primeira linha (não em branco) de cada blob contém cabeçalhos.
imageAction	BlobIndexerImageAction	none	Determina como processar imagens inseridas e arquivos de imagem no armazenamento de blobs do Azure. Definir a configuração "imageAction" como qualquer valor diferente de "none" requer que um conjunto de habilidades também seja anexado a esse indexador.
indexStorageMetadataOnlyForOversizedDocuments	boolean	False	Para blobs do Azure, defina essa propriedade como true para ainda indexar metadados de armazenamento para conteúdo de blob que é muito grande para ser processado. Blobs superdimensionados são tratados como erros por padrão. Para obter limites no tamanho do blob, consulte https://dotnet.territoriali.olinfo.it/azure/search/search-limits-quotas-capacity.
indexedFileNameExtensions	string		Lista delimitada por vírgulas de extensões de nome de arquivo para selecionar ao processar no armazenamento de blobs do Azure. Por exemplo, você pode focar a indexação em arquivos de aplicativo específicos ".docx, .pptx, .msg" para incluir especificamente esses tipos de arquivo.
markdownHeaderDepth	enum: h1 h2 h3 h4 h5 h6	h6	Especifica a profundidade máxima do cabeçalho que será considerada ao agrupar o conteúdo de markdown. O padrão é `h6`.
markdownParsingSubmode	enum: oneToMany oneToOne	oneToMany	Especifica o submodo que determinará se um arquivo markdown será analisado em exatamente um documento de pesquisa ou em vários documentos de pesquisa. O padrão é `oneToMany`.
parsingMode	BlobIndexerParsingMode	default	Representa o modo de análise para indexação de uma fonte de dados de blob do Azure.
pdfTextRotationAlgorithm	BlobIndexerPDFTextRotationAlgorithm	none	Determina o algoritmo para extração de texto de arquivos PDF no armazenamento de blobs do Azure.
queryTimeout	string	00:05:00	Aumenta o tempo limite além do padrão de 5 minutos para fontes de dados do Banco de Dados SQL do Azure, especificado no formato "hh:mm:ss".

IndexingSchedule

Objeto

Representa um agendamento para a execução do indexador.

Nome	Tipo	Description
interval	string (duration)	O intervalo de tempo entre as execuções do indexador.
startTime	string (date-time)	A hora em que um indexador deve começar a ser executado.

SearchIndexer

Objeto

Representa um indexador.

Nome	Tipo	Valor padrão	Description
@odata.etag	string		A ETag do indexador.
dataSourceName	string		O nome da fonte de dados da qual esse indexador lê os dados.
description	string		A descrição do indexador.
disabled	boolean	False	Um valor que indica se o indexador está desabilitado. O padrão é false.
encryptionKey	SearchResourceEncryptionKey		Uma descrição de uma chave de criptografia que você cria no Azure Key Vault. Essa chave é usada para fornecer um nível adicional de criptografia em repouso para a definição do indexador (bem como o status de execução do indexador) quando você deseja garantia total de que ninguém, nem mesmo a Microsoft, pode descriptografá-los. Depois de criptografar a definição do indexador, ela sempre permanecerá criptografada. O serviço de pesquisa ignorará as tentativas de definir essa propriedade como nula. Você pode alterar essa propriedade conforme necessário se quiser girar sua chave de criptografia; A definição do indexador (e o status de execução do indexador) não serão afetadas. A criptografia com chaves gerenciadas pelo cliente não está disponível para serviços de pesquisa gratuitos e só está disponível para serviços pagos criados em 1º de janeiro de 2019 ou depois de 1º de janeiro de 2019.
fieldMappings	FieldMapping[]		Define mapeamentos entre campos na fonte de dados e campos de destino correspondentes no índice.
name	string		O nome do indexador.
outputFieldMappings	FieldMapping[]		Os mapeamentos de campo de saída são aplicados após o enriquecimento e imediatamente antes da indexação.
parameters	IndexingParameters		Parâmetros para execução do indexador.
schedule	IndexingSchedule		A agenda deste indexador.
skillsetName	string		O nome do conjunto de habilidades em execução com esse indexador.
targetIndexName	string		O nome do índice no qual esse indexador grava dados.

SearchIndexerDataNoneIdentity

Objeto

Limpa a propriedade de identidade de uma fonte de dados.

Nome	Tipo	Description
@odata.type	string: #Microsoft.Azure.Search.DataNoneIdentity	Um fragmento de URI especificando o tipo de identidade.

SearchIndexerDataUserAssignedIdentity

Objeto

Especifica a identidade de uma fonte de dados a ser usada.

Nome	Tipo	Description
@odata.type	string: #Microsoft.Azure.Search.DataUserAssignedIdentity	Um fragmento de URI especificando o tipo de identidade.
userAssignedIdentity	string	A ID de recurso do Azure totalmente qualificada de uma identidade gerenciada atribuída pelo usuário normalmente no formato "/subscriptions/12345678-1234-1234-12334-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId" que deveria ter sido atribuída ao serviço de pesquisa.

SearchResourceEncryptionKey

Objeto

Uma chave de criptografia gerenciada pelo cliente no Azure Key Vault. As chaves que você cria e gerencia podem ser usadas para criptografar ou descriptografar dados em repouso, como índices e mapas de sinônimos.

Nome	Tipo	Description
accessCredentials.applicationId	string	Uma ID de aplicativo do AAD que recebeu as permissões de acesso necessárias para o Azure Key Vault que deve ser usada ao criptografar seus dados em repouso. A ID do aplicativo não deve ser confundida com a ID do objeto para seu aplicativo do AAD.
accessCredentials.applicationSecret	string	A chave de autenticação do aplicativo AAD especificado.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Uma identidade gerenciada explícita a ser usada para essa chave de criptografia. Se não for especificado e a propriedade de credenciais de acesso for nula, a identidade gerenciada atribuída pelo sistema será usada. Ao atualizar para o recurso, se a identidade explícita não for especificada, ela permanecerá inalterada. Se "nenhum" for especificado, o valor dessa propriedade será limpo.
keyVaultKeyName	string	O nome da chave do Azure Key Vault a ser usada para criptografar seus dados em repouso.
keyVaultKeyVersion	string	A versão da chave do Azure Key Vault a ser usada para criptografar seus dados em repouso.
keyVaultUri	string	O URI do Azure Key Vault, também conhecido como nome DNS, que contém a chave a ser usada para criptografar seus dados em repouso. Um URI de exemplo pode ser `https://my-keyvault-name.vault.azure.net`.