Views - Create Or Update By Scope

보기를 만들거나 업데이트하는 작업입니다. 업데이트 작업을 수행하려면 요청에 최신 eTag를 설정해야 합니다. get 작업을 수행하여 최신 eTag를 얻을 수 있습니다. 만들기 작업에는 eTag가 필요하지 않습니다.

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

URI 매개 변수

Name In Required Type Description
scope
path True
  • string

보기 작업과 연결된 범위입니다. 여기에는 구독 범위에 대한 'subscriptions/{subscriptionId}', resourceGroup 범위의 경우 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'이 포함됩니다. 청구 계정 범위에 대한 'providers/Microsoft.Billing/billingAccountId}', 부서 범위의 경우 'providers/Microsoft.Billing/billingAccountId}/{billingAccountId}/{departmentId}', 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ EnrollmentAccount 범위에 대한 enrollmentAccountId}', BillingProfile 범위에 대한 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' InvoiceSection 범위의 경우 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}', 관리 그룹 범위의 경우 'providers/Microsoft.Management/managementGroups/{managementGroupId}', 'providers/Microsoft.CostManagement/externalBillingAccounts/{ externalBillingAccountName}' for External Billing Account scope and 'providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' for External Subscription scope.

viewName
path True
  • string

뷰 이름

api-version
query True
  • string

클라이언트 요청과 함께 사용할 API의 버전입니다.

요청 본문

Name Required Type Description
properties.query.timeframe True

보고서의 데이터를 끌어당기는 시간 프레임입니다. 사용자 지정하는 경우 특정 기간을 제공해야 합니다.

properties.query.type True

보고서의 형식입니다. 사용량은 실제 사용량을 나타내고 예측은 예측 데이터를 나타내고 UsageAndForecast는 사용량 및 예측 데이터를 모두 나타냅니다. 실제 사용량 및 예측 데이터는 날짜를 기준으로 구분할 수 있습니다.

eTag
  • string

리소스의 eTag입니다. 동시 업데이트 시나리오를 처리하기 위해 이 필드는 사용자가 최신 버전을 업데이트하는지 여부를 확인하는 데 사용됩니다.

properties.accumulated

시간이 지남에 따라 누적된 비용을 표시합니다.

properties.chart

비용 분석에서 기본 보기의 차트 유형입니다. 필수 요소.

properties.displayName
  • string

뷰의 사용자 입력 이름입니다. 필수 요소.

properties.kpis

비용 분석 UI에 표시할 KPI 목록입니다.

properties.metric

비용을 표시할 때 사용할 메트릭입니다.

properties.pivots

비용 분석 UI의 하위 뷰 3개 구성

properties.query.dataSet

이 보고서 구성의 데이터에 대한 정의가 있습니다.

properties.query.includeMonetaryCommitment
  • boolean

true이면 보고서에 현금 약정 금액이 포함됩니다.

properties.query.timePeriod

보고서에 대한 데이터를 끌어당기는 기간이 있습니다.

properties.scope
  • string

보기를 저장할 Cost Management 범위입니다. 여기에는 구독 범위에 대한 'subscriptions/{subscriptionId}', resourceGroup 범위의 경우 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'이 포함됩니다. 청구 계정 범위에 대한 'providers/Microsoft.Billing/billingAccountId}', 부서 범위의 경우 'providers/Microsoft.Billing/billingAccountId}/{billingAccountId}/{departmentId}', 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ EnrollmentAccount 범위에 대한 enrollmentAccountId}', BillingProfile 범위에 대한 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' InvoiceSection 범위의 경우 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}', 관리 그룹 범위의 경우 'providers/Microsoft.Management/managementGroups/{managementGroupId}', '/providers/Microsoft.CostManagement/externalBillingAccounts/{ externalBillingAccount 범위의 경우 externalBillingAccountName}' 및 ExternalSubscription 범위의 경우 '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}'입니다.

응답

Name Type Description
200 OK

OK. 요청이 성공했습니다.

201 Created

만들어졌습니다.

Other Status Codes

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

OAuth2 Flow Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

ResourceGroupCreateOrUpdateView

Sample Request

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.CostManagement/views/swaggerExample?api-version=2021-10-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"
      }
    ]
  }
}

Sample Response

{
  "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"
      }
    ]
  }
}
{
  "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

보기에 표시할 데이터 형식입니다.

ReportConfigAggregation

보고서에 사용할 집계 식입니다.

ReportConfigColumnType

보고서에 있는 열의 형식입니다.

ReportConfigComparisonExpression

보고서에 사용할 비교 식입니다.

ReportConfigDataset

보고서에 있는 데이터의 정의입니다.

ReportConfigDatasetConfiguration

보고서의 데이터 세트 구성입니다.

ReportConfigFilter

보고서에 사용할 필터 식입니다.

ReportConfigGrouping

보고서에 사용할 식별 그룹입니다.

ReportConfigSorting

보고서에 사용할 식별 순서입니다.

ReportConfigSortingType

정렬 방향입니다.

ReportConfigTimePeriod

보고서의 데이터를 끌어올리기 위한 시작 및 종료 날짜입니다.

ReportGranularityType

보고서의 행 세분성입니다.

ReportTimeframeType

보고서의 데이터를 끌어당기는 시간 프레임입니다. 사용자 지정하는 경우 특정 기간을 제공해야 합니다.

ReportType

보고서의 형식입니다. 사용량은 실제 사용량을 나타내고 예측은 예측 데이터를 나타내고 UsageAndForecast는 사용량 및 예측 데이터를 모두 나타냅니다. 실제 사용량 및 예측 데이터는 날짜에 따라 구별할 수 있습니다.

View

비용 분석의 상태 및 구성입니다.

AccumulatedType

시간이 지남에 따라 누적된 비용을 표시합니다.

Name Type Description
false
  • string
true
  • string

ChartType

비용 분석에서 기본 보기의 차트 종류입니다. 필수 요소.

Name Type Description
Area
  • string
GroupedColumn
  • string
Line
  • string
StackedColumn
  • string
Table
  • string

ErrorDetails

오류의 세부 정보입니다.

Name Type Description
code
  • string

오류 코드

message
  • string

작업이 실패한 이유를 나타내는 오류 메시지입니다.

ErrorResponse

오류 응답은 서비스가 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다.

일부 오류 응답:

  • 429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.

  • 503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간 동안 기다린 후 다시 시도합니다.

Name Type Description
error

오류의 세부 정보입니다.

FunctionType

사용할 집계 함수의 이름입니다.

Name Type Description
Sum
  • string

KpiProperties

각 KPI에는 'type' 및 'enabled' 키가 포함되어야 합니다.

Name Type Description
enabled
  • boolean

UI에 KPI를 표시하시겠습니까?

id
  • string

메트릭(예산)과 관련된 리소스의 ID입니다.

type

KPI 유형(예측, 예산).

KpiTypeType

KPI 유형(예측, 예산).

Name Type Description
Budget
  • string
Forecast
  • string

MetricType

비용을 표시할 때 사용할 메트릭입니다.

Name Type Description
AHUB
  • string
ActualCost
  • string
AmortizedCost
  • string

OperatorType

비교에 사용할 연산자입니다.

Name Type Description
Contains
  • string
In
  • string

PivotProperties

각 피벗은 'type' 및 'name'을 포함해야 합니다.

Name Type Description
name
  • string

보기에 표시할 데이터 필드입니다.

type

보기에 표시할 데이터 형식입니다.

PivotTypeType

보기에 표시할 데이터 형식입니다.

Name Type Description
Dimension
  • string
TagKey
  • string

ReportConfigAggregation

보고서에 사용할 집계 식입니다.

Name Type Description
function

사용할 집계 함수의 이름입니다.

name
  • string

집계할 열의 이름입니다.

ReportConfigColumnType

보고서에 있는 열의 형식입니다.

Name Type Description
Dimension
  • string
Tag
  • string

ReportConfigComparisonExpression

보고서에 사용할 비교 식입니다.

Name Type Description
name
  • string

비교할 열의 이름입니다.

operator

비교에 사용할 연산자입니다.

values
  • string[]

비교에 사용할 값의 배열

ReportConfigDataset

보고서에 있는 데이터의 정의입니다.

Name Type Description
aggregation

보고서에서 사용할 집계 식의 사전입니다. 사전에 있는 각 항목의 키는 집계된 열의 별칭입니다. 보고서에는 최대 2개의 집계 절이 있을 수 있습니다.

configuration

보고서의 데이터에 대한 구성 정보가 있습니다. 집계 및 그룹화가 제공되면 구성이 무시됩니다.

filter

보고서에 사용할 필터 식이 있습니다.

granularity

보고서의 행 세분성입니다.

grouping

보고서에 사용할 식별 그룹 배열입니다. 보고서에는 최대 2개의 그룹별 절이 있을 수 있습니다.

sorting

보고서에 사용할 식별 순서 배열입니다.

ReportConfigDatasetConfiguration

보고서의 데이터 세트 구성입니다.

Name Type Description
columns
  • string[]

보고서에 포함할 열 이름의 배열입니다. 유효한 보고서 열 이름은 허용됩니다. 제공되지 않으면 보고서에 모든 열이 포함됩니다.

ReportConfigFilter

보고서에 사용할 필터 식입니다.

Name Type Description
and

논리적 "AND" 식입니다. 항목이 2개 이상 있어야 합니다.

dimensions

차원에 대한 비교 식이 있습니다.

or

논리적 "OR" 식입니다. 항목이 2개 이상 있어야 합니다.

tags

태그에 대한 비교 식 있음

ReportConfigGrouping

보고서에 사용할 식별 그룹입니다.

Name Type Description
name
  • string

그룹화할 열의 이름입니다. 이 버전은 구독 가능한 가장 낮은 곡물을 지원합니다.

type

그룹화할 열의 형식이 있습니다.

ReportConfigSorting

보고서에 사용할 식별 순서입니다.

Name Type Description
direction

정렬 방향입니다.

name
  • string

정렬할 열의 이름입니다.

ReportConfigSortingType

정렬 방향입니다.

Name Type Description
Ascending
  • string
Descending
  • string

ReportConfigTimePeriod

보고서의 데이터를 끌어올리기 위한 시작 및 종료 날짜입니다.

Name Type Description
from
  • string

데이터를 끌어올 시작 날짜입니다.

to
  • string

데이터를 끌어올 종료 날짜입니다.

ReportGranularityType

보고서의 행 세분성입니다.

Name Type Description
Daily
  • string
Monthly
  • string

ReportTimeframeType

보고서의 데이터를 끌어당기는 시간 프레임입니다. 사용자 지정하는 경우 특정 기간을 제공해야 합니다.

Name Type Description
Custom
  • string
MonthToDate
  • string
WeekToDate
  • string
YearToDate
  • string

ReportType

보고서의 형식입니다. 사용량은 실제 사용량을 나타내고 예측은 예측 데이터를 나타내고 UsageAndForecast는 사용량 및 예측 데이터를 모두 나타냅니다. 실제 사용량 및 예측 데이터는 날짜에 따라 구별할 수 있습니다.

Name Type Description
Usage
  • string

View

비용 분석의 상태 및 구성입니다.

Name Type Description
eTag
  • string

리소스의 eTag입니다. 동시 업데이트 시나리오를 처리하기 위해 이 필드는 사용자가 최신 버전을 업데이트하는지 여부를 확인하는 데 사용됩니다.

id
  • string

리소스 ID입니다.

name
  • string

리소스 이름입니다.

properties.accumulated

시간이 지남에 따라 누적된 비용을 표시합니다.

properties.chart

비용 분석에서 기본 보기의 차트 종류입니다. 필수 요소.

properties.createdOn
  • string

사용자가 이 보기를 만든 날짜입니다.

properties.currency
  • string

현재 보기의 통화입니다.

properties.dateRange
  • string

현재 보기의 날짜 범위입니다.

properties.displayName
  • string

뷰의 사용자 입력 이름입니다. 필수 요소.

properties.kpis

비용 분석 UI에 표시할 KPI 목록입니다.

properties.metric

비용을 표시할 때 사용할 메트릭입니다.

properties.modifiedOn
  • string

사용자가 이 보기를 마지막으로 수정한 날짜입니다.

properties.pivots

비용 분석 UI의 하위 보기 3개 구성

properties.query.dataSet

이 보고서 구성의 데이터에 대한 정의가 있습니다.

properties.query.includeMonetaryCommitment
  • boolean

true이면 보고서에 현금 약정 금액이 포함됩니다.

properties.query.timePeriod

보고서의 데이터를 끌어당기는 기간이 있습니다.

properties.query.timeframe

보고서의 데이터를 끌어당기는 시간 프레임입니다. 사용자 지정하는 경우 특정 기간을 제공해야 합니다.

properties.query.type

보고서의 형식입니다. 사용량은 실제 사용량을 나타내고 예측은 예측 데이터를 나타내고 UsageAndForecast는 사용량 및 예측 데이터를 모두 나타냅니다. 실제 사용량 및 예측 데이터는 날짜에 따라 구별할 수 있습니다.

properties.scope
  • string

보기를 저장할 Cost Management 범위입니다. 여기에는 구독 범위에 대한 'subscriptions/{subscriptionId}', resourceGroup 범위에 대한 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'이 포함됩니다. 청구 계정 범위에 대한 'providers/Microsoft.Billing/billingAccountId}', 부서 범위의 경우 'providers/Microsoft.Billing/billingAccountId}/{billingAccountId}/departments/{departmentId}', 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccount 범위에 대한 enrollmentAccountId}', BillingProfile 범위에 대한 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' InvoiceSection 범위의 경우 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' - 관리 그룹 범위의 경우 'providers/Microsoft.Management/managementGroups/{managementGroupId}', '/providers/Microsoft.CostManagement/externalBillingAccounts/{ externalBillingAccount 범위의 경우 externalBillingAccountName}' 및 ExternalSubscription 범위의 경우 '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}'입니다.

type
  • string

리소스 종류.