Erstellen eines Cloud-Diensts

Der Create Cloud Service-Vorgang erstellt einen neuen Cloud-Dienst in Microsoft Azure.

Anforderung

Die Create Cloud Service Anforderung wird wie folgt angegeben. Ersetzen Sie <subscription-id> durch Ihre Abonnement-ID.

Methode	Anforderungs-URI
POST	https://management.core.windows.net/<subscription-id>/services/hostedservices

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. Der Wert dieses Headers muss auf 2010-10-28 oder höher festgelegt werden.

Anforderungstext

Der Anforderungstext weist das folgende Format auf:

<?xml version="1.0" encoding="utf-8"?>  
<CreateHostedService xmlns="http://schemas.microsoft.com/windowsazure">  
  <ServiceName>name-of-cloud-service</ServiceName>  
  <Label>base64-encoded-label-of-cloud-service</Label>  
  <Description>description-of-cloud-service</Description>  
  <Location>location-of-cloud-service</Location>  
  <AffinityGroup>name-of-affinity-group</AffinityGroup>  
  <ExtendedProperties>  
    <ExtendedProperty>  
      <Name>name-of-property</Name>  
      <Value>value-of-property</Value>  
    </ExtendedProperty>  
  </ExtendedProperties>  
  <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn>  
</CreateHostedService>  

In der folgenden Tabelle werden die Elemente des Anforderungstexts beschrieben.

Elementname	BESCHREIBUNG
Dienstname	Erforderlich. Gibt den Namen für den Cloud-Dienst an. Der Name muss innerhalb von Azure eindeutig sein. Dieser Name ist der DNS-Präfixname, der für den Zugriff auf den Dienst verwendet wird. Um die Verfügbarkeit eines Namens zu überprüfen, können Sie die Verfügbarkeit von Clouddienstnamen überprüfen verwenden.
Bezeichnung	Erforderlich. Gibt den Base-64-codierten Bezeichner des Cloud-Diensts an. Der Bezeichner kann bis zu 100 Zeichen lang sein. Die Bezeichnung kann für die Nachverfolgung verwendet werden.
BESCHREIBUNG	Optional. Gibt die Beschreibung des Cloud-Diensts an. Die Beschreibung kann bis zu 1024 Zeichen lang sein.
Standort	Erforderlich, wenn AffinityGroup nicht angegeben wird. Gibt den Standort an, an dem der Cloud-Dienst erstellt wird. Sie müssen Location oder AffinityGroup, jedoch nicht beide angeben. Um die verfügbaren Speicherorte anzuzeigen, können Sie Speicherorte auflisten verwenden.
AffinityGroup	Erforderlich, wenn Location nicht angegeben wird. Gibt den Namen einer vorhandenen Affinitätsgruppe an, die dem Abonnement zugeordnet ist. Sie müssen Location oder AffinityGroup, jedoch nicht beide angeben. Um die verfügbaren Affinitätsgruppen anzuzeigen, können Sie Affinitätsgruppen auflisten verwenden.
Name	Optional. Gibt den Namen einer erweiterten Eigenschaft des Cloud-Diensts an. Der Name kann bis zu 64 Zeichen umfassen, darf nur alphanumerische Zeichen und Unterstriche enthalten und muss mit einem Buchstaben beginnen. Jede erweiterte Eigenschaft muss sowohl einen definierten Namen als auch einen definierten Wert aufweisen. Sie können maximal 50 erweiterte Eigenschaften definieren. 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. Der Wert der erweiterten Eigenschaft kann bis zu 255 Zeichen lang sein. Das Value Element ist nur mit Version 2012-03-01 oder höher verfügbar.
ReverseDnsFqdn	Optional. Gibt die DNS-Adresse an, in die die IP-Adresse des Cloud-Diensts aufgelöst wird, wenn eine Abfrage mithilfe einer DNS-Rückwärtsabfrage erfolgt. Das ReverseDnsFqdn Element ist nur mit Version 2014-06-01 oder höher verfügbar.

Antwort

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

Statuscode

Bei einem erfolgreichen Vorgang wird der Statuscode 201 (Erstellt) 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 Vorgangsstatus abrufen mit dem Wert des Headers aufrufen, um zu bestimmen, ob der Vorgang abgeschlossen ist, fehlgeschlagen ist oder noch ausgeführt wird.

Antworttext

Keine.