VERTRIEB: 1-800-867-1380

Change Deployment Configuration

Letzte Aktualisierung: Februar 2015

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

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

Sie müssen sicherstellen, dass die an den Verwaltungsdienst gestellte Anforderung sicher ist. Zusätzliche Informationen finden Sie im Thema Authentifizieren von Dienstverwaltungsanforderungen.

 

URI-Parameter Beschreibung

comp=config

Erforderlich. Gibt an, dass eine Änderung an der Konfiguration der Bereitstellung vorgenommen werden muss.

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 01.10.09 oder höher festgelegt werden. Weitere Informationen zu den Versionsangaben in den Headern finden Sie unter Dienstverwaltungs-Versionsverwaltung.

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.

Folgende Werte sind möglich:

  • true

  • false

Wenn dieser Wert nicht angegeben wird, ist der Standardwert false. Wenn der Wert auf true ist, wird das Update blockiert, wenn Warnungen auftreten.

Das TreatWarningsAsError-Element ist nur bei Version 01.04.11 und höher verfügbar.

Modus

Optional. Folgende Werte sind möglich:

  • Auto

  • Manual

  • Simultaneous

Wenn dieser Wert nicht angegeben wird, ist der Standardwert Auto. Wenn der Wert auf Manual festgelegt ist, muss WalkUpgradeDomain aufgerufen werden, um die Aktualisierung 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 bei Version 01.08.11 und höher verfügbar.

Die Einstellung Simultaneous ist nur bei Version 2012-12-01 und höher 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 bei Version 01.03.12 und 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 bei Version 01.03.12 und 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 Cloud-Dienst eine Erweiterung hinzufügen, indem Sie Erweiterung hinzufügen verwenden, bevor sie der Bereitstellung während einer Konfigurationsänderung hinzugefügt werden kann.

Das ExtensionConfiguration-Element ist nur bei Version 01.03.13 und höher verfügbar.

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.

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, die einem Cloud-Dienst hinzugefügt wurde, über Erweiterungen auflisten suchen.

US-Bundesstaat

Optional. Gibt den Zustand der Erweiterung an. Dieses Element gilt nur für JSON-konfigurierte Erweiterungen.

Folgende Werte sind möglich:

  • Enable

  • Disable

  • Uninstall

Der Standardwert lautet Enable.

Das State-Element ist nur bei Version 01.06.14 und höher verfügbar.

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

 

Elementname Beschreibung

Rolle

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.

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

Da Change Deployment Configuration ein asynchroner Vorgang ist, müssen Sie Vorgangsstatus abrufen aufrufen, um zu bestimmen, ob der Vorgang abgeschlossen wurde, fehlgeschlagen ist oder noch ausgeführt wird.

Bei einem erfolgreichen Vorgang wird der Statuscode 200 (OK) zurückgegeben. Weitere Informationen zu Statuscodes finden Sie unter Dienstverwaltungsstatus und Fehlercodes.

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

 

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 Vorgangsstatus abrufen mit dem Wert dieses Headers aufrufen, um zu bestimmen, ob der Vorgang abgeschlossen wurde, fehlgeschlagen ist oder noch ausgeführt wird.

Keine.

Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Vielen Dank für Ihr Feedback.
Anzeigen:
© 2015 Microsoft