Solucionar problemas da Azion Lib

Esta página lista os erros que você pode encontrar com os pacotes da Azion Lib, cada um com a causa e a correção. O carregamento e a autenticação vêm primeiro, seguidos de Storage, SQL, Applications e JWT.

Uma importação de tipo falha com does not provide an export named

Um arquivo TypeScript que importa de um pacote da Azion Lib para no carregamento, antes que qualquer chamada seja executada:

A importação mistura uma função e um tipo, como em import { getBucket, AzionBucket } from '@aziontech/storage'. Quando o Node.js remove os tipos do arquivo, ou em um projeto com verbatimModuleSyntax, a importação permanece como foi escrita, e o pacote não tem nenhum export em tempo de execução com o nome do tipo.

• Importe tipos com import type: mantenha as funções na importação de valores e mova cada tipo para uma linha própria, como import type { AzionBucket } from '@aziontech/storage';. Isso vale para todos os pacotes da Azion Lib.
• Deixe o tsc apontar o problema: execute tsc com --verbatimModuleSyntax. Ele informa TS1484 em uma importação mista. Sem a flag, tsc aceita o arquivo.

O arquivo carrega e a chamada é executada. Todos os exemplos em TypeScript das páginas da Azion Lib importam os tipos com import type.

Uma chamada falha com Invalid authentication credentials

Uma chamada retorna um erro de autenticação, ou lança um, e não alcança nenhum recurso. A mensagem depende do pacote e de um token ter chegado ou não à chamada:

A chamada levou um token que a API recusa, ou nenhum token. Uma função chamada diretamente lê o token da variável de ambiente AZION_TOKEN quando é executada. Um client lê o token do campo token dele.

• Defina AZION_TOKEN: exporte o seu personal token em AZION_TOKEN antes de executar o código que chama as funções.
• Passe o token ao client: um client criado com createClient recebe o token em token. Para as opções do client, consulte Client.
• Use um personal token válido: a API recusa qualquer outro valor. Para mais informações, consulte Tokens pessoais.

Com um token válido, a chamada retorna o resultado em data.

Uma chamada de storage retorna The specified bucket does not exist

Uma chamada de @aziontech/storage retorna um envelope de erro em vez do bucket ou do objeto:

Nenhum bucket da conta tem o nome que você passou. deleteBucket retorna a mesma mensagem, com operation definido como delete bucket. Para uma chave de objeto que o bucket não contém, getObjectByKey e deleteObject retornam The specified bucket object does not exist., com get object by key ou delete object em operation.

• Liste os buckets: getBuckets retorna o nome de todos os buckets da conta. Compare o nome que você passa com essa lista.
• Liste os objetos: getObjects retorna as chaves que um bucket contém.

Para as outras mensagens que essas funções retornam, consulte Erros do Storage. Com um nome existente, getBucket retorna o bucket em data.

createDatabase retorna The maximum number of databases has been reached

createDatabase de @aziontech/sql retorna um envelope de erro e não cria nenhum banco de dados:

A conta já tem o número máximo de bancos de dados que pode ter. A API responde à requisição com HTTP 403.

• Liste os bancos de dados: getDatabases retorna todos os bancos de dados da conta, com o nome e o status de cada um.
• Exclua um banco de dados de que você não precisa mais: deleteDatabase recebe o ID do banco de dados. A exclusão é permanente. Para o exemplo, consulte SQL.
• Verifique o limite do seu plano: para o número de bancos de dados que cada plano permite, consulte Limites por plano.

Quando a conta está abaixo do limite, createDatabase retorna o novo banco de dados em data.

Uma chamada de aplicação lança um erro em vez de retorná-lo

Uma chamada de azion/applications encerra o programa com um erro que o seu código não trata:

O módulo chama a Azion API v3, e as funções dele informam erros de duas formas. As cinco funções do nível da aplicação, createApplication, getApplication, getApplications, putApplication e patchApplication, lançam um erro em qualquer erro HTTP. As funções de origens, cache settings, device groups, instâncias de function e regras retornam { error: { message, operation } }.

• Envolva as funções do nível da aplicação em try e catch: uma aplicação inexistente, um token recusado e um payload recusado lançam um erro.
• Verifique error nas outras funções: leia error.message e error.operation depois de cada chamada.
• Passe um único objeto: toda função recebe um único objeto, como getApplication({ applicationId }). Um ID posicional, como em getApplication(1234), não envia nenhum ID, e a API responde 404.

Este script mostra os dois comportamentos. Substitua 1234567890 pelo ID de uma das suas aplicações:

O bloco catch recebe o 404 de getApplication, e getOrigin o retorna em error:

O programa chega à última linha. Para todas as funções do módulo, consulte Applications.

A criação de um device group falha com 400 BAD REQUEST

createDeviceGroup de azion/applications retorna {"error":{"message":"HTTP error! Status: 400 - BAD REQUEST","operation":"create device group"}}. A biblioteca descarta o motivo que a API informa.

A API recusa o nome do grupo. Para um nome como Mobile Devices, ela responde {"name":["This value does not match the required pattern."]}. Nomes com espaço ou hífen são recusados.

Para corrigir, use apenas letras e dígitos no nome, como MobileDevices. Azion Console mostra Name must be alphanumeric para outros caracteres. Para os campos de um device group, consulte Device Groups.

Este script cria um device group com um nome aceito. Substitua 1234567890 pelo ID da sua aplicação:

A função retorna o novo device group com o ID dele:

A criação de um cache setting falha em uma aplicação sem origem

createCacheSetting de azion/applications retorna {"error":{"message":"HTTP error! Status: 400 - BAD REQUEST","operation":"create cache setting"}}, e a aplicação não tem origem.

A API recusa um cache setting em uma aplicação que não tem origem. A resposta dela, que a biblioteca descarta, é It's not possible to create Cache Settings for Originless Edge Application.

• Crie uma origem primeiro: chame createOrigin na aplicação e depois chame createCacheSetting de novo. Para as duas funções, consulte Applications.

Em uma aplicação com origem, createCacheSetting retorna o novo cache setting em data, com o id dele.

Uma importação de classe de erro JWT falha com does not provide an export named

Um arquivo que importa uma classe de erro de @aziontech/jwt, como JwtAlgorithmNotImplemented, para no carregamento com uma linha que termina assim:

As declarações de tipo do pacote listam sete classes de erro, mas o módulo exporta apenas decode, sign, verify e um export padrão. O TypeScript aceita a importação, e o Node.js a recusa. azion/jwt se comporta da mesma forma.

• Compare err.name: remova a importação da classe e compare o name do erro que você captura com o nome da classe. instanceof não funciona sem a classe.

Este exemplo verifica um token, depois o verifica de novo com uma chave errada e imprime o nome e a mensagem do erro:

A primeira chamada imprime o payload, e a segunda imprime JwtTokenSignatureMismatched:

Os sete nomes, o caso que gera cada um e a mensagem dele, com o token substituído por <token>:

O bloco catch identifica o erro pelo nome. Para as funções, consulte JWT.

Recursos relacionados