Share via


Cluster interface

Cluster represents the on-premises Network Cloud cluster.

Extends

Properties

aggregatorOrSingleRackDefinition

The rack definition that is intended to reflect only a single rack in a single rack cluster, or an aggregator rack in a multi-rack cluster.

analyticsOutputSettings

The settings for the log analytics workspace used for output of logs from this cluster.

analyticsWorkspaceId

Field Deprecated. The resource ID of the Log Analytics Workspace that will be used for storing relevant logs.

availableUpgradeVersions

The list of cluster runtime version upgrades available for this cluster. NOTE: This property will not be serialized. It can only be populated by the server.

clusterCapacity

The capacity supported by this cluster. NOTE: This property will not be serialized. It can only be populated by the server.

clusterConnectionStatus

The latest heartbeat status between the cluster manager and the cluster. NOTE: This property will not be serialized. It can only be populated by the server.

clusterExtendedLocation

The extended ___location (custom ___location) that represents the cluster's control plane ___location. This extended ___location is used to route the requests of child objects of the cluster that are handled by the platform operator. NOTE: This property will not be serialized. It can only be populated by the server.

clusterLocation

The customer-provided ___location information to identify where the cluster resides.

clusterManagerConnectionStatus

The latest connectivity status between cluster manager and the cluster. NOTE: This property will not be serialized. It can only be populated by the server.

clusterManagerId

The resource ID of the cluster manager that manages this cluster. This is set by the Cluster Manager when the cluster is created. NOTE: This property will not be serialized. It can only be populated by the server.

clusterServicePrincipal

The service principal to be used by the cluster during Arc Appliance installation.

clusterType

The type of rack configuration for the cluster.

clusterVersion

The current runtime version of the cluster.

commandOutputSettings

The settings for commands run in this cluster, such as bare metal machine run read only commands and data extracts.

computeDeploymentThreshold

The validation threshold indicating the allowable failures of compute machines during environment validation and deployment.

computeRackDefinitions

The list of rack definitions for the compute racks in a multi-rack cluster, or an empty list in a single-rack cluster.

detailedStatus

The current detailed status of the cluster. NOTE: This property will not be serialized. It can only be populated by the server.

detailedStatusMessage

The descriptive message about the detailed status. NOTE: This property will not be serialized. It can only be populated by the server.

etag

Resource ETag. NOTE: This property will not be serialized. It can only be populated by the server.

extendedLocation

The extended ___location of the cluster manager associated with the cluster.

hybridAksExtendedLocation

Field Deprecated. This field will not be populated in an upcoming version. The extended ___location (custom ___location) that represents the Hybrid AKS control plane ___location. This extended ___location is used when creating provisioned clusters (Hybrid AKS clusters). NOTE: This property will not be serialized. It can only be populated by the server.

identity

The identity for the resource.

managedResourceGroupConfiguration

The configuration of the managed resource group associated with the resource.

manualActionCount

The count of Manual Action Taken (MAT) events that have not been validated. NOTE: This property will not be serialized. It can only be populated by the server.

networkFabricId

The resource ID of the Network Fabric associated with the cluster.

provisioningState

The provisioning state of the cluster. NOTE: This property will not be serialized. It can only be populated by the server.

runtimeProtectionConfiguration

The settings for cluster runtime protection.

secretArchive

The configuration for use of a key vault to store secrets for later retrieval by the operator.

secretArchiveSettings

The settings for the secret archive used to hold credentials for the cluster.

supportExpiryDate

The support end date of the runtime version of the cluster. NOTE: This property will not be serialized. It can only be populated by the server.

updateStrategy

The strategy for updating the cluster.

vulnerabilityScanningSettings

The settings for how security vulnerability scanning is applied to the cluster.

workloadResourceIds

The list of workload resource IDs that are hosted within this cluster. NOTE: This property will not be serialized. It can only be populated by the server.

Inherited Properties

id

Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" NOTE: This property will not be serialized. It can only be populated by the server.

___location

The geo-___location where the resource lives

name

The name of the resource NOTE: This property will not be serialized. It can only be populated by the server.

systemData

Azure Resource Manager metadata containing createdBy and modifiedBy information. NOTE: This property will not be serialized. It can only be populated by the server.

tags

Resource tags.

type

The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts" NOTE: This property will not be serialized. It can only be populated by the server.

Property Details

aggregatorOrSingleRackDefinition

The rack definition that is intended to reflect only a single rack in a single rack cluster, or an aggregator rack in a multi-rack cluster.

aggregatorOrSingleRackDefinition: RackDefinition

Property Value

analyticsOutputSettings

The settings for the log analytics workspace used for output of logs from this cluster.

analyticsOutputSettings?: AnalyticsOutputSettings

Property Value

analyticsWorkspaceId

Field Deprecated. The resource ID of the Log Analytics Workspace that will be used for storing relevant logs.

analyticsWorkspaceId?: string

Property Value

string

availableUpgradeVersions

The list of cluster runtime version upgrades available for this cluster. NOTE: This property will not be serialized. It can only be populated by the server.

availableUpgradeVersions?: ClusterAvailableUpgradeVersion[]

Property Value

clusterCapacity

The capacity supported by this cluster. NOTE: This property will not be serialized. It can only be populated by the server.

clusterCapacity?: ClusterCapacity

Property Value

clusterConnectionStatus

The latest heartbeat status between the cluster manager and the cluster. NOTE: This property will not be serialized. It can only be populated by the server.

clusterConnectionStatus?: string

Property Value

string

clusterExtendedLocation

The extended ___location (custom ___location) that represents the cluster's control plane ___location. This extended ___location is used to route the requests of child objects of the cluster that are handled by the platform operator. NOTE: This property will not be serialized. It can only be populated by the server.

clusterExtendedLocation?: ExtendedLocation

Property Value

clusterLocation

The customer-provided ___location information to identify where the cluster resides.

clusterLocation?: string

Property Value

string

clusterManagerConnectionStatus

The latest connectivity status between cluster manager and the cluster. NOTE: This property will not be serialized. It can only be populated by the server.

clusterManagerConnectionStatus?: string

Property Value

string

clusterManagerId

The resource ID of the cluster manager that manages this cluster. This is set by the Cluster Manager when the cluster is created. NOTE: This property will not be serialized. It can only be populated by the server.

clusterManagerId?: string

Property Value

string

clusterServicePrincipal

The service principal to be used by the cluster during Arc Appliance installation.

clusterServicePrincipal?: ServicePrincipalInformation

Property Value

clusterType

The type of rack configuration for the cluster.

clusterType: string

Property Value

string

clusterVersion

The current runtime version of the cluster.

clusterVersion: string

Property Value

string

commandOutputSettings

The settings for commands run in this cluster, such as bare metal machine run read only commands and data extracts.

commandOutputSettings?: CommandOutputSettings

Property Value

computeDeploymentThreshold

The validation threshold indicating the allowable failures of compute machines during environment validation and deployment.

computeDeploymentThreshold?: ValidationThreshold

Property Value

computeRackDefinitions

The list of rack definitions for the compute racks in a multi-rack cluster, or an empty list in a single-rack cluster.

computeRackDefinitions?: RackDefinition[]

Property Value

detailedStatus

The current detailed status of the cluster. NOTE: This property will not be serialized. It can only be populated by the server.

detailedStatus?: string

Property Value

string

detailedStatusMessage

The descriptive message about the detailed status. NOTE: This property will not be serialized. It can only be populated by the server.

detailedStatusMessage?: string

Property Value

string

etag

Resource ETag. NOTE: This property will not be serialized. It can only be populated by the server.

etag?: string

Property Value

string

extendedLocation

The extended ___location of the cluster manager associated with the cluster.

extendedLocation: ExtendedLocation

Property Value

hybridAksExtendedLocation

Field Deprecated. This field will not be populated in an upcoming version. The extended ___location (custom ___location) that represents the Hybrid AKS control plane ___location. This extended ___location is used when creating provisioned clusters (Hybrid AKS clusters). NOTE: This property will not be serialized. It can only be populated by the server.

hybridAksExtendedLocation?: ExtendedLocation

Property Value

identity

The identity for the resource.

identity?: ManagedServiceIdentity

Property Value

managedResourceGroupConfiguration

The configuration of the managed resource group associated with the resource.

managedResourceGroupConfiguration?: ManagedResourceGroupConfiguration

Property Value

manualActionCount

The count of Manual Action Taken (MAT) events that have not been validated. NOTE: This property will not be serialized. It can only be populated by the server.

manualActionCount?: number

Property Value

number

networkFabricId

The resource ID of the Network Fabric associated with the cluster.

networkFabricId: string

Property Value

string

provisioningState

The provisioning state of the cluster. NOTE: This property will not be serialized. It can only be populated by the server.

provisioningState?: string

Property Value

string

runtimeProtectionConfiguration

The settings for cluster runtime protection.

runtimeProtectionConfiguration?: RuntimeProtectionConfiguration

Property Value

secretArchive

The configuration for use of a key vault to store secrets for later retrieval by the operator.

secretArchive?: ClusterSecretArchive

Property Value

secretArchiveSettings

The settings for the secret archive used to hold credentials for the cluster.

secretArchiveSettings?: SecretArchiveSettings

Property Value

supportExpiryDate

The support end date of the runtime version of the cluster. NOTE: This property will not be serialized. It can only be populated by the server.

supportExpiryDate?: string

Property Value

string

updateStrategy

The strategy for updating the cluster.

updateStrategy?: ClusterUpdateStrategy

Property Value

vulnerabilityScanningSettings

The settings for how security vulnerability scanning is applied to the cluster.

vulnerabilityScanningSettings?: VulnerabilityScanningSettings

Property Value

workloadResourceIds

The list of workload resource IDs that are hosted within this cluster. NOTE: This property will not be serialized. It can only be populated by the server.

workloadResourceIds?: string[]

Property Value

string[]

Inherited Property Details

id

Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" NOTE: This property will not be serialized. It can only be populated by the server.

id?: string

Property Value

string

Inherited From TrackedResource.id

___location

The geo-___location where the resource lives

___location: string

Property Value

string

Inherited From TrackedResource.___location

name

The name of the resource NOTE: This property will not be serialized. It can only be populated by the server.

name?: string

Property Value

string

Inherited From TrackedResource.name

systemData

Azure Resource Manager metadata containing createdBy and modifiedBy information. NOTE: This property will not be serialized. It can only be populated by the server.

systemData?: SystemData

Property Value

Inherited From TrackedResource.systemData

tags

Resource tags.

tags?: {[propertyName: string]: string}

Property Value

{[propertyName: string]: string}

Inherited From TrackedResource.tags

type

The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts" NOTE: This property will not be serialized. It can only be populated by the server.

type?: string

Property Value

string

Inherited From TrackedResource.type