Kube Environments - Get

Serviço:: App Service

Versão da API:: 2026-07-15

Descrição para Obter as propriedades de um ambiente Kubernetes.

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

Parâmetros do URI

Name	Em	Obrigatório	Tipo	Descrição
name	path	True	string	Nome do ambiente Kubernetes.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não distingue maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	O ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Respostas

Name	Tipo	Descrição
200 OK	KubeEnvironment	Operação do Azure concluída com sucesso.
Other Status Codes	DefaultErrorResponse	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Descrição
user_impersonation	assumir a identidade da sua conta de utilizador

Exemplos

Get kube environments by name

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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": {}
}

Definições

Name	Descrição
AppLogsConfiguration
ArcConfiguration
ContainerAppsConfiguration
createdByType	O tipo de identidade que criou o recurso.
DefaultErrorResponse	Resposta de erro do Serviço de Aplicativo.
DefaultErrorResponseError	Modelo de erro.
DefaultErrorResponseErrorDetailsItem	Erros detalhados.
ExtendedLocation	Localização estendida.
FrontEndConfiguration
FrontEndServiceType
KubeEnvironment	Um cluster Kubernetes especializado para workloads web por Serviço de Aplicações do Azure
KubeEnvironmentProvisioningState	Estado de provisionamento do ambiente Kubernetes.
LogAnalyticsConfiguration
StorageType
systemData	Metadados referentes à criação e última modificação do recurso.

AppLogsConfiguration

Object

Name	Tipo	Descrição
destination	string
logAnalyticsConfiguration	LogAnalyticsConfiguration

ArcConfiguration

Object

Name	Tipo	Descrição
artifactStorageAccessMode	string
artifactStorageClassName	string
artifactStorageMountPath	string
artifactStorageNodeName	string
artifactsStorageType	StorageType
frontEndServiceConfiguration	FrontEndConfiguration
kubeConfig	string (password)

ContainerAppsConfiguration

Object

Name	Tipo	Descrição
appSubnetResourceId	string	ID de recurso de uma sub-rede para componentes de infraestrutura do plano de controle. Essa sub-rede deve estar na mesma VNET que a sub-rede definida em appSubnetResourceId. Não deve sobrepor-se ao intervalo de IP definido em platformReservedCidr, se definido.
controlPlaneSubnetResourceId	string	ID de recurso de uma sub-rede para componentes de infraestrutura do plano de controle. Essa sub-rede deve estar na mesma VNET que a sub-rede definida em appSubnetResourceId. Não deve sobrepor-se ao intervalo de IP definido em platformReservedCidr, se definido.
daprAIInstrumentationKey	string	Chave de instrumentação do Azure Monitor usada pelo Dapr para exportar telemetria de comunicação de Serviço a Serviço
dockerBridgeCidr	string	Intervalo de IP de notação CIDR atribuído à rede de ponte do Docker. Ele não deve se sobrepor a nenhum intervalo de IP de sub-rede ou ao intervalo de IP definido em platformReservedCidr, se definido.
platformReservedCidr	string	Intervalo de IP na notação CIDR que pode ser reservado para endereços IP de infraestrutura de ambiente. Ele não deve se sobrepor a nenhum outro intervalo IP de sub-rede.
platformReservedDnsIP	string	Um endereço IP do intervalo de IP definido por platformReservedCidr que será reservado para o servidor DNS interno

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Descrição
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Object

Resposta de erro do Serviço de Aplicativo.

Name	Tipo	Descrição
error	DefaultErrorResponseError	Modelo de erro.

DefaultErrorResponseError

Object

Modelo de erro.

Name	Tipo	Descrição
code	string	String padronizada para identificar programaticamente o erro.
details	DefaultErrorResponseErrorDetailsItem[]	Erros detalhados.
innererror	string	Mais informações para depurar erro.
message	string	Descrição detalhada do erro e informações de depuração.
target	string	Descrição detalhada do erro e informações de depuração.

DefaultErrorResponseErrorDetailsItem

Object

Erros detalhados.

Name	Tipo	Descrição
code	string	String padronizada para identificar programaticamente o erro.
message	string	Descrição detalhada do erro e informações de depuração.
target	string	Descrição detalhada do erro e informações de depuração.

ExtendedLocation

Object

Localização estendida.

Name	Tipo	Descrição
name	string	Nome do local estendido.
type	string	Tipo de local estendido.

FrontEndConfiguration

Object

Name	Tipo	Descrição
kind	FrontEndServiceType

FrontEndServiceType

Enumeração

Valor	Descrição
NodePort
LoadBalancer

KubeEnvironment

Object

Um cluster Kubernetes especializado para workloads web por Serviço de Aplicações do Azure

Name	Tipo	Descrição
extendedLocation	ExtendedLocation	Localização estendida.
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Tipo de recurso.
location	string	A geolocalização onde o recurso vive
name	string	O nome do recurso
properties.aksResourceID	string
properties.appLogsConfiguration	AppLogsConfiguration	Configuração de cluster que permite que o daemon de log exporte logs de aplicativos para um destino. Atualmente, apenas "log-analytics" é suportado
properties.arcConfiguration	ArcConfiguration	Configuração de cluster que determina os tipos de componentes de cluster ARC. Por exemplo: Escolhendo entre o tipo BuildService, FrontEnd Service ArtifactsStorageType etc.
properties.containerAppsConfiguration	ContainerAppsConfiguration	Configuração de cluster para ambientes de aplicativos de contêiner para configurar a chave de instrumentação Dapr e a configuração de VNET
properties.defaultDomain	string	Nome de domínio padrão para o cluster
properties.deploymentErrors	string	Quaisquer erros que ocorreram durante a implantação ou validação da implantação
properties.environmentType	string	Tipo de ambiente Kubernetes. Suportado apenas para Ambientes de Aplicativos de Contêiner com valor como Gerenciado
properties.internalLoadBalancerEnabled	boolean	Visível apenas em Vnet/Subnet
properties.provisioningState	KubeEnvironmentProvisioningState	Estado de provisionamento do ambiente Kubernetes.
properties.staticIp	string	IP estático do KubeEnvironment
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

KubeEnvironmentProvisioningState

Enumeração

Estado de provisionamento do ambiente Kubernetes.

Valor	Descrição
Succeeded
Failed
Canceled
Waiting
InitializationInProgress
InfrastructureSetupInProgress
InfrastructureSetupComplete
ScheduledForDelete
UpgradeRequested
UpgradeFailed

LogAnalyticsConfiguration

Object

Name	Tipo	Descrição
customerId	string
sharedKey	string (password)

StorageType

Enumeração

Valor	Descrição
LocalNode
NetworkFileSystem

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Descrição
createdAt	string (date-time)	A marca temporal da criação do recurso (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	A data e hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.