Skip to main content
Cada API de Basaltic se dirige por servicio, en su propio nombre de host. No hay un único host de puerta de enlace de API.

​
Códigos de región

Un código de región es <continent>-<metro>-<n> — el prefijo geográfico es un continente estricto, y el token metro es lo que lleva la jurisdicción legal en la que se encuentran tus datos. GET https://catalog.basaltic.sh/v1/regions devuelve el catálogo de regiones públicas. No necesita autenticación ni cuenta seleccionada, por lo que es una primera llamada útil para confirmar la conectividad. Obtener una región con GET /v1/regions/{code} en el mismo host.
La lista contiene regions y un código de región default. Cada región tiene un code estable, un catálogo crn, un name de visualización, location, country_code, y un ciclo de vida state: accepting_new_resources es válido solo para regiones active. available es un alias para ese campo, y coming_soon es verdadero para regiones planned. Estos describen el ciclo de vida del catálogo, no el estado del servicio en vivo o la capacidad disponible. La API del producto sigue comprobando los permisos, las cuotas y la ubicación de los recursos. El valor por defecto es una región aceptada en la lista devuelta, o una cadena vacía cuando no se ofrece ninguna. Los filtros exactos name y crn pueden reducir la lista. Los códigos de región desconocidos devuelven 404. Las respuestas correctas se pueden almacenar en caché de forma privada durante 60 segundos. El antiguo GET https://iam.basaltic.sh/v1/regions sigue disponible para los clientes existentes, con su forma de respuesta original y CRNs de región IAM. Los nuevos clientes deben usar Catálogo. Consulte Permisos del catálogo para conocer los límites de acceso público y de velocidad.

​
Servicios globales y regionales

El alcance geográfico y la propiedad son independientes. Workspace administra los recursos de la organización a nivel global. IAM y DNS administran los recursos de propiedad de la cuenta globalmente. Los recursos de computación, redes y almacenamiento se administran en la región seleccionada.
Se dirige como https://<service>.<region>.basaltic.sh, por ejemplo https://compute.sa-saopaulo-1.basaltic.sh.Utilice un token al portador autorizado para la cuenta y la región.

​
Almacenamiento de objetos

El almacenamiento de objetos compatible con S3 es el único punto final que no está en basaltic.sh:
Se encuentra en un dominio separado, fuera del dominio del producto, porque está impulsado por los SDK de AWS ordinarios y firmado con AWS Signature Version 4 en lugar de autenticarse con un token portador de plano de control. Apunte cualquier cliente de S3 a él como un punto final personalizado. El lado de gestión del almacenamiento — volúmenes, instantáneas, ciclo de vida del bucket — está en storage.<region>.basaltic.sh con el resto de la API de la plataforma.

​
Seleccionar una cuenta

Las solicitudes de API de cuentas identifican la cuenta seleccionada con X-Account-Id. Los tokens de cuenta de servicio y de rol permanecen vinculados a su cuenta; cambiar el encabezado no otorga acceso a otra cuenta. Usa una suposición de rol explícita para acceso entre cuentas.