Clusters Microsoft.ServiceFabric

Definição de recurso 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.ServiceFabric/clusters, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.ServiceFabric/clusters@2026-03-01-preview' = {
  location: 'string'
  name: 'string'
  properties: {
    addOnFeatures: [
      'string'
    ]
    applicationTypeVersionsCleanupPolicy: {
      maxUnusedVersionsToKeep: int
    }
    azureActiveDirectory: {
      clientApplication: 'string'
      clusterApplication: 'string'
      tenantId: 'string'
    }
    certificate: {
      thumbprint: 'string'
      thumbprintSecondary: 'string'
      x509StoreName: 'string'
    }
    certificateCommonNames: {
      commonNames: [
        {
          certificateCommonName: 'string'
          certificateIssuerThumbprint: 'string'
        }
      ]
      x509StoreName: 'string'
    }
    clientCertificateCommonNames: [
      {
        certificateCommonName: 'string'
        certificateIssuerThumbprint: 'string'
        isAdmin: bool
      }
    ]
    clientCertificateThumbprints: [
      {
        certificateThumbprint: 'string'
        isAdmin: bool
      }
    ]
    clusterCodeVersion: 'string'
    diagnosticsStorageAccountConfig: {
      blobEndpoint: 'string'
      protectedAccountKeyName: 'string'
      protectedAccountKeyName2: 'string'
      queueEndpoint: 'string'
      storageAccountName: 'string'
      tableEndpoint: 'string'
    }
    enableHttpGatewayExclusiveAuthMode: bool
    eventStoreServiceEnabled: bool
    fabricSettings: [
      {
        name: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
      }
    ]
    infrastructureServiceManager: bool
    managementEndpoint: 'string'
    nodeTypes: [
      {
        applicationPorts: {
          endPort: int
          startPort: int
        }
        capacities: {
          {customized property}: 'string'
        }
        clientConnectionEndpointPort: int
        durabilityLevel: 'string'
        ephemeralPorts: {
          endPort: int
          startPort: int
        }
        httpGatewayEndpointPort: int
        httpGatewayTokenAuthEndpointPort: int
        isPrimary: bool
        isStateless: bool
        multipleAvailabilityZones: bool
        name: 'string'
        placementProperties: {
          {customized property}: 'string'
        }
        reverseProxyEndpointPort: int
        vmInstanceCount: int
      }
    ]
    notifications: [
      {
        isEnabled: bool
        notificationCategory: 'string'
        notificationLevel: 'string'
        notificationTargets: [
          {
            notificationChannel: 'string'
            receivers: [
              'string'
            ]
          }
        ]
      }
    ]
    reliabilityLevel: 'string'
    reverseProxyCertificate: {
      thumbprint: 'string'
      thumbprintSecondary: 'string'
      x509StoreName: 'string'
    }
    reverseProxyCertificateCommonNames: {
      commonNames: [
        {
          certificateCommonName: 'string'
          certificateIssuerThumbprint: 'string'
        }
      ]
      x509StoreName: 'string'
    }
    sfZonalUpgradeMode: 'string'
    upgradeDescription: {
      deltaHealthPolicy: {
        applicationDeltaHealthPolicies: {
          {customized property}: {
            defaultServiceTypeDeltaHealthPolicy: {
              maxPercentDeltaUnhealthyServices: int
            }
            serviceTypeDeltaHealthPolicies: {
              {customized property}: {
                maxPercentDeltaUnhealthyServices: int
              }
            }
          }
        }
        maxPercentDeltaUnhealthyApplications: int
        maxPercentDeltaUnhealthyNodes: int
        maxPercentUpgradeDomainDeltaUnhealthyNodes: int
      }
      forceRestart: bool
      healthCheckRetryTimeout: 'string'
      healthCheckStableDuration: 'string'
      healthCheckWaitDuration: 'string'
      healthPolicy: {
        applicationHealthPolicies: {
          {customized property}: {
            defaultServiceTypeHealthPolicy: {
              maxPercentUnhealthyServices: int
            }
            serviceTypeHealthPolicies: {
              {customized property}: {
                maxPercentUnhealthyServices: int
              }
            }
          }
        }
        maxPercentUnhealthyApplications: int
        maxPercentUnhealthyNodes: int
      }
      upgradeDomainTimeout: 'string'
      upgradeReplicaSetCheckTimeout: 'string'
      upgradeTimeout: 'string'
    }
    upgradeMode: 'string'
    upgradePauseEndTimestampUtc: 'string'
    upgradePauseStartTimestampUtc: 'string'
    upgradeWave: 'string'
    vmImage: 'string'
    vmssZonalUpgradeMode: 'string'
    waveUpgradePaused: bool
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

Microsoft.ServiceFabric/clusters

Nome	Descrição	Valor
local	A localização geográfica onde o recurso reside	cadeia de caracteres (obrigatório)
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	As propriedades do recurso do cluster	clusterProperties
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos

AplicaçãoDeltaHealthPolicy

Nome	Descrição	Valor
defaultServiceTypeDeltaHealthPolicy	A política de integridade delta usada por padrão para avaliar a integridade de um tipo de serviço ao atualizar o cluster.	ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies	O mapa com o tipo de serviço de política de integridade delta por nome de tipo de serviço. O mapa está vazio por padrão.	AplicaçãoDeltaPolíticaSaúdeTipoDeltaPolíticaSaúdePolíticas

AplicaçãoDeltaPolíticaSaúdeTipoDeltaPolíticaSaúdePolíticas

Nome	Descrição	Valor

Política de Integridade do Aplicativo

Nome	Descrição	Valor
defaultServiceTypeHealthPolicy	A política de integridade usada por padrão para avaliar a integridade de um tipo de serviço.	ServiceTypeHealthPolicy
serviceTypeHealthPolicies	O mapa com a política de integridade do tipo de serviço por nome de tipo de serviço. O mapa está vazio por padrão.	AplicaçãoPolíticaSaúdeTipoServiçoPolíticas de Saúde

AplicaçãoPolíticaSaúdeTipoServiçoPolíticas de Saúde

Nome	Descrição	Valor

ApplicationTypeVersionsCleanupPolicy

Nome	Descrição	Valor
maxUnusedVersionsToKeep	Número de versões não utilizados por tipo de aplicativo a serem mantidas.	int Restrições: Valor mínimo = 0 (obrigatório)

AzureActiveDirectory

Nome	Descrição	Valor
Aplicativo cliente	ID de aplicação do cliente do Azure Active Directory.	cadeia
clusterAplicativo	ID de aplicação do cluster do Azure Active Directory.	cadeia
ID do inquilino	Azure Active Directory tenant ID.	cadeia

Descrição do certificado

Nome	Descrição	Valor
impressão digital	Impressão digital do certificado primário.	cadeia de caracteres (obrigatório)
impressão digitalSecundário	Impressão digital do certificado secundário.	cadeia
x509NomedaLoja	O local do repositório de certificados local.	'Catálogo de endereços' 'AuthRoot' 'Autoridade de Certificação' 'Não permitido' 'Meu' 'Raiz' 'Pessoas confiáveis' 'Editor confiável'

ClientCertificateCommonName

Nome	Descrição	Valor
certificadoNomeComum	O nome comum do certificado do cliente.	cadeia de caracteres (obrigatório)
certificadoEmissorImpressão digital	A impressão digital do emissor do certificado do cliente.	cadeia de caracteres (obrigatório)
isAdmin	Indica se o certificado do cliente tem acesso de administrador ao cluster. Clientes não administradores só podem executar operações somente leitura no cluster.	bool (obrigatório)

ClientCertificateThumbprint

Nome	Descrição	Valor
certificadoImpressão digital	A impressão digital do certificado do cliente.	cadeia de caracteres (obrigatório)
isAdmin	Indica se o certificado do cliente tem acesso de administrador ao cluster. Clientes não administradores só podem executar operações somente leitura no cluster.	bool (obrigatório)

Política de Integridade do Cluster

Nome	Descrição	Valor
applicationHealthPolicies	Define o mapa da política de integridade do aplicativo usado para avaliar a integridade de um aplicativo ou de uma de suas entidades filho.	ClusterPolíticaSaúdeAplicaçãoPolíticas de Saúde
maxPercentUnhealthyApplications	O percentual máximo permitido de aplicativos não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% de aplicativos não estejam íntegros, esse valor seria 10. O percentual representa o percentual máximo tolerado de aplicativos que podem não estar íntegros antes que o cluster seja considerado erro. Se o percentual for respeitado, mas houver pelo menos um aplicativo não íntegro, a integridade será avaliada como Aviso. Isso é calculado dividindo o número de aplicativos não íntegros sobre o número total de instâncias de aplicativo no cluster, excluindo aplicativos de tipos de aplicativo incluídos no ApplicationTypeHealthPolicyMap. A computação arredonda para tolerar uma falha em um pequeno número de aplicativos. O percentual padrão é zero.	int Restrições: Valor mínimo = 0 Valor máximo = 100
maxPercentUnhealthyNodes	O percentual máximo permitido de nós não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% de nós não estejam íntegros, esse valor seria 10. O percentual representa o percentual máximo tolerado de nós que podem não estar íntegros antes que o cluster seja considerado em erro. Se o percentual for respeitado, mas houver pelo menos um nó não íntegro, a integridade será avaliada como Aviso. O percentual é calculado dividindo o número de nós não íntegros sobre o número total de nós no cluster. A computação é arredondada para tolerar uma falha em um pequeno número de nós. O percentual padrão é zero. Em clusters grandes, alguns nós sempre estarão inativos ou sem reparos, portanto, esse percentual deve ser configurado para tolerar isso.	int Restrições: Valor mínimo = 0 Valor máximo = 100

ClusterPolíticaSaúdeAplicaçãoPolíticas de Saúde

Nome	Descrição	Valor

Propriedades do Cluster

Nome	Descrição	Valor
addOnFeatures	A lista de recursos de complemento a serem habilitados no cluster.	Matriz de cadeia de caracteres que contém qualquer um dos: 'BackupRestoreService' 'DnsService' 'Gerenciador de reparos' 'ResourceMonitorService'
applicationTypeVersionsCleanupPolicy	A política usada para limpar versões não utilizadas.	ApplicationTypeVersionsCleanupPolicy
azureActiveDirectory	As configurações de autenticação do AAD do cluster.	do AzureActiveDirectory
certificado	O certificado a ser usado para proteger o cluster. O certificado fornecido será usado para a segurança do nó para nó dentro do cluster, certificado SSL para o ponto de extremidade de gerenciamento de cluster e o cliente de administrador padrão.	CertificateDescription
certificateCommonNames	Descreve uma lista de certificados de servidor referenciados pelo nome comum que são usados para proteger o cluster.	serverCertificateCommonNames
clientCertificateCommonNames	A lista de certificados de cliente referenciados por nome comum que têm permissão para gerenciar o cluster.	ClientCertificateCommonName[]
clientCertificateThumbprints	A lista de certificados de cliente referenciados pela impressão digital que têm permissão para gerenciar o cluster.	ClientCertificateThumbprint []
clusterCodeVersion	A versão de runtime do Service Fabric do cluster. Essa propriedade só pode definir o usuário quando upgradeMode estiver definido como "Manual". Para obter uma lista das versões disponíveis do Service Fabric para novos clusters, use da API do ClusterVersion. Para obter a lista de versões disponíveis para clusters existentes, use ClusterVersions disponíveis.	cadeia
diagnosticsStorageAccountConfig	As informações da conta de armazenamento para armazenar logs de diagnóstico do Service Fabric.	DiagnosticsStorageAccountConfig
enableHttpGatewayExclusiveAuthMode	Se for true, a autenticação baseada em token não será permitida no HttpGatewayEndpoint. Isso é necessário para dar suporte às versões 1.3 e superiores do TLS. Se a autenticação baseada em token for usada, HttpGatewayTokenAuthEndpointPort deverá ser definido.	Bool
eventStoreServiceEnabled	Indica se o serviço de repositório de eventos está habilitado.	Bool
configurações de tecido	A lista de configurações de malha personalizadas para definir o cluster.	SettingsSectionDescription[]
Gerenciador de Serviços de infraestrutura	Indica se o gerenciador de serviços de infraestrutura está habilitado.	Bool
gerenciamentoPonto de extremidade	O ponto de extremidade de gerenciamento http do cluster.	cadeia de caracteres (obrigatório)
nodeTypes	A lista de tipos de nó no cluster.	NodeTypeDescription [] (obrigatório)
Notificações	Indica uma lista de canais de notificação para eventos de cluster.	de notificação []
nível de confiabilidade	O nível de confiabilidade define o tamanho do conjunto de réplicas dos serviços do sistema. Saiba mais sobre ReliabilityLevel. - Nenhum - Execute os serviços do Sistema com uma contagem de conjunto de réplicas de destino de 1. Isso só deve ser usado para clusters de teste. – Bronze – Execute os serviços do Sistema com uma contagem de conjunto de réplicas de destino de 3. Isso só deve ser usado para clusters de teste. - Silver - Execute os serviços do Sistema com uma contagem de conjunto de réplicas de destino de 5. – Ouro – Execute os serviços do Sistema com uma contagem de conjunto de réplicas de destino de 7. - Platinum - Execute os serviços do Sistema com uma contagem de conjunto de réplicas de destino de 9.	'Bronze' 'Ouro' 'Nenhum' 'Platina' 'Prata'
reverseProxyCertificate	O certificado do servidor usado pelo proxy reverso.	CertificateDescription
reverseProxyCertificateCommonNames	Descreve uma lista de certificados de servidor referenciados pelo nome comum que são usados para proteger o cluster.	serverCertificateCommonNames
sfZonalUpgradeMode	Essa propriedade controla o agrupamento lógico de VMs em domínios de atualização (UDs). Essa propriedade não pode ser modificada se um tipo de nó com múltiplas Availability Zones já estiver presente no cluster.	'Hierárquico' 'Paralelo'
descrição da atualização	A política a ser usada ao atualizar o cluster.	ClusterUpgradePolicy
Modo de atualização	O modo de atualização do cluster quando a nova versão de runtime do Service Fabric estiver disponível.	'Automático' 'Manual'
upgradePauseEndTimestampUtc	Indica a data e a hora de término para pausar atualizações automáticas de versão de runtime no cluster por um período específico no cluster (UTC).	cadeia
upgradePauseStartTimestampUtc	Indica a data e a hora de início para pausar atualizações automáticas de versão de runtime no cluster por um período específico no cluster (UTC).	cadeia
Onda de atualização	Indica quando as novas atualizações de versão do runtime do cluster serão aplicadas após a liberação. Por padrão, é Wave0. Aplica-se somente quando upgradeMode é definido como 'Automático'.	'Onda0' 'Onda 1' 'Onda 2'
vmImagem	A VMSS de imagem da VM foi configurada. Nomes genéricos como Windows ou Linux podem ser usados.	cadeia
vmssZonalUpgradeMode	Essa propriedade define o modo de atualização para o conjunto de escalas da máquina virtual, sendo obrigatória se um tipo de nó com múltiplas Availability Zones for adicionado.	'Hierárquico' 'Paralelo'
waveUpgradePaused	Booliano para pausar atualizações automáticas de versão de runtime para o cluster.	Bool

ClusterUpgradeDeltaHealthPolicy

Nome	Descrição	Valor
applicationDeltaHealthPolicies	Define o mapa da política de integridade delta do aplicativo usado para avaliar a integridade de um aplicativo ou de uma de suas entidades filho ao atualizar o cluster.	ClusterUpgradeDeltaSaúdePolíticaDeltaPolíticaSaúdePolíticas
maxPercentDeltaUnhealthyApplications	O percentual máximo permitido de degradação da integridade dos aplicativos permitido durante as atualizações de cluster. O delta é medido entre o estado dos aplicativos no início da atualização e o estado dos aplicativos no momento da avaliação de integridade. A verificação é executada após cada conclusão da atualização do domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados. Os serviços do sistema não estão incluídos nisso.	int Restrições: Valor mínimo = 0 Valor máximo = 100 (obrigatório)
maxPercentDeltaUnhealthyNodes	O percentual máximo permitido de degradação da integridade dos nós permitido durante as atualizações do cluster. O delta é medido entre o estado dos nós no início da atualização e o estado dos nós no momento da avaliação da integridade. A verificação é executada após cada conclusão da atualização do domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados.	int Restrições: Valor mínimo = 0 Valor máximo = 100 (obrigatório)
maxPercentUpgradeDomainDeltaUnhealthyNodes	A porcentagem máxima permitida de degradação da integridade dos nós de domínio de atualização permitida durante as atualizações de cluster. O delta é medido entre o estado dos nós de domínio de atualização no início da atualização e o estado dos nós de domínio de atualização no momento da avaliação da integridade. A verificação é executada após cada conclusão da atualização do domínio de atualização para todos os domínios de atualização concluídos para garantir que o estado dos domínios de atualização esteja dentro dos limites tolerados.	int Restrições: Valor mínimo = 0 Valor máximo = 100 (obrigatório)

ClusterUpgradeDeltaSaúdePolíticaDeltaPolíticaSaúdePolíticas

Nome	Descrição	Valor

Política de atualização de cluster

Nome	Descrição	Valor
Política de Saúde delta	A política de integridade delta do cluster usada ao atualizar o cluster.	ClusterUpgradeDeltaHealthPolicy
forceRestart	Se for true, os processos serão reiniciados com força durante a atualização mesmo quando a versão do código não tiver sido alterada (a atualização altera apenas a configuração ou os dados).	Bool
healthCheckRetryTimeout	A quantidade de tempo para tentar novamente a avaliação de integridade quando o aplicativo ou cluster não estiver íntegro antes que a atualização volte. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)
healthCheckStableDuration	A quantidade de tempo que o aplicativo ou cluster deve permanecer íntegro antes que a atualização prossiga para o próximo domínio de atualização. A duração pode estar em hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)
healthCheckWaitDuration	O período de espera após a conclusão de um domínio de atualização antes de executar verificações de integridade. A duração pode estar em hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)
Política de Saúde	A política de integridade do cluster usada ao atualizar o cluster.	ClusterHealthPolicy (obrigatório)
upgradeDomainTimeout	A quantidade de tempo que cada domínio de atualização precisa concluir antes que a atualização reverta. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)
upgradeReplicaSetCheckTimeout	O tempo máximo para bloquear o processamento de um domínio de atualização e evitar a perda de disponibilidade quando houver problemas inesperados. Quando esse tempo limite expirar, o processamento do domínio de atualização continuará independentemente dos problemas de perda de disponibilidade. O tempo limite é redefinido no início de cada domínio de atualização. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)
upgradeTimeout	A quantidade de tempo que a atualização geral precisa ser concluída antes que a atualização reverta. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)

DiagnosticsStorageAccountConfig

Nome	Descrição	Valor
blobEndpoint	O ponto de extremidade de blob da conta de armazenamento do Azure.	cadeia de caracteres (obrigatório)
protectedAccountKeyName	O nome da chave de armazenamento de diagnóstico protegido.	cadeia de caracteres (obrigatório)
protectedAccountKeyName2	O nome da chave de armazenamento de diagnóstico protegido secundário. Se uma das chaves da conta de armazenamento for girada, o cluster fará fallback para usar a outra.	cadeia
queueEndpoint	O ponto de extremidade da fila da conta de armazenamento do Azure.	cadeia de caracteres (obrigatório)
storageAccountName	O nome da conta de armazenamento Azure.	cadeia de caracteres (obrigatório)
tableEndpoint	O ponto de extremidade da tabela da conta de armazenamento do Azure.	cadeia de caracteres (obrigatório)

EndpointRangeDescription

Nome	Descrição	Valor
Porta final	Porta final de um intervalo de portas	int (obrigatório)
porta inicial	Porta inicial de um intervalo de portas	int (obrigatório)

Descrição do tipo de nó

Nome	Descrição	Valor
portas de aplicação	O intervalo de portas das quais o cluster atribuiu porta a aplicativos do Service Fabric.	EndpointRangeDescription
Capacidades	As marcas de capacidade aplicadas aos nós no tipo de nó, o gerenciador de recursos de cluster usa essas marcas para entender a quantidade de recurso que um nó tem.	nodeTypeDescriptionCapacities
clientConnectionEndpointPort	A porta do ponto de extremidade de gerenciamento de cluster TCP.	int (obrigatório)
nível de durabilidade	O nível de durabilidade do tipo de nó. Saiba mais sobre DurabilityLevel. - Bronze - Sem privilégios. Esse é o padrão. - Silver - Os trabalhos de infraestrutura podem ser pausados por uma duração de 10 minutos por UD. - Ouro - Os trabalhos de infraestrutura podem ser pausados por uma duração de 2 horas por UD. A durabilidade do ouro só pode ser habilitada em skus de VM de nó completo, como D15_V2, G5 etc.	'Bronze' 'Ouro' 'Prata'
efêmerosPortos	O intervalo de portas efêmeras com as quais os nós neste tipo de nó devem ser configurados.	EndpointRangeDescription
httpGatewayEndpointPort	A porta do ponto de extremidade de gerenciamento de cluster HTTP.	int (obrigatório)
httpGatewayTokenAuthEndpointPort	A porta usada para conexões HTTPS baseadas em autenticação de token para o cluster. Não é possível definir como a mesma porta que HttpGatewayEndpoint.	int
é Primário	O tipo de nó no qual os serviços do sistema serão executados. Apenas um tipo de nó deve ser marcado como primário. O tipo de nó primário não pode ser excluído ou alterado para clusters existentes.	bool (obrigatório)
é sem estado	Indica se o tipo de nó só pode hospedar cargas de trabalho sem estado.	Bool
multipleAvailabilityZones	Indica se o tipo de nó está habilitado para dar suporte a várias zonas.	Bool
nome	O nome do tipo de nó.	cadeia de caracteres (obrigatório)
placementProperties	As marcas de posicionamento aplicadas a nós no tipo de nó, que podem ser usadas para indicar onde determinados serviços (carga de trabalho) devem ser executados.	NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort	O ponto de extremidade usado pelo proxy reverso.	int
vmInstanceCount	VMInstanceCount deve ser de 1 a n, em que n indica o número de instâncias de VM correspondentes a esse nodeType. VMInstanceCount = 0 só pode ser feito nestes cenários: NodeType é um nodeType secundário. Durabilidade = Bronze ou Durabilidade >= Bronze e InfrastructureServiceManager = true. Se VMInstanceCount = 0, implicará que as VMs para esse nodeType não serão usadas para a computação de tamanho de cluster inicial.	int Restrições: Valor mínimo = 0 Valor máximo = 2147483647 (obrigatório)

NodeTypeDescriptionCapacidades

Nome	Descrição	Valor

NodeTypeDescriptionPlacementProperties

Nome	Descrição	Valor

Notificação

Nome	Descrição	Valor
está ativado	Indica se a notificação está habilitada.	bool (obrigatório)
notificationCategory	A categoria de notificação.	'WaveProgress' (obrigatório)
nível de notificação	O nível de notificação.	'Todos' 'Crítico' (obrigatório)
notificationTargets	Lista de destinos que assinam a notificação.	NotificationTarget [] (obrigatório)

Alvo de Notificação

Nome	Descrição	Valor
notificationChannel	O canal de notificação indica o tipo de receptores inscritos na notificação, usuário ou assinatura.	'EmailSubscription' 'EmailUser' (obrigatório)
Receptores	Lista de destinos que assinam a notificação.	string[] (obrigatório)

ServerCertificateCommonName

Nome	Descrição	Valor
certificadoNomeComum	O nome comum do certificado do servidor.	cadeia de caracteres (obrigatório)
certificadoEmissorImpressão digital	A impressão digital do emissor do certificado do servidor.	cadeia de caracteres (obrigatório)

ServerCertificateCommonNames

Nome	Descrição	Valor
nomes comuns	A lista de certificados de servidor referenciados pelo nome comum que são usados para proteger o cluster.	ServerCertificateCommonName[]
x509NomedaLoja	O local do repositório de certificados local.	'Catálogo de endereços' 'AuthRoot' 'Autoridade de Certificação' 'Não permitido' 'Meu' 'Raiz' 'Pessoas confiáveis' 'Editor confiável'

ServiceTypeDeltaHealthPolicy

Nome	Descrição	Valor
maxPercentDeltaUnhealthyServices	O percentual máximo permitido de degradação da integridade dos serviços permitido durante as atualizações de cluster. O delta é medido entre o estado dos serviços no início da atualização e o estado dos serviços no momento da avaliação da integridade. A verificação é executada após cada conclusão da atualização do domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados.	int Restrições: Valor mínimo = 0 Valor máximo = 100

ServiceTypeHealthPolicy

Nome	Descrição	Valor
maxPercentUnhealthyServices	O percentual máximo de serviços permitidos para não estar íntegro antes que seu aplicativo seja considerado em erro.	int Restrições: Valor mínimo = 0 Valor máximo = 100

SettingsParameterDescription

Nome	Descrição	Valor
nome	O nome do parâmetro da configuração da malha.	cadeia de caracteres (obrigatório)
valor	O valor do parâmetro da configuração da malha.	cadeia de caracteres (obrigatório)

ConfiguraçõesSeçãoDescrição

Nome	Descrição	Valor
nome	O nome da seção das configurações da malha.	cadeia de caracteres (obrigatório)
Parâmetros	A coleção de parâmetros na seção.	SettingsParameterDescription[] (obrigatório)

TrackedResourceTags

Nome	Descrição	Valor

Exemplos de uso

Amostras de Bicep

Um exemplo básico de implantação do Cluster do Service Fabric.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource cluster 'Microsoft.ServiceFabric/clusters@2021-06-01' = {
  name: resourceName
  location: location
  properties: {
    addOnFeatures: []
    fabricSettings: []
    managementEndpoint: 'http://example:80'
    nodeTypes: [
      {
        capacities: {}
        clientConnectionEndpointPort: 2020
        durabilityLevel: 'Bronze'
        httpGatewayEndpointPort: 80
        isPrimary: true
        isStateless: false
        multipleAvailabilityZones: false
        name: 'first'
        placementProperties: {}
        vmInstanceCount: 3
      }
    ]
    reliabilityLevel: 'Bronze'
    upgradeMode: 'Automatic'
    vmImage: 'Windows'
  }
}

Azure Verified Modules

Os seguintes módulos Azure Verificados podem ser usados para implantar esse tipo de recurso.

Módulo	Descrição
Service Fabric	Módulo de recurso AVM para cluster do Service Fabric

Exemplos de Início Rápido do Azure

Os seguintes modelos Azure Quickstart contêm Bicep exemplos para implantar esse tipo de recurso.

Arquivo Bicep	Descrição
implante um cluster seguro de 5 nós	Esse modelo permite implantar um Cluster de Fabric de Serviço seguro de 5 nós rodando Windows Server 2019 Datacenter em um VMSS de Standard_D2_v2 Tamanho.

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.ServiceFabric/clusters, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.ServiceFabric/clusters",
  "apiVersion": "2026-03-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "addOnFeatures": [ "string" ],
    "applicationTypeVersionsCleanupPolicy": {
      "maxUnusedVersionsToKeep": "int"
    },
    "azureActiveDirectory": {
      "clientApplication": "string",
      "clusterApplication": "string",
      "tenantId": "string"
    },
    "certificate": {
      "thumbprint": "string",
      "thumbprintSecondary": "string",
      "x509StoreName": "string"
    },
    "certificateCommonNames": {
      "commonNames": [
        {
          "certificateCommonName": "string",
          "certificateIssuerThumbprint": "string"
        }
      ],
      "x509StoreName": "string"
    },
    "clientCertificateCommonNames": [
      {
        "certificateCommonName": "string",
        "certificateIssuerThumbprint": "string",
        "isAdmin": "bool"
      }
    ],
    "clientCertificateThumbprints": [
      {
        "certificateThumbprint": "string",
        "isAdmin": "bool"
      }
    ],
    "clusterCodeVersion": "string",
    "diagnosticsStorageAccountConfig": {
      "blobEndpoint": "string",
      "protectedAccountKeyName": "string",
      "protectedAccountKeyName2": "string",
      "queueEndpoint": "string",
      "storageAccountName": "string",
      "tableEndpoint": "string"
    },
    "enableHttpGatewayExclusiveAuthMode": "bool",
    "eventStoreServiceEnabled": "bool",
    "fabricSettings": [
      {
        "name": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ]
      }
    ],
    "infrastructureServiceManager": "bool",
    "managementEndpoint": "string",
    "nodeTypes": [
      {
        "applicationPorts": {
          "endPort": "int",
          "startPort": "int"
        },
        "capacities": {
          "{customized property}": "string"
        },
        "clientConnectionEndpointPort": "int",
        "durabilityLevel": "string",
        "ephemeralPorts": {
          "endPort": "int",
          "startPort": "int"
        },
        "httpGatewayEndpointPort": "int",
        "httpGatewayTokenAuthEndpointPort": "int",
        "isPrimary": "bool",
        "isStateless": "bool",
        "multipleAvailabilityZones": "bool",
        "name": "string",
        "placementProperties": {
          "{customized property}": "string"
        },
        "reverseProxyEndpointPort": "int",
        "vmInstanceCount": "int"
      }
    ],
    "notifications": [
      {
        "isEnabled": "bool",
        "notificationCategory": "string",
        "notificationLevel": "string",
        "notificationTargets": [
          {
            "notificationChannel": "string",
            "receivers": [ "string" ]
          }
        ]
      }
    ],
    "reliabilityLevel": "string",
    "reverseProxyCertificate": {
      "thumbprint": "string",
      "thumbprintSecondary": "string",
      "x509StoreName": "string"
    },
    "reverseProxyCertificateCommonNames": {
      "commonNames": [
        {
          "certificateCommonName": "string",
          "certificateIssuerThumbprint": "string"
        }
      ],
      "x509StoreName": "string"
    },
    "sfZonalUpgradeMode": "string",
    "upgradeDescription": {
      "deltaHealthPolicy": {
        "applicationDeltaHealthPolicies": {
          "{customized property}": {
            "defaultServiceTypeDeltaHealthPolicy": {
              "maxPercentDeltaUnhealthyServices": "int"
            },
            "serviceTypeDeltaHealthPolicies": {
              "{customized property}": {
                "maxPercentDeltaUnhealthyServices": "int"
              }
            }
          }
        },
        "maxPercentDeltaUnhealthyApplications": "int",
        "maxPercentDeltaUnhealthyNodes": "int",
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
      },
      "forceRestart": "bool",
      "healthCheckRetryTimeout": "string",
      "healthCheckStableDuration": "string",
      "healthCheckWaitDuration": "string",
      "healthPolicy": {
        "applicationHealthPolicies": {
          "{customized property}": {
            "defaultServiceTypeHealthPolicy": {
              "maxPercentUnhealthyServices": "int"
            },
            "serviceTypeHealthPolicies": {
              "{customized property}": {
                "maxPercentUnhealthyServices": "int"
              }
            }
          }
        },
        "maxPercentUnhealthyApplications": "int",
        "maxPercentUnhealthyNodes": "int"
      },
      "upgradeDomainTimeout": "string",
      "upgradeReplicaSetCheckTimeout": "string",
      "upgradeTimeout": "string"
    },
    "upgradeMode": "string",
    "upgradePauseEndTimestampUtc": "string",
    "upgradePauseStartTimestampUtc": "string",
    "upgradeWave": "string",
    "vmImage": "string",
    "vmssZonalUpgradeMode": "string",
    "waveUpgradePaused": "bool"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

Microsoft.ServiceFabric/clusters

Nome	Descrição	Valor
apiVersion	A versão da API	'Prévia 2026-03-01-Preview'
local	A localização geográfica onde o recurso reside	cadeia de caracteres (obrigatório)
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	As propriedades do recurso do cluster	clusterProperties
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo	O tipo de recurso	'Microsoft.ServiceFabric/clusters'

AplicaçãoDeltaHealthPolicy

Nome	Descrição	Valor
defaultServiceTypeDeltaHealthPolicy	A política de integridade delta usada por padrão para avaliar a integridade de um tipo de serviço ao atualizar o cluster.	ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies	O mapa com o tipo de serviço de política de integridade delta por nome de tipo de serviço. O mapa está vazio por padrão.	AplicaçãoDeltaPolíticaSaúdeTipoDeltaPolíticaSaúdePolíticas

AplicaçãoDeltaPolíticaSaúdeTipoDeltaPolíticaSaúdePolíticas

Nome	Descrição	Valor

Política de Integridade do Aplicativo

Nome	Descrição	Valor
defaultServiceTypeHealthPolicy	A política de integridade usada por padrão para avaliar a integridade de um tipo de serviço.	ServiceTypeHealthPolicy
serviceTypeHealthPolicies	O mapa com a política de integridade do tipo de serviço por nome de tipo de serviço. O mapa está vazio por padrão.	AplicaçãoPolíticaSaúdeTipoServiçoPolíticas de Saúde

AplicaçãoPolíticaSaúdeTipoServiçoPolíticas de Saúde

Nome	Descrição	Valor

ApplicationTypeVersionsCleanupPolicy

Nome	Descrição	Valor
maxUnusedVersionsToKeep	Número de versões não utilizados por tipo de aplicativo a serem mantidas.	int Restrições: Valor mínimo = 0 (obrigatório)

AzureActiveDirectory

Nome	Descrição	Valor
Aplicativo cliente	ID de aplicação do cliente do Azure Active Directory.	cadeia
clusterAplicativo	ID de aplicação do cluster do Azure Active Directory.	cadeia
ID do inquilino	Azure Active Directory tenant ID.	cadeia

Descrição do certificado

Nome	Descrição	Valor
impressão digital	Impressão digital do certificado primário.	cadeia de caracteres (obrigatório)
impressão digitalSecundário	Impressão digital do certificado secundário.	cadeia
x509NomedaLoja	O local do repositório de certificados local.	'Catálogo de endereços' 'AuthRoot' 'Autoridade de Certificação' 'Não permitido' 'Meu' 'Raiz' 'Pessoas confiáveis' 'Editor confiável'

ClientCertificateCommonName

Nome	Descrição	Valor
certificadoNomeComum	O nome comum do certificado do cliente.	cadeia de caracteres (obrigatório)
certificadoEmissorImpressão digital	A impressão digital do emissor do certificado do cliente.	cadeia de caracteres (obrigatório)
isAdmin	Indica se o certificado do cliente tem acesso de administrador ao cluster. Clientes não administradores só podem executar operações somente leitura no cluster.	bool (obrigatório)

ClientCertificateThumbprint

Nome	Descrição	Valor
certificadoImpressão digital	A impressão digital do certificado do cliente.	cadeia de caracteres (obrigatório)
isAdmin	Indica se o certificado do cliente tem acesso de administrador ao cluster. Clientes não administradores só podem executar operações somente leitura no cluster.	bool (obrigatório)

Política de Integridade do Cluster

Nome	Descrição	Valor
applicationHealthPolicies	Define o mapa da política de integridade do aplicativo usado para avaliar a integridade de um aplicativo ou de uma de suas entidades filho.	ClusterPolíticaSaúdeAplicaçãoPolíticas de Saúde
maxPercentUnhealthyApplications	O percentual máximo permitido de aplicativos não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% de aplicativos não estejam íntegros, esse valor seria 10. O percentual representa o percentual máximo tolerado de aplicativos que podem não estar íntegros antes que o cluster seja considerado erro. Se o percentual for respeitado, mas houver pelo menos um aplicativo não íntegro, a integridade será avaliada como Aviso. Isso é calculado dividindo o número de aplicativos não íntegros sobre o número total de instâncias de aplicativo no cluster, excluindo aplicativos de tipos de aplicativo incluídos no ApplicationTypeHealthPolicyMap. A computação arredonda para tolerar uma falha em um pequeno número de aplicativos. O percentual padrão é zero.	int Restrições: Valor mínimo = 0 Valor máximo = 100
maxPercentUnhealthyNodes	O percentual máximo permitido de nós não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% de nós não estejam íntegros, esse valor seria 10. O percentual representa o percentual máximo tolerado de nós que podem não estar íntegros antes que o cluster seja considerado em erro. Se o percentual for respeitado, mas houver pelo menos um nó não íntegro, a integridade será avaliada como Aviso. O percentual é calculado dividindo o número de nós não íntegros sobre o número total de nós no cluster. A computação é arredondada para tolerar uma falha em um pequeno número de nós. O percentual padrão é zero. Em clusters grandes, alguns nós sempre estarão inativos ou sem reparos, portanto, esse percentual deve ser configurado para tolerar isso.	int Restrições: Valor mínimo = 0 Valor máximo = 100

ClusterPolíticaSaúdeAplicaçãoPolíticas de Saúde

Nome	Descrição	Valor

Propriedades do Cluster

Nome	Descrição	Valor
addOnFeatures	A lista de recursos de complemento a serem habilitados no cluster.	Matriz de cadeia de caracteres que contém qualquer um dos: 'BackupRestoreService' 'DnsService' 'Gerenciador de reparos' 'ResourceMonitorService'
applicationTypeVersionsCleanupPolicy	A política usada para limpar versões não utilizadas.	ApplicationTypeVersionsCleanupPolicy
azureActiveDirectory	As configurações de autenticação do AAD do cluster.	do AzureActiveDirectory
certificado	O certificado a ser usado para proteger o cluster. O certificado fornecido será usado para a segurança do nó para nó dentro do cluster, certificado SSL para o ponto de extremidade de gerenciamento de cluster e o cliente de administrador padrão.	CertificateDescription
certificateCommonNames	Descreve uma lista de certificados de servidor referenciados pelo nome comum que são usados para proteger o cluster.	serverCertificateCommonNames
clientCertificateCommonNames	A lista de certificados de cliente referenciados por nome comum que têm permissão para gerenciar o cluster.	ClientCertificateCommonName[]
clientCertificateThumbprints	A lista de certificados de cliente referenciados pela impressão digital que têm permissão para gerenciar o cluster.	ClientCertificateThumbprint []
clusterCodeVersion	A versão de runtime do Service Fabric do cluster. Essa propriedade só pode definir o usuário quando upgradeMode estiver definido como "Manual". Para obter uma lista das versões disponíveis do Service Fabric para novos clusters, use da API do ClusterVersion. Para obter a lista de versões disponíveis para clusters existentes, use ClusterVersions disponíveis.	cadeia
diagnosticsStorageAccountConfig	As informações da conta de armazenamento para armazenar logs de diagnóstico do Service Fabric.	DiagnosticsStorageAccountConfig
enableHttpGatewayExclusiveAuthMode	Se for true, a autenticação baseada em token não será permitida no HttpGatewayEndpoint. Isso é necessário para dar suporte às versões 1.3 e superiores do TLS. Se a autenticação baseada em token for usada, HttpGatewayTokenAuthEndpointPort deverá ser definido.	Bool
eventStoreServiceEnabled	Indica se o serviço de repositório de eventos está habilitado.	Bool
configurações de tecido	A lista de configurações de malha personalizadas para definir o cluster.	SettingsSectionDescription[]
Gerenciador de Serviços de infraestrutura	Indica se o gerenciador de serviços de infraestrutura está habilitado.	Bool
gerenciamentoPonto de extremidade	O ponto de extremidade de gerenciamento http do cluster.	cadeia de caracteres (obrigatório)
nodeTypes	A lista de tipos de nó no cluster.	NodeTypeDescription [] (obrigatório)
Notificações	Indica uma lista de canais de notificação para eventos de cluster.	de notificação []
nível de confiabilidade	O nível de confiabilidade define o tamanho do conjunto de réplicas dos serviços do sistema. Saiba mais sobre ReliabilityLevel. - Nenhum - Execute os serviços do Sistema com uma contagem de conjunto de réplicas de destino de 1. Isso só deve ser usado para clusters de teste. – Bronze – Execute os serviços do Sistema com uma contagem de conjunto de réplicas de destino de 3. Isso só deve ser usado para clusters de teste. - Silver - Execute os serviços do Sistema com uma contagem de conjunto de réplicas de destino de 5. – Ouro – Execute os serviços do Sistema com uma contagem de conjunto de réplicas de destino de 7. - Platinum - Execute os serviços do Sistema com uma contagem de conjunto de réplicas de destino de 9.	'Bronze' 'Ouro' 'Nenhum' 'Platina' 'Prata'
reverseProxyCertificate	O certificado do servidor usado pelo proxy reverso.	CertificateDescription
reverseProxyCertificateCommonNames	Descreve uma lista de certificados de servidor referenciados pelo nome comum que são usados para proteger o cluster.	serverCertificateCommonNames
sfZonalUpgradeMode	Essa propriedade controla o agrupamento lógico de VMs em domínios de atualização (UDs). Essa propriedade não pode ser modificada se um tipo de nó com múltiplas Availability Zones já estiver presente no cluster.	'Hierárquico' 'Paralelo'
descrição da atualização	A política a ser usada ao atualizar o cluster.	ClusterUpgradePolicy
Modo de atualização	O modo de atualização do cluster quando a nova versão de runtime do Service Fabric estiver disponível.	'Automático' 'Manual'
upgradePauseEndTimestampUtc	Indica a data e a hora de término para pausar atualizações automáticas de versão de runtime no cluster por um período específico no cluster (UTC).	cadeia
upgradePauseStartTimestampUtc	Indica a data e a hora de início para pausar atualizações automáticas de versão de runtime no cluster por um período específico no cluster (UTC).	cadeia
Onda de atualização	Indica quando as novas atualizações de versão do runtime do cluster serão aplicadas após a liberação. Por padrão, é Wave0. Aplica-se somente quando upgradeMode é definido como 'Automático'.	'Onda0' 'Onda 1' 'Onda 2'
vmImagem	A VMSS de imagem da VM foi configurada. Nomes genéricos como Windows ou Linux podem ser usados.	cadeia
vmssZonalUpgradeMode	Essa propriedade define o modo de atualização para o conjunto de escalas da máquina virtual, sendo obrigatória se um tipo de nó com múltiplas Availability Zones for adicionado.	'Hierárquico' 'Paralelo'
waveUpgradePaused	Booliano para pausar atualizações automáticas de versão de runtime para o cluster.	Bool

ClusterUpgradeDeltaHealthPolicy

Nome	Descrição	Valor
applicationDeltaHealthPolicies	Define o mapa da política de integridade delta do aplicativo usado para avaliar a integridade de um aplicativo ou de uma de suas entidades filho ao atualizar o cluster.	ClusterUpgradeDeltaSaúdePolíticaDeltaPolíticaSaúdePolíticas
maxPercentDeltaUnhealthyApplications	O percentual máximo permitido de degradação da integridade dos aplicativos permitido durante as atualizações de cluster. O delta é medido entre o estado dos aplicativos no início da atualização e o estado dos aplicativos no momento da avaliação de integridade. A verificação é executada após cada conclusão da atualização do domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados. Os serviços do sistema não estão incluídos nisso.	int Restrições: Valor mínimo = 0 Valor máximo = 100 (obrigatório)
maxPercentDeltaUnhealthyNodes	O percentual máximo permitido de degradação da integridade dos nós permitido durante as atualizações do cluster. O delta é medido entre o estado dos nós no início da atualização e o estado dos nós no momento da avaliação da integridade. A verificação é executada após cada conclusão da atualização do domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados.	int Restrições: Valor mínimo = 0 Valor máximo = 100 (obrigatório)
maxPercentUpgradeDomainDeltaUnhealthyNodes	A porcentagem máxima permitida de degradação da integridade dos nós de domínio de atualização permitida durante as atualizações de cluster. O delta é medido entre o estado dos nós de domínio de atualização no início da atualização e o estado dos nós de domínio de atualização no momento da avaliação da integridade. A verificação é executada após cada conclusão da atualização do domínio de atualização para todos os domínios de atualização concluídos para garantir que o estado dos domínios de atualização esteja dentro dos limites tolerados.	int Restrições: Valor mínimo = 0 Valor máximo = 100 (obrigatório)

ClusterUpgradeDeltaSaúdePolíticaDeltaPolíticaSaúdePolíticas

Nome	Descrição	Valor

Política de atualização de cluster

Nome	Descrição	Valor
Política de Saúde delta	A política de integridade delta do cluster usada ao atualizar o cluster.	ClusterUpgradeDeltaHealthPolicy
forceRestart	Se for true, os processos serão reiniciados com força durante a atualização mesmo quando a versão do código não tiver sido alterada (a atualização altera apenas a configuração ou os dados).	Bool
healthCheckRetryTimeout	A quantidade de tempo para tentar novamente a avaliação de integridade quando o aplicativo ou cluster não estiver íntegro antes que a atualização volte. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)
healthCheckStableDuration	A quantidade de tempo que o aplicativo ou cluster deve permanecer íntegro antes que a atualização prossiga para o próximo domínio de atualização. A duração pode estar em hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)
healthCheckWaitDuration	O período de espera após a conclusão de um domínio de atualização antes de executar verificações de integridade. A duração pode estar em hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)
Política de Saúde	A política de integridade do cluster usada ao atualizar o cluster.	ClusterHealthPolicy (obrigatório)
upgradeDomainTimeout	A quantidade de tempo que cada domínio de atualização precisa concluir antes que a atualização reverta. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)
upgradeReplicaSetCheckTimeout	O tempo máximo para bloquear o processamento de um domínio de atualização e evitar a perda de disponibilidade quando houver problemas inesperados. Quando esse tempo limite expirar, o processamento do domínio de atualização continuará independentemente dos problemas de perda de disponibilidade. O tempo limite é redefinido no início de cada domínio de atualização. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)
upgradeTimeout	A quantidade de tempo que a atualização geral precisa ser concluída antes que a atualização reverta. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)

DiagnosticsStorageAccountConfig

Nome	Descrição	Valor
blobEndpoint	O ponto de extremidade de blob da conta de armazenamento do Azure.	cadeia de caracteres (obrigatório)
protectedAccountKeyName	O nome da chave de armazenamento de diagnóstico protegido.	cadeia de caracteres (obrigatório)
protectedAccountKeyName2	O nome da chave de armazenamento de diagnóstico protegido secundário. Se uma das chaves da conta de armazenamento for girada, o cluster fará fallback para usar a outra.	cadeia
queueEndpoint	O ponto de extremidade da fila da conta de armazenamento do Azure.	cadeia de caracteres (obrigatório)
storageAccountName	O nome da conta de armazenamento Azure.	cadeia de caracteres (obrigatório)
tableEndpoint	O ponto de extremidade da tabela da conta de armazenamento do Azure.	cadeia de caracteres (obrigatório)

EndpointRangeDescription

Nome	Descrição	Valor
Porta final	Porta final de um intervalo de portas	int (obrigatório)
porta inicial	Porta inicial de um intervalo de portas	int (obrigatório)

Descrição do tipo de nó

Nome	Descrição	Valor
portas de aplicação	O intervalo de portas das quais o cluster atribuiu porta a aplicativos do Service Fabric.	EndpointRangeDescription
Capacidades	As marcas de capacidade aplicadas aos nós no tipo de nó, o gerenciador de recursos de cluster usa essas marcas para entender a quantidade de recurso que um nó tem.	nodeTypeDescriptionCapacities
clientConnectionEndpointPort	A porta do ponto de extremidade de gerenciamento de cluster TCP.	int (obrigatório)
nível de durabilidade	O nível de durabilidade do tipo de nó. Saiba mais sobre DurabilityLevel. - Bronze - Sem privilégios. Esse é o padrão. - Silver - Os trabalhos de infraestrutura podem ser pausados por uma duração de 10 minutos por UD. - Ouro - Os trabalhos de infraestrutura podem ser pausados por uma duração de 2 horas por UD. A durabilidade do ouro só pode ser habilitada em skus de VM de nó completo, como D15_V2, G5 etc.	'Bronze' 'Ouro' 'Prata'
efêmerosPortos	O intervalo de portas efêmeras com as quais os nós neste tipo de nó devem ser configurados.	EndpointRangeDescription
httpGatewayEndpointPort	A porta do ponto de extremidade de gerenciamento de cluster HTTP.	int (obrigatório)
httpGatewayTokenAuthEndpointPort	A porta usada para conexões HTTPS baseadas em autenticação de token para o cluster. Não é possível definir como a mesma porta que HttpGatewayEndpoint.	int
é Primário	O tipo de nó no qual os serviços do sistema serão executados. Apenas um tipo de nó deve ser marcado como primário. O tipo de nó primário não pode ser excluído ou alterado para clusters existentes.	bool (obrigatório)
é sem estado	Indica se o tipo de nó só pode hospedar cargas de trabalho sem estado.	Bool
multipleAvailabilityZones	Indica se o tipo de nó está habilitado para dar suporte a várias zonas.	Bool
nome	O nome do tipo de nó.	cadeia de caracteres (obrigatório)
placementProperties	As marcas de posicionamento aplicadas a nós no tipo de nó, que podem ser usadas para indicar onde determinados serviços (carga de trabalho) devem ser executados.	NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort	O ponto de extremidade usado pelo proxy reverso.	int
vmInstanceCount	VMInstanceCount deve ser de 1 a n, em que n indica o número de instâncias de VM correspondentes a esse nodeType. VMInstanceCount = 0 só pode ser feito nestes cenários: NodeType é um nodeType secundário. Durabilidade = Bronze ou Durabilidade >= Bronze e InfrastructureServiceManager = true. Se VMInstanceCount = 0, implicará que as VMs para esse nodeType não serão usadas para a computação de tamanho de cluster inicial.	int Restrições: Valor mínimo = 0 Valor máximo = 2147483647 (obrigatório)

NodeTypeDescriptionCapacidades

Nome	Descrição	Valor

NodeTypeDescriptionPlacementProperties

Nome	Descrição	Valor

Notificação

Nome	Descrição	Valor
está ativado	Indica se a notificação está habilitada.	bool (obrigatório)
notificationCategory	A categoria de notificação.	'WaveProgress' (obrigatório)
nível de notificação	O nível de notificação.	'Todos' 'Crítico' (obrigatório)
notificationTargets	Lista de destinos que assinam a notificação.	NotificationTarget [] (obrigatório)

Alvo de Notificação

Nome	Descrição	Valor
notificationChannel	O canal de notificação indica o tipo de receptores inscritos na notificação, usuário ou assinatura.	'EmailSubscription' 'EmailUser' (obrigatório)
Receptores	Lista de destinos que assinam a notificação.	string[] (obrigatório)

ServerCertificateCommonName

Nome	Descrição	Valor
certificadoNomeComum	O nome comum do certificado do servidor.	cadeia de caracteres (obrigatório)
certificadoEmissorImpressão digital	A impressão digital do emissor do certificado do servidor.	cadeia de caracteres (obrigatório)

ServerCertificateCommonNames

Nome	Descrição	Valor
nomes comuns	A lista de certificados de servidor referenciados pelo nome comum que são usados para proteger o cluster.	ServerCertificateCommonName[]
x509NomedaLoja	O local do repositório de certificados local.	'Catálogo de endereços' 'AuthRoot' 'Autoridade de Certificação' 'Não permitido' 'Meu' 'Raiz' 'Pessoas confiáveis' 'Editor confiável'

ServiceTypeDeltaHealthPolicy

Nome	Descrição	Valor
maxPercentDeltaUnhealthyServices	O percentual máximo permitido de degradação da integridade dos serviços permitido durante as atualizações de cluster. O delta é medido entre o estado dos serviços no início da atualização e o estado dos serviços no momento da avaliação da integridade. A verificação é executada após cada conclusão da atualização do domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados.	int Restrições: Valor mínimo = 0 Valor máximo = 100

ServiceTypeHealthPolicy

Nome	Descrição	Valor
maxPercentUnhealthyServices	O percentual máximo de serviços permitidos para não estar íntegro antes que seu aplicativo seja considerado em erro.	int Restrições: Valor mínimo = 0 Valor máximo = 100

SettingsParameterDescription

Nome	Descrição	Valor
nome	O nome do parâmetro da configuração da malha.	cadeia de caracteres (obrigatório)
valor	O valor do parâmetro da configuração da malha.	cadeia de caracteres (obrigatório)

ConfiguraçõesSeçãoDescrição

Nome	Descrição	Valor
nome	O nome da seção das configurações da malha.	cadeia de caracteres (obrigatório)
Parâmetros	A coleção de parâmetros na seção.	SettingsParameterDescription[] (obrigatório)

TrackedResourceTags

Nome	Descrição	Valor

Exemplos de uso

Modelos de Início Rápido do Azure

Os seguintes modelos Azure Quickstart implantam esse tipo de recurso.

Modelo	Descrição
Implante um Cluster Seguro de 3 Nós com NSGs ativados	Este modelo permite implantar um cluster de fabric de serviço seguro de 3 nós rodando Windows data center server 2016 em VMs de Standard_D2 Size. Usar esse modelo permite que você controle o tráfego de rede de entrada e saída usando Grupos de Segurança de Rede.
implante um cluster seguro de 5 nós	Esse modelo permite implantar um Cluster de Fabric de Serviço seguro de 5 nós rodando Windows Server 2019 Datacenter em um VMSS de Standard_D2_v2 Tamanho.
Implante um Cluster Ubuntu Service Fabric com 5 nós	Esse modelo permite que você implante um Cluster seguro do Service Fabric de 5 nós executando o Ubuntu em uma VMSS de tamanho Standard_D2_V2.

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.ServiceFabric/clusters, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/clusters@2026-03-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      addOnFeatures = [
        "string"
      ]
      applicationTypeVersionsCleanupPolicy = {
        maxUnusedVersionsToKeep = int
      }
      azureActiveDirectory = {
        clientApplication = "string"
        clusterApplication = "string"
        tenantId = "string"
      }
      certificate = {
        thumbprint = "string"
        thumbprintSecondary = "string"
        x509StoreName = "string"
      }
      certificateCommonNames = {
        commonNames = [
          {
            certificateCommonName = "string"
            certificateIssuerThumbprint = "string"
          }
        ]
        x509StoreName = "string"
      }
      clientCertificateCommonNames = [
        {
          certificateCommonName = "string"
          certificateIssuerThumbprint = "string"
          isAdmin = bool
        }
      ]
      clientCertificateThumbprints = [
        {
          certificateThumbprint = "string"
          isAdmin = bool
        }
      ]
      clusterCodeVersion = "string"
      diagnosticsStorageAccountConfig = {
        blobEndpoint = "string"
        protectedAccountKeyName = "string"
        protectedAccountKeyName2 = "string"
        queueEndpoint = "string"
        storageAccountName = "string"
        tableEndpoint = "string"
      }
      enableHttpGatewayExclusiveAuthMode = bool
      eventStoreServiceEnabled = bool
      fabricSettings = [
        {
          name = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
        }
      ]
      infrastructureServiceManager = bool
      managementEndpoint = "string"
      nodeTypes = [
        {
          applicationPorts = {
            endPort = int
            startPort = int
          }
          capacities = {
            {customized property} = "string"
          }
          clientConnectionEndpointPort = int
          durabilityLevel = "string"
          ephemeralPorts = {
            endPort = int
            startPort = int
          }
          httpGatewayEndpointPort = int
          httpGatewayTokenAuthEndpointPort = int
          isPrimary = bool
          isStateless = bool
          multipleAvailabilityZones = bool
          name = "string"
          placementProperties = {
            {customized property} = "string"
          }
          reverseProxyEndpointPort = int
          vmInstanceCount = int
        }
      ]
      notifications = [
        {
          isEnabled = bool
          notificationCategory = "string"
          notificationLevel = "string"
          notificationTargets = [
            {
              notificationChannel = "string"
              receivers = [
                "string"
              ]
            }
          ]
        }
      ]
      reliabilityLevel = "string"
      reverseProxyCertificate = {
        thumbprint = "string"
        thumbprintSecondary = "string"
        x509StoreName = "string"
      }
      reverseProxyCertificateCommonNames = {
        commonNames = [
          {
            certificateCommonName = "string"
            certificateIssuerThumbprint = "string"
          }
        ]
        x509StoreName = "string"
      }
      sfZonalUpgradeMode = "string"
      upgradeDescription = {
        deltaHealthPolicy = {
          applicationDeltaHealthPolicies = {
            {customized property} = {
              defaultServiceTypeDeltaHealthPolicy = {
                maxPercentDeltaUnhealthyServices = int
              }
              serviceTypeDeltaHealthPolicies = {
                {customized property} = {
                  maxPercentDeltaUnhealthyServices = int
                }
              }
            }
          }
          maxPercentDeltaUnhealthyApplications = int
          maxPercentDeltaUnhealthyNodes = int
          maxPercentUpgradeDomainDeltaUnhealthyNodes = int
        }
        forceRestart = bool
        healthCheckRetryTimeout = "string"
        healthCheckStableDuration = "string"
        healthCheckWaitDuration = "string"
        healthPolicy = {
          applicationHealthPolicies = {
            {customized property} = {
              defaultServiceTypeHealthPolicy = {
                maxPercentUnhealthyServices = int
              }
              serviceTypeHealthPolicies = {
                {customized property} = {
                  maxPercentUnhealthyServices = int
                }
              }
            }
          }
          maxPercentUnhealthyApplications = int
          maxPercentUnhealthyNodes = int
        }
        upgradeDomainTimeout = "string"
        upgradeReplicaSetCheckTimeout = "string"
        upgradeTimeout = "string"
      }
      upgradeMode = "string"
      upgradePauseEndTimestampUtc = "string"
      upgradePauseStartTimestampUtc = "string"
      upgradeWave = "string"
      vmImage = "string"
      vmssZonalUpgradeMode = "string"
      waveUpgradePaused = bool
    }
  }
}

Valores de propriedade

Microsoft.ServiceFabric/clusters

Nome	Descrição	Valor
local	A localização geográfica onde o recurso reside	cadeia de caracteres (obrigatório)
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	As propriedades do recurso do cluster	clusterProperties
Tags	Marcas de recurso	Dicionário de nomes e valores de marca.
tipo	O tipo de recurso	"Microsoft.ServiceFabric/clusters@2026-03-01-preview"

AplicaçãoDeltaHealthPolicy

Nome	Descrição	Valor
defaultServiceTypeDeltaHealthPolicy	A política de integridade delta usada por padrão para avaliar a integridade de um tipo de serviço ao atualizar o cluster.	ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies	O mapa com o tipo de serviço de política de integridade delta por nome de tipo de serviço. O mapa está vazio por padrão.	AplicaçãoDeltaPolíticaSaúdeTipoDeltaPolíticaSaúdePolíticas

AplicaçãoDeltaPolíticaSaúdeTipoDeltaPolíticaSaúdePolíticas

Nome	Descrição	Valor

Política de Integridade do Aplicativo

Nome	Descrição	Valor
defaultServiceTypeHealthPolicy	A política de integridade usada por padrão para avaliar a integridade de um tipo de serviço.	ServiceTypeHealthPolicy
serviceTypeHealthPolicies	O mapa com a política de integridade do tipo de serviço por nome de tipo de serviço. O mapa está vazio por padrão.	AplicaçãoPolíticaSaúdeTipoServiçoPolíticas de Saúde

AplicaçãoPolíticaSaúdeTipoServiçoPolíticas de Saúde

Nome	Descrição	Valor

ApplicationTypeVersionsCleanupPolicy

Nome	Descrição	Valor
maxUnusedVersionsToKeep	Número de versões não utilizados por tipo de aplicativo a serem mantidas.	int Restrições: Valor mínimo = 0 (obrigatório)

AzureActiveDirectory

Nome	Descrição	Valor
Aplicativo cliente	ID de aplicação do cliente do Azure Active Directory.	cadeia
clusterAplicativo	ID de aplicação do cluster do Azure Active Directory.	cadeia
ID do inquilino	Azure Active Directory tenant ID.	cadeia

Descrição do certificado

Nome	Descrição	Valor
impressão digital	Impressão digital do certificado primário.	cadeia de caracteres (obrigatório)
impressão digitalSecundário	Impressão digital do certificado secundário.	cadeia
x509NomedaLoja	O local do repositório de certificados local.	'Catálogo de endereços' 'AuthRoot' 'Autoridade de Certificação' 'Não permitido' 'Meu' 'Raiz' 'Pessoas confiáveis' 'Editor confiável'

ClientCertificateCommonName

Nome	Descrição	Valor
certificadoNomeComum	O nome comum do certificado do cliente.	cadeia de caracteres (obrigatório)
certificadoEmissorImpressão digital	A impressão digital do emissor do certificado do cliente.	cadeia de caracteres (obrigatório)
isAdmin	Indica se o certificado do cliente tem acesso de administrador ao cluster. Clientes não administradores só podem executar operações somente leitura no cluster.	bool (obrigatório)

ClientCertificateThumbprint

Nome	Descrição	Valor
certificadoImpressão digital	A impressão digital do certificado do cliente.	cadeia de caracteres (obrigatório)
isAdmin	Indica se o certificado do cliente tem acesso de administrador ao cluster. Clientes não administradores só podem executar operações somente leitura no cluster.	bool (obrigatório)

Política de Integridade do Cluster

Nome	Descrição	Valor
applicationHealthPolicies	Define o mapa da política de integridade do aplicativo usado para avaliar a integridade de um aplicativo ou de uma de suas entidades filho.	ClusterPolíticaSaúdeAplicaçãoPolíticas de Saúde
maxPercentUnhealthyApplications	O percentual máximo permitido de aplicativos não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% de aplicativos não estejam íntegros, esse valor seria 10. O percentual representa o percentual máximo tolerado de aplicativos que podem não estar íntegros antes que o cluster seja considerado erro. Se o percentual for respeitado, mas houver pelo menos um aplicativo não íntegro, a integridade será avaliada como Aviso. Isso é calculado dividindo o número de aplicativos não íntegros sobre o número total de instâncias de aplicativo no cluster, excluindo aplicativos de tipos de aplicativo incluídos no ApplicationTypeHealthPolicyMap. A computação arredonda para tolerar uma falha em um pequeno número de aplicativos. O percentual padrão é zero.	int Restrições: Valor mínimo = 0 Valor máximo = 100
maxPercentUnhealthyNodes	O percentual máximo permitido de nós não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% de nós não estejam íntegros, esse valor seria 10. O percentual representa o percentual máximo tolerado de nós que podem não estar íntegros antes que o cluster seja considerado em erro. Se o percentual for respeitado, mas houver pelo menos um nó não íntegro, a integridade será avaliada como Aviso. O percentual é calculado dividindo o número de nós não íntegros sobre o número total de nós no cluster. A computação é arredondada para tolerar uma falha em um pequeno número de nós. O percentual padrão é zero. Em clusters grandes, alguns nós sempre estarão inativos ou sem reparos, portanto, esse percentual deve ser configurado para tolerar isso.	int Restrições: Valor mínimo = 0 Valor máximo = 100

ClusterPolíticaSaúdeAplicaçãoPolíticas de Saúde

Nome	Descrição	Valor

Propriedades do Cluster

Nome	Descrição	Valor
addOnFeatures	A lista de recursos de complemento a serem habilitados no cluster.	Matriz de cadeia de caracteres que contém qualquer um dos: 'BackupRestoreService' 'DnsService' 'Gerenciador de reparos' 'ResourceMonitorService'
applicationTypeVersionsCleanupPolicy	A política usada para limpar versões não utilizadas.	ApplicationTypeVersionsCleanupPolicy
azureActiveDirectory	As configurações de autenticação do AAD do cluster.	do AzureActiveDirectory
certificado	O certificado a ser usado para proteger o cluster. O certificado fornecido será usado para a segurança do nó para nó dentro do cluster, certificado SSL para o ponto de extremidade de gerenciamento de cluster e o cliente de administrador padrão.	CertificateDescription
certificateCommonNames	Descreve uma lista de certificados de servidor referenciados pelo nome comum que são usados para proteger o cluster.	serverCertificateCommonNames
clientCertificateCommonNames	A lista de certificados de cliente referenciados por nome comum que têm permissão para gerenciar o cluster.	ClientCertificateCommonName[]
clientCertificateThumbprints	A lista de certificados de cliente referenciados pela impressão digital que têm permissão para gerenciar o cluster.	ClientCertificateThumbprint []
clusterCodeVersion	A versão de runtime do Service Fabric do cluster. Essa propriedade só pode definir o usuário quando upgradeMode estiver definido como "Manual". Para obter uma lista das versões disponíveis do Service Fabric para novos clusters, use da API do ClusterVersion. Para obter a lista de versões disponíveis para clusters existentes, use ClusterVersions disponíveis.	cadeia
diagnosticsStorageAccountConfig	As informações da conta de armazenamento para armazenar logs de diagnóstico do Service Fabric.	DiagnosticsStorageAccountConfig
enableHttpGatewayExclusiveAuthMode	Se for true, a autenticação baseada em token não será permitida no HttpGatewayEndpoint. Isso é necessário para dar suporte às versões 1.3 e superiores do TLS. Se a autenticação baseada em token for usada, HttpGatewayTokenAuthEndpointPort deverá ser definido.	Bool
eventStoreServiceEnabled	Indica se o serviço de repositório de eventos está habilitado.	Bool
configurações de tecido	A lista de configurações de malha personalizadas para definir o cluster.	SettingsSectionDescription[]
Gerenciador de Serviços de infraestrutura	Indica se o gerenciador de serviços de infraestrutura está habilitado.	Bool
gerenciamentoPonto de extremidade	O ponto de extremidade de gerenciamento http do cluster.	cadeia de caracteres (obrigatório)
nodeTypes	A lista de tipos de nó no cluster.	NodeTypeDescription [] (obrigatório)
Notificações	Indica uma lista de canais de notificação para eventos de cluster.	de notificação []
nível de confiabilidade	O nível de confiabilidade define o tamanho do conjunto de réplicas dos serviços do sistema. Saiba mais sobre ReliabilityLevel. - Nenhum - Execute os serviços do Sistema com uma contagem de conjunto de réplicas de destino de 1. Isso só deve ser usado para clusters de teste. – Bronze – Execute os serviços do Sistema com uma contagem de conjunto de réplicas de destino de 3. Isso só deve ser usado para clusters de teste. - Silver - Execute os serviços do Sistema com uma contagem de conjunto de réplicas de destino de 5. – Ouro – Execute os serviços do Sistema com uma contagem de conjunto de réplicas de destino de 7. - Platinum - Execute os serviços do Sistema com uma contagem de conjunto de réplicas de destino de 9.	'Bronze' 'Ouro' 'Nenhum' 'Platina' 'Prata'
reverseProxyCertificate	O certificado do servidor usado pelo proxy reverso.	CertificateDescription
reverseProxyCertificateCommonNames	Descreve uma lista de certificados de servidor referenciados pelo nome comum que são usados para proteger o cluster.	serverCertificateCommonNames
sfZonalUpgradeMode	Essa propriedade controla o agrupamento lógico de VMs em domínios de atualização (UDs). Essa propriedade não pode ser modificada se um tipo de nó com múltiplas Availability Zones já estiver presente no cluster.	'Hierárquico' 'Paralelo'
descrição da atualização	A política a ser usada ao atualizar o cluster.	ClusterUpgradePolicy
Modo de atualização	O modo de atualização do cluster quando a nova versão de runtime do Service Fabric estiver disponível.	'Automático' 'Manual'
upgradePauseEndTimestampUtc	Indica a data e a hora de término para pausar atualizações automáticas de versão de runtime no cluster por um período específico no cluster (UTC).	cadeia
upgradePauseStartTimestampUtc	Indica a data e a hora de início para pausar atualizações automáticas de versão de runtime no cluster por um período específico no cluster (UTC).	cadeia
Onda de atualização	Indica quando as novas atualizações de versão do runtime do cluster serão aplicadas após a liberação. Por padrão, é Wave0. Aplica-se somente quando upgradeMode é definido como 'Automático'.	'Onda0' 'Onda 1' 'Onda 2'
vmImagem	A VMSS de imagem da VM foi configurada. Nomes genéricos como Windows ou Linux podem ser usados.	cadeia
vmssZonalUpgradeMode	Essa propriedade define o modo de atualização para o conjunto de escalas da máquina virtual, sendo obrigatória se um tipo de nó com múltiplas Availability Zones for adicionado.	'Hierárquico' 'Paralelo'
waveUpgradePaused	Booliano para pausar atualizações automáticas de versão de runtime para o cluster.	Bool

ClusterUpgradeDeltaHealthPolicy

Nome	Descrição	Valor
applicationDeltaHealthPolicies	Define o mapa da política de integridade delta do aplicativo usado para avaliar a integridade de um aplicativo ou de uma de suas entidades filho ao atualizar o cluster.	ClusterUpgradeDeltaSaúdePolíticaDeltaPolíticaSaúdePolíticas
maxPercentDeltaUnhealthyApplications	O percentual máximo permitido de degradação da integridade dos aplicativos permitido durante as atualizações de cluster. O delta é medido entre o estado dos aplicativos no início da atualização e o estado dos aplicativos no momento da avaliação de integridade. A verificação é executada após cada conclusão da atualização do domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados. Os serviços do sistema não estão incluídos nisso.	int Restrições: Valor mínimo = 0 Valor máximo = 100 (obrigatório)
maxPercentDeltaUnhealthyNodes	O percentual máximo permitido de degradação da integridade dos nós permitido durante as atualizações do cluster. O delta é medido entre o estado dos nós no início da atualização e o estado dos nós no momento da avaliação da integridade. A verificação é executada após cada conclusão da atualização do domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados.	int Restrições: Valor mínimo = 0 Valor máximo = 100 (obrigatório)
maxPercentUpgradeDomainDeltaUnhealthyNodes	A porcentagem máxima permitida de degradação da integridade dos nós de domínio de atualização permitida durante as atualizações de cluster. O delta é medido entre o estado dos nós de domínio de atualização no início da atualização e o estado dos nós de domínio de atualização no momento da avaliação da integridade. A verificação é executada após cada conclusão da atualização do domínio de atualização para todos os domínios de atualização concluídos para garantir que o estado dos domínios de atualização esteja dentro dos limites tolerados.	int Restrições: Valor mínimo = 0 Valor máximo = 100 (obrigatório)

ClusterUpgradeDeltaSaúdePolíticaDeltaPolíticaSaúdePolíticas

Nome	Descrição	Valor

Política de atualização de cluster

Nome	Descrição	Valor
Política de Saúde delta	A política de integridade delta do cluster usada ao atualizar o cluster.	ClusterUpgradeDeltaHealthPolicy
forceRestart	Se for true, os processos serão reiniciados com força durante a atualização mesmo quando a versão do código não tiver sido alterada (a atualização altera apenas a configuração ou os dados).	Bool
healthCheckRetryTimeout	A quantidade de tempo para tentar novamente a avaliação de integridade quando o aplicativo ou cluster não estiver íntegro antes que a atualização volte. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)
healthCheckStableDuration	A quantidade de tempo que o aplicativo ou cluster deve permanecer íntegro antes que a atualização prossiga para o próximo domínio de atualização. A duração pode estar em hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)
healthCheckWaitDuration	O período de espera após a conclusão de um domínio de atualização antes de executar verificações de integridade. A duração pode estar em hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)
Política de Saúde	A política de integridade do cluster usada ao atualizar o cluster.	ClusterHealthPolicy (obrigatório)
upgradeDomainTimeout	A quantidade de tempo que cada domínio de atualização precisa concluir antes que a atualização reverta. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)
upgradeReplicaSetCheckTimeout	O tempo máximo para bloquear o processamento de um domínio de atualização e evitar a perda de disponibilidade quando houver problemas inesperados. Quando esse tempo limite expirar, o processamento do domínio de atualização continuará independentemente dos problemas de perda de disponibilidade. O tempo limite é redefinido no início de cada domínio de atualização. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)
upgradeTimeout	A quantidade de tempo que a atualização geral precisa ser concluída antes que a atualização reverta. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms.	cadeia de caracteres (obrigatório)

DiagnosticsStorageAccountConfig

Nome	Descrição	Valor
blobEndpoint	O ponto de extremidade de blob da conta de armazenamento do Azure.	cadeia de caracteres (obrigatório)
protectedAccountKeyName	O nome da chave de armazenamento de diagnóstico protegido.	cadeia de caracteres (obrigatório)
protectedAccountKeyName2	O nome da chave de armazenamento de diagnóstico protegido secundário. Se uma das chaves da conta de armazenamento for girada, o cluster fará fallback para usar a outra.	cadeia
queueEndpoint	O ponto de extremidade da fila da conta de armazenamento do Azure.	cadeia de caracteres (obrigatório)
storageAccountName	O nome da conta de armazenamento Azure.	cadeia de caracteres (obrigatório)
tableEndpoint	O ponto de extremidade da tabela da conta de armazenamento do Azure.	cadeia de caracteres (obrigatório)

EndpointRangeDescription

Nome	Descrição	Valor
Porta final	Porta final de um intervalo de portas	int (obrigatório)
porta inicial	Porta inicial de um intervalo de portas	int (obrigatório)

Descrição do tipo de nó

Nome	Descrição	Valor
portas de aplicação	O intervalo de portas das quais o cluster atribuiu porta a aplicativos do Service Fabric.	EndpointRangeDescription
Capacidades	As marcas de capacidade aplicadas aos nós no tipo de nó, o gerenciador de recursos de cluster usa essas marcas para entender a quantidade de recurso que um nó tem.	nodeTypeDescriptionCapacities
clientConnectionEndpointPort	A porta do ponto de extremidade de gerenciamento de cluster TCP.	int (obrigatório)
nível de durabilidade	O nível de durabilidade do tipo de nó. Saiba mais sobre DurabilityLevel. - Bronze - Sem privilégios. Esse é o padrão. - Silver - Os trabalhos de infraestrutura podem ser pausados por uma duração de 10 minutos por UD. - Ouro - Os trabalhos de infraestrutura podem ser pausados por uma duração de 2 horas por UD. A durabilidade do ouro só pode ser habilitada em skus de VM de nó completo, como D15_V2, G5 etc.	'Bronze' 'Ouro' 'Prata'
efêmerosPortos	O intervalo de portas efêmeras com as quais os nós neste tipo de nó devem ser configurados.	EndpointRangeDescription
httpGatewayEndpointPort	A porta do ponto de extremidade de gerenciamento de cluster HTTP.	int (obrigatório)
httpGatewayTokenAuthEndpointPort	A porta usada para conexões HTTPS baseadas em autenticação de token para o cluster. Não é possível definir como a mesma porta que HttpGatewayEndpoint.	int
é Primário	O tipo de nó no qual os serviços do sistema serão executados. Apenas um tipo de nó deve ser marcado como primário. O tipo de nó primário não pode ser excluído ou alterado para clusters existentes.	bool (obrigatório)
é sem estado	Indica se o tipo de nó só pode hospedar cargas de trabalho sem estado.	Bool
multipleAvailabilityZones	Indica se o tipo de nó está habilitado para dar suporte a várias zonas.	Bool
nome	O nome do tipo de nó.	cadeia de caracteres (obrigatório)
placementProperties	As marcas de posicionamento aplicadas a nós no tipo de nó, que podem ser usadas para indicar onde determinados serviços (carga de trabalho) devem ser executados.	NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort	O ponto de extremidade usado pelo proxy reverso.	int
vmInstanceCount	VMInstanceCount deve ser de 1 a n, em que n indica o número de instâncias de VM correspondentes a esse nodeType. VMInstanceCount = 0 só pode ser feito nestes cenários: NodeType é um nodeType secundário. Durabilidade = Bronze ou Durabilidade >= Bronze e InfrastructureServiceManager = true. Se VMInstanceCount = 0, implicará que as VMs para esse nodeType não serão usadas para a computação de tamanho de cluster inicial.	int Restrições: Valor mínimo = 0 Valor máximo = 2147483647 (obrigatório)

NodeTypeDescriptionCapacidades

Nome	Descrição	Valor

NodeTypeDescriptionPlacementProperties

Nome	Descrição	Valor

Notificação

Nome	Descrição	Valor
está ativado	Indica se a notificação está habilitada.	bool (obrigatório)
notificationCategory	A categoria de notificação.	'WaveProgress' (obrigatório)
nível de notificação	O nível de notificação.	'Todos' 'Crítico' (obrigatório)
notificationTargets	Lista de destinos que assinam a notificação.	NotificationTarget [] (obrigatório)

Alvo de Notificação

Nome	Descrição	Valor
notificationChannel	O canal de notificação indica o tipo de receptores inscritos na notificação, usuário ou assinatura.	'EmailSubscription' 'EmailUser' (obrigatório)
Receptores	Lista de destinos que assinam a notificação.	string[] (obrigatório)

ServerCertificateCommonName

Nome	Descrição	Valor
certificadoNomeComum	O nome comum do certificado do servidor.	cadeia de caracteres (obrigatório)
certificadoEmissorImpressão digital	A impressão digital do emissor do certificado do servidor.	cadeia de caracteres (obrigatório)

ServerCertificateCommonNames

Nome	Descrição	Valor
nomes comuns	A lista de certificados de servidor referenciados pelo nome comum que são usados para proteger o cluster.	ServerCertificateCommonName[]
x509NomedaLoja	O local do repositório de certificados local.	'Catálogo de endereços' 'AuthRoot' 'Autoridade de Certificação' 'Não permitido' 'Meu' 'Raiz' 'Pessoas confiáveis' 'Editor confiável'

ServiceTypeDeltaHealthPolicy

Nome	Descrição	Valor
maxPercentDeltaUnhealthyServices	O percentual máximo permitido de degradação da integridade dos serviços permitido durante as atualizações de cluster. O delta é medido entre o estado dos serviços no início da atualização e o estado dos serviços no momento da avaliação da integridade. A verificação é executada após cada conclusão da atualização do domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados.	int Restrições: Valor mínimo = 0 Valor máximo = 100

ServiceTypeHealthPolicy

Nome	Descrição	Valor
maxPercentUnhealthyServices	O percentual máximo de serviços permitidos para não estar íntegro antes que seu aplicativo seja considerado em erro.	int Restrições: Valor mínimo = 0 Valor máximo = 100

SettingsParameterDescription

Nome	Descrição	Valor
nome	O nome do parâmetro da configuração da malha.	cadeia de caracteres (obrigatório)
valor	O valor do parâmetro da configuração da malha.	cadeia de caracteres (obrigatório)

ConfiguraçõesSeçãoDescrição

Nome	Descrição	Valor
nome	O nome da seção das configurações da malha.	cadeia de caracteres (obrigatório)
Parâmetros	A coleção de parâmetros na seção.	SettingsParameterDescription[] (obrigatório)

TrackedResourceTags

Nome	Descrição	Valor

Exemplos de uso

Exemplos do Terraform

Um exemplo básico de implantação do Cluster do Service Fabric.

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

provider "azapi" {
  skip_provider_registration = false
}

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

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

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

resource "azapi_resource" "cluster" {
  type      = "Microsoft.ServiceFabric/clusters@2021-06-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      addOnFeatures = [
      ]
      fabricSettings = [
      ]
      managementEndpoint = "http://example:80"
      nodeTypes = [
        {
          capacities = {
          }
          clientConnectionEndpointPort = 2020
          durabilityLevel              = "Bronze"
          httpGatewayEndpointPort      = 80
          isPrimary                    = true
          isStateless                  = false
          multipleAvailabilityZones    = false
          name                         = "first"
          placementProperties = {
          }
          vmInstanceCount = 3
        },
      ]
      reliabilityLevel = "Bronze"
      upgradeMode      = "Automatic"
      vmImage          = "Windows"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Comentários

Esta página foi útil?

Last updated on 2026-02-18