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 |
---|---|---|---|---|
cloud
|
path | True |
string |
Bulut hizmetinin adı. |
resource
|
path | True |
string |
Kaynak grubunun adı. |
subscription
|
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 |
Tamam |
|
Other Status Codes |
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 |
---|---|
Api |
Api hatası. |
Api |
Api hata tabanı. |
Cloud |
İşlem hizmetinden bir hata yanıtı. |
Cloud |
Bulut hizmetini açıklar. |
Cloud |
Bir bulut hizmeti uzantısı profilini açıklar. |
Cloud |
Uzantı Özellikleri. |
Cloud |
Bulut hizmeti için Ağ Profili. |
Cloud |
Bulut hizmeti için işletim sistemi profilini açıklar. |
Cloud |
Bulut hizmeti özellikleri |
Cloud |
Bulut hizmeti için rol profilini açıklar. |
Cloud |
Rol özelliklerini açıklar. |
Cloud |
Bulut hizmeti rolü sku'su açıklanır. |
Cloud |
Bulut hizmeti için yuva türü.
Olası değerler şunlardır: |
Cloud |
|
Cloud |
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: |
Cloud |
Rol örneğine gönderilmeden önce şifrelenen KeyVault kullanılarak başvurulan uzantının korumalı ayarları. |
Cloud |
Bir Key Vault tek bir sertifika başvuruyu ve sertifikanın rol örneğinde nerede bulunması gerektiğini açıklar. |
Cloud |
Tümü aynı Key Vault olan bir sertifika kümesini açıklar. |
Extension |
Bir bulut hizmeti Uzantısını açıklar. |
Inner |
İç hata ayrıntıları. |
Load |
Yük dengeleyici yapılandırmasını açıklar. |
Load |
Yük dengeleyici yapılandırmasının özelliklerini açıklar. |
Load |
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. |
Load |
Bulut hizmeti IP Yapılandırmasını açıklar |
Sub |
|
System |
Bu kaynakla ilgili sistem meta verileri. |
ApiError
Api hatası.
Name | Tür | Description |
---|---|---|
code |
string |
Hata kodu. |
details |
Api hata ayrıntıları |
|
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 |
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 |
Bulut hizmeti özellikleri |
|
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 |
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 |
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 |
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 |
Bulut hizmeti için yuva türü.
Olası değerler şunlardır: |
|
swappableCloudService |
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 |
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.
|
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 |
Bir bulut hizmeti uzantısı profilini açıklar. |
|
networkProfile |
Bulut hizmeti için Ağ Profili. |
|
osProfile |
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 |
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.
|
uniqueId |
string |
Bulut hizmetinin benzersiz tanımlayıcısı. |
upgradeMode |
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: |
CloudServiceRoleProfile
Bulut hizmeti için rol profilini açıklar.
Name | Tür | Description |
---|---|---|
roles |
Bulut hizmeti rollerinin listesi. |
CloudServiceRoleProfileProperties
Rol özelliklerini açıklar.
Name | Tür | Description |
---|---|---|
name |
string |
Kaynak adı. |
sku |
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: |
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 |
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 |
VaultCertificates'teki tüm sertifikaları içeren Key Vault göreli URL'si. |
|
vaultCertificates |
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 |
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 |
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 |
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 |
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 |
Genel IP adresi kaynağına başvuru. |
|
subnet |
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. |
lastModifiedAt |
string |
Bulut Hizmeti (genişletilmiş destek) kaynağının en son değiştirildiği saati UTC olarak belirtir. |