Tworzenie usługi w chmurze

Operacja Create Cloud Service asynchroniczna tworzy nową usługę w chmurze na platformie Microsoft Azure.

Żądanie

Żądanie Create Cloud Service jest określone w następujący sposób. Zastąp <subscription-id> element identyfikatorem subskrypcji.

Metoda	Identyfikator URI żądania
POST	https://management.core.windows.net/<subscription-id>/services/hostedservices

Parametry identyfikatora URI

Brak.

Nagłówki żądań

W poniższej tabeli opisano nagłówki żądań.

Nagłówek żądania	Opis
Content-Type	Wymagane. Ustaw ten nagłówek na application/xmlwartość .
x-ms-version	Wymagane. Określa wersję operacji do użycia dla tego żądania. Wartość tego nagłówka musi być ustawiona na 2010-10-28 lub wyższą.

Treść żądania

Format treści żądania jest następujący:

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

W poniższej tabeli opisano elementy treści żądania.

Nazwa elementu	Opis
ServiceName	Wymagane. Określa nazwę usługi w chmurze. Ta nazwa musi być unikatowa na platformie Azure. Jest to nazwa prefiksu DNS używana do uzyskiwania dostępu do usługi. Aby sprawdzić dostępność nazwy, możesz użyć opcji Sprawdź dostępność nazwy usługi w chmurze.
Etykieta	Wymagane. Określa identyfikator usługi w chmurze zakodowany w formacie base-64. Identyfikator może mieć długość do 100 znaków. Etykieta może być używana do celów śledzenia.
Opis	Opcjonalny. Określa opis usługi w chmurze. Opis może mieć długość maksymalnie 1024 znaków.
Lokalizacja	Wymagane, jeśli AffinityGroup nie zostanie określony. Określa lokalizację, w której jest tworzona usługa w chmurze. Musisz określić elementy Location lub AffinityGroup, ale nie oba te elementy. Aby wyświetlić dostępne lokalizacje, możesz użyć lokalizacji listy.
Grupa koligacji	Wymagane, jeśli Location nie zostanie określony. Określa nazwę istniejącej grupy koligacji skojarzonej z subskrypcją. Musisz określić elementy Location lub AffinityGroup, ale nie oba te elementy. Aby wyświetlić dostępne grupy koligacji, możesz użyć grup koligacji listy.
Nazwa	Opcjonalny. Określa nazwę rozszerzonej właściwości usługi w chmurze. Nazwa może mieć długość maksymalnie 64 znaków, tylko znaki alfanumeryczne i podkreślenia są prawidłowe w nazwie i muszą zaczynać się literą. Każda właściwość rozszerzona musi mieć zarówno zdefiniowaną nazwę, jak i wartość. Można zdefiniować maksymalnie 50 właściwości rozszerzonych. Element Name jest dostępny tylko w wersji 2012-03-01 lub nowszej.
Wartość	Opcjonalny. Określa wartość rozszerzonej właściwości usługi w chmurze. Wartość właściwości rozszerzonej może mieć długość do 255 znaków. Element Value jest dostępny tylko w wersji 2012-03-01 lub nowszej.
ReverseDnsFqdn	Opcjonalny. Określa adres DNS, do którego adres IP usługi w chmurze jest rozpoznawany podczas wykonywania zapytań przy użyciu odwrotnego zapytania DNS. Element ReverseDnsFqdn jest dostępny tylko w wersji 2014-06-01 lub nowszej.

Reakcja

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.

Kod stanu

Pomyślna operacja zwraca kod stanu 201 (Utworzony).

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP.

Nagłówek odpowiedzi	Opis
x-ms-request-id	Wartość, która jednoznacznie identyfikuje żądanie skierowane do usługi zarządzania. W przypadku operacji asynchronicznej można wywołać metodę Get Operation Status z wartością nagłówka, aby określić, czy operacja została ukończona, zakończyła się niepowodzeniem, czy nadal jest w toku.

Treść odpowiedzi

Brak.