Lista Cloud Services

Artikel
07/19/2023

Åtgärden List Cloud Services visar de molntjänster som är tillgängliga under den angivna prenumerationen.

Förfrågan

Begäran List Cloud Services kan anges på följande sätt. Ersätt <subscription-id> med ditt prenumerations-ID.

Metod	URI för förfrågan
GET	`https://management.core.windows.net/<subscription-id>/services/hostedservices`

URI-parametrar

Inga.

Rubriker för begäran

I följande tabell beskrivs begärandehuvudena.

Begärandehuvud	Description
`x-ms-version`	Krävs. Anger vilken version av åtgärden som ska användas för den här begäran. Det här huvudet ska vara inställt på `2009-10-01` eller högre.
`x-ms-continuation-token`	Valfritt. Anger en fortsättningstoken som gör att du kan hämta resten av svaret när det finns fler molntjänster att lista än vad som kan returneras under den tilldelade tiden. Värdet för denna token returneras i rubriken för ett tidigare svar och returneras endast om ytterligare molntjänster behöver anges.

Begärandetext

Inga.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext.

Statuskod

En lyckad åtgärd returnerar statuskod 200 (OK).

Svarsrubriker

Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden.

Svarshuvud	Description
`x-ms-request-id`	Anger ett värde som unikt identifierar en begäran som görs mot hanteringstjänsten.
`x-ms-continuation-token`	Anger en fortsättningstoken som gör att du kan hämta resten av svaret när det finns fler molntjänster att lista än vad som kan returneras under den tilldelade tiden. Om det finns ett stort antal molntjänster i prenumerationen kan inte alla visas i ett enda svar. Du kan använda token i den här rubriken i efterföljande åtgärdsbegäranden tills alla molntjänster returneras.

Svarstext

Formatet på svarstexten är följande:

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

I följande tabell beskrivs elementen i svarstexten.

Elementnamn	Beskrivning
URL	Anger den begärande-URI som används för att hämta information om molntjänsten.
ServiceName	Anger namnet på molntjänsten. Det här namnet är DNS-prefixnamnet och kan användas för att komma åt tjänsten. Om tjänstnamnet till exempel är MyService kan du komma åt tjänsten genom att anropa: http:// MyService.cloudapp.net
Description	Anger beskrivningen av molntjänsten. Elementet `Description` är endast tillgängligt med version 2012-03-01 eller senare.
AffinityGroup	Anger den tillhörighetsgrupp som den här molntjänsten är associerad med, om den finns. Om tjänsten är associerad med en tillhörighetsgrupp returneras inte elementet `Location` . Elementet `AffinityGroup` är endast tillgängligt med version 2012-03-01 eller senare.
Location	Anger molntjänstens geoplats i Azure, om tjänsten inte är associerad med en tillhörighetsgrupp. Om en plats anges returneras inte -elementet `AffinityGroup` . Elementet `Location` är endast tillgängligt med version 2012-03-01 eller senare.
Etikett	Anger den base-64-kodade identifieraren för molntjänsten. Den här identifieraren kan användas i spårningssyfte. Elementet `Label` är endast tillgängligt med version 2012-03-01 eller senare.
Status	Anger status för molntjänsten. Möjliga värden: - `Creating` - `Created` - `Deleting` - `Deleted` - `Changing` - `ResolvingDns` Elementet `Status` är endast tillgängligt med version 2012-03-01 eller senare.
Datumskapad	Anger det datum då molntjänsten skapades i formatet [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z. Datumet 2011-05-11T16:15:26Z är ett exempel som kan returneras av elementen `DateCreated` eller `DateLastModified` . Elementet `DateCreated` är endast tillgängligt med version 2012-03-01 eller senare.
DateLastModified	Anger det datum då molntjänsten senast uppdaterades, i formatet [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z. Datumet 2011-05-11T16:15:26Z är ett exempel som kan returneras av elementen `DateCreated` eller `DateLastModified` Elementet `DateLastModified` är endast tillgängligt med version 2012-03-01 eller senare.
Name	Anger namnet på en utökad molntjänstegenskap. Varje utökad egenskap måste ha både ett definierat namn och värde. Du kan definiera högst 50 utökade egenskaper. Elementet `Name` är endast tillgängligt med version 2012-03-01 eller senare.
Värde	Representerar värdet för en utökad molntjänstegenskap. Det utökade egenskapsvärdet kan vara upp till 255 tecken långt. Elementet `Value` är endast tillgängligt med version 2012-03-01 eller senare.
ReverseDnsFqdn	Valfritt. Anger den DNS-adress som molntjänstens IP-adress matchar vid frågor med hjälp av en omvänd DNS-fråga. Elementet `ReverseDnsFqdn` är endast tillgängligt med version 2014-06-01 eller senare.
DefaultWinRMCertificateThumbprint	Anger standardcertifikatet för en säker anslutning till WinRM. Om ett tumavtryck för certifikat inte anges för WinRM när en virtuell dator distribueras i en molntjänst skapas ett certifikat automatiskt och tumavtrycket visas som värdet för det här elementet. Mer information om hur du definierar WinRM finns i Skapa distribution av virtuella datorer eller Lägg till roll.
ComputeCapabilities	Anger de rollstorlekar som är tillgängliga för distributioner i molntjänsten. De tillgängliga rollstorlekarna definieras av de resurser som stöds av molntjänsten. Distributioner av webbroller och arbetsroller kan till exempel ha andra storlekar än distributioner av Virtual Machines. Elementet `ComputeCapabilities` är endast tillgängligt med version 2014-05-01 eller senare.

ComputeCapabilities

Anger de rollstorlekar som är tillgängliga för distributioner i molntjänsten.

Elementnamn	Beskrivning
VirtualMachineRoleSizes	Innehåller en samling RoleSize-element.
WebWorkerRoleSizes	Innehåller en samling RoleSize-element.
RoleSize	Anger den rollstorlek som är tillgänglig för typen av distribution.

Kommentarer

x-ms-version Om är äldre än 2012-03-01 returneras inte molntjänster som innehåller distributioner av virtuella datorer.

Du kan se de molntjänster som finns i din prenumeration genom att titta i avsnittet Cloud Services i hanteringsportalen. Du kan också hämta en lista över molntjänster med hjälp av cmdleten Get-AzureService .

Dela via