Admin
Consulte o contrato e um exemplo de cada operação, sem percorrer uma lista inteira.
Neste artigo
Operações e exemplos
Abra a página do recurso desejado no menu lateral ou nos links abaixo. O exemplo pode ser copiado nas linguagens disponíveis. Os exemplos são referências e não executam chamadas automaticamente.
/api/admin/dashboardResumo administrativo
Totais de contas/projetos e recursos reservados e contratados.
const response = await fetch('https://runixcloud.online/api/admin/dashboard', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/admin/usersContas e pools
Lista plano atual e consumo agregado de RAM/CPU/disco/projetos por conta.
const response = await fetch('https://runixcloud.online/api/admin/users', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/admin/users/:idAtualizar conta
Altera suspensão, role, senha e/ou plano. Impede downgrade abaixo dos recursos já reservados.
{
"plan_id": "<uuid>",
"suspended": false,
"billing_exempt": false
}const response = await fetch('https://runixcloud.online/api/admin/users/SERVER_ID', {
method: 'PATCH',
headers: {
'Authorization': 'Bearer ' + TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"plan_id": "<uuid>",
"suspended": false,
"billing_exempt": false
})
});
console.log(response.status);/api/admin/users/:idExcluir conta
Exclui a conta respeitando a proteção do último admin.
const response = await fetch('https://runixcloud.online/api/admin/users/SERVER_ID', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(response.status);/api/admin/serversTodos os projetos
Projetos de todas as contas com recursos e proprietário.
const response = await fetch('https://runixcloud.online/api/admin/servers', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/admin/plansListar planos
Capacidades dos pools.
const response = await fetch('https://runixcloud.online/api/admin/plans', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/admin/plansCriar plano
Cria um plano.
{
"Name": "Core",
"MemoryMB": 1024,
"CPU": 2,
"DiskMB": 10240,
"MaxServers": 3,
"MonthlyPriceCents": 890,
"AnnualPriceCents": 9078,
"Currency": "BRL",
"BillingEnabled": true,
"IsPublic": true,
"Description": "Plano principal",
"Highlighted": true
}const response = await fetch('https://runixcloud.online/api/admin/plans', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"Name": "Core",
"MemoryMB": 1024,
"CPU": 2,
"DiskMB": 10240,
"MaxServers": 3,
"MonthlyPriceCents": 890,
"AnnualPriceCents": 9078,
"Currency": "BRL",
"BillingEnabled": true,
"IsPublic": true,
"Description": "Plano principal",
"Highlighted": true
})
});
console.log(await response.text());/api/admin/plans/:idAtualizar plano
Substitui capacidades do plano.
{
"Name": "Core",
"MemoryMB": 2048,
"CPU": 2,
"DiskMB": 20480,
"MaxServers": 5,
"MonthlyPriceCents": 1090,
"AnnualPriceCents": 11118,
"Currency": "BRL",
"BillingEnabled": true,
"IsPublic": true,
"Description": "Plano atualizado",
"Highlighted": true
}const response = await fetch('https://runixcloud.online/api/admin/plans/SERVER_ID', {
method: 'PATCH',
headers: {
'Authorization': 'Bearer ' + TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"Name": "Core",
"MemoryMB": 2048,
"CPU": 2,
"DiskMB": 20480,
"MaxServers": 5,
"MonthlyPriceCents": 1090,
"AnnualPriceCents": 11118,
"Currency": "BRL",
"BillingEnabled": true,
"IsPublic": true,
"Description": "Plano atualizado",
"Highlighted": true
})
});
console.log(response.status);/api/admin/plans/:idExcluir plano
Exclui somente plano sem usuários.
const response = await fetch('https://runixcloud.online/api/admin/plans/SERVER_ID', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(response.status);/api/admin/clustersListar clusters
Lista clusters lógicos, região, estado de manutenção, capacidade agregada e projetos.
const response = await fetch('https://runixcloud.online/api/admin/clusters', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/admin/clustersCriar cluster
Cria um grupo lógico de nodes sem mover projetos existentes.
{
"name": "São Paulo 01",
"slug": "sao-paulo-01",
"region": "Brasil · São Paulo",
"weight": 100,
"enabled": true,
"maintenance": false
}const response = await fetch('https://runixcloud.online/api/admin/clusters', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"name": "São Paulo 01",
"slug": "sao-paulo-01",
"region": "Brasil · São Paulo",
"weight": 100,
"enabled": true,
"maintenance": false
})
});
console.log(await response.text());/api/admin/clusters/:idAtualizar cluster
Altera nome, região, peso, disponibilidade e modo manutenção.
{
"maintenance": true
}const response = await fetch('https://runixcloud.online/api/admin/clusters/SERVER_ID', {
method: 'PATCH',
headers: {
'Authorization': 'Bearer ' + TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"maintenance": true
})
});
console.log(response.status);/api/admin/clusters/:idExcluir cluster
Exclui somente clusters sem nodes vinculados.
const response = await fetch('https://runixcloud.online/api/admin/clusters/SERVER_ID', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(response.status);/api/admin/nodesListar nodes
Lista nodes, cluster, heartbeat, capacidade e reservas usadas pelo scheduler.
const response = await fetch('https://runixcloud.online/api/admin/nodes', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/admin/nodesCriar node
Cadastra e testa um Docker Engine remoto. Em produção use HTTPS/TLS.
{
"Name": "node-1",
"Hostname": "node-1",
"Address": "https://10.0.0.2:2376",
"Port": 2376,
"Memory": 0,
"Disk": 102400,
"Weight": 100,
"cluster_id": "<uuid>"
}const response = await fetch('https://runixcloud.online/api/admin/nodes', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"Name": "node-1",
"Hostname": "node-1",
"Address": "https://10.0.0.2:2376",
"Port": 2376,
"Memory": 0,
"Disk": 102400,
"Weight": 100,
"cluster_id": "<uuid>"
})
});
console.log(await response.text());/api/admin/nodes/:idExcluir node
Exclui registro do node.
const response = await fetch('https://runixcloud.online/api/admin/nodes/SERVER_ID', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(response.status);/api/admin/nodes/:idAtualizar node
Atualiza endpoint, peso, limites administrativos e habilitação do node.
const response = await fetch('https://runixcloud.online/api/admin/nodes/SERVER_ID', {
method: 'PATCH',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(response.status);/api/admin/nodes/:id/testTestar node
Executa heartbeat imediato e atualiza a capacidade detectada.
const response = await fetch('https://runixcloud.online/api/admin/nodes/SERVER_ID/test', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/admin/servers/:id/moveMigrar projeto
Copia o workspace e recria o container no node de destino preservando configuração e reserva.
{
"node_id": "<uuid>"
}const response = await fetch('https://runixcloud.online/api/admin/servers/SERVER_ID/move', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"node_id": "<uuid>"
})
});
console.log(await response.text());/api/admin/billingCobranças
Lista pagamentos recentes e totais processados pelo Mercado Pago.
const response = await fetch('https://runixcloud.online/api/admin/billing', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/admin/couponsCupons
Lista cupons, usos confirmados, reservas e vínculos de desconto automático.
const response = await fetch('https://runixcloud.online/api/admin/coupons', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/admin/ticketsFila de suporte
Lista tickets de todas as contas.
const response = await fetch('https://runixcloud.online/api/admin/tickets', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/admin/tickets/:idAtender ticket
Atualiza status/prioridade e pode enviar resposta de suporte.
const response = await fetch('https://runixcloud.online/api/admin/tickets/SERVER_ID', {
method: 'PUT',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/admin/settingsConfigurações da plataforma
Retorna settings persistentes e status seguro das integrações, sem expor segredos.
const response = await fetch('https://runixcloud.online/api/admin/settings', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/admin/settingsSalvar configurações
Atualiza configurações operacionais persistentes.
const response = await fetch('https://runixcloud.online/api/admin/settings', {
method: 'PUT',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(response.status);/api/admin/auditAuditoria
Lista até 200 registros de audit_logs.
const response = await fetch('https://runixcloud.online/api/admin/audit', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/admin/orphansContainers órfãos
Containers runix.managed sem registro correspondente.
const response = await fetch('https://runixcloud.online/api/admin/orphans', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());