From 26d64847dea36f6ba6d6d6e221f91205e151add4 Mon Sep 17 00:00:00 2001 From: aws-sdk-go-automation <43143561+aws-sdk-go-automation@users.noreply.github.com> Date: Thu, 15 Sep 2022 11:28:16 -0700 Subject: [PATCH] Release v1.44.99 (2022-09-15) (#4559) Release v1.44.99 (2022-09-15) === ### Service Client Updates * `service/dynamodb`: Updates service API, documentation, waiters, paginators, and examples * Increased DynamoDB transaction limit from 25 to 100. * `service/ec2`: Updates service API and documentation * This feature allows customers to create tags for vpc-endpoint-connections and vpc-endpoint-service-permissions. * `service/sagemaker`: Updates service API and documentation * Amazon SageMaker Automatic Model Tuning now supports specifying Hyperband strategy for tuning jobs, which uses a multi-fidelity based tuning strategy to stop underperforming hyperparameter configurations early. --- CHANGELOG.md | 11 ++ aws/endpoints/defaults.go | 79 ++++++++ aws/version.go | 2 +- models/apis/dynamodb/2012-08-10/api-2.json | 10 +- models/apis/dynamodb/2012-08-10/docs-2.json | 10 +- models/apis/ec2/2016-11-15/api-2.json | 54 ++++++ models/apis/ec2/2016-11-15/docs-2.json | 23 ++- models/apis/sagemaker/2017-07-24/api-2.json | 27 ++- models/apis/sagemaker/2017-07-24/docs-2.json | 40 +++- models/endpoints/endpoints.json | 49 +++++ service/dynamodb/api.go | 10 +- service/ec2/api.go | 121 ++++++++++++ service/sagemaker/api.go | 190 +++++++++++++++++-- 13 files changed, 584 insertions(+), 42 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index f52d1d90d61..4ce8fe8b40d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,14 @@ +Release v1.44.99 (2022-09-15) +=== + +### Service Client Updates +* `service/dynamodb`: Updates service API, documentation, waiters, paginators, and examples + * Increased DynamoDB transaction limit from 25 to 100. +* `service/ec2`: Updates service API and documentation + * This feature allows customers to create tags for vpc-endpoint-connections and vpc-endpoint-service-permissions. +* `service/sagemaker`: Updates service API and documentation + * Amazon SageMaker Automatic Model Tuning now supports specifying Hyperband strategy for tuning jobs, which uses a multi-fidelity based tuning strategy to stop underperforming hyperparameter configurations early. + Release v1.44.98 (2022-09-14) === diff --git a/aws/endpoints/defaults.go b/aws/endpoints/defaults.go index 10fd3fc5e4f..4df415be5d5 100644 --- a/aws/endpoints/defaults.go +++ b/aws/endpoints/defaults.go @@ -16671,6 +16671,70 @@ var awsPartition = partition{ }, }, }, + "participant.connect": service{ + Endpoints: serviceEndpoints{ + endpointKey{ + Region: "af-south-1", + }: endpoint{}, + endpointKey{ + Region: "ap-northeast-1", + }: endpoint{}, + endpointKey{ + Region: "ap-northeast-2", + }: endpoint{}, + endpointKey{ + Region: "ap-southeast-1", + }: endpoint{}, + endpointKey{ + Region: "ap-southeast-2", + }: endpoint{}, + endpointKey{ + Region: "ca-central-1", + }: endpoint{}, + endpointKey{ + Region: "eu-central-1", + }: endpoint{}, + endpointKey{ + Region: "eu-west-2", + }: endpoint{}, + endpointKey{ + Region: "fips-us-east-1", + }: endpoint{ + Hostname: "participant.connect-fips.us-east-1.amazonaws.com", + CredentialScope: credentialScope{ + Region: "us-east-1", + }, + Deprecated: boxedTrue, + }, + endpointKey{ + Region: "fips-us-west-2", + }: endpoint{ + Hostname: "participant.connect-fips.us-west-2.amazonaws.com", + CredentialScope: credentialScope{ + Region: "us-west-2", + }, + Deprecated: boxedTrue, + }, + endpointKey{ + Region: "us-east-1", + }: endpoint{}, + endpointKey{ + Region: "us-east-1", + Variant: fipsVariant, + }: endpoint{ + Hostname: "participant.connect-fips.us-east-1.amazonaws.com", + }, + endpointKey{ + Region: "us-west-2", + }: endpoint{}, + endpointKey{ + Region: "us-west-2", + Variant: fipsVariant, + }: endpoint{ + Hostname: "participant.connect-fips.us-west-2.amazonaws.com", + }, + }, + }, "personalize": service{ Endpoints: serviceEndpoints{ endpointKey{ @@ -21542,6 +21606,9 @@ var awsPartition = partition{ }: endpoint{ Hostname: "snowball-fips.ap-southeast-2.amazonaws.com", }, + endpointKey{ + Region: "ap-southeast-3", + }: endpoint{}, endpointKey{ Region: "ca-central-1", }: endpoint{}, @@ -30507,6 +30574,18 @@ var awsusgovPartition = partition{ }, }, }, + "participant.connect": service{ + Endpoints: serviceEndpoints{ + endpointKey{ + Region: "us-gov-west-1", + }: endpoint{ + Hostname: "participant.connect.us-gov-west-1.amazonaws.com", + CredentialScope: credentialScope{ + Region: "us-gov-west-1", + }, + }, + }, + }, "pinpoint": service{ Defaults: endpointDefaults{ defaultKey{}: endpoint{ diff --git a/aws/version.go b/aws/version.go index 29c8fb9aa33..517eae5d9ef 100644 --- a/aws/version.go +++ b/aws/version.go @@ -5,4 +5,4 @@ package aws const SDKName = "aws-sdk-go" // SDKVersion is the version of this SDK -const SDKVersion = "1.44.98" +const SDKVersion = "1.44.99" diff --git a/models/apis/dynamodb/2012-08-10/api-2.json b/models/apis/dynamodb/2012-08-10/api-2.json index 80198ffb59b..27396fce35a 100644 --- a/models/apis/dynamodb/2012-08-10/api-2.json +++ b/models/apis/dynamodb/2012-08-10/api-2.json @@ -1260,7 +1260,7 @@ "CancellationReasonList":{ "type":"list", "member":{"shape":"CancellationReason"}, - "max":25, + "max":100, "min":1 }, "Capacity":{ @@ -2436,7 +2436,7 @@ "ItemResponseList":{ "type":"list", "member":{"shape":"ItemResponse"}, - "max":25, + "max":100, "min":1 }, "KMSMasterKeyArn":{"type":"string"}, @@ -2750,7 +2750,7 @@ "ParameterizedStatements":{ "type":"list", "member":{"shape":"ParameterizedStatement"}, - "max":25, + "max":100, "min":1 }, "PartiQLBatchRequest":{ @@ -3689,7 +3689,7 @@ "TransactGetItemList":{ "type":"list", "member":{"shape":"TransactGetItem"}, - "max":25, + "max":100, "min":1 }, "TransactGetItemsInput":{ @@ -3719,7 +3719,7 @@ "TransactWriteItemList":{ "type":"list", "member":{"shape":"TransactWriteItem"}, - "max":25, + "max":100, "min":1 }, "TransactWriteItemsInput":{ diff --git a/models/apis/dynamodb/2012-08-10/docs-2.json b/models/apis/dynamodb/2012-08-10/docs-2.json index 2d23bc851f0..f9a908a3647 100644 --- a/models/apis/dynamodb/2012-08-10/docs-2.json +++ b/models/apis/dynamodb/2012-08-10/docs-2.json @@ -44,8 +44,8 @@ "RestoreTableToPointInTime": "

Restores the specified table to the specified point in time within EarliestRestorableDateTime and LatestRestorableDateTime. You can restore your table to any point in time during the last 35 days. Any number of users can execute up to 4 concurrent restores (any type of restore) in a given account.

When you restore using point in time recovery, DynamoDB restores your table data to the state based on the selected date and time (day:hour:minute:second) to a new table.

Along with data, the following are also included on the new restored table using point in time recovery:

You must manually set up the following on the restored table:

", "Scan": "

The Scan operation returns one or more items and item attributes by accessing every item in a table or a secondary index. To have DynamoDB return fewer items, you can provide a FilterExpression operation.

If the total number of scanned items exceeds the maximum dataset size limit of 1 MB, the scan stops and results are returned to the user as a LastEvaluatedKey value to continue the scan in a subsequent operation. The results also include the number of items exceeding the limit. A scan can result in no table data meeting the filter criteria.

A single Scan operation reads up to the maximum number of items set (if using the Limit parameter) or a maximum of 1 MB of data and then apply any filtering to the results using FilterExpression. If LastEvaluatedKey is present in the response, you need to paginate the result set. For more information, see Paginating the Results in the Amazon DynamoDB Developer Guide.

Scan operations proceed sequentially; however, for faster performance on a large table or secondary index, applications can request a parallel Scan operation by providing the Segment and TotalSegments parameters. For more information, see Parallel Scan in the Amazon DynamoDB Developer Guide.

Scan uses eventually consistent reads when accessing the data in a table; therefore, the result set might not include the changes to data in the table immediately before the operation began. If you need a consistent copy of the data, as of the time that the Scan begins, you can set the ConsistentRead parameter to true.

", "TagResource": "

Associate a set of tags with an Amazon DynamoDB resource. You can then activate these user-defined tags so that they appear on the Billing and Cost Management console for cost allocation tracking. You can call TagResource up to five times per second, per account.

For an overview on tagging DynamoDB resources, see Tagging for DynamoDB in the Amazon DynamoDB Developer Guide.

", - "TransactGetItems": "

TransactGetItems is a synchronous operation that atomically retrieves multiple items from one or more tables (but not from indexes) in a single account and Region. A TransactGetItems call can contain up to 25 TransactGetItem objects, each of which contains a Get structure that specifies an item to retrieve from a table in the account and Region. A call to TransactGetItems cannot retrieve items from tables in more than one Amazon Web Services account or Region. The aggregate size of the items in the transaction cannot exceed 4 MB.

DynamoDB rejects the entire TransactGetItems request if any of the following is true:

", - "TransactWriteItems": "

TransactWriteItems is a synchronous write operation that groups up to 25 action requests. These actions can target items in different tables, but not in different Amazon Web Services accounts or Regions, and no two actions can target the same item. For example, you cannot both ConditionCheck and Update the same item. The aggregate size of the items in the transaction cannot exceed 4 MB.

The actions are completed atomically so that either all of them succeed, or all of them fail. They are defined by the following objects:

DynamoDB rejects the entire TransactWriteItems request if any of the following is true:

", + "TransactGetItems": "

TransactGetItems is a synchronous operation that atomically retrieves multiple items from one or more tables (but not from indexes) in a single account and Region. A TransactGetItems call can contain up to 100 TransactGetItem objects, each of which contains a Get structure that specifies an item to retrieve from a table in the account and Region. A call to TransactGetItems cannot retrieve items from tables in more than one Amazon Web Services account or Region. The aggregate size of the items in the transaction cannot exceed 4 MB.

DynamoDB rejects the entire TransactGetItems request if any of the following is true:

", + "TransactWriteItems": "

TransactWriteItems is a synchronous write operation that groups up to 100 action requests. These actions can target items in different tables, but not in different Amazon Web Services accounts or Regions, and no two actions can target the same item. For example, you cannot both ConditionCheck and Update the same item. The aggregate size of the items in the transaction cannot exceed 4 MB.

The actions are completed atomically so that either all of them succeed, or all of them fail. They are defined by the following objects:

DynamoDB rejects the entire TransactWriteItems request if any of the following is true:

", "UntagResource": "

Removes the association of tags from an Amazon DynamoDB resource. You can call UntagResource up to five times per second, per account.

For an overview on tagging DynamoDB resources, see Tagging for DynamoDB in the Amazon DynamoDB Developer Guide.

", "UpdateContinuousBackups": "

UpdateContinuousBackups enables or disables point in time recovery for the specified table. A successful UpdateContinuousBackups call returns the current ContinuousBackupsDescription. Continuous backups are ENABLED on all tables at table creation. If point in time recovery is enabled, PointInTimeRecoveryStatus will be set to ENABLED.

Once continuous backups and point in time recovery are enabled, you can restore to any point in time within EarliestRestorableDateTime and LatestRestorableDateTime.

LatestRestorableDateTime is typically 5 minutes before the current time. You can restore your table to any point in time during the last 35 days.

", "UpdateContributorInsights": "

Updates the status for contributor insights for a specific table or index. CloudWatch Contributor Insights for DynamoDB graphs display the partition key and (if applicable) sort key of frequently accessed items and frequently throttled items in plaintext. If you require the use of Amazon Web Services Key Management Service (KMS) to encrypt this table’s partition key and sort key data with an Amazon Web Services managed key or customer managed key, you should not enable CloudWatch Contributor Insights for DynamoDB for this table.

", @@ -1620,7 +1620,7 @@ "base": null, "refs": { "ExecuteTransactionOutput$Responses": "

The response to a PartiQL transaction.

", - "TransactGetItemsOutput$Responses": "

An ordered array of up to 25 ItemResponse objects, each of which corresponds to the TransactGetItem object in the same position in the TransactItems array. Each ItemResponse object contains a Map of the name-value pairs that are the projected attributes of the requested item.

If a requested item could not be retrieved, the corresponding ItemResponse object is Null, or if the requested item has no projected attributes, the corresponding ItemResponse object is an empty Map.

" + "TransactGetItemsOutput$Responses": "

An ordered array of up to 100 ItemResponse objects, each of which corresponds to the TransactGetItem object in the same position in the TransactItems array. Each ItemResponse object contains a Map of the name-value pairs that are the projected attributes of the requested item.

If a requested item could not be retrieved, the corresponding ItemResponse object is Null, or if the requested item has no projected attributes, the corresponding ItemResponse object is an empty Map.

" } }, "KMSMasterKeyArn": { @@ -2942,7 +2942,7 @@ "TransactGetItemList": { "base": null, "refs": { - "TransactGetItemsInput$TransactItems": "

An ordered array of up to 25 TransactGetItem objects, each of which contains a Get structure.

" + "TransactGetItemsInput$TransactItems": "

An ordered array of up to 100 TransactGetItem objects, each of which contains a Get structure.

" } }, "TransactGetItemsInput": { @@ -2964,7 +2964,7 @@ "TransactWriteItemList": { "base": null, "refs": { - "TransactWriteItemsInput$TransactItems": "

An ordered array of up to 25 TransactWriteItem objects, each of which contains a ConditionCheck, Put, Update, or Delete object. These can operate on items in different tables, but the tables must reside in the same Amazon Web Services account and Region, and no two of them can operate on the same item.

" + "TransactWriteItemsInput$TransactItems": "

An ordered array of up to 100 TransactWriteItem objects, each of which contains a ConditionCheck, Put, Update, or Delete object. These can operate on items in different tables, but the tables must reside in the same Amazon Web Services account and Region, and no two of them can operate on the same item.

" } }, "TransactWriteItemsInput": { diff --git a/models/apis/ec2/2016-11-15/api-2.json b/models/apis/ec2/2016-11-15/api-2.json index 88348349e71..9800fe8a343 100755 --- a/models/apis/ec2/2016-11-15/api-2.json +++ b/models/apis/ec2/2016-11-15/api-2.json @@ -5233,6 +5233,34 @@ "Description":{"shape":"String"} } }, + "AddedPrincipal":{ + "type":"structure", + "members":{ + "PrincipalType":{ + "shape":"PrincipalType", + "locationName":"principalType" + }, + "Principal":{ + "shape":"String", + "locationName":"principal" + }, + "ServicePermissionId":{ + "shape":"String", + "locationName":"servicePermissionId" + }, + "ServiceId":{ + "shape":"String", + "locationName":"serviceId" + } + } + }, + "AddedPrincipalSet":{ + "type":"list", + "member":{ + "shape":"AddedPrincipal", + "locationName":"item" + } + }, "AdditionalDetail":{ "type":"structure", "members":{ @@ -5563,6 +5591,18 @@ "Principal":{ "shape":"String", "locationName":"principal" + }, + "ServicePermissionId":{ + "shape":"String", + "locationName":"servicePermissionId" + }, + "Tags":{ + "shape":"TagList", + "locationName":"tagSet" + }, + "ServiceId":{ + "shape":"String", + "locationName":"serviceId" } } }, @@ -29176,6 +29216,10 @@ "ModifyVpcEndpointServicePermissionsResult":{ "type":"structure", "members":{ + "AddedPrincipals":{ + "shape":"AddedPrincipalSet", + "locationName":"addedPrincipalSet" + }, "ReturnValue":{ "shape":"Boolean", "locationName":"return" @@ -33708,7 +33752,9 @@ "volume", "vpc", "vpc-endpoint", + "vpc-endpoint-connection", "vpc-endpoint-service", + "vpc-endpoint-service-permission", "vpc-peering-connection", "vpn-connection", "vpn-gateway", @@ -40406,6 +40452,14 @@ "IpAddressType":{ "shape":"IpAddressType", "locationName":"ipAddressType" + }, + "VpcEndpointConnectionId":{ + "shape":"String", + "locationName":"vpcEndpointConnectionId" + }, + "Tags":{ + "shape":"TagList", + "locationName":"tagSet" } } }, diff --git a/models/apis/ec2/2016-11-15/docs-2.json b/models/apis/ec2/2016-11-15/docs-2.json index 060e5adf7db..4f6e0c42004 100755 --- a/models/apis/ec2/2016-11-15/docs-2.json +++ b/models/apis/ec2/2016-11-15/docs-2.json @@ -788,6 +788,18 @@ "AddPrefixListEntries$member": null } }, + "AddedPrincipal": { + "base": "

Describes a principal.

", + "refs": { + "AddedPrincipalSet$member": null + } + }, + "AddedPrincipalSet": { + "base": null, + "refs": { + "ModifyVpcEndpointServicePermissionsResult$AddedPrincipals": "

Information about the added principals.

" + } + }, "AdditionalDetail": { "base": "

Describes an additional detail for a path analysis.

", "refs": { @@ -14487,6 +14499,7 @@ "PrincipalType": { "base": null, "refs": { + "AddedPrincipal$PrincipalType": "

The type of principal.

", "AllowedPrincipal$PrincipalType": "

The type of principal.

" } }, @@ -14499,7 +14512,7 @@ "PrivateDnsDetailsSet": { "base": null, "refs": { - "ServiceDetail$PrivateDnsNames": "

The private DNS names assigned to the VPC endpoint service.

" + "ServiceDetail$PrivateDnsNames": "

The private DNS names assigned to the VPC endpoint service.

" } }, "PrivateDnsNameConfiguration": { @@ -16716,6 +16729,9 @@ "AddIpamOperatingRegion$RegionName": "

The name of the operating Region.

", "AddPrefixListEntry$Cidr": "

The CIDR block.

", "AddPrefixListEntry$Description": "

A description for the entry.

Constraints: Up to 255 characters in length.

", + "AddedPrincipal$Principal": "

The Amazon Resource Name (ARN) of the principal.

", + "AddedPrincipal$ServicePermissionId": "

The ID of the service permission.

", + "AddedPrincipal$ServiceId": "

The ID of the service.

", "AdditionalDetail$AdditionalDetailType": "

The information type.

", "Address$InstanceId": "

The ID of the instance that the address is associated with (if any).

", "Address$PublicIp": "

The Elastic IP address.

", @@ -16749,6 +16765,8 @@ "AllocateIpamPoolCidrRequest$ClientToken": "

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.

", "AllocateIpamPoolCidrRequest$Description": "

A description for the allocation.

", "AllowedPrincipal$Principal": "

The Amazon Resource Name (ARN) of the principal.

", + "AllowedPrincipal$ServicePermissionId": "

The ID of the service permission.

", + "AllowedPrincipal$ServiceId": "

The ID of the service.

", "AlternatePathHint$ComponentId": "

The ID of the component.

", "AlternatePathHint$ComponentArn": "

The Amazon Resource Name (ARN) of the component.

", "AnalysisAclRule$Cidr": "

The IPv4 address range, in CIDR notation.

", @@ -18527,6 +18545,7 @@ "VpcEndpointConnection$ServiceId": "

The ID of the service to which the endpoint is connected.

", "VpcEndpointConnection$VpcEndpointId": "

The ID of the VPC endpoint.

", "VpcEndpointConnection$VpcEndpointOwner": "

The ID of the Amazon Web Services account that owns the VPC endpoint.

", + "VpcEndpointConnection$VpcEndpointConnectionId": "

The ID of the VPC endpoint connection.

", "VpcIpv6CidrBlockAssociation$AssociationId": "

The association ID for the IPv6 CIDR block.

", "VpcIpv6CidrBlockAssociation$Ipv6CidrBlock": "

The IPv6 CIDR block.

", "VpcIpv6CidrBlockAssociation$NetworkBorderGroup": "

The name of the unique set of Availability Zones, Local Zones, or Wavelength Zones from which Amazon Web Services advertises IP addresses, for example, us-east-1-wl1-bos-wlz-1.

", @@ -18776,6 +18795,7 @@ "base": null, "refs": { "Address$Tags": "

Any tags assigned to the Elastic IP address.

", + "AllowedPrincipal$Tags": "

The tags.

", "CapacityReservation$Tags": "

Any tags assigned to the Capacity Reservation.

", "CapacityReservationFleet$Tags": "

The tags assigned to the Capacity Reservation Fleet.

", "CarrierGateway$Tags": "

The tags assigned to the carrier gateway.

", @@ -18872,6 +18892,7 @@ "Vpc$Tags": "

Any tags assigned to the VPC.

", "VpcClassicLink$Tags": "

Any tags assigned to the VPC.

", "VpcEndpoint$Tags": "

Any tags assigned to the endpoint.

", + "VpcEndpointConnection$Tags": "

The tags.

", "VpcPeeringConnection$Tags": "

Any tags assigned to the resource.

", "VpnConnection$Tags": "

Any tags assigned to the VPN connection.

", "VpnGateway$Tags": "

Any tags assigned to the virtual private gateway.

" diff --git a/models/apis/sagemaker/2017-07-24/api-2.json b/models/apis/sagemaker/2017-07-24/api-2.json index e3646822a41..774cf7b598f 100644 --- a/models/apis/sagemaker/2017-07-24/api-2.json +++ b/models/apis/sagemaker/2017-07-24/api-2.json @@ -9691,6 +9691,7 @@ ], "members":{ "Strategy":{"shape":"HyperParameterTuningJobStrategyType"}, + "StrategyConfig":{"shape":"HyperParameterTuningJobStrategyConfig"}, "HyperParameterTuningJobObjective":{"shape":"HyperParameterTuningJobObjective"}, "ResourceLimits":{"shape":"ResourceLimits"}, "ParameterRanges":{"shape":"ParameterRanges"}, @@ -9765,11 +9766,18 @@ "Stopping" ] }, + "HyperParameterTuningJobStrategyConfig":{ + "type":"structure", + "members":{ + "HyperbandStrategyConfig":{"shape":"HyperbandStrategyConfig"} + } + }, "HyperParameterTuningJobStrategyType":{ "type":"string", "enum":[ "Bayesian", - "Random" + "Random", + "Hyperband" ] }, "HyperParameterTuningJobSummaries":{ @@ -9841,6 +9849,21 @@ "max":100, "min":0 }, + "HyperbandStrategyConfig":{ + "type":"structure", + "members":{ + "MinResource":{"shape":"HyperbandStrategyMinResource"}, + "MaxResource":{"shape":"HyperbandStrategyMaxResource"} + } + }, + "HyperbandStrategyMaxResource":{ + "type":"integer", + "min":1 + }, + "HyperbandStrategyMinResource":{ + "type":"integer", + "min":1 + }, "IdempotencyToken":{ "type":"string", "max":128, @@ -12019,7 +12042,7 @@ }, "MaxConcurrentTaskCount":{ "type":"integer", - "max":1000, + "max":5000, "min":1 }, "MaxConcurrentTransforms":{ diff --git a/models/apis/sagemaker/2017-07-24/docs-2.json b/models/apis/sagemaker/2017-07-24/docs-2.json index 74c3a72516d..e3dde8e8db9 100644 --- a/models/apis/sagemaker/2017-07-24/docs-2.json +++ b/models/apis/sagemaker/2017-07-24/docs-2.json @@ -8,7 +8,7 @@ "BatchDescribeModelPackage": "

This action batch describes a list of versioned model packages

", "CreateAction": "

Creates an action. An action is a lineage tracking entity that represents an action or activity. For example, a model deployment or an HPO job. Generally, an action involves at least one input or output artifact. For more information, see Amazon SageMaker ML Lineage Tracking.

", "CreateAlgorithm": "

Create a machine learning algorithm that you can use in SageMaker and list in the Amazon Web Services Marketplace.

", - "CreateApp": "

Creates a running app for the specified UserProfile. Supported apps are JupyterServer and KernelGateway. This operation is automatically invoked by Amazon SageMaker Studio upon access to the associated Domain, and when new kernel configurations are selected by the user. A user may have multiple Apps active simultaneously.

", + "CreateApp": "

Creates a running app for the specified UserProfile. This operation is automatically invoked by Amazon SageMaker Studio upon access to the associated Domain, and when new kernel configurations are selected by the user. A user may have multiple Apps active simultaneously.

", "CreateAppImageConfig": "

Creates a configuration for running a SageMaker image as a KernelGateway app. The configuration specifies the Amazon Elastic File System (EFS) storage volume on the image, and a list of the kernels in the image.

", "CreateArtifact": "

Creates an artifact. An artifact is a lineage tracking entity that represents a URI addressable object or data. Some examples are the S3 URI of a dataset and the ECR registry path of an image. For more information, see Amazon SageMaker ML Lineage Tracking.

", "CreateAutoMLJob": "

Creates an Autopilot job.

Find the best-performing model after you run an Autopilot job by calling .

For information about how to use Autopilot, see Automate Model Development with Amazon SageMaker Autopilot.

", @@ -607,7 +607,7 @@ "base": null, "refs": { "AppDetails$AppType": "

The type of app.

", - "CreateAppRequest$AppType": "

The type of app. Supported apps are JupyterServer and KernelGateway. TensorBoard is not supported.

", + "CreateAppRequest$AppType": "

The type of app.

", "DeleteAppRequest$AppType": "

The type of app.

", "DescribeAppRequest$AppType": "

The type of app.

", "DescribeAppResponse$AppType": "

The type of app.

" @@ -4258,8 +4258,8 @@ "ExecutionRoleIdentityConfig": { "base": null, "refs": { - "DomainSettings$ExecutionRoleIdentityConfig": "

The configuration for attaching a SageMaker user profile name to the execution role as a sts:SourceIdentity key.

", - "DomainSettingsForUpdate$ExecutionRoleIdentityConfig": "

The configuration for attaching a SageMaker user profile name to the execution role as a sts:SourceIdentity key. This configuration can only be modified if there are no apps in the InService or Pending state.

" + "DomainSettings$ExecutionRoleIdentityConfig": "

The configuration for attaching a SageMaker user profile name to the execution role as a sts:SourceIdentity key.

", + "DomainSettingsForUpdate$ExecutionRoleIdentityConfig": "

The configuration for attaching a SageMaker user profile name to the execution role as a sts:SourceIdentity key. This configuration can only be modified if there are no apps in the InService or Pending state.

" } }, "ExecutionStatus": { @@ -5212,11 +5212,17 @@ "ListHyperParameterTuningJobsRequest$StatusEquals": "

A filter that returns only tuning jobs with the specified status.

" } }, + "HyperParameterTuningJobStrategyConfig": { + "base": "

The configuration for a training job launched by a hyperparameter tuning job. Choose Bayesian for Bayesian optimization, and Random for random search optimization. For more advanced use cases, use Hyperband, which evaluates objective metrics for training jobs after every epoch. For more information about strategies, see How Hyperparameter Tuning Works.

", + "refs": { + "HyperParameterTuningJobConfig$StrategyConfig": "

The configuration for the Hyperband optimization strategy. This parameter should be provided only if Hyperband is selected as the strategy for HyperParameterTuningJobConfig.

" + } + }, "HyperParameterTuningJobStrategyType": { "base": "

The strategy hyperparameter tuning uses to find the best combination of hyperparameters for your model. Currently, the only supported value is Bayesian.

", "refs": { - "HyperParameterTuningJobConfig$Strategy": "

Specifies how hyperparameter tuning chooses the combinations of hyperparameter values to use for the training job it launches. To use the Bayesian search strategy, set this to Bayesian. To randomly search, set it to Random. For information about search strategies, see How Hyperparameter Tuning Works.

", - "HyperParameterTuningJobSummary$Strategy": "

Specifies the search strategy hyperparameter tuning uses to choose which hyperparameters to use for each iteration. Currently, the only valid value is Bayesian.

" + "HyperParameterTuningJobConfig$Strategy": "

Specifies how hyperparameter tuning chooses the combinations of hyperparameter values to use for the training job it launches. For information about search strategies, see How Hyperparameter Tuning Works.

", + "HyperParameterTuningJobSummary$Strategy": "

Specifies the search strategy hyperparameter tuning uses to choose which hyperparameters to evaluate at each iteration.

" } }, "HyperParameterTuningJobSummaries": { @@ -5269,6 +5275,24 @@ "TrainingJobDefinition$HyperParameters": "

The hyperparameters used for the training job.

" } }, + "HyperbandStrategyConfig": { + "base": "

The configuration for Hyperband, a multi-fidelity based hyperparameter tuning strategy. Hyperband uses the final and intermediate results of a training job to dynamically allocate resources to utilized hyperparameter configurations while automatically stopping under-performing configurations. This parameter should be provided only if Hyperband is selected as the StrategyConfig under the HyperParameterTuningJobConfig API.

", + "refs": { + "HyperParameterTuningJobStrategyConfig$HyperbandStrategyConfig": "

The configuration for the object that specifies the Hyperband strategy. This parameter is only supported for the Hyperband selection for Strategy within the HyperParameterTuningJobConfig API.

" + } + }, + "HyperbandStrategyMaxResource": { + "base": null, + "refs": { + "HyperbandStrategyConfig$MaxResource": "

The maximum number of resources (such as epochs) that can be used by a training job launched by a hyperparameter tuning job. Once a job reaches the MaxResource value, it is stopped. If a value for MaxResource is not provided, and Hyperband is selected as the hyperparameter tuning strategy, HyperbandTrainingJ attempts to infer MaxResource from the following keys (if present) in StaticsHyperParameters:

If HyperbandStrategyConfig is unable to infer a value for MaxResource, it generates a validation error. The maximum value is 20,000 epochs. All metrics that correspond to an objective metric are used to derive early stopping decisions. For distributive training jobs, ensure that duplicate metrics are not printed in the logs across the individual nodes in a training job. If multiple nodes are publishing duplicate or incorrect metrics, training jobs may make an incorrect stopping decision and stop the job prematurely.

" + } + }, + "HyperbandStrategyMinResource": { + "base": null, + "refs": { + "HyperbandStrategyConfig$MinResource": "

The minimum number of resources (such as epochs) that can be used by a training job launched by a hyperparameter tuning job. If the value for MinResource has not been reached, the training job will not be stopped by Hyperband.

" + } + }, "IdempotencyToken": { "base": null, "refs": { @@ -6788,7 +6812,7 @@ "MaxConcurrentTaskCount": { "base": null, "refs": { - "HumanTaskConfig$MaxConcurrentTaskCount": "

Defines the maximum number of data objects that can be labeled by human workers at the same time. Also referred to as batch size. Each object may have more than one worker at one time. The default value is 1000 objects.

" + "HumanTaskConfig$MaxConcurrentTaskCount": "

Defines the maximum number of data objects that can be labeled by human workers at the same time. Also referred to as batch size. Each object may have more than one worker at one time. The default value is 1000 objects. To increase the maximum value to 5000 objects, contact Amazon Web Services Support.

" } }, "MaxConcurrentTransforms": { @@ -11471,7 +11495,7 @@ "TrainingJobEarlyStoppingType": { "base": null, "refs": { - "HyperParameterTuningJobConfig$TrainingJobEarlyStoppingType": "

Specifies whether to use early stopping for training jobs launched by the hyperparameter tuning job. This can be one of the following values (the default value is OFF):

OFF

Training jobs launched by the hyperparameter tuning job do not use early stopping.

AUTO

SageMaker stops training jobs launched by the hyperparameter tuning job when they are unlikely to perform better than previously completed training jobs. For more information, see Stop Training Jobs Early.

" + "HyperParameterTuningJobConfig$TrainingJobEarlyStoppingType": "

Specifies whether to use early stopping for training jobs launched by the hyperparameter tuning job. Because the Hyperband strategy has its own advanced internal early stopping mechanism, TrainingJobEarlyStoppingType must be OFF to use Hyperband. This parameter can take on one of the following values (the default value is OFF):

OFF

Training jobs launched by the hyperparameter tuning job do not use early stopping.

AUTO

SageMaker stops training jobs launched by the hyperparameter tuning job when they are unlikely to perform better than previously completed training jobs. For more information, see Stop Training Jobs Early.

" } }, "TrainingJobName": { diff --git a/models/endpoints/endpoints.json b/models/endpoints/endpoints.json index bff12a70de7..6806cda31b4 100644 --- a/models/endpoints/endpoints.json +++ b/models/endpoints/endpoints.json @@ -9755,6 +9755,44 @@ } } }, + "participant.connect" : { + "endpoints" : { + "af-south-1" : { }, + "ap-northeast-1" : { }, + "ap-northeast-2" : { }, + "ap-southeast-1" : { }, + "ap-southeast-2" : { }, + "ca-central-1" : { }, + "eu-central-1" : { }, + "eu-west-2" : { }, + "fips-us-east-1" : { + "credentialScope" : { + "region" : "us-east-1" + }, + "deprecated" : true, + "hostname" : "participant.connect-fips.us-east-1.amazonaws.com" + }, + "fips-us-west-2" : { + "credentialScope" : { + "region" : "us-west-2" + }, + "deprecated" : true, + "hostname" : "participant.connect-fips.us-west-2.amazonaws.com" + }, + "us-east-1" : { + "variants" : [ { + "hostname" : "participant.connect-fips.us-east-1.amazonaws.com", + "tags" : [ "fips" ] + } ] + }, + "us-west-2" : { + "variants" : [ { + "hostname" : "participant.connect-fips.us-west-2.amazonaws.com", + "tags" : [ "fips" ] + } ] + } + } + }, "personalize" : { "endpoints" : { "ap-northeast-1" : { }, @@ -12539,6 +12577,7 @@ "tags" : [ "fips" ] } ] }, + "ap-southeast-3" : { }, "ca-central-1" : { "variants" : [ { "hostname" : "snowball-fips.ca-central-1.amazonaws.com", @@ -18492,6 +18531,16 @@ } } }, + "participant.connect" : { + "endpoints" : { + "us-gov-west-1" : { + "credentialScope" : { + "region" : "us-gov-west-1" + }, + "hostname" : "participant.connect.us-gov-west-1.amazonaws.com" + } + } + }, "pinpoint" : { "defaults" : { "credentialScope" : { diff --git a/service/dynamodb/api.go b/service/dynamodb/api.go index 253cebaa846..244e075f5c7 100644 --- a/service/dynamodb/api.go +++ b/service/dynamodb/api.go @@ -5806,7 +5806,7 @@ func (c *DynamoDB) TransactGetItemsRequest(input *TransactGetItemsInput) (req *r // // TransactGetItems is a synchronous operation that atomically retrieves multiple // items from one or more tables (but not from indexes) in a single account -// and Region. A TransactGetItems call can contain up to 25 TransactGetItem +// and Region. A TransactGetItems call can contain up to 100 TransactGetItem // objects, each of which contains a Get structure that specifies an item to // retrieve from a table in the account and Region. A call to TransactGetItems // cannot retrieve items from tables in more than one Amazon Web Services account @@ -6032,7 +6032,7 @@ func (c *DynamoDB) TransactWriteItemsRequest(input *TransactWriteItemsInput) (re // TransactWriteItems API operation for Amazon DynamoDB. // -// TransactWriteItems is a synchronous write operation that groups up to 25 +// TransactWriteItems is a synchronous write operation that groups up to 100 // action requests. These actions can target items in different tables, but // not in different Amazon Web Services accounts or Regions, and no two actions // can target the same item. For example, you cannot both ConditionCheck and @@ -23586,7 +23586,7 @@ type TransactGetItemsInput struct { // is valid. ReturnConsumedCapacity *string `type:"string" enum:"ReturnConsumedCapacity"` - // An ordered array of up to 25 TransactGetItem objects, each of which contains + // An ordered array of up to 100 TransactGetItem objects, each of which contains // a Get structure. // // TransactItems is a required field @@ -23658,7 +23658,7 @@ type TransactGetItemsOutput struct { // consumed by the TransactGetItems call in that table. ConsumedCapacity []*ConsumedCapacity `type:"list"` - // An ordered array of up to 25 ItemResponse objects, each of which corresponds + // An ordered array of up to 100 ItemResponse objects, each of which corresponds // to the TransactGetItem object in the same position in the TransactItems array. // Each ItemResponse object contains a Map of the name-value pairs that are // the projected attributes of the requested item. @@ -23836,7 +23836,7 @@ type TransactWriteItemsInput struct { // NONE (the default), no statistics are returned. ReturnItemCollectionMetrics *string `type:"string" enum:"ReturnItemCollectionMetrics"` - // An ordered array of up to 25 TransactWriteItem objects, each of which contains + // An ordered array of up to 100 TransactWriteItem objects, each of which contains // a ConditionCheck, Put, Update, or Delete object. These can operate on items // in different tables, but the tables must reside in the same Amazon Web Services // account and Region, and no two of them can operate on the same item. diff --git a/service/ec2/api.go b/service/ec2/api.go index 22ed6840918..5ce17212aa7 100644 --- a/service/ec2/api.go +++ b/service/ec2/api.go @@ -50984,6 +50984,65 @@ func (s *AddPrefixListEntry) SetDescription(v string) *AddPrefixListEntry { return s } +// Describes a principal. +type AddedPrincipal struct { + _ struct{} `type:"structure"` + + // The Amazon Resource Name (ARN) of the principal. + Principal *string `locationName:"principal" type:"string"` + + // The type of principal. + PrincipalType *string `locationName:"principalType" type:"string" enum:"PrincipalType"` + + // The ID of the service. + ServiceId *string `locationName:"serviceId" type:"string"` + + // The ID of the service permission. + ServicePermissionId *string `locationName:"servicePermissionId" type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s AddedPrincipal) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s AddedPrincipal) GoString() string { + return s.String() +} + +// SetPrincipal sets the Principal field's value. +func (s *AddedPrincipal) SetPrincipal(v string) *AddedPrincipal { + s.Principal = &v + return s +} + +// SetPrincipalType sets the PrincipalType field's value. +func (s *AddedPrincipal) SetPrincipalType(v string) *AddedPrincipal { + s.PrincipalType = &v + return s +} + +// SetServiceId sets the ServiceId field's value. +func (s *AddedPrincipal) SetServiceId(v string) *AddedPrincipal { + s.ServiceId = &v + return s +} + +// SetServicePermissionId sets the ServicePermissionId field's value. +func (s *AddedPrincipal) SetServicePermissionId(v string) *AddedPrincipal { + s.ServicePermissionId = &v + return s +} + // Describes an additional detail for a path analysis. type AdditionalDetail struct { _ struct{} `type:"structure"` @@ -51886,6 +51945,15 @@ type AllowedPrincipal struct { // The type of principal. PrincipalType *string `locationName:"principalType" type:"string" enum:"PrincipalType"` + + // The ID of the service. + ServiceId *string `locationName:"serviceId" type:"string"` + + // The ID of the service permission. + ServicePermissionId *string `locationName:"servicePermissionId" type:"string"` + + // The tags. + Tags []*Tag `locationName:"tagSet" locationNameList:"item" type:"list"` } // String returns the string representation. @@ -51918,6 +51986,24 @@ func (s *AllowedPrincipal) SetPrincipalType(v string) *AllowedPrincipal { return s } +// SetServiceId sets the ServiceId field's value. +func (s *AllowedPrincipal) SetServiceId(v string) *AllowedPrincipal { + s.ServiceId = &v + return s +} + +// SetServicePermissionId sets the ServicePermissionId field's value. +func (s *AllowedPrincipal) SetServicePermissionId(v string) *AllowedPrincipal { + s.ServicePermissionId = &v + return s +} + +// SetTags sets the Tags field's value. +func (s *AllowedPrincipal) SetTags(v []*Tag) *AllowedPrincipal { + s.Tags = v + return s +} + // Describes an potential intermediate component of a feasible path. type AlternatePathHint struct { _ struct{} `type:"structure"` @@ -134586,6 +134672,9 @@ func (s *ModifyVpcEndpointServicePermissionsInput) SetServiceId(v string) *Modif type ModifyVpcEndpointServicePermissionsOutput struct { _ struct{} `type:"structure"` + // Information about the added principals. + AddedPrincipals []*AddedPrincipal `locationName:"addedPrincipalSet" locationNameList:"item" type:"list"` + // Returns true if the request succeeds; otherwise, it returns an error. ReturnValue *bool `locationName:"return" type:"boolean"` } @@ -134608,6 +134697,12 @@ func (s ModifyVpcEndpointServicePermissionsOutput) GoString() string { return s.String() } +// SetAddedPrincipals sets the AddedPrincipals field's value. +func (s *ModifyVpcEndpointServicePermissionsOutput) SetAddedPrincipals(v []*AddedPrincipal) *ModifyVpcEndpointServicePermissionsOutput { + s.AddedPrincipals = v + return s +} + // SetReturnValue sets the ReturnValue field's value. func (s *ModifyVpcEndpointServicePermissionsOutput) SetReturnValue(v bool) *ModifyVpcEndpointServicePermissionsOutput { s.ReturnValue = &v @@ -163903,6 +163998,12 @@ type VpcEndpointConnection struct { // The ID of the service to which the endpoint is connected. ServiceId *string `locationName:"serviceId" type:"string"` + // The tags. + Tags []*Tag `locationName:"tagSet" locationNameList:"item" type:"list"` + + // The ID of the VPC endpoint connection. + VpcEndpointConnectionId *string `locationName:"vpcEndpointConnectionId" type:"string"` + // The ID of the VPC endpoint. VpcEndpointId *string `locationName:"vpcEndpointId" type:"string"` @@ -163967,6 +164068,18 @@ func (s *VpcEndpointConnection) SetServiceId(v string) *VpcEndpointConnection { return s } +// SetTags sets the Tags field's value. +func (s *VpcEndpointConnection) SetTags(v []*Tag) *VpcEndpointConnection { + s.Tags = v + return s +} + +// SetVpcEndpointConnectionId sets the VpcEndpointConnectionId field's value. +func (s *VpcEndpointConnection) SetVpcEndpointConnectionId(v string) *VpcEndpointConnection { + s.VpcEndpointConnectionId = &v + return s +} + // SetVpcEndpointId sets the VpcEndpointId field's value. func (s *VpcEndpointConnection) SetVpcEndpointId(v string) *VpcEndpointConnection { s.VpcEndpointId = &v @@ -172223,9 +172336,15 @@ const ( // ResourceTypeVpcEndpoint is a ResourceType enum value ResourceTypeVpcEndpoint = "vpc-endpoint" + // ResourceTypeVpcEndpointConnection is a ResourceType enum value + ResourceTypeVpcEndpointConnection = "vpc-endpoint-connection" + // ResourceTypeVpcEndpointService is a ResourceType enum value ResourceTypeVpcEndpointService = "vpc-endpoint-service" + // ResourceTypeVpcEndpointServicePermission is a ResourceType enum value + ResourceTypeVpcEndpointServicePermission = "vpc-endpoint-service-permission" + // ResourceTypeVpcPeeringConnection is a ResourceType enum value ResourceTypeVpcPeeringConnection = "vpc-peering-connection" @@ -172320,7 +172439,9 @@ func ResourceType_Values() []string { ResourceTypeVolume, ResourceTypeVpc, ResourceTypeVpcEndpoint, + ResourceTypeVpcEndpointConnection, ResourceTypeVpcEndpointService, + ResourceTypeVpcEndpointServicePermission, ResourceTypeVpcPeeringConnection, ResourceTypeVpnConnection, ResourceTypeVpnGateway, diff --git a/service/sagemaker/api.go b/service/sagemaker/api.go index 6b624242dc0..b30d93499d9 100644 --- a/service/sagemaker/api.go +++ b/service/sagemaker/api.go @@ -553,10 +553,10 @@ func (c *SageMaker) CreateAppRequest(input *CreateAppInput) (req *request.Reques // CreateApp API operation for Amazon SageMaker Service. // -// Creates a running app for the specified UserProfile. Supported apps are JupyterServer -// and KernelGateway. This operation is automatically invoked by Amazon SageMaker -// Studio upon access to the associated Domain, and when new kernel configurations -// are selected by the user. A user may have multiple Apps active simultaneously. +// Creates a running app for the specified UserProfile. This operation is automatically +// invoked by Amazon SageMaker Studio upon access to the associated Domain, +// and when new kernel configurations are selected by the user. A user may have +// multiple Apps active simultaneously. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -31657,8 +31657,7 @@ type CreateAppInput struct { // AppName is a required field AppName *string `type:"string" required:"true"` - // The type of app. Supported apps are JupyterServer and KernelGateway. TensorBoard - // is not supported. + // The type of app. // // AppType is a required field AppType *string `type:"string" required:"true" enum:"AppType"` @@ -60295,7 +60294,8 @@ type HumanTaskConfig struct { // Defines the maximum number of data objects that can be labeled by human workers // at the same time. Also referred to as batch size. Each object may have more - // than one worker at one time. The default value is 1000 objects. + // than one worker at one time. The default value is 1000 objects. To increase + // the maximum value to 5000 objects, contact Amazon Web Services Support. MaxConcurrentTaskCount *int64 `min:"1" type:"integer"` // The number of human workers that will label an object. @@ -62043,17 +62043,21 @@ type HyperParameterTuningJobConfig struct { ResourceLimits *ResourceLimits `type:"structure" required:"true"` // Specifies how hyperparameter tuning chooses the combinations of hyperparameter - // values to use for the training job it launches. To use the Bayesian search - // strategy, set this to Bayesian. To randomly search, set it to Random. For - // information about search strategies, see How Hyperparameter Tuning Works - // (https://docs.aws.amazon.com/sagemaker/latest/dg/automatic-model-tuning-how-it-works.html). + // values to use for the training job it launches. For information about search + // strategies, see How Hyperparameter Tuning Works (https://docs.aws.amazon.com/sagemaker/latest/dg/automatic-model-tuning-how-it-works.html). // // Strategy is a required field Strategy *string `type:"string" required:"true" enum:"HyperParameterTuningJobStrategyType"` + // The configuration for the Hyperband optimization strategy. This parameter + // should be provided only if Hyperband is selected as the strategy for HyperParameterTuningJobConfig. + StrategyConfig *HyperParameterTuningJobStrategyConfig `type:"structure"` + // Specifies whether to use early stopping for training jobs launched by the - // hyperparameter tuning job. This can be one of the following values (the default - // value is OFF): + // hyperparameter tuning job. Because the Hyperband strategy has its own advanced + // internal early stopping mechanism, TrainingJobEarlyStoppingType must be OFF + // to use Hyperband. This parameter can take on one of the following values + // (the default value is OFF): // // OFF // @@ -62113,6 +62117,11 @@ func (s *HyperParameterTuningJobConfig) Validate() error { invalidParams.AddNested("ResourceLimits", err.(request.ErrInvalidParams)) } } + if s.StrategyConfig != nil { + if err := s.StrategyConfig.Validate(); err != nil { + invalidParams.AddNested("StrategyConfig", err.(request.ErrInvalidParams)) + } + } if s.TuningJobCompletionCriteria != nil { if err := s.TuningJobCompletionCriteria.Validate(); err != nil { invalidParams.AddNested("TuningJobCompletionCriteria", err.(request.ErrInvalidParams)) @@ -62149,6 +62158,12 @@ func (s *HyperParameterTuningJobConfig) SetStrategy(v string) *HyperParameterTun return s } +// SetStrategyConfig sets the StrategyConfig field's value. +func (s *HyperParameterTuningJobConfig) SetStrategyConfig(v *HyperParameterTuningJobStrategyConfig) *HyperParameterTuningJobConfig { + s.StrategyConfig = v + return s +} + // SetTrainingJobEarlyStoppingType sets the TrainingJobEarlyStoppingType field's value. func (s *HyperParameterTuningJobConfig) SetTrainingJobEarlyStoppingType(v string) *HyperParameterTuningJobConfig { s.TrainingJobEarlyStoppingType = &v @@ -62415,6 +62430,59 @@ func (s *HyperParameterTuningJobSearchEntity) SetWarmStartConfig(v *HyperParamet return s } +// The configuration for a training job launched by a hyperparameter tuning +// job. Choose Bayesian for Bayesian optimization, and Random for random search +// optimization. For more advanced use cases, use Hyperband, which evaluates +// objective metrics for training jobs after every epoch. For more information +// about strategies, see How Hyperparameter Tuning Works (https://docs.aws.amazon.com/sagemaker/latest/dg/automatic-model-tuning-how-it-works.html). +type HyperParameterTuningJobStrategyConfig struct { + _ struct{} `type:"structure"` + + // The configuration for the object that specifies the Hyperband strategy. This + // parameter is only supported for the Hyperband selection for Strategy within + // the HyperParameterTuningJobConfig API. + HyperbandStrategyConfig *HyperbandStrategyConfig `type:"structure"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s HyperParameterTuningJobStrategyConfig) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s HyperParameterTuningJobStrategyConfig) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *HyperParameterTuningJobStrategyConfig) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "HyperParameterTuningJobStrategyConfig"} + if s.HyperbandStrategyConfig != nil { + if err := s.HyperbandStrategyConfig.Validate(); err != nil { + invalidParams.AddNested("HyperbandStrategyConfig", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetHyperbandStrategyConfig sets the HyperbandStrategyConfig field's value. +func (s *HyperParameterTuningJobStrategyConfig) SetHyperbandStrategyConfig(v *HyperbandStrategyConfig) *HyperParameterTuningJobStrategyConfig { + s.HyperbandStrategyConfig = v + return s +} + // Provides summary information about a hyperparameter tuning job. type HyperParameterTuningJobSummary struct { _ struct{} `type:"structure"` @@ -62456,8 +62524,7 @@ type HyperParameterTuningJobSummary struct { ResourceLimits *ResourceLimits `type:"structure"` // Specifies the search strategy hyperparameter tuning uses to choose which - // hyperparameters to use for each iteration. Currently, the only valid value - // is Bayesian. + // hyperparameters to evaluate at each iteration. // // Strategy is a required field Strategy *string `type:"string" required:"true" enum:"HyperParameterTuningJobStrategyType"` @@ -62815,6 +62882,95 @@ func (s *HyperParameterTuningResourceConfig) SetVolumeSizeInGB(v int64) *HyperPa return s } +// The configuration for Hyperband, a multi-fidelity based hyperparameter tuning +// strategy. Hyperband uses the final and intermediate results of a training +// job to dynamically allocate resources to utilized hyperparameter configurations +// while automatically stopping under-performing configurations. This parameter +// should be provided only if Hyperband is selected as the StrategyConfig under +// the HyperParameterTuningJobConfig API. +type HyperbandStrategyConfig struct { + _ struct{} `type:"structure"` + + // The maximum number of resources (such as epochs) that can be used by a training + // job launched by a hyperparameter tuning job. Once a job reaches the MaxResource + // value, it is stopped. If a value for MaxResource is not provided, and Hyperband + // is selected as the hyperparameter tuning strategy, HyperbandTrainingJ attempts + // to infer MaxResource from the following keys (if present) in StaticsHyperParameters + // (https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_HyperParameterTrainingJobDefinition.html#sagemaker-Type-HyperParameterTrainingJobDefinition-StaticHyperParameters): + // + // * epochs + // + // * numepochs + // + // * n-epochs + // + // * n_epochs + // + // * num_epochs + // + // If HyperbandStrategyConfig is unable to infer a value for MaxResource, it + // generates a validation error. The maximum value is 20,000 epochs. All metrics + // that correspond to an objective metric are used to derive early stopping + // decisions (https://docs.aws.amazon.com/sagemaker/latest/dg/automatic-model-tuning-early-stopping.html). + // For distributive (https://docs.aws.amazon.com/sagemaker/latest/dg/distributed-training.html) + // training jobs, ensure that duplicate metrics are not printed in the logs + // across the individual nodes in a training job. If multiple nodes are publishing + // duplicate or incorrect metrics, training jobs may make an incorrect stopping + // decision and stop the job prematurely. + MaxResource *int64 `min:"1" type:"integer"` + + // The minimum number of resources (such as epochs) that can be used by a training + // job launched by a hyperparameter tuning job. If the value for MinResource + // has not been reached, the training job will not be stopped by Hyperband. + MinResource *int64 `min:"1" type:"integer"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s HyperbandStrategyConfig) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s HyperbandStrategyConfig) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *HyperbandStrategyConfig) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "HyperbandStrategyConfig"} + if s.MaxResource != nil && *s.MaxResource < 1 { + invalidParams.Add(request.NewErrParamMinValue("MaxResource", 1)) + } + if s.MinResource != nil && *s.MinResource < 1 { + invalidParams.Add(request.NewErrParamMinValue("MinResource", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetMaxResource sets the MaxResource field's value. +func (s *HyperbandStrategyConfig) SetMaxResource(v int64) *HyperbandStrategyConfig { + s.MaxResource = &v + return s +} + +// SetMinResource sets the MinResource field's value. +func (s *HyperbandStrategyConfig) SetMinResource(v int64) *HyperbandStrategyConfig { + s.MinResource = &v + return s +} + // A SageMaker image. A SageMaker image represents a set of container images // that are derived from a common base container image. Each of these container // images is represented by a SageMaker ImageVersion. @@ -99889,6 +100045,9 @@ const ( // HyperParameterTuningJobStrategyTypeRandom is a HyperParameterTuningJobStrategyType enum value HyperParameterTuningJobStrategyTypeRandom = "Random" + + // HyperParameterTuningJobStrategyTypeHyperband is a HyperParameterTuningJobStrategyType enum value + HyperParameterTuningJobStrategyTypeHyperband = "Hyperband" ) // HyperParameterTuningJobStrategyType_Values returns all elements of the HyperParameterTuningJobStrategyType enum @@ -99896,6 +100055,7 @@ func HyperParameterTuningJobStrategyType_Values() []string { return []string{ HyperParameterTuningJobStrategyTypeBayesian, HyperParameterTuningJobStrategyTypeRandom, + HyperParameterTuningJobStrategyTypeHyperband, } }