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

Marketplaces - List For Billing Period By Department

按计费周期和 departmentId 列出范围的市场。 市场仅适用于 2014 年 5 月 1 日或更高版本的此 API。

GET https://management.azure.com/providers/Microsoft.Billing/departments/{departmentId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/marketplaces?api-version=2018-10-01
GET https://management.azure.com/providers/Microsoft.Billing/departments/{departmentId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/marketplaces?$filter={$filter}&$top={$top}&$skiptoken={$skiptoken}&api-version=2018-10-01

URI 参数

名称 必需 类型 说明
billingPeriodName
path True

string

计费周期名称。

departmentId
path True

string

部门 ID

api-version
query True

string

要用于客户端请求的 API 的版本。 当前版本为 2018-10-01。

$filter
query

string

可用于按 properties/usageEnd(Utc 时间)、properties/usageStart (Utc 时间)、properties/resourceGroup、properties/instanceName 或 properties/instanceId 筛选市场。 该筛选器支持“eq”、“lt”、“gt”、“le”、“ge”和“and”。 它当前不支持“ne”、“or”或“not”。

$skiptoken
query

string

仅当以前的作返回了部分结果时,才使用 Skiptoken。 如果以前的响应包含 nextLink 元素,则 nextLink 元素的值将包含一个 skiptoken 参数,该参数指定用于后续调用的起点。

$top
query

integer

minimum: 1
maximum: 1000

可用于将结果数限制为最新的 N 市场。

响应

名称 类型 说明
200 OK

MarketplacesListResult

还行。 请求已成功。

Other Status Codes

ErrorResponse

描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

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

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

MarketplacesListForBillingPeriod

示例请求

GET https://management.azure.com/providers/Microsoft.Billing/departments/123456/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/marketplaces?api-version=2018-10-01

示例响应

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/departments/123456/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/marketplaces/marketplaceId1",
      "name": "marketplacesId1",
      "type": "Microsoft.Consumption/marketPlaces",
      "tags": {
        "env": "newcrp",
        "dev": "tools"
      },
      "properties": {
        "accountName": "Account1",
        "additionalProperties": "additionalProperties",
        "costCenter": "Center1",
        "departmentName": "Department1",
        "billingPeriodId": "/providers/Microsoft.Billing/departments/123456/providers/Microsoft.Billing/billingPeriods/201702",
        "usageStart": "2017-02-13T00:00:00Z",
        "usageEnd": "2017-02-13T23:59:59Z",
        "instanceName": "shared1",
        "instanceId": "/subscriptions/subid/resourceGroups/Default-Web-eastasia/providers/Microsoft.Web/sites/shared1",
        "currency": "USD",
        "consumedQuantity": 0.00328,
        "pretaxCost": 0.67,
        "isEstimated": false,
        "meterId": "00000000-0000-0000-0000-000000000000",
        "offerName": "offer1",
        "resourceGroup": "TEST",
        "orderNumber": "00000000-0000-0000-0000-000000000000",
        "publisherName": "xyz",
        "planName": "plan2",
        "resourceRate": 0.24,
        "subscriptionGuid": "00000000-0000-0000-0000-000000000000",
        "subscriptionName": "azure subscription",
        "unitOfMeasure": "10 Hours",
        "isRecurringCharge": false
      }
    }
  ]
}

定义

名称 说明
ErrorDetails

错误的详细信息。

ErrorResponse

错误响应指示服务无法处理传入请求。 错误消息中提供了原因。

Marketplace

市场资源。

MarketplacesListResult

列出市场的结果。 它包含按计费周期按时间顺序排列的可用市场列表。

ErrorDetails

错误的详细信息。

名称 类型 说明
code

string

错误代码。

message

string

指示操作失败的原因的错误消息。

ErrorResponse

错误响应指示服务无法处理传入请求。 错误消息中提供了原因。

名称 类型 说明
error

ErrorDetails

错误的详细信息。

Marketplace

市场资源。

名称 类型 说明
id

string

资源 ID。

name

string

资源名称。

properties.accountName

string

帐户名称。

properties.additionalProperties

string

此使用项的其他详细信息。 默认情况下,除非在$expand中指定,否则不会填充它。

properties.billingPeriodId

string

使用情况所属的计费周期资源的 ID。

properties.consumedQuantity

number (decimal)

使用情况数量。

properties.consumedService

string

已使用的服务名称。

properties.costCenter

string

如果此部门是部门且存在成本中心,则此部门的成本中心

properties.currency

string

计量费用的 ISO 货币,例如美元。

properties.departmentName

string

部门名称。

properties.instanceId

string

使用情况所要介绍的资源实例的 URI。

properties.instanceName

string

使用情况所要介绍的资源实例的名称。

properties.isEstimated

boolean

估计使用量可能会更改。

properties.isRecurringCharge

boolean

指示这是否为定期费用的标志。

properties.meterId

string (uuid)

计量 ID (GUID)。

properties.offerName

string

产品/服务的类型。

properties.orderNumber

string

订单号。

properties.planName

string

计划的名称。

properties.pretaxCost

number (decimal)

税前的成本金额。

properties.publisherName

string

发布者的名称。

properties.resourceGroup

string

资源组的名称。

properties.resourceRate

number (decimal)

市场资源费率。

properties.subscriptionGuid

string (uuid)

订阅 guid。

properties.subscriptionName

string

订阅名称。

properties.unitOfMeasure

string

度量单位。

properties.usageEnd

string (date-time)

使用情况详细信息涵盖的日期时间范围的结束时间。

properties.usageStart

string (date-time)

使用情况详细信息涵盖的日期时间范围的开始日期。

tags

object

资源标记。

type

string

资源类型。

MarketplacesListResult

列出市场的结果。 它包含按计费周期按时间顺序排列的可用市场列表。

名称 类型 说明
nextLink

string

指向下一页结果的链接(url)。

value

Marketplace[]

市场列表。