Freigeben über


Price Sheet - Get

Ruft das Preisblatt für ein Abonnement ab. Das Preisblatt ist nur für den 1. Mai 2014 oder höher über diese API verfügbar.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
subscriptionId
path True

string

minLength: 1

Die ID des Zielabonnements.

api-version
query True

string

minLength: 1

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

$expand
query

string

Kann verwendet werden, um die Eigenschaften/MeterDetails innerhalb eines Preisblatts zu erweitern. Standardmäßig sind diese Felder beim Zurückgeben des Preisblatts nicht enthalten.

$skiptoken
query

string

Skiptoken wird nur verwendet, wenn ein vorheriger Vorgang ein Teilergebnis zurückgegeben hat. Wenn eine vorherige Antwort ein nextLink-Element enthält, enthält der Wert des nextLink-Elements einen Skiptoken-Parameter, der einen Ausgangspunkt angibt, der für nachfolgende Aufrufe verwendet werden soll.

$top
query

integer (int32)

minimum: 1
maximum: 1000

Kann verwendet werden, um die Anzahl der Ergebnisse auf die obersten N-Ergebnisse zu beschränken.

Antworten

Name Typ Beschreibung
200 OK

PriceSheetResult

Der Azure-Vorgang wurde erfolgreich abgeschlossen.

Other Status Codes

ErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

PriceSheet

Beispielanforderung

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

Beispiel für eine Antwort

{
  "name": "default",
  "type": "Microsoft.Consumption/pricesheets",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/pricesheets/default",
  "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",
        "currencyCode": "EUR",
        "includedQuantity": 100,
        "meterId": "00000000-0000-0000-0000-000000000000",
        "offerId": "OfferId 1",
        "partNumber": "XX-11110",
        "savingsPlan": {
          "effectivePrice": 0.002,
          "marketPrice": 0.00328,
          "term": "P3Y"
        },
        "unitOfMeasure": "100 Hours",
        "unitPrice": 0.00328
      }
    ]
  }
}

Definitionen

Name Beschreibung
createdByType

Der Identitätstyp, der die Ressource erstellt hat.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

MeterDetails

Die Eigenschaften des Meterdetails.

PriceSheetProperties

Die Eigenschaften des Preisblatts.

PriceSheetResult

Eine Preistabellenressource.

SavingsPlan

Die Eigenschaften des SavingsPlan.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Wert Beschreibung
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

MeterDetails

Die Eigenschaften des Meterdetails.

Name Typ Beschreibung
meterCategory

string

Die Kategorie des Zählers, z. B. "Clouddienste", "Netzwerk", usw.

meterLocation

string

Der Speicherort, an dem der Azure-Dienst verfügbar ist.

meterName

string

Der Name des Zählers innerhalb der angegebenen Meterkategorie

meterSubCategory

string

Die Unterkategorie des Zählers, z. B. "A6 Cloud Services", "ExpressRoute (IXP)" usw.

pretaxStandardRate

number (decimal)

Der Vortax-Eintragspreis.

serviceName

string

Der Name des Diensts.

serviceTier

string

Die Dienstebene.

totalIncludedQuantity

number (decimal)

Die gesamt enthaltene Menge, die dem Angebot zugeordnet ist.

unit

string

Die Einheit, in der der Meterverbrauch berechnet wird, z. B. "Stunden", "GB" usw.

PriceSheetProperties

Die Eigenschaften des Preisblatts.

Name Typ Beschreibung
billingPeriodId

string

Die ID der Abrechnungszeitraumsressource, zu der die Verwendung gehört.

currencyCode

string

Währungscode

includedQuantity

number (decimal)

Inklusive Qualität für ein Angebot

meterDetails

MeterDetails

Die Details zum Meter. Standardmäßig wird dies nicht ausgefüllt, es sei denn, sie wird in $expand angegeben.

meterId

string (uuid)

Die Meter-ID (GUID)

offerId

string

Angebots-ID

partNumber

string

Teilenummer

savingsPlan

SavingsPlan

Details zum Sparplan

unitOfMeasure

string

Maßeinheit

unitPrice

number (decimal)

Einheitenpreis

PriceSheetResult

Eine Preistabellenressource.

Name Typ Beschreibung
etag

string

eTag der Ressource. Um das Szenario für gleichzeitige Updates zu behandeln, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht.

id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Der Name der Ressource

properties.download

MeterDetails

Downloaddetails für Preislisten.

properties.nextLink

string

Der Link (URL) zur nächsten Seite der Ergebnisse.

properties.pricesheets

PriceSheetProperties[]

Preisblatt

systemData

systemData

Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.

tags

object

Ressourcentags.

type

string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

SavingsPlan

Die Eigenschaften des SavingsPlan.

Name Typ Beschreibung
effectivePrice

number (decimal)

Sparplan effektiver Preis

marketPrice

number (decimal)

Sparplan Marktpreis

term

string

Sparplan-Laufzeit

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name Typ Beschreibung
createdAt

string (date-time)

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string (date-time)

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.