Freigeben über

Abrufen von Wechselkursen

In diesem Artikel wird erläutert, wie Sie Wechselkurse für einen bestimmten Monat erhalten.

Voraussetzungen

  • Anmeldeinformationen, wie in der API-Authentifizierung beschrieben. Dieses Szenario unterstützt nur Anwendungsbenutzerauthentifizierung. Die reine Anwendungsauthentifizierung wird noch nicht unterstützt.
  • Diese API unterstützt derzeit nur den Benutzerzugriff, bei dem Partner in einer der folgenden Rollen sein müssen: Administrator-Agent oder Vertriebsmitarbeiter.

Details

  • Wird derzeit mit der API zum Abrufen von Preistabellen verwendet, um die erwarteten Gebühren für lokale Azure-CSP-Währungen zu berechnen.
  • Wechselkurse halten für den gesamten Monat wahr, den sie gebucht haben.
  • Weitere Informationen zu Azure-Planpreisen finden Sie in der Azure-Plan-Preisdokumentation.
  • Diese Methode gibt Ergebnisse als Dateidatenstrom zurück. Der Dateidatenstrom ist entweder eine .csv Datei oder eine komprimierte Zip-Version der .csv. Details zum Anfordern komprimierter Dateien finden Sie unten.

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
GET https://api.partner.microsoft.com/v1.0/sales/fxrates(Month='{month}')/$value

Erforderliche URI-Parameter

Verwenden Sie die folgenden Pfadparameter, um den gewünschten Monat der Wechselkurse anzufordern.

Name Type Erforderlich Beschreibung
Monat Zeichenfolge Ja Muss im JJJJMM-Format vorliegen. Wenn der Standardwert für den aktuellen Monat nicht angegeben wird.

Anforderungsheader

Zusätzlich zu den obigen Headern können Dateien wie komprimiert abgerufen werden, um Bandbreite und Downloadzeiten zu reduzieren. Standardmäßig werden die Dateien nicht komprimiert. Um komprimierte Versionen der Dateien zu erhalten, können Sie den folgenden Headerwert einschließen. 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 Typ Wert Beschreibung
Accept-Encoding Zeichenfolge deflate Optional. Wenn kein Dateidatenstrom angegeben wird, wird der Dateidatenstrom 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

Wenn die Methode erfolgreich verläuft, werden Wechselkurse als Dateidatenstrom zurückgegeben. Der Dateidatenstrom ist entweder eine .csv Datei oder eine komprimierte Zip-Version der .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.

Beispielantwort

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 ==============

Zugehöriger Inhalt