翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # CreateApplication Managed Service for Apache Flink アプリケーションを作成します。Managed Service for Apache Flink アプリケーションを作成する方法については、「[アプリケーションを作成する](https://docs.aws.amazon.com/kinesisanalytics/latest/java/getting-started.html)」を参照してください。 ## リクエストの構文 ``` { "ApplicationConfiguration": { "ApplicationCodeConfiguration": { "CodeContent": { "S3ContentLocation": { "BucketARN": "string", "FileKey": "string", "ObjectVersion": "string" }, "TextContent": "string", "ZipFileContent": blob }, "CodeContentType": "string" }, "ApplicationEncryptionConfiguration": { "KeyId": "string", "KeyType": "string" }, "ApplicationSnapshotConfiguration": { "SnapshotsEnabled": boolean }, "ApplicationSystemRollbackConfiguration": { "RollbackEnabled": boolean }, "EnvironmentProperties": { "PropertyGroups": [ { "PropertyGroupId": "string", "PropertyMap": { "string" : "string" } } ] }, "FlinkApplicationConfiguration": { "CheckpointConfiguration": { "CheckpointingEnabled": boolean, "CheckpointInterval": number, "ConfigurationType": "string", "MinPauseBetweenCheckpoints": number }, "MonitoringConfiguration": { "ConfigurationType": "string", "LogLevel": "string", "MetricsLevel": "string" }, "ParallelismConfiguration": { "AutoScalingEnabled": boolean, "ConfigurationType": "string", "Parallelism": number, "ParallelismPerKPU": number } }, "SqlApplicationConfiguration": { "Inputs": [ { "InputParallelism": { "Count": number }, "InputProcessingConfiguration": { "InputLambdaProcessor": { "ResourceARN": "string" } }, "InputSchema": { "RecordColumns": [ { "Mapping": "string", "Name": "string", "SqlType": "string" } ], "RecordEncoding": "string", "RecordFormat": { "MappingParameters": { "CSVMappingParameters": { "RecordColumnDelimiter": "string", "RecordRowDelimiter": "string" }, "JSONMappingParameters": { "RecordRowPath": "string" } }, "RecordFormatType": "string" } }, "KinesisFirehoseInput": { "ResourceARN": "string" }, "KinesisStreamsInput": { "ResourceARN": "string" }, "NamePrefix": "string" } ], "Outputs": [ { "DestinationSchema": { "RecordFormatType": "string" }, "KinesisFirehoseOutput": { "ResourceARN": "string" }, "KinesisStreamsOutput": { "ResourceARN": "string" }, "LambdaOutput": { "ResourceARN": "string" }, "Name": "string" } ], "ReferenceDataSources": [ { "ReferenceSchema": { "RecordColumns": [ { "Mapping": "string", "Name": "string", "SqlType": "string" } ], "RecordEncoding": "string", "RecordFormat": { "MappingParameters": { "CSVMappingParameters": { "RecordColumnDelimiter": "string", "RecordRowDelimiter": "string" }, "JSONMappingParameters": { "RecordRowPath": "string" } }, "RecordFormatType": "string" } }, "S3ReferenceDataSource": { "BucketARN": "string", "FileKey": "string" }, "TableName": "string" } ] }, "VpcConfigurations": [ { "SecurityGroupIds": [ "string" ], "SubnetIds": [ "string" ] } ], "ZeppelinApplicationConfiguration": { "CatalogConfiguration": { "GlueDataCatalogConfiguration": { "DatabaseARN": "string" } }, "CustomArtifactsConfiguration": [ { "ArtifactType": "string", "MavenReference": { "ArtifactId": "string", "GroupId": "string", "Version": "string" }, "S3ContentLocation": { "BucketARN": "string", "FileKey": "string", "ObjectVersion": "string" } } ], "DeployAsApplicationConfiguration": { "S3ContentLocation": { "BasePath": "string", "BucketARN": "string" } }, "MonitoringConfiguration": { "LogLevel": "string" } } }, "ApplicationDescription": "string", "ApplicationMode": "string", "ApplicationName": "string", "CloudWatchLoggingOptions": [ { "LogStreamARN": "string" } ], "RuntimeEnvironment": "string", "ServiceExecutionRole": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## リクエストパラメーター リクエストは以下のデータを JSON 形式で受け入れます。 ** [ApplicationConfiguration](#API_CreateApplication_RequestSyntax) ** このパラメータを使用して、アプリケーションを設定します。 型: [ApplicationConfiguration](API_ApplicationConfiguration.md) オブジェクト 必須: いいえ ** [ApplicationDescription](#API_CreateApplication_RequestSyntax) ** アプリケーションの簡単な説明。 タイプ: 文字列 長さの制約: 最小長は 0 です。最大長は 1,024 です。 必須: いいえ ** [ApplicationMode](#API_CreateApplication_RequestSyntax) ** `STREAMING` モードを使用して、Managed Service for Apache Flink アプリケーションを作成します。Managed Service for Apache Flink Studio ノートブックを作成するには、`INTERACTIVE` モードを使用します。 型: 文字列 有効な値：`STREAMING | INTERACTIVE` 必須：いいえ ** [ApplicationName](#API_CreateApplication_RequestSyntax) ** アプリケーションの名前 (`sample-app` など)。 タイプ: 文字列 長さの制限: 最小長は 1 です。最大長は 128 です。 パターン: `[a-zA-Z0-9_.-]+` 必須: はい ** [CloudWatchLoggingOptions](#API_CreateApplication_RequestSyntax) ** このパラメータでは、Amazon CloudWatch ログストリームを設定してアプリケーションの設定エラーをモニタリングします。 タイプ: [CloudWatchLoggingOption](API_CloudWatchLoggingOption.md) オブジェクトの配列 必須: いいえ ** [RuntimeEnvironment](#API_CreateApplication_RequestSyntax) ** アプリケーションのランタイム環境。 型: 文字列 有効な値：`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` 必須: はい ** [ServiceExecutionRole](#API_CreateApplication_RequestSyntax) ** Kinesis データストリーム、Kinesis Data Firehose 配信ストリーム、Amazon S3 オブジェクト、その他の外部リソースにアクセスするためにアプリケーションが使用する IAM ロール。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 2,048 です。 パターン: `arn:.*` 必須: はい ** [Tags](#API_CreateApplication_RequestSyntax) ** アプリケーションに割り当てる 1 つ以上のタグのリスト。タグは、アプリケーションを識別するキーと値のペアです。アプリケーションタグの最大数にはシステムタグが含まれることに注意してください。ユーザー定義のアプリケーションタグの最大数は 50 です。詳細については、「[タグ付けの使用](https://docs.aws.amazon.com/kinesisanalytics/latest/java/how-tagging.html)」を参照してください。 型: [Tag](API_Tag.md) オブジェクトの配列 配列メンバー: 最小数は 1 項目です。最大数は 200 項目です。 必須: いいえ ## レスポンスの構文 ``` { "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" } } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [ApplicationDetail](#API_CreateApplication_ResponseSyntax) ** `CreateApplication` リクエストに応じて、Managed Service for Apache Flink から、作成したアプリケーションの詳細を含むレスポンスが返されます。 型: [ApplicationDetail](API_ApplicationDetail.md) オブジェクト ## エラー ** CodeValidationException ** ユーザー指定のアプリケーションコード (クエリ) が無効です。これは単純な構文エラーである可能性があります。 HTTP ステータスコード: 400 ** ConcurrentModificationException ** アプリケーションへの同時変更の結果としてスローされる例外。このエラーは、現在のアプリケーション ID を使用せずにアプリケーションを変更しようとしたことが原因である可能性があります。 HTTP ステータスコード: 400 ** InvalidArgumentException ** 指定された入力パラメータ値が無効です。 HTTP ステータスコード: 400 ** InvalidRequestException ** 要求された JSON はオペレーションに対して無効です。 HTTP ステータスコード: 400 ** LimitExceededException ** 許可されているリソースの数を超過しました。 HTTP ステータスコード: 400 ** ResourceInUseException ** このオペレーションではアプリケーションを使用できません。 HTTP ステータスコード: 400 ** TooManyTagsException ** 多すぎるタグを使用してアプリケーションが作成されたか、またはアプリケーションに追加されたタグが多すぎます。アプリケーションタグの最大数にはシステムタグが含まれることに注意してください。ユーザー定義のアプリケーションタグの最大数は 50 です。 HTTP ステータスコード: 400 ** UnsupportedOperationException ** 指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalyticsv2-2018-05-23/CreateApplication) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/CreateApplication) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/CreateApplication) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/CreateApplication) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/CreateApplication) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/CreateApplication) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/CreateApplication) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/CreateApplication) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/CreateApplication) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/CreateApplication)