Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Nesta página, mostramos como aumentar ou diminuir a capacidade das
instâncias do Filestore.
Ao usar o Filestore, recomendamos que você
monitore a utilização das instâncias do Filestore
para ajustar a capacidade conforme necessário. Por exemplo, se você perceber que uma
instância de nível regional com um intervalo de capacidade maior (anteriormente SSD de alta escala) não
precisa mais de toda a capacidade alocada, considere reduzi-la.
Da mesma forma, se você perceber que está sem
capacidade, convém aumentar a capacidade para evitar que os aplicativos fiquem
sem falhas. Se o sistema de arquivos
ficar sem inodes, também será preciso adicionar capacidade. Para verificar o uso do nó-i, execute:
Cada arquivo armazenado no compartilhamento de arquivos consome um inode. Se o sistema de arquivos ficar
sem nós, não será possível armazenar mais arquivos no compartilhamento de arquivos, mesmo
que você não tenha atingido a capacidade máxima alocada. A única maneira de adicionar
inodes é adicionar capacidade. No entanto, alcançar o máximo de nós-i é raro
e só é uma preocupação se você precisar armazenar muitos arquivos pequenos.
Para entender melhor a capacidade disponível de uma instância, consulte
Como prever a capacidade.
Diferenças no comportamento de escalonamento por nível de serviço
O escalonamento de uma instância não afeta a
disponibilidade dela e pode ser realizado enquanto a instância está em uso. A tabela a seguir mostra como a capacidade de compartilhamento de arquivos pode ser
escalonada com base no nível de serviço:
Nível de serviço
HDD básico
SSD básico
Zonal, capacidade menor
Zonal, maior capacidade
Regional, capacidade menor
Regional, maior capacidade
Enterprise
Direção do escalonamento
Somente para cima
Somente para cima
Para cima e para baixo
Para cima e para baixo
Para cima e para baixo
Para cima e para baixo
Para cima e para baixo
Aumento de escalonamento
1GiB
1GiB
256GiB
2.5TiB
256GiB
2.5TiB
256GiB
Capacidade mínima
1TiB
2.5TiB
1TiB
10TiB
1TiB
10TiB
1TiB
Capacidade máxima
63.9TiB
63.9TiB
9.75TiB
100TiB
9.75TiB
100TiB
10TiB
O escalonamento da capacidade de uma instância de nível zonal com um intervalo de capacidade maior pode
demorar mais do que as instâncias de nível empresarial e básico. O tempo real necessário
varia de acordo com a quantidade de dados armazenados na instância e a carga na
instância do Filestore. Para garantir que suas instâncias não fiquem sem
capacidade, execute essas operações com antecedência.
Quando uma operação de escalonamento ocorre, não é possível cancelar a operação nem
fazer outras edições na instância, mas as operações de leitura e gravação são
ininterruptas. Também não é possível dimensionar uma instância de nível empresarial e zonal
para um nível de capacidade inferior ao necessário para armazenar os
dados e metadados de arquivo atuais. A tentativa de fazer isso resultará em um erro.
Instruções para editar uma instância
Console do Google Cloud
Para editar instâncias do Filestore usando o console Google Cloud ,
acesse a página Editar instância, em que é possível editar a descrição
da instância, gerenciar regras de controle de acesso baseadas em IP e escalonar o desempenho do compartilhamento
de arquivos:
No console Google Cloud , acesse a página "Instâncias do Filestore".
instance-id é o ID da instância do
Filestore que você quer editar.
project-id é o ID do projeto Google Cloud que
contém a instância do Filestore. É possível ignorar essa
flag se a instância do Filestore estiver no projeto
padrão gcloud. Para definir o projeto padrão, execute:
gcloud config set project project-id
location é o local onde a instância do Filestore
reside. Para instâncias empresariais, especifique uma região. Para todas as outras
instâncias, especifique uma zona. Por exemplo, us-central1-a.
Execute o comando gcloud filestore zones list para conferir uma lista de zonas
compatíveis. Pule essa flag se a instância do Filestore estiver na
zona padrão gcloud. Para definir a zona padrão, execute:
gcloud config set filestore/zone zone
file-share-name é o nome do compartilhamento de arquivos exibido pela
instância do Filestore. Não é possível alterar os nomes de
compartilhamento de arquivos após a criação da instância.
file-share-size é o novo tamanho que você quer que o compartilhamento de arquivos tenha. É
possível especificar o tamanho do compartilhamento de arquivos em números inteiros usando GiB (padrão)
ou TiB. Por exemplo, 10TiB.
Para conferir sua cota disponível, acesse a página "Cotas" no console Google Cloud :
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-18 UTC."],[[["\u003cp\u003eFilestore instance capacity can be increased or decreased, allowing for adjustments based on usage, and should be monitored to prevent application disruptions.\u003c/p\u003e\n"],["\u003cp\u003eScaling operations do not interrupt read and write operations, but no other instance edits are allowed during this process, and the direction of scaling depends on the tier.\u003c/p\u003e\n"],["\u003cp\u003eBasic HDD and SSD service tiers can only scale up, while other tiers, like Zonal, Regional, and Enterprise, can scale up and down with differing minimum, maximum, and increment values.\u003c/p\u003e\n"],["\u003cp\u003eInode usage is critical because each file consumes one, and if the file system runs out of inodes, no more files can be stored, necessitating an increase in capacity.\u003c/p\u003e\n"],["\u003cp\u003eFilestore instance capacity can be edited via the Google Cloud console's "Edit instance" page or through the \u003ccode\u003egcloud filestore instances update\u003c/code\u003e command, specifying the new file share size.\u003c/p\u003e\n"]]],[],null,["# Scale capacity\n\nThis page shows you how to increase or decrease the capacity of your\nFilestore instances.\n| **Note:** For information about performance scaling, see the [performance documentation](/filestore/docs/performance#performance-scaling).\n\nWhen using Filestore, we recommend that you\n[monitor the utilization of your Filestore instances](/filestore/docs/monitoring-instances)\nso that you can adjust capacity as needed. For example, if you notice that a\nzonal-tier instance with a higher capacity range (previously high scale SSD) no\nlonger needs all of its allocated capacity, you may consider scaling it down.\nSimilarly, if you notice that you are running out of capacity, you may want to\nscale up capacity to prevent your applications from breaking. If the file system\nruns out of inodes, you also need to add capacity. To check the inode usage, run: \n\n df -i\n\nThe command returns something similar to the following: \n\n Filesystem Inodes IUsed IFree IUse% Mounted on\n 10.0.0.2:/vol1 134217728 13 134217715 1% /mnt/test\n\nInode usage\n-----------\n\nEach file stored on the file share consumes one inode. If the file system runs\nout of inodes, you won't be able to store more files on the file share even\nif you haven't reached the maximum allocated capacity. The only way to add\ninodes is by adding capacity. However, reaching the maximum inodes is rare\nand is only a concern if you need to store numerous small files.\n\nFor a better understanding of an instance's available capacity, see\n[Anticipating capacity](/filestore/docs/monitoring-instances#anticpating-capacity).\n\nDifferences in scaling behavior by service tier\n-----------------------------------------------\n\nScaling an instance does not affect its availability and can be performed while\nthe instance is in use. The following table shows how file share capacity can be\nscaled based on the [service tier](/filestore/docs/service-tiers):\n\nScaling the capacity of a zonal tier instance with a higher capacity range can\ntake longer than enterprise and basic tier instances. The actual time required\nvaries depending on the amount of data stored in the instance and the load on the\nFilestore instance. To ensure that your instances don't run out of\ncapacity, perform these operations in advance.\n\nWhen a scaling operation is taking place, you cannot cancel the operation or\nmake any other edits to the instance, but read and write operations are\nuninterrupted. You also cannot scale an enterprise-tier and zonal-tier instance\nto a capacity level that's lower than what's needed for storing its existing\nfile data and metadata. Attempting to do so results in an error.\n\nInstructions for editing an instance\n------------------------------------\n\n### Google Cloud console\n\nTo edit Filestore instances using the Google Cloud console,\nnavigate to the **Edit instance** page, where you can edit the instance\ndescription, manage IP-based access control rules, and scale the file share\nperformance:\n\n1. In the Google Cloud console, go to the Filestore Instances page.\n\n [Go to the Filestore instances page](https://console.cloud.google.com/filestore/instances)\n2. Click the instance ID of the instance you want to edit.\n\n3. On the **Instance details** page, click **Edit** to go to the **Edit\n instance** page.\n\n4. In the **Edit capacity** field, enter the new capacity value.\n\n5. Click **Save**.\n\n### gcloud\n\n#### Before you begin\n\nTo use the gcloud CLI, you must either\n[install the Cloud SDK](/sdk/downloads)\nor use the Cloud Shell\n\nthat's built into the Google Cloud console:\n\n[Go to the Google Cloud console](https://console.cloud.google.com/)\n\n\u003cbr /\u003e\n\n#### `gcloud` command for editing an instance\n\nYou can edit a Filestore instance by running the [`instances\nupdate`](/sdk/gcloud/reference/filestore/instances/update) command. \n\n gcloud filestore instances update \u003cvar translate=\"no\"\u003einstance-id\u003c/var\u003e \\\n --project=\"\u003cvar translate=\"no\"\u003eproject-id\u003c/var\u003e\" \\\n --location=\u003cvar translate=\"no\"\u003elocation\u003c/var\u003e \\\n --file-share=name=\"\u003cvar translate=\"no\"\u003efile-share-name\u003c/var\u003e\",capacity=\u003cvar translate=\"no\"\u003efile-share-size\u003c/var\u003e\n\nwhere:\n\n- \u003cvar translate=\"no\"\u003einstance-id\u003c/var\u003e is the instance ID of the Filestore instance you want to edit.\n- \u003cvar translate=\"no\"\u003eproject-id\u003c/var\u003e is the project ID of the Google Cloud project that\n contains the Filestore instance. You can skip this\n flag if the Filestore instance is in the `gcloud` default\n project. You can set the default project by running:\n\n gcloud config set project \u003cvar translate=\"no\"\u003eproject-id\u003c/var\u003e\n\n- \u003cvar translate=\"no\"\u003elocation\u003c/var\u003e is the location where the Filestore\n instance resides. For enterprise instances, specify a region. For all other\n instances, specify a zone. For example, `us-central1-a`.\n\n Run the `gcloud filestore zones list` command to get a list of supported\n zones. You can skip this flag if the Filestore instance is in\n the `gcloud` default zone. You can set the default zone by running: \n\n gcloud config set filestore/zone \u003cvar translate=\"no\"\u003ezone\u003c/var\u003e\n\n- \u003cvar translate=\"no\"\u003efile-share-name\u003c/var\u003e is the name of the file share that is served\n from the Filestore instance. File share names cannot be changed\n after instance creation.\n\n- \u003cvar translate=\"no\"\u003efile-share-size\u003c/var\u003e is the new size you want for the file share. You\n can specify the file share size in whole numbers using either `GiB` (default)\n or `TiB`. For example, `10TiB`.\n\n To see your available quota, go to the Quotas page in the Google Cloud console:\n\n [Go to the Quotas page](https://console.cloud.google.com/iam-admin/quotas)\n- Optional: For a detailed list of available flags, see the\n [`gcloud filestore instances update`](/sdk/gcloud/reference/filestore/instances/update)\n reference page.\n\nWhat's next\n-----------\n\n- [Known issues](/filestore/docs/known-issues)\n- [Troubleshoot performance-related issues](/filestore/docs/troubleshooting)"]]