Kube Environments - Get

Hizmet:: App Service

API Sürümü:: 2026-07-15

Kubernetes Ortamının özelliklerini alma açıklaması.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/kubeEnvironments/{name}?api-version=2026-07-15

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
name	path	True	string	Kubernetes Ortamının adı.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	KubeEnvironment	Azure işlemi başarıyla tamamlandı.
Other Status Codes	DefaultErrorResponse	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızı taklit etme

Örnekler

Get kube environments by name

Örnek isteği

HTTP

GET https://management.azure.com/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.Web/kubeEnvironments/jlaw-demo1?api-version=2026-07-15

Örnek yanıt

Durum kodu:: 200

{
  "name": "jlaw-demo1",
  "type": "Microsoft.Web/kubeEnvironments",
  "extendedLocation": {
    "name": "/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.ExtendedLocation/customLocations/testcustomlocation",
    "type": "customLocation"
  },
  "id": "/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.Web/kubeEnvironments/jlaw-demo1",
  "location": "North Central US",
  "properties": {
    "aksResourceID": "/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.ContainerService/managedClusters/jlaw-demo1",
    "appLogsConfiguration": null,
    "arcConfiguration": null,
    "defaultDomain": "jlaw-demo1.k4apps.io",
    "deploymentErrors": null,
    "internalLoadBalancerEnabled": false,
    "provisioningState": "Succeeded",
    "staticIp": "20.42.33.145"
  },
  "tags": {}
}

Tanımlar

Name	Description
AppLogsConfiguration
ArcConfiguration
ContainerAppsConfiguration
createdByType	Kaynağı oluşturan kimliğin türü.
DefaultErrorResponse	App Service hata yanıtı.
DefaultErrorResponseError	Hata modeli.
DefaultErrorResponseErrorDetailsItem	Ayrıntılı hatalar.
ExtendedLocation	Genişletilmiş Konum.
FrontEndConfiguration
FrontEndServiceType
KubeEnvironment	A Kubernetes cluster specialized for web workloads by Azure App Service
KubeEnvironmentProvisioningState	Kubernetes Ortamının sağlama durumu.
LogAnalyticsConfiguration
StorageType
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

AppLogsConfiguration

Nesne

Name	Tür	Description
destination	string
logAnalyticsConfiguration	LogAnalyticsConfiguration

ArcConfiguration

Nesne

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

ContainerAppsConfiguration

Nesne

Name	Tür	Description
appSubnetResourceId	string	Denetim düzlemi altyapı bileşenleri için bir alt ağın kaynak kimliği. Bu alt ağ, appSubnetResourceId içinde tanımlanan alt ağ ile aynı sanal ağda olmalıdır. Tanımlanmışsa platformReservedCidr içinde tanımlanan IP aralığıyla çakışmamalıdır.
controlPlaneSubnetResourceId	string	Denetim düzlemi altyapı bileşenleri için bir alt ağın kaynak kimliği. Bu alt ağ, appSubnetResourceId içinde tanımlanan alt ağ ile aynı sanal ağda olmalıdır. Tanımlanmışsa platformReservedCidr içinde tanımlanan IP aralığıyla çakışmamalıdır.
daprAIInstrumentationKey	string	Hizmet'i Hizmete aktarma iletişim telemetrisini dışarı aktarmak için Dapr tarafından kullanılan Azure İzleyici izleme anahtarı
dockerBridgeCidr	string	Docker köprüsü ağına atanan CIDR gösterimi IP aralığı. Tanımlanmışsa, herhangi bir Alt Ağ IP aralığıyla veya platformReservedCidr'de tanımlanan IP aralığıyla çakışmamalıdır.
platformReservedCidr	string	CIDR gösteriminde ortam altyapısı IP adresleri için ayrılabilen IP aralığı. Diğer Alt Ağ IP aralıklarıyla çakışmamalıdır.
platformReservedDnsIP	string	platformReservedCidr tarafından tanımlanan IP aralığından iç DNS sunucusu için ayrılacak bir IP adresi

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Nesne

App Service hata yanıtı.

Name	Tür	Description
error	DefaultErrorResponseError	Hata modeli.

DefaultErrorResponseError

Nesne

Hata modeli.

Name	Tür	Description
code	string	Hatayı program aracılığıyla tanımlamak için standartlaştırılmış dize.
details	DefaultErrorResponseErrorDetailsItem[]	Ayrıntılı hatalar.
innererror	string	Hata ayıklamak için daha fazla bilgi.
message	string	Ayrıntılı hata açıklaması ve hata ayıklama bilgileri.
target	string	Ayrıntılı hata açıklaması ve hata ayıklama bilgileri.

DefaultErrorResponseErrorDetailsItem

Nesne

Ayrıntılı hatalar.

Name	Tür	Description
code	string	Hatayı program aracılığıyla tanımlamak için standartlaştırılmış dize.
message	string	Ayrıntılı hata açıklaması ve hata ayıklama bilgileri.
target	string	Ayrıntılı hata açıklaması ve hata ayıklama bilgileri.

ExtendedLocation

Nesne

Genişletilmiş Konum.

Name	Tür	Description
name	string	Genişletilmiş konumun adı.
type	string	Genişletilmiş konum türü.

FrontEndConfiguration

Nesne

Name	Tür	Description
kind	FrontEndServiceType

FrontEndServiceType

Numaralandırma

Değer	Description
NodePort
LoadBalancer

KubeEnvironment

Nesne

A Kubernetes cluster specialized for web workloads by Azure App Service

Name	Tür	Description
extendedLocation	ExtendedLocation	Genişletilmiş Konum.
id	string (arm-id)	Kaynağın tam nitelikli kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Kaynak türü.
location	string	Kaynağın bulunduğu coğrafi konum
name	string	Kaynağın adı
properties.aksResourceID	string
properties.appLogsConfiguration	AppLogsConfiguration	Günlük arka plan programının uygulama günlüklerini bir hedefe aktarmasını sağlayan küme yapılandırması. Şu anda yalnızca "log-analytics" desteklenmektedir
properties.arcConfiguration	ArcConfiguration	ARC küme bileşenleri türlerini belirleyen küme yapılandırması. Örneğin: BuildService türü, FrontEnd Service ArtifactsStorageType vb. arasında seçim yapmak.
properties.containerAppsConfiguration	ContainerAppsConfiguration	Dapr Instrumentation Key ve VNET Yapılandırmasını yapılandırmak için Container Apps Ortamları için küme yapılandırması
properties.defaultDomain	string	Küme için Varsayılan Etki Alanı Adı
properties.deploymentErrors	string	Dağıtım veya dağıtım doğrulaması sırasında oluşan hatalar
properties.environmentType	string	Kubernetes Ortamı türü. Yalnızca Yönetilen değeri olan Kapsayıcı Uygulama Ortamları için desteklenir
properties.internalLoadBalancerEnabled	boolean	Yalnızca sanal ağ/alt ağ içinde görünür
properties.provisioningState	KubeEnvironmentProvisioningState	Kubernetes Ortamının sağlama durumu.
properties.staticIp	string	KubeEnvironment'ın statik IP'si
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
tags	object	Kaynak etiketleri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

KubeEnvironmentProvisioningState

Numaralandırma

Kubernetes Ortamının sağlama durumu.

Değer	Description
Succeeded
Failed
Canceled
Waiting
InitializationInProgress
InfrastructureSetupInProgress
InfrastructureSetupComplete
ScheduledForDelete
UpgradeRequested
UpgradeFailed

LogAnalyticsConfiguration

Nesne

Name	Tür	Description
customerId	string
sharedKey	string (password)

StorageType

Numaralandırma

Değer	Description
LocalNode
NetworkFileSystem

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturmanın zaman damgası (UTC).
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.