El teu allotjament, des del terminal.

Consulta els teus llocs i VPS, automatitza tasques i accedeix al catàleg d’eines autoritzat per al teu compte. Un fitxer Python, sense dependències externes.

Descarregar hostbrid.py Guia completa del CLI

hostbrid · CLIPython 3

$ python3 ~/bin/hostbrid tools show hostbrid_get_plan

Pla contractat

Consulta l’ús i els límits de llocs, bases de dades, dominis, bústies i disc del teu pla.

sitios:leer

{
  "type": "object",
  "properties": {}
}

Exemples de lectura · sense crear recursos

Python 3 · biblioteca estàndard · JSON

01 / Instal·lació

Instal·la una vegada. Fes-lo servir als scripts.

Necessites Python 3. La descàrrega es desa al teu equip: pots revisar el fitxer abans d’executar-lo. Els exemples fan servir la ruta completa; afegeix ~/bin al PATH si prefereixes escriure hostbrid.

Guia completa del CLI →

mkdir -p ~/bin
curl --fail --show-error --location \
  https://my.hostbrid.com/cli/hostbrid.py \
  --output ~/bin/hostbrid
chmod 700 ~/bin/hostbrid
python3 ~/bin/hostbrid --help

02 / Recursos

Comença pels teus recursos

Les ordres directes cobreixen tasques habituals de llocs, DNS, correu i màquines. Fes servir --help per consultar les opcions i --json per processar la resposta.

python3 ~/bin/hostbrid sites list
python3 ~/bin/hostbrid maquinas list
python3 ~/bin/hostbrid sites list --json

03 / Eines

Descobreix abans d’executar

tools list consulta per MCP el catàleg que permet la teva clau. tools show mostra l’esquema d’una eina; tools call l’executa amb arguments JSON. Les ordres directes i el catàleg MCP conviuen al mateix client. El catàleg públic de plans es consulta sense clau amb --public; és independent del catàleg del teu compte.

MCP →

python3 ~/bin/hostbrid tools list
python3 ~/bin/hostbrid tools list --filter plan
python3 ~/bin/hostbrid tools show hostbrid_get_plan
python3 ~/bin/hostbrid tools call hostbrid_get_plan --arguments '{}'

python3 ~/bin/hostbrid tools call hostbrid_listar_planes_publicos \
  --arguments '{"tipo_recurso":"vps","limite":3}' --public

04 / JSON

JSON per als teus pipelines

Desa la resposta, processa-la amb jq o passa-la al pas següent del CI. A tools call pots carregar arguments des de @arguments.json o des de l’entrada estàndard amb @-. Comprova el codi de sortida abans de continuar.

python3 ~/bin/hostbrid sites list --json > sites.json
jq . sites.json

printf '%s' '{}' | python3 ~/bin/hostbrid tools call hostbrid_get_plan --arguments @-

Autenticació

Una clau amb els permisos que necessites

Crea la clau al panell i lliura HOSTBRID_TOKEN al procés des d’un gestor de secrets. No l’escriguis en repositoris, prompts ni registres. Les claus noves són de lectura; els permisos addicionals es concedeixen per separat. Revoca la clau al panell quan deixis de fer-la servir o si s’exposa.

Gestionar claus API →

API · CLI · MCP

Les confirmacions continuen vigents

El CLI no amplia els permisos de la clau ni evita les confirmacions del servidor. Preparar una compra no la paga: revisa i confirma el pagament al panell. Els esborraments i altres operacions sensibles conserven les previsualitzacions i els controls de confirmació.