Lista Cloud Services

A List Cloud Services művelet felsorolja a megadott előfizetés alatt elérhető felhőszolgáltatásokat.

Kérés

A List Cloud Services kérés a következőképpen adható meg. Cserélje le a elemet <subscription-id> az előfizetés-azonosítóra.

Metódus	Kérés URI-ja
GET	https://management.core.windows.net/<subscription-id>/services/hostedservices

URI-paraméterek

Nincsenek.

Kérelemfejlécek

Az alábbi táblázat a kérelemfejléceket ismerteti.

Kérelem fejléce	Description
x-ms-version	Kötelező. A kérelemhez használni kívánt művelet verzióját adja meg. Ezt a fejlécet vagy annál magasabbra 2009-10-01 kell állítani.
x-ms-continuation-token	Választható. Olyan folytatási jogkivonatot ad meg, amely lehetővé teszi a válasz fennmaradó részét, ha több felhőszolgáltatást szeretne listázni, mint amennyit a kiosztott időpontban vissza lehet adni. Ennek a jogkivonatnak az értéke egy korábbi válasz fejlécében lesz visszaadva, és csak akkor lesz visszaadva, ha további felhőszolgáltatásokat kell felsorolni.

Kérelem törzse

Nincsenek.

Reagálás

A válasz tartalmaz egy HTTP-állapotkódot, egy válaszfejléceket és egy választörzset.

Állapotkód

A sikeres művelet a 200-ra (OK) vonatkozó állapotkódot adja vissza.

Válaszfejlécek

A műveletre adott válasz a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmazhat.

Válaszfejléc	Description
x-ms-request-id	Olyan értéket ad meg, amely egyedileg azonosítja a felügyeleti szolgáltatásra irányuló kéréseket.
x-ms-continuation-token	Olyan folytatási jogkivonatot ad meg, amely lehetővé teszi a válasz fennmaradó részét, ha több felhőszolgáltatást szeretne listázni, mint amennyit a kiosztott időpontban vissza lehet adni. Ha az előfizetésben nagyszámú felhőszolgáltatás található, nem mindegyik szerepelhet egyetlen válaszban. Az ebben a fejlécben található jogkivonatot a későbbi műveletkérésekben használhatja, amíg az összes felhőszolgáltatás vissza nem tér.

Válasz törzse

A válasz törzsének formátuma a következő:

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

Az alábbi táblázat a válasz törzsének elemeit ismerteti.

Elem neve	Leírás
URL-cím	Megadja a felhőszolgáltatással kapcsolatos információk beszerzéséhez használt kérelem URI-jának megadását.
ServiceName	Megadja a felhőszolgáltatás nevét. Ez a név a DNS-előtag neve, és a szolgáltatás eléréséhez használható. Ha például a szolgáltatás neve MyService, a következő hívással érheti el a szolgáltatást: http:// MyService.cloudapp.net
Description	A felhőszolgáltatás leírását adja meg. Az Description elem csak a 2012-03-01-es vagy újabb verzióval érhető el.
AffinityGroup	Meghatározza azt az affinitási csoportot, amelyhez ez a felhőszolgáltatás társítva van, ha van ilyen. Ha a szolgáltatás affinitási csoporthoz van társítva, a függvény nem adja vissza az Location elemet. Az AffinityGroup elem csak a 2012-03-01-es vagy újabb verzióval érhető el.
Hely	Megadja a felhőszolgáltatás földrajzi helyét az Azure-ban, ha a szolgáltatás nincs affinitási csoporthoz társítva. Ha meg van adva hely, a rendszer nem adja vissza az AffinityGroup elemet. Az Location elem csak a 2012-03-01-es vagy újabb verzióval érhető el.
Címke	Megadja a felhőszolgáltatás base-64 kódolású azonosítóját. Ez az azonosító használható nyomon követési célokra. Az Label elem csak a 2012-03-01-es vagy újabb verzióval érhető el.
Állapot	Megadja a felhőszolgáltatás állapotát. Lehetséges értékek: - Creating - Created - Deleting - Deleted - Changing - ResolvingDns Az Status elem csak a 2012-03-01-es vagy újabb verzióval érhető el.
DateCreated	Megadja a felhőszolgáltatás létrehozásának dátumát a következő formátumban: [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z formátumban. A 2011-05-11T16:15:26Z dátum egy példa, amelyet az vagy DateLastModified az DateCreated elemek visszaadhatnak. Az DateCreated elem csak a 2012-03-01-es vagy újabb verzióval érhető el.
DateLastModified	A felhőszolgáltatás utolsó frissítésének dátumát adja meg [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z formátumban. A 2011-05-11T16:15:26Z dátum egy példa, amelyet a vagy DateLastModified az DateCreated elemek visszaadhatnak Az DateLastModified elem csak a 2012-03-01-es vagy újabb verzióval érhető el.
Name	Egy kiterjesztett felhőszolgáltatás-tulajdonság nevét adja meg. Minden kiterjesztett tulajdonságnak definiált névvel és értékkel kell rendelkeznie. Legfeljebb 50 kiterjesztett tulajdonságot definiálhat. Az Name elem csak a 2012-03-01-es vagy újabb verzióval érhető el.
Érték	Egy kiterjesztett felhőszolgáltatás-tulajdonság értékét jelöli. A kiterjesztett tulajdonság értéke legfeljebb 255 karakter hosszú lehet. Az Value elem csak a 2012-03-01-es vagy újabb verzióval érhető el.
ReverseDnsFqdn	Választható. Megadja azt a DNS-címet, amelyre a felhőszolgáltatás IP-címe feloldható, ha fordított DNS-lekérdezéssel kérdezik le. Az ReverseDnsFqdn elem csak a 2014-06-01-es vagy újabb verzióval érhető el.
DefaultWinRMCertificateThumbprint	Megadja a WinRM-vel létesített biztonságos kapcsolat alapértelmezett tanúsítványát. Ha a WinRM-hez nem ad meg tanúsítvány-ujjlenyomatot, amikor virtuális gépet helyez üzembe egy felhőszolgáltatásban, a rendszer automatikusan létrehoz egy tanúsítványt, és ennek az elemnek az értékeként szerepel az ujjlenyomat. A WinRM definiálásáról további információt a Virtuális gépek üzembe helyezésének létrehozása vagy a Szerepkör hozzáadása című témakörben talál.
ComputeCapabilities	Meghatározza a felhőszolgáltatásban üzemelő példányokhoz elérhető szerepkörméreteket. Az elérhető szerepkörméreteket a felhőszolgáltatás által támogatott erőforrások határozzák meg. A webes szerepkörök és a feldolgozói szerepkörök üzembe helyezései például eltérő méretűek lehetnek, mint a Virtual Machines üzemelő példányai. Az ComputeCapabilities elem csak a 2014-05-01-es vagy újabb verzióval érhető el.

ComputeCapabilities

Meghatározza a felhőszolgáltatásban üzemelő példányokhoz elérhető szerepkörméreteket.

Elem neve	Leírás
VirtualMachineRoleSizes	A RoleSize elemek gyűjteményét tartalmazza.
WebWorkerRoleSizes	A RoleSize elemek gyűjteményét tartalmazza.
RoleSize	Megadja az üzembe helyezés típusához elérhető szerepkörméretet.

Megjegyzések

Ha a x-ms-version régebbi, mint 2012-03-01, a virtuális gépek üzembe helyezését tartalmazó felhőszolgáltatások nem lesznek visszaadva.

Az előfizetésében meglévő felhőszolgáltatásokat a felügyeleti portál Cloud Services szakaszában tekintheti meg. A felhőszolgáltatások listáját a Get-AzureService parancsmaggal is lekérheti.