> ## 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. # Anexar uma NIC existente a uma instância > Anexa uma interface de rede autônoma existente. A instância deve estar em execução ou parada. Para criar uma interface, use `POST /v1/interfaces` na API de rede antes de anexá-la. Esta operação nunca provisiona uma interface. O anexo é durável no momento em que ele retorna: ele faz parte da especificação da instância e sobrevive a reinicializações. A entrega ao hóspede é assíncrona e a resposta diz o que é preciso. Uma instância parada aparece com o dispositivo, e `restart_required` está ausente. Uma instância em execução é dada ao dispositivo enquanto ele está em execução onde a região suporta que: a chamada retorna antes que o convidado tenha, `restart_required` está ausente, e a interface aparece no convidado momentos depois — poll `GET /v1/instances/{instance_id}/nics`, ou observe o convidado para um link que carrega o MAC nesta resposta. Onde a região não o faz, a resposta define `restart_required`: reiniciar a instância com `{"hard": true}` para entregá-lo. Uma reinicialização suave é ACPI dentro do mesmo lançador e não vai. O endereço é DHCP de qualquer maneira. Nada configura a nova interface dentro do convidado, então uma imagem que não traz um dispositivo de rede quando aparece (cloud-init hotplug, NetworkManager, systemd-networkd com uma correspondência de curinga) mantém o link sem um endereço até que algo no convidado peça o lease. Requer a ação do IAM **`compute:AttachNIC`**. 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}/nics 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}/nics: post: tags: - Compute summary: Anexar uma NIC existente a uma instância description: > Anexa uma interface de rede autônoma existente. A instância deve estar em execução ou parada. Para criar uma interface, use `POST /v1/interfaces` na API de rede antes de anexá-la. Esta operação nunca provisiona uma interface. O anexo é durável no momento em que ele retorna: ele faz parte da especificação da instância e sobrevive a reinicializações. A entrega ao hóspede é assíncrona e a resposta diz o que é preciso. Uma instância parada aparece com o dispositivo, e `restart_required` está ausente. Uma instância em execução é dada ao dispositivo enquanto ele está em execução onde a região suporta que: a chamada retorna antes que o convidado tenha, `restart_required` está ausente, e a interface aparece no convidado momentos depois — poll `GET /v1/instances/{instance_id}/nics`, ou observe o convidado para um link que carrega o MAC nesta resposta. Onde a região não o faz, a resposta define `restart_required`: reiniciar a instância com `{"hard": true}` para entregá-lo. Uma reinicialização suave é ACPI dentro do mesmo lançador e não vai. O endereço é DHCP de qualquer maneira. Nada configura a nova interface dentro do convidado, então uma imagem que não traz um dispositivo de rede quando aparece (cloud-init hotplug, NetworkManager, systemd-networkd com uma correspondência de curinga) mantém o link sem um endereço até que algo no convidado peça o lease. operationId: attachInstanceNIC parameters: - $ref: '#/components/parameters/IdempotencyKey' - $ref: '#/components/parameters/InstanceId' requestBody: required: true content: application/json: schema: type: object additionalProperties: false required: - interface properties: interface: type: string minLength: 1 description: >- UUID de interface autônoma existente ou VPC/sub-rede/CRN de interface completo. Os nomes nulos não têm o pai da sub-rede e são rejeitados. Ele mantém seu endereço, MAC e grupos de segurança; detach retorna-o para standalone em vez de destruí-lo. example: e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d responses: '202': description: Anexo aceito content: application/json: schema: type: object properties: attachment: type: object properties: interface_id: type: string example: e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d mac: type: string example: 02:1a:2b:3c:4d:5e boot_index: type: integer example: 0 external: type: boolean description: >- A interface anexada existia antes desta chamada (a interface foi dada). Detach desliga-o e deixa-o sozinho em vez de destruí-lo. example: false restart_required: type: boolean description: >- O guest ainda não carrega a interface e uma reinicialização é o que a entrega — uma interface depois da primeira é uma rede no lançador da instância, e as redes de um lançador são fixas por toda a vida. Definido quando a instância estava em execução em uma região que não pode se conectar a um convidado em execução. Ausente para uma instância parada, que aparece com o dispositivo, e ausente onde a região se conecta ao vivo, onde o convidado em execução recebe o dispositivo sem uma reinicialização. example: true addresses: type: array items: $ref: '#/components/schemas/InterfaceAddress' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '409': description: Instância não em um estado que permite a conexão de NIC content: application/json: schema: $ref: '#/components/schemas/Error' '422': $ref: '#/components/responses/UnprocessableEntity' 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 schemas: InterfaceAddress: type: object properties: id: type: string format: uuid family: type: string enum: - ipv4 - ipv6 address: type: string prefix: type: string description: >- Alocação própria, não a máscara de rede do convidado: IPv4 /32 ou IPv6 /96. O DHCPv6 configura o primeiro /128. primary: type: boolean floating_ips: type: array items: $ref: '#/components/schemas/AddressFloatingIp' required: - id - family - address - prefix - primary - floating_ips 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 AddressFloatingIp: type: object properties: id: type: string format: uuid crn: type: string visibility: type: string enum: - public - private address: type: string required: - id - crn - visibility - address 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 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 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.