Azion CLI function-instance
Comandos da Azion CLI que criam, listam, descrevem, atualizam e excluem instâncias de function, com as flags, os tipos e os padrões de cada comando.
Os comandos function-instance da Azion CLI criam, listam, descrevem, atualizam e excluem instâncias de function. Uma instância de function vincula uma function a uma aplicação e carrega os argumentos que o código da function recebe. As opções compartilhadas por todos os comandos, como --format, --out e -y, estão listadas em Opções globais da Azion CLI.
Criar
azion create function-instance adiciona uma function a uma aplicação como uma instância de function:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--active | — | string | "true" | Define se a instância de function está ativa (true) ou não (false). |
--application-id | — | int | — | ID da aplicação que recebe a instância de function. |
--args | — | string | — | Caminho de um arquivo JSON com os argumentos da instância de function. |
--file | — | string | — | Caminho de um arquivo JSON com os atributos da instância de function. Use - para ler o JSON da entrada padrão. |
--function-id | — | int | — | Obrigatório, a menos que --file esteja definida. ID da function a instanciar. Sem ela, o comando pede o ID. |
--name | — | string | — | Nome da instância de function. |
--args recebe o caminho de um arquivo JSON, não o próprio JSON. Um JSON inline falha com este erro:
Este arquivo guarda os argumentos da instância de function:
Este comando cria uma instância de function chamada my-instance a partir da function com ID 12359 na aplicação com ID 1234567890 e passa a ela os argumentos de fi-args.json:
O comando imprime o ID da instância de function:
Listar
azion list function-instance lista as instâncias de function de uma aplicação, 50 por página:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--application-id | — | int | — | ID da aplicação cujas instâncias de function você lista. |
--details | — | — | — | Adiciona as colunas LAST EDITOR e LAST MODIFIED às colunas ID, NAME, ACTIVE e FUNCTION. |
--filter | — | string | — | Nome pelo qual a lista é filtrada. |
--order-by | — | string | — | Campo pelo qual a lista é ordenada. |
--page | — | int | 1 | Número da página a retornar. |
--page-size | — | int | 50 | Número de instâncias de function em cada página. |
Este comando lista as instâncias de function da aplicação com ID 1234567890:
O comando imprime uma linha por instância de function, com o ID da function que ela executa:
Descrever
azion describe function-instance imprime as configurações de uma instância de function:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--application-id | — | int | — | ID da aplicação que contém a instância de function. |
--instance-id | — | int | — | ID da instância de function a descrever. |
Este comando descreve a instância de function com ID 12361:
O comando imprime o ID, o nome, a function e a última alteração da instância de function:
A saída simples deixa os argumentos de fora. Com --format json, o comando imprime o objeto completo: active, args, azion_form, created_at, function, id, last_editor, last_modified e name. Para a instância de function acima, args contém o objeto lido de fi-args.json:
Atualizar
azion update function-instance altera os atributos de uma instância de function:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--active | — | string | "true" | Define se a instância de function está ativa (true) ou não (false). |
--application-id | — | int | — | ID da aplicação que contém a instância de function. |
--args | — | string | — | Caminho de um arquivo JSON com os novos argumentos da instância de function. |
--file | — | string | — | Caminho de um arquivo JSON com os atributos a alterar. Use - para ler o JSON da entrada padrão. |
--function-id | — | int | — | ID da function que a instância executa. |
--instance-id | — | int | — | ID da instância de function a atualizar. |
--name | — | string | — | Novo nome da instância de function. |
Uma instância de function permanece ativa. Com --active false, a API recusa a atualização e o comando falha com este erro:
Este comando renomeia a instância de function com ID 12361 para my-instance-renamed:
O comando imprime o ID da instância de function atualizada. Os argumentos e o estado ativo mantêm seus valores:
Excluir
azion delete function-instance remove uma instância de function de uma aplicação:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--application-id | — | int | — | ID da aplicação que contém a instância de function. |
--instance-id | — | int | — | ID da instância de function a excluir. |
Este comando exclui a instância de function com ID 12362:
O comando confirma a exclusão e imprime o ID como %!s(int64=12362):
Usar um arquivo JSON
azion create function-instance e azion update function-instance leem os atributos da instância de function de um arquivo JSON com --file. Dentro do arquivo, args é um objeto JSON, não um caminho.
Este arquivo cria uma instância de function ativa chamada my-other-instance a partir da function com ID 12359. O comando lê name, function, active e args dele:
Passe o arquivo para o comando de criação com o ID da aplicação:
O comando imprime o ID da instância de function:
Na atualização, passe o ID da aplicação e o ID da instância de function na linha de comando. Este arquivo altera o nome e os argumentos da instância de function com ID 12362:
Passe o arquivo para o comando de atualização:
O comando imprime o ID da instância de function atualizada:
Os campos que o arquivo deixa de fora mantêm seus valores: a instância de function acima continua ativa.