aws-sdk-controltower 1.24.0 → 1.25.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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