StartApplication - Guia do desenvolvedor do Amazon Kinesis Data Analytics SQL para aplicativos

Para novos projetos, recomendamos que você use o novo Managed Service para Apache Flink Studio em vez do Kinesis Data Analytics for Applications. SQL O Managed Service for Apache Flink Studio combina facilidade de uso com recursos analíticos avançados, permitindo que você crie aplicativos sofisticados de processamento de stream em minutos.

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á.

StartApplication

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.

Inicia o aplicativo Amazon Kinesis Analytics especificado. Depois de criar um aplicativo, você deve designar exclusivamente essa operação para iniciar seu aplicativo.

Depois que o aplicativo é iniciado, ele começa a consumir os dados de entrada, os processa e grava a saída no destino configurado.

O status da inscrição deve ser READY para você iniciar uma inscrição. Você pode obter o status do aplicativo no console ou usando a DescribeApplicationoperação.

Depois de iniciar o aplicativo, você pode impedir que o aplicativo processe a entrada chamando a StopApplicationoperação.

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

Sintaxe da Solicitação

{ "ApplicationName": "string", "InputConfigurations": [ { "Id": "string", "InputStartingPositionConfiguration": { "InputStartingPosition": "string" } } ] }

Parâmetros da solicitação

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

ApplicationName

Nome do aplicativo.

Tipo: sequência

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

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

Exigido: Sim

InputConfigurations

Identifica a entrada específica, por ID, que o aplicativo começa a consumir. O Amazon Kinesis Analytics começa a ler a origem de streaming associada à entrada. Também é possível especificar onde na origem de streaming você deseja que o Amazon Kinesis Analytics comece a ler.

Tipo: matriz de objetos InputConfiguration

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

InvalidApplicationConfigurationException

A configuração do aplicativo fornecida pelo usuário não é válida.

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: