Use estes endpoints para descobrir quais instâncias estão ativas e alterar a quantidade de réplicas de um projeto. Eles são úteis para automações de escala, rotinas de economia e painéis internos de operação.
Header Obrigatório Descrição x-api-keySim API Key do projeto x-organization-idSim Organização ativa do projeto Content-Type: application/jsonSim Necessário apenas no PATCH
Retorna os identificadores das instâncias atuais do projeto.
GET /project/:id/instances Parâmetro Tipo Descrição idstring ID do projeto (ObjectId)
{ "status" : "success" , "message" : "get instances with success" , "data" : [ { "instance" : "abc" }, { "instance" : "def" } ] } Use o valor de instance em chamadas de métricas e logs quando quiser consultar um container específico.
Altera a quantidade de réplicas do projeto.
PATCH /project/:id/instances Campo Tipo Obrigatório Descrição instancesnumber Sim Nova quantidade de instâncias. Deve ser um inteiro positivo.
{ "status" : "success" , "message" : "project instances changed with success" } Situação Resultado instances igual ao valor atualRetorna 200 sem alteração relevante instances igual a 0Rejeitado. Use Ciclo de Vida para parar o projeto Projeto parado Rejeitado. Use /resume antes de escalar Auto-scaling HTTP ativo Rejeitado. Desative Auto-scaling HTTP antes de alterar manualmente Plano mensal ou anual Pode ser rejeitado em escala manual; prefira auto-scaling quando o plano permitir picos Plano db-free Não permite alteração dinâmica de instâncias MariaDB Exige exatamente 3 instâncias
curl -X GET "https://api.zenifra.com/v1/project/507f1f77bcf86cd799439011/instances" \ -H "x-api-key: sua-api-key" \ -H "x-organization-id: sua-organization-id" curl -X PATCH "https://api.zenifra.com/v1/project/507f1f77bcf86cd799439011/instances" \ -H "x-api-key: sua-api-key" \ -H "x-organization-id: sua-organization-id" \ -H "Content-Type: application/json" \ -d '{"instances": 3}' import requests API_KEY = "sua-api-key" ORGANIZATION_ID = "sua-organization-id" PROJECT_ID = "507f1f77bcf86cd799439011" headers = { "x-api-key" : API_KEY , "x-organization-id" : ORGANIZATION_ID } instances = requests.get( f "https://api.zenifra.com/v1/project/ {PROJECT_ID} /instances" , headers = headers ).json() scale = requests.patch( f "https://api.zenifra.com/v1/project/ {PROJECT_ID} /instances" , headers = headers, json = { "instances" : 3 } ).json() Código Motivo provável Como resolver 400instances ausente, inválido ou igual a 0Envie um inteiro positivo e use /stop para parar 404Projeto não encontrado Verifique Project ID, API Key e organização 409Estado, plano ou auto-scaling ativo não permite escala manual Confira se o projeto está rodando e se o auto-scaling está desativado 500Falha operacional ao aplicar escala Tente novamente ou acione o suporte