你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Gallery Images - List

列出给定实验室中的库映像。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/galleryimages?api-version=2018-09-15
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/galleryimages?$expand={$expand}&$filter={$filter}&$top={$top}&$orderby={$orderby}&api-version=2018-09-15

URI 参数

名称 必需 类型 说明
labName
path True

string

实验室的名称。

resourceGroupName
path True

string

资源组的名称。

subscriptionId
path True

string

订阅的 ID。

api-version
query True

string

客户端 API 版本。

$expand
query

string

指定$expand查询。 示例:“properties ($select=author) ”

$filter
query

string

要应用于操作的筛选器。 示例:'$filter=contains (name,'myName')

$orderby
query

string

结果的排序表达式,使用 OData 表示法。 示例:“$orderby=name desc”

$top
query

integer

int32

要从操作返回的最大资源数。 示例:“$top=10”

响应

名称 类型 说明
200 OK

GalleryImageList

确定

Other Status Codes

CloudError

BadRequest

安全性

azure_auth

OAuth2 隐式授权

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 访问 Microsoft Azure

示例

GalleryImages_List

示例请求

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/galleryimages?api-version=2018-09-15

示例响应

{
  "value": [
    {
      "properties": {
        "author": "Canonical",
        "createdDate": "2020-12-14T23:43:43.7643542+00:00",
        "description": "Ubuntu Server is the world's most popular Linux for cloud environments. Updates and patches for Ubuntu Server 20.04 LTS will be available until April 2025. Ubuntu Server is the perfect virtual machine (VM) platform for all workloads from web applications to NoSQL databases and Hadoop. For more information see <a href='https://ubuntu.com/azure' target='_blank'>Ubuntu on Azure</a> and <a href='http://juju.ubuntu.com' target='_blank'>using Juju to deploy your workloads</a>.<p><h3 class='msportalfx-text-header'>Legal Terms</h3></p><p>By clicking the Create button, I acknowledge that I am getting this software from Canonical and that the <a href='http://www.ubuntu.com/project/about-ubuntu/licensing' target='_blank'>legal terms</a> of Canonical apply to it. Microsoft does not provide rights for third-party software. Also see the <a href='http://www.ubuntu.com/aboutus/privacypolicy' target='_blank'>privacy statement</a> from Canonical.</p>",
        "imageReference": {
          "offer": "0001-com-ubuntu-server-focal",
          "publisher": "canonical",
          "sku": "20_04-lts",
          "osType": "Linux",
          "version": "latest"
        },
        "icon": "https://106c4.wpc.azureedge.net/80106C4/Gallery-Prod/cdn/2015-02-24/prod20161101-microsoft-windowsazure-gallery/canonical.0001-com-ubuntu-server-focal20_04-lts-ARM.1.0.22/Icons/Small.png",
        "enabled": true
      },
      "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/galleryimages/ubuntu server 20.04 lts",
      "name": "Ubuntu Server 20.04 LTS",
      "type": "Microsoft.DevTestLab/labs/galleryImages",
      "location": "{location}",
      "tags": {
        "tagName1": "tagValue1"
      }
    },
    {
      "properties": {
        "author": "Microsoft",
        "createdDate": "2020-12-14T21:33:33.2464999+00:00",
        "description": "<p>This software is provided by Microsoft. Use of this software in Microsoft Azure is not permitted except under a volume licensing agreement with Microsoft. By clicking Create, I acknowledge that I or the company I work for is licensed to use this software under a volume licensing agreement with Microsoft and that the right to use it will be subject to that agreement.</p> <p><h3 class='msportalfx-text-header'>Legal Terms</h3></p><p>By clicking the Create button, I acknowledge that I am getting this software from Microsoft and that the <a href='https://www.microsoft.com/en-us/Useterms/Retail/Windows/10/UseTerms_Retail_Windows_10_English.htm' target='_blank'>legal terms</a> of Microsoft apply to it. Microsoft does not provide rights for third-party software. Also see the <a href='https://go.microsoft.com/fwlink/?LinkId=529552' target='_blank'>privacy statement</a> from Microsoft.</p>",
        "imageReference": {
          "offer": "Windows-10",
          "publisher": "MicrosoftWindowsDesktop",
          "sku": "20h2-ent",
          "osType": "Windows",
          "version": "latest"
        },
        "icon": "https://106c4.wpc.azureedge.net/80106C4/Gallery-Prod/cdn/2015-02-24/prod20161101-microsoft-windowsazure-gallery/microsoftwindowsdesktop.windows-1020h2-ent.1.0.238/Icons/Small.png",
        "enabled": true
      },
      "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/galleryimages/windows 10 enterprise, version 20h2",
      "name": "Windows 10 Enterprise, Version 20H2",
      "type": "Microsoft.DevTestLab/labs/galleryImages",
      "location": "{location}",
      "tags": {
        "tagName1": "tagValue1"
      }
    }
  ]
}

定义

名称 说明
CloudError

REST 请求出错。

CloudErrorBody

来自 REST 请求的错误正文。

GalleryImage

库映像。

GalleryImageList

列表操作的响应。

GalleryImageReference

Azure 市场映像的参考信息。

CloudError

REST 请求出错。

名称 类型 说明
error

CloudErrorBody

发生的云错误

CloudErrorBody

来自 REST 请求的错误正文。

名称 类型 说明
code

string

错误代码。

details

CloudErrorBody[]

内部错误。

message

string

错误消息。

target

string

错误目标。

GalleryImage

库映像。

名称 类型 说明
id

string

资源的标识符。

location

string

资源的位置。

name

string

资源的名称。

properties.author

string

库映像的作者。

properties.createdDate

string

库映像的创建日期。

properties.description

string

库映像的说明。

properties.enabled

boolean

指示是否启用此库映像。

properties.icon

string

库映像的图标。

properties.imageReference

GalleryImageReference

库映像的图像引用。

properties.isPlanAuthorized

boolean

指示计划是否已获得编程部署的授权。

properties.planId

string

适用于此映像的第三方计划

tags

object

资源的标记。

type

string

资源类型。

GalleryImageList

列表操作的响应。

名称 类型 说明
nextLink

string

下一组结果的链接。

value

GalleryImage[]

列表操作的结果。

GalleryImageReference

Azure 市场映像的参考信息。

名称 类型 说明
offer

string

库映像的产品/服务。

osType

string

库映像的 OS 类型。

publisher

string

库映像的发布者。

sku

string

库映像的 SKU。

version

string

库映像的版本。