Price Sheet - Download By Invoice

Referenz

Dienst:: Cost Management

API-Version:: 2024-08-01

Ruft eine URL zum Herunterladen des Preisblatts für eine Rechnung ab. Der Vorgang wird für Abrechnungskonten mit dem Vertragstyp Microsoft Partner Agreement oder Microsoft Customer Agreement unterstützt.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoices/{invoiceName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
billingAccountName	path	True	string	Die ID, die ein Abrechnungskonto eindeutig identifiziert. RegEx-Muster: `([A-Za-z0-9]+(-[A-Za-z0-9]+)+):([A-Za-z0-9]+(-[A-Za-z0-9]+)+)_[0-9]{4}-[0-9]{2}-[0-9]{2}`
billingProfileName	path	True	string	Die ID, die ein Abrechnungsprofil eindeutig identifiziert. RegEx-Muster: `([A-Za-z0-9]+(-[A-Za-z0-9]+)+)`
invoiceName	path	True	string	Die ID, die eine Rechnung eindeutig identifiziert. RegEx-Muster: `[A-Za-z0-9]+`
api-version	query	True	string	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name

Typ

Beschreibung

200 OK

OKAY. Die Anforderung ist erfolgreich.

202 Accepted

Angenommen.

Header

Location: string
Retry-After: string
OData-EntityId: string

Other Status Codes

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

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

PricesheetDownload

Beispielanforderung

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/invoices/T000940677/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

Beispiel für eine Antwort

Statuscode:: 202

Location: https://management.azure.com:443/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/operationResults/45000000-0000-0000-0000-000000000000?sessiontoken=0:000000&api-version=2024-08-01&OperationType=PriceSheet
Retry-After: 60
OData-EntityId: 45000000-0000-0000-0000-000000000000

Statuscode:: 200

{
  "downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
  "expiryTime": "2022-09-30T17:32:28Z"
}

Definitionen

Name

Beschreibung

DownloadURL

Die URL zum Herunterladen des generierten Berichts.

ErrorDetails

Die Details des Fehlers.

ErrorResponse

Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Einige Fehlerantworten:

429 TooManyRequests – Anforderung wird gedrosselt. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit.
503 ServiceUnavailable – Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "Retry-After" angegebene Zeit.

DownloadURL

Die URL zum Herunterladen des generierten Berichts.

Name	Typ	Beschreibung
downloadUrl	string	Die URL zum Herunterladen des generierten Berichts.
expiryTime	string	Die Uhrzeit, zu der die Berichts-URL in UTC ungültig/abläuft, z. B. 2020-12-08T05:55:59.4394737Z.
validTill	string	Die Uhrzeit, zu der die Berichts-URL in UTC ungültig/abläuft, z. B. 2020-12-08T05:55:59.4394737Z.

ErrorDetails

Die Details des Fehlers.

Name	Typ	Beschreibung
code	string	Fehlercode.
message	string	Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ErrorResponse

Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Einige Fehlerantworten:

429 TooManyRequests – Anforderung wird gedrosselt. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit.
503 ServiceUnavailable – Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "Retry-After" angegebene Zeit.

Name	Typ	Beschreibung
error	ErrorDetails	Die Details des Fehlers.