Datastores - Get

Obter armazenamento de dados.

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 URI

Name In Required Type Description
name
path True
  • string

Nome do armazenamento de dados.

resourceGroupName
path True
  • string

O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.

subscriptionId
path True
  • string

A ID da assinatura de destino.

workspaceName
path True
  • string

Nome do workspace do Azure Machine Learning.

api-version
query True
  • string

A versão da API a ser usada para esta operação.

Respostas

Name Type Description
200 OK

Êxito

Other Status Codes

Erro

Exemplos

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

Definições

AccountKeyDatastoreCredentials

Configuração de credenciais de armazenamento de dados de chave de conta.

AccountKeyDatastoreSecrets

Segredos da chave da conta do armazenamento de dados.

AzureBlobDatastore

Configuração do armazenamento de dados do Blob do Azure.

AzureDataLakeGen1Datastore

Configuração do armazenamento de dados do Azure Data Lake Gen1.

AzureDataLakeGen2Datastore

Configuração do armazenamento de dados do Azure Data Lake Gen2.

AzureFileDatastore

Configuração do armazenamento de dados do Arquivo do Azure.

CertificateDatastoreCredentials

Configuração de credenciais de armazenamento de dados de certificado.

CertificateDatastoreSecrets

Segredos do certificado datastore.

createdByType

O tipo de identidade que criou o recurso.

CredentialsType

Enumerar para determinar o tipo de credenciais de armazenamento de dados.

DatastoreResource

Envelope de recursos Resource Manager do Azure.

DatastoreType

Enumerar para determinar o tipo de conteúdo do armazenamento de dados.

ErrorAdditionalInfo

As informações adicionais de erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

HdfsDatastore
KerberosKeytabCredentials
KerberosKeytabSecrets
KerberosPasswordCredentials
KerberosPasswordSecrets
NoneDatastoreCredentials

Credenciais de armazenamento de dados vazias/nenhuma.

SasDatastoreCredentials

Configuração de credenciais de armazenamento de dados SAS.

SasDatastoreSecrets

Segredos sas do armazenamento de dados.

SecretsType

Enumerar para determinar o tipo de segredos do armazenamento de dados.

ServiceDataAccessAuthIdentity
ServicePrincipalDatastoreCredentials

Configuração de credenciais de armazenamento de dados da Entidade de Serviço.

ServicePrincipalDatastoreSecrets

Segredos da Entidade de Serviço de Armazenamento de Dados.

systemData

Metadados relativos à criação e à última modificação do recurso.

AccountKeyDatastoreCredentials

Configuração de credenciais de armazenamento de dados de chave de conta.

Name Type Description
credentialsType string:
  • AccountKey

[Obrigatório] Tipo de credencial usado para autenticação com armazenamento.

secrets

[Obrigatório] Segredos da conta de armazenamento.

AccountKeyDatastoreSecrets

Segredos da chave da conta do armazenamento de dados.

Name Type Description
key
  • string

Chave de conta de armazenamento.

secretsType string:
  • AccountKey

[Obrigatório] Tipo de credencial usado para autenticação com armazenamento.

AzureBlobDatastore

Configuração do armazenamento de dados do Blob do Azure.

Name Type Default Value Description
accountName
  • string

Nome da conta de armazenamento.

containerName
  • string

Nome do contêiner da conta de armazenamento.

credentials DatastoreCredentials:

[Obrigatório] Credenciais da conta.

datastoreType string:
  • AzureBlob

[Obrigatório] Tipo de armazenamento que dá suporte ao armazenamento de dados.

description
  • string

O texto de descrição do ativo.

endpoint
  • string

Ponto de extremidade de nuvem do Azure para a conta de armazenamento.

isDefault
  • boolean

Propriedade Readonly para indicar se o armazenamento de dados é o armazenamento de dados padrão do workspace

properties
  • object

O dicionário de propriedades do ativo.

protocol
  • string

Protocolo usado para se comunicar com a conta de armazenamento.

resourceGroup
  • string

Nome do Grupo de Recursos do Azure

serviceDataAccessAuthIdentity None

Indica qual identidade deve ser usada para autenticar o acesso a dados de serviço para o armazenamento do cliente.

subscriptionId
  • string

ID da assinatura do Azure

tags
  • object

Dicionário de marcas. As marcas podem ser adicionadas, removidas e atualizadas.

AzureDataLakeGen1Datastore

Configuração do armazenamento de dados do Azure Data Lake Gen1.

Name Type Default Value Description
credentials DatastoreCredentials:

[Obrigatório] Credenciais da conta.

datastoreType string:
  • AzureDataLakeGen1

[Obrigatório] Tipo de armazenamento que dá suporte ao armazenamento de dados.

description
  • string

O texto de descrição do ativo.

isDefault
  • boolean

Propriedade Readonly para indicar se o armazenamento de dados é o armazenamento de dados padrão do workspace

properties
  • object

O dicionário de propriedades do ativo.

resourceGroup
  • string

Nome do Grupo de Recursos do Azure

serviceDataAccessAuthIdentity None

Indica qual identidade deve ser usada para autenticar o acesso a dados de serviço para o armazenamento do cliente.

storeName
  • string

[Obrigatório] Nome do repositório do Azure Data Lake.

subscriptionId
  • string

ID da assinatura do Azure

tags
  • object

Dicionário de marcas. As marcas podem ser adicionadas, removidas e atualizadas.

AzureDataLakeGen2Datastore

Configuração do armazenamento de dados do Azure Data Lake Gen2.

Name Type Default Value Description
accountName
  • string

[Obrigatório] Nome da conta de armazenamento.

credentials DatastoreCredentials:

[Obrigatório] Credenciais da conta.

datastoreType string:
  • AzureDataLakeGen2

[Obrigatório] Tipo de armazenamento que dá suporte ao armazenamento de dados.

description
  • string

O texto de descrição do ativo.

endpoint
  • string

Ponto de extremidade de nuvem do Azure para a conta de armazenamento.

filesystem
  • string

[Obrigatório] O nome do sistema de arquivos Data Lake Gen2.

isDefault
  • boolean

Propriedade Readonly para indicar se o armazenamento de dados é o armazenamento de dados padrão do workspace

properties
  • object

O dicionário de propriedades do ativo.

protocol
  • string

Protocolo usado para se comunicar com a conta de armazenamento.

resourceGroup
  • string

Nome do Grupo de Recursos do Azure

serviceDataAccessAuthIdentity None

Indica qual identidade deve ser usada para autenticar o acesso a dados de serviço para o armazenamento do cliente.

subscriptionId
  • string

ID da assinatura do Azure

tags
  • object

Dicionário de marcas. As marcas podem ser adicionadas, removidas e atualizadas.

AzureFileDatastore

Configuração do armazenamento de dados do Arquivo do Azure.

Name Type Default Value Description
accountName
  • string

[Obrigatório] Nome da conta de armazenamento.

credentials DatastoreCredentials:

[Obrigatório] Credenciais da conta.

datastoreType string:
  • AzureFile

[Obrigatório] Tipo de armazenamento que dá suporte ao armazenamento de dados.

description
  • string

O texto de descrição do ativo.

endpoint
  • string

Ponto de extremidade de nuvem do Azure para a conta de armazenamento.

fileShareName
  • string

[Obrigatório] O nome do compartilhamento de arquivos do Azure para o qual o armazenamento de dados aponta.

isDefault
  • boolean

Propriedade Readonly para indicar se o armazenamento de dados é o armazenamento de dados padrão do workspace

properties
  • object

O dicionário de propriedades do ativo.

protocol
  • string

Protocolo usado para se comunicar com a conta de armazenamento.

resourceGroup
  • string

Nome do Grupo de Recursos do Azure

serviceDataAccessAuthIdentity None

Indica qual identidade deve ser usada para autenticar o acesso a dados de serviço para o armazenamento do cliente.

subscriptionId
  • string

ID da assinatura do Azure

tags
  • object

Dicionário de marcas. As marcas podem ser adicionadas, removidas e atualizadas.

CertificateDatastoreCredentials

Configuração de credenciais de armazenamento de dados de certificado.

Name Type Description
authorityUrl
  • string

URL de autoridade usada para autenticação.

clientId
  • string

[Obrigatório] ID do cliente da entidade de serviço.

credentialsType string:
  • Certificate

[Obrigatório] Tipo de credencial usado para autenticação com armazenamento.

resourceUrl
  • string

Recurso ao qual a entidade de serviço tem acesso.

secrets

[Obrigatório] Segredos da entidade de serviço.

tenantId
  • string

[Obrigatório] ID do locatário ao qual a entidade de serviço pertence.

thumbprint
  • string

[Obrigatório] Impressão digital do certificado usado para autenticação.

CertificateDatastoreSecrets

Segredos do certificado datastore.

Name Type Description
certificate
  • string

Certificado da entidade de serviço.

secretsType string:
  • Certificate

[Obrigatório] Tipo de credencial usado para autenticação com armazenamento.

createdByType

O tipo de identidade que criou o recurso.

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

CredentialsType

Enumerar para determinar o tipo de credenciais de armazenamento de dados.

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

DatastoreResource

Envelope de recursos Resource Manager do Azure.

Name Type Description
id
  • string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

O nome do recurso

properties Datastore:

[Obrigatório] Atributos adicionais da entidade.

systemData

Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy.

type
  • string

Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

DatastoreType

Enumerar para determinar o tipo de conteúdo do armazenamento de dados.

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

ErrorAdditionalInfo

As informações adicionais de erro de gerenciamento de recursos.

Name Type Description
info
  • object

As informações adicionais.

type
  • string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Type Description
additionalInfo

As informações adicionais do erro.

code
  • string

O código de erro.

details

Os detalhes do erro.

message
  • string

A mensagem de erro.

target
  • string

O destino do erro.

ErrorResponse

Resposta de erro

Name Type Description
error

O objeto de erro.

HdfsDatastore

Name Type Default Value Description
credentials DatastoreCredentials:

[Obrigatório] Credenciais da conta.

datastoreType string:
  • Hdfs

[Obrigatório] Tipo de armazenamento que dá suporte ao armazenamento de dados.

description
  • string

O texto de descrição do ativo.

hdfsServerCertificate
  • string

O certificado TLS do servidor HDFS. Precisa ser uma cadeia de caracteres codificada em base64. Obrigatório se o protocolo "Https" estiver selecionado.

isDefault
  • boolean

Propriedade Readonly para indicar se o armazenamento de dados é o armazenamento de dados padrão do workspace

nameNodeAddress
  • string

[Obrigatório] Endereço IP ou HostName DNS.

properties
  • object

O dicionário de propriedades do ativo.

protocol
  • string
http

Protocolo usado para se comunicar com a conta de armazenamento (Https/Http).

tags
  • object

Dicionário de marcas. As marcas podem ser adicionadas, removidas e atualizadas.

KerberosKeytabCredentials

Name Type Description
credentialsType string:
  • KerberosKeytab

[Obrigatório] Tipo de credencial usado para autenticação com armazenamento.

kerberosKdcAddress
  • string

[Obrigatório] Endereço IP ou Nome do Host DNS.

kerberosPrincipal
  • string

[Obrigatório] Nome de usuário Kerberos

kerberosRealm
  • string

[Obrigatório] Domínio sobre o qual um servidor de autenticação Kerberos tem autoridade para autenticar um usuário, host ou serviço.

secrets

[Obrigatório] Segredos do keytab.

KerberosKeytabSecrets

Name Type Description
kerberosKeytab
  • string

Segredo do keytab Kerberos.

secretsType string:
  • KerberosKeytab

[Obrigatório] Tipo de credencial usado para autenticação com armazenamento.

KerberosPasswordCredentials

Name Type Description
credentialsType string:
  • KerberosPassword

[Obrigatório] Tipo de credencial usado para autenticação com armazenamento.

kerberosKdcAddress
  • string

[Obrigatório] Endereço IP ou Nome do Host DNS.

kerberosPrincipal
  • string

[Obrigatório] Nome de usuário Kerberos

kerberosRealm
  • string

[Obrigatório] Domínio sobre o qual um servidor de autenticação Kerberos tem autoridade para autenticar um usuário, host ou serviço.

secrets

[Obrigatório] Segredos de senha kerberos.

KerberosPasswordSecrets

Name Type Description
kerberosPassword
  • string

Segredo de senha kerberos.

secretsType string:
  • KerberosPassword

[Obrigatório] Tipo de credencial usado para autenticação com armazenamento.

NoneDatastoreCredentials

Credenciais de armazenamento de dados vazias/nenhuma.

Name Type Description
credentialsType string:
  • None

[Obrigatório] Tipo de credencial usado para autenticação com armazenamento.

SasDatastoreCredentials

Configuração de credenciais de armazenamento de dados SAS.

Name Type Description
credentialsType string:
  • Sas

[Obrigatório] Tipo de credencial usado para autenticação com armazenamento.

secrets

[Obrigatório] Segredos do contêiner de armazenamento.

SasDatastoreSecrets

Segredos sas do armazenamento de dados.

Name Type Description
sasToken
  • string

Token SAS do contêiner de armazenamento.

secretsType string:
  • Sas

[Obrigatório] Tipo de credencial usado para autenticação com armazenamento.

SecretsType

Enumerar para determinar o tipo de segredos do armazenamento de dados.

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

ServiceDataAccessAuthIdentity

Name Type Description
None
  • string

Não use nenhuma identidade para acesso a dados de serviço.

WorkspaceSystemAssignedIdentity
  • string

Use a identidade gerenciada atribuída pelo sistema do Workspace para autenticar o acesso aos dados do serviço.

WorkspaceUserAssignedIdentity
  • string

Use a identidade gerenciada atribuída pelo usuário do Workspace para autenticar o acesso aos dados do serviço.

ServicePrincipalDatastoreCredentials

Configuração de credenciais de armazenamento de dados da Entidade de Serviço.

Name Type Description
authorityUrl
  • string

URL de autoridade usada para autenticação.

clientId
  • string

[Obrigatório] ID do cliente da entidade de serviço.

credentialsType string:
  • ServicePrincipal

[Obrigatório] Tipo de credencial usado para autenticação com armazenamento.

resourceUrl
  • string

Recurso ao qual a entidade de serviço tem acesso.

secrets

[Obrigatório] Segredos da entidade de serviço.

tenantId
  • string

[Obrigatório] ID do locatário ao qual a entidade de serviço pertence.

ServicePrincipalDatastoreSecrets

Segredos da Entidade de Serviço de Armazenamento de Dados.

Name Type Description
clientSecret
  • string

Segredo da entidade de serviço.

secretsType string:
  • ServicePrincipal

[Obrigatório] Tipo de credencial usado para autenticação com armazenamento.

systemData

Metadados relativos à criação e à última modificação do recurso.

Name Type Description
createdAt
  • string

O carimbo de data/hora da criação de recursos (UTC).

createdBy
  • string

A identidade que criou o recurso.

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt
  • string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy
  • string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

O tipo de identidade que modificou o recurso pela última vez.