Price Sheet - Get

Servizio:

Consumption

Versione API:

2024-08-01

Ottiene l'elenco prezzi per una sottoscrizione. Il listino prezzi è disponibile solo tramite questa API per il 1° maggio 2014 o versione successiva.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2024-08-01

Con parametri facoltativi:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?$expand={$expand}&$skiptoken={$skiptoken}&$top={$top}&api-version=2024-08-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
subscriptionId	path	True	string	ID sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare con la richiesta client. La versione corrente è 2023-03-01.
$expand	query		string	Può essere utilizzato per espandere le proprietà/meterDetails all'interno di un elenco prezzi. Per impostazione predefinita, questi campi non sono inclusi durante la restituzione dell'elenco prezzi.
$skiptoken	query		string	Skiptoken viene usato solo se un'operazione precedente ha restituito un risultato parziale. Se una risposta precedente contiene un elemento nextLink, il valore dell'elemento nextLink includerà un parametro skiptoken che specifica un punto di partenza da usare per le chiamate successive.
$top	query		integer (int32) minimum: 1 maximum: 1000	Può essere usato per limitare il numero di risultati ai primi N risultati.

Risposte

Nome	Tipo	Descrizione
200 OK	PriceSheetResult	OK. La richiesta ha avuto esito positivo.
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

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	rappresentare l'account utente

Esempio

PriceSheet

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/pricesheets/default?api-version=2024-08-01

Risposta di esempio

Codice di stato:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/pricesheets/default",
  "name": "default",
  "type": "Microsoft.Consumption/pricesheets",
  "properties": {
    "nextLink": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/microsoft.consumption/pricesheets/default?api-version=2018-01-31&$skiptoken=AQAAAA%3D%3D",
    "pricesheets": [
      {
        "billingPeriodId": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "unitOfMeasure": "100 Hours",
        "includedQuantity": 100,
        "partNumber": "XX-11110",
        "unitPrice": 0.00328,
        "currencyCode": "EUR",
        "offerId": "OfferId 1",
        "savingsPlan": {
          "term": "P3Y",
          "effectivePrice": 0.002,
          "marketPrice": 0.00328
        }
      }
    ]
  }
}

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
MeterDetails	Dettagli sul contatore. Per impostazione predefinita, questa operazione non viene popolata, a meno che non sia specificata in $expand.
PriceSheetProperties	Elenco prezzi
PriceSheetResult	Risorsa della scheda prezzi.
SavingsPlan	Dettagli di SavingsPlan

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

MeterDetails

Object

Dettagli sul contatore. Per impostazione predefinita, questa operazione non viene popolata, a meno che non sia specificata in $expand.

Nome	Tipo	Descrizione
meterCategory	string	Categoria del contatore, ad esempio "Servizi cloud", "Rete" e così via.
meterLocation	string	Percorso in cui è disponibile il servizio di Azure.
meterName	string	Nome del contatore, all'interno della categoria del contatore specificata
meterSubCategory	string	Sottocategoria del contatore, ad esempio "Servizi cloud A6", "ExpressRoute (IXP)" e così via.
pretaxStandardRate	number (decimal)	Prezzo di listino pretax.
serviceName	string	Nome del servizio.
serviceTier	string	Livello di servizio.
totalIncludedQuantity	number (decimal)	Quantità totale inclusa associata all'offerta.
unit	string	Unità in cui viene addebitato il consumo del contatore, ad esempio "Ore", "GB" e così via.

PriceSheetProperties

Object

Elenco prezzi

Nome	Tipo	Descrizione
billingPeriodId	string	ID della risorsa del periodo di fatturazione a cui appartiene l'utilizzo.
currencyCode	string	Codice valuta
includedQuantity	number (decimal)	Qualità inclusa per un'offerta
meterDetails	MeterDetails	Dettagli sul contatore. Per impostazione predefinita, questa operazione non viene popolata, a meno che non sia specificata in $expand.
meterId	string (uuid)	ID contatore (GUID)
offerId	string	ID offerta
partNumber	string	Numero di parte
savingsPlan	SavingsPlan	Dettagli di SavingsPlan
unitOfMeasure	string	Unità di misura
unitPrice	number (decimal)	Prezzo unitario

PriceSheetResult

Object

Risorsa della scheda prezzi.

Nome	Tipo	Descrizione
etag	string	Etag per la risorsa.
id	string	ID ARM completo di un evento.
name	string	ID che identifica in modo univoco un evento.
properties.download	MeterDetails	Dettagli del download di Pricesheet.
properties.nextLink	string	Collegamento (URL) alla pagina successiva dei risultati.
properties.pricesheets	PriceSheetProperties[]	Elenco prezzi
tags	object	Tag di risorsa.
type	string	Tipo di risorsa.

SavingsPlan

Object

Dettagli di SavingsPlan

Nome	Tipo	Descrizione
effectivePrice	number (decimal)	Prezzo effettivo di SavingsPlan
marketPrice	number (decimal)	SavingsPlan Market Price
term	string	Termine di SavingsPlan