War diese Seite hilfreich?
Ihr Feedback ist uns wichtig. Teilen Sie uns Ihre Meinung mit.
Weiteres Feedback?
1500 verbleibende Zeichen
MSDN Library

Bereitstellung aktualisieren

Letzte Aktualisierung: Juni 2015

Der asynchrone Upgrade Deployment-Vorgang initiiert eine Aktualisierung von Rolleninstanzen in einer Bereitstellung mithilfe des angegebenen Pakets und der angegebenen Konfiguration. Weitere Informationen zum Update von Rolleninstanzen finden Sie unter Aktualisieren eines Azure-Diensts.

Die Upgrade Deployment-Anforderung kann wie folgt angegeben werden. Ersetzen Sie <subscription-id> durch die Abonnement-ID, <cloudservice-name> durch den Namen des Cloud-Diensts und <deployment-slot> durch staging oder production und <deployment-name> durch den 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=upgrade

Erforderlich. Gibt an, dass die Bereitstellung aktualisiert 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"?>
<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>

In der folgenden Tabelle werden die Elemente im Anforderungstext beschrieben.

 

Elementname Beschreibung

Modus

Erforderlich. Gibt den Typ des zu initiierenden Updates an. Rolleninstanzen werden den Aktualisierungsdomänen zugeordnet, wenn der Dienst bereitgestellt wird. Updates können in jeder Aktualisierungsdomäne manuell initiiert oder in allen Updatedomänen automatisch initiiert werden. 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 jede Aktualisierungsdomäne nacheinander angewendet.

Die Simultaneous-Einstellung ist nur in Version 2012-12-01 oder höher verfügbar.

PackageUrl

Erforderlich. Gibt eine URL an, die auf den Speicherort des Dienstpakets im Blob-Dienst verweist. Das Dienstpaket kann sich in einem Speicherkonto unter demselben Abonnement oder einem SAS-URI (Freigegebene Zugriffssignatur) von jedem Speicherkonto befinden. Weitere Informationen zu freigegebenen Zugriffssignaturen finden Sie unter Delegieren des Zugriffs mit einer SAS (Shared Access Signature).

Konfiguration

Erforderlich. Gibt die Base-64-codierte Dienstkonfigurationsdatei für die Bereitstellung an.

Label

Erforderlich. Gibt den Namen für den Cloud-Dienst an, der Base-64-codiert ist. Der Name kann bis zu 100 Zeichen lang sein. Die Bezeichnung sollte innerhalb des Abonnements eindeutig sein. Der Name kann verwendet werden, um den Cloud-Dienst für die Nachverfolgung zu identifizieren.

RoleToUpgrade

Optional. Gibt den Namen der zu aktualisierenden spezifischen Rolleninstanz an.

Force

Erforderlich. Gibt an, ob das Update fortgesetzt werden soll, wenn die lokalen Daten von Rolleninstanzen verloren gehen. True, wenn das Update fortgesetzt wird; andernfalls false.

Das Force-Element ist nur bei Version 01.10.11 und höher verfügbar.

Name

Optional. Gibt den Namen einer erweiterten Eigenschaft des Cloud-Diensts an. 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 im Namen sind 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. Gibt den Wert einer erweiterten Eigenschaft eines Cloud-Diensts an. 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. Gibt eine Erweiterung an, die dem Cloud-Dienst hinzugefügt wird. In Azure kann ein Prozess als Erweiterung eines Cloud-Diensts ausgeführt werden. Sie müssen mit Erweiterung hinzufügen dem Cloud-Dienst eine Erweiterung hinzufügen, bevor er während eines Updates der Bereitstellung hinzugefügt werden kann.

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

Gibt eine Erweiterung an, 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. Gibt eine Erweiterung an, 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.

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

 

Elementname Beschreibung

ID

Erforderlich. Gibt den Bezeichner der Erweiterung an. 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. Gibt eine bestimmte Rolle an, der die Erweiterung hinzugefügt wird.

RoleName

Erforderlich. Gibt den Namen der Rolle an.

Erweiterung

Erforderlich. Gibt eine Erweiterung an, die für eine Rolle in einem Cloud-Dienst bereitgestellt werden soll.

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

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.

Um ein automatisches Update einer Bereitstellung durchzuführen, rufen Sie Bereitstellung aktualisieren oder Ändern der Bereitstellungskonfiguration mit der Mode-Elementgruppe automatic auf. Das Update wird dann ohne weitere Eingaben fortgesetzt. Sie können Vorgangsstatus abrufen aufrufen, um zu ermitteln, wann das Update abgeschlossen ist.

Um ein manuelles Update durchzuführen, rufen Sie zuerst Bereitstellung aktualisieren mit der Mode-Elementgruppe manual auf. Rufen Sie dann Aktualisieren von Domänen durchlaufen auf, um die einzelnen Domänen innerhalb der Bereitstellung zu aktualisieren. Stellen Sie vor dem Aktualisieren der nächsten Domäne durch Aufrufen von "Get Operation Status" sicher, dass der Vorgang abgeschlossen ist.

ImportantWichtig
Ein Update, durch das Rolleninstanzen hinzugefügt oder entfernt werden, führt zu einem Konfigurationsupdate aller Rollen, die im Cloud-Dienst bereitgestellt sind. Vorhandene Rolleninstanzen müssen über neue Rolleninstanzen benachrichtigt werden, damit alle Rolleninstanzen im Cloud-Dienst miteinander kommunizieren können.

Standardmäßig wird ein Cloud-Dienst mit fünf Updatedomänen bereitgestellt, die während eines direkten Updates einzeln nacheinander aktualisiert werden. Informationen zum Ändern der Anzahl von Updatedomänen in der Dienstdefinitionsdatei finden Sie unter Azure-Dienstdefinitionsschema (.csdef-Datei).

Um die Updatedomäne zu bestimmen, in der eine bestimmte Instanz ausgeführt wird, verwenden Sie die UpdateDomain-Eigenschaft der RoleInstance-Klasse.

Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Anzeigen:
© 2015 Microsoft