Data Sources - Create

Servicio:: Search Service

Versión de la API:: 2026-04-01

Crea una nueva fuente de datos.

POST {endpoint}/datasources?api-version=2026-04-01

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 la API que se va a usar para esta 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

Nombre	Requerido	Tipo	Description
container	True	SearchIndexerDataContainer	Contenedor de datos para el origen de datos.
name	True	string	Nombre del origen de datos.
type	True	SearchIndexerDataSourceType	Tipo del origen de datos.
@odata.etag		string	ETag del origen de datos.
credentials.connectionString		string	Cadena de conexión para el origen de datos. Establézcalo en `<unchanged>` (con corchetes) si no desea que se actualice la cadena de conexión. Establézcalo en `<redacted>` si desea quitar el valor de la cadena de conexión del origen de datos.
dataChangeDetectionPolicy		DataChangeDetectionPolicy: HighWaterMarkChangeDetectionPolicy SqlIntegratedChangeTrackingPolicy	Directiva de detección de cambios de datos para el origen de datos.
dataDeletionDetectionPolicy		DataDeletionDetectionPolicy: NativeBlobSoftDeleteDeletionDetectionPolicy SoftDeleteColumnDeletionDetectionPolicy	Directiva de detección de eliminación de datos para el origen de datos.
description		string	Descripción del origen de datos.
encryptionKey		SearchResourceEncryptionKey	Descripción de una clave de cifrado que se crea en Azure Key Vault. Esta clave se usa para proporcionar un nivel adicional de cifrado en reposo para la definición del origen de datos cuando desea una garantía total de que nadie, ni siquiera Microsoft, puede descifrar la definición del origen de datos. Una vez que haya cifrado la definición del origen de datos, siempre permanecerá cifrada. El servicio de búsqueda omitirá los intentos de establecer esta propiedad en null. Puede cambiar esta propiedad según sea necesario si desea rotar la clave de cifrado; La definición del origen de datos 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.
identity		SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Una identidad administrada explícita que se va a usar para este origen de datos. Si no se especifica y la cadena de conexión es una identidad administrada, se usa la identidad administrada asignada por el sistema. Si no se especifica, el valor permanece sin cambios. Si se especifica "none", se borra el valor de esta propiedad.

Respuestas

Nombre	Tipo	Description
201 Created	SearchIndexerDataSource	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

SearchServiceCreateDataSource

Solicitud de ejemplo

HTTP

POST https://exampleservice.search.windows.net/datasources?api-version=2026-04-01


{
  "name": "tempdatasource",
  "description": "My Azure Blob data source.",
  "type": "azureblob",
  "credentials": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net "
  },
  "container": {
    "name": "doc-extraction-skillset",
    "query": "E2E_Dsat"
  },
  "identity": {
    "@odata.type": "#Microsoft.Azure.Search.DataNoneIdentity"
  },
  "dataChangeDetectionPolicy": {
    "highWaterMarkColumnName": "metadata_storage_last_modified",
    "@odata.type": "#Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy"
  },
  "dataDeletionDetectionPolicy": {
    "softDeleteColumnName": "isDeleted",
    "softDeleteMarkerValue": "true",
    "@odata.type": "#Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy"
  },
  "@odata.etag": "0x1234568AE7E58A1"
}

Respuesta de muestra

status code:: 201

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "tempdatasource",
  "description": "My Azure Blob data source.",
  "type": "azureblob",
  "credentials": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net "
  },
  "container": {
    "name": "doc-extraction-skillset",
    "query": "E2E_Dsat"
  },
  "dataChangeDetectionPolicy": {
    "@odata.type": "#Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy",
    "highWaterMarkColumnName": "metadata_storage_last_modified"
  },
  "dataDeletionDetectionPolicy": {
    "@odata.type": "#Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy",
    "softDeleteColumnName": "isDeleted",
    "softDeleteMarkerValue": "true"
  },
  "identity": {
    "@odata.type": "#Microsoft.Azure.Search.DataNoneIdentity"
  }
}

Definiciones

Nombre	Description
Accept	El encabezado Aceptar.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta común a errores para todas las APIs de Azure Resource Manager para devolver detalles de error por operaciones fallidas. (Esto también sigue el formato de respuesta de error de OData).
HighWaterMarkChangeDetectionPolicy	Define una directiva de detección de cambios de datos que captura los cambios en función del valor de una columna de marca de agua alta.
NativeBlobSoftDeleteDeletionDetectionPolicy	Define una directiva de detección de eliminación de datos mediante la característica nativa de eliminación temporal de Azure Blob Storage para la detección de eliminación.
SearchIndexerDataContainer	Representa información sobre la entidad (como la tabla de Azure SQL o la colección cosmosDB) que se indexará.
SearchIndexerDataNoneIdentity	Borra la propiedad de identidad de un origen de datos.
SearchIndexerDataSource	Representa una definición de origen de datos, que se puede usar para configurar un indexador.
SearchIndexerDataSourceType	Define el tipo de origen de datos.
SearchIndexerDataUserAssignedIdentity	Especifica la identidad de un origen de datos que se va a usar.
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.
SoftDeleteColumnDeletionDetectionPolicy	Define una directiva de detección de eliminación de datos que implementa una estrategia de eliminación temporal. Determina si un elemento se debe eliminar en función del valor de una columna designada "eliminación temporal".
SqlIntegratedChangeTrackingPolicy	Define una directiva de detección de cambios de datos que captura los cambios mediante la característica Seguimiento de cambios integrado de Azure SQL Database.

Accept

Enumeración

El encabezado Aceptar.

Valor	Description
application/json;odata.metadata=minimal

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[]	Detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta común a errores para todas las APIs de Azure Resource Manager para devolver detalles de error por operaciones fallidas. (Esto también sigue el formato de respuesta de error de OData).

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

HighWaterMarkChangeDetectionPolicy

Objeto

Define una directiva de detección de cambios de datos que captura los cambios en función del valor de una columna de marca de agua alta.

Nombre	Tipo	Description
@odata.type	string: #Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy	El discriminador para los tipos derivados.
highWaterMarkColumnName	string	Nombre de la columna de marca de agua alta.

NativeBlobSoftDeleteDeletionDetectionPolicy

Objeto

Define una directiva de detección de eliminación de datos mediante la característica nativa de eliminación temporal de Azure Blob Storage para la detección de eliminación.

Nombre	Tipo	Description
@odata.type	string: #Microsoft.Azure.Search.NativeBlobSoftDeleteDeletionDetectionPolicy	El discriminador para los tipos derivados.

SearchIndexerDataContainer

Objeto

Representa información sobre la entidad (como la tabla de Azure SQL o la colección cosmosDB) que se indexará.

Nombre	Tipo	Description
name	string	Nombre de la tabla o vista (para el origen de datos SQL de Azure) o la colección (para el origen de datos de CosmosDB) que se indexará.
query	string	Consulta que se aplica a este contenedor de datos. La sintaxis y el significado de este parámetro son específicos de la fuente de datos. No es compatible con los orígenes de datos de Azure SQL.

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.

SearchIndexerDataSource

Objeto

Representa una definición de origen de datos, que se puede usar para configurar un indexador.

Nombre	Tipo	Description
@odata.etag	string	ETag del origen de datos.
container	SearchIndexerDataContainer	Contenedor de datos para el origen de datos.
credentials.connectionString	string	Cadena de conexión para el origen de datos. Establézcalo en `<unchanged>` (con corchetes) si no desea que se actualice la cadena de conexión. Establézcalo en `<redacted>` si desea quitar el valor de la cadena de conexión del origen de datos.
dataChangeDetectionPolicy	DataChangeDetectionPolicy: HighWaterMarkChangeDetectionPolicy SqlIntegratedChangeTrackingPolicy	Directiva de detección de cambios de datos para el origen de datos.
dataDeletionDetectionPolicy	DataDeletionDetectionPolicy: NativeBlobSoftDeleteDeletionDetectionPolicy SoftDeleteColumnDeletionDetectionPolicy	Directiva de detección de eliminación de datos para el origen de datos.
description	string	Descripción del origen de datos.
encryptionKey	SearchResourceEncryptionKey	Descripción de una clave de cifrado que se crea en Azure Key Vault. Esta clave se usa para proporcionar un nivel adicional de cifrado en reposo para la definición del origen de datos cuando desea una garantía total de que nadie, ni siquiera Microsoft, puede descifrar la definición del origen de datos. Una vez que haya cifrado la definición del origen de datos, siempre permanecerá cifrada. El servicio de búsqueda omitirá los intentos de establecer esta propiedad en null. Puede cambiar esta propiedad según sea necesario si desea rotar la clave de cifrado; La definición del origen de datos 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.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Una identidad administrada explícita que se va a usar para este origen de datos. Si no se especifica y la cadena de conexión es una identidad administrada, se usa la identidad administrada asignada por el sistema. Si no se especifica, el valor permanece sin cambios. Si se especifica "none", se borra el valor de esta propiedad.
name	string	Nombre del origen de datos.
type	SearchIndexerDataSourceType	Tipo del origen de datos.

SearchIndexerDataSourceType

Enumeración

Define el tipo de origen de datos.

Valor	Description
azuresql	Indica un origen de datos de Azure SQL.
cosmosdb	Indica un origen de datos de CosmosDB.
azureblob	Indica un origen de datos de Azure Blob.
azuretable	Indica un origen de datos de tabla de Azure.
mysql	Indica un origen de datos MySql.
adlsgen2	Indica un origen de datos de ADLS Gen2.
onelake	Indica un origen de datos de Microsoft Fabric OneLake.
sharepoint	Indica un origen de datos de SharePoint.

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	El identificador de recurso de Azure completo 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 se debe haber asignado al servicio de búsqueda.

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

SoftDeleteColumnDeletionDetectionPolicy

Objeto

Define una directiva de detección de eliminación de datos que implementa una estrategia de eliminación temporal. Determina si un elemento se debe eliminar en función del valor de una columna designada "eliminación temporal".

Nombre	Tipo	Description
@odata.type	string: #Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy	El discriminador para los tipos derivados.
softDeleteColumnName	string	Nombre de la columna que se va a usar para la detección de eliminación temporal.
softDeleteMarkerValue	string	Valor de marcador que identifica un elemento como eliminado.

SqlIntegratedChangeTrackingPolicy

Objeto

Define una directiva de detección de cambios de datos que captura los cambios mediante la característica Seguimiento de cambios integrado de Azure SQL Database.

Nombre	Tipo	Description
@odata.type	string: #Microsoft.Azure.Search.SqlIntegratedChangeTrackingPolicy	El discriminador para los tipos derivados.