AddApplicationOutput - Amazon Managed Service for Apache Flink (anteriormente Amazon Kinesis Data Analytics for Apache Flink)

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

Adiciona um destino externo ao seu aplicativo Kinesis Data Analytics baseado em SQL.

Se você quiser que o Kinesis Data Analytics entregue dados de um fluxo dentro do aplicativo em um aplicativo para um destino externo (como um fluxo de dados do Kinesis, um fluxo de entrega do Kinesis Data Firehose ou uma função do Amazon Lambda), adicione a configuração relevante ao aplicativo usando esta 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.

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 operação DescribeApplication para localizar a versão atual do aplicativo.

Sintaxe da Solicitação

{ "ApplicationName": "string", "CurrentApplicationVersionId": number, "Output": { "DestinationSchema": { "RecordFormatType": "string" }, "KinesisFirehoseOutput": { "ResourceARN": "string" }, "KinesisStreamsOutput": { "ResourceARN": "string" }, "LambdaOutput": { "ResourceARN": "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: string

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

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

Exigido: Sim

CurrentApplicationVersionId

A versão da aplicação à qual você deseja adicionar a configuração de saída. Você pode usar a operação DescribeApplication para obter a versão atual da aplicação. 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 da saída, você especifica o nome de um fluxo na aplicação, um destino (ou seja, um fluxo de dados do Kinesis, um fluxo de entrega do Kinesis Data Firehose ou uma função do Amazon Lambda) e registra a formação a ser usada ao gravar no destino.

Tipo: objeto Output

Exigido: Sim

Sintaxe da Resposta

{ "ApplicationARN": "string", "ApplicationVersionId": number, "OutputDescriptions": [ { "DestinationSchema": { "RecordFormatType": "string" }, "KinesisFirehoseOutputDescription": { "ResourceARN": "string", "RoleARN": "string" }, "KinesisStreamsOutputDescription": { "ResourceARN": "string", "RoleARN": "string" }, "LambdaOutputDescription": { "ResourceARN": "string", "RoleARN": "string" }, "Name": "string", "OutputId": "string" } ] }

Elementos de Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

ApplicationARN

O nome de recurso da Amazon (ARN) do aplicativo do .

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.

Padrão: arn:.*

ApplicationVersionId

O ID da versão atualizada da aplicação. O Kinesis Data Analytics incrementa essa ID quando o aplicativo é atualizado.

Tipo: longo

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

OutputDescriptions

Descreve a configuração de saída da aplicação. Para obter mais informações, consulte Configuração da saída do aplicativo.

Tipo: matriz de objetos OutputDescription

Erros

ConcurrentModificationException

Exceção lançada como resultado de modificações simultâneas em uma aplicação. Esse erro pode ser o resultado da tentativa de modificar uma aplicação sem usar o ID da aplicação atual.

Código de Status HTTP: 400

InvalidArgumentException

O valor do parâmetro de entrada especificado não é válido.

Código de Status HTTP: 400

InvalidRequestException

A solicitação de JSON não é válida para a operação.

Código de Status HTTP: 400

ResourceInUseException

A aplicação 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

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: