Bereitstellung erstellen

Der asynchrone Create Deployment-Vorgang lädt ein neues Dienstpaket hoch und erstellt eine neue Bereitstellung in Staging- oder der Produktionsumgebung.

Bevor Sie diesen Vorgang ausführen können, müssen Sie folgende Aufgaben ausführen:

• Erstellen Sie ein Abonnement, und rufen Sie den Abonnementbezeichner ab. Sie erhalten den Abonnementbezeichner auf der Seite "Einstellungen" des Verwaltungsportals.

• Erstellen Sie ein Verwaltungszertifikat, und laden Sie es hoch, um den Vorgang zu autorisieren.

• Erstellen Sie einen Clouddienst.

• Legen Sie fest, ob die Anwendung in einer Staging- oder Produktionsumgebung bereitgestellt werden soll.

Anforderung

Die Create Deployment Anforderung wird wie folgt angegeben. Ersetzen Sie <subscription-id> durch die Abonnement-ID, <cloudservice-name> durch den Namen des Cloud-Diensts und <deployment-slot> durch staging oder production.

Methode	Anforderungs-URI
POST	https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>

URI-Parameter

Keine.

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"?>  
<CreateDeployment xmlns="http://schemas.microsoft.com/windowsazure">  
  <Name>deployment-name</Name>  
  <PackageUrl>package-url-in-blob-storage</PackageUrl>  
  <Label>base64-encoded-deployment-label</Label>  
  <Configuration>base64-encoded-configuration-file</Configuration>  
  <StartDeployment>start-deployment</StartDeployment>  
  <TreatWarningsAsError>prioritize-warnings</TreatWarningsAsError>  
  <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>  
</CreateDeployment>  
  

In der folgenden Tabelle werden die Elemente im Anforderungstext beschrieben.

Elementname	BESCHREIBUNG
Name	Erforderlich. Gibt den Namen der Bereitstellung an.
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.
Konfiguration	Erforderlich. Gibt die Base-64-codierte Dienstkonfigurationsdatei für die Bereitstellung an.
Bezeichnung	Erforderlich. Gibt einen Bezeichner für die Bereitstellung an, der Base-64-codiert ist. Der Bezeichner kann bis zu 100 Zeichen lang sein. Die Bezeichnung sollte innerhalb des Abonnements eindeutig sein. Die Bezeichnung kann für die Nachverfolgung verwendet werden.
StartDeployment	Optional. Gibt an, ob die Bereitstellung sofort nach dem Erstellen gestartet werden soll. Standardwert: false. false gibt an, dass das Dienstmodell weiterhin bereitgestellt wird, der Code jedoch nicht sofort ausgeführt wird. Stattdessen wird Suspended der Dienst so lange ausgeführt, bis Sie Den Updatebereitstellungsstatus aufrufen und die status auf Runningfestlegen. Zu diesem Zeitpunkt wird der Dienst gestartet. Ein bereitgestellter Dienst verursacht immer noch Gebühren, wenn er angehalten wurde. Das StartDeployment Element ist nur mit Version 2010-04-01 oder höher verfügbar.
TreatWarningsAsError	Optional. Gibt an, ob Paketüberprüfungswarnungen als Fehler behandelt werden sollen. Standardwert: false. Bei true wird beim Created Deployment-Vorgang ein Fehler erzeugt, wenn Überprüfungswarnungen für das Dienstpaket auftreten. Das TreatWarningsAsError Element ist nur mit Version 2011-04-01 oder höher verfügbar.
Name	Optional. Gibt den Namen einer erweiterten Bereitstellungseigenschaft 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 Namenelements beträgt 64 Zeichen, nur alphanumerische Zeichen und Unterstriche im Namen sind gültig, und der Name muss mit einem Buchstaben beginnen. Das Name Element ist nur mit Version 2012-03-01 oder 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. Das Value Element ist nur mit Version 2012-03-01 oder 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 dem Clouddienst mithilfe von Erweiterung hinzufügen eine Erweiterung hinzufügen, bevor sie der Bereitstellung hinzugefügt werden kann. Das ExtensionConfiguration Element ist nur mit Version 2013-03-01 oder höher verfügbar.

ExtensionConfiguration

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.

Durchwahl

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 den Bezeichner 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. 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.

Antwort

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

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.