Wyświetlanie listy Cloud Services

Operacja List Cloud Services zawiera listę usług w chmurze, które są dostępne w ramach określonej subskrypcji.

Żądanie

Żądanie List Cloud Services można określić w następujący sposób. Zastąp ciąg <subscription-id> identyfikatorem subskrypcji.

Metoda	Identyfikator URI żądania
GET	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
x-ms-version	Wymagane. Określa wersję operacji do użycia dla tego żądania. Ten nagłówek powinien być ustawiony na 2009-10-01 lub wyższy.
x-ms-continuation-token	Opcjonalny. Określa token kontynuacji, który umożliwia uzyskanie pozostałej części odpowiedzi, gdy istnieje więcej usług w chmurze do wyświetlenia listy niż można zwrócić w przydzielonym czasie. Wartość tego tokenu jest zwracana w nagłówku poprzedniej odpowiedzi i zostanie zwrócona tylko wtedy, gdy trzeba wyświetlić dodatkowe usługi w chmurze.

Treść żądania

Brak.

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.

Kod stanu

Operacja zakończona powodzeniem zwraca kod stanu 200 (OK).

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	Określa wartość, która jednoznacznie identyfikuje żądanie wykonane względem usługi zarządzania.
x-ms-continuation-token	Określa token kontynuacji, który umożliwia uzyskanie pozostałej części odpowiedzi, gdy istnieje więcej usług w chmurze do wyświetlenia listy niż można zwrócić w przydzielonym czasie. Jeśli w subskrypcji istnieje duża liczba usług w chmurze, nie wszystkie z nich mogą być wymienione w jednej odpowiedzi. Token w tym nagłówku można użyć w kolejnych żądaniach operacji do momentu zwrócenia wszystkich usług w chmurze.

Treść odpowiedzi

Format treści odpowiedzi jest następujący:

  
<?xml version="1.0" encoding="utf-8"?>  
  <HostedServices xmlns=”http://schemas.microsoft.com/windowsazure”>  
    <HostedService>  
      <Url>address-of-cloud-service</Url>  
      <ServiceName>name-of-cloud-service</ServiceName>  
      <HostedServiceProperties>  
        <Description>description-of-cloud-service</Description>  
        <AffinityGroup>name-of-affinity-group</AffinityGroup>  
        <Location>location-of-cloud-service</Location>  
        <Label>label-of-cloud-service</Label>  
        <Status>status-of-cloud-service</Status>  
        <DateCreated>date-created</DateCreated>  
        <DateLastModified>date-modified</DateLastModified>  
        <ExtendedProperties>  
          <ExtendedProperty>  
            <Name>name-of-property-name</Name>  
            <Value>value-of-property</Value>  
          </ExtendedProperty>  
        </ExtendedProperties>  
        <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn>  
      </HostedServiceProperties>  
      <DefaultWinRMCertificateThumbprint>certificate-thumbprint-for-winrm</DefaultWinRMCertificateThumbprint>  
      <ComputeCapabilities>  
        <VirtualMachineRoleSizes>  
          <RoleSize>role-size-name</RoleSize>  
        </VirtualMachineRoleSizes>  
        <WebWorkerRoleSizes>  
          <RoleSize>role-size-name</RoleSize>  
        </WebWorkerRoleSizes>  
      </ComputeCapabilities>  
    </HostedService>  
  </HostedServices>  
  

W poniższej tabeli opisano elementy treści odpowiedzi.

Nazwa elementu	Opis
Url	Określa identyfikator URI żądania używany do uzyskiwania informacji o usłudze w chmurze.
ServiceName	Określa nazwę usługi w chmurze. Ta nazwa jest prefiksem DNS i może służyć do uzyskiwania dostępu do usługi. Jeśli na przykład nazwa usługi to MyService, możesz uzyskać dostęp do usługi, wywołując polecenie: http:// MyService.cloudapp.net
Opis	Określa opis usługi w chmurze. Element Description jest dostępny tylko w wersji 2012-03-01 lub nowszej.
Grupa koligacji	Określa grupę koligacji, z którą jest skojarzona ta usługa w chmurze, jeśli istnieje. Jeśli usługa jest skojarzona z grupą koligacji, Location element nie jest zwracany. Element AffinityGroup jest dostępny tylko w wersji 2012-03-01 lub nowszej.
Lokalizacja	Określa lokalizację geograficzną usługi w chmurze na platformie Azure, jeśli usługa nie jest skojarzona z grupą koligacji. Jeśli zostanie określona lokalizacja, AffinityGroup element nie zostanie zwrócony. Element Location jest dostępny tylko w wersji 2012-03-01 lub nowszej.
Etykieta	Określa identyfikator zakodowany w formacie base-64 usługi w chmurze. Ten identyfikator może być używany do celów śledzenia. Element Label jest dostępny tylko w wersji 2012-03-01 lub nowszej.
Stan	Określa stan usługi w chmurze. Możliwe wartości: - Creating - Created - Deleting - Deleted - Changing - ResolvingDns Element Status jest dostępny tylko w wersji 2012-03-01 lub nowszej.
Datecreated	Określa datę utworzenia usługi w chmurze w [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]]Z format. Data 2011-05-11T16:15:26Z jest przykładem, który może zostać zwrócony przez DateCreated elementy lub DateLastModified . Element DateCreated jest dostępny tylko w wersji 2012-03-01 lub nowszej.
DateLastModified	Określa datę ostatniej aktualizacji usługi w chmurze w [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]]Z format. Data 2011-05-11T16:15:26Z jest przykładem, który może zostać zwrócony przez DateCreated elementy lub DateLastModified Element DateLastModified jest dostępny tylko w wersji 2012-03-01 lub nowszej.
Nazwa	Określa nazwę rozszerzonej właściwości usługi w chmurze. Każda właściwość rozszerzona musi mieć zdefiniowaną nazwę 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ść	Reprezentuje 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.
DefaultWinRMCertificateThumbprint	Określa certyfikat domyślny dla bezpiecznego połączenia z usługą WinRM. Jeśli odcisk palca certyfikatu nie zostanie określony dla usługi WinRM po wdrożeniu maszyny wirtualnej w usłudze w chmurze, certyfikat zostanie automatycznie utworzony, a odcisk palca zostanie wyświetlony jako wartość tego elementu. Aby uzyskać więcej informacji na temat definiowania usługi WinRM, zobacz Tworzenie wdrożenia maszyny wirtualnej lub Dodawanie roli.
ObliczeniaCapabilities	Określa rozmiary ról, które są dostępne dla wdrożeń w usłudze w chmurze. Dostępne rozmiary ról są definiowane przez zasoby obsługiwane przez usługę w chmurze. Na przykład wdrożenia ról internetowych i ról procesów roboczych mogą mieć różne rozmiary niż wdrożenia Virtual Machines. Element ComputeCapabilities jest dostępny tylko w wersji 2014-05-01 lub nowszej.

ObliczeniaCapabilities

Określa rozmiary ról, które są dostępne dla wdrożeń w usłudze w chmurze.

Nazwa elementu	Opis
VirtualMachineRoleSizes	Zawiera kolekcję elementów RoleSize.
WebWorkerRoleSizes	Zawiera kolekcję elementów RoleSize.
RoleSize	Określa rozmiar roli dostępny dla typu wdrożenia.

Uwagi

Jeśli element x-ms-version jest starszy niż 2012-03-01, usługi w chmurze zawierające wdrożenia maszyn wirtualnych nie zostaną zwrócone.

Usługi w chmurze, które istnieją w ramach subskrypcji, można znaleźć w sekcji Cloud Services portalu zarządzania. Listę usług w chmurze można również uzyskać za pomocą polecenia cmdlet Get-AzureService .