CreateApplication - Amazon Managed Service für Apache Flink (früher Amazon Kinesis Data Analytics für Apache Flink)
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

CreateApplication

Erstellt einen Managed Service für die Apache Flink-Anwendung. Informationen zum Erstellen eines Managed Service für die Apache Flink-Anwendung finden Sie unter Anwendung erstellen.

Anforderungssyntax

{
   "ApplicationConfiguration": { 
      "ApplicationCodeConfiguration": { 
         "CodeContent": { 
            "S3ContentLocation": { 
               "BucketARN": "string",
               "FileKey": "string",
               "ObjectVersion": "string"
            },
            "TextContent": "string",
            "ZipFileContent": blob
         },
         "CodeContentType": "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"
      }
   ]
}

Anforderungsparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

ApplicationConfiguration

Verwenden Sie diesen Parameter zum Konfigurieren der Anwendung.

Typ: ApplicationConfiguration Objekt

Erforderlich: Nein

ApplicationDescription

Eine zusammenfassende Beschreibung der Anwendung.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 1024 Zeichen.

Erforderlich: Nein

ApplicationMode

Verwenden Sie den STREAMING Modus, um eine Managed Service für Apache Flink-Anwendung zu erstellen. Verwenden Sie den Modus, um einen Managed Service für ein Apache Flink Studio-Notebook zu erstellen. INTERACTIVE

Typ: Zeichenfolge

Zulässige Werte: STREAMING | INTERACTIVE

Erforderlich: Nein

ApplicationName

Der Name Ihrer Anwendung (z. B.sample-app).

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.

Pattern: [a-zA-Z0-9_.-]+

Erforderlich: Ja

CloudWatchLoggingOptions

Verwenden Sie diesen Parameter, um einen CloudWatch Amazon-Protokollstream zur Überwachung von Anwendungskonfigurationsfehlern zu konfigurieren.

Typ: Array von CloudWatchLoggingOption-Objekten

Erforderlich: Nein

RuntimeEnvironment

Die Laufzeitumgebung für die Anwendung.

Typ: Zeichenfolge

Zulässige Werte: 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

Erforderlich: Ja

ServiceExecutionRole

Die IAM-Rolle, die von der Anwendung für den Zugriff auf Kinesis-Datenstreams, Kinesis Data Firehose-Lieferdatenströme, Amazon S3 S3-Objekte und andere externe Ressourcen verwendet wird.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.

Pattern: arn:.*

Erforderlich: Ja

Tags

Eine Liste mit einem oder mehreren Tags, die der Anwendung zugewiesen werden können. Ein Tag ist ein Schlüssel/Wert-Paar, das eine Anwendung identifiziert. Beachten Sie, dass die maximale Anzahl von Anwendungs-Tags System-Tags einschließt. Die maximale Anzahl an benutzerdefinierten Anwendungs-Tags ist 50. Weitere Informationen über das Markieren mit Tags finden Sie unter Nutzung von Tags.

Typ: Array von Tag-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 200 Elemente.

Erforderlich: Nein

Antwortsyntax

{
   "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"
   }
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

ApplicationDetail

Als Antwort auf Ihre CreateApplication Anfrage gibt Managed Service for Apache Flink eine Antwort mit Details zu der von ihm erstellten Anwendung zurück.

Typ: ApplicationDetail Objekt

Fehler

CodeValidationException

Der vom Benutzer bereitgestellte Anwendungscode (Abfrage) ist ungültig. Dies kann ein einfacher Syntaxfehler sein.

HTTP Status Code: 400

ConcurrentModificationException

Ausnahme, die als Ergebnis gleichzeitiger Änderungen an einer Anwendung ausgelöst wurde. Dieser Fehler kann das Ergebnis des Versuchs sein, eine Anwendung zu ändern, ohne die aktuelle Anwendungs-ID zu verwenden.

HTTP Status Code: 400

InvalidArgumentException

Der angegebene Eingabeparameterwert ist nicht gültig.

HTTP Status Code: 400

InvalidRequestException

Die JSON-Anforderung ist für den Vorgang nicht gültig.

HTTP Status Code: 400

LimitExceededException

Die Anzahl der zulässigen Ressourcen wurde überschritten.

HTTP Status Code: 400

ResourceInUseException

Die Anwendung ist für diesen Vorgang nicht verfügbar.

HTTP Status Code: 400

TooManyTagsException

Anwendung, die mit zu vielen Tags erstellt wurde, oder einer Anwendung wurden zu viele Tags hinzugefügt. Beachten Sie, dass die maximale Anzahl von Anwendungs-Tags System-Tags einschließt. Die maximale Anzahl an benutzerdefinierten Anwendungs-Tags ist 50.

HTTP Status Code: 400

UnsupportedOperationException

Die Anfrage wurde abgelehnt, weil ein bestimmter Parameter nicht unterstützt wird oder eine angegebene Ressource für diesen Vorgang nicht gültig ist.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: