Renovar un servicio a través de la API de OVHcloud
Cómo renovar un servicio utilizando la API de OVHcloud
Última actualización: 27/08/2018
Objetivo
OVHcloud 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 OVHcloud.
Requisitos
- Estar conectado a la API de OVHcloud.
- Disponer de las claves para conectarse a la API de OVHcloud - EN.
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 https://community.ovh.com/en/.
¿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.