Interface `Client` da Azion

A interface Client da Azion fornece um meio unificado para interagir com todos os produtos e serviços. Você pode usar o client para acessar e gerenciar todos os produtos e funcionalidades no Storage, SQL, Purge, e mais.

Ao instanciar um cliente, você pode definir explicitamente configurações como token e debug como parâmetros. Você pode então interagir com as funcionalidades da Azion diretamente através do client, de maneira simplificada e centralizada.

Saiba mais sobre as Azion Libraries

Use o Client da Azion

Para usar a interface Client, importe a função createClient das Azion Libraries. Você pode então passar seu token como parâmetro e usar a instância do client para acessar módulos e suas funcionalidades.

O exemplo abaixo mostra uma implementação em JavaScript:

import { createClient } from 'azion';

// Instancie o cliente
const client = createClient({ token: 'seu-token-api', debug: true });

// Acesse o módulo SQL e crie um Banco de Dados
const { data: newDatabase, error } = await client.sql.createDatabase('meu-novo-banco-de-dados');
if (data) {
  console.log(`Banco de dados criado com ID: ${newDatabase.id}`);
} else {
  console.error('Falha ao criar banco de dados', error);
}

Se você está usando TypeScript, importe os tipos apropriados como no exemplo abaixo:

import { createClient } from 'azion';
import type { AzionClient } from 'azion/client';
import type { AzionDatabaseResponse } from 'azion/sql';
// Instancie o cliente
const client = createClient({ token: 'seu-token-api', debug: true });

// Acesse o módulo SQL e crie um Banco de Dados
const { data: newDatabase, error }: AzionDatabaseResponse<AzionDatabase> = await client.sql.createDatabase('meu-novo-banco-de-dados');
if (data) {
  console.log(`Banco de dados criado com ID: ${newDatabase.id}`);
} else {
  console.error('Falha ao criar banco de dados', error);
}

Client da Azion vs funções independentes de pacote

Cada módulo tem seu próprio cliente interno que gerencia as interações. O exemplo abaixo mostra o uso de um cliente para um módulo específico:

import { createClient, StorageClient } from 'azion/storage';

// Crie um cliente para o módulo Storage
const client: StorageClient = createClient({ token: 'seu-token-api', debug: true });

const { data, error }: AzionStorageResponse<AzionBucket> = await client.createBucket({
  name: 'meu-novo-bucket',
  edge_access: 'public',
});

if (data) {
  console.log(`Bucket criado com nome: ${data.name}`);
} else {
  console.error('Falha ao criar bucket', error);
}

Também é possível usar funções específicas diretamente de seus pacotes, sem usar um client, como mostrado no exemplo abaixo.

import { createDatabase } from 'azion/sql';

// Chame a função createDatabase diretamente de seu pacote
const { data, error } = await createDatabase('meu-novo-banco-de-dados', { debug: true });
if (data) {
  console.log(`Banco de dados criado com ID: ${data.id}`);
} else {
  console.error('Falha ao criar banco de dados', error);
}

Essa flexibilidade permite que você gerencie tudo através do client para simplificar ou chame funções específicas de cada pacote com mais controle sobre as configurações do ambiente.