Developer Network

Documentação

Informações e instruções das APIs dos produtos Locaweb.

Cloud On Demand

Manipulando servidores cloud On Demand via API.

Listagem de servidores

Os servidores Cloud On Demand são listados em conjunto dos servidores Cloud Server Pro. Mais informações em Cloud Server Pro.

Instalação de Cloud On Demand

É possível realizar a instalação de novos servidores Cloud On Demand via API. A quantidade é limitados a dois servidores por cliente.

Parâmetro Descrição Valor Obrigatório
title Nome do servidor "Nome do servidor" Sim
memory Valor de memória RAM do servidor em megabytes. Variam de 512MB a 32GB.

Os possíveis valores são:

  • 512
  • 1024
  • 2048
  • 3072
  • 4096
  • 5120
  • 6144
  • 7168
  • 8192
  • 9216
  • 10240
  • 11264
  • 12288
  • 16384
  • 32768
 Sim
cpus

Número de vCPUs do servidor.

Valor deve ser relacionado à memória selecionada RAM:

  • 2 vCPUs (512MB a 6G)
  • 4 vCPUs (7GB a 12GB)
  • 6 vCPUs (16GB)
  • 8 vCPUs (32GB)
  • 2
  • 4
  • 6
  • 8
 Sim
hdd

Espaço em disco disponível para utilização. O espaço livre para uso, o sistema operacional. Valores de espaço em disco variam de 10MB a 500GB com incrementos de 10GB.

Quando utilizando uma uma de template customizado, não é necessário informar o espaço em disco.

Valores possíveis:

  • 10
  • 20
  • 30
  • 40
  • 50
  • ...
  • 480
  • 490
  • 500
 Sim, caso o atributo "custom_template_id" não seja informado
image

O identificador da imagem padrão a ser instalada no servidor.

No identificador da imagem são informados:

  • Sistema operacional e versão
  • Processador 64 ou 32-bit
  • Aplicação (em alguns casos)
  • Plataforma de revenda (em alguns casos)
  • windows-2008-r2-datacenter-edition-64
  • windows-2012-r2-datacenter-edition-64
  • centos-6-32
  • centos-6-64
  • centos-7-64
  • centos-7-lamp-64
  • centos-7-wordpress-64
  • cpanel-linux-64
  • debian-7-64
  • debian-7-32
  • debian-8-64
  • debian-8-lamp-64
  • opensuse-13-64
  • plesk-12-5-linux-64
  • plesk-12-5-windows-64
  • ubuntu-12-04-lts-64
  • ubuntu-14-04-lts-64
  • ubuntu-14-04-lts-32
  • ubuntu-16-04-lts-64
 Sim, caso o atributo "custom_template_id" não seja informado
custom_template_id

ID do template customizado a ser instalado no servidor. Ver Template customizado

Caso o template customizado seja utilizado, não enviar o parâmetro "image"

 Id do template customizado Sim, caso o atributo "image" não seja informado
additional_service_code

Em servidores Windows, há a opção de instalar um servidor com licença de banco de dados SQL Server.

LICENCA_SQL_2008_WEB

LICENCA_SQL_2012_WEB

 Não
POST:
• https://DOMINIO/v1/on_demand/servers/

Retorno:

1
2
3
4
5
6
7
8
9
10
11
12
13
14

{
 "data": {
   "type": "servers",
   "attributes": {
     "price": 0.424,
     "title": "Shrbrk",
     "cpus": 2,
     "memory": 1024,
     "image": "ubuntu-16-04-lts-64",
     "hdd": 10,
     "transfer": 1048576
   }
 }
}

Consultar custo e validar configuração do servidor

É possível consultar o valor por hora do servidor a ser instalado utilizando a chamada abaixo e enviando os mesmos parâmetros para instalação do servidor Cloud On Demand:

Parametros: Mesmos de instalação de Cloud On Demand

POST:
• https://DOMINIO/v1/on_demand/servers/check_config

Retorno:

1
2
3
4
5
6
7
8
9
10
11
12
13
14

{
 "data": {
   "type": "servers",
   "attributes": {
     "price": 0.424,
     "title": "Shrbrk",
     "cpus": 2,
     "memory": 1024,
     "image": "ubuntu-16-04-lts-64",
     "hdd": 10,
     "transfer": 1048576
   }
 }
}

Excluir um servidor Cloud On Demand

Exclusão de um servidor Cloud On Demand.

Obs.: Esta ação só pode ser executada em servidores Cloud on Demand.

DELETE:
• https://DOMINIO/v1/cloud/servers/SERVER_NAME/

Caso não seja um servidor Cloud On Demand, retorna uma mensagem de erro e HTTP Code 401(Unauthorized).

Retorno:

1
2
3
4
5
6

{
  "errors": {
    "status": "unauthorized",
    "detail": "You do not have permission to execute it."
  }
}

Caso seja um servidor Cloud On Demand

Retorno (sucesso): Resposta HTTP: 204