AddApplicationOutput - Guia do desenvolvedor do Amazon Kinesis Data Analytics SQL para aplicativos
Sintaxe da SolicitaçãoParâmetros da solicitaçãoElementos de RespostaErrosConsulte também

Após uma análise cuidadosa, decidimos descontinuar o Amazon Kinesis Data Analytics SQL para aplicativos em duas etapas:

1. A partir de 15 de outubro de 2025, você não poderá criar um novo Kinesis Data Analytics SQL para aplicativos.

2. Excluiremos seus aplicativos a partir de 27 de janeiro de 2026. Você não poderá iniciar ou operar seu Amazon Kinesis Data Analytics SQL para aplicativos. O suporte não estará mais disponível para o Amazon Kinesis Data Analytics SQL a partir desse momento. Para obter mais informações, consulte Descontinuação do Amazon Kinesis Data Analytics SQL para aplicativos.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

AddApplicationOutput

nota

Esta documentação é para a versão 1 da API do Amazon Kinesis Data Analytics, que oferece suporte somente a aplicativos SQL. A versão 2 da API oferece suporte a aplicativos Java e SQL. Para obter mais informações sobre a versão 2, consulte Documentação da API V2 do Amazon Kinesis Data Analytics.

Adiciona um destino externo ao aplicativo do Amazon Kinesis Analytics.

Se você quiser que o Amazon Kinesis Analytics entregue dados de um stream no aplicativo para um destino externo (como um stream do Amazon Kinesis, um stream do Amazon Kinesis Firehose ou uma função AWS Lambda), adicione a configuração relevante ao seu aplicativo usando essa operação. Você pode configurar uma ou mais saídas para seu aplicativo. Cada configuração de saída mapeia um stream no aplicativo e um destino externo.

É possível usar uma das configurações de saída para entregar dados de um stream de erros no aplicativo para um destino externo para que você possa analisar os erros. Para obter mais informações, consulte Compreensão da saída do aplicativo (destino).

Qualquer atualização da configuração, incluindo a adição de uma origem de streaming usando essa operação, resulta em uma nova versão do aplicativo. Você pode usar a DescribeApplicationoperação para encontrar a versão atual do aplicativo.

Para obter os limites do número de entradas e saídas do aplicativo que você pode configurar, consulte Limites.

Essa operação exige permissões para executar a ação kinesisanalytics:AddApplicationOutput.

Sintaxe da Solicitação

{
   "ApplicationName": "string",
   "CurrentApplicationVersionId": number,
   "Output": { 
      "DestinationSchema": { 
         "RecordFormatType": "string"
      },
      "KinesisFirehoseOutput": { 
         "ResourceARN": "string",
         "RoleARN": "string"
      },
      "KinesisStreamsOutput": { 
         "ResourceARN": "string",
         "RoleARN": "string"
      },
      "LambdaOutput": { 
         "ResourceARN": "string",
         "RoleARN": "string"
      },
      "Name": "string"
   }
}

Parâmetros da solicitação

A solicitação aceita os dados a seguir no formato JSON.

ApplicationName

O nome do aplicativo ao qual você deseja adicionar a configuração de saída.

Tipo: sequência

Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.

Padrão: [a-zA-Z0-9_.-]+

Exigido: Sim

CurrentApplicationVersionId

Versão do aplicativo ao qual você deseja adicionar a configuração de saída. Você pode usar a DescribeApplicationoperação para obter a versão atual do aplicativo. Se a versão especificada não for a versão atual, ConcurrentModificationException será retornado.

Tipo: longo

Faixa válida: valor mínimo de 1. Valor máximo de 999999999.

Obrigatório: Sim

Output

Uma matriz de objetos, cada qual descrevendo uma configuração de saída. Na configuração de saída, você especifica o nome de um stream no aplicativo, um destino (ou seja, um stream do Amazon Kinesis, um stream de entrega do Amazon Kinesis Firehose ou AWS uma função Lambda) e registra a formação a ser usada ao gravar no destino.

Tipo: objeto Output

Obrigatório: Sim

Elementos de Resposta

Se a ação tiver êxito, o serviço enviará de volta uma resposta HTTP 200 com um corpo HTTP vazio.

Erros

ConcurrentModificationException

Exceção lançada como resultado da modificação simultânea em um aplicativo. Por exemplo, duas pessoas tentando editar o mesmo aplicativo ao mesmo tempo.

Código de Status HTTP: 400

InvalidArgumentException

O valor do parâmetro de entrada especificado é inválido.

Código de Status HTTP: 400

ResourceInUseException

O aplicativo não está disponível para esta operação.

Código de Status HTTP: 400

ResourceNotFoundException

A aplicação especificada não pode ser encontrada.

Código de Status HTTP: 400

UnsupportedOperationException

A solicitação foi rejeitada porque um parâmetro especificado não é compatível ou um recurso especificado não é válido para esta operação.

Código de Status HTTP: 400

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte: