Udostępnij za pośrednictwem

Tworzenie usługi w chmurze

  • Artykuł

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.