Módulo Application da Azion
Gerencie a Applications usando o módulo Application.
O módulo Application da Azion oferece uma interface completa para interagir com a API de Applications da Azion. Este módulo permite gerenciar applications e seus componentes, incluindo configurações de cache, grupos de dispositivos, instâncias de funções, origens e configurações do mecanismo de regras.
Saiba mais sobre as Azion LibrariesVocê pode interagir com a API usando um client ou chamando os métodos diretamente da biblioteca. Ao fazer chamadas diretas, você pode usar as variáveis de ambiente para configurar o client sem precisar passar diretamente o token e os parâmetros de depuração.
Este é um exemplo de como um arquivo .env com suas variáveis de ambiente pode ser:
| Variavel | Descrição |
|---|---|
AZION_TOKEN | Seu token da API Azion. |
AZION_DEBUG | Ativa o modo de depuração (true/false). |
Uso
createClient
Exemplo em TypeScript:
Uso com Applications
createApplication
Cria uma nova application.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
data | { name: string; delivery_protocol: string; application_acceleration: boolean; } | Dados para a nova application. |
options? | debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionApplication>> | A application criada ou erro se a criação falhou. |
getApplications
Lista todas as applications.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
params? | { page?: number; page_size?: number; order?: 'id'} | 'name'; sort?: 'asc' | 'desc'; } | Parâmetros opcionais de filtro e paginação. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationCollectionResponse<AzionApplication>> | Uma coleção de applications ou erro se a busca falhou. |
getApplication
Busca uma application específica.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
applicationId | Número | O ID da application que você quer buscar. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionApplication>> | O objeto da application encontrada ou erro caso não localizado. |
updateApplication
Atualiza uma application existente.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
applicationId | Número | O ID da application a ser atualizada. |
data | { name?: string; delivery_protocol?: string; application_acceleration?: boolean; } | Os dados atualizados da application. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionApplication>> | O objeto application atualizado, ou erro caso a atualização tenha falhado. |
deleteApplication
Exclui uma application.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
applicationId | Número | O ID da application a ser excluída. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionDeletedApplication>> | Confirmação de exclusão ou erro se a operação falhou. |
Configurações de cache
createCacheSetting
Cria uma nova configuração de cache.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
data | { name: string; browser_cache_settings: string; cdn_cache_settings: string; } | Dados para a nova configuração de cache. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionCacheSetting>> | A configuração de cache criada ou erro se a operação falhou. |
getCacheSetting
Busca uma configuração de cache específica.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
cacheSettingId | Número | O ID da configuração de cache a ser buscado. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionCacheSetting>> | O objeto de configuração de cache encontrado ou erro caso não localizado. |
getCacheSettings
Lista todas configurações de cache.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
params? | { page?: number; page_size?: number; order?: 'id' | 'name'; sort?: 'asc' | 'desc'; } | Parâmetros opcionais de filtro e paginação. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationCollectionResponse<AzionCacheSetting>> | Uma coleção de configurações de cache ou erro caso a busca tenha falhado. |
updateCacheSetting
Atualizar uma configuração de cache existente.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
cacheSettingId | Número | O ID da configuração de cache a ser atualizada. |
data | { name?: string; browser_cache_settings?: string; cdn_cache_settings?: string; } | Dados atualizados para a configuração de cache. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionCacheSetting>> | O objeto de configuração atualizado ou erro se a operação falhou. |
deleteCacheSetting
Exclui uma configuração de cache.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
cacheSettingId | Número | O ID da configuração de cache a ser excluída. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionDeletedCacheSetting>> | Confirmação de exclusão ou erro se a operação falhou. |
Grupos de dispositivos
createDeviceGroup
Cria um novo grupo de dispositivos.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
data | { name: string; user_agent: string; } | Dados para o novo grupo de dispositivos. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionDeviceGroup>> | O grupo de dispositivos criado ou erro se a operação falhou. |
getDeviceGroup
Busca um grupo de dispositivos específico.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
deviceGroupId | Número | O ID do grupo de dispositivos a ser buscado. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionDeviceGroup>> | O objeto grupo de dispositivos encontrado ou erro caso não localizado. |
getDeviceGroups
Lista todos os grupos de dispositivos.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
params? | { page?: number; page_size?: number; order?: 'id' | 'name'; sort?: 'asc' | 'desc'; } | Parâmetros opcionais de filtro e paginação. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationCollectionResponse<AzionDeviceGroup>> | O objeto grupo de dispositivo encontrado ou erro caso não localizado. |
updateDeviceGroup
Atualiza um grupo de dispositivos.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
deviceGroupId | Número | O ID do grupo de dispositivos a ser atualizado. |
data | { name?: string; user_agent?: string; } | Os dados a serem atualizados do grupo de dispositivos. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionDeviceGroup>> | O grupo de dispositivos atualizados ou erro se a operação falhou. |
deleteDeviceGroup
Exclui um grupo de dispositivos.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
deviceGroupId | Número | O ID do grupo de dispositivos a ser excluído. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionDeletedDeviceGroup>> | Confirmação de exclusão ou erro se a operação falhou. |
Instância de function
createFunctionInstance
Cria uma nova instância de function.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
data | ApiCreateFunctionInstancePayload | Os dados para nova instância de function. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionFunctionInstance>> | Objeto instância de function criado ou erro se a operação falhou. |
getFunctionInstance
Busca uma instância de function específica.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
functionInstanceId | Número | O ID da function a ser buscada. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionFunctionInstance>> | A instância da function encontrada ou erro caso não localizada. |
getFunctionInstances
Lista todas as instâncias de functions.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
params? | ApiListFunctionInstancesParams | Parâmetros opcionais de filtro e paginação. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationCollectionResponse<AzionFunctionInstance>> | Uma coleção de instâncias de functions ou erro se não localizadas. |
updateFunctionInstance
Atualiza uma instância de function existente.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
functionInstanceId | Número | O ID da function a ser atualizada. |
data | ApiUpdateFunctionInstancePayload | Os dados atualizados da instância da function. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionFunctionInstance>> | O objeto function atualizado ou erro se a operação falhou. |
deleteFunctionInstance
Exclui uma instância de function.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
functionInstanceId | Número | O ID da instância de function a ser excluída. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionDeletedFunctionInstance>> | Confirmação de exclusão ou erro se a operação falhou. |
Origins
createOrigin
Cria uma nova Origin.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
data | { name: string; url: string; } | Os dados para a nova Origin. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionOrigin>> | O objeto Origin criado ou erro se a operação falhou. |
getOrigin
Busca uma Origin específica.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
originId | Número | O ID da Origin a ser localizada. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionOrigin>> | A Origin encontrada ou erro caso não localizada. |
getOrigins
Lista todas as Origins.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
params? | { page?: number; page_size?: number; order?: 'id' | 'name'; sort?: 'asc' | 'desc'; } | Parâmetros opcionais de filtro e paginação. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationCollectionResponse<AzionOrigin>> | Uma coleção de origins encontradas ou erro caso não localizadas. |
updateOrigin
Atualiza uma Origin existente.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
originId | Número | O ID da Origin a ser atualizada. |
data | { name?: string; url?: string; } | Os dados atualizados da Origin. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionOrigin>> | O objeto Origin atualizado ou erro se a operação falhou. |
deleteOrigin
Exclui uma Origin.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
originId | Número | O ID da Origin a ser excluída. |
options? | { debug?: boolean } | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionDeletedOrigin>> | Confirmação de exclusão ou erro se a operação falhou. |
Rules Engine
createRule
Cria uma nova regra.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
data | {ApiCreateRulePayload | Os dados da nova regra. |
options? | AzionClientOptions | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionRule>> | O objeto regra criado ou erro se a operação falhou. |
getRule
Busca uma regra específica.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
ruleId | Número | O ID da regra a ser localizada. |
options? | AzionClientOptions | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionRule>> | A regra encontrada ou erro se não localizada. |
getRules
Lista todas as regras.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
params? | ApiListRulesParams | Parâmetros opcionais de filtro e paginação. |
options? | AzionClientOptions | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationCollectionResponse<AzionRule>> | Uma coleção de regras ou erro se a operação falhou. |
updateRule
Atualiza uma regra existente.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
ruleId | Número | O ID da regra a ser atualizada. |
data | ApiUpdateRulePayload | Os dados atualizados da regra. |
options? | AzionClientOptions | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionRule>> | Objeto de regra atualizado ou erro se a operação falhou. |
deleteRule
Exclui uma regra.
Exemplo em TypeScript:
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
ruleId | Número | O ID da regra a ser excluída. |
options? | AzionClientOptions | Parâmetros opcionais para modo debug. |
Retorna:
| Tipo de Retorno | Descrição |
|---|---|
Promise<AzionApplicationResponse<AzionDeletedRule>> | Confirmação de exclusão ou erro se a operação falhou. |