App Service Environments - Update

Hizmet:: App Service

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

App Service Ortamı oluşturma veya güncelleme için açıklama.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
name	path	True	string	App Service Ortamı'ı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ü.

İstek Gövdesi

Name	Gerekli	Tür	Description
properties.virtualNetwork	True	VirtualNetworkProfile	Sanal Ağ'ün Tanımı.
kind		string	Kaynak türü.
properties.clusterSettings		NameValuePair[]	App Service Ortamı'ın davranışını değiştirmek için özel ayarlar.
properties.customDnsSuffixConfiguration		CustomDnsSuffixConfiguration	ASEv3 için özel etki alanı soneki yapılandırmasının tam görünümü.
properties.dedicatedHostCount		integer (int32)	Ayrılmış Konak Sayısı
properties.dnsSuffix		string	App Service Ortamı'ın DNS eki.
properties.frontEndScaleFactor		integer (int32)	Ön uçlar için ölçek faktörü.
properties.internalLoadBalancingMode		LoadBalancingMode	App Service Ortamı için Sanal Ağ'te dahili olarak hangi uç noktalara hizmet edileceğini belirtir.
properties.ipsslAddressCount		integer (int32)	App Service Ortamı için ayrılmış IP SSL adreslerinin sayısı.
properties.multiSize		string	Ön uç VM boyutu, örneğin "Orta", "Büyük".
properties.networkingConfiguration		AseV3NetworkingConfiguration	ASE için ağ yapılandırmasının tam görünümü.
properties.upgradePreference		UpgradePreference	Yükseltme Tercihi
properties.userWhitelistedIpRanges		string[]	Kullanıcı ASE db'de izin verilenler listesine ip aralıkları ekledi
properties.zoneRedundant		boolean	Bu App Service Ortamı'ın bölge-yedek olup olmadığı önemlidir.

Yanıtlar

Name	Tür	Description
200 OK	AppServiceEnvironmentResource	Azure işlemi başarıyla tamamlandı.
201 Created	AppServiceEnvironmentResource	Resource 'AppServiceEnvironmentResource' operasyon oluşturdu
202 Accepted	AppServiceEnvironmentResource	İstek işleme için kabul edildi, ancak işleme henüz tamamlanmadı.
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ın kimliğine bürünme

Örnekler

Create or update an App Service Environment.

Örnek isteği

HTTP

PATCH https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-rg/providers/Microsoft.Web/hostingEnvironments/test-ase?api-version=2026-03-15

{
  "properties": {
    "frontEndScaleFactor": 20,
    "virtualNetwork": {
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-rg/providers/Microsoft.Network/virtualNetworks/test-subnet/subnets/delegated"
    }
  }
}

Örnek yanıt

Durum kodu:: 200

{
  "name": "test-ase",
  "type": "Microsoft.Web/hostingEnvironments",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-rg/providers/Microsoft.Web/hostingEnvironments/test-ase",
  "kind": "ASEV3",
  "location": "South Central US",
  "properties": {
    "clusterSettings": null,
    "dedicatedHostCount": 0,
    "dnsSuffix": "test-ase.p.azurewebsites.net",
    "frontEndScaleFactor": 15,
    "hasLinuxWorkers": true,
    "internalLoadBalancingMode": "None",
    "ipsslAddressCount": 0,
    "maximumNumberOfMachines": 250,
    "multiRoleCount": null,
    "multiSize": "Standard_D2d_v4",
    "networkingConfiguration": {
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-rg/providers/Microsoft.Web/hostingEnvironments/test-ase/configurations/networking",
      "properties": {
        "allowNewPrivateEndpointConnections": false,
        "externalInboundIpAddresses": [
          "52.153.248.36"
        ],
        "ftpEnabled": false,
        "inboundIpAddressOverride": null,
        "internalInboundIpAddresses": [],
        "linuxOutboundIpAddresses": [
          "20.88.241.56",
          "20.88.241.9"
        ],
        "remoteDebugEnabled": false,
        "windowsOutboundIpAddresses": [
          "20.88.241.56",
          "20.88.241.9"
        ]
      }
    },
    "provisioningState": "Succeeded",
    "status": "Ready",
    "suspended": false,
    "userWhitelistedIpRanges": null,
    "virtualNetwork": {
      "name": "delegated",
      "type": "Microsoft.Network/virtualNetworks/subnets",
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-rg/providers/Microsoft.Network/virtualNetworks/test-subnet/subnets/delegated",
      "subnet": ""
    },
    "zoneRedundant": false
  },
  "tags": {}
}

Durum kodu:: 201

{
  "name": "test-ase",
  "type": "Microsoft.Web/hostingEnvironments",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-rg/providers/Microsoft.Web/hostingEnvironments/test-ase",
  "kind": "ASEV3",
  "location": "South Central US",
  "properties": {
    "clusterSettings": null,
    "dedicatedHostCount": 0,
    "dnsSuffix": "test-ase.p.azurewebsites.net",
    "frontEndScaleFactor": 15,
    "hasLinuxWorkers": true,
    "internalLoadBalancingMode": "None",
    "ipsslAddressCount": 0,
    "maximumNumberOfMachines": 250,
    "multiRoleCount": null,
    "multiSize": "Standard_D2d_v4",
    "networkingConfiguration": {
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-rg/providers/Microsoft.Web/hostingEnvironments/test-ase/configurations/networking",
      "properties": {
        "allowNewPrivateEndpointConnections": false,
        "externalInboundIpAddresses": [
          "52.153.248.36"
        ],
        "ftpEnabled": false,
        "inboundIpAddressOverride": null,
        "internalInboundIpAddresses": [],
        "linuxOutboundIpAddresses": [
          "20.88.241.56",
          "20.88.241.9"
        ],
        "remoteDebugEnabled": false,
        "windowsOutboundIpAddresses": [
          "20.88.241.56",
          "20.88.241.9"
        ]
      }
    },
    "provisioningState": "Succeeded",
    "status": "Ready",
    "suspended": false,
    "userWhitelistedIpRanges": null,
    "virtualNetwork": {
      "name": "delegated",
      "type": "Microsoft.Network/virtualNetworks/subnets",
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-rg/providers/Microsoft.Network/virtualNetworks/test-subnet/subnets/delegated",
      "subnet": ""
    },
    "zoneRedundant": false
  },
  "tags": {}
}

Durum kodu:: 202

{
  "name": "test-ase",
  "type": "Microsoft.Web/hostingEnvironments",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-rg/providers/Microsoft.Web/hostingEnvironments/test-ase",
  "kind": "ASEV3",
  "location": "South Central US",
  "properties": {
    "clusterSettings": null,
    "dedicatedHostCount": 0,
    "dnsSuffix": "test-ase.p.azurewebsites.net",
    "frontEndScaleFactor": 15,
    "hasLinuxWorkers": true,
    "internalLoadBalancingMode": "None",
    "ipsslAddressCount": 0,
    "maximumNumberOfMachines": 250,
    "multiRoleCount": null,
    "multiSize": "Standard_D2d_v4",
    "networkingConfiguration": {
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-rg/providers/Microsoft.Web/hostingEnvironments/test-ase/configurations/networking",
      "properties": {
        "allowNewPrivateEndpointConnections": false,
        "externalInboundIpAddresses": [
          "52.153.248.36"
        ],
        "ftpEnabled": false,
        "inboundIpAddressOverride": null,
        "internalInboundIpAddresses": [],
        "linuxOutboundIpAddresses": [
          "20.88.241.56",
          "20.88.241.9"
        ],
        "remoteDebugEnabled": false,
        "windowsOutboundIpAddresses": [
          "20.88.241.56",
          "20.88.241.9"
        ]
      }
    },
    "provisioningState": "Succeeded",
    "status": "Ready",
    "suspended": false,
    "userWhitelistedIpRanges": null,
    "virtualNetwork": {
      "name": "delegated",
      "type": "Microsoft.Network/virtualNetworks/subnets",
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-rg/providers/Microsoft.Network/virtualNetworks/test-subnet/subnets/delegated",
      "subnet": ""
    },
    "zoneRedundant": false
  },
  "tags": {}
}

Tanımlar

Name	Description
AppServiceEnvironmentPatchResource	App Service ortamı için ARM kaynağı.
AppServiceEnvironmentResource	App Service Ortamı ARM kaynağı.
AseV3NetworkingConfiguration	ASE için ağ yapılandırmasının tam görünümü.
createdByType	Kaynağı oluşturan kimliğin türü.
CustomDnsSuffixConfiguration	ASEv3 için özel etki alanı soneki yapılandırmasının tam görünümü.
CustomDnsSuffixProvisioningState
DefaultErrorResponse	App Service hata yanıtı.
DefaultErrorResponseError	Hata modeli.
DefaultErrorResponseErrorDetailsItem	Ayrıntılı hatalar.
HostingEnvironmentStatus	App Service Ortamı'ın güncel durumu.
LoadBalancingMode	App Service Ortamı için Sanal Ağ'te dahili olarak hangi uç noktalara hizmet edileceğini belirtir.
NameValuePair	İsim değer çifti.
ProvisioningState	App Service Planının sağlama durumu.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
UpgradeAvailability	Bu App Service Ortamı için bir yükseltmenin mevcut olup olmadığı.
UpgradePreference	Yükseltme Tercihi
VirtualNetworkProfile	Sanal Ağ kullanımı için spesifikasyon.

AppServiceEnvironmentPatchResource

Nesne

App Service ortamı için ARM kaynağı.

Name	Tür	Default value	Description
id	string		Kaynak Kimliği.
kind	string		Kaynak türü.
name	string		Kaynak Adı.
properties.clusterSettings	NameValuePair[]		App Service Ortamı'ın davranışını değiştirmek için özel ayarlar.
properties.customDnsSuffixConfiguration	CustomDnsSuffixConfiguration		ASEv3 için özel etki alanı soneki yapılandırmasının tam görünümü.
properties.dedicatedHostCount	integer (int32)		Ayrılmış Konak Sayısı
properties.dnsSuffix	string		App Service Ortamı'ın DNS eki.
properties.frontEndScaleFactor	integer (int32)		Ön uçlar için ölçek faktörü.
properties.hasLinuxWorkers	boolean		ASE'de Linux çalışanı olup olmadığını gösteren bayrak
properties.internalLoadBalancingMode	LoadBalancingMode		App Service Ortamı için Sanal Ağ'te dahili olarak hangi uç noktalara hizmet edileceğini belirtir.
properties.ipsslAddressCount	integer (int32)		App Service Ortamı için ayrılmış IP SSL adreslerinin sayısı.
properties.maximumNumberOfMachines	integer (int32)		App Service Ortamı'te maksimum VM sayısı.
properties.multiRoleCount	integer (int32)		Ön uç örneklerinin sayısı.
properties.multiSize	string		Ön uç VM boyutu, örneğin "Orta", "Büyük".
properties.networkingConfiguration	AseV3NetworkingConfiguration		ASE için ağ yapılandırmasının tam görünümü.
properties.provisioningState	ProvisioningState		App Service Ortamı'ın provisioning state'i.
properties.status	HostingEnvironmentStatus		App Service Ortamı'ın güncel durumu.
properties.suspended	boolean		`true` App Service Ortamı askıya alınmışsa; aksi takdirde `false`. Ortam, örneğin yönetim uç noktası artık kullanılamadığında (büyük olasılıkla NSG gelen trafiği engellediği için) askıya alınabilir.
properties.upgradeAvailability	UpgradeAvailability		Bu App Service Ortamı için bir yükseltmenin mevcut olup olmadığı.
properties.upgradePreference	UpgradePreference	None	Yükseltme Tercihi
properties.userWhitelistedIpRanges	string[]		Kullanıcı ASE db'de izin verilenler listesine ip aralıkları ekledi
properties.virtualNetwork	VirtualNetworkProfile		Sanal Ağ'ün Tanımı.
properties.zoneRedundant	boolean		Bu App Service Ortamı'ın bölge-yedek olup olmadığı önemlidir.
type	string		Kaynak türü.

AppServiceEnvironmentResource

Nesne

App Service Ortamı ARM kaynağı.

Name	Tür	Default value	Description
id	string (arm-id)		Kaynağın tam kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string		Kaynak türü. Kaynak bir uygulamaysa, tür için desteklenen değerler için detaylar için https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference adresine başvurabilirsiniz.
location	string		Kaynağın bulunduğu coğrafi konum
name	string		Kaynağın adı
properties.clusterSettings	NameValuePair[]		App Service Ortamı'ın davranışını değiştirmek için özel ayarlar.
properties.customDnsSuffixConfiguration	CustomDnsSuffixConfiguration		ASEv3 için özel etki alanı soneki yapılandırmasının tam görünümü.
properties.dedicatedHostCount	integer (int32)		Ayrılmış Konak Sayısı
properties.dnsSuffix	string		App Service Ortamı'ın DNS eki.
properties.frontEndScaleFactor	integer (int32)		Ön uçlar için ölçek faktörü.
properties.hasLinuxWorkers	boolean		ASE'de Linux çalışanı olup olmadığını gösteren bayrak
properties.internalLoadBalancingMode	LoadBalancingMode		App Service Ortamı için Sanal Ağ'te dahili olarak hangi uç noktalara hizmet edileceğini belirtir.
properties.ipsslAddressCount	integer (int32)		App Service Ortamı için ayrılmış IP SSL adreslerinin sayısı.
properties.maximumNumberOfMachines	integer (int32)		App Service Ortamı'te maksimum VM sayısı.
properties.multiRoleCount	integer (int32)		Ön uç örneklerinin sayısı.
properties.multiSize	string		Ön uç VM boyutu, örneğin "Orta", "Büyük".
properties.networkingConfiguration	AseV3NetworkingConfiguration		ASE için ağ yapılandırmasının tam görünümü.
properties.provisioningState	ProvisioningState		App Service Ortamı'ın provisioning state'i.
properties.status	HostingEnvironmentStatus		App Service Ortamı'ın güncel durumu.
properties.suspended	boolean		`true` App Service Ortamı askıya alınmışsa; aksi takdirde `false`. Ortam, örneğin yönetim uç noktası artık kullanılamadığında (büyük olasılıkla NSG gelen trafiği engellediği için) askıya alınabilir.
properties.upgradeAvailability	UpgradeAvailability		Bu App Service Ortamı için bir yükseltmenin mevcut olup olmadığı.
properties.upgradePreference	UpgradePreference	None	Yükseltme Tercihi
properties.userWhitelistedIpRanges	string[]		Kullanıcı ASE db'de izin verilenler listesine ip aralıkları ekledi
properties.virtualNetwork	VirtualNetworkProfile		Sanal Ağ'ün Tanımı.
properties.zoneRedundant	boolean		Bu App Service Ortamı'ın bölge-yedek olup olmadığı önemlidir.
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"

AseV3NetworkingConfiguration

Nesne

ASE için ağ yapılandırmasının tam görünümü.

Name	Tür	Description
id	string (arm-id)	Kaynağın tam kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Kaynak türü.
name	string	Kaynağın adı
properties.allowNewPrivateEndpointConnections	boolean	ASE'de yeni özel uç nokta bağlantı oluşturma özelliğini etkinleştirme ve devre dışı bırakma özelliği
properties.externalInboundIpAddresses	string[]
properties.ftpEnabled	boolean	ASEV3'te FTP'yi etkinleştirme ve devre dışı bırakma özelliği
properties.inboundIpAddressOverride	string	Müşteri Gelen IP Adresi sağladı. Yalnızca Ase oluşturmada ayarlanabilir.
properties.internalInboundIpAddresses	string[]
properties.linuxOutboundIpAddresses	string[]
properties.remoteDebugEnabled	boolean	ASEV3'te Uzaktan Hata Ayıklamayı etkinleştirme ve devre dışı bırakma özelliği
properties.windowsOutboundIpAddresses	string[]
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

createdByType

Numaralandırma

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

Değer	Description
User
Application
ManagedIdentity
Key

CustomDnsSuffixConfiguration

Nesne

ASEv3 için özel etki alanı soneki yapılandırmasının tam görünümü.

Name	Tür	Description
id	string (arm-id)	Kaynağın tam kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Kaynak türü.
name	string	Kaynağın adı
properties.certificateUrl	string	URL, özel alan adı ekine sahip siteler için varsayılan SSL/TLS sertifikası olarak kullanılması gereken Azure Key Vault sertifika gizliliğine atıfta bulunur.
properties.dnsSuffix	string	ASE'de dağıtılan tüm siteler için kullanılacak varsayılan özel etki alanı soneki.
properties.keyVaultReferenceIdentity	string	Anahtar kasası sertifika başvurularını çözümlemek için kullanılacak kullanıcı tarafından atanan kimlik. Belirtilmezse, varsa sistem tarafından atanan ASE kimliği kullanılır.
properties.provisioningDetails	string
properties.provisioningState	CustomDnsSuffixProvisioningState
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

CustomDnsSuffixProvisioningState

Numaralandırma

Değer	Description
Succeeded
Failed
Degraded
InProgress

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.

HostingEnvironmentStatus

Numaralandırma

App Service Ortamı'ın güncel durumu.

Değer	Description
Preparing
Ready
Scaling
Deleting

LoadBalancingMode

Numaralandırma

App Service Ortamı için Sanal Ağ'te dahili olarak hangi uç noktalara hizmet edileceğini belirtir.

Değer	Description
None
Web
Publishing
Web, Publishing

NameValuePair

Nesne

İsim değer çifti.

Name	Tür	Description
name	string	Çift adı.
value	string	Değeri eşleştirin.

ProvisioningState

Numaralandırma

App Service Planının sağlama durumu.

Değer	Description
Succeeded
Failed
Canceled
InProgress
Deleting

systemData

Nesne

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

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
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ü.

UpgradeAvailability

Numaralandırma

Bu App Service Ortamı için bir yükseltmenin mevcut olup olmadığı.

Değer	Description
None	Şu anda bu App Service Ortamı için herhangi bir yükseltme mevcut değildir
Ready	Bu App Service Ortamı'te manuel olarak bir yükseltme başlatılmaya hazır

UpgradePreference

Numaralandırma

Yükseltme Tercihi

Değer	Description
None	Bu App Service Ortamı'ın ne zaman güncelleneceğine dair bir tercih yok
Early	Bu App Service Ortamı, aynı bölgede 'Geç' Yükseltme Tercihi olan diğerlerinden önce güncellenecektir
Late	Bu App Service Ortamı, aynı bölgedeki Yükseltme Tercihi 'Erken' olanlardan sonra güncellenecektir
Manual	Yalnızca ASEv3. Yükseltme sağlandığında, bu App Service Ortamı yükseltmenin manuel başlatılması için 10 gün bekler. 10 gün sonra yükseltme otomatik olarak başlayacaktır

VirtualNetworkProfile

Nesne

Sanal Ağ kullanımı için spesifikasyon.

Name	Tür	Description
id	string	Sanal Ağ'in kaynak kimliği.
name	string	Sanal Ağ'ün adı (sadece okunabilir).
subnet	string	Sanal Ağ içindeki alt net.
type	string	Sanal Ağ'ün kaynak türü (sadece okunabilir).