@pulumi/azure-native
Version:
[](https://slack.pulumi.com) [](https://npmjs.com/package/@pulumi/azure-native) [ • 15.6 kB
TypeScript
import * as pulumi from "@pulumi/pulumi";
import * as outputs from "../types/output";
/**
* Managed cluster.
*
* Uses Azure REST API version 2025-08-01.
*
* Other available API versions: 2019-11-01, 2020-01-01, 2020-02-01, 2020-03-01, 2020-04-01, 2020-06-01, 2020-07-01, 2020-09-01, 2020-11-01, 2020-12-01, 2021-02-01, 2021-03-01, 2021-05-01, 2021-07-01, 2021-08-01, 2021-09-01, 2021-10-01, 2021-11-01-preview, 2022-01-01, 2022-01-02-preview, 2022-02-01, 2022-02-02-preview, 2022-03-01, 2022-03-02-preview, 2022-04-01, 2022-04-02-preview, 2022-05-02-preview, 2022-06-01, 2022-06-02-preview, 2022-07-01, 2022-07-02-preview, 2022-08-02-preview, 2022-08-03-preview, 2022-09-01, 2022-09-02-preview, 2022-10-02-preview, 2022-11-01, 2022-11-02-preview, 2023-01-01, 2023-01-02-preview, 2023-02-01, 2023-02-02-preview, 2023-03-01, 2023-03-02-preview, 2023-04-01, 2023-04-02-preview, 2023-05-01, 2023-05-02-preview, 2023-06-01, 2023-06-02-preview, 2023-07-01, 2023-07-02-preview, 2023-08-01, 2023-08-02-preview, 2023-09-01, 2023-09-02-preview, 2023-10-01, 2023-10-02-preview, 2023-11-01, 2023-11-02-preview, 2024-01-01, 2024-01-02-preview, 2024-02-01, 2024-02-02-preview, 2024-03-02-preview, 2024-04-02-preview, 2024-05-01, 2024-05-02-preview, 2024-06-02-preview, 2024-07-01, 2024-07-02-preview, 2024-08-01, 2024-09-01, 2024-09-02-preview, 2024-10-01, 2024-10-02-preview, 2025-01-01, 2025-01-02-preview, 2025-02-01, 2025-02-02-preview, 2025-03-01, 2025-03-02-preview, 2025-04-01, 2025-04-02-preview, 2025-05-01, 2025-05-02-preview, 2025-06-02-preview, 2025-07-01, 2025-07-02-preview. These can be accessed by generating a local SDK package using the CLI command `pulumi package add azure-native containerservice [ApiVersion]`. See the [version guide](../../../version-guide/#accessing-any-api-version-via-local-packages) for details.
*/
export declare function getManagedCluster(args: GetManagedClusterArgs, opts?: pulumi.InvokeOptions): Promise<GetManagedClusterResult>;
export interface GetManagedClusterArgs {
/**
* The name of the resource group. The name is case insensitive.
*/
resourceGroupName: string;
/**
* The name of the managed cluster resource.
*/
resourceName: string;
}
/**
* Managed cluster.
*/
export interface GetManagedClusterResult {
/**
* The Azure Active Directory configuration.
*/
readonly aadProfile?: outputs.containerservice.ManagedClusterAADProfileResponse;
/**
* The profile of managed cluster add-on.
*/
readonly addonProfiles?: {
[key: string]: outputs.containerservice.ManagedClusterAddonProfileResponse;
};
/**
* The agent pool properties.
*/
readonly agentPoolProfiles?: outputs.containerservice.ManagedClusterAgentPoolProfileResponse[];
/**
* AI toolchain operator settings that apply to the whole cluster.
*/
readonly aiToolchainOperatorProfile?: outputs.containerservice.ManagedClusterAIToolchainOperatorProfileResponse;
/**
* The access profile for managed cluster API server.
*/
readonly apiServerAccessProfile?: outputs.containerservice.ManagedClusterAPIServerAccessProfileResponse;
/**
* Parameters to be applied to the cluster-autoscaler when enabled
*/
readonly autoScalerProfile?: outputs.containerservice.ManagedClusterPropertiesResponseAutoScalerProfile;
/**
* The auto upgrade configuration.
*/
readonly autoUpgradeProfile?: outputs.containerservice.ManagedClusterAutoUpgradeProfileResponse;
/**
* The Azure API version of the resource.
*/
readonly azureApiVersion: string;
/**
* Azure Monitor addon profiles for monitoring the managed cluster.
*/
readonly azureMonitorProfile?: outputs.containerservice.ManagedClusterAzureMonitorProfileResponse;
/**
* The special FQDN used by the Azure Portal to access the Managed Cluster. This FQDN is for use only by the Azure Portal and should not be used by other clients. The Azure Portal requires certain Cross-Origin Resource Sharing (CORS) headers to be sent in some responses, which Kubernetes APIServer doesn't handle by default. This special FQDN supports CORS, allowing the Azure Portal to function properly.
*/
readonly azurePortalFQDN: string;
/**
* Profile of the cluster bootstrap configuration.
*/
readonly bootstrapProfile?: outputs.containerservice.ManagedClusterBootstrapProfileResponse;
/**
* The version of Kubernetes the Managed Cluster is running. If kubernetesVersion was a fully specified version <major.minor.patch>, this field will be exactly equal to it. If kubernetesVersion was <major.minor>, this field will contain the full <major.minor.patch> version being used.
*/
readonly currentKubernetesVersion: string;
/**
* If local accounts should be disabled on the Managed Cluster. If set to true, getting static credentials will be disabled for this cluster. This must only be used on Managed Clusters that are AAD enabled. For more details see [disable local accounts](https://docs.microsoft.com/azure/aks/managed-aad#disable-local-accounts-preview).
*/
readonly disableLocalAccounts?: boolean;
/**
* The Resource ID of the disk encryption set to use for enabling encryption at rest. This is of the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/diskEncryptionSets/{encryptionSetName}'
*/
readonly diskEncryptionSetID?: string;
/**
* The DNS prefix of the Managed Cluster. This cannot be updated once the Managed Cluster has been created.
*/
readonly dnsPrefix?: string;
/**
* Unique read-only string used to implement optimistic concurrency. The eTag value will change when the resource is updated. Specify an if-match or if-none-match header with the eTag value for a subsequent request to enable optimistic concurrency per the normal etag convention.
*/
readonly eTag: string;
/**
* Whether to enable Kubernetes Role-Based Access Control.
*/
readonly enableRBAC?: boolean;
/**
* The extended location of the Virtual Machine.
*/
readonly extendedLocation?: outputs.containerservice.ExtendedLocationResponse;
/**
* The FQDN of the master pool.
*/
readonly fqdn: string;
/**
* The FQDN subdomain of the private cluster with custom private dns zone. This cannot be updated once the Managed Cluster has been created.
*/
readonly fqdnSubdomain?: string;
/**
* Configurations for provisioning the cluster with HTTP proxy servers.
*/
readonly httpProxyConfig?: outputs.containerservice.ManagedClusterHTTPProxyConfigResponse;
/**
* Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
*/
readonly id: string;
/**
* The identity of the managed cluster, if configured.
*/
readonly identity?: outputs.containerservice.ManagedClusterIdentityResponse;
/**
* The user identity associated with the managed cluster. This identity will be used by the kubelet. Only one user assigned identity is allowed. The only accepted key is "kubeletidentity", with value of "resourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".
*/
readonly identityProfile?: {
[key: string]: outputs.containerservice.UserAssignedIdentityResponse;
};
/**
* Ingress profile for the managed cluster.
*/
readonly ingressProfile?: outputs.containerservice.ManagedClusterIngressProfileResponse;
/**
* This is primarily used to expose different UI experiences in the portal for different kinds
*/
readonly kind?: string;
/**
* The version of Kubernetes specified by the user. Both patch version <major.minor.patch> (e.g. 1.20.13) and <major.minor> (e.g. 1.20) are supported. When <major.minor> is specified, the latest supported GA patch version is chosen automatically. Updating the cluster with the same <major.minor> once it has been created (e.g. 1.14.x -> 1.14) will not trigger an upgrade, even if a newer patch version is available. When you upgrade a supported AKS cluster, Kubernetes minor versions cannot be skipped. All upgrades must be performed sequentially by major version number. For example, upgrades between 1.14.x -> 1.15.x or 1.15.x -> 1.16.x are allowed, however 1.14.x -> 1.16.x is not allowed. See [upgrading an AKS cluster](https://docs.microsoft.com/azure/aks/upgrade-cluster) for more details.
*/
readonly kubernetesVersion?: string;
/**
* The profile for Linux VMs in the Managed Cluster.
*/
readonly linuxProfile?: outputs.containerservice.ContainerServiceLinuxProfileResponse;
/**
* The geo-location where the resource lives
*/
readonly location: string;
/**
* The max number of agent pools for the managed cluster.
*/
readonly maxAgentPools: number;
/**
* Optional cluster metrics configuration.
*/
readonly metricsProfile?: outputs.containerservice.ManagedClusterMetricsProfileResponse;
/**
* The name of the resource
*/
readonly name: string;
/**
* The network configuration profile.
*/
readonly networkProfile?: outputs.containerservice.ContainerServiceNetworkProfileResponse;
/**
* Node provisioning settings that apply to the whole cluster.
*/
readonly nodeProvisioningProfile?: outputs.containerservice.ManagedClusterNodeProvisioningProfileResponse;
/**
* The name of the resource group containing agent pool nodes.
*/
readonly nodeResourceGroup?: string;
/**
* Profile of the node resource group configuration.
*/
readonly nodeResourceGroupProfile?: outputs.containerservice.ManagedClusterNodeResourceGroupProfileResponse;
/**
* The OIDC issuer profile of the Managed Cluster.
*/
readonly oidcIssuerProfile?: outputs.containerservice.ManagedClusterOIDCIssuerProfileResponse;
/**
* The pod identity profile of the Managed Cluster. See [use AAD pod identity](https://docs.microsoft.com/azure/aks/use-azure-ad-pod-identity) for more details on AAD pod identity integration.
*/
readonly podIdentityProfile?: outputs.containerservice.ManagedClusterPodIdentityProfileResponse;
/**
* The Power State of the cluster.
*/
readonly powerState: outputs.containerservice.PowerStateResponse;
/**
* The FQDN of private cluster.
*/
readonly privateFQDN: string;
/**
* Private link resources associated with the cluster.
*/
readonly privateLinkResources?: outputs.containerservice.PrivateLinkResourceResponse[];
/**
* The current provisioning state.
*/
readonly provisioningState: string;
/**
* PublicNetworkAccess of the managedCluster. Allow or deny public network access for AKS
*/
readonly publicNetworkAccess?: string;
/**
* The resourceUID uniquely identifies ManagedClusters that reuse ARM ResourceIds (i.e: create, delete, create sequence)
*/
readonly resourceUID: string;
/**
* Security profile for the managed cluster.
*/
readonly securityProfile?: outputs.containerservice.ManagedClusterSecurityProfileResponse;
/**
* Service mesh profile for a managed cluster.
*/
readonly serviceMeshProfile?: outputs.containerservice.ServiceMeshProfileResponse;
/**
* Information about a service principal identity for the cluster to use for manipulating Azure APIs.
*/
readonly servicePrincipalProfile?: outputs.containerservice.ManagedClusterServicePrincipalProfileResponse;
/**
* The managed cluster SKU.
*/
readonly sku?: outputs.containerservice.ManagedClusterSKUResponse;
/**
* Contains read-only information about the Managed Cluster.
*/
readonly status?: outputs.containerservice.ManagedClusterStatusResponse;
/**
* Storage profile for the managed cluster.
*/
readonly storageProfile?: outputs.containerservice.ManagedClusterStorageProfileResponse;
/**
* The support plan for the Managed Cluster. If unspecified, the default is 'KubernetesOfficial'.
*/
readonly supportPlan?: string;
/**
* Azure Resource Manager metadata containing createdBy and modifiedBy information.
*/
readonly systemData: outputs.containerservice.SystemDataResponse;
/**
* Resource tags.
*/
readonly tags?: {
[key: string]: string;
};
/**
* The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
*/
readonly type: string;
/**
* Settings for upgrading a cluster.
*/
readonly upgradeSettings?: outputs.containerservice.ClusterUpgradeSettingsResponse;
/**
* The profile for Windows VMs in the Managed Cluster.
*/
readonly windowsProfile?: outputs.containerservice.ManagedClusterWindowsProfileResponse;
/**
* Workload Auto-scaler profile for the managed cluster.
*/
readonly workloadAutoScalerProfile?: outputs.containerservice.ManagedClusterWorkloadAutoScalerProfileResponse;
}
/**
* Managed cluster.
*
* Uses Azure REST API version 2025-08-01.
*
* Other available API versions: 2019-11-01, 2020-01-01, 2020-02-01, 2020-03-01, 2020-04-01, 2020-06-01, 2020-07-01, 2020-09-01, 2020-11-01, 2020-12-01, 2021-02-01, 2021-03-01, 2021-05-01, 2021-07-01, 2021-08-01, 2021-09-01, 2021-10-01, 2021-11-01-preview, 2022-01-01, 2022-01-02-preview, 2022-02-01, 2022-02-02-preview, 2022-03-01, 2022-03-02-preview, 2022-04-01, 2022-04-02-preview, 2022-05-02-preview, 2022-06-01, 2022-06-02-preview, 2022-07-01, 2022-07-02-preview, 2022-08-02-preview, 2022-08-03-preview, 2022-09-01, 2022-09-02-preview, 2022-10-02-preview, 2022-11-01, 2022-11-02-preview, 2023-01-01, 2023-01-02-preview, 2023-02-01, 2023-02-02-preview, 2023-03-01, 2023-03-02-preview, 2023-04-01, 2023-04-02-preview, 2023-05-01, 2023-05-02-preview, 2023-06-01, 2023-06-02-preview, 2023-07-01, 2023-07-02-preview, 2023-08-01, 2023-08-02-preview, 2023-09-01, 2023-09-02-preview, 2023-10-01, 2023-10-02-preview, 2023-11-01, 2023-11-02-preview, 2024-01-01, 2024-01-02-preview, 2024-02-01, 2024-02-02-preview, 2024-03-02-preview, 2024-04-02-preview, 2024-05-01, 2024-05-02-preview, 2024-06-02-preview, 2024-07-01, 2024-07-02-preview, 2024-08-01, 2024-09-01, 2024-09-02-preview, 2024-10-01, 2024-10-02-preview, 2025-01-01, 2025-01-02-preview, 2025-02-01, 2025-02-02-preview, 2025-03-01, 2025-03-02-preview, 2025-04-01, 2025-04-02-preview, 2025-05-01, 2025-05-02-preview, 2025-06-02-preview, 2025-07-01, 2025-07-02-preview. These can be accessed by generating a local SDK package using the CLI command `pulumi package add azure-native containerservice [ApiVersion]`. See the [version guide](../../../version-guide/#accessing-any-api-version-via-local-packages) for details.
*/
export declare function getManagedClusterOutput(args: GetManagedClusterOutputArgs, opts?: pulumi.InvokeOutputOptions): pulumi.Output<GetManagedClusterResult>;
export interface GetManagedClusterOutputArgs {
/**
* The name of the resource group. The name is case insensitive.
*/
resourceGroupName: pulumi.Input<string>;
/**
* The name of the managed cluster resource.
*/
resourceName: pulumi.Input<string>;
}