Microsoft.MachineLearningServices workspaces/datastores 2024-07-01-preview

  • [アーティクル]

Bicep リソース定義

ワークスペース/データストアのリソースの種類は、次を対象とする操作と共にデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.MachineLearningServices/workspaces/datastores リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/datastores@2024-07-01-preview' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    credentials: {
      credentialsType: 'string'
      // For remaining properties, see DatastoreCredentials objects
    }
    description: 'string'
    properties: {
      {customized property}: 'string'
    }
    tags: {}
    datastoreType: 'string'
    // For remaining properties, see DatastoreProperties objects
  }
}

DatastoreProperties オブジェクト

オブジェクトの種類を指定するには、datastoreType プロパティを設定します。

AzureBlobを する場合は、次を使用します。

  datastoreType: 'AzureBlob'
  accountName: 'string'
  containerName: 'string'
  endpoint: 'string'
  protocol: 'string'
  resourceGroup: 'string'
  serviceDataAccessAuthIdentity: 'string'
  subscriptionId: 'string'

AzureDataLakeGen1の場合は、次の値を使用します。

  datastoreType: 'AzureDataLakeGen1'
  resourceGroup: 'string'
  serviceDataAccessAuthIdentity: 'string'
  storeName: 'string'
  subscriptionId: 'string'

AzureDataLakeGen2を する場合は、次の値を使用します。

  datastoreType: 'AzureDataLakeGen2'
  accountName: 'string'
  endpoint: 'string'
  filesystem: 'string'
  protocol: 'string'
  resourceGroup: 'string'
  serviceDataAccessAuthIdentity: 'string'
  subscriptionId: 'string'

AzureFileを する場合は、次を使用します。

  datastoreType: 'AzureFile'
  accountName: 'string'
  endpoint: 'string'
  fileShareName: 'string'
  protocol: 'string'
  resourceGroup: 'string'
  serviceDataAccessAuthIdentity: 'string'
  subscriptionId: 'string'

OneLakeを する場合は、次を使用します。

  datastoreType: 'OneLake'
  artifact: {
    artifactName: 'string'
    artifactType: 'string'
    // For remaining properties, see OneLakeArtifact objects
  }
  endpoint: 'string'
  oneLakeWorkspaceName: 'string'
  serviceDataAccessAuthIdentity: 'string'

DatastoreCredentials オブジェクト

credentialsType プロパティを設定して、オブジェクトの種類を指定します。

AccountKeyの場合は、次を使用します。

  credentialsType: 'AccountKey'
  secrets: {
    key: 'string'
    secretsType: 'string'
  }

証明書の場合は、次を使用します。

  credentialsType: 'Certificate'
  authorityUrl: 'string'
  clientId: 'string'
  resourceUrl: 'string'
  secrets: {
    certificate: 'string'
    secretsType: 'string'
  }
  tenantId: 'string'
  thumbprint: 'string'

[なし] の場合は、次を使用します。

  credentialsType: 'None'

Sasの場合は、次のコマンドを使用します。

  credentialsType: 'Sas'
  secrets: {
    sasToken: 'string'
    secretsType: 'string'
  }

ServicePrincipalを する場合は、次を使用します。

  credentialsType: 'ServicePrincipal'
  authorityUrl: 'string'
  clientId: 'string'
  resourceUrl: 'string'
  secrets: {
    clientSecret: 'string'
    secretsType: 'string'
  }
  tenantId: 'string'

OneLakeArtifact オブジェクト

artifactType プロパティを設定して、オブジェクトの種類を指定します。

LakeHouseの場合は、次を使用します。

  artifactType: 'LakeHouse'

プロパティ値

workspaces/datastores

名前 形容 価値
名前 リソース名

Bicepで子リソースの名前と種類 設定する方法を参照してください。		 string (必須)

文字制限: データストア名の最大 255 文字

有効な文字:
データストア名は、小文字、数字、およびアンダースコアのみで構成されます。
親 Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。

詳細については、「親リソースの外部 子リソース」を参照してください。		 種類のリソースのシンボリック名: ワークスペース
プロパティ [必須]エンティティの追加の属性。 DatastoreProperties (必須)

DatastoreProperties

名前 形容 価値
資格 情報 [必須]アカウントの資格情報。 DatastoreCredentials (必須)
形容 資産の説明テキスト。 糸
プロパティ 資産プロパティ ディクショナリ。 ResourceBaseProperties
タグ タグ ディクショナリ。 タグは追加、削除、更新できます。 オブジェクト
datastoreType オブジェクトの種類を設定する AzureBlob の
AzureDataLakeGen1
AzureDataLakeGen2 の
AzureFile の
OneLake (必須)

DatastoreCredentials

名前 形容 価値
credentialsType オブジェクトの種類を設定する AccountKey
証明書 の
なし
Sas
ServicePrincipal (必須)

AccountKeyDatastoreCredentials

名前 形容 価値
credentialsType [必須]ストレージでの認証に使用される資格情報の種類。 'AccountKey' (必須)
秘密 [必須]ストレージ アカウント シークレット。 AccountKeyDatastoreSecrets (必須)

AccountKeyDatastoreSecrets

名前 形容 価値
鍵 ストレージ アカウント キー。 糸
secretsType [必須]ストレージでの認証に使用される資格情報の種類。 'AccountKey'
'Certificate'
'Sas'
'ServicePrincipal' (必須)

CertificateDatastoreCredentials

名前 形容 価値
credentialsType [必須]ストレージでの認証に使用される資格情報の種類。 'Certificate' (必須)
authorityUrl 認証に使用される機関 URL。 糸
clientId [必須]サービス プリンシパル クライアント ID。 string (必須)

制約：
最小長 = 36
最大長 = 36
パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceUrl サービス プリンシパルがアクセスできるリソース。 糸
秘密 [必須]サービス プリンシパル シークレット。 CertificateDatastoreSecrets (必須)
tenantId [必須]サービス プリンシパルが属するテナントの ID。 string (必須)

制約：
最小長 = 36
最大長 = 36
パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
拇印 [必須]認証に使用される証明書の拇印。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]

CertificateDatastoreSecrets

名前 形容 価値
証書 サービス プリンシパル証明書。 糸
secretsType [必須]ストレージでの認証に使用される資格情報の種類。 'AccountKey'
'Certificate'
'Sas'
'ServicePrincipal' (必須)

NoneDatastoreCredentials

名前 形容 価値
credentialsType [必須]ストレージでの認証に使用される資格情報の種類。 'None' (必須)

SasDatastoreCredentials

名前 形容 価値
credentialsType [必須]ストレージでの認証に使用される資格情報の種類。 'Sas' (必須)
秘密 [必須]ストレージ コンテナー シークレット。 SasDatastoreSecrets (必須)

SasDatastoreSecrets

名前 形容 価値
sasToken ストレージ コンテナー SAS トークン。 糸
secretsType [必須]ストレージでの認証に使用される資格情報の種類。 'AccountKey'
'Certificate'
'Sas'
'ServicePrincipal' (必須)

ServicePrincipalDatastoreCredentials

名前 形容 価値
credentialsType [必須]ストレージでの認証に使用される資格情報の種類。 'ServicePrincipal' (必須)
authorityUrl 認証に使用される機関 URL。 糸
clientId [必須]サービス プリンシパル クライアント ID。 string (必須)

制約：
最小長 = 36
最大長 = 36
パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceUrl サービス プリンシパルがアクセスできるリソース。 糸
秘密 [必須]サービス プリンシパル シークレット。 ServicePrincipalDatastoreSecrets (必須)
tenantId [必須]サービス プリンシパルが属するテナントの ID。 string (必須)

制約：
最小長 = 36
最大長 = 36
パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ServicePrincipalDatastoreSecrets

名前 形容 価値
clientSecret サービス プリンシパル シークレット。 糸
secretsType [必須]ストレージでの認証に使用される資格情報の種類。 'AccountKey'
'Certificate'
'Sas'
'ServicePrincipal' (必須)

ResourceBaseProperties

名前 形容 価値
{カスタマイズされたプロパティ} 糸

AzureBlobDatastore

名前 形容 価値
datastoreType [必須]データストアをバックアップするストレージの種類。 'AzureBlob' (必須)
accountName ストレージ アカウント名。 糸
containerName ストレージ アカウントコンテナー名。 糸
エンドポイント ストレージ アカウントの Azure クラウド エンドポイント。 糸
議定書 ストレージ アカウントとの通信に使用されるプロトコル。 糸
resourceGroup Azure リソース グループ名 糸
serviceDataAccessAuthIdentity 顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。 'None'
'WorkspaceSystemAssignedIdentity'
'WorkspaceUserAssignedIdentity'
subscriptionId Azure サブスクリプション ID 糸

AzureDataLakeGen1Datastore

名前 形容 価値
datastoreType [必須]データストアをバックアップするストレージの種類。 'AzureDataLakeGen1' (必須)
resourceGroup Azure リソース グループ名 糸
serviceDataAccessAuthIdentity 顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。 'None'
'WorkspaceSystemAssignedIdentity'
'WorkspaceUserAssignedIdentity'
storeName [必須]Azure Data Lake ストア名。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
subscriptionId Azure サブスクリプション ID 糸

AzureDataLakeGen2Datastore

名前 形容 価値
datastoreType [必須]データストアをバックアップするストレージの種類。 'AzureDataLakeGen2' (必須)
accountName [必須]ストレージ アカウント名。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
エンドポイント ストレージ アカウントの Azure クラウド エンドポイント。 糸
filesystem [必須]Data Lake Gen2 ファイルシステムの名前。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
議定書 ストレージ アカウントとの通信に使用されるプロトコル。 糸
resourceGroup Azure リソース グループ名 糸
serviceDataAccessAuthIdentity 顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。 'None'
'WorkspaceSystemAssignedIdentity'
'WorkspaceUserAssignedIdentity'
subscriptionId Azure サブスクリプション ID 糸

AzureFileDatastore

名前 形容 価値
datastoreType [必須]データストアをバックアップするストレージの種類。 'AzureFile' (必須)
accountName [必須]ストレージ アカウント名。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
エンドポイント ストレージ アカウントの Azure クラウド エンドポイント。 糸
fileShareName [必須]データストアが指す Azure ファイル共有の名前。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
議定書 ストレージ アカウントとの通信に使用されるプロトコル。 糸
resourceGroup Azure リソース グループ名 糸
serviceDataAccessAuthIdentity 顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。 'None'
'WorkspaceSystemAssignedIdentity'
'WorkspaceUserAssignedIdentity'
subscriptionId Azure サブスクリプション ID 糸

OneLakeDatastore

名前 形容 価値
datastoreType [必須]データストアをバックアップするストレージの種類。 'OneLake' (必須)
アーティファクト [必須]データストアをバックアップする OneLake アーティファクト。 OneLakeArtifact (必須)
エンドポイント データストアに使用する OneLake エンドポイント。 糸
oneLakeWorkspaceName [必須]OneLake ワークスペース名。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
serviceDataAccessAuthIdentity 顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。 'None'
'WorkspaceSystemAssignedIdentity'
'WorkspaceUserAssignedIdentity'

OneLakeArtifact

名前 形容 価値
artifactName [必須]OneLake アーティファクト名 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
artifactType オブジェクトの種類を設定する LakeHouse (必須)

LakeHouseArtifact

名前 形容 価値
artifactType [必須]OneLake 成果物の種類 'LakeHouse' (必須)

クイック スタート テンプレート

次のクイック スタート テンプレートでは、このリソースの種類をデプロイします。

テンプレート 形容
データストア & 複数のデータセットを含む AML ワークスペースを作成する

Azure にデプロイする 		このテンプレートでは、データストア & 複数のデータセットを含む Azure Machine Learning ワークスペースが作成されます。
Azure ADLS データストア を作成する

Azure にデプロイする 		このテンプレートは、Azure Machine Learning ワークスペースに ADLS データストアを作成します。
Azure ADLS Gen2 データストア を作成する

Azure にデプロイする 		このテンプレートは、Azure Machine Learning ワークスペースに ADLS Gen2 データストアを作成します。
Blob Storage データストア を作成する

Azure にデプロイする 		このテンプレートは、Azure Machine Learning ワークスペースに BLOB ストレージ データストアを作成します。
Databricks ファイル システム データストア を作成する

Azure にデプロイする 		このテンプレートは、Azure Machine Learning ワークスペースに Databricks ファイル システム データストアを作成します。
ファイル共有データストア を作成する

Azure にデプロイする 		このテンプレートは、Azure Machine Learning ワークスペースにファイル共有データストアを作成します。
Azure MySQL データストア を作成する

Azure にデプロイする 		このテンプレートは、Azure Machine Learning ワークスペースに MySQL データストアを作成します。
Azure PostgreSQL データストア を作成

Azure にデプロイする 		このテンプレートは、Azure Machine Learning ワークスペースに PostgreSQL データストアを作成します。
Azure SQL データストア を作成する

Azure にデプロイする 		このテンプレートは、Azure Machine Learning ワークスペースに SQL データストアを作成します。

ARM テンプレート リソース定義

ワークスペース/データストアのリソースの種類は、次を対象とする操作と共にデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.MachineLearningServices/workspaces/datastores リソースを作成するには、テンプレートに次の JSON を追加します。

{
  "type": "Microsoft.MachineLearningServices/workspaces/datastores",
  "apiVersion": "2024-07-01-preview",
  "name": "string",
  "properties": {
    "credentials": {
      "credentialsType": "string"
      // For remaining properties, see DatastoreCredentials objects
    },
    "description": "string",
    "properties": {
      "{customized property}": "string"
    },
    "tags": {},
    "datastoreType": "string"
    // For remaining properties, see DatastoreProperties objects
  }
}

DatastoreProperties オブジェクト

オブジェクトの種類を指定するには、datastoreType プロパティを設定します。

AzureBlobを する場合は、次を使用します。

  "datastoreType": "AzureBlob",
  "accountName": "string",
  "containerName": "string",
  "endpoint": "string",
  "protocol": "string",
  "resourceGroup": "string",
  "serviceDataAccessAuthIdentity": "string",
  "subscriptionId": "string"

AzureDataLakeGen1の場合は、次の値を使用します。

  "datastoreType": "AzureDataLakeGen1",
  "resourceGroup": "string",
  "serviceDataAccessAuthIdentity": "string",
  "storeName": "string",
  "subscriptionId": "string"

AzureDataLakeGen2を する場合は、次の値を使用します。

  "datastoreType": "AzureDataLakeGen2",
  "accountName": "string",
  "endpoint": "string",
  "filesystem": "string",
  "protocol": "string",
  "resourceGroup": "string",
  "serviceDataAccessAuthIdentity": "string",
  "subscriptionId": "string"

AzureFileを する場合は、次を使用します。

  "datastoreType": "AzureFile",
  "accountName": "string",
  "endpoint": "string",
  "fileShareName": "string",
  "protocol": "string",
  "resourceGroup": "string",
  "serviceDataAccessAuthIdentity": "string",
  "subscriptionId": "string"

OneLakeを する場合は、次を使用します。

  "datastoreType": "OneLake",
  "artifact": {
    "artifactName": "string",
    "artifactType": "string"
    // For remaining properties, see OneLakeArtifact objects
  },
  "endpoint": "string",
  "oneLakeWorkspaceName": "string",
  "serviceDataAccessAuthIdentity": "string"

DatastoreCredentials オブジェクト

credentialsType プロパティを設定して、オブジェクトの種類を指定します。

AccountKeyの場合は、次を使用します。

  "credentialsType": "AccountKey",
  "secrets": {
    "key": "string",
    "secretsType": "string"
  }

証明書の場合は、次を使用します。

  "credentialsType": "Certificate",
  "authorityUrl": "string",
  "clientId": "string",
  "resourceUrl": "string",
  "secrets": {
    "certificate": "string",
    "secretsType": "string"
  },
  "tenantId": "string",
  "thumbprint": "string"

[なし] の場合は、次を使用します。

  "credentialsType": "None"

Sasの場合は、次のコマンドを使用します。

  "credentialsType": "Sas",
  "secrets": {
    "sasToken": "string",
    "secretsType": "string"
  }

ServicePrincipalを する場合は、次を使用します。

  "credentialsType": "ServicePrincipal",
  "authorityUrl": "string",
  "clientId": "string",
  "resourceUrl": "string",
  "secrets": {
    "clientSecret": "string",
    "secretsType": "string"
  },
  "tenantId": "string"

OneLakeArtifact オブジェクト

artifactType プロパティを設定して、オブジェクトの種類を指定します。

LakeHouseの場合は、次を使用します。

  "artifactType": "LakeHouse"

プロパティ値

workspaces/datastores

名前 形容 価値
種類 リソースの種類 'Microsoft.MachineLearningServices/workspaces/datastores'
apiVersion リソース API のバージョン '2024-07-01-preview'
名前 リソース名

JSON ARM テンプレートで子リソースの名前と型 設定する方法を参照してください。		 string (必須)

文字制限: データストア名の最大 255 文字

有効な文字:
データストア名は、小文字、数字、およびアンダースコアのみで構成されます。
プロパティ [必須]エンティティの追加の属性。 DatastoreProperties (必須)

DatastoreProperties

名前 形容 価値
資格 情報 [必須]アカウントの資格情報。 DatastoreCredentials (必須)
形容 資産の説明テキスト。 糸
プロパティ 資産プロパティ ディクショナリ。 ResourceBaseProperties
タグ タグ ディクショナリ。 タグは追加、削除、更新できます。 オブジェクト
datastoreType オブジェクトの種類を設定する AzureBlob の
AzureDataLakeGen1
AzureDataLakeGen2 の
AzureFile の
OneLake (必須)

DatastoreCredentials

名前 形容 価値
credentialsType オブジェクトの種類を設定する AccountKey
証明書 の
なし
Sas
ServicePrincipal (必須)

AccountKeyDatastoreCredentials

名前 形容 価値
credentialsType [必須]ストレージでの認証に使用される資格情報の種類。 'AccountKey' (必須)
秘密 [必須]ストレージ アカウント シークレット。 AccountKeyDatastoreSecrets (必須)

AccountKeyDatastoreSecrets

名前 形容 価値
鍵 ストレージ アカウント キー。 糸
secretsType [必須]ストレージでの認証に使用される資格情報の種類。 'AccountKey'
'Certificate'
'Sas'
'ServicePrincipal' (必須)

CertificateDatastoreCredentials

名前 形容 価値
credentialsType [必須]ストレージでの認証に使用される資格情報の種類。 'Certificate' (必須)
authorityUrl 認証に使用される機関 URL。 糸
clientId [必須]サービス プリンシパル クライアント ID。 string (必須)

制約：
最小長 = 36
最大長 = 36
パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceUrl サービス プリンシパルがアクセスできるリソース。 糸
秘密 [必須]サービス プリンシパル シークレット。 CertificateDatastoreSecrets (必須)
tenantId [必須]サービス プリンシパルが属するテナントの ID。 string (必須)

制約：
最小長 = 36
最大長 = 36
パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
拇印 [必須]認証に使用される証明書の拇印。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]

CertificateDatastoreSecrets

名前 形容 価値
証書 サービス プリンシパル証明書。 糸
secretsType [必須]ストレージでの認証に使用される資格情報の種類。 'AccountKey'
'Certificate'
'Sas'
'ServicePrincipal' (必須)

NoneDatastoreCredentials

名前 形容 価値
credentialsType [必須]ストレージでの認証に使用される資格情報の種類。 'None' (必須)

SasDatastoreCredentials

名前 形容 価値
credentialsType [必須]ストレージでの認証に使用される資格情報の種類。 'Sas' (必須)
秘密 [必須]ストレージ コンテナー シークレット。 SasDatastoreSecrets (必須)

SasDatastoreSecrets

名前 形容 価値
sasToken ストレージ コンテナー SAS トークン。 糸
secretsType [必須]ストレージでの認証に使用される資格情報の種類。 'AccountKey'
'Certificate'
'Sas'
'ServicePrincipal' (必須)

ServicePrincipalDatastoreCredentials

名前 形容 価値
credentialsType [必須]ストレージでの認証に使用される資格情報の種類。 'ServicePrincipal' (必須)
authorityUrl 認証に使用される機関 URL。 糸
clientId [必須]サービス プリンシパル クライアント ID。 string (必須)

制約：
最小長 = 36
最大長 = 36
パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceUrl サービス プリンシパルがアクセスできるリソース。 糸
秘密 [必須]サービス プリンシパル シークレット。 ServicePrincipalDatastoreSecrets (必須)
tenantId [必須]サービス プリンシパルが属するテナントの ID。 string (必須)

制約：
最小長 = 36
最大長 = 36
パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ServicePrincipalDatastoreSecrets

名前 形容 価値
clientSecret サービス プリンシパル シークレット。 糸
secretsType [必須]ストレージでの認証に使用される資格情報の種類。 'AccountKey'
'Certificate'
'Sas'
'ServicePrincipal' (必須)

ResourceBaseProperties

名前 形容 価値
{カスタマイズされたプロパティ} 糸

AzureBlobDatastore

名前 形容 価値
datastoreType [必須]データストアをバックアップするストレージの種類。 'AzureBlob' (必須)
accountName ストレージ アカウント名。 糸
containerName ストレージ アカウントコンテナー名。 糸
エンドポイント ストレージ アカウントの Azure クラウド エンドポイント。 糸
議定書 ストレージ アカウントとの通信に使用されるプロトコル。 糸
resourceGroup Azure リソース グループ名 糸
serviceDataAccessAuthIdentity 顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。 'None'
'WorkspaceSystemAssignedIdentity'
'WorkspaceUserAssignedIdentity'
subscriptionId Azure サブスクリプション ID 糸

AzureDataLakeGen1Datastore

名前 形容 価値
datastoreType [必須]データストアをバックアップするストレージの種類。 'AzureDataLakeGen1' (必須)
resourceGroup Azure リソース グループ名 糸
serviceDataAccessAuthIdentity 顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。 'None'
'WorkspaceSystemAssignedIdentity'
'WorkspaceUserAssignedIdentity'
storeName [必須]Azure Data Lake ストア名。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
subscriptionId Azure サブスクリプション ID 糸

AzureDataLakeGen2Datastore

名前 形容 価値
datastoreType [必須]データストアをバックアップするストレージの種類。 'AzureDataLakeGen2' (必須)
accountName [必須]ストレージ アカウント名。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
エンドポイント ストレージ アカウントの Azure クラウド エンドポイント。 糸
filesystem [必須]Data Lake Gen2 ファイルシステムの名前。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
議定書 ストレージ アカウントとの通信に使用されるプロトコル。 糸
resourceGroup Azure リソース グループ名 糸
serviceDataAccessAuthIdentity 顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。 'None'
'WorkspaceSystemAssignedIdentity'
'WorkspaceUserAssignedIdentity'
subscriptionId Azure サブスクリプション ID 糸

AzureFileDatastore

名前 形容 価値
datastoreType [必須]データストアをバックアップするストレージの種類。 'AzureFile' (必須)
accountName [必須]ストレージ アカウント名。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
エンドポイント ストレージ アカウントの Azure クラウド エンドポイント。 糸
fileShareName [必須]データストアが指す Azure ファイル共有の名前。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
議定書 ストレージ アカウントとの通信に使用されるプロトコル。 糸
resourceGroup Azure リソース グループ名 糸
serviceDataAccessAuthIdentity 顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。 'None'
'WorkspaceSystemAssignedIdentity'
'WorkspaceUserAssignedIdentity'
subscriptionId Azure サブスクリプション ID 糸

OneLakeDatastore

名前 形容 価値
datastoreType [必須]データストアをバックアップするストレージの種類。 'OneLake' (必須)
アーティファクト [必須]データストアをバックアップする OneLake アーティファクト。 OneLakeArtifact (必須)
エンドポイント データストアに使用する OneLake エンドポイント。 糸
oneLakeWorkspaceName [必須]OneLake ワークスペース名。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
serviceDataAccessAuthIdentity 顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。 'None'
'WorkspaceSystemAssignedIdentity'
'WorkspaceUserAssignedIdentity'

OneLakeArtifact

名前 形容 価値
artifactName [必須]OneLake アーティファクト名 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
artifactType オブジェクトの種類を設定する LakeHouse (必須)

LakeHouseArtifact

名前 形容 価値
artifactType [必須]OneLake 成果物の種類 'LakeHouse' (必須)

クイック スタート テンプレート

次のクイック スタート テンプレートでは、このリソースの種類をデプロイします。

テンプレート 形容
データストア & 複数のデータセットを含む AML ワークスペースを作成する

Azure にデプロイする 		このテンプレートでは、データストア & 複数のデータセットを含む Azure Machine Learning ワークスペースが作成されます。
Azure ADLS データストア を作成する

Azure にデプロイする 		このテンプレートは、Azure Machine Learning ワークスペースに ADLS データストアを作成します。
Azure ADLS Gen2 データストア を作成する

Azure にデプロイする 		このテンプレートは、Azure Machine Learning ワークスペースに ADLS Gen2 データストアを作成します。
Blob Storage データストア を作成する

Azure にデプロイする 		このテンプレートは、Azure Machine Learning ワークスペースに BLOB ストレージ データストアを作成します。
Databricks ファイル システム データストア を作成する

Azure にデプロイする 		このテンプレートは、Azure Machine Learning ワークスペースに Databricks ファイル システム データストアを作成します。
ファイル共有データストア を作成する

Azure にデプロイする 		このテンプレートは、Azure Machine Learning ワークスペースにファイル共有データストアを作成します。
Azure MySQL データストア を作成する

Azure にデプロイする 		このテンプレートは、Azure Machine Learning ワークスペースに MySQL データストアを作成します。
Azure PostgreSQL データストア を作成

Azure にデプロイする 		このテンプレートは、Azure Machine Learning ワークスペースに PostgreSQL データストアを作成します。
Azure SQL データストア を作成する

Azure にデプロイする 		このテンプレートは、Azure Machine Learning ワークスペースに SQL データストアを作成します。

Terraform (AzAPI プロバイダー) リソース定義

ワークスペース/データストアのリソースの種類は、次を対象とする操作と共にデプロイできます。

  • リソース グループの

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.MachineLearningServices/workspaces/datastores リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces/datastores@2024-07-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      credentials = {
        credentialsType = "string"
        // For remaining properties, see DatastoreCredentials objects
      }
      description = "string"
      properties = {
        {customized property} = "string"
      }
      tags = {}
      datastoreType = "string"
      // For remaining properties, see DatastoreProperties objects
    }
  })
}

DatastoreProperties オブジェクト

オブジェクトの種類を指定するには、datastoreType プロパティを設定します。

AzureBlobを する場合は、次を使用します。

  datastoreType = "AzureBlob"
  accountName = "string"
  containerName = "string"
  endpoint = "string"
  protocol = "string"
  resourceGroup = "string"
  serviceDataAccessAuthIdentity = "string"
  subscriptionId = "string"

AzureDataLakeGen1の場合は、次の値を使用します。

  datastoreType = "AzureDataLakeGen1"
  resourceGroup = "string"
  serviceDataAccessAuthIdentity = "string"
  storeName = "string"
  subscriptionId = "string"

AzureDataLakeGen2を する場合は、次の値を使用します。

  datastoreType = "AzureDataLakeGen2"
  accountName = "string"
  endpoint = "string"
  filesystem = "string"
  protocol = "string"
  resourceGroup = "string"
  serviceDataAccessAuthIdentity = "string"
  subscriptionId = "string"

AzureFileを する場合は、次を使用します。

  datastoreType = "AzureFile"
  accountName = "string"
  endpoint = "string"
  fileShareName = "string"
  protocol = "string"
  resourceGroup = "string"
  serviceDataAccessAuthIdentity = "string"
  subscriptionId = "string"

OneLakeを する場合は、次を使用します。

  datastoreType = "OneLake"
  artifact = {
    artifactName = "string"
    artifactType = "string"
    // For remaining properties, see OneLakeArtifact objects
  }
  endpoint = "string"
  oneLakeWorkspaceName = "string"
  serviceDataAccessAuthIdentity = "string"

DatastoreCredentials オブジェクト

credentialsType プロパティを設定して、オブジェクトの種類を指定します。

AccountKeyの場合は、次を使用します。

  credentialsType = "AccountKey"
  secrets = {
    key = "string"
    secretsType = "string"
  }

証明書の場合は、次を使用します。

  credentialsType = "Certificate"
  authorityUrl = "string"
  clientId = "string"
  resourceUrl = "string"
  secrets = {
    certificate = "string"
    secretsType = "string"
  }
  tenantId = "string"
  thumbprint = "string"

[なし] の場合は、次を使用します。

  credentialsType = "None"

Sasの場合は、次のコマンドを使用します。

  credentialsType = "Sas"
  secrets = {
    sasToken = "string"
    secretsType = "string"
  }

ServicePrincipalを する場合は、次を使用します。

  credentialsType = "ServicePrincipal"
  authorityUrl = "string"
  clientId = "string"
  resourceUrl = "string"
  secrets = {
    clientSecret = "string"
    secretsType = "string"
  }
  tenantId = "string"

OneLakeArtifact オブジェクト

artifactType プロパティを設定して、オブジェクトの種類を指定します。

LakeHouseの場合は、次を使用します。

  artifactType = "LakeHouse"

プロパティ値

workspaces/datastores

名前 形容 価値
種類 リソースの種類 "Microsoft.MachineLearningServices/workspaces/datastores@2024-07-01-preview"
名前 リソース名 string (必須)

文字制限: データストア名の最大 255 文字

有効な文字:
データストア名は、小文字、数字、およびアンダースコアのみで構成されます。
parent_id このリソースの親であるリソースの ID。 種類のリソースの ID: ワークスペース
プロパティ [必須]エンティティの追加の属性。 DatastoreProperties (必須)

DatastoreProperties

名前 形容 価値
資格 情報 [必須]アカウントの資格情報。 DatastoreCredentials (必須)
形容 資産の説明テキスト。 糸
プロパティ 資産プロパティ ディクショナリ。 ResourceBaseProperties
タグ タグ ディクショナリ。 タグは追加、削除、更新できます。 オブジェクト
datastoreType オブジェクトの種類を設定する AzureBlob の
AzureDataLakeGen1
AzureDataLakeGen2 の
AzureFile の
OneLake (必須)

DatastoreCredentials

名前 形容 価値
credentialsType オブジェクトの種類を設定する AccountKey
証明書 の
なし
Sas
ServicePrincipal (必須)

AccountKeyDatastoreCredentials

名前 形容 価値
credentialsType [必須]ストレージでの認証に使用される資格情報の種類。 "AccountKey" (必須)
秘密 [必須]ストレージ アカウント シークレット。 AccountKeyDatastoreSecrets (必須)

AccountKeyDatastoreSecrets

名前 形容 価値
鍵 ストレージ アカウント キー。 糸
secretsType [必須]ストレージでの認証に使用される資格情報の種類。 "AccountKey"
"Certificate"
"Sas"
"ServicePrincipal" (必須)

CertificateDatastoreCredentials

名前 形容 価値
credentialsType [必須]ストレージでの認証に使用される資格情報の種類。 "Certificate" (必須)
authorityUrl 認証に使用される機関 URL。 糸
clientId [必須]サービス プリンシパル クライアント ID。 string (必須)

制約：
最小長 = 36
最大長 = 36
パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceUrl サービス プリンシパルがアクセスできるリソース。 糸
秘密 [必須]サービス プリンシパル シークレット。 CertificateDatastoreSecrets (必須)
tenantId [必須]サービス プリンシパルが属するテナントの ID。 string (必須)

制約：
最小長 = 36
最大長 = 36
パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
拇印 [必須]認証に使用される証明書の拇印。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]

CertificateDatastoreSecrets

名前 形容 価値
証書 サービス プリンシパル証明書。 糸
secretsType [必須]ストレージでの認証に使用される資格情報の種類。 "AccountKey"
"Certificate"
"Sas"
"ServicePrincipal" (必須)

NoneDatastoreCredentials

名前 形容 価値
credentialsType [必須]ストレージでの認証に使用される資格情報の種類。 "None" (必須)

SasDatastoreCredentials

名前 形容 価値
credentialsType [必須]ストレージでの認証に使用される資格情報の種類。 "Sas" (必須)
秘密 [必須]ストレージ コンテナー シークレット。 SasDatastoreSecrets (必須)

SasDatastoreSecrets

名前 形容 価値
sasToken ストレージ コンテナー SAS トークン。 糸
secretsType [必須]ストレージでの認証に使用される資格情報の種類。 "AccountKey"
"Certificate"
"Sas"
"ServicePrincipal" (必須)

ServicePrincipalDatastoreCredentials

名前 形容 価値
credentialsType [必須]ストレージでの認証に使用される資格情報の種類。 "ServicePrincipal" (必須)
authorityUrl 認証に使用される機関 URL。 糸
clientId [必須]サービス プリンシパル クライアント ID。 string (必須)

制約：
最小長 = 36
最大長 = 36
パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceUrl サービス プリンシパルがアクセスできるリソース。 糸
秘密 [必須]サービス プリンシパル シークレット。 ServicePrincipalDatastoreSecrets (必須)
tenantId [必須]サービス プリンシパルが属するテナントの ID。 string (必須)

制約：
最小長 = 36
最大長 = 36
パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ServicePrincipalDatastoreSecrets

名前 形容 価値
clientSecret サービス プリンシパル シークレット。 糸
secretsType [必須]ストレージでの認証に使用される資格情報の種類。 "AccountKey"
"Certificate"
"Sas"
"ServicePrincipal" (必須)

ResourceBaseProperties

名前 形容 価値
{カスタマイズされたプロパティ} 糸

AzureBlobDatastore

名前 形容 価値
datastoreType [必須]データストアをバックアップするストレージの種類。 "AzureBlob" (必須)
accountName ストレージ アカウント名。 糸
containerName ストレージ アカウントコンテナー名。 糸
エンドポイント ストレージ アカウントの Azure クラウド エンドポイント。 糸
議定書 ストレージ アカウントとの通信に使用されるプロトコル。 糸
resourceGroup Azure リソース グループ名 糸
serviceDataAccessAuthIdentity 顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。 "なし"
"WorkspaceSystemAssignedIdentity"
"WorkspaceUserAssignedIdentity"
subscriptionId Azure サブスクリプション ID 糸

AzureDataLakeGen1Datastore

名前 形容 価値
datastoreType [必須]データストアをバックアップするストレージの種類。 "AzureDataLakeGen1" (必須)
resourceGroup Azure リソース グループ名 糸
serviceDataAccessAuthIdentity 顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。 "なし"
"WorkspaceSystemAssignedIdentity"
"WorkspaceUserAssignedIdentity"
storeName [必須]Azure Data Lake ストア名。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
subscriptionId Azure サブスクリプション ID 糸

AzureDataLakeGen2Datastore

名前 形容 価値
datastoreType [必須]データストアをバックアップするストレージの種類。 "AzureDataLakeGen2" (必須)
accountName [必須]ストレージ アカウント名。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
エンドポイント ストレージ アカウントの Azure クラウド エンドポイント。 糸
filesystem [必須]Data Lake Gen2 ファイルシステムの名前。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
議定書 ストレージ アカウントとの通信に使用されるプロトコル。 糸
resourceGroup Azure リソース グループ名 糸
serviceDataAccessAuthIdentity 顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。 "なし"
"WorkspaceSystemAssignedIdentity"
"WorkspaceUserAssignedIdentity"
subscriptionId Azure サブスクリプション ID 糸

AzureFileDatastore

名前 形容 価値
datastoreType [必須]データストアをバックアップするストレージの種類。 "AzureFile" (必須)
accountName [必須]ストレージ アカウント名。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
エンドポイント ストレージ アカウントの Azure クラウド エンドポイント。 糸
fileShareName [必須]データストアが指す Azure ファイル共有の名前。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
議定書 ストレージ アカウントとの通信に使用されるプロトコル。 糸
resourceGroup Azure リソース グループ名 糸
serviceDataAccessAuthIdentity 顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。 "なし"
"WorkspaceSystemAssignedIdentity"
"WorkspaceUserAssignedIdentity"
subscriptionId Azure サブスクリプション ID 糸

OneLakeDatastore

名前 形容 価値
datastoreType [必須]データストアをバックアップするストレージの種類。 "OneLake" (必須)
アーティファクト [必須]データストアをバックアップする OneLake アーティファクト。 OneLakeArtifact (必須)
エンドポイント データストアに使用する OneLake エンドポイント。 糸
oneLakeWorkspaceName [必須]OneLake ワークスペース名。 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
serviceDataAccessAuthIdentity 顧客のストレージへのサービス データ アクセスを認証するために使用する ID を示します。 "なし"
"WorkspaceSystemAssignedIdentity"
"WorkspaceUserAssignedIdentity"

OneLakeArtifact

名前 形容 価値
artifactName [必須]OneLake アーティファクト名 string (必須)

制約：
最小長 = 1
パターン = [a-zA-Z0-9_]
artifactType オブジェクトの種類を設定する LakeHouse (必須)

LakeHouseArtifact

名前 形容 価値
artifactType [必須]OneLake 成果物の種類 "LakeHouse" (必須)