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

# Regiones y endpoints

> Qué host llamar y qué servicios son globales en lugar de regionales.

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.

<a id="region-codes" />

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

| Región de | Ubicación |
| - | - |
| `sa-saopaulo-1` | São Paulo, Brasil |

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

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

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`:

| Estado | Significado de la palabra |
| - | - |
| `planned` | Anunciado, aún no ofrecido |
| `active` | Ofrecido para nuevos recursos |
| `restricted` | No se ofrece para nuevos recursos |
| `retiring` | Los recursos existentes se están eliminando gradualmente |
| `retired` | Ubicación histórica; su código no se reutiliza |

`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](/es/catalog/permissions) para conocer los límites de acceso público y de velocidad.

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

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

<Tabs>
  <Tab title="Regional">
    Se dirige como `https://<service>.<region>.basaltic.sh`, por ejemplo `https://compute.sa-saopaulo-1.basaltic.sh`.

    | Servicio de mantenimiento | Host |
    | - | - |
    | Compute | `compute.<region>.basaltic.sh` |
    | Red de trabajo | `network.<region>.basaltic.sh` |
    | Balanceador de carga | `loadbalancer.<region>.basaltic.sh` |
    | Almacenamiento de datos | `storage.<region>.basaltic.sh` |
    | Certificado de calidad | `certificate.<region>.basaltic.sh` |
    | KMS | `kms.<region>.basaltic.sh` |
    | Secretos de la vida | `secrets.<region>.basaltic.sh` |
    | Telemetría | `telemetry.<region>.basaltic.sh` |

    Utilice un token al portador autorizado para la cuenta y la región.
  </Tab>

  <Tab title="Global">
    Se dirige como `https://<service>.basaltic.sh` — un extremo, sin segmento de región.

    | Servicio de mantenimiento | Host | Por qué es global |
    | - | - | - |
    | Espacio de trabajo | `workspace.basaltic.sh` | Organización, cuentas, personas y políticas de organización |
    | Catálogo de productos | `catalog.basaltic.sh` | Descubrimiento de la región pública |
    | IAM | `iam.basaltic.sh` | Identidades de cuentas y sesiones en diferentes regiones |
    | Facturación y pago | `billing.basaltic.sh` | Facturación de la organización en todas las cuentas |
    | Cuota | `quota.basaltic.sh` | Gestión de cuotas de organización |
    | Auditoría | `audit.basaltic.sh` | Rastro de auditoría de la organización |
    | DNS | `dns.basaltic.sh` | El espacio de nombres DNS público no es regional |

    El descubrimiento de catálogos es público. Las operaciones autenticadas en los otros servicios utilizan la autenticación de portador. Los servicios de cuenta global todavía requieren autoridad de cuenta; seleccionar **Global** en la consola no es un cambio de cuenta.
  </Tab>
</Tabs>

<a id="object-storage" />

## Almacenamiento de objetos

El almacenamiento de objetos compatible con S3 es el único punto final que no está en `basaltic.sh`:

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

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.

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

## 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](/es/iam/roles#assuming-a-role).


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