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

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