Поделиться через


Microsoft.ServiceFabric managedClusters 2023-09-01-preview

Определение ресурсов Bicep

Тип ресурса managedClusters можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.ServiceFabric/managedClusters, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.ServiceFabric/managedClusters@2023-09-01-preview' = {
  location: 'string'
  name: 'string'
  properties: {
    addonFeatures: [
      'string'
    ]
    adminPassword: 'string'
    adminUserName: 'string'
    allowRdpAccess: bool
    applicationTypeVersionsCleanupPolicy: {
      maxUnusedVersionsToKeep: int
    }
    auxiliarySubnets: [
      {
        enableIpv6: bool
        name: 'string'
        networkSecurityGroupId: 'string'
        privateEndpointNetworkPolicies: 'string'
        privateLinkServiceNetworkPolicies: 'string'
      }
    ]
    azureActiveDirectory: {
      clientApplication: 'string'
      clusterApplication: 'string'
      tenantId: 'string'
    }
    clientConnectionPort: int
    clients: [
      {
        commonName: 'string'
        isAdmin: bool
        issuerThumbprint: 'string'
        thumbprint: 'string'
      }
    ]
    clusterCodeVersion: 'string'
    clusterUpgradeCadence: 'string'
    clusterUpgradeMode: 'string'
    ddosProtectionPlanId: 'string'
    dnsName: 'string'
    enableAutoOSUpgrade: bool
    enableIpv6: bool
    enableServicePublicIP: bool
    fabricSettings: [
      {
        name: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
      }
    ]
    httpGatewayConnectionPort: int
    ipTags: [
      {
        ipTagType: 'string'
        tag: 'string'
      }
    ]
    loadBalancingRules: [
      {
        backendPort: int
        frontendPort: int
        loadDistribution: 'string'
        probePort: int
        probeProtocol: 'string'
        probeRequestPath: 'string'
        protocol: 'string'
      }
    ]
    networkSecurityRules: [
      {
        access: 'string'
        description: 'string'
        destinationAddressPrefix: 'string'
        destinationAddressPrefixes: [
          'string'
        ]
        destinationPortRange: 'string'
        destinationPortRanges: [
          'string'
        ]
        direction: 'string'
        name: 'string'
        priority: int
        protocol: 'string'
        sourceAddressPrefix: 'string'
        sourceAddressPrefixes: [
          'string'
        ]
        sourcePortRange: 'string'
        sourcePortRanges: [
          'string'
        ]
      }
    ]
    publicIPPrefixId: 'string'
    serviceEndpoints: [
      {
        locations: [
          'string'
        ]
        service: 'string'
      }
    ]
    subnetId: 'string'
    useCustomVnet: bool
    zonalResiliency: bool
    zonalUpdateMode: 'string'
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Значения свойств

ApplicationTypeVersionsCleanupPolicy

Имя Описание Ценность
maxUnusedVersionsToKeep Количество неиспользуемых версий для каждого типа приложения. int

Ограничения целостности:
Минимальное значение = 0 (обязательно)

AzureActiveDirectory

Имя Описание Ценность
clientApplication Идентификатор клиентского приложения Azure Active Directory. струна
clusterApplication Идентификатор приложения кластера Azure Active Directory. струна
tenantId Идентификатор клиента Azure Active Directory. струна

ClientCertificate

Имя Описание Ценность
commonName Общее имя сертификата. струна
isAdmin Указывает, имеет ли сертификат клиента доступ администратора к кластеру. Клиенты, не являющиеся администраторами, могут выполнять только операции только для чтения в кластере. bool (обязательно)
issuerThumbprint Отпечаток издателя для сертификата. Используется только вместе с CommonName. струна
Отпечаток Отпечаток сертификата. струна

IPTag

Имя Описание Ценность
ipTagType Тип тега IP. строка (обязательно)
ярлык Значение тега IP. строка (обязательно)

LoadBalancingRule

Имя Описание Ценность
серверный порт Порт, используемый для внутренних подключений в конечной точке. Допустимые значения : от 1 до 65535. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 65534 (обязательно)
frontendPort Порт для внешней конечной точки. Номера портов для каждого правила должны быть уникальными в load Balancer. Допустимые значения : от 1 до 65534. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 65534 (обязательно)
loadDistribution Политика распределения нагрузки для этого правила. струна
probePort Порт prob, используемый правилом балансировки нагрузки. Допустимые значения : от 1 до 65535. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 65534
probeProtocol Ссылка на пробу подсистемы балансировки нагрузки, используемую правилом балансировки нагрузки. "http"
Https
Tcp (обязательно)
probeRequestPath Путь запроса пробы. Поддерживается только для проб HTTP/HTTPS. струна
протокол Ссылка на транспортный протокол, используемый правилом балансировки нагрузки. Tcp
"udp" (обязательно)

ManagedClusterProperties

Имя Описание Ценность
addonFeatures Список функций надстройки для включения в кластере. Массив строк, содержащий любой из:
BackupRestoreService
"DnsService"
ResourceMonitorService
adminPassword Пароль пользователя администратора виртуальной машины. струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
adminUserName Имя пользователя администратора виртуальной машины. строка (обязательно)
allowRdpAccess Если задано значение true, это позволяет RDP получить доступ к виртуальной машине. Правило NSG по умолчанию открывает порт RDP в Интернет, который можно переопределить пользовательскими правилами безопасности сети. Значение по умолчанию для этого параметра равно false. bool
applicationTypeVersionsCleanupPolicy Политика, используемая для очистки неиспользуемых версий. ApplicationTypeVersionsCleanupPolicy
вспомогательныеSubnets Вспомогательные подсети для кластера. подсети[]
azureActiveDirectory Параметры проверки подлинности AAD кластера. AzureActiveDirectory
clientConnectionPort Порт, используемый для клиентских подключений к кластеру. int
Клиентов Сертификаты клиента, которым разрешено управлять кластером. ClientCertificate[]
clusterCodeVersion Версия среды выполнения Service Fabric кластера. Это свойство необходимо, если clusterUpgradeMode имеет значение Manual. Чтобы получить список доступных версий Service Fabric для новых кластеров, используйте API ClusterVersion. Чтобы получить список доступных версий для существующих кластеров, используйте availableClusterVersions. струна
clusterUpgradeCadence Указывает, когда будут применены новые обновления версий среды выполнения кластера после их выпуска. По умолчанию используется Wave0. Применяется только в том случае, если clusterUpgradeMode имеет значение Automatic. "Wave0"
"Волна1"
"Волна2"
clusterUpgradeMode Режим обновления кластера, когда доступна новая версия среды выполнения Service Fabric. "Автоматически"
"Вручную"
ddosProtectionPlanId Укажите идентификатор ресурса плана защиты сети DDoS, который будет связан с виртуальной сетью кластера. струна
dnsName Dns-имя кластера. строка (обязательно)
enableAutoOSUpgrade Если задано значение true, это позволяет автоматически обновлять ОС для типов узлов, созданных с помощью любого образа ОС платформы с последней версией. Значение по умолчанию для этого параметра равно false. bool
enableIpv6 Если задано значение true, создается адресное пространство IPv6 для виртуальной сети по умолчанию, используемой кластером. Этот параметр нельзя изменить после создания кластера. Значение по умолчанию для этого параметра равно false. bool
enableServicePublicIP При задании этого значения значение true будет связывать IPv4-адрес в качестве ServicePublicIP адреса IPv6. Его можно задать только в том случае, если протокол IPv6 включен в кластере. bool
fabricSettings Список настраиваемых параметров структуры для настройки кластера. SettingsSectionDescription[]
httpGatewayConnectionPort Порт, используемый для HTTP-подключений к кластеру. int
ipTags Список тегов IP-адресов, связанных с общедоступным IP-адресом кластера по умолчанию. IPTag[]
loadBalancingRules Правила балансировки нагрузки, применяемые к общедоступной подсистеме балансировки нагрузки кластера. LoadBalancingRule[]
networkSecurityRules Пользовательские правила безопасности сети, применяемые к виртуальной сети кластера. NetworkSecurityRule[]
publicIPPrefixId Укажите идентификатор ресурса префикса общедоступного IP-адреса, из которому подсистема балансировки нагрузки выделяет общедоступный IP-адрес. Поддерживает только IPv4. струна
serviceEndpoints Конечные точки службы для подсетей в кластере. ServiceEndpoint[]
SubnetId При указании типы узлов для кластера создаются в этой подсети вместо виртуальной сети по умолчанию. networkSecurityRules, указанные для кластера, также применяются к этой подсети. Этот параметр нельзя изменить после создания кластера. струна
useCustomVnet Для новых кластеров этот параметр указывает, что он использует собственную виртуальную сеть, но подсеть указана на уровне типа узла; для таких кластеров свойство subnetId требуется для типов узлов. bool
зональРесилиентность Указывает, имеет ли кластер устойчивость зоны. bool
zonalUpdateMode Указывает режим обновления для кластеров Cross Az. "Быстрый"
"Стандартный"

Microsoft.ServiceFabric/managedClusters

Имя Описание Ценность
местоположение Расположение ресурсов Azure. строка (обязательно)
имя Имя ресурса строка (обязательно)
свойства Свойства ресурса управляемого кластера ManagedClusterProperties
SKU SKU управляемого кластера Sku (обязательно)
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

NetworkSecurityRule

Имя Описание Ценность
доступ Сетевой трафик разрешен или запрещен. "разрешить"
"запрет" (обязательно)
описание Описание правила безопасности сети. струна
destinationAddressPrefix Префикс адреса назначения. Диапазон IP-адресов CIDR или назначения. Звездочка "*" также может использоваться для сопоставления всех исходных IP-адресов. Также можно использовать теги по умолчанию, такие как VirtualNetwork, AzureLoadBalancer и Internet. струна
destinationAddressPrefixes Префиксы целевого адреса. Диапазоны IP-адресов CIDR или назначения. string[]
destinationPortRange он целевой порт или диапазон. Целое число или диапазон от 0 до 65535. Звездочка "*" также может использоваться для сопоставления всех портов. струна
destinationPortRanges Диапазоны портов назначения. string[]
направление Направление правила безопасности сети. "входящий трафик"
"исходящий" (обязательный)
имя Имя правила безопасности сети. строка (обязательно)
приоритет Приоритет правила. Значение может находиться в диапазоне от 1000 до 3000. Значения за пределами этого диапазона зарезервированы для поставщика ресурсов Service Fabric ManagerCluster. Номер приоритета должен быть уникальным для каждого правила в коллекции. Чем ниже число приоритета, тем выше приоритет правила. int

Ограничения целостности:
Минимальное значение = 1000
Максимальное значение = 3000 (обязательно)
протокол К этому правилу применяется сетевой протокол. 'ah'
'esp'
"http"
Https
'icmp'
Tcp
"udp" (обязательно)
sourceAddressPrefix Диапазон IP-адресов CIDR или источника. Звездочка "*" также может использоваться для сопоставления всех исходных IP-адресов. Также можно использовать теги по умолчанию, такие как VirtualNetwork, AzureLoadBalancer и Internet. Если это правило входящего трафика, указывает, откуда происходит сетевой трафик. струна
sourceAddressPrefixes Диапазоны IP-адресов CIDR или источника. string[]
sourcePortRange Исходный порт или диапазон. Целое число или диапазон от 0 до 65535. Звездочка "*" также может использоваться для сопоставления всех портов. струна
sourcePortRanges Диапазоны исходных портов. string[]

ResourceTags

Имя Описание Ценность

ServiceEndpoint

Имя Описание Ценность
Местонахождения Список расположений. string[]
служба Тип службы конечных точек. строка (обязательно)

SettingsParameterDescription

Имя Описание Ценность
имя Имя параметра структуры. строка (обязательно)
ценность Значение параметра параметра структуры. строка (обязательно)

SettingsSectionDescription

Имя Описание Ценность
имя Имя раздела параметров структуры. строка (обязательно)
Параметры Коллекция параметров в разделе. SettingsParameterDescription[] (обязательно)

Sku

Имя Описание Ценность
имя Имя SKU. "Базовый"
"Стандартный" (обязательный)

Подсеть

Имя Описание Ценность
enableIpv6 Указывает, что параметр wether включает ipv6 или нет. Если он не указан, он займет ту же конфигурацию, что и кластер. bool
имя Имя подсети. строка (обязательно)
networkSecurityGroupId Полный идентификатор ресурса для группы безопасности сети. струна
privateEndpointNetworkPolicies Включение или отключение применения политик сети к частной конечной точке в подсети. "отключено"
"Включено"
privateLinkServiceNetworkPolicies Включение или отключение применения политик сети к службе приватного канала в подсети. "отключено"
"Включено"

Определение ресурса шаблона ARM

Тип ресурса managedClusters можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.ServiceFabric/managedClusters, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.ServiceFabric/managedClusters",
  "apiVersion": "2023-09-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "addonFeatures": [ "string" ],
    "adminPassword": "string",
    "adminUserName": "string",
    "allowRdpAccess": "bool",
    "applicationTypeVersionsCleanupPolicy": {
      "maxUnusedVersionsToKeep": "int"
    },
    "auxiliarySubnets": [
      {
        "enableIpv6": "bool",
        "name": "string",
        "networkSecurityGroupId": "string",
        "privateEndpointNetworkPolicies": "string",
        "privateLinkServiceNetworkPolicies": "string"
      }
    ],
    "azureActiveDirectory": {
      "clientApplication": "string",
      "clusterApplication": "string",
      "tenantId": "string"
    },
    "clientConnectionPort": "int",
    "clients": [
      {
        "commonName": "string",
        "isAdmin": "bool",
        "issuerThumbprint": "string",
        "thumbprint": "string"
      }
    ],
    "clusterCodeVersion": "string",
    "clusterUpgradeCadence": "string",
    "clusterUpgradeMode": "string",
    "ddosProtectionPlanId": "string",
    "dnsName": "string",
    "enableAutoOSUpgrade": "bool",
    "enableIpv6": "bool",
    "enableServicePublicIP": "bool",
    "fabricSettings": [
      {
        "name": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ]
      }
    ],
    "httpGatewayConnectionPort": "int",
    "ipTags": [
      {
        "ipTagType": "string",
        "tag": "string"
      }
    ],
    "loadBalancingRules": [
      {
        "backendPort": "int",
        "frontendPort": "int",
        "loadDistribution": "string",
        "probePort": "int",
        "probeProtocol": "string",
        "probeRequestPath": "string",
        "protocol": "string"
      }
    ],
    "networkSecurityRules": [
      {
        "access": "string",
        "description": "string",
        "destinationAddressPrefix": "string",
        "destinationAddressPrefixes": [ "string" ],
        "destinationPortRange": "string",
        "destinationPortRanges": [ "string" ],
        "direction": "string",
        "name": "string",
        "priority": "int",
        "protocol": "string",
        "sourceAddressPrefix": "string",
        "sourceAddressPrefixes": [ "string" ],
        "sourcePortRange": "string",
        "sourcePortRanges": [ "string" ]
      }
    ],
    "publicIPPrefixId": "string",
    "serviceEndpoints": [
      {
        "locations": [ "string" ],
        "service": "string"
      }
    ],
    "subnetId": "string",
    "useCustomVnet": "bool",
    "zonalResiliency": "bool",
    "zonalUpdateMode": "string"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Значения свойств

ApplicationTypeVersionsCleanupPolicy

Имя Описание Ценность
maxUnusedVersionsToKeep Количество неиспользуемых версий для каждого типа приложения. int

Ограничения целостности:
Минимальное значение = 0 (обязательно)

AzureActiveDirectory

Имя Описание Ценность
clientApplication Идентификатор клиентского приложения Azure Active Directory. струна
clusterApplication Идентификатор приложения кластера Azure Active Directory. струна
tenantId Идентификатор клиента Azure Active Directory. струна

ClientCertificate

Имя Описание Ценность
commonName Общее имя сертификата. струна
isAdmin Указывает, имеет ли сертификат клиента доступ администратора к кластеру. Клиенты, не являющиеся администраторами, могут выполнять только операции только для чтения в кластере. bool (обязательно)
issuerThumbprint Отпечаток издателя для сертификата. Используется только вместе с CommonName. струна
Отпечаток Отпечаток сертификата. струна

IPTag

Имя Описание Ценность
ipTagType Тип тега IP. строка (обязательно)
ярлык Значение тега IP. строка (обязательно)

LoadBalancingRule

Имя Описание Ценность
серверный порт Порт, используемый для внутренних подключений в конечной точке. Допустимые значения : от 1 до 65535. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 65534 (обязательно)
frontendPort Порт для внешней конечной точки. Номера портов для каждого правила должны быть уникальными в load Balancer. Допустимые значения : от 1 до 65534. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 65534 (обязательно)
loadDistribution Политика распределения нагрузки для этого правила. струна
probePort Порт prob, используемый правилом балансировки нагрузки. Допустимые значения : от 1 до 65535. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 65534
probeProtocol Ссылка на пробу подсистемы балансировки нагрузки, используемую правилом балансировки нагрузки. "http"
Https
Tcp (обязательно)
probeRequestPath Путь запроса пробы. Поддерживается только для проб HTTP/HTTPS. струна
протокол Ссылка на транспортный протокол, используемый правилом балансировки нагрузки. Tcp
"udp" (обязательно)

ManagedClusterProperties

Имя Описание Ценность
addonFeatures Список функций надстройки для включения в кластере. Массив строк, содержащий любой из:
BackupRestoreService
"DnsService"
ResourceMonitorService
adminPassword Пароль пользователя администратора виртуальной машины. струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
adminUserName Имя пользователя администратора виртуальной машины. строка (обязательно)
allowRdpAccess Если задано значение true, это позволяет RDP получить доступ к виртуальной машине. Правило NSG по умолчанию открывает порт RDP в Интернет, который можно переопределить пользовательскими правилами безопасности сети. Значение по умолчанию для этого параметра равно false. bool
applicationTypeVersionsCleanupPolicy Политика, используемая для очистки неиспользуемых версий. ApplicationTypeVersionsCleanupPolicy
вспомогательныеSubnets Вспомогательные подсети для кластера. подсети[]
azureActiveDirectory Параметры проверки подлинности AAD кластера. AzureActiveDirectory
clientConnectionPort Порт, используемый для клиентских подключений к кластеру. int
Клиентов Сертификаты клиента, которым разрешено управлять кластером. ClientCertificate[]
clusterCodeVersion Версия среды выполнения Service Fabric кластера. Это свойство необходимо, если clusterUpgradeMode имеет значение Manual. Чтобы получить список доступных версий Service Fabric для новых кластеров, используйте API ClusterVersion. Чтобы получить список доступных версий для существующих кластеров, используйте availableClusterVersions. струна
clusterUpgradeCadence Указывает, когда будут применены новые обновления версий среды выполнения кластера после их выпуска. По умолчанию используется Wave0. Применяется только в том случае, если clusterUpgradeMode имеет значение Automatic. "Wave0"
"Волна1"
"Волна2"
clusterUpgradeMode Режим обновления кластера, когда доступна новая версия среды выполнения Service Fabric. "Автоматически"
"Вручную"
ddosProtectionPlanId Укажите идентификатор ресурса плана защиты сети DDoS, который будет связан с виртуальной сетью кластера. струна
dnsName Dns-имя кластера. строка (обязательно)
enableAutoOSUpgrade Если задано значение true, это позволяет автоматически обновлять ОС для типов узлов, созданных с помощью любого образа ОС платформы с последней версией. Значение по умолчанию для этого параметра равно false. bool
enableIpv6 Если задано значение true, создается адресное пространство IPv6 для виртуальной сети по умолчанию, используемой кластером. Этот параметр нельзя изменить после создания кластера. Значение по умолчанию для этого параметра равно false. bool
enableServicePublicIP При задании этого значения значение true будет связывать IPv4-адрес в качестве ServicePublicIP адреса IPv6. Его можно задать только в том случае, если протокол IPv6 включен в кластере. bool
fabricSettings Список настраиваемых параметров структуры для настройки кластера. SettingsSectionDescription[]
httpGatewayConnectionPort Порт, используемый для HTTP-подключений к кластеру. int
ipTags Список тегов IP-адресов, связанных с общедоступным IP-адресом кластера по умолчанию. IPTag[]
loadBalancingRules Правила балансировки нагрузки, применяемые к общедоступной подсистеме балансировки нагрузки кластера. LoadBalancingRule[]
networkSecurityRules Пользовательские правила безопасности сети, применяемые к виртуальной сети кластера. NetworkSecurityRule[]
publicIPPrefixId Укажите идентификатор ресурса префикса общедоступного IP-адреса, из которому подсистема балансировки нагрузки выделяет общедоступный IP-адрес. Поддерживает только IPv4. струна
serviceEndpoints Конечные точки службы для подсетей в кластере. ServiceEndpoint[]
SubnetId При указании типы узлов для кластера создаются в этой подсети вместо виртуальной сети по умолчанию. networkSecurityRules, указанные для кластера, также применяются к этой подсети. Этот параметр нельзя изменить после создания кластера. струна
useCustomVnet Для новых кластеров этот параметр указывает, что он использует собственную виртуальную сеть, но подсеть указана на уровне типа узла; для таких кластеров свойство subnetId требуется для типов узлов. bool
зональРесилиентность Указывает, имеет ли кластер устойчивость зоны. bool
zonalUpdateMode Указывает режим обновления для кластеров Cross Az. "Быстрый"
"Стандартный"

Microsoft.ServiceFabric/managedClusters

Имя Описание Ценность
apiVersion Версия API '2023-09-01-preview'
местоположение Расположение ресурсов Azure. строка (обязательно)
имя Имя ресурса строка (обязательно)
свойства Свойства ресурса управляемого кластера ManagedClusterProperties
SKU SKU управляемого кластера Sku (обязательно)
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
тип Тип ресурса "Microsoft.ServiceFabric/managedClusters"

NetworkSecurityRule

Имя Описание Ценность
доступ Сетевой трафик разрешен или запрещен. "разрешить"
"запрет" (обязательно)
описание Описание правила безопасности сети. струна
destinationAddressPrefix Префикс адреса назначения. Диапазон IP-адресов CIDR или назначения. Звездочка "*" также может использоваться для сопоставления всех исходных IP-адресов. Также можно использовать теги по умолчанию, такие как VirtualNetwork, AzureLoadBalancer и Internet. струна
destinationAddressPrefixes Префиксы целевого адреса. Диапазоны IP-адресов CIDR или назначения. string[]
destinationPortRange он целевой порт или диапазон. Целое число или диапазон от 0 до 65535. Звездочка "*" также может использоваться для сопоставления всех портов. струна
destinationPortRanges Диапазоны портов назначения. string[]
направление Направление правила безопасности сети. "входящий трафик"
"исходящий" (обязательный)
имя Имя правила безопасности сети. строка (обязательно)
приоритет Приоритет правила. Значение может находиться в диапазоне от 1000 до 3000. Значения за пределами этого диапазона зарезервированы для поставщика ресурсов Service Fabric ManagerCluster. Номер приоритета должен быть уникальным для каждого правила в коллекции. Чем ниже число приоритета, тем выше приоритет правила. int

Ограничения целостности:
Минимальное значение = 1000
Максимальное значение = 3000 (обязательно)
протокол К этому правилу применяется сетевой протокол. 'ah'
'esp'
"http"
Https
'icmp'
Tcp
"udp" (обязательно)
sourceAddressPrefix Диапазон IP-адресов CIDR или источника. Звездочка "*" также может использоваться для сопоставления всех исходных IP-адресов. Также можно использовать теги по умолчанию, такие как VirtualNetwork, AzureLoadBalancer и Internet. Если это правило входящего трафика, указывает, откуда происходит сетевой трафик. струна
sourceAddressPrefixes Диапазоны IP-адресов CIDR или источника. string[]
sourcePortRange Исходный порт или диапазон. Целое число или диапазон от 0 до 65535. Звездочка "*" также может использоваться для сопоставления всех портов. струна
sourcePortRanges Диапазоны исходных портов. string[]

ResourceTags

Имя Описание Ценность

ServiceEndpoint

Имя Описание Ценность
Местонахождения Список расположений. string[]
служба Тип службы конечных точек. строка (обязательно)

SettingsParameterDescription

Имя Описание Ценность
имя Имя параметра структуры. строка (обязательно)
ценность Значение параметра параметра структуры. строка (обязательно)

SettingsSectionDescription

Имя Описание Ценность
имя Имя раздела параметров структуры. строка (обязательно)
Параметры Коллекция параметров в разделе. SettingsParameterDescription[] (обязательно)

Sku

Имя Описание Ценность
имя Имя SKU. "Базовый"
"Стандартный" (обязательный)

Подсеть

Имя Описание Ценность
enableIpv6 Указывает, что параметр wether включает ipv6 или нет. Если он не указан, он займет ту же конфигурацию, что и кластер. bool
имя Имя подсети. строка (обязательно)
networkSecurityGroupId Полный идентификатор ресурса для группы безопасности сети. струна
privateEndpointNetworkPolicies Включение или отключение применения политик сети к частной конечной точке в подсети. "отключено"
"Включено"
privateLinkServiceNetworkPolicies Включение или отключение применения политик сети к службе приватного канала в подсети. "отключено"
"Включено"

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса managedClusters можно развернуть с помощью операций, предназначенных для следующих операций:

  • групп ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.ServiceFabric/managedClusters, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/managedClusters@2023-09-01-preview"
  name = "string"
  location = "string"
  body = jsonencode({
    properties = {
      addonFeatures = [
        "string"
      ]
      adminPassword = "string"
      adminUserName = "string"
      allowRdpAccess = bool
      applicationTypeVersionsCleanupPolicy = {
        maxUnusedVersionsToKeep = int
      }
      auxiliarySubnets = [
        {
          enableIpv6 = bool
          name = "string"
          networkSecurityGroupId = "string"
          privateEndpointNetworkPolicies = "string"
          privateLinkServiceNetworkPolicies = "string"
        }
      ]
      azureActiveDirectory = {
        clientApplication = "string"
        clusterApplication = "string"
        tenantId = "string"
      }
      clientConnectionPort = int
      clients = [
        {
          commonName = "string"
          isAdmin = bool
          issuerThumbprint = "string"
          thumbprint = "string"
        }
      ]
      clusterCodeVersion = "string"
      clusterUpgradeCadence = "string"
      clusterUpgradeMode = "string"
      ddosProtectionPlanId = "string"
      dnsName = "string"
      enableAutoOSUpgrade = bool
      enableIpv6 = bool
      enableServicePublicIP = bool
      fabricSettings = [
        {
          name = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
        }
      ]
      httpGatewayConnectionPort = int
      ipTags = [
        {
          ipTagType = "string"
          tag = "string"
        }
      ]
      loadBalancingRules = [
        {
          backendPort = int
          frontendPort = int
          loadDistribution = "string"
          probePort = int
          probeProtocol = "string"
          probeRequestPath = "string"
          protocol = "string"
        }
      ]
      networkSecurityRules = [
        {
          access = "string"
          description = "string"
          destinationAddressPrefix = "string"
          destinationAddressPrefixes = [
            "string"
          ]
          destinationPortRange = "string"
          destinationPortRanges = [
            "string"
          ]
          direction = "string"
          name = "string"
          priority = int
          protocol = "string"
          sourceAddressPrefix = "string"
          sourceAddressPrefixes = [
            "string"
          ]
          sourcePortRange = "string"
          sourcePortRanges = [
            "string"
          ]
        }
      ]
      publicIPPrefixId = "string"
      serviceEndpoints = [
        {
          locations = [
            "string"
          ]
          service = "string"
        }
      ]
      subnetId = "string"
      useCustomVnet = bool
      zonalResiliency = bool
      zonalUpdateMode = "string"
    }
  })
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
}

Значения свойств

ApplicationTypeVersionsCleanupPolicy

Имя Описание Ценность
maxUnusedVersionsToKeep Количество неиспользуемых версий для каждого типа приложения. int

Ограничения целостности:
Минимальное значение = 0 (обязательно)

AzureActiveDirectory

Имя Описание Ценность
clientApplication Идентификатор клиентского приложения Azure Active Directory. струна
clusterApplication Идентификатор приложения кластера Azure Active Directory. струна
tenantId Идентификатор клиента Azure Active Directory. струна

ClientCertificate

Имя Описание Ценность
commonName Общее имя сертификата. струна
isAdmin Указывает, имеет ли сертификат клиента доступ администратора к кластеру. Клиенты, не являющиеся администраторами, могут выполнять только операции только для чтения в кластере. bool (обязательно)
issuerThumbprint Отпечаток издателя для сертификата. Используется только вместе с CommonName. струна
Отпечаток Отпечаток сертификата. струна

IPTag

Имя Описание Ценность
ipTagType Тип тега IP. строка (обязательно)
ярлык Значение тега IP. строка (обязательно)

LoadBalancingRule

Имя Описание Ценность
серверный порт Порт, используемый для внутренних подключений в конечной точке. Допустимые значения : от 1 до 65535. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 65534 (обязательно)
frontendPort Порт для внешней конечной точки. Номера портов для каждого правила должны быть уникальными в load Balancer. Допустимые значения : от 1 до 65534. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 65534 (обязательно)
loadDistribution Политика распределения нагрузки для этого правила. струна
probePort Порт prob, используемый правилом балансировки нагрузки. Допустимые значения : от 1 до 65535. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 65534
probeProtocol Ссылка на пробу подсистемы балансировки нагрузки, используемую правилом балансировки нагрузки. "http"
Https
Tcp (обязательно)
probeRequestPath Путь запроса пробы. Поддерживается только для проб HTTP/HTTPS. струна
протокол Ссылка на транспортный протокол, используемый правилом балансировки нагрузки. Tcp
"udp" (обязательно)

ManagedClusterProperties

Имя Описание Ценность
addonFeatures Список функций надстройки для включения в кластере. Массив строк, содержащий любой из:
BackupRestoreService
"DnsService"
ResourceMonitorService
adminPassword Пароль пользователя администратора виртуальной машины. струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
adminUserName Имя пользователя администратора виртуальной машины. строка (обязательно)
allowRdpAccess Если задано значение true, это позволяет RDP получить доступ к виртуальной машине. Правило NSG по умолчанию открывает порт RDP в Интернет, который можно переопределить пользовательскими правилами безопасности сети. Значение по умолчанию для этого параметра равно false. bool
applicationTypeVersionsCleanupPolicy Политика, используемая для очистки неиспользуемых версий. ApplicationTypeVersionsCleanupPolicy
вспомогательныеSubnets Вспомогательные подсети для кластера. подсети[]
azureActiveDirectory Параметры проверки подлинности AAD кластера. AzureActiveDirectory
clientConnectionPort Порт, используемый для клиентских подключений к кластеру. int
Клиентов Сертификаты клиента, которым разрешено управлять кластером. ClientCertificate[]
clusterCodeVersion Версия среды выполнения Service Fabric кластера. Это свойство необходимо, если clusterUpgradeMode имеет значение Manual. Чтобы получить список доступных версий Service Fabric для новых кластеров, используйте API ClusterVersion. Чтобы получить список доступных версий для существующих кластеров, используйте availableClusterVersions. струна
clusterUpgradeCadence Указывает, когда будут применены новые обновления версий среды выполнения кластера после их выпуска. По умолчанию используется Wave0. Применяется только в том случае, если clusterUpgradeMode имеет значение Automatic. "Wave0"
"Волна1"
"Волна2"
clusterUpgradeMode Режим обновления кластера, когда доступна новая версия среды выполнения Service Fabric. "Автоматически"
"Вручную"
ddosProtectionPlanId Укажите идентификатор ресурса плана защиты сети DDoS, который будет связан с виртуальной сетью кластера. струна
dnsName Dns-имя кластера. строка (обязательно)
enableAutoOSUpgrade Если задано значение true, это позволяет автоматически обновлять ОС для типов узлов, созданных с помощью любого образа ОС платформы с последней версией. Значение по умолчанию для этого параметра равно false. bool
enableIpv6 Если задано значение true, создается адресное пространство IPv6 для виртуальной сети по умолчанию, используемой кластером. Этот параметр нельзя изменить после создания кластера. Значение по умолчанию для этого параметра равно false. bool
enableServicePublicIP При задании этого значения значение true будет связывать IPv4-адрес в качестве ServicePublicIP адреса IPv6. Его можно задать только в том случае, если протокол IPv6 включен в кластере. bool
fabricSettings Список настраиваемых параметров структуры для настройки кластера. SettingsSectionDescription[]
httpGatewayConnectionPort Порт, используемый для HTTP-подключений к кластеру. int
ipTags Список тегов IP-адресов, связанных с общедоступным IP-адресом кластера по умолчанию. IPTag[]
loadBalancingRules Правила балансировки нагрузки, применяемые к общедоступной подсистеме балансировки нагрузки кластера. LoadBalancingRule[]
networkSecurityRules Пользовательские правила безопасности сети, применяемые к виртуальной сети кластера. NetworkSecurityRule[]
publicIPPrefixId Укажите идентификатор ресурса префикса общедоступного IP-адреса, из которому подсистема балансировки нагрузки выделяет общедоступный IP-адрес. Поддерживает только IPv4. струна
serviceEndpoints Конечные точки службы для подсетей в кластере. ServiceEndpoint[]
SubnetId При указании типы узлов для кластера создаются в этой подсети вместо виртуальной сети по умолчанию. networkSecurityRules, указанные для кластера, также применяются к этой подсети. Этот параметр нельзя изменить после создания кластера. струна
useCustomVnet Для новых кластеров этот параметр указывает, что он использует собственную виртуальную сеть, но подсеть указана на уровне типа узла; для таких кластеров свойство subnetId требуется для типов узлов. bool
зональРесилиентность Указывает, имеет ли кластер устойчивость зоны. bool
zonalUpdateMode Указывает режим обновления для кластеров Cross Az. "Быстрый"
"Стандартный"

Microsoft.ServiceFabric/managedClusters

Имя Описание Ценность
местоположение Расположение ресурсов Azure. строка (обязательно)
имя Имя ресурса строка (обязательно)
свойства Свойства ресурса управляемого кластера ManagedClusterProperties
SKU SKU управляемого кластера Sku (обязательно)
Теги Теги ресурсов Словарь имен и значений тегов.
тип Тип ресурса "Microsoft.ServiceFabric/managedClusters@2023-09-01-preview"

NetworkSecurityRule

Имя Описание Ценность
доступ Сетевой трафик разрешен или запрещен. "разрешить"
"запрет" (обязательно)
описание Описание правила безопасности сети. струна
destinationAddressPrefix Префикс адреса назначения. Диапазон IP-адресов CIDR или назначения. Звездочка "*" также может использоваться для сопоставления всех исходных IP-адресов. Также можно использовать теги по умолчанию, такие как VirtualNetwork, AzureLoadBalancer и Internet. струна
destinationAddressPrefixes Префиксы целевого адреса. Диапазоны IP-адресов CIDR или назначения. string[]
destinationPortRange он целевой порт или диапазон. Целое число или диапазон от 0 до 65535. Звездочка "*" также может использоваться для сопоставления всех портов. струна
destinationPortRanges Диапазоны портов назначения. string[]
направление Направление правила безопасности сети. "входящий трафик"
"исходящий" (обязательный)
имя Имя правила безопасности сети. строка (обязательно)
приоритет Приоритет правила. Значение может находиться в диапазоне от 1000 до 3000. Значения за пределами этого диапазона зарезервированы для поставщика ресурсов Service Fabric ManagerCluster. Номер приоритета должен быть уникальным для каждого правила в коллекции. Чем ниже число приоритета, тем выше приоритет правила. int

Ограничения целостности:
Минимальное значение = 1000
Максимальное значение = 3000 (обязательно)
протокол К этому правилу применяется сетевой протокол. 'ah'
'esp'
"http"
Https
'icmp'
Tcp
"udp" (обязательно)
sourceAddressPrefix Диапазон IP-адресов CIDR или источника. Звездочка "*" также может использоваться для сопоставления всех исходных IP-адресов. Также можно использовать теги по умолчанию, такие как VirtualNetwork, AzureLoadBalancer и Internet. Если это правило входящего трафика, указывает, откуда происходит сетевой трафик. струна
sourceAddressPrefixes Диапазоны IP-адресов CIDR или источника. string[]
sourcePortRange Исходный порт или диапазон. Целое число или диапазон от 0 до 65535. Звездочка "*" также может использоваться для сопоставления всех портов. струна
sourcePortRanges Диапазоны исходных портов. string[]

ResourceTags

Имя Описание Ценность

ServiceEndpoint

Имя Описание Ценность
Местонахождения Список расположений. string[]
служба Тип службы конечных точек. строка (обязательно)

SettingsParameterDescription

Имя Описание Ценность
имя Имя параметра структуры. строка (обязательно)
ценность Значение параметра параметра структуры. строка (обязательно)

SettingsSectionDescription

Имя Описание Ценность
имя Имя раздела параметров структуры. строка (обязательно)
Параметры Коллекция параметров в разделе. SettingsParameterDescription[] (обязательно)

Sku

Имя Описание Ценность
имя Имя SKU. "Базовый"
"Стандартный" (обязательный)

Подсеть

Имя Описание Ценность
enableIpv6 Указывает, что параметр wether включает ipv6 или нет. Если он не указан, он займет ту же конфигурацию, что и кластер. bool
имя Имя подсети. строка (обязательно)
networkSecurityGroupId Полный идентификатор ресурса для группы безопасности сети. струна
privateEndpointNetworkPolicies Включение или отключение применения политик сети к частной конечной точке в подсети. "отключено"
"Включено"
privateLinkServiceNetworkPolicies Включение или отключение применения политик сети к службе приватного канала в подсети. "отключено"
"Включено"