aws-sdk-controltower 1.24.0 → 1.25.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 961bed721f5f19784957c464b2e84758579bb85eb8df5c68d9010f889e96c51b
4
- data.tar.gz: fd8a82c4bca1844667909df6b01dce378dfedd7530bc3789e046135c5776316d
3
+ metadata.gz: c81d1d4e5596eda7ac04d10625057271e47ce98e0581c689b1ff194a4dba6d36
4
+ data.tar.gz: fb65efbdece38796b41559bf8e600510d0cb20a5aeaa8b7277f3ed3ad5825a7d
5
5
  SHA512:
6
- metadata.gz: b6032ff275f07a89e5d04a54aedd4c4f6111a82ae4d7fbd004337f6471e09eee48df9f23c0d5e905c3e8e26c59f6bde3fc2f07058ea16c94f59844e114464b2a
7
- data.tar.gz: 784513af12103d284ed0b0ce9771e59215b5bcfca9fe2fbe6e357744042acd3efedc73ff28c8b34ba8b0972610b256dab5128d9ba494491252a3adda6fdc472e
6
+ metadata.gz: 9b7f046462f04d4ba61a27b18be3aef979536ce3acaf6f35be704fc309d2b603b54182d8392113c3b4db40a2d83469680ac8167a72c4050efaa2ae817fa9bd94
7
+ data.tar.gz: 10924c573ec3223f54274985fdc5566a9a3b61428cb91702e523941f5a56db1f0326c5f775fa8f2e55e3e0511664c70fd6fbc350ef6e84a058e6af729602155c
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.25.0 (2024-06-26)
5
+ ------------------
6
+
7
+ * Feature - Added ListLandingZoneOperations API.
8
+
4
9
  1.24.0 (2024-06-25)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.24.0
1
+ 1.25.0
@@ -538,14 +538,14 @@ module Aws::ControlTower
538
538
  end
539
539
 
540
540
  # This API call turns off a control. It starts an asynchronous operation
541
- # that deletes AWS resources on the specified organizational unit and
542
- # the accounts it contains. The resources will vary according to the
543
- # control that you specify. For usage examples, see [ *the Amazon Web
544
- # Services Control Tower User Guide* ][1].
541
+ # that deletes Amazon Web Services resources on the specified
542
+ # organizational unit and the accounts it contains. The resources will
543
+ # vary according to the control that you specify. For usage examples,
544
+ # see the [ *Controls Reference Guide* ][1].
545
545
  #
546
546
  #
547
547
  #
548
- # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
548
+ # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
549
549
  #
550
550
  # @option params [required, String] :control_identifier
551
551
  # The ARN of the control. Only **Strongly recommended** and **Elective**
@@ -656,12 +656,11 @@ module Aws::ControlTower
656
656
  # that creates Amazon Web Services resources on the specified
657
657
  # organizational unit and the accounts it contains. The resources
658
658
  # created will vary according to the control that you specify. For usage
659
- # examples, see [ *the Amazon Web Services Control Tower User Guide*
660
- # ][1].
659
+ # examples, see the [ *Controls Reference Guide* ][1].
661
660
  #
662
661
  #
663
662
  #
664
- # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
663
+ # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
665
664
  #
666
665
  # @option params [required, String] :control_identifier
667
666
  # The ARN of the control. Only **Strongly recommended** and **Elective**
@@ -806,12 +805,12 @@ module Aws::ControlTower
806
805
 
807
806
  # Returns the status of a particular `EnableControl` or `DisableControl`
808
807
  # operation. Displays a message in case of error. Details for an
809
- # operation are available for 90 days. For usage examples, see [ *the
810
- # Amazon Web Services Control Tower User Guide* ][1].
808
+ # operation are available for 90 days. For usage examples, see the [
809
+ # *Controls Reference Guide* ][1].
811
810
  #
812
811
  #
813
812
  #
814
- # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
813
+ # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
815
814
  #
816
815
  # @option params [required, String] :operation_identifier
817
816
  # The ID of the asynchronous operation, which is used to track status.
@@ -885,12 +884,12 @@ module Aws::ControlTower
885
884
  req.send_request(options)
886
885
  end
887
886
 
888
- # Retrieves details about an enabled control. For usage examples, see [
889
- # *the Amazon Web Services Control Tower User Guide* ][1].
887
+ # Retrieves details about an enabled control. For usage examples, see
888
+ # the [ *Controls Reference Guide* ][1].
890
889
  #
891
890
  #
892
891
  #
893
- # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
892
+ # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
894
893
  #
895
894
  # @option params [required, String] :enabled_control_identifier
896
895
  # The `controlIdentifier` of the enabled control.
@@ -979,6 +978,7 @@ module Aws::ControlTower
979
978
  # @example Response structure
980
979
  #
981
980
  # resp.operation_details.end_time #=> Time
981
+ # resp.operation_details.operation_identifier #=> String
982
982
  # resp.operation_details.operation_type #=> String, one of "DELETE", "CREATE", "UPDATE", "RESET"
983
983
  # resp.operation_details.start_time #=> Time
984
984
  # resp.operation_details.status #=> String, one of "SUCCEEDED", "FAILED", "IN_PROGRESS"
@@ -1037,7 +1037,12 @@ module Aws::ControlTower
1037
1037
  req.send_request(options)
1038
1038
  end
1039
1039
 
1040
- # Provides a list of operations in progress or queued.
1040
+ # Provides a list of operations in progress or queued. For usage
1041
+ # examples, see [ListControlOperation examples][1].
1042
+ #
1043
+ #
1044
+ #
1045
+ # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html#list-control-operations-api-examples
1041
1046
  #
1042
1047
  # @option params [Types::ControlOperationFilter] :filter
1043
1048
  # An input filter for the `ListControlOperations` API that lets you
@@ -1153,16 +1158,15 @@ module Aws::ControlTower
1153
1158
 
1154
1159
  # Lists the controls enabled by Amazon Web Services Control Tower on the
1155
1160
  # specified organizational unit and the accounts it contains. For usage
1156
- # examples, see [ *the Amazon Web Services Control Tower User Guide*
1157
- # ][1].
1161
+ # examples, see the [ *Controls Reference Guide* ][1].
1158
1162
  #
1159
1163
  #
1160
1164
  #
1161
- # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
1165
+ # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
1162
1166
  #
1163
1167
  # @option params [Types::EnabledControlFilter] :filter
1164
- # An input filter for the `ListCEnabledControls` API that lets you
1165
- # select the types of control operations to view.
1168
+ # An input filter for the `ListEnabledControls` API that lets you select
1169
+ # the types of control operations to view.
1166
1170
  #
1167
1171
  # @option params [Integer] :max_results
1168
1172
  # How many results to return per API call.
@@ -1219,6 +1223,55 @@ module Aws::ControlTower
1219
1223
  req.send_request(options)
1220
1224
  end
1221
1225
 
1226
+ # Lists all landing zone operations from the past 90 days. Results are
1227
+ # sorted by time, with the most recent operation first.
1228
+ #
1229
+ # @option params [Types::LandingZoneOperationFilter] :filter
1230
+ # An input filter for the `ListLandingZoneOperations` API that lets you
1231
+ # select the types of landing zone operations to view.
1232
+ #
1233
+ # @option params [Integer] :max_results
1234
+ # How many results to return per API call.
1235
+ #
1236
+ # @option params [String] :next_token
1237
+ # The token to continue the list from a previous API call with the same
1238
+ # parameters.
1239
+ #
1240
+ # @return [Types::ListLandingZoneOperationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1241
+ #
1242
+ # * {Types::ListLandingZoneOperationsOutput#landing_zone_operations #landing_zone_operations} => Array<Types::LandingZoneOperationSummary>
1243
+ # * {Types::ListLandingZoneOperationsOutput#next_token #next_token} => String
1244
+ #
1245
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1246
+ #
1247
+ # @example Request syntax with placeholder values
1248
+ #
1249
+ # resp = client.list_landing_zone_operations({
1250
+ # filter: {
1251
+ # statuses: ["SUCCEEDED"], # accepts SUCCEEDED, FAILED, IN_PROGRESS
1252
+ # types: ["DELETE"], # accepts DELETE, CREATE, UPDATE, RESET
1253
+ # },
1254
+ # max_results: 1,
1255
+ # next_token: "String",
1256
+ # })
1257
+ #
1258
+ # @example Response structure
1259
+ #
1260
+ # resp.landing_zone_operations #=> Array
1261
+ # resp.landing_zone_operations[0].operation_identifier #=> String
1262
+ # resp.landing_zone_operations[0].operation_type #=> String, one of "DELETE", "CREATE", "UPDATE", "RESET"
1263
+ # resp.landing_zone_operations[0].status #=> String, one of "SUCCEEDED", "FAILED", "IN_PROGRESS"
1264
+ # resp.next_token #=> String
1265
+ #
1266
+ # @see http://docs.aws.amazon.com/goto/WebAPI/controltower-2018-05-10/ListLandingZoneOperations AWS API Documentation
1267
+ #
1268
+ # @overload list_landing_zone_operations(params = {})
1269
+ # @param [Hash] params ({})
1270
+ def list_landing_zone_operations(params = {}, options = {})
1271
+ req = build_request(:list_landing_zone_operations, params)
1272
+ req.send_request(options)
1273
+ end
1274
+
1222
1275
  # Returns the landing zone ARN for the landing zone deployed in your
1223
1276
  # managed account. This API also creates an ARN for existing accounts
1224
1277
  # that do not yet have a landing zone ARN.
@@ -1262,12 +1315,11 @@ module Aws::ControlTower
1262
1315
  end
1263
1316
 
1264
1317
  # Returns a list of tags associated with the resource. For usage
1265
- # examples, see [ *the Amazon Web Services Control Tower User Guide*
1266
- # ][1].
1318
+ # examples, see the [ *Controls Reference Guide* ][1].
1267
1319
  #
1268
1320
  #
1269
1321
  #
1270
- # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
1322
+ # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
1271
1323
  #
1272
1324
  # @option params [required, String] :resource_arn
1273
1325
  # The ARN of the resource.
@@ -1334,7 +1386,11 @@ module Aws::ControlTower
1334
1386
 
1335
1387
  # This API call resets a landing zone. It starts an asynchronous
1336
1388
  # operation that resets the landing zone to the parameters specified in
1337
- # its original configuration.
1389
+ # the original configuration, which you specified in the manifest file.
1390
+ # Nothing in the manifest file's original landing zone configuration is
1391
+ # changed during the reset process, by default. This API is not the same
1392
+ # as a rollback of a landing zone version, which is not a supported
1393
+ # operation.
1338
1394
  #
1339
1395
  # @option params [required, String] :landing_zone_identifier
1340
1396
  # The unique identifier of the landing zone.
@@ -1362,12 +1418,12 @@ module Aws::ControlTower
1362
1418
  req.send_request(options)
1363
1419
  end
1364
1420
 
1365
- # Applies tags to a resource. For usage examples, see [ *the Amazon Web
1366
- # Services Control Tower User Guide* ][1].
1421
+ # Applies tags to a resource. For usage examples, see the [ *Controls
1422
+ # Reference Guide* ][1].
1367
1423
  #
1368
1424
  #
1369
1425
  #
1370
- # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
1426
+ # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
1371
1427
  #
1372
1428
  # @option params [required, String] :resource_arn
1373
1429
  # The ARN of the resource to be tagged.
@@ -1395,12 +1451,12 @@ module Aws::ControlTower
1395
1451
  req.send_request(options)
1396
1452
  end
1397
1453
 
1398
- # Removes tags from a resource. For usage examples, see [ *the Amazon
1399
- # Web Services Control Tower User Guide* ][1].
1454
+ # Removes tags from a resource. For usage examples, see the [ *Controls
1455
+ # Reference Guide* ][1].
1400
1456
  #
1401
1457
  #
1402
1458
  #
1403
- # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
1459
+ # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
1404
1460
  #
1405
1461
  # @option params [required, String] :resource_arn
1406
1462
  # The ARN of the resource.
@@ -1483,18 +1539,18 @@ module Aws::ControlTower
1483
1539
  # accept the request.
1484
1540
  #
1485
1541
  # If the enabled control shows an `EnablementStatus` of FAILED, Amazon
1486
- # Web Services Control Tower will update the control to match any valid
1542
+ # Web Services Control Tower updates the control to match any valid
1487
1543
  # parameters that you supply.
1488
1544
  #
1489
1545
  # If the `DriftSummary` status for the control shows as DRIFTED, you
1490
1546
  # cannot call this API. Instead, you can update the control by calling
1491
1547
  # `DisableControl` and again calling `EnableControl`, or you can run an
1492
- # extending governance operation. For usage examples, see [ *the Amazon
1493
- # Web Services Control Tower User Guide* ][1]
1548
+ # extending governance operation. For usage examples, see the [
1549
+ # *Controls Reference Guide* ][1].
1494
1550
  #
1495
1551
  #
1496
1552
  #
1497
- # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
1553
+ # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
1498
1554
  #
1499
1555
  # @option params [required, String] :enabled_control_identifier
1500
1556
  # The ARN of the enabled control that will be updated.
@@ -1542,9 +1598,11 @@ module Aws::ControlTower
1542
1598
  # The unique identifier of the landing zone.
1543
1599
  #
1544
1600
  # @option params [required, Hash,Array,String,Numeric,Boolean] :manifest
1545
- # The manifest JSON file is a text file that describes your Amazon Web
1546
- # Services resources. For examples, review [Launch your landing
1547
- # zone][1].
1601
+ # The manifest file (JSON) is a text file that describes your Amazon Web
1602
+ # Services resources. For an example, review [Launch your landing
1603
+ # zone][1]. The example manifest file contains each of the available
1604
+ # parameters. The schema for the landing zone's JSON manifest file is
1605
+ # not published, by design.
1548
1606
  #
1549
1607
  # Document type used to carry open content
1550
1608
  # (Hash,Array,String,Numeric,Boolean). A document type value is
@@ -1597,7 +1655,7 @@ module Aws::ControlTower
1597
1655
  params: params,
1598
1656
  config: config)
1599
1657
  context[:gem_name] = 'aws-sdk-controltower'
1600
- context[:gem_version] = '1.24.0'
1658
+ context[:gem_version] = '1.25.0'
1601
1659
  Seahorse::Client::Request.new(handlers, context)
1602
1660
  end
1603
1661
 
@@ -92,8 +92,13 @@ module Aws::ControlTower
92
92
  LandingZoneDriftStatus = Shapes::StringShape.new(name: 'LandingZoneDriftStatus')
93
93
  LandingZoneDriftStatusSummary = Shapes::StructureShape.new(name: 'LandingZoneDriftStatusSummary')
94
94
  LandingZoneOperationDetail = Shapes::StructureShape.new(name: 'LandingZoneOperationDetail')
95
+ LandingZoneOperationFilter = Shapes::StructureShape.new(name: 'LandingZoneOperationFilter')
95
96
  LandingZoneOperationStatus = Shapes::StringShape.new(name: 'LandingZoneOperationStatus')
97
+ LandingZoneOperationStatuses = Shapes::ListShape.new(name: 'LandingZoneOperationStatuses')
98
+ LandingZoneOperationSummary = Shapes::StructureShape.new(name: 'LandingZoneOperationSummary')
96
99
  LandingZoneOperationType = Shapes::StringShape.new(name: 'LandingZoneOperationType')
100
+ LandingZoneOperationTypes = Shapes::ListShape.new(name: 'LandingZoneOperationTypes')
101
+ LandingZoneOperations = Shapes::ListShape.new(name: 'LandingZoneOperations')
97
102
  LandingZoneStatus = Shapes::StringShape.new(name: 'LandingZoneStatus')
98
103
  LandingZoneSummary = Shapes::StructureShape.new(name: 'LandingZoneSummary')
99
104
  LandingZoneVersion = Shapes::StringShape.new(name: 'LandingZoneVersion')
@@ -110,6 +115,9 @@ module Aws::ControlTower
110
115
  ListEnabledBaselinesOutput = Shapes::StructureShape.new(name: 'ListEnabledBaselinesOutput')
111
116
  ListEnabledControlsInput = Shapes::StructureShape.new(name: 'ListEnabledControlsInput')
112
117
  ListEnabledControlsOutput = Shapes::StructureShape.new(name: 'ListEnabledControlsOutput')
118
+ ListLandingZoneOperationsInput = Shapes::StructureShape.new(name: 'ListLandingZoneOperationsInput')
119
+ ListLandingZoneOperationsMaxResults = Shapes::IntegerShape.new(name: 'ListLandingZoneOperationsMaxResults')
120
+ ListLandingZoneOperationsOutput = Shapes::StructureShape.new(name: 'ListLandingZoneOperationsOutput')
113
121
  ListLandingZonesInput = Shapes::StructureShape.new(name: 'ListLandingZonesInput')
114
122
  ListLandingZonesMaxResults = Shapes::IntegerShape.new(name: 'ListLandingZonesMaxResults')
115
123
  ListLandingZonesOutput = Shapes::StructureShape.new(name: 'ListLandingZonesOutput')
@@ -401,12 +409,28 @@ module Aws::ControlTower
401
409
  LandingZoneDriftStatusSummary.struct_class = Types::LandingZoneDriftStatusSummary
402
410
 
403
411
  LandingZoneOperationDetail.add_member(:end_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "endTime"))
412
+ LandingZoneOperationDetail.add_member(:operation_identifier, Shapes::ShapeRef.new(shape: OperationIdentifier, location_name: "operationIdentifier"))
404
413
  LandingZoneOperationDetail.add_member(:operation_type, Shapes::ShapeRef.new(shape: LandingZoneOperationType, location_name: "operationType"))
405
414
  LandingZoneOperationDetail.add_member(:start_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "startTime"))
406
415
  LandingZoneOperationDetail.add_member(:status, Shapes::ShapeRef.new(shape: LandingZoneOperationStatus, location_name: "status"))
407
416
  LandingZoneOperationDetail.add_member(:status_message, Shapes::ShapeRef.new(shape: String, location_name: "statusMessage"))
408
417
  LandingZoneOperationDetail.struct_class = Types::LandingZoneOperationDetail
409
418
 
419
+ LandingZoneOperationFilter.add_member(:statuses, Shapes::ShapeRef.new(shape: LandingZoneOperationStatuses, location_name: "statuses"))
420
+ LandingZoneOperationFilter.add_member(:types, Shapes::ShapeRef.new(shape: LandingZoneOperationTypes, location_name: "types"))
421
+ LandingZoneOperationFilter.struct_class = Types::LandingZoneOperationFilter
422
+
423
+ LandingZoneOperationStatuses.member = Shapes::ShapeRef.new(shape: LandingZoneOperationStatus)
424
+
425
+ LandingZoneOperationSummary.add_member(:operation_identifier, Shapes::ShapeRef.new(shape: OperationIdentifier, location_name: "operationIdentifier"))
426
+ LandingZoneOperationSummary.add_member(:operation_type, Shapes::ShapeRef.new(shape: LandingZoneOperationType, location_name: "operationType"))
427
+ LandingZoneOperationSummary.add_member(:status, Shapes::ShapeRef.new(shape: LandingZoneOperationStatus, location_name: "status"))
428
+ LandingZoneOperationSummary.struct_class = Types::LandingZoneOperationSummary
429
+
430
+ LandingZoneOperationTypes.member = Shapes::ShapeRef.new(shape: LandingZoneOperationType)
431
+
432
+ LandingZoneOperations.member = Shapes::ShapeRef.new(shape: LandingZoneOperationSummary)
433
+
410
434
  LandingZoneSummary.add_member(:arn, Shapes::ShapeRef.new(shape: Arn, location_name: "arn"))
411
435
  LandingZoneSummary.struct_class = Types::LandingZoneSummary
412
436
 
@@ -446,6 +470,15 @@ module Aws::ControlTower
446
470
  ListEnabledControlsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
447
471
  ListEnabledControlsOutput.struct_class = Types::ListEnabledControlsOutput
448
472
 
473
+ ListLandingZoneOperationsInput.add_member(:filter, Shapes::ShapeRef.new(shape: LandingZoneOperationFilter, location_name: "filter"))
474
+ ListLandingZoneOperationsInput.add_member(:max_results, Shapes::ShapeRef.new(shape: ListLandingZoneOperationsMaxResults, location_name: "maxResults"))
475
+ ListLandingZoneOperationsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
476
+ ListLandingZoneOperationsInput.struct_class = Types::ListLandingZoneOperationsInput
477
+
478
+ ListLandingZoneOperationsOutput.add_member(:landing_zone_operations, Shapes::ShapeRef.new(shape: LandingZoneOperations, required: true, location_name: "landingZoneOperations"))
479
+ ListLandingZoneOperationsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
480
+ ListLandingZoneOperationsOutput.struct_class = Types::ListLandingZoneOperationsOutput
481
+
449
482
  ListLandingZonesInput.add_member(:max_results, Shapes::ShapeRef.new(shape: ListLandingZonesMaxResults, location_name: "maxResults"))
450
483
  ListLandingZonesInput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
451
484
  ListLandingZonesInput.struct_class = Types::ListLandingZonesInput
@@ -544,6 +577,7 @@ module Aws::ControlTower
544
577
 
545
578
  api.metadata = {
546
579
  "apiVersion" => "2018-05-10",
580
+ "auth" => ["aws.auth#sigv4"],
547
581
  "endpointPrefix" => "controltower",
548
582
  "jsonVersion" => "1.1",
549
583
  "protocol" => "rest-json",
@@ -806,6 +840,24 @@ module Aws::ControlTower
806
840
  )
807
841
  end)
808
842
 
843
+ api.add_operation(:list_landing_zone_operations, Seahorse::Model::Operation.new.tap do |o|
844
+ o.name = "ListLandingZoneOperations"
845
+ o.http_method = "POST"
846
+ o.http_request_uri = "/list-landingzone-operations"
847
+ o.input = Shapes::ShapeRef.new(shape: ListLandingZoneOperationsInput)
848
+ o.output = Shapes::ShapeRef.new(shape: ListLandingZoneOperationsOutput)
849
+ o.errors << Shapes::ShapeRef.new(shape: ValidationException)
850
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
851
+ o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
852
+ o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
853
+ o[:pager] = Aws::Pager.new(
854
+ limit_key: "max_results",
855
+ tokens: {
856
+ "next_token" => "next_token"
857
+ }
858
+ )
859
+ end)
860
+
809
861
  api.add_operation(:list_landing_zones, Seahorse::Model::Operation.new.tap do |o|
810
862
  o.name = "ListLandingZones"
811
863
  o.http_method = "POST"
@@ -250,6 +250,20 @@ module Aws::ControlTower
250
250
  end
251
251
  end
252
252
 
253
+ class ListLandingZoneOperations
254
+ def self.build(context)
255
+ unless context.config.regional_endpoint
256
+ endpoint = context.config.endpoint.to_s
257
+ end
258
+ Aws::ControlTower::EndpointParameters.new(
259
+ region: context.config.region,
260
+ use_dual_stack: context.config.use_dualstack_endpoint,
261
+ use_fips: context.config.use_fips_endpoint,
262
+ endpoint: endpoint,
263
+ )
264
+ end
265
+ end
266
+
253
267
  class ListLandingZones
254
268
  def self.build(context)
255
269
  unless context.config.regional_endpoint
@@ -92,6 +92,8 @@ module Aws::ControlTower
92
92
  Aws::ControlTower::Endpoints::ListEnabledBaselines.build(context)
93
93
  when :list_enabled_controls
94
94
  Aws::ControlTower::Endpoints::ListEnabledControls.build(context)
95
+ when :list_landing_zone_operations
96
+ Aws::ControlTower::Endpoints::ListLandingZoneOperations.build(context)
95
97
  when :list_landing_zones
96
98
  Aws::ControlTower::Endpoints::ListLandingZones.build(context)
97
99
  when :list_tags_for_resource
@@ -159,7 +159,7 @@ module Aws::ControlTower
159
159
  include Aws::Structure
160
160
  end
161
161
 
162
- # A filter object that lets you call `ListCOntrolOperations` with a
162
+ # A filter object that lets you call `ListControlOperations` with a
163
163
  # specific filter.
164
164
  #
165
165
  # @!attribute [rw] control_identifiers
@@ -559,7 +559,8 @@ module Aws::ControlTower
559
559
  # @return [Array<Types::EnabledBaselineParameterSummary>]
560
560
  #
561
561
  # @!attribute [rw] status_summary
562
- # The deployment summary of the enabled control.
562
+ # The deployment summary of an `EnabledControl` or `EnabledBaseline`
563
+ # resource.
563
564
  # @return [Types::EnablementStatusSummary]
564
565
  #
565
566
  # @!attribute [rw] target_identifier
@@ -657,7 +658,8 @@ module Aws::ControlTower
657
658
  # @return [String]
658
659
  #
659
660
  # @!attribute [rw] status_summary
660
- # The deployment summary of the enabled control.
661
+ # The deployment summary of an `EnabledControl` or `EnabledBaseline`
662
+ # resource.
661
663
  # @return [Types::EnablementStatusSummary]
662
664
  #
663
665
  # @!attribute [rw] target_identifier
@@ -830,23 +832,26 @@ module Aws::ControlTower
830
832
  include Aws::Structure
831
833
  end
832
834
 
833
- # The deployment summary of the enabled control.
835
+ # The deployment summary of an `EnabledControl` or `EnabledBaseline`
836
+ # resource.
834
837
  #
835
838
  # @!attribute [rw] last_operation_identifier
836
- # The last operation identifier for the enabled control.
839
+ # The last operation identifier for the enabled resource.
837
840
  # @return [String]
838
841
  #
839
842
  # @!attribute [rw] status
840
- # The deployment status of the enabled control.
843
+ # The deployment status of the enabled resource.
841
844
  #
842
845
  # Valid values:
843
846
  #
844
- # * `SUCCEEDED`: The `enabledControl` configuration was deployed
845
- # successfully.
847
+ # * `SUCCEEDED`: The `EnabledControl` or `EnabledBaseline`
848
+ # configuration was deployed successfully.
846
849
  #
847
- # * `UNDER_CHANGE`: The `enabledControl` configuration is changing.
850
+ # * `UNDER_CHANGE`: The `EnabledControl` or `EnabledBaseline`
851
+ # configuration is changing.
848
852
  #
849
- # * `FAILED`: The `enabledControl` configuration failed to deploy.
853
+ # * `FAILED`: The `EnabledControl` or `EnabledBaseline` configuration
854
+ # failed to deploy.
850
855
  # @return [String]
851
856
  #
852
857
  # @see http://docs.aws.amazon.com/goto/WebAPI/controltower-2018-05-10/EnablementStatusSummary AWS API Documentation
@@ -1127,6 +1132,10 @@ module Aws::ControlTower
1127
1132
  # The landing zone operation end time.
1128
1133
  # @return [Time]
1129
1134
  #
1135
+ # @!attribute [rw] operation_identifier
1136
+ # The `operationIdentifier` of the landing zone operation.
1137
+ # @return [String]
1138
+ #
1130
1139
  # @!attribute [rw] operation_type
1131
1140
  # The landing zone operation type.
1132
1141
  #
@@ -1164,6 +1173,7 @@ module Aws::ControlTower
1164
1173
  #
1165
1174
  class LandingZoneOperationDetail < Struct.new(
1166
1175
  :end_time,
1176
+ :operation_identifier,
1167
1177
  :operation_type,
1168
1178
  :start_time,
1169
1179
  :status,
@@ -1172,6 +1182,51 @@ module Aws::ControlTower
1172
1182
  include Aws::Structure
1173
1183
  end
1174
1184
 
1185
+ # A filter object that lets you call `ListLandingZoneOperations` with a
1186
+ # specific filter.
1187
+ #
1188
+ # @!attribute [rw] statuses
1189
+ # The statuses of the set of landing zone operations selected by the
1190
+ # filter.
1191
+ # @return [Array<String>]
1192
+ #
1193
+ # @!attribute [rw] types
1194
+ # The set of landing zone operation types selected by the filter.
1195
+ # @return [Array<String>]
1196
+ #
1197
+ # @see http://docs.aws.amazon.com/goto/WebAPI/controltower-2018-05-10/LandingZoneOperationFilter AWS API Documentation
1198
+ #
1199
+ class LandingZoneOperationFilter < Struct.new(
1200
+ :statuses,
1201
+ :types)
1202
+ SENSITIVE = []
1203
+ include Aws::Structure
1204
+ end
1205
+
1206
+ # Returns a summary of information about a landing zone operation.
1207
+ #
1208
+ # @!attribute [rw] operation_identifier
1209
+ # The `operationIdentifier` of the landing zone operation.
1210
+ # @return [String]
1211
+ #
1212
+ # @!attribute [rw] operation_type
1213
+ # The type of the landing zone operation.
1214
+ # @return [String]
1215
+ #
1216
+ # @!attribute [rw] status
1217
+ # The status of the landing zone operation.
1218
+ # @return [String]
1219
+ #
1220
+ # @see http://docs.aws.amazon.com/goto/WebAPI/controltower-2018-05-10/LandingZoneOperationSummary AWS API Documentation
1221
+ #
1222
+ class LandingZoneOperationSummary < Struct.new(
1223
+ :operation_identifier,
1224
+ :operation_type,
1225
+ :status)
1226
+ SENSITIVE = []
1227
+ include Aws::Structure
1228
+ end
1229
+
1175
1230
  # Returns a summary of information about a landing zone.
1176
1231
  #
1177
1232
  # @!attribute [rw] arn
@@ -1244,7 +1299,7 @@ module Aws::ControlTower
1244
1299
  end
1245
1300
 
1246
1301
  # @!attribute [rw] control_operations
1247
- # Returns a list of output from control operations. PLACEHOLDER
1302
+ # Returns a list of output from control operations.
1248
1303
  # @return [Array<Types::ControlOperationSummary>]
1249
1304
  #
1250
1305
  # @!attribute [rw] next_token
@@ -1302,7 +1357,7 @@ module Aws::ControlTower
1302
1357
  end
1303
1358
 
1304
1359
  # @!attribute [rw] filter
1305
- # An input filter for the `ListCEnabledControls` API that lets you
1360
+ # An input filter for the `ListEnabledControls` API that lets you
1306
1361
  # select the types of control operations to view.
1307
1362
  # @return [Types::EnabledControlFilter]
1308
1363
  #
@@ -1354,6 +1409,48 @@ module Aws::ControlTower
1354
1409
  include Aws::Structure
1355
1410
  end
1356
1411
 
1412
+ # @!attribute [rw] filter
1413
+ # An input filter for the `ListLandingZoneOperations` API that lets
1414
+ # you select the types of landing zone operations to view.
1415
+ # @return [Types::LandingZoneOperationFilter]
1416
+ #
1417
+ # @!attribute [rw] max_results
1418
+ # How many results to return per API call.
1419
+ # @return [Integer]
1420
+ #
1421
+ # @!attribute [rw] next_token
1422
+ # The token to continue the list from a previous API call with the
1423
+ # same parameters.
1424
+ # @return [String]
1425
+ #
1426
+ # @see http://docs.aws.amazon.com/goto/WebAPI/controltower-2018-05-10/ListLandingZoneOperationsInput AWS API Documentation
1427
+ #
1428
+ class ListLandingZoneOperationsInput < Struct.new(
1429
+ :filter,
1430
+ :max_results,
1431
+ :next_token)
1432
+ SENSITIVE = []
1433
+ include Aws::Structure
1434
+ end
1435
+
1436
+ # @!attribute [rw] landing_zone_operations
1437
+ # Lists landing zone operations.
1438
+ # @return [Array<Types::LandingZoneOperationSummary>]
1439
+ #
1440
+ # @!attribute [rw] next_token
1441
+ # Retrieves the next page of results. If the string is empty, the
1442
+ # response is the end of the results.
1443
+ # @return [String]
1444
+ #
1445
+ # @see http://docs.aws.amazon.com/goto/WebAPI/controltower-2018-05-10/ListLandingZoneOperationsOutput AWS API Documentation
1446
+ #
1447
+ class ListLandingZoneOperationsOutput < Struct.new(
1448
+ :landing_zone_operations,
1449
+ :next_token)
1450
+ SENSITIVE = []
1451
+ include Aws::Structure
1452
+ end
1453
+
1357
1454
  # @!attribute [rw] max_results
1358
1455
  # The maximum number of returned landing zone ARNs, which is one.
1359
1456
  # @return [Integer]
@@ -1660,9 +1757,11 @@ module Aws::ControlTower
1660
1757
  # @return [String]
1661
1758
  #
1662
1759
  # @!attribute [rw] manifest
1663
- # The manifest JSON file is a text file that describes your Amazon Web
1664
- # Services resources. For examples, review [Launch your landing
1665
- # zone][1].
1760
+ # The manifest file (JSON) is a text file that describes your Amazon
1761
+ # Web Services resources. For an example, review [Launch your landing
1762
+ # zone][1]. The example manifest file contains each of the available
1763
+ # parameters. The schema for the landing zone's JSON manifest file is
1764
+ # not published, by design.
1666
1765
  #
1667
1766
  #
1668
1767
  #
@@ -52,6 +52,6 @@ require_relative 'aws-sdk-controltower/customizations'
52
52
  # @!group service
53
53
  module Aws::ControlTower
54
54
 
55
- GEM_VERSION = '1.24.0'
55
+ GEM_VERSION = '1.25.0'
56
56
 
57
57
  end
data/sig/client.rbs CHANGED
@@ -295,6 +295,22 @@ module Aws
295
295
  ) -> _ListEnabledControlsResponseSuccess
296
296
  | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListEnabledControlsResponseSuccess
297
297
 
298
+ interface _ListLandingZoneOperationsResponseSuccess
299
+ include ::Seahorse::Client::_ResponseSuccess[Types::ListLandingZoneOperationsOutput]
300
+ def landing_zone_operations: () -> ::Array[Types::LandingZoneOperationSummary]
301
+ def next_token: () -> ::String
302
+ end
303
+ # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/ControlTower/Client.html#list_landing_zone_operations-instance_method
304
+ def list_landing_zone_operations: (
305
+ ?filter: {
306
+ statuses: Array[("SUCCEEDED" | "FAILED" | "IN_PROGRESS")]?,
307
+ types: Array[("DELETE" | "CREATE" | "UPDATE" | "RESET")]?
308
+ },
309
+ ?max_results: ::Integer,
310
+ ?next_token: ::String
311
+ ) -> _ListLandingZoneOperationsResponseSuccess
312
+ | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListLandingZoneOperationsResponseSuccess
313
+
298
314
  interface _ListLandingZonesResponseSuccess
299
315
  include ::Seahorse::Client::_ResponseSuccess[Types::ListLandingZonesOutput]
300
316
  def landing_zones: () -> ::Array[Types::LandingZoneSummary]
data/sig/types.rbs CHANGED
@@ -324,6 +324,7 @@ module Aws::ControlTower
324
324
 
325
325
  class LandingZoneOperationDetail
326
326
  attr_accessor end_time: ::Time
327
+ attr_accessor operation_identifier: ::String
327
328
  attr_accessor operation_type: ("DELETE" | "CREATE" | "UPDATE" | "RESET")
328
329
  attr_accessor start_time: ::Time
329
330
  attr_accessor status: ("SUCCEEDED" | "FAILED" | "IN_PROGRESS")
@@ -331,6 +332,19 @@ module Aws::ControlTower
331
332
  SENSITIVE: []
332
333
  end
333
334
 
335
+ class LandingZoneOperationFilter
336
+ attr_accessor statuses: ::Array[("SUCCEEDED" | "FAILED" | "IN_PROGRESS")]
337
+ attr_accessor types: ::Array[("DELETE" | "CREATE" | "UPDATE" | "RESET")]
338
+ SENSITIVE: []
339
+ end
340
+
341
+ class LandingZoneOperationSummary
342
+ attr_accessor operation_identifier: ::String
343
+ attr_accessor operation_type: ("DELETE" | "CREATE" | "UPDATE" | "RESET")
344
+ attr_accessor status: ("SUCCEEDED" | "FAILED" | "IN_PROGRESS")
345
+ SENSITIVE: []
346
+ end
347
+
334
348
  class LandingZoneSummary
335
349
  attr_accessor arn: ::String
336
350
  SENSITIVE: []
@@ -388,6 +402,19 @@ module Aws::ControlTower
388
402
  SENSITIVE: []
389
403
  end
390
404
 
405
+ class ListLandingZoneOperationsInput
406
+ attr_accessor filter: Types::LandingZoneOperationFilter
407
+ attr_accessor max_results: ::Integer
408
+ attr_accessor next_token: ::String
409
+ SENSITIVE: []
410
+ end
411
+
412
+ class ListLandingZoneOperationsOutput
413
+ attr_accessor landing_zone_operations: ::Array[Types::LandingZoneOperationSummary]
414
+ attr_accessor next_token: ::String
415
+ SENSITIVE: []
416
+ end
417
+
391
418
  class ListLandingZonesInput
392
419
  attr_accessor max_results: ::Integer
393
420
  attr_accessor next_token: ::String
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-controltower
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.24.0
4
+ version: 1.25.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-06-25 00:00:00.000000000 Z
11
+ date: 2024-06-26 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core