> ## 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 instância
> Lista todos os tipos de instância de instância disponíveis. O catálogo é pequeno e retorna em uma única vez — esse ponto final não é paginado.
Requer a ação do IAM **`compute:ListFlavors`**. Consulte [permissões de computação](/pt/compute/permissions) para obter a lista completa, o que cada uma abrange e um exemplo de política.
## OpenAPI
````yaml /pt/api-reference/specs/compute.yaml get /v1/flavors
openapi: 3.0.3
info:
title: API de Basaltic Compute
version: 1.0.0
description: >
Instâncias de máquina virtual e as imagens, os tipos e os pools de
instâncias a partir dos quais elas são criadas. Abrange todo o ciclo de vida
da instância: iniciar, parar, reiniciar, redimensionar e reinstalar.
contact:
name: Basaltic Support
email: ping@basaltic.sh
license:
name: Proprietary
url: https://basaltic.sh/terms
servers:
- url: https://compute.{region}.basaltic.sh
description: Endpoint de API regional
variables:
region:
default: sa-saopaulo-1
description: Código de região
security:
- BearerAuth: []
paths:
/v1/flavors:
get:
tags:
- Compute
summary: Listar tipos de instância
description: >-
Lista todos os tipos de instância de instância disponíveis. O catálogo é
pequeno e retorna em uma única vez — esse ponto final não é paginado.
operationId: listFlavors
parameters:
- $ref: '#/components/parameters/ComputeNameFilter'
- $ref: '#/components/parameters/ComputeCRNFilter'
- name: family
in: query
description: >-
Filtrar por família de produtos. Os fluxos de criação de balanceador
de carga e banco de dados devem listar sua própria família;
instâncias regulares usam "general".
schema:
type: string
enum:
- general
- loadbalancer
- database
example: general
responses:
'200':
description: Lista de tipos de instância
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: >-
Exato, nome sensível a maiúsculas. Valores vazios não correspondem a
nenhum recurso nomeado. As listas de NICs de instância correspondem aos
nomes de interface dentro das ligações de instância; várias interfaces
com o mesmo nome podem corresponder. Os IPs flutuantes não têm
identidade de nome e retornam uma lista vazia para esse filtro.
schema:
type: string
ComputeCRNFilter:
name: crn
in: query
description: >-
CRN exato do recurso, intersetado com todos os outros filtros antes da
paginação. Um CRN estrangeiro ou não correspondido retorna uma página
vazia; CRNs malformados ou vazios retornam 400. As listas de anexos
aninhadas filtram o recurso representado, não a vinculação.
schema:
type: string
schemas:
FlavorListResponse:
type: object
properties:
flavors:
type: array
items:
$ref: '#/components/schemas/Flavor'
Flavor:
type: object
description: >-
Um tamanho de computação (vCPU + RAM). Um flavor não carrega nenhum
tamanho de disco — o disco de inicialização é um volume do cliente com o
tamanho no lançamento, limitado pelo min_disk_gb da imagem.
properties:
id:
type: string
format: uuid
readOnly: true
example: 550e8400-e29b-41d4-a716-446655440000
crn:
type: string
readOnly: true
description: Nome do recurso da nuvem
example: crn:compute:sa-saopaulo-1:platform:flavor/standard-2
name:
description: >-
Os nomes de recursos não devem começar com o prefixo literal crn: ou
ser UUIDs (formas canônicas, compactas, entre colchetes ou
urn:uuid:, em qualquer caso).
type: string
example: m1.medium
description:
type: string
example: Medium instance with 2 vCPUs and 4GB RAM
vcpus:
type: integer
description: Número de CPUs virtuais
example: 2
ram_mb:
type: integer
description: Memória RAM em MB
example: 4096
class:
type: string
description: >-
Roteamento de pool de host. "compartilhada" sobrescrever CPU para
maior densidade; "dedicado" pinos cada vCPU 1:1 para um núcleo
físico.
enum:
- shared
- dedicated
example: shared
family:
type: string
description: >-
Qual produto pode reservar o tipo de instância. Os tipos de
instância "geral" são para instâncias regulares e pools de
instâncias; os tipos de instância "loadbalancer" e "base de dados"
são reservados para os produtos gerenciados (seus nós são operados
por plataforma e têm preços correspondentes) e não podem ser usados
para instâncias regulares.
enum:
- general
- loadbalancer
- database
example: general
net_mbps:
type: integer
minimum: 1
readOnly: true
description: >-
Limite agregado de transferência de rede da instância em megabits
por segundo. Omitido quando não há limite.
example: 10000
cpu_baseline_pct:
type: integer
minimum: 1
readOnly: true
description: >-
Mínimo de CPU garantido como porcentagem de cada vCPU. Omitido
quando não há mínimo garantido.
example: 100
cpu_burst_pct:
type: integer
minimum: 1
readOnly: true
description: >-
Limite de CPU como porcentagem de cada vCPU. O valor 100 ou a
omissão do campo permite usar todas as vCPUs.
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 erro identificando o tipo de erro
example: INVALID_INPUT
message:
type: string
description: Mensagem de erro legível pelo ser humano
example: Invalid request parameters
params:
type: object
additionalProperties: true
description: >-
Valores não sensíveis opcionais para interpolação de erros
localizados, codificados por código de erro. Nunca presente para
erros de servidor.
example:
instances: 2
pools: 0
request_id:
type: string
format: uuid
description: Solicitar ID para depuração
example: 550e8400-e29b-41d4-a716-446655440000
responses:
BadRequest:
description: Parâmetros de solicitação invá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: Autenticação necessária ou token invá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: Permissões 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: Erro interno do 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: >+
Um token bearer OAuth 2.0, enviado como `Authorization: Bearer `.
Esta é a forma recomendada de autenticação.
Obtenha o token trocando o par de chaves de acesso de uma conta de
serviço em `POST /v1/oauth/token` com `grant_type=client_credentials`.
Esse é o fluxo padrão de credenciais de cliente; bibliotecas compatíveis
com OAuth podem obter e renovar o token para você.
```
curl -s -u "$KEY_ID:$SECRET" -d grant_type=client_credentials \
https://iam.basaltic.sh/v1/oauth/token
```
Os tokens duram uma hora por padrão. O mesmo par de chaves de acesso
também serve como credencial AWS SigV4 para o endpoint de objetos
compatível com S3, que aceita somente esse método de autenticação.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.