Aracılığıyla paylaş


Cloud Services - Update

Bulut hizmetini güncelleştirme.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/cloudServices/{cloudServiceName}?api-version=2022-09-04

URI Parametreleri

Name İçinde Gerekli Tür Description
cloudServiceName
path True

string

Bulut hizmetinin adı.

resourceGroupName
path True

string

Kaynak grubunun adı.

subscriptionId
path True

string

Microsoft Azure aboneliğini benzersiz olarak tanımlayan abonelik kimlik bilgileri. Abonelik kimliği, her hizmet çağrısı için URI'nin bir parçasını oluşturur.

api-version
query True

string

İstemci Api Sürümü.

İstek Gövdesi

Name Tür Description
tags

object

Kaynak etiketleri

Yanıtlar

Name Tür Description
200 OK

CloudService

Tamam

Other Status Codes

CloudError

Hata

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow

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

Update existing Cloud Service to add tags

Örnek isteği

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Compute/cloudServices/{cs-name}?api-version=2022-09-04

{
  "tags": {
    "Documentation": "RestAPI"
  }
}

Örnek yanıt

{
  "name": "{cs-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Compute/cloudServices/{cs-name}",
  "type": "Microsoft.Compute/cloudServices",
  "location": "eastus2euap",
  "tags": {
    "Documentation": "RestAPI"
  },
  "properties": {
    "configuration": "{ServiceConfiguration}",
    "upgradeMode": "Auto",
    "roleProfile": {
      "roles": [
        {
          "name": "ContosoFrontend",
          "sku": {
            "name": "Standard_D1_v2",
            "tier": "Standard",
            "capacity": 2
          }
        },
        {
          "name": "ContosoBackend",
          "sku": {
            "name": "Standard_D1_v2",
            "tier": "Standard",
            "capacity": 2
          }
        }
      ]
    },
    "osProfile": {
      "secrets": []
    },
    "networkProfile": {
      "loadBalancerConfigurations": [
        {
          "name": "contosolb",
          "properties": {
            "frontendIpConfigurations": [
              {
                "name": "contosofe",
                "properties": {
                  "publicIPAddress": {
                    "id": "/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Network/publicIPAddresses/contosopublicip"
                  }
                }
              }
            ]
          }
        }
      ]
    },
    "provisioningState": "Updating",
    "uniqueId": "4ccb4323-4740-4545-bb81-780b27375947"
  }
}

Tanımlar

Name Description
ApiError

Api hatası.

ApiErrorBase

Api hata tabanı.

CloudError

İşlem hizmetinden bir hata yanıtı.

CloudService

Bulut hizmetini açıklar.

CloudServiceExtensionProfile

Bir bulut hizmeti uzantısı profilini açıklar.

CloudServiceExtensionProperties

Uzantı Özellikleri.

CloudServiceNetworkProfile

Bulut hizmeti için Ağ Profili.

CloudServiceOsProfile

Bulut hizmeti için işletim sistemi profilini açıklar.

CloudServiceProperties

Bulut hizmeti özellikleri

CloudServiceRoleProfile

Bulut hizmeti için rol profilini açıklar.

CloudServiceRoleProfileProperties

Rol özelliklerini açıklar.

CloudServiceRoleSku

Bulut hizmeti rolü sku'su açıklanır.

CloudServiceSlotType

Bulut hizmeti için yuva türü. Olası değerler şunlardır:

Üretim

Hazırlama

Belirtilmezse, varsayılan değer Üretim'dir.

CloudServiceUpdate
CloudServiceUpgradeMode

Bulut hizmeti için güncelleştirme modu. Rol örnekleri, hizmet dağıtıldığında etki alanlarını güncelleştirmek için ayrılır. Güncelleştirmeler her güncelleştirme etki alanında el ile veya tüm güncelleştirme etki alanlarında otomatik olarak başlatılabilir. Olası Değerler şunlardır:

Otomatik

El ile

Eşzamanlı

Belirtilmezse, varsayılan değer Otomatik'tir. El ile olarak ayarlanırsa, güncelleştirmeyi uygulamak için PUT UpdateDomain çağrılmalıdır. Otomatik olarak ayarlanırsa, güncelleştirme her güncelleştirme etki alanına sırayla otomatik olarak uygulanır.

CloudServiceVaultAndSecretReference

Rol örneğine gönderilmeden önce şifrelenen KeyVault kullanılarak başvurulan uzantının korumalı ayarları.

CloudServiceVaultCertificate

Bir Key Vault tek bir sertifika başvuruyu ve sertifikanın rol örneğinde nerede bulunması gerektiğini açıklar.

CloudServiceVaultSecretGroup

Tümü aynı Key Vault olan bir sertifika kümesini açıklar.

Extension

Bir bulut hizmeti Uzantısını açıklar.

InnerError

İç hata ayrıntıları.

LoadBalancerConfiguration

Yük dengeleyici yapılandırmasını açıklar.

LoadBalancerConfigurationProperties

Yük dengeleyici yapılandırmasının özelliklerini açıklar.

LoadBalancerFrontendIpConfiguration

Yük dengeleyici için kullanılacak ön uç IP'sini belirtir. Yalnızca IPv4 ön uç IP adresi desteklenir. Her yük dengeleyici yapılandırmasının tam olarak bir ön uç IP yapılandırması olmalıdır.

LoadBalancerFrontendIpConfigurationProperties

Bulut hizmeti IP Yapılandırmasını açıklar

SubResource
SystemData

Bu kaynakla ilgili sistem meta verileri.

ApiError

Api hatası.

Name Tür Description
code

string

Hata kodu.

details

ApiErrorBase[]

Api hata ayrıntıları

innererror

InnerError

Api iç hatası

message

string

Hata iletisi.

target

string

Belirli bir hatanın hedefi.

ApiErrorBase

Api hata tabanı.

Name Tür Description
code

string

Hata kodu.

message

string

Hata iletisi.

target

string

Belirli bir hatanın hedefi.

CloudError

İşlem hizmetinden bir hata yanıtı.

Name Tür Description
error

ApiError

Api hatası.

CloudService

Bulut hizmetini açıklar.

Name Tür Description
id

string

Kaynak Kimliği.

location

string

Kaynak konumu.

name

string

Kaynak adı.

properties

CloudServiceProperties

Bulut hizmeti özellikleri

systemData

SystemData

Bu kaynakla ilgili sistem meta verileri.

tags

object

Kaynak etiketleri.

type

string

Kaynak türü.

zones

string[]

Kaynağın mantıksal kullanılabilirlik alanı listesi. Liste, bulut hizmetinin sağlanması gereken yalnızca 1 bölge içermelidir. Bu alan isteğe bağlıdır.

CloudServiceExtensionProfile

Bir bulut hizmeti uzantısı profilini açıklar.

Name Tür Description
extensions

Extension[]

Bulut hizmeti uzantılarının listesi.

CloudServiceExtensionProperties

Uzantı Özellikleri.

Name Tür Description
autoUpgradeMinorVersion

boolean

Platform kullanılabilir olduğunda typeHandlerVersion'ı otomatik olarak daha yüksek ikincil sürümlere yükseltip yükseltemeyeceğini açıkça belirtin.

forceUpdateTag

string

Sağlanan genel ve korumalı ayarları zorlamak için etiket. Etiket değerinin değiştirilmesi, genel veya korumalı ayarları değiştirmeden uzantının yeniden çalıştırılmasına olanak tanır. ForceUpdateTag değiştirilmezse, ortak veya korumalı ayarlara yönelik güncelleştirmeler yine işleyici tarafından uygulanır. ForceUpdateTag veya genel veya korumalı ayarların hiçbiri değişmezse, uzantı aynı sıra numarasına sahip rol örneğine akabilir ve yeniden çalıştırılıp çalıştırılmayacağı işleyici uygulamasına bağlı olur

protectedSettings

object

Rol örneğine gönderilmeden önce şifrelenen uzantının korumalı ayarları.

protectedSettingsFromKeyVault

CloudServiceVaultAndSecretReference

Rol örneğine gönderilmeden önce şifrelenen KeyVault kullanılarak başvurulan uzantının korumalı ayarları.

provisioningState

string

Yalnızca yanıtta görünen sağlama durumu.

publisher

string

Uzantı işleyici yayımcısının adı.

rolesAppliedTo

string[]

Bu uzantıyı uygulamak için isteğe bağlı rol listesi. Özellik belirtilmezse veya '*' belirtilirse, uzantı bulut hizmetindeki tüm rollere uygulanır.

settings

object

Uzantının genel ayarları. JSON uzantıları için bu, uzantının JSON ayarlarıdır. XML Uzantısı (RDP gibi) için bu, uzantının XML ayarıdır.

type

string

Uzantının türünü belirtir.

typeHandlerVersion

string

Uzantının sürümünü belirtir. Uzantının sürümünü belirtir. Bu öğe belirtilmezse veya değer olarak yıldız işareti (*) kullanılırsa, uzantının en son sürümü kullanılır. Değer bir ana sürüm numarası ve ikincil sürüm numarası (X) olarak yıldız işaretiyle belirtilirse, belirtilen ana sürümün en son ikincil sürümü seçilir. Ana sürüm numarası ve ikincil sürüm numarası belirtilirse (X.Y), belirli bir uzantı sürümü seçilir. Bir sürüm belirtilirse rol örneğinde otomatik yükseltme gerçekleştirilir.

CloudServiceNetworkProfile

Bulut hizmeti için Ağ Profili.

Name Tür Description
loadBalancerConfigurations

LoadBalancerConfiguration[]

Yük dengeleyici yapılandırmalarının listesi. Bulut hizmeti, genel Load Balancer ve iç Load Balancer karşılık gelen en fazla iki yük dengeleyici yapılandırmasına sahip olabilir.

slotType

CloudServiceSlotType

Bulut hizmeti için yuva türü. Olası değerler şunlardır:

Üretim

Hazırlama

Belirtilmezse, varsayılan değer Üretim'dir.

swappableCloudService

SubResource

Konu bulut hizmetinin değiştirme gerçekleştirebileceği hedef IP'yi içeren bulut hizmetinin kimlik başvurusu. Bu özellik ayarlandıktan sonra güncelleştirilemez. Bu kimlik tarafından başvurulan değiştirilebilir bulut hizmeti mevcut olmalıdır, aksi takdirde bir hata oluşur.

CloudServiceOsProfile

Bulut hizmeti için işletim sistemi profilini açıklar.

Name Tür Description
secrets

CloudServiceVaultSecretGroup[]

Rol örneklerine yüklenmesi gereken sertifika kümesini belirtir.

CloudServiceProperties

Bulut hizmeti özellikleri

Name Tür Description
allowModelOverride

boolean

(İsteğe bağlı) Modelde/şablonda belirtilen rol sku özelliklerinin (roleProfile.roles.sku) sırasıyla .cscfg ve .csdef içinde belirtilen rol örneği sayısını ve vm boyutunu geçersiz kılıp geçersiz kılmayacağını gösterir. false varsayılan değerdir.

configuration

string

Bulut hizmeti için XML hizmet yapılandırmasını (.cscfg) belirtir.

configurationUrl

string

Blob hizmetindeki hizmet yapılandırmasının konumuna başvuran bir URL belirtir. Hizmet paketi URL'si, herhangi bir depolama hesabından Paylaşılan Erişim İmzası (SAS) URI'si olabilir. Bu yalnızca yazma özelliğidir ve GET çağrılarında döndürülmemektedir.

extensionProfile

CloudServiceExtensionProfile

Bir bulut hizmeti uzantısı profilini açıklar.

networkProfile

CloudServiceNetworkProfile

Bulut hizmeti için Ağ Profili.

osProfile

CloudServiceOsProfile

Bulut hizmeti için işletim sistemi profilini açıklar.

packageUrl

string

Blob hizmetindeki hizmet paketinin konumuna başvuran bir URL belirtir. Hizmet paketi URL'si, herhangi bir depolama hesabından Paylaşılan Erişim İmzası (SAS) URI'si olabilir. Bu yalnızca yazma özelliğidir ve GET çağrılarında döndürülmemektedir.

provisioningState

string

Yalnızca yanıtta görünen sağlama durumu.

roleProfile

CloudServiceRoleProfile

Bulut hizmeti için rol profilini açıklar.

startCloudService

boolean

(İsteğe bağlı) Bulut hizmetinin oluşturulduktan hemen sonra başlatılıp başlatılmayacağını gösterir. true varsayılan değerdir. False ise, hizmet modeli yine de dağıtılır, ancak kod hemen çalıştırılmaz. Bunun yerine, siz Başlat'ı çağırana kadar hizmet PoweredOff olur ve bu sırada hizmet başlatılır. Dağıtılan bir hizmet, destekleniyor olsa bile ücrete tabi olmaya devam eder.

uniqueId

string

Bulut hizmetinin benzersiz tanımlayıcısı.

upgradeMode

CloudServiceUpgradeMode

Bulut hizmeti için güncelleştirme modu. Rol örnekleri, hizmet dağıtıldığında etki alanlarını güncelleştirmek için ayrılır. Güncelleştirmeler her güncelleştirme etki alanında el ile veya tüm güncelleştirme etki alanlarında otomatik olarak başlatılabilir. Olası Değerler şunlardır:

Otomatik

El ile

Eşzamanlı

Belirtilmezse, varsayılan değer Otomatik'tir. El ile olarak ayarlanırsa, güncelleştirmeyi uygulamak için PUT UpdateDomain çağrılmalıdır. Otomatik olarak ayarlanırsa, güncelleştirme her güncelleştirme etki alanına sırayla otomatik olarak uygulanır.

CloudServiceRoleProfile

Bulut hizmeti için rol profilini açıklar.

Name Tür Description
roles

CloudServiceRoleProfileProperties[]

Bulut hizmeti rollerinin listesi.

CloudServiceRoleProfileProperties

Rol özelliklerini açıklar.

Name Tür Description
name

string

Kaynak adı.

sku

CloudServiceRoleSku

Bulut hizmeti rolü sku'su açıklanır.

CloudServiceRoleSku

Bulut hizmeti rolü sku'su açıklanır.

Name Tür Description
capacity

integer

Bulut hizmetindeki rol örneklerinin sayısını belirtir.

name

string

SKU adı. NOT: Yeni SKU, bulut hizmetinin şu anda üzerinde olduğu donanımda desteklenmiyorsa, bulut hizmetini silip yeniden oluşturmanız veya eski sku'ya geri dönmeniz gerekir.

tier

string

Bulut hizmetinin katmanını belirtir. Olası Değerler şunlardır:

Standart

Temel

CloudServiceSlotType

Bulut hizmeti için yuva türü. Olası değerler şunlardır:

Üretim

Hazırlama

Belirtilmezse, varsayılan değer Üretim'dir.

Name Tür Description
Production

string

Staging

string

CloudServiceUpdate

Name Tür Description
tags

object

Kaynak etiketleri

CloudServiceUpgradeMode

Bulut hizmeti için güncelleştirme modu. Rol örnekleri, hizmet dağıtıldığında etki alanlarını güncelleştirmek için ayrılır. Güncelleştirmeler her güncelleştirme etki alanında el ile veya tüm güncelleştirme etki alanlarında otomatik olarak başlatılabilir. Olası Değerler şunlardır:

Otomatik

El ile

Eşzamanlı

Belirtilmezse, varsayılan değer Otomatik'tir. El ile olarak ayarlanırsa, güncelleştirmeyi uygulamak için PUT UpdateDomain çağrılmalıdır. Otomatik olarak ayarlanırsa, güncelleştirme her güncelleştirme etki alanına sırayla otomatik olarak uygulanır.

Name Tür Description
Auto

string

Manual

string

Simultaneous

string

CloudServiceVaultAndSecretReference

Rol örneğine gönderilmeden önce şifrelenen KeyVault kullanılarak başvurulan uzantının korumalı ayarları.

Name Tür Description
secretUrl

string

Uzantının korumalı ayarlarını içeren gizli URL

sourceVault

SubResource

Key Vault ARM Kaynak Kimliği

CloudServiceVaultCertificate

Bir Key Vault tek bir sertifika başvuruyu ve sertifikanın rol örneğinde nerede bulunması gerektiğini açıklar.

Name Tür Description
certificateUrl

string

Bu, Key Vault'ye gizli dizi olarak yüklenmiş bir sertifikanın URL'sidir.

CloudServiceVaultSecretGroup

Tümü aynı Key Vault olan bir sertifika kümesini açıklar.

Name Tür Description
sourceVault

SubResource

VaultCertificates'teki tüm sertifikaları içeren Key Vault göreli URL'si.

vaultCertificates

CloudServiceVaultCertificate[]

SourceVault'ta sertifikaları içeren anahtar kasası başvurularının listesi.

Extension

Bir bulut hizmeti Uzantısını açıklar.

Name Tür Description
name

string

Uzantının adı.

properties

CloudServiceExtensionProperties

Uzantı Özellikleri.

InnerError

İç hata ayrıntıları.

Name Tür Description
errordetail

string

İç hata iletisi veya özel durum dökümü.

exceptiontype

string

Özel durum türü.

LoadBalancerConfiguration

Yük dengeleyici yapılandırmasını açıklar.

Name Tür Description
id

string

Kaynak Kimliği

name

string

Yük dengeleyicinin adı

properties

LoadBalancerConfigurationProperties

Yük dengeleyici yapılandırmasının özellikleri.

LoadBalancerConfigurationProperties

Yük dengeleyici yapılandırmasının özelliklerini açıklar.

Name Tür Description
frontendIpConfigurations

LoadBalancerFrontendIpConfiguration[]

Yük dengeleyici için kullanılacak ön uç IP'sini belirtir. Yalnızca IPv4 ön uç IP adresi desteklenir. Her yük dengeleyici yapılandırmasının tam olarak bir ön uç IP yapılandırması olmalıdır.

LoadBalancerFrontendIpConfiguration

Yük dengeleyici için kullanılacak ön uç IP'sini belirtir. Yalnızca IPv4 ön uç IP adresi desteklenir. Her yük dengeleyici yapılandırmasının tam olarak bir ön uç IP yapılandırması olmalıdır.

Name Tür Description
name

string

Yük dengeleyici tarafından kullanılan ön uç IP yapılandırmaları kümesinde benzersiz olan kaynağın adı. Bu ad kaynağa erişmek için kullanılabilir.

properties

LoadBalancerFrontendIpConfigurationProperties

Yük dengeleyici ön uç ip yapılandırmasının özellikleri.

LoadBalancerFrontendIpConfigurationProperties

Bulut hizmeti IP Yapılandırmasını açıklar

Name Tür Description
privateIPAddress

string

IP yapılandırmasının sanal ağ özel IP adresi.

publicIPAddress

SubResource

Genel IP adresi kaynağına başvuru.

subnet

SubResource

Sanal ağ alt ağı kaynağına başvuru.

SubResource

Name Tür Description
id

string

Kaynak Kimliği

SystemData

Bu kaynakla ilgili sistem meta verileri.

Name Tür Description
createdAt

string

Bulut Hizmeti (genişletilmiş destek) kaynağının oluşturulduğu saati UTC olarak belirtir.
En düşük api sürümü: 2022-04-04.

lastModifiedAt

string

Bulut Hizmeti (genişletilmiş destek) kaynağının en son değiştirildiği saati UTC olarak belirtir.
En düşük api sürümü: 2022-04-04.