Skip to main content
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.

​
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. 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.
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: 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 para obter informações sobre acesso público e limites de taxa.

​
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.
Endereçado como https://<service>.<region>.basaltic.sh, por exemplo https://compute.sa-saopaulo-1.basaltic.sh.Use um token de portador autorizado para a conta e região.

​
Armazenamento de objetos

O armazenamento de objetos compatível com S3 é o único endpoint que não está no basaltic.sh:
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.

​
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.