ClusterUpdateParameters interface
Cluster update request
Properties
add |
The list of add-on features to enable in the cluster. |
application |
The policy used to clean up unused versions. |
certificate | The certificate to use for securing the cluster. The certificate provided will be used for node to node security within the cluster, SSL certificate for cluster management endpoint and default admin client. |
certificate |
Describes a list of server certificates referenced by common name that are used to secure the cluster. |
client |
The list of client certificates referenced by common name that are allowed to manage the cluster. This will overwrite the existing list. |
client |
The list of client certificates referenced by thumbprint that are allowed to manage the cluster. This will overwrite the existing list. |
cluster |
The Service Fabric runtime version of the cluster. This property can only by set the user when upgradeMode 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. |
event |
Indicates if the event store service is enabled. |
fabric |
The list of custom fabric settings to configure the cluster. This will overwrite the existing list. |
infrastructure |
Indicates if infrastructure service manager is enabled. |
node |
The list of node types in the cluster. This will overwrite the existing list. |
notifications | Indicates a list of notification channels for cluster events. |
reliability |
The reliability level sets the replica set size of system services. Learn about ReliabilityLevel.
|
reverse |
The server certificate used by reverse proxy. |
sf |
This property controls the logical grouping of VMs in upgrade domains (UDs). This property can't be modified if a node type with multiple Availability Zones is already present in the cluster. |
tags | Cluster update parameters |
upgrade |
The policy to use when upgrading the cluster. |
upgrade |
The upgrade mode of the cluster when new Service Fabric runtime version is available. |
upgrade |
The end timestamp of pause runtime version upgrades on the cluster (UTC). |
upgrade |
The start timestamp to pause runtime version upgrades on the cluster (UTC). |
upgrade |
Indicates when new cluster runtime version upgrades will be applied after they are released. By default is Wave0. Only applies when upgradeMode is set to 'Automatic'. |
vmss |
This property defines the upgrade mode for the virtual machine scale set, it is mandatory if a node type with multiple Availability Zones is added. |
wave |
Boolean to pause automatic runtime version upgrades to the cluster. |
Property Details
addOnFeatures
The list of add-on features to enable in the cluster.
addOnFeatures?: string[]
Property Value
string[]
applicationTypeVersionsCleanupPolicy
The policy used to clean up unused versions.
applicationTypeVersionsCleanupPolicy?: ApplicationTypeVersionsCleanupPolicy
Property Value
certificate
The certificate to use for securing the cluster. The certificate provided will be used for node to node security within the cluster, SSL certificate for cluster management endpoint and default admin client.
certificate?: CertificateDescription
Property Value
certificateCommonNames
Describes a list of server certificates referenced by common name that are used to secure the cluster.
certificateCommonNames?: ServerCertificateCommonNames
Property Value
clientCertificateCommonNames
The list of client certificates referenced by common name that are allowed to manage the cluster. This will overwrite the existing list.
clientCertificateCommonNames?: ClientCertificateCommonName[]
Property Value
clientCertificateThumbprints
The list of client certificates referenced by thumbprint that are allowed to manage the cluster. This will overwrite the existing list.
clientCertificateThumbprints?: ClientCertificateThumbprint[]
Property Value
clusterCodeVersion
The Service Fabric runtime version of the cluster. This property can only by set the user when upgradeMode 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
eventStoreServiceEnabled
Indicates if the event store service is enabled.
eventStoreServiceEnabled?: boolean
Property Value
boolean
fabricSettings
The list of custom fabric settings to configure the cluster. This will overwrite the existing list.
fabricSettings?: SettingsSectionDescription[]
Property Value
infrastructureServiceManager
Indicates if infrastructure service manager is enabled.
infrastructureServiceManager?: boolean
Property Value
boolean
nodeTypes
The list of node types in the cluster. This will overwrite the existing list.
nodeTypes?: NodeTypeDescription[]
Property Value
notifications
Indicates a list of notification channels for cluster events.
notifications?: Notification_2[]
Property Value
reliabilityLevel
The reliability level sets the replica set size of system services. Learn about ReliabilityLevel.
- None - Run the System services with a target replica set count of 1. This should only be used for test clusters.
- Bronze - Run the System services with a target replica set count of 3. This should only be used for test clusters.
- Silver - Run the System services with a target replica set count of 5.
- Gold - Run the System services with a target replica set count of 7.
- Platinum - Run the System services with a target replica set count of 9.
reliabilityLevel?: string
Property Value
string
reverseProxyCertificate
The server certificate used by reverse proxy.
reverseProxyCertificate?: CertificateDescription
Property Value
sfZonalUpgradeMode
This property controls the logical grouping of VMs in upgrade domains (UDs). This property can't be modified if a node type with multiple Availability Zones is already present in the cluster.
sfZonalUpgradeMode?: string
Property Value
string
tags
Cluster update parameters
tags?: {[propertyName: string]: string}
Property Value
{[propertyName: string]: string}
upgradeDescription
The policy to use when upgrading the cluster.
upgradeDescription?: ClusterUpgradePolicy
Property Value
upgradeMode
The upgrade mode of the cluster when new Service Fabric runtime version is available.
upgradeMode?: string
Property Value
string
upgradePauseEndTimestampUtc
The end timestamp of pause runtime version upgrades on the cluster (UTC).
upgradePauseEndTimestampUtc?: Date
Property Value
Date
upgradePauseStartTimestampUtc
The start timestamp to pause runtime version upgrades on the cluster (UTC).
upgradePauseStartTimestampUtc?: Date
Property Value
Date
upgradeWave
Indicates when new cluster runtime version upgrades will be applied after they are released. By default is Wave0. Only applies when upgradeMode is set to 'Automatic'.
upgradeWave?: string
Property Value
string
vmssZonalUpgradeMode
This property defines the upgrade mode for the virtual machine scale set, it is mandatory if a node type with multiple Availability Zones is added.
vmssZonalUpgradeMode?: string
Property Value
string
waveUpgradePaused
Boolean to pause automatic runtime version upgrades to the cluster.
waveUpgradePaused?: boolean
Property Value
boolean