Ändra distributionskonfiguration

Artikel
08/05/2023

Den Change Deployment Configuration asynkrona åtgärden initierar en ändring av distributionskonfigurationen.

Förfrågan

Begäran Change Deployment Configuration kan anges på följande sätt. Ersätt <subscription-id> med ditt prenumerations-ID, <cloudservice-name> med namnet på molntjänsten, <deployment-slot> med staging eller productioneller med <deployment-name> det unika 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=config`	Krävs. Anger att en ändring måste göras i konfigurationen av distributionen.

Rubriker för begäran

I följande tabell beskrivs begäranderubrikerna.

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"?>  
<ChangeConfiguration xmlns="http://schemas.microsoft.com/windowsazure">  
  <Configuration>base-64-encoded-configuration-file</Configuration>  
  <TreatWarningsAsError>warnings-as-errors</TreatWarningsAsError>  
  <Mode>type-of-change</Mode>  
  <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>  
</ChangeConfiguration>

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

Elementnamn	Beskrivning
Konfiguration	Krävs. Anger den base-64-kodade tjänstkonfigurationsfilen för distributionen.
TreatWarningsAsError	Valfritt. Anger om varningar ska behandlas som fel. Möjliga värden: - `true` - `false` Om det inte anges är `false`standardvärdet . Om inställningen `true`är inställd på blockeras uppdateringen när varningar påträffas. Elementet `TreatWarningsAsError` är endast tillgängligt med version 2011-04-01 eller senare.
Läge	Valfritt. Möjliga värden: - `Auto` - `Manual` - `Simultaneous` Om inte anges är `Auto`standardvärdet . Om värdet är `Manual`måste WalkUpgradeDomain anropas för att tillämpa uppdateringen. Om inställningen `Auto`är inställd på tillämpas uppdateringen automatiskt på varje uppdateringsdomän för tjänsten. Elementet `Mode` är endast tillgängligt med version 2011-08-01 eller senare. Inställningen `Simultaneous` är endast tillgänglig med version 2013-03-01 eller senare.
Name	Valfritt. Representerar 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 måste börja med en bokstav. Om du försöker använda andra tecken, från och med ett icke-bokstavstecken eller om du 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. Representerar 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 kan ta bort en utökad egenskap genom att ange värdet till NULL. Elementet `Value` är endast tillgängligt med version 2012-03-01 eller senare.
ExtensionConfiguration	Valfritt. Representerar ett tillägg som läggs till i molntjänsten. I Azure kan en process köras som ett tillägg för 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 konfigurationsändring. Elementet `ExtensionConfiguration` är endast tillgängligt med version 2013-03-01 eller senare.

ExtensionConfiguration

Representerar 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. Representerar 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

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

Elementnamn	Beskrivning
Id	Krävs. Identifieraren för tillägget. 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. Representerar en specifik roll som tillägget läggs till i.
RoleName	Krävs. Anger namnet på rollen.
Förlängning	Krävs. Representerar 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.

Eftersom Change Deployment Configuration är en asynkron åtgärd måste du anropa Hämta åtgärdsstatus för att avgöra om åtgärden är slutförd, har misslyckats eller fortfarande pågår.

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.

Dela via