Datastores - List

Servicio:: Machine Learning

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

Enumerar almacenes de datos.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/datastores?api-version=2025-04-01

Con parámetros opcionales:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/datastores?api-version=2025-04-01&$skip={$skip}&count={count}&isDefault={isDefault}&names={names}&searchText={searchText}&orderBy={orderBy}&orderByAsc={orderByAsc}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
workspaceName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Nombre del área de trabajo de Azure Machine Learning.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.
$skip	query		string	Token de continuación para la paginación.
count	query		integer (int32)	Número máximo de resultados que se van a devolver.
isDefault	query		boolean	Filtre por el almacén de datos predeterminado del área de trabajo.
names	query		string[]	Nombres de almacenes de datos que se van a devolver.
orderBy	query		string	Ordenar por propiedad (createdtime \| modifiedtime \| name).
orderByAsc	query		boolean	Ordenar por propiedad en orden ascendente.
searchText	query		string	Texto que se va a buscar en los nombres del almacén de datos.

Respuestas

Nombre	Tipo	Description
200 OK	DatastoreResourceArmPaginatedResult	Éxito
Other Status Codes	ErrorResponse	Error

Ejemplos

List datastores.

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/datastores?api-version=2025-04-01&count=1&isDefault=False&names=string&searchText=string&orderBy=string&orderByAsc=False

Respuesta de muestra

status code:: 200

{
  "value": [
    {
      "id": "string",
      "name": "string",
      "type": "string",
      "properties": {
        "description": "string",
        "tags": {
          "string": "string"
        },
        "isDefault": false,
        "properties": null,
        "credentials": {
          "credentialsType": "AccountKey",
          "secrets": {
            "secretsType": "AccountKey"
          }
        },
        "datastoreType": "AzureBlob",
        "accountName": "string",
        "containerName": "string",
        "endpoint": "core.windows.net",
        "protocol": "https"
      },
      "systemData": {
        "createdAt": "2020-01-01T12:34:56.999Z",
        "createdBy": "string",
        "createdByType": "User",
        "lastModifiedAt": "2020-01-01T12:34:56.999Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "User"
      }
    }
  ],
  "nextLink": "string"
}

Definiciones

Nombre	Description
AccountKeyDatastoreCredentials	Configuración de credenciales del almacén de datos de clave de cuenta.
AccountKeyDatastoreSecrets	Secretos de clave de cuenta de almacén de datos.
AzureBlobDatastore	Configuración del almacén de datos de Blob de Azure.
AzureDataLakeGen1Datastore	Configuración del almacén de datos de Azure Data Lake Gen1.
AzureDataLakeGen2Datastore	Configuración del almacén de datos de Azure Data Lake Gen2.
AzureFileDatastore	Configuración del almacén de datos de Azure File.
CertificateDatastoreCredentials	Configuración de credenciales del almacén de datos de certificado.
CertificateDatastoreSecrets	Secretos de certificado de almacén de datos.
createdByType	Tipo de identidad que creó el recurso.
CredentialsType	Enumeración para determinar el tipo de credenciales del almacén de datos.
DatastoreResource	Sobre de recursos de Azure Resource Manager.
DatastoreResourceArmPaginatedResult	Lista paginada de entidades de almacén de datos.
DatastoreType	Enumeración para determinar el tipo de contenido del almacén de datos.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
LakeHouseArtifact
NoneDatastoreCredentials	Credenciales vacías o ninguna del almacén de datos.
OneLakeArtifactType	Enumeración para determinar el tipo de artefacto oneLake.
OneLakeDatastore	Configuración del almacén de datos oneLake (Trident).
SasDatastoreCredentials	Configuración de credenciales del almacén de datos de SAS.
SasDatastoreSecrets	Secretos de SAS del almacén de datos.
SecretsType	Enumeración para determinar el tipo de secretos del almacén de datos.
ServiceDataAccessAuthIdentity
ServicePrincipalDatastoreCredentials	Configuración de credenciales del almacén de datos de la entidad de servicio.
ServicePrincipalDatastoreSecrets	Secretos de entidad de servicio de almacén de datos.
systemData	Metadatos relativos a la creación y última modificación del recurso.

AccountKeyDatastoreCredentials

Object

Configuración de credenciales del almacén de datos de clave de cuenta.

Nombre	Tipo	Description
credentialsType	string: AccountKey	[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.
secrets	AccountKeyDatastoreSecrets	[Obligatorio] Secretos de la cuenta de almacenamiento.

AccountKeyDatastoreSecrets

Object

Secretos de clave de cuenta de almacén de datos.

Nombre	Tipo	Description
key	string	Clave de cuenta de almacenamiento.
secretsType	string: AccountKey	[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.

AzureBlobDatastore

Object

Configuración del almacén de datos de Blob de Azure.

Nombre	Tipo	Valor predeterminado	Description
accountName	string		Nombre de la cuenta de almacenamiento.
containerName	string		Nombre del contenedor de la cuenta de almacenamiento.
credentials	DatastoreCredentials: AccountKeyDatastoreCredentials CertificateDatastoreCredentials NoneDatastoreCredentials SasDatastoreCredentials ServicePrincipalDatastoreCredentials		[Obligatorio] Credenciales de cuenta.
datastoreType	string: AzureBlob		[Obligatorio] Tipo de almacenamiento que respalda el almacén de datos.
description	string		Texto de descripción del recurso.
endpoint	string		Punto de conexión en la nube de Azure para la cuenta de almacenamiento.
isDefault	boolean		Propiedad Readonly para indicar si el almacén de datos es el almacén de datos predeterminado del área de trabajo
properties	object		Diccionario de propiedades de recurso.
protocol	string		Protocolo usado para comunicarse con la cuenta de almacenamiento.
resourceGroup	string		Nombre del grupo de recursos de Azure
serviceDataAccessAuthIdentity	ServiceDataAccessAuthIdentity	None	Indica la identidad que se va a usar para autenticar el acceso de datos del servicio al almacenamiento del cliente.
subscriptionId	string		Identificador de suscripción de Azure
tags	object		Diccionario de etiquetas. Las etiquetas se pueden agregar, quitar y actualizar.

AzureDataLakeGen1Datastore

Object

Configuración del almacén de datos de Azure Data Lake Gen1.

Nombre	Tipo	Valor predeterminado	Description
credentials	DatastoreCredentials: AccountKeyDatastoreCredentials CertificateDatastoreCredentials NoneDatastoreCredentials SasDatastoreCredentials ServicePrincipalDatastoreCredentials		[Obligatorio] Credenciales de cuenta.
datastoreType	string: AzureDataLakeGen1		[Obligatorio] Tipo de almacenamiento que respalda el almacén de datos.
description	string		Texto de descripción del recurso.
isDefault	boolean		Propiedad Readonly para indicar si el almacén de datos es el almacén de datos predeterminado del área de trabajo
properties	object		Diccionario de propiedades de recurso.
resourceGroup	string		Nombre del grupo de recursos de Azure
serviceDataAccessAuthIdentity	ServiceDataAccessAuthIdentity	None	Indica la identidad que se va a usar para autenticar el acceso de datos del servicio al almacenamiento del cliente.
storeName	string minLength: 1 pattern: [a-zA-Z0-9_]		[Obligatorio] Nombre del almacén de Azure Data Lake.
subscriptionId	string		Identificador de suscripción de Azure
tags	object		Diccionario de etiquetas. Las etiquetas se pueden agregar, quitar y actualizar.

AzureDataLakeGen2Datastore

Object

Configuración del almacén de datos de Azure Data Lake Gen2.

Nombre	Tipo	Valor predeterminado	Description
accountName	string minLength: 1 pattern: [a-zA-Z0-9_]		[Obligatorio] Nombre de la cuenta de almacenamiento.
credentials	DatastoreCredentials: AccountKeyDatastoreCredentials CertificateDatastoreCredentials NoneDatastoreCredentials SasDatastoreCredentials ServicePrincipalDatastoreCredentials		[Obligatorio] Credenciales de cuenta.
datastoreType	string: AzureDataLakeGen2		[Obligatorio] Tipo de almacenamiento que respalda el almacén de datos.
description	string		Texto de descripción del recurso.
endpoint	string		Punto de conexión en la nube de Azure para la cuenta de almacenamiento.
filesystem	string minLength: 1 pattern: [a-zA-Z0-9_]		[Obligatorio] Nombre del sistema de archivos de Data Lake Gen2.
isDefault	boolean		Propiedad Readonly para indicar si el almacén de datos es el almacén de datos predeterminado del área de trabajo
properties	object		Diccionario de propiedades de recurso.
protocol	string		Protocolo usado para comunicarse con la cuenta de almacenamiento.
resourceGroup	string		Nombre del grupo de recursos de Azure
serviceDataAccessAuthIdentity	ServiceDataAccessAuthIdentity	None	Indica la identidad que se va a usar para autenticar el acceso de datos del servicio al almacenamiento del cliente.
subscriptionId	string		Identificador de suscripción de Azure
tags	object		Diccionario de etiquetas. Las etiquetas se pueden agregar, quitar y actualizar.

AzureFileDatastore

Object

Configuración del almacén de datos de Azure File.

Nombre	Tipo	Valor predeterminado	Description
accountName	string minLength: 1 pattern: [a-zA-Z0-9_]		[Obligatorio] Nombre de la cuenta de almacenamiento.
credentials	DatastoreCredentials: AccountKeyDatastoreCredentials CertificateDatastoreCredentials NoneDatastoreCredentials SasDatastoreCredentials ServicePrincipalDatastoreCredentials		[Obligatorio] Credenciales de cuenta.
datastoreType	string: AzureFile		[Obligatorio] Tipo de almacenamiento que respalda el almacén de datos.
description	string		Texto de descripción del recurso.
endpoint	string		Punto de conexión en la nube de Azure para la cuenta de almacenamiento.
fileShareName	string minLength: 1 pattern: [a-zA-Z0-9_]		[Obligatorio] Nombre del recurso compartido de archivos de Azure al que apunta el almacén de datos.
isDefault	boolean		Propiedad Readonly para indicar si el almacén de datos es el almacén de datos predeterminado del área de trabajo
properties	object		Diccionario de propiedades de recurso.
protocol	string		Protocolo usado para comunicarse con la cuenta de almacenamiento.
resourceGroup	string		Nombre del grupo de recursos de Azure
serviceDataAccessAuthIdentity	ServiceDataAccessAuthIdentity	None	Indica la identidad que se va a usar para autenticar el acceso de datos del servicio al almacenamiento del cliente.
subscriptionId	string		Identificador de suscripción de Azure
tags	object		Diccionario de etiquetas. Las etiquetas se pueden agregar, quitar y actualizar.

CertificateDatastoreCredentials

Object

Configuración de credenciales del almacén de datos de certificado.

Nombre	Tipo	Description
authorityUrl	string	Dirección URL de autoridad usada para la autenticación.
clientId	string (uuid)	[Obligatorio] Identificador de cliente de la entidad de servicio.
credentialsType	string: Certificate	[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.
resourceUrl	string	Recurso al que tiene acceso la entidad de servicio.
secrets	CertificateDatastoreSecrets	[Obligatorio] Secretos de entidad de servicio.
tenantId	string (uuid)	[Obligatorio] Identificador del inquilino al que pertenece la entidad de servicio.
thumbprint	string minLength: 1 pattern: [a-zA-Z0-9_]	[Obligatorio] Huella digital del certificado usado para la autenticación.

CertificateDatastoreSecrets

Object

Secretos de certificado de almacén de datos.

Nombre	Tipo	Description
certificate	string	Certificado de entidad de servicio.
secretsType	string: Certificate	[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
Application
Key
ManagedIdentity
User

CredentialsType

Enumeración

Enumeración para determinar el tipo de credenciales del almacén de datos.

Valor	Description
AccountKey
Certificate
None
Sas
ServicePrincipal

DatastoreResource

Object

Sobre de recursos de Azure Resource Manager.

Nombre	Tipo	Description
id	string	Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nombre del recurso
properties	Datastore: AzureBlobDatastore AzureDataLakeGen1Datastore AzureDataLakeGen2Datastore AzureFileDatastore OneLakeDatastore	[Obligatorio] Atributos adicionales de la entidad.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

DatastoreResourceArmPaginatedResult

Object

Lista paginada de entidades de almacén de datos.

Nombre	Tipo	Description
nextLink	string	Vínculo a la página siguiente de objetos de almacén de datos. Si es null, no hay páginas adicionales.
value	DatastoreResource[]	Matriz de objetos de tipo Almacén de datos.

DatastoreType

Enumeración

Enumeración para determinar el tipo de contenido del almacén de datos.

Valor	Description
AzureBlob
AzureDataLakeGen1
AzureDataLakeGen2
AzureFile
OneLake

ErrorAdditionalInfo

Object

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

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

ErrorDetail

Object

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

Object

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

LakeHouseArtifact

Object

Nombre	Tipo	Description
artifactName	string minLength: 1 pattern: [a-zA-Z0-9_]	[Obligatorio] Nombre del artefacto de OneLake
artifactType	string: LakeHouse	[Obligatorio] Tipo de artefacto oneLake

NoneDatastoreCredentials

Object

Credenciales vacías o ninguna del almacén de datos.

Nombre	Tipo	Description
credentialsType	string: None	[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.

OneLakeArtifactType

Enumeración

Enumeración para determinar el tipo de artefacto oneLake.

Valor	Description
LakeHouse

OneLakeDatastore

Object

Configuración del almacén de datos oneLake (Trident).

Nombre	Tipo	Valor predeterminado	Description
artifact	OneLakeArtifact: LakeHouseArtifact		[Obligatorio] Artefacto de OneLake que respalda el almacén de datos.
credentials	DatastoreCredentials: AccountKeyDatastoreCredentials CertificateDatastoreCredentials NoneDatastoreCredentials SasDatastoreCredentials ServicePrincipalDatastoreCredentials		[Obligatorio] Credenciales de cuenta.
datastoreType	string: OneLake		[Obligatorio] Tipo de almacenamiento que respalda el almacén de datos.
description	string		Texto de descripción del recurso.
endpoint	string		Punto de conexión de OneLake que se va a usar para el almacén de datos.
isDefault	boolean		Propiedad Readonly para indicar si el almacén de datos es el almacén de datos predeterminado del área de trabajo
oneLakeWorkspaceName	string minLength: 1 pattern: [a-zA-Z0-9_]		[Obligatorio] Nombre del área de trabajo de OneLake.
properties	object		Diccionario de propiedades de recurso.
serviceDataAccessAuthIdentity	ServiceDataAccessAuthIdentity	None	Indica la identidad que se va a usar para autenticar el acceso de datos del servicio al almacenamiento del cliente.
tags	object		Diccionario de etiquetas. Las etiquetas se pueden agregar, quitar y actualizar.

SasDatastoreCredentials

Object

Configuración de credenciales del almacén de datos de SAS.

Nombre	Tipo	Description
credentialsType	string: Sas	[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.
secrets	SasDatastoreSecrets	[Obligatorio] Secretos de contenedor de almacenamiento.

SasDatastoreSecrets

Object

Secretos de SAS del almacén de datos.

Nombre	Tipo	Description
sasToken	string	Token de SAS del contenedor de almacenamiento.
secretsType	string: Sas	[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.

SecretsType

Enumeración

Enumeración para determinar el tipo de secretos del almacén de datos.

Valor	Description
AccountKey
Certificate
Sas
ServicePrincipal

ServiceDataAccessAuthIdentity

Enumeración

Valor	Description
None	No use ninguna identidad para el acceso a datos de servicio.
WorkspaceSystemAssignedIdentity	Use la identidad administrada asignada por el sistema del área de trabajo para autenticar el acceso a los datos del servicio.
WorkspaceUserAssignedIdentity	Use la identidad administrada asignada por el usuario del área de trabajo para autenticar el acceso a datos del servicio.

ServicePrincipalDatastoreCredentials

Object

Configuración de credenciales del almacén de datos de la entidad de servicio.

Nombre	Tipo	Description
authorityUrl	string	Dirección URL de autoridad usada para la autenticación.
clientId	string (uuid)	[Obligatorio] Identificador de cliente de la entidad de servicio.
credentialsType	string: ServicePrincipal	[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.
resourceUrl	string	Recurso al que tiene acceso la entidad de servicio.
secrets	ServicePrincipalDatastoreSecrets	[Obligatorio] Secretos de entidad de servicio.
tenantId	string (uuid)	[Obligatorio] Identificador del inquilino al que pertenece la entidad de servicio.

ServicePrincipalDatastoreSecrets

Object

Secretos de entidad de servicio de almacén de datos.

Nombre	Tipo	Description
clientSecret	string	Secreto de entidad de servicio.
secretsType	string: ServicePrincipal	[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.

systemData

Object

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

Compartir a través de

Datastores - List

Parámetros de identificador URI

Respuestas

Ejemplos

List datastores.

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AccountKeyDatastoreCredentials

AccountKeyDatastoreSecrets

AzureBlobDatastore

AzureDataLakeGen1Datastore

AzureDataLakeGen2Datastore

AzureFileDatastore

CertificateDatastoreCredentials

CertificateDatastoreSecrets

createdByType

CredentialsType

DatastoreResource

DatastoreResourceArmPaginatedResult

DatastoreType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

LakeHouseArtifact

NoneDatastoreCredentials

OneLakeArtifactType

OneLakeDatastore

SasDatastoreCredentials

SasDatastoreSecrets

SecretsType

ServiceDataAccessAuthIdentity

ServicePrincipalDatastoreCredentials

ServicePrincipalDatastoreSecrets

systemData