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 (必須) |