ManagedCluster interface
The managed cluster resource
- Extends
Properties
addon |
List of add-on features to enable on the cluster. |
admin |
VM admin user password. This value contains a credential. Consider obscuring before showing to users |
admin |
VM admin user name. |
allow |
Setting this to true enables RDP access to the VM. The default NSG rule opens RDP port to Internet which can be overridden with custom Network Security Rules. The default value for this setting is false. |
application |
The policy used to clean up unused versions. |
auto |
This property is the entry point to using a public CA cert for your cluster cert. It specifies the level of reuse allowed for the custom FQDN created, matching the subject of the public CA cert. |
auxiliary |
Auxiliary subnets for the cluster. |
azure |
The AAD authentication settings of the cluster. |
client |
The port used for client connections to the cluster. |
clients | Client certificates that are allowed to manage the cluster. |
cluster |
List of thumbprints of the cluster certificates. NOTE: This property will not be serialized. It can only be populated by the server. |
cluster |
The Service Fabric runtime version of the cluster. This property is required when clusterUpgradeMode is set to 'Manual'. To get list of available Service Fabric versions for new clusters use ClusterVersion API. To get the list of available version for existing clusters use availableClusterVersions. |
cluster |
A service generated unique identifier for the cluster resource. NOTE: This property will not be serialized. It can only be populated by the server. |
cluster |
The current state of the cluster. NOTE: This property will not be serialized. It can only be populated by the server. |
cluster |
Indicates when new cluster runtime version upgrades will be applied after they are released. By default is Wave0. Only applies when clusterUpgradeMode is set to 'Automatic'. |
cluster |
The upgrade mode of the cluster when new Service Fabric runtime version is available. |
custom |
If using autoGeneratedDomainNameLabelScope, this is the fully qualified domain name using SFMC's domain, pointing to the public load balancer of the cluster. |
ddos |
Specify the resource id of a DDoS network protection plan that will be associated with the virtual network of the cluster. |
dns |
The cluster dns name. |
enable |
Setting this to true enables automatic OS upgrade for the node types that are created using any platform OS image with version 'latest'. The default value for this setting is false. |
enable |
If true, token-based authentication is not allowed on the HttpGatewayEndpoint. This is required to support TLS versions 1.3 and above. If token-based authentication is used, HttpGatewayTokenAuthConnectionPort must be defined. |
enable |
Setting this to true creates IPv6 address space for the default VNet used by the cluster. This setting cannot be changed once the cluster is created. The default value for this setting is false. |
enable |
Setting this to true will link the IPv4 address as the ServicePublicIP of the IPv6 address. It can only be set to True if IPv6 is enabled on the cluster. |
fabric |
The list of custom fabric settings to configure the cluster. |
fqdn | The fully qualified domain name associated with the public load balancer of the cluster. NOTE: This property will not be serialized. It can only be populated by the server. |
http |
The port used for HTTP connections to the cluster. |
http |
The port used for token-auth based HTTPS connections to the cluster. Cannot be set to the same port as HttpGatewayEndpoint. |
ip |
The list of IP tags associated with the default public IP address of the cluster. |
ipv4Address | The IPv4 address associated with the public load balancer of the cluster. NOTE: This property will not be serialized. It can only be populated by the server. |
ipv6Address | IPv6 address for the cluster if IPv6 is enabled. NOTE: This property will not be serialized. It can only be populated by the server. |
load |
Load balancing rules that are applied to the public load balancer of the cluster. |
network |
Custom Network Security Rules that are applied to the Virtual Network of the cluster. |
provisioning |
The provisioning state of the managed cluster resource. NOTE: This property will not be serialized. It can only be populated by the server. |
public |
Specify the resource id of a public IPv4 prefix that the load balancer will allocate a public IPv4 address from. This setting cannot be changed once the cluster is created. |
public |
Specify the resource id of a public IPv6 prefix that the load balancer will allocate a public IPv6 address from. This setting cannot be changed once the cluster is created. |
service |
Service endpoints for subnets in the cluster. |
sku | The sku of the managed cluster |
subnet |
If specified, the node types for the cluster are created in this subnet instead of the default VNet. The networkSecurityRules specified for the cluster are also applied to this subnet. This setting cannot be changed once the cluster is created. |
upgrade |
The policy to use when upgrading the cluster. |
use |
For new clusters, this parameter indicates that it uses Bring your own VNet, but the subnet is specified at node type level; and for such clusters, the subnetId property is required for node types. |
zonal |
Indicates if the cluster has zone resiliency. |
zonal |
Indicates the update mode for Cross Az clusters. |
Inherited Properties
etag | Azure resource etag. NOTE: This property will not be serialized. It can only be populated by the server. |
id | Azure resource identifier. NOTE: This property will not be serialized. It can only be populated by the server. |
location | Azure resource location. |
name | Azure resource name. NOTE: This property will not be serialized. It can only be populated by the server. |
system |
Metadata pertaining to creation and last modification of the resource. NOTE: This property will not be serialized. It can only be populated by the server. |
tags | Azure resource tags. |
type | Azure resource type. NOTE: This property will not be serialized. It can only be populated by the server. |
Property Details
addonFeatures
List of add-on features to enable on the cluster.
addonFeatures?: string[]
Property Value
string[]
adminPassword
VM admin user password. This value contains a credential. Consider obscuring before showing to users
adminPassword?: string
Property Value
string
adminUserName
VM admin user name.
adminUserName?: string
Property Value
string
allowRdpAccess
Setting this to true enables RDP access to the VM. The default NSG rule opens RDP port to Internet which can be overridden with custom Network Security Rules. The default value for this setting is false.
allowRdpAccess?: boolean
Property Value
boolean
applicationTypeVersionsCleanupPolicy
The policy used to clean up unused versions.
applicationTypeVersionsCleanupPolicy?: ApplicationTypeVersionsCleanupPolicy
Property Value
autoGeneratedDomainNameLabelScope
This property is the entry point to using a public CA cert for your cluster cert. It specifies the level of reuse allowed for the custom FQDN created, matching the subject of the public CA cert.
autoGeneratedDomainNameLabelScope?: string
Property Value
string
auxiliarySubnets
azureActiveDirectory
The AAD authentication settings of the cluster.
azureActiveDirectory?: AzureActiveDirectory
Property Value
clientConnectionPort
The port used for client connections to the cluster.
clientConnectionPort?: number
Property Value
number
clients
Client certificates that are allowed to manage the cluster.
clients?: ClientCertificate[]
Property Value
clusterCertificateThumbprints
List of thumbprints of the cluster certificates. NOTE: This property will not be serialized. It can only be populated by the server.
clusterCertificateThumbprints?: string[]
Property Value
string[]
clusterCodeVersion
The Service Fabric runtime version of the cluster. This property is required when clusterUpgradeMode is set to 'Manual'. To get list of available Service Fabric versions for new clusters use ClusterVersion API. To get the list of available version for existing clusters use availableClusterVersions.
clusterCodeVersion?: string
Property Value
string
clusterId
A service generated unique identifier for the cluster resource. NOTE: This property will not be serialized. It can only be populated by the server.
clusterId?: string
Property Value
string
clusterState
The current state of the cluster. NOTE: This property will not be serialized. It can only be populated by the server.
clusterState?: string
Property Value
string
clusterUpgradeCadence
Indicates when new cluster runtime version upgrades will be applied after they are released. By default is Wave0. Only applies when clusterUpgradeMode is set to 'Automatic'.
clusterUpgradeCadence?: string
Property Value
string
clusterUpgradeMode
The upgrade mode of the cluster when new Service Fabric runtime version is available.
clusterUpgradeMode?: string
Property Value
string
customFqdn
If using autoGeneratedDomainNameLabelScope, this is the fully qualified domain name using SFMC's domain, pointing to the public load balancer of the cluster.
customFqdn?: string
Property Value
string
ddosProtectionPlanId
Specify the resource id of a DDoS network protection plan that will be associated with the virtual network of the cluster.
ddosProtectionPlanId?: string
Property Value
string
dnsName
The cluster dns name.
dnsName?: string
Property Value
string
enableAutoOSUpgrade
Setting this to true enables automatic OS upgrade for the node types that are created using any platform OS image with version 'latest'. The default value for this setting is false.
enableAutoOSUpgrade?: boolean
Property Value
boolean
enableHttpGatewayExclusiveAuthMode
If true, token-based authentication is not allowed on the HttpGatewayEndpoint. This is required to support TLS versions 1.3 and above. If token-based authentication is used, HttpGatewayTokenAuthConnectionPort must be defined.
enableHttpGatewayExclusiveAuthMode?: boolean
Property Value
boolean
enableIpv6
Setting this to true creates IPv6 address space for the default VNet used by the cluster. This setting cannot be changed once the cluster is created. The default value for this setting is false.
enableIpv6?: boolean
Property Value
boolean
enableServicePublicIP
Setting this to true will link the IPv4 address as the ServicePublicIP of the IPv6 address. It can only be set to True if IPv6 is enabled on the cluster.
enableServicePublicIP?: boolean
Property Value
boolean
fabricSettings
The list of custom fabric settings to configure the cluster.
fabricSettings?: SettingsSectionDescription[]
Property Value
fqdn
The fully qualified domain name associated with the public load balancer of the cluster. NOTE: This property will not be serialized. It can only be populated by the server.
fqdn?: string
Property Value
string
httpGatewayConnectionPort
The port used for HTTP connections to the cluster.
httpGatewayConnectionPort?: number
Property Value
number
httpGatewayTokenAuthConnectionPort
The port used for token-auth based HTTPS connections to the cluster. Cannot be set to the same port as HttpGatewayEndpoint.
httpGatewayTokenAuthConnectionPort?: number
Property Value
number
ipTags
The list of IP tags associated with the default public IP address of the cluster.
ipTags?: IpTag[]
Property Value
IpTag[]
ipv4Address
The IPv4 address associated with the public load balancer of the cluster. NOTE: This property will not be serialized. It can only be populated by the server.
ipv4Address?: string
Property Value
string
ipv6Address
IPv6 address for the cluster if IPv6 is enabled. NOTE: This property will not be serialized. It can only be populated by the server.
ipv6Address?: string
Property Value
string
loadBalancingRules
Load balancing rules that are applied to the public load balancer of the cluster.
loadBalancingRules?: LoadBalancingRule[]
Property Value
networkSecurityRules
Custom Network Security Rules that are applied to the Virtual Network of the cluster.
networkSecurityRules?: NetworkSecurityRule[]
Property Value
provisioningState
The provisioning state of the managed cluster resource. NOTE: This property will not be serialized. It can only be populated by the server.
provisioningState?: string
Property Value
string
publicIPPrefixId
Specify the resource id of a public IPv4 prefix that the load balancer will allocate a public IPv4 address from. This setting cannot be changed once the cluster is created.
publicIPPrefixId?: string
Property Value
string
publicIPv6PrefixId
Specify the resource id of a public IPv6 prefix that the load balancer will allocate a public IPv6 address from. This setting cannot be changed once the cluster is created.
publicIPv6PrefixId?: string
Property Value
string
serviceEndpoints
Service endpoints for subnets in the cluster.
serviceEndpoints?: ServiceEndpoint[]
Property Value
sku
subnetId
If specified, the node types for the cluster are created in this subnet instead of the default VNet. The networkSecurityRules specified for the cluster are also applied to this subnet. This setting cannot be changed once the cluster is created.
subnetId?: string
Property Value
string
upgradeDescription
The policy to use when upgrading the cluster.
upgradeDescription?: ClusterUpgradePolicy
Property Value
useCustomVnet
For new clusters, this parameter indicates that it uses Bring your own VNet, but the subnet is specified at node type level; and for such clusters, the subnetId property is required for node types.
useCustomVnet?: boolean
Property Value
boolean
zonalResiliency
Indicates if the cluster has zone resiliency.
zonalResiliency?: boolean
Property Value
boolean
zonalUpdateMode
Indicates the update mode for Cross Az clusters.
zonalUpdateMode?: string
Property Value
string
Inherited Property Details
etag
Azure resource etag. NOTE: This property will not be serialized. It can only be populated by the server.
etag?: string
Property Value
string
Inherited From Resource.etag
id
Azure resource identifier. NOTE: This property will not be serialized. It can only be populated by the server.
id?: string
Property Value
string
Inherited From Resource.id
location
name
Azure resource name. NOTE: This property will not be serialized. It can only be populated by the server.
name?: string
Property Value
string
Inherited From Resource.name
systemData
Metadata pertaining to creation and last modification of the resource. NOTE: This property will not be serialized. It can only be populated by the server.
systemData?: SystemData
Property Value
Inherited From Resource.systemData
tags
Azure resource tags.
tags?: {[propertyName: string]: string}
Property Value
{[propertyName: string]: string}
Inherited From Resource.tags
type
Azure resource type. NOTE: This property will not be serialized. It can only be populated by the server.
type?: string
Property Value
string
Inherited From Resource.type
Azure SDK for JavaScript