Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este artículo se explica cómo obtener tipos de cambio de divisas durante un mes determinado.
Requisitos previos
- Credenciales como se describe en Autenticación de API. Este escenario solo es compatible con la autenticación de usuario y aplicación. Todavía no se admite la autenticación solo de aplicación.
- Actualmente, esta API solo admite el acceso de usuario en el que los asociados deben estar en uno de los roles siguientes: Agente de administración o Agente de ventas.
Detalles
- Actualmente se usa con get price sheet API para calcular los cargos esperados para las monedas locales de CSP del plan de Azure.
- Los tipos de cambio de divisas son verdaderos durante todo el mes que se publican.
- Puede encontrar más información sobre los precios del plan de Azure en la documentación de precios del plan de Azure.
- Este método devuelve resultados como una secuencia de archivos. La secuencia de archivos es un archivo .csv o una versión comprimida zip del .csv. A continuación se incluyen detalles sobre cómo solicitar archivos comprimidos.
Solicitud REST
Sintaxis de la solicitud
Método | URI de solicitud |
---|---|
GET | https://api.partner.microsoft.com/v1.0/sales/fxrates(Month='{month}')/$value |
Parámetros necesarios de URI
Use los siguientes parámetros de ruta de acceso para solicitar el mes de los tipos de cambio de divisas que desee.
Nombre | Type | Obligatorio | Descripción |
---|---|---|---|
Mes | string | Sí | Debe estar en formato AAAAMM. Si se omite, el valor predeterminado es el mes actual. |
Encabezados de solicitud
- Consulte Encabezados REST de partners para obtener más información.
Además de los encabezados anteriores, los archivos se pueden recuperar como comprimidos reduciendo el ancho de banda y los tiempos de descarga. De forma predeterminada, los archivos no están comprimidos. Para obtener versiones comprimidas de los archivos, puede incluir el valor de encabezado siguiente. Tenga en cuenta que las hojas comprimidas solo están disponibles a partir de abril de 2020, todas las solicitudes anteriores a abril de 2020 solo están disponibles como no comprimidas.
Encabezado | Tipo de valor | Valor | Descripción |
---|---|---|---|
Accept-Encoding | string | deflate | Opcional. Si no se omite la secuencia de archivos no está comprimida. |
Ejemplo de solicitud
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
Respuesta REST
Si se ejecuta correctamente, este método devuelve tipos de cambio de divisas como una secuencia de archivos. La secuencia de archivos es un archivo .csv o una versión comprimida zip del .csv.
Códigos de error y de respuesta correctos
Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulte Códigos de error.
Ejemplo de respuesta
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 ==============