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
Atualiza uma aplicação existente do Managed Service for Apache Flink. Com essa operação, é possível atualizar o código da aplicação, a configuração de entrada e a configuração de saída.
O Managed Service for Apache Flink atualiza ApplicationVersionId
sempre que você atualiza a aplicação.
Sintaxe da Solicitação
{
"ApplicationConfigurationUpdate": {
"ApplicationCodeConfigurationUpdate": {
"CodeContentTypeUpdate": "string
",
"CodeContentUpdate": {
"S3ContentLocationUpdate": {
"BucketARNUpdate": "string
",
"FileKeyUpdate": "string
",
"ObjectVersionUpdate": "string
"
},
"TextContentUpdate": "string
",
"ZipFileContentUpdate": blob
}
},
"ApplicationSnapshotConfigurationUpdate": {
"SnapshotsEnabledUpdate": boolean
},
"ApplicationSystemRollbackConfigurationUpdate": {
"RollbackEnabledUpdate": boolean
},
"EnvironmentPropertyUpdates": {
"PropertyGroups": [
{
"PropertyGroupId": "string
",
"PropertyMap": {
"string
" : "string
"
}
}
]
},
"FlinkApplicationConfigurationUpdate": {
"CheckpointConfigurationUpdate": {
"CheckpointingEnabledUpdate": boolean
,
"CheckpointIntervalUpdate": number
,
"ConfigurationTypeUpdate": "string
",
"MinPauseBetweenCheckpointsUpdate": number
},
"MonitoringConfigurationUpdate": {
"ConfigurationTypeUpdate": "string
",
"LogLevelUpdate": "string
",
"MetricsLevelUpdate": "string
"
},
"ParallelismConfigurationUpdate": {
"AutoScalingEnabledUpdate": boolean
,
"ConfigurationTypeUpdate": "string
",
"ParallelismPerKPUUpdate": number
,
"ParallelismUpdate": number
}
},
"SqlApplicationConfigurationUpdate": {
"InputUpdates": [
{
"InputId": "string
",
"InputParallelismUpdate": {
"CountUpdate": number
},
"InputProcessingConfigurationUpdate": {
"InputLambdaProcessorUpdate": {
"ResourceARNUpdate": "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
"
},
"KinesisStreamsInputUpdate": {
"ResourceARNUpdate": "string
"
},
"NamePrefixUpdate": "string
"
}
],
"OutputUpdates": [
{
"DestinationSchemaUpdate": {
"RecordFormatType": "string
"
},
"KinesisFirehoseOutputUpdate": {
"ResourceARNUpdate": "string
"
},
"KinesisStreamsOutputUpdate": {
"ResourceARNUpdate": "string
"
},
"LambdaOutputUpdate": {
"ResourceARNUpdate": "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
"
},
"TableNameUpdate": "string
"
}
]
},
"VpcConfigurationUpdates": [
{
"SecurityGroupIdUpdates": [ "string
" ],
"SubnetIdUpdates": [ "string
" ],
"VpcConfigurationId": "string
"
}
],
"ZeppelinApplicationConfigurationUpdate": {
"CatalogConfigurationUpdate": {
"GlueDataCatalogConfigurationUpdate": {
"DatabaseARNUpdate": "string
"
}
},
"CustomArtifactsConfigurationUpdate": [
{
"ArtifactType": "string
",
"MavenReference": {
"ArtifactId": "string
",
"GroupId": "string
",
"Version": "string
"
},
"S3ContentLocation": {
"BucketARN": "string
",
"FileKey": "string
",
"ObjectVersion": "string
"
}
}
],
"DeployAsApplicationConfigurationUpdate": {
"S3ContentLocationUpdate": {
"BasePathUpdate": "string
",
"BucketARNUpdate": "string
"
}
},
"MonitoringConfigurationUpdate": {
"LogLevelUpdate": "string
"
}
}
},
"ApplicationName": "string
",
"CloudWatchLoggingOptionUpdates": [
{
"CloudWatchLoggingOptionId": "string
",
"LogStreamARNUpdate": "string
"
}
],
"ConditionalToken": "string
",
"CurrentApplicationVersionId": number
,
"RunConfigurationUpdate": {
"ApplicationRestoreConfiguration": {
"ApplicationRestoreType": "string
",
"SnapshotName": "string
"
},
"FlinkRunConfiguration": {
"AllowNonRestoredState": boolean
}
},
"RuntimeEnvironmentUpdate": "string
",
"ServiceExecutionRoleUpdate": "string
"
}
Parâmetros da solicitação
A solicitação aceita os dados a seguir no formato JSON.
- ApplicationConfigurationUpdate
-
Descreve as atualizações de configuração da aplicação.
Tipo: objeto ApplicationConfigurationUpdate
Obrigatório: Não
- ApplicationName
-
O nome do aplicativo a atualizar.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. O tamanho máximo é 128.
Padrão:
[a-zA-Z0-9_.-]+
Exigido: Sim
- CloudWatchLoggingOptionUpdates
-
Descreve as atualizações das opções de CloudWatch registro do aplicativo Amazon. Você só pode atualizar as opções de CloudWatch registro existentes com essa ação. Para adicionar uma nova opção de CloudWatch registro, useAddApplicationCloudWatchLoggingOption.
Tipo: matriz de objetos CloudWatchLoggingOptionUpdate
Obrigatório: Não
- ConditionalToken
-
Um valor que você usa para implementar uma forte simultaneidade para atualizações de aplicações. Você deve fornecer
CurrentApplicationVersionId
ouConditionalToken
. Você obtém oConditionalToken
atual da aplicação usando DescribeApplication. Para melhor suporte à simultaneidade, use o parâmetroConditionalToken
em vez deCurrentApplicationVersionId
.Tipo: string
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 512.
Padrão:
[a-zA-Z0-9-_+/=]+
Obrigatório: Não
- CurrentApplicationVersionId
-
O ID da versão de aplicação atual. Forneça o
CurrentApplicationVersionId
ouConditionalToken
o. Você pode recuperar o ID da versão da aplicação usando DescribeApplication. Para um melhor suporte à simultaneidade, use o parâmetroConditionalToken
em vez deCurrentApplicationVersionId
.Tipo: longo
Faixa válida: valor mínimo de 1. Valor máximo de 999999999.
Obrigatório: Não
- RunConfigurationUpdate
-
Descreve as atualizações nos parâmetros iniciais da aplicação.
Tipo: objeto RunConfigurationUpdate
Obrigatório: Não
- RuntimeEnvironmentUpdate
-
Atualiza o ambiente de execução do Managed Service for Apache Flink usado para executar seu código. Para evitar problemas, você deve:
-
Certifique-se de que seu novo jar e dependências sejam compatíveis com o novo tempo de execução selecionado.
-
Certifique-se de que o estado do seu novo código seja compatível com o instantâneo a partir do qual seu aplicativo será iniciado
Tipo: sequências
Valores Válidos:
SQL-1_0 | FLINK-1_6 | FLINK-1_8 | ZEPPELIN-FLINK-1_0 | FLINK-1_11 | FLINK-1_13 | ZEPPELIN-FLINK-2_0 | FLINK-1_15 | ZEPPELIN-FLINK-3_0 | FLINK-1_18 | FLINK-1_19
Obrigatório: Não
-
- ServiceExecutionRoleUpdate
-
Descreve as atualizações no perfil de execução do serviço.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.
Padrão:
arn:.*
Obrigatório: Não
Sintaxe da Resposta
{
"ApplicationDetail": {
"ApplicationARN": "string",
"ApplicationConfigurationDescription": {
"ApplicationCodeConfigurationDescription": {
"CodeContentDescription": {
"CodeMD5": "string",
"CodeSize": number,
"S3ApplicationCodeLocationDescription": {
"BucketARN": "string",
"FileKey": "string",
"ObjectVersion": "string"
},
"TextContent": "string"
},
"CodeContentType": "string"
},
"ApplicationSnapshotConfigurationDescription": {
"SnapshotsEnabled": boolean
},
"ApplicationSystemRollbackConfigurationDescription": {
"RollbackEnabled": boolean
},
"EnvironmentPropertyDescriptions": {
"PropertyGroupDescriptions": [
{
"PropertyGroupId": "string",
"PropertyMap": {
"string" : "string"
}
}
]
},
"FlinkApplicationConfigurationDescription": {
"CheckpointConfigurationDescription": {
"CheckpointingEnabled": boolean,
"CheckpointInterval": number,
"ConfigurationType": "string",
"MinPauseBetweenCheckpoints": number
},
"JobPlanDescription": "string",
"MonitoringConfigurationDescription": {
"ConfigurationType": "string",
"LogLevel": "string",
"MetricsLevel": "string"
},
"ParallelismConfigurationDescription": {
"AutoScalingEnabled": boolean,
"ConfigurationType": "string",
"CurrentParallelism": number,
"Parallelism": number,
"ParallelismPerKPU": number
}
},
"RunConfigurationDescription": {
"ApplicationRestoreConfigurationDescription": {
"ApplicationRestoreType": "string",
"SnapshotName": "string"
},
"FlinkRunConfigurationDescription": {
"AllowNonRestoredState": boolean
}
},
"SqlApplicationConfigurationDescription": {
"InputDescriptions": [
{
"InAppStreamNames": [ "string" ],
"InputId": "string",
"InputParallelism": {
"Count": number
},
"InputProcessingConfigurationDescription": {
"InputLambdaProcessorDescription": {
"ResourceARN": "string",
"RoleARN": "string"
}
},
"InputSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"InputStartingPositionConfiguration": {
"InputStartingPosition": "string"
},
"KinesisFirehoseInputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"KinesisStreamsInputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"NamePrefix": "string"
}
],
"OutputDescriptions": [
{
"DestinationSchema": {
"RecordFormatType": "string"
},
"KinesisFirehoseOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"KinesisStreamsOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"LambdaOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"Name": "string",
"OutputId": "string"
}
],
"ReferenceDataSourceDescriptions": [
{
"ReferenceId": "string",
"ReferenceSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"S3ReferenceDataSourceDescription": {
"BucketARN": "string",
"FileKey": "string",
"ReferenceRoleARN": "string"
},
"TableName": "string"
}
]
},
"VpcConfigurationDescriptions": [
{
"SecurityGroupIds": [ "string" ],
"SubnetIds": [ "string" ],
"VpcConfigurationId": "string",
"VpcId": "string"
}
],
"ZeppelinApplicationConfigurationDescription": {
"CatalogConfigurationDescription": {
"GlueDataCatalogConfigurationDescription": {
"DatabaseARN": "string"
}
},
"CustomArtifactsConfigurationDescription": [
{
"ArtifactType": "string",
"MavenReferenceDescription": {
"ArtifactId": "string",
"GroupId": "string",
"Version": "string"
},
"S3ContentLocationDescription": {
"BucketARN": "string",
"FileKey": "string",
"ObjectVersion": "string"
}
}
],
"DeployAsApplicationConfigurationDescription": {
"S3ContentLocationDescription": {
"BasePath": "string",
"BucketARN": "string"
}
},
"MonitoringConfigurationDescription": {
"LogLevel": "string"
}
}
},
"ApplicationDescription": "string",
"ApplicationMaintenanceConfigurationDescription": {
"ApplicationMaintenanceWindowEndTime": "string",
"ApplicationMaintenanceWindowStartTime": "string"
},
"ApplicationMode": "string",
"ApplicationName": "string",
"ApplicationStatus": "string",
"ApplicationVersionCreateTimestamp": number,
"ApplicationVersionId": number,
"ApplicationVersionRolledBackFrom": number,
"ApplicationVersionRolledBackTo": number,
"ApplicationVersionUpdatedFrom": number,
"CloudWatchLoggingOptionDescriptions": [
{
"CloudWatchLoggingOptionId": "string",
"LogStreamARN": "string",
"RoleARN": "string"
}
],
"ConditionalToken": "string",
"CreateTimestamp": number,
"LastUpdateTimestamp": number,
"RuntimeEnvironment": "string",
"ServiceExecutionRole": "string"
},
"OperationId": "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.
- ApplicationDetail
-
Descreve as atualizações da aplicação.
Tipo: objeto ApplicationDetail
- OperationId
-
O ID da operação que pode ser usado para rastrear a solicitação.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.
Erros
- CodeValidationException
-
O código da aplicação fornecido pelo usuário (consulta) não é válido. Isso pode ser um simples erro de sintaxe.
Código de Status HTTP: 400
- 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
- InvalidApplicationConfigurationException
-
A configuração da aplicação fornecida pelo usuário do não é válida.
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
- LimitExceededException
-
O número de recursos permitidos foi excedido.
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
-
O aplicativo especificado não pode ser encontrado.
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: