Knowledge Sources - Get

Serviço:: Search Service

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

Recupera uma definição de fonte de conhecimento.

GET {endpoint}/knowledgesources('{sourceName}')?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.
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		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	KnowledgeSource: AzureBlobKnowledgeSource IndexedOneLakeKnowledgeSource SearchIndexKnowledgeSource WebKnowledgeSource	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

SearchServiceGetKnowledgeSource

SearchServiceGetKnowledgeSourceAzureBlob

SearchServiceGetKnowledgeSourceIndexedOneLake

SearchServiceGetKnowledgeSourceWeb

SearchServiceGetKnowledgeSource

Solicitação de exemplo

HTTP

GET https://exampleservice.search.windows.net/knowledgesources('ks-example-index')?api-version=2026-04-01

Resposta de exemplo

Código de status:: 200

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-example-index",
  "kind": "searchIndex",
  "description": "Description of the knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "searchIndexParameters": {
    "searchIndexName": "example-index",
    "semanticConfigurationName": "testconfig",
    "sourceDataFields": [
      {
        "name": "description"
      },
      {
        "name": "category"
      }
    ],
    "searchFields": [
      {
        "name": "*"
      }
    ]
  }
}

SearchServiceGetKnowledgeSourceAzureBlob

Solicitação de exemplo

HTTP

GET https://exampleservice.search.windows.net/knowledgesources('ks-example-index')?api-version=2026-04-01

Resposta de exemplo

Código de status:: 200

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-example-index",
  "kind": "azureBlob",
  "description": "Description of the knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "test-container",
    "folderPath": "test-path",
    "isADLSGen2": false,
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "contentExtractionMode": "standard",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "model",
          "apiKey": "<redacted>",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "myDeployment",
          "apiKey": "<redacted>",
          "modelName": "gpt-5-nano"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "<redacted>"
      }
    },
    "createdResources": {
      "dataSourceConnection": "ks-example-index-datasource",
      "indexer": "ks-example-index-indexer",
      "skillset": "ks-example-index-skillset",
      "index": "ks-example-index-index"
    }
  }
}

SearchServiceGetKnowledgeSourceIndexedOneLake

Solicitação de exemplo

HTTP

GET https://exampleservice.search.windows.net/knowledgesources('ks-example-index')?api-version=2026-04-01

Resposta de exemplo

Código de status:: 200

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-example-index",
  "kind": "indexedOneLake",
  "description": "Description of the OneLake knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedOneLakeParameters": {
    "fabricWorkspaceId": "<redacted>",
    "lakehouseId": "fakeLakehouseId",
    "targetPath": "testfolder",
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "contentExtractionMode": "standard",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "model",
          "apiKey": "<redacted>",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "myDeployment",
          "apiKey": "<redacted>",
          "modelName": "gpt-5-nano"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "<redacted>"
      }
    },
    "createdResources": {
      "dataSourceConnection": "ks-example-index-datasource",
      "indexer": "ks-example-index-indexer",
      "skillset": "ks-example-index-skillset",
      "index": "ks-example-index-index"
    }
  }
}

SearchServiceGetKnowledgeSourceWeb

Solicitação de exemplo

HTTP

GET https://exampleservice.search.windows.net/knowledgesources('ks-example-index')?api-version=2026-04-01

Resposta de exemplo

Código de status:: 200

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-example-index",
  "kind": "web",
  "description": "Description of the knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "webParameters": {
    "domains": {
      "allowedDomains": [
        {
          "address": "example.com",
          "includeSubpages": true
        },
        {
          "address": "another-example.com"
        }
      ],
      "blockedDomains": [
        {
          "address": "blocked.com"
        },
        {
          "address": "spam.com",
          "includeSubpages": true
        }
      ]
    }
  }
}

Definições

Nome	Description
Accept	O cabeçalho Aceitar.
AIServices	Parâmetros para Serviços de IA.
AzureBlobKnowledgeSource	Configuração para a fonte de conhecimento do Armazenamento de Blobs do Azure.
AzureBlobKnowledgeSourceParameters	Parâmetros para a fonte de conhecimento do Armazenamento de Blobs do Azure.
AzureOpenAIModelName	O nome do modelo do Azure Open AI que será chamado.
AzureOpenAIVectorizerParameters	Especifica os parâmetros para se conectar ao recurso do Azure OpenAI.
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.).
IndexedOneLakeKnowledgeSource	Configuração para a fonte de conhecimento do OneLake.
IndexedOneLakeKnowledgeSourceParameters	Parâmetros para a fonte de conhecimento do OneLake.
IndexingSchedule	Representa um agendamento para a execução do indexador.
KnowledgeBaseAzureOpenAIModel	Especifica o recurso OpenAI do Azure usado para fazer o planejamento de consulta.
KnowledgeBaseModelKind	O modelo de IA a ser usado para planejamento de consulta.
KnowledgeSourceAzureOpenAIVectorizer	Especifica o recurso OpenAI do Azure usado para vetorizar uma cadeia de caracteres de consulta.
KnowledgeSourceIngestionParameters	Consolida todas as configurações gerais de ingestão para fontes de conhecimento.
KnowledgeSourceKind	O tipo de fonte de conhecimento.
SearchIndexerDataNoneIdentity	Limpa a propriedade de identidade de uma fonte de dados.
SearchIndexerDataUserAssignedIdentity	Especifica a identidade de uma fonte de dados a ser usada.
SearchIndexFieldReference	Referência de campo para um índice de busca.
SearchIndexKnowledgeSource	Fonte de conhecimento direcionada a um índice de pesquisa.
SearchIndexKnowledgeSourceParameters	Parâmetros para a fonte de conhecimento do índice de pesquisa.
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.
VectorSearchVectorizerKind	O método de vetorização a ser usado durante o tempo de consulta.
WebKnowledgeSource	Fonte de conhecimento direcionando resultados da Web.
WebKnowledgeSourceDomain	Configuração para domínio de fonte de conhecimento da Web.
WebKnowledgeSourceDomains	Configuração de permissão/bloqueio de domínio para fonte de conhecimento da Web.
WebKnowledgeSourceParameters	Parâmetros para fonte de conhecimento da Web.

Accept

Enumeração

O cabeçalho Aceitar.

Valor	Description
application/json;odata.metadata=minimal

AIServices

Objeto

Parâmetros para Serviços de IA.

Nome	Tipo	Description
apiKey	string	A chave de API para acessar os Serviços de IA.
uri	string (uri)	O URI do endpoint dos Serviços de IA.

AzureBlobKnowledgeSource

Objeto

Configuração para a fonte de conhecimento do Armazenamento de Blobs do Azure.

Nome	Tipo	Description
@odata.etag	string	O ETag da fonte de conhecimento.
azureBlobParameters	AzureBlobKnowledgeSourceParameters	O tipo da fonte de conhecimento.
description	string	Descrição opcional definida pelo usuário.
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 da sua fonte de conhecimento quando você quer total garantia de que ninguém, nem mesmo a Microsoft, pode descriptografá-las. Depois que você criptografou sua definição de fonte de conhecimento, 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; Sua definição de fonte de conhecimento não será afetada. 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.
kind	string: azureBlob	O tipo da fonte de conhecimento.
name	string	O nome da fonte de conhecimento.

AzureBlobKnowledgeSourceParameters

Objeto

Parâmetros para a fonte de conhecimento do Armazenamento de Blobs do Azure.

Nome	Tipo	Valor padrão	Description
connectionString	string		Cadeia de conexão baseada em chave ou no formato ResourceId se estiver usando uma identidade gerenciada.
containerName	string		O nome do contêiner de armazenamento de blobs.
createdResources	object		Recursos criados pela fonte de conhecimento.
folderPath	string		Caminho de pasta opcional dentro do contêiner.
ingestionParameters	KnowledgeSourceIngestionParameters		Consolida todas as configurações gerais de ingestão.
isADLSGen2	boolean	False	Defina como true se estiver se conectando a uma conta de armazenamento do ADLS Gen2. O padrão é false.

AzureOpenAIModelName

Enumeração

O nome do modelo do Azure Open AI que será chamado.

Valor	Description
text-embedding-ada-002	TextEmbeddingAda002 modelo.
text-embedding-3-large	TextEmbedding3 Modelo grande.
text-embedding-3-small	TextEmbedding3Small modelo.
gpt-5-mini	Modelo Gpt5Mini.
gpt-5-nano	Modelo Gpt5Nano.
gpt-5.4-mini	Modelo Gpt54Mini.
gpt-5.4-nano	Modelo Gpt54Nano.

AzureOpenAIVectorizerParameters

Objeto

Especifica os parâmetros para se conectar ao recurso do Azure OpenAI.

Nome	Tipo	Description
apiKey	string	Chave de API do recurso Azure OpenAI designado.
authIdentity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	A identidade gerenciada atribuída pelo usuário usada para conexões de saída.
deploymentId	string	ID da implantação de modelo do Azure OpenAI no recurso designado.
modelName	AzureOpenAIModelName	O nome do modelo de inserção implantado no caminho deploymentId fornecido.
resourceUri	string (uri)	O URI do recurso do Azure OpenAI.

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.

IndexedOneLakeKnowledgeSource

Objeto

Configuração para a fonte de conhecimento do OneLake.

Nome	Tipo	Description
@odata.etag	string	O ETag da fonte de conhecimento.
description	string	Descrição opcional definida pelo usuário.
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 da sua fonte de conhecimento quando você quer total garantia de que ninguém, nem mesmo a Microsoft, pode descriptografá-las. Depois que você criptografou sua definição de fonte de conhecimento, 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; Sua definição de fonte de conhecimento não será afetada. 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.
indexedOneLakeParameters	IndexedOneLakeKnowledgeSourceParameters	Os parâmetros para a fonte de conhecimento.
kind	string: indexedOneLake	O tipo da fonte de conhecimento.
name	string	O nome da fonte de conhecimento.

IndexedOneLakeKnowledgeSourceParameters

Objeto

Parâmetros para a fonte de conhecimento do OneLake.

Nome	Tipo	Description
createdResources	object	Recursos criados pela fonte de conhecimento.
fabricWorkspaceId	string	ID do espaço de trabalho do OneLake.
ingestionParameters	KnowledgeSourceIngestionParameters	Consolida todas as configurações gerais de ingestão.
lakehouseId	string	Especifica qual lakehouse do OneLake acessar.
targetPath	string	Pasta ou atalho opcional do OneLakehouse para filtrar o conteúdo do OneLake.

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.

KnowledgeBaseAzureOpenAIModel

Objeto

Especifica o recurso OpenAI do Azure usado para fazer o planejamento de consulta.

Nome	Tipo	Description
azureOpenAIParameters	AzureOpenAIVectorizerParameters	Azure OpenAI.
kind	string: azureOpenAI	O modelo de IA a ser usado para planejamento de consulta.

KnowledgeBaseModelKind

Enumeração

O modelo de IA a ser usado para planejamento de consulta.

Valor	Description
azureOpenAI	Use modelos de IA aberta do Azure para planejamento de consulta.

KnowledgeSourceAzureOpenAIVectorizer

Objeto

Especifica o recurso OpenAI do Azure usado para vetorizar uma cadeia de caracteres de consulta.

Nome	Tipo	Description
azureOpenAIParameters	AzureOpenAIVectorizerParameters	Contém os parâmetros específicos para a vetorização de inserção do OpenAI do Azure.
kind	string: azureOpenAI	O nome do tipo de método de vetorização que está sendo configurado para uso com a pesquisa vetorial.

KnowledgeSourceIngestionParameters

Objeto

Consolida todas as configurações gerais de ingestão para fontes de conhecimento.

Nome	Tipo	Valor padrão	Description
aiServices	AIServices		Configuração opcional de serviços de IA para processamento de conteúdo.
chatCompletionModel	KnowledgeBaseModel: KnowledgeBaseAzureOpenAIModel		Modelo opcional de conclusão de bate-papo para verbalização de imagem ou extração de contexto.
contentExtractionMode	enum: minimal standard	minimal	Modo de extração de conteúdo opcional. O padrão é 'mínimo'.
disableImageVerbalization	boolean	False	Indica se a verbalização da imagem deve ser desativada. O padrão é false.
embeddingModel	KnowledgeSourceVectorizer: KnowledgeSourceAzureOpenAIVectorizer		Configuração de vetorizador opcional para vetorizar conteúdo.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity		Uma identidade explícita a ser usada para essa fonte de conhecimento.
ingestionSchedule	IndexingSchedule		Agendamento opcional para ingestão de dados.

KnowledgeSourceKind

Enumeração

O tipo de fonte de conhecimento.

Valor	Description
searchIndex	Uma fonte de conhecimento que lê dados de um Índice de Pesquisa.
azureBlob	Uma fonte de conhecimento que lê e ingere dados do Armazenamento de Blobs do Azure em um Índice de Pesquisa.
indexedOneLake	Uma fonte de conhecimento que lê dados do OneLake indexado.
web	Uma fonte de conhecimento que lê dados da web.

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.

SearchIndexFieldReference

Objeto

Referência de campo para um índice de busca.

Nome	Tipo	Description
name	string	O nome do campo.

SearchIndexKnowledgeSource

Objeto

Fonte de conhecimento direcionada a um índice de pesquisa.

Nome	Tipo	Description
@odata.etag	string	O ETag da fonte de conhecimento.
description	string	Descrição opcional definida pelo usuário.
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 da sua fonte de conhecimento quando você quer total garantia de que ninguém, nem mesmo a Microsoft, pode descriptografá-las. Depois que você criptografou sua definição de fonte de conhecimento, 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; Sua definição de fonte de conhecimento não será afetada. 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.
kind	string: searchIndex	O tipo da fonte de conhecimento.
name	string	O nome da fonte de conhecimento.
searchIndexParameters	SearchIndexKnowledgeSourceParameters	Os parâmetros para a fonte de conhecimento.

SearchIndexKnowledgeSourceParameters

Objeto

Parâmetros para a fonte de conhecimento do índice de pesquisa.

Nome	Tipo	Description
searchFields	SearchIndexFieldReference[]	Usado para restringir quais campos pesquisar no índice de pesquisa.
searchIndexName	string	O nome do índice de pesquisa.
semanticConfigurationName	string	Usado para especificar uma configuração semântica diferente no índice de pesquisa de destino diferente do padrão.
sourceDataFields	SearchIndexFieldReference[]	Usado para solicitar campos adicionais para dados de origem referenciados.

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`.

VectorSearchVectorizerKind

Enumeração

O método de vetorização a ser usado durante o tempo de consulta.

Valor	Description
azureOpenAI	Gere inserções usando um recurso do Azure OpenAI no momento da consulta.
customWebApi	Gere inserções usando um ponto de extremidade da Web personalizado no momento da consulta.
aiServicesVision	Gere inserções para uma entrada de imagem ou texto no momento da consulta usando a API de Vetorização da Visão dos Serviços de IA do Azure.
aml	Gere inserções usando um ponto de extremidade do Azure Machine Learning implantado por meio do Catálogo de Modelos do Fábrica de IA do Azure no momento da consulta.

WebKnowledgeSource

Objeto

Fonte de conhecimento direcionando resultados da Web.

Nome	Tipo	Description
@odata.etag	string	O ETag da fonte de conhecimento.
description	string	Descrição opcional definida pelo usuário.
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 da sua fonte de conhecimento quando você quer total garantia de que ninguém, nem mesmo a Microsoft, pode descriptografá-las. Depois que você criptografou sua definição de fonte de conhecimento, 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; Sua definição de fonte de conhecimento não será afetada. 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.
kind	string: web	O tipo da fonte de conhecimento.
name	string	O nome da fonte de conhecimento.
webParameters	WebKnowledgeSourceParameters	Os parâmetros para a fonte de conhecimento da Web.

WebKnowledgeSourceDomain

Objeto

Configuração para domínio de fonte de conhecimento da Web.

Nome	Tipo	Description
address	string	O endereço do domínio.
includeSubpages	boolean	Incluir ou não subpáginas deste domínio.

WebKnowledgeSourceDomains

Objeto

Configuração de permissão/bloqueio de domínio para fonte de conhecimento da Web.

Nome	Tipo	Description
allowedDomains	WebKnowledgeSourceDomain[]	Domínios que são permitidos para resultados web.
blockedDomains	WebKnowledgeSourceDomain[]	Domínios que são bloqueados nos resultados da web.

WebKnowledgeSourceParameters

Objeto

Parâmetros para fonte de conhecimento da Web.

Nome	Tipo	Description
domains	WebKnowledgeSourceDomains	Configuração de permissão/bloqueio de domínio para resultados da Web.