Datastores - Get

Service:: Machine Learning

API Version:: 2024-10-01

Get datastore.

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

URI Parameters

Name	In	Required	Type	Description
name	path	True	string	Datastore name.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	The name of the resource group. The name is case insensitive.
subscriptionId	path	True	string minLength: 1	The ID of the target subscription.
workspaceName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Name of Azure Machine Learning workspace.
api-version	query	True	string minLength: 1	The API version to use for this operation.

Responses

Name	Type	Description
200 OK	DatastoreResource	Success
Other Status Codes	ErrorResponse	Error

Examples

Get datastore.

Sample request

HTTP

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=2024-10-01

Sample response

Status code:: 200

{
  "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"
  }
}

Definitions

Name	Description
AccountKeyDatastoreCredentials	Account key datastore credentials configuration.
AccountKeyDatastoreSecrets	Datastore account key secrets.
AzureBlobDatastore	Azure Blob datastore configuration.
AzureDataLakeGen1Datastore	Azure Data Lake Gen1 datastore configuration.
AzureDataLakeGen2Datastore	Azure Data Lake Gen2 datastore configuration.
AzureFileDatastore	Azure File datastore configuration.
CertificateDatastoreCredentials	Certificate datastore credentials configuration.
CertificateDatastoreSecrets	Datastore certificate secrets.
createdByType	The type of identity that created the resource.
CredentialsType	Enum to determine the datastore credentials type.
DatastoreResource	Azure Resource Manager resource envelope.
DatastoreType	Enum to determine the datastore contents type.
ErrorAdditionalInfo	The resource management error additional info.
ErrorDetail	The error detail.
ErrorResponse	Error response
LakeHouseArtifact
NoneDatastoreCredentials	Empty/none datastore credentials.
OneLakeArtifactType	Enum to determine OneLake artifact type.
OneLakeDatastore	OneLake (Trident) datastore configuration.
SasDatastoreCredentials	SAS datastore credentials configuration.
SasDatastoreSecrets	Datastore SAS secrets.
SecretsType	Enum to determine the datastore secrets type.
ServiceDataAccessAuthIdentity
ServicePrincipalDatastoreCredentials	Service Principal datastore credentials configuration.
ServicePrincipalDatastoreSecrets	Datastore Service Principal secrets.
systemData	Metadata pertaining to creation and last modification of the resource.

AccountKeyDatastoreCredentials

Object

Account key datastore credentials configuration.

Name	Type	Description
credentialsType	string: AccountKey	[Required] Credential type used to authentication with storage.
secrets	AccountKeyDatastoreSecrets	[Required] Storage account secrets.

AccountKeyDatastoreSecrets

Object

Datastore account key secrets.

Name	Type	Description
key	string	Storage account key.
secretsType	string: AccountKey	[Required] Credential type used to authentication with storage.

AzureBlobDatastore

Object

Azure Blob datastore configuration.

Name	Type	Default value	Description
accountName	string		Storage account name.
containerName	string		Storage account container name.
credentials	DatastoreCredentials: AccountKeyDatastoreCredentials CertificateDatastoreCredentials NoneDatastoreCredentials SasDatastoreCredentials ServicePrincipalDatastoreCredentials		[Required] Account credentials.
datastoreType	string: AzureBlob		[Required] Storage type backing the datastore.
description	string		The asset description text.
endpoint	string		Azure cloud endpoint for the storage account.
isDefault	boolean		Readonly property to indicate if datastore is the workspace default datastore
properties	object		The asset property dictionary.
protocol	string		Protocol used to communicate with the storage account.
resourceGroup	string		Azure Resource Group name
serviceDataAccessAuthIdentity	ServiceDataAccessAuthIdentity	None	Indicates which identity to use to authenticate service data access to customer's storage.
subscriptionId	string		Azure Subscription Id
tags	object		Tag dictionary. Tags can be added, removed, and updated.

AzureDataLakeGen1Datastore

Object

Azure Data Lake Gen1 datastore configuration.

Name	Type	Default value	Description
credentials	DatastoreCredentials: AccountKeyDatastoreCredentials CertificateDatastoreCredentials NoneDatastoreCredentials SasDatastoreCredentials ServicePrincipalDatastoreCredentials		[Required] Account credentials.
datastoreType	string: AzureDataLakeGen1		[Required] Storage type backing the datastore.
description	string		The asset description text.
isDefault	boolean		Readonly property to indicate if datastore is the workspace default datastore
properties	object		The asset property dictionary.
resourceGroup	string		Azure Resource Group name
serviceDataAccessAuthIdentity	ServiceDataAccessAuthIdentity	None	Indicates which identity to use to authenticate service data access to customer's storage.
storeName	string minLength: 1 pattern: [a-zA-Z0-9_]		[Required] Azure Data Lake store name.
subscriptionId	string		Azure Subscription Id
tags	object		Tag dictionary. Tags can be added, removed, and updated.

AzureDataLakeGen2Datastore

Object

Azure Data Lake Gen2 datastore configuration.

Name	Type	Default value	Description
accountName	string minLength: 1 pattern: [a-zA-Z0-9_]		[Required] Storage account name.
credentials	DatastoreCredentials: AccountKeyDatastoreCredentials CertificateDatastoreCredentials NoneDatastoreCredentials SasDatastoreCredentials ServicePrincipalDatastoreCredentials		[Required] Account credentials.
datastoreType	string: AzureDataLakeGen2		[Required] Storage type backing the datastore.
description	string		The asset description text.
endpoint	string		Azure cloud endpoint for the storage account.
filesystem	string minLength: 1 pattern: [a-zA-Z0-9_]		[Required] The name of the Data Lake Gen2 filesystem.
isDefault	boolean		Readonly property to indicate if datastore is the workspace default datastore
properties	object		The asset property dictionary.
protocol	string		Protocol used to communicate with the storage account.
resourceGroup	string		Azure Resource Group name
serviceDataAccessAuthIdentity	ServiceDataAccessAuthIdentity	None	Indicates which identity to use to authenticate service data access to customer's storage.
subscriptionId	string		Azure Subscription Id
tags	object		Tag dictionary. Tags can be added, removed, and updated.

AzureFileDatastore

Object

Azure File datastore configuration.

Name	Type	Default value	Description
accountName	string minLength: 1 pattern: [a-zA-Z0-9_]		[Required] Storage account name.
credentials	DatastoreCredentials: AccountKeyDatastoreCredentials CertificateDatastoreCredentials NoneDatastoreCredentials SasDatastoreCredentials ServicePrincipalDatastoreCredentials		[Required] Account credentials.
datastoreType	string: AzureFile		[Required] Storage type backing the datastore.
description	string		The asset description text.
endpoint	string		Azure cloud endpoint for the storage account.
fileShareName	string minLength: 1 pattern: [a-zA-Z0-9_]		[Required] The name of the Azure file share that the datastore points to.
isDefault	boolean		Readonly property to indicate if datastore is the workspace default datastore
properties	object		The asset property dictionary.
protocol	string		Protocol used to communicate with the storage account.
resourceGroup	string		Azure Resource Group name
serviceDataAccessAuthIdentity	ServiceDataAccessAuthIdentity	None	Indicates which identity to use to authenticate service data access to customer's storage.
subscriptionId	string		Azure Subscription Id
tags	object		Tag dictionary. Tags can be added, removed, and updated.

CertificateDatastoreCredentials

Object

Certificate datastore credentials configuration.

Name	Type	Description
authorityUrl	string	Authority URL used for authentication.
clientId	string (uuid)	[Required] Service principal client ID.
credentialsType	string: Certificate	[Required] Credential type used to authentication with storage.
resourceUrl	string	Resource the service principal has access to.
secrets	CertificateDatastoreSecrets	[Required] Service principal secrets.
tenantId	string (uuid)	[Required] ID of the tenant to which the service principal belongs.
thumbprint	string minLength: 1 pattern: [a-zA-Z0-9_]	[Required] Thumbprint of the certificate used for authentication.

CertificateDatastoreSecrets

Object

Datastore certificate secrets.

Name	Type	Description
certificate	string	Service principal certificate.
secretsType	string: Certificate	[Required] Credential type used to authentication with storage.

createdByType

Enumeration

The type of identity that created the resource.

Value	Description
User
Application
ManagedIdentity
Key

CredentialsType

Enumeration

Enum to determine the datastore credentials type.

Value	Description
AccountKey
Certificate
None
Sas
ServicePrincipal

DatastoreResource

Object

Azure Resource Manager resource envelope.

Name	Type	Description
id	string	Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	The name of the resource
properties	Datastore: AzureBlobDatastore AzureDataLakeGen1Datastore AzureDataLakeGen2Datastore AzureFileDatastore OneLakeDatastore	[Required] Additional attributes of the entity.
systemData	systemData	Azure Resource Manager metadata containing createdBy and modifiedBy information.
type	string	The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

DatastoreType

Enumeration

Enum to determine the datastore contents type.

Value	Description
AzureBlob
AzureDataLakeGen1
AzureDataLakeGen2
AzureFile
OneLake

ErrorAdditionalInfo

Object

The resource management error additional info.

Name	Type	Description
info	object	The additional info.
type	string	The additional info type.

ErrorDetail

Object

The error detail.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	The error additional info.
code	string	The error code.
details	ErrorDetail[]	The error details.
message	string	The error message.
target	string	The error target.

ErrorResponse

Object

Error response

Name	Type	Description
error	ErrorDetail	The error object.

LakeHouseArtifact

Object

Name	Type	Description
artifactName	string minLength: 1 pattern: [a-zA-Z0-9_]	[Required] OneLake artifact name
artifactType	string: LakeHouse	[Required] OneLake artifact type

NoneDatastoreCredentials

Object

Empty/none datastore credentials.

Name	Type	Description
credentialsType	string: None	[Required] Credential type used to authentication with storage.

OneLakeArtifactType

Enumeration

Enum to determine OneLake artifact type.

Value	Description
LakeHouse

OneLakeDatastore

Object

OneLake (Trident) datastore configuration.

Name	Type	Default value	Description
artifact	OneLakeArtifact: LakeHouseArtifact		[Required] OneLake artifact backing the datastore.
credentials	DatastoreCredentials: AccountKeyDatastoreCredentials CertificateDatastoreCredentials NoneDatastoreCredentials SasDatastoreCredentials ServicePrincipalDatastoreCredentials		[Required] Account credentials.
datastoreType	string: OneLake		[Required] Storage type backing the datastore.
description	string		The asset description text.
endpoint	string		OneLake endpoint to use for the datastore.
isDefault	boolean		Readonly property to indicate if datastore is the workspace default datastore
oneLakeWorkspaceName	string minLength: 1 pattern: [a-zA-Z0-9_]		[Required] OneLake workspace name.
properties	object		The asset property dictionary.
serviceDataAccessAuthIdentity	ServiceDataAccessAuthIdentity	None	Indicates which identity to use to authenticate service data access to customer's storage.
tags	object		Tag dictionary. Tags can be added, removed, and updated.

SasDatastoreCredentials

Object

SAS datastore credentials configuration.

Name	Type	Description
credentialsType	string: Sas	[Required] Credential type used to authentication with storage.
secrets	SasDatastoreSecrets	[Required] Storage container secrets.

SasDatastoreSecrets

Object

Datastore SAS secrets.

Name	Type	Description
sasToken	string	Storage container SAS token.
secretsType	string: Sas	[Required] Credential type used to authentication with storage.

SecretsType

Enumeration

Enum to determine the datastore secrets type.

Value	Description
AccountKey
Certificate
Sas
ServicePrincipal

ServiceDataAccessAuthIdentity

Enumeration

Value	Description
None	Do not use any identity for service data access.
WorkspaceSystemAssignedIdentity	Use the system assigned managed identity of the Workspace to authenticate service data access.
WorkspaceUserAssignedIdentity	Use the user assigned managed identity of the Workspace to authenticate service data access.

ServicePrincipalDatastoreCredentials

Object

Service Principal datastore credentials configuration.

Name	Type	Description
authorityUrl	string	Authority URL used for authentication.
clientId	string (uuid)	[Required] Service principal client ID.
credentialsType	string: ServicePrincipal	[Required] Credential type used to authentication with storage.
resourceUrl	string	Resource the service principal has access to.
secrets	ServicePrincipalDatastoreSecrets	[Required] Service principal secrets.
tenantId	string (uuid)	[Required] ID of the tenant to which the service principal belongs.

ServicePrincipalDatastoreSecrets

Object

Datastore Service Principal secrets.

Name	Type	Description
clientSecret	string	Service principal secret.
secretsType	string: ServicePrincipal	[Required] Credential type used to authentication with storage.

systemData

Object

Metadata pertaining to creation and last modification of the resource.

Name	Type	Description
createdAt	string (date-time)	The timestamp of resource creation (UTC).
createdBy	string	The identity that created the resource.
createdByType	createdByType	The type of identity that created the resource.
lastModifiedAt	string (date-time)	The timestamp of resource last modification (UTC)
lastModifiedBy	string	The identity that last modified the resource.
lastModifiedByType	createdByType	The type of identity that last modified the resource.

Share via

Datastores - Get

URI Parameters

Responses

Examples

Get datastore.

Sample request

Sample response

Definitions

AccountKeyDatastoreCredentials

AccountKeyDatastoreSecrets

AzureBlobDatastore

AzureDataLakeGen1Datastore

AzureDataLakeGen2Datastore

AzureFileDatastore

CertificateDatastoreCredentials

CertificateDatastoreSecrets

createdByType

CredentialsType

DatastoreResource

DatastoreType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

LakeHouseArtifact

NoneDatastoreCredentials

OneLakeArtifactType

OneLakeDatastore

SasDatastoreCredentials

SasDatastoreSecrets

SecretsType

ServiceDataAccessAuthIdentity

ServicePrincipalDatastoreCredentials

ServicePrincipalDatastoreSecrets

systemData