Datastores - Get

データストアを取得します。

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

URI パラメーター

Name In Required Type Description
name
path True
  • string

データストア名。

resourceGroupName
path True
  • string

リソース グループの名前。 名前の大文字と小文字は区別されます。

subscriptionId
path True
  • string

ターゲット サブスクリプションの ID。

workspaceName
path True
  • string

Azure Machine Learning ワークスペースの名前。

api-version
query True
  • string

この操作に使用する API バージョン。

応答

Name Type Description
200 OK

Success

Other Status Codes

エラー

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

定義

AccountKeyDatastoreCredentials

アカウント キー データストアの資格情報の構成。

AccountKeyDatastoreSecrets

データストア アカウント キー シークレット。

AzureBlobDatastore

Azure Blob データストアの構成。

AzureDataLakeGen1Datastore

Azure Data Lake Gen1 データストアの構成。

AzureDataLakeGen2Datastore

Azure Data Lake Gen2 データストアの構成。

AzureFileDatastore

Azure File データストアの構成。

CertificateDatastoreCredentials

証明書データストアの資格情報の構成。

CertificateDatastoreSecrets

データストア証明書シークレット。

createdByType

リソースを作成した ID の種類。

CredentialsType

データストアの資格情報の種類を決定する列挙型。

DatastoreResource

Azure Resource Manager リソース エンベロープ。

DatastoreType

データストアの内容の種類を決定する列挙型。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

HdfsDatastore
KerberosKeytabCredentials
KerberosKeytabSecrets
KerberosPasswordCredentials
KerberosPasswordSecrets
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

データストアがワークスペースの既定のデータストアであるかどうかを示す Readonly プロパティ

properties
  • object

資産プロパティ ディクショナリ。

protocol
  • string

ストレージ アカウントとの通信に使用されるプロトコル。

resourceGroup
  • string

Azure リソース グループ名

serviceDataAccessAuthIdentity None

顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。

subscriptionId
  • string

Azure サブスクリプション ID

tags
  • object

タグディクショナリ。 タグは追加、削除、更新できます。

AzureDataLakeGen1Datastore

Azure Data Lake Gen1 データストアの構成。

Name Type Default Value Description
credentials DatastoreCredentials:

[必須]アカウントの資格情報。

datastoreType string:
  • AzureDataLakeGen1

[必須]データストアをバックアップするストレージの種類。

description
  • string

資産の説明テキスト。

isDefault
  • boolean

データストアがワークスペースの既定のデータストアであるかどうかを示す Readonly プロパティ

properties
  • object

資産プロパティ ディクショナリ。

resourceGroup
  • string

Azure リソース グループ名

serviceDataAccessAuthIdentity None

顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。

storeName
  • string

[必須]Azure Data Lake ストア名。

subscriptionId
  • string

Azure サブスクリプション ID

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

データストアがワークスペースの既定のデータストアであるかどうかを示す Readonly プロパティ

properties
  • object

資産プロパティ ディクショナリ。

protocol
  • string

ストレージ アカウントとの通信に使用されるプロトコル。

resourceGroup
  • string

Azure リソース グループ名

serviceDataAccessAuthIdentity None

顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。

subscriptionId
  • string

Azure サブスクリプション ID

tags
  • object

タグディクショナリ。 タグは追加、削除、更新できます。

AzureFileDatastore

Azure File データストアの構成。

Name Type Default Value Description
accountName
  • string

[必須]ストレージ アカウント名。

credentials DatastoreCredentials:

[必須]アカウントの資格情報。

datastoreType string:
  • AzureFile

[必須]データストアをバックアップするストレージの種類。

description
  • string

資産の説明テキスト。

endpoint
  • string

ストレージ アカウントの Azure クラウド エンドポイント。

fileShareName
  • string

[必須]データストアが指す Azure ファイル共有の名前。

isDefault
  • boolean

データストアがワークスペースの既定のデータストアであるかどうかを示す Readonly プロパティ

properties
  • object

資産プロパティ ディクショナリ。

protocol
  • string

ストレージ アカウントとの通信に使用されるプロトコル。

resourceGroup
  • string

Azure リソース グループ名

serviceDataAccessAuthIdentity None

顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。

subscriptionId
  • string

Azure サブスクリプション ID

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

リソースを作成した ID の種類。

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

CredentialsType

データストアの資格情報の種類を決定する列挙型。

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

DatastoreResource

Azure Resource Manager リソース エンベロープ。

Name Type Description
id
  • string

リソースの完全修飾リソース ID。 例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

リソースの名前

properties Datastore:

[必須]エンティティの追加の属性。

systemData

createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。

type
  • string

リソースの型。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

DatastoreType

データストアの内容の種類を決定する列挙型。

Name Type Description
AzureBlob
  • string
AzureDataLakeGen1
  • string
AzureDataLakeGen2
  • string
AzureFile
  • string
Hdfs
  • 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

エラー オブジェクト。

HdfsDatastore

Name Type Default Value Description
credentials DatastoreCredentials:

[必須]アカウントの資格情報。

datastoreType string:
  • Hdfs

[必須]データストアをバックアップするストレージの種類。

description
  • string

資産の説明テキスト。

hdfsServerCertificate
  • string

HDFS サーバーの TLS 証明書。 base64 でエンコードされた文字列である必要があります。 "Https" プロトコルが選択されている場合は必須です。

isDefault
  • boolean

データストアがワークスペースの既定のデータストアであるかどうかを示す Readonly プロパティ

nameNodeAddress
  • string

[必須]IP アドレスまたは DNS HostName。

properties
  • object

資産プロパティ ディクショナリ。

protocol
  • string
http

ストレージ アカウント (Https/Http) との通信に使用されるプロトコル。

tags
  • object

タグディクショナリ。 タグは追加、削除、更新できます。

KerberosKeytabCredentials

Name Type Description
credentialsType string:
  • KerberosKeytab

[必須]ストレージでの認証に使用される資格情報の種類。

kerberosKdcAddress
  • string

[必須]IP アドレスまたは DNS HostName。

kerberosPrincipal
  • string

[必須]Kerberos ユーザー名

kerberosRealm
  • string

[必須]Kerberos 認証サーバーがユーザー、ホスト、またはサービスを認証する権限を持つドメイン。

secrets

[必須]Keytab シークレット。

KerberosKeytabSecrets

Name Type Description
kerberosKeytab
  • string

Kerberos keytab シークレット。

secretsType string:
  • KerberosKeytab

[必須]ストレージでの認証に使用される資格情報の種類。

KerberosPasswordCredentials

Name Type Description
credentialsType string:
  • KerberosPassword

[必須]ストレージでの認証に使用される資格情報の種類。

kerberosKdcAddress
  • string

[必須]IP アドレスまたは DNS HostName。

kerberosPrincipal
  • string

[必須]Kerberos ユーザー名

kerberosRealm
  • string

[必須]Kerberos 認証サーバーがユーザー、ホスト、またはサービスを認証する権限を持つドメイン。

secrets

[必須]Kerberos パスワード シークレット。

KerberosPasswordSecrets

Name Type Description
kerberosPassword
  • string

Kerberos パスワード シークレット。

secretsType string:
  • KerberosPassword

[必須]ストレージでの認証に使用される資格情報の種類。

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
KerberosKeytab
  • string
KerberosPassword
  • string
Sas
  • string
ServicePrincipal
  • string

ServiceDataAccessAuthIdentity

Name Type Description
None
  • string

サービス データ アクセスには ID を使用しないでください。

WorkspaceSystemAssignedIdentity
  • string

ワークスペースのシステム割り当てマネージド ID を使用して、サービス データ アクセスを認証します。

WorkspaceUserAssignedIdentity
  • string

ワークスペースのユーザー割り当てマネージド ID を使用して、サービス データ アクセスを認証します。

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

リソースを作成した ID。

createdByType

リソースを作成した ID の種類。

lastModifiedAt
  • string

リソースの最終変更 (UTC) のタイムスタンプ

lastModifiedBy
  • string

リソースを最後に変更した ID。

lastModifiedByType

リソースを最後に変更した ID の種類。