Edite, pare ou exclua um stream

Altere as configurações de um stream do Data Stream, pare e reinicie o stream ou exclua-o, no Azion Console ou com a Azion API.

Última atualização

Ver como Markdown Configurar agente

Você pode editar, parar ou excluir um stream do Data Stream no Azion Console ou com a Azion API. Para criar um stream, consulte Primeiros passos do Data Stream.

Um stream parado mantém as configurações e não envia nada até você iniciá-lo de novo. Um stream excluído deixa de existir, junto com as configurações. Para ver todos os campos que você pode alterar, consulte Configurações do stream.

Selecione a interface uma vez. Os pré-requisitos e todas as tarefas abaixo mostram só esse caminho.

Pré-requisitos

  • Um stream na sua conta Azion. Para criar um, consulte Primeiros passos do Data Stream.
  • A permissão Edit Data Stream. Só com View Data Stream, você vê os streams, mas não pode editá-los, pará-los nem excluí-los. Para mais informações, consulte Configurações do stream.
  • Acesso ao Azion Console. Para entrar, consulte Acessar Azion Console.
  • Uma conta com menos de 3.000 workloads. A partir de 3.000 workloads, o Console bloqueia os formulários de stream, e você gerencia os streams só pela API.
  • Um personal token. Para criar um, consulte Criar um personal token.
  • curl.
  • O ID do stream. A resposta de listagem de GET /v4/workspace/stream/streams traz o ID no campo id de cada stream. No Azion Console, ele é o número no final da URL da página de edição do stream, /data-stream/edit/<stream-id>.

Edite um stream

Uma edição mantém o ID do stream e altera só as configurações que você salva. Salvar verifica o formato dos campos, não o endpoint, então uma credencial errada aparece depois como envios com falha.

Para editar um stream com a API, envie uma requisição PATCH só com as chaves que você altera. Este exemplo renomeia o stream. Substitua <stream-id> pelo ID do seu stream:

Shell
01curl -X PATCH 'https://api.azion.com/v4/workspace/stream/streams/<stream-id>' \
02 -H 'Content-Type: application/json' \
03 -H 'Authorization: Token [TOKEN VALUE]' \
04 -d '{"name": "activity-to-bucket"}'

A API responde 200 com o stream armazenado:

JSON
01{
02 "state": "executed",
03 "data": {
04 "id": 12345,
05 "name": "activity-to-bucket",
06 "last_editor": "user@example.com",
07 "created": "2026-01-01T11:30:47.000000Z",
08 "last_modified": "2026-01-01T11:30:59.000000Z",
09 "product_version": "1.0",
10 "active": true,
11 "inputs": [{ "type": "raw_logs", "attributes": { "data_source": "activity_history" } }],
12 "transform": [
13 { "type": "sampling", "attributes": { "rate": 100 } },
14 { "type": "render_template", "attributes": { "template": 251 } }
15 ],
16 "outputs": […]
17 }
18}

O name é o que você enviou, e last_modified avança. A fonte de dados, os transforms e o endpoint continuam como estavam. Para substituir o stream inteiro, envie uma requisição PUT com as chaves que uma criação exige: name, inputs, transform e outputs. Para o corpo de cada chave, consulte Configurações do stream.

Para editar um stream no Azion Console:

Abra o Data Stream

Acesse Azion Console > Data Stream.

Abra o stream

Na lista, selecione a linha do stream. A página de edição abre com o nome do stream como título.

Um stream sem sampling abre com Filter Workloads selecionado em Option, porque o formulário lê a opção a partir dos transforms do stream.

Altere as configurações

Na seção General, Input, Transform, Render Template, Output ou Status, altere os campos necessários. A seção Output chama o campo do endpoint de Connector.

Em uma edição, o Console não exige a Secret Key do S3. Para AWS Kinesis Data Firehose, informe a Secret Key de novo a cada vez que salvar.

Selecione Save
Confirme o aviso de sampling

Se Sampling estiver ligado, a caixa de diálogo Attention abre com After activating and saving these settings, all other Data Streams will be disabled. Selecione Confirm.

O Console mostra Your data stream has been updated.

As edições levam alguns minutos para se propagar. Salvar um stream ativo que usa sampling desativa todos os outros streams da conta. Depois de alterar o endpoint, verifique os próximos envios no Real-Time Events: cada envio é registrado com o status code que o endpoint retornou.

Pare um stream

Um stream parado mantém as configurações, então você pode iniciá-lo de novo sem configurá-lo.

Para parar um stream com a API, envie uma requisição PATCH que define active como false:

Shell
01curl -X PATCH 'https://api.azion.com/v4/workspace/stream/streams/<stream-id>' \
02 -H 'Content-Type: application/json' \
03 -H 'Authorization: Token [TOKEN VALUE]' \
04 -d '{"active": false}'

A API responde 200 com o stream armazenado:

JSON
01{
02 "state": "executed",
03 "data": {
04 "id": 12345,
05 "name": "activity-to-bucket",
06 …
07 "last_modified": "2026-01-01T12:03:37.000000Z",
08 "product_version": "1.0",
09 "active": false,
10 …
11 }
12}

O stream mostra "active": false, e as outras configurações não mudam. Para iniciar o stream de novo, envie a mesma requisição com {"active": true}.

Para parar um stream no Azion Console:

Abra o Data Stream

Acesse Azion Console > Data Stream.

A coluna Status mostra cada stream como Active ou Inactive.

Abra o stream

Na lista, selecione a linha do stream.

Desligue Active

Na seção Status, desligue Active.

Selecione Save
Confirme o aviso de sampling

Se a caixa de diálogo Attention abrir, selecione Confirm.

O Console mostra Your data stream has been updated, e a lista mostra o stream como Inactive. Para iniciar o stream de novo, ligue Active e selecione Save.

Uma mudança no estado ativo entra em vigor depois de um a dois minutos. Durante esse intervalo, o stream pode continuar enviando. Depois dele, o Real-Time Events não registra mais nenhum envio do stream parado para o endpoint.

Exclua um stream

Excluir um stream remove o stream e as configurações dele. Um stream excluído não pode ser restaurado: o Console avisa Once confirmed, this action can't be reversed. Para pausar um stream e manter as configurações, pare o stream em vez disso.

Para excluir um stream com a API, envie uma requisição DELETE:

Shell
01curl -X DELETE 'https://api.azion.com/v4/workspace/stream/streams/<stream-id>' \
02 -H 'Authorization: Token [TOKEN VALUE]'

A API responde 200:

{"state":"executed"}

O valor "state": "executed" confirma que a API excluiu o stream.

Para excluir um stream no Azion Console:

Abra o Data Stream

Acesse Azion Console > Data Stream.

Selecione Delete

Na linha do stream, selecione Delete, o ícone de lixeira. A caixa de diálogo Delete stream abre.

Digite o nome do stream

Na caixa, digite o nome do stream exatamente como a caixa de diálogo o mostra.

Selecione Delete

O Console mostra Data Stream successfully deleted.

Próximos passos

Configurações do streamConsulte todos os campos que você pode alterar, com valores, padrões e erros.Primeiros passos do Data StreamCrie um stream e confirme que os primeiros logs chegam ao endpoint.Solucionar problemas de Data StreamCorrija um stream que para de enviar ou um endpoint que rejeita os logs.