次の方法で共有


Microsoft.HybridCompute マシン 2019-12-12

Bicep リソース定義

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

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

リソースの形式

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

resource symbolicname 'Microsoft.HybridCompute/machines@2019-12-12' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'SystemAssigned'
  }
  location: 'string'
  name: 'string'
  properties: {
    clientPublicKey: 'string'
    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'
    }
    osProfile: {}
    vmId: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.HybridCompute/マシン

名前 説明 価値
ID マシンアイデンティティ
位置 リソースが存在する地理的な場所 string (必須)
名前 リソース名 string (必須)
プロパティ ハイブリッド コンピューティング マシンのプロパティ MachineProperties
スコープ デプロイ スコープとは異なるスコープでリソースを作成するときに使用します。 このプロパティをリソースのシンボリック名に設定して、拡張リソースを適用します。
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください

位置データ

名前 説明 価値
都市 リソースが配置されている都市または地域。 文字列
countryOrRegion の国または地域 リソースが配置されている国またはリージョン 文字列
リソースが配置されている地区、州、または都道府県。 文字列
名前 地理的または物理的な場所の正規名。

制約:
最大長 = 256 (必須)

MachineExtensionインスタンスビュー

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

MachineExtensionInstanceViewステータス

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

マシンアイデンティティ

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

マシンプロパティ

名前 説明 価値
clientPublicKey (クライアントパブリックキー) 初期リソースのオンボード中にクライアントが使用するために提供する公開キー 文字列
拡張機能 マシン拡張機能の情報 MachineExtensionインスタンスビュー[]
locationデータ リソースの地理的な場所に関連するメタデータ。 ロケーションデータ
osプロフィール ハイブリッド コンピューターのオペレーティング システム設定を指定します。 MachinePropertiesOsProfile
vmIdの ハイブリッド マシンの一意の ID を指定します。

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

MachinePropertiesOsProfile

名前 説明 価値

追跡リソースタグ

名前 説明 価値

使用例

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": "2019-12-12",
  "name": "string",
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "string",
  "properties": {
    "clientPublicKey": "string",
    "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"
    },
    "osProfile": {
    },
    "vmId": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.HybridCompute/マシン

名前 説明 価値
apiVersion (英語) API のバージョン '2019-12-12'
ID マシンアイデンティティ
位置 リソースが存在する地理的な場所 string (必須)
名前 リソース名 string (必須)
プロパティ ハイブリッド コンピューティング マシンのプロパティ MachineProperties
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください
リソースの種類 'Microsoft.HybridCompute/machines'

位置データ

名前 説明 価値
都市 リソースが配置されている都市または地域。 文字列
countryOrRegion の国または地域 リソースが配置されている国またはリージョン 文字列
リソースが配置されている地区、州、または都道府県。 文字列
名前 地理的または物理的な場所の正規名。

制約:
最大長 = 256 (必須)

MachineExtensionインスタンスビュー

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

MachineExtensionInstanceViewステータス

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

マシンアイデンティティ

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

マシンプロパティ

名前 説明 価値
clientPublicKey (クライアントパブリックキー) 初期リソースのオンボード中にクライアントが使用するために提供する公開キー 文字列
拡張機能 マシン拡張機能の情報 MachineExtensionインスタンスビュー[]
locationデータ リソースの地理的な場所に関連するメタデータ。 ロケーションデータ
osプロフィール ハイブリッド コンピューターのオペレーティング システム設定を指定します。 MachinePropertiesOsProfile
vmIdの ハイブリッド マシンの一意の ID を指定します。

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

MachinePropertiesOsProfile

名前 説明 価値

追跡リソースタグ

名前 説明 価値

使用例

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

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

テンプレート 説明
Azure Stack HCI 上のギャラリー イメージから Linux VM を作成する

Azure に展開する
このテンプレートは、Azure Stack HCI バージョン 23H2 以降で参照されるカスタム イメージから単純な Linux VM を作成します
Azure Stack HCI で参照先イメージから VM を作成する

Azure に展開する
このテンプレートは、Azure Stack HCI バージョン 23H2 以降で参照されている Azure Marketplace イメージから単純な Windows VM を作成します

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

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

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

リソースの形式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.HybridCompute/machines@2019-12-12"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      clientPublicKey = "string"
      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"
      }
      osProfile = {
      }
      vmId = "string"
    }
  }
}

プロパティ値

Microsoft.HybridCompute/マシン

名前 説明 価値
ID マシンアイデンティティ
位置 リソースが存在する地理的な場所 string (必須)
名前 リソース名 string (必須)
parent_id この拡張リソースを適用するリソースの ID。 string (必須)
プロパティ ハイブリッド コンピューティング マシンのプロパティ MachineProperties
タグ リソース タグ タグ名と値のディクショナリ。
リソースの種類 "Microsoft.HybridCompute/machines@2019-12-12" (英語)

位置データ

名前 説明 価値
都市 リソースが配置されている都市または地域。 文字列
countryOrRegion の国または地域 リソースが配置されている国またはリージョン 文字列
リソースが配置されている地区、州、または都道府県。 文字列
名前 地理的または物理的な場所の正規名。

制約:
最大長 = 256 (必須)

MachineExtensionインスタンスビュー

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

MachineExtensionInstanceViewステータス

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

マシンアイデンティティ

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

マシンプロパティ

名前 説明 価値
clientPublicKey (クライアントパブリックキー) 初期リソースのオンボード中にクライアントが使用するために提供する公開キー 文字列
拡張機能 マシン拡張機能の情報 MachineExtensionインスタンスビュー[]
locationデータ リソースの地理的な場所に関連するメタデータ。 ロケーションデータ
osプロフィール ハイブリッド コンピューターのオペレーティング システム設定を指定します。 MachinePropertiesOsProfile
vmIdの ハイブリッド マシンの一意の ID を指定します。

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

MachinePropertiesOsProfile

名前 説明 価値

追跡リソースタグ

名前 説明 価値

使用例

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