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 |
|---|---|---|---|---|
|
subscription
|
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: 1maximum: 1000 |
Kann verwendet werden, um die Anzahl der Ergebnisse auf die obersten N-Ergebnisse zu beschränken. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Der Azure-Vorgang wurde erfolgreich abgeschlossen. |
|
| Other Status Codes |
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 |
|---|---|
|
created |
Der Identitätstyp, der die Ressource erstellt hat. |
|
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
|
Error |
Das Fehlerdetails. |
|
Error |
Fehlerantwort |
|
Meter |
Die Eigenschaften des Meterdetails. |
|
Price |
Die Eigenschaften des Preisblatts. |
|
Price |
Eine Preistabellenressource. |
|
Savings |
Die Eigenschaften des SavingsPlan. |
|
system |
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 |
Die zusätzlichen Informationen des Fehlers. |
|
| code |
string |
Der Fehlercode. |
| details |
Die Fehlerdetails. |
|
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
| Name | Typ | Beschreibung |
|---|---|---|
| error |
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 |
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 |
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 |
Downloaddetails für Preislisten. |
|
| properties.nextLink |
string |
Der Link (URL) zur nächsten Seite der Ergebnisse. |
| properties.pricesheets |
Preisblatt |
|
| 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 |
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 |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |