Esta página descreve as cotas e os limites de solicitação do Cloud Storage. É possível solicitar aumentos de cotas, mas os limites não podem ser ajustados.
As cotas e os limites estão sujeitos a alterações.
Buckets
| Limite | Valor | Observações |
|---|---|---|
| Tamanho máximo do nome do bucket | 63 caracteres | |
| Taxa máxima de criação e exclusão de buckets por projeto | Aproximadamente uma solicitação a cada dois segundos | Na maioria dos casos, deve-se planejar menos buckets e mais objetos. Por exemplo, uma escolha comum de design é usar um bucket por usuário no projeto. No entanto, ao desenvolver um sistema que adiciona muitos usuários por segundo, configure um design de muitos usuários em um único bucket com as (permissões apropriadas).Dessa forma, o limite da taxa de criação de buckets não causará um gargalo. Aplicativos altamente disponíveis não devem depender da criação, exclusão ou listagem de buckets no caminho desses aplicativos. Os nomes dos buckets fazem parte de um namespace centralizado e global: qualquer dependência desse namespace cria um ponto único de falha para o aplicativo. Se um local estiver temporariamente indisponível, a operação de lista de buckets poderá retornar apenas uma lista parcial de buckets. Devido a essas considerações e ao limite de criação/exclusão de bucket, a prática recomendada para serviços altamente disponíveis no Cloud Storage é pré-criar todos os buckets necessários. |
| Taxa máxima de restauração de buckets por projeto | Aproximadamente uma solicitação a cada dois segundos | |
| Taxa máxima de atualizações de metadados de bucket por bucket | Uma atualização por segundo | Atualizações rápidas em um único bucket (por exemplo, alteração na configuração do CORS) podem resultar em erros de limitação. |
| Número máximo de principais que podem receber papéis do IAM por bucket | 1.500 principais para todos os papéis do IAM 100 principais para papéis legados do IAM |
Consulte Tipos principais para mais informações. |
| Número máximo de configurações de notificação do Pub/Sub por bucket | Cem configurações de notificação | |
| Número máximo de realocações simultâneas de buckets aceitas no mesmo local em um projeto | 5 buckets | Consulte Realocação de bucket para mais informações. |
| Número máximo de configurações de notificação do Pub/Sub definidas para serem acionadas em um evento específico | Dez configurações de notificação | |
| Número máximo de atributos personalizados em uma configuração de notificação do Pub/Sub | Dez atributos personalizados | |
| Período de armazenamento máximo que pode ser definido para o Bloqueio de bucket | 3.155.760.000 segundos (100 anos) | |
| Duração máxima da retenção da exclusão reversível | 90 dias | |
Número máximo de prefixos e sufixos no total ao usar as
condições de ciclo de vida matchesPrefix e matchesSuffix em todas as regras de um bucket. |
1.000 | Para informações sobre o Gerenciamento do ciclo de vida de objetos, consulte Gerenciamento do ciclo de vida de objetos. |
Objetos
| Limite | Valor | Observações |
|---|---|---|
| Tamanho máximo do objeto | 5 TiB | Esse limite se aplica independentemente do método de gravação, incluindo composição de objetos, uploads retomáveis e upload de várias partes. |
| Tamanho máximo combinado de todas as chaves e valores de metadados personalizados por objeto | 8 KiB | |
| Tamanho máximo do nome do objeto para objetos em um bucket de namespace simples | 1.024 bytes (codificado em UTF-8) | |
| Tamanho máximo do nome do objeto para objetos em um bucket com namespace hierárquico ativado |
Nome da pasta: 512 bytes (codificado em UTF-8) Nome base: 512 bytes (codificado em UTF-8) |
|
| Taxa máxima de gravações no mesmo nome de objeto | Uma gravação por segundo | Gravar no mesmo nome de objeto a uma taxa acima do limite pode resultar em erros de limitação. Para saber mais, consulte Imutabilidade de objetos. |
| Taxa máxima de atualizações de metadados de objetos em um único objeto | Uma atualização por segundo | Atualizar os metadados de objetos a uma taxa acima do limite pode resultar em erros de limitação. |
| Taxa máxima de gravações de objetos em um bucket | Ilimitado | Inclui upload, atualização e exclusão de objetos. Os buckets aceitam inicialmente cerca de mil gravações por segundo e, em seguida, são escalonados conforme necessário. |
| Taxa máxima de leituras de objetos em um bucket | Ilimitado | Inclui a leitura de dados de objetos, a leitura de metadados de objetos e a listagem de objetos. Inicialmente, os buckets aceitam cerca de 5 mil leituras por segundo e, em seguida, são escalonados conforme necessário. No entanto, há limites de largura de banda. |
| Número máximo de entradas da lista de controle de acesso (ACLs) | 100 ACLs por objeto | Para mais informações, consulte Escopos da ACL. |
| Número máximo de objetos de origem em uma composição de objeto | 32 objetos em uma única solicitação de composição | |
| Número máximo de componentes que formam um objeto composto | Ilimitado | Não há limite para o número de componentes de um
objeto composto, mas os metadados componentCount associados
a um objeto composto são saturados em 2.147.483.647, e o
objeto composto final precisa aderir ao Limite de tamanho de 5 TiB
que se aplica a todos os objetos no Cloud Storage. |
| Tempo máximo de retenção que pode ser definido para o Bloqueio de retenção de objetos | 3.155.760.000 segundos (100 anos) da data e hora atuais | |
| Limites máximos de consultas iniciais por segundo (QPS) para ler e gravar objetos em buckets com o namespace hierárquico ativado | QPS até 8 vezes maior em comparação com buckets sem namespace hierárquico ativado | Para saber como otimizar o desempenho ao trabalhar com pastas, consulte Gerenciamento de pastas. |
| Máximo de contextos por objeto | 50 | |
| Tamanho máximo combinado de todas as chaves e valores de contexto de objeto por objeto | 25 KiB (codificado em UTF-8) | |
| Tamanho máximo de uma chave de contexto de objeto | 256 bytes (codificado em UTF-8) | |
| Comprimento máximo de um valor de contexto de objeto | 256 bytes (codificado em UTF-8) |
Pastas gerenciadas
| Limite | Valor | Observações |
|---|---|---|
| Tamanho máximo da pasta gerenciada | 1.024 bytes (codificado em UTF-8) | |
| Número máximo de pastas gerenciadas em um bucket do Cloud Storage | Ilimitado | |
| Limite máximo de aninhamento de pastas gerenciadas | 15 | |
| Taxa máxima de atualizações da política do IAM por pasta gerenciada | Uma atualização por segundo | |
| Número máximo de principais que podem receber papéis do IAM por pasta gerenciada | 1.500 principais para todos os papéis do IAM |
O número de principais que recebem um papel do IAM em uma pasta gerenciada não conta para o número máximo de principais que podem receber um papel do IAM no bucket que contém a pasta gerenciada, as pastas gerenciadas pai ou as pastas gerenciadas filhas. |
Solicitações da API JSON
| Limite | Valor | Observações |
|---|---|---|
| Payload total máximo de solicitações em uma solicitação em lote | Menos de 10 MiB | Não inclua mais de cem chamadas em uma única solicitação. |
| Tamanho máximo de um padrão glob de listagem de objetos | 1.024 bytes na codificação UTF-8 |
Solicitações da API XML
| Limite | Valor | Observações |
|---|---|---|
| Tamanho máximo combinado do URL de solicitação e dos cabeçalhos HTTP | 16 KiB | |
| Número máximo de buckets que podem ser retornados ao listar buckets | Mil buckets | A API XML retorna buckets lexicograficamente pelo nome. |
| Número máximo de partes em um upload de várias partes | 10 mil partes | O objeto montado com essas partes precisa aderir ao limite de tamanho de 5 TiB que se aplica a todos os objetos no Cloud Storage. |
| Tamanho máximo de uma parte individual em um upload de várias partes | 5 GiB | |
| Tamanho mínimo de uma parte individual em um upload de várias partes | 5 MiB | Não há limite de tamanho mínimo na última parte de um upload de várias partes. Como resultado, esse limite não é aplicado no momento do upload de uma parte, mas quando você tenta concluir o upload. |
| O tempo máximo de um upload de várias partes e das partes enviadas pode permanecer inacabado ou inativo em um bucket | Ilimitado | |
| Número máximo de uploads de várias partes diferentes que podem ocorrer simultaneamente para um objeto | Ilimitado | |
| Tempo máximo para concluir uma sessão de upload retomável | 7 dias | O tempo é medido a partir do início do upload retomável. |
Chaves HMAC para contas de serviço
Há um limite de, no máximo, 10 chaves HMAC para cada conta de serviço. Chaves excluídas não são contabilizadas nesse limite.
Jobs de operações em lote do Storage
Nesta seção, descrevemos os limites e as cotas para jobs de operações em lote do Storage.
Jobs simultâneos de operações em lote do Storage
A tabela a seguir descreve o limite para jobs
em andamento simultaneamente:
| Tipo de limite | Limite | Aplicável a |
|---|---|---|
| Jobs simultâneos em um único bucket | 100 | Por projeto e por local |
| Jobs de simulação simultâneos em um único bucket | 100 | Por projeto e por local |
| Jobs simultâneos em vários buckets | 5 | Globalmente por projeto |
| Jobs de simulação simultâneos em vários buckets | 5 | Globalmente por projeto |
| Operações simultâneas de bucket | 50 buckets | Por job em vários buckets por local |
cotas de taxa.
As operações em lote do Storage aplicam cotas de taxa às solicitações.
A tabela a seguir lista a métrica, os métodos de API e os limites padrão de cada cota:
| Métrica | Métodos da API | Limites padrão |
|---|---|---|
storagebatchoperations.googleapis.com/api-requests |
|
1.200 solicitações por minuto e projeto |
Limites de fila
É possível colocar vários jobs de operações em lote do Storage na fila. O sistema aplica os seguintes limites de taxa quando você coloca jobs na fila:
- Por projeto, por minuto: no máximo 600 jobs em fila por projeto.
- Por projeto, por dia: no máximo 5.000 jobs em fila por projeto.
Servidor MCP do Cloud Storage
Nesta seção, descrevemos os limites e as cotas do servidor MCP do Cloud Storage. Para instruções sobre como usá-lo, consulte Usar o servidor MCP do Cloud Storage.
| Limite | Valor |
|---|---|
| Tamanhos máximos dos arquivos | 8 MiB |
| Pontos de extremidade compatíveis | Somente global |
A tabela a seguir descreve os limites de taxa por ferramenta:
| Cota | Valor |
|---|---|
Solicitações de McpListBuckets, McpListObjects, McpReadText, McpGetObjectMetadata, McpReadObject, McpGetBucketMetadata, McpGetBucketIamPolicy e McpTestBucketIamPermissions |
600 por minuto por projeto e por região |
Solicitações para McpCreateBucket, McpWriteText e McpDeleteObject |
300 por minuto por projeto e por região |
Solicitações de McpDeleteBucket e McpSetBucketIamPolicy |
100 por minuto, por projeto e por região |
Largura de banda
| Cota | Valor | Observações |
|---|---|---|
| Largura de banda máxima de cada region com saída de dados do Cloud Storage para os serviços do Google. | Cota padrão de 200 Gbps por região na maioria dos projetos, mas o valor pode ser menor com base no histórico da conta de faturamento do projeto. |
É possível solicitar aumentos de cota por projeto. Para saber como visualizar os limites de saída do Google de um projeto, consulte Ver e gerenciar cotas. Para saber como visualizar o uso de saída do Google em um projeto, consulte Monitoramento de largura de banda. |
| Largura de banda máxima de cada birregional com saída de dados do Cloud Storage para os serviços do Google. | Cota padrão de 200 Gbps para cada região em uma birregião para a maioria dos projetos, mas pode ser menor dependendo do histórico da conta de faturamento do projeto |
A saída para o Cloud CDN e o Media CDN está isenta dessa cota. É possível solicitar um aumento de cota por projeto. Para saber como visualizar os limites de saída do Google de um projeto, consulte Ver e gerenciar cotas. Para saber como visualizar o uso de saída do Google em um projeto, consulte Monitoramento de largura de banda. |
| Largura de banda máxima de cada multirregião com saída de dados do Cloud Storage para os serviços do Google. | Cota padrão de 200 Gbps por região na maioria dos projetos, mas o valor pode ser menor com base no histórico da conta de faturamento do projeto. |
A saída para o Cloud CDN e o Media CDN está isenta dessa cota. Cada região dentro da multirregião especificada tem uma cota separada. Por exemplo, digamos que o projeto Para saber como visualizar os limites de saída do Google de um projeto, consulte Ver e gerenciar cotas. Para saber como visualizar o uso de saída do Google em um projeto, consulte Monitoramento de largura de banda. É possível solicitar um aumento de cota por projeto. Em geral, é necessário usar buckets localizados em regiões ou birregiões para cargas de trabalho com altas taxas de saída para os Serviços do Google. Para buckets em multirregiões que executam cargas de trabalho grandes em serviços do Google, use o Serviço de transferência do Cloud Storage para mover seus dados para um bucket em uma região ou birregião. |
| Largura de banda de saída máxima para solicitações de Internet que acessam dados de buckets em um region | Cota padrão de 200 Gbps por região na maioria dos projetos, mas o valor pode ser menor com base no histórico da conta de faturamento do projeto. |
Para saber como visualizar os limites de saída de dados para a internet de um projeto, consulte Ver e gerenciar cotas. Para saber como visualizar o uso de saída de dados para a internet em um projeto, consulte Monitoramento de largura de banda. É possível solicitar aumentos de cota por projeto. |
| Largura de banda de saída máxima para solicitações de Internet que acessam dados de buckets em um birregional | Cota padrão de 200 Gbps para cada região em uma birregião para a maioria dos projetos, mas pode ser menor dependendo do histórico da conta de faturamento do projeto | A saída para o Cloud CDN e o Media CDN devido a ausências no cache está incluída nessa cota. Para saber como visualizar os limites de saída de dados para a internet de um projeto, consulte Ver e gerenciar cotas. Para saber como visualizar o uso da saída de dados para a internet de um projeto por região, consulte Monitoramento da largura de banda. É possível solicitar um aumento de cota por projeto. |
| Largura de banda de saída máxima para solicitações de Internet que acessam dados de buckets em uma determinada multirregião | Cota padrão de 200 Gbps por região na maioria dos projetos, mas o valor pode ser menor com base no histórico da conta de faturamento do projeto. |
A saída para o Cloud CDN e o Media CDN devido a ausências no cache está incluída nessa cota. As regiões dentro da multirregião têm cotas de saída de dados para a internet multirregionais separadas. Por exemplo, digamos que Para saber como visualizar os limites de saída de dados para a internet de um projeto, consulte Ver e gerenciar cotas. Para saber como visualizar o uso da saída de dados para a internet de um projeto por região, consulte Monitoramento da largura de banda. É possível solicitar um aumento de cota por projeto. |
Quando a largura de banda de um projeto excede uma determinada cota, as solicitações para os buckets afetados podem ser limitadas ou rejeitadas com um erro 429 - rateLimitExceeded repetível que inclui detalhes da cota excedida.
Consulte Uso da largura de banda para mais informações sobre como monitorar sua largura de banda.