Change Deployment Configuration

Artikel
07/19/2023

Der asynchrone Change Deployment Configuration-Vorgang initiiert eine Änderung an der Bereitstellungskonfiguration.

Anforderung

Die Change Deployment Configuration-Anforderung kann wie folgt angegeben werden. Ersetzen Sie <subscription-id> durch Ihre Abonnement-ID, <cloudservice-name> durch den Namen des Cloud-Diensts, <deployment-slot> durch staging oder production und <deployment-name> durch den eindeutigen Namen der Bereitstellung.

Methode	Anforderungs-URI
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-Parameter

URI-Parameter	BESCHREIBUNG
`comp=config`	Erforderlich. Gibt an, dass eine Änderung an der Konfiguration der Bereitstellung vorgenommen werden muss.

Anforderungsheader

In der folgenden Tabelle werden die Anforderungsheader beschrieben.

Anforderungsheader	BESCHREIBUNG
`Content-Type`	Erforderlich. Legen Sie diesen Header auf `application/xml` fest.
`x-ms-version`	Erforderlich. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Dieser Header sollte auf `2009-10-01` oder höher festgelegt werden.

Anforderungstext

Der Anforderungstext weist das folgende Format auf:

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

In der folgenden Tabelle werden die Elemente im Anforderungstext beschrieben.

Elementname	BESCHREIBUNG
Konfiguration	Erforderlich. Gibt die Base-64-codierte Dienstkonfigurationsdatei für die Bereitstellung an.
TreatWarningsAsError	Optional. Gibt an, ob Warnungen als Fehler behandelt werden sollen. Mögliche Werte: - `true` - `false` Wenn Sie hier nichts angeben, lautet der Standardwert `false`. Wenn der Wert auf `true` ist, wird das Update blockiert, wenn Warnungen auftreten. Das `TreatWarningsAsError` Element ist nur mit Version 2011-04-01 oder höher verfügbar.
Mode	Optional. Mögliche Werte: - `Auto` - `Manual` - `Simultaneous` Wenn dieser Wert nicht angegeben wird, ist der Standardwert `Auto`. Wenn auf `Manual`festgelegt ist, muss WalkUpgradeDomain aufgerufen werden, um das Update anzuwenden. Wenn der Wert auf `Auto` festgelegt ist, wird das Update automatisch auf jeder Aktualisierungsdomäne für den Dienst angewendet. Das `Mode` Element ist nur mit Version 2011-08-01 oder höher verfügbar. Die `Simultaneous` Einstellung ist nur ab Version 2013-03-01 verfügbar.
Name	Optional. Stellt den Namen einer erweiterten Cloud-Dienst-Eigenschaft dar. Jede erweiterte Eigenschaft muss sowohl einen definierten Namen als auch einen definierten Wert aufweisen. Sie können über maximal 25 erweiterte Eigenschaftsnamen und Wertpaare verfügen. Die maximale Länge des `Name`-Elements beträgt 64 Zeichen, nur alphanumerische Zeichen und Unterstriche sind im Namen gültig und der Name muss mit einem Buchstaben beginnen. Der Versuch, andere Zeichen zu verwenden, mit einem anderen Zeichen als einem Buchstaben zu beginnen oder einen Namen einzugeben, der dem einer anderen erweiterten Eigenschaft desselben Cloud-Diensts entspricht, führt zu einem Fehler des Typs Statuscode 400 (ungültige Anforderung). Das `Name` Element ist nur mit Version 2012-03-01 oder höher verfügbar.
Wert	Optional. Stellt den Wert einer erweiterten Cloud-Dienst-Eigenschaft dar. Jede erweiterte Eigenschaft muss sowohl einen definierten Namen als auch einen definierten Wert aufweisen. Sie können über maximal 25 erweiterte Eigenschaftsnamen und Wertpaare verfügen, und jeder erweiterte Eigenschaftswert kann eine maximale Länge von 255 Zeichen aufweisen. Sie können eine erweiterte Eigenschaft löschen, indem Sie den Wert auf NULL festlegen. Das `Value` Element ist nur mit Version 2012-03-01 oder höher verfügbar.
ExtensionConfiguration	Optional. Stellt eine Erweiterung dar, die dem Cloud-Dienst hinzugefügt wird. In Azure kann ein Prozess als Erweiterung eines Cloud-Diensts ausgeführt werden. Sie müssen dem Clouddienst mithilfe von Erweiterung hinzufügen eine Erweiterung hinzufügen, bevor sie während einer Konfigurationsänderung zur Bereitstellung hinzugefügt werden kann. Das `ExtensionConfiguration` Element ist nur mit Version 2013-03-01 oder höher verfügbar.

ExtensionConfiguration

Stellt eine Erweiterung dar, die dem Cloud-Dienst hinzugefügt wird.

Elementname	BESCHREIBUNG
AllRoles	Optional. Gibt eine Liste von Erweiterungen an, die auf alle Rollen in einer Bereitstellung angewendet werden.
Erweiterung	Erforderlich. Stellt eine Erweiterung dar, die für eine Rolle in einem Cloud-Dienst bereitgestellt werden soll.
NamedRoles	Optional. Gibt eine Liste von Erweiterungen an, die auf bestimmte Rollen in einer Bereitstellung angewendet werden.

Durchwahl

Stellt eine Erweiterung dar, die für eine Rolle in einem Cloud-Dienst bereitgestellt werden soll.

Elementname	BESCHREIBUNG
Id	Erforderlich. Der Bezeichner der Erweiterung. Der Bezeichner wird erstellt, wenn die Erweiterung dem Cloud-Dienst hinzugefügt wird. Sie können die ID einer Erweiterung finden, die einem Clouddienst hinzugefügt wurde, indem Sie Listenerweiterungen verwenden.
State	Optional. Gibt den Zustand der Erweiterung an. Dieses Element gilt nur für JSON-konfigurierte Erweiterungen. Mögliche Werte: - `Enable` - `Disable` - `Uninstall` Standardwert: `Enable`. Das `State` Element ist nur mit Version 2014-06-01 oder höher verfügbar.

NamedRoles

Gibt eine Liste von Erweiterungen an, die auf bestimmte Rollen in einer Bereitstellung angewendet werden.

Elementname	BESCHREIBUNG
Role	Erforderlich. Stellt eine bestimmte Rolle dar, der die Erweiterung hinzugefügt wird.
RoleName	Erforderlich. Gibt den Namen der Rolle an.
Erweiterung	Erforderlich. Stellt eine Erweiterung dar, die für eine Rolle in einem Cloud-Dienst bereitgestellt werden soll.

Antwort

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.

Da Change Deployment Configuration es sich um einen asynchronen Vorgang handelt, müssen Sie Vorgangsstatus abrufen aufrufen, um zu bestimmen, ob der Vorgang abgeschlossen ist, ein Fehler aufgetreten ist oder noch ausgeführt wird.

Statuscode

Bei einem erfolgreichen Vorgang wird der Statuscode 200 (OK) zurückgegeben.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten.

Antwortheader	BESCHREIBUNG
`x-ms-request-id`	Ein Wert, der eine für den Verwaltungsdienst ausgeführte Anforderung eindeutig identifiziert. Bei einem asynchronen Vorgang können Sie Den Vorgangsstatus abrufen mit dem Wert des Headers aufrufen, um zu bestimmen, ob der Vorgang abgeschlossen ist, ein Fehler aufgetreten ist oder noch ausgeführt wird.

Antworttext

Keine.

Freigeben über