> ## 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 tipos de instancia
> Enumera todas las variantes de instancia disponibles. El catálogo es pequeño y se vuelve a mostrar de una sola vez; este punto final no está paginado.
Requiere la acción de IAM **`compute:ListFlavors`**. Consulte [permisos de computación](/es/compute/permissions) para obtener la lista completa, lo que cubre cada una y un ejemplo de directiva.
## OpenAPI
````yaml /es/api-reference/specs/compute.yaml get /v1/flavors
openapi: 3.0.3
info:
title: Basaltic Compute API
version: 1.0.0
description: >
Instancias de máquinas virtuales y las imágenes, los tipos de instancia y
los grupos de instancias a partir de los cuales se crean. Cubre todo el
ciclo de vida de la instancia: inicio, parada, reinicio, cambio de tamaño y
reinstalación.
contact:
name: Basaltic Support
email: ping@basaltic.sh
license:
name: Proprietary
url: https://basaltic.sh/terms
servers:
- url: https://compute.{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/flavors:
get:
tags:
- Compute
summary: Listar tipos de instancia
description: >-
Enumera todas las variantes de instancia disponibles. El catálogo es
pequeño y se vuelve a mostrar de una sola vez; este punto final no está
paginado.
operationId: listFlavors
parameters:
- $ref: '#/components/parameters/ComputeNameFilter'
- $ref: '#/components/parameters/ComputeCRNFilter'
- name: family
in: query
description: >-
Filtrar por familia de productos. Los flujos de creación de
balanceador de carga y base de datos deben listar su propia familia;
las instancias regulares usan "general".
schema:
type: string
enum:
- general
- loadbalancer
- database
example: general
responses:
'200':
description: Lista de tipos de instancia
content:
application/json:
schema:
$ref: '#/components/schemas/FlavorListResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'500':
$ref: '#/components/responses/InternalServerError'
security:
- BearerAuth: []
components:
parameters:
ComputeNameFilter:
name: name
in: query
description: >-
Nombre exacto, que distinga entre mayúsculas y minúsculas. Los valores
vacíos no coinciden con recursos con nombre. Las listas de NIC de
instancia coinciden con los nombres de interfaz dentro de las
vinculaciones de instancia; pueden coincidir varias interfaces con el
mismo nombre. Las IP flotantes no tienen identidad de nombre y devuelven
una lista vacía para este filtro.
schema:
type: string
ComputeCRNFilter:
name: crn
in: query
description: >-
CRN exacto del recurso, intersecado con todos los demás filtros antes de
la paginación. Un CRN extranjero o no coincidente devuelve una página
vacía; los CRN mal formados o vacíos devuelven 400. Las listas de
archivos adjuntos anidados filtran el recurso representado, no el
enlace.
schema:
type: string
schemas:
FlavorListResponse:
type: object
properties:
flavors:
type: array
items:
$ref: '#/components/schemas/Flavor'
Flavor:
type: object
description: >-
Un tamaño de cálculo (vCPU + RAM). Un tipo de instancia no tiene tamaño
de disco — el disco de arranque es un volumen de cliente con el tamaño
al inicio, limitado por el min_disk_gb de la imagen.
properties:
id:
type: string
format: uuid
readOnly: true
example: 550e8400-e29b-41d4-a716-446655440000
crn:
type: string
readOnly: true
description: Nombre de recurso de la nube
example: crn:compute:sa-saopaulo-1:platform:flavor/standard-2
name:
description: >-
Los nombres de los recursos no deben comenzar con el prefijo literal
crn: ni ser UUID (en cualquier caso, en las formas canónica,
compacta, entre corchetes o urn:uuid:).
type: string
example: m1.medium
description:
type: string
example: Medium instance with 2 vCPUs and 4GB RAM
vcpus:
type: integer
description: Número de CPU virtuales
example: 2
ram_mb:
type: integer
description: Memoria RAM en MB
example: 4096
class:
type: string
description: >-
Enrutamiento de grupo de hosts. "Compartido" sobresuscribe la CPU
para una mayor densidad; "Dedicado" conecta cada vCPU 1:1 a un
núcleo físico.
enum:
- shared
- dedicated
example: shared
family:
type: string
description: >-
Qué producto puede reservar el tipo de instancia. Las opciones
"general" son para instancias regulares y grupos de instancias; las
opciones "loadbalancer" y "database" están reservadas para los
productos administrados (sus nodos se operan en plataforma y tienen
un precio correspondiente) y no se pueden usar para instancias
regulares.
enum:
- general
- loadbalancer
- database
example: general
net_mbps:
type: integer
minimum: 1
readOnly: true
description: >-
Límite agregado de transferencia de red de la instancia en megabits
por segundo. Se omite cuando no hay límite.
example: 10000
cpu_baseline_pct:
type: integer
minimum: 1
readOnly: true
description: >-
Mínimo de CPU garantizado como porcentaje de cada vCPU. Se omite
cuando no hay un mínimo garantizado.
example: 100
cpu_burst_pct:
type: integer
minimum: 1
readOnly: true
description: >-
Límite de CPU como porcentaje de cada vCPU. El valor 100 o la
omisión del campo permite usar todas las vCPU.
example: 100
status:
type: string
enum:
- active
- disabled
example: active
created_at:
type: string
format: date-time
readOnly: true
updated_at:
type: string
format: date-time
readOnly: true
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
responses:
BadRequest:
description: Parámetros de solicitud no válidos
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: INVALID_INPUT
message: Invalid request parameters
request_id: 550e8400-e29b-41d4-a716-446655440000
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
InternalServerError:
description: Error interno del servidor
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: INTERNAL_ERROR
message: An internal error occurred
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.