Skip to content

Commit a39faa1

Browse files
author
AWS
committed
Network Flow Monitor Update: This release contains 2 changes. 1: DeleteScope/GetScope/UpdateScope operations now return 404 instead of 500 when the resource does not exist. 2: Expected string format for clientToken fields of CreateMonitorInput/CreateScopeInput/UpdateMonitorInput have been updated to be an UUID based string.
1 parent fa3717c commit a39faa1

File tree

2 files changed

+23
-8
lines changed

2 files changed

+23
-8
lines changed
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"type": "feature",
3+
"category": "Network Flow Monitor",
4+
"contributor": "",
5+
"description": "This release contains 2 changes. 1: DeleteScope/GetScope/UpdateScope operations now return 404 instead of 500 when the resource does not exist. 2: Expected string format for clientToken fields of CreateMonitorInput/CreateScopeInput/UpdateMonitorInput have been updated to be an UUID based string."
6+
}

services/networkflowmonitor/src/main/resources/codegen-resources/service-2.json

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,7 @@
8383
"output":{"shape":"DeleteScopeOutput"},
8484
"errors":[
8585
{"shape":"ServiceQuotaExceededException"},
86+
{"shape":"ResourceNotFoundException"},
8687
{"shape":"ValidationException"},
8788
{"shape":"ThrottlingException"},
8889
{"shape":"AccessDeniedException"},
@@ -145,7 +146,7 @@
145146
{"shape":"AccessDeniedException"},
146147
{"shape":"InternalServerException"}
147148
],
148-
"documentation":"<p>Return the data for a query with the Network Flow Monitor query interface. You specify the query that you want to return results for by providing a query ID and a monitor name. This query returns the top contributors for a specific monitor.</p> <p>Create a query ID for this call by calling the corresponding API call to start the query, <code>StartQueryWorkloadInsightsTopContributors</code>. Use the scope ID that was returned for your account by <code>CreateScope</code>.</p> <p>Top contributors in Network Flow Monitor are network flows with the highest values for a specific metric type, related to a scope (for workload insights) or a monitor.</p>"
149+
"documentation":"<p>Return the data for a query with the Network Flow Monitor query interface. You specify the query that you want to return results for by providing a query ID and a monitor name.</p> <p>This query returns the top contributors for a scope for workload insights. Workload insights provide a high level view of network flow performance data collected by agents. To return the data for the top contributors, see <code>GetQueryResultsWorkloadInsightsTopContributorsData</code>.</p> <p>Create a query ID for this call by calling the corresponding API call to start the query, <code>StartQueryWorkloadInsightsTopContributors</code>. Use the scope ID that was returned for your account by <code>CreateScope</code>.</p> <p>Top contributors in Network Flow Monitor are network flows with the highest values for a specific metric type, related to a scope (for workload insights) or a monitor.</p>"
149150
},
150151
"GetQueryResultsWorkloadInsightsTopContributorsData":{
151152
"name":"GetQueryResultsWorkloadInsightsTopContributorsData",
@@ -164,7 +165,7 @@
164165
{"shape":"AccessDeniedException"},
165166
{"shape":"InternalServerException"}
166167
],
167-
"documentation":"<p>Return the data for a query with the Network Flow Monitor query interface. Specify the query that you want to return results for by providing a query ID and a scope ID. This query returns data for the top contributors for workload insights. Workload insights provide a high level view of network flow performance data collected by agents for a scope.</p> <p>Create a query ID for this call by calling the corresponding API call to start the query, <code>StartQueryWorkloadInsightsTopContributorsData</code>. Use the scope ID that was returned for your account by <code>CreateScope</code>.</p> <p>Top contributors in Network Flow Monitor are network flows with the highest values for a specific metric type, related to a scope (for workload insights) or a monitor.</p> <p>The top contributor network flows overall for a specific metric type, for example, the number of retransmissions.</p>"
168+
"documentation":"<p>Return the data for a query with the Network Flow Monitor query interface. Specify the query that you want to return results for by providing a query ID and a scope ID.</p> <p>This query returns the data for top contributors for workload insights for a specific scope. Workload insights provide a high level view of network flow performance data collected by agents for a scope. To return just the top contributors, see <code>GetQueryResultsWorkloadInsightsTopContributors</code>.</p> <p>Create a query ID for this call by calling the corresponding API call to start the query, <code>StartQueryWorkloadInsightsTopContributorsData</code>. Use the scope ID that was returned for your account by <code>CreateScope</code>.</p> <p>Top contributors in Network Flow Monitor are network flows with the highest values for a specific metric type, related to a scope (for workload insights) or a monitor.</p> <p>The top contributor network flows overall for a specific metric type, for example, the number of retransmissions.</p>"
168169
},
169170
"GetQueryStatusMonitorTopContributors":{
170171
"name":"GetQueryStatusMonitorTopContributors",
@@ -182,7 +183,7 @@
182183
{"shape":"AccessDeniedException"},
183184
{"shape":"InternalServerException"}
184185
],
185-
"documentation":"<p>Returns the current status of a query for the Network Flow Monitor query interface, for a specified query ID and monitor. This call returns the query status for the top contributors for a monitor.</p> <p>When you start a query, use this call to check the status of the query to make sure that it has has <code>SUCCEEDED</code> before you review the results. Use the same query ID that you used for the corresponding API call to start the query, <code>StartQueryMonitorTopContributors</code>.</p> <p>When you run a query, use this call to check the status of the query to make sure that the query has <code>SUCCEEDED</code> before you review the results.</p>"
186+
"documentation":"<p>Returns the current status of a query for the Network Flow Monitor query interface, for a specified query ID and monitor. This call returns the query status for the top contributors for a monitor.</p> <p>When you start a query, use this call to check the status of the query to make sure that it has has <code>SUCCEEDED</code> before you reviewStartQueryWorkloadInsightsTopContributorsData the results. Use the same query ID that you used for the corresponding API call to start the query, <code>StartQueryMonitorTopContributors</code>.</p> <p>When you run a query, use this call to check the status of the query to make sure that the query has <code>SUCCEEDED</code> before you review the results.</p>"
186187
},
187188
"GetQueryStatusWorkloadInsightsTopContributors":{
188189
"name":"GetQueryStatusWorkloadInsightsTopContributors",
@@ -231,6 +232,7 @@
231232
"output":{"shape":"GetScopeOutput"},
232233
"errors":[
233234
{"shape":"ServiceQuotaExceededException"},
235+
{"shape":"ResourceNotFoundException"},
234236
{"shape":"ValidationException"},
235237
{"shape":"ThrottlingException"},
236238
{"shape":"AccessDeniedException"},
@@ -344,7 +346,7 @@
344346
{"shape":"AccessDeniedException"},
345347
{"shape":"InternalServerException"}
346348
],
347-
"documentation":"<p>Return the data for a query with the Network Flow Monitor query interface. Specify the query that you want to return results for by providing a query ID and a scope ID. This query returns data for the top contributors for workload insights. Workload insights provide a high level view of network flow performance data collected by agents for a scope.</p> <p>A query ID is returned from an API call to start a query of a specific type; for example </p> <p>Top contributors in Network Flow Monitor are network flows with the highest values for a specific metric type, related to a scope (for workload insights) or a monitor.</p> <p>The top contributor network flows overall for a specific metric type, for example, the number of retransmissions.</p>"
349+
"documentation":"<p>Start a query to return the with the Network Flow Monitor query interface. Specify the query that you want to start by providing a query ID and a monitor name. This query returns the data for top contributors for workload insights.</p> <p>Top contributors in Network Flow Monitor are network flows with the highest values for a specific metric type, related to a scope (for workload insights) or a monitor.</p>"
348350
},
349351
"StopQueryMonitorTopContributors":{
350352
"name":"StopQueryMonitorTopContributors",
@@ -471,6 +473,7 @@
471473
"output":{"shape":"UpdateScopeOutput"},
472474
"errors":[
473475
{"shape":"ServiceQuotaExceededException"},
476+
{"shape":"ResourceNotFoundException"},
474477
{"shape":"ValidationException"},
475478
{"shape":"ThrottlingException"},
476479
{"shape":"AccessDeniedException"},
@@ -546,7 +549,7 @@
546549
"documentation":"<p>The Amazon Resource Name (ARN) of the scope for the monitor.</p>"
547550
},
548551
"clientToken":{
549-
"shape":"String",
552+
"shape":"UuidString",
550553
"documentation":"<p>A unique, case-sensitive string of up to 64 ASCII characters that you specify to make an idempotent API request. Don't reuse the same client token for other API requests.</p>",
551554
"idempotencyToken":true
552555
},
@@ -616,7 +619,7 @@
616619
"documentation":"<p>The targets to define the scope to be monitored. Currently, a target is an Amazon Web Services account.</p>"
617620
},
618621
"clientToken":{
619-
"shape":"String",
622+
"shape":"UuidString",
620623
"documentation":"<p>A unique, case-sensitive string of up to 64 ASCII characters that you specify to make an idempotent API request. Don't reuse the same client token for other API requests.</p>",
621624
"idempotencyToken":true
622625
},
@@ -1572,7 +1575,7 @@
15721575
},
15731576
"destinationCategory":{
15741577
"shape":"DestinationCategory",
1575-
"documentation":"<p>The category that you want to query top contributors for, for a specific monitor. Destination categories can be one of the following: </p> <ul> <li> <p> <code>INTRA_AZ</code>: Top contributor network flows within a single Availability Zone</p> </li> <li> <p> <code>INTER_AZ</code>: Top contributor network flows between Availability Zones</p> </li> <li> <p> <code>INTER_VPC</code>: Top contributor network flows between VPCs</p> </li> <li> <p> <code>AWS_SERVICES</code>: Top contributor network flows to or from Amazon Web Services services</p> </li> <li> <p> <code>UNCLASSIFIED</code>: Top contributor network flows that do not have a bucket classification</p> </li> </ul>"
1578+
"documentation":"<p>The category that you want to query top contributors for, for a specific monitor. Destination categories can be one of the following: </p> <ul> <li> <p> <code>INTRA_AZ</code>: Top contributor network flows within a single Availability Zone</p> </li> <li> <p> <code>INTER_AZ</code>: Top contributor network flows between Availability Zones</p> </li> <li> <p> <code>INTER_VPC</code>: Top contributor network flows between VPCs</p> </li> <li> <p> <code>AMAZON_S3</code>: Top contributor network flows to or from Amazon S3</p> </li> <li> <p> <code>AMAZON_DYNAMODB</code>: Top contributor network flows to or from Amazon Dynamo DB</p> </li> <li> <p> <code>UNCLASSIFIED</code>: Top contributor network flows that do not have a bucket classification</p> </li> </ul>"
15761579
},
15771580
"limit":{
15781581
"shape":"Limit",
@@ -1964,7 +1967,7 @@
19641967
"documentation":"<p>The remove resources to remove, as an array of resources with identifiers and types.</p>"
19651968
},
19661969
"clientToken":{
1967-
"shape":"String",
1970+
"shape":"UuidString",
19681971
"documentation":"<p>A unique, case-sensitive string of up to 64 ASCII characters that you specify to make an idempotent API request. Don't reuse the same client token for other API requests.</p>",
19691972
"idempotencyToken":true
19701973
}
@@ -2074,6 +2077,12 @@
20742077
}
20752078
}
20762079
},
2080+
"UuidString":{
2081+
"type":"string",
2082+
"max":36,
2083+
"min":36,
2084+
"pattern":"[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}"
2085+
},
20772086
"ValidationException":{
20782087
"type":"structure",
20792088
"members":{

0 commit comments

Comments
 (0)