Uppgradera distribution

Artikel
08/05/2023

Den Upgrade Deployment asynkrona åtgärden initierar en uppdatering av rollinstanser i en distribution med hjälp av det paket och den konfiguration som du anger.

Förfrågan

Begäran Upgrade Deployment kan anges på följande sätt. Ersätt <subscription-id> med prenumerations-ID:t med <cloudservice-name> namnet på molntjänsten, <deployment-slot> med staging eller productioneller med <deployment-name> namnet på distributionen.

Metod	URI för förfrågan
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-parametrar

URI-parameter	Description
`comp=upgrade`	Krävs. Anger att distributionen måste uppdateras.

Rubriker för begäran

I följande tabell beskrivs begärandehuvudena.

Begärandehuvud	Description
`Content-Type`	Krävs. Ställ in det här huvudet på `application/xml`.
`x-ms-version`	Krävs. Anger vilken version av åtgärden som ska användas för den här begäran. Det här huvudet ska vara inställt på `2009-10-01` eller högre.

Begärandetext

Formatet för begärandetexten är följande:

  
<?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>

I följande tabell beskrivs elementen i begärandetexten.

Elementnamn	Beskrivning
Läge	Krävs. Anger vilken typ av uppdatering som ska initieras. Rollinstanser allokeras till uppdateringsdomäner när tjänsten distribueras. Uppdateringar kan initieras manuellt i varje uppdateringsdomän eller initieras automatiskt i alla uppdateringsdomäner. Möjliga värden: - `Auto` - `Manual` - `Simultaneous` Om inget anges är `Auto`standardvärdet . Om värdet är `Manual`måste WalkUpgradeDomain anropas för att uppdateringen ska kunna tillämpas. Om inställningen är inställd `Auto`på tillämpas uppdateringen automatiskt på varje uppdateringsdomän i följd. Inställningen `Simultaneous` är endast tillgänglig i version 2012-12-01 eller senare.
PackageUrl	Krävs. Anger en URL som refererar till platsen för tjänstpaketet i Blob Service. Tjänstpaketet kan finnas antingen i ett lagringskonto under samma prenumeration eller en SAS-URI (Signatur för delad åtkomst) från valfritt lagringskonto. Mer information om signaturer för delad åtkomst finns i Delegera åtkomst med en signatur för delad åtkomst.
Konfiguration	Krävs. Anger base-64-kodad tjänstkonfigurationsfil för distributionen.
Etikett	Krävs. Anger namnet på den molntjänst som är base-64-kodad. Namnet kan vara upp till 100 tecken långt. Vi rekommenderar att etiketten är unik i prenumerationen. Namnet kan användas för att identifiera molntjänsten i spårningssyfte.
RoleToUpgrade	Valfritt. Anger namnet på den specifika rollinstans som ska uppdateras. Vid en enskild rolluppgradering kan alla andra roller fortfarande återanvändas om en intern Azure-uppgradering har schemalagts. Uppdateringsdomänen garanteras i det här scenariot.
Force	Krävs. Anger om uppdateringen ska fortsätta även när lokala data går förlorade från vissa rollinstanser. `True` om uppdateringen ska fortsätta; annars `false`. Elementet `Force` är endast tillgängligt med version 2011-10-01 eller senare.
Name	Valfritt. Anger namnet på en utökad molntjänstegenskap. Varje utökad egenskap måste ha både ett definierat namn och värde. Du kan ha högst 25 utökade egenskapsnamn och värdepar. Den maximala längden för elementet `Name` är 64 tecken, endast alfanumeriska tecken och understreck är giltiga i namnet och namnet måste börja med en bokstav. Om du försöker använda andra tecken, som börjar med ett icke-bokstavstecken, eller anger ett namn som är identiskt med namnet på en annan utökad egenskap som ägs av samma molntjänst, resulterar det i ett statuskod 400-fel (felaktig begäran). Elementet `Name` är endast tillgängligt med version 2012-03-01 eller senare.
Värde	Valfritt. Anger värdet för en utökad molntjänstegenskap. Varje utökad egenskap måste ha både ett definierat namn och värde. Du kan ha högst 25 utökade egenskapsnamn och värdepar, och varje utökat egenskapsvärde har en maximal längd på 255 tecken. Du tar bort en utökad egenskap genom att ange värdet null. Elementet `Value` är endast tillgängligt med version 2012-03-01 eller senare.
ExtensionConfiguration	Valfritt. Anger ett tillägg som läggs till i molntjänsten. I Azure kan en process köras som ett tillägg till en molntjänst. Du måste lägga till ett tillägg till molntjänsten med hjälp av Lägg till tillägg innan det kan läggas till i distributionen under en uppdatering. Elementet `ExtensionConfiguration` är endast tillgängligt med version 2013-03-01 eller senare.

ExtensionConfiguration

Anger ett tillägg som läggs till i molntjänsten.

Elementnamn	Beskrivning
AllRoles	Valfritt. Anger en lista över tillägg som tillämpas på alla roller i en distribution.
Förlängning	Krävs. Anger ett tillägg som ska distribueras till en roll i en molntjänst.
NamedRoles	Valfritt. Anger en lista över tillägg som tillämpas på specifika roller i en distribution.

Filnamnstillägg

Anger ett tillägg som ska distribueras till en roll i en molntjänst.

Elementnamn	Beskrivning
Id	Krävs. Anger tilläggets identifierare. Identifieraren skapas när tillägget läggs till i molntjänsten. Du hittar ID:t för ett tillägg som har lagts till i en molntjänst med hjälp av Listtillägg.
Tillstånd	Valfritt. Anger tillståndet för tillägget. Det här elementet gäller endast för JSON-konfigurerade tillägg. Möjliga värden: - `Enable` - `Disable` - `Uninstall` Standardvärdet är `Enable`. Elementet `State` är endast tillgängligt med version 2014-06-01 eller senare.

NamedRoles

Anger en lista över tillägg som tillämpas på specifika roller i en distribution.

Elementnamn	Beskrivning
Roll	Krävs. Anger en specifik roll som tillägget läggs till i.
RoleName	Krävs. Anger namnet på rollen.
Förlängning	Krävs. Anger ett tillägg som ska distribueras till en roll i en molntjänst.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Statuskod

En lyckad åtgärd returnerar statuskod 200 (OK).

Svarsrubriker

Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden.

Svarshuvud	Description
`x-ms-request-id`	Ett värde som unikt identifierar en begäran som görs mot hanteringstjänsten. För en asynkron åtgärd kan du anropa Hämta åtgärdsstatus med värdet för huvudet för att avgöra om åtgärden är slutförd, har misslyckats eller fortfarande pågår.

Svarstext

Inga.

Kommentarer

Om du vill utföra en automatisk uppdatering av en distribution anropar du Uppgradera distribution eller Ändra distributionskonfiguration med elementet Mode inställt på automatic. Uppdateringen fortsätter från den punkten utan ytterligare indata. Du kan anropa Hämta åtgärdsstatus för att avgöra när uppdateringen är klar.

Om du vill utföra en manuell uppdatering anropar du först Uppgraderingsdistribution med elementet Mode inställt på manual. Anropa sedan WalkUpgradeDomain för att uppdatera varje domän i distributionen. Du bör se till att åtgärden har slutförts genom att anropa Hämta åtgärdsstatus innan du uppdaterar nästa domän.

En uppdatering som lägger till eller tar bort rollinstanser resulterar i en konfigurationsuppdatering för alla roller som distribueras i molntjänsten. Befintliga rollinstanser måste meddelas om nya rollinstanser så att alla rollinstanser kan kommunicera tillsammans i molntjänsten.

Som standard distribueras en molntjänst med fem uppdateringsdomäner, som uppdateras en i taget under en uppdatering på plats.

Om du vill fastställa uppdateringsdomänen där en viss instans körs använder du UpdateDomain egenskapen för RoleInstance klassen .

Dela via