列出雲端服務

List Cloud Services 作業會列出指定的訂閱底下可用的雲端服務。

要求

請使用下列格式指定 List Cloud Services 要求。使用您的訂用帳戶 ID 來取代 <subscription-id> 。

方法	要求 URI
GET	`https://management.core.windows.net/<subscription-id>/services/hostedservices`

URI 參數

無。

要求標頭

下表描述要求標頭。

要求標頭	描述
`x-ms-version`	必要。指定用於這個要求的作業版本。此標頭應設定為 `2009-10-01` 或更新版本。
`x-ms-continuation-token`	選擇性。指定當要列出的雲端服務比分配時間內能傳回的數目還多時，可讓您取得回應之剩餘部分的接續 Token。此 Token 的值是在前一個回應標頭中傳回，且只有在需要列出其他雲端服務時才會傳回。

要求本文

無。

回應

回應包括 HTTP 狀態碼、一組回應標頭和回應主體。

狀態碼

成功的作業會傳回狀態碼 200 (OK)。

回應標頭

這項作業的回應包括下列標頭。回應也可能包括其他標準 HTTP 標頭。

回應標頭	Description
`x-ms-request-id`	指定唯一識別對管理服務發出之要求的值。
`x-ms-continuation-token`	指定當要列出的雲端服務比分配時間內能傳回的數目還多時，可讓您取得回應之剩餘部分的接續 Token。如果訂閱中存在大量雲端服務，則無法在單一回應中列出所有雲端服務。您可以在後續作業要求中，於此標頭中使用 Token，直到傳回所有雲端服務為止。

回應本文

回應主體的格式如下：

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

下表描述回應本文的元素。

元素名稱	描述
Url	指定用來取得雲端服務相關資訊的要求 URI。
ServiceName	指定雲端服務的名稱。這個名稱是 DNS 首碼名稱，可用來存取服務。例如，如果服務名稱是 MyService，您就可以透過呼叫 http://MyService.cloudapp.net，存取服務。
Description	指定雲端服務的描述。只在使用 01.03.12 版或更高版本，才能使用 `Description` 元素。
AffinityGroup	指定與這個雲端服務相關聯的同質群組 (如果有的話)。如果服務與同質群組相關聯，就不會傳回 `Location` 元素。只在使用 01.03.12 版或更高版本，才能使用 `AffinityGroup` 元素。
位置	指定當 Azure 中的雲端服務未與任何同質群組相關聯時，該服務的地理位置。如果指定位置，就不會傳回 `AffinityGroup` 元素。只在使用 01.03.12 版或更高版本，才能使用 `Location` 元素。
標籤	指定雲端服務的 Base-64 編碼識別項。此識別項可讓您用來進行追蹤。只在使用 01.03.12 版或更高版本，才能使用 `Label` 元素。
狀態	指定雲端服務的狀態。可能的值包括： - `Creating` - `Created` - `Deleting` - `Deleted` - `Changing` - `ResolvingDns` 只在使用 01.03.12 版或更高版本，才能使用 `Status` 元素。
DateCreated	指定雲端服務的建立日期，格式為 [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z。 2011-05-11T16:15:26Z 日期是 `DateCreated` 或 `DateLastModified` 元素可能會傳回的範例。只在使用 01.03.12 版或更高版本，才能使用 `DateCreated` 元素。
DateLastModified	指定雲端服務的上次更新日期，格式為 [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z。 2011-05-11T16:15:26Z 日期是 `DateCreated` 或 `DateLastModified` 元素可能會傳回的範例只在使用 01.03.12 版或更高版本，才能使用 `DateLastModified` 元素。
名稱	指定雲端服務擴充屬性的名稱。每個擴充屬性都必須具有已定義的名稱和值。您最多可以定義 50 個擴充屬性。只在使用 01.03.12 版或更高版本，才能使用 `Name` 元素。
值	代表擴充雲端服務屬性的值。擴充屬性值的長度最多可達 255 個字元。只在使用 01.03.12 版或更高版本，才能使用 `Value` 元素。
ReverseDnsFqdn	選擇性。指定在使用反向 DNS 進行查詢時，雲端服務的 IP 位址所解析成的 DNS 位址。元素 `ReverseDnsFqdn` 只能使用版本 2014-06-01 或更高版本。
DefaultWinRMCertificateThumbprint	指定與 WinRM 進行安全連接的預設憑證。如果部署虛擬機器至雲端服務時未針對 WinRM 指定憑證指紋，便會自動建立憑證並將其憑證指紋列為這個元素的值。如需定義 WinRM 的詳細資訊，請參閱建立虛擬機器部署或新增角色。
ComputeCapabilities	指定可供雲端服務中的部署使用的角色大小。可用的角色大小是由雲端服務支援的資源所定義。例如，Web 角色和背景工作角色的部署可用的大小，可能與虛擬機器的部署有所不同。必須使用 01.05.14 版或更高版本，才能使用 `ComputeCapabilities` 元素。

ComputeCapabilities

指定可供雲端服務中的部署使用的角色大小。

元素名稱	Description
VirtualMachineRoleSizes	包含 RoleSize 元素的集合。
WebWorkerRoleSizes	包含 RoleSize 元素的集合。
RoleSize	指定可供部署類型使用的角色大小。

備註

如果 x-ms-version 比 2012-03-01 還舊，就不會傳回包含虛擬機器部署的雲端服務。

您可以藉由查看管理入口網站的 [雲端服務] 區段，檢視您的訂閱中現存的雲端服務。您也可以使用 Get-AzureService Cmdlet 來取得雲端服務清單。

Last updated on 2023-07-19