PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/kubeEnvironments/{name}/?api-version=2023-01-01

Description for Creates or updates a Kubernetes Environment.

Servers

Path parameters

Name Type Required Description
name String Yes

Name of the Kubernetes Environment.

subscriptionId String Yes

Your Azure subscription ID. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000).

resourceGroupName String Yes

Name of the resource group to which the resource belongs.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
id String No

Resource Id.

name String No

Resource Name.

properties Object No

KubeEnvironmentPatchResource resource specific properties

properties.containerAppsConfiguration Object No
properties.containerAppsConfiguration.appSubnetResourceId String No

Resource ID of a subnet for control plane infrastructure components. This subnet must be in the same VNET as the subnet defined in appSubnetResourceId. Must not overlap with the IP range defined in platformReservedCidr, if defined.

properties.containerAppsConfiguration.controlPlaneSubnetResourceId String No

Resource ID of a subnet for control plane infrastructure components. This subnet must be in the same VNET as the subnet defined in appSubnetResourceId. Must not overlap with the IP range defined in platformReservedCidr, if defined.

properties.containerAppsConfiguration.platformReservedCidr String No

IP range in CIDR notation that can be reserved for environment infrastructure IP addresses. It must not overlap with any other Subnet IP ranges.

properties.containerAppsConfiguration.platformReservedDnsIP String No

An IP address from the IP range defined by platformReservedCidr that will be reserved for the internal DNS server

properties.containerAppsConfiguration.dockerBridgeCidr String No

CIDR notation IP range assigned to the Docker bridge network. It must not overlap with any Subnet IP ranges or the IP range defined in platformReservedCidr, if defined.

properties.containerAppsConfiguration.daprAIInstrumentationKey String No

Azure Monitor instrumentation key used by Dapr to export Service to Service communication telemetry

properties.appLogsConfiguration Object No
properties.appLogsConfiguration.destination String No
properties.appLogsConfiguration.logAnalyticsConfiguration Object No
properties.appLogsConfiguration.logAnalyticsConfiguration.sharedKey String No
properties.appLogsConfiguration.logAnalyticsConfiguration.customerId String No
properties.defaultDomain String No

Default Domain Name for the cluster

properties.provisioningState String No

Provisioning state of the Kubernetes Environment.

Possible values:

  • "InfrastructureSetupInProgress"
  • "Succeeded"
  • "InfrastructureSetupComplete"
  • "Canceled"
  • "Waiting"
  • "ScheduledForDelete"
  • "UpgradeFailed"
  • "UpgradeRequested"
  • "Failed"
  • "InitializationInProgress"
properties.deploymentErrors String No

Any errors that occurred during deployment or deployment validation

properties.staticIp String No

Static IP of the KubeEnvironment

properties.aksResourceID String No
properties.arcConfiguration Object No
properties.arcConfiguration.kubeConfig String No
properties.arcConfiguration.frontEndServiceConfiguration Object No
properties.arcConfiguration.frontEndServiceConfiguration.kind String No

Possible values:

  • "LoadBalancer"
  • "NodePort"
properties.arcConfiguration.artifactsStorageType String No

Possible values:

  • "NetworkFileSystem"
  • "LocalNode"
properties.arcConfiguration.artifactStorageAccessMode String No
properties.arcConfiguration.artifactStorageMountPath String No
properties.arcConfiguration.artifactStorageClassName String No
properties.arcConfiguration.artifactStorageNodeName String No
properties.internalLoadBalancerEnabled Boolean No

Only visible within Vnet/Subnet

type String No

Resource type.

kind String No

Kind of resource.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.