From ecd55b7d6b820c5fc89cca534dedac722d8434bc Mon Sep 17 00:00:00 2001 From: aws-sdk-python-automation Date: Fri, 19 Apr 2024 18:11:28 +0000 Subject: [PATCH 1/2] Update to latest models --- .../next-release/api-change-glue-12902.json | 5 + .../api-change-internetmonitor-7520.json | 5 + .../api-change-personalize-2044.json | 5 + botocore/data/glue/2017-03-31/service-2.json | 4 + .../2021-06-03/paginators-1.json | 6 + .../internetmonitor/2021-06-03/service-2.json | 284 +++++++++++++++++- .../personalize/2018-05-22/service-2.json | 91 ++++-- 7 files changed, 371 insertions(+), 29 deletions(-) create mode 100644 .changes/next-release/api-change-glue-12902.json create mode 100644 .changes/next-release/api-change-internetmonitor-7520.json create mode 100644 .changes/next-release/api-change-personalize-2044.json diff --git a/.changes/next-release/api-change-glue-12902.json b/.changes/next-release/api-change-glue-12902.json new file mode 100644 index 0000000000..1be185d966 --- /dev/null +++ b/.changes/next-release/api-change-glue-12902.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``glue``", + "description": "Adding RowFilter in the response for GetUnfilteredTableMetadata API" +} diff --git a/.changes/next-release/api-change-internetmonitor-7520.json b/.changes/next-release/api-change-internetmonitor-7520.json new file mode 100644 index 0000000000..3e4cdc2bd8 --- /dev/null +++ b/.changes/next-release/api-change-internetmonitor-7520.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``internetmonitor``", + "description": "This update introduces the GetInternetEvent and ListInternetEvents APIs, which provide access to internet events displayed on the Amazon CloudWatch Internet Weather Map." +} diff --git a/.changes/next-release/api-change-personalize-2044.json b/.changes/next-release/api-change-personalize-2044.json new file mode 100644 index 0000000000..8c890a05fd --- /dev/null +++ b/.changes/next-release/api-change-personalize-2044.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``personalize``", + "description": "This releases auto training capability while creating a solution and automatically syncing latest solution versions when creating/updating a campaign" +} diff --git a/botocore/data/glue/2017-03-31/service-2.json b/botocore/data/glue/2017-03-31/service-2.json index 7d07dde954..c84b898194 100644 --- a/botocore/data/glue/2017-03-31/service-2.json +++ b/botocore/data/glue/2017-03-31/service-2.json @@ -13088,6 +13088,10 @@ "Permissions":{ "shape":"PermissionList", "documentation":"

The Lake Formation data permissions of the caller on the table. Used to authorize the call when no view context is found.

" + }, + "RowFilter":{ + "shape":"PredicateString", + "documentation":"

The filter that applies to the table. For example when applying the filter in SQL, it would go in the WHERE clause and can be evaluated by using an AND operator with any other predicates applied by the user querying the table.

" } } }, diff --git a/botocore/data/internetmonitor/2021-06-03/paginators-1.json b/botocore/data/internetmonitor/2021-06-03/paginators-1.json index 467ebeee8e..c08ea4f0d8 100644 --- a/botocore/data/internetmonitor/2021-06-03/paginators-1.json +++ b/botocore/data/internetmonitor/2021-06-03/paginators-1.json @@ -11,6 +11,12 @@ "output_token": "NextToken", "limit_key": "MaxResults", "result_key": "Monitors" + }, + "ListInternetEvents": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults", + "result_key": "InternetEvents" } } } diff --git a/botocore/data/internetmonitor/2021-06-03/service-2.json b/botocore/data/internetmonitor/2021-06-03/service-2.json index 73efa954f8..17747a0a24 100644 --- a/botocore/data/internetmonitor/2021-06-03/service-2.json +++ b/botocore/data/internetmonitor/2021-06-03/service-2.json @@ -65,7 +65,24 @@ {"shape":"ThrottlingException"}, {"shape":"ValidationException"} ], - "documentation":"

Gets information the Amazon CloudWatch Internet Monitor has created and stored about a health event for a specified monitor. This information includes the impacted locations, and all the information related to the event, by location.

The information returned includes the impact on performance, availability, and round-trip time, information about the network providers (ASNs), the event type, and so on.

Information rolled up at the global traffic level is also returned, including the impact type and total traffic impact.

" + "documentation":"

Gets information that Amazon CloudWatch Internet Monitor has created and stored about a health event for a specified monitor. This information includes the impacted locations, and all the information related to the event, by location.

The information returned includes the impact on performance, availability, and round-trip time, information about the network providers (ASNs), the event type, and so on.

Information rolled up at the global traffic level is also returned, including the impact type and total traffic impact.

" + }, + "GetInternetEvent":{ + "name":"GetInternetEvent", + "http":{ + "method":"GET", + "requestUri":"/v20210603/InternetEvents/{EventId}", + "responseCode":200 + }, + "input":{"shape":"GetInternetEventInput"}, + "output":{"shape":"GetInternetEventOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ValidationException"} + ], + "documentation":"

Gets information that Amazon CloudWatch Internet Monitor has generated about an internet event. Internet Monitor displays information about recent global health events, called internet events, on a global outages map that is available to all Amazon Web Services customers.

The information returned here includes the impacted location, when the event started and (if the event is over) ended, the type of event (PERFORMANCE or AVAILABILITY), and the status (ACTIVE or RESOLVED).

" }, "GetMonitor":{ "name":"GetMonitor", @@ -135,7 +152,24 @@ {"shape":"ThrottlingException"}, {"shape":"ValidationException"} ], - "documentation":"

Lists all health events for a monitor in Amazon CloudWatch Internet Monitor. Returns information for health events including the event start and end time and the status.

Health events that have start times during the time frame that is requested are not included in the list of health events.

" + "documentation":"

Lists all health events for a monitor in Amazon CloudWatch Internet Monitor. Returns information for health events including the event start and end times, and the status.

Health events that have start times during the time frame that is requested are not included in the list of health events.

" + }, + "ListInternetEvents":{ + "name":"ListInternetEvents", + "http":{ + "method":"GET", + "requestUri":"/v20210603/InternetEvents", + "responseCode":200 + }, + "input":{"shape":"ListInternetEventsInput"}, + "output":{"shape":"ListInternetEventsOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ValidationException"} + ], + "documentation":"

Lists internet events that cause performance or availability issues for client locations. Amazon CloudWatch Internet Monitor displays information about recent global health events, called internet events, on a global outages map that is available to all Amazon Web Services customers.

You can constrain the list of internet events returned by providing a start time and end time to define a total time frame for events you want to list. Both start time and end time specify the time when an event started. End time is optional. If you don't include it, the default end time is the current time.

You can also limit the events returned to a specific status (ACTIVE or RESOLVED) or type (PERFORMANCE or AVAILABILITY).

" }, "ListMonitors":{ "name":"ListMonitors", @@ -325,6 +359,52 @@ "type":"boolean", "box":true }, + "ClientLocation":{ + "type":"structure", + "required":[ + "ASName", + "ASNumber", + "Country", + "City", + "Latitude", + "Longitude" + ], + "members":{ + "ASName":{ + "shape":"String", + "documentation":"

The name of the internet service provider (ISP) or network (ASN).

" + }, + "ASNumber":{ + "shape":"Long", + "documentation":"

The Autonomous System Number (ASN) of the network at an impacted location.

" + }, + "Country":{ + "shape":"String", + "documentation":"

The name of the country where the internet event is located.

" + }, + "Subdivision":{ + "shape":"String", + "documentation":"

The subdivision location where the health event is located. The subdivision usually maps to states in most countries (including the United States). For United Kingdom, it maps to a country (England, Scotland, Wales) or province (Northern Ireland).

" + }, + "Metro":{ + "shape":"String", + "documentation":"

The metro area where the health event is located.

Metro indicates a metropolitan region in the United States, such as the region around New York City. In non-US countries, this is a second-level subdivision. For example, in the United Kingdom, it could be a county, a London borough, a unitary authority, council area, and so on.

" + }, + "City":{ + "shape":"String", + "documentation":"

The name of the city where the internet event is located.

" + }, + "Latitude":{ + "shape":"Double", + "documentation":"

The latitude where the internet event is located.

" + }, + "Longitude":{ + "shape":"Double", + "documentation":"

The longitude where the internet event is located.

" + } + }, + "documentation":"

The impacted location, such as a city, that Amazon Web Services clients access application resources from.

" + }, "ConflictException":{ "type":"structure", "members":{ @@ -461,7 +541,7 @@ }, "LinkedAccountId":{ "shape":"AccountId", - "documentation":"

TBD

", + "documentation":"

The account ID for an account that you've set up cross-account sharing for in Amazon CloudWatch Internet Monitor. You configure cross-account sharing by using Amazon CloudWatch Observability Access Manager. For more information, see Internet Monitor cross-account observability in the Amazon CloudWatch Internet Monitor User Guide.

", "location":"querystring", "locationName":"LinkedAccountId" } @@ -525,6 +605,59 @@ } } }, + "GetInternetEventInput":{ + "type":"structure", + "required":["EventId"], + "members":{ + "EventId":{ + "shape":"InternetEventId", + "documentation":"

The EventId of the internet event to return information for.

", + "location":"uri", + "locationName":"EventId" + } + } + }, + "GetInternetEventOutput":{ + "type":"structure", + "required":[ + "EventId", + "EventArn", + "StartedAt", + "ClientLocation", + "EventType", + "EventStatus" + ], + "members":{ + "EventId":{ + "shape":"InternetEventId", + "documentation":"

The internally-generated identifier of an internet event.

" + }, + "EventArn":{ + "shape":"Arn", + "documentation":"

The Amazon Resource Name (ARN) of the internet event.

" + }, + "StartedAt":{ + "shape":"SyntheticTimestamp_date_time", + "documentation":"

The time when the internet event started.

" + }, + "EndedAt":{ + "shape":"SyntheticTimestamp_date_time", + "documentation":"

The time when the internet event ended. If the event hasn't ended yet, this value is empty.

" + }, + "ClientLocation":{ + "shape":"ClientLocation", + "documentation":"

The impacted location, such as a city, where clients access Amazon Web Services application resources.

" + }, + "EventType":{ + "shape":"InternetEventType", + "documentation":"

The type of network impairment.

" + }, + "EventStatus":{ + "shape":"InternetEventStatus", + "documentation":"

The status of the internet event.

" + } + } + }, "GetMonitorInput":{ "type":"structure", "required":["MonitorName"], @@ -537,7 +670,7 @@ }, "LinkedAccountId":{ "shape":"AccountId", - "documentation":"

TBD

", + "documentation":"

The account ID for an account that you've set up cross-account sharing for in Amazon CloudWatch Internet Monitor. You configure cross-account sharing by using Amazon CloudWatch Observability Access Manager. For more information, see Internet Monitor cross-account observability in the Amazon CloudWatch Internet Monitor User Guide.

", "location":"querystring", "locationName":"LinkedAccountId" } @@ -735,7 +868,7 @@ }, "Status":{ "shape":"HealthEventStatus", - "documentation":"

Health event list member.

" + "documentation":"

The status of a health event.

" }, "PercentOfTotalTrafficImpacted":{ "shape":"Double", @@ -811,7 +944,7 @@ "members":{ "ASName":{ "shape":"String", - "documentation":"

The name of the network at an impacted location.

" + "documentation":"

The name of the internet service provider (ISP) or network (ASN).

" }, "ASNumber":{ "shape":"Long", @@ -898,6 +1031,78 @@ "fault":true, "retryable":{"throttling":false} }, + "InternetEventId":{ + "type":"string", + "max":255, + "min":1, + "pattern":"[a-zA-Z0-9-]+" + }, + "InternetEventMaxResults":{ + "type":"integer", + "box":true, + "max":100, + "min":1 + }, + "InternetEventStatus":{ + "type":"string", + "enum":[ + "ACTIVE", + "RESOLVED" + ] + }, + "InternetEventSummary":{ + "type":"structure", + "required":[ + "EventId", + "EventArn", + "StartedAt", + "ClientLocation", + "EventType", + "EventStatus" + ], + "members":{ + "EventId":{ + "shape":"InternetEventId", + "documentation":"

The internally-generated identifier of an internet event.

" + }, + "EventArn":{ + "shape":"Arn", + "documentation":"

The Amazon Resource Name (ARN) of the internet event.

" + }, + "StartedAt":{ + "shape":"SyntheticTimestamp_date_time", + "documentation":"

The time when an internet event started.

" + }, + "EndedAt":{ + "shape":"SyntheticTimestamp_date_time", + "documentation":"

The time when an internet event ended. If the event hasn't ended yet, this value is empty.

" + }, + "ClientLocation":{ + "shape":"ClientLocation", + "documentation":"

The impacted location, such as a city, that Amazon Web Services clients access application resources from.

" + }, + "EventType":{ + "shape":"InternetEventType", + "documentation":"

The type of network impairment.

" + }, + "EventStatus":{ + "shape":"InternetEventStatus", + "documentation":"

The status of an internet event.

" + } + }, + "documentation":"

A summary of information about an internet event in Amazon CloudWatch Internet Monitor. Internet events are issues that cause performance degradation or availability problems for impacted Amazon Web Services client locations. Internet Monitor displays information about recent global health events, called internet events, on a global outages map that is available to all Amazon Web Services customers.

" + }, + "InternetEventType":{ + "type":"string", + "enum":[ + "AVAILABILITY", + "PERFORMANCE" + ] + }, + "InternetEventsList":{ + "type":"list", + "member":{"shape":"InternetEventSummary"} + }, "InternetHealth":{ "type":"structure", "members":{ @@ -980,7 +1185,7 @@ }, "LinkedAccountId":{ "shape":"AccountId", - "documentation":"

TBD

", + "documentation":"

The account ID for an account that you've set up cross-account sharing for in Amazon CloudWatch Internet Monitor. You configure cross-account sharing by using Amazon CloudWatch Observability Access Manager. For more information, see Internet Monitor cross-account observability in the Amazon CloudWatch Internet Monitor User Guide.

", "location":"querystring", "locationName":"LinkedAccountId" } @@ -1000,6 +1205,61 @@ } } }, + "ListInternetEventsInput":{ + "type":"structure", + "members":{ + "NextToken":{ + "shape":"String", + "documentation":"

The token for the next set of results. You receive this token from a previous call.

", + "location":"querystring", + "locationName":"NextToken" + }, + "MaxResults":{ + "shape":"InternetEventMaxResults", + "documentation":"

The number of query results that you want to return with this call.

", + "location":"querystring", + "locationName":"InternetEventMaxResults" + }, + "StartTime":{ + "shape":"SyntheticTimestamp_date_time", + "documentation":"

The start time of the time window that you want to get a list of internet events for.

", + "location":"querystring", + "locationName":"StartTime" + }, + "EndTime":{ + "shape":"SyntheticTimestamp_date_time", + "documentation":"

The end time of the time window that you want to get a list of internet events for.

", + "location":"querystring", + "locationName":"EndTime" + }, + "EventStatus":{ + "shape":"String", + "documentation":"

The status of an internet event.

", + "location":"querystring", + "locationName":"EventStatus" + }, + "EventType":{ + "shape":"String", + "documentation":"

The type of network impairment.

", + "location":"querystring", + "locationName":"EventType" + } + } + }, + "ListInternetEventsOutput":{ + "type":"structure", + "required":["InternetEvents"], + "members":{ + "InternetEvents":{ + "shape":"InternetEventsList", + "documentation":"

A set of internet events returned for the list operation.

" + }, + "NextToken":{ + "shape":"String", + "documentation":"

The token for the next set of results. You receive this token from a previous call.

" + } + } + }, "ListMonitorsInput":{ "type":"structure", "members":{ @@ -1023,7 +1283,7 @@ }, "IncludeLinkedAccounts":{ "shape":"Boolean", - "documentation":"

TBD

", + "documentation":"

A boolean option that you can set to TRUE to include monitors for linked accounts in a list of monitors, when you've set up cross-account sharing in Amazon CloudWatch Internet Monitor. You configure cross-account sharing by using Amazon CloudWatch Observability Access Manager. For more information, see Internet Monitor cross-account observability in the Amazon CloudWatch Internet Monitor User Guide.

", "location":"querystring", "locationName":"IncludeLinkedAccounts" } @@ -1178,14 +1438,14 @@ "members":{ "ASName":{ "shape":"String", - "documentation":"

The internet provider name or network name.

" + "documentation":"

The name of the internet service provider (ISP) or network (ASN).

" }, "ASNumber":{ "shape":"Long", "documentation":"

The Autonomous System Number (ASN) of the internet provider or network.

" } }, - "documentation":"

An internet service provider (ISP) or network in Amazon CloudWatch Internet Monitor.

" + "documentation":"

An internet service provider (ISP) or network (ASN) in Amazon CloudWatch Internet Monitor.

" }, "NetworkImpairment":{ "type":"structure", @@ -1205,7 +1465,7 @@ }, "NetworkEventType":{ "shape":"TriangulationEventType", - "documentation":"

Type of network impairment.

" + "documentation":"

The type of network impairment.

" } }, "documentation":"

Information about the network impairment for a specific network measured by Amazon CloudWatch Internet Monitor.

" @@ -1405,7 +1665,7 @@ }, "LinkedAccountId":{ "shape":"AccountId", - "documentation":"

TBD

" + "documentation":"

The account ID for an account that you've set up cross-account sharing for in Amazon CloudWatch Internet Monitor. You configure cross-account sharing by using Amazon CloudWatch Observability Access Manager. For more information, see Internet Monitor cross-account observability in the Amazon CloudWatch Internet Monitor User Guide.

" } } }, diff --git a/botocore/data/personalize/2018-05-22/service-2.json b/botocore/data/personalize/2018-05-22/service-2.json index 410f259784..e152ed32d5 100644 --- a/botocore/data/personalize/2018-05-22/service-2.json +++ b/botocore/data/personalize/2018-05-22/service-2.json @@ -65,7 +65,7 @@ {"shape":"ResourceInUseException"}, {"shape":"TooManyTagsException"} ], - "documentation":"

Creates a campaign that deploys a solution version. When a client calls the GetRecommendations and GetPersonalizedRanking APIs, a campaign is specified in the request.

Minimum Provisioned TPS and Auto-Scaling

A high minProvisionedTPS will increase your cost. We recommend starting with 1 for minProvisionedTPS (the default). Track your usage using Amazon CloudWatch metrics, and increase the minProvisionedTPS as necessary.

When you create an Amazon Personalize campaign, you can specify the minimum provisioned transactions per second (minProvisionedTPS) for the campaign. This is the baseline transaction throughput for the campaign provisioned by Amazon Personalize. It sets the minimum billing charge for the campaign while it is active. A transaction is a single GetRecommendations or GetPersonalizedRanking request. The default minProvisionedTPS is 1.

If your TPS increases beyond the minProvisionedTPS, Amazon Personalize auto-scales the provisioned capacity up and down, but never below minProvisionedTPS. There's a short time delay while the capacity is increased that might cause loss of transactions. When your traffic reduces, capacity returns to the minProvisionedTPS.

You are charged for the the minimum provisioned TPS or, if your requests exceed the minProvisionedTPS, the actual TPS. The actual TPS is the total number of recommendation requests you make. We recommend starting with a low minProvisionedTPS, track your usage using Amazon CloudWatch metrics, and then increase the minProvisionedTPS as necessary.

For more information about campaign costs, see Amazon Personalize pricing.

Status

A campaign can be in one of the following states:

To get the campaign status, call DescribeCampaign.

Wait until the status of the campaign is ACTIVE before asking the campaign for recommendations.

Related APIs

", + "documentation":"

You incur campaign costs while it is active. To avoid unnecessary costs, make sure to delete the campaign when you are finished. For information about campaign costs, see Amazon Personalize pricing.

Creates a campaign that deploys a solution version. When a client calls the GetRecommendations and GetPersonalizedRanking APIs, a campaign is specified in the request.

Minimum Provisioned TPS and Auto-Scaling

A high minProvisionedTPS will increase your cost. We recommend starting with 1 for minProvisionedTPS (the default). Track your usage using Amazon CloudWatch metrics, and increase the minProvisionedTPS as necessary.

When you create an Amazon Personalize campaign, you can specify the minimum provisioned transactions per second (minProvisionedTPS) for the campaign. This is the baseline transaction throughput for the campaign provisioned by Amazon Personalize. It sets the minimum billing charge for the campaign while it is active. A transaction is a single GetRecommendations or GetPersonalizedRanking request. The default minProvisionedTPS is 1.

If your TPS increases beyond the minProvisionedTPS, Amazon Personalize auto-scales the provisioned capacity up and down, but never below minProvisionedTPS. There's a short time delay while the capacity is increased that might cause loss of transactions. When your traffic reduces, capacity returns to the minProvisionedTPS.

You are charged for the the minimum provisioned TPS or, if your requests exceed the minProvisionedTPS, the actual TPS. The actual TPS is the total number of recommendation requests you make. We recommend starting with a low minProvisionedTPS, track your usage using Amazon CloudWatch metrics, and then increase the minProvisionedTPS as necessary.

For more information about campaign costs, see Amazon Personalize pricing.

Status

A campaign can be in one of the following states:

To get the campaign status, call DescribeCampaign.

Wait until the status of the campaign is ACTIVE before asking the campaign for recommendations.

Related APIs

", "idempotent":true }, "CreateDataset":{ @@ -244,7 +244,7 @@ {"shape":"ResourceInUseException"}, {"shape":"TooManyTagsException"} ], - "documentation":"

Creates the configuration for training a model. A trained model is known as a solution version. After the configuration is created, you train the model (create a solution version) by calling the CreateSolutionVersion operation. Every time you call CreateSolutionVersion, a new version of the solution is created.

After creating a solution version, you check its accuracy by calling GetSolutionMetrics. When you are satisfied with the version, you deploy it using CreateCampaign. The campaign provides recommendations to a client through the GetRecommendations API.

To train a model, Amazon Personalize requires training data and a recipe. The training data comes from the dataset group that you provide in the request. A recipe specifies the training algorithm and a feature transformation. You can specify one of the predefined recipes provided by Amazon Personalize.

Amazon Personalize doesn't support configuring the hpoObjective for solution hyperparameter optimization at this time.

Status

A solution can be in one of the following states:

To get the status of the solution, call DescribeSolution. Wait until the status shows as ACTIVE before calling CreateSolutionVersion.

Related APIs

" + "documentation":"

After you create a solution, you can’t change its configuration. By default, all new solutions use automatic training. With automatic training, you incur training costs while your solution is active. You can't stop automatic training for a solution. To avoid unnecessary costs, make sure to delete the solution when you are finished. For information about training costs, see Amazon Personalize pricing.

Creates the configuration for training a model (creating a solution version). This configuration includes the recipe to use for model training and optional training configuration, such as columns to use in training and feature transformation parameters. For more information about configuring a solution, see Creating and configuring a solution.

By default, new solutions use automatic training to create solution versions every 7 days. You can change the training frequency. Automatic solution version creation starts one hour after the solution is ACTIVE. If you manually create a solution version within the hour, the solution skips the first automatic training. For more information, see Configuring automatic training.

To turn off automatic training, set performAutoTraining to false. If you turn off automatic training, you must manually create a solution version by calling the CreateSolutionVersion operation.

After training starts, you can get the solution version's Amazon Resource Name (ARN) with the ListSolutionVersions API operation. To get its status, use the DescribeSolutionVersion.

After training completes you can evaluate model accuracy by calling GetSolutionMetrics. When you are satisfied with the solution version, you deploy it using CreateCampaign. The campaign provides recommendations to a client through the GetRecommendations API.

Amazon Personalize doesn't support configuring the hpoObjective for solution hyperparameter optimization at this time.

Status

A solution can be in one of the following states:

To get the status of the solution, call DescribeSolution. If you use manual training, the status must be ACTIVE before you call CreateSolutionVersion.

Related APIs

" }, "CreateSolutionVersion":{ "name":"CreateSolutionVersion", @@ -903,7 +903,7 @@ {"shape":"InvalidInputException"}, {"shape":"InvalidNextTokenException"} ], - "documentation":"

Returns a list of solutions that use the given dataset group. When a dataset group is not specified, all the solutions associated with the account are listed. The response provides the properties for each solution, including the Amazon Resource Name (ARN). For more information on solutions, see CreateSolution.

", + "documentation":"

Returns a list of solutions in a given dataset group. When a dataset group is not specified, all the solutions associated with the account are listed. The response provides the properties for each solution, including the Amazon Resource Name (ARN). For more information on solutions, see CreateSolution.

", "idempotent":true }, "ListTagsForResource":{ @@ -999,7 +999,7 @@ {"shape":"TooManyTagKeysException"}, {"shape":"ResourceInUseException"} ], - "documentation":"

Remove tags that are attached to a resource.

" + "documentation":"

Removes the specified tags that are attached to a resource. For more information, see Removing tags from Amazon Personalize resources.

" }, "UpdateCampaign":{ "name":"UpdateCampaign", @@ -1014,7 +1014,7 @@ {"shape":"ResourceNotFoundException"}, {"shape":"ResourceInUseException"} ], - "documentation":"

Updates a campaign to deploy a retrained solution version with an existing campaign, change your campaign's minProvisionedTPS, or modify your campaign's configuration, such as the exploration configuration.

To update a campaign, the campaign status must be ACTIVE or CREATE FAILED. Check the campaign status using the DescribeCampaign operation.

You can still get recommendations from a campaign while an update is in progress. The campaign will use the previous solution version and campaign configuration to generate recommendations until the latest campaign update status is Active.

For more information about updating a campaign, including code samples, see Updating a campaign. For more information about campaigns, see Creating a campaign.

", + "documentation":"

Updates a campaign to deploy a retrained solution version with an existing campaign, change your campaign's minProvisionedTPS, or modify your campaign's configuration. For example, you can set enableMetadataWithRecommendations to true for an existing campaign.

To update a campaign to start automatically using the latest solution version, specify the following:

To update a campaign, the campaign status must be ACTIVE or CREATE FAILED. Check the campaign status using the DescribeCampaign operation.

You can still get recommendations from a campaign while an update is in progress. The campaign will use the previous solution version and campaign configuration to generate recommendations until the latest campaign update status is Active.

For more information about updating a campaign, including code samples, see Updating a campaign. For more information about campaigns, see Creating a campaign.

", "idempotent":true }, "UpdateDataset":{ @@ -1166,6 +1166,16 @@ }, "documentation":"

When the solution performs AutoML (performAutoML is true in CreateSolution), specifies the recipe that best optimized the specified metric.

" }, + "AutoTrainingConfig":{ + "type":"structure", + "members":{ + "schedulingExpression":{ + "shape":"SchedulingExpression", + "documentation":"

Specifies how often to automatically train new solution versions. Specify a rate expression in rate(value unit) format. For value, specify a number between 1 and 30. For unit, specify day or days. For example, to automatically create a new solution version every 5 days, specify rate(5 days). The default is every 7 days.

For more information about auto training, see Creating and configuring a solution.

" + } + }, + "documentation":"

The automatic training configuration to use when performAutoTraining is true.

" + }, "AvroSchema":{ "type":"string", "max":20000 @@ -1441,7 +1451,7 @@ }, "solutionVersionArn":{ "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of a specific version of the solution.

" + "documentation":"

The Amazon Resource Name (ARN) of the solution version the campaign uses.

" }, "minProvisionedTPS":{ "shape":"TransactionsPerSecond", @@ -1481,6 +1491,10 @@ "enableMetadataWithRecommendations":{ "shape":"Boolean", "documentation":"

Whether metadata with recommendations is enabled for the campaign. If enabled, you can specify the columns from your Items dataset in your request for recommendations. Amazon Personalize returns this data for each item in the recommendation response. For information about enabling metadata for a campaign, see Enabling metadata in recommendations for a campaign.

If you enable metadata in recommendations, you will incur additional costs. For more information, see Amazon Personalize pricing.

" + }, + "syncWithLatestSolutionVersion":{ + "shape":"Boolean", + "documentation":"

Whether the campaign automatically updates to use the latest solution version (trained model) of a solution. If you specify True, you must specify the ARN of your solution for the SolutionVersionArn parameter. It must be in SolutionArn/$LATEST format. The default is False and you must manually update the campaign to deploy the latest solution version.

For more information about automatic campaign updates, see Enabling automatic campaign updates.

" } }, "documentation":"

The configuration details of a campaign.

" @@ -1750,7 +1764,7 @@ }, "solutionVersionArn":{ "shape":"Arn", - "documentation":"

The Amazon Resource Name (ARN) of the solution version to deploy.

" + "documentation":"

The Amazon Resource Name (ARN) of the trained model to deploy with the campaign. To specify the latest solution version of your solution, specify the ARN of your solution in SolutionArn/$LATEST format. You must use this format if you set syncWithLatestSolutionVersion to True in the CampaignConfig.

To deploy a model that isn't the latest solution version of your solution, specify the ARN of the solution version.

For more information about automatic campaign updates, see Enabling automatic campaign updates.

" }, "minProvisionedTPS":{ "shape":"TransactionsPerSecond", @@ -2139,6 +2153,10 @@ "shape":"PerformAutoML", "documentation":"

We don't recommend enabling automated machine learning. Instead, match your use case to the available Amazon Personalize recipes. For more information, see Choosing a recipe.

Whether to perform automated machine learning (AutoML). The default is false. For this case, you must specify recipeArn.

When set to true, Amazon Personalize analyzes your training data and selects the optimal USER_PERSONALIZATION recipe and hyperparameters. In this case, you must omit recipeArn. Amazon Personalize determines the optimal recipe by running tests with different values for the hyperparameters. AutoML lengthens the training process as compared to selecting a specific recipe.

" }, + "performAutoTraining":{ + "shape":"PerformAutoTraining", + "documentation":"

Whether the solution uses automatic training to create new solution versions (trained models). The default is True and the solution automatically creates new solution versions every 7 days. You can change the training frequency by specifying a schedulingExpression in the AutoTrainingConfig as part of solution configuration. For more information about automatic training, see Configuring automatic training.

Automatic solution version creation starts one hour after the solution is ACTIVE. If you manually create a solution version within the hour, the solution skips the first automatic training.

After training starts, you can get the solution version's Amazon Resource Name (ARN) with the ListSolutionVersions API operation. To get its status, use the DescribeSolutionVersion.

" + }, "recipeArn":{ "shape":"Arn", "documentation":"

The Amazon Resource Name (ARN) of the recipe to use for model training. This is required when performAutoML is false. For information about different Amazon Personalize recipes and their ARNs, see Choosing a recipe.

" @@ -4046,7 +4064,7 @@ "members":{ "resourceArn":{ "shape":"Arn", - "documentation":"

The resource's Amazon Resource Name.

" + "documentation":"

The resource's Amazon Resource Name (ARN).

" } } }, @@ -4209,7 +4227,8 @@ }, "NextToken":{ "type":"string", - "max":1500 + "max":1500, + "pattern":"\\p{ASCII}{0,1500}" }, "NumBatchResults":{"type":"integer"}, "ObjectiveSensitivity":{ @@ -4244,6 +4263,10 @@ "max":1000 }, "PerformAutoML":{"type":"boolean"}, + "PerformAutoTraining":{ + "type":"boolean", + "box":true + }, "PerformHPO":{"type":"boolean"}, "Recipe":{ "type":"structure", @@ -4526,6 +4549,12 @@ "max":256, "pattern":"(s3|http|https)://.+" }, + "SchedulingExpression":{ + "type":"string", + "max":16, + "min":1, + "pattern":"rate\\(\\d+ days?\\)" + }, "Schemas":{ "type":"list", "member":{"shape":"DatasetSchemaSummary"}, @@ -4550,6 +4579,10 @@ "shape":"PerformAutoML", "documentation":"

We don't recommend enabling automated machine learning. Instead, match your use case to the available Amazon Personalize recipes. For more information, see Determining your use case.

When true, Amazon Personalize performs a search for the best USER_PERSONALIZATION recipe from the list specified in the solution configuration (recipeArn must not be specified). When false (the default), Amazon Personalize uses recipeArn for training.

" }, + "performAutoTraining":{ + "shape":"PerformAutoTraining", + "documentation":"

Specifies whether the solution automatically creates solution versions. The default is True and the solution automatically creates new solution versions every 7 days.

For more information about auto training, see Creating and configuring a solution.

" + }, "recipeArn":{ "shape":"Arn", "documentation":"

The ARN of the recipe used to create the solution. This is required when performAutoML is false.

" @@ -4587,7 +4620,7 @@ "documentation":"

Describes the latest version of the solution, including the status and the ARN.

" } }, - "documentation":"

An object that provides information about a solution. A solution is a trained model that can be deployed as a campaign.

" + "documentation":"

After you create a solution, you can’t change its configuration. By default, all new solutions use automatic training. With automatic training, you incur training costs while your solution is active. You can't stop automatic training for a solution. To avoid unnecessary costs, make sure to delete the solution when you are finished. For information about training costs, see Amazon Personalize pricing.

An object that provides information about a solution. A solution includes the custom recipe, customized parameters, and trained models (Solution Versions) that Amazon Personalize uses to generate recommendations.

After you create a solution, you can’t change its configuration. If you need to make changes, you can clone the solution with the Amazon Personalize console or create a new one.

" }, "SolutionConfig":{ "type":"structure", @@ -4619,6 +4652,10 @@ "trainingDataConfig":{ "shape":"TrainingDataConfig", "documentation":"

Specifies the training data configuration to use when creating a custom solution version (trained model).

" + }, + "autoTrainingConfig":{ + "shape":"AutoTrainingConfig", + "documentation":"

Specifies the automatic training configuration to use.

" } }, "documentation":"

Describes the configuration properties for the solution.

" @@ -4698,7 +4735,7 @@ }, "trainingMode":{ "shape":"TrainingMode", - "documentation":"

The scope of training to be performed when creating the solution version. The FULL option trains the solution version based on the entirety of the input solution's training data, while the UPDATE option processes only the data that has changed in comparison to the input solution. Choose UPDATE when you want to incrementally update your solution version instead of creating an entirely new one.

The UPDATE option can only be used when you already have an active solution version created from the input solution using the FULL option and the input solution was trained with the User-Personalization recipe or the HRNN-Coldstart recipe.

" + "documentation":"

The scope of training to be performed when creating the solution version. A FULL training considers all of the data in your dataset group. An UPDATE processes only the data that has changed since the latest training. Only solution versions created with the User-Personalization recipe can use UPDATE.

" }, "tunedHPOParams":{ "shape":"TunedHPOParams", @@ -4719,6 +4756,10 @@ "lastUpdatedDateTime":{ "shape":"Date", "documentation":"

The date and time (in Unix time) that the solution was last updated.

" + }, + "trainingType":{ + "shape":"TrainingType", + "documentation":"

Whether the solution version was created automatically or manually.

" } }, "documentation":"

An object that provides information about a specific version of a Solution in a Custom dataset group.

" @@ -4734,6 +4775,14 @@ "shape":"Status", "documentation":"

The status of the solution version.

A solution version can be in one of the following states:

" }, + "trainingMode":{ + "shape":"TrainingMode", + "documentation":"

The scope of training to be performed when creating the solution version. A FULL training considers all of the data in your dataset group. An UPDATE processes only the data that has changed since the latest training. Only solution versions created with the User-Personalization recipe can use UPDATE.

" + }, + "trainingType":{ + "shape":"TrainingType", + "documentation":"

Whether the solution version was created automatically or manually.

" + }, "creationDateTime":{ "shape":"Date", "documentation":"

The date and time (in Unix time) that this version of a solution was created.

" @@ -4827,7 +4876,7 @@ "documentation":"

The optional part of a key-value pair that makes up a tag. A value acts as a descriptor within a tag category (key).

" } }, - "documentation":"

The optional metadata that you apply to resources to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define. For more information see Tagging Amazon Personalize recources.

" + "documentation":"

The optional metadata that you apply to resources to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define. For more information see Tagging Amazon Personalize resources.

" }, "TagKey":{ "type":"string", @@ -4854,7 +4903,7 @@ }, "tags":{ "shape":"Tags", - "documentation":"

Tags to apply to the resource. For more information see Tagging Amazon Personalize recources.

" + "documentation":"

Tags to apply to the resource. For more information see Tagging Amazon Personalize resources.

" } } }, @@ -4911,7 +4960,7 @@ "members":{ "excludedDatasetColumns":{ "shape":"ExcludedDatasetColumns", - "documentation":"

Specifies the columns to exclude from training. Each key is a dataset type, and each value is a list of columns. Exclude columns to control what data Amazon Personalize uses to generate recommendations. For example, you might have a column that you want to use only to filter recommendations. You can exclude this column from training and Amazon Personalize considers it only when filtering.

" + "documentation":"

Specifies the columns to exclude from training. Each key is a dataset type, and each value is a list of columns. Exclude columns to control what data Amazon Personalize uses to generate recommendations.

For example, you might have a column that you want to use only to filter recommendations. You can exclude this column from training and Amazon Personalize considers it only when filtering.

" } }, "documentation":"

The training data configuration to use when creating a domain recommender or custom solution version (trained model).

" @@ -4928,7 +4977,15 @@ "type":"string", "enum":[ "FULL", - "UPDATE" + "UPDATE", + "AUTOTRAIN" + ] + }, + "TrainingType":{ + "type":"string", + "enum":[ + "AUTOMATIC", + "MANUAL" ] }, "TransactionsPerSecond":{ @@ -4959,7 +5016,7 @@ }, "tagKeys":{ "shape":"TagKeys", - "documentation":"

Keys to remove from the resource's tags.

" + "documentation":"

The keys of the tags to be removed.

" } } }, @@ -4978,7 +5035,7 @@ }, "solutionVersionArn":{ "shape":"Arn", - "documentation":"

The ARN of a new solution version to deploy.

" + "documentation":"

The Amazon Resource Name (ARN) of a new model to deploy. To specify the latest solution version of your solution, specify the ARN of your solution in SolutionArn/$LATEST format. You must use this format if you set syncWithLatestSolutionVersion to True in the CampaignConfig.

To deploy a model that isn't the latest solution version of your solution, specify the ARN of the solution version.

For more information about automatic campaign updates, see Enabling automatic campaign updates.

" }, "minProvisionedTPS":{ "shape":"TransactionsPerSecond", From 548a3d9f30493659c6d2a2968a5ded02c2417b79 Mon Sep 17 00:00:00 2001 From: aws-sdk-python-automation Date: Fri, 19 Apr 2024 18:13:23 +0000 Subject: [PATCH 2/2] Bumping version to 1.34.88 --- .changes/1.34.88.json | 17 +++++++++++++++++ .../next-release/api-change-glue-12902.json | 5 ----- .../api-change-internetmonitor-7520.json | 5 ----- .../api-change-personalize-2044.json | 5 ----- CHANGELOG.rst | 8 ++++++++ botocore/__init__.py | 2 +- docs/source/conf.py | 2 +- 7 files changed, 27 insertions(+), 17 deletions(-) create mode 100644 .changes/1.34.88.json delete mode 100644 .changes/next-release/api-change-glue-12902.json delete mode 100644 .changes/next-release/api-change-internetmonitor-7520.json delete mode 100644 .changes/next-release/api-change-personalize-2044.json diff --git a/.changes/1.34.88.json b/.changes/1.34.88.json new file mode 100644 index 0000000000..304ee0af71 --- /dev/null +++ b/.changes/1.34.88.json @@ -0,0 +1,17 @@ +[ + { + "category": "``glue``", + "description": "Adding RowFilter in the response for GetUnfilteredTableMetadata API", + "type": "api-change" + }, + { + "category": "``internetmonitor``", + "description": "This update introduces the GetInternetEvent and ListInternetEvents APIs, which provide access to internet events displayed on the Amazon CloudWatch Internet Weather Map.", + "type": "api-change" + }, + { + "category": "``personalize``", + "description": "This releases auto training capability while creating a solution and automatically syncing latest solution versions when creating/updating a campaign", + "type": "api-change" + } +] \ No newline at end of file diff --git a/.changes/next-release/api-change-glue-12902.json b/.changes/next-release/api-change-glue-12902.json deleted file mode 100644 index 1be185d966..0000000000 --- a/.changes/next-release/api-change-glue-12902.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``glue``", - "description": "Adding RowFilter in the response for GetUnfilteredTableMetadata API" -} diff --git a/.changes/next-release/api-change-internetmonitor-7520.json b/.changes/next-release/api-change-internetmonitor-7520.json deleted file mode 100644 index 3e4cdc2bd8..0000000000 --- a/.changes/next-release/api-change-internetmonitor-7520.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``internetmonitor``", - "description": "This update introduces the GetInternetEvent and ListInternetEvents APIs, which provide access to internet events displayed on the Amazon CloudWatch Internet Weather Map." -} diff --git a/.changes/next-release/api-change-personalize-2044.json b/.changes/next-release/api-change-personalize-2044.json deleted file mode 100644 index 8c890a05fd..0000000000 --- a/.changes/next-release/api-change-personalize-2044.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``personalize``", - "description": "This releases auto training capability while creating a solution and automatically syncing latest solution versions when creating/updating a campaign" -} diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 83d9affdce..79ef89c47b 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -2,6 +2,14 @@ CHANGELOG ========= +1.34.88 +======= + +* api-change:``glue``: Adding RowFilter in the response for GetUnfilteredTableMetadata API +* api-change:``internetmonitor``: This update introduces the GetInternetEvent and ListInternetEvents APIs, which provide access to internet events displayed on the Amazon CloudWatch Internet Weather Map. +* api-change:``personalize``: This releases auto training capability while creating a solution and automatically syncing latest solution versions when creating/updating a campaign + + 1.34.87 ======= diff --git a/botocore/__init__.py b/botocore/__init__.py index fbd2c18faf..0c483a16c3 100644 --- a/botocore/__init__.py +++ b/botocore/__init__.py @@ -16,7 +16,7 @@ import os import re -__version__ = '1.34.87' +__version__ = '1.34.88' class NullHandler(logging.Handler): diff --git a/docs/source/conf.py b/docs/source/conf.py index 25bf898d86..c57bc2be32 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -59,7 +59,7 @@ # The short X.Y version. version = '1.34.' # The full version, including alpha/beta/rc tags. -release = '1.34.87' +release = '1.34.88' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages.