导出 (0) 打印
全部展开

列出操作系统映像

更新时间: 2014年4月

List OS Images 操作从映像存储库中检索操作系统映像的列表。

按如下所示指定 List OS Images 请求。请将 <subscription-id> 替换为您的订阅 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

介质所在的地缘组。从介质所在的 blob 所属的存储帐户派生 AffinityGroup 值。如果存储帐户不属于某一地缘组,则该值为 NULL,并且在响应中不显示该元素。

对于平台映像,该值为 NULL

Category

映像的存储库分类。所有用户映像都具有类别 User。如果版本设置为 2013-10-01 或更高,则下列值也可取:

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

  • Private – 个人专用的平台映像。

  • MSDN - 可通过 MSDN 使用的平台映像。

Label

映像的标识符。

Location

此介质所在的地理位置。从介质所在的 blob 所属的存储帐户派生 Location 值。如果该存储帐户属于某个地缘组,则该值为 NULL

如果版本设置为 2012-08-01 或更高版本,则为平台映像返回位置;否则,对于平台映像,该值为 NULL

LogicalSizeInGB

以 GB 为单位的映像大小。

MediaLink

Windows Azure 存储中 blob 的位置。blob 位置属于操作调用中 <subscription-id> 值所指定的订阅中的某个存储帐户。

示例:

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

Name

操作系统映像的名称。在使用该映像创建一个或多个虚拟机时使用此名称。

OS

映像的操作系统类型。

可能的值有:

  • Linux

  • Windows

Eula

指定与映像相关联的最终用户许可协议。此元素的值是字符串,但建议该值为指向 EULA 的 URL。

Description

指定映像的说明。

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 元素。

Language

指定映像的语言。

仅在 2013-03-01 版或更高版本中才可以使用 Language 元素。

只有帐户所有者才可以调用此操作。

显示:
© 2014 Microsoft