Área de clienteContactar con el equipo comercialWebmailOVHcloud Blog

¡Bienvenido/a a OVHcloud!

Identifíquese para contratar una solución, gestionar sus productos y servicios, y consultar sus pedidos

Conectarme

Renovar un servicio a través de la API de OVH

Cómo renovar un servicio utilizando la API de OVH

Última actualización: 27/08/2018

Objetivo

OVH ofrece de forma nativa la renovación automática de sus soluciones, aunque también es posible renovar un servicio utilizando la API.

Esta guía explica cómo renovar un servicio a través de la API de OVH.

Requisitos

  • Estar conectado a la API de OVH.
  • Disponer de las claves para conectarse a la API de OVH.

Procedimiento

Para utilizar la función de renovación de la API, necesitará el serviceId. Puede obtener este dato con la función serviceInfos, como en el siguiente ejemplo:

También puede ver la lista de sus servicios con la función service:

Consultar las distintas estrategias de renovación

Para consultar las distintas estrategias de renovación disponibles para un servicio determinado, utilice la siguiente función:

Aparecerá una lista RenewDescription con dos propiedades:

  • renewPeriod: Duración de renovación (en formato ISO 8601).
  • strategies: Lista de posibles estrategias de renovación (RenewStrategy).

Una estrategia de renovación describe el precio y la lista de servicios que se pueden renovar. Por ejemplo, renovar un dominio es una estrategia distinta de renovar un dominio y su alojamiento. Las estrategias muestran todas las posibles combinaciones para una solución determinada: servicios asociados, opciones....

A continuación ofrecemos un ejemplo en Python para consultar la información de renovación:

import ovh
client = ovh.Client()

client.get('/service/12345/renew',
includeOptions=False, // Include service s option(s) (type: boolean)
)

Este es un ejemplo del tipo de respuesta que se puede obtener para un servicio en un período determinado:

[
  {
    "renewPeriod": "P1Y",
    "strategies": [
      {
        "services": [
          12345
        ],
        "price": {
          "value": 1.99
           },
           "servicesDetails": [
             {
               "serviceType": "Domain .ovh",
               "serviceId": 12345
           }
         ]
       },
       {
         "services": [
           67890,
           12345
           ],
           "price": {
           "value": 37.87
         },
         "servicesDetails": [
           {
             "serviceType": "Hosting Perso 2014",
             "serviceId": 67890
           },
           {
             "serviceType": "Domain .ovh",
             "serviceId": 12345
           }
         ]
       }
     ]
   }
 ]

Para más información sobre el formato de la respuesta, consulte la función renew de la API.

Crear una nueva orden de pedido para la renovación

Para crear una nueva orden de pedido de renovación, deberá especificar qué servicios quiere renovar, así como el período de renovación deseado:

import ovh
client = ovh.Client()

client.post('/service/12345/renew',
    dryRun=False, // Indicates if renew order is generated (type: boolean)
    duration='P1Y',
    services=[
        67890,
        12345
    ]
)

Obtendrá una respuesta como la siguiente:

{
  "expirationDate": "2018-05-16T15:49:06+02:00",
  "password": "aBcD",
  "date": "2018-05-15T15:49:06+02:00",
  "priceWithTax": {
    "value": 45.44,
    "text": "45.44 u20ac",
    "currencyCode": "EUR"
  },
 "tax": {
    "value": 7.57,
    "text": "7.57 u20ac",
    "currencyCode": "EUR"
  },
  "pdfUrl": "https://www.ovh.com/cgi-bin/order/displayOrder.cgi?orderId=123456789&orderPassword=aBcD",
  "orderId": 123456789,
  "url": "https://www.ovh.com/cgi-bin/order/displayOrder.cgi?orderId=123456789&orderPassword=aBcD",
  "priceWithoutTax": {
    "value": 37.87,
    "text": "37.87 u20ac",
    "currencyCode": "EUR"
  },
 "retractionDate": null
}

A continuación, podrá abonar la orden de pedido con la función order de la API:

Ejemplo: Renovar un VPS

import ovh
client = ovh.Client()

myVps = "vps112233.ovh.net"
expectedRenewPeriod = "P3M"

def checkStrategy(choices, serviceId):

    for choice in choices:
       if choice['renewPeriod'] != expectedRenewPeriod:
           continue
       for strategy in choice['strategies']:
           services = strategy['services']
           if len(services) == 1 and serviceId in services:
                return True

raise ValueError('Unable to find expected service/renewPeriod in choices')


def main():

    serviceId = client.get('/vps/{}/serviceInfos'.format(myVps))['serviceId']

    choices = client.get('/service/{}/renew'.format(serviceId))
    checkStrategy(choices, serviceId)

    order = client.post('/service/{}/renew'.format(serviceId),
        dryRun=False,
        duration=expectedRenewPeriod,
        services=[
           serviceId
       ]
   )

    client.post('/me/order/{}/payWithRegisteredPaymentMean'.format(order['orderId']),
        paymentMean='paypal',
        paymentMeanId=1234
    )
:if __name__ == '__main__':

    main()

Más información

Interactúe con nuestra comunidad de usuarios en ovh.es/community.


¿Le ha resultado útil esta guía?

Si lo desea, también puede enviarnos sus sugerencias para ayudarnos a mejorar nuestra documentación.

Imágenes, contenido, estructura...: ayúdenos a mejorar nuestra documentación con sus sugerencias.

No podemos tratar sus solicitudes de asistencia a través de este formulario. Para ello, haga clic en "Crear un tíquet" .

¡Gracias! Tendremos en cuenta su opinión.


Otras guías que podrían interesarle...

OVHcloud Community

¡Acceda al espacio de la OVHcloud Community! Resuelva sus dudas, busque información, publique contenido e interactúe con otros miembros de la comunidad.

Discuss with the OVHcloud community

A partir del 1 de enero de 2015, con arreglo a la Directiva 2006/112/CE modificada, los precios IVA incluido pueden variar según el país de residencia del cliente (por defecto, los precios con IVA incluyen el IVA español vigente).