Microsoft.MachineLearningServices workspaces/computes

[アーティクル]
11/21/2024

Bicep リソース定義

ワークスペース/コンピューティングリソースの種類は、次をターゲットとする操作でデプロイできます。

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

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

リソースの形式

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

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/computes@2024-10-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    computeLocation: 'string'
    description: 'string'
    disableLocalAuth: bool
    resourceId: 'string'
    computeType: 'string'
    // For remaining properties, see Compute objects
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

コンピューティングオブジェクト

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

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

{
  computeType: 'AKS'
  properties: {
    agentCount: int
    agentVmSize: 'string'
    aksNetworkingConfiguration: {
      dnsServiceIP: 'string'
      dockerBridgeCidr: 'string'
      serviceCidr: 'string'
      subnetId: 'string'
    }
    clusterFqdn: 'string'
    clusterPurpose: 'string'
    loadBalancerSubnet: 'string'
    loadBalancerType: 'string'
    sslConfiguration: {
      cert: 'string'
      cname: 'string'
      key: 'string'
      leafDomainLabel: 'string'
      overwriteExistingDomain: bool
      status: 'string'
    }
  }
}

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

{
  computeType: 'AmlCompute'
  properties: {
    enableNodePublicIp: bool
    isolatedNetwork: bool
    osType: 'string'
    propertyBag: any(Azure.Bicep.Types.Concrete.AnyType)
    remoteLoginPortPublicAccess: 'string'
    scaleSettings: {
      maxNodeCount: int
      minNodeCount: int
      nodeIdleTimeBeforeScaleDown: 'string'
    }
    subnet: {
      id: 'string'
    }
    userAccountCredentials: {
      adminUserName: 'string'
      adminUserPassword: 'string'
      adminUserSshPublicKey: 'string'
    }
    virtualMachineImage: {
      id: 'string'
    }
    vmPriority: 'string'
    vmSize: 'string'
  }
}

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

{
  computeType: 'ComputeInstance'
  properties: {
    applicationSharingPolicy: 'string'
    computeInstanceAuthorizationType: 'string'
    customServices: [
      {
        docker: {
          privileged: bool
        }
        endpoints: [
          {
            hostIp: 'string'
            name: 'string'
            protocol: 'string'
            published: int
            target: int
          }
        ]
        environmentVariables: {
          {customized property}: {
            type: 'string'
            value: 'string'
          }
        }
        image: {
          reference: 'string'
          type: 'string'
        }
        name: 'string'
        volumes: [
          {
            bind: {
              createHostPath: bool
              propagation: 'string'
              selinux: 'string'
            }
            consistency: 'string'
            readOnly: bool
            source: 'string'
            target: 'string'
            tmpfs: {
              size: int
            }
            type: 'string'
            volume: {
              nocopy: bool
            }
          }
        ]
      }
    ]
    enableNodePublicIp: bool
    personalComputeInstanceSettings: {
      assignedUser: {
        objectId: 'string'
        tenantId: 'string'
      }
    }
    schedules: {
      computeStartStop: [
        {
          action: 'string'
          cron: {
            expression: 'string'
            startTime: 'string'
            timeZone: 'string'
          }
          recurrence: {
            frequency: 'string'
            interval: int
            schedule: {
              hours: [
                int
              ]
              minutes: [
                int
              ]
              monthDays: [
                int
              ]
              weekDays: [
                'string'
              ]
            }
            startTime: 'string'
            timeZone: 'string'
          }
          schedule: {
            id: 'string'
            provisioningStatus: 'string'
            status: 'string'
          }
          status: 'string'
          triggerType: 'string'
        }
      ]
    }
    setupScripts: {
      scripts: {
        creationScript: {
          scriptArguments: 'string'
          scriptData: 'string'
          scriptSource: 'string'
          timeout: 'string'
        }
        startupScript: {
          scriptArguments: 'string'
          scriptData: 'string'
          scriptSource: 'string'
          timeout: 'string'
        }
      }
    }
    sshSettings: {
      adminPublicKey: 'string'
      sshPublicAccess: 'string'
    }
    subnet: {
      id: 'string'
    }
    vmSize: 'string'
  }
}

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

{
  computeType: 'DataFactory'
}

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

{
  computeType: 'DataLakeAnalytics'
  properties: {
    dataLakeStoreAccountName: 'string'
  }
}

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

{
  computeType: 'Databricks'
  properties: {
    databricksAccessToken: 'string'
    workspaceUrl: 'string'
  }
}

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

{
  computeType: 'HDInsight'
  properties: {
    address: 'string'
    administratorAccount: {
      password: 'string'
      privateKeyData: 'string'
      publicKeyData: 'string'
      username: 'string'
    }
    sshPort: int
  }
}

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

{
  computeType: 'Kubernetes'
  properties: {
    defaultInstanceType: 'string'
    extensionInstanceReleaseTrain: 'string'
    extensionPrincipalId: 'string'
    instanceTypes: {
      {customized property}: {
        nodeSelector: {
          {customized property}: 'string'
        }
        resources: {
          limits: {
            {customized property}: 'string'
          }
          requests: {
            {customized property}: 'string'
          }
        }
      }
    }
    namespace: 'string'
    relayConnectionString: 'string'
    serviceBusConnectionString: 'string'
    vcName: 'string'
  }
}

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

{
  computeType: 'SynapseSpark'
  properties: {
    autoPauseProperties: {
      delayInMinutes: int
      enabled: bool
    }
    autoScaleProperties: {
      enabled: bool
      maxNodeCount: int
      minNodeCount: int
    }
    nodeCount: int
    nodeSize: 'string'
    nodeSizeFamily: 'string'
    poolName: 'string'
    resourceGroup: 'string'
    sparkVersion: 'string'
    subscriptionId: 'string'
    workspaceName: 'string'
  }
}

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

{
  computeType: 'VirtualMachine'
  properties: {
    address: 'string'
    administratorAccount: {
      password: 'string'
      privateKeyData: 'string'
      publicKeyData: 'string'
      username: 'string'
    }
    isNotebookInstanceCompute: bool
    notebookServerPort: int
    sshPort: int
    virtualMachineSize: 'string'
  }
}

プロパティ値

AKS

名前	形容	価値
computeType	コンピューティングの種類	'AKS' (必須)
プロパティ	AKS プロパティ	AKSSchemaProperties

AksNetworkingConfiguration

名前	形容	価値
dnsServiceIP	Kubernetes DNS サービスに割り当てられた IP アドレス。これは、serviceCidr で指定された Kubernetes サービスアドレス範囲内にある必要があります。	糸制約：パターン = `^(?:(?:25[0-5]\|2[0-4][0-9]\|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]\|2[0-4][0-9]\|[01]?[0-9][0-9]?)$`
dockerBridgeCidr	Docker ブリッジネットワークに割り当てられた CIDR 表記 IP 範囲。サブネット IP 範囲または Kubernetes サービスアドレス範囲と重複してはなりません。	糸制約：パターン = `^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]\|[1-2][0-9]\|3[0-2]))?$`
serviceCidr	サービスクラスター IP を割り当てる CIDR 表記 IP 範囲。サブネット IP 範囲と重複しないようにする必要があります。	糸制約：パターン = `^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]\|[1-2][0-9]\|3[0-2]))?$`
subnetId	コンピューティングノードが属する仮想ネットワークサブネットリソース ID	糸

AKSSchemaProperties

名前	形容	価値
agentCount	エージェントの数	int 制約：最小値 = 0
agentVmSize	エージェント仮想マシンのサイズ	糸
aksNetworkingConfiguration	vnet の AKS ネットワーク構成	AksNetworkingConfiguration
clusterFqdn	クラスターの完全修飾ドメイン名	糸
clusterPurpose	クラスターの使用目的	'DenseProd' 'DevTest' 'FastProd'
loadBalancerSubnet	Load Balancer サブネット	糸
loadBalancerType	ロードバランサーの種類	'InternalLoadBalancer' 'PublicIp'
sslConfiguration	SSL 構成	SslConfiguration

AmlCompute

名前	形容	価値
computeType	コンピューティングの種類	'AmlCompute' (必須)
プロパティ	AmlCompute のプロパティ	AmlComputeProperties をする

AmlComputeProperties

名前	形容	価値
enableNodePublicIp	ノードパブリック IP アドレスのプロビジョニングを有効または無効にします。使用可能な値は次のとおりです。true - コンピューティングノードにパブリック IP がプロビジョニングされることを示します。 false - コンピューティングノードにプライベートエンドポイントがあり、パブリック IP がないことを示します。	bool
isolatedNetwork	ネットワークが分離されているかどうか	bool
osType	コンピューティング OS の種類	'Linux' 'Windows'
propertyBag	追加のプロパティを含むプロパティバッグ。	任意
remoteLoginPortPublicAccess	パブリック SSH ポートの状態。使用可能な値は次のとおりです。無効 - クラスターのすべてのノードでパブリック ssh ポートが閉じられていることを示します。 [有効] - クラスターのすべてのノードでパブリック ssh ポートが開かれていることを示します。 NotSpecified - VNet が定義されている場合、クラスターのすべてのノードでパブリック ssh ポートが閉じられ、それ以外のすべてのパブリックノードが開かれていることを示します。これは、クラスターの作成時にのみ既定で使用でき、作成後は有効または無効になります。	'Disabled' 'Enabled' 'NotSpecified'
scaleSettings	AML コンピューティングのスケール設定	ScaleSettings
サブネット	コンピューティングノードが属する仮想ネットワークサブネットリソース ID。	ResourceId
userAccountCredentials	各コンピューティングノードに作成される管理者ユーザーアカウントの資格情報。	UserAccountCredentials の
virtualMachineImage	AML コンピューティングの仮想マシンイメージ - ウィンドウのみ	VirtualMachineImage
vmPriority	仮想マシンの優先順位	'Dedicated' 'LowPriority'
vmSize	仮想マシンのサイズ	糸

AssignedUser

名前	形容	価値
objectId	ユーザーの AAD オブジェクト ID。	string (必須)
tenantId	ユーザーの AAD テナント ID。	string (必須)

AutoPauseProperties

名前	形容	価値
delayInMinutes		int
有効		bool

AutoScaleProperties

名前	形容	価値
有効		bool
maxNodeCount		int
minNodeCount		int

BindOptions

名前	形容	価値
createHostPath	ホストパスを作成するかどうかを示します。	bool
伝播	バインドオプションの種類	糸
selinux	selinux オプションについて説明します。	糸

計算する

名前	形容	価値
computeLocation	基になるコンピューティングの場所	糸
computeType	AKSの型 'AKS' に設定します。 AmlCompute型 'AmlCompute' に設定します。 ComputeInstanceの型 "ComputeInstance" に設定します。 DataFactoryの型 'DataFactory' に設定します。 DataLakeAnalytics型 'DataLakeAnalytics' に設定します。 Databricks型 'Databricks' に設定します。 HDInsightの種類 "HDInsight" に設定します。 Kubernetes型 'Kubernetes' に設定します。 SynapseSparkの種類 'SynapseSpark' に設定します。 VirtualMachineの種類 "VirtualMachine" に設定します。	'AKS' 'AmlCompute' 'ComputeInstance' 'Databricks' 'DataFactory' 'DataLakeAnalytics' 'HDInsight' 'Kubernetes' 'SynapseSpark' 'VirtualMachine' (必須)
形容	Machine Learning コンピューティングの説明。	糸
disableLocalAuth	ローカル認証をオプトアウトし、お客様が認証にのみ MSI と AAD のみを使用できることを確認します。	bool
resourceId	基になるコンピューティングの ARM リソース ID	糸

ComputeInstance

名前	形容	価値
computeType	コンピューティングの種類	'ComputeInstance' (必須)
プロパティ	ComputeInstance のプロパティ	ComputeInstanceProperties

ComputeInstanceProperties

名前	形容	価値
applicationSharingPolicy	親ワークスペースのユーザー間でこのコンピューティングインスタンス上のアプリケーションを共有するためのポリシー。個人用の場合、作成者のみがこのコンピューティングインスタンス上のアプリケーションにアクセスできます。 [共有] の場合、ワークスペースユーザーは、割り当てられたロールに応じて、このインスタンスのアプリケーションにアクセスできます。	'Personal' 'Shared'
computeInstanceAuthorizationType	コンピューティングインスタンスの承認の種類。使用可能な値は個人用 (既定値) です。	'personal'
customServices	コンピューティングに追加されたカスタムサービスの一覧。	CustomServiceの []
enableNodePublicIp	ノードパブリック IP アドレスのプロビジョニングを有効または無効にします。使用可能な値は次のとおりです。true - コンピューティングノードにパブリック IP がプロビジョニングされることを示します。 false - コンピューティングノードにプライベートエンドポイントがあり、パブリック IP がないことを示します。	bool
personalComputeInstanceSettings	パーソナルコンピューティングインスタンスの設定。	PersonalComputeInstanceSettings
スケジュール	コンピューティングに適用するスケジュールの一覧。	ComputeSchedules
setupScripts	クラスターを設定するために実行するカスタマイズされたスクリプトの詳細。	SetupScripts
sshSettings	SSH アクセスのポリシーと設定を指定します。	ComputeInstanceSshSettings
サブネット	コンピューティングノードが属する仮想ネットワークサブネットリソース ID。	ResourceId
vmSize	仮想マシンのサイズ	糸

ComputeInstanceSshSettings

名前	形容	価値
adminPublicKey	SSH rsa 公開キーファイルを文字列として指定します。 "ssh-keygen -t rsa -b 2048" を使用して、SSH キーペアを生成します。	糸
sshPublicAccess	パブリック SSH ポートの状態。使用可能な値は次のとおりです。無効 - このインスタンスでパブリック ssh ポートが閉じられていることを示します。有効 - パブリック SSH ポートが開き、該当する場合は VNet/サブネットポリシーに従ってアクセス可能であることを示します。	'Disabled' 'Enabled'

ComputeRecurrenceSchedule

名前	形容	価値
時間	[必須]スケジュールの時間の一覧。	int[] (必須)
議事録	[必須]スケジュールの分の一覧。	int[] (必須)
monthDays	スケジュールの月日の一覧	int[]
平日	スケジュールの日数の一覧。	次のいずれかを含む文字列配列: 'Friday' 'Monday' 'Saturday' 'Sunday' 'Thursday' 'Tuesday' 'Wednesday'

ComputeResourceTags

名前	形容	価値

ComputeSchedules

名前	形容	価値
computeStartStop	適用するコンピューティング開始停止スケジュールの一覧。	ComputeStartStopSchedule[]

ComputeStartStopSchedule

名前	形容	価値
アクション	[必須]コンピューティング電源アクション。	'Start' 'Stop'
cron	triggerType が Cron の場合は必須。	Cron
再発	triggerType が Recurrence の場合は必須。	Recurrence
計画	[非推奨]それ以上使用しません。	ScheduleBase
地位	スケジュールは有効か無効か。	'Disabled' 'Enabled'
triggerType	[必須]スケジュールトリガーの種類。	'Cron' 'Recurrence'

Cron

名前	形容	価値
表現	[必須]スケジュールの cron 式を指定します。式は NCronTab 形式に従う必要があります。	糸
startTime	yyyy-MM-ddTHH:mm:ss 形式の開始時刻。	糸
timeZone	スケジュールを実行するタイムゾーンを指定します。 TimeZone は、Windows のタイムゾーン形式に従う必要があります。参照: /windows-hardware/manufacture/desktop/default-time-zones?view=windows-11	糸

CustomService

名前	形容	価値
港湾労働者	イメージの Docker 設定について説明します	Docker
エンドポイント	コンテナーのエンドポイントの構成	エンドポイント[]
environmentVariables	コンテナーの環境変数	CustomServiceEnvironmentVariables の
画像	イメージの仕様について説明します	画像
名前	カスタムサービスの名前	糸
ボリューム	コンテナーのボリュームの構成	VolumeDefinition[]

CustomServiceEnvironmentVariables

名前	形容	価値

Databricks

名前	形容	価値
computeType	コンピューティングの種類	'Databricks' (必須)
プロパティ	Databricks のプロパティ	DatabricksProperties の

DatabricksProperties

名前	形容	価値
databricksAccessToken	Databricks アクセストークン	糸
workspaceUrl	ワークスペースの URL	糸

DataFactory

名前	形容	価値
computeType	コンピューティングの種類	'DataFactory' (必須)

DataLakeAnalytics

名前	形容	価値
computeType	コンピューティングの種類	'DataLakeAnalytics' (必須)
プロパティ		DataLakeAnalyticsSchemaProperties の

DataLakeAnalyticsSchemaProperties

名前	形容	価値
dataLakeStoreAccountName	DataLake Store アカウント名	糸

港湾労働者

名前	形容	価値
特権	コンテナーを特権モードまたは非特権モードで実行するかどうかを示します。	bool

エンドポイント

名前	形容	価値
hostIp	アプリケーションがコンテナーから公開されるホスト IP	糸
名前	エンドポイントの名前	糸
議定書	このエンドポイント経由で通信が行われるプロトコル	'http' 'tcp' 'udp'
公開	アプリケーションがコンテナーから公開されるポート。	int
ターゲット	コンテナー内のアプリケーションポート。	int

EnvironmentVariable

名前	形容	価値
種類	環境変数の型。使用可能な値: local - ローカル変数の場合	'local'
価値	環境変数の値	糸

HDInsight

名前	形容	価値
computeType	コンピューティングの種類	'HDInsight' (必須)
プロパティ	HDInsight コンピューティングプロパティ	HDInsightProperties の

HDInsightProperties

名前	形容	価値
住所	クラスターのマスターノードのパブリック IP アドレス。	糸
administratorAccount	クラスターのマスターノードの管理者資格情報	VirtualMachineSshCredentials
sshPort	クラスターのマスターノードで SSH 接続用にポートを開きます。	int

画像

名前	形容	価値
参考	イメージ参照	糸
種類	イメージの種類。使用可能な値は、docker - Docker イメージの場合です。 azureml - AzureML イメージの場合	'azureml' 'docker'

InstanceResourceSchema

名前	形容	価値

InstanceResourceSchema

名前	形容	価値

InstanceTypeSchema

名前	形容	価値
nodeSelector	ノードセレクター	InstanceTypeSchemaNodeSelector
リソース	このインスタンスの種類のリソース要求/制限	InstanceTypeSchemaResources

InstanceTypeSchemaNodeSelector

名前	形容	価値

InstanceTypeSchemaResources

名前	形容	価値
切り	このインスタンスの種類のリソース制限	InstanceResourceSchema
要求	このインスタンスの種類のリソース要求	InstanceResourceSchema

Kubernetes

名前	形容	価値
computeType	コンピューティングの種類	'Kubernetes' (必須)
プロパティ	Kubernetes のプロパティ	KubernetesProperties の

KubernetesProperties

名前	形容	価値
defaultInstanceType	既定のインスタンスの種類	糸
extensionInstanceReleaseTrain	拡張機能インスタンスのリリーストレーニング。	糸
extensionPrincipalId	拡張機能プリンシパル ID。	糸
instanceTypes	インスタンス型スキーマ	KubernetesPropertiesInstanceTypes の
名前空間	コンピューティング名前空間	糸
relayConnectionString	リレー接続文字列。	糸制約：機密性の高い値。セキュリティで保護されたパラメーターとして渡します。
serviceBusConnectionString	ServiceBus 接続文字列。	糸制約：機密性の高い値。セキュリティで保護されたパラメーターとして渡します。
vcName	VC 名。	糸

KubernetesPropertiesInstanceTypes

名前	形容	価値

ManagedServiceIdentity

名前	形容	価値
種類	マネージドサービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (必須)
userAssignedIdentities	リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリキーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。	UserAssignedIdentities の