---
title: "Configurar um script iPXE personalizado para iniciar o seu servidor através da API OVHcloud"
description: "Descubra como a API OVHcloud lhe permite configurar um script de arranque personalizado PXE para dar bootagem ao seu servidor"
url: https://docs.ovhcloud.com/pt/guides/bare-metal-cloud/dedicated-servers/ipxe-scripts
lang: pt
lastUpdated: 2024-02-27
---
# Configurar um script iPXE personalizado para iniciar o seu servidor através da API OVHcloud

:::info
Esta tradução foi automaticamente gerada pelo nosso parceiro SYSTRAN. Em certos casos, poderão ocorrer formulações imprecisas, como por exemplo nomes de botões ou detalhes técnicos. Recomendamos que consulte a versão inglesa ou francesa do manual, caso tenha alguma dúvida. Se nos quiser ajudar a melhorar esta tradução, clique em "Contribuir" nesta página.

:::

## Objetivo

:::warning
Este artigo destina-se aos utilizadores experientes que tenham no mínimo conhecimentos de base sobre o [lançamento PXE](https://en.wikipedia.org/wiki/Preboot_Execution_Environment) bem como sobre a implementação utilizada na OVHcloud: [PXE](https://ipxe.org/).

:::

Na Área de Cliente OVHcloud
, é possível especificar um modo de boot entre uma lista predefinida: disco principal ou rescue.
Através da [API OVHcloud](https://eu.api.ovh.com/)
, pode também definir scripts personalizados.
Utilizar um script personalizado pode ser interessante nos seguintes casos:

- Utiliza um SO volátil que não deseja instalar no disco e que permanece unicamente em RAM.
- Faz multicloud e um dos outros fornecedores que utiliza não propõe o SO que deseja instalar no seu catálogo, nem soluções alternativas tais como [BringYourOwnImage](/pt/guides/bare-metal-cloud/dedicated-servers/bring-your-own-image.md). Desejando um método único e normalizado de instalação, seja qual for o fornecedor, construiu a sua própria imagem de rescue de instalação para gerir a instalação completa do seu servidor dedicado.

## Requisitos

- Um [servidor dedicado](https://www.ovhcloud.com/pt/bare-metal/) **pronto a ser lançado/reboot** na sua conta OVHcloud.
- Ter acesso à [API OVHcloud](https://eu.api.ovh.com/).

:::warning
A reinicialização de um servidor dedicado pode gerar a interrupção de serviços não redundados que dependem unicamente do servidor reiniciado.

:::

## Instruções

### Gerir um script iPXE para um servidor dedicado [](#)
#### Modificar o script iPXE de um servidor [](#)

🇪🇺EU▾

[PUT/dedicated/server/{serviceName}](https://eu.api.ovh.com/console/?section=/dedicated/server&branch=v1#put-/dedicated/server/-serviceName-)

Especifique o seu script no atributo `bootScript` diretamente.

#### Obter o script iPXE de um servidor [](#)

🇪🇺EU▾

[GET/dedicated/server/{serviceName}](https://eu.api.ovh.com/console/?section=/dedicated/server&branch=v1#get-/dedicated/server/-serviceName-)

O seu script situa-se no atributo `bootScript`.

Por exemplo:

```json
{
    "noIntervention": false,
    "name": "nsXXXXXXX.ip-XXX-XXX-XXX.eu",
    "rack": "SXXXBXX",
    "commercialRange": "fs",
    "os": "debian11_64",
    "rootDevice": null,
    "rescueMail": null,
    "linkSpeed": 1000,
    "bootScript": "#!ipxe\necho Boot first local hdd in LEGACY mode\nsanboot --no-describe --drive 0x80\nexit 1\n",
    "reverse": "nsXXXXXXX.ip-XXX-XXX-XXX.eu",
    "state": "ok",
    "ip": "XXX.XXX.XXX.XXX",
    "bootId": null,
    "newUpgradeSystem": false,
    "datacenter": "sbg3",
    "professionalUse": false,
    "supportLevel": "pro",
    "serverId": 123456,
    "powerState": "poweron",
    "monitoring": false
}
```

Agora pode reiniciar o seu servidor e este irá utilizar o seu script [iPXE](https://ipxe.org/) para o arranque.

### Outros modos de boot [](#)
Pode alternar de novo entre o disco ou o modo rescue a partir da Área de Cliente OVHcloud
 (consulte o nosso guia "[Ativar e utilizar o modo rescue](/pt/guides/bare-metal-cloud/dedicated-servers/rescue-mode.md)
") ou através da [API OVHcloud](https://eu.api.ovh.com/)
.
#### Migrar para disco [](#)

🇪🇺EU▾

[PUT/dedicated/server/{serviceName}](https://eu.api.ovh.com/console/?section=/dedicated/server&branch=v1#put-/dedicated/server/-serviceName-)

Especifique `1` no atributo `bootId`.


🇪🇺EU▾

[GET/dedicated/server/{serviceName}](https://eu.api.ovh.com/console/?section=/dedicated/server&branch=v1#get-/dedicated/server/-serviceName-)

Verificará que o valor do atributo `bootScript` é agora zero.

## Quer saber mais? [](#)
[Reinicialização do seu servidor dedicado](/pt/guides/bare-metal-cloud/dedicated-servers/getting-started-with-dedicated-server.md#reboot)

[Ativar e utilizar o modo rescue](/pt/guides/bare-metal-cloud/dedicated-servers/rescue-mode.md)

[iPXE - open source boot firmware](https://ipxe.org/)

Fale com nossa [comunidade de utilizadores](https://community.ovhcloud.com/).