Datastores - Get

Obtenga el almacén de datos.

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

Parámetros de identificador URI

Name In Required Type Description
name
path True
  • string

Nombre del almacén de datos.

resourceGroupName
path True
  • string

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

subscriptionId
path True
  • string

Identificador de la suscripción de destino.

workspaceName
path True
  • string

Nombre del área de trabajo de Azure Machine Learning.

api-version
query True
  • string

Versión de API que se usará para la operación.

Respuestas

Name Type Description
200 OK

Correcto

Other Status Codes

Error

Ejemplos

Get datastore.

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/datastores/string?api-version=2022-06-01-preview

Sample Response

{
  "id": "string",
  "name": "string",
  "type": "string",
  "properties": {
    "description": "string",
    "tags": {
      "string": "string"
    },
    "isDefault": false,
    "properties": null,
    "credentials": {
      "credentialsType": "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"
  }
}

Definiciones

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 blobs 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 certificados.

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.

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

HdfsDatastore
KerberosKeytabCredentials
KerberosKeytabSecrets
KerberosPasswordCredentials
KerberosPasswordSecrets
NoneDatastoreCredentials

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

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 del almacén de datos.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

AccountKeyDatastoreCredentials

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

Name Type Description
credentialsType string:
  • AccountKey

[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.

secrets

[Obligatorio] Secretos de la cuenta de almacenamiento.

AccountKeyDatastoreSecrets

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

Name Type Description
key
  • string

Clave de la cuenta de almacenamiento.

secretsType string:
  • AccountKey

[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.

AzureBlobDatastore

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

Name Type Default Value Description
accountName
  • string

Nombre de la cuenta de almacenamiento.

containerName
  • string

Nombre del contenedor de la cuenta de almacenamiento.

credentials DatastoreCredentials:

[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 recursos.

protocol
  • string

Protocolo usado para comunicarse con la cuenta de almacenamiento.

resourceGroup
  • string

Nombre del grupo de recursos de Azure

serviceDataAccessAuthIdentity None

Indica qué identidad se va a usar para autenticar el acceso a datos de servicio para el almacenamiento del cliente.

subscriptionId
  • string

Id. de suscripción de Azure

tags
  • object

Diccionario de etiquetas. Las etiquetas se pueden agregar, quitar y actualizar.

AzureDataLakeGen1Datastore

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

Name Type Default Value Description
credentials DatastoreCredentials:

[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 recursos.

resourceGroup
  • string

Nombre del grupo de recursos de Azure

serviceDataAccessAuthIdentity None

Indica qué identidad se va a usar para autenticar el acceso a datos de servicio para el almacenamiento del cliente.

storeName
  • string

[Obligatorio] Nombre del almacén de Azure Data Lake.

subscriptionId
  • string

Id. de suscripción de Azure

tags
  • object

Diccionario de etiquetas. Las etiquetas se pueden agregar, quitar y actualizar.

AzureDataLakeGen2Datastore

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

Name Type Default Value Description
accountName
  • string

[Obligatorio] Nombre de la cuenta de almacenamiento.

credentials DatastoreCredentials:

[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

[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 recursos.

protocol
  • string

Protocolo usado para comunicarse con la cuenta de almacenamiento.

resourceGroup
  • string

Nombre del grupo de recursos de Azure

serviceDataAccessAuthIdentity None

Indica qué identidad se va a usar para autenticar el acceso a datos de servicio para el almacenamiento del cliente.

subscriptionId
  • string

Id. de suscripción de Azure

tags
  • object

Diccionario de etiquetas. Las etiquetas se pueden agregar, quitar y actualizar.

AzureFileDatastore

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

Name Type Default Value Description
accountName
  • string

[Obligatorio] Nombre de la cuenta de almacenamiento.

credentials DatastoreCredentials:

[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

[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 recursos.

protocol
  • string

Protocolo usado para comunicarse con la cuenta de almacenamiento.

resourceGroup
  • string

Nombre del grupo de recursos de Azure

serviceDataAccessAuthIdentity None

Indica qué identidad se va a usar para autenticar el acceso a datos de servicio para el almacenamiento del cliente.

subscriptionId
  • string

Id. de suscripción de Azure

tags
  • object

Diccionario de etiquetas. Las etiquetas se pueden agregar, quitar y actualizar.

CertificateDatastoreCredentials

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

Name Type Description
authorityUrl
  • string

Dirección URL de autoridad usada para la autenticación.

clientId
  • string

[Obligatorio] Id. 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

[Obligatorio] Secretos de entidad de servicio.

tenantId
  • string

[Obligatorio] Identificador del inquilino al que pertenece la entidad de servicio.

thumbprint
  • string

[Obligatorio] Huella digital del certificado usado para la autenticación.

CertificateDatastoreSecrets

Secretos de certificado de almacén de datos.

Name Type Description
certificate
  • string

Certificado de entidad de servicio.

secretsType string:
  • Certificate

[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.

createdByType

Tipo de identidad que creó el recurso.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

CredentialsType

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

Name Type Description
AccountKey
  • string
Certificate
  • string
KerberosKeytab
  • string
KerberosPassword
  • string
None
  • string
Sas
  • string
ServicePrincipal
  • string

DatastoreResource

Sobre de recursos de Azure Resource Manager.

Name Type Description
id
  • string

Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

Nombre del recurso.

properties Datastore:

[Obligatorio] Atributos adicionales de la entidad.

systemData

Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.

type
  • string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

DatastoreType

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

Name Type Description
AzureBlob
  • string
AzureDataLakeGen1
  • string
AzureDataLakeGen2
  • string
AzureFile
  • string
Hdfs
  • string

ErrorAdditionalInfo

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

Name Type Description
info
  • object

La información adicional.

type
  • string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Name Type Description
additionalInfo

Información adicional del error.

code
  • string

Código de error.

details

Los detalles del error.

message
  • string

El mensaje de error.

target
  • string

Destino del error.

ErrorResponse

Respuesta de error

Name Type Description
error

Objeto de error.

HdfsDatastore

Name Type Default Value Description
credentials DatastoreCredentials:

[Obligatorio] Credenciales de cuenta.

datastoreType string:
  • Hdfs

[Obligatorio] Tipo de almacenamiento que respalda el almacén de datos.

description
  • string

Texto de descripción del recurso.

hdfsServerCertificate
  • string

Certificado TLS del servidor HDFS. Debe ser una cadena codificada en base64. Obligatorio si se selecciona el protocolo "Https".

isDefault
  • boolean

Propiedad Readonly para indicar si el almacén de datos es el almacén de datos predeterminado del área de trabajo

nameNodeAddress
  • string

[Obligatorio] Dirección IP o Nombre de host DNS.

properties
  • object

Diccionario de propiedades de recursos.

protocol
  • string
http

Protocolo usado para comunicarse con la cuenta de almacenamiento (Https/Http).

tags
  • object

Diccionario de etiquetas. Las etiquetas se pueden agregar, quitar y actualizar.

KerberosKeytabCredentials

Name Type Description
credentialsType string:
  • KerberosKeytab

[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.

kerberosKdcAddress
  • string

[Obligatorio] Dirección IP o Nombre de host DNS.

kerberosPrincipal
  • string

[Obligatorio] Nombre de usuario de Kerberos

kerberosRealm
  • string

[Obligatorio] Dominio sobre el que un servidor de autenticación Kerberos tiene la autoridad para autenticar a un usuario, host o servicio.

secrets

[Obligatorio] Secretos de Keytab.

KerberosKeytabSecrets

Name Type Description
kerberosKeytab
  • string

Secreto keytab de Kerberos.

secretsType string:
  • KerberosKeytab

[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.

KerberosPasswordCredentials

Name Type Description
credentialsType string:
  • KerberosPassword

[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.

kerberosKdcAddress
  • string

[Obligatorio] Dirección IP o Nombre de host DNS.

kerberosPrincipal
  • string

[Obligatorio] Nombre de usuario de Kerberos

kerberosRealm
  • string

[Obligatorio] Dominio sobre el que un servidor de autenticación Kerberos tiene la autoridad para autenticar a un usuario, host o servicio.

secrets

[Obligatorio] Secretos de contraseña de Kerberos.

KerberosPasswordSecrets

Name Type Description
kerberosPassword
  • string

Secreto de contraseña kerberos.

secretsType string:
  • KerberosPassword

[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.

NoneDatastoreCredentials

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

Name Type Description
credentialsType string:
  • None

[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.

SasDatastoreCredentials

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

Name Type Description
credentialsType string:
  • Sas

[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.

secrets

[Obligatorio] Secretos de contenedor de almacenamiento.

SasDatastoreSecrets

Secretos de SAS del almacén de datos.

Name Type 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 para determinar el tipo de secretos del almacén de datos.

Name Type Description
AccountKey
  • string
Certificate
  • string
KerberosKeytab
  • string
KerberosPassword
  • string
Sas
  • string
ServicePrincipal
  • string

ServiceDataAccessAuthIdentity

Name Type Description
None
  • string

No use ninguna identidad para el acceso a datos de servicio.

WorkspaceSystemAssignedIdentity
  • string

Use la identidad administrada asignada por el sistema del área de trabajo para autenticar el acceso a los datos del servicio.

WorkspaceUserAssignedIdentity
  • string

Use la identidad administrada asignada por el usuario del área de trabajo para autenticar el acceso a los datos del servicio.

ServicePrincipalDatastoreCredentials

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

Name Type Description
authorityUrl
  • string

Dirección URL de autoridad usada para la autenticación.

clientId
  • string

[Obligatorio] Id. 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

[Obligatorio] Secretos de entidad de servicio.

tenantId
  • string

[Obligatorio] Identificador del inquilino al que pertenece la entidad de servicio.

ServicePrincipalDatastoreSecrets

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

Name Type Description
clientSecret
  • string

Secreto de entidad de servicio.

secretsType string:
  • ServicePrincipal

[Obligatorio] Tipo de credencial usado para la autenticación con almacenamiento.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Name Type Description
createdAt
  • string

Marca de tiempo de creación de recursos (UTC).

createdBy
  • string

Identidad que creó el recurso.

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt
  • string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy
  • string

Identidad que modificó por última vez el recurso.

lastModifiedByType

Tipo de identidad que modificó por última vez el recurso.