> ## 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.
# Listar réplicas de instancias del balanceador con su estado actual
> Devuelve una entrada por instancia de cálculo que respalda el LB. La superposición `proxy_ok` + `last_seen` por réplica se actualiza en cada informe de estado de la réplica (normalmente cada 15 segundos) y está ausente cuando una réplica aún no ha informado (el arranque todavía está en curso).
Requiere la acción de IAM **`loadbalancer:GetLoadBalancer`**. Consulta [permisos de balanceadores de carga](/loadbalancer/permissions) para obtener la lista completa, lo que cubre cada una y un ejemplo de directiva.
## OpenAPI
````yaml /es/api-reference/specs/loadbalancer.yaml get /v1/load-balancers/{id}/replicas
openapi: 3.0.3
info:
title: API de equilibrador de carga basaltico
version: 1.0.0
description: >
Las relaciones de solicitud aceptan referencias clasificadas por sintaxis
resueltas dentro de la cuenta y región del llamador. Las referencias IP
flotantes solo aceptan UUID o CRN; los destinos IP permanecen literales.
Balanceadores de carga administrados: escuchas, grupos de destino,
comprobaciones de estado y los certificados TLS que termina una escucha.
contact:
name: Basaltic Support
email: ping@basaltic.sh
license:
name: Proprietary
url: https://basaltic.sh/terms
servers:
- url: https://loadbalancer.{region}.basaltic.sh
description: Punto final de API regional
variables:
region:
default: sa-saopaulo-1
description: Código de región
security:
- BearerAuth: []
paths:
/v1/load-balancers/{id}/replicas:
get:
tags:
- Load Balancers
summary: Listar réplicas de instancias del balanceador con su estado actual
description: >
Devuelve una entrada por instancia de cálculo que respalda el LB. La
superposición `proxy_ok` + `last_seen` por réplica se actualiza en cada
informe de estado de la réplica (normalmente cada 15 segundos) y está
ausente cuando una réplica aún no ha informado (el arranque todavía está
en curso).
operationId: listLoadBalancerReplicas
parameters:
- name: name
in: query
description: >-
Nombre exacto inmutable. Un valor vacío o un recurso sin nombre no
selecciona filas.
schema:
type: string
- name: crn
in: query
description: >-
CRN con alcance exacto. Los CRN extraños o no coincidentes no
seleccionan filas; los CRN malformados o vacíos devuelven 400.
schema:
type: string
- name: id
in: path
required: true
schema:
type: string
example: 4e1f8c2a-9b3d-4f6e-8a1c-2d5e7f9a0b3c
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/LoadBalancerReplicasResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
components:
schemas:
LoadBalancerReplicasResponse:
type: object
properties:
replicas:
type: array
items:
$ref: '#/components/schemas/LoadBalancerReplica'
LoadBalancerReplica:
type: object
description: >
Una instancia de cómputo que sostiene el balanceador de carga. Los
campos de identificación y registro (instance_id, replica_index,
created_at, flavor_id) se conservan; los datos de actividad (last_seen,
proxy_ok, agent_version) se actualizan con cada informe de estado de la
réplica.
Las réplicas son instancias administradas y no aparecen en los endpoints
de instancias de cómputo. Consúltalas aquí. Durante un cambio de tamaño
se sustituyen de una en una: un cambio de instance_id indica que se ha
sustituido una réplica, y el proceso termina cuando todos los valores de
flavor_id coinciden con el del balanceador. Durante el cambio, la lista
puede incluir una réplica más que replica_count para mantener la
capacidad. Esa réplica adicional desaparece al retirar la última réplica
antigua.
required:
- instance_id
- replica_index
- created_at
- flavor_id
- proxy_ok
- status
properties:
retirement:
$ref: '#/components/schemas/Retirement'
instance_id:
type: string
format: uuid
example: a7b8c9d0-e1f2-4345-a6b7-c8d9e0f1a2b3
replica_index:
type: integer
example: 0
created_at:
type: string
format: date-time
example: '2026-01-15T09:30:00Z'
flavor_id:
type: string
format: uuid
example: e5f6a7b8-c9d0-4123-e4f5-a6b7c8d9e0f1
description: >-
El tamaño en el que esta réplica realmente arrancó. Coincide con el
flavor_id del balanceador de carga excepto mid-resize, cuando las
réplicas que aún no se han reemplazado siguen informando la antigua.
status:
type: string
enum:
- initializing
- healthy
- unhealthy
- draining
example: healthy
description: >-
Estado de actividad resumido: 'initializing' (el agente todavía no
ha enviado ningún informe; el arranque sigue en curso), 'healthy'
(hay señales de actividad y el proxy atiende tráfico) o 'unhealthy'
(hay señales de actividad, pero el proxy no está disponible).
proxy_ok:
type: boolean
description: Si el proxy informó que estaba listo en el último informe de estado
example: true
agent_version:
type: string
example: 1.4.2
last_seen:
type: string
format: date-time
description: Se omite cuando esta réplica no ha reportado aún
example: '2026-01-15T09:31:00Z'
Error:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
- request_id
properties:
code:
type: string
description: Código de error que identifica el tipo de error
example: INVALID_INPUT
message:
type: string
description: Mensaje de error legible por el ser humano
example: Invalid request parameters
params:
type: object
additionalProperties: true
description: >-
Valores no sensibles opcionales para la interpolación de errores
localizados, codificados por código de error. Nunca presente por
errores del servidor.
example:
instances: 2
pools: 0
request_id:
type: string
format: uuid
description: Solicitar ID para depuración
example: 550e8400-e29b-41d4-a716-446655440000
Retirement:
type: object
readOnly: true
required:
- requested_at
- drain_seconds
properties:
requested_at:
type: string
format: date-time
drain_seconds:
type: integer
minimum: 30
maximum: 3600
agent_acknowledged_at:
type: string
format: date-time
drain_until:
type: string
format: date-time
description: >-
Hora de eliminación más temprana; ausente mientras la retirada está
pendiente.
responses:
Unauthorized:
description: Se requiere autenticación o el token no es válido
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UNAUTHORIZED
message: Authentication required
request_id: 550e8400-e29b-41d4-a716-446655440000
Forbidden:
description: Permisos insuficientes
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: ACCESS_DENIED
message: You don't have permission to perform this action
request_id: 550e8400-e29b-41d4-a716-446655440000
NotFound:
description: No se encontró el recurso
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: NOT_FOUND
message: Resource not found
request_id: 550e8400-e29b-41d4-a716-446655440000
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: >+
Un token bearer de OAuth 2.0, enviado como `Authorization: Bearer
`. Esta es la forma recomendada de autenticación.
Obtén el token intercambiando el par de claves de acceso de una cuenta
de servicio en `POST /v1/oauth/token` con
`grant_type=client_credentials`. Es el flujo estándar de credenciales de
cliente; las bibliotecas compatibles con OAuth pueden obtener y renovar
el token por ti.
```
curl -s -u "$KEY_ID:$SECRET" -d grant_type=client_credentials \
https://iam.basaltic.sh/v1/oauth/token
```
Los tokens duran una hora por defecto. El mismo par de claves de acceso
también sirve como credencial AWS SigV4 para el endpoint de objetos
compatible con S3, que solo acepta ese método de autenticación.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.