匯出 (0) 列印
全部展開

列出作業系統映像

更新日期: 2014年4月

List OS Images 作業會從映像儲存機制中擷取作業系統映像的清單。

List OS Images 要求的指定方式如下。請以您的訂用帳戶 ID 取代 <subscription-id>

 

方法 要求 URI HTTP 版本

GET

https://management.core.windows.net/<subscription-id>/services/images

HTTP/1.1

無。

下表描述要求標頭。

 

要求標頭 說明

x-ms-version

必要項。指定用於這個要求的作業版本。此標頭目前應設為 2013-03-01

無。

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

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

如需狀態碼的資訊,請參閱<服務管理狀態和錯誤碼>。

這項作業的回應包括下列標頭。回應也可能包括其他標準 HTTP 標頭。所有標準標頭都符合 HTTP/1.1 通訊協定規格

 

回應標頭 說明

x-ms-request-id

唯一識別對管理服務發出之要求的值。若為非同步作業,您可以使用標頭的值來呼叫 Get Operation Status,以便判斷作業已完成、失敗,還是仍在進行中。如需詳細資訊,請參閱<追蹤非同步服務管理要求>。

回應主體的格式如下:

  
<Images xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <OSImage>
    <AffinityGroup>name-of-the-affinity-group</AffinityGroup>
    <Category>category-of-the-image</Category>
    <Label>image-description</Label>
    <Location>geo-location-of-the-stored-image</Location>
    <LogicalSizeInGB>size-of-the-image</LogicalSizeInGB>
    <MediaLink>url-of-the-containing-blob</MediaLink>
    <Name>image-name</Name>
    <OS>operating-system-of-the-image</OS>
    <Eula>image-eula</Eula>
    <Description>image-description</Description>
    <ImageFamily>image-family</ImageFamily>
    <ShowInGui>true|false</ShowInGui>
    <PublishedDate>published-date</PublishedDate>
    <IsPremium>true|false</IsPremium>
    <PrivacyUri>uri-of-privacy-policy</PrivacyUri>
    <RecommendedVMSize>size-of-the-virtual-machine</RecommendedVMSize>
    <PublisherName>publisher-identifier</PublisherName>
    <PricingDetailLink>pricing-details</PricingDetailLink>
    <SmallIconUri>uri-of-icon</SmallIconUri>
    <Language>language-of-image</Language>
  </OSImage>
  …
</Images>

下表描述回應主體的重要元素:

 

元素名稱 說明

AffinityGroup

媒體所在的同質群組。AffinityGroup 值是衍生自包含媒體所在之 Blob 的儲存體帳戶。如果儲存體帳戶不屬於同質群組,其值就是 NULL 而且此元素不會顯示在回應中。

若為平台映像,這個值也是 NULL

Category

映像的儲存機制分類。所有使用者映像的類別都是 User。如果版本設定為 2013-10-01 或更高版本,則另有下列可能的值:

  • Public – 可供所有人使用的平台映像。

  • Private – 僅供私用的平台映像。

  • MSDN - 由 MSDN 供予使用的平台映像。

Label

映像的識別碼。

位置

這個媒體所在的地理位置。Location 值是衍生自包含媒體所在之 Blob 的儲存體帳戶。如果儲存體帳戶屬於同質群組,此值為 NULL

如果版本設定為 2012-08-01 或更新版本,就會傳回平台映像的位置。否則,這個值就是 NULL (若為平台映像)。

LogicalSizeInGB

映像的大小 (以 GB 為單位)。

MediaLink

Blob 在 Windows Azure 儲存體中的位置。Blob 位置屬於作業呼叫中 <subscription-id> 值所指定之訂用帳戶的儲存體帳戶。

範例:

http://example.blob.core.windows.net/disks/myimage.vhd

Name

作業系統映像的名稱。這是使用映像來建立一個或多個虛擬機器時所用的名稱。

作業系統

映像的作業系統類型。

可能的值為:

  • Linux

  • Windows

Eula

指定與映像相關聯的使用者授權合約。此元素的值是字串,但是建議將其值設定為指向 EULA 的 URL。

說明

指定映像的描述。

ImageFamily

指定可用來分組映像的值。

PublishedDate

指定映像加入至映像儲存機制的日期。

IsPremium

指出映像是否包含會致使其費用高於虛擬機器核心價格的軟體或相關服務。如需其他詳細資訊,請參閱 PricingDetailLink 元素。

PrivacyUri

指定包含映像之相關隱私權原則的文件 URI。

RecommendedVMSize

指定要針對從映像建立之虛擬機器使用的大小。

PublisherName

映像的發行者名稱。所有使用者映像的發行者名稱都是 User

PricingDetailLink

針對 IsPremium 設定為 true 的映像指定 URL,其中包含從映像建立之虛擬機器的定價詳細資料。

必須使用 2012-12-01 版或更高版本,才能使用 PricingDetailLink 元素。

SmallIconUri

指定在 Windows Azure 管理入口網站中呈現映像時顯示之小圖示的 URI。

必須使用 2013-03-01 版或更高版本,才能使用 SmallIconUri 元素。

語言

指定映像的語言。

必須使用 2013-03-01 版或更高版本,才能使用 Language 元素。

只有帳戶擁有者可呼叫這項作業。

顯示:
© 2014 Microsoft