> For the complete documentation index, see [llms.txt](https://docs.plenit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plenit.com/docs-pt/reference/servers-api/sshkeypair/addsshkeypairtoserver.md).

# Casos de utilização

* **Ativar acesso SSH num servidor recém-provisionado** Depois de criar um servidor e um par de chaves SSH separadamente, chame este endpoint para associar a chave ao servidor. Isso conclui o fluxo de provisionamento ao ativar a autenticação SSH segura, sem palavra-passe, desde o momento em que o servidor fica acessível.
* **Implementar a mesma chave SSH em vários servidores de uma vez** O `serverId` campo aceita uma matriz de IDs de servidor, portanto pode associar um único par de chaves SSH a vários servidores numa única solicitação. Use isto para distribuir uma chave partilhada da equipa ou uma chave de implementação por toda a sua frota sem fazer chamadas repetidas à API.
* **Conceder a um novo membro da equipa acesso à infraestrutura existente** Quando um novo programador ou operador se junta à equipa, crie um par de chaves SSH com a respetiva chave pública e, em seguida, associe-o a todos os servidores a que precisa de acesso. Isto fornece um acesso controlado e auditável sem modificar manualmente as configurações de cada servidor.
* **Automatizar a distribuição de chaves em pipelines de CI/CD** Integre este endpoint na automatização da sua infraestrutura para atribuir programaticamente chaves SSH a servidores durante a implementação. Um pipeline pode criar um par de chaves, provisionar servidores e associar a chave — garantindo que cada instância implementada fica acessível para configuração ou depuração pós-implementação.
* **Rodar chaves SSH em toda a sua frota de servidores** Como parte de uma política de rotação de chaves, crie um novo par de chaves SSH e use este endpoint para o atribuir a todos os servidores afetados. Uma vez confirmado, remova o par de chaves antigo. O parâmetro baseado em matriz `serverId` torna eficiente a atualização de vários servidores numa única chamada.

## Obter os parâmetros necessários

* **subscriptionId** (query): Obtenha os IDs de subscrição disponíveis usando o [Listar todas as subscrições](https://gitlab.com/plenit-group/plenit-docs-es-es/-/blob/v1.0/reference/listallsubscriptions/README.md) endpoint. Passe o seu `organizationId` como parâmetro de consulta para listar todas as subscrições, depois use o `id` campo da resposta.
* **sshId** (caminho): Recupere os IDs dos pares de chaves SSH disponíveis usando o [Listar pares de chaves SSH por subscrição](https://gitlab.com/plenit-group/plenit-docs-es-es/-/blob/v1.0/reference/listsshkeypairsbysubscription/README.md) endpoint. Passe o `subscriptionId` como parâmetro de consulta para obter todos os pares de chaves nessa subscrição, depois use o `id` campo da resposta.
* **serverId** (corpo): Recupere os IDs dos servidores disponíveis usando o [Obter todos os servidores para um ID de subscrição](https://gitlab.com/plenit-group/plenit-docs-es-es/-/blob/v1.0/reference/getallserversbysubscription/README.md) endpoint. Passe o `subscriptionId` como parâmetro de consulta para listar todos os servidores, depois use o `id` campo de cada servidor de destino. Este parâmetro aceita uma matriz, portanto pode incluir vários IDs de servidor numa única solicitação.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.plenit.com/docs-pt/reference/servers-api/sshkeypair/addsshkeypairtoserver.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.