Knowledge Sources - Get Status

Serviço:: Search Service

Versão da API:: 2025-11-01-preview

Recupera o status de uma fonte de conhecimento.

GET https:///knowledgesources('{sourceName}')/status?api-version=2025-11-01-preview

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
sourceName	path	True	string	O nome da fonte de conhecimento.
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	True	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	KnowledgeSourceStatus	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

SearchServiceGetKnowledgeSourceStatus

Solicitação de exemplo

HTTP

GET https:///knowledgesources('ks-preview-test')/status?api-version=2025-11-01-preview

Resposta de exemplo

Código de status:: 200

{
  "synchronizationStatus": "active",
  "synchronizationInterval": "1d",
  "currentSynchronizationState": {
    "startTime": "2024-11-26T03:37:18.853Z",
    "itemsUpdatesProcessed": 10,
    "itemsUpdatesFailed": 2,
    "itemsSkipped": 1
  },
  "lastSynchronizationState": {
    "startTime": "2024-11-25T03:37:18.853Z",
    "endTime": "2024-11-25T03:38:19.012Z",
    "itemsUpdatesProcessed": 8,
    "itemsUpdatesFailed": 1,
    "itemsSkipped": 0
  },
  "statistics": {
    "totalSynchronization": 5,
    "averageSynchronizationDuration": "PT30M",
    "averageItemsProcessedPerSynchronization": 100
  }
}

Definições

Nome	Description
Accept	O cabeçalho Aceitar.
CompletedSynchronizationState	Representa o estado concluído da última sincronização.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro comum para todas as APIs do Azure Resource Manager retornarem detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.).
KnowledgeSourceStatistics	Informações estatísticas sobre o histórico de sincronização da fonte de conhecimento.
KnowledgeSourceStatus	Representa o status e o histórico de sincronização de uma fonte de conhecimento.
KnowledgeSourceSynchronizationStatus	O status de sincronização atual da fonte de conhecimento.
SynchronizationState	Representa o estado atual de uma sincronização contínua que abrange várias execuções do indexador.

Accept

Enumeração

O cabeçalho Aceitar.

Valor	Description
application/json;odata.metadata=minimal

CompletedSynchronizationState

Objeto

Representa o estado concluído da última sincronização.

Nome	Tipo	Description
endTime	string (date-time)	A hora de término da última sincronização concluída.
itemsSkipped	integer (int32)	O número de itens ignorados na última sincronização.
itemsUpdatesFailed	integer (int32)	O número de atualizações de itens que falharam na última sincronização.
itemsUpdatesProcessed	integer (int32)	O número de atualizações de item processadas com êxito na última sincronização.
startTime	string (date-time)	A hora de início da última sincronização concluída.

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 de erro comum para todas as APIs do Azure Resource Manager retornarem detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.).

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

KnowledgeSourceStatistics

Objeto

Informações estatísticas sobre o histórico de sincronização da fonte de conhecimento.

Nome	Tipo	Description
averageItemsProcessedPerSynchronization	integer (int32)	Itens médios processados por sincronização.
averageSynchronizationDuration	string	Duração média de sincronização no formato HH:MM:SS.
totalSynchronization	integer (int32)	Número total de sincronizações.

KnowledgeSourceStatus

Objeto

Representa o status e o histórico de sincronização de uma fonte de conhecimento.

Nome	Tipo	Description
currentSynchronizationState	SynchronizationState	Estado de sincronização atual que abrange várias execuções do indexador.
lastSynchronizationState	CompletedSynchronizationState	Detalhes da última sincronização concluída. Nulo na primeira sincronização.
statistics	KnowledgeSourceStatistics	Informações estatísticas sobre o histórico de sincronização da fonte de conhecimento. Nulo na primeira sincronização.
synchronizationInterval	string	O intervalo de sincronização (por exemplo, '1d' para diário). Nulo se nenhum agendamento estiver configurado.
synchronizationStatus	KnowledgeSourceSynchronizationStatus	O status atual da sincronização.

KnowledgeSourceSynchronizationStatus

Enumeração

O status de sincronização atual da fonte de conhecimento.

Valor	Description
creating	A fonte de conhecimento está sendo provisionada.
active	A fonte de conhecimento está ativa e as execuções de sincronização estão ocorrendo.
deleting	A fonte de conhecimento está sendo excluída e a sincronização está pausada.

SynchronizationState

Objeto

Representa o estado atual de uma sincronização contínua que abrange várias execuções do indexador.

Nome	Tipo	Description
itemsSkipped	integer (int32)	O número de itens ignorados na sincronização atual.
itemsUpdatesFailed	integer (int32)	O número de atualizações de itens que falharam na sincronização atual.
itemsUpdatesProcessed	integer (int32)	O número de atualizações de item processadas com êxito na sincronização atual.
startTime	string (date-time)	A hora de início da sincronização atual.

Compartilhar via

Knowledge Sources - Get Status

Parâmetros de URI

Cabeçalho da solicitação

Respostas

Segurança

api-key

OAuth2Auth

Escopos

Exemplos

SearchServiceGetKnowledgeSourceStatus

Solicitação de exemplo

Resposta de exemplo

Definições

Accept

CompletedSynchronizationState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

KnowledgeSourceStatistics

KnowledgeSourceStatus

KnowledgeSourceSynchronizationStatus

SynchronizationState