Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Definição de recurso do Bicep
O tipo de recurso de clusters pode ser implantado com operações direcionadas:
- Grupos de recursos - Consulte comandos de implantação do grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Formato de recurso
Para criar um recurso Microsoft.NetworkCloud/clusters, adicione o Bicep a seguir ao seu modelo.
resource symbolicname 'Microsoft.NetworkCloud/clusters@2026-07-01' = {
extendedLocation: {
name: 'string'
type: 'string'
}
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
kind: 'string'
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'
}
]
}
analyticsOutputSettings: {
analyticsWorkspaceId: 'string'
associatedIdentity: {
identityType: 'string'
userAssignedIdentityResourceId: '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'
overrides: [
{
associatedIdentity: {
identityType: 'string'
userAssignedIdentityResourceId: 'string'
}
commandOutputType: '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: {
definitionUpdateMode: 'string'
enforcementLevel: 'string'
}
secretArchive: {
keyVaultId: 'string'
useKeyVault: 'string'
}
secretArchiveSettings: {
associatedIdentity: {
identityType: 'string'
userAssignedIdentityResourceId: 'string'
}
vaultUri: 'string'
}
updateStrategy: {
maxUnavailable: int
strategyType: 'string'
thresholdType: 'string'
thresholdValue: int
waitTimeMinutes: int
}
vulnerabilityScanningSettings: {
containerScan: 'string'
}
}
tags: {
{customized property}: 'string'
}
}
Valores da propriedade
Microsoft.NetworkCloud/clusters
| Nome | Descrição | Valor |
|---|---|---|
| localização estendida | A localização estendida do recurso. Essa propriedade é necessária na criação do recurso. | AzureResourceManagerCommonTypesExtendedLocation (required) |
| identidade | As identidades de serviço gerenciadas atribuídas a esse recurso. | ManagedServiceIdentity |
| variante | O tipo (tipo) do cluster. Quando especificado, o valor deve corresponder exatamente ao tipo configurado no gerenciador de cluster que gerencia o cluster. Se for omitido, o serviço irá definir o valor padrão para o valor de tipo do gerenciador de cluster. | 'AzureLocal' 'Nexus' |
| local | A localização geográfica onde o recurso reside | cadeia de caracteres (obrigatório) |
| nome | O nome do recurso | corda Restrições: Padrão = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (obrigatório) |
| Propriedades | A lista das propriedades do recurso. | clusterProperties (obrigatório) |
| Tags | Marcas de recurso | Dicionário de nomes e valores de marca. Consulte Marcas em modelos |
Credenciais administrativas
| Nome | Descrição | Valor |
|---|---|---|
| senha | A senha do administrador do dispositivo usado durante a inicialização. | corda Restrições: Comprimento mínimo = 1 Valor confidencial. Passe como um parâmetro seguro. (obrigatório) |
| nome de usuário | O nome de usuário do administrador do dispositivo usado durante a inicialização. | corda Restrições: Comprimento mínimo = 1 (obrigatório) |
AnalyticsOutputSettings
| Nome | Descrição | Valor |
|---|---|---|
| analyticsWorkspaceId | A ID do recurso do workspace de análise que deve ser usado pela identidade especificada. | cadeia |
| identidade associada | A seleção da identidade gerenciada a ser usada com esse workspace de análise. O tipo de identidade deve ser atribuído ao sistema ou ao usuário. | identityselector |
AzureResourceManagerCommonTypesExtendedLocation
| Nome | Descrição | Valor |
|---|---|---|
| nome | O nome do local estendido. | cadeia de caracteres (obrigatório) |
| tipo | O tipo de local estendido. | 'Localização Personalizada' 'EdgeZone' (obrigatório) |
BareMetalMachineConfigurationData
Propriedades do Cluster
| Nome | Descrição | Valor |
|---|---|---|
| agregadorOuSingleRackDefinição | A definição de rack que se destina a refletir apenas um único rack em um único cluster de rack ou um rack agregador em um cluster multi-rack. | RackDefinition (obrigatório) |
| Configurações de saída de análise | As configurações do workspace do Log Analytics usadas para a saída de logs desse cluster. | AnalyticsOutputSettings |
| analyticsWorkspaceId | Campo preterido. A ID do recurso do workspace do Log Analytics que será usado para armazenar logs relevantes. | cadeia |
| localização do cluster | As informações de localização fornecidas pelo cliente para identificar onde o cluster reside. | corda Restrições: Comprimento máximo = 256 |
| clusterServicePrincipal | Campo Preterido: use a identidade gerenciada para fornecer privilégios de cluster. A entidade de serviço a ser usada pelo cluster durante a instalação do Dispositivo Arc. | ServicePrincipalInformation |
| tipo de cluster | O tipo de configuração de rack para o cluster. | 'MultiRack' 'SingleRack' (obrigatório) |
| Versão do cluster | A versão atual do runtime do cluster. | cadeia de caracteres (obrigatório) |
| commandOutputSettings | As configurações para comandos são executadas neste cluster, como a execução de máquina bare-metal somente leitura de comandos e extrações de dados. | commandOutputSettings |
| computeDeploymentThreshold | O limite de validação que indica as falhas permitidos de computadores de computação durante a validação e a implantação do ambiente. | ValidationThreshold |
| computeRackDefinitions | A lista de definições de rack para os racks de computação em um cluster de vários racks ou uma lista vazia em um cluster de rack único. | Definição de rack |
| Configuração do Grupo de Recursos Gerenciado | A configuração do grupo de recursos gerenciados associado ao recurso. | ManagedResourceGroupConfiguration |
| networkFabricId | A ID do recurso do Network Fabric associado ao cluster. | cadeia de caracteres (obrigatório) |
| runtimeProtectionConfiguration | As configurações para proteção de runtime do cluster. | RuntimeProtectionConfiguration |
| Arquivo secreto | A configuração para uso de um cofre de chaves para armazenar segredos para recuperação posterior pelo operador. | clusterSecretArchive |
| secretArchiveSettings | As configurações do arquivo secreto usado para armazenar credenciais para o cluster. | SecretArchiveSettings |
| updateStrategy | A estratégia para atualizar o cluster. | ClusterUpdateStrategy |
| vulnerabilidadeScanningSettings | As configurações de como a verificação de vulnerabilidades de segurança é aplicada ao cluster. | VulnerabilityScanningSettings |
Arquivo Secreto do Cluster
| Nome | Descrição | Valor |
|---|---|---|
| keyVaultId | A ID do recurso do cofre de chaves para arquivar os segredos do cluster. | cadeia de caracteres (obrigatório) |
| useKeyVault | O indicador se o cofre de chaves especificado deve ser usado para arquivar os segredos do cluster. | Falso 'Verdade' |
Estratégia de atualização de cluster
| Nome | Descrição | Valor |
|---|---|---|
| maxIndisponível | O número máximo de nós de trabalho que podem estar offline dentro do incremento da atualização, por exemplo, rack por rack. Limitado pelo número máximo de computadores no incremento. O padrão é todo o tamanho de incremento. | int Restrições: Valor mínimo = 1 |
| tipo de estratégia | O modo de operação para proteção de runtime. | 'PauseAfterRack' 'Rack' (obrigatório) |
| tipo de limite | Seleção de como o limite deve ser avaliado. | 'ContarSucesso' 'PercentSuccess' (obrigatório) |
| valor limite | O valor do limite numérico. | int Restrições: Valor mínimo = 0 (obrigatório) |
| waitTimeMinutes | O tempo de espera entre os incrementos de atualização definidos pela estratégia. | int Restrições: Valor mínimo = 0 Valor máximo = 60 |
CommandOutputOverride
| Nome | Descrição | Valor |
|---|---|---|
| identidade associada | A seleção da identidade gerenciada a ser usada com esse contêiner de conta de armazenamento. O tipo de identidade deve ser atribuído ao sistema ou ao usuário. | identityselector |
| commandOutputType | O tipo de saída de comando para a substituição. | 'BareMetalMachineRunCommand' 'BareMetalMachineRunDataExtracts' 'BareMetalMachineRunDataExtractsRestricted' 'BareMetalMachineRunReadCommands' 'AçõesAdministrativasDe Suporte ao Cluster' 'StorageRunReadCommands' |
| containerUrl | A URL do contêiner da conta de armazenamento que deve ser usada pelas identidades especificadas. | cadeia |
CommandOutputSettings
| Nome | Descrição | Valor |
|---|---|---|
| identidade associada | A seleção da identidade gerenciada a ser usada com esse contêiner de conta de armazenamento. O tipo de identidade deve ser atribuído ao sistema ou ao usuário. | identityselector |
| containerUrl | A URL do contêiner da conta de armazenamento que deve ser usada pelas identidades especificadas. | cadeia |
| substituições | A lista de substituições opcionais que permitem a associação de contêineres de armazenamento e identidades a tipos específicos de saída de comando. Se um tipo não for substituído, a identidade padrão e o contêiner de armazenamento serão utilizados. | CommandOutputOverride[] |
IdentitySelector
| Nome | Descrição | Valor |
|---|---|---|
| tipo de identidade | O tipo de identidade gerenciada que está sendo selecionado. | 'SystemAssignedIdentity' 'UserAssignedIdentity' |
| userAssignedIdentityResourceId | A ID do recurso de identidade gerenciada atribuída pelo usuário a ser usada. Mutuamente exclusivo com um tipo de identidade atribuído pelo sistema. | cadeia |
Configuração do Grupo de Recursos Gerenciados
| Nome | Descrição | Valor |
|---|---|---|
| local | O local do grupo de recursos gerenciados. Se não for especificado, o local do recurso pai será escolhido. | cadeia |
| nome | O nome do grupo de recursos gerenciado. Se não for especificado, o nome exclusivo será gerado automaticamente. | corda Restrições: Comprimento máximo = 75 |
ManagedServiceIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos). | 'Nenhum' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obrigatório) |
| Identidades Atribuídas pelo Usuário | O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Nome | Descrição | Valor |
|---|
Definição de rack
| Nome | Descrição | Valor |
|---|---|---|
| Zona de disponibilidade | O nome da zona usado para este rack quando criado. As zonas de disponibilidade são usadas para o posicionamento da carga de trabalho. | corda Restrições: Padrão = ^[a-zA-Z0-9]{1,10}$ |
| bareMetalMachineConfigurationData | A lista não ordenada da configuração da máquina bare-metal. | BareMetalMachineConfigurationData |
| networkRackId | A ID do recurso do rack de rede que corresponde a essa definição de rack. | cadeia de caracteres (obrigatório) |
| localização do rack | A descrição de forma livre da localização do rack. | corda Restrições: Comprimento máximo = 256 |
| rackNúmero de série | O identificador exclusivo do rack no cluster de Nuvem de Rede. Um valor alfanumérico exclusivo alternativo diferente de um número de série poderá ser fornecido, se desejado. | corda Restrições: Comprimento mínimo = 1 Comprimento máximo = 64 (obrigatório) |
| rackSkuId | A ID do recurso do sku para o rack que está sendo adicionado. | cadeia de caracteres (obrigatório) |
| storageApplianceConfigurationData | A lista de dados de configuração do dispositivo de armazenamento para este rack. | StorageApplianceConfigurationData [] |
RuntimeProtectionConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| definitionUpdateMode | O modo de atualização de definição para proteção em tempo de execução. | 'Automático' 'Nenhum' |
| nível de imposição | O modo de operação para proteção de runtime. | 'Auditoria' 'Desabilitado' 'Sob demanda' 'Passivo' 'Tempo real' |
Configurações de arquivo secreto
| Nome | Descrição | Valor |
|---|---|---|
| identidade associada | A seleção da identidade gerenciada a ser usada com esse URI do cofre. O tipo de identidade deve ser atribuído ao sistema ou ao usuário. | identityselector |
| vaultUri | O URI do cofre de chaves usado como o arquivo secreto. | cadeia |
ServicePrincipalInformation
| Nome | Descrição | Valor |
|---|---|---|
| ID do aplicativo | A ID do aplicativo, também conhecida como ID do cliente, da entidade de serviço. | cadeia de caracteres (obrigatório) |
| senha | A senha da entidade de serviço. | corda Restrições: Valor confidencial. Passe como um parâmetro seguro. (obrigatório) |
| principalId | A ID da entidade de segurança, também conhecida como ID do objeto, da entidade de serviço. | cadeia de caracteres (obrigatório) |
| ID do inquilino | A ID do locatário, também conhecida como ID do diretório, do locatário no qual a entidade de serviço é criada. | cadeia de caracteres (obrigatório) |
StorageApplianceConfigurationData
TrackedResourceTags
| Nome | Descrição | Valor |
|---|
UserAssignedIdentity
| Nome | Descrição | Valor |
|---|
Limite de validação
| Nome | Descrição | Valor |
|---|---|---|
| agrupamento | Seleção de como a avaliação de tipo é aplicada ao cálculo do cluster. | 'PerCluster' 'PerRack' (obrigatório) |
| tipo | Seleção de como o limite deve ser avaliado. | 'ContarSucesso' 'PercentSuccess' (obrigatório) |
| valor | O valor do limite numérico. | int Restrições: Valor mínimo = 0 (obrigatório) |
VulnerabilidadeScanningSettings
| Nome | Descrição | Valor |
|---|---|---|
| de contêinerScan | A seleção de modo para verificação de vulnerabilidade de contêiner. | 'Desabilitado' 'Habilitado' |
Definição de recurso de modelo do ARM
O tipo de recurso de clusters pode ser implantado com operações direcionadas:
- Grupos de recursos - Consulte comandos de implantação do grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Formato de recurso
Para criar um recurso Microsoft.NetworkCloud/clusters, adicione o JSON a seguir ao seu modelo.
{
"type": "Microsoft.NetworkCloud/clusters",
"apiVersion": "2026-07-01",
"name": "string",
"extendedLocation": {
"name": "string",
"type": "string"
},
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"kind": "string",
"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"
}
]
},
"analyticsOutputSettings": {
"analyticsWorkspaceId": "string",
"associatedIdentity": {
"identityType": "string",
"userAssignedIdentityResourceId": "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",
"overrides": [
{
"associatedIdentity": {
"identityType": "string",
"userAssignedIdentityResourceId": "string"
},
"commandOutputType": "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": {
"definitionUpdateMode": "string",
"enforcementLevel": "string"
},
"secretArchive": {
"keyVaultId": "string",
"useKeyVault": "string"
},
"secretArchiveSettings": {
"associatedIdentity": {
"identityType": "string",
"userAssignedIdentityResourceId": "string"
},
"vaultUri": "string"
},
"updateStrategy": {
"maxUnavailable": "int",
"strategyType": "string",
"thresholdType": "string",
"thresholdValue": "int",
"waitTimeMinutes": "int"
},
"vulnerabilityScanningSettings": {
"containerScan": "string"
}
},
"tags": {
"{customized property}": "string"
}
}
Valores da propriedade
Microsoft.NetworkCloud/clusters
| Nome | Descrição | Valor |
|---|---|---|
| apiVersion | A versão da API | '2026-07-01' |
| localização estendida | A localização estendida do recurso. Essa propriedade é necessária na criação do recurso. | AzureResourceManagerCommonTypesExtendedLocation (required) |
| identidade | As identidades de serviço gerenciadas atribuídas a esse recurso. | ManagedServiceIdentity |
| variante | O tipo (tipo) do cluster. Quando especificado, o valor deve corresponder exatamente ao tipo configurado no gerenciador de cluster que gerencia o cluster. Se for omitido, o serviço irá definir o valor padrão para o valor de tipo do gerenciador de cluster. | 'AzureLocal' 'Nexus' |
| local | A localização geográfica onde o recurso reside | cadeia de caracteres (obrigatório) |
| nome | O nome do recurso | corda Restrições: Padrão = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (obrigatório) |
| Propriedades | A lista das propriedades do recurso. | clusterProperties (obrigatório) |
| Tags | Marcas de recurso | Dicionário de nomes e valores de marca. Consulte Marcas em modelos |
| tipo | O tipo de recurso | 'Microsoft.NetworkCloud/clusters' |
Credenciais administrativas
| Nome | Descrição | Valor |
|---|---|---|
| senha | A senha do administrador do dispositivo usado durante a inicialização. | corda Restrições: Comprimento mínimo = 1 Valor confidencial. Passe como um parâmetro seguro. (obrigatório) |
| nome de usuário | O nome de usuário do administrador do dispositivo usado durante a inicialização. | corda Restrições: Comprimento mínimo = 1 (obrigatório) |
AnalyticsOutputSettings
| Nome | Descrição | Valor |
|---|---|---|
| analyticsWorkspaceId | A ID do recurso do workspace de análise que deve ser usado pela identidade especificada. | cadeia |
| identidade associada | A seleção da identidade gerenciada a ser usada com esse workspace de análise. O tipo de identidade deve ser atribuído ao sistema ou ao usuário. | identityselector |
AzureResourceManagerCommonTypesExtendedLocation
| Nome | Descrição | Valor |
|---|---|---|
| nome | O nome do local estendido. | cadeia de caracteres (obrigatório) |
| tipo | O tipo de local estendido. | 'Localização Personalizada' 'EdgeZone' (obrigatório) |
BareMetalMachineConfigurationData
Propriedades do Cluster
| Nome | Descrição | Valor |
|---|---|---|
| agregadorOuSingleRackDefinição | A definição de rack que se destina a refletir apenas um único rack em um único cluster de rack ou um rack agregador em um cluster multi-rack. | RackDefinition (obrigatório) |
| Configurações de saída de análise | As configurações do workspace do Log Analytics usadas para a saída de logs desse cluster. | AnalyticsOutputSettings |
| analyticsWorkspaceId | Campo preterido. A ID do recurso do workspace do Log Analytics que será usado para armazenar logs relevantes. | cadeia |
| localização do cluster | As informações de localização fornecidas pelo cliente para identificar onde o cluster reside. | corda Restrições: Comprimento máximo = 256 |
| clusterServicePrincipal | Campo Preterido: use a identidade gerenciada para fornecer privilégios de cluster. A entidade de serviço a ser usada pelo cluster durante a instalação do Dispositivo Arc. | ServicePrincipalInformation |
| tipo de cluster | O tipo de configuração de rack para o cluster. | 'MultiRack' 'SingleRack' (obrigatório) |
| Versão do cluster | A versão atual do runtime do cluster. | cadeia de caracteres (obrigatório) |
| commandOutputSettings | As configurações para comandos são executadas neste cluster, como a execução de máquina bare-metal somente leitura de comandos e extrações de dados. | commandOutputSettings |
| computeDeploymentThreshold | O limite de validação que indica as falhas permitidos de computadores de computação durante a validação e a implantação do ambiente. | ValidationThreshold |
| computeRackDefinitions | A lista de definições de rack para os racks de computação em um cluster de vários racks ou uma lista vazia em um cluster de rack único. | Definição de rack |
| Configuração do Grupo de Recursos Gerenciado | A configuração do grupo de recursos gerenciados associado ao recurso. | ManagedResourceGroupConfiguration |
| networkFabricId | A ID do recurso do Network Fabric associado ao cluster. | cadeia de caracteres (obrigatório) |
| runtimeProtectionConfiguration | As configurações para proteção de runtime do cluster. | RuntimeProtectionConfiguration |
| Arquivo secreto | A configuração para uso de um cofre de chaves para armazenar segredos para recuperação posterior pelo operador. | clusterSecretArchive |
| secretArchiveSettings | As configurações do arquivo secreto usado para armazenar credenciais para o cluster. | SecretArchiveSettings |
| updateStrategy | A estratégia para atualizar o cluster. | ClusterUpdateStrategy |
| vulnerabilidadeScanningSettings | As configurações de como a verificação de vulnerabilidades de segurança é aplicada ao cluster. | VulnerabilityScanningSettings |
Arquivo Secreto do Cluster
| Nome | Descrição | Valor |
|---|---|---|
| keyVaultId | A ID do recurso do cofre de chaves para arquivar os segredos do cluster. | cadeia de caracteres (obrigatório) |
| useKeyVault | O indicador se o cofre de chaves especificado deve ser usado para arquivar os segredos do cluster. | Falso 'Verdade' |
Estratégia de atualização de cluster
| Nome | Descrição | Valor |
|---|---|---|
| maxIndisponível | O número máximo de nós de trabalho que podem estar offline dentro do incremento da atualização, por exemplo, rack por rack. Limitado pelo número máximo de computadores no incremento. O padrão é todo o tamanho de incremento. | int Restrições: Valor mínimo = 1 |
| tipo de estratégia | O modo de operação para proteção de runtime. | 'PauseAfterRack' 'Rack' (obrigatório) |
| tipo de limite | Seleção de como o limite deve ser avaliado. | 'ContarSucesso' 'PercentSuccess' (obrigatório) |
| valor limite | O valor do limite numérico. | int Restrições: Valor mínimo = 0 (obrigatório) |
| waitTimeMinutes | O tempo de espera entre os incrementos de atualização definidos pela estratégia. | int Restrições: Valor mínimo = 0 Valor máximo = 60 |
CommandOutputOverride
| Nome | Descrição | Valor |
|---|---|---|
| identidade associada | A seleção da identidade gerenciada a ser usada com esse contêiner de conta de armazenamento. O tipo de identidade deve ser atribuído ao sistema ou ao usuário. | identityselector |
| commandOutputType | O tipo de saída de comando para a substituição. | 'BareMetalMachineRunCommand' 'BareMetalMachineRunDataExtracts' 'BareMetalMachineRunDataExtractsRestricted' 'BareMetalMachineRunReadCommands' 'AçõesAdministrativasDe Suporte ao Cluster' 'StorageRunReadCommands' |
| containerUrl | A URL do contêiner da conta de armazenamento que deve ser usada pelas identidades especificadas. | cadeia |
CommandOutputSettings
| Nome | Descrição | Valor |
|---|---|---|
| identidade associada | A seleção da identidade gerenciada a ser usada com esse contêiner de conta de armazenamento. O tipo de identidade deve ser atribuído ao sistema ou ao usuário. | identityselector |
| containerUrl | A URL do contêiner da conta de armazenamento que deve ser usada pelas identidades especificadas. | cadeia |
| substituições | A lista de substituições opcionais que permitem a associação de contêineres de armazenamento e identidades a tipos específicos de saída de comando. Se um tipo não for substituído, a identidade padrão e o contêiner de armazenamento serão utilizados. | CommandOutputOverride[] |
IdentitySelector
| Nome | Descrição | Valor |
|---|---|---|
| tipo de identidade | O tipo de identidade gerenciada que está sendo selecionado. | 'SystemAssignedIdentity' 'UserAssignedIdentity' |
| userAssignedIdentityResourceId | A ID do recurso de identidade gerenciada atribuída pelo usuário a ser usada. Mutuamente exclusivo com um tipo de identidade atribuído pelo sistema. | cadeia |
Configuração do Grupo de Recursos Gerenciados
| Nome | Descrição | Valor |
|---|---|---|
| local | O local do grupo de recursos gerenciados. Se não for especificado, o local do recurso pai será escolhido. | cadeia |
| nome | O nome do grupo de recursos gerenciado. Se não for especificado, o nome exclusivo será gerado automaticamente. | corda Restrições: Comprimento máximo = 75 |
ManagedServiceIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos). | 'Nenhum' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obrigatório) |
| Identidades Atribuídas pelo Usuário | O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Nome | Descrição | Valor |
|---|
Definição de rack
| Nome | Descrição | Valor |
|---|---|---|
| Zona de disponibilidade | O nome da zona usado para este rack quando criado. As zonas de disponibilidade são usadas para o posicionamento da carga de trabalho. | corda Restrições: Padrão = ^[a-zA-Z0-9]{1,10}$ |
| bareMetalMachineConfigurationData | A lista não ordenada da configuração da máquina bare-metal. | BareMetalMachineConfigurationData |
| networkRackId | A ID do recurso do rack de rede que corresponde a essa definição de rack. | cadeia de caracteres (obrigatório) |
| localização do rack | A descrição de forma livre da localização do rack. | corda Restrições: Comprimento máximo = 256 |
| rackNúmero de série | O identificador exclusivo do rack no cluster de Nuvem de Rede. Um valor alfanumérico exclusivo alternativo diferente de um número de série poderá ser fornecido, se desejado. | corda Restrições: Comprimento mínimo = 1 Comprimento máximo = 64 (obrigatório) |
| rackSkuId | A ID do recurso do sku para o rack que está sendo adicionado. | cadeia de caracteres (obrigatório) |
| storageApplianceConfigurationData | A lista de dados de configuração do dispositivo de armazenamento para este rack. | StorageApplianceConfigurationData [] |
RuntimeProtectionConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| definitionUpdateMode | O modo de atualização de definição para proteção em tempo de execução. | 'Automático' 'Nenhum' |
| nível de imposição | O modo de operação para proteção de runtime. | 'Auditoria' 'Desabilitado' 'Sob demanda' 'Passivo' 'Tempo real' |
Configurações de arquivo secreto
| Nome | Descrição | Valor |
|---|---|---|
| identidade associada | A seleção da identidade gerenciada a ser usada com esse URI do cofre. O tipo de identidade deve ser atribuído ao sistema ou ao usuário. | identityselector |
| vaultUri | O URI do cofre de chaves usado como o arquivo secreto. | cadeia |
ServicePrincipalInformation
| Nome | Descrição | Valor |
|---|---|---|
| ID do aplicativo | A ID do aplicativo, também conhecida como ID do cliente, da entidade de serviço. | cadeia de caracteres (obrigatório) |
| senha | A senha da entidade de serviço. | corda Restrições: Valor confidencial. Passe como um parâmetro seguro. (obrigatório) |
| principalId | A ID da entidade de segurança, também conhecida como ID do objeto, da entidade de serviço. | cadeia de caracteres (obrigatório) |
| ID do inquilino | A ID do locatário, também conhecida como ID do diretório, do locatário no qual a entidade de serviço é criada. | cadeia de caracteres (obrigatório) |
StorageApplianceConfigurationData
TrackedResourceTags
| Nome | Descrição | Valor |
|---|
UserAssignedIdentity
| Nome | Descrição | Valor |
|---|
Limite de validação
| Nome | Descrição | Valor |
|---|---|---|
| agrupamento | Seleção de como a avaliação de tipo é aplicada ao cálculo do cluster. | 'PerCluster' 'PerRack' (obrigatório) |
| tipo | Seleção de como o limite deve ser avaliado. | 'ContarSucesso' 'PercentSuccess' (obrigatório) |
| valor | O valor do limite numérico. | int Restrições: Valor mínimo = 0 (obrigatório) |
VulnerabilidadeScanningSettings
| Nome | Descrição | Valor |
|---|---|---|
| de contêinerScan | A seleção de modo para verificação de vulnerabilidade de contêiner. | 'Desabilitado' 'Habilitado' |
Exemplos de uso
Definição de recurso do Terraform (provedor de AzAPI)
O tipo de recurso de clusters pode ser implantado com operações direcionadas:
- Grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Formato de recurso
Para criar um recurso Microsoft.NetworkCloud/clusters, adicione o Terraform a seguir ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.NetworkCloud/clusters@2026-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"
}
kind = "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"
}
]
}
analyticsOutputSettings = {
analyticsWorkspaceId = "string"
associatedIdentity = {
identityType = "string"
userAssignedIdentityResourceId = "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"
overrides = [
{
associatedIdentity = {
identityType = "string"
userAssignedIdentityResourceId = "string"
}
commandOutputType = "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 = {
definitionUpdateMode = "string"
enforcementLevel = "string"
}
secretArchive = {
keyVaultId = "string"
useKeyVault = "string"
}
secretArchiveSettings = {
associatedIdentity = {
identityType = "string"
userAssignedIdentityResourceId = "string"
}
vaultUri = "string"
}
updateStrategy = {
maxUnavailable = int
strategyType = "string"
thresholdType = "string"
thresholdValue = int
waitTimeMinutes = int
}
vulnerabilityScanningSettings = {
containerScan = "string"
}
}
}
}
Valores da propriedade
Microsoft.NetworkCloud/clusters
| Nome | Descrição | Valor |
|---|---|---|
| localização estendida | A localização estendida do recurso. Essa propriedade é necessária na criação do recurso. | AzureResourceManagerCommonTypesExtendedLocation (required) |
| identidade | As identidades de serviço gerenciadas atribuídas a esse recurso. | ManagedServiceIdentity |
| variante | O tipo (tipo) do cluster. Quando especificado, o valor deve corresponder exatamente ao tipo configurado no gerenciador de cluster que gerencia o cluster. Se for omitido, o serviço irá definir o valor padrão para o valor de tipo do gerenciador de cluster. | 'AzureLocal' 'Nexus' |
| local | A localização geográfica onde o recurso reside | cadeia de caracteres (obrigatório) |
| nome | O nome do recurso | corda Restrições: Padrão = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (obrigatório) |
| Propriedades | A lista das propriedades do recurso. | clusterProperties (obrigatório) |
| Tags | Marcas de recurso | Dicionário de nomes e valores de marca. |
| tipo | O tipo de recurso | "Microsoft. NetworkCloud/clusters@2026-07-01" |
Credenciais administrativas
| Nome | Descrição | Valor |
|---|---|---|
| senha | A senha do administrador do dispositivo usado durante a inicialização. | corda Restrições: Comprimento mínimo = 1 Valor confidencial. Passe como um parâmetro seguro. (obrigatório) |
| nome de usuário | O nome de usuário do administrador do dispositivo usado durante a inicialização. | corda Restrições: Comprimento mínimo = 1 (obrigatório) |
AnalyticsOutputSettings
| Nome | Descrição | Valor |
|---|---|---|
| analyticsWorkspaceId | A ID do recurso do workspace de análise que deve ser usado pela identidade especificada. | cadeia |
| identidade associada | A seleção da identidade gerenciada a ser usada com esse workspace de análise. O tipo de identidade deve ser atribuído ao sistema ou ao usuário. | identityselector |
AzureResourceManagerCommonTypesExtendedLocation
| Nome | Descrição | Valor |
|---|---|---|
| nome | O nome do local estendido. | cadeia de caracteres (obrigatório) |
| tipo | O tipo de local estendido. | 'Localização Personalizada' 'EdgeZone' (obrigatório) |
BareMetalMachineConfigurationData
Propriedades do Cluster
| Nome | Descrição | Valor |
|---|---|---|
| agregadorOuSingleRackDefinição | A definição de rack que se destina a refletir apenas um único rack em um único cluster de rack ou um rack agregador em um cluster multi-rack. | RackDefinition (obrigatório) |
| Configurações de saída de análise | As configurações do workspace do Log Analytics usadas para a saída de logs desse cluster. | AnalyticsOutputSettings |
| analyticsWorkspaceId | Campo preterido. A ID do recurso do workspace do Log Analytics que será usado para armazenar logs relevantes. | cadeia |
| localização do cluster | As informações de localização fornecidas pelo cliente para identificar onde o cluster reside. | corda Restrições: Comprimento máximo = 256 |
| clusterServicePrincipal | Campo Preterido: use a identidade gerenciada para fornecer privilégios de cluster. A entidade de serviço a ser usada pelo cluster durante a instalação do Dispositivo Arc. | ServicePrincipalInformation |
| tipo de cluster | O tipo de configuração de rack para o cluster. | 'MultiRack' 'SingleRack' (obrigatório) |
| Versão do cluster | A versão atual do runtime do cluster. | cadeia de caracteres (obrigatório) |
| commandOutputSettings | As configurações para comandos são executadas neste cluster, como a execução de máquina bare-metal somente leitura de comandos e extrações de dados. | commandOutputSettings |
| computeDeploymentThreshold | O limite de validação que indica as falhas permitidos de computadores de computação durante a validação e a implantação do ambiente. | ValidationThreshold |
| computeRackDefinitions | A lista de definições de rack para os racks de computação em um cluster de vários racks ou uma lista vazia em um cluster de rack único. | Definição de rack |
| Configuração do Grupo de Recursos Gerenciado | A configuração do grupo de recursos gerenciados associado ao recurso. | ManagedResourceGroupConfiguration |
| networkFabricId | A ID do recurso do Network Fabric associado ao cluster. | cadeia de caracteres (obrigatório) |
| runtimeProtectionConfiguration | As configurações para proteção de runtime do cluster. | RuntimeProtectionConfiguration |
| Arquivo secreto | A configuração para uso de um cofre de chaves para armazenar segredos para recuperação posterior pelo operador. | clusterSecretArchive |
| secretArchiveSettings | As configurações do arquivo secreto usado para armazenar credenciais para o cluster. | SecretArchiveSettings |
| updateStrategy | A estratégia para atualizar o cluster. | ClusterUpdateStrategy |
| vulnerabilidadeScanningSettings | As configurações de como a verificação de vulnerabilidades de segurança é aplicada ao cluster. | VulnerabilityScanningSettings |
Arquivo Secreto do Cluster
| Nome | Descrição | Valor |
|---|---|---|
| keyVaultId | A ID do recurso do cofre de chaves para arquivar os segredos do cluster. | cadeia de caracteres (obrigatório) |
| useKeyVault | O indicador se o cofre de chaves especificado deve ser usado para arquivar os segredos do cluster. | Falso 'Verdade' |
Estratégia de atualização de cluster
| Nome | Descrição | Valor |
|---|---|---|
| maxIndisponível | O número máximo de nós de trabalho que podem estar offline dentro do incremento da atualização, por exemplo, rack por rack. Limitado pelo número máximo de computadores no incremento. O padrão é todo o tamanho de incremento. | int Restrições: Valor mínimo = 1 |
| tipo de estratégia | O modo de operação para proteção de runtime. | 'PauseAfterRack' 'Rack' (obrigatório) |
| tipo de limite | Seleção de como o limite deve ser avaliado. | 'ContarSucesso' 'PercentSuccess' (obrigatório) |
| valor limite | O valor do limite numérico. | int Restrições: Valor mínimo = 0 (obrigatório) |
| waitTimeMinutes | O tempo de espera entre os incrementos de atualização definidos pela estratégia. | int Restrições: Valor mínimo = 0 Valor máximo = 60 |
CommandOutputOverride
| Nome | Descrição | Valor |
|---|---|---|
| identidade associada | A seleção da identidade gerenciada a ser usada com esse contêiner de conta de armazenamento. O tipo de identidade deve ser atribuído ao sistema ou ao usuário. | identityselector |
| commandOutputType | O tipo de saída de comando para a substituição. | 'BareMetalMachineRunCommand' 'BareMetalMachineRunDataExtracts' 'BareMetalMachineRunDataExtractsRestricted' 'BareMetalMachineRunReadCommands' 'AçõesAdministrativasDe Suporte ao Cluster' 'StorageRunReadCommands' |
| containerUrl | A URL do contêiner da conta de armazenamento que deve ser usada pelas identidades especificadas. | cadeia |
CommandOutputSettings
| Nome | Descrição | Valor |
|---|---|---|
| identidade associada | A seleção da identidade gerenciada a ser usada com esse contêiner de conta de armazenamento. O tipo de identidade deve ser atribuído ao sistema ou ao usuário. | identityselector |
| containerUrl | A URL do contêiner da conta de armazenamento que deve ser usada pelas identidades especificadas. | cadeia |
| substituições | A lista de substituições opcionais que permitem a associação de contêineres de armazenamento e identidades a tipos específicos de saída de comando. Se um tipo não for substituído, a identidade padrão e o contêiner de armazenamento serão utilizados. | CommandOutputOverride[] |
IdentitySelector
| Nome | Descrição | Valor |
|---|---|---|
| tipo de identidade | O tipo de identidade gerenciada que está sendo selecionado. | 'SystemAssignedIdentity' 'UserAssignedIdentity' |
| userAssignedIdentityResourceId | A ID do recurso de identidade gerenciada atribuída pelo usuário a ser usada. Mutuamente exclusivo com um tipo de identidade atribuído pelo sistema. | cadeia |
Configuração do Grupo de Recursos Gerenciados
| Nome | Descrição | Valor |
|---|---|---|
| local | O local do grupo de recursos gerenciados. Se não for especificado, o local do recurso pai será escolhido. | cadeia |
| nome | O nome do grupo de recursos gerenciado. Se não for especificado, o nome exclusivo será gerado automaticamente. | corda Restrições: Comprimento máximo = 75 |
ManagedServiceIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos). | 'Nenhum' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obrigatório) |
| Identidades Atribuídas pelo Usuário | O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Nome | Descrição | Valor |
|---|
Definição de rack
| Nome | Descrição | Valor |
|---|---|---|
| Zona de disponibilidade | O nome da zona usado para este rack quando criado. As zonas de disponibilidade são usadas para o posicionamento da carga de trabalho. | corda Restrições: Padrão = ^[a-zA-Z0-9]{1,10}$ |
| bareMetalMachineConfigurationData | A lista não ordenada da configuração da máquina bare-metal. | BareMetalMachineConfigurationData |
| networkRackId | A ID do recurso do rack de rede que corresponde a essa definição de rack. | cadeia de caracteres (obrigatório) |
| localização do rack | A descrição de forma livre da localização do rack. | corda Restrições: Comprimento máximo = 256 |
| rackNúmero de série | O identificador exclusivo do rack no cluster de Nuvem de Rede. Um valor alfanumérico exclusivo alternativo diferente de um número de série poderá ser fornecido, se desejado. | corda Restrições: Comprimento mínimo = 1 Comprimento máximo = 64 (obrigatório) |
| rackSkuId | A ID do recurso do sku para o rack que está sendo adicionado. | cadeia de caracteres (obrigatório) |
| storageApplianceConfigurationData | A lista de dados de configuração do dispositivo de armazenamento para este rack. | StorageApplianceConfigurationData [] |
RuntimeProtectionConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| definitionUpdateMode | O modo de atualização de definição para proteção em tempo de execução. | 'Automático' 'Nenhum' |
| nível de imposição | O modo de operação para proteção de runtime. | 'Auditoria' 'Desabilitado' 'Sob demanda' 'Passivo' 'Tempo real' |
Configurações de arquivo secreto
| Nome | Descrição | Valor |
|---|---|---|
| identidade associada | A seleção da identidade gerenciada a ser usada com esse URI do cofre. O tipo de identidade deve ser atribuído ao sistema ou ao usuário. | identityselector |
| vaultUri | O URI do cofre de chaves usado como o arquivo secreto. | cadeia |
ServicePrincipalInformation
| Nome | Descrição | Valor |
|---|---|---|
| ID do aplicativo | A ID do aplicativo, também conhecida como ID do cliente, da entidade de serviço. | cadeia de caracteres (obrigatório) |
| senha | A senha da entidade de serviço. | corda Restrições: Valor confidencial. Passe como um parâmetro seguro. (obrigatório) |
| principalId | A ID da entidade de segurança, também conhecida como ID do objeto, da entidade de serviço. | cadeia de caracteres (obrigatório) |
| ID do inquilino | A ID do locatário, também conhecida como ID do diretório, do locatário no qual a entidade de serviço é criada. | cadeia de caracteres (obrigatório) |
StorageApplianceConfigurationData
TrackedResourceTags
| Nome | Descrição | Valor |
|---|
UserAssignedIdentity
| Nome | Descrição | Valor |
|---|
Limite de validação
| Nome | Descrição | Valor |
|---|---|---|
| agrupamento | Seleção de como a avaliação de tipo é aplicada ao cálculo do cluster. | 'PerCluster' 'PerRack' (obrigatório) |
| tipo | Seleção de como o limite deve ser avaliado. | 'ContarSucesso' 'PercentSuccess' (obrigatório) |
| valor | O valor do limite numérico. | int Restrições: Valor mínimo = 0 (obrigatório) |
VulnerabilidadeScanningSettings
| Nome | Descrição | Valor |
|---|---|---|
| de contêinerScan | A seleção de modo para verificação de vulnerabilidade de contêiner. | 'Desabilitado' 'Habilitado' |