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

Views - Create Or Update By Scope

参考

服务:: Cost Management

API 版本:: 2024-08-01

用于创建或更新视图的操作。更新操作要求在请求中设置最新的 eTag。可以通过执行 get 操作来获取最新的 eTag。创建操作不需要 eTag。

PUT https://management.azure.com/{scope}/providers/Microsoft.CostManagement/views/{viewName}?api-version=2024-08-01

URI 参数

名称	在	必需	类型	说明
scope	path	True	string	与视图操作关联的范围。这包括订阅范围的“subscriptions/{subscriptionId}”、resourceGroup 范围的“subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}”、 “providers/Microsoft.Billing/billingAccounts/{billingAccountId}” for Billing Account scope， 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope， 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{EnrollmentAccount 范围的 enrollmentAccountId}，“providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}” for BillingProfile scope， “providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}” for InvoiceSection scope， 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope， 'providers/Microsoft.CostManagement/externalBillingAccounts/{外部计费帐户范围的 externalBillingAccountName}“和外部订阅范围的”providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}”。
viewName	path	True	string	视图名称
api-version	query	True	string	用于此操作的 API 版本。

请求正文

名称	必需	类型	说明
properties.query.timeframe	True	ReportTimeframeType	为报表拉取数据的时间范围。如果为自定义，则必须提供特定的时间段。
properties.query.type	True	ReportType	报表的类型。使用情况表示实际使用情况，预测表示预测数据，UsageAndForecast 表示使用情况和预测数据。根据日期，可以区分实际使用情况和预测数据。
eTag		string	资源的 eTag。若要处理并发更新方案，此字段将用于确定用户是否正在更新最新版本。
properties.accumulated		AccumulatedType	显示随时间累积的成本。
properties.chart		ChartType	成本分析中主视图的图表类型。必填。
properties.dateRange		string	当前视图的日期范围。
properties.displayName		string	视图的用户输入名称。必填。
properties.kpis		KpiProperties[]	要显示在成本分析 UI 中的 KPI 列表。
properties.metric		MetricType	显示成本时要使用的指标。
properties.modifiedOn		string	用户上次修改此视图的日期。
properties.pivots		PivotProperties[]	在成本分析 UI 中配置 3 个子视图。
properties.query.dataSet		ReportConfigDataset	具有此报表配置中的数据的定义。
properties.query.includeMonetaryCommitment		boolean	如果为 true，则报告包括货币承诺。
properties.query.timePeriod		ReportConfigTimePeriod	具有为报表拉取数据的时间段。
properties.scope		string	用于保存视图的成本管理范围。这包括订阅范围的“subscriptions/{subscriptionId}”、resourceGroup 范围的“subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}”、 “providers/Microsoft.Billing/billingAccounts/{billingAccountId}” for Billing Account scope， 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope， 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{EnrollmentAccount 范围的 enrollmentAccountId}，“providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}” for BillingProfile scope， “providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}” for InvoiceSection scope， 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope， '/providers/Microsoft.CostManagement/externalBillingAccounts/{ExternalBillingAccount 作用域的 externalBillingAccountName}，对于 ExternalSubscription 范围，“/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}”。

响应

名称	类型	说明
200 OK	View	还行。请求已成功。
201 Created	View	创建。
Other Status Codes	ErrorResponse	描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

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

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

ResourceGroupCreateOrUpdateView

示例请求

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/views/swaggerExample?api-version=2024-08-01

{
  "eTag": "\"1d4ff9fe66f1d10\"",
  "properties": {
    "displayName": "swagger Example",
    "query": {
      "type": "Usage",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "aggregation": {
          "totalCost": {
            "name": "PreTaxCost",
            "function": "Sum"
          }
        },
        "grouping": [],
        "sorting": [
          {
            "direction": "Ascending",
            "name": "UsageDate"
          }
        ]
      }
    },
    "chart": "Table",
    "accumulated": "true",
    "metric": "ActualCost",
    "kpis": [
      {
        "type": "Forecast",
        "id": null,
        "enabled": true
      },
      {
        "type": "Budget",
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Consumption/budgets/swaggerDemo",
        "enabled": true
      }
    ],
    "pivots": [
      {
        "type": "Dimension",
        "name": "ServiceName"
      },
      {
        "type": "Dimension",
        "name": "MeterCategory"
      },
      {
        "type": "TagKey",
        "name": "swaggerTagKey"
      }
    ]
  }
}

示例响应

状态代码:: 201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/views/swaggerExample",
  "name": "swaggerExample",
  "type": "Microsoft.CostManagement/Views",
  "eTag": "\"1d4ffa5a9c2430c\"",
  "properties": {
    "displayName": "swagger Example",
    "scope": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG",
    "query": {
      "type": "Usage",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "aggregation": {
          "totalCost": {
            "name": "PreTaxCost",
            "function": "Sum"
          }
        },
        "grouping": [],
        "sorting": [
          {
            "direction": "Ascending",
            "name": "UsageDate"
          }
        ]
      }
    },
    "chart": "Table",
    "accumulated": "true",
    "metric": "ActualCost",
    "kpis": [
      {
        "type": "Forecast",
        "id": null,
        "enabled": true
      },
      {
        "type": "Budget",
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Consumption/budgets/swaggerDemo",
        "enabled": true
      }
    ],
    "pivots": [
      {
        "type": "Dimension",
        "name": "ServiceName"
      },
      {
        "type": "Dimension",
        "name": "MeterCategory"
      },
      {
        "type": "TagKey",
        "name": "swaggerTagKey"
      }
    ]
  }
}

状态代码:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/views/swaggerExample",
  "name": "swaggerExample",
  "type": "Microsoft.CostManagement/Views",
  "eTag": "\"1d4ffa5a9c2430c\"",
  "properties": {
    "displayName": "swagger Example",
    "scope": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG",
    "query": {
      "type": "Usage",
      "timeframe": "MonthToDate",
      "dataSet": {
        "granularity": "Daily",
        "aggregation": {
          "totalCost": {
            "name": "PreTaxCost",
            "function": "Sum"
          }
        },
        "grouping": [],
        "sorting": [
          {
            "direction": "Ascending",
            "name": "UsageDate"
          }
        ]
      }
    },
    "chart": "Table",
    "accumulated": "true",
    "metric": "ActualCost",
    "kpis": [
      {
        "type": "Forecast",
        "id": null,
        "enabled": true
      },
      {
        "type": "Budget",
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Consumption/budgets/swaggerDemo",
        "enabled": true
      }
    ],
    "pivots": [
      {
        "type": "Dimension",
        "name": "ServiceName"
      },
      {
        "type": "Dimension",
        "name": "MeterCategory"
      },
      {
        "type": "TagKey",
        "name": "swaggerTagKey"
      }
    ]
  }
}

定义

名称	说明
AccumulatedType	显示随时间累积的成本。
ChartType	成本分析中主视图的图表类型。必填。
ErrorDetails	错误的详细信息。
ErrorResponse	错误响应指示服务无法处理传入请求。错误消息中提供了原因。一些错误响应： 429 TooManyRequests - 请求受到限制。等待“x-ms-ratelimit-microsoft.consumption-retry-after”标头中指定的时间后重试。 503 ServiceUnavailable - 服务暂时不可用。在等待“Retry-After”标头中指定的时间后重试。
FunctionType	要使用的聚合函数的名称。
KpiProperties	每个 KPI 必须包含“type”和“enabled”密钥。
KpiTypeType	KPI 类型（预测、预算）。
MetricType	显示成本时要使用的指标。
OperatorType	要用于比较的运算符。
PivotProperties	每个透视表必须包含一个“type”和“name”。
PivotTypeType	要显示在视图中的数据类型。
QueryColumnType	导出中的列的类型。
ReportConfigAggregation	要用于报表的聚合表达式。
ReportConfigComparisonExpression	要用于报表的比较表达式。
ReportConfigDataset	报表中存在的数据的定义。
ReportConfigDatasetConfiguration	报表中数据集的配置。
ReportConfigFilter	报表中使用的筛选器表达式。
ReportConfigGrouping	报表中使用的按表达式分组。
ReportConfigSorting	报表中使用的按表达式排序。
ReportConfigSortingType	排序方向。
ReportConfigTimePeriod	用于拉取报表数据的开始和结束日期。
ReportGranularityType	报表中行的粒度。
ReportTimeframeType	为报表拉取数据的时间范围。如果为自定义，则必须提供特定的时间段。
ReportType	报表的类型。使用情况表示实际使用情况，预测表示预测数据，UsageAndForecast 表示使用情况和预测数据。根据日期，可以区分实际使用情况和预测数据。
View	成本分析的状态和配置。

AccumulatedType

显示随时间累积的成本。

名称	类型	说明
false	string
true	string

ChartType

成本分析中主视图的图表类型。必填。

名称	类型	说明
Area	string
GroupedColumn	string
Line	string
StackedColumn	string
Table	string

ErrorDetails

错误的详细信息。

名称	类型	说明
code	string	错误代码。
message	string	指示操作失败的原因的错误消息。

ErrorResponse

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

一些错误响应：

429 TooManyRequests - 请求受到限制。等待“x-ms-ratelimit-microsoft.consumption-retry-after”标头中指定的时间后重试。
503 ServiceUnavailable - 服务暂时不可用。在等待“Retry-After”标头中指定的时间后重试。

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

FunctionType

要使用的聚合函数的名称。

名称	类型	说明
Sum	string

KpiProperties

每个 KPI 必须包含“type”和“enabled”密钥。

名称	类型	说明
enabled	boolean	在 UI 中显示 KPI？
id	string	与指标（预算）相关的资源的 ID。
type	KpiTypeType	KPI 类型（预测、预算）。

KpiTypeType

KPI 类型（预测、预算）。

名称	类型	说明
Budget	string
Forecast	string

MetricType

显示成本时要使用的指标。

名称	类型	说明
AHUB	string
ActualCost	string
AmortizedCost	string

OperatorType

要用于比较的运算符。

名称	类型	说明
Contains	string
In	string

PivotProperties

每个透视表必须包含一个“type”和“name”。

名称	类型	说明
name	string	要显示在视图中的数据字段。
type	PivotTypeType	要显示在视图中的数据类型。

PivotTypeType

要显示在视图中的数据类型。

名称	类型	说明
Dimension	string
TagKey	string

QueryColumnType

导出中的列的类型。

名称	类型	说明
Dimension	string	成本数据的维度。
TagKey	string	与成本数据关联的标记。

ReportConfigAggregation

要用于报表的聚合表达式。

名称	类型	说明
function	FunctionType	要使用的聚合函数的名称。
name	string	要聚合的列的名称。

ReportConfigComparisonExpression

要用于报表的比较表达式。

名称	类型	说明
name	string	要进行比较的列的名称。
operator	OperatorType	要用于比较的运算符。
values	string[]	要用于比较的值数组

ReportConfigDataset

报表中存在的数据的定义。

名称	类型	说明
aggregation	<string, ReportConfigAggregation>	报表中使用的聚合表达式字典。字典中每个项的键是聚合列的别名。报表最多可以包含 2 个聚合子句。
configuration	ReportConfigDatasetConfiguration	为报表中的数据提供配置信息。如果提供了聚合和分组，则会忽略配置。
filter	ReportConfigFilter	在报表中使用筛选器表达式。
granularity	ReportGranularityType	报表中行的粒度。
grouping	ReportConfigGrouping[]	要用于报表的按表达式分组的数组。报表最多可以包含 2 个分组依据子句。
sorting	ReportConfigSorting[]	按表达式在报表中使用的顺序数组。

ReportConfigDatasetConfiguration

报表中数据集的配置。

名称	类型	说明
columns	string[]	要包含在报表中的列名数组。允许任何有效的报表列名称。如果未提供，则报表包括所有列。

ReportConfigFilter

报表中使用的筛选器表达式。

名称	类型	说明
and	ReportConfigFilter[]	逻辑“AND”表达式。必须至少有 2 个项目。
dimensions	ReportConfigComparisonExpression	具有维度的比较表达式
or	ReportConfigFilter[]	逻辑“OR”表达式。必须至少有 2 个项目。
tags	ReportConfigComparisonExpression	具有标记的比较表达式

ReportConfigGrouping

报表中使用的按表达式分组。

名称	类型	说明
name	string	要分组的列的名称。此版本支持尽可能低的订阅粒度。
type	QueryColumnType	具有要分组的列的类型。

ReportConfigSorting

报表中使用的按表达式排序。

名称	类型	说明
direction	ReportConfigSortingType	排序方向。
name	string	要排序的列的名称。

ReportConfigSortingType

排序方向。

名称	类型	说明
Ascending	string
Descending	string

ReportConfigTimePeriod

用于拉取报表数据的开始和结束日期。

名称	类型	说明
from	string	要从中提取数据的开始日期。
to	string	要将数据拉取到的结束日期。

ReportGranularityType

报表中行的粒度。

名称	类型	说明
Daily	string
Monthly	string

ReportTimeframeType

为报表拉取数据的时间范围。如果为自定义，则必须提供特定的时间段。

名称	类型	说明
Custom	string
MonthToDate	string
WeekToDate	string
YearToDate	string

ReportType

报表的类型。使用情况表示实际使用情况，预测表示预测数据，UsageAndForecast 表示使用情况和预测数据。根据日期，可以区分实际使用情况和预测数据。

名称	类型	说明
Usage	string

View

成本分析的状态和配置。

名称	类型	说明
eTag	string	资源的 eTag。若要处理并发更新方案，此字段将用于确定用户是否正在更新最新版本。
id	string	资源 ID。
name	string	资源名称。
properties.accumulated	AccumulatedType	显示随时间累积的成本。
properties.chart	ChartType	成本分析中主视图的图表类型。必填。
properties.createdOn	string	用户创建此视图的日期。
properties.currency	string	当前视图的货币。
properties.dateRange	string	当前视图的日期范围。
properties.displayName	string	视图的用户输入名称。必填。
properties.kpis	KpiProperties[]	要显示在成本分析 UI 中的 KPI 列表。
properties.metric	MetricType	显示成本时要使用的指标。
properties.modifiedOn	string	用户上次修改此视图的日期。
properties.pivots	PivotProperties[]	在成本分析 UI 中配置 3 个子视图。
properties.query.dataSet	ReportConfigDataset	具有此报表配置中的数据的定义。
properties.query.includeMonetaryCommitment	boolean	如果为 true，则报告包括货币承诺。
properties.query.timePeriod	ReportConfigTimePeriod	具有为报表拉取数据的时间段。
properties.query.timeframe	ReportTimeframeType	为报表拉取数据的时间范围。如果为自定义，则必须提供特定的时间段。
properties.query.type	ReportType	报表的类型。使用情况表示实际使用情况，预测表示预测数据，UsageAndForecast 表示使用情况和预测数据。根据日期，可以区分实际使用情况和预测数据。
properties.scope	string	用于保存视图的成本管理范围。这包括订阅范围的“subscriptions/{subscriptionId}”、resourceGroup 范围的“subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}”、 “providers/Microsoft.Billing/billingAccounts/{billingAccountId}” for Billing Account scope， 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope， 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{EnrollmentAccount 范围的 enrollmentAccountId}，“providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}” for BillingProfile scope， “providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}” for InvoiceSection scope， 'providers/Microsoft.Management/managementGroups/{managementGroupId}' for Management Group scope， '/providers/Microsoft.CostManagement/externalBillingAccounts/{ExternalBillingAccount 作用域的 externalBillingAccountName}，对于 ExternalSubscription 范围，“/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}”。
type	string	资源类型。

通过