Skip to content

Commit 8d57525

Browse files
author
AWS
committed
Amazon Kinesis Analytics Update: Amazon Kinesis Analytics now supports ListApplicationVersions and DescribeApplicationVersion API for Apache Flink applications
1 parent 923f378 commit 8d57525

File tree

2 files changed

+131
-9
lines changed

2 files changed

+131
-9
lines changed

‎.changes/next-release/feature-AmazonKinesisAnalytics-68219be.json

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"type": "feature",
3+
"category": "Amazon Kinesis Analytics",
4+
"contributor": "",
5+
"description": "Amazon Kinesis Analytics now supports ListApplicationVersions and DescribeApplicationVersion API for Apache Flink applications"
6+
}

‎services/kinesisanalyticsv2/src/main/resources/codegen-resources/service-2.json

Lines changed: 125 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -322,6 +322,21 @@
322322
],
323323
"documentation":"<p>Returns information about a snapshot of application state data.</p>"
324324
},
325+
"DescribeApplicationVersion":{
326+
"name":"DescribeApplicationVersion",
327+
"http":{
328+
"method":"POST",
329+
"requestUri":"/"
330+
},
331+
"input":{"shape":"DescribeApplicationVersionRequest"},
332+
"output":{"shape":"DescribeApplicationVersionResponse"},
333+
"errors":[
334+
{"shape":"InvalidArgumentException"},
335+
{"shape":"ResourceNotFoundException"},
336+
{"shape":"UnsupportedOperationException"}
337+
],
338+
"documentation":"<p>Provides a detailed description of a specified version of the application. To see a list of all the versions of an application, invoke the <a>ListApplicationVersions</a> operation.</p> <note> <p>This operation is supported only for Amazon Kinesis Data Analytics for Apache Flink.</p> </note>"
339+
},
325340
"DiscoverInputSchema":{
326341
"name":"DiscoverInputSchema",
327342
"http":{
@@ -353,6 +368,21 @@
353368
],
354369
"documentation":"<p>Lists information about the current application snapshots.</p>"
355370
},
371+
"ListApplicationVersions":{
372+
"name":"ListApplicationVersions",
373+
"http":{
374+
"method":"POST",
375+
"requestUri":"/"
376+
},
377+
"input":{"shape":"ListApplicationVersionsRequest"},
378+
"output":{"shape":"ListApplicationVersionsResponse"},
379+
"errors":[
380+
{"shape":"InvalidArgumentException"},
381+
{"shape":"ResourceNotFoundException"},
382+
{"shape":"UnsupportedOperationException"}
383+
],
384+
"documentation":"<p>Lists all the versions for the specified application, including versions that were rolled back. The response also includes a summary of the configuration associated with each version.</p> <p>To get the complete description of a specific application version, invoke the <a>DescribeApplicationVersion</a> operation.</p> <note> <p>This operation is supported only for Amazon Kinesis Data Analytics for Apache Flink.</p> </note>"
385+
},
356386
"ListApplications":{
357387
"name":"ListApplications",
358388
"http":{
@@ -503,7 +533,7 @@
503533
{"shape":"ConcurrentModificationException"},
504534
{"shape":"UnsupportedOperationException"}
505535
],
506-
"documentation":"<p>Updates the configuration for the automatic maintenance that Kinesis Data Analytics performs on the application. For information about automatic application maintenance, see <a href=\"https://docs.aws.amazon.com/kinesisanalytics/latest/java/maintenance.html\">Kinesis Data Analytics for Apache Flink Maintenance</a>.</p>"
536+
"documentation":"<p>Updates the maintenance configuration of the Kinesis Data Analytics application. </p> <p>You can invoke this operation on an application that is in one of the two following states: <code>READY</code> or <code>RUNNING</code>. If you invoke it when the application is in a state other than these two states, it throws a <code>ResourceInUseException</code>. The service makes use of the updated configuration the next time it schedules maintenance for the application. If you invoke this operation after the service schedules maintenance, the service will apply the configuration update the next time it schedules maintenance for the application. This means that you might not see the maintenance configuration update applied to the maintenance process that follows a successful invocation of this operation, but to the following maintenance process instead.</p> <p>To see the current maintenance configuration of your application, invoke the <a>DescribeApplication</a> operation.</p> <p>For information about application maintenance, see <a href=\"https://docs.aws.amazon.com/kinesisanalytics/latest/java/maintenance.html\">Kinesis Data Analytics for Apache Flink Maintenance</a>.</p> <note> <p>This operation is supported only for Amazon Kinesis Data Analytics for Apache Flink.</p> </note>"
507537
}
508538
},
509539
"shapes":{
@@ -956,7 +986,7 @@
956986
},
957987
"ApplicationMaintenanceConfigurationDescription":{
958988
"shape":"ApplicationMaintenanceConfigurationDescription",
959-
"documentation":"<p>Describes the time window for automatic application maintenance.</p>"
989+
"documentation":"<p>The details of the maintenance configuration for the application.</p>"
960990
},
961991
"ApplicationVersionUpdatedFrom":{
962992
"shape":"ApplicationVersionId",
@@ -969,6 +999,10 @@
969999
"ConditionalToken":{
9701000
"shape":"ConditionalToken",
9711001
"documentation":"<p>A value you use to implement strong concurrency for application updates.</p>"
1002+
},
1003+
"ApplicationVersionRolledBackTo":{
1004+
"shape":"ApplicationVersionId",
1005+
"documentation":"<p>The version to which you want to roll back the application.</p>"
9721006
}
9731007
},
9741008
"documentation":"<p>Describes the application, including the application Amazon Resource Name (ARN), status, latest version, and input and output configurations.</p>"
@@ -982,25 +1016,25 @@
9821016
"members":{
9831017
"ApplicationMaintenanceWindowStartTime":{
9841018
"shape":"ApplicationMaintenanceWindowStartTime",
985-
"documentation":"<p>The start time for the automatic maintenance window.</p>"
1019+
"documentation":"<p>The start time for the maintenance window.</p>"
9861020
},
9871021
"ApplicationMaintenanceWindowEndTime":{
9881022
"shape":"ApplicationMaintenanceWindowEndTime",
989-
"documentation":"<p>The end time for the automatic maintenance window.</p>"
1023+
"documentation":"<p>The end time for the maintenance window.</p>"
9901024
}
9911025
},
992-
"documentation":"<p>Describes the time window for automatic application maintenance.</p>"
1026+
"documentation":"<p>The details of the maintenance configuration for the application.</p>"
9931027
},
9941028
"ApplicationMaintenanceConfigurationUpdate":{
9951029
"type":"structure",
9961030
"required":["ApplicationMaintenanceWindowStartTimeUpdate"],
9971031
"members":{
9981032
"ApplicationMaintenanceWindowStartTimeUpdate":{
9991033
"shape":"ApplicationMaintenanceWindowStartTime",
1000-
"documentation":"<p>The updated start time for the automatic maintenance window.</p>"
1034+
"documentation":"<p>The updated start time for the maintenance window.</p>"
10011035
}
10021036
},
1003-
"documentation":"<p>Describes the updated time window for automatic application maintenance.</p>"
1037+
"documentation":"<p>Describes the updated maintenance configuration for the application.</p>"
10041038
},
10051039
"ApplicationMaintenanceWindowEndTime":{
10061040
"type":"string",
@@ -1088,7 +1122,8 @@
10881122
"AUTOSCALING",
10891123
"FORCE_STOPPING",
10901124
"MAINTENANCE",
1091-
"ROLLING_BACK"
1125+
"ROLLING_BACK",
1126+
"ROLLED_BACK"
10921127
]
10931128
},
10941129
"ApplicationSummaries":{
@@ -1133,6 +1168,28 @@
11331168
"max":999999999,
11341169
"min":1
11351170
},
1171+
"ApplicationVersionSummaries":{
1172+
"type":"list",
1173+
"member":{"shape":"ApplicationVersionSummary"}
1174+
},
1175+
"ApplicationVersionSummary":{
1176+
"type":"structure",
1177+
"required":[
1178+
"ApplicationVersionId",
1179+
"ApplicationStatus"
1180+
],
1181+
"members":{
1182+
"ApplicationVersionId":{
1183+
"shape":"ApplicationVersionId",
1184+
"documentation":"<p>The ID of the application version. Kinesis Data Analytics updates the <code>ApplicationVersionId</code> each time you update the application.</p>"
1185+
},
1186+
"ApplicationStatus":{
1187+
"shape":"ApplicationStatus",
1188+
"documentation":"<p>The status of the application.</p>"
1189+
}
1190+
},
1191+
"documentation":"<p>The summary of the application version.</p>"
1192+
},
11361193
"AuthorizedUrl":{
11371194
"type":"string",
11381195
"max":2048,
@@ -1780,6 +1837,29 @@
17801837
}
17811838
}
17821839
},
1840+
"DescribeApplicationVersionRequest":{
1841+
"type":"structure",
1842+
"required":[
1843+
"ApplicationName",
1844+
"ApplicationVersionId"
1845+
],
1846+
"members":{
1847+
"ApplicationName":{
1848+
"shape":"ApplicationName",
1849+
"documentation":"<p>The name of the application for which you want to get the version description.</p>"
1850+
},
1851+
"ApplicationVersionId":{
1852+
"shape":"ApplicationVersionId",
1853+
"documentation":"<p>The ID of the application version for which you want to get the description.</p>"
1854+
}
1855+
}
1856+
},
1857+
"DescribeApplicationVersionResponse":{
1858+
"type":"structure",
1859+
"members":{
1860+
"ApplicationVersionDetail":{"shape":"ApplicationDetail"}
1861+
}
1862+
},
17831863
"DestinationSchema":{
17841864
"type":"structure",
17851865
"required":["RecordFormatType"],
@@ -2485,6 +2565,42 @@
24852565
}
24862566
}
24872567
},
2568+
"ListApplicationVersionsInputLimit":{
2569+
"type":"integer",
2570+
"max":50,
2571+
"min":1
2572+
},
2573+
"ListApplicationVersionsRequest":{
2574+
"type":"structure",
2575+
"required":["ApplicationName"],
2576+
"members":{
2577+
"ApplicationName":{
2578+
"shape":"ApplicationName",
2579+
"documentation":"<p>The name of the application for which you want to list all versions.</p>"
2580+
},
2581+
"Limit":{
2582+
"shape":"ListApplicationVersionsInputLimit",
2583+
"documentation":"<p>The maximum number of versions to list in this invocation of the operation.</p>"
2584+
},
2585+
"NextToken":{
2586+
"shape":"NextToken",
2587+
"documentation":"<p>If a previous invocation of this operation returned a pagination token, pass it into this value to retrieve the next set of results. For more information about pagination, see <a href=\"https://docs.aws.amazon.com/cli/latest/userguide/pagination.html\">Using the AWS Command Line Interface's Pagination Options</a>.</p>"
2588+
}
2589+
}
2590+
},
2591+
"ListApplicationVersionsResponse":{
2592+
"type":"structure",
2593+
"members":{
2594+
"ApplicationVersionSummaries":{
2595+
"shape":"ApplicationVersionSummaries",
2596+
"documentation":"<p>A list of the application versions and the associated configuration summaries. The list includes application versions that were rolled back.</p> <p>To get the complete description of a specific application version, invoke the <a>DescribeApplicationVersion</a> operation.</p>"
2597+
},
2598+
"NextToken":{
2599+
"shape":"NextToken",
2600+
"documentation":"<p>The pagination token for the next set of results, or <code>null</code> if there are no additional results. To retrieve the next set of items, pass this token into a subsequent invocation of this operation. For more information about pagination, see <a href=\"https://docs.aws.amazon.com/cli/latest/userguide/pagination.html\">Using the AWS Command Line Interface's Pagination Options</a>.</p>"
2601+
}
2602+
}
2603+
},
24882604
"ListApplicationsInputLimit":{
24892605
"type":"integer",
24902606
"max":50,
@@ -3644,7 +3760,7 @@
36443760
"members":{
36453761
"ApplicationName":{
36463762
"shape":"ApplicationName",
3647-
"documentation":"<p>The name of the application for which you want to update the maintenance time window.</p>"
3763+
"documentation":"<p>The name of the application for which you want to update the maintenance configuration.</p>"
36483764
},
36493765
"ApplicationMaintenanceConfigurationUpdate":{
36503766
"shape":"ApplicationMaintenanceConfigurationUpdate",

0 commit comments

Comments
 (0)