Knowledge Sources - Create

Servicio:: Search Service

Versión de la API:: 2025-11-01-preview

Crea una nueva fuente de conocimiento.

POST {endpoint}/knowledgesources?api-version=2025-11-01-preview

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string (uri)	La dirección URL del punto de conexión del servicio de búsqueda.
api-version	query	True	string minLength: 1	Versión de API que se usará para la operación.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Accept		Accept	El encabezado Aceptar.
x-ms-client-request-id		string (uuid)	Identificador de cadena globalmente único y generado por el cliente para la solicitud.

Cuerpo de la solicitud

El cuerpo de la solicitud puede ser uno de los siguientes:

Nombre	Description
AzureBlobKnowledgeSource	Configuración para el origen de conocimiento de Azure Blob Storage.
IndexedOneLakeKnowledgeSource	Configuración para el origen de conocimiento de OneLake.
IndexedSharePointKnowledgeSource	Configuración para el origen de conocimiento de SharePoint.
RemoteSharePointKnowledgeSource	Configuración para el origen de conocimiento remoto de SharePoint.
SearchIndexKnowledgeSource	Fuente de conocimiento dirigida a un índice de búsqueda.
WebKnowledgeSource	Fuente de conocimiento dirigida a resultados web.

AzureBlobKnowledgeSource

Configuración para el origen de conocimiento de Azure Blob Storage.

Nombre	Requerido	Tipo	Description
azureBlobParameters	True	AzureBlobKnowledgeSourceParameters	El tipo de fuente de conocimiento.
kind	True	string: azureBlob	El tipo de fuente de conocimiento.
name	True	string	El nombre de la fuente de conocimiento.
@odata.etag		string	El ETag de la fuente de conocimiento.
description		string	Descripción opcional definida por el usuario.
encryptionKey		SearchResourceEncryptionKey	Descripción de una clave de cifrado que se crea en Azure Key Vault. Esta clave se utiliza para proporcionar un nivel adicional de cifrado en reposo para la definición de la fuente de conocimiento cuando quieres la total seguridad de que nadie, ni siquiera Microsoft, puede descifrarlas. Una vez que hayas cifrado la definición de tu fuente de conocimiento, siempre permanecerá cifrada. El servicio de búsqueda omitirá los intentos de establecer esta propiedad en null. Puedes cambiar esta propiedad según lo necesites si quieres rotar tu clave de cifrado; La definición de tu fuente de conocimiento no se verá afectada. El cifrado con claves administradas por el cliente no está disponible para los servicios de búsqueda gratuitos y solo está disponible para los servicios pagos creados a partir del 1 de enero de 2019.

IndexedOneLakeKnowledgeSource

Configuración para el origen de conocimiento de OneLake.

Nombre	Requerido	Tipo	Description
indexedOneLakeParameters	True	IndexedOneLakeKnowledgeSourceParameters	Los parámetros de la fuente de conocimiento.
kind	True	string: indexedOneLake	El tipo de fuente de conocimiento.
name	True	string	El nombre de la fuente de conocimiento.
@odata.etag		string	El ETag de la fuente de conocimiento.
description		string	Descripción opcional definida por el usuario.
encryptionKey		SearchResourceEncryptionKey	Descripción de una clave de cifrado que se crea en Azure Key Vault. Esta clave se utiliza para proporcionar un nivel adicional de cifrado en reposo para la definición de la fuente de conocimiento cuando quieres la total seguridad de que nadie, ni siquiera Microsoft, puede descifrarlas. Una vez que hayas cifrado la definición de tu fuente de conocimiento, siempre permanecerá cifrada. El servicio de búsqueda omitirá los intentos de establecer esta propiedad en null. Puedes cambiar esta propiedad según lo necesites si quieres rotar tu clave de cifrado; La definición de tu fuente de conocimiento no se verá afectada. El cifrado con claves administradas por el cliente no está disponible para los servicios de búsqueda gratuitos y solo está disponible para los servicios pagos creados a partir del 1 de enero de 2019.

IndexedSharePointKnowledgeSource

Configuración para el origen de conocimiento de SharePoint.

Nombre	Requerido	Tipo	Description
indexedSharePointParameters	True	IndexedSharePointKnowledgeSourceParameters	Los parámetros de la fuente de conocimiento.
kind	True	string: indexedSharePoint	El tipo de fuente de conocimiento.
name	True	string	El nombre de la fuente de conocimiento.
@odata.etag		string	El ETag de la fuente de conocimiento.
description		string	Descripción opcional definida por el usuario.
encryptionKey		SearchResourceEncryptionKey	Descripción de una clave de cifrado que se crea en Azure Key Vault. Esta clave se utiliza para proporcionar un nivel adicional de cifrado en reposo para la definición de la fuente de conocimiento cuando quieres la total seguridad de que nadie, ni siquiera Microsoft, puede descifrarlas. Una vez que hayas cifrado la definición de tu fuente de conocimiento, siempre permanecerá cifrada. El servicio de búsqueda omitirá los intentos de establecer esta propiedad en null. Puedes cambiar esta propiedad según lo necesites si quieres rotar tu clave de cifrado; La definición de tu fuente de conocimiento no se verá afectada. El cifrado con claves administradas por el cliente no está disponible para los servicios de búsqueda gratuitos y solo está disponible para los servicios pagos creados a partir del 1 de enero de 2019.

RemoteSharePointKnowledgeSource

Configuración para el origen de conocimiento remoto de SharePoint.

Nombre	Requerido	Tipo	Description
kind	True	string: remoteSharePoint	El tipo de fuente de conocimiento.
name	True	string	El nombre de la fuente de conocimiento.
@odata.etag		string	El ETag de la fuente de conocimiento.
description		string	Descripción opcional definida por el usuario.
encryptionKey		SearchResourceEncryptionKey	Descripción de una clave de cifrado que se crea en Azure Key Vault. Esta clave se utiliza para proporcionar un nivel adicional de cifrado en reposo para la definición de la fuente de conocimiento cuando quieres la total seguridad de que nadie, ni siquiera Microsoft, puede descifrarlas. Una vez que hayas cifrado la definición de tu fuente de conocimiento, siempre permanecerá cifrada. El servicio de búsqueda omitirá los intentos de establecer esta propiedad en null. Puedes cambiar esta propiedad según lo necesites si quieres rotar tu clave de cifrado; La definición de tu fuente de conocimiento no se verá afectada. El cifrado con claves administradas por el cliente no está disponible para los servicios de búsqueda gratuitos y solo está disponible para los servicios pagos creados a partir del 1 de enero de 2019.
remoteSharePointParameters		RemoteSharePointKnowledgeSourceParameters	Los parámetros para la fuente de conocimiento remota de SharePoint.

SearchIndexKnowledgeSource

Fuente de conocimiento dirigida a un índice de búsqueda.

Nombre	Requerido	Tipo	Description
kind	True	string: searchIndex	El tipo de fuente de conocimiento.
name	True	string	El nombre de la fuente de conocimiento.
searchIndexParameters	True	SearchIndexKnowledgeSourceParameters	Los parámetros de la fuente de conocimiento.
@odata.etag		string	El ETag de la fuente de conocimiento.
description		string	Descripción opcional definida por el usuario.
encryptionKey		SearchResourceEncryptionKey	Descripción de una clave de cifrado que se crea en Azure Key Vault. Esta clave se utiliza para proporcionar un nivel adicional de cifrado en reposo para la definición de la fuente de conocimiento cuando quieres la total seguridad de que nadie, ni siquiera Microsoft, puede descifrarlas. Una vez que hayas cifrado la definición de tu fuente de conocimiento, siempre permanecerá cifrada. El servicio de búsqueda omitirá los intentos de establecer esta propiedad en null. Puedes cambiar esta propiedad según lo necesites si quieres rotar tu clave de cifrado; La definición de tu fuente de conocimiento no se verá afectada. El cifrado con claves administradas por el cliente no está disponible para los servicios de búsqueda gratuitos y solo está disponible para los servicios pagos creados a partir del 1 de enero de 2019.

WebKnowledgeSource

Fuente de conocimiento dirigida a resultados web.

Nombre	Requerido	Tipo	Description
kind	True	string: web	El tipo de fuente de conocimiento.
name	True	string	El nombre de la fuente de conocimiento.
@odata.etag		string	El ETag de la fuente de conocimiento.
description		string	Descripción opcional definida por el usuario.
encryptionKey		SearchResourceEncryptionKey	Descripción de una clave de cifrado que se crea en Azure Key Vault. Esta clave se utiliza para proporcionar un nivel adicional de cifrado en reposo para la definición de la fuente de conocimiento cuando quieres la total seguridad de que nadie, ni siquiera Microsoft, puede descifrarlas. Una vez que hayas cifrado la definición de tu fuente de conocimiento, siempre permanecerá cifrada. El servicio de búsqueda omitirá los intentos de establecer esta propiedad en null. Puedes cambiar esta propiedad según lo necesites si quieres rotar tu clave de cifrado; La definición de tu fuente de conocimiento no se verá afectada. El cifrado con claves administradas por el cliente no está disponible para los servicios de búsqueda gratuitos y solo está disponible para los servicios pagos creados a partir del 1 de enero de 2019.
webParameters		WebKnowledgeSourceParameters	Los parámetros de la fuente de conocimiento web.

Respuestas

Nombre	Tipo	Description
201 Created	KnowledgeSource: AzureBlobKnowledgeSource IndexedOneLakeKnowledgeSource IndexedSharePointKnowledgeSource RemoteSharePointKnowledgeSource SearchIndexKnowledgeSource WebKnowledgeSource	La solicitud se ha realizado correctamente y se ha creado un nuevo recurso como resultado.
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Seguridad

api-key

Tipo: apiKey
En: header

OAuth2Auth

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Ámbitos

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

Ejemplos

SearchServiceCreateKnowledgeSource

SearchServiceCreateKnowledgeSourceAzureBlob

SearchServiceCreateKnowledgeSourceIndexedOneLake

SearchServiceCreateKnowledgeSourceIndexedSharePoint

SearchServiceCreateKnowledgeSourceWeb

SearchServiceCreateKnowledgeSource

Solicitud de ejemplo

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2025-11-01-preview


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

Respuesta de muestra

status code:: 201

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "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": "preview-test",
    "semanticConfigurationName": "testconfig",
    "sourceDataFields": [
      {
        "name": "description"
      },
      {
        "name": "category"
      }
    ],
    "searchFields": [
      {
        "name": "*"
      }
    ]
  }
}

SearchServiceCreateKnowledgeSourceAzureBlob

Solicitud de ejemplo

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2025-11-01-preview


{
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "test-container",
    "folderPath": "test-path",
    "isADLSGen2": false,
    "ingestionParameters": {
      "identity": {
        "userAssignedIdentity": "/my/userassigned/id",
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity"
      },
      "embeddingModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        },
        "kind": "azureOpenAI"
      },
      "chatCompletionModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        },
        "kind": "azureOpenAI"
      },
      "disableImageVerbalization": false,
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2025-01-07T19:30:00Z"
      },
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "contentExtractionMode": "standard",
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  },
  "name": "ks-preview-test",
  "description": "Description of the knowledge source.",
  "kind": "azureBlob",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  }
}

Respuesta de muestra

status code:: 201

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "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,
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "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": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    },
    "createdResources": {
      "dataSourceConnection": "ks-preview-test-datasource",
      "indexer": "ks-preview-test-indexer",
      "skillset": "ks-preview-test-skillset",
      "index": "ks-preview-test-index"
    }
  }
}

SearchServiceCreateKnowledgeSourceIndexedOneLake

Solicitud de ejemplo

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2025-11-01-preview


{
  "indexedOneLakeParameters": {
    "fabricWorkspaceId": "ResourceId=fakeWorkspaceId",
    "lakehouseId": "fakeLakehouseId",
    "targetPath": "testfolder",
    "ingestionParameters": {
      "identity": {
        "userAssignedIdentity": "/my/userassigned/id",
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity"
      },
      "embeddingModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        },
        "kind": "azureOpenAI"
      },
      "chatCompletionModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        },
        "kind": "azureOpenAI"
      },
      "disableImageVerbalization": false,
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2025-01-07T19:30:00Z"
      },
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "contentExtractionMode": "standard",
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  },
  "name": "ks-preview-test",
  "description": "Description of the OneLake knowledge source.",
  "kind": "indexedOneLake",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  }
}

Respuesta de muestra

status code:: 201

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "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": "ResourceId=fakeWorkspaceId",
    "lakehouseId": "fakeLakehouseId",
    "targetPath": "testfolder",
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "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": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  }
}

SearchServiceCreateKnowledgeSourceIndexedSharePoint

Solicitud de ejemplo

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2025-11-01-preview


{
  "indexedSharePointParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "defaultSiteLibrary",
    "query": "*.docx OR *.pdf",
    "ingestionParameters": {
      "identity": {
        "userAssignedIdentity": "/my/userassigned/id",
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity"
      },
      "embeddingModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "model",
          "apiKey": "api-key",
          "modelName": "text-embedding-3-large"
        },
        "kind": "azureOpenAI"
      },
      "chatCompletionModel": {
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        },
        "kind": "azureOpenAI"
      },
      "disableImageVerbalization": false,
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2025-01-07T19:30:00Z"
      },
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "contentExtractionMode": "standard",
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  },
  "name": "ks-preview-test",
  "description": "Description of the SharePoint knowledge source.",
  "kind": "indexedSharePoint",
  "@odata.etag": "0x1234568AE7E58A1",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  }
}

Respuesta de muestra

status code:: 201

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "indexedSharePoint",
  "description": "Description of the SharePoint knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedSharePointParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "defaultSiteLibrary",
    "query": "*.docx OR *.pdf",
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds",
        "rbacScope"
      ],
      "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": "api-key",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com/",
          "deploymentId": "myDeployment",
          "apiKey": "api-key",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "api-key"
      }
    }
  }
}

SearchServiceCreateKnowledgeSourceWeb

Solicitud de ejemplo

HTTP

POST https://previewexampleservice.search.windows.net/knowledgesources?api-version=2025-11-01-preview


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

Respuesta de muestra

status code:: 201

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "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
        }
      ]
    }
  }
}

Definiciones

Nombre	Description
Accept	El encabezado Aceptar.
AIServices	Parámetros para los servicios de IA.
AzureBlobKnowledgeSource	Configuración para el origen de conocimiento de Azure Blob Storage.
AzureBlobKnowledgeSourceParameters	Parámetros para el origen de conocimiento de Azure Blob Storage.
AzureOpenAIModelName	Nombre del modelo de Azure Open AI al que se llamará.
AzureOpenAIVectorizerParameters	Especifica los parámetros para conectarse al recurso de Azure OpenAI.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData).
IndexedOneLakeKnowledgeSource	Configuración para el origen de conocimiento de OneLake.
IndexedOneLakeKnowledgeSourceParameters	Parámetros para el origen de conocimiento de OneLake.
IndexedSharePointContainerName	Especifica a qué bibliotecas de SharePoint se va a acceder.
IndexedSharePointKnowledgeSource	Configuración para el origen de conocimiento de SharePoint.
IndexedSharePointKnowledgeSourceParameters	Parámetros para el origen de conocimiento de SharePoint.
IndexingSchedule	Representa una programación para la ejecución del indexador.
KnowledgeBaseAzureOpenAIModel	Especifica el recurso de Azure OpenAI que se usa para realizar la planeación de consultas.
KnowledgeBaseModelKind	El modelo de IA que se utilizará para la planificación de consultas.
KnowledgeSourceAzureOpenAIVectorizer	Especifica el recurso de Azure OpenAI que se usa para vectorizar una cadena de consulta.
KnowledgeSourceIngestionParameters	Consolida todas las configuraciones generales de ingesta para los orígenes de conocimiento.
KnowledgeSourceIngestionPermissionOption	Tipos de permisos para ingerir junto con el contenido del documento.
KnowledgeSourceKind	El tipo de fuente de conocimiento.
RemoteSharePointKnowledgeSource	Configuración para el origen de conocimiento remoto de SharePoint.
RemoteSharePointKnowledgeSourceParameters	Parámetros para el origen de conocimiento remoto de SharePoint.
SearchIndexerDataNoneIdentity	Borra la propiedad de identidad de un origen de datos.
SearchIndexerDataUserAssignedIdentity	Especifica la identidad de un origen de datos que se va a usar.
SearchIndexFieldReference	Referencia de campo para un índice de búsqueda.
SearchIndexKnowledgeSource	Fuente de conocimiento dirigida a un índice de búsqueda.
SearchIndexKnowledgeSourceParameters	Parámetros para el origen de conocimiento del índice de búsqueda.
SearchResourceEncryptionKey	Una clave de cifrado administrada por el cliente en Azure Key Vault. Las claves que crea y administra se pueden usar para cifrar o descifrar datos en reposo, como índices y mapas de sinónimos.
VectorSearchVectorizerKind	El método de vectorización que se utilizará durante el tiempo de consulta.
WebKnowledgeSource	Fuente de conocimiento dirigida a resultados web.
WebKnowledgeSourceDomain	Configuración para el dominio de origen de conocimiento web.
WebKnowledgeSourceDomains	Configuración de dominio/bloqueo para el origen de conocimiento web.
WebKnowledgeSourceParameters	Parámetros para el origen de conocimiento web.

Accept

Enumeración

El encabezado Aceptar.

Valor	Description
application/json;odata.metadata=minimal

AIServices

Objeto

Parámetros para los servicios de IA.

Nombre	Tipo	Description
apiKey	string	La clave de API para acceder a los servicios de IA.
uri	string (uri)	El URI del punto de conexión de AI Services.

AzureBlobKnowledgeSource

Objeto

Configuración para el origen de conocimiento de Azure Blob Storage.

Nombre	Tipo	Description
@odata.etag	string	El ETag de la fuente de conocimiento.
azureBlobParameters	AzureBlobKnowledgeSourceParameters	El tipo de fuente de conocimiento.
description	string	Descripción opcional definida por el usuario.
encryptionKey	SearchResourceEncryptionKey	Descripción de una clave de cifrado que se crea en Azure Key Vault. Esta clave se utiliza para proporcionar un nivel adicional de cifrado en reposo para la definición de la fuente de conocimiento cuando quieres la total seguridad de que nadie, ni siquiera Microsoft, puede descifrarlas. Una vez que hayas cifrado la definición de tu fuente de conocimiento, siempre permanecerá cifrada. El servicio de búsqueda omitirá los intentos de establecer esta propiedad en null. Puedes cambiar esta propiedad según lo necesites si quieres rotar tu clave de cifrado; La definición de tu fuente de conocimiento no se verá afectada. El cifrado con claves administradas por el cliente no está disponible para los servicios de búsqueda gratuitos y solo está disponible para los servicios pagos creados a partir del 1 de enero de 2019.
kind	string: azureBlob	El tipo de fuente de conocimiento.
name	string	El nombre de la fuente de conocimiento.

AzureBlobKnowledgeSourceParameters

Objeto

Parámetros para el origen de conocimiento de Azure Blob Storage.

Nombre	Tipo	Valor predeterminado	Description
connectionString	string		Cadena de conexión basada en clave o el formato ResourceId si se usa una identidad administrada.
containerName	string		Nombre del contenedor de almacenamiento de blobs.
createdResources	object		Recursos creados por la fuente de conocimiento.
folderPath	string		Ruta de acceso de carpeta opcional dentro del contenedor.
ingestionParameters	KnowledgeSourceIngestionParameters		Consolida todas las configuraciones generales de ingesta.
isADLSGen2	boolean	False	Establézcalo en true si se conecta a una cuenta de almacenamiento de ADLS Gen2. El valor predeterminado es False.

AzureOpenAIModelName

Enumeración

Nombre del modelo de Azure Open AI al que se llamará.

Valor	Description
text-embedding-ada-002	TextEmbeddingAda002 modelo.
text-embedding-3-large	TextEmbedding3 Modelo grande.
text-embedding-3-small	TextoEmbede3Modelo pequeño.
gpt-4o	Modelo GPT4o.
gpt-4o-mini	Modelo Gpt4oMini.
gpt-4.1	Modelo GPT41.
gpt-4.1-mini	Modelo Gpt41Mini.
gpt-4.1-nano	Modelo Gpt41Nano.
gpt-5	Modelo GPT5.
gpt-5-mini	Modelo Gpt5Mini.
gpt-5-nano	Modelo Gpt5Nano.

AzureOpenAIVectorizerParameters

Objeto

Especifica los parámetros para conectarse al recurso de Azure OpenAI.

Nombre	Tipo	Description
apiKey	string	Clave de API del recurso de Azure OpenAI designado.
authIdentity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	La identidad administrada asignada por el usuario que se usa para las conexiones salientes.
deploymentId	string	Identificador de la implementación del modelo de Azure OpenAI en el recurso designado.
modelName	AzureOpenAIModelName	Nombre del modelo de inserción que se implementa en la ruta de acceso deploymentId proporcionada.
resourceUri	string (uri)	Identificador URI del recurso de Azure OpenAI.

ErrorAdditionalInfo

Objeto

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info		Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Objeto

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Los detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData).

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

IndexedOneLakeKnowledgeSource

Objeto

Configuración para el origen de conocimiento de OneLake.

Nombre	Tipo	Description
@odata.etag	string	El ETag de la fuente de conocimiento.
description	string	Descripción opcional definida por el usuario.
encryptionKey	SearchResourceEncryptionKey	Descripción de una clave de cifrado que se crea en Azure Key Vault. Esta clave se utiliza para proporcionar un nivel adicional de cifrado en reposo para la definición de la fuente de conocimiento cuando quieres la total seguridad de que nadie, ni siquiera Microsoft, puede descifrarlas. Una vez que hayas cifrado la definición de tu fuente de conocimiento, siempre permanecerá cifrada. El servicio de búsqueda omitirá los intentos de establecer esta propiedad en null. Puedes cambiar esta propiedad según lo necesites si quieres rotar tu clave de cifrado; La definición de tu fuente de conocimiento no se verá afectada. El cifrado con claves administradas por el cliente no está disponible para los servicios de búsqueda gratuitos y solo está disponible para los servicios pagos creados a partir del 1 de enero de 2019.
indexedOneLakeParameters	IndexedOneLakeKnowledgeSourceParameters	Los parámetros de la fuente de conocimiento.
kind	string: indexedOneLake	El tipo de fuente de conocimiento.
name	string	El nombre de la fuente de conocimiento.

IndexedOneLakeKnowledgeSourceParameters

Objeto

Parámetros para el origen de conocimiento de OneLake.

Nombre	Tipo	Description
createdResources	object	Recursos creados por la fuente de conocimiento.
fabricWorkspaceId	string	ID de área de trabajo de OneLake.
ingestionParameters	KnowledgeSourceIngestionParameters	Consolida todas las configuraciones generales de ingesta.
lakehouseId	string	Especifica a qué casa del lago OneLake se va a acceder.
targetPath	string	Carpeta OneLakehouse opcional o acceso directo para filtrar el contenido de OneLake.

IndexedSharePointContainerName

Enumeración

Especifica a qué bibliotecas de SharePoint se va a acceder.

Valor	Description
defaultSiteLibrary	Indexar el contenido de la biblioteca de documentos predeterminada del sitio.
allSiteLibraries	Indexe el contenido de cada biblioteca de documentos del sitio.
useQuery	Utiliza una consulta para filtrar el contenido de SharePoint.

IndexedSharePointKnowledgeSource

Objeto

Configuración para el origen de conocimiento de SharePoint.

Nombre	Tipo	Description
@odata.etag	string	El ETag de la fuente de conocimiento.
description	string	Descripción opcional definida por el usuario.
encryptionKey	SearchResourceEncryptionKey	Descripción de una clave de cifrado que se crea en Azure Key Vault. Esta clave se utiliza para proporcionar un nivel adicional de cifrado en reposo para la definición de la fuente de conocimiento cuando quieres la total seguridad de que nadie, ni siquiera Microsoft, puede descifrarlas. Una vez que hayas cifrado la definición de tu fuente de conocimiento, siempre permanecerá cifrada. El servicio de búsqueda omitirá los intentos de establecer esta propiedad en null. Puedes cambiar esta propiedad según lo necesites si quieres rotar tu clave de cifrado; La definición de tu fuente de conocimiento no se verá afectada. El cifrado con claves administradas por el cliente no está disponible para los servicios de búsqueda gratuitos y solo está disponible para los servicios pagos creados a partir del 1 de enero de 2019.
indexedSharePointParameters	IndexedSharePointKnowledgeSourceParameters	Los parámetros de la fuente de conocimiento.
kind	string: indexedSharePoint	El tipo de fuente de conocimiento.
name	string	El nombre de la fuente de conocimiento.

IndexedSharePointKnowledgeSourceParameters

Objeto

Parámetros para el origen de conocimiento de SharePoint.

Nombre	Tipo	Description
connectionString	string	Cadena de conexión de SharePoint con formato: SharePointOnlineEndpoint=[URL del sitio de SharePoint]; ApplicationId=[ID de aplicación de Azure AD]; ApplicationSecret=[Secreto de cliente de la aplicación de Azure AD]; TenantId=[Id. de inquilino del sitio de SharePoint]
containerName	IndexedSharePointContainerName	Especifica a qué bibliotecas de SharePoint se va a acceder.
createdResources	object	Recursos creados por la fuente de conocimiento.
ingestionParameters	KnowledgeSourceIngestionParameters	Consolida todas las configuraciones generales de ingesta.
query	string	Consulta opcional para filtrar el contenido de SharePoint.

IndexingSchedule

Objeto

Representa una programación para la ejecución del indexador.

Nombre	Tipo	Description
interval	string (duration)	Intervalo de tiempo entre ejecuciones del indexador.
startTime	string (date-time)	Hora en la que un indexador debe comenzar a ejecutarse.

KnowledgeBaseAzureOpenAIModel

Objeto

Especifica el recurso de Azure OpenAI que se usa para realizar la planeación de consultas.

Nombre	Tipo	Description
azureOpenAIParameters	AzureOpenAIVectorizerParameters	Azure OpenAI.
kind	string: azureOpenAI	El modelo de IA que se utilizará para la planificación de consultas.

KnowledgeBaseModelKind

Enumeración

El modelo de IA que se utilizará para la planificación de consultas.

Valor	Description
azureOpenAI	Use modelos de Azure Open AI para la planeación de consultas.

KnowledgeSourceAzureOpenAIVectorizer

Objeto

Especifica el recurso de Azure OpenAI que se usa para vectorizar una cadena de consulta.

Nombre	Tipo	Description
azureOpenAIParameters	AzureOpenAIVectorizerParameters	Contiene los parámetros específicos de la vectorización de inserción de Azure OpenAI.
kind	string: azureOpenAI	El nombre del tipo de método de vectorización que se configura para su uso con la búsqueda vectorial.

KnowledgeSourceIngestionParameters

Objeto

Consolida todas las configuraciones generales de ingesta para los orígenes de conocimiento.

Nombre	Tipo	Valor predeterminado	Description
aiServices	AIServices		Configuración opcional de AI Services para el procesamiento de contenido.
chatCompletionModel	KnowledgeBaseModel: KnowledgeBaseAzureOpenAIModel		Modelo opcional de finalización de chat para la verbalización de imágenes o la extracción de contexto.
contentExtractionMode	enum: minimal standard	minimal	Modo de extracción de contenido opcional. El valor predeterminado es 'mínimo'.
disableImageVerbalization	boolean	False	Indica si se debe desactivar la verbalización de la imagen. El valor predeterminado es False.
embeddingModel	KnowledgeSourceVectorizer: KnowledgeSourceAzureOpenAIVectorizer		Configuración opcional del vectorizador para vectorizar contenido.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity		Una identidad explícita que se usará para este origen de conocimiento.
ingestionPermissionOptions	KnowledgeSourceIngestionPermissionOption[]		Lista opcional de tipos de permisos para ingerir junto con el contenido del documento. Si se especifica, establecerá las opciones de permisos del indexador para el origen de datos.
ingestionSchedule	IndexingSchedule		Programación opcional para la ingesta de datos.

KnowledgeSourceIngestionPermissionOption

Enumeración

Tipos de permisos para ingerir junto con el contenido del documento.

Valor	Description
userIds	Ingiere identificadores de usuario explícitos junto con el contenido del documento.
groupIds	Ingiera identificadores de grupo junto con el contenido del documento.
rbacScope	Ingiera información del alcance de RBAC junto con el contenido del documento.

KnowledgeSourceKind

Enumeración

El tipo de fuente de conocimiento.

Valor	Description
searchIndex	Un origen de conocimiento que lee datos de un índice de búsqueda.
azureBlob	Un origen de conocimiento que lee e ingiere datos de Azure Blob Storage en un índice de búsqueda.
indexedSharePoint	Una fuente de conocimiento que lee datos de SharePoint indexado.
indexedOneLake	Una fuente de conocimiento que lee datos de OneLake indexado.
web	Una fuente de conocimiento que lee datos de la web.
remoteSharePoint	Una fuente de conocimiento que lee datos de SharePoint remoto.

RemoteSharePointKnowledgeSource

Objeto

Configuración para el origen de conocimiento remoto de SharePoint.

Nombre	Tipo	Description
@odata.etag	string	El ETag de la fuente de conocimiento.
description	string	Descripción opcional definida por el usuario.
encryptionKey	SearchResourceEncryptionKey	Descripción de una clave de cifrado que se crea en Azure Key Vault. Esta clave se utiliza para proporcionar un nivel adicional de cifrado en reposo para la definición de la fuente de conocimiento cuando quieres la total seguridad de que nadie, ni siquiera Microsoft, puede descifrarlas. Una vez que hayas cifrado la definición de tu fuente de conocimiento, siempre permanecerá cifrada. El servicio de búsqueda omitirá los intentos de establecer esta propiedad en null. Puedes cambiar esta propiedad según lo necesites si quieres rotar tu clave de cifrado; La definición de tu fuente de conocimiento no se verá afectada. El cifrado con claves administradas por el cliente no está disponible para los servicios de búsqueda gratuitos y solo está disponible para los servicios pagos creados a partir del 1 de enero de 2019.
kind	string: remoteSharePoint	El tipo de fuente de conocimiento.
name	string	El nombre de la fuente de conocimiento.
remoteSharePointParameters	RemoteSharePointKnowledgeSourceParameters	Los parámetros para la fuente de conocimiento remota de SharePoint.

RemoteSharePointKnowledgeSourceParameters

Objeto

Parámetros para el origen de conocimiento remoto de SharePoint.

Nombre	Tipo	Description
containerTypeId	string	Identificador de contenedor para la conexión de SharePoint Embedded. Cuando es null, usará SharePoint Online.
filterExpression	string	Expresión de lenguaje de consulta de palabras clave (KQL) con propiedades y atributos de SharePoint consultables para determinar el ámbito de la recuperación antes de que se ejecute la consulta.
resourceMetadata	string[]	Lista de campos de metadatos que se devolverán para cada elemento de la respuesta. En esta lista solo se pueden incluir propiedades de metadatos recuperables. De forma predeterminada, no se devuelve ningún metadato.

SearchIndexerDataNoneIdentity

Objeto

Borra la propiedad de identidad de un origen de datos.

Nombre	Tipo	Description
@odata.type	string: #Microsoft.Azure.Search.DataNoneIdentity	Fragmento de URI que especifica el tipo de identidad.

SearchIndexerDataUserAssignedIdentity

Objeto

Especifica la identidad de un origen de datos que se va a usar.

Nombre	Tipo	Description
@odata.type	string: #Microsoft.Azure.Search.DataUserAssignedIdentity	Fragmento de URI que especifica el tipo de identidad.
userAssignedIdentity	string	Identificador de recurso completo de Azure de una identidad administrada asignada por el usuario, normalmente con el formato "/subscriptions/12345678-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId" que debería haberse asignado al servicio de búsqueda.

SearchIndexFieldReference

Objeto

Referencia de campo para un índice de búsqueda.

Nombre	Tipo	Description
name	string	Nombre del campo.

SearchIndexKnowledgeSource

Objeto

Fuente de conocimiento dirigida a un índice de búsqueda.

Nombre	Tipo	Description
@odata.etag	string	El ETag de la fuente de conocimiento.
description	string	Descripción opcional definida por el usuario.
encryptionKey	SearchResourceEncryptionKey	Descripción de una clave de cifrado que se crea en Azure Key Vault. Esta clave se utiliza para proporcionar un nivel adicional de cifrado en reposo para la definición de la fuente de conocimiento cuando quieres la total seguridad de que nadie, ni siquiera Microsoft, puede descifrarlas. Una vez que hayas cifrado la definición de tu fuente de conocimiento, siempre permanecerá cifrada. El servicio de búsqueda omitirá los intentos de establecer esta propiedad en null. Puedes cambiar esta propiedad según lo necesites si quieres rotar tu clave de cifrado; La definición de tu fuente de conocimiento no se verá afectada. El cifrado con claves administradas por el cliente no está disponible para los servicios de búsqueda gratuitos y solo está disponible para los servicios pagos creados a partir del 1 de enero de 2019.
kind	string: searchIndex	El tipo de fuente de conocimiento.
name	string	El nombre de la fuente de conocimiento.
searchIndexParameters	SearchIndexKnowledgeSourceParameters	Los parámetros de la fuente de conocimiento.

SearchIndexKnowledgeSourceParameters

Objeto

Parámetros para el origen de conocimiento del índice de búsqueda.

Nombre	Tipo	Description
searchFields	SearchIndexFieldReference[]	Se utiliza para restringir los campos que se buscan en el índice de búsqueda.
searchIndexName	string	El nombre del índice de búsqueda.
semanticConfigurationName	string	Se utiliza para especificar una configuración semántica diferente en el índice de búsqueda de destino distinta de la predeterminada.
sourceDataFields	SearchIndexFieldReference[]	Se utiliza para solicitar campos adicionales para los datos de origen a los que se hace referencia.

SearchResourceEncryptionKey

Objeto

Una clave de cifrado administrada por el cliente en Azure Key Vault. Las claves que crea y administra se pueden usar para cifrar o descifrar datos en reposo, como índices y mapas de sinónimos.

Nombre	Tipo	Description
accessCredentials.applicationId	string	Un identificador de aplicación de AAD al que se concedieron los permisos de acceso necesarios a Azure Key Vault que se va a usar al cifrar los datos en reposo. El identificador de aplicación no debe confundirse con el id. de objeto de la aplicación de AAD.
accessCredentials.applicationSecret	string	Clave de autenticación de la aplicación de AAD especificada.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Una identidad administrada explícita que se va a usar para esta clave de cifrado. Si no se especifica y la propiedad de credenciales de acceso es null, se usa la identidad administrada asignada por el sistema. Al actualizar al recurso, si la identidad explícita no está especificada, permanece sin cambios. Si se especifica "none", se borra el valor de esta propiedad.
keyVaultKeyName	string	Nombre de la clave de Azure Key Vault que se usará para cifrar los datos en reposo.
keyVaultKeyVersion	string	Versión de la clave de Azure Key Vault que se usará para cifrar los datos en reposo.
keyVaultUri	string	El URI de Azure Key Vault, también denominado nombre DNS, que contiene la clave que se va a usar para cifrar los datos en reposo. Un URI de ejemplo podría ser `https://my-keyvault-name.vault.azure.net`.

VectorSearchVectorizerKind

Enumeración

El método de vectorización que se utilizará durante el tiempo de consulta.

Valor	Description
azureOpenAI	Genere incrustaciones mediante un recurso de Azure OpenAI en el momento de la consulta.
customWebApi	Genere incrustaciones mediante un punto de conexión web personalizado en el momento de la consulta.
aiServicesVision	Genere incrustaciones para una entrada de imagen o texto en el momento de la consulta mediante Azure AI Services Vision Vectorize API.
aml	Genere inserciones mediante un punto de conexión de Azure Machine Learning implementado a través del catálogo de modelos de Azure AI Foundry en el momento de la consulta.

WebKnowledgeSource

Objeto

Fuente de conocimiento dirigida a resultados web.

Nombre	Tipo	Description
@odata.etag	string	El ETag de la fuente de conocimiento.
description	string	Descripción opcional definida por el usuario.
encryptionKey	SearchResourceEncryptionKey	Descripción de una clave de cifrado que se crea en Azure Key Vault. Esta clave se utiliza para proporcionar un nivel adicional de cifrado en reposo para la definición de la fuente de conocimiento cuando quieres la total seguridad de que nadie, ni siquiera Microsoft, puede descifrarlas. Una vez que hayas cifrado la definición de tu fuente de conocimiento, siempre permanecerá cifrada. El servicio de búsqueda omitirá los intentos de establecer esta propiedad en null. Puedes cambiar esta propiedad según lo necesites si quieres rotar tu clave de cifrado; La definición de tu fuente de conocimiento no se verá afectada. El cifrado con claves administradas por el cliente no está disponible para los servicios de búsqueda gratuitos y solo está disponible para los servicios pagos creados a partir del 1 de enero de 2019.
kind	string: web	El tipo de fuente de conocimiento.
name	string	El nombre de la fuente de conocimiento.
webParameters	WebKnowledgeSourceParameters	Los parámetros de la fuente de conocimiento web.

WebKnowledgeSourceDomain

Objeto

Configuración para el dominio de origen de conocimiento web.

Nombre	Tipo	Description
address	string	La dirección del dominio.
includeSubpages	boolean	Si se deben incluir o no subpáginas de este dominio.

WebKnowledgeSourceDomains

Objeto

Configuración de dominio/bloqueo para el origen de conocimiento web.

Nombre	Tipo	Description
allowedDomains	WebKnowledgeSourceDomain[]	Dominios que están permitidos para resultados web.
blockedDomains	WebKnowledgeSourceDomain[]	Dominios bloqueados en los resultados web.

WebKnowledgeSourceParameters

Objeto

Parámetros para el origen de conocimiento web.

Nombre	Tipo	Description
domains	WebKnowledgeSourceDomains	Configuración de dominio/bloqueo de permitidos para resultados web.