azuredevops.ServiceEndpoint.Kubernetes (v2)

Azure DevOps v2.15.1 (2.x), Mar 9 26

Viewing docs for Azure DevOps v2.15.1 (Older version)
published on Monday, Mar 9, 2026 by Pulumi

Go to latest version

Schema (JSON)

pulumi/pulumi-azuredevops

Viewing docs for Azure DevOps v2.15.1 (Older version)
published on Monday, Mar 9, 2026 by Pulumi

Go to latest version

Schema (JSON)

pulumi/pulumi-azuredevops

Create Kubernetes Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new Kubernetes(name: string, args: KubernetesArgs, opts?: CustomResourceOptions);

@overload
def Kubernetes(resource_name: str,
               args: KubernetesArgs,
               opts: Optional[ResourceOptions] = None)

@overload
def Kubernetes(resource_name: str,
               opts: Optional[ResourceOptions] = None,
               apiserver_url: Optional[str] = None,
               authorization: Optional[Mapping[str, str]] = None,
               authorization_type: Optional[str] = None,
               azure_subscriptions: Optional[Sequence[KubernetesAzureSubscriptionArgs]] = None,
               description: Optional[str] = None,
               kubeconfig: Optional[KubernetesKubeconfigArgs] = None,
               project_id: Optional[str] = None,
               service_account: Optional[KubernetesServiceAccountArgs] = None,
               service_endpoint_name: Optional[str] = None)

func NewKubernetes(ctx *Context, name string, args KubernetesArgs, opts ...ResourceOption) (*Kubernetes, error)

public Kubernetes(string name, KubernetesArgs args, CustomResourceOptions? opts = null)

public Kubernetes(String name, KubernetesArgs args)
public Kubernetes(String name, KubernetesArgs args, CustomResourceOptions options)

type: azuredevops:ServiceEndpoint:Kubernetes
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name string: The unique name of the resource.
args KubernetesArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

resource_name str: The unique name of the resource.
args KubernetesArgs: The arguments to resource properties.
opts ResourceOptions: Bag of options to control resource's behavior.

ctx Context: Context object for the current deployment.
name string: The unique name of the resource.
args KubernetesArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args KubernetesArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args KubernetesArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

Kubernetes Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The Kubernetes resource accepts the following input properties:

ApiserverUrl string: The hostname (in form of URI) of the Kubernetes API.
AuthorizationType string: The authentication method used to authenticate on the Kubernetes cluster. The value should be one of AzureSubscription, Kubeconfig, ServiceAccount.
ProjectId string: The ID of the project.
ServiceEndpointName string: The Service Endpoint name.
Authorization Dictionary<string, string>
AzureSubscriptions List<Pulumi.AzureDevOps.ServiceEndpoint.Inputs.KubernetesAzureSubscription>: A azure_subscription block defined blow.
Description string
Kubeconfig Pulumi.AzureDevOps.ServiceEndpoint.Inputs.KubernetesKubeconfig: A kubeconfig block defined blow.
ServiceAccount Pulumi.AzureDevOps.ServiceEndpoint.Inputs.KubernetesServiceAccount: A service_account block defined blow.

ApiserverUrl string: The hostname (in form of URI) of the Kubernetes API.
AuthorizationType string: The authentication method used to authenticate on the Kubernetes cluster. The value should be one of AzureSubscription, Kubeconfig, ServiceAccount.
ProjectId string: The ID of the project.
ServiceEndpointName string: The Service Endpoint name.
Authorization map[string]string
AzureSubscriptions []KubernetesAzureSubscriptionArgs: A azure_subscription block defined blow.
Description string
Kubeconfig KubernetesKubeconfigArgs: A kubeconfig block defined blow.
ServiceAccount KubernetesServiceAccountArgs: A service_account block defined blow.

apiserverUrl String: The hostname (in form of URI) of the Kubernetes API.
authorizationType String: The authentication method used to authenticate on the Kubernetes cluster. The value should be one of AzureSubscription, Kubeconfig, ServiceAccount.
projectId String: The ID of the project.
serviceEndpointName String: The Service Endpoint name.
authorization Map<String,String>
azureSubscriptions List<KubernetesAzureSubscription>: A azure_subscription block defined blow.
description String
kubeconfig KubernetesKubeconfig: A kubeconfig block defined blow.
serviceAccount KubernetesServiceAccount: A service_account block defined blow.

apiserverUrl string: The hostname (in form of URI) of the Kubernetes API.
authorizationType string: The authentication method used to authenticate on the Kubernetes cluster. The value should be one of AzureSubscription, Kubeconfig, ServiceAccount.
projectId string: The ID of the project.
serviceEndpointName string: The Service Endpoint name.
authorization {[key: string]: string}
azureSubscriptions KubernetesAzureSubscription[]: A azure_subscription block defined blow.
description string
kubeconfig KubernetesKubeconfig: A kubeconfig block defined blow.
serviceAccount KubernetesServiceAccount: A service_account block defined blow.

apiserver_url str: The hostname (in form of URI) of the Kubernetes API.
authorization_type str: The authentication method used to authenticate on the Kubernetes cluster. The value should be one of AzureSubscription, Kubeconfig, ServiceAccount.
project_id str: The ID of the project.
service_endpoint_name str: The Service Endpoint name.
authorization Mapping[str, str]
azure_subscriptions Sequence[KubernetesAzureSubscriptionArgs]: A azure_subscription block defined blow.
description str
kubeconfig KubernetesKubeconfigArgs: A kubeconfig block defined blow.
service_account KubernetesServiceAccountArgs: A service_account block defined blow.

apiserverUrl String: The hostname (in form of URI) of the Kubernetes API.
authorizationType String: The authentication method used to authenticate on the Kubernetes cluster. The value should be one of AzureSubscription, Kubeconfig, ServiceAccount.
projectId String: The ID of the project.
serviceEndpointName String: The Service Endpoint name.
authorization Map<String>
azureSubscriptions List<Property Map>: A azure_subscription block defined blow.
description String
kubeconfig Property Map: A kubeconfig block defined blow.
serviceAccount Property Map: A service_account block defined blow.

Outputs

All input properties are implicitly available as output properties. Additionally, the Kubernetes resource produces the following output properties:

Id string: The provider-assigned unique ID for this managed resource.

Id string: The provider-assigned unique ID for this managed resource.

id String: The provider-assigned unique ID for this managed resource.

id string: The provider-assigned unique ID for this managed resource.

id str: The provider-assigned unique ID for this managed resource.

id String: The provider-assigned unique ID for this managed resource.

Look up Existing Kubernetes Resource

Get an existing Kubernetes resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: KubernetesState, opts?: CustomResourceOptions): Kubernetes

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        apiserver_url: Optional[str] = None,
        authorization: Optional[Mapping[str, str]] = None,
        authorization_type: Optional[str] = None,
        azure_subscriptions: Optional[Sequence[KubernetesAzureSubscriptionArgs]] = None,
        description: Optional[str] = None,
        kubeconfig: Optional[KubernetesKubeconfigArgs] = None,
        project_id: Optional[str] = None,
        service_account: Optional[KubernetesServiceAccountArgs] = None,
        service_endpoint_name: Optional[str] = None) -> Kubernetes

func GetKubernetes(ctx *Context, name string, id IDInput, state *KubernetesState, opts ...ResourceOption) (*Kubernetes, error)

public static Kubernetes Get(string name, Input<string> id, KubernetesState? state, CustomResourceOptions? opts = null)

public static Kubernetes get(String name, Output<String> id, KubernetesState state, CustomResourceOptions options)

resources:  _:    type: azuredevops:ServiceEndpoint:Kubernetes    get:      id: ${id}

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

resource_name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

The following state arguments are supported:

ApiserverUrl string: The hostname (in form of URI) of the Kubernetes API.
Authorization Dictionary<string, string>
AuthorizationType string: The authentication method used to authenticate on the Kubernetes cluster. The value should be one of AzureSubscription, Kubeconfig, ServiceAccount.
AzureSubscriptions List<Pulumi.AzureDevOps.ServiceEndpoint.Inputs.KubernetesAzureSubscription>: A azure_subscription block defined blow.
Description string
Kubeconfig Pulumi.AzureDevOps.ServiceEndpoint.Inputs.KubernetesKubeconfig: A kubeconfig block defined blow.
ProjectId string: The ID of the project.
ServiceAccount Pulumi.AzureDevOps.ServiceEndpoint.Inputs.KubernetesServiceAccount: A service_account block defined blow.
ServiceEndpointName string: The Service Endpoint name.

ApiserverUrl string: The hostname (in form of URI) of the Kubernetes API.
Authorization map[string]string
AuthorizationType string: The authentication method used to authenticate on the Kubernetes cluster. The value should be one of AzureSubscription, Kubeconfig, ServiceAccount.
AzureSubscriptions []KubernetesAzureSubscriptionArgs: A azure_subscription block defined blow.
Description string
Kubeconfig KubernetesKubeconfigArgs: A kubeconfig block defined blow.
ProjectId string: The ID of the project.
ServiceAccount KubernetesServiceAccountArgs: A service_account block defined blow.
ServiceEndpointName string: The Service Endpoint name.

apiserverUrl String: The hostname (in form of URI) of the Kubernetes API.
authorization Map<String,String>
authorizationType String: The authentication method used to authenticate on the Kubernetes cluster. The value should be one of AzureSubscription, Kubeconfig, ServiceAccount.
azureSubscriptions List<KubernetesAzureSubscription>: A azure_subscription block defined blow.
description String
kubeconfig KubernetesKubeconfig: A kubeconfig block defined blow.
projectId String: The ID of the project.
serviceAccount KubernetesServiceAccount: A service_account block defined blow.
serviceEndpointName String: The Service Endpoint name.

apiserverUrl string: The hostname (in form of URI) of the Kubernetes API.
authorization {[key: string]: string}
authorizationType string: The authentication method used to authenticate on the Kubernetes cluster. The value should be one of AzureSubscription, Kubeconfig, ServiceAccount.
azureSubscriptions KubernetesAzureSubscription[]: A azure_subscription block defined blow.
description string
kubeconfig KubernetesKubeconfig: A kubeconfig block defined blow.
projectId string: The ID of the project.
serviceAccount KubernetesServiceAccount: A service_account block defined blow.
serviceEndpointName string: The Service Endpoint name.

apiserver_url str: The hostname (in form of URI) of the Kubernetes API.
authorization Mapping[str, str]
authorization_type str: The authentication method used to authenticate on the Kubernetes cluster. The value should be one of AzureSubscription, Kubeconfig, ServiceAccount.
azure_subscriptions Sequence[KubernetesAzureSubscriptionArgs]: A azure_subscription block defined blow.
description str
kubeconfig KubernetesKubeconfigArgs: A kubeconfig block defined blow.
project_id str: The ID of the project.
service_account KubernetesServiceAccountArgs: A service_account block defined blow.
service_endpoint_name str: The Service Endpoint name.

apiserverUrl String: The hostname (in form of URI) of the Kubernetes API.
authorization Map<String>
authorizationType String: The authentication method used to authenticate on the Kubernetes cluster. The value should be one of AzureSubscription, Kubeconfig, ServiceAccount.
azureSubscriptions List<Property Map>: A azure_subscription block defined blow.
description String
kubeconfig Property Map: A kubeconfig block defined blow.
projectId String: The ID of the project.
serviceAccount Property Map: A service_account block defined blow.
serviceEndpointName String: The Service Endpoint name.

Supporting Types

KubernetesAzureSubscription, KubernetesAzureSubscriptionArgs

ClusterName string: The name of the Kubernetes cluster.
ResourcegroupId string: The resource group name, to which the Kubernetes cluster is deployed.
SubscriptionId string: The id of the Azure subscription.
SubscriptionName string: The name of the Azure subscription.
TenantId string: The id of the tenant used by the subscription.
AzureEnvironment string: Azure environment refers to whether the public cloud offering or domestic (government) clouds are being used. Currently, only the public cloud is supported. The value must be AzureCloud. This is also the default-value.
ClusterAdmin bool: Set this option to allow use cluster admin credentials.
Namespace string: The Kubernetes namespace. Default value is "default".

ClusterName string: The name of the Kubernetes cluster.
ResourcegroupId string: The resource group name, to which the Kubernetes cluster is deployed.
SubscriptionId string: The id of the Azure subscription.
SubscriptionName string: The name of the Azure subscription.
TenantId string: The id of the tenant used by the subscription.
AzureEnvironment string: Azure environment refers to whether the public cloud offering or domestic (government) clouds are being used. Currently, only the public cloud is supported. The value must be AzureCloud. This is also the default-value.
ClusterAdmin bool: Set this option to allow use cluster admin credentials.
Namespace string: The Kubernetes namespace. Default value is "default".

clusterName String: The name of the Kubernetes cluster.
resourcegroupId String: The resource group name, to which the Kubernetes cluster is deployed.
subscriptionId String: The id of the Azure subscription.
subscriptionName String: The name of the Azure subscription.
tenantId String: The id of the tenant used by the subscription.
azureEnvironment String: Azure environment refers to whether the public cloud offering or domestic (government) clouds are being used. Currently, only the public cloud is supported. The value must be AzureCloud. This is also the default-value.
clusterAdmin Boolean: Set this option to allow use cluster admin credentials.
namespace String: The Kubernetes namespace. Default value is "default".

clusterName string: The name of the Kubernetes cluster.
resourcegroupId string: The resource group name, to which the Kubernetes cluster is deployed.
subscriptionId string: The id of the Azure subscription.
subscriptionName string: The name of the Azure subscription.
tenantId string: The id of the tenant used by the subscription.
azureEnvironment string: Azure environment refers to whether the public cloud offering or domestic (government) clouds are being used. Currently, only the public cloud is supported. The value must be AzureCloud. This is also the default-value.
clusterAdmin boolean: Set this option to allow use cluster admin credentials.
namespace string: The Kubernetes namespace. Default value is "default".

cluster_name str: The name of the Kubernetes cluster.
resourcegroup_id str: The resource group name, to which the Kubernetes cluster is deployed.
subscription_id str: The id of the Azure subscription.
subscription_name str: The name of the Azure subscription.
tenant_id str: The id of the tenant used by the subscription.
azure_environment str: Azure environment refers to whether the public cloud offering or domestic (government) clouds are being used. Currently, only the public cloud is supported. The value must be AzureCloud. This is also the default-value.
cluster_admin bool: Set this option to allow use cluster admin credentials.
namespace str: The Kubernetes namespace. Default value is "default".

clusterName String: The name of the Kubernetes cluster.
resourcegroupId String: The resource group name, to which the Kubernetes cluster is deployed.
subscriptionId String: The id of the Azure subscription.
subscriptionName String: The name of the Azure subscription.
tenantId String: The id of the tenant used by the subscription.
azureEnvironment String: Azure environment refers to whether the public cloud offering or domestic (government) clouds are being used. Currently, only the public cloud is supported. The value must be AzureCloud. This is also the default-value.
clusterAdmin Boolean: Set this option to allow use cluster admin credentials.
namespace String: The Kubernetes namespace. Default value is "default".

KubernetesKubeconfig, KubernetesKubeconfigArgs

KubeConfig string: The content of the kubeconfig in yaml notation to be used to communicate with the API-Server of Kubernetes.
AcceptUntrustedCerts bool: Set this option to allow clients to accept a self-signed certificate.
ClusterContext string: Context within the kubeconfig file that is to be used for identifying the cluster. Default value is the current-context set in kubeconfig.

KubeConfig string: The content of the kubeconfig in yaml notation to be used to communicate with the API-Server of Kubernetes.
AcceptUntrustedCerts bool: Set this option to allow clients to accept a self-signed certificate.
ClusterContext string: Context within the kubeconfig file that is to be used for identifying the cluster. Default value is the current-context set in kubeconfig.

kubeConfig String: The content of the kubeconfig in yaml notation to be used to communicate with the API-Server of Kubernetes.
acceptUntrustedCerts Boolean: Set this option to allow clients to accept a self-signed certificate.
clusterContext String: Context within the kubeconfig file that is to be used for identifying the cluster. Default value is the current-context set in kubeconfig.

kubeConfig string: The content of the kubeconfig in yaml notation to be used to communicate with the API-Server of Kubernetes.
acceptUntrustedCerts boolean: Set this option to allow clients to accept a self-signed certificate.
clusterContext string: Context within the kubeconfig file that is to be used for identifying the cluster. Default value is the current-context set in kubeconfig.

kube_config str: The content of the kubeconfig in yaml notation to be used to communicate with the API-Server of Kubernetes.
accept_untrusted_certs bool: Set this option to allow clients to accept a self-signed certificate.
cluster_context str: Context within the kubeconfig file that is to be used for identifying the cluster. Default value is the current-context set in kubeconfig.

kubeConfig String: The content of the kubeconfig in yaml notation to be used to communicate with the API-Server of Kubernetes.
acceptUntrustedCerts Boolean: Set this option to allow clients to accept a self-signed certificate.
clusterContext String: Context within the kubeconfig file that is to be used for identifying the cluster. Default value is the current-context set in kubeconfig.

KubernetesServiceAccount, KubernetesServiceAccountArgs

CaCert string: The certificate from a Kubernetes secret object.
Token string: The token from a Kubernetes secret object.

CaCert string: The certificate from a Kubernetes secret object.
Token string: The token from a Kubernetes secret object.

caCert String: The certificate from a Kubernetes secret object.
token String: The token from a Kubernetes secret object.

caCert string: The certificate from a Kubernetes secret object.
token string: The token from a Kubernetes secret object.

ca_cert str: The certificate from a Kubernetes secret object.
token str: The token from a Kubernetes secret object.

caCert String: The certificate from a Kubernetes secret object.
token String: The token from a Kubernetes secret object.

Import

Azure DevOps Service Endpoint Kubernetes can be imported using projectID/serviceEndpointID or projectName/serviceEndpointID

$ pulumi import azuredevops:ServiceEndpoint/kubernetes:Kubernetes example 00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000000

To learn more about importing existing cloud resources, see Importing resources.

Package Details

Repository: Azure DevOps pulumi/pulumi-azuredevops
License: Apache-2.0
Notes: This Pulumi package is based on the azuredevops Terraform Provider.

Viewing docs for Azure DevOps v2.15.1 (Older version)
published on Monday, Mar 9, 2026 by Pulumi

Go to latest version

Schema (JSON)

pulumi/pulumi-azuredevops

azuredevops.ServiceEndpoint.Kubernetes

On this page

On this page

Create Kubernetes Resource

Constructor syntax

Parameters

Kubernetes Resource Properties

Inputs

Outputs

Look up Existing Kubernetes Resource

Supporting Types

KubernetesAzureSubscription, KubernetesAzureSubscriptionArgs

KubernetesKubeconfig, KubernetesKubeconfigArgs

KubernetesServiceAccount, KubernetesServiceAccountArgs

Import

Package Details

On this page

On this page