aws-sdk-emr 1.42.0 → 1.46.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -80,6 +80,8 @@ module Aws::EMR
80
80
  DescribeJobFlowsOutput = Shapes::StructureShape.new(name: 'DescribeJobFlowsOutput')
81
81
  DescribeNotebookExecutionInput = Shapes::StructureShape.new(name: 'DescribeNotebookExecutionInput')
82
82
  DescribeNotebookExecutionOutput = Shapes::StructureShape.new(name: 'DescribeNotebookExecutionOutput')
83
+ DescribeReleaseLabelInput = Shapes::StructureShape.new(name: 'DescribeReleaseLabelInput')
84
+ DescribeReleaseLabelOutput = Shapes::StructureShape.new(name: 'DescribeReleaseLabelOutput')
83
85
  DescribeSecurityConfigurationInput = Shapes::StructureShape.new(name: 'DescribeSecurityConfigurationInput')
84
86
  DescribeSecurityConfigurationOutput = Shapes::StructureShape.new(name: 'DescribeSecurityConfigurationOutput')
85
87
  DescribeStepInput = Shapes::StructureShape.new(name: 'DescribeStepInput')
@@ -183,6 +185,8 @@ module Aws::EMR
183
185
  ListInstancesOutput = Shapes::StructureShape.new(name: 'ListInstancesOutput')
184
186
  ListNotebookExecutionsInput = Shapes::StructureShape.new(name: 'ListNotebookExecutionsInput')
185
187
  ListNotebookExecutionsOutput = Shapes::StructureShape.new(name: 'ListNotebookExecutionsOutput')
188
+ ListReleaseLabelsInput = Shapes::StructureShape.new(name: 'ListReleaseLabelsInput')
189
+ ListReleaseLabelsOutput = Shapes::StructureShape.new(name: 'ListReleaseLabelsOutput')
186
190
  ListSecurityConfigurationsInput = Shapes::StructureShape.new(name: 'ListSecurityConfigurationsInput')
187
191
  ListSecurityConfigurationsOutput = Shapes::StructureShape.new(name: 'ListSecurityConfigurationsOutput')
188
192
  ListStepsInput = Shapes::StructureShape.new(name: 'ListStepsInput')
@@ -195,6 +199,7 @@ module Aws::EMR
195
199
  ManagedScalingPolicy = Shapes::StructureShape.new(name: 'ManagedScalingPolicy')
196
200
  Marker = Shapes::StringShape.new(name: 'Marker')
197
201
  MarketType = Shapes::StringShape.new(name: 'MarketType')
202
+ MaxResultsNumber = Shapes::IntegerShape.new(name: 'MaxResultsNumber')
198
203
  MetricDimension = Shapes::StructureShape.new(name: 'MetricDimension')
199
204
  MetricDimensionList = Shapes::ListShape.new(name: 'MetricDimensionList')
200
205
  ModifyClusterInput = Shapes::StructureShape.new(name: 'ModifyClusterInput')
@@ -207,6 +212,9 @@ module Aws::EMR
207
212
  NotebookExecutionStatus = Shapes::StringShape.new(name: 'NotebookExecutionStatus')
208
213
  NotebookExecutionSummary = Shapes::StructureShape.new(name: 'NotebookExecutionSummary')
209
214
  NotebookExecutionSummaryList = Shapes::ListShape.new(name: 'NotebookExecutionSummaryList')
215
+ OnDemandCapacityReservationOptions = Shapes::StructureShape.new(name: 'OnDemandCapacityReservationOptions')
216
+ OnDemandCapacityReservationPreference = Shapes::StringShape.new(name: 'OnDemandCapacityReservationPreference')
217
+ OnDemandCapacityReservationUsageStrategy = Shapes::StringShape.new(name: 'OnDemandCapacityReservationUsageStrategy')
210
218
  OnDemandProvisioningAllocationStrategy = Shapes::StringShape.new(name: 'OnDemandProvisioningAllocationStrategy')
211
219
  OnDemandProvisioningSpecification = Shapes::StructureShape.new(name: 'OnDemandProvisioningSpecification')
212
220
  OptionalArnType = Shapes::StringShape.new(name: 'OptionalArnType')
@@ -223,6 +231,7 @@ module Aws::EMR
223
231
  PutBlockPublicAccessConfigurationOutput = Shapes::StructureShape.new(name: 'PutBlockPublicAccessConfigurationOutput')
224
232
  PutManagedScalingPolicyInput = Shapes::StructureShape.new(name: 'PutManagedScalingPolicyInput')
225
233
  PutManagedScalingPolicyOutput = Shapes::StructureShape.new(name: 'PutManagedScalingPolicyOutput')
234
+ ReleaseLabelFilter = Shapes::StructureShape.new(name: 'ReleaseLabelFilter')
226
235
  RemoveAutoScalingPolicyInput = Shapes::StructureShape.new(name: 'RemoveAutoScalingPolicyInput')
227
236
  RemoveAutoScalingPolicyOutput = Shapes::StructureShape.new(name: 'RemoveAutoScalingPolicyOutput')
228
237
  RemoveManagedScalingPolicyInput = Shapes::StructureShape.new(name: 'RemoveManagedScalingPolicyInput')
@@ -250,6 +259,8 @@ module Aws::EMR
250
259
  SetVisibleToAllUsersInput = Shapes::StructureShape.new(name: 'SetVisibleToAllUsersInput')
251
260
  ShrinkPolicy = Shapes::StructureShape.new(name: 'ShrinkPolicy')
252
261
  SimpleScalingPolicyConfiguration = Shapes::StructureShape.new(name: 'SimpleScalingPolicyConfiguration')
262
+ SimplifiedApplication = Shapes::StructureShape.new(name: 'SimplifiedApplication')
263
+ SimplifiedApplicationList = Shapes::ListShape.new(name: 'SimplifiedApplicationList')
253
264
  SpotProvisioningAllocationStrategy = Shapes::StringShape.new(name: 'SpotProvisioningAllocationStrategy')
254
265
  SpotProvisioningSpecification = Shapes::StructureShape.new(name: 'SpotProvisioningSpecification')
255
266
  SpotProvisioningTimeoutAction = Shapes::StringShape.new(name: 'SpotProvisioningTimeoutAction')
@@ -544,6 +555,16 @@ module Aws::EMR
544
555
  DescribeNotebookExecutionOutput.add_member(:notebook_execution, Shapes::ShapeRef.new(shape: NotebookExecution, location_name: "NotebookExecution"))
545
556
  DescribeNotebookExecutionOutput.struct_class = Types::DescribeNotebookExecutionOutput
546
557
 
558
+ DescribeReleaseLabelInput.add_member(:release_label, Shapes::ShapeRef.new(shape: String, location_name: "ReleaseLabel"))
559
+ DescribeReleaseLabelInput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
560
+ DescribeReleaseLabelInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResultsNumber, location_name: "MaxResults"))
561
+ DescribeReleaseLabelInput.struct_class = Types::DescribeReleaseLabelInput
562
+
563
+ DescribeReleaseLabelOutput.add_member(:release_label, Shapes::ShapeRef.new(shape: String, location_name: "ReleaseLabel"))
564
+ DescribeReleaseLabelOutput.add_member(:applications, Shapes::ShapeRef.new(shape: SimplifiedApplicationList, location_name: "Applications"))
565
+ DescribeReleaseLabelOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
566
+ DescribeReleaseLabelOutput.struct_class = Types::DescribeReleaseLabelOutput
567
+
547
568
  DescribeSecurityConfigurationInput.add_member(:name, Shapes::ShapeRef.new(shape: XmlString, required: true, location_name: "Name"))
548
569
  DescribeSecurityConfigurationInput.struct_class = Types::DescribeSecurityConfigurationInput
549
570
 
@@ -974,6 +995,15 @@ module Aws::EMR
974
995
  ListNotebookExecutionsOutput.add_member(:marker, Shapes::ShapeRef.new(shape: Marker, location_name: "Marker"))
975
996
  ListNotebookExecutionsOutput.struct_class = Types::ListNotebookExecutionsOutput
976
997
 
998
+ ListReleaseLabelsInput.add_member(:filters, Shapes::ShapeRef.new(shape: ReleaseLabelFilter, location_name: "Filters"))
999
+ ListReleaseLabelsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
1000
+ ListReleaseLabelsInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResultsNumber, location_name: "MaxResults"))
1001
+ ListReleaseLabelsInput.struct_class = Types::ListReleaseLabelsInput
1002
+
1003
+ ListReleaseLabelsOutput.add_member(:release_labels, Shapes::ShapeRef.new(shape: StringList, location_name: "ReleaseLabels"))
1004
+ ListReleaseLabelsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
1005
+ ListReleaseLabelsOutput.struct_class = Types::ListReleaseLabelsOutput
1006
+
977
1007
  ListSecurityConfigurationsInput.add_member(:marker, Shapes::ShapeRef.new(shape: Marker, location_name: "Marker"))
978
1008
  ListSecurityConfigurationsInput.struct_class = Types::ListSecurityConfigurationsInput
979
1009
 
@@ -1058,7 +1088,13 @@ module Aws::EMR
1058
1088
 
1059
1089
  NotebookExecutionSummaryList.member = Shapes::ShapeRef.new(shape: NotebookExecutionSummary)
1060
1090
 
1091
+ OnDemandCapacityReservationOptions.add_member(:usage_strategy, Shapes::ShapeRef.new(shape: OnDemandCapacityReservationUsageStrategy, location_name: "UsageStrategy"))
1092
+ OnDemandCapacityReservationOptions.add_member(:capacity_reservation_preference, Shapes::ShapeRef.new(shape: OnDemandCapacityReservationPreference, location_name: "CapacityReservationPreference"))
1093
+ OnDemandCapacityReservationOptions.add_member(:capacity_reservation_resource_group_arn, Shapes::ShapeRef.new(shape: XmlStringMaxLen256, location_name: "CapacityReservationResourceGroupArn"))
1094
+ OnDemandCapacityReservationOptions.struct_class = Types::OnDemandCapacityReservationOptions
1095
+
1061
1096
  OnDemandProvisioningSpecification.add_member(:allocation_strategy, Shapes::ShapeRef.new(shape: OnDemandProvisioningAllocationStrategy, required: true, location_name: "AllocationStrategy"))
1097
+ OnDemandProvisioningSpecification.add_member(:capacity_reservation_options, Shapes::ShapeRef.new(shape: OnDemandCapacityReservationOptions, location_name: "CapacityReservationOptions"))
1062
1098
  OnDemandProvisioningSpecification.struct_class = Types::OnDemandProvisioningSpecification
1063
1099
 
1064
1100
  PlacementGroupConfig.add_member(:instance_role, Shapes::ShapeRef.new(shape: InstanceRoleType, required: true, location_name: "InstanceRole"))
@@ -1099,6 +1135,10 @@ module Aws::EMR
1099
1135
 
1100
1136
  PutManagedScalingPolicyOutput.struct_class = Types::PutManagedScalingPolicyOutput
1101
1137
 
1138
+ ReleaseLabelFilter.add_member(:prefix, Shapes::ShapeRef.new(shape: String, location_name: "Prefix"))
1139
+ ReleaseLabelFilter.add_member(:application, Shapes::ShapeRef.new(shape: String, location_name: "Application"))
1140
+ ReleaseLabelFilter.struct_class = Types::ReleaseLabelFilter
1141
+
1102
1142
  RemoveAutoScalingPolicyInput.add_member(:cluster_id, Shapes::ShapeRef.new(shape: ClusterId, required: true, location_name: "ClusterId"))
1103
1143
  RemoveAutoScalingPolicyInput.add_member(:instance_group_id, Shapes::ShapeRef.new(shape: InstanceGroupId, required: true, location_name: "InstanceGroupId"))
1104
1144
  RemoveAutoScalingPolicyInput.struct_class = Types::RemoveAutoScalingPolicyInput
@@ -1216,6 +1256,12 @@ module Aws::EMR
1216
1256
  SimpleScalingPolicyConfiguration.add_member(:cool_down, Shapes::ShapeRef.new(shape: Integer, location_name: "CoolDown"))
1217
1257
  SimpleScalingPolicyConfiguration.struct_class = Types::SimpleScalingPolicyConfiguration
1218
1258
 
1259
+ SimplifiedApplication.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
1260
+ SimplifiedApplication.add_member(:version, Shapes::ShapeRef.new(shape: String, location_name: "Version"))
1261
+ SimplifiedApplication.struct_class = Types::SimplifiedApplication
1262
+
1263
+ SimplifiedApplicationList.member = Shapes::ShapeRef.new(shape: SimplifiedApplication)
1264
+
1219
1265
  SpotProvisioningSpecification.add_member(:timeout_duration_minutes, Shapes::ShapeRef.new(shape: WholeNumber, required: true, location_name: "TimeoutDurationMinutes"))
1220
1266
  SpotProvisioningSpecification.add_member(:timeout_action, Shapes::ShapeRef.new(shape: SpotProvisioningTimeoutAction, required: true, location_name: "TimeoutAction"))
1221
1267
  SpotProvisioningSpecification.add_member(:block_duration_minutes, Shapes::ShapeRef.new(shape: WholeNumber, location_name: "BlockDurationMinutes"))
@@ -1522,6 +1568,16 @@ module Aws::EMR
1522
1568
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
1523
1569
  end)
1524
1570
 
1571
+ api.add_operation(:describe_release_label, Seahorse::Model::Operation.new.tap do |o|
1572
+ o.name = "DescribeReleaseLabel"
1573
+ o.http_method = "POST"
1574
+ o.http_request_uri = "/"
1575
+ o.input = Shapes::ShapeRef.new(shape: DescribeReleaseLabelInput)
1576
+ o.output = Shapes::ShapeRef.new(shape: DescribeReleaseLabelOutput)
1577
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
1578
+ o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
1579
+ end)
1580
+
1525
1581
  api.add_operation(:describe_security_configuration, Seahorse::Model::Operation.new.tap do |o|
1526
1582
  o.name = "DescribeSecurityConfiguration"
1527
1583
  o.http_method = "POST"
@@ -1670,6 +1726,22 @@ module Aws::EMR
1670
1726
  )
1671
1727
  end)
1672
1728
 
1729
+ api.add_operation(:list_release_labels, Seahorse::Model::Operation.new.tap do |o|
1730
+ o.name = "ListReleaseLabels"
1731
+ o.http_method = "POST"
1732
+ o.http_request_uri = "/"
1733
+ o.input = Shapes::ShapeRef.new(shape: ListReleaseLabelsInput)
1734
+ o.output = Shapes::ShapeRef.new(shape: ListReleaseLabelsOutput)
1735
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
1736
+ o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
1737
+ o[:pager] = Aws::Pager.new(
1738
+ limit_key: "max_results",
1739
+ tokens: {
1740
+ "next_token" => "next_token"
1741
+ }
1742
+ )
1743
+ end)
1744
+
1673
1745
  api.add_operation(:list_security_configurations, Seahorse::Model::Operation.new.tap do |o|
1674
1746
  o.name = "ListSecurityConfigurations"
1675
1747
  o.http_method = "POST"
@@ -2,7 +2,7 @@
2
2
  # WARNING ABOUT GENERATED CODE
3
3
  #
4
4
  # This file is generated. See the contributing for info on making contributions:
5
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
5
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
6
6
  #
7
7
  # WARNING ABOUT GENERATED CODE
8
8
 
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -61,6 +61,11 @@ module Aws::EMR
61
61
  # },
62
62
  # on_demand_specification: {
63
63
  # allocation_strategy: "lowest-price", # required, accepts lowest-price
64
+ # capacity_reservation_options: {
65
+ # usage_strategy: "use-capacity-reservations-first", # accepts use-capacity-reservations-first
66
+ # capacity_reservation_preference: "open", # accepts open, none
67
+ # capacity_reservation_resource_group_arn: "XmlStringMaxLen256",
68
+ # },
64
69
  # },
65
70
  # },
66
71
  # },
@@ -576,8 +581,8 @@ module Aws::EMR
576
581
  include Aws::Structure
577
582
  end
578
583
 
579
- # Properties that describe the AWS principal that created the
580
- # `BlockPublicAccessConfiguration` using the
584
+ # Properties that describe the Amazon Web Services principal that
585
+ # created the `BlockPublicAccessConfiguration` using the
581
586
  # `PutBlockPublicAccessConfiguration` action as well as the date and
582
587
  # time that the configuration was created. Each time a configuration for
583
588
  # block public access is updated, Amazon EMR updates this metadata.
@@ -846,9 +851,8 @@ module Aws::EMR
846
851
  # @return [String]
847
852
  #
848
853
  # @!attribute [rw] log_encryption_kms_key_id
849
- # The AWS KMS customer master key (CMK) used for encrypting log files.
850
- # This attribute is only available with EMR version 5.30.0 and later,
851
- # excluding EMR 6.0.0.
854
+ # The KMS key used for encrypting log files. This attribute is only
855
+ # available with EMR version 5.30.0 and later, excluding EMR 6.0.0.
852
856
  # @return [String]
853
857
  #
854
858
  # @!attribute [rw] requested_ami_version
@@ -887,15 +891,27 @@ module Aws::EMR
887
891
  # @return [Boolean]
888
892
  #
889
893
  # @!attribute [rw] visible_to_all_users
890
- # Indicates whether the cluster is visible to all IAM users of the AWS
891
- # account associated with the cluster. The default value, `true`,
892
- # indicates that all IAM users in the AWS account can perform cluster
893
- # actions if they have the proper IAM policy permissions. If this
894
- # value is `false`, only the IAM user that created the cluster can
895
- # perform actions. This value can be changed on a running cluster by
896
- # using the SetVisibleToAllUsers action. You can override the default
897
- # value of `true` when you create a cluster by using the
898
- # `VisibleToAllUsers` parameter of the `RunJobFlow` action.
894
+ # Indicates whether the cluster is visible to IAM principals in the
895
+ # account associated with the cluster. When `true`, IAM principals in
896
+ # the account can perform EMR cluster actions on the cluster that
897
+ # their IAM policies allow. When `false`, only the IAM principal that
898
+ # created the cluster and the account root user can perform EMR
899
+ # actions, regardless of IAM permissions policies attached to other
900
+ # IAM principals.
901
+ #
902
+ # The default value is `false` if a value is not provided when
903
+ # creating a cluster using the EMR API RunJobFlow command or the CLI
904
+ # [create-cluster][1] command. The default value is `true` when a
905
+ # cluster is created using the Management Console. IAM principals that
906
+ # are allowed to perform actions on the cluster can use the
907
+ # SetVisibleToAllUsers action to change the value on a running
908
+ # cluster. For more information, see [Understanding the EMR Cluster
909
+ # VisibleToAllUsers Setting][2] in the *Amazon EMR Management Guide*.
910
+ #
911
+ #
912
+ #
913
+ # [1]: https://docs.aws.amazon.com/cli/latest/reference/emr/create-cluster.html
914
+ # [2]: https://docs.aws.amazon.com/emr/latest/ManagementGuide/security_iam_emr-with-iam.html#security_set_visible_to_all_users
899
915
  # @return [Boolean]
900
916
  #
901
917
  # @!attribute [rw] applications
@@ -908,7 +924,7 @@ module Aws::EMR
908
924
  #
909
925
  # @!attribute [rw] service_role
910
926
  # The IAM role that will be assumed by the Amazon EMR service to
911
- # access AWS resources on your behalf.
927
+ # access Amazon Web Services resources on your behalf.
912
928
  # @return [String]
913
929
  #
914
930
  # @!attribute [rw] normalized_instance_hours
@@ -1403,7 +1419,7 @@ module Aws::EMR
1403
1419
  # @!attribute [rw] service_role
1404
1420
  # The IAM role that will be assumed by the Amazon EMR Studio. The
1405
1421
  # service role provides a way for Amazon EMR Studio to interoperate
1406
- # with other AWS services.
1422
+ # with other Amazon Web Services services.
1407
1423
  # @return [String]
1408
1424
  #
1409
1425
  # @!attribute [rw] user_role
@@ -1426,9 +1442,8 @@ module Aws::EMR
1426
1442
  # @return [String]
1427
1443
  #
1428
1444
  # @!attribute [rw] default_s3_location
1429
- # The default Amazon S3 location to back up Amazon EMR Studio
1430
- # Workspaces and notebook files. A Studio user can select an
1431
- # alternative Amazon S3 location when creating a Workspace.
1445
+ # The Amazon S3 location to back up Amazon EMR Studio Workspaces and
1446
+ # notebook files.
1432
1447
  # @return [String]
1433
1448
  #
1434
1449
  # @!attribute [rw] tags
@@ -1491,9 +1506,10 @@ module Aws::EMR
1491
1506
  #
1492
1507
  # @!attribute [rw] identity_id
1493
1508
  # The globally unique identifier (GUID) of the user or group from the
1494
- # AWS SSO Identity Store. For more information, see [UserId][1] and
1495
- # [GroupId][2] in the *AWS SSO Identity Store API Reference*. Either
1496
- # `IdentityName` or `IdentityId` must be specified.
1509
+ # Amazon Web Services SSO Identity Store. For more information, see
1510
+ # [UserId][1] and [GroupId][2] in the *Amazon Web Services SSO
1511
+ # Identity Store API Reference*. Either `IdentityName` or `IdentityId`
1512
+ # must be specified.
1497
1513
  #
1498
1514
  #
1499
1515
  #
@@ -1503,9 +1519,9 @@ module Aws::EMR
1503
1519
  #
1504
1520
  # @!attribute [rw] identity_name
1505
1521
  # The name of the user or group. For more information, see
1506
- # [UserName][1] and [DisplayName][2] in the *AWS SSO Identity Store
1507
- # API Reference*. Either `IdentityName` or `IdentityId` must be
1508
- # specified.
1522
+ # [UserName][1] and [DisplayName][2] in the *Amazon Web Services SSO
1523
+ # Identity Store API Reference*. Either `IdentityName` or `IdentityId`
1524
+ # must be specified.
1509
1525
  #
1510
1526
  #
1511
1527
  #
@@ -1520,8 +1536,14 @@ module Aws::EMR
1520
1536
  #
1521
1537
  # @!attribute [rw] session_policy_arn
1522
1538
  # The Amazon Resource Name (ARN) for the session policy that will be
1523
- # applied to the user or group. Session policies refine Studio user
1524
- # permissions without the need to use multiple IAM user roles.
1539
+ # applied to the user or group. You should specify the ARN for the
1540
+ # session policy that you want to apply, not the ARN of your user
1541
+ # role. For more information, see [Create an EMR Studio User Role with
1542
+ # Session Policies][1].
1543
+ #
1544
+ #
1545
+ #
1546
+ # [1]: https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-studio-user-role.html
1525
1547
  # @return [String]
1526
1548
  #
1527
1549
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/CreateStudioSessionMappingInput AWS API Documentation
@@ -1595,8 +1617,8 @@ module Aws::EMR
1595
1617
  # @!attribute [rw] identity_id
1596
1618
  # The globally unique identifier (GUID) of the user or group to remove
1597
1619
  # from the Amazon EMR Studio. For more information, see [UserId][1]
1598
- # and [GroupId][2] in the *AWS SSO Identity Store API Reference*.
1599
- # Either `IdentityName` or `IdentityId` must be specified.
1620
+ # and [GroupId][2] in the *Amazon Web Services SSO Identity Store API
1621
+ # Reference*. Either `IdentityName` or `IdentityId` must be specified.
1600
1622
  #
1601
1623
  #
1602
1624
  #
@@ -1607,8 +1629,8 @@ module Aws::EMR
1607
1629
  # @!attribute [rw] identity_name
1608
1630
  # The name of the user name or group to remove from the Amazon EMR
1609
1631
  # Studio. For more information, see [UserName][1] and [DisplayName][2]
1610
- # in the *AWS SSO Identity Store API Reference*. Either `IdentityName`
1611
- # or `IdentityId` must be specified.
1632
+ # in the *Amazon Web Services SSO Store API Reference*. Either
1633
+ # `IdentityName` or `IdentityId` must be specified.
1612
1634
  #
1613
1635
  #
1614
1636
  #
@@ -1751,6 +1773,63 @@ module Aws::EMR
1751
1773
  include Aws::Structure
1752
1774
  end
1753
1775
 
1776
+ # @note When making an API call, you may pass DescribeReleaseLabelInput
1777
+ # data as a hash:
1778
+ #
1779
+ # {
1780
+ # release_label: "String",
1781
+ # next_token: "String",
1782
+ # max_results: 1,
1783
+ # }
1784
+ #
1785
+ # @!attribute [rw] release_label
1786
+ # The target release label to be described.
1787
+ # @return [String]
1788
+ #
1789
+ # @!attribute [rw] next_token
1790
+ # The pagination token. Reserved for future use. Currently set to
1791
+ # null.
1792
+ # @return [String]
1793
+ #
1794
+ # @!attribute [rw] max_results
1795
+ # Reserved for future use. Currently set to null.
1796
+ # @return [Integer]
1797
+ #
1798
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/DescribeReleaseLabelInput AWS API Documentation
1799
+ #
1800
+ class DescribeReleaseLabelInput < Struct.new(
1801
+ :release_label,
1802
+ :next_token,
1803
+ :max_results)
1804
+ SENSITIVE = []
1805
+ include Aws::Structure
1806
+ end
1807
+
1808
+ # @!attribute [rw] release_label
1809
+ # The target release label described in the response.
1810
+ # @return [String]
1811
+ #
1812
+ # @!attribute [rw] applications
1813
+ # The list of applications available for the target release label.
1814
+ # `Name` is the name of the application. `Version` is the concise
1815
+ # version of the application.
1816
+ # @return [Array<Types::SimplifiedApplication>]
1817
+ #
1818
+ # @!attribute [rw] next_token
1819
+ # The pagination token. Reserved for future use. Currently set to
1820
+ # null.
1821
+ # @return [String]
1822
+ #
1823
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/DescribeReleaseLabelOutput AWS API Documentation
1824
+ #
1825
+ class DescribeReleaseLabelOutput < Struct.new(
1826
+ :release_label,
1827
+ :applications,
1828
+ :next_token)
1829
+ SENSITIVE = []
1830
+ include Aws::Structure
1831
+ end
1832
+
1754
1833
  # @note When making an API call, you may pass DescribeSecurityConfigurationInput
1755
1834
  # data as a hash:
1756
1835
  #
@@ -2175,8 +2254,8 @@ module Aws::EMR
2175
2254
  # @return [Types::BlockPublicAccessConfiguration]
2176
2255
  #
2177
2256
  # @!attribute [rw] block_public_access_configuration_metadata
2178
- # Properties that describe the AWS principal that created the
2179
- # `BlockPublicAccessConfiguration` using the
2257
+ # Properties that describe the Amazon Web Services principal that
2258
+ # created the `BlockPublicAccessConfiguration` using the
2180
2259
  # `PutBlockPublicAccessConfiguration` action as well as the date and
2181
2260
  # time that the configuration was created. Each time a configuration
2182
2261
  # for block public access is updated, Amazon EMR updates this
@@ -2241,9 +2320,9 @@ module Aws::EMR
2241
2320
  #
2242
2321
  # @!attribute [rw] identity_id
2243
2322
  # The globally unique identifier (GUID) of the user or group. For more
2244
- # information, see [UserId][1] and [GroupId][2] in the *AWS SSO
2245
- # Identity Store API Reference*. Either `IdentityName` or `IdentityId`
2246
- # must be specified.
2323
+ # information, see [UserId][1] and [GroupId][2] in the *Amazon Web
2324
+ # Services SSO Identity Store API Reference*. Either `IdentityName` or
2325
+ # `IdentityId` must be specified.
2247
2326
  #
2248
2327
  #
2249
2328
  #
@@ -2253,9 +2332,9 @@ module Aws::EMR
2253
2332
  #
2254
2333
  # @!attribute [rw] identity_name
2255
2334
  # The name of the user or group to fetch. For more information, see
2256
- # [UserName][1] and [DisplayName][2] in the *AWS SSO Identity Store
2257
- # API Reference*. Either `IdentityName` or `IdentityId` must be
2258
- # specified.
2335
+ # [UserName][1] and [DisplayName][2] in the *Amazon Web Services SSO
2336
+ # Identity Store API Reference*. Either `IdentityName` or `IdentityId`
2337
+ # must be specified.
2259
2338
  #
2260
2339
  #
2261
2340
  #
@@ -2425,7 +2504,7 @@ module Aws::EMR
2425
2504
  # @return [String]
2426
2505
  #
2427
2506
  # @!attribute [rw] ebs_volumes
2428
- # The list of EBS volumes that are attached to this instance.
2507
+ # The list of Amazon EBS volumes that are attached to this instance.
2429
2508
  # @return [Array<Types::EbsVolume>]
2430
2509
  #
2431
2510
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/Instance AWS API Documentation
@@ -2541,9 +2620,8 @@ module Aws::EMR
2541
2620
  # @return [Integer]
2542
2621
  #
2543
2622
  # @!attribute [rw] instance_type_specifications
2544
- # The specification for the instance types that comprise an instance
2545
- # fleet. Up to five unique instance specifications may be defined for
2546
- # each instance fleet.
2623
+ # An array of specifications for the instance types that comprise an
2624
+ # instance fleet.
2547
2625
  # @return [Array<Types::InstanceTypeSpecification>]
2548
2626
  #
2549
2627
  # @!attribute [rw] launch_specifications
@@ -2623,6 +2701,11 @@ module Aws::EMR
2623
2701
  # },
2624
2702
  # on_demand_specification: {
2625
2703
  # allocation_strategy: "lowest-price", # required, accepts lowest-price
2704
+ # capacity_reservation_options: {
2705
+ # usage_strategy: "use-capacity-reservations-first", # accepts use-capacity-reservations-first
2706
+ # capacity_reservation_preference: "open", # accepts open, none
2707
+ # capacity_reservation_resource_group_arn: "XmlStringMaxLen256",
2708
+ # },
2626
2709
  # },
2627
2710
  # },
2628
2711
  # }
@@ -2769,6 +2852,11 @@ module Aws::EMR
2769
2852
  # },
2770
2853
  # on_demand_specification: {
2771
2854
  # allocation_strategy: "lowest-price", # required, accepts lowest-price
2855
+ # capacity_reservation_options: {
2856
+ # usage_strategy: "use-capacity-reservations-first", # accepts use-capacity-reservations-first
2857
+ # capacity_reservation_preference: "open", # accepts open, none
2858
+ # capacity_reservation_resource_group_arn: "XmlStringMaxLen256",
2859
+ # },
2772
2860
  # },
2773
2861
  # }
2774
2862
  #
@@ -2929,10 +3017,10 @@ module Aws::EMR
2929
3017
  # @return [String]
2930
3018
  #
2931
3019
  # @!attribute [rw] bid_price
2932
- # The bid price for each EC2 Spot Instance type as defined by
2933
- # `InstanceType`. Expressed in USD. If neither `BidPrice` nor
2934
- # `BidPriceAsPercentageOfOnDemandPrice` is provided,
2935
- # `BidPriceAsPercentageOfOnDemandPrice` defaults to 100%.
3020
+ # If specified, indicates that the instance group uses Spot Instances.
3021
+ # This is the maximum price you are willing to pay for Spot Instances.
3022
+ # Specify `OnDemandPrice` to set the amount equal to the On-Demand
3023
+ # price, or specify an amount in USD.
2936
3024
  # @return [String]
2937
3025
  #
2938
3026
  # @!attribute [rw] instance_type
@@ -2956,9 +3044,9 @@ module Aws::EMR
2956
3044
  #
2957
3045
  # </note>
2958
3046
  #
2959
- # The list of configurations supplied for an EMR cluster instance
2960
- # group. You can specify a separate configuration for each instance
2961
- # group (master, core, and task).
3047
+ # The list of configurations supplied for an Amazon EMR cluster
3048
+ # instance group. You can specify a separate configuration for each
3049
+ # instance group (master, core, and task).
2962
3050
  # @return [Array<Types::Configuration>]
2963
3051
  #
2964
3052
  # @!attribute [rw] configurations_version
@@ -3111,10 +3199,10 @@ module Aws::EMR
3111
3199
  # @return [String]
3112
3200
  #
3113
3201
  # @!attribute [rw] bid_price
3114
- # The bid price for each EC2 Spot Instance as defined by
3115
- # `InstanceType`. Expressed in USD. If neither `BidPrice` nor
3116
- # `BidPriceAsPercentageOfOnDemandPrice` is provided,
3117
- # `BidPriceAsPercentageOfOnDemandPrice` defaults to 100%.
3202
+ # If specified, indicates that the instance group uses Spot Instances.
3203
+ # This is the maximum price you are willing to pay for Spot Instances.
3204
+ # Specify `OnDemandPrice` to set the amount equal to the On-Demand
3205
+ # price, or specify an amount in USD.
3118
3206
  # @return [String]
3119
3207
  #
3120
3208
  # @!attribute [rw] instance_type
@@ -3183,10 +3271,10 @@ module Aws::EMR
3183
3271
  # @return [String]
3184
3272
  #
3185
3273
  # @!attribute [rw] bid_price
3186
- # The bid price for each EC2 Spot Instance as defined by
3187
- # `InstanceType`. Expressed in USD. If neither `BidPrice` nor
3188
- # `BidPriceAsPercentageOfOnDemandPrice` is provided,
3189
- # `BidPriceAsPercentageOfOnDemandPrice` defaults to 100%.
3274
+ # If specified, indicates that the instance group uses Spot Instances.
3275
+ # This is the maximum price you are willing to pay for Spot Instances.
3276
+ # Specify `OnDemandPrice` to set the amount equal to the On-Demand
3277
+ # price, or specify an amount in USD.
3190
3278
  # @return [String]
3191
3279
  #
3192
3280
  # @!attribute [rw] instance_type
@@ -3485,14 +3573,22 @@ module Aws::EMR
3485
3573
 
3486
3574
  # An instance type configuration for each instance type in an instance
3487
3575
  # fleet, which determines the EC2 instances Amazon EMR attempts to
3488
- # provision to fulfill On-Demand and Spot target capacities. There can
3489
- # be a maximum of five instance type configurations in a fleet.
3576
+ # provision to fulfill On-Demand and Spot target capacities. When you
3577
+ # use an allocation strategy, you can include a maximum of 30 instance
3578
+ # type configurations for a fleet. For more information about how to use
3579
+ # an allocation strategy, see [Configure Instance Fleets][1]. Without an
3580
+ # allocation strategy, you may specify a maximum of five instance type
3581
+ # configurations for a fleet.
3490
3582
  #
3491
3583
  # <note markdown="1"> The instance fleet configuration is available only in Amazon EMR
3492
3584
  # versions 4.8.0 and later, excluding 5.0.x versions.
3493
3585
  #
3494
3586
  # </note>
3495
3587
  #
3588
+ #
3589
+ #
3590
+ # [1]: https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-instance-fleet.html
3591
+ #
3496
3592
  # @note When making an API call, you may pass InstanceTypeConfig
3497
3593
  # data as a hash:
3498
3594
  #
@@ -3555,7 +3651,7 @@ module Aws::EMR
3555
3651
  # @return [Float]
3556
3652
  #
3557
3653
  # @!attribute [rw] ebs_configuration
3558
- # The configuration of Amazon Elastic Block Storage (Amazon EBS)
3654
+ # The configuration of Amazon Elastic Block Store (Amazon EBS)
3559
3655
  # attached to each instance as defined by `InstanceType`.
3560
3656
  # @return [Types::EbsConfiguration]
3561
3657
  #
@@ -3616,7 +3712,7 @@ module Aws::EMR
3616
3712
  # @return [Array<Types::Configuration>]
3617
3713
  #
3618
3714
  # @!attribute [rw] ebs_block_devices
3619
- # The configuration of Amazon Elastic Block Storage (Amazon EBS)
3715
+ # The configuration of Amazon Elastic Block Store (Amazon EBS)
3620
3716
  # attached to each instance as defined by `InstanceType`.
3621
3717
  # @return [Array<Types::EbsBlockDevice>]
3622
3718
  #
@@ -3695,9 +3791,8 @@ module Aws::EMR
3695
3791
  # @return [String]
3696
3792
  #
3697
3793
  # @!attribute [rw] log_encryption_kms_key_id
3698
- # The AWS KMS customer master key (CMK) used for encrypting log files.
3699
- # This attribute is only available with EMR version 5.30.0 and later,
3700
- # excluding EMR 6.0.0.
3794
+ # The KMS key used for encrypting log files. This attribute is only
3795
+ # available with EMR version 5.30.0 and later, excluding EMR 6.0.0.
3701
3796
  # @return [String]
3702
3797
  #
3703
3798
  # @!attribute [rw] ami_version
@@ -3729,15 +3824,26 @@ module Aws::EMR
3729
3824
  # @return [Array<String>]
3730
3825
  #
3731
3826
  # @!attribute [rw] visible_to_all_users
3732
- # Indicates whether the cluster is visible to all IAM users of the AWS
3733
- # account associated with the cluster. The default value, `true`,
3734
- # indicates that all IAM users in the AWS account can perform cluster
3735
- # actions if they have the proper IAM policy permissions. If this
3736
- # value is `false`, only the IAM user that created the cluster can
3737
- # perform actions. This value can be changed on a running cluster by
3738
- # using the SetVisibleToAllUsers action. You can override the default
3739
- # value of `true` when you create a cluster by using the
3740
- # `VisibleToAllUsers` parameter of the `RunJobFlow` action.
3827
+ # Indicates whether the cluster is visible to IAM principals in the
3828
+ # account associated with the cluster. When `true`, IAM principals in
3829
+ # the account can perform EMR cluster actions that their IAM policies
3830
+ # allow. When `false`, only the IAM principal that created the cluster
3831
+ # and the account root user can perform EMR actions, regardless of IAM
3832
+ # permissions policies attached to other IAM principals.
3833
+ #
3834
+ # The default value is `false` if a value is not provided when
3835
+ # creating a cluster using the EMR API RunJobFlow command or the CLI
3836
+ # [create-cluster][1] command. The default value is `true` when a
3837
+ # cluster is created using the Management Console. IAM principals that
3838
+ # are authorized to perform actions on the cluster can use the
3839
+ # SetVisibleToAllUsers action to change the value on a running
3840
+ # cluster. For more information, see [Understanding the EMR Cluster
3841
+ # VisibleToAllUsers Setting][2] in the *Amazon EMR Management Guide*.
3842
+ #
3843
+ #
3844
+ #
3845
+ # [1]: https://docs.aws.amazon.com/cli/latest/reference/emr/create-cluster.html
3846
+ # [2]: https://docs.aws.amazon.com/emr/latest/ManagementGuide/security_iam_emr-with-iam.html#security_set_visible_to_all_users
3741
3847
  # @return [Boolean]
3742
3848
  #
3743
3849
  # @!attribute [rw] job_flow_role
@@ -3746,8 +3852,8 @@ module Aws::EMR
3746
3852
  # @return [String]
3747
3853
  #
3748
3854
  # @!attribute [rw] service_role
3749
- # The IAM role that is assumed by the Amazon EMR service to access AWS
3750
- # resources on your behalf.
3855
+ # The IAM role that is assumed by the Amazon EMR service to access
3856
+ # Amazon Web Services resources on your behalf.
3751
3857
  # @return [String]
3752
3858
  #
3753
3859
  # @!attribute [rw] auto_scaling_role
@@ -3969,6 +4075,11 @@ module Aws::EMR
3969
4075
  # },
3970
4076
  # on_demand_specification: {
3971
4077
  # allocation_strategy: "lowest-price", # required, accepts lowest-price
4078
+ # capacity_reservation_options: {
4079
+ # usage_strategy: "use-capacity-reservations-first", # accepts use-capacity-reservations-first
4080
+ # capacity_reservation_preference: "open", # accepts open, none
4081
+ # capacity_reservation_resource_group_arn: "XmlStringMaxLen256",
4082
+ # },
3972
4083
  # },
3973
4084
  # },
3974
4085
  # },
@@ -4027,7 +4138,13 @@ module Aws::EMR
4027
4138
  #
4028
4139
  # @!attribute [rw] keep_job_flow_alive_when_no_steps
4029
4140
  # Specifies whether the cluster should remain available after
4030
- # completing all steps.
4141
+ # completing all steps. Defaults to `true`. For more information about
4142
+ # configuring cluster termination, see [Control Cluster
4143
+ # Termination][1] in the *EMR Management Guide*.
4144
+ #
4145
+ #
4146
+ #
4147
+ # [1]: https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html
4031
4148
  # @return [Boolean]
4032
4149
  #
4033
4150
  # @!attribute [rw] termination_protected
@@ -4068,11 +4185,14 @@ module Aws::EMR
4068
4185
  #
4069
4186
  # @!attribute [rw] emr_managed_master_security_group
4070
4187
  # The identifier of the Amazon EC2 security group for the master node.
4188
+ # If you specify `EmrManagedMasterSecurityGroup`, you must also
4189
+ # specify `EmrManagedSlaveSecurityGroup`.
4071
4190
  # @return [String]
4072
4191
  #
4073
4192
  # @!attribute [rw] emr_managed_slave_security_group
4074
4193
  # The identifier of the Amazon EC2 security group for the core and
4075
- # task nodes.
4194
+ # task nodes. If you specify `EmrManagedSlaveSecurityGroup`, you must
4195
+ # also specify `EmrManagedMasterSecurityGroup`.
4076
4196
  # @return [String]
4077
4197
  #
4078
4198
  # @!attribute [rw] service_access_security_group
@@ -4361,7 +4481,9 @@ module Aws::EMR
4361
4481
  # @return [Time]
4362
4482
  #
4363
4483
  # @!attribute [rw] cluster_states
4364
- # The cluster state filters to apply when listing clusters.
4484
+ # The cluster state filters to apply when listing clusters. Clusters
4485
+ # that change state while this action runs may be not be returned as
4486
+ # expected in the list of clusters.
4365
4487
  # @return [Array<String>]
4366
4488
  #
4367
4489
  # @!attribute [rw] marker
@@ -4669,6 +4791,67 @@ module Aws::EMR
4669
4791
  include Aws::Structure
4670
4792
  end
4671
4793
 
4794
+ # @note When making an API call, you may pass ListReleaseLabelsInput
4795
+ # data as a hash:
4796
+ #
4797
+ # {
4798
+ # filters: {
4799
+ # prefix: "String",
4800
+ # application: "String",
4801
+ # },
4802
+ # next_token: "String",
4803
+ # max_results: 1,
4804
+ # }
4805
+ #
4806
+ # @!attribute [rw] filters
4807
+ # Filters the results of the request. `Prefix` specifies the prefix of
4808
+ # release labels to return. `Application` specifies the application
4809
+ # (with/without version) of release labels to return.
4810
+ # @return [Types::ReleaseLabelFilter]
4811
+ #
4812
+ # @!attribute [rw] next_token
4813
+ # Specifies the next page of results. If `NextToken` is not specified,
4814
+ # which is usually the case for the first request of
4815
+ # ListReleaseLabels, the first page of results are determined by other
4816
+ # filtering parameters or by the latest version. The
4817
+ # `ListReleaseLabels` request fails if the identity (AWS AccountID)
4818
+ # and all filtering parameters are different from the original
4819
+ # request, or if the `NextToken` is expired or tampered with.
4820
+ # @return [String]
4821
+ #
4822
+ # @!attribute [rw] max_results
4823
+ # Defines the maximum number of release labels to return in a single
4824
+ # response. The default is `100`.
4825
+ # @return [Integer]
4826
+ #
4827
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ListReleaseLabelsInput AWS API Documentation
4828
+ #
4829
+ class ListReleaseLabelsInput < Struct.new(
4830
+ :filters,
4831
+ :next_token,
4832
+ :max_results)
4833
+ SENSITIVE = []
4834
+ include Aws::Structure
4835
+ end
4836
+
4837
+ # @!attribute [rw] release_labels
4838
+ # The returned release labels.
4839
+ # @return [Array<String>]
4840
+ #
4841
+ # @!attribute [rw] next_token
4842
+ # Used to paginate the next page of results if specified in the next
4843
+ # `ListReleaseLabels` request.
4844
+ # @return [String]
4845
+ #
4846
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ListReleaseLabelsOutput AWS API Documentation
4847
+ #
4848
+ class ListReleaseLabelsOutput < Struct.new(
4849
+ :release_labels,
4850
+ :next_token)
4851
+ SENSITIVE = []
4852
+ include Aws::Structure
4853
+ end
4854
+
4672
4855
  # @note When making an API call, you may pass ListSecurityConfigurationsInput
4673
4856
  # data as a hash:
4674
4857
  #
@@ -4735,8 +4918,10 @@ module Aws::EMR
4735
4918
  # @return [Array<String>]
4736
4919
  #
4737
4920
  # @!attribute [rw] marker
4738
- # The pagination token that indicates the next set of results to
4739
- # retrieve.
4921
+ # The maximum number of steps that a single `ListSteps` action returns
4922
+ # is 50. To return a longer list of steps, use multiple `ListSteps`
4923
+ # actions along with the `Marker` parameter, which is a pagination
4924
+ # token that indicates the next set of results to retrieve.
4740
4925
  # @return [String]
4741
4926
  #
4742
4927
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ListStepsInput AWS API Documentation
@@ -4758,8 +4943,10 @@ module Aws::EMR
4758
4943
  # @return [Array<Types::StepSummary>]
4759
4944
  #
4760
4945
  # @!attribute [rw] marker
4761
- # The pagination token that indicates the next set of results to
4762
- # retrieve.
4946
+ # The maximum number of steps that a single `ListSteps` action returns
4947
+ # is 50. To return a longer list of steps, use multiple `ListSteps`
4948
+ # actions along with the `Marker` parameter, which is a pagination
4949
+ # token that indicates the next set of results to retrieve.
4763
4950
  # @return [String]
4764
4951
  #
4765
4952
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ListStepsOutput AWS API Documentation
@@ -4939,7 +5126,10 @@ module Aws::EMR
4939
5126
  #
4940
5127
  # @!attribute [rw] step_concurrency_level
4941
5128
  # The number of steps that can be executed concurrently. You can
4942
- # specify a maximum of 256 steps.
5129
+ # specify a minimum of 1 step and a maximum of 256 steps. We recommend
5130
+ # that you do not change this parameter while steps are running or the
5131
+ # `ActionOnFailure` setting may not behave as expected. For more
5132
+ # information see Step$ActionOnFailure.
4943
5133
  # @return [Integer]
4944
5134
  #
4945
5135
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ModifyClusterInput AWS API Documentation
@@ -4980,7 +5170,7 @@ module Aws::EMR
4980
5170
  # @return [String]
4981
5171
  #
4982
5172
  # @!attribute [rw] instance_fleet
4983
- # The unique identifier of the instance fleet.
5173
+ # The configuration parameters of the instance fleet.
4984
5174
  # @return [Types::InstanceFleetModifyConfig]
4985
5175
  #
4986
5176
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ModifyInstanceFleetInput AWS API Documentation
@@ -5161,6 +5351,9 @@ module Aws::EMR
5161
5351
  include Aws::Structure
5162
5352
  end
5163
5353
 
5354
+ # Details for a notebook execution. The details include information such
5355
+ # as the unique ID and status of the notebook execution.
5356
+ #
5164
5357
  # @!attribute [rw] notebook_execution_id
5165
5358
  # The unique identifier of the notebook execution.
5166
5359
  # @return [String]
@@ -5229,6 +5422,63 @@ module Aws::EMR
5229
5422
  include Aws::Structure
5230
5423
  end
5231
5424
 
5425
+ # Describes the strategy for using unused Capacity Reservations for
5426
+ # fulfilling On-Demand capacity.
5427
+ #
5428
+ # @note When making an API call, you may pass OnDemandCapacityReservationOptions
5429
+ # data as a hash:
5430
+ #
5431
+ # {
5432
+ # usage_strategy: "use-capacity-reservations-first", # accepts use-capacity-reservations-first
5433
+ # capacity_reservation_preference: "open", # accepts open, none
5434
+ # capacity_reservation_resource_group_arn: "XmlStringMaxLen256",
5435
+ # }
5436
+ #
5437
+ # @!attribute [rw] usage_strategy
5438
+ # Indicates whether to use unused Capacity Reservations for fulfilling
5439
+ # On-Demand capacity.
5440
+ #
5441
+ # If you specify `use-capacity-reservations-first`, the fleet uses
5442
+ # unused Capacity Reservations to fulfill On-Demand capacity up to the
5443
+ # target On-Demand capacity. If multiple instance pools have unused
5444
+ # Capacity Reservations, the On-Demand allocation strategy
5445
+ # (`lowest-price`) is applied. If the number of unused Capacity
5446
+ # Reservations is less than the On-Demand target capacity, the
5447
+ # remaining On-Demand target capacity is launched according to the
5448
+ # On-Demand allocation strategy (`lowest-price`).
5449
+ #
5450
+ # If you do not specify a value, the fleet fulfills the On-Demand
5451
+ # capacity according to the chosen On-Demand allocation strategy.
5452
+ # @return [String]
5453
+ #
5454
+ # @!attribute [rw] capacity_reservation_preference
5455
+ # Indicates the instance's Capacity Reservation preferences. Possible
5456
+ # preferences include:
5457
+ #
5458
+ # * `open` - The instance can run in any open Capacity Reservation
5459
+ # that has matching attributes (instance type, platform,
5460
+ # Availability Zone).
5461
+ #
5462
+ # * `none` - The instance avoids running in a Capacity Reservation
5463
+ # even if one is available. The instance runs as an On-Demand
5464
+ # Instance.
5465
+ # @return [String]
5466
+ #
5467
+ # @!attribute [rw] capacity_reservation_resource_group_arn
5468
+ # The ARN of the Capacity Reservation resource group in which to run
5469
+ # the instance.
5470
+ # @return [String]
5471
+ #
5472
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/OnDemandCapacityReservationOptions AWS API Documentation
5473
+ #
5474
+ class OnDemandCapacityReservationOptions < Struct.new(
5475
+ :usage_strategy,
5476
+ :capacity_reservation_preference,
5477
+ :capacity_reservation_resource_group_arn)
5478
+ SENSITIVE = []
5479
+ include Aws::Structure
5480
+ end
5481
+
5232
5482
  # The launch specification for On-Demand Instances in the instance
5233
5483
  # fleet, which determines the allocation strategy.
5234
5484
  #
@@ -5244,18 +5494,29 @@ module Aws::EMR
5244
5494
  #
5245
5495
  # {
5246
5496
  # allocation_strategy: "lowest-price", # required, accepts lowest-price
5497
+ # capacity_reservation_options: {
5498
+ # usage_strategy: "use-capacity-reservations-first", # accepts use-capacity-reservations-first
5499
+ # capacity_reservation_preference: "open", # accepts open, none
5500
+ # capacity_reservation_resource_group_arn: "XmlStringMaxLen256",
5501
+ # },
5247
5502
  # }
5248
5503
  #
5249
5504
  # @!attribute [rw] allocation_strategy
5250
- # Specifies the strategy to use in launching On-Demand Instance
5251
- # fleets. Currently, the only option is lowest-price (the default),
5505
+ # Specifies the strategy to use in launching On-Demand instance
5506
+ # fleets. Currently, the only option is `lowest-price` (the default),
5252
5507
  # which launches the lowest price first.
5253
5508
  # @return [String]
5254
5509
  #
5510
+ # @!attribute [rw] capacity_reservation_options
5511
+ # The launch specification for On-Demand instances in the instance
5512
+ # fleet, which determines the allocation strategy.
5513
+ # @return [Types::OnDemandCapacityReservationOptions]
5514
+ #
5255
5515
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/OnDemandProvisioningSpecification AWS API Documentation
5256
5516
  #
5257
5517
  class OnDemandProvisioningSpecification < Struct.new(
5258
- :allocation_strategy)
5518
+ :allocation_strategy,
5519
+ :capacity_reservation_options)
5259
5520
  SENSITIVE = []
5260
5521
  include Aws::Structure
5261
5522
  end
@@ -5552,6 +5813,34 @@ module Aws::EMR
5552
5813
  #
5553
5814
  class PutManagedScalingPolicyOutput < Aws::EmptyStructure; end
5554
5815
 
5816
+ # The release label filters by application or version prefix.
5817
+ #
5818
+ # @note When making an API call, you may pass ReleaseLabelFilter
5819
+ # data as a hash:
5820
+ #
5821
+ # {
5822
+ # prefix: "String",
5823
+ # application: "String",
5824
+ # }
5825
+ #
5826
+ # @!attribute [rw] prefix
5827
+ # Optional release label version prefix filter. For example, `emr-5`.
5828
+ # @return [String]
5829
+ #
5830
+ # @!attribute [rw] application
5831
+ # Optional release label application filter. For example,
5832
+ # `spark@2.1.0`.
5833
+ # @return [String]
5834
+ #
5835
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ReleaseLabelFilter AWS API Documentation
5836
+ #
5837
+ class ReleaseLabelFilter < Struct.new(
5838
+ :prefix,
5839
+ :application)
5840
+ SENSITIVE = []
5841
+ include Aws::Structure
5842
+ end
5843
+
5555
5844
  # @note When making an API call, you may pass RemoveAutoScalingPolicyInput
5556
5845
  # data as a hash:
5557
5846
  #
@@ -5776,6 +6065,11 @@ module Aws::EMR
5776
6065
  # },
5777
6066
  # on_demand_specification: {
5778
6067
  # allocation_strategy: "lowest-price", # required, accepts lowest-price
6068
+ # capacity_reservation_options: {
6069
+ # usage_strategy: "use-capacity-reservations-first", # accepts use-capacity-reservations-first
6070
+ # capacity_reservation_preference: "open", # accepts open, none
6071
+ # capacity_reservation_resource_group_arn: "XmlStringMaxLen256",
6072
+ # },
5779
6073
  # },
5780
6074
  # },
5781
6075
  # },
@@ -5900,10 +6194,10 @@ module Aws::EMR
5900
6194
  # @return [String]
5901
6195
  #
5902
6196
  # @!attribute [rw] log_encryption_kms_key_id
5903
- # The AWS KMS customer master key (CMK) used for encrypting log files.
5904
- # If a value is not provided, the logs remain encrypted by AES-256.
5905
- # This attribute is only available with Amazon EMR version 5.30.0 and
5906
- # later, excluding Amazon EMR 6.0.0.
6197
+ # The KMS key used for encrypting log files. If a value is not
6198
+ # provided, the logs remain encrypted by AES-256. This attribute is
6199
+ # only available with Amazon EMR version 5.30.0 and later, excluding
6200
+ # Amazon EMR 6.0.0.
5907
6201
  # @return [String]
5908
6202
  #
5909
6203
  # @!attribute [rw] additional_info
@@ -6019,10 +6313,22 @@ module Aws::EMR
6019
6313
  # @return [Array<Types::Configuration>]
6020
6314
  #
6021
6315
  # @!attribute [rw] visible_to_all_users
6022
- # A value of `true` indicates that all IAM users in the AWS account
6023
- # can perform cluster actions if they have the proper IAM policy
6024
- # permissions. This is the default. A value of `false` indicates that
6025
- # only the IAM user who created the cluster can perform actions.
6316
+ # Set this value to `true` so that IAM principals in the account
6317
+ # associated with the cluster can perform EMR actions on the cluster
6318
+ # that their IAM policies allow. This value defaults to `false` for
6319
+ # clusters created using the EMR API or the CLI [create-cluster][1]
6320
+ # command.
6321
+ #
6322
+ # When set to `false`, only the IAM principal that created the cluster
6323
+ # and the account root user can perform EMR actions for the cluster,
6324
+ # regardless of the IAM permissions policies attached to other IAM
6325
+ # principals. For more information, see [Understanding the EMR Cluster
6326
+ # VisibleToAllUsers Setting][2] in the *Amazon EMR Management Guide*.
6327
+ #
6328
+ #
6329
+ #
6330
+ # [1]: https://docs.aws.amazon.com/cli/latest/reference/emr/create-cluster.html
6331
+ # [2]: https://docs.aws.amazon.com/emr/latest/ManagementGuide/security_iam_emr-with-iam.html#security_set_visible_to_all_users
6026
6332
  # @return [Boolean]
6027
6333
  #
6028
6334
  # @!attribute [rw] job_flow_role
@@ -6034,7 +6340,7 @@ module Aws::EMR
6034
6340
  #
6035
6341
  # @!attribute [rw] service_role
6036
6342
  # The IAM role that will be assumed by the Amazon EMR service to
6037
- # access AWS resources on your behalf.
6343
+ # access Amazon Web Services resources on your behalf.
6038
6344
  # @return [String]
6039
6345
  #
6040
6346
  # @!attribute [rw] tags
@@ -6371,8 +6677,8 @@ module Aws::EMR
6371
6677
  # }
6372
6678
  #
6373
6679
  # @!attribute [rw] path
6374
- # Location of the script to run during a bootstrap action. Can be
6375
- # either a location in Amazon S3 or on a local file system.
6680
+ # Location in Amazon S3 of the script to run during a bootstrap
6681
+ # action.
6376
6682
  # @return [String]
6377
6683
  #
6378
6684
  # @!attribute [rw] args
@@ -6421,8 +6727,8 @@ module Aws::EMR
6421
6727
  #
6422
6728
  # @!attribute [rw] identity_name
6423
6729
  # The name of the user or group. For more information, see
6424
- # [UserName][1] and [DisplayName][2] in the *AWS SSO Identity Store
6425
- # API Reference*.
6730
+ # [UserName][1] and [DisplayName][2] in the *Amazon Web Services SSO
6731
+ # Identity Store API Reference*.
6426
6732
  #
6427
6733
  #
6428
6734
  #
@@ -6471,13 +6777,13 @@ module Aws::EMR
6471
6777
  #
6472
6778
  # @!attribute [rw] identity_id
6473
6779
  # The globally unique identifier (GUID) of the user or group from the
6474
- # AWS SSO Identity Store.
6780
+ # Amazon Web Services SSO Identity Store.
6475
6781
  # @return [String]
6476
6782
  #
6477
6783
  # @!attribute [rw] identity_name
6478
6784
  # The name of the user or group. For more information, see
6479
- # [UserName][1] and [DisplayName][2] in the *AWS SSO Identity Store
6480
- # API Reference*.
6785
+ # [UserName][1] and [DisplayName][2] in the *Amazon Web Services SSO
6786
+ # Identity Store API Reference*.
6481
6787
  #
6482
6788
  #
6483
6789
  #
@@ -6558,10 +6864,11 @@ module Aws::EMR
6558
6864
  # @return [Array<String>]
6559
6865
  #
6560
6866
  # @!attribute [rw] visible_to_all_users
6561
- # A value of `true` indicates that all IAM users in the AWS account
6562
- # can perform cluster actions if they have the proper IAM policy
6563
- # permissions. This is the default. A value of `false` indicates that
6564
- # only the IAM user who created the cluster can perform actions.
6867
+ # A value of `true` indicates that an IAM principal in the account can
6868
+ # perform EMR actions on the cluster that the IAM policies attached to
6869
+ # the principal allow. A value of `false` indicates that only the IAM
6870
+ # principal that created the cluster and the Amazon Web Services root
6871
+ # user can perform EMR actions on the cluster.
6565
6872
  # @return [Boolean]
6566
6873
  #
6567
6874
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/SetVisibleToAllUsersInput AWS API Documentation
@@ -6664,6 +6971,26 @@ module Aws::EMR
6664
6971
  include Aws::Structure
6665
6972
  end
6666
6973
 
6974
+ # The returned release label application names or versions.
6975
+ #
6976
+ # @!attribute [rw] name
6977
+ # The returned release label application name. For example, `hadoop`.
6978
+ # @return [String]
6979
+ #
6980
+ # @!attribute [rw] version
6981
+ # The returned release label application version. For example,
6982
+ # `3.2.1`.
6983
+ # @return [String]
6984
+ #
6985
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/SimplifiedApplication AWS API Documentation
6986
+ #
6987
+ class SimplifiedApplication < Struct.new(
6988
+ :name,
6989
+ :version)
6990
+ SENSITIVE = []
6991
+ include Aws::Structure
6992
+ end
6993
+
6667
6994
  # The launch specification for Spot Instances in the instance fleet,
6668
6995
  # which determines the defined duration, provisioning timeout behavior,
6669
6996
  # and allocation strategy.
@@ -6847,9 +7174,22 @@ module Aws::EMR
6847
7174
  #
6848
7175
  # @!attribute [rw] action_on_failure
6849
7176
  # The action to take when the cluster step fails. Possible values are
6850
- # TERMINATE\_CLUSTER, CANCEL\_AND\_WAIT, and CONTINUE.
6851
- # TERMINATE\_JOB\_FLOW is provided for backward compatibility. We
6852
- # recommend using TERMINATE\_CLUSTER instead.
7177
+ # `TERMINATE_CLUSTER`, `CANCEL_AND_WAIT`, and `CONTINUE`.
7178
+ # `TERMINATE_JOB_FLOW` is provided for backward compatibility. We
7179
+ # recommend using `TERMINATE_CLUSTER` instead.
7180
+ #
7181
+ # If a cluster's `StepConcurrencyLevel` is greater than `1`, do not
7182
+ # use `AddJobFlowSteps` to submit a step with this parameter set to
7183
+ # `CANCEL_AND_WAIT` or `TERMINATE_CLUSTER`. The step is not submitted
7184
+ # and the action fails with a message that the `ActionOnFailure`
7185
+ # setting is not valid.
7186
+ #
7187
+ # If you change a cluster's `StepConcurrencyLevel` to be greater than
7188
+ # 1 while a step is running, the `ActionOnFailure` parameter may not
7189
+ # behave as you expect. In this case, for a step that fails with this
7190
+ # parameter set to `CANCEL_AND_WAIT`, pending steps and the running
7191
+ # step are not canceled; for a step that fails with this parameter set
7192
+ # to `TERMINATE_CLUSTER`, the cluster does not terminate.
6853
7193
  # @return [String]
6854
7194
  #
6855
7195
  # @!attribute [rw] status
@@ -6868,7 +7208,7 @@ module Aws::EMR
6868
7208
  include Aws::Structure
6869
7209
  end
6870
7210
 
6871
- # Specification of a cluster (job flow) step.
7211
+ # Specification for a cluster (job flow) step.
6872
7212
  #
6873
7213
  # @note When making an API call, you may pass StepConfig
6874
7214
  # data as a hash:
@@ -6894,10 +7234,32 @@ module Aws::EMR
6894
7234
  # @return [String]
6895
7235
  #
6896
7236
  # @!attribute [rw] action_on_failure
6897
- # The action to take when the cluster step fails. Possible values are
6898
- # TERMINATE\_CLUSTER, CANCEL\_AND\_WAIT, and CONTINUE.
6899
- # TERMINATE\_JOB\_FLOW is provided for backward compatibility. We
6900
- # recommend using TERMINATE\_CLUSTER instead.
7237
+ # The action to take when the step fails. Use one of the following
7238
+ # values:
7239
+ #
7240
+ # * `TERMINATE_CLUSTER` - Shuts down the cluster.
7241
+ #
7242
+ # * `CANCEL_AND_WAIT` - Cancels any pending steps and returns the
7243
+ # cluster to the `WAITING` state.
7244
+ #
7245
+ # * `CONTINUE` - Continues to the next step in the queue.
7246
+ #
7247
+ # * `TERMINATE_JOB_FLOW` - Shuts down the cluster.
7248
+ # `TERMINATE_JOB_FLOW` is provided for backward compatibility. We
7249
+ # recommend using `TERMINATE_CLUSTER` instead.
7250
+ #
7251
+ # If a cluster's `StepConcurrencyLevel` is greater than `1`, do not
7252
+ # use `AddJobFlowSteps` to submit a step with this parameter set to
7253
+ # `CANCEL_AND_WAIT` or `TERMINATE_CLUSTER`. The step is not submitted
7254
+ # and the action fails with a message that the `ActionOnFailure`
7255
+ # setting is not valid.
7256
+ #
7257
+ # If you change a cluster's `StepConcurrencyLevel` to be greater than
7258
+ # 1 while a step is running, the `ActionOnFailure` parameter may not
7259
+ # behave as you expect. In this case, for a step that fails with this
7260
+ # parameter set to `CANCEL_AND_WAIT`, pending steps and the running
7261
+ # step are not canceled; for a step that fails with this parameter set
7262
+ # to `TERMINATE_CLUSTER`, the cluster does not terminate.
6901
7263
  # @return [String]
6902
7264
  #
6903
7265
  # @!attribute [rw] hadoop_jar_step
@@ -7034,8 +7396,7 @@ module Aws::EMR
7034
7396
  # @!attribute [rw] action_on_failure
7035
7397
  # The action to take when the cluster step fails. Possible values are
7036
7398
  # TERMINATE\_CLUSTER, CANCEL\_AND\_WAIT, and CONTINUE.
7037
- # TERMINATE\_JOB\_FLOW is available for backward compatibility. We
7038
- # recommend using TERMINATE\_CLUSTER instead.
7399
+ # TERMINATE\_JOB\_FLOW is available for backward compatibility.
7039
7400
  # @return [String]
7040
7401
  #
7041
7402
  # @!attribute [rw] status
@@ -7162,8 +7523,8 @@ module Aws::EMR
7162
7523
  # @return [Time]
7163
7524
  #
7164
7525
  # @!attribute [rw] default_s3_location
7165
- # The default Amazon S3 location to back up Amazon EMR Studio
7166
- # Workspaces and notebook files.
7526
+ # The Amazon S3 location to back up Amazon EMR Studio Workspaces and
7527
+ # notebook files.
7167
7528
  # @return [String]
7168
7529
  #
7169
7530
  # @!attribute [rw] tags
@@ -7361,9 +7722,8 @@ module Aws::EMR
7361
7722
  # @return [Array<String>]
7362
7723
  #
7363
7724
  # @!attribute [rw] default_s3_location
7364
- # A default Amazon S3 location to back up Workspaces and notebook
7365
- # files for the Amazon EMR Studio. A Studio user can select an
7366
- # alternative Amazon S3 location when creating a Workspace.
7725
+ # The Amazon S3 location to back up Workspaces and notebook files for
7726
+ # the Amazon EMR Studio.
7367
7727
  # @return [String]
7368
7728
  #
7369
7729
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/UpdateStudioInput AWS API Documentation
@@ -7395,9 +7755,9 @@ module Aws::EMR
7395
7755
  #
7396
7756
  # @!attribute [rw] identity_id
7397
7757
  # The globally unique identifier (GUID) of the user or group. For more
7398
- # information, see [UserId][1] and [GroupId][2] in the *AWS SSO
7399
- # Identity Store API Reference*. Either `IdentityName` or `IdentityId`
7400
- # must be specified.
7758
+ # information, see [UserId][1] and [GroupId][2] in the *Amazon Web
7759
+ # Services SSO Identity Store API Reference*. Either `IdentityName` or
7760
+ # `IdentityId` must be specified.
7401
7761
  #
7402
7762
  #
7403
7763
  #
@@ -7407,9 +7767,9 @@ module Aws::EMR
7407
7767
  #
7408
7768
  # @!attribute [rw] identity_name
7409
7769
  # The name of the user or group to update. For more information, see
7410
- # [UserName][1] and [DisplayName][2] in the *AWS SSO Identity Store
7411
- # API Reference*. Either `IdentityName` or `IdentityId` must be
7412
- # specified.
7770
+ # [UserName][1] and [DisplayName][2] in the *Amazon Web Services SSO
7771
+ # Identity Store API Reference*. Either `IdentityName` or `IdentityId`
7772
+ # must be specified.
7413
7773
  #
7414
7774
  #
7415
7775
  #