Kube Environments - Get

サービス:: App Service

API バージョン:: 2026-07-15

Kubernetes 環境のプロパティの取得の説明。

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

URI パラメーター

名前	/	必須	型	説明
name	path	True	string	Kubernetes 環境の名前。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前は大文字と小文字を区別しません。
subscriptionId	path	True	string (uuid)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

応答

名前	型	説明
200 OK	KubeEnvironment	Azureの運用は無事に完了しました。
Other Status Codes	DefaultErrorResponse	予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	あなたのユーザーアカウントになりすます

例

Get kube environments by name

要求のサンプル

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

応答のサンプル

状態コード:: 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": {}
}

定義

名前	説明
AppLogsConfiguration
ArcConfiguration
ContainerAppsConfiguration
createdByType	リソースを作成した ID の種類。
DefaultErrorResponse	App Service エラー応答。
DefaultErrorResponseError	エラーモデル。
DefaultErrorResponseErrorDetailsItem	詳細なエラー。
ExtendedLocation	拡張された場所。
FrontEndConfiguration
FrontEndServiceType
KubeEnvironment	A Kubernetes cluster specialized for web workload by Azure App Service
KubeEnvironmentProvisioningState	Kubernetes 環境のプロビジョニング状態。
LogAnalyticsConfiguration
StorageType
systemData	リソースの作成と最後の変更に関連するメタデータ。

AppLogsConfiguration

Object

名前	型	説明
destination	string
logAnalyticsConfiguration	LogAnalyticsConfiguration

ArcConfiguration

Object

名前	型	説明
artifactStorageAccessMode	string
artifactStorageClassName	string
artifactStorageMountPath	string
artifactStorageNodeName	string
artifactsStorageType	StorageType
frontEndServiceConfiguration	FrontEndConfiguration
kubeConfig	string (password)

ContainerAppsConfiguration

Object

名前	型	説明
appSubnetResourceId	string	コントロールプレーンインフラストラクチャコンポーネントのサブネットのリソース ID。このサブネットは、appSubnetResourceId で定義されているサブネットと同じ VNET 内にある必要があります。 platformReservedCidr で定義されている IP 範囲 (定義されている場合) と重複してはなりません。
controlPlaneSubnetResourceId	string	コントロールプレーンインフラストラクチャコンポーネントのサブネットのリソース ID。このサブネットは、appSubnetResourceId で定義されているサブネットと同じ VNET 内にある必要があります。 platformReservedCidr で定義されている IP 範囲 (定義されている場合) と重複してはなりません。
daprAIInstrumentationKey	string	サービス間通信テレメトリをエクスポートするために Dapr によって使用される Azure Monitor インストルメンテーションキー
dockerBridgeCidr	string	Docker ブリッジネットワークに割り当てられた CIDR 表記 IP 範囲。定義されている場合、サブネットの IP 範囲または platformReservedCidr で定義されている IP 範囲と重複してはなりません。
platformReservedCidr	string	環境インフラストラクチャの IP アドレス用に予約できる CIDR 表記の IP 範囲。他のサブネット IP 範囲と重複してはなりません。
platformReservedDnsIP	string	内部 DNS サーバー用に予約される platformReservedCidr によって定義された IP 範囲の IP アドレス

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Object

App Service エラー応答。

名前	型	説明
error	DefaultErrorResponseError	エラーモデル。

DefaultErrorResponseError

Object

エラーモデル。

名前	型	説明
code	string	プログラムでエラーを識別するための標準化された文字列。
details	DefaultErrorResponseErrorDetailsItem[]	詳細なエラー。
innererror	string	エラーのデバッグに関する詳細情報。
message	string	詳細なエラーの説明とデバッグ情報。
target	string	詳細なエラーの説明とデバッグ情報。

DefaultErrorResponseErrorDetailsItem

Object

詳細なエラー。

名前	型	説明
code	string	プログラムでエラーを識別するための標準化された文字列。
message	string	詳細なエラーの説明とデバッグ情報。
target	string	詳細なエラーの説明とデバッグ情報。

ExtendedLocation

Object

拡張された場所。

名前	型	説明
name	string	拡張された場所の名前。
type	string	拡張ロケーションのタイプ。

FrontEndConfiguration

Object

名前	型	説明
kind	FrontEndServiceType

FrontEndServiceType

列挙

値	説明
NodePort
LoadBalancer

KubeEnvironment

Object

A Kubernetes cluster specialized for web workload by Azure App Service

名前	型	説明
extendedLocation	ExtendedLocation	拡張された場所。
id	string (arm-id)	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	リソースの種類。
location	string	リソースが存在する地理的な場所
name	string	リソースの名前
properties.aksResourceID	string
properties.appLogsConfiguration	AppLogsConfiguration	ログデーモンがアプリログを宛先にエクスポートできるようにするクラスター構成。現在、"log-analytics" のみがサポートされています
properties.arcConfiguration	ArcConfiguration	ARC クラスターコンポーネントタイプを決定するクラスター構成。例:BuildServiceの種類、フロントエンドサービスアーティファクトStorageTypeなどから選択します。
properties.containerAppsConfiguration	ContainerAppsConfiguration	Dapr インストルメンテーションキーと VNET 構成を構成するための Container Apps 環境のクラスター構成
properties.defaultDomain	string	クラスタのデフォルトドメイン名
properties.deploymentErrors	string	デプロイメントまたはデプロイメントの検証中に発生したエラー
properties.environmentType	string	Kubernetes 環境の種類。値がマネージドである Container App Environment でのみサポートされます
properties.internalLoadBalancerEnabled	boolean	Vnet/Subnet 内でのみ表示される
properties.provisioningState	KubeEnvironmentProvisioningState	Kubernetes 環境のプロビジョニング状態。
properties.staticIp	string	KubeEnvironment の静的 IP
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
tags	object	リソースタグ。
type	string	リソースの種類。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

KubeEnvironmentProvisioningState

列挙

Kubernetes 環境のプロビジョニング状態。

値	説明
Succeeded
Failed
Canceled
Waiting
InitializationInProgress
InfrastructureSetupInProgress
InfrastructureSetupComplete
ScheduledForDelete
UpgradeRequested
UpgradeFailed

LogAnalyticsConfiguration

Object

名前	型	説明
customerId	string
sharedKey	string (password)

StorageType

列挙

値	説明
LocalNode
NetworkFileSystem

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。