你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Datastores - List

列出数据存储。

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

URI 参数

Name In Required Type Description
resourceGroupName
path True
  • string

资源组的名称。 此名称不区分大小写。

subscriptionId
path True
  • string

目标订阅的 ID。

workspaceName
path True
  • string

Azure 机器学习工作区的名称。

api-version
query True
  • string

要用于此操作的 API 版本。

$skip
query
  • string

分页的延续标记。

count
query
  • integer
int32

要返回的结果数上限。

isDefault
query
  • boolean

筛选到工作区默认数据存储。

names
query
  • array

要返回的数据存储的名称。

orderBy
query
  • string

order by property (createdtime |modifiedtime |名称) 。

orderByAsc
query
  • boolean

按属性按升序排序。

searchText
query
  • string

在数据存储名称中搜索的文本。

响应

Name Type Description
200 OK

成功

Other Status Codes

错误

示例

List datastores.

Sample Request

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

Sample Response

{
  "value": [
    {
      "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"
      }
    }
  ],
  "nextLink": "string"
}

定义

AccountKeyDatastoreCredentials

帐户密钥数据存储凭据配置。

AccountKeyDatastoreSecrets

数据存储帐户密钥机密。

AzureBlobDatastore

Azure Blob 数据存储配置。

AzureDataLakeGen1Datastore

Azure Data Lake Gen1 数据存储配置。

AzureDataLakeGen2Datastore

Azure Data Lake Gen2 数据存储配置。

AzureFileDatastore

Azure 文件数据存储配置。

CertificateDatastoreCredentials

证书数据存储凭据配置。

CertificateDatastoreSecrets

数据存储证书机密。

createdByType

创建资源的标识的类型。

CredentialsType

用于确定数据存储凭据类型的枚举。

DatastoreResource

Azure 资源管理器资源信封。

DatastoreResourceArmPaginatedResult

数据存储实体的分页列表。

DatastoreType

用于确定数据存储内容类型的枚举。

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

NoneDatastoreCredentials

空/无数据存储凭据。

SasDatastoreCredentials

SAS 数据存储凭据配置。

SasDatastoreSecrets

数据存储 SAS 机密。

SecretsType

用于确定数据存储机密类型的枚举。

ServiceDataAccessAuthIdentity
ServicePrincipalDatastoreCredentials

服务主体数据存储凭据配置。

ServicePrincipalDatastoreSecrets

数据存储服务主体机密。

systemData

与创建和上次修改资源相关的元数据。

AccountKeyDatastoreCredentials

帐户密钥数据存储凭据配置。

Name Type Description
credentialsType string:
  • AccountKey

[必需]用于通过存储进行身份验证的凭据类型。

secrets

[必需]存储帐户机密。

AccountKeyDatastoreSecrets

数据存储帐户密钥机密。

Name Type Description
key
  • string

存储帐户密钥。

secretsType string:
  • AccountKey

[必需]用于通过存储进行身份验证的凭据类型。

AzureBlobDatastore

Azure Blob 数据存储配置。

Name Type Default Value Description
accountName
  • string

存储帐户名称。

containerName
  • string

存储帐户容器名称。

credentials DatastoreCredentials:

[必需]帐户凭据。

datastoreType string:
  • AzureBlob

[必需]支持数据存储的存储类型。

description
  • string

资产说明文本。

endpoint
  • string

存储帐户的 Azure 云终结点。

isDefault
  • boolean

只读属性,用于指示数据存储是否为工作区默认数据存储

properties
  • object

资产属性字典。

protocol
  • string

用于与存储帐户通信的协议。

serviceDataAccessAuthIdentity None

指示用于验证客户存储的服务数据访问的标识。

tags
  • object

标记字典。 可以添加、删除和更新标记。

AzureDataLakeGen1Datastore

Azure Data Lake Gen1 数据存储配置。

Name Type Default Value Description
credentials DatastoreCredentials:

[必需]帐户凭据。

datastoreType string:
  • AzureDataLakeGen1

[必需]支持数据存储的存储类型。

description
  • string

资产说明文本。

isDefault
  • boolean

只读属性,用于指示数据存储是否为工作区默认数据存储

properties
  • object

资产属性字典。

serviceDataAccessAuthIdentity None

指示用于验证客户存储的服务数据访问的标识。

storeName
  • string

[必需]Azure Data Lake Store 名称。

tags
  • object

标记字典。 可以添加、删除和更新标记。

AzureDataLakeGen2Datastore

Azure Data Lake Gen2 数据存储配置。

Name Type Default Value Description
accountName
  • string

[必需]存储帐户名称。

credentials DatastoreCredentials:

[必需]帐户凭据。

datastoreType string:
  • AzureDataLakeGen2

[必需]支持数据存储的存储类型。

description
  • string

资产说明文本。

endpoint
  • string

存储帐户的 Azure 云终结点。

filesystem
  • string

[必需]Data Lake Gen2 文件系统的名称。

isDefault
  • boolean

只读属性,用于指示数据存储是否为工作区默认数据存储

properties
  • object

资产属性字典。

protocol
  • string

用于与存储帐户通信的协议。

serviceDataAccessAuthIdentity None

指示用于验证客户存储的服务数据访问的标识。

tags
  • object

标记字典。 可以添加、删除和更新标记。

AzureFileDatastore

Azure 文件数据存储配置。

Name Type Default Value Description
accountName
  • string

[必需]存储帐户名称。

credentials DatastoreCredentials:

[必需]帐户凭据。

datastoreType string:
  • AzureFile

[必需]支持数据存储的存储类型。

description
  • string

资产说明文本。

endpoint
  • string

存储帐户的 Azure 云终结点。

fileShareName
  • string

[必需]数据存储指向的 Azure 文件共享的名称。

isDefault
  • boolean

只读属性,用于指示数据存储是否为工作区默认数据存储

properties
  • object

资产属性字典。

protocol
  • string

用于与存储帐户通信的协议。

serviceDataAccessAuthIdentity None

指示用于验证客户存储的服务数据访问的标识。

tags
  • object

标记字典。 可以添加、删除和更新标记。

CertificateDatastoreCredentials

证书数据存储凭据配置。

Name Type Description
authorityUrl
  • string

用于身份验证的颁发机构 URL。

clientId
  • string

[必需]服务主体客户端 ID。

credentialsType string:
  • Certificate

[必需]用于通过存储进行身份验证的凭据类型。

resourceUrl
  • string

服务主体有权访问的资源。

secrets

[必需]服务主体机密。

tenantId
  • string

[必需]服务主体所属的租户的 ID。

thumbprint
  • string

[必需]用于身份验证的证书指纹。

CertificateDatastoreSecrets

数据存储证书机密。

Name Type Description
certificate
  • string

服务主体证书。

secretsType string:
  • Certificate

[必需]用于通过存储进行身份验证的凭据类型。

createdByType

创建资源的标识的类型。

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

CredentialsType

用于确定数据存储凭据类型的枚举。

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

DatastoreResource

Azure 资源管理器资源信封。

Name Type Description
id
  • string

资源的完全限定的资源 ID。 Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

资源的名称

properties Datastore:

[必需]实体的其他属性。

systemData

包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。

type
  • string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

DatastoreResourceArmPaginatedResult

数据存储实体的分页列表。

Name Type Description
nextLink
  • string

指向数据存储对象的下一页的链接。 如果为 null,则没有其他页面。

value

数据存储类型的对象的数组。

DatastoreType

用于确定数据存储内容类型的枚举。

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

ErrorAdditionalInfo

资源管理错误附加信息。

Name Type Description
info
  • object

其他信息。

type
  • string

其他信息类型。

ErrorDetail

错误详细信息。

Name Type Description
additionalInfo

错误附加信息。

code
  • string

错误代码。

details

错误详细信息。

message
  • string

错误消息。

target
  • string

错误目标。

ErrorResponse

错误响应

Name Type Description
error

错误对象。

NoneDatastoreCredentials

空/无数据存储凭据。

Name Type Description
credentialsType string:
  • None

[必需]用于通过存储进行身份验证的凭据类型。

SasDatastoreCredentials

SAS 数据存储凭据配置。

Name Type Description
credentialsType string:
  • Sas

[必需]用于通过存储进行身份验证的凭据类型。

secrets

[必需]存储容器机密。

SasDatastoreSecrets

数据存储 SAS 机密。

Name Type Description
sasToken
  • string

存储容器 SAS 令牌。

secretsType string:
  • Sas

[必需]用于通过存储进行身份验证的凭据类型。

SecretsType

用于确定数据存储机密类型的枚举。

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

ServiceDataAccessAuthIdentity

Name Type Description
None
  • string

请勿使用任何标识进行服务数据访问。

WorkspaceSystemAssignedIdentity
  • string

使用工作区的系统分配的托管标识对服务数据访问进行身份验证。

WorkspaceUserAssignedIdentity
  • string

使用工作区的用户分配的托管标识对服务数据访问进行身份验证。

ServicePrincipalDatastoreCredentials

服务主体数据存储凭据配置。

Name Type Description
authorityUrl
  • string

用于身份验证的颁发机构 URL。

clientId
  • string

[必需]服务主体客户端 ID。

credentialsType string:
  • ServicePrincipal

[必需]用于通过存储进行身份验证的凭据类型。

resourceUrl
  • string

服务主体有权访问的资源。

secrets

[必需]服务主体机密。

tenantId
  • string

[必需]服务主体所属的租户的 ID。

ServicePrincipalDatastoreSecrets

数据存储服务主体机密。

Name Type Description
clientSecret
  • string

服务主体机密。

secretsType string:
  • ServicePrincipal

[必需]用于通过存储进行身份验证的凭据类型。

systemData

与创建和上次修改资源相关的元数据。

Name Type Description
createdAt
  • string

资源创建时间戳 (UTC) 。

createdBy
  • string

创建资源的标识。

createdByType

创建资源的标识的类型。

lastModifiedAt
  • string

资源上次修改的时间戳 (UTC)

lastModifiedBy
  • string

上次修改资源的标识。

lastModifiedByType

上次修改资源的标识的类型。