> ## 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.

# Zonas privadas

> Zonas que respondem somente dentro das VPCs que você anexar a elas.

<a id="private-zones" />

## Zonas privadas

Uma zona é `public` ou `private`, fixada na criação.

<Tabs>
  <Tab title="Console">
    Em **Create Zone**, o cartão **Visibility** carrega um interruptor **Private zone**. Ao ativá-lo, você verá **Select VPCs** — escolha pelo menos uma, ou o formulário recusará com **Choose at least one VPC**.
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    POST /v1/zones
    {
      "name": "internal.example.com",
      "visibility": "private",
      "vpcs": ["c3d4e5f6-a7b8-4901-c2d3-e4f5a6b7c8d9"]
    }
    ```
  </Tab>

  <Tab title="CLI">
    Use a API para fornecer referências de VPC até que a CLI ofereça suporte a esse contrato.
  </Tab>

  <Tab title="Go">
    Use a API para fornecer referências de VPC até que o Go SDK ofereça suporte a esse contrato.
  </Tab>
</Tabs>

Uma zona privada responde somente dentro das VPCs associadas a ela e precisa de pelo menos uma na criação. Anexar ou desligar mais tarde através dos endpoints `vpc-associations`. Criar usa `vpcs`; anexar usa `vpc`. Forneça um UUID ou CRN de VPC de propriedade da conta. Nomes nuos retornam `400` porque as solicitações de DNS não corrigem uma região. VPCs ausentes, VPCs pertencentes a outra conta e CRNs para outra região retornam `404`.

<Note>
  O formulário **Create Zone** do console tem um cartão **Visibility** com um switch privado e a lista de VPCs. A visibilidade é fixada na criação de qualquer maneira, então uma zona tornada pública permanece pública.

  As associações de VPC são suportadas apenas na região configurada para DNS. As associações entre regiões não são suportadas no momento.
</Note>

<Note>
  As duas incompatibilidades são rejeitadas em vez de silenciosamente corrigidas: uma zona `private` sem `vpcs`, e uma zona `public` que as carrega, ambas respondem `400`.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.