Ir para o conteúdo
NimbusNexus

Solicitações de região

Por padrão, as contas novas recebem acesso a uma região (a que escolheram no cadastro). Para adicionar acesso a outras regiões, é preciso uma solicitação de região — um formulário curto que explica a carga de trabalho que precisa da nova região. A maioria das contas de produção é aprovada em até um dia útil; esse controle existe para o planejamento de capacidade e para sinalizar padrões incomuns (uma conta recém-criada pedindo capacidade em cinco regiões no primeiro dia merece uma conversa rápida).

Este endpoint também cuida dos aumentos de cota — uma solicitação para aumentar o limite de quantidade de VMs, de vCPU ou de armazenamento em uma região à qual você já tem acesso. O motivo do controle é o mesmo: solicitações grandes exigem planejamento de capacidade. Veja Cotas para o modelo de cotas em si.

Esta parte da API existe para que um deploy programático possa disparar a solicitação e seguir adiante; a aprovação continua acontecendo manualmente do nosso lado (este é um dos poucos cantos da API que, por design, não são totalmente self-service).

Próximos passos

  • Regiões — a lista de regiões disponíveis.
  • Cotas — os limites por projeto que uma solicitação de região também pode ajustar.
  • Visão geral da conta — o contexto da conta para o acesso a regiões.

Reference

POST/api/v1/account/region-requests

Submit Region Request

Records a region request. Idempotent in spirit — duplicate submissions from the same email + region are accepted as separate rows so analytics can see the strength of demand over time. Rate limiting on the proxy side keeps this from being abused. Originating IP is captured for fraud forensics; auto-purged after 365 days by the retention job.

Request body

FieldTypeDescription
email*string—
regionCode*string—
regionOtherTextstring | null—
companystring | null—
notestring | null—

Responses

  • 200Successful Response
  • 400Bad Request
  • 422Validation error
  • 500Internal Server Error

Example

curl -X POST "https://api.nimbusnexus.net/api/v1/account/region-requests" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "regionCode": "example"
  }'

Need to make a real call? Try these endpoints in the live Swagger UI →