Központi telepítő frissítése

Cikk
08/05/2023

Az aszinkron Upgrade Deployment művelet kezdeményezi a szerepkörpéldányok frissítését egy üzemelő példányban a megadott csomag és konfiguráció használatával.

Kérés

A Upgrade Deployment kérelem az alábbiak szerint adható meg. Cserélje le <subscription-id> az elemet az előfizetés-azonosítóra, <cloudservice-name> a felhőszolgáltatás nevére, staging<deployment-slot> a vagy productiona helyére, vagy <deployment-name> az üzembe helyezés nevére.

Metódus	Kérés URI-ja
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/`
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/`

URI-paraméterek

URI-paraméter	Description
`comp=upgrade`	Kötelező. Azt adja meg, hogy az üzemelő példányt frissíteni kell.

Kérelemfejlécek

Az alábbi táblázat a kérelemfejléceket ismerteti.

Kérelem fejléce	Description
`Content-Type`	Kötelező. Állítsa ezt a fejlécet értékre `application/xml`.
`x-ms-version`	Kötelező. A kérelemhez használandó művelet verzióját adja meg. Ezt a fejlécet vagy annál magasabbra `2009-10-01` kell állítani.

Kérelem törzse

A kérelem törzsének formátuma a következő:

  
<?xml version="1.0" encoding="utf-8"?>  
<UpgradeDeployment xmlns="http://schemas.microsoft.com/windowsazure">  
  <Mode>type-of-upgrade</Mode>  
  <PackageUrl>url-to-package</PackageUrl>  
  <Configuration>base64-encoded-config-file</Configuration>  
  <Label>base-64-encoded-label</Label>  
  <RoleToUpgrade>role-name</RoleToUpgrade>  
  <Force>true|false</Force>  
  <ExtendedProperties>  
    <ExtendedProperty>  
      <Name>property-name</Name>  
      <Value>property-value</Value>  
    </ExtendedProperty>  
  </ExtendedProperties>  
  <ExtensionConfiguration>  
    <AllRoles>  
      <Extension>  
        <Id>identifier-of-extension</Id>  
        <State>state-of-extension</State>  
      </Extension>  
    </AllRoles>  
    <NamedRoles>  
      <Role>  
        <RoleName>role_name1</RoleName>  
        <Extensions>  
          <Extension>  
            <Id>identifier-of-extension</Id>  
            <State>state-of-extension</State>  
          </Extension>  
        </Extensions>  
      </Role>  
    </NamedRoles>  
  </ExtensionConfiguration>  
</UpgradeDeployment>

Az alábbi táblázat a kérelem törzsének elemeit ismerteti.

Elem neve	Leírás
Mód	Kötelező. Megadja a kezdeményezni kívánt frissítés típusát. A szerepkörpéldányok a szolgáltatás üzembe helyezésekor lesznek lefoglalva a tartományok frissítéséhez. Frissítések manuálisan indítható el minden frissítési tartományban, vagy automatikusan elindítható az összes frissítési tartományban. Lehetséges értékek: - `Auto` - `Manual` - `Simultaneous` Ha nincs megadva, az alapértelmezett érték a .`Auto` Ha a értékre van állítva, `Manual`a WalkUpgradeDomaint meg kell hívni a frissítés alkalmazásához. Ha a értékre `Auto`van állítva, a rendszer egymás után automatikusan alkalmazza a frissítést az egyes frissítési tartományokra. A `Simultaneous` beállítás csak a 2012-12-01-es vagy újabb verzióban érhető el.
PackageUrl	Kötelező. Megad egy URL-címet, amely a szolgáltatáscsomag blobszolgáltatásban való helyére hivatkozik. A szolgáltatáscsomag egy tárfiókban, ugyanazon előfizetés alatt, vagy bármely tárfiókból származó közös hozzáférésű jogosultságkód (SAS) URI-jában található. A közös hozzáférésű jogosultságkódokkal kapcsolatos további információkért lásd: Hozzáférés delegálása közös hozzáférésű jogosultságkóddal.
Konfiguráció	Kötelező. Megadja az üzembe helyezés base-64 kódolású szolgáltatáskonfigurációs fájlját.
Címke	Kötelező. Megadja a base-64 kódolású felhőszolgáltatás nevét. A név legfeljebb 100 karakter hosszúságú lehet. Javasoljuk, hogy a címke egyedi legyen az előfizetésen belül. A név a felhőszolgáltatás azonosítására használható nyomkövetési célokra.
RoleToUpgrade	Választható. Megadja a frissíteni kívánt szerepkörpéldány nevét. Egyetlen szerepkör frissítése esetén az összes többi szerepkör továbbra is újraindulhat, ha belső Azure-frissítés van ütemezve. Ebben a forgatókönyvben a frissítési tartomány garantált.
Force	Kötelező. Azt jelzi, hogy a frissítés akkor is folytatódjon-e, ha a helyi adatok elvesznek bizonyos szerepkörpéldányokból. `True` ha a frissítésnek folytatódnia kell; egyéb esetben `false`: . Az `Force` elem csak a 2011-10-01-es vagy újabb verzióval érhető el.
Name	Választható. Egy kiterjesztett felhőszolgáltatás-tulajdonság nevét adja meg. Minden kiterjesztett tulajdonságnak definiált névvel és értékkel kell rendelkeznie. Legfeljebb 25 kiterjesztett tulajdonságnév és értékpár lehet. Az elem maximális hossza `Name` 64 karakter, csak alfanumerikus karakterek és aláhúzásjelek érvényesek a névben, és a névnek betűvel kell kezdődnie. Ha más karaktereket próbál használni, amelyek nem betűjellel kezdődnek, vagy olyan nevet ad meg, amely megegyezik az ugyanazon felhőszolgáltatás tulajdonában lévő másik kiterjesztett tulajdonság nevével, 400-ás (hibás kérelem) állapotkódot eredményez. Az `Name` elem csak a 2012-03-01-es vagy újabb verzióval érhető el.
Érték	Választható. Egy kiterjesztett felhőszolgáltatás-tulajdonság értékét adja meg. Minden kiterjesztett tulajdonságnak definiált névvel és értékkel kell rendelkeznie. Legfeljebb 25 kiterjesztett tulajdonságnév és értékpár lehet, és minden kiterjesztett tulajdonság értéke legfeljebb 255 karakter hosszúságú lehet. A kiterjesztett tulajdonság törléséhez állítsa az értéket NULL értékre. Az `Value` elem csak a 2012-03-01-es vagy újabb verzióval érhető el.
ExtensionConfiguration	Választható. A felhőszolgáltatáshoz hozzáadott bővítményt adja meg. Az Azure-ban egy folyamat egy felhőszolgáltatás bővítményeként is futtatható. Ahhoz, hogy a frissítés során hozzá lehessen adni az üzembe helyezéshez, hozzá kell adnia egy bővítményt a felhőszolgáltatáshoz az Add Extension (Bővítmény hozzáadása ) használatával. Az `ExtensionConfiguration` elem csak a 2013-03-01-es vagy újabb verzióval érhető el.

ExtensionConfiguration

A felhőszolgáltatáshoz hozzáadott bővítményt adja meg.

Elem neve	Leírás
AllRoles	Választható. Az üzembe helyezés összes szerepkörére alkalmazott bővítmények listáját adja meg.
Kiterjesztés	Kötelező. Olyan bővítményt ad meg, amelyet egy felhőszolgáltatásban lévő szerepkörben kell üzembe helyezni.
NamedRoles	Választható. Megadja azoknak a bővítményeknek a listáját, amelyek az üzemelő példány adott szerepköreire vonatkoznak.

Kiterjesztés

Olyan bővítményt ad meg, amelyet egy felhőszolgáltatásban lévő szerepkörben kell üzembe helyezni.

Elem neve	Leírás
Id	Kötelező. A bővítmény azonosítóját adja meg. Az azonosító akkor jön létre, amikor a bővítmény hozzá van adva a felhőszolgáltatáshoz. A bővítmények listázásával megkeresheti egy felhőszolgáltatáshoz hozzáadott bővítmény azonosítóját.
Állapot	Választható. A bővítmény állapotát adja meg. Ez az elem csak a JSON-konfigurált bővítményekre vonatkozik. Lehetséges értékek: - `Enable` - `Disable` - `Uninstall` Az alapértelmezett érték `Enable`. Az `State` elem csak a 2014-06-01-es vagy újabb verzióval érhető el.

NamedRoles

Megadja azoknak a bővítményeknek a listáját, amelyek az üzemelő példány adott szerepköreire vonatkoznak.

Elem neve	Leírás
Szerepkör	Kötelező. Megadja azt a szerepkört, amelyhez a bővítmény hozzá van adva.
RoleName	Kötelező. A szerepkör nevét adja meg.
Kiterjesztés	Kötelező. Olyan bővítményt ad meg, amelyet egy felhőszolgáltatásban lévő szerepkörben kell üzembe helyezni.

Reagálás

A válasz egy HTTP-állapotkódot és válaszfejléceket tartalmaz.

Állapotkód

A sikeres művelet a 200 -os állapotkódot adja vissza (OK).

Válaszfejlécek

A műveletre adott válasz a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmazhat.

Válaszfejléc	Description
`x-ms-request-id`	Egy érték, amely egyedileg azonosítja a felügyeleti szolgáltatásra irányuló kérést. Aszinkron művelet esetén meghívhatja a Művelet állapotának lekérése a fejléc értékével annak megállapításához, hogy a művelet befejeződött,sikertelen volt-e, vagy még folyamatban van-e.

Válasz törzse

Nincsenek.

Megjegyzések

Az üzemelő példány automatikus frissítésének végrehajtásához hívja meg a Frissítéstelepítés vagy a Központi telepítési konfiguráció módosítása elemet a Mode következőre állítva: automatic. A frissítés ettől a ponttól kezdve további bevitel nélkül folytatódik. A Művelet állapotának lekérése hívásával megállapíthatja, hogy mikor fejeződik be a frissítés.

Manuális frissítés végrehajtásához először hívja meg a Frissítéstelepítést , amelynek eleme a Mode következő: manual. Ezután hívja meg a WalkUpgradeDomaint az üzemelő példányon belüli tartományok frissítéséhez. A következő tartomány frissítése előtt a Művelet állapotának lekérése hívásával győződjön meg arról, hogy a művelet befejeződött.

A szerepkörpéldányokat hozzáadó vagy eltávolító frissítés konfigurációs frissítést eredményez a felhőszolgáltatásban üzembe helyezett összes szerepkörhöz. A meglévő szerepkörpéldányokat értesíteni kell az új szerepkörpéldányokról, hogy az összes szerepkörpéldány együtt tudjon kommunikálni a felhőszolgáltatásban.

Alapértelmezés szerint egy felhőszolgáltatás öt frissítési tartománnyal van üzembe helyezve, amelyek egy helyben történő frissítés során egyenként frissülnek.

Annak a frissítési tartománynak a meghatározásához, amelyben egy adott példány fut, használja a UpdateDomainRoleInstance osztály tulajdonságát.