

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
<a name="API_UpdateApplication"></a>

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
<a name="API_UpdateApplication_RequestSyntax"></a>

```
{
   "ApplicationConfigurationUpdate": { 
      "ApplicationCodeConfigurationUpdate": { 
         "CodeContentTypeUpdate": "string",
         "CodeContentUpdate": { 
            "S3ContentLocationUpdate": { 
               "BucketARNUpdate": "string",
               "FileKeyUpdate": "string",
               "ObjectVersionUpdate": "string"
            },
            "TextContentUpdate": "string",
            "ZipFileContentUpdate": blob
         }
      },
      "ApplicationEncryptionConfigurationUpdate": { 
         "KeyIdUpdate": "string",
         "KeyTypeUpdate": "string"
      },
      "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 name="API_UpdateApplication_RequestParameters"></a>

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

 ** [ApplicationConfigurationUpdate](#API_UpdateApplication_RequestSyntax) **   <a name="APIReference-UpdateApplication-request-ApplicationConfigurationUpdate"></a>
Descreve as atualizações de configuração da aplicação.  
Tipo: objeto [ApplicationConfigurationUpdate](API_ApplicationConfigurationUpdate.md)  
Obrigatório: não

 ** [ApplicationName](#API_UpdateApplication_RequestSyntax) **   <a name="APIReference-UpdateApplication-request-ApplicationName"></a>
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_.-]+`   
Obrigatório: Sim

 ** [CloudWatchLoggingOptionUpdates](#API_UpdateApplication_RequestSyntax) **   <a name="APIReference-UpdateApplication-request-CloudWatchLoggingOptionUpdates"></a>
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, use[AddApplicationCloudWatchLoggingOption](API_AddApplicationCloudWatchLoggingOption.md).  
Tipo: matriz de objetos [CloudWatchLoggingOptionUpdate](API_CloudWatchLoggingOptionUpdate.md)  
Obrigatório: não

 ** [ConditionalToken](#API_UpdateApplication_RequestSyntax) **   <a name="APIReference-UpdateApplication-request-ConditionalToken"></a>
Um valor que você usa para implementar uma forte simultaneidade para atualizações de aplicações. Você deve fornecer `CurrentApplicationVersionId` ou `ConditionalToken`. Você obtém o `ConditionalToken` atual da aplicação usando [DescribeApplication](API_DescribeApplication.md). Para melhor suporte à simultaneidade, use o parâmetro `ConditionalToken` em vez de `CurrentApplicationVersionId`.  
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](#API_UpdateApplication_RequestSyntax) **   <a name="APIReference-UpdateApplication-request-CurrentApplicationVersionId"></a>
O ID da versão de aplicação atual. Forneça o `CurrentApplicationVersionId` ou `ConditionalToken` o. Você pode recuperar o ID da versão da aplicação usando [DescribeApplication](API_DescribeApplication.md). Para um melhor suporte à simultaneidade, use o parâmetro `ConditionalToken` em vez de `CurrentApplicationVersionId`.  
Tipo: longo  
Faixa válida: valor mínimo de 1. Valor máximo de 999999999.  
Obrigatório: não

 ** [RunConfigurationUpdate](#API_UpdateApplication_RequestSyntax) **   <a name="APIReference-UpdateApplication-request-RunConfigurationUpdate"></a>
Descreve as atualizações nos parâmetros iniciais da aplicação.  
Tipo: objeto [RunConfigurationUpdate](API_RunConfigurationUpdate.md)  
Obrigatório: não

 ** [RuntimeEnvironmentUpdate](#API_UpdateApplication_RequestSyntax) **   <a name="APIReference-UpdateApplication-request-RuntimeEnvironmentUpdate"></a>
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: string  
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 | FLINK-1_20`   
Obrigatório: não

 ** [ServiceExecutionRoleUpdate](#API_UpdateApplication_RequestSyntax) **   <a name="APIReference-UpdateApplication-request-ServiceExecutionRoleUpdate"></a>
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
<a name="API_UpdateApplication_ResponseSyntax"></a>

```
{
   "ApplicationDetail": { 
      "ApplicationARN": "string",
      "ApplicationConfigurationDescription": { 
         "ApplicationCodeConfigurationDescription": { 
            "CodeContentDescription": { 
               "CodeMD5": "string",
               "CodeSize": number,
               "S3ApplicationCodeLocationDescription": { 
                  "BucketARN": "string",
                  "FileKey": "string",
                  "ObjectVersion": "string"
               },
               "TextContent": "string"
            },
            "CodeContentType": "string"
         },
         "ApplicationEncryptionConfigurationDescription": { 
            "KeyId": "string",
            "KeyType": "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
<a name="API_UpdateApplication_ResponseElements"></a>

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](#API_UpdateApplication_ResponseSyntax) **   <a name="APIReference-UpdateApplication-response-ApplicationDetail"></a>
Descreve as atualizações da aplicação.  
Tipo: objeto [ApplicationDetail](API_ApplicationDetail.md)

 ** [OperationId](#API_UpdateApplication_ResponseSyntax) **   <a name="APIReference-UpdateApplication-response-OperationId"></a>
O ID da operação que pode ser usado para rastrear a solicitação.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.

## Erros
<a name="API_UpdateApplication_Errors"></a>

 ** 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
<a name="API_UpdateApplication_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalyticsv2-2018-05-23/UpdateApplication) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/UpdateApplication) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/UpdateApplication) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/UpdateApplication) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/UpdateApplication) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/UpdateApplication) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/UpdateApplication) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/UpdateApplication) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/UpdateApplication) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/UpdateApplication) 