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á.
UpdateApplication
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.
Atualiza um aplicativo Amazon Kinesis Analytics existente. Usando essa API, você pode atualizar o código, a configuração de entrada e a configuração de saída do aplicativo.
Observe que o Amazon Kinesis Analytics atualiza o CurrentApplicationVersionId
cada vez que você atualiza seu aplicativo.
Essa operação exige permissão para a ação kinesisanalytics:UpdateApplication
.
Sintaxe da Solicitação
{
"ApplicationName": "string
",
"ApplicationUpdate": {
"ApplicationCodeUpdate": "string
",
"CloudWatchLoggingOptionUpdates": [
{
"CloudWatchLoggingOptionId": "string
",
"LogStreamARNUpdate": "string
",
"RoleARNUpdate": "string
"
}
],
"InputUpdates": [
{
"InputId": "string
",
"InputParallelismUpdate": {
"CountUpdate": number
},
"InputProcessingConfigurationUpdate": {
"InputLambdaProcessorUpdate": {
"ResourceARNUpdate": "string
",
"RoleARNUpdate": "string
"
}
},
"InputSchemaUpdate": {
"RecordColumnUpdates": [
{
"Mapping": "string
",
"Name": "string
",
"SqlType": "string
"
}
],
"RecordEncodingUpdate": "string
",
"RecordFormatUpdate": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string
",
"RecordRowDelimiter": "string
"
},
"JSONMappingParameters": {
"RecordRowPath": "string
"
}
},
"RecordFormatType": "string
"
}
},
"KinesisFirehoseInputUpdate": {
"ResourceARNUpdate": "string
",
"RoleARNUpdate": "string
"
},
"KinesisStreamsInputUpdate": {
"ResourceARNUpdate": "string
",
"RoleARNUpdate": "string
"
},
"NamePrefixUpdate": "string
"
}
],
"OutputUpdates": [
{
"DestinationSchemaUpdate": {
"RecordFormatType": "string
"
},
"KinesisFirehoseOutputUpdate": {
"ResourceARNUpdate": "string
",
"RoleARNUpdate": "string
"
},
"KinesisStreamsOutputUpdate": {
"ResourceARNUpdate": "string
",
"RoleARNUpdate": "string
"
},
"LambdaOutputUpdate": {
"ResourceARNUpdate": "string
",
"RoleARNUpdate": "string
"
},
"NameUpdate": "string
",
"OutputId": "string
"
}
],
"ReferenceDataSourceUpdates": [
{
"ReferenceId": "string
",
"ReferenceSchemaUpdate": {
"RecordColumns": [
{
"Mapping": "string
",
"Name": "string
",
"SqlType": "string
"
}
],
"RecordEncoding": "string
",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string
",
"RecordRowDelimiter": "string
"
},
"JSONMappingParameters": {
"RecordRowPath": "string
"
}
},
"RecordFormatType": "string
"
}
},
"S3ReferenceDataSourceUpdate": {
"BucketARNUpdate": "string
",
"FileKeyUpdate": "string
",
"ReferenceRoleARNUpdate": "string
"
},
"TableNameUpdate": "string
"
}
]
},
"CurrentApplicationVersionId": number
}
Parâmetros da solicitação
A solicitação aceita os dados a seguir no formato JSON.
- ApplicationName
-
Nome do aplicativo Amazon Kinesis Analytics a ser atualizado.
Tipo: sequência
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.
Padrão:
[a-zA-Z0-9_.-]+
Exigido: Sim
- ApplicationUpdate
-
Descreve as atualizações do aplicativo.
Tipo: objeto ApplicationUpdate
Obrigatório: Sim
- CurrentApplicationVersionId
-
ID da versão de aplicativo atual. Você pode usar a DescribeApplicationoperação para obter esse valor.
Tipo: longo
Faixa válida: valor mínimo de 1. Valor máximo de 999999999.
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
- CodeValidationException
-
O código do aplicativo fornecido pelo usuário (consulta) é inválido. Pode ser um simples erro de sintaxe.
Código de Status HTTP: 400
- 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: