Esta página lista os limites que os armazenamentos de dados impõem sobre solicitações, dados, taxa de transferência e armazenamento, seguidos pelos códigos de erro que as solicitações falhadas retornam.
Limites
Modelos de dados têm limites. Se uma experiência exceder esses limites, o serviço automaticamente reduz o uso do armazenamento de dados da experiência e faz com que futuras solicitações sejam colocadas em uma das seguintes filas:
- Definir
- Conjunto ordenado
- Obter
- Obter ordenado
As solicitações em uma fila são tratadas na ordem em que são recebidas. A função chamada continua a ceder enquanto sua solicitação ainda estiver na fila. Se a chave do armazenamento de dados em si estiver sendo limitada, a solicitação é colocada em uma fila, mas é temporariamente ignorada.
Cada fila tem um limite de 30 solicitações. Quando o limite de uma fila é atingido, as solicitações falham com um código de erro na faixa de 301-306, indicando que as solicitações foram completamente descartadas.
Limites de dados
Os armazenamentos de dados limitam quanto dados podem ser usados por entrada.
O nome do armazenamento de dados, o nome da chave e escopo devem estar todos abaixo de um certo comprimento de caracteres. Use string.len() para verificar seu comprimento.
Os dados (valor da chave) também são armazenados como uma string, independentemente de seu tipo inicial. Você pode verificar o tamanho dos dados com a função JSONEncode(), que converte dados Luau em uma tabela JSON serializada.
| Componente | Número máximo de caracteres |
|---|---|
| Nome do armazenamento de dados | 50 |
| Nome da chave | 50 |
| Escopo | 50 |
| Dados (valor da chave) | 4.194.304 por chave |
Limites de metadados
Limites para o número de caracteres em metadados definidos pelo usuário.
| Componente | Número máximo de caracteres |
|---|---|
| Nome da chave | 50 |
| Valor | 250 |
| Pares chave-valor | 300 |
Limites de throughput
Os limites de throughput por chave garantem que o desempenho seja ideal nos servidores Roblox. Cada limite se aplica a cada chave individual em todos os servidores de uma experiência e se renova ao longo do tempo.
O Roblox examina o uso da cota associada à chave nos últimos 60 segundos. Se o uso, incluindo a solicitação atual, estiver dentro do limite de throughput, a solicitação é aprovada. Se o uso exceder o limite, a solicitação é negada.
| Tipo de solicitação | API do servidor do jogo | API do Open Cloud | Limite |
|---|---|---|---|
| Leitura | GetAsync() GetVersionAsync() GetVersionAtTimeAsync() ListVersionsAsync() UpdateAsync() | Obter entrada do Data Store | 25 MB por minuto |
| Escrita | SetAsync() IncrementAsync() UpdateAsync() RemoveAsync() | Criar, Atualizar, Incrementar, Remover entrada do Data Store | 4 MB por minuto |
Além dos limites de throughput acima, o Roblox organiza os dados em partições com base em um esquema interno. Como resultado, quando o servidor backend recebe um alto volume de solicitações para o mesmo data store, isso pode resultar em mais limitação. Independentemente da causa, a limitação se manifesta como erros DatastoreThrottled ou KeyThrottled, dependendo se o limite de throughput foi excedido para um único data store ou uma chave. Essas mensagens de erro se aplicam tanto a data stores ordenados quanto padrão.
Limites de armazenamento
Para manter o armazenamento estável e escalável, os data stores usam um limite de nível de jogo sobre o uso de armazenamento.
Esse limite consiste em uma alocação base para cada jogo mais uma alocação adicional com base no número de usuários vitalícios. Um usuário vitalício é qualquer usuário que tenha se juntado ao seu jogo pelo menos uma vez.
O limite de armazenamento é calculado usando a seguinte fórmula Total latest version storage limit = 500 MB + 1 MB × lifetime user count.
O uso de armazenamento é medido usando o tamanho comprimido da versão mais recente de cada chave. Os data stores comprimem automaticamente seus dados antes do armazenamento, portanto, evite pré-comprimir você mesmo. A pré-compressão adiciona sobrecarga desnecessária de CPU e pode reduzir a eficácia da compressão embutida dos data stores. Ao armazenar dados não comprimidos, você se beneficia automaticamente das melhorias nos algoritmos de compressão do Roblox e de futuras otimizações baseadas em esquema.
Apenas a versão mais recente de cada chave conta para o uso de armazenamento. Chaves excluídas e versões substituídas, embora ainda acessíveis através das APIs de versão durante seu período de retenção, não contam para o uso de armazenamento. No entanto, os dados armazenados excluídos através do método Open Cloud DeleteDataStore continuam a contar para o uso de armazenamento durante seu período de processamento de exclusão de 30 dias, até que sejam removidos permanentemente.
Limites de acesso
Os data stores estão sujeitos a limites tanto de experiência quanto de nível de servidor. Os limites de nível de experiência escalam com o total de usuários simultâneos na experiência, enquanto os limites de nível de servidor são configuráveis e destinados a serem usados como uma ferramenta pelo criador.
Limites de Experiência
Cada experiência tem um número permitido de solicitações de data store com base no tipo de data store, tipo de solicitação e número de usuários simultâneos. Para cada tipo de data store e tipo de solicitação, o limite é compartilhado entre todas as funções listadas.
- UpdateAsync() consome tanto do orçamento de solicitações de leitura quanto de gravação. Uma única chamada diminuirá ambos os limites.
- O servidor de jogo e o Open Cloud compartilham um orçamento; o tráfego do Open Cloud pode ser limitado pelo uso dentro da experiência (e vice-versa). Veja Controlar limites de taxa para mais orientações.
Data stores padrão
| Tipo de solicitação | API do servidor de jogo | API do Open Cloud | Limites compartilhados (solicitações por minuto) |
|---|---|---|---|
| Leitura | GetAsync() GetVersionAsync() GetVersionAtTimeAsync() UpdateAsync() | Obter entrada do Data Store | 300 + usuáriosSimultâneos × 40 |
| Gravação | SetAsync() IncrementAsync() UpdateAsync() | Criar, Atualizar, Incrementar entrada do Data Store | 300 + usuáriosSimultâneos × 20 |
| Listar | ListDataStoresAsync() ListKeysAsync() ListVersionsAsync() | Listar Data Stores, Listar Entradas do Data Store, Listar Revisões de Entrada do Data Store | 300 + usuáriosSimultâneos × 2 |
| Remover | RemoveAsync() | Excluir entrada do Data Store, Excluir Data Store, Restaurar Data Store | 300 + usuáriosSimultâneos × 40 |
Data stores ordenados
| Tipo de solicitação | API do servidor de jogo | API do Open Cloud | Limites compartilhados (solicitações por minuto) |
|---|---|---|---|
| Leitura | GetAsync() BatchGetAsync() UpdateAsync() | Obter entrada do Data Store Ordenado | 300 + usuáriosSimultâneos × 40 |
| Gravação | SetAsync() IncrementAsync() UpdateAsync() | Criar, Atualizar, Incrementar entrada do Data Store Ordenado | 300 + usuáriosSimultâneos × 20 |
| Listar | GetSortedAsync() | Listar Entradas do Data Store Ordenado | 300 + usuáriosSimultâneos × 2 |
| Remover | RemoveAsync() | Excluir entrada do Data Store Ordenado | 300 + usuáriosSimultâneos × 40 |
Controlar limites de taxa
Como as solicitações do Open Cloud e do servidor de jogo são compartilhadas, é importante controlar independentemente quanto cada um pode consumir do orçamento.
Servidor de jogo
Servidores individuais têm limites embutidos, conforme descrito acima. Use uma combinação de SetRateLimitForRequestType() e GetRequestBudgetForRequestType() para manter um controle detalhado sobre a contribuição de servidores individuais ao orçamento total.
Open Cloud
As solicitações do Open Cloud requerem uma solução externa de limitação de taxa. Recomendamos uma das seguintes abordagens:
- (Simples) Adicione um curto tempo limite após cada solicitação, especialmente se estiver chamando a mesma API em um loop contínuo. Defina esse tempo limite igual a 60 / (desired budget consumption per minute) segundos, como um limite superior. Observe que essa abordagem não permite que as solicitações sejam enviadas em rajadas.
- (Robusta) Implemente um limitador de taxa local usando a estratégia do balde furado.
Os seguintes exemplos de código Node.js incluem implementações de referência.
const apiKey = process.env.API_KEY;
if (!apiKey) {
throw new Error('The API_KEY environment variable is not set.');
}
const apiHeaderKey = 'x-api-key';
const universeId = '';
const dataStoreId = 'Inventory';
const baseUrl = 'https://apis.roblox.com/cloud/v2/';
// --- Per-operation rate limiting config (requests per minute) ---
const LIST_RATE_PER_MIN = 60;
const GET_RATE_PER_MIN = 120;
const UPDATE_RATE_PER_MIN = 60;
// Upper-bound spacing per operation: 60 / (requests per min) seconds.
const LIST_INTERVAL_MS = (60 / LIST_RATE_PER_MIN) * 1000;
const GET_INTERVAL_MS = (60 / GET_RATE_PER_MIN) * 1000;
const UPDATE_INTERVAL_MS = (60 / UPDATE_RATE_PER_MIN) * 1000;
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
// Performs the request, then waits this operation's own interval before returning.
async function throttledFetch(url, options, intervalMs) {
const response = await fetch(url, options);
await sleep(intervalMs);
return response;
}
async function listEntries(universe, dataStore) {
const listPath = `universes/${universe}/data-stores/${dataStore}/entries`;
const url = baseUrl + listPath;
const response = await throttledFetch(url, {
headers: { [apiHeaderKey]: apiKey }
}, LIST_INTERVAL_MS);
return response.json();
}
async function getEntry(path) {
const url = baseUrl + path;
const response = await throttledFetch(url, {
headers: { [apiHeaderKey]: apiKey }
}, GET_INTERVAL_MS);
return response.json();
}
async function updateEntry(path, payload) {
const url = baseUrl + path;
const response = await throttledFetch(url, {
method: 'PATCH',
headers: {
[apiHeaderKey]: apiKey,
'Content-Type': 'application/json'
},
body: JSON.stringify(payload) // The body must be a string
}, UPDATE_INTERVAL_MS);
return response;
}
(async () => {
try {
const entries = await listEntries(universeId, dataStoreId);
for (const entry of entries.dataStoreEntries) {
const path = entry.path;
console.log(`\nProcessing entry: ${path}`);
const currentData = await getEntry(path);
currentData.value.currency += 10;
const payload = { value: currentData.value };
const updateResponse = await updateEntry(path, payload);
console.log(`Status: ${updateResponse.status}`);
console.log(`Response: ${await updateResponse.text()}`);
}
} catch (error) {
console.error('An error occurred during execution:', error);
}
})();Limites do servidor
Cada servidor tem um limite de taxa configurável para cada tipo de solicitação, com base no número de jogadores nesse servidor. Os servidores recebem um aumento de orçamento de solicitação adicional uma única vez quando são criados pela primeira vez. Use GetRequestBudgetForRequestType() para confirmar o número de solicitações de armazenamento de dados que o servidor atual pode fazer a qualquer momento.
Esses limites são configuráveis pelo criador usando a SetRateLimitForRequestType() API. Usando essa API, um criador pode configurar seus próprios limites de taxa de armazenamento de dados para cada tipo de solicitação.
Os seguintes limites de taxa padrão se aplicam se a API não for chamada:
Armazenamentos de dados padrão
| Tipo de solicitação | DataStoreRequestType Enum | API do servidor de jogo | Solicitações por minuto |
|---|---|---|---|
| Leitura | StandardRead | GetAsync() GetVersionAsync() GetVersionAtTimeAsync() UpdateAsync() | 60 + numPlayers × 40 |
| Escrita | StandardWrite | SetAsync() IncrementAsync() UpdateAsync() | 60 + numPlayers × 40 |
| Listar | StandardList | ListDataStoresAsync() ListKeysAsync() ListVersionsAsync() | 5 + numPlayers × 2 |
| Remover | StandardRemove | RemoveAsync() | 60 + numPlayers × 40 |
| RemoverVersão (Depreciado) | RemoveVersionAsync | RemoveVersionAsync() | 5 + numPlayers × 2 |
Armazenamentos de dados ordenados
| Tipo de solicitação | DataStoreRequestType Enum | API do servidor do jogo | Solicitações por minuto |
|---|---|---|---|
| Leitura | OrderedRead | GetAsync() BatchGetAsync() UpdateAsync() | 60 + numPlayers × 40 |
| Gravação | OrderedWrite | SetAsync() IncrementAsync() UpdateAsync() | 30 + numPlayers × 5 |
| Listar | OrderedList | GetSortedAsync() | 5 + numPlayers × 2 |
| Remover | OrderedRemove | RemoveAsync() | 30 + numPlayers × 5 |
Referência de código de erro
As solicitações que você faz aos armazenamentos de dados podem falhar devido a conectividade ruim ou outros problemas. Para lidar com erros e retornar mensagens com um código de erro, envolva as funções de armazenamento de dados em pcall().
Uma chamada de gravação falhada, como UpdateAsync(), significa que o servidor do jogo não recebeu uma resposta bem-sucedida. Isso não garante sempre que a gravação no backend não ocorreu. Em alguns cenários de falha, o estado final da gravação pode ser desconhecido para o chamador até que seja verificado com uma leitura subsequente sem cache.
| Código de erro | Nome do erro | Mensagem de erro | Notas | |
|---|---|---|---|---|
| 101 | KeyNameEmpty | O nome da chave não pode estar vazio. | Verifique se a chave inserida na função de armazenamento de dados é uma string vazia. | |
| 102 | KeyNameLimit | O nome da chave excede o limite de 50 caracteres. | Verifique se a chave inserida na função de armazenamento de dados excede um comprimento de 50. | |
| 103 | ValueNotAllowed | Não é permitido X em DataStore. | Uma função de atualização ruim retornou um valor do tipo X. | |
| 104 | CantStoreValue | Não é possível armazenar X em DataStore. | A função de atualização retornou um valor do tipo X que não foi serializado. | |
| 105 | ValueTooLarge | O valor serializado excede o limite de X. | Se você estiver definindo um valor com SetAsync() ou UpdateAsync(), o comprimento serializado do valor não pode exceder o tamanho de X. Para verificar o comprimento serializado dos dados, use JSONEncode(). | |
| 106 | MaxValueInvalid | MaxValue deve ser um inteiro. | Se você estiver passando um valor máximo para GetSortedAsync() para um OrderedDataStore, ele deve ser um inteiro. | |
| 106 | MinValueInvalid | MinValue deve ser um inteiro. | Se você estiver passando um valor mínimo para GetSortedAsync() para um OrderedDataStore, ele deve ser um inteiro. | |
| 106 | PageSizeGreater | PageSize deve estar dentro de um intervalo predefinido. | O tamanho mínimo da página para um OrderedDataStore é 1. | |
| 106 | PageSizeLesser | PageSize deve estar dentro de um intervalo predefinido. | O tamanho máximo da página para um OrderedDataStore é 100. | |
| 107 | MinMaxOrderInvalid | MaxValue deve ser maior ou igual a MinValue. | O valor máximo deve ser maior ou igual ao valor mínimo para GetSortedAsync(). | |
| 301 | GetAsyncThrottle | GetAsync solicitação descartada. A solicitação foi limitada, mas a fila estava cheia. | GetAsync() a solicitação excedeu o tamanho máximo da fila e o Roblox não consegue processar as solicitações na taxa atual. | |
| 302 | SetAsyncThrottle | SetAsync solicitação descartada. A solicitação foi limitada, mas a fila estava cheia. | SetAsync() a solicitação excedeu o tamanho máximo da fila e o Roblox não consegue processar as solicitações na taxa atual. | |
| 303 | IncreAsyncThrottle | IncrementAsync solicitação descartada. A solicitação foi limitada, mas a fila estava cheia. | IncrementAsync() a solicitação excedeu o tamanho máximo da fila e o Roblox não consegue processar as solicitações na taxa atual. | |
| 304 | UpdateAsyncThrottle | UpdateAsync solicitação descartada. A solicitação foi limitada, mas a fila estava cheia. | UpdateAsync() a solicitação excedeu o tamanho máximo da fila e o Roblox não consegue processar as solicitações na taxa atual. | |
| 304 | TransformThrottle | UpdateAsync solicitação descartada. A solicitação foi limitada, mas a fila estava cheia. | UpdateAsync() a solicitação excedeu o tamanho máximo da fila e o Roblox não consegue processar as solicitações na taxa atual. | |
| 305 | GetSortedThrottle | GetSorted solicitação descartada. A solicitação foi limitada, mas a fila estava cheia. | GetSortedAsync() a solicitação excedeu o tamanho máximo da fila e o Roblox não consegue processar as solicitações na taxa atual. | |
| 306 | RemoveAsyncThrottle | RemoveAsync solicitação descartada. A solicitação foi limitada, mas a fila estava cheia. | RemoveAsync() a solicitação excedeu o tamanho máximo da fila e o Roblox não consegue processar as solicitações na taxa atual. | |
| 401 | DataModelNoAccess | Solicitação falhou. DataModel está inacessível enquanto a experiência está sendo encerrada. | DataModel está não inicializado porque a experiência está sendo encerrada. | |
| 402 | LuaWebSrvsNoAccess | Solicitação falhou. LuaWebService está inacessível enquanto a experiência está sendo encerrada. | LuaWebService está não inicializado porque a experiência está sendo encerrada. | |
| 403 | StudioAccessToApisNotAllowed | Não é possível gravar em DataStore a partir do Studio porque o acesso à API não está habilitado. | O acesso à API deve estar ativo para usar os data stores no Studio. | |
| 404 | InternalError | OrderedDataStore não existe. | O OrderedDataStore associado a esta solicitação não foi encontrado. Isso pode ser um sinal de corrupção de dados. Tente novamente mais tarde. | |
| 501 | InternalError | Não é possível analisar a resposta porque os dados podem estar corrompidos. | O servidor não conseguiu analisar a resposta à sua solicitação. Isso pode ser um sinal de corrupção de dados. Tente novamente mais tarde. | |
| 502 | RequestRejected | Os serviços de API rejeitaram a solicitação com o erro X. | O erro X ocorreu durante o processamento nos servidores Roblox. Tente novamente mais tarde. | |
| 503 | InternalError | A solicitação do data store foi bem-sucedida, mas a chave não foi encontrada. | A chave solicitada não foi encontrada no data store. Isso pode ser um sinal de corrupção de dados. Tente novamente mais tarde. | |
| 504 | InternalError | A solicitação do data store foi bem-sucedida, mas a resposta não foi formatada corretamente. | O servidor não conseguiu analisar a resposta à sua solicitação. Isso pode ser um sinal de corrupção de dados. Tente novamente mais tarde. | |
| 505 | InternalError | OrderedDataStore a solicitação foi bem-sucedida, mas a resposta não foi formatada corretamente. | O servidor não conseguiu analisar a resposta à sua OrderedDataStore solicitação. Isso pode ser um sinal de corrupção de dados. Tente novamente mais tarde. | |
| 509 | OperationNotAllowed | As operações do data store estão bloqueadas enquanto são executadas em um RCC Pessoal para evitar possível corrupção de dados. | As gravações do data store estão bloqueadas em canais RCC privados. | |
| 511 | AttributeSizeTooLarge | O tamanho do atributo de metadados excede o limite de X. | O tamanho dos metadados serializados excede o limite de X. O valor X é dinâmico. Se o tamanho mudar, o valor também mudará. | |
| 512 | UserIdLimitExceeded | O tamanho UserID excede o limite de X. | O comprimento do array de IDs de usuário fornecido pelo usuário excede o limite de X. | |
| 513 | AttributeFormatError | O formato do atributo userId é inválido. | O ID de usuário fornecido não é um número. | |
| 513 | AttributeFormatError | O formato dos metadados do atributo é inválido. | Os metadados não são uma tabela. | |
| GetVersionAsyncThrottle | GetVersionAsync a solicitação foi descartada. A solicitação foi limitada. | GetVersionAsync() a solicitação excedeu o tamanho máximo da fila e o Roblox não consegue processar as solicitações na taxa atual. | ||
| GetVersionAtTimeAsyncThrottle | GetVersionAtTimeAsync a solicitação foi descartada. A solicitação foi limitada. | GetVersionAtTimeAsync() a solicitação excedeu o tamanho máximo da fila e o Roblox não consegue processar as solicitações na taxa atual. | ||
| ListDataStoresAsyncThrottle | ListDataStoresAsync a solicitação foi descartada. A solicitação foi limitada. | ListDataStoresAsync() a solicitação excedeu o tamanho máximo da fila e o Roblox não consegue processar as solicitações na taxa atual. | ||
| ListKeysAsyncThrottle | ListKeysAsync a solicitação foi descartada. A solicitação foi limitada. | ListKeysAsync() a solicitação excedeu o tamanho máximo da fila e o Roblox não consegue processar as solicitações na taxa atual. | ||
| ListVersionsAsyncThrottle | ListVersionsAsync a solicitação foi descartada. A solicitação foi limitada. | ListVersionsAsync() a solicitação excedeu o tamanho máximo da fila e o Roblox não consegue processar as solicitações na taxa atual. | ||
| RemoveVersionAsyncThrottle | RemoveVersionAsync a solicitação foi descartada. A solicitação foi limitada. | RemoveVersionAsync() a solicitação excedeu o tamanho máximo da fila e o Roblox não consegue processar as solicitações na taxa atual. | ||
| InvalidTimestamp | O timestamp deve ser positivo e não pode ser mais de dez minutos no futuro. | O timestamp fornecido para GetVersionAtTimeAsync() não era válido. | ||
| StandardReadExperienceThrottled | StandardRead a solicitação foi limitada pelos limites de experiência. | Uma solicitação para GetAsync(), GetVersionAsync(), GetVersionAtTimeAsync(), ou a leitura de UpdateAsync() em um data store padrão excedeu o StandardRead limite de taxa de nível de experiência. | ||
| StandardWriteExperienceThrottled | StandardWrite a solicitação foi limitada pelos limites de experiência. | Uma solicitação para SetAsync(), IncrementAsync(), ou a gravação de UpdateAsync() em um data store padrão excedeu o StandardWrite limite de taxa de nível de experiência. | ||
| StandardListExperienceThrottled | StandardList a solicitação foi limitada pelos limites de experiência. | Uma solicitação para ListKeysAsync(), ListVersionsAsync(), ou ListDataStoresAsync() em data stores padrão excedeu o StandardList limite de taxa de nível de experiência. | ||
| StandardRemoveExperienceThrottled | StandardRemove a solicitação foi limitada pelos limites de experiência. | Uma solicitação para RemoveAsync() em um data store padrão excedeu o StandardRemove limite de taxa de nível de experiência. | ||
| OrderedReadExperienceThrottled | OrderedRead a solicitação foi limitada pelos limites de experiência. | Uma solicitação para GetAsync(), BatchGetAsync(), ou a leitura de UpdateAsync() em um data store ordenado excedeu o OrderedRead limite de taxa de nível de experiência. | ||
| OrderedWriteExperienceThrottled | OrderedWrite a solicitação foi limitada pelos limites de experiência. | Uma solicitação para SetAsync(), IncrementAsync(), ou a gravação de UpdateAsync() em um data store ordenado excedeu o OrderedWrite limite de taxa de nível de experiência. | ||
| OrderedListExperienceThrottled | OrderedList a solicitação foi limitada pelos limites de experiência. | Uma solicitação para GetSortedAsync() em um data store ordenado excedeu o OrderedList limite de taxa de nível de experiência. | ||
| OrderedRemoveExperienceThrottled | OrderedRemove a solicitação foi limitada pelos limites de experiência. | Uma solicitação para RemoveAsync() em um data store ordenado excedeu o OrderedRemove limite de taxa de nível de experiência. | ||
| StandardReadGameServerThrottled | StandardRead a solicitação foi limitada pelos limites do servidor do jogo ou a fila de solicitações estava cheia. | Uma solicitação para GetAsync(), GetVersionAsync(), GetVersionAtTimeAsync(), ou a leitura de UpdateAsync() em um data store padrão excedeu o StandardRead limite de taxa de nível do servidor do jogo. | ||
| StandardWriteGameServerThrottled | StandardWrite a solicitação foi limitada pelos limites do servidor do jogo ou a fila de solicitações estava cheia. | Uma solicitação para SetAsync(), IncrementAsync(), ou a gravação de UpdateAsync() em um data store padrão excedeu o StandardWrite limite de taxa de nível do servidor do jogo. | ||
| StandardListGameServerThrottled | StandardList a solicitação foi limitada pelos limites do servidor do jogo ou a fila de solicitações estava cheia. | Uma solicitação para ListKeysAsync(), ListVersionsAsync(), ou ListDataStoresAsync() em data stores padrão excedeu o StandardList limite de taxa de nível do servidor do jogo. | ||
| StandardRemoveGameServerThrottled | StandardRemove a solicitação foi limitada pelos limites do servidor do jogo ou a fila de solicitações estava cheia. | Uma solicitação para RemoveAsync() em um data store padrão excedeu o StandardRemove limite de taxa de nível do servidor do jogo. | ||
| OrderedReadGameServerThrottled | OrderedRead a solicitação foi limitada pelos limites do servidor do jogo ou a fila de solicitações estava cheia. | Uma solicitação para GetAsync(), BatchGetAsync(), ou a leitura de UpdateAsync() em um data store ordenado excedeu o OrderedRead limite de taxa de nível do servidor do jogo. | ||
| OrderedWriteGameServerThrottled | OrderedWrite a solicitação foi limitada pelos limites do servidor do jogo ou a fila de solicitações estava cheia. | Uma solicitação para SetAsync(), IncrementAsync(), ou a gravação de UpdateAsync() em um armazenamento de dados ordenado excedeu o OrderedWrite limite de taxa no nível do servidor do jogo. | ||
| OrderedListGameServerThrottled | A solicitação OrderedList foi limitada pelos limites do servidor do jogo ou a fila de solicitações estava cheia. | Uma solicitação para GetSortedAsync() em um armazenamento de dados ordenado excedeu o limite de taxa OrderedList no nível do servidor do jogo. | ||
| OrderedRemoveGameServerThrottled | A solicitação foi limitada pelos limites do servidor do jogo ou a fila de solicitações estava cheia.OrderedRemove | Uma solicitação para RemoveAsync() em um armazenamento de dados ordenado excedeu o OrderedRemove limite de taxa no nível do servidor do jogo. |
Códigos de erro do servidor
| Nome do erro | Mensagem de erro | Notas |
|---|---|---|
| DatastoreDeleted | O armazenamento de dados foi excluído. | Uma operação no armazenamento de dados não pôde ocorrer porque o armazenamento de dados foi excluído anteriormente. |
| DatastoreThrottled | A taxa de solicitação excede o máximo permitido para o datastore. | Solicitações demais foram enviadas para um único armazenamento de dados. |
| InternalServerError | Ocorreu um erro interno do servidor. | Erro ocasional nos servidores do Roblox. Tente novamente, idealmente com um retrocesso exponencial. |
| InvalidExclusiveStartKey | A chave de início exclusiva fornecida não é válida. | A chave de início exclusiva (cursor) fornecida para uma operação de lista, como ListKeysAsync(), não é válida. |
| InvalidPlace | O lugar fornecido é inválido. | Nenhum ID de Universo correspondente para o lugar. Tente novamente mais tarde. |
| InvalidTarget | O alvo fornecido é inválido. | O nome da chave do armazenamento de dados ordenado excede o limite de 50 caracteres. |
| InvalidUniverse | O universo fornecido é inválido. | Nenhum ID de Lugar correspondente para o universo. Tente novamente mais tarde. |
| InvalidUserIds | Os IDs de usuário fornecidos têm um formato inválido. | Falha ao analisar os IDs de usuário. |
| KeyThrottled | A taxa de solicitação excede o máximo permitido para a chave. | A taxa de solicitação excede a taxa de solicitação máxima permitida para uma única chave. |
| KeyNotFound | A chave solicitada não existe. | A chave não existe. |
| N/A | Não há páginas para avançar. | Esse erro ocorre quando você chama Pages:AdvanceToNextPageAsync() na última página. |
| StandardReadExperienceThrottled | A taxa de solicitação de leitura padrão excede o máximo permitido para a experiência. | Uma solicitação para GetAsync(), GetVersionAsync(), GetVersionAtTimeAsync(), ou a leitura de UpdateAsync() em um armazenamento de dados padrão excedeu o StandardRead limite de taxa a nível de experiência. |
| StandardWriteExperienceThrottled | A taxa de solicitação de gravação padrão excede o máximo permitido para a experiência. | Uma solicitação para SetAsync(), IncrementAsync(), ou a gravação de UpdateAsync() em um armazenamento de dados padrão excedeu o StandardWrite limite de taxa a nível de experiência. |
| StandardListExperienceThrottled | A taxa de solicitação de lista padrão excede o máximo permitido para a experiência. | Uma solicitação para ListKeysAsync(), ListVersionsAsync(), ou ListDataStoresAsync() em armazenamentos de dados padrão excedeu o StandardList limite de taxa a nível de experiência. |
| StandardRemoveExperienceThrottled | A taxa de solicitação de remoção padrão excede o máximo permitido para a experiência. | Uma solicitação para RemoveAsync() em um armazenamento de dados padrão excedeu o limite de taxa de nível de experiência StandardRemove. |
| OrderedReadExperienceThrottled | A taxa de solicitação de leitura ordenada excede o máximo permitido para a experiência. | Uma solicitação para GetAsync(), BatchGetAsync(), ou a leitura de UpdateAsync() em um armazenamento de dados ordenado excedeu o limite de taxa de nível de experiência OrderedRead. |
| OrderedWriteExperienceThrottled | A taxa de solicitação de gravação ordenada excede o máximo permitido para a experiência. | Uma solicitação para SetAsync(), IncrementAsync(), ou a gravação de UpdateAsync() em um armazenamento de dados ordenado excedeu o limite de taxa de nível de experiência OrderedWrite. |
| OrderedListExperienceThrottled | A taxa de solicitação de lista ordenada excede o máximo permitido para a experiência. | Uma solicitação para GetSortedAsync() em um armazenamento de dados ordenado excedeu o limite de taxa de nível de experiência OrderedList. |
| OrderedRemoveExperienceThrottled | A taxa de solicitação de remoção ordenada excede o máximo permitido para a experiência. | Uma solicitação para RemoveAsync() em um armazenamento de dados ordenado excedeu o limite de taxa de nível de experiência OrderedRemove. |