Abrufen von Wechselkursen
Gilt für:
- Partner-API
In diesem Thema wird erläutert, wie Sie Wechselkurse für einen bestimmten Monat erhalten.
Voraussetzungen
- Anmeldeinformationen, wie unter Partner-API-Authentifizierung beschrieben. Dieses Szenario unterstützt nur die Anwendungsbenutzerauthentifizierung. Nur Anwendung wird noch nicht unterstützt.
- Diese API unterstützt derzeit nur den Benutzerzugriff, bei dem Partner eine der folgenden Rollen haben müssen: Globaler Administrator, Administrator-Agent oder Vertriebs-Agent.
Details
- Wird derzeit mit der API zum Abrufen des Preisblatts verwendet, um die erwarteten Gebühren für lokale Währungen des Azure-Plan-CSP zu berechnen.
- Wechselkurse gelten für den gesamten Monat, in dem sie veröffentlicht werden.
- Weitere Informationen zu den Preisen für Azure-Pläne finden Sie in der Preisdokumentation für Azure-Pläne.
- Partnerpreise und Wechselkurs-APIs sind nicht Teil der Partner Center SDK.
- Diese Methode gibt Ergebnisse als Dateistream zurück. Der Dateistream ist entweder eine .csv-Datei oder eine zip-komprimierte Version des .csv. Details zum Anfordern komprimierter Dateien finden Sie unten.
REST-Anforderung
Anforderungssyntax
| Methode | Anforderungs-URI |
|---|---|
| GET | '{month}')/$value |
Erforderliche URI-Parameter
Verwenden Sie die folgenden Pfadparameter, um den Monat der wechselkursen an fordern, die Sie möchten.
| Name | Typ | Erforderlich | BESCHREIBUNG |
|---|---|---|---|
| Month (Monat) | Zeichenfolge | Ja | Muss im YYYMM-Format vorliegen. Wenn nicht angegeben, wird standardmäßig der aktuelle Monat verwendet. |
Anforderungsheader
- Weitere Informationen findest du unter Partner-API: REST-Header.
Zusätzlich zu den oben genannten Headern können Dateien als komprimiert abgerufen werden, um bandbreiten- und downloadzeiten zu reduzieren. Standardmäßig werden die Dateien nicht komprimiert. Um komprimierte Versionen der Dateien zu erhalten, können Sie den folgenden Headerwert angeben. Stellen Sie fest, dass komprimierte Blätter nur ab April 2020 verfügbar sind. Alle Anforderungen vor April 2020 sind nur als nicht komprimiert verfügbar.
| Header | Werttyp | Wert | BESCHREIBUNG |
|---|---|---|---|
| Accept-Encoding | Zeichenfolge | Deflate | Optional. Wenn der Dateidatenstrom ausgelassen wird, wird er nicht komprimiert. |
Anforderungsbeispiel
GET https://api.partner.microsoft.com/v1.0/sales/fxrates(Month='201909')/$value HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com
REST-Antwort
Bei Erfolg gibt diese Methode Wechselkurse als Dateistream zurück. Der Dateistream ist entweder eine .csv-Datei oder eine zip-komprimierte Version des .csv.
Erfolgs- und Fehlercodes der Antwort
Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.
Antwortbeispiel
HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 18548
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=fxrates
Request-ID: 65fb6e59-051b-42f7-8771-c8c139b3c901
Date: Wed, 02 Oct 2019 03:42:54 GMT
"CurrencyCode","USDPerUnit","Month"
"AED","0.27224589249009701","2019”
======= Truncated ==============