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

Products - Download

参考

服务:: Azure Stack Admin

API 版本:: 2016-01-01

从 Azure 市场下载产品。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureBridge.Admin/activations/{activationName}/products/{productName}/download?api-version=2016-01-01

URI 参数

名称	在	必需	类型	说明
activationName	path	True	string	激活的名称。
productName	path	True	string	产品的名称。
resourceGroupName	path	True	string	资源所在的资源组。
subscriptionId	path	True	string	唯一标识 azure 订阅Microsoft的订阅凭据。订阅 ID 构成了每个服务调用的 URI 的一部分。
api-version	query	True	string	客户端 API 版本。

响应

名称	类型	说明
200 OK	DownloadedProductResource	接受
202 Accepted	DownloadedProductResource	接受
Other Status Codes	ExtendedErrorInfo	默认响应。

安全性

azure_auth

授权使用 Azure Active Directory OAuth2 流。

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

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Return product name.

示例请求

HTTP

POST https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/azurestack/providers/Microsoft.AzureBridge.Admin/activations/default/products/Canonical.UbuntuServer1710-ARM.1.0.6/download?api-version=2016-01-01

示例响应

状态代码:: 200

{
  "id": "/subscriptions/b6a34e73-810f-4564-881a-8434c6c2e5c8/resourceGroups/azurestack-activation/providers/Microsoft.AzureBridge.Admin/activations/default/downloadedProducts/Canonical.UbuntuServer1710-ARM.1.0.6",
  "name": "default/Canonical.UbuntuServer1710-ARM.1.0.6",
  "type": "Microsoft.AzureBridge.Admin/activations/downloadedProducts",
  "properties": {
    "displayName": "Ubuntu Server 17.10",
    "description": "Ubuntu Server 17.10 amd64 20180109 Public Azure, 20180109 Azure China, 20180109 Azure Germany. Ubuntu Server is the world's most popular Linux for cloud environments. Updates and patches for Ubuntu 17.10 will be available until July 2018.  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='http://partners.ubuntu.com/microsoft' 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>",
    "publisherDisplayName": "Canonical",
    "publisherIdentifier": "Canonical",
    "provisioningState": "Downloading",
    "offer": "UbuntuServer",
    "offerVersion": "1.0.6",
    "sku": "17.10",
    "billingPartNumber": "",
    "galleryItemIdentity": "Canonical.UbuntuServer1710-ARM.1.0.6",
    "iconUris": {
      "large": "https://azstmktprod001.azureedge.net/Canonical.UbuntuServer1710-ARM.1.0.6/icons/Large.png",
      "wide": "https://azstmktprod001.azureedge.net/Canonical.UbuntuServer1710-ARM.1.0.6/icons/Wide.png",
      "medium": "https://azstmktprod001.azureedge.net/Canonical.UbuntuServer1710-ARM.1.0.6/icons/Medium.png",
      "small": "https://azstmktprod001.azureedge.net/Canonical.UbuntuServer1710-ARM.1.0.6/icons/Small.png"
    },
    "links": [
      {
        "displayName": "Linux VM Documentation",
        "uri": "https://docs.microsoft.com/azure/virtual-machines/linux/"
      },
      {
        "displayName": "Ubuntu Documentation",
        "uri": "https://help.ubuntu.com/17.10/index.html"
      },
      {
        "displayName": "FAQ",
        "uri": "https://help.ubuntu.com/community/ServerFaq"
      },
      {
        "displayName": "Pricing details",
        "uri": "http://azure.microsoft.com/en-us/pricing/details/virtual-machines/#linux"
      }
    ],
    "legalTerms": "http://www.ubuntu.com/project/about-ubuntu/licensing",
    "privacyPolicy": "http://www.ubuntu.com/aboutus/privacypolicy",
    "payloadLength": 32212288186,
    "productKind": "VirtualMachine",
    "productProperties": {
      "version": "17.10.201801090"
    }
  }
}

状态代码:: 202

{
  "id": "/subscriptions/b6a34e73-810f-4564-881a-8434c6c2e5c8/resourceGroups/azurestack-activation/providers/Microsoft.AzureBridge.Admin/activations/default/downloadedProducts/Canonical.UbuntuServer1710-ARM.1.0.6",
  "name": "default/Canonical.UbuntuServer1710-ARM.1.0.6",
  "type": "Microsoft.AzureBridge.Admin/activations/downloadedProducts",
  "properties": {
    "displayName": "Ubuntu Server 17.10",
    "description": "Ubuntu Server 17.10 amd64 20180109 Public Azure, 20180109 Azure China, 20180109 Azure Germany. Ubuntu Server is the world's most popular Linux for cloud environments. Updates and patches for Ubuntu 17.10 will be available until July 2018.  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='http://partners.ubuntu.com/microsoft' 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>",
    "publisherDisplayName": "Canonical",
    "publisherIdentifier": "Canonical",
    "provisioningState": "Downloading",
    "offer": "UbuntuServer",
    "offerVersion": "1.0.6",
    "sku": "17.10",
    "billingPartNumber": "",
    "galleryItemIdentity": "Canonical.UbuntuServer1710-ARM.1.0.6",
    "iconUris": {
      "large": "https://azstmktprod001.azureedge.net/Canonical.UbuntuServer1710-ARM.1.0.6/icons/Large.png",
      "wide": "https://azstmktprod001.azureedge.net/Canonical.UbuntuServer1710-ARM.1.0.6/icons/Wide.png",
      "medium": "https://azstmktprod001.azureedge.net/Canonical.UbuntuServer1710-ARM.1.0.6/icons/Medium.png",
      "small": "https://azstmktprod001.azureedge.net/Canonical.UbuntuServer1710-ARM.1.0.6/icons/Small.png"
    },
    "links": [
      {
        "displayName": "Linux VM Documentation",
        "uri": "https://docs.microsoft.com/azure/virtual-machines/linux/"
      },
      {
        "displayName": "Ubuntu Documentation",
        "uri": "https://help.ubuntu.com/17.10/index.html"
      },
      {
        "displayName": "FAQ",
        "uri": "https://help.ubuntu.com/community/ServerFaq"
      },
      {
        "displayName": "Pricing details",
        "uri": "http://azure.microsoft.com/en-us/pricing/details/virtual-machines/#linux"
      }
    ],
    "legalTerms": "http://www.ubuntu.com/project/about-ubuntu/licensing",
    "privacyPolicy": "http://www.ubuntu.com/aboutus/privacypolicy",
    "payloadLength": 32212288186,
    "productKind": "VirtualMachine",
    "productProperties": {
      "version": "17.10.201801090"
    }
  }
}

定义

名称	说明
Compatibility	产品兼容性
CompatibilityIssue	兼容性问题
ComputeRole	计算角色类型（IaaS 或 PaaS）。
DataDiskImage	数据磁盘映像。
DownloadedProductResource	下载的产品资源。
ErrorDefinition	错误定义。
ExtendedErrorInfo	错误响应。
GalleryIcons	库项的图标。
OperatingSystem	作系统类型（Windows 或 Linux）。
OsDiskImage	OS 磁盘映像。
ProductLink	链接到产品。
ProductProperties	产品的其他属性
ProvisioningState	资源的预配状态。

Compatibility

Object

产品兼容性

名称	类型	说明
description	string	如果发现任何兼容性问题，则显示完整错误消息
isCompatible	boolean	告知产品是否与当前设备兼容
issues	CompatibilityIssue[]	找到的所有问题的列表
message	string	如果发现任何兼容性问题，则出现简短错误消息

CompatibilityIssue

枚举

兼容性问题

值	说明
ADFSIdentitySystemRequired
AzureADIdentitySystemRequired
CapacityBillingModelRequired
ConnectionToAzureRequired
ConnectionToInternetRequired
DevelopmentBillingModelRequired
DisconnectedEnvironmentRequired
HigherDeviceVersionRequired
LowerDeviceVersionRequired
PayAsYouGoBillingModelRequired

ComputeRole

枚举

计算角色类型（IaaS 或 PaaS）。

值	说明
IaaS
None
PaaS

DataDiskImage

Object

数据磁盘映像。

名称	类型	说明
lun	integer (int32)	LUN。
sourceBlobSasUri	string	源 Blob 的 SAS 密钥。

DownloadedProductResource

Object

下载的产品资源。

名称	类型	说明
id	string	资源的 URI。
location	string	资源的位置
name	string	资源的名称。
properties.billingPartNumber	string	计费部件号。
properties.compatibility	Compatibility	产品与当前设备的兼容性。
properties.description	string	产品的说明。
properties.displayName	string	为产品显示的名称。
properties.galleryItemIdentity	string	库项标识。
properties.galleryPackageBlobSasUri	string	.azpkg 文件的 URI，提供在库中显示产品所需的信息。
properties.iconUris	GalleryIcons	有关库图标的信息。
properties.legalTerms	string	产品的法律条款。
properties.links	ProductLink[]	库项标识。
properties.offer	string	产品/服务名称。
properties.offerVersion	string	产品/服务版本。
properties.payloadLength	integer (int64)	大小（以字节为单位）。
properties.privacyPolicy	string	产品的隐私策略。
properties.productDetailsProperties.computeRole	ComputeRole	指定包中包含的计算角色的类型。
properties.productDetailsProperties.dataDiskImages	DataDiskImage[]	附加的数据磁盘列表。
properties.productDetailsProperties.isSystemExtension	boolean	指定产品是否为虚拟机扩展。
properties.productDetailsProperties.osDiskImage	OsDiskImage	产品使用的 OS 磁盘映像。
properties.productDetailsProperties.sourceBlob.uri	string	URI。
properties.productDetailsProperties.supportMultipleExtensions	boolean	指示指定的产品是否支持多个扩展。
properties.productDetailsProperties.version	string	指定产品版本。
properties.productDetailsProperties.vmOsType	OperatingSystem	指定产品使用的作系统。
properties.productDetailsProperties.vmScaleSetEnabled	boolean	指示是否在指定的产品中启用了虚拟机规模集。
properties.productKind	string	类型。例如 VirtualMachineProductProperties.ProductKind 或 WebApp、SolutionTemplate。
properties.productProperties	ProductProperties	产品属性。目前只允许 VirtualMachineProductProperties。
properties.provisioningState	ProvisioningState	资源的预配状态。
properties.publisherDisplayName	string	发布者的名称。
properties.publisherIdentifier	string	发布者标识符。
properties.sku	string	产品 SKU。
properties.vmExtensionType	string	VM 的扩展类型。
tags	object	键值对列表。
type	string	资源类型。

ErrorDefinition

Object

错误定义。

名称	类型	说明
code	string	服务特定的错误代码，用作 HTTP 错误代码的子状态。
details	ErrorDefinition[]	内部错误详细信息。
message	string	错误说明。

ExtendedErrorInfo

Object

错误响应。

名称	类型	说明
error	ErrorDefinition	错误详细信息。

GalleryIcons

Object

库项的图标。

名称	类型	说明
hero	string	英雄（815x290）图标相对路径。
large	string	大（115x115）图标相对路径。
medium	string	中等（90x90）图标相对路径。
small	string	小（40x40）图标相对路径。
wide	string	宽（255x115）图标相对路径。

OperatingSystem

枚举

作系统类型（Windows 或 Linux）。

值	说明
Linux
None
Windows

OsDiskImage

Object

OS 磁盘映像。

名称	类型	说明
operatingSystem	OperatingSystem	OS作系统类型。
sourceBlobSasUri	string	源 Blob 的 SAS 密钥。

ProductLink

Object

链接到产品。

名称	类型	说明
displayName	string	显示的产品名称。
uri	string	产品 URI。

ProductProperties

Object

产品的其他属性

名称	类型	说明
version	string	产品的版本

ProvisioningState

枚举

资源的预配状态。

值	说明
Downloading
Running
Starting
Stopped
Stopping
Succeeded

通过

Products - Download

URI 参数

响应

安全性

azure_auth

作用域

示例

Return product name.

示例请求

示例响应

定义

Compatibility

CompatibilityIssue

ComputeRole

DataDiskImage

DownloadedProductResource

ErrorDefinition

ExtendedErrorInfo

GalleryIcons

OperatingSystem

OsDiskImage

ProductLink

ProductProperties

ProvisioningState