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

Microsoft.ServiceFabric managedClusters 2022-10-01-preview

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

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

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

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

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

resource symbolicname 'Microsoft.ServiceFabric/managedClusters@2022-10-01-preview' = {
  scope: resourceSymbolicName or scope
  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'
    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'
        ]
      }
    ]
    serviceEndpoints: [
      {
        locations: [
          'string'
        ]
        service: 'string'
      }
    ]
    subnetId: 'string'
    useCustomVnet: bool
    zonalResiliency: bool
    zonalUpdateMode: 'string'
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

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

Microsoft.ServiceFabric/managedClusters

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

ApplicationTypeVersionsCleanupPolicy

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

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

AzureActiveDirectory

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

Клиентский сертификат

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

ИПТаг

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

Правило балансировки нагрузки

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

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

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

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

ManagedClusterProperties (Свойства управляемого кластера)

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

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

Правило сетевой безопасности

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

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

Теги ресурса

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

ServiceEndpoint

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

НастройкиПараметрОписание

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

НастройкиРазделОписание

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

Артикул

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

Подсеть

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

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

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

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

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

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

{
  "type": "Microsoft.ServiceFabric/managedClusters",
  "apiVersion": "2022-10-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",
    "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" ]
      }
    ],
    "serviceEndpoints": [
      {
        "locations": [ "string" ],
        "service": "string"
      }
    ],
    "subnetId": "string",
    "useCustomVnet": "bool",
    "zonalResiliency": "bool",
    "zonalUpdateMode": "string"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

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

Microsoft.ServiceFabric/managedClusters

Имя Описание Ценность
apiVersion Версия API «2022-10-01-превью»
расположение Расположение ресурсов Azure. строка (обязательно)
имя имя ресурса. строка (обязательно)
свойства Свойства ресурса управляемого кластера ManagedClusterProperties (Свойства управляемого кластера)
SKU (Единица учета запасов) SKU управляемого кластера SKU
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
тип Тип ресурса "Microsoft.ServiceFabric/managedClusters"

ApplicationTypeVersionsCleanupPolicy

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

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

AzureActiveDirectory

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

Клиентский сертификат

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

ИПТаг

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

Правило балансировки нагрузки

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

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

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

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

ManagedClusterProperties (Свойства управляемого кластера)

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

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

Правило сетевой безопасности

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

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

Теги ресурса

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

ServiceEndpoint

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

НастройкиПараметрОписание

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

НастройкиРазделОписание

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

Артикул

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

Подсеть

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

Примеры использования

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

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

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/managedClusters@2022-10-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    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"
      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"
          ]
        }
      ]
      serviceEndpoints = [
        {
          locations = [
            "string"
          ]
          service = "string"
        }
      ]
      subnetId = "string"
      useCustomVnet = bool
      zonalResiliency = bool
      zonalUpdateMode = "string"
    }
    sku = {
      name = "string"
    }
  }
}

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

Microsoft.ServiceFabric/managedClusters

Имя Описание Ценность
расположение Расположение ресурсов Azure. строка (обязательно)
имя имя ресурса. строка (обязательно)
parent_id Идентификатор ресурса для применения этого ресурса расширения. строка (обязательно)
свойства Свойства ресурса управляемого кластера ManagedClusterProperties (Свойства управляемого кластера)
SKU (Единица учета запасов) SKU управляемого кластера SKU
Теги Теги ресурсов Словарь имен и значений тегов.
тип Тип ресурса "Microsoft.ServiceFabric/managedClusters@2022-10-01-preview"

ApplicationTypeVersionsCleanupPolicy

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

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

AzureActiveDirectory

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

Клиентский сертификат

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

ИПТаг

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

Правило балансировки нагрузки

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

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

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

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

ManagedClusterProperties (Свойства управляемого кластера)

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

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

Правило сетевой безопасности

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

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

Теги ресурса

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

ServiceEndpoint

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

НастройкиПараметрОписание

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

НастройкиРазделОписание

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

Артикул

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

Подсеть

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

Примеры использования

Примеры Terraform

Простой пример развертывания группы ресурсов.

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"
}

variable "admin_username" {
  type        = string
  description = "The administrator username for the Service Fabric managed cluster"
}

variable "admin_password" {
  type        = string
  description = "The administrator password for the Service Fabric managed cluster"
  sensitive   = true
}

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

resource "azapi_resource" "managedCluster" {
  type      = "Microsoft.ServiceFabric/managedClusters@2021-05-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      addonFeatures = [
        "DnsService",
      ]
      adminPassword             = var.admin_password
      adminUserName             = var.admin_username
      clientConnectionPort      = 12345
      clusterUpgradeCadence     = "Wave0"
      dnsName                   = var.resource_name
      httpGatewayConnectionPort = 23456
      loadBalancingRules = [
        {
          backendPort      = 8000
          frontendPort     = 443
          probeProtocol    = "http"
          probeRequestPath = "/"
          protocol         = "tcp"
        },
      ]
      networkSecurityRules = [
        {
          access = "allow"
          destinationAddressPrefixes = [
            "0.0.0.0/0",
          ]
          destinationPortRanges = [
            "443",
          ]
          direction = "inbound"
          name      = "rule443-allow-fe"
          priority  = 1000
          protocol  = "tcp"
          sourceAddressPrefixes = [
            "0.0.0.0/0",
          ]
          sourcePortRanges = [
            "1-65535",
          ]
        },
      ]
    }
    sku = {
      name = "Standard"
    }
    tags = {
      Test = "value"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}
  • Last updated on