Microsoft.HybridCompute マシン 2022-12-27-preview

Bicep リソース定義

マシンリソースの種類は、次を対象とする操作でデプロイできます。

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

リソースの形式

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

resource symbolicname 'Microsoft.HybridCompute/machines@2022-12-27-preview' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'SystemAssigned'
  }
  location: 'string'
  name: 'string'
  properties: {
    agentUpgrade: {
      correlationId: 'string'
      desiredVersion: 'string'
      enableAutomaticUpgrade: bool
    }
    clientPublicKey: 'string'
    cloudMetadata: {}
    extensions: [
      {
        name: 'string'
        status: {
          code: 'string'
          displayStatus: 'string'
          level: 'string'
          message: 'string'
          time: 'string'
        }
        type: 'string'
        typeHandlerVersion: 'string'
      }
    ]
    locationData: {
      city: 'string'
      countryOrRegion: 'string'
      district: 'string'
      name: 'string'
    }
    mssqlDiscovered: 'string'
    osProfile: {
      linuxConfiguration: {
        patchSettings: {
          assessmentMode: 'string'
          patchMode: 'string'
        }
      }
      windowsConfiguration: {
        patchSettings: {
          assessmentMode: 'string'
          patchMode: 'string'
        }
      }
    }
    osType: 'string'
    parentClusterResourceId: 'string'
    privateLinkScopeResourceId: 'string'
    serviceStatuses: {
      extensionService: {
        startupType: 'string'
        status: 'string'
      }
      guestConfigurationService: {
        startupType: 'string'
        status: 'string'
      }
    }
    vmId: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.HybridCompute/マシン

名前	説明	価値
ID	リソースの ID。	アイデンティティ
位置	リソースが存在する地理的な場所	string (必須)
名前	リソース名	糸制約：最小長 = 1 最大長 = 54 パターン = `[a-zA-Z0-9-_\.]` (必須)
プロパティ	ハイブリッドコンピューティングマシンのプロパティ	MachineProperties の
スコープ	デプロイスコープとは異なるスコープでリソースを作成するときに使用します。	このプロパティをリソースのシンボリック名に設定して、拡張リソースを適用します。
タグ	リソースタグ	タグ名と値のディクショナリ。テンプレートのタグを参照してください

Agentアップグレード

名前	説明	価値
相関ID	アップグレードごとに RSM から渡される関連付け ID。	糸制約：最小長 = 36 最大長 = 36 パターン = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
desiredVersion (desiredVersion)	マシンのバージョン情報 w.r.t AgentUpgrade を指定します。	文字列
自動アップグレードを有効にする	RSM がこのマシンのアップグレードを試みる必要があるかどうかを指定します	ブール (bool)

クラウドメタデータ

名前	説明	価値

アイデンティティ

名前	説明	価値
型	ID の種類。	'システム割り当て'

位置データ

名前	説明	価値
都市	リソースが配置されている都市または地域。	文字列
countryOrRegion の国または地域	リソースが配置されている国またはリージョン	文字列
区	リソースが配置されている地区、州、または都道府県。	文字列
名前	地理的または物理的な場所の正規名。	糸制約：最大長 = 256 (必須)

MachineExtensionインスタンスビュー

名前	説明	価値
名前	コンピューター拡張機能の名前。	文字列
状態	インスタンスビューの状態。	MachineExtensionInstanceViewステータス
型	拡張機能の型を指定します。たとえば、"CustomScriptExtension" です。	文字列
タイプハンドラバージョン	スクリプトハンドラーのバージョンを指定します。	文字列

MachineExtensionInstanceViewステータス

名前	説明	価値
コード	状態コード。	文字列
ディスプレイステータス	状態の短いローカライズ可能なラベル。	文字列
レベル	レベルコード。	「エラー」「情報」「警告」
メッセージ	アラートやエラーメッセージを含む詳細なステータスメッセージ。	文字列
時間	状態の時刻。	文字列

マシンプロパティ

名前	説明	価値
エージェントアップグレード	マシン w.r.t エージェントアップグレードの情報	Agentアップグレード
clientPublicKey (クライアントパブリックキー)	初期リソースのオンボード中にクライアントが使用するために提供する公開キー	文字列
cloudMetadata(クラウドメタデータ)	クラウド環境のメタデータ (Azure/GCP/AWS/OCI...)。	クラウドメタデータ
拡張機能	マシン拡張機能の情報 (非推奨のフィールド)	MachineExtensionインスタンスビュー[]
locationデータ	リソースの地理的な場所に関連するメタデータ。	ロケーションデータ
mssqlDiscovered	マシン上で MS SQL インスタンスを検出するかどうかを指定します。	文字列
osプロフィール	ハイブリッドコンピューターのオペレーティングシステム設定を指定します。	OSProfile の
osTypeの	オペレーティングシステム (windows/linux) の種類。	文字列
親クラスタリソースID	このマシンが割り当てられている親クラスター (Azure HCI) のリソース ID (存在する場合)。	文字列
privateLinkScopeリソースId	このマシンが割り当てられているプライベートリンクスコープのリソース ID (存在する場合)。	文字列
サービスステータス	ARM に報告される依存サービスの状態。	サービスステータス
vmIdの	ハイブリッドマシンの一意の ID を指定します。	糸制約：最小長 = 36 最大長 = 36 パターン = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

OSプロファイル

名前	説明	価値
linuxの設定	更新管理用の Linux 構成を指定します。	OSProfileLinuxConfiguration の
windows設定	更新管理用の Windows 構成を指定します。	OSProfileWindowsConfiguration の

OSProfileLinux設定

名前	説明	価値
パッチ設定	パッチ設定を指定します。	PatchSettings の

OSProfileWindows設定

名前	説明	価値
パッチ設定	パッチ設定を指定します。	PatchSettings の

パッチ設定

名前	説明	価値
アセスメントモード	評価モードを指定します。	「AutomaticByPlatform」「ImageDefault」
パッチモード	パッチモードを指定します。	「AutomaticByOS」「AutomaticByPlatform」「ImageDefault」「マニュアル」

サービスステータス

名前	説明	価値
スタートアップタイプ	Arc 対応マシンの起動時のサービスの動作。	文字列
状態	サービスの現在の状態。	文字列

サービスステータス

名前	説明	価値
extensionService	Arc 対応マシン上の拡張サービスの状態。	サービスステータス
guestConfigurationService (ゲスト構成サービス)	Arc 対応マシン上のゲスト構成サービスの状態。	サービスステータス

追跡リソースタグ

名前	説明	価値

使用例

Azure 検証済みモジュール

次の Azure 検証済みモジュールを使用して、このリソースの種類をデプロイできます。

モジュール	説明
ハイブリッドコンピューティングマシンの	ハイブリッドコンピューティングマシン用の AVM リソースモジュール

Azure クイックスタートのサンプル

次 Azure クイックスタートテンプレート、このリソースの種類をデプロイするための Bicep サンプルが含まれています。

Bicep ファイル	説明
Azure Stack HCI 上のギャラリーイメージから Linux VM を作成する	このテンプレートは、Azure Stack HCI バージョン 23H2 以降で参照されるカスタムイメージから単純な Linux VM を作成します
Azure Stack HCI で参照先イメージから VM を作成する	このテンプレートは、Azure Stack HCI バージョン 23H2 以降で参照されている Azure Marketplace イメージから単純な Windows VM を作成します

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

マシンリソースの種類は、次を対象とする操作でデプロイできます。

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

リソースの形式

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

{
  "type": "Microsoft.HybridCompute/machines",
  "apiVersion": "2022-12-27-preview",
  "name": "string",
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "string",
  "properties": {
    "agentUpgrade": {
      "correlationId": "string",
      "desiredVersion": "string",
      "enableAutomaticUpgrade": "bool"
    },
    "clientPublicKey": "string",
    "cloudMetadata": {
    },
    "extensions": [
      {
        "name": "string",
        "status": {
          "code": "string",
          "displayStatus": "string",
          "level": "string",
          "message": "string",
          "time": "string"
        },
        "type": "string",
        "typeHandlerVersion": "string"
      }
    ],
    "locationData": {
      "city": "string",
      "countryOrRegion": "string",
      "district": "string",
      "name": "string"
    },
    "mssqlDiscovered": "string",
    "osProfile": {
      "linuxConfiguration": {
        "patchSettings": {
          "assessmentMode": "string",
          "patchMode": "string"
        }
      },
      "windowsConfiguration": {
        "patchSettings": {
          "assessmentMode": "string",
          "patchMode": "string"
        }
      }
    },
    "osType": "string",
    "parentClusterResourceId": "string",
    "privateLinkScopeResourceId": "string",
    "serviceStatuses": {
      "extensionService": {
        "startupType": "string",
        "status": "string"
      },
      "guestConfigurationService": {
        "startupType": "string",
        "status": "string"
      }
    },
    "vmId": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.HybridCompute/マシン

名前	説明	価値
apiVersion (英語)	API のバージョン	「2022-12-27-プレビュー」
ID	リソースの ID。	アイデンティティ
位置	リソースが存在する地理的な場所	string (必須)
名前	リソース名	糸制約：最小長 = 1 最大長 = 54 パターン = `[a-zA-Z0-9-_\.]` (必須)
プロパティ	ハイブリッドコンピューティングマシンのプロパティ	MachineProperties の
タグ	リソースタグ	タグ名と値のディクショナリ。テンプレートのタグを参照してください
型	リソースの種類	'Microsoft.HybridCompute/machines'

Agentアップグレード

名前	説明	価値
相関ID	アップグレードごとに RSM から渡される関連付け ID。	糸制約：最小長 = 36 最大長 = 36 パターン = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
desiredVersion (desiredVersion)	マシンのバージョン情報 w.r.t AgentUpgrade を指定します。	文字列
自動アップグレードを有効にする	RSM がこのマシンのアップグレードを試みる必要があるかどうかを指定します	ブール (bool)

クラウドメタデータ

名前	説明	価値

アイデンティティ

名前	説明	価値
型	ID の種類。	'システム割り当て'

位置データ

名前	説明	価値
都市	リソースが配置されている都市または地域。	文字列
countryOrRegion の国または地域	リソースが配置されている国またはリージョン	文字列
区	リソースが配置されている地区、州、または都道府県。	文字列
名前	地理的または物理的な場所の正規名。	糸制約：最大長 = 256 (必須)

MachineExtensionインスタンスビュー

名前	説明	価値
名前	コンピューター拡張機能の名前。	文字列
状態	インスタンスビューの状態。	MachineExtensionInstanceViewステータス
型	拡張機能の型を指定します。たとえば、"CustomScriptExtension" です。	文字列
タイプハンドラバージョン	スクリプトハンドラーのバージョンを指定します。	文字列

MachineExtensionInstanceViewステータス

名前	説明	価値
コード	状態コード。	文字列
ディスプレイステータス	状態の短いローカライズ可能なラベル。	文字列
レベル	レベルコード。	「エラー」「情報」「警告」
メッセージ	アラートやエラーメッセージを含む詳細なステータスメッセージ。	文字列
時間	状態の時刻。	文字列

マシンプロパティ

名前	説明	価値
エージェントアップグレード	マシン w.r.t エージェントアップグレードの情報	Agentアップグレード
clientPublicKey (クライアントパブリックキー)	初期リソースのオンボード中にクライアントが使用するために提供する公開キー	文字列
cloudMetadata(クラウドメタデータ)	クラウド環境のメタデータ (Azure/GCP/AWS/OCI...)。	クラウドメタデータ
拡張機能	マシン拡張機能の情報 (非推奨のフィールド)	MachineExtensionインスタンスビュー[]
locationデータ	リソースの地理的な場所に関連するメタデータ。	ロケーションデータ
mssqlDiscovered	マシン上で MS SQL インスタンスを検出するかどうかを指定します。	文字列
osプロフィール	ハイブリッドコンピューターのオペレーティングシステム設定を指定します。	OSProfile の
osTypeの	オペレーティングシステム (windows/linux) の種類。	文字列
親クラスタリソースID	このマシンが割り当てられている親クラスター (Azure HCI) のリソース ID (存在する場合)。	文字列
privateLinkScopeリソースId	このマシンが割り当てられているプライベートリンクスコープのリソース ID (存在する場合)。	文字列
サービスステータス	ARM に報告される依存サービスの状態。	サービスステータス
vmIdの	ハイブリッドマシンの一意の ID を指定します。	糸制約：最小長 = 36 最大長 = 36 パターン = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

OSプロファイル

名前	説明	価値
linuxの設定	更新管理用の Linux 構成を指定します。	OSProfileLinuxConfiguration の
windows設定	更新管理用の Windows 構成を指定します。	OSProfileWindowsConfiguration の

OSProfileLinux設定

名前	説明	価値
パッチ設定	パッチ設定を指定します。	PatchSettings の

OSProfileWindows設定

名前	説明	価値
パッチ設定	パッチ設定を指定します。	PatchSettings の

パッチ設定

名前	説明	価値
アセスメントモード	評価モードを指定します。	「AutomaticByPlatform」「ImageDefault」
パッチモード	パッチモードを指定します。	「AutomaticByOS」「AutomaticByPlatform」「ImageDefault」「マニュアル」

サービスステータス

名前	説明	価値
スタートアップタイプ	Arc 対応マシンの起動時のサービスの動作。	文字列
状態	サービスの現在の状態。	文字列

サービスステータス

名前	説明	価値
extensionService	Arc 対応マシン上の拡張サービスの状態。	サービスステータス
guestConfigurationService (ゲスト構成サービス)	Arc 対応マシン上のゲスト構成サービスの状態。	サービスステータス

追跡リソースタグ

名前	説明	価値

使用例

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

このリソースの種類デプロイする Azure クイックスタートテンプレート次に示します。

テンプレート	説明
Azure Stack HCI 上のギャラリーイメージから Linux VM を作成する	このテンプレートは、Azure Stack HCI バージョン 23H2 以降で参照されるカスタムイメージから単純な Linux VM を作成します
Azure Stack HCI で参照先イメージから VM を作成する	このテンプレートは、Azure Stack HCI バージョン 23H2 以降で参照されている Azure Marketplace イメージから単純な Windows VM を作成します

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

マシンリソースの種類は、次を対象とする操作でデプロイできます。

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

リソースの形式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.HybridCompute/machines@2022-12-27-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      agentUpgrade = {
        correlationId = "string"
        desiredVersion = "string"
        enableAutomaticUpgrade = bool
      }
      clientPublicKey = "string"
      cloudMetadata = {
      }
      extensions = [
        {
          name = "string"
          status = {
            code = "string"
            displayStatus = "string"
            level = "string"
            message = "string"
            time = "string"
          }
          type = "string"
          typeHandlerVersion = "string"
        }
      ]
      locationData = {
        city = "string"
        countryOrRegion = "string"
        district = "string"
        name = "string"
      }
      mssqlDiscovered = "string"
      osProfile = {
        linuxConfiguration = {
          patchSettings = {
            assessmentMode = "string"
            patchMode = "string"
          }
        }
        windowsConfiguration = {
          patchSettings = {
            assessmentMode = "string"
            patchMode = "string"
          }
        }
      }
      osType = "string"
      parentClusterResourceId = "string"
      privateLinkScopeResourceId = "string"
      serviceStatuses = {
        extensionService = {
          startupType = "string"
          status = "string"
        }
        guestConfigurationService = {
          startupType = "string"
          status = "string"
        }
      }
      vmId = "string"
    }
  }
}

プロパティ値

Microsoft.HybridCompute/マシン

名前	説明	価値
ID	リソースの ID。	アイデンティティ
位置	リソースが存在する地理的な場所	string (必須)
名前	リソース名	糸制約：最小長 = 1 最大長 = 54 パターン = `[a-zA-Z0-9-_\.]` (必須)
parent_id	この拡張リソースを適用するリソースの ID。	string (必須)
プロパティ	ハイブリッドコンピューティングマシンのプロパティ	MachineProperties の
タグ	リソースタグ	タグ名と値のディクショナリ。
型	リソースの種類	"Microsoft.HybridCompute/machines@2022-12-27-preview" (英語)

Agentアップグレード

名前	説明	価値
相関ID	アップグレードごとに RSM から渡される関連付け ID。	糸制約：最小長 = 36 最大長 = 36 パターン = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
desiredVersion (desiredVersion)	マシンのバージョン情報 w.r.t AgentUpgrade を指定します。	文字列
自動アップグレードを有効にする	RSM がこのマシンのアップグレードを試みる必要があるかどうかを指定します	ブール (bool)

クラウドメタデータ

名前	説明	価値

アイデンティティ

名前	説明	価値
型	ID の種類。	'システム割り当て'

位置データ

名前	説明	価値
都市	リソースが配置されている都市または地域。	文字列
countryOrRegion の国または地域	リソースが配置されている国またはリージョン	文字列
区	リソースが配置されている地区、州、または都道府県。	文字列
名前	地理的または物理的な場所の正規名。	糸制約：最大長 = 256 (必須)

MachineExtensionインスタンスビュー

名前	説明	価値
名前	コンピューター拡張機能の名前。	文字列
状態	インスタンスビューの状態。	MachineExtensionInstanceViewステータス
型	拡張機能の型を指定します。たとえば、"CustomScriptExtension" です。	文字列
タイプハンドラバージョン	スクリプトハンドラーのバージョンを指定します。	文字列

MachineExtensionInstanceViewステータス

名前	説明	価値
コード	状態コード。	文字列
ディスプレイステータス	状態の短いローカライズ可能なラベル。	文字列
レベル	レベルコード。	「エラー」「情報」「警告」
メッセージ	アラートやエラーメッセージを含む詳細なステータスメッセージ。	文字列
時間	状態の時刻。	文字列

マシンプロパティ

名前	説明	価値
エージェントアップグレード	マシン w.r.t エージェントアップグレードの情報	Agentアップグレード
clientPublicKey (クライアントパブリックキー)	初期リソースのオンボード中にクライアントが使用するために提供する公開キー	文字列
cloudMetadata(クラウドメタデータ)	クラウド環境のメタデータ (Azure/GCP/AWS/OCI...)。	クラウドメタデータ
拡張機能	マシン拡張機能の情報 (非推奨のフィールド)	MachineExtensionインスタンスビュー[]
locationデータ	リソースの地理的な場所に関連するメタデータ。	ロケーションデータ
mssqlDiscovered	マシン上で MS SQL インスタンスを検出するかどうかを指定します。	文字列
osプロフィール	ハイブリッドコンピューターのオペレーティングシステム設定を指定します。	OSProfile の
osTypeの	オペレーティングシステム (windows/linux) の種類。	文字列
親クラスタリソースID	このマシンが割り当てられている親クラスター (Azure HCI) のリソース ID (存在する場合)。	文字列
privateLinkScopeリソースId	このマシンが割り当てられているプライベートリンクスコープのリソース ID (存在する場合)。	文字列
サービスステータス	ARM に報告される依存サービスの状態。	サービスステータス
vmIdの	ハイブリッドマシンの一意の ID を指定します。	糸制約：最小長 = 36 最大長 = 36 パターン = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

OSプロファイル

名前	説明	価値
linuxの設定	更新管理用の Linux 構成を指定します。	OSProfileLinuxConfiguration の
windows設定	更新管理用の Windows 構成を指定します。	OSProfileWindowsConfiguration の

OSProfileLinux設定

名前	説明	価値
パッチ設定	パッチ設定を指定します。	PatchSettings の

OSProfileWindows設定

名前	説明	価値
パッチ設定	パッチ設定を指定します。	PatchSettings の

パッチ設定

名前	説明	価値
アセスメントモード	評価モードを指定します。	「AutomaticByPlatform」「ImageDefault」
パッチモード	パッチモードを指定します。	「AutomaticByOS」「AutomaticByPlatform」「ImageDefault」「マニュアル」

サービスステータス

名前	説明	価値
スタートアップタイプ	Arc 対応マシンの起動時のサービスの動作。	文字列
状態	サービスの現在の状態。	文字列

サービスステータス

名前	説明	価値
extensionService	Arc 対応マシン上の拡張サービスの状態。	サービスステータス
guestConfigurationService (ゲスト構成サービス)	Arc 対応マシン上のゲスト構成サービスの状態。	サービスステータス

追跡リソースタグ

名前	説明	価値

使用例

Terraformサンプル

ハイブリッドコンピューティングマシンのデプロイの基本的な例。

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "machine" {
  type      = "Microsoft.HybridCompute/machines@2024-07-10"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}hcm"
  location  = var.location
  body = {
    kind = "SCVMM"
  }
}

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-09-16

次の方法で共有

Microsoft.HybridCompute マシン 2022-12-27-preview

Bicep リソース定義

リソースの形式

プロパティ値

Microsoft.HybridCompute/マシン

Agentアップグレード

クラウドメタデータ

アイデンティティ

位置データ

MachineExtensionインスタンスビュー

MachineExtensionInstanceViewステータス

マシンプロパティ

OSプロファイル

OSProfileLinux設定

OSProfileWindows設定

パッチ設定

サービスステータス

サービスステータス

追跡リソースタグ

使用例

Azure 検証済みモジュール

Azure クイック スタートのサンプル

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

リソースの形式

プロパティ値

Microsoft.HybridCompute/マシン

Agentアップグレード

クラウドメタデータ

アイデンティティ

位置データ

MachineExtensionインスタンスビュー

MachineExtensionInstanceViewステータス

マシンプロパティ

OSプロファイル

OSProfileLinux設定

OSProfileWindows設定

パッチ設定

サービスステータス

サービスステータス

追跡リソースタグ

使用例

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

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

リソースの形式

プロパティ値

Microsoft.HybridCompute/マシン

Agentアップグレード

クラウドメタデータ

アイデンティティ

位置データ

MachineExtensionインスタンスビュー

MachineExtensionInstanceViewステータス

マシンプロパティ

OSプロファイル

OSProfileLinux設定

OSProfileWindows設定

パッチ設定

サービスステータス

サービスステータス

追跡リソースタグ

使用例

Terraformサンプル

フィードバック

その他のリソース

Azure クイックスタートのサンプル

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

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