> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/contributor/contributor-pt/conteudo/file-system.md).

# Sistema de ficheiros

Por trás das diferentes APIs de conteúdo no protocolo Decentraland há uma implementação de um sistema de arquivos distribuído. Cada content server mantém uma cópia de todo o armazenamento e sincroniza as atualizações que recebe com outras instâncias.

Os arquivos enviados para o sistema são **imutáveis**. Uma vez implantados, nem o seu identificador nem o seu conteúdo mudam. Eles só podem ser atualizados no sentido de que uma nova versão é enviada e as aplicações escolhem usá-la, enquanto a antiga pode ser descartada.

Você pode experimentar com arquivos na [prática](https://github.com/decentraland/docs/tree/main/contributor/content/practice/README.md) seção.

### Identificadores de arquivo <a href="#identifiers" id="identifiers"></a>

O sistema de arquivos do Decentraland é organizado em um índice plano (ou seja, não há uma hierarquia natural de diretórios), no qual cada arquivo é identificado por uma cadeia de caracteres única.

As cadeias de caracteres dos identificadores são prefixadas [base32](https://en.wikipedia.org/wiki/Base32) codificações do hash SHA-256 do conteúdo do arquivo, usando o [IPFS CID v1](https://docs.ipfs.tech/concepts/content-addressing/) algoritmo. Elas se parecem com isto:

```
bafybeicgclohdfaccu2sqqkzrzuenjxzcry3m5vcb4mpxgucjl3oheq5tq
```

O prefixo nos primeiros bytes indica a codificação, a versão e o tipo de hash do próprio identificador.

{% hint style="info" %}
Por razões históricas, algumas APIs chamam o identificador do arquivo de *hash* em vez de *id*, mas se referem à mesma coisa. Você também pode encontrar identificadores legados em conteúdo antigo que parecem um pouco diferentes.
{% endhint %}

Na prática, esses detalhes não são necessários para descobrir e baixar conteúdo. A maioria dos clientes do protocolo pode tratar identificadores como strings opacas sem perder funcionalidades.

Observe que os identificadores CIDv1 modernos são compatíveis com IPFS, produzindo o mesmo CID para o mesmo arquivo, então o IPFS pode ser usado como provedor do arquivo.

### Propriedade e Persistência

Exceto por [snapshots](https://github.com/decentraland/docs/tree/main/contributor/content/snapshots/README.md), os arquivos armazenados na rede estão associados a uma [Entity](https://github.com/decentraland/docs/tree/main/contributor/content/entities/README.md) de propriedade de uma conta Ethereum. O proprietário é o único autorizado a atualizar a Entity e os arquivos relacionados.

Os content servers são obrigados pelo protocolo a armazenar sempre a versão mais recente de uma Entity e de seus arquivos, mas podem escolher se mantêm ou não as versões antigas de acordo com sua configuração individual.

### Baixar arquivos <a href="#downloading" id="downloading"></a>

O [`/contents/<fileId>`](https://decentraland.github.io/catalyst-api-specs/#tag/Content-Server/operation/getContentFile) O endpoint do content server pode ser usado para baixar qualquer arquivo. Seus identificadores são encontrados no pai [da Entity](https://github.com/decentraland/docs/tree/main/contributor/content/entities/README.md)manifesto.

### Enviando arquivos

Os arquivos não são enviados independentemente. Em vez disso, eles são empacotados dentro de entities e enviados durante a implantação da entity para o content server.

Veja a [documentação do criador de conteúdo](https://github.com/decentraland/docs/tree/main/creator/README.md) para mais detalhes.


---

# 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.decentraland.org/contributor/contributor-pt/conteudo/file-system.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.