> 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/productos/object-storage/quickstart.md).

# Início rápido

Cria o repositório com a sua quota e atribui-lhe um utilizador proprietário, em dois passos.

Criar o Armazenamento de Objetos leva dois passos: crias o repositório com a sua quota e atribuis-lhe um utilizador proprietário.

Ligar o software por S3 vem depois, com as credenciais do repositório.

> #### 📘 O que obténs
>
> Um repositório de Armazenamento de Objetos criado, com a sua quota e o seu utilizador proprietário, pronto para ligar por S3 ou para começar a carregar objetos a partir do painel.

### Antes de começar

* Ter sessão iniciada na plataforma de Plenit.
* Ter uma organização com pelo menos um utilizador, ou criá-lo durante o registo.

### Começa o registo

Consoante já trabalhes com o serviço ou seja a primeira vez, chegas ao assistente por uma destas vias. As três terminam no mesmo sítio.

| Situação                          | Como começas                                                                                              |
| --------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Já usas Armazenamento de Objetos  | Entra no serviço e clica em **Nova subscrição**, no canto superior direito da lista                       |
| É a primeira vez com o serviço    | Na página do produto, clica em **Quero experimentá-lo agora**                                             |
| A partir de um Cliente específico | Entra em **Organização › Subscrições** e escolhe **Armazenamento de objetos** em "O que queres registar?" |

<figure><img src="https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-76347edc2ef7fd0f71debf0a49e55170bc89ea8c%2FListado_de_Servicios.png?alt=media" alt=""><figcaption><p><em>A partir da lista do serviço vês o consumo agregado e crias um novo repositório com Nova subscrição, no canto superior direito.</em></p></figcaption></figure>

<figure><img src="https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-bef62eafac48ea50dcc284ea70577d5ee20ee312%2FEmpty_state.png?alt=media" alt=""><figcaption><p><em>Da primeira vez, entras no mesmo assistente a partir da página do produto, com Quero experimentá-lo agora.</em></p></figcaption></figure>

### Passo 1. Cria o repositório e define a quota

No assistente:

1. Escreve o **nome da subscrição**, que te ajudará a identificá-la.
2. Define a **quota de armazenamento** com o cursor (a partir de 100 GB). Ao movê-lo, vês o custo estimado por mês e por hora. Podes aumentá-la mais tarde, se crescer.
3. Avança para o passo seguinte.

> #### 📘 O nome só aceita letras e números
>
> Devido a uma limitação do serviço, o identificador do repositório compõe-se apenas por letras e números, sem espaços, sem maiúsculas e sem caracteres especiais.
>
> Tem isso em conta ao nomear a subscrição.

<figure><img src="https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-19b4ae5cf978fcfc080ca13f1d79932edd3e8024%2FStep_1.png?alt=media" alt=""><figcaption><p><em>Passo 1. Dá um nome ao repositório e define a quota com o cursor (a partir de 100 GB); podes aumentá-la mais tarde, se crescer.</em></p></figcaption></figure>

### Passo 2. Atribui o utilizador proprietário

Seleciona o utilizador que será **proprietário** do repositório. O proprietário tem permissões totais, e só pode haver um por repositório. Se não existir, crias um no momento com **Novo utilizador** e o respetivo endereço de e-mail. Ao clicar em **Guardar**, criamos o repositório.

> #### 📘 Os restantes utilizadores, depois
>
> Os restantes utilizadores que vão aceder são adicionados após o registo, com as suas permissões específicas. Tens isso em [Acesso S3: utilizadores e credenciais.](https://docs.plenit.com/docs-pt/productos/object-storage/concepts/s3-access-users-and-credentials.md)

<figure><img src="https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-e8609ef9cc0451944389165e4479d6ef5a009685%2FStep_2.png?alt=media" alt=""><figcaption><p><em>Passo 2. Escolhe o utilizador proprietário do repositório, ou cria um novo no momento.</em></p></figcaption></figure>

### Passo 3. Verifica e recolhe os dados de ligação

O repositório aparece como um **cartão no painel**. Ao entrar, tens os separadores do serviço (Resumo, Bucket, Utilizadores, Estrutura) e o resumo com o **consumo** (quota, utilizadores, objetos e carregamento).

A partir do botão **Ligar** e a partir do separador **Utilizadores** reúnes o que precisas para ligar por S3: o endpoint, o nome do repositório e, no acesso de cada utilizador, a **chave de acesso** e a **chave secreta**.

<figure><img src="https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-728067d25ab9785693d31f9735a6914413c6b633%2FSummary_1.png?alt=media" alt=""><figcaption><p><em>Já criado, ao entrares no repositório tens o resumo com o consumo e o botão Ligar com os dados de ligação S3.</em></p></figcaption></figure>

### Já tens o repositório criado

A partir daqui, o seguinte é pô-lo a funcionar:

* Ligar o software por S3 com comandos ou com um cliente: [Como integrar com um cliente S3.](https://docs.plenit.com/docs-pt/productos/object-storage/how-to/how-to-integrate-with-an-s3-client.md)
* Dar acesso aos restantes utilizadores e gerir as suas chaves: [Acesso S3: utilizadores e credenciais.](https://docs.plenit.com/docs-pt/productos/object-storage/concepts/s3-access-users-and-credentials.md)
* Ativar a conservação de versões, a partir do separador **Bucket**: [Versionamento e imutabilidade.](https://docs.plenit.com/docs-pt/productos/object-storage/details/versioning-and-immutability.md)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.plenit.com/docs-pt/productos/object-storage/quickstart.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
