> ## 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.
# Reinstalar a instância
> Reimagine o volume de inicialização de uma instância STOPPED a partir de uma imagem (a atual ou uma nova imagem), mantendo a identidade da instância: id, nome, IPs e semente cloud-init. A substituição é dimensionada e dividida em camadas por size_gb e volume_type, sendo o padrão min_disk_gb da imagem na camada padrão da região. O volume de inicialização antigo é excluído; os volumes de dados anexados permanecem intactos. O novo sistema operacional é aplicado na próxima inicialização.
Requer a ação do IAM **`compute:ReinstallInstance`**. 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 post /v1/instances/{instance_id}/reinstall
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/instances/{instance_id}/reinstall:
post:
tags:
- Compute
summary: Reinstalar a instância
description: >
Reimagine o volume de inicialização de uma instância STOPPED a partir de
uma imagem (a atual ou uma nova imagem), mantendo a identidade da
instância: id, nome, IPs e semente cloud-init. A substituição é
dimensionada e dividida em camadas por size_gb e volume_type, sendo o
padrão min_disk_gb da imagem na camada padrão da região. O volume de
inicialização antigo é excluído; os volumes de dados anexados permanecem
intactos. O novo sistema operacional é aplicado na próxima
inicialização.
operationId: reinstallInstance
parameters:
- $ref: '#/components/parameters/IdempotencyKey'
- $ref: '#/components/parameters/InstanceId'
requestBody:
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
image:
type: string
description: >-
Referência de imagem de substituição (UUID, CRN qualificado
pela arquitetura, nome ou nome:versão). Omita para
reinstalar a partir da imagem atual da instância.
example: f47ac10b-58cc-4372-a567-0e02b2c3d479
size_gb:
type: integer
minimum: 1
maximum: 16384
description: >-
Tamanho do disco de inicialização de substituição; omitido =
o min_disk_gb da imagem. Deve estar dentro do intervalo de
tamanho do volume (1..16384) e pelo menos o min_disk_gb da
imagem.
example: 40
volume_type:
type: string
enum:
- ssd
- nvme
description: >-
Camada de disco de inicialização de substituição; omitida =
a região padrão.
responses:
'202':
$ref: '#/components/responses/Accepted'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'409':
description: A instância não está parada
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'422':
$ref: '#/components/responses/UnprocessableEntity'
'500':
$ref: '#/components/responses/InternalServerError'
security:
- BearerAuth: []
components:
parameters:
IdempotencyKey:
name: Idempotency-Key
in: header
description: >-
Chave opcional gerada pelo cliente que torna uma criação segura para
reprodução. A reintentar uma solicitação com a mesma chave retorna o
resultado original literalmente em vez de criar um recurso duplicado. A
reutilização de uma chave com um corpo de solicitação diferente é
rejeitada (422); uma solicitação cuja chave ainda está sendo processada
retorna 409. Os registros são honrados por 24 horas. Use um UUID ou
token exclusivo semelhante.
required: false
schema:
type: string
maxLength: 255
example: 550e8400-e29b-41d4-a716-446655440000
InstanceId:
name: instance_id
in: path
description: ID da instância
required: true
schema:
type: string
format: uuid
example: 550e8400-e29b-41d4-a716-446655440000
responses:
Accepted:
description: >
Solicitação aceita, processamento assíncrono. A ação é fire-and-forget —
o corpo está vazio; consulte o recurso para observar a transição de
estado resultante.
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
NotFound:
description: Página não encontrada
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: NOT_FOUND
message: Resource not found
request_id: 550e8400-e29b-41d4-a716-446655440000
UnprocessableEntity:
description: >
A solicitação está bem formada, mas não pode ser processada conforme
enviada. Nas operações que aceitam `Idempotency-Key` este é o caso de
reutilização de chave: a chave foi vista pela primeira vez com uma carga
de solicitação diferente, então reproduzir o resultado armazenado
responderia a uma pergunta que o chamador não fez.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: IDEMPOTENCY_KEY_REUSED
message: >-
This Idempotency-Key was already used with a different request
payload
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
schemas:
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
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.