> ## Documentation Index
> Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Regiões e endpoints

> Qual host para chamar e quais serviços são globais em vez de regionais.

Cada API Basaltic é endereçada por serviço, em seu próprio nome de host. Não há um único host de gateway de API.

<a id="region-codes" />

## Códigos de região

Um código de região é `<continent>-<metro>-<n>` — o prefixo geográfico é um continente estrito, e o token metro é o que carrega a jurisdição legal em que seus dados estão localizados.

| Região de Lisboa | Localização |
| - | - |
| `sa-saopaulo-1` | Rio de Janeiro, Brasil |

`GET https://catalog.basaltic.sh/v1/regions` retorna o catálogo de regiões públicas. Não precisa de autenticação ou conta selecionada, por isso é uma primeira chamada útil para confirmar a conectividade. Obtenha uma região com `GET /v1/regions/{code}` no mesmo host.

```bash theme={null}
curl https://catalog.basaltic.sh/v1/regions
curl https://catalog.basaltic.sh/v1/regions/sa-saopaulo-1
```

A lista contém `regions` e um código de região `default`. Cada região tem um `code` estável, um catálogo `crn`, um display `name`, `location`, `country_code`, e um ciclo de vida `state`:

| Estado | Significado da palavra |
| - | - |
| `planned` | Anunciado, ainda não oferecido |
| `active` | Oferecida para novos recursos |
| `restricted` | Não oferecido para novos recursos |
| `retiring` | Os recursos existentes estão sendo eliminados gradualmente |
| `retired` | Localização histórica; seu código não é reutilizado |

`accepting_new_resources` é verdadeiro apenas para regiões `active`. `available` é um alias para esse campo, e `coming_soon` é verdadeiro para regiões `planned`. Eles descrevem o ciclo de vida do catálogo, não a integridade do serviço em tempo real ou a capacidade disponível. A API do produto ainda verifica suas permissões, cotas e colocação de recursos.

O padrão é uma região de aceitação na lista retornada, ou uma string vazia quando nenhuma é oferecida. Filtros exatos `name` e `crn` podem restringir a lista. Códigos de região desconhecidos retornam 404. As respostas bem-sucedidas podem ser armazenadas em cache de forma privada por 60 segundos.

O antigo `GET https://iam.basaltic.sh/v1/regions` permanece disponível para clientes existentes, com sua forma de resposta original e CRNs de região do IAM. Novos clientes devem usar o Catálogo. Consulte [Catalog permissions](/pt/catalog/permissions) para obter informações sobre acesso público e limites de taxa.

<a id="global-and-regional-services" />

## Serviços globais e regionais

O escopo geográfico e a propriedade são separados. O Workspace gerencia os recursos da organização globalmente. O IAM e o DNS gerenciam recursos de propriedade da conta globalmente. A computação, a rede e o armazenamento gerenciam recursos na região selecionada.

<Tabs>
  <Tab title="Regional">
    Endereçado como `https://<service>.<region>.basaltic.sh`, por exemplo `https://compute.sa-saopaulo-1.basaltic.sh`.

    | Serviço de Atendimento | Host |
    | - | - |
    | Compute em Português | `compute.<region>.basaltic.sh` |
    | Rede de trabalho | `network.<region>.basaltic.sh` |
    | Balanceador de carga | `loadbalancer.<region>.basaltic.sh` |
    | Armazenamento de dados | `storage.<region>.basaltic.sh` |
    | Certificado de qualidade | `certificate.<region>.basaltic.sh` |
    | KMS | `kms.<region>.basaltic.sh` |
    | Segredos de Amor | `secrets.<region>.basaltic.sh` |
    | Telemetria de dados | `telemetry.<region>.basaltic.sh` |

    Use um token de portador autorizado para a conta e região.
  </Tab>

  <Tab title="Global">
    Endereçado como `https://<service>.basaltic.sh` — um ponto final, sem segmento de região.

    | Serviço de Atendimento | Anfitrião | Por que é global |
    | - | - | - |
    | Espaço de trabalho | `workspace.basaltic.sh` | Organização, contas, pessoas e políticas da organização |
    | Catálogo de Produtos | `catalog.basaltic.sh` | Public region discovery |
    | IAM | `iam.basaltic.sh` | Identidades de conta e sessões em todas as regiões |
    | Faturação e pagamentos | `billing.basaltic.sh` | Faturação da organização em contas |
    | Quota de participação | `quota.basaltic.sh` | Gestão de quotas da organização |
    | Auditoria de Contas | `audit.basaltic.sh` | Trilha de auditoria da organização |
    | DNS | `dns.basaltic.sh` | O namespace DNS público não é regional |

    A descoberta de catálogo é pública. As operações autenticadas nos outros serviços usam a autenticação de portador. Os serviços de conta global ainda exigem autoridade de conta; selecionar **Global** no console não é uma troca de conta.
  </Tab>
</Tabs>

<a id="object-storage" />

## Armazenamento de objetos

O armazenamento de objetos compatível com S3 é o único endpoint que não está no `basaltic.sh`:

```
https://objects.<region>.basaltic.cloud
```

Ele está em um domínio separado deliberadamente, fora do domínio do produto, porque é impulsionado por SDKs comuns da AWS e assinado com o AWS Signature Version 4, em vez de autenticado com um token de portador de plano de controle. Aponte qualquer cliente do S3 para ele como um endpoint personalizado.

O lado *gerenciamento* do armazenamento — volumes, snapshots, ciclo de vida do bucket — está em `storage.<region>.basaltic.sh` com o resto da API da plataforma.

<a id="selecting-an-account" />

## Selecionar uma conta

As solicitações de API de conta identificam a conta selecionada com `X-Account-Id`. Os tokens de conta de serviço e de função permanecem vinculados à conta; alterar o cabeçalho não concede acesso a outra conta. Use uma suposição de função explícita para [acesso entre contas](/pt/iam/roles#assuming-a-role).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.