翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # UpdateApplication 既存の Managed Service for Apache Flink アプリケーションを更新します。このオペレーションを使用して、アプリケーションコード、入力設定、出力設定を更新できます。 Managed Service for Apache Flink は、アプリケーションを更新するたびに `ApplicationVersionId` を更新します。 ## リクエストの構文 ``` { "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" } ``` ## リクエストパラメーター リクエストは以下のデータを JSON 形式で受け入れます。 ** [ApplicationConfigurationUpdate](#API_UpdateApplication_RequestSyntax) ** アプリケーションの設定の更新を記述します。 型: [ApplicationConfigurationUpdate](API_ApplicationConfigurationUpdate.md) オブジェクト 必須: いいえ ** [ApplicationName](#API_UpdateApplication_RequestSyntax) ** 更新するアプリケーションの名前。 タイプ: 文字列 長さの制限: 最小長は 1 です。最大長は 128 です。 パターン: `[a-zA-Z0-9_.-]+` 必須: はい ** [CloudWatchLoggingOptionUpdates](#API_UpdateApplication_RequestSyntax) ** アプリケーションの Amazon CloudWatch ログ記録オプションの更新を記述します。このアクションで更新できるのは、既存の CloudWatch ログ記録オプションのみです。新しい CloudWatch ログ記録オプションを追加するには、[AddApplicationCloudWatchLoggingOption](API_AddApplicationCloudWatchLoggingOption.md) を使用します。 タイプ: [CloudWatchLoggingOptionUpdate](API_CloudWatchLoggingOptionUpdate.md) オブジェクトの配列 必須: いいえ ** [ConditionalToken](#API_UpdateApplication_RequestSyntax) ** アプリケーション更新の強力な同時実行性を実装するために使用する値。`CurrentApplicationVersionId` または `ConditionalToken` を指定する必要があります。[DescribeApplication](API_DescribeApplication.md) を使用するとアプリケーションの現在の `ConditionalToken` がわかります。同時実行性のサポートを強化するには、`CurrentApplicationVersionId` の代わりに `ConditionalToken` パラメータを使用します。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 512 です。 パターン: `[a-zA-Z0-9-_+/=]+` 必須: いいえ ** [CurrentApplicationVersionId](#API_UpdateApplication_RequestSyntax) ** 現在のアプリケーションバージョン ID。`CurrentApplicationVersionId` または `ConditionalToken` を指定する必要があります。アプリケーションのバージョン ID は [DescribeApplication](API_DescribeApplication.md) を使用して取得できます。同時実行性のサポートを強化するには、`CurrentApplicationVersionId` の代わりに `ConditionalToken` パラメータを使用します。 タイプ: Long 有効範囲: 最小値は 1 です。最大値は 999999999 です。 必須: いいえ ** [RunConfigurationUpdate](#API_UpdateApplication_RequestSyntax) ** アプリケーションの開始パラメータの更新を記述します。 型: [RunConfigurationUpdate](API_RunConfigurationUpdate.md) オブジェクト 必須: いいえ ** [RuntimeEnvironmentUpdate](#API_UpdateApplication_RequestSyntax) ** コードの実行に使用される Managed Service for Apache Flink ランタイム環境を更新します。問題を回避するには、以下を行う必要があります。 + 新しい jar と依存関係が、選択した新しいランタイムと互換性があることを確認します。 + 新しいコードの状態が、アプリケーションが起動するスナップショットと互換性があることを確認します。 型: 文字列 有効な値：`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` 必須：いいえ ** [ServiceExecutionRoleUpdate](#API_UpdateApplication_RequestSyntax) ** サービス実行ロールの更新を記述します。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 2,048 です。 パターン: `arn:.*` 必須: いいえ ## レスポンスの構文 ``` { "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" } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [ApplicationDetail](#API_UpdateApplication_ResponseSyntax) ** アプリケーションの更新を記述します。 型: [ApplicationDetail](API_ApplicationDetail.md) オブジェクト ** [OperationId](#API_UpdateApplication_ResponseSyntax) ** リクエストの追跡に使用できるオペレーション ID。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長 64 ## エラー ** CodeValidationException ** ユーザー指定のアプリケーションコード (クエリ) が無効です。これは単純な構文エラーである可能性があります。 HTTP ステータスコード: 400 ** ConcurrentModificationException ** アプリケーションへの同時変更の結果としてスローされる例外。このエラーは、現在のアプリケーション ID を使用せずにアプリケーションを変更しようとしたことが原因である可能性があります。 HTTP ステータスコード: 400 ** InvalidApplicationConfigurationException ** ユーザー指定のアプリケーション設定が無効です。 HTTP ステータスコード: 400 ** InvalidArgumentException ** 指定された入力パラメータ値が無効です。 HTTP ステータスコード: 400 ** InvalidRequestException ** 要求された JSON はオペレーションに対して無効です。 HTTP ステータスコード: 400 ** LimitExceededException ** 許可されているリソースの数を超過しました。 HTTP ステータスコード: 400 ** ResourceInUseException ** このオペレーションではアプリケーションを使用できません。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたアプリケーションが見つかりません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalyticsv2-2018-05-23/UpdateApplication) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/UpdateApplication) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/UpdateApplication) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/UpdateApplication) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/UpdateApplication) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/UpdateApplication) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/UpdateApplication) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/UpdateApplication) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/UpdateApplication) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/UpdateApplication)