Developer Network

Documentação

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

Isos

Manipulando Isos em servidores cloud via API

Listagem de Isos Disponíveis

Lista todas as Isos disponíveis para um determinado servidor cloud.

GET:
• https://DOMINIO/v1/cloud/servers/SERVER_NAME/isos/available_isos

Retorno:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

{
  "data": [
    {
      "type": "isos",
      "id": 22,
      "attributes": {
        "name": "System Rescue 4.1",
        "description": "Sistema operacional utilizado para reparar servidores que com problemas na inicialização ou corrompidos após travamento.",
        "iso_name": "systemrescuecd-x86-4.1.0.iso",
        "shared": true,
        "bootable": true,
        "integration_code": "",
        "hypervisor": "xen"
      }
    },
    {
      "type": "isos",
      "id": 20,
      "attributes": {
        "name": "XenServer Tools",
        "description": "Ferramenta com um conjunto de scripts que integram as maquinas virtuais à sua infraestrutura.",
        "iso_name": "xs-tools.iso",
        "shared": true,
        "bootable": false,
        "integration_code": "",
        "hypervisor": "xen"
      }
    }
  ],
  "meta": {
    "total": 2
  }
}

Verificando Iso inserido no servidor Cloud

Verifica se há uma Isos inserida no Servidor.

GET:
• https://DOMINIO/v1/cloud/servers/SERVER_NAME/isos/inserted_iso_cd

Caso exista, retorna informações da Iso inserida.

Retorno:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

{
  "type": "isos",
  "id": 22,
  "attributes": {
    "name": "System Rescue 4.1",
    "description": "Sistema operacional utilizado para reparar servidores que com problemas na inicialização ou corrompidos após travamento.",
    "iso_name": "systemrescuecd-x86-4.1.0.iso",
    "shared": true,
    "bootable": true,
    "integration_code": "",
    "hypervisor": "xen"
  },
  "relationships": {
    "server": {
      "links": {
        "related": "https://api-servidores.qa.locaweb.com.br/v1/cloud/servers/qacpro0989"
      }
    }
  }
}

Caso não exista, retorna uma mensagem de erro e HTTP Code 404(Not found).

Retorno:

1
2
3
4
5
6

{
  "errors": {
    "status": "not_found",
    "detail": "There is no ISO cd inserted on this virtual machine"
  }
}

Inserir Iso em um servidor Cloud

Realiza a inserção uma iso em um servidor Cloud.

Essa ação só pode ser realizado com Isos disponíveis para o servidor cloud.

PUT:
• https://DOMINIO/v1/cloud/servers/SERVER_NAME/isos/ISO_ID/mount

Retorno:

Código Resposta HTTP: 202

Excluir Iso de um servidor Cloud

Exclusão de Iso inserida em um servidor Cloud.

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

Código Resposta HTTP: 204