다음을 통해 공유


Managed Clusters - Create Or Update

Service Fabric 관리형 클러스터 리소스를 만들거나 업데이트합니다.
Service Fabric 관리형 클러스터 리소스를 지정된 이름으로 Create 또는 업데이트합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabric/managedClusters/{clusterName}?api-version=2024-04-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
clusterName
path True

string

클러스터 리소스의 이름입니다.

resourceGroupName
path True

string

리소스 그룹의 이름.

subscriptionId
path True

string

고객 구독 식별자입니다.

api-version
query True

string

Service Fabric 리소스 공급자 API의 버전입니다. 이 매개 변수는 필수 매개 변수이며 이 사양의 값은 "2024-04-01"이어야 합니다.

요청 본문

Name 필수 형식 Description
location True

string

Azure 리소스 위치.

properties.adminUserName True

string

VM 관리자 사용자 이름입니다.

properties.dnsName True

string

클러스터 dns 이름입니다.

sku True

Sku

관리형 클러스터의 sku

properties.addonFeatures

ManagedClusterAddOnFeature[]

클러스터에서 사용하도록 설정할 추가 기능 목록입니다.

properties.adminPassword

string

VM 관리자 사용자 암호입니다.

properties.allowRdpAccess

boolean

이를 true로 설정하면 VM에 대한 RDP 액세스를 사용할 수 있습니다. 기본 NSG 규칙은 사용자 지정 네트워크 보안 규칙으로 재정의할 수 있는 인터넷으로 RDP 포트를 엽니다. 이 설정의 기본값은 false입니다.

properties.applicationTypeVersionsCleanupPolicy

ApplicationTypeVersionsCleanupPolicy

사용되지 않는 버전을 클린 데 사용되는 정책입니다.

properties.auxiliarySubnets

Subnet[]

클러스터에 대한 보조 서브넷입니다.

properties.azureActiveDirectory

AzureActiveDirectory

클러스터의 AAD 인증 설정입니다.

properties.clientConnectionPort

integer

클러스터에 대한 클라이언트 연결에 사용되는 포트입니다.

properties.clients

ClientCertificate[]

클러스터를 관리할 수 있는 클라이언트 인증서입니다.

properties.clusterCodeVersion

string

클러스터의 Service Fabric 런타임 버전입니다. clusterUpgradeMode가 '수동'으로 설정된 경우 이 속성이 필요합니다. 새 클러스터에 사용 가능한 Service Fabric 버전 목록을 얻으려면 ClusterVersion API를 사용합니다. 기존 클러스터에 사용 가능한 버전 목록을 얻으려면 availableClusterVersions를 사용합니다.

properties.clusterUpgradeCadence

clusterUpgradeCadence

새 클러스터 런타임 버전 업그레이드가 릴리스된 후 적용되는 시기를 나타냅니다. 기본적으로 Wave0입니다. clusterUpgradeMode가 '자동'으로 설정된 경우에만 적용됩니다.

properties.clusterUpgradeMode

ClusterUpgradeMode

새 Service Fabric 런타임 버전을 사용할 수 있는 경우 클러스터의 업그레이드 모드입니다.

properties.ddosProtectionPlanId

string

클러스터의 가상 네트워크와 연결될 DDoS 네트워크 보호 계획의 리소스 ID를 지정합니다.

properties.enableAutoOSUpgrade

boolean

이를 true로 설정하면 버전이 'latest'인 플랫폼 OS 이미지를 사용하여 만든 노드 유형에 대한 자동 OS 업그레이드가 가능합니다. 이 설정의 기본값은 false입니다.

properties.enableHttpGatewayExclusiveAuthMode

boolean

true이면 HttpGatewayEndpoint에서 토큰 기반 인증이 허용되지 않습니다. 이는 TLS 버전 1.3 이상을 지원하는 데 필요합니다. 토큰 기반 인증을 사용하는 경우 HttpGatewayTokenAuthConnectionPort를 정의해야 합니다.

properties.enableIpv6

boolean

이를 true로 설정하면 클러스터에서 사용하는 기본 VNet에 대한 IPv6 주소 공간이 만들어집니다. 클러스터를 만든 후에는 이 설정을 변경할 수 없습니다. 이 설정의 기본값은 false입니다.

properties.enableServicePublicIP

boolean

이를 true로 설정하면 IPv4 주소가 IPv6 주소의 ServicePublicIP로 연결됩니다. 클러스터에서 IPv6을 사용하도록 설정한 경우에만 True로 설정할 수 있습니다.

properties.fabricSettings

SettingsSectionDescription[]

클러스터를 구성할 사용자 지정 패브릭 설정 목록입니다.

properties.httpGatewayConnectionPort

integer

클러스터에 대한 HTTP 연결에 사용되는 포트입니다.

properties.httpGatewayTokenAuthConnectionPort

integer

클러스터에 대한 토큰 인증 기반 HTTPS 연결에 사용되는 포트입니다. HttpGatewayEndpoint와 동일한 포트로 설정할 수 없습니다.

properties.ipTags

IpTag[]

클러스터의 기본 공용 IP 주소와 연결된 IP 태그 목록입니다.

properties.loadBalancingRules

LoadBalancingRule[]

클러스터의 공용 부하 분산 장치에 적용되는 부하 분산 규칙입니다.

properties.networkSecurityRules

NetworkSecurityRule[]

클러스터의 Virtual Network 적용되는 사용자 지정 네트워크 보안 규칙입니다.

properties.publicIPPrefixId

string

부하 분산 장치가 공용 IPv4 주소를 할당할 공용 IPv4 접두사에 대한 리소스 ID를 지정합니다. 클러스터를 만든 후에는 이 설정을 변경할 수 없습니다.

properties.publicIPv6PrefixId

string

부하 분산 장치가 공용 IPv6 주소를 할당할 공용 IPv6 접두사에 대한 리소스 ID를 지정합니다. 클러스터를 만든 후에는 이 설정을 변경할 수 없습니다.

properties.serviceEndpoints

ServiceEndpoint[]

클러스터의 서브넷에 대한 서비스 엔드포인트입니다.

properties.subnetId

string

지정된 경우 클러스터의 노드 형식은 기본 VNet 대신 이 서브넷에 만들어집니다. 클러스터에 지정된 networkSecurityRules 도 이 서브넷에 적용됩니다. 클러스터를 만든 후에는 이 설정을 변경할 수 없습니다.

properties.upgradeDescription

ClusterUpgradePolicy

클러스터를 업그레이드할 때 사용할 정책입니다.

properties.useCustomVnet

boolean

새 클러스터의 경우 이 매개 변수는 Bring Your Own VNet을 사용하지만 서브넷은 노드 유형 수준에서 지정됨을 나타냅니다. 이러한 클러스터의 경우 노드 형식에 subnetId 속성이 필요합니다.

properties.zonalResiliency

boolean

클러스터에 영역 복원력이 있는지를 나타냅니다.

properties.zonalUpdateMode

ZonalUpdateMode

교차 Az 클러스터의 업데이트 모드를 나타냅니다.

tags

object

Azure 리소스 태그.

응답

Name 형식 Description
200 OK

ManagedCluster

작업이 성공적으로 완료되었습니다.

202 Accepted

ManagedCluster

요청이 수락되었고 작업이 비동기적으로 완료됩니다.

헤더

  • Azure-AsyncOperation: string
  • Location: string
Other Status Codes

ErrorModel

자세한 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

Put a cluster with maximum parameters
Put a cluster with minimum parameters

Put a cluster with maximum parameters

샘플 요청

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.ServiceFabric/managedClusters/myCluster?api-version=2024-04-01

{
  "location": "eastus",
  "tags": {},
  "sku": {
    "name": "Basic"
  },
  "properties": {
    "clusterUpgradeMode": "Manual",
    "clusterCodeVersion": "7.1.168.9494",
    "dnsName": "myCluster",
    "adminUserName": "vmadmin",
    "adminPassword": "{vm-password}",
    "clientConnectionPort": 19000,
    "httpGatewayConnectionPort": 19080,
    "loadBalancingRules": [
      {
        "frontendPort": 80,
        "backendPort": 80,
        "probePort": 80,
        "protocol": "http",
        "probeProtocol": "http"
      },
      {
        "frontendPort": 443,
        "backendPort": 443,
        "probePort": 443,
        "protocol": "http",
        "probeProtocol": "http"
      },
      {
        "frontendPort": 10000,
        "backendPort": 10000,
        "probePort": 10000,
        "protocol": "tcp",
        "probeProtocol": "http",
        "loadDistribution": "Default"
      }
    ],
    "allowRdpAccess": true,
    "networkSecurityRules": [
      {
        "name": "TestName",
        "protocol": "tcp",
        "access": "allow",
        "priority": 1010,
        "direction": "inbound",
        "sourcePortRanges": [
          "*"
        ],
        "destinationPortRanges": [
          "*"
        ],
        "sourceAddressPrefixes": [
          "*"
        ],
        "destinationAddressPrefixes": [
          "*"
        ],
        "description": "Test description"
      },
      {
        "name": "AllowARM",
        "protocol": "*",
        "sourcePortRange": "*",
        "sourceAddressPrefix": "AzureResourceManager",
        "destinationAddressPrefix": "*",
        "destinationPortRange": "33500-33699",
        "access": "allow",
        "priority": 2002,
        "direction": "inbound"
      }
    ],
    "fabricSettings": [
      {
        "name": "ManagedIdentityTokenService",
        "parameters": [
          {
            "name": "IsEnabled",
            "value": "true"
          }
        ]
      }
    ],
    "addonFeatures": [
      "DnsService",
      "BackupRestoreService",
      "ResourceMonitorService"
    ],
    "enableAutoOSUpgrade": true,
    "applicationTypeVersionsCleanupPolicy": {
      "maxUnusedVersionsToKeep": 3
    },
    "zonalResiliency": true,
    "zonalUpdateMode": "Fast",
    "enableIpv6": true,
    "publicIPPrefixId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.Network/publicIPPrefixes/myPublicIPPrefix",
    "publicIPv6PrefixId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.Network/publicIPPrefixes/myPublicIPv6Prefix",
    "ipTags": [
      {
        "ipTagType": "FirstPartyUsage",
        "tag": "SQL"
      }
    ],
    "auxiliarySubnets": [
      {
        "name": "testSubnet1",
        "enableIpv6": true,
        "privateEndpointNetworkPolicies": "enabled",
        "privateLinkServiceNetworkPolicies": "enabled",
        "networkSecurityGroupId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.Network/networkSecurityGroups/sn1"
      }
    ],
    "serviceEndpoints": [
      {
        "service": "Microsoft.Storage",
        "locations": [
          "eastus2",
          "usnorth"
        ]
      }
    ],
    "useCustomVnet": true,
    "ddosProtectionPlanId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.Network/ddosProtectionPlans/myDDoSProtectionPlan",
    "upgradeDescription": {
      "forceRestart": false,
      "monitoringPolicy": {
        "healthCheckWaitDuration": "00:05:00",
        "healthCheckStableDuration": "00:45:00",
        "healthCheckRetryTimeout": "00:55:00",
        "upgradeTimeout": "12:00:00",
        "upgradeDomainTimeout": "03:00:00"
      },
      "healthPolicy": {
        "maxPercentUnhealthyNodes": 10,
        "maxPercentUnhealthyApplications": 30
      },
      "deltaHealthPolicy": {
        "maxPercentDeltaUnhealthyNodes": 20,
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": 40,
        "maxPercentDeltaUnhealthyApplications": 40
      }
    },
    "httpGatewayTokenAuthConnectionPort": 19081,
    "enableHttpGatewayExclusiveAuthMode": true
  }
}

샘플 응답

Location: http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationResults/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2024-04-01
Azure-AsyncOperation: http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationStatus/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2024-04-01
{
  "type": "Microsoft.ServiceFabric/managedClusters",
  "location": "eastus",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedClusters/myCluster",
  "name": "myCluster",
  "tags": {},
  "etag": "W/\"636462502169240745\"",
  "sku": {
    "name": "Basic"
  },
  "properties": {
    "provisioningState": "Updating",
    "clusterId": "92584666-9889-4ae8-8d02-91902923d37f",
    "clusterUpgradeMode": "Manual",
    "clusterCodeVersion": "7.1.168.9494",
    "clusterState": "WaitingForNodes",
    "dnsName": "myCluster",
    "fqdn": "MyCluster.eastus.cloudapp.azure.com",
    "clusterCertificateThumbprints": [
      "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
    ],
    "clientConnectionPort": 19000,
    "httpGatewayConnectionPort": 19080,
    "loadBalancingRules": [
      {
        "frontendPort": 80,
        "backendPort": 80,
        "probePort": 80,
        "protocol": "http",
        "probeProtocol": "http"
      },
      {
        "frontendPort": 443,
        "backendPort": 443,
        "probePort": 443,
        "protocol": "http",
        "probeProtocol": "http"
      },
      {
        "frontendPort": 10000,
        "backendPort": 10000,
        "probePort": 10000,
        "protocol": "tcp",
        "probeProtocol": "tcp",
        "loadDistribution": "Default"
      }
    ],
    "allowRdpAccess": true,
    "networkSecurityRules": [
      {
        "name": "TestName",
        "protocol": "tcp",
        "access": "allow",
        "priority": 1010,
        "direction": "inbound",
        "sourcePortRanges": [
          "*"
        ],
        "destinationPortRanges": [
          "*"
        ],
        "sourceAddressPrefixes": [
          "*"
        ],
        "destinationAddressPrefixes": [
          "*"
        ],
        "description": "Test description"
      },
      {
        "name": "AllowARM",
        "protocol": "*",
        "sourcePortRange": "*",
        "sourceAddressPrefix": "AzureResourceManager",
        "destinationAddressPrefix": "*",
        "destinationPortRange": "33500-33699",
        "access": "allow",
        "priority": 2002,
        "direction": "inbound"
      }
    ],
    "adminUserName": "vmadmin",
    "fabricSettings": [
      {
        "name": "ManagedIdentityTokenService",
        "parameters": [
          {
            "name": "IsEnabled",
            "value": "true"
          }
        ]
      }
    ],
    "addonFeatures": [
      "DnsService",
      "BackupRestoreService",
      "ResourceMonitorService"
    ],
    "enableAutoOSUpgrade": true,
    "applicationTypeVersionsCleanupPolicy": {
      "maxUnusedVersionsToKeep": 3
    },
    "zonalResiliency": true,
    "zonalUpdateMode": "Fast",
    "enableIpv6": true,
    "enableServicePublicIP": true,
    "publicIPPrefixId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.Network/publicIPPrefixes/myPublicIPPrefix",
    "publicIPv6PrefixId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.Network/publicIPPrefixes/myPublicIPv6Prefix",
    "ipTags": [
      {
        "ipTagType": "FirstPartyUsage",
        "tag": "SQL"
      }
    ],
    "auxiliarySubnets": [
      {
        "name": "testSubnet1",
        "enableIpv6": true,
        "privateEndpointNetworkPolicies": "enabled",
        "privateLinkServiceNetworkPolicies": "enabled",
        "networkSecurityGroupId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.Network/networkSecurityGroups/sn1"
      }
    ],
    "serviceEndpoints": [
      {
        "service": "Microsoft.Storage",
        "locations": [
          "eastus2",
          "usnorth"
        ]
      }
    ],
    "useCustomVnet": true,
    "ddosProtectionPlanId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.Network/ddosProtectionPlans/myDDoSProtectionPlan",
    "upgradeDescription": {
      "forceRestart": false,
      "monitoringPolicy": {
        "healthCheckWaitDuration": "00:05:00",
        "healthCheckStableDuration": "00:45:00",
        "healthCheckRetryTimeout": "00:55:00",
        "upgradeTimeout": "12:00:00",
        "upgradeDomainTimeout": "03:00:00"
      },
      "healthPolicy": {
        "maxPercentUnhealthyNodes": 10,
        "maxPercentUnhealthyApplications": 30
      },
      "deltaHealthPolicy": {
        "maxPercentDeltaUnhealthyNodes": 20,
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": 40,
        "maxPercentDeltaUnhealthyApplications": 40
      }
    },
    "httpGatewayTokenAuthConnectionPort": 19081,
    "enableHttpGatewayExclusiveAuthMode": true
  }
}
Location: http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationResults/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2024-04-01
Azure-AsyncOperation: http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationStatus/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2024-04-01
{
  "type": "Microsoft.ServiceFabric/managedClusters",
  "location": "eastus",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedClusters/myCluster",
  "name": "myCluster",
  "tags": {},
  "etag": "W/\"636462502169240745\"",
  "sku": {
    "name": "Basic"
  },
  "properties": {
    "provisioningState": "Creating",
    "clusterId": "92584666-9889-4ae8-8d02-91902923d37f",
    "clusterUpgradeMode": "Manual",
    "clusterCodeVersion": "7.1.168.9494",
    "clusterState": "WaitingForNodes",
    "dnsName": "myCluster",
    "fqdn": "MyCluster.eastus.cloudapp.azure.com",
    "clusterCertificateThumbprints": [
      "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
    ],
    "clientConnectionPort": 19000,
    "httpGatewayConnectionPort": 19080,
    "loadBalancingRules": [
      {
        "frontendPort": 80,
        "backendPort": 80,
        "probePort": 80,
        "protocol": "http",
        "probeProtocol": "http"
      },
      {
        "frontendPort": 443,
        "backendPort": 443,
        "probePort": 443,
        "protocol": "http",
        "probeProtocol": "http"
      },
      {
        "frontendPort": 10000,
        "backendPort": 10000,
        "probePort": 10000,
        "protocol": "tcp",
        "probeProtocol": "tcp",
        "loadDistribution": "Default"
      }
    ],
    "allowRdpAccess": true,
    "networkSecurityRules": [
      {
        "name": "TestName",
        "protocol": "tcp",
        "access": "allow",
        "priority": 1010,
        "direction": "inbound",
        "sourcePortRanges": [
          "*"
        ],
        "destinationPortRanges": [
          "*"
        ],
        "sourceAddressPrefixes": [
          "*"
        ],
        "destinationAddressPrefixes": [
          "*"
        ],
        "description": "Test description"
      },
      {
        "name": "AllowARM",
        "protocol": "*",
        "sourcePortRange": "*",
        "sourceAddressPrefix": "AzureResourceManager",
        "destinationAddressPrefix": "*",
        "destinationPortRange": "33500-33699",
        "access": "allow",
        "priority": 2002,
        "direction": "inbound"
      }
    ],
    "adminUserName": "vmadmin",
    "fabricSettings": [
      {
        "name": "ManagedIdentityTokenService",
        "parameters": [
          {
            "name": "IsEnabled",
            "value": "true"
          }
        ]
      }
    ],
    "addonFeatures": [
      "DnsService",
      "BackupRestoreService",
      "ResourceMonitorService"
    ],
    "enableAutoOSUpgrade": true,
    "applicationTypeVersionsCleanupPolicy": {
      "maxUnusedVersionsToKeep": 3
    },
    "zonalResiliency": true,
    "zonalUpdateMode": "Fast",
    "enableIpv6": true,
    "enableServicePublicIP": true,
    "ipv6Address": "0000:0000:0000:0000:0000:0000:0000:0000",
    "publicIPPrefixId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.Network/publicIPPrefixes/myPublicIPPrefix",
    "publicIPv6PrefixId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.Network/publicIPPrefixes/myPublicIPv6Prefix",
    "ipTags": [
      {
        "ipTagType": "FirstPartyUsage",
        "tag": "SQL"
      }
    ],
    "auxiliarySubnets": [
      {
        "name": "testSubnet1",
        "enableIpv6": true,
        "privateEndpointNetworkPolicies": "enabled",
        "privateLinkServiceNetworkPolicies": "enabled",
        "networkSecurityGroupId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.Network/networkSecurityGroups/sn1"
      }
    ],
    "serviceEndpoints": [
      {
        "service": "Microsoft.Storage",
        "locations": [
          "eastus2",
          "usnorth"
        ]
      }
    ],
    "useCustomVnet": true,
    "ddosProtectionPlanId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.Network/ddosProtectionPlans/myDDoSProtectionPlan",
    "upgradeDescription": {
      "forceRestart": false,
      "monitoringPolicy": {
        "healthCheckWaitDuration": "00:05:00",
        "healthCheckStableDuration": "00:45:00",
        "healthCheckRetryTimeout": "00:55:00",
        "upgradeTimeout": "12:00:00",
        "upgradeDomainTimeout": "03:00:00"
      },
      "upgradeReplicaSetCheckTimeout": "49710.06:28:16",
      "healthPolicy": {
        "maxPercentUnhealthyNodes": 10,
        "maxPercentUnhealthyApplications": 30
      },
      "deltaHealthPolicy": {
        "maxPercentDeltaUnhealthyNodes": 20,
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": 40,
        "maxPercentDeltaUnhealthyApplications": 40
      }
    },
    "httpGatewayTokenAuthConnectionPort": 19081,
    "enableHttpGatewayExclusiveAuthMode": true
  }
}

Put a cluster with minimum parameters

샘플 요청

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.ServiceFabric/managedClusters/myCluster?api-version=2024-04-01

{
  "location": "eastus",
  "sku": {
    "name": "Basic"
  },
  "properties": {
    "clusterUpgradeMode": "Automatic",
    "clusterUpgradeCadence": "Wave1",
    "dnsName": "myCluster",
    "adminUserName": "vmadmin",
    "adminPassword": "{vm-password}",
    "fabricSettings": [
      {
        "name": "ManagedIdentityTokenService",
        "parameters": [
          {
            "name": "IsEnabled",
            "value": "true"
          }
        ]
      }
    ]
  }
}

샘플 응답

Location: http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationResults/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2024-04-01
Azure-AsyncOperation: http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationStatus/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2024-04-01
{
  "type": "Microsoft.ServiceFabric/managedClusters",
  "location": "eastus",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedClusters/myCluster",
  "name": "myCluster",
  "tags": {},
  "etag": "W/\"636462502169240745\"",
  "sku": {
    "name": "Basic"
  },
  "properties": {
    "provisioningState": "Updating",
    "clusterId": "92584666-9889-4ae8-8d02-91902923d37f",
    "clusterUpgradeMode": "Automatic",
    "clusterUpgradeCadence": "Wave1",
    "clusterState": "WaitingForNodes",
    "dnsName": "myCluster",
    "fqdn": "MyCluster.eastus.cloudapp.azure.com",
    "clusterCertificateThumbprints": [
      "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
    ],
    "clientConnectionPort": 19000,
    "httpGatewayConnectionPort": 19080,
    "loadBalancingRules": [],
    "adminUserName": "vmadmin",
    "fabricSettings": [
      {
        "name": "ManagedIdentityTokenService",
        "parameters": [
          {
            "name": "IsEnabled",
            "value": "true"
          }
        ]
      }
    ]
  }
}
Location: http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationResults/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2024-04-01
Azure-AsyncOperation: http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationStatus/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2024-04-01
{
  "type": "Microsoft.ServiceFabric/managedClusters",
  "location": "eastus",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedClusters/myCluster",
  "name": "myCluster",
  "tags": {},
  "etag": "W/\"636462502169240745\"",
  "sku": {
    "name": "Basic"
  },
  "properties": {
    "provisioningState": "Creating",
    "clusterId": "92584666-9889-4ae8-8d02-91902923d37f",
    "clusterUpgradeMode": "Automatic",
    "clusterUpgradeCadence": "Wave1",
    "clusterState": "WaitingForNodes",
    "dnsName": "myCluster",
    "fqdn": "MyCluster.eastus.cloudapp.azure.com",
    "clusterCertificateThumbprints": [
      "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
    ],
    "clientConnectionPort": 19000,
    "httpGatewayConnectionPort": 19080,
    "loadBalancingRules": [],
    "adminUserName": "vmadmin",
    "fabricSettings": [
      {
        "name": "ManagedIdentityTokenService",
        "parameters": [
          {
            "name": "IsEnabled",
            "value": "true"
          }
        ]
      }
    ]
  }
}

정의

Name Description
access

네트워크 트래픽이 허용되거나 거부됩니다.

ApplicationTypeVersionsCleanupPolicy

사용되지 않는 버전을 클린 데 사용되는 정책입니다. 정책을 명시적으로 지정하지 않으면 유지할 기본 사용되지 않는 애플리케이션 버전은 3이 됩니다.

AzureActiveDirectory

클러스터에서 AAD 인증을 사용하도록 설정하는 설정입니다.

ClientCertificate

클라이언트 인증서 정의.

ClusterHealthPolicy

클러스터 또는 클러스터 노드의 상태를 평가하는 데 사용되는 상태 정책을 정의합니다.

ClusterMonitoringPolicy

클러스터 업그레이드에 대한 모니터링 정책을 설명합니다.

ClusterState

클러스터의 현재 상태입니다.

clusterUpgradeCadence

새 클러스터 런타임 버전 업그레이드가 릴리스된 후 적용되는 시기를 나타냅니다. 기본적으로 Wave0입니다. clusterUpgradeMode가 '자동'으로 설정된 경우에만 적용됩니다.

ClusterUpgradeDeltaHealthPolicy

클러스터 업그레이드에 대한 델타 상태 정책을 설명합니다.

ClusterUpgradeMode

새 Service Fabric 런타임 버전을 사용할 수 있는 경우 클러스터의 업그레이드 모드입니다.

ClusterUpgradePolicy

클러스터를 업그레이드할 때 사용되는 정책을 설명합니다.

direction

네트워크 보안 규칙 방향.

ErrorModel

오류의 구조입니다.

ErrorModelError

오류 세부 정보입니다.

IpTag

공용 IP 주소와 연결된 IP 태그입니다.

LoadBalancingRule

부하 분산 규칙에 대해 설명합니다.

ManagedCluster

관리형 클러스터 리소스

ManagedClusterAddOnFeature

사용 가능한 클러스터 추가 기능

ManagedResourceProvisioningState

관리되는 리소스의 프로비전 상태입니다.

NetworkSecurityRule

네트워크 보안 규칙을 설명합니다.

nsgProtocol

이 규칙이 적용되는 네트워크 프로토콜입니다.

privateEndpointNetworkPolicies

서브넷의 프라이빗 엔드포인트에 네트워크 정책 적용을 사용하거나 사용하지 않도록 설정합니다.

privateLinkServiceNetworkPolicies

서브넷의 프라이빗 링크 서비스에 네트워크 정책 적용을 사용하거나 사용하지 않도록 설정합니다.

probeProtocol

부하 분산 규칙에서 사용하는 부하 분산 장치 프로브에 대한 참조입니다.

protocol

부하 분산 규칙에서 사용하는 전송 프로토콜에 대한 참조입니다.

ServiceEndpoint

서비스 엔드포인트 속성입니다.

SettingsParameterDescription

클러스터의 패브릭 설정에서 매개 변수를 설명합니다.

SettingsSectionDescription

클러스터의 패브릭 설정에 있는 섹션에 대해 설명합니다.

Sku

Service Fabric 관리형 클러스터 SKU 정의

SkuName

Sku 이름입니다.

Subnet

서브넷에 대해 설명합니다.

SystemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

ZonalUpdateMode

교차 Az 클러스터의 업데이트 모드를 나타냅니다.

access

네트워크 트래픽이 허용되거나 거부됩니다.

Name 형식 Description
allow

string

deny

string

ApplicationTypeVersionsCleanupPolicy

사용되지 않는 버전을 클린 데 사용되는 정책입니다. 정책을 명시적으로 지정하지 않으면 유지할 기본 사용되지 않는 애플리케이션 버전은 3이 됩니다.

Name 형식 Description
maxUnusedVersionsToKeep

integer

유지할 애플리케이션 유형당 사용되지 않는 버전 수입니다.

AzureActiveDirectory

클러스터에서 AAD 인증을 사용하도록 설정하는 설정입니다.

Name 형식 Description
clientApplication

string

Azure Active Directory 클라이언트 애플리케이션 ID입니다.

clusterApplication

string

Azure Active Directory 클러스터 애플리케이션 ID입니다.

tenantId

string

Azure Active Directory 테넌트 ID입니다.

ClientCertificate

클라이언트 인증서 정의.

Name 형식 Description
commonName

string

인증서 일반 이름입니다.

isAdmin

boolean

클라이언트 인증서에 클러스터에 대한 관리자 액세스 권한이 있는지를 나타냅니다. 관리자가 아닌 클라이언트는 클러스터에서 읽기 전용 작업만 수행할 수 있습니다.

issuerThumbprint

string

인증서에 대한 발급자 지문입니다. CommonName과 함께만 사용됩니다.

thumbprint

string

인증서 지문입니다.

ClusterHealthPolicy

클러스터 또는 클러스터 노드의 상태를 평가하는 데 사용되는 상태 정책을 정의합니다.

Name 형식 Default value Description
maxPercentUnhealthyApplications

integer

0

오류를 보고하기 전에 허용되는 비정상 애플리케이션의 최대 백분율입니다. 예를 들어 애플리케이션의 10%를 비정상 상태가 되도록 허용하면 값은 10입니다.

비율은 클러스터에서 오류로 처리하기 전에 비정상 상태로 있을 수 있는 애플리케이션의 최대 허용 비율을 나타냅니다. 비율은 지켜지나 비정상 애플리케이션이 적어도 하나 있다면 상태는 경고로 평가됩니다. 이 값은 클러스터에 있는 애플리케이션 인스턴스의 총 수를 비정상 애플리케이션의 수로 나눠 계산합니다. 이 때 ApplicationTypeHealthPolicyMap에 포함된 애플리케이션 형식의 애플리케이션은 제외합니다. 계산값은 적은 수의 애플리케이션에서 오류 하나를 허용할 수 있도록 반올림됩니다. 기본 비율은 0입니다.

maxPercentUnhealthyNodes

integer

0

오류를 보고하기 전에 허용되는 비정상 노드의 최대 백분율입니다. 예를 들어 노드의 10%를 비정상 상태가 되도록 허용하면 값은 10입니다.

비율은 클러스터에서 오류로 처리하기 전에 비정상 상태로 있을 수 있는 노드의 최대 허용 비율을 나타냅니다. 비율은 지켜지나 비정상 노드가 적어도 하나 있다면 상태는 경고로 평가됩니다. 이 백분율은 클러스터에 있는 노드 총 수를 비정상 노드 수로 나눠 계산합니다. 계산값은 적은 수의 노드에서 오류 하나를 허용할 수 있도록 반올림됩니다. 기본 비율은 0입니다.

대형 클러스터에는 항상 복구를 위해 다운되거나 중단되는 노드가 있으므로 이를 감안하여 이 비율을 구성해야 합니다.

ClusterMonitoringPolicy

클러스터 업그레이드에 대한 모니터링 정책을 설명합니다.

Name 형식 Description
healthCheckRetryTimeout

string

업그레이드가 롤백되기 전에 애플리케이션 또는 클러스터가 비정상일 때 상태 평가를 다시 시도하는 시간입니다. 시간 제한은 hh:mm:ss 또는 d.hh:mm:ss.ms 형식일 수 있습니다.

healthCheckStableDuration

string

업그레이드가 다음 업그레이드 도메인으로 진행되기 전에 애플리케이션 또는 클러스터가 정상 상태로 유지되어야 하는 시간입니다. 기간은 hh:mm:ss 또는 d.hh:mm:ss.ms 형식일 수 있습니다.

healthCheckWaitDuration

string

상태 검사를 수행하기 전에 업그레이드 도메인을 완료한 후 대기할 시간입니다. 기간은 hh:mm:ss 또는 d.hh:mm:ss.ms 형식일 수 있습니다.

upgradeDomainTimeout

string

업그레이드가 롤백되기 전에 각 업그레이드 도메인을 완료해야 하는 시간입니다. 시간 제한은 hh:mm:ss 또는 d.hh:mm:ss.ms 형식일 수 있습니다.

upgradeTimeout

string

업그레이드가 롤백되기 전에 전체 업그레이드를 완료해야 하는 시간입니다. 시간 제한은 hh:mm:ss 또는 d.hh:mm:ss.ms 형식일 수 있습니다.

ClusterState

클러스터의 현재 상태입니다.

Name 형식 Description
BaselineUpgrade

string

클러스터 버전을 설정하기 위해 클러스터가 업그레이드 중임을 나타냅니다. 이 업그레이드는 클러스터가 처음으로 부팅될 때 자동으로 시작됩니다.

Deploying

string

Service Fabric 런타임이 VM에 설치되고 있음을 나타냅니다. 클러스터 리소스는 클러스터가 부팅되고 시스템 서비스가 작동할 때까지 이 상태가 됩니다.

Ready

string

클러스터가 안정적인 상태임을 나타냅니다.

UpgradeFailed

string

클러스터의 마지막 업그레이드가 실패했음을 나타냅니다.

Upgrading

string

사용자가 제공한 구성을 사용하여 클러스터를 업그레이드 중임을 나타냅니다.

WaitingForNodes

string

클러스터 리소스가 생성되고 리소스 공급자가 Service Fabric VM 확장이 부팅되어 보고되기를 기다리고 있음을 나타냅니다.

clusterUpgradeCadence

새 클러스터 런타임 버전 업그레이드가 릴리스된 후 적용되는 시기를 나타냅니다. 기본적으로 Wave0입니다. clusterUpgradeMode가 '자동'으로 설정된 경우에만 적용됩니다.

Name 형식 Description
Wave0

string

클러스터 업그레이드는 새 버전이 출시된 직후에 시작됩니다. 테스트/개발 클러스터에 권장됩니다.

Wave1

string

클러스터 업그레이드는 새 버전이 출시된 후 7일 후에 시작됩니다. 사전 프로덕션 클러스터에 권장됩니다.

Wave2

string

클러스터 업그레이드는 새 버전이 출시된 후 14일 후에 시작됩니다. 프로덕션 클러스터에 권장됩니다.

ClusterUpgradeDeltaHealthPolicy

클러스터 업그레이드에 대한 델타 상태 정책을 설명합니다.

Name 형식 Description
maxPercentDeltaUnhealthyApplications

integer

클러스터 업그레이드 중에 허용되는 최대 애플리케이션 상태 저하 비율입니다. 델타는 업그레이드 시작 시 애플리케이션의 상태와 상태 평가 시 애플리케이션의 상태 간에 측정됩니다. 클러스터의 전역 상태를 허용 한도 내로 유지하기 위해 업그레이드 도메인 업그레이드가 완료될 때마다 검사가 수행됩니다. 시스템 서비스는 이에 포함되지 않습니다. 참고: 이 값은 속성에 지정된 값을 덮어씁니다. UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications

maxPercentDeltaUnhealthyNodes

integer

클러스터를 업그레이드하는 동안 허용되는 노드 상태 저하의 최대 비율입니다. 델타는 업그레이드 시작 시 노드 상태와 상태 평가 시 노드 상태 간에 측정됩니다. 클러스터의 전역 상태를 허용 한도 내로 유지하기 위해 업그레이드 도메인 업그레이드가 완료될 때마다 검사가 수행됩니다.

maxPercentUpgradeDomainDeltaUnhealthyNodes

integer

클러스터를 업그레이드하는 동안 허용되는 업그레이드 도메인 노드 상태 저하의 최대 비율입니다. 델타는 업그레이드 시작 시 업그레이드 도메인 노드 상태와 상태 평가 시 업그레이드 도메인 노드 상태 간에 측정됩니다. 클러스터의 전역 상태를 허용 한도 내로 유지하기 위해 업그레이드 도메인 업그레이드가 완료될 때마다 완료된 업그레이드 도메인에 대한 검사가 수행됩니다.

ClusterUpgradeMode

새 Service Fabric 런타임 버전을 사용할 수 있는 경우 클러스터의 업그레이드 모드입니다.

Name 형식 Description
Automatic

string

클러스터는 최신 Service Fabric 런타임 버전으로 자동으로 업그레이드되며, clusterUpgradeCadence 는 새 버전을 사용할 수 있게 된 후 업그레이드가 시작되는 시기를 결정합니다.

Manual

string

클러스터는 최신 Service Fabric 런타임 버전으로 자동으로 업그레이드되지 않습니다. 클러스터 리소스에서 clusterCodeVersion 속성을 설정하여 클러스터를 업그레이드합니다.

ClusterUpgradePolicy

클러스터를 업그레이드할 때 사용되는 정책을 설명합니다.

Name 형식 Description
deltaHealthPolicy

ClusterUpgradeDeltaHealthPolicy

클러스터 델타 상태 정책은 클러스터 업그레이드 중에 클러스터의 상태를 평가하는 데 사용되는 상태 정책을 정의합니다.

forceRestart

boolean

true이면 코드 버전이 변경되지 않은 경우에도 업그레이드 중에 프로세스가 강제로 다시 시작됩니다(업그레이드는 구성 또는 데이터만 변경됨).

healthPolicy

ClusterHealthPolicy

클러스터 상태 정책은 클러스터 업그레이드 중에 클러스터의 상태를 평가하는 데 사용되는 상태 정책을 정의합니다.

monitoringPolicy

ClusterMonitoringPolicy

클러스터 모니터링 정책은 모니터링 모드에서 업그레이드를 모니터링하기 위한 매개 변수를 설명합니다.

upgradeReplicaSetCheckTimeout

string

예기치 않은 문제가 있을 때 업그레이드 도메인의 처리를 차단하고 가용성의 손실을 방지하는 최대 시간입니다. 이 시간 제한이 만료되면 가용성 손실 문제와 상관없이 업그레이드 도메인 처리가 진행됩니다. 시간 제한은 각 업그레이드 도메인의 시작 시 다시 설정됩니다. 시간 제한은 hh:mm:ss 또는 d.hh:mm:ss.ms 형식일 수 있습니다. 이 값은 00:00:00에서 49710.06:28:15 사이여야 합니다(부호 없는 32비트 정수(초))

direction

네트워크 보안 규칙 방향.

Name 형식 Description
inbound

string

outbound

string

ErrorModel

오류의 구조입니다.

Name 형식 Description
error

ErrorModelError

오류 세부 정보입니다.

ErrorModelError

오류 세부 정보입니다.

Name 형식 Description
code

string

오류 코드입니다.

message

string

오류 메시지입니다.

IpTag

공용 IP 주소와 연결된 IP 태그입니다.

Name 형식 Description
ipTagType

string

IP 태그 유형입니다. 예: FirstPartyUsage.

tag

string

공용 IP와 연결된 IP 태그입니다. 예: SQL, 스토리지 등

LoadBalancingRule

부하 분산 규칙에 대해 설명합니다.

Name 형식 Description
backendPort

integer

엔드포인트의 내부 연결에 사용되는 포트입니다. 허용되는 값은 1에서 65535 사이입니다.

frontendPort

integer

외부 엔드포인트에 대한 포트입니다. 각 규칙의 포트 번호는 Load Balancer 내에서 고유해야 합니다. 허용되는 값은 1에서 65534 사이입니다.

loadDistribution

string

이 규칙에 대한 부하 분산 정책입니다.

probePort

integer

부하 분산 규칙에 사용되는 프로브 포트입니다. 허용되는 값은 1에서 65535 사이입니다.

probeProtocol

probeProtocol

부하 분산 규칙에서 사용하는 부하 분산 장치 프로브에 대한 참조입니다.

probeRequestPath

string

프로브 요청 경로입니다. HTTP/HTTPS 프로브에 대해서만 지원됩니다.

protocol

protocol

부하 분산 규칙에서 사용하는 전송 프로토콜에 대한 참조입니다.

ManagedCluster

관리형 클러스터 리소스

Name 형식 Default value Description
etag

string

Azure 리소스 etag.

id

string

Azure 리소스 식별자입니다.

location

string

Azure 리소스 위치.

name

string

Azure 리소스 이름입니다.

properties.addonFeatures

ManagedClusterAddOnFeature[]

클러스터에서 사용하도록 설정할 추가 기능 목록입니다.

properties.adminPassword

string

VM 관리자 사용자 암호입니다.

properties.adminUserName

string

VM 관리자 사용자 이름입니다.

properties.allowRdpAccess

boolean

이를 true로 설정하면 VM에 대한 RDP 액세스를 사용할 수 있습니다. 기본 NSG 규칙은 사용자 지정 네트워크 보안 규칙으로 재정의할 수 있는 인터넷으로 RDP 포트를 엽니다. 이 설정의 기본값은 false입니다.

properties.applicationTypeVersionsCleanupPolicy

ApplicationTypeVersionsCleanupPolicy

사용되지 않는 버전을 클린 데 사용되는 정책입니다.

properties.auxiliarySubnets

Subnet[]

클러스터에 대한 보조 서브넷입니다.

properties.azureActiveDirectory

AzureActiveDirectory

클러스터의 AAD 인증 설정입니다.

properties.clientConnectionPort

integer

19000

클러스터에 대한 클라이언트 연결에 사용되는 포트입니다.

properties.clients

ClientCertificate[]

클러스터를 관리할 수 있는 클라이언트 인증서입니다.

properties.clusterCertificateThumbprints

string[]

클러스터 인증서의 지문 목록입니다.

properties.clusterCodeVersion

string

클러스터의 Service Fabric 런타임 버전입니다. clusterUpgradeMode가 '수동'으로 설정된 경우 이 속성이 필요합니다. 새 클러스터에 사용 가능한 Service Fabric 버전 목록을 얻으려면 ClusterVersion API를 사용합니다. 기존 클러스터에 사용 가능한 버전 목록을 얻으려면 availableClusterVersions를 사용합니다.

properties.clusterId

string

서비스에서 클러스터 리소스에 대한 고유 식별자를 생성했습니다.

properties.clusterState

ClusterState

클러스터의 현재 상태입니다.

properties.clusterUpgradeCadence

clusterUpgradeCadence

새 클러스터 런타임 버전 업그레이드가 릴리스된 후 적용되는 시기를 나타냅니다. 기본적으로 Wave0입니다. clusterUpgradeMode가 '자동'으로 설정된 경우에만 적용됩니다.

properties.clusterUpgradeMode

ClusterUpgradeMode

Automatic

새 Service Fabric 런타임 버전을 사용할 수 있는 경우 클러스터의 업그레이드 모드입니다.

properties.ddosProtectionPlanId

string

클러스터의 가상 네트워크와 연결될 DDoS 네트워크 보호 계획의 리소스 ID를 지정합니다.

properties.dnsName

string

클러스터 dns 이름입니다.

properties.enableAutoOSUpgrade

boolean

이를 true로 설정하면 버전이 'latest'인 플랫폼 OS 이미지를 사용하여 만든 노드 유형에 대한 자동 OS 업그레이드가 가능합니다. 이 설정의 기본값은 false입니다.

properties.enableHttpGatewayExclusiveAuthMode

boolean

true이면 HttpGatewayEndpoint에서 토큰 기반 인증이 허용되지 않습니다. 이는 TLS 버전 1.3 이상을 지원하는 데 필요합니다. 토큰 기반 인증을 사용하는 경우 HttpGatewayTokenAuthConnectionPort를 정의해야 합니다.

properties.enableIpv6

boolean

이를 true로 설정하면 클러스터에서 사용하는 기본 VNet에 대한 IPv6 주소 공간이 만들어집니다. 클러스터를 만든 후에는 이 설정을 변경할 수 없습니다. 이 설정의 기본값은 false입니다.

properties.enableServicePublicIP

boolean

이를 true로 설정하면 IPv4 주소가 IPv6 주소의 ServicePublicIP로 연결됩니다. 클러스터에서 IPv6을 사용하도록 설정한 경우에만 True로 설정할 수 있습니다.

properties.fabricSettings

SettingsSectionDescription[]

클러스터를 구성할 사용자 지정 패브릭 설정 목록입니다.

properties.fqdn

string

클러스터의 공용 부하 분산 장치와 연결된 정규화된 도메인 이름입니다.

properties.httpGatewayConnectionPort

integer

19080

클러스터에 대한 HTTP 연결에 사용되는 포트입니다.

properties.httpGatewayTokenAuthConnectionPort

integer

클러스터에 대한 토큰 인증 기반 HTTPS 연결에 사용되는 포트입니다. HttpGatewayEndpoint와 동일한 포트로 설정할 수 없습니다.

properties.ipTags

IpTag[]

클러스터의 기본 공용 IP 주소와 연결된 IP 태그 목록입니다.

properties.ipv4Address

string

클러스터의 공용 부하 분산 장치와 연결된 IPv4 주소입니다.

properties.ipv6Address

string

IPv6이 사용하도록 설정된 경우 클러스터의 IPv6 주소입니다.

properties.loadBalancingRules

LoadBalancingRule[]

클러스터의 공용 부하 분산 장치에 적용되는 부하 분산 규칙입니다.

properties.networkSecurityRules

NetworkSecurityRule[]

클러스터의 Virtual Network 적용되는 사용자 지정 네트워크 보안 규칙입니다.

properties.provisioningState

ManagedResourceProvisioningState

관리형 클러스터 리소스의 프로비저닝 상태입니다.

properties.publicIPPrefixId

string

부하 분산 장치가 공용 IPv4 주소를 할당할 공용 IPv4 접두사에 대한 리소스 ID를 지정합니다. 클러스터를 만든 후에는 이 설정을 변경할 수 없습니다.

properties.publicIPv6PrefixId

string

부하 분산 장치가 공용 IPv6 주소를 할당할 공용 IPv6 접두사에 대한 리소스 ID를 지정합니다. 클러스터를 만든 후에는 이 설정을 변경할 수 없습니다.

properties.serviceEndpoints

ServiceEndpoint[]

클러스터의 서브넷에 대한 서비스 엔드포인트입니다.

properties.subnetId

string

지정된 경우 클러스터의 노드 형식은 기본 VNet 대신 이 서브넷에 만들어집니다. 클러스터에 지정된 networkSecurityRules 도 이 서브넷에 적용됩니다. 클러스터를 만든 후에는 이 설정을 변경할 수 없습니다.

properties.upgradeDescription

ClusterUpgradePolicy

클러스터를 업그레이드할 때 사용할 정책입니다.

properties.useCustomVnet

boolean

새 클러스터의 경우 이 매개 변수는 Bring Your Own VNet을 사용하지만 서브넷은 노드 유형 수준에서 지정됨을 나타냅니다. 이러한 클러스터의 경우 노드 형식에 subnetId 속성이 필요합니다.

properties.zonalResiliency

boolean

False

클러스터에 영역 복원력이 있는지를 나타냅니다.

properties.zonalUpdateMode

ZonalUpdateMode

교차 Az 클러스터의 업데이트 모드를 나타냅니다.

sku

Sku

관리형 클러스터의 sku

systemData

SystemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

tags

object

Azure 리소스 태그.

type

string

Azure 리소스 종류.

ManagedClusterAddOnFeature

사용 가능한 클러스터 추가 기능

Name 형식 Description
BackupRestoreService

string

서비스 백업 및 복원

DnsService

string

Dns 서비스

ResourceMonitorService

string

리소스 모니터 서비스

ManagedResourceProvisioningState

관리되는 리소스의 프로비전 상태입니다.

Name 형식 Description
Canceled

string

Created

string

Creating

string

Deleted

string

Deleting

string

Failed

string

None

string

Other

string

Succeeded

string

Updating

string

NetworkSecurityRule

네트워크 보안 규칙을 설명합니다.

Name 형식 Description
access

access

네트워크 트래픽이 허용되거나 거부됩니다.

description

string

네트워크 보안 규칙 설명입니다.

destinationAddressPrefix

string

대상 주소 접두사입니다. CIDR 또는 대상 IP 범위입니다. 모든 원본 IP가 일치하도록 별표(‘*’)를 사용할 수도 있습니다. 'VirtualNetwork', 'AzureLoadBalancer' 및 'Internet'과 같은 기본 태그도 사용할 수 있습니다.

destinationAddressPrefixes

string[]

대상 주소 접두사입니다. CIDR 또는 대상 IP 범위.

destinationPortRange

string

대상 포트 또는 범위입니다. 정수 또는 범위는 0에서 65535 사이입니다. 별표 '*'를 사용하여 모든 포트를 일치시킬 수도 있습니다.

destinationPortRanges

string[]

대상 포트 범위입니다.

direction

direction

네트워크 보안 규칙 방향.

name

string

네트워크 보안 규칙 이름입니다.

priority

integer

규칙의 우선 순위입니다. 값은 1000~3000 범위일 수 있습니다. 이 범위를 벗어난 값은 Service Fabric ManagerCluster 리소스 공급자용으로 예약됩니다. 우선 순위 번호는 컬렉션의 각 규칙에 대해 고유해야 합니다. 우선 순위 번호가 낮을수록 규칙의 우선 순위가 높습니다.

protocol

nsgProtocol

이 규칙이 적용되는 네트워크 프로토콜입니다.

sourceAddressPrefix

string

CIDR 또는 원본 IP 범위입니다. 모든 원본 IP가 일치하도록 별표(‘*’)를 사용할 수도 있습니다. 'VirtualNetwork', 'AzureLoadBalancer' 및 'Internet'과 같은 기본 태그도 사용할 수 있습니다. 수신 규칙인 경우 네트워크 트래픽이 시작되는 위치를 지정합니다.

sourceAddressPrefixes

string[]

CIDR 또는 원본 IP 범위입니다.

sourcePortRange

string

원본 포트 또는 범위입니다. 정수 또는 범위는 0에서 65535 사이입니다. 별표 '*'를 사용하여 모든 포트를 일치시킬 수도 있습니다.

sourcePortRanges

string[]

원본 포트 범위입니다.

nsgProtocol

이 규칙이 적용되는 네트워크 프로토콜입니다.

Name 형식 Description
ah

string

esp

string

http

string

https

string

icmp

string

tcp

string

udp

string

privateEndpointNetworkPolicies

서브넷의 프라이빗 엔드포인트에 네트워크 정책 적용을 사용하거나 사용하지 않도록 설정합니다.

Name 형식 Description
disabled

string

enabled

string

privateLinkServiceNetworkPolicies

서브넷의 프라이빗 링크 서비스에 네트워크 정책 적용을 사용하거나 사용하지 않도록 설정합니다.

Name 형식 Description
disabled

string

enabled

string

probeProtocol

부하 분산 규칙에서 사용하는 부하 분산 장치 프로브에 대한 참조입니다.

Name 형식 Description
http

string

https

string

tcp

string

protocol

부하 분산 규칙에서 사용하는 전송 프로토콜에 대한 참조입니다.

Name 형식 Description
tcp

string

udp

string

ServiceEndpoint

서비스 엔드포인트 속성입니다.

Name 형식 Description
locations

string[]

위치 목록입니다.

service

string

엔드포인트 서비스의 형식입니다.

SettingsParameterDescription

클러스터의 패브릭 설정에서 매개 변수를 설명합니다.

Name 형식 Description
name

string

패브릭 설정의 매개 변수 이름입니다.

value

string

패브릭 설정의 매개 변수 값입니다.

SettingsSectionDescription

클러스터의 패브릭 설정에 있는 섹션에 대해 설명합니다.

Name 형식 Description
name

string

패브릭 설정의 섹션 이름입니다.

parameters

SettingsParameterDescription[]

섹션의 매개 변수 컬렉션입니다.

Sku

Service Fabric 관리형 클러스터 SKU 정의

Name 형식 Description
name

SkuName

Sku 이름입니다.

SkuName

Sku 이름입니다.

Name 형식 Description
Basic

string

기본은 최소 3개의 노드가 필요하며 노드 유형은 1개만 허용합니다.

Standard

string

최소 5개의 노드가 필요하며 1개 이상의 노드 형식을 허용합니다.

Subnet

서브넷에 대해 설명합니다.

Name 형식 Description
enableIpv6

boolean

Ipv6을 사용하도록 설정할지 여부를 나타냅니다. 제공되지 않으면 클러스터와 동일한 구성을 사용합니다.

name

string

서브넷 이름입니다.

networkSecurityGroupId

string

네트워크 보안 그룹의 전체 리소스 ID입니다.

privateEndpointNetworkPolicies

privateEndpointNetworkPolicies

서브넷의 프라이빗 엔드포인트에 네트워크 정책 적용을 사용하거나 사용하지 않도록 설정합니다.

privateLinkServiceNetworkPolicies

privateLinkServiceNetworkPolicies

서브넷의 프라이빗 링크 서비스에 네트워크 정책 적용을 사용하거나 사용하지 않도록 설정합니다.

SystemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string

UTC(리소스 만들기)의 타임스탬프입니다.

createdBy

string

리소스를 만든 ID입니다.

createdByType

string

리소스를 만든 ID의 형식입니다.

lastModifiedAt

string

리소스 마지막 수정(UTC)의 타임스탬프입니다.

lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

string

리소스를 마지막으로 수정한 ID 유형입니다.

ZonalUpdateMode

교차 Az 클러스터의 업데이트 모드를 나타냅니다.

Name 형식 Description
Fast

string

클러스터는 더 빠른 배포를 위해 교차 Az 노드 유형에 대해 5개 대신 영역당 최대 3개의 업그레이드 도메인을 사용합니다.

Standard

string

클러스터는 크로스 Az 노드 유형에 대해 5개의 업그레이드 도메인을 사용합니다.