Dela via


Ändra distributionskonfiguration

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 falsestandardvä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 Autostandardvärdet . Om värdet är Manualmå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.