次の方法で共有


Microsoft.NetworkCloud クラスター 2024-07-01

Bicep リソース定義

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

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

リソースの形式

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

resource symbolicname 'Microsoft.NetworkCloud/clusters@2024-07-01' = {
  scope: resourceSymbolicName or scope
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    aggregatorOrSingleRackDefinition: {
      availabilityZone: 'string'
      bareMetalMachineConfigurationData: [
        {
          bmcCredentials: {
            password: 'string'
            username: 'string'
          }
          bmcMacAddress: 'string'
          bootMacAddress: 'string'
          machineDetails: 'string'
          machineName: 'string'
          rackSlot: int
          serialNumber: 'string'
        }
      ]
      networkRackId: 'string'
      rackLocation: 'string'
      rackSerialNumber: 'string'
      rackSkuId: 'string'
      storageApplianceConfigurationData: [
        {
          adminCredentials: {
            password: 'string'
            username: 'string'
          }
          rackSlot: int
          serialNumber: 'string'
          storageApplianceName: 'string'
        }
      ]
    }
    analyticsWorkspaceId: 'string'
    clusterLocation: 'string'
    clusterServicePrincipal: {
      applicationId: 'string'
      password: 'string'
      principalId: 'string'
      tenantId: 'string'
    }
    clusterType: 'string'
    clusterVersion: 'string'
    commandOutputSettings: {
      associatedIdentity: {
        identityType: 'string'
        userAssignedIdentityResourceId: 'string'
      }
      containerUrl: 'string'
    }
    computeDeploymentThreshold: {
      grouping: 'string'
      type: 'string'
      value: int
    }
    computeRackDefinitions: [
      {
        availabilityZone: 'string'
        bareMetalMachineConfigurationData: [
          {
            bmcCredentials: {
              password: 'string'
              username: 'string'
            }
            bmcMacAddress: 'string'
            bootMacAddress: 'string'
            machineDetails: 'string'
            machineName: 'string'
            rackSlot: int
            serialNumber: 'string'
          }
        ]
        networkRackId: 'string'
        rackLocation: 'string'
        rackSerialNumber: 'string'
        rackSkuId: 'string'
        storageApplianceConfigurationData: [
          {
            adminCredentials: {
              password: 'string'
              username: 'string'
            }
            rackSlot: int
            serialNumber: 'string'
            storageApplianceName: 'string'
          }
        ]
      }
    ]
    managedResourceGroupConfiguration: {
      location: 'string'
      name: 'string'
    }
    networkFabricId: 'string'
    runtimeProtectionConfiguration: {
      enforcementLevel: 'string'
    }
    secretArchive: {
      keyVaultId: 'string'
      useKeyVault: 'string'
    }
    updateStrategy: {
      maxUnavailable: int
      strategyType: 'string'
      thresholdType: 'string'
      thresholdValue: int
      waitTimeMinutes: int
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.NetworkCloud/クラスター

名前 形容 価値
拡張ロケーション クラスターに関連付けられているクラスター マネージャーの拡張場所。 ExtendedLocation (必須)
ID リソースの ID。 ManagedServiceIdentity の
位置 リソースが存在する地理的な場所 string (必須)
名前 リソース名

制約:
パターン = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (必須)
プロパティ リソースのプロパティの一覧。 ClusterProperties の (必須)
スコープ デプロイ スコープとは異なるスコープでリソースを作成するときに使用します。 このプロパティをリソースのシンボリック名に設定して、拡張リソースを適用します。
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください

アドミニストレーティブ・クレデンシャル

名前 形容 価値
パスワード 初期化中に使用されるデバイスの管理者のパスワード。

制約:
最小長 = 1
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。 (必須)
ユーザー名 初期化中に使用されるデバイスの管理者のユーザー名。

制約:
最小長 = 1 (必須)

BareMetalMachineConfigurationData (ベアメタルマシン構成データ)

名前 形容 価値
bmc資格情報 このベア メタル マシン上のベースボード管理コントローラーの資格情報。 AdministrativeCredentials (必須)
bmcMacアドレス このマシンの BMC の MAC アドレス。

制約:
パターン = ^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ (必須)
bootMacアドレス PXE NIC カードに関連付けられている MAC アドレス。

制約:
パターン = ^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ (必須)
machine詳細 資産タグなど、マシンに関する自由形式の追加情報。

制約:
最大長 = 256
マシン名 この仕様から作成されたベア メタル マシンのユーザー指定の名前。
指定しない場合、コンピューター名はプログラムによって生成されます。


制約:
パターン = ^([a-zA-Z0-9][a-zA-Z0-9]{0,62}[a-zA-Z0-9])$
ラックスロット 物理マシンが BOM 構成に基づいてラック内にあるスロット。 int

制約:
最小値 = 1
最大値 = 256 (必須)
シリアル番号 マシンのシリアル番号。 ハードウェア サプライヤーは代替値を使用できます。 たとえば、サービス タグです。

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

クラスタプロパティ

名前 形容 価値
アグリゲーターOrSingleRackDefinition 1 つのラック クラスター内の 1 つのラックのみ、またはマルチラック クラスター内のアグリゲーター ラックのみを反映することを目的としたラック定義。 RackDefinition (必須)
analyticsWorkspaceId (英語) 関連するログの格納に使用される Log Analytics ワークスペースのリソース ID。 文字列
clusterLocation (クラスタロケーション) クラスターが存在する場所を識別するための、顧客が指定した場所情報。

制約:
最大長 = 256
クラスタ サービスプリンシパル Arc アプライアンスのインストール中にクラスターによって使用されるサービス プリンシパル。 ServicePrincipalInformation の
クラスタタイプ クラスターのラック構成の種類。 「マルチラック」
'SingleRack' (必須)
クラスタバージョン クラスターの現在のランタイム バージョン。 string (必須)
コマンド出力設定 ベア メタル マシンの実行読み取り専用コマンドやデータ抽出など、このクラスターで実行されるコマンドの設定。 CommandOutputSettings (コマンド出力設定)
computeDeploymentThreshold (英語) 環境の検証とデプロイ中のコンピューティング マシンの許容されるエラーを示す検証しきい値。 検証しきい値
computeRackDefinitions の マルチラック内のコンピューティング ラックのラック定義の一覧
クラスター、または単一ラック クラスター内の空のリスト。
ラックの定義[]
managedResourceGroupConfiguration リソースに関連付けられているマネージド リソース グループの構成。 ManagedResourceGroupConfiguration の
ネットワークファブリックID クラスターに関連付けられている Network Fabric のリソース ID。 string (必須)
runtimeProtectionConfiguration (ランタイム保護設定) クラスター ランタイム保護の設定。 ランタイム保護構成
シークレットアーカイブ 後でオペレーターが取得できるようにシークレットを格納するためにキー コンテナーを使用するための構成。 ClusterSecretArchive の
updateStrategy クラスターを更新するための戦略。 ClusterUpdateStrategy の

ClusterSecretアーカイブ

名前 形容 価値
キー・ヴォールト・イド クラスターのシークレットをアーカイブするキー コンテナーのリソース ID。 string (必須)
useKeyVaultの 指定したキー コンテナーを使用してクラスターのシークレットをアーカイブする必要があるかどうかを示します。
「本当」

ClusterUpdateStrategy (英語)

名前 形容 価値
max利用不可 更新プログラムの増分内でオフラインにできるワーカー ノードの最大数 (ラック単位など)。
増分内のマシンの最大数によって制限されます。 既定値は増分サイズ全体です。
int

制約:
最小値 = 1
ストラテジータイプ ランタイム保護の操作モード。 「ポーズアフターラック」
'Rack' (必須)
thresholdタイプ しきい値の評価方法を選択します。 「カウントサクセス」
'PercentSuccess' (必須)
threshold値 数値のしきい値。 int

制約:
最小値 = 0 (必須)
waitTimeMinutes (英語) 戦略によって定義された更新の増分の間に待機する時間。 int

制約:
最小値 = 0
最大値 = 60

CommandOutputSettings (コマンド出力設定)

名前 形容 価値
関連付けられたアイデンティティ このストレージ アカウント コンテナーで使用するマネージド ID の選択。 ID の種類は、システム割り当てまたはユーザー割り当てのいずれかである必要があります。 アイデンティティセレクタ
コンテナURL 指定した ID によって使用されるストレージ アカウント コンテナーの URL。 文字列

拡張ロケーション

名前 形容 価値
名前 リソースが作成される拡張された場所のリソース ID。 string (必須)
拡張された場所の種類 (CustomLocation など)。 string (必須)

アイデンティティセレクター

名前 形容 価値
アイデンティティタイプ 選択されているマネージド ID の種類。 'SystemAssignedIdentity'
'UserAssignedIdentity'
userAssignedIdentityリソースID 使用するユーザー割り当てマネージド ID リソース ID。 システム割り当て ID 型と相互に排他的です。 文字列

ManagedResourceGroupConfiguration (管理リソースグループ構成)

名前 形容 価値
位置 マネージド リソース グループの場所。 指定しない場合は、親リソースの場所が選択されます。 文字列
名前 マネージド リソース グループの名前。 指定しない場合、一意の名前が自動的に生成されます。

制約:
最大長 = 75

マネージドサービスアイデンティティ

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

ラック定義

名前 形容 価値
アベイラビリティゾーン 作成時にこのラックに使用されるゾーン名。 可用性ゾーンは、ワークロードの配置に使用されます。

制約:
パターン = ^[a-zA-Z0-9]{1,10}$
bareMetalMachineConfigurationData ベア メタル マシン構成の順序指定されていない一覧。 BareMetalMachineConfigurationData[]
ネットワークラックID このラック定義に一致するネットワーク ラックのリソース ID。 string (必須)
rack場所 ラックの位置の自由形式の説明。

制約:
最大長 = 256
rackSerialNumber (ラックシリアル番号) ネットワーク クラウド クラスター内のラックの一意識別子。 必要に応じて、シリアル番号以外の代替の一意の英数字値を指定できます。

制約:
最小長 = 1
最大長 = 64 (必須)
rackSkuId(ラックスクイド) 追加するラックの SKU のリソース ID。 string (必須)
storageApplianceConfigurationData このラックのストレージ アプライアンス構成データの一覧。 StorageApplianceConfigurationData[]

ランタイム保護構成

名前 形容 価値
enforcementLevel (エンフォースメント・レベル) ランタイム保護の操作モード。 「監査」
「無効」
「オンデマンド」
'パッシブ'
「リアルタイム」

ServicePrincipal情報

名前 形容 価値
アプリケーションID サービス プリンシパルのアプリケーション ID (クライアント ID とも呼ばれます)。 string (必須)
パスワード サービス プリンシパルのパスワード。

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。 (必須)
プリンシパルID サービス プリンシパルのプリンシパル ID (オブジェクト ID とも呼ばれます)。 string (必須)
テナントID サービス プリンシパルが作成されるテナントのテナント ID (ディレクトリ ID とも呼ばれます)。 string (必須)

StorageApplianceConfigurationData

名前 形容 価値
adminCredentialsの このストレージ アプライアンス上の管理インターフェイスの資格情報。 AdministrativeCredentials (必須)
ラックスロット BOM 構成に基づいて、ストレージ アプライアンスがラック内にあるスロット。 int

制約:
最小値 = 1
最大値 = 256 (必須)
シリアル番号 アプライアンスのシリアル番号。 string (必須)
storageApplianceName (ストレージアプライアンス名) この仕様から作成されるストレージ アプライアンスのユーザー指定の名前。

制約:
パターン = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$

追跡リソースタグ

名前 形容 価値

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

名前 形容 価値

ユーザー割り当て識別子

名前 形容 価値

検証しきい値

名前 形容 価値
グループ クラスターの計算に型評価を適用する方法を選択します。 「PerCluster」
'PerRack' (必須)
しきい値の評価方法を選択します。 「カウントサクセス」
'PercentSuccess' (必須)
価値 数値のしきい値。 int

制約:
最小値 = 0 (必須)

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

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

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

リソースの形式

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

{
  "type": "Microsoft.NetworkCloud/clusters",
  "apiVersion": "2024-07-01",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "aggregatorOrSingleRackDefinition": {
      "availabilityZone": "string",
      "bareMetalMachineConfigurationData": [
        {
          "bmcCredentials": {
            "password": "string",
            "username": "string"
          },
          "bmcMacAddress": "string",
          "bootMacAddress": "string",
          "machineDetails": "string",
          "machineName": "string",
          "rackSlot": "int",
          "serialNumber": "string"
        }
      ],
      "networkRackId": "string",
      "rackLocation": "string",
      "rackSerialNumber": "string",
      "rackSkuId": "string",
      "storageApplianceConfigurationData": [
        {
          "adminCredentials": {
            "password": "string",
            "username": "string"
          },
          "rackSlot": "int",
          "serialNumber": "string",
          "storageApplianceName": "string"
        }
      ]
    },
    "analyticsWorkspaceId": "string",
    "clusterLocation": "string",
    "clusterServicePrincipal": {
      "applicationId": "string",
      "password": "string",
      "principalId": "string",
      "tenantId": "string"
    },
    "clusterType": "string",
    "clusterVersion": "string",
    "commandOutputSettings": {
      "associatedIdentity": {
        "identityType": "string",
        "userAssignedIdentityResourceId": "string"
      },
      "containerUrl": "string"
    },
    "computeDeploymentThreshold": {
      "grouping": "string",
      "type": "string",
      "value": "int"
    },
    "computeRackDefinitions": [
      {
        "availabilityZone": "string",
        "bareMetalMachineConfigurationData": [
          {
            "bmcCredentials": {
              "password": "string",
              "username": "string"
            },
            "bmcMacAddress": "string",
            "bootMacAddress": "string",
            "machineDetails": "string",
            "machineName": "string",
            "rackSlot": "int",
            "serialNumber": "string"
          }
        ],
        "networkRackId": "string",
        "rackLocation": "string",
        "rackSerialNumber": "string",
        "rackSkuId": "string",
        "storageApplianceConfigurationData": [
          {
            "adminCredentials": {
              "password": "string",
              "username": "string"
            },
            "rackSlot": "int",
            "serialNumber": "string",
            "storageApplianceName": "string"
          }
        ]
      }
    ],
    "managedResourceGroupConfiguration": {
      "location": "string",
      "name": "string"
    },
    "networkFabricId": "string",
    "runtimeProtectionConfiguration": {
      "enforcementLevel": "string"
    },
    "secretArchive": {
      "keyVaultId": "string",
      "useKeyVault": "string"
    },
    "updateStrategy": {
      "maxUnavailable": "int",
      "strategyType": "string",
      "thresholdType": "string",
      "thresholdValue": "int",
      "waitTimeMinutes": "int"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.NetworkCloud/クラスター

名前 形容 価値
apiVersion (英語) API のバージョン '2024-07-01'
拡張ロケーション クラスターに関連付けられているクラスター マネージャーの拡張場所。 ExtendedLocation (必須)
ID リソースの ID。 ManagedServiceIdentity の
位置 リソースが存在する地理的な場所 string (必須)
名前 リソース名

制約:
パターン = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (必須)
プロパティ リソースのプロパティの一覧。 ClusterProperties の (必須)
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください
リソースの種類 'Microsoft.NetworkCloud/clusters'

アドミニストレーティブ・クレデンシャル

名前 形容 価値
パスワード 初期化中に使用されるデバイスの管理者のパスワード。

制約:
最小長 = 1
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。 (必須)
ユーザー名 初期化中に使用されるデバイスの管理者のユーザー名。

制約:
最小長 = 1 (必須)

BareMetalMachineConfigurationData (ベアメタルマシン構成データ)

名前 形容 価値
bmc資格情報 このベア メタル マシン上のベースボード管理コントローラーの資格情報。 AdministrativeCredentials (必須)
bmcMacアドレス このマシンの BMC の MAC アドレス。

制約:
パターン = ^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ (必須)
bootMacアドレス PXE NIC カードに関連付けられている MAC アドレス。

制約:
パターン = ^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ (必須)
machine詳細 資産タグなど、マシンに関する自由形式の追加情報。

制約:
最大長 = 256
マシン名 この仕様から作成されたベア メタル マシンのユーザー指定の名前。
指定しない場合、コンピューター名はプログラムによって生成されます。


制約:
パターン = ^([a-zA-Z0-9][a-zA-Z0-9]{0,62}[a-zA-Z0-9])$
ラックスロット 物理マシンが BOM 構成に基づいてラック内にあるスロット。 int

制約:
最小値 = 1
最大値 = 256 (必須)
シリアル番号 マシンのシリアル番号。 ハードウェア サプライヤーは代替値を使用できます。 たとえば、サービス タグです。

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

クラスタプロパティ

名前 形容 価値
アグリゲーターOrSingleRackDefinition 1 つのラック クラスター内の 1 つのラックのみ、またはマルチラック クラスター内のアグリゲーター ラックのみを反映することを目的としたラック定義。 RackDefinition (必須)
analyticsWorkspaceId (英語) 関連するログの格納に使用される Log Analytics ワークスペースのリソース ID。 文字列
clusterLocation (クラスタロケーション) クラスターが存在する場所を識別するための、顧客が指定した場所情報。

制約:
最大長 = 256
クラスタ サービスプリンシパル Arc アプライアンスのインストール中にクラスターによって使用されるサービス プリンシパル。 ServicePrincipalInformation の
クラスタタイプ クラスターのラック構成の種類。 「マルチラック」
'SingleRack' (必須)
クラスタバージョン クラスターの現在のランタイム バージョン。 string (必須)
コマンド出力設定 ベア メタル マシンの実行読み取り専用コマンドやデータ抽出など、このクラスターで実行されるコマンドの設定。 CommandOutputSettings (コマンド出力設定)
computeDeploymentThreshold (英語) 環境の検証とデプロイ中のコンピューティング マシンの許容されるエラーを示す検証しきい値。 検証しきい値
computeRackDefinitions の マルチラック内のコンピューティング ラックのラック定義の一覧
クラスター、または単一ラック クラスター内の空のリスト。
ラックの定義[]
managedResourceGroupConfiguration リソースに関連付けられているマネージド リソース グループの構成。 ManagedResourceGroupConfiguration の
ネットワークファブリックID クラスターに関連付けられている Network Fabric のリソース ID。 string (必須)
runtimeProtectionConfiguration (ランタイム保護設定) クラスター ランタイム保護の設定。 ランタイム保護構成
シークレットアーカイブ 後でオペレーターが取得できるようにシークレットを格納するためにキー コンテナーを使用するための構成。 ClusterSecretArchive の
updateStrategy クラスターを更新するための戦略。 ClusterUpdateStrategy の

ClusterSecretアーカイブ

名前 形容 価値
キー・ヴォールト・イド クラスターのシークレットをアーカイブするキー コンテナーのリソース ID。 string (必須)
useKeyVaultの 指定したキー コンテナーを使用してクラスターのシークレットをアーカイブする必要があるかどうかを示します。
「本当」

ClusterUpdateStrategy (英語)

名前 形容 価値
max利用不可 更新プログラムの増分内でオフラインにできるワーカー ノードの最大数 (ラック単位など)。
増分内のマシンの最大数によって制限されます。 既定値は増分サイズ全体です。
int

制約:
最小値 = 1
ストラテジータイプ ランタイム保護の操作モード。 「ポーズアフターラック」
'Rack' (必須)
thresholdタイプ しきい値の評価方法を選択します。 「カウントサクセス」
'PercentSuccess' (必須)
threshold値 数値のしきい値。 int

制約:
最小値 = 0 (必須)
waitTimeMinutes (英語) 戦略によって定義された更新の増分の間に待機する時間。 int

制約:
最小値 = 0
最大値 = 60

CommandOutputSettings (コマンド出力設定)

名前 形容 価値
関連付けられたアイデンティティ このストレージ アカウント コンテナーで使用するマネージド ID の選択。 ID の種類は、システム割り当てまたはユーザー割り当てのいずれかである必要があります。 アイデンティティセレクタ
コンテナURL 指定した ID によって使用されるストレージ アカウント コンテナーの URL。 文字列

拡張ロケーション

名前 形容 価値
名前 リソースが作成される拡張された場所のリソース ID。 string (必須)
拡張された場所の種類 (CustomLocation など)。 string (必須)

アイデンティティセレクター

名前 形容 価値
アイデンティティタイプ 選択されているマネージド ID の種類。 'SystemAssignedIdentity'
'UserAssignedIdentity'
userAssignedIdentityリソースID 使用するユーザー割り当てマネージド ID リソース ID。 システム割り当て ID 型と相互に排他的です。 文字列

ManagedResourceGroupConfiguration (管理リソースグループ構成)

名前 形容 価値
位置 マネージド リソース グループの場所。 指定しない場合は、親リソースの場所が選択されます。 文字列
名前 マネージド リソース グループの名前。 指定しない場合、一意の名前が自動的に生成されます。

制約:
最大長 = 75

マネージドサービスアイデンティティ

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

ラック定義

名前 形容 価値
アベイラビリティゾーン 作成時にこのラックに使用されるゾーン名。 可用性ゾーンは、ワークロードの配置に使用されます。

制約:
パターン = ^[a-zA-Z0-9]{1,10}$
bareMetalMachineConfigurationData ベア メタル マシン構成の順序指定されていない一覧。 BareMetalMachineConfigurationData[]
ネットワークラックID このラック定義に一致するネットワーク ラックのリソース ID。 string (必須)
rack場所 ラックの位置の自由形式の説明。

制約:
最大長 = 256
rackSerialNumber (ラックシリアル番号) ネットワーク クラウド クラスター内のラックの一意識別子。 必要に応じて、シリアル番号以外の代替の一意の英数字値を指定できます。

制約:
最小長 = 1
最大長 = 64 (必須)
rackSkuId(ラックスクイド) 追加するラックの SKU のリソース ID。 string (必須)
storageApplianceConfigurationData このラックのストレージ アプライアンス構成データの一覧。 StorageApplianceConfigurationData[]

ランタイム保護構成

名前 形容 価値
enforcementLevel (エンフォースメント・レベル) ランタイム保護の操作モード。 「監査」
「無効」
「オンデマンド」
'パッシブ'
「リアルタイム」

ServicePrincipal情報

名前 形容 価値
アプリケーションID サービス プリンシパルのアプリケーション ID (クライアント ID とも呼ばれます)。 string (必須)
パスワード サービス プリンシパルのパスワード。

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。 (必須)
プリンシパルID サービス プリンシパルのプリンシパル ID (オブジェクト ID とも呼ばれます)。 string (必須)
テナントID サービス プリンシパルが作成されるテナントのテナント ID (ディレクトリ ID とも呼ばれます)。 string (必須)

StorageApplianceConfigurationData

名前 形容 価値
adminCredentialsの このストレージ アプライアンス上の管理インターフェイスの資格情報。 AdministrativeCredentials (必須)
ラックスロット BOM 構成に基づいて、ストレージ アプライアンスがラック内にあるスロット。 int

制約:
最小値 = 1
最大値 = 256 (必須)
シリアル番号 アプライアンスのシリアル番号。 string (必須)
storageApplianceName (ストレージアプライアンス名) この仕様から作成されるストレージ アプライアンスのユーザー指定の名前。

制約:
パターン = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$

追跡リソースタグ

名前 形容 価値

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

名前 形容 価値

ユーザー割り当て識別子

名前 形容 価値

検証しきい値

名前 形容 価値
グループ クラスターの計算に型評価を適用する方法を選択します。 「PerCluster」
'PerRack' (必須)
しきい値の評価方法を選択します。 「カウントサクセス」
'PercentSuccess' (必須)
価値 数値のしきい値。 int

制約:
最小値 = 0 (必須)

使用例

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

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

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

リソースの形式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.NetworkCloud/clusters@2024-07-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      aggregatorOrSingleRackDefinition = {
        availabilityZone = "string"
        bareMetalMachineConfigurationData = [
          {
            bmcCredentials = {
              password = "string"
              username = "string"
            }
            bmcMacAddress = "string"
            bootMacAddress = "string"
            machineDetails = "string"
            machineName = "string"
            rackSlot = int
            serialNumber = "string"
          }
        ]
        networkRackId = "string"
        rackLocation = "string"
        rackSerialNumber = "string"
        rackSkuId = "string"
        storageApplianceConfigurationData = [
          {
            adminCredentials = {
              password = "string"
              username = "string"
            }
            rackSlot = int
            serialNumber = "string"
            storageApplianceName = "string"
          }
        ]
      }
      analyticsWorkspaceId = "string"
      clusterLocation = "string"
      clusterServicePrincipal = {
        applicationId = "string"
        password = "string"
        principalId = "string"
        tenantId = "string"
      }
      clusterType = "string"
      clusterVersion = "string"
      commandOutputSettings = {
        associatedIdentity = {
          identityType = "string"
          userAssignedIdentityResourceId = "string"
        }
        containerUrl = "string"
      }
      computeDeploymentThreshold = {
        grouping = "string"
        type = "string"
        value = int
      }
      computeRackDefinitions = [
        {
          availabilityZone = "string"
          bareMetalMachineConfigurationData = [
            {
              bmcCredentials = {
                password = "string"
                username = "string"
              }
              bmcMacAddress = "string"
              bootMacAddress = "string"
              machineDetails = "string"
              machineName = "string"
              rackSlot = int
              serialNumber = "string"
            }
          ]
          networkRackId = "string"
          rackLocation = "string"
          rackSerialNumber = "string"
          rackSkuId = "string"
          storageApplianceConfigurationData = [
            {
              adminCredentials = {
                password = "string"
                username = "string"
              }
              rackSlot = int
              serialNumber = "string"
              storageApplianceName = "string"
            }
          ]
        }
      ]
      managedResourceGroupConfiguration = {
        location = "string"
        name = "string"
      }
      networkFabricId = "string"
      runtimeProtectionConfiguration = {
        enforcementLevel = "string"
      }
      secretArchive = {
        keyVaultId = "string"
        useKeyVault = "string"
      }
      updateStrategy = {
        maxUnavailable = int
        strategyType = "string"
        thresholdType = "string"
        thresholdValue = int
        waitTimeMinutes = int
      }
    }
  }
}

プロパティ値

Microsoft.NetworkCloud/クラスター

名前 形容 価値
拡張ロケーション クラスターに関連付けられているクラスター マネージャーの拡張場所。 ExtendedLocation (必須)
ID リソースの ID。 ManagedServiceIdentity の
位置 リソースが存在する地理的な場所 string (必須)
名前 リソース名

制約:
パターン = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (必須)
parent_id この拡張リソースを適用するリソースの ID。 string (必須)
プロパティ リソースのプロパティの一覧。 ClusterProperties の (必須)
タグ リソース タグ タグ名と値のディクショナリ。
リソースの種類 "Microsoft.NetworkCloud/clusters@2024-07-01"

アドミニストレーティブ・クレデンシャル

名前 形容 価値
パスワード 初期化中に使用されるデバイスの管理者のパスワード。

制約:
最小長 = 1
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。 (必須)
ユーザー名 初期化中に使用されるデバイスの管理者のユーザー名。

制約:
最小長 = 1 (必須)

BareMetalMachineConfigurationData (ベアメタルマシン構成データ)

名前 形容 価値
bmc資格情報 このベア メタル マシン上のベースボード管理コントローラーの資格情報。 AdministrativeCredentials (必須)
bmcMacアドレス このマシンの BMC の MAC アドレス。

制約:
パターン = ^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ (必須)
bootMacアドレス PXE NIC カードに関連付けられている MAC アドレス。

制約:
パターン = ^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ (必須)
machine詳細 資産タグなど、マシンに関する自由形式の追加情報。

制約:
最大長 = 256
マシン名 この仕様から作成されたベア メタル マシンのユーザー指定の名前。
指定しない場合、コンピューター名はプログラムによって生成されます。


制約:
パターン = ^([a-zA-Z0-9][a-zA-Z0-9]{0,62}[a-zA-Z0-9])$
ラックスロット 物理マシンが BOM 構成に基づいてラック内にあるスロット。 int

制約:
最小値 = 1
最大値 = 256 (必須)
シリアル番号 マシンのシリアル番号。 ハードウェア サプライヤーは代替値を使用できます。 たとえば、サービス タグです。

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

クラスタプロパティ

名前 形容 価値
アグリゲーターOrSingleRackDefinition 1 つのラック クラスター内の 1 つのラックのみ、またはマルチラック クラスター内のアグリゲーター ラックのみを反映することを目的としたラック定義。 RackDefinition (必須)
analyticsWorkspaceId (英語) 関連するログの格納に使用される Log Analytics ワークスペースのリソース ID。 文字列
clusterLocation (クラスタロケーション) クラスターが存在する場所を識別するための、顧客が指定した場所情報。

制約:
最大長 = 256
クラスタ サービスプリンシパル Arc アプライアンスのインストール中にクラスターによって使用されるサービス プリンシパル。 ServicePrincipalInformation の
クラスタタイプ クラスターのラック構成の種類。 「マルチラック」
'SingleRack' (必須)
クラスタバージョン クラスターの現在のランタイム バージョン。 string (必須)
コマンド出力設定 ベア メタル マシンの実行読み取り専用コマンドやデータ抽出など、このクラスターで実行されるコマンドの設定。 CommandOutputSettings (コマンド出力設定)
computeDeploymentThreshold (英語) 環境の検証とデプロイ中のコンピューティング マシンの許容されるエラーを示す検証しきい値。 検証しきい値
computeRackDefinitions の マルチラック内のコンピューティング ラックのラック定義の一覧
クラスター、または単一ラック クラスター内の空のリスト。
ラックの定義[]
managedResourceGroupConfiguration リソースに関連付けられているマネージド リソース グループの構成。 ManagedResourceGroupConfiguration の
ネットワークファブリックID クラスターに関連付けられている Network Fabric のリソース ID。 string (必須)
runtimeProtectionConfiguration (ランタイム保護設定) クラスター ランタイム保護の設定。 ランタイム保護構成
シークレットアーカイブ 後でオペレーターが取得できるようにシークレットを格納するためにキー コンテナーを使用するための構成。 ClusterSecretArchive の
updateStrategy クラスターを更新するための戦略。 ClusterUpdateStrategy の

ClusterSecretアーカイブ

名前 形容 価値
キー・ヴォールト・イド クラスターのシークレットをアーカイブするキー コンテナーのリソース ID。 string (必須)
useKeyVaultの 指定したキー コンテナーを使用してクラスターのシークレットをアーカイブする必要があるかどうかを示します。
「本当」

ClusterUpdateStrategy (英語)

名前 形容 価値
max利用不可 更新プログラムの増分内でオフラインにできるワーカー ノードの最大数 (ラック単位など)。
増分内のマシンの最大数によって制限されます。 既定値は増分サイズ全体です。
int

制約:
最小値 = 1
ストラテジータイプ ランタイム保護の操作モード。 「ポーズアフターラック」
'Rack' (必須)
thresholdタイプ しきい値の評価方法を選択します。 「カウントサクセス」
'PercentSuccess' (必須)
threshold値 数値のしきい値。 int

制約:
最小値 = 0 (必須)
waitTimeMinutes (英語) 戦略によって定義された更新の増分の間に待機する時間。 int

制約:
最小値 = 0
最大値 = 60

CommandOutputSettings (コマンド出力設定)

名前 形容 価値
関連付けられたアイデンティティ このストレージ アカウント コンテナーで使用するマネージド ID の選択。 ID の種類は、システム割り当てまたはユーザー割り当てのいずれかである必要があります。 アイデンティティセレクタ
コンテナURL 指定した ID によって使用されるストレージ アカウント コンテナーの URL。 文字列

拡張ロケーション

名前 形容 価値
名前 リソースが作成される拡張された場所のリソース ID。 string (必須)
拡張された場所の種類 (CustomLocation など)。 string (必須)

アイデンティティセレクター

名前 形容 価値
アイデンティティタイプ 選択されているマネージド ID の種類。 'SystemAssignedIdentity'
'UserAssignedIdentity'
userAssignedIdentityリソースID 使用するユーザー割り当てマネージド ID リソース ID。 システム割り当て ID 型と相互に排他的です。 文字列

ManagedResourceGroupConfiguration (管理リソースグループ構成)

名前 形容 価値
位置 マネージド リソース グループの場所。 指定しない場合は、親リソースの場所が選択されます。 文字列
名前 マネージド リソース グループの名前。 指定しない場合、一意の名前が自動的に生成されます。

制約:
最大長 = 75

マネージドサービスアイデンティティ

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

ラック定義

名前 形容 価値
アベイラビリティゾーン 作成時にこのラックに使用されるゾーン名。 可用性ゾーンは、ワークロードの配置に使用されます。

制約:
パターン = ^[a-zA-Z0-9]{1,10}$
bareMetalMachineConfigurationData ベア メタル マシン構成の順序指定されていない一覧。 BareMetalMachineConfigurationData[]
ネットワークラックID このラック定義に一致するネットワーク ラックのリソース ID。 string (必須)
rack場所 ラックの位置の自由形式の説明。

制約:
最大長 = 256
rackSerialNumber (ラックシリアル番号) ネットワーク クラウド クラスター内のラックの一意識別子。 必要に応じて、シリアル番号以外の代替の一意の英数字値を指定できます。

制約:
最小長 = 1
最大長 = 64 (必須)
rackSkuId(ラックスクイド) 追加するラックの SKU のリソース ID。 string (必須)
storageApplianceConfigurationData このラックのストレージ アプライアンス構成データの一覧。 StorageApplianceConfigurationData[]

ランタイム保護構成

名前 形容 価値
enforcementLevel (エンフォースメント・レベル) ランタイム保護の操作モード。 「監査」
「無効」
「オンデマンド」
'パッシブ'
「リアルタイム」

ServicePrincipal情報

名前 形容 価値
アプリケーションID サービス プリンシパルのアプリケーション ID (クライアント ID とも呼ばれます)。 string (必須)
パスワード サービス プリンシパルのパスワード。

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。 (必須)
プリンシパルID サービス プリンシパルのプリンシパル ID (オブジェクト ID とも呼ばれます)。 string (必須)
テナントID サービス プリンシパルが作成されるテナントのテナント ID (ディレクトリ ID とも呼ばれます)。 string (必須)

StorageApplianceConfigurationData

名前 形容 価値
adminCredentialsの このストレージ アプライアンス上の管理インターフェイスの資格情報。 AdministrativeCredentials (必須)
ラックスロット BOM 構成に基づいて、ストレージ アプライアンスがラック内にあるスロット。 int

制約:
最小値 = 1
最大値 = 256 (必須)
シリアル番号 アプライアンスのシリアル番号。 string (必須)
storageApplianceName (ストレージアプライアンス名) この仕様から作成されるストレージ アプライアンスのユーザー指定の名前。

制約:
パターン = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$

追跡リソースタグ

名前 形容 価値

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

名前 形容 価値

ユーザー割り当て識別子

名前 形容 価値

検証しきい値

名前 形容 価値
グループ クラスターの計算に型評価を適用する方法を選択します。 「PerCluster」
'PerRack' (必須)
しきい値の評価方法を選択します。 「カウントサクセス」
'PercentSuccess' (必須)
価値 数値のしきい値。 int

制約:
最小値 = 0 (必須)