Kube Environments - Create Or Update

Szolgáltatás:

App Service

API-verzió:

2025-05-01

Kubernetes-környezet létrehozása vagy frissítése leírása.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/kubeEnvironments/{name}?api-version=2025-05-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
name	path	True	string	A Kubernetes-környezet neve.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem törzse

Name	Kötelező	Típus	Description
location	True	string	Az a földrajzi hely, ahol az erőforrás él
extendedLocation		ExtendedLocation	Kiterjesztett hely.
kind		string	Erőforrás típusa.
properties.aksResourceID		string
properties.appLogsConfiguration		AppLogsConfiguration	Fürtkonfiguráció, amely lehetővé teszi, hogy a naplódémon exportálja az alkalmazásnaplókat egy célhelyre. Jelenleg csak a "log-analytics" támogatott
properties.arcConfiguration		ArcConfiguration	Az ARC-fürt összetevőinek típusát meghatározó fürtkonfiguráció. Például: Választás a BuildService típus, a FrontEnd Service ArtifactsStorageType stb. között.
properties.containerAppsConfiguration		ContainerAppsConfiguration	A Container Apps-környezetek fürtkonfigurációja a Dapr Instrumentation Key és a VNET konfigurációjának konfigurálásához
properties.environmentType		string	A Kubernetes-környezet típusa. Csak felügyelt értékekkel rendelkező Tárolóalkalmazás-környezetek esetén támogatott
properties.internalLoadBalancerEnabled		boolean	Csak a virtuális hálózaton/alhálózaton belül látható
properties.staticIp		string	A KubeEnvironment statikus IP-címe
tags		object	Erőforráscímkék.

Válaszok

Name	Típus	Description
200 OK	KubeEnvironment	A 'KubeEnvironment' erőforrás frissítési művelete sikeres
201 Created	KubeEnvironment	'KubeEnvironment' erőforrás sikeres műveletet hozott létre Fejlécek Location: string Retry-After: integer
Other Status Codes	DefaultErrorResponse	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Create kube environments

Mintakérelem

HTTP

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.Web/kubeEnvironments/testkubeenv?api-version=2025-05-01

{
  "location": "East US",
  "properties": {
    "staticIp": "1.2.3.4"
  }
}

Java

import com.azure.resourcemanager.appservice.fluent.models.KubeEnvironmentInner;

/**
 * Samples for KubeEnvironments CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2025-05-01/KubeEnvironments_CreateOrUpdate.json
     */
    /**
     * Sample code: Create kube environments.
     * 
     * @param manager Entry point to AppServiceManager.
     */
    public static void createKubeEnvironments(com.azure.resourcemanager.appservice.AppServiceManager manager) {
        manager.serviceClient().getKubeEnvironments().createOrUpdate("examplerg", "testkubeenv",
            new KubeEnvironmentInner().withLocation("East US").withStaticIp("1.2.3.4"),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armappservice_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/appservice/armappservice/v6"
)

// Generated from example definition: 2025-05-01/KubeEnvironments_CreateOrUpdate.json
func ExampleKubeEnvironmentsClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armappservice.NewClientFactory("34adfa4f-cedf-4dc0-ba29-b6d1a69ab345", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewKubeEnvironmentsClient().BeginCreateOrUpdate(ctx, "examplerg", "testkubeenv", armappservice.KubeEnvironment{
		Location: to.Ptr("East US"),
		Properties: &armappservice.KubeEnvironmentProperties{
			StaticIP: to.Ptr("1.2.3.4"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armappservice.KubeEnvironmentsClientCreateOrUpdateResponse{
	// 	KubeEnvironment: &armappservice.KubeEnvironment{
	// 		Name: to.Ptr("testkubeenv"),
	// 		Type: to.Ptr("Microsoft.Web/kubeEnvironments"),
	// 		ExtendedLocation: &armappservice.ExtendedLocation{
	// 			Name: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.ExtendedLocation/customLocations/testcustomlocation"),
	// 			Type: to.Ptr("customLocation"),
	// 		},
	// 		ID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.Web/kubeEnvironments/testkubeenv"),
	// 		Location: to.Ptr("East US"),
	// 		Properties: &armappservice.KubeEnvironmentProperties{
	// 			AksResourceID: to.Ptr("test"),
	// 			DefaultDomain: to.Ptr("testkubeenv.k4apps.io"),
	// 			InternalLoadBalancerEnabled: to.Ptr(false),
	// 			ProvisioningState: to.Ptr(armappservice.KubeEnvironmentProvisioningStateSucceeded),
	// 			StaticIP: to.Ptr("1.2.3.4"),
	// 		},
	// 		Tags: map[string]*string{
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Mintaválasz

Állapotkód:

200

{
  "name": "testkubeenv",
  "type": "Microsoft.Web/kubeEnvironments",
  "extendedLocation": {
    "name": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.ExtendedLocation/customLocations/testcustomlocation",
    "type": "customLocation"
  },
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.Web/kubeEnvironments/testkubeenv",
  "location": "East US",
  "properties": {
    "aksResourceID": "test",
    "appLogsConfiguration": null,
    "arcConfiguration": null,
    "defaultDomain": "testkubeenv.k4apps.io",
    "deploymentErrors": null,
    "internalLoadBalancerEnabled": false,
    "provisioningState": "Succeeded",
    "staticIp": "1.2.3.4"
  },
  "tags": {}
}

Állapotkód:

201

{
  "name": "testkubeenv",
  "type": "Microsoft.Web/kubeEnvironments",
  "extendedLocation": {
    "name": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.ExtendedLocation/customLocations/testcustomlocation",
    "type": "customLocation"
  },
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.Web/kubeEnvironments/testkubeenv",
  "location": "East US",
  "properties": {
    "aksResourceID": "test",
    "appLogsConfiguration": null,
    "arcConfiguration": null,
    "defaultDomain": "testkubeenv.k4apps.io",
    "deploymentErrors": null,
    "internalLoadBalancerEnabled": false,
    "provisioningState": "InitializationInProgress",
    "staticIp": "1.2.3.4"
  },
  "tags": {}
}

Definíciók

Name	Description
AppLogsConfiguration
ArcConfiguration
ContainerAppsConfiguration
createdByType	Az erőforrást létrehozó identitás típusa.
DefaultErrorResponse	App Service-hibaválasz.
DefaultErrorResponseError	Hibamodell.
DefaultErrorResponseErrorDetailsItem	Részletes hibák.
ExtendedLocation	Kiterjesztett hely.
FrontEndConfiguration
FrontEndServiceType
KubeEnvironment	A Azure App Service webes számítási feladatokra specializálódott Kubernetes-fürt
KubeEnvironmentProvisioningState	A Kubernetes-környezet kiépítési állapota.
LogAnalyticsConfiguration
StorageType
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

AppLogsConfiguration

Tárgy

Name	Típus	Description
destination	string
logAnalyticsConfiguration	LogAnalyticsConfiguration

ArcConfiguration

Tárgy

Name	Típus	Description
artifactStorageAccessMode	string
artifactStorageClassName	string
artifactStorageMountPath	string
artifactStorageNodeName	string
artifactsStorageType	StorageType
frontEndServiceConfiguration	FrontEndConfiguration
kubeConfig	string (password)

ContainerAppsConfiguration

Tárgy

Name	Típus	Description
appSubnetResourceId	string	A vezérlősík-infrastruktúra összetevőinek alhálózatának erőforrás-azonosítója. Ennek az alhálózatnak ugyanabban a virtuális hálózaton kell lennie, mint az appSubnetResourceId fájlban definiált alhálózatnak. Ha meg van adva, nem lehet átfedésben a platformReservedCidrben definiált IP-tartománnyal.
controlPlaneSubnetResourceId	string	A vezérlősík-infrastruktúra összetevőinek alhálózatának erőforrás-azonosítója. Ennek az alhálózatnak ugyanabban a virtuális hálózaton kell lennie, mint az appSubnetResourceId fájlban definiált alhálózatnak. Ha meg van adva, nem lehet átfedésben a platformReservedCidrben definiált IP-tartománnyal.
daprAIInstrumentationKey	string	A Dapr által a Szolgáltatás szolgáltatásba irányuló kommunikációs telemetriai adatok exportálásához használt Azure Monitor-rendszerállapot-kulcs
dockerBridgeCidr	string	A Docker-híd hálózatához rendelt CIDR-jelölési IP-tartomány. Nem fedheti át az alhálózati IP-tartományokat vagy a platformReservedCidrben definiált IP-tartományt, ha meg van adva.
platformReservedCidr	string	A CIDR-jelölés ip-tartománya, amely a környezeti infrastruktúra IP-címeinek fenntartotta. Nem lehet átfedésben más alhálózati IP-tartományokkal.
platformReservedDnsIP	string	A platformReservedCidr által meghatározott IP-cím, amely a belső DNS-kiszolgáló számára lesz fenntartva

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Description
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Tárgy

App Service-hibaválasz.

Name	Típus	Description
error	DefaultErrorResponseError	Hibamodell.

DefaultErrorResponseError

Tárgy

Hibamodell.

Name	Típus	Description
code	string	Szabványosított sztring a hiba programozott azonosításához.
details	DefaultErrorResponseErrorDetailsItem[]	Részletes hibák.
innererror	string	További információ a hiba hibakereséséről.
message	string	Részletes hibaleírás és hibakeresési információk.
target	string	Részletes hibaleírás és hibakeresési információk.

DefaultErrorResponseErrorDetailsItem

Tárgy

Részletes hibák.

Name	Típus	Description
code	string	Szabványosított sztring a hiba programozott azonosításához.
message	string	Részletes hibaleírás és hibakeresési információk.
target	string	Részletes hibaleírás és hibakeresési információk.

ExtendedLocation

Tárgy

Kiterjesztett hely.

Name	Típus	Description
name	string	A kiterjesztett hely neve.
type	string	A kiterjesztett hely típusa.

FrontEndConfiguration

Tárgy

Name	Típus	Description
kind	FrontEndServiceType

FrontEndServiceType

Felsorolás

Érték	Description
NodePort
LoadBalancer

KubeEnvironment

Tárgy

A Azure App Service webes számítási feladatokra specializálódott Kubernetes-fürt

Name	Típus	Description
extendedLocation	ExtendedLocation	Kiterjesztett hely.
id	string (arm-id)	Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Erőforrás típusa.
location	string	Az a földrajzi hely, ahol az erőforrás él
name	string	Az erőforrás neve
properties.aksResourceID	string
properties.appLogsConfiguration	AppLogsConfiguration	Fürtkonfiguráció, amely lehetővé teszi, hogy a naplódémon exportálja az alkalmazásnaplókat egy célhelyre. Jelenleg csak a "log-analytics" támogatott
properties.arcConfiguration	ArcConfiguration	Az ARC-fürt összetevőinek típusát meghatározó fürtkonfiguráció. Például: Választás a BuildService típus, a FrontEnd Service ArtifactsStorageType stb. között.
properties.containerAppsConfiguration	ContainerAppsConfiguration	A Container Apps-környezetek fürtkonfigurációja a Dapr Instrumentation Key és a VNET konfigurációjának konfigurálásához
properties.defaultDomain	string	A fürt alapértelmezett tartományneve
properties.deploymentErrors	string	Az üzembe helyezés vagy a telepítés ellenőrzése során bekövetkezett hibák
properties.environmentType	string	A Kubernetes-környezet típusa. Csak felügyelt értékekkel rendelkező Tárolóalkalmazás-környezetek esetén támogatott
properties.internalLoadBalancerEnabled	boolean	Csak a virtuális hálózaton/alhálózaton belül látható
properties.provisioningState	KubeEnvironmentProvisioningState	A Kubernetes-környezet kiépítési állapota.
properties.staticIp	string	A KubeEnvironment statikus IP-címe
systemData	systemData	A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
tags	object	Erőforráscímkék.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

KubeEnvironmentProvisioningState

Felsorolás

A Kubernetes-környezet kiépítési állapota.

Érték	Description
Succeeded
Failed
Canceled
Waiting
InitializationInProgress
InfrastructureSetupInProgress
InfrastructureSetupComplete
ScheduledForDelete
UpgradeRequested
UpgradeFailed

LogAnalyticsConfiguration

Tárgy

Name	Típus	Description
customerId	string
sharedKey	string (password)

StorageType

Felsorolás

Érték	Description
LocalNode
NetworkFileSystem

systemData

Tárgy

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.