Views - Get

Servizio:

Cost Management

Versione API:

2026-06-01

Ottiene la visualizzazione in base al nome della vista.

GET https://management.azure.com/providers/Microsoft.CostManagement/views/{viewName}?api-version=2026-06-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
viewName	path	True	string	Nome visualizzato
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	View	Operazione Azure completata con successo.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	impersonare il tuo account utente

Esempio

PrivateView

Esempio di richiesta

HTTP

GET https://management.azure.com/providers/Microsoft.CostManagement/views/swaggerExample?api-version=2026-06-01

Risposta di esempio

Codice di stato:

200

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

Definizioni

Nome	Descrizione
AccumulatedType	Mostra i costi accumulati nel tempo.
ChartType	Tipo di grafico della vista principale in Analisi dei costi. Required.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorDetails	Dettagli dell'errore.
ErrorResponse	La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore. \n\nAlcune risposte agli errori: \n\n * 429 TooManyRequests - La richiesta è limitata. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after". \n\n * 503 ServiceUnavailable - Il servizio è temporaneamente non disponibile. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "Retry-After".
FunctionType	Nome della funzione di aggregazione da usare.
KpiProperties	Ogni indicatore KPI deve contenere una chiave 'type' e 'enabled'.
KpiTypeType	Tipo di KPI (Previsione, Budget).
MetricType	Metrica da utilizzare per la visualizzazione dei costi.
OperatorType	Operatore da utilizzare per il confronto.
PivotProperties	Ogni pivot deve contenere un 'type' e 'name'.
PivotTypeType	Tipo di dati da visualizzare nella visualizzazione.
QueryColumnType	Il tipo di rubrica nel rapporto.
ReportConfigAggregation	Espressione di aggregazione da utilizzare nel report.
ReportConfigComparisonExpression	Espressione di confronto da utilizzare nel report.
ReportConfigDataset	Definizione dei dati presenti nel report.
ReportConfigDatasetConfiguration	Configurazione del set di dati nel report.
ReportConfigFilter	Espressione di filtro da utilizzare nel report.
ReportConfigGrouping	Gruppo per espressione da utilizzare nel report.
ReportConfigSorting	Ordine in base all'espressione da utilizzare nel report.
ReportConfigSortingType	Direzione di sorta.
ReportConfigTimePeriod	Data di inizio e fine per il pull dei dati per il report.
ReportGranularityType	Granularità delle righe nel report.
ReportTimeframeType	Intervallo di tempo per il pull dei dati per il report. Se personalizzato, è necessario specificare un periodo di tempo specifico.
ReportType	Tipo del report. Usage rappresenta l'utilizzo effettivo, forecast rappresenta i dati previsti e UsageAndForecast rappresenta sia l'utilizzo che i dati previsti. L'utilizzo effettivo e i dati previsti possono essere differenziati in base alle date.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
View	Stati e configurazioni di Analisi dei costi.

AccumulatedType

Enumerazione

Mostra i costi accumulati nel tempo.

Valore	Descrizione
true
false

ChartType

Enumerazione

Tipo di grafico della vista principale in Analisi dei costi. Required.

Valore	Descrizione
Area
Line
StackedColumn
GroupedColumn
Table

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorDetails

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

ErrorResponse

Oggetto

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore. \n\nAlcune risposte agli errori: \n\n * 429 TooManyRequests - La richiesta è limitata. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after". \n\n * 503 ServiceUnavailable - Il servizio è temporaneamente non disponibile. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "Retry-After".

Nome	Tipo	Descrizione
error	ErrorDetails	Dettagli dell'errore.

FunctionType

Enumerazione

Nome della funzione di aggregazione da usare.

Valore	Descrizione
Sum

KpiProperties

Oggetto

Ogni indicatore KPI deve contenere una chiave 'type' e 'enabled'.

Nome	Tipo	Descrizione
enabled	boolean	visualizzare il KPI nell'interfaccia utente?
id	string	ID della risorsa correlata alla metrica (budget).
type	KpiTypeType	Tipo di KPI (Previsione, Budget).

KpiTypeType

Enumerazione

Tipo di KPI (Previsione, Budget).

Valore	Descrizione
Forecast
Budget

MetricType

Enumerazione

Metrica da utilizzare per la visualizzazione dei costi.

Valore	Descrizione
ActualCost
AmortizedCost
AHUB

OperatorType

Enumerazione

Operatore da utilizzare per il confronto.

Valore	Descrizione
In
Contains

PivotProperties

Oggetto

Ogni pivot deve contenere un 'type' e 'name'.

Nome	Tipo	Descrizione
name	string	Campo dati da mostrare nella visualizzazione.
type	PivotTypeType	Tipo di dati da visualizzare nella visualizzazione.

PivotTypeType

Enumerazione

Tipo di dati da visualizzare nella visualizzazione.

Valore	Descrizione
Dimension
TagKey

QueryColumnType

Enumerazione

Il tipo di rubrica nel rapporto.

Valore	Descrizione
TagKey	Tag associato ai dati sui costi.
Dimension	Dimensione dei dati sui costi.

ReportConfigAggregation

Oggetto

Espressione di aggregazione da utilizzare nel report.

Nome	Tipo	Descrizione
function	FunctionType	Nome della funzione di aggregazione da usare.
name	string	Nome della colonna da aggregare.

ReportConfigComparisonExpression

Oggetto

Espressione di confronto da utilizzare nel report.

Nome	Tipo	Descrizione
name	string	Nome della colonna da utilizzare in confronto.
operator	OperatorType	Operatore da utilizzare per il confronto.
values	string[]	Matrice di valori da usare per il confronto

ReportConfigDataset

Oggetto

Definizione dei dati presenti nel report.

Nome	Tipo	Descrizione
aggregation	<string,  ReportConfigAggregation>	Dizionario dell'espressione di aggregazione da usare nel report. La chiave di ogni elemento nel dizionario è l'alias per la colonna aggregata. Il report può avere fino a 2 clausole di aggregazione.
configuration	ReportConfigDatasetConfiguration	Contiene informazioni di configurazione per i dati nel report. La configurazione verrà ignorata se vengono fornite aggregazioni e raggruppamento.
filter	ReportConfigFilter	Dispone dell'espressione di filtro da utilizzare nel report.
granularity	ReportGranularityType	Granularità delle righe nel report.
grouping	ReportConfigGrouping[]	Matrice di raggruppamento per espressione da usare nel report. Il report può avere fino a 2 clausole group by.
sorting	ReportConfigSorting[]	Matrice di ordine per espressione da utilizzare nel report.

ReportConfigDatasetConfiguration

Oggetto

Configurazione del set di dati nel report.

Nome	Tipo	Descrizione
columns	string[]	Matrice di nomi di colonna da includere nel report. È consentito qualsiasi nome di colonna del report valido. Se non specificato, il report include tutte le colonne.

ReportConfigFilter

Oggetto

Espressione di filtro da utilizzare nel report.

Nome	Tipo	Descrizione
and	ReportConfigFilter[]	Espressione logica "AND". Deve contenere almeno 2 elementi.
dimensions	ReportConfigComparisonExpression	Espressione di confronto per una dimensione
or	ReportConfigFilter[]	Espressione logica "OR". Deve contenere almeno 2 elementi.
tags	ReportConfigComparisonExpression	Ha un'espressione di confronto per un tag

ReportConfigGrouping

Oggetto

Gruppo per espressione da utilizzare nel report.

Nome	Tipo	Descrizione
name	string	Nome della colonna da raggruppare. Questa versione supporta la granularità più bassa possibile della sottoscrizione.
type	QueryColumnType	Tipo della colonna da raggruppare.

ReportConfigSorting

Oggetto

Ordine in base all'espressione da utilizzare nel report.

Nome	Tipo	Descrizione
direction	ReportConfigSortingType	Direzione di sorta.
name	string	Nome della colonna da ordinare.

ReportConfigSortingType

Enumerazione

Direzione di sorta.

Valore	Descrizione
Ascending
Descending

ReportConfigTimePeriod

Oggetto

Data di inizio e fine per il pull dei dati per il report.

Nome	Tipo	Descrizione
from	string (date-time)	Data di inizio da cui estrarre i dati.
to	string (date-time)	Data di fine in cui eseguire il pull dei dati.

ReportGranularityType

Enumerazione

Granularità delle righe nel report.

Valore	Descrizione
Daily
Monthly

ReportTimeframeType

Enumerazione

Intervallo di tempo per il pull dei dati per il report. Se personalizzato, è necessario specificare un periodo di tempo specifico.

Valore	Descrizione
WeekToDate
MonthToDate
YearToDate
Custom

ReportType

Enumerazione

Tipo del report. Usage rappresenta l'utilizzo effettivo, forecast rappresenta i dati previsti e UsageAndForecast rappresenta sia l'utilizzo che i dati previsti. L'utilizzo effettivo e i dati previsti possono essere differenziati in base alle date.

Valore	Descrizione
Usage

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

View

Oggetto

Stati e configurazioni di Analisi dei costi.

Nome	Tipo	Descrizione
eTag	string	eTag della risorsa. Per gestire lo scenario di aggiornamento simultaneo, questo campo verrà usato per determinare se l'utente sta aggiornando o meno la versione più recente.
id	string (arm-id)	Identificatore di risorsa completamente qualificato per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	nome della risorsa.
properties.accumulated	AccumulatedType	Mostra i costi accumulati nel tempo.
properties.chart	ChartType	Tipo di grafico della vista principale in Analisi dei costi. Required.
properties.createdOn	string (date-time)	Data di creazione della visualizzazione da parte dell'utente.
properties.currency	string	Valuta della visualizzazione corrente.
properties.dateRange	string	Intervallo di date della visualizzazione corrente.
properties.displayName	string	Nome immesso dall'utente della vista. Required.
properties.kpis	KpiProperties[]	Elenco di indicatori KPI da visualizzare nell'interfaccia utente di Analisi costi.
properties.metric	MetricType	Metrica da utilizzare per la visualizzazione dei costi.
properties.modifiedOn	string (date-time)	Data dell'ultima modifica apportata dall'utente alla visualizzazione.
properties.pivots	PivotProperties[]	Configurazione di 3 visualizzazioni secondarie nell'interfaccia utente di Analisi dei costi.
properties.query.dataSet	ReportConfigDataset	Ha una definizione per i dati in questa configurazione del report.
properties.query.includeMonetaryCommitment	boolean	Se true, il report include l'impegno monetario.
properties.query.timePeriod	ReportConfigTimePeriod	Periodo di tempo per il pull dei dati per il report.
properties.query.timeframe	ReportTimeframeType	Intervallo di tempo per il pull dei dati per il report. Se personalizzato, è necessario specificare un periodo di tempo specifico.
properties.query.type	ReportType	Tipo del report. Usage rappresenta l'utilizzo effettivo, forecast rappresenta i dati previsti e UsageAndForecast rappresenta sia l'utilizzo che i dati previsti. L'utilizzo effettivo e i dati previsti possono essere differenziati in base alle date.
properties.scope	string	Ambito di Gestione costi in cui salvare la visualizzazione. Sono inclusi 'subscriptions/{subscriptionId}' per l'ambito della sottoscrizione, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' per l'ambito resourceGroup, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' per l'ambito dell'account di fatturazione, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' per l'ambito del reparto, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}' per l'ambito EnrollmentAccount, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' per l'ambito BillingProfile, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' per l'ambito InvoiceSection, 'providers/Microsoft.Management/managementGroups/{managementGroupId}' per l'ambito del gruppo di gestione, '/providers/Microsoft.CostManagement/externalBillingAccounts/{ externalBillingAccountName}' per l'ambito ExternalBillingAccount e '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}' per l'ambito ExternalSubscription.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"