From a8fd8ddfba5f5356eb7952b724e22fc14aba710b Mon Sep 17 00:00:00 2001 From: aws-sdk-python-automation Date: Thu, 20 Jun 2024 18:09:28 +0000 Subject: [PATCH 1/3] Update to latest models --- .../api-change-bedrockruntime-87779.json | 5 + .../api-change-codeartifact-37143.json | 5 + .../api-change-computeoptimizer-26348.json | 5 + .../api-change-costoptimizationhub-37.json | 5 + .../next-release/api-change-dynamodb-925.json | 5 + .../next-release/api-change-glue-63425.json | 5 + .../api-change-ivsrealtime-98511.json | 5 + .../api-change-sagemaker-52623.json | 5 + .../api-change-securityhub-2982.json | 5 + .../bedrock-runtime/2023-09-30/service-2.json | 65 ++ .../codeartifact/2018-09-22/service-2.json | 61 +- .../2019-11-01/service-2.json | 804 +++++++++++++++-- .../2022-07-26/service-2.json | 834 ++++++++++-------- .../2022-07-26/waiters-2.json | 5 + .../data/dynamodb/2012-08-10/service-2.json | 15 +- .../data/glue/2017-03-31/paginators-1.json | 30 + .../ivs-realtime/2020-07-14/service-2.json | 725 ++++++++------- .../ivs-realtime/2020-07-14/waiters-2.json | 5 + .../data/sagemaker/2017-07-24/service-2.json | 205 ++++- .../securityhub/2018-10-26/service-2.json | 7 +- 20 files changed, 1990 insertions(+), 811 deletions(-) create mode 100644 .changes/next-release/api-change-bedrockruntime-87779.json create mode 100644 .changes/next-release/api-change-codeartifact-37143.json create mode 100644 .changes/next-release/api-change-computeoptimizer-26348.json create mode 100644 .changes/next-release/api-change-costoptimizationhub-37.json create mode 100644 .changes/next-release/api-change-dynamodb-925.json create mode 100644 .changes/next-release/api-change-glue-63425.json create mode 100644 .changes/next-release/api-change-ivsrealtime-98511.json create mode 100644 .changes/next-release/api-change-sagemaker-52623.json create mode 100644 .changes/next-release/api-change-securityhub-2982.json create mode 100644 botocore/data/cost-optimization-hub/2022-07-26/waiters-2.json create mode 100644 botocore/data/ivs-realtime/2020-07-14/waiters-2.json diff --git a/.changes/next-release/api-change-bedrockruntime-87779.json b/.changes/next-release/api-change-bedrockruntime-87779.json new file mode 100644 index 0000000000..ba45d7c8f3 --- /dev/null +++ b/.changes/next-release/api-change-bedrockruntime-87779.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``bedrock-runtime``", + "description": "This release adds document support to Converse and ConverseStream APIs" +} diff --git a/.changes/next-release/api-change-codeartifact-37143.json b/.changes/next-release/api-change-codeartifact-37143.json new file mode 100644 index 0000000000..1116f603b6 --- /dev/null +++ b/.changes/next-release/api-change-codeartifact-37143.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``codeartifact``", + "description": "Add support for the Cargo package format." +} diff --git a/.changes/next-release/api-change-computeoptimizer-26348.json b/.changes/next-release/api-change-computeoptimizer-26348.json new file mode 100644 index 0000000000..3d917c2941 --- /dev/null +++ b/.changes/next-release/api-change-computeoptimizer-26348.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``compute-optimizer``", + "description": "This release enables AWS Compute Optimizer to analyze and generate optimization recommendations for Amazon RDS MySQL and RDS PostgreSQL." +} diff --git a/.changes/next-release/api-change-costoptimizationhub-37.json b/.changes/next-release/api-change-costoptimizationhub-37.json new file mode 100644 index 0000000000..6ba04f5454 --- /dev/null +++ b/.changes/next-release/api-change-costoptimizationhub-37.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``cost-optimization-hub``", + "description": "This release enables AWS Cost Optimization Hub to show cost optimization recommendations for Amazon RDS MySQL and RDS PostgreSQL." +} diff --git a/.changes/next-release/api-change-dynamodb-925.json b/.changes/next-release/api-change-dynamodb-925.json new file mode 100644 index 0000000000..60a52f69bc --- /dev/null +++ b/.changes/next-release/api-change-dynamodb-925.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``dynamodb``", + "description": "Doc-only update for DynamoDB. Fixed Important note in 6 Global table APIs - CreateGlobalTable, DescribeGlobalTable, DescribeGlobalTableSettings, ListGlobalTables, UpdateGlobalTable, and UpdateGlobalTableSettings." +} diff --git a/.changes/next-release/api-change-glue-63425.json b/.changes/next-release/api-change-glue-63425.json new file mode 100644 index 0000000000..ad0fc85c01 --- /dev/null +++ b/.changes/next-release/api-change-glue-63425.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``glue``", + "description": "Fix Glue paginators for Jobs, JobRuns, Triggers, Blueprints and Workflows." +} diff --git a/.changes/next-release/api-change-ivsrealtime-98511.json b/.changes/next-release/api-change-ivsrealtime-98511.json new file mode 100644 index 0000000000..409bc56d63 --- /dev/null +++ b/.changes/next-release/api-change-ivsrealtime-98511.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``ivs-realtime``", + "description": "IVS Real-Time now offers customers the ability to record individual stage participants to S3." +} diff --git a/.changes/next-release/api-change-sagemaker-52623.json b/.changes/next-release/api-change-sagemaker-52623.json new file mode 100644 index 0000000000..0b3bfe0cce --- /dev/null +++ b/.changes/next-release/api-change-sagemaker-52623.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``sagemaker``", + "description": "Adds support for model references in Hub service, and adds support for cross-account access of Hubs" +} diff --git a/.changes/next-release/api-change-securityhub-2982.json b/.changes/next-release/api-change-securityhub-2982.json new file mode 100644 index 0000000000..24ff2c5ba5 --- /dev/null +++ b/.changes/next-release/api-change-securityhub-2982.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``securityhub``", + "description": "Documentation updates for Security Hub" +} diff --git a/botocore/data/bedrock-runtime/2023-09-30/service-2.json b/botocore/data/bedrock-runtime/2023-09-30/service-2.json index a31e30c5b5..734e1c3bd7 100644 --- a/botocore/data/bedrock-runtime/2023-09-30/service-2.json +++ b/botocore/data/bedrock-runtime/2023-09-30/service-2.json @@ -142,6 +142,10 @@ "shape":"ImageBlock", "documentation":"

Image to include in the message.

This field is only supported by Anthropic Claude 3 models.

" }, + "document":{ + "shape":"DocumentBlock", + "documentation":"

A document to include in the message.

" + }, "toolUse":{ "shape":"ToolUseBlock", "documentation":"

Information about a tool use request from a model.

" @@ -533,6 +537,63 @@ }, "document":true }, + "DocumentBlock":{ + "type":"structure", + "required":[ + "format", + "name", + "source" + ], + "members":{ + "format":{ + "shape":"DocumentFormat", + "documentation":"

The format of a document, or its extension.

" + }, + "name":{ + "shape":"DocumentBlockNameString", + "documentation":"

A name for the document.

" + }, + "source":{ + "shape":"DocumentSource", + "documentation":"

Contains the content of the document.

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

A document to include in a message when sending a Converse or ConverseStream request. You can include up to 5 documents in a request. The maximum document size is 50 MB.

" + }, + "DocumentBlockNameString":{ + "type":"string", + "max":64, + "min":1 + }, + "DocumentFormat":{ + "type":"string", + "enum":[ + "pdf", + "csv", + "doc", + "docx", + "xls", + "xlsx", + "html", + "txt", + "md" + ] + }, + "DocumentSource":{ + "type":"structure", + "members":{ + "bytes":{ + "shape":"DocumentSourceBytesBlob", + "documentation":"

A base64-encoded string of a UTF-8 encoded file, that is the document to include in the message.

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

Contains the content of the document included in a message when sending a Converse or ConverseStream request or in the response.

", + "union":true + }, + "DocumentSourceBytesBlob":{ + "type":"blob", + "min":1 + }, "GuardrailAssessment":{ "type":"structure", "members":{ @@ -1633,6 +1694,10 @@ "image":{ "shape":"ImageBlock", "documentation":"

A tool result that is an image.

This field is only supported by Anthropic Claude 3 models.

" + }, + "document":{ + "shape":"DocumentBlock", + "documentation":"

A tool result that is a document.

" } }, "documentation":"

The tool result content block.

", diff --git a/botocore/data/codeartifact/2018-09-22/service-2.json b/botocore/data/codeartifact/2018-09-22/service-2.json index 10df5d9dc9..47941f71f9 100644 --- a/botocore/data/codeartifact/2018-09-22/service-2.json +++ b/botocore/data/codeartifact/2018-09-22/service-2.json @@ -5,11 +5,13 @@ "endpointPrefix":"codeartifact", "jsonVersion":"1.1", "protocol":"rest-json", + "protocols":["rest-json"], "serviceFullName":"CodeArtifact", "serviceId":"codeartifact", "signatureVersion":"v4", "signingName":"codeartifact", - "uid":"codeartifact-2018-09-22" + "uid":"codeartifact-2018-09-22", + "auth":["aws.auth#sigv4"] }, "operations":{ "AssociateExternalConnection":{ @@ -457,7 +459,7 @@ {"shape":"ThrottlingException"}, {"shape":"ValidationException"} ], - "documentation":"

Returns the endpoint of a repository for a specific package format. A repository has one endpoint for each package format:

" + "documentation":"

Returns the endpoint of a repository for a specific package format. A repository has one endpoint for each package format:

" }, "GetRepositoryPermissionsPolicy":{ "name":"GetRepositoryPermissionsPolicy", @@ -963,7 +965,7 @@ }, "externalConnection":{ "shape":"ExternalConnectionName", - "documentation":"

The name of the external connection to add to the repository. The following values are supported:

", + "documentation":"

The name of the external connection to add to the repository. The following values are supported:

", "location":"querystring", "locationName":"external-connection" } @@ -987,7 +989,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the associated package. The package component that specifies its namespace depends on its type. For example:

" + "documentation":"

The namespace of the associated package. The package component that specifies its namespace depends on its type. For example:

" }, "package":{ "shape":"PackageName", @@ -1070,7 +1072,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package versions to be copied. The package component that specifies its namespace depends on its type. For example:

The namespace is required when copying package versions of the following formats:

 ", + "documentation":"

The namespace of the package versions to be copied. The package component that specifies its namespace depends on its type. For example:

The namespace is required when copying package versions of the following formats:

 ", "location":"querystring", "locationName":"namespace" }, @@ -1365,7 +1367,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package to delete. The package component that specifies its namespace depends on its type. For example:

The namespace is required when deleting packages of the following formats:

 ", + "documentation":"

The namespace of the package to delete. The package component that specifies its namespace depends on its type. For example:

The namespace is required when deleting packages of the following formats:

 ", "location":"querystring", "locationName":"namespace" }, @@ -1419,7 +1421,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package versions to be deleted. The package component that specifies its namespace depends on its type. For example:

The namespace is required when deleting package versions of the following formats:

 ", + "documentation":"

The namespace of the package versions to be deleted. The package component that specifies its namespace depends on its type. For example:

The namespace is required when deleting package versions of the following formats:

 ", "location":"querystring", "locationName":"namespace" }, @@ -1625,7 +1627,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the requested package. The package component that specifies its namespace depends on its type. For example:

The namespace is required when requesting packages of the following formats:

 ", + "documentation":"

The namespace of the requested package. The package component that specifies its namespace depends on its type. For example:

The namespace is required when requesting packages of the following formats:

 ", "location":"querystring", "locationName":"namespace" }, @@ -1683,7 +1685,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the requested package version. The package component that specifies its namespace depends on its type. For example:

The namespace is required when requesting package versions of the following formats:

 ", + "documentation":"

The namespace of the requested package version. The package component that specifies its namespace depends on its type. For example:

The namespace is required when requesting package versions of the following formats:

 ", "location":"querystring", "locationName":"namespace" }, @@ -1831,7 +1833,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package versions to be disposed. The package component that specifies its namespace depends on its type. For example:

The namespace is required when disposing package versions of the following formats:

 ", + "documentation":"

The namespace of the package versions to be disposed. The package component that specifies its namespace depends on its type. For example:

The namespace is required when disposing package versions of the following formats:

 ", "location":"querystring", "locationName":"namespace" }, @@ -2010,7 +2012,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package from which to get the associated package group. The package component that specifies its namespace depends on its type. For example:

The namespace is required when getting associated package groups from packages of the following formats:

 ", + "documentation":"

The namespace of the package from which to get the associated package group. The package component that specifies its namespace depends on its type. For example:

The namespace is required when getting associated package groups from packages of the following formats:

 ", "location":"querystring", "locationName":"namespace" }, @@ -2137,7 +2139,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package version with the requested asset file. The package component that specifies its namespace depends on its type. For example:

The namespace is required when requesting assets from package versions of the following formats:

 ", + "documentation":"

The namespace of the package version with the requested asset file. The package component that specifies its namespace depends on its type. For example:

The namespace is required when requesting assets from package versions of the following formats:

 ", "location":"querystring", "locationName":"namespace" }, @@ -2231,7 +2233,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package version with the requested readme file. The package component that specifies its namespace depends on its type. For example:

The namespace is required when requesting the readme from package versions of the following formats:

 ", + "documentation":"

The namespace of the package version with the requested readme file. The package component that specifies its namespace depends on its type. For example:

The namespace is required when requesting the readme from package versions of the following formats:

 ", "location":"querystring", "locationName":"namespace" }, @@ -2258,7 +2260,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package version with the requested readme file. The package component that specifies its namespace depends on its type. For example:

" + "documentation":"

The namespace of the package version with the requested readme file. The package component that specifies its namespace depends on its type. For example:

" }, "package":{ "shape":"PackageName", @@ -2650,7 +2652,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package version that contains the requested package version assets. The package component that specifies its namespace depends on its type. For example:

The namespace is required requesting assets from package versions of the following formats:

 ", + "documentation":"

The namespace of the package version that contains the requested package version assets. The package component that specifies its namespace depends on its type. For example:

The namespace is required requesting assets from package versions of the following formats:

 ", "location":"querystring", "locationName":"namespace" }, @@ -2689,7 +2691,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package version that contains the requested package version assets. The package component that specifies its namespace depends on its type. For example:

" + "documentation":"

The namespace of the package version that contains the requested package version assets. The package component that specifies its namespace depends on its type. For example:

" }, "package":{ "shape":"PackageName", @@ -2749,7 +2751,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package version with the requested dependencies. The package component that specifies its namespace depends on its type. For example:

The namespace is required when listing dependencies from package versions of the following formats:

 ", + "documentation":"

The namespace of the package version with the requested dependencies. The package component that specifies its namespace depends on its type. For example:

The namespace is required when listing dependencies from package versions of the following formats:

 ", "location":"querystring", "locationName":"namespace" }, @@ -2782,7 +2784,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package version that contains the returned dependencies. The package component that specifies its namespace depends on its type. For example:

" + "documentation":"

The namespace of the package version that contains the returned dependencies. The package component that specifies its namespace depends on its type. For example:

The namespace is required when listing dependencies from package versions of the following formats:

 " }, "package":{ "shape":"PackageName", @@ -2846,7 +2848,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package that contains the requested package versions. The package component that specifies its namespace depends on its type. For example:

The namespace is required when deleting package versions of the following formats:

 ", + "documentation":"

The namespace of the package that contains the requested package versions. The package component that specifies its namespace depends on its type. For example:

The namespace is required when deleting package versions of the following formats:

 ", "location":"querystring", "locationName":"namespace" }, @@ -2901,7 +2903,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package that contains the requested package versions. The package component that specifies its namespace depends on its type. For example:

" + "documentation":"

The namespace of the package that contains the requested package versions. The package component that specifies its namespace depends on its type. For example:

" }, "package":{ "shape":"PackageName", @@ -2955,7 +2957,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace prefix used to filter requested packages. Only packages with a namespace that starts with the provided string value are returned. Note that although this option is called --namespace and not --namespace-prefix, it has prefix-matching behavior.

Each package format uses namespace as follows:

", + "documentation":"

The namespace prefix used to filter requested packages. Only packages with a namespace that starts with the provided string value are returned. Note that although this option is called --namespace and not --namespace-prefix, it has prefix-matching behavior.

Each package format uses namespace as follows:

", "location":"querystring", "locationName":"namespace" }, @@ -3190,7 +3192,7 @@ "members":{ "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package that this package depends on. The package component that specifies its namespace depends on its type. For example:

" + "documentation":"

The namespace of the package that this package depends on. The package component that specifies its namespace depends on its type. For example:

" }, "package":{ "shape":"PackageName", @@ -3220,7 +3222,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package. The package component that specifies its namespace depends on its type. For example:

" + "documentation":"

The namespace of the package. The package component that specifies its namespace depends on its type. For example:

" }, "name":{ "shape":"PackageName", @@ -3242,7 +3244,8 @@ "nuget", "generic", "ruby", - "swift" + "swift", + "cargo" ] }, "PackageGroupAllowedRepository":{ @@ -3510,7 +3513,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package. The package component that specifies its namespace depends on its type. For example:

" + "documentation":"

The namespace of the package. The package component that specifies its namespace depends on its type. For example:

" }, "package":{ "shape":"PackageName", @@ -3542,7 +3545,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package version. The package component that specifies its namespace depends on its type. For example:

" + "documentation":"

The namespace of the package version. The package component that specifies its namespace depends on its type. For example:

" }, "packageName":{ "shape":"PackageName", @@ -3905,7 +3908,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package to be updated. The package component that specifies its namespace depends on its type. For example:

", + "documentation":"

The namespace of the package to be updated. The package component that specifies its namespace depends on its type. For example:

", "location":"querystring", "locationName":"namespace" }, @@ -4421,7 +4424,7 @@ }, "namespace":{ "shape":"PackageNamespace", - "documentation":"

The namespace of the package version to be updated. The package component that specifies its namespace depends on its type. For example:

", + "documentation":"

The namespace of the package version to be updated. The package component that specifies its namespace depends on its type. For example:

", "location":"querystring", "locationName":"namespace" }, @@ -4560,5 +4563,5 @@ ] } }, - "documentation":"

CodeArtifact is a fully managed artifact repository compatible with language-native package managers and build tools such as npm, Apache Maven, pip, and dotnet. You can use CodeArtifact to share packages with development teams and pull packages. Packages can be pulled from both public and CodeArtifact repositories. You can also create an upstream relationship between a CodeArtifact repository and another repository, which effectively merges their contents from the point of view of a package manager client.

CodeArtifact concepts

CodeArtifact supported API operations

" + "documentation":"

CodeArtifact is a fully managed artifact repository compatible with language-native package managers and build tools such as npm, Apache Maven, pip, and dotnet. You can use CodeArtifact to share packages with development teams and pull packages. Packages can be pulled from both public and CodeArtifact repositories. You can also create an upstream relationship between a CodeArtifact repository and another repository, which effectively merges their contents from the point of view of a package manager client.

CodeArtifact concepts

CodeArtifact supported API operations

" } diff --git a/botocore/data/compute-optimizer/2019-11-01/service-2.json b/botocore/data/compute-optimizer/2019-11-01/service-2.json index 3d3eaf8493..b2a0411918 100644 --- a/botocore/data/compute-optimizer/2019-11-01/service-2.json +++ b/botocore/data/compute-optimizer/2019-11-01/service-2.json @@ -5,12 +5,14 @@ "endpointPrefix":"compute-optimizer", "jsonVersion":"1.0", "protocol":"json", + "protocols":["json"], "serviceFullName":"AWS Compute Optimizer", "serviceId":"Compute Optimizer", "signatureVersion":"v4", "signingName":"compute-optimizer", "targetPrefix":"ComputeOptimizerService", - "uid":"compute-optimizer-2019-11-01" + "uid":"compute-optimizer-2019-11-01", + "auth":["aws.auth#sigv4"] }, "operations":{ "DeleteRecommendationPreferences":{ @@ -173,6 +175,26 @@ ], "documentation":"

Export optimization recommendations for your licenses.

Recommendations are exported in a comma-separated values (CSV) file, and its metadata in a JavaScript Object Notation (JSON) file, to an existing Amazon Simple Storage Service (Amazon S3) bucket that you specify. For more information, see Exporting Recommendations in the Compute Optimizer User Guide.

You can have only one license export job in progress per Amazon Web Services Region.

" }, + "ExportRDSDatabaseRecommendations":{ + "name":"ExportRDSDatabaseRecommendations", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ExportRDSDatabaseRecommendationsRequest"}, + "output":{"shape":"ExportRDSDatabaseRecommendationsResponse"}, + "errors":[ + {"shape":"OptInRequiredException"}, + {"shape":"InternalServerException"}, + {"shape":"ServiceUnavailableException"}, + {"shape":"AccessDeniedException"}, + {"shape":"InvalidParameterValueException"}, + {"shape":"MissingAuthenticationToken"}, + {"shape":"ThrottlingException"}, + {"shape":"LimitExceededException"} + ], + "documentation":"

Export optimization recommendations for your Amazon Relational Database Service (Amazon RDS).

Recommendations are exported in a comma-separated values (CSV) file, and its metadata in a JavaScript Object Notation (JSON) file, to an existing Amazon Simple Storage Service (Amazon S3) bucket that you specify. For more information, see Exporting Recommendations in the Compute Optimizer User Guide.

You can have only one Amazon RDS export job in progress per Amazon Web Services Region.

" + }, "GetAutoScalingGroupRecommendations":{ "name":"GetAutoScalingGroupRecommendations", "http":{ @@ -389,6 +411,46 @@ ], "documentation":"

Returns license recommendations for Amazon EC2 instances that run on a specific license.

Compute Optimizer generates recommendations for licenses that meet a specific set of requirements. For more information, see the Supported resources and requirements in the Compute Optimizer User Guide.

" }, + "GetRDSDatabaseRecommendationProjectedMetrics":{ + "name":"GetRDSDatabaseRecommendationProjectedMetrics", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"GetRDSDatabaseRecommendationProjectedMetricsRequest"}, + "output":{"shape":"GetRDSDatabaseRecommendationProjectedMetricsResponse"}, + "errors":[ + {"shape":"OptInRequiredException"}, + {"shape":"InternalServerException"}, + {"shape":"ServiceUnavailableException"}, + {"shape":"AccessDeniedException"}, + {"shape":"InvalidParameterValueException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"MissingAuthenticationToken"}, + {"shape":"ThrottlingException"} + ], + "documentation":"

Returns the projected metrics of Amazon RDS recommendations.

" + }, + "GetRDSDatabaseRecommendations":{ + "name":"GetRDSDatabaseRecommendations", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"GetRDSDatabaseRecommendationsRequest"}, + "output":{"shape":"GetRDSDatabaseRecommendationsResponse"}, + "errors":[ + {"shape":"OptInRequiredException"}, + {"shape":"InternalServerException"}, + {"shape":"ServiceUnavailableException"}, + {"shape":"AccessDeniedException"}, + {"shape":"InvalidParameterValueException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"MissingAuthenticationToken"}, + {"shape":"ThrottlingException"} + ], + "documentation":"

Returns Amazon RDS recommendations.

Compute Optimizer generates recommendations for Amazon RDS that meet a specific set of requirements. For more information, see the Supported resources and requirements in the Compute Optimizer User Guide.

" + }, "GetRecommendationPreferences":{ "name":"GetRecommendationPreferences", "http":{ @@ -508,6 +570,7 @@ "type":"list", "member":{"shape":"AccountId"} }, + "AllocatedStorage":{"type":"integer"}, "AutoScalingConfiguration":{ "type":"string", "enum":[ @@ -588,6 +651,10 @@ "shape":"AutoScalingGroupConfiguration", "documentation":"

An array of objects that describe the current configuration of the Auto Scaling group.

" }, + "currentInstanceGpuInfo":{ + "shape":"GpuInfo", + "documentation":"

Describes the GPU accelerator settings for the current instance type of the Auto Scaling group.

" + }, "recommendationOptions":{ "shape":"AutoScalingGroupRecommendationOptions", "documentation":"

An array of objects that describe the recommendation options for the Auto Scaling group.

" @@ -607,10 +674,6 @@ "inferredWorkloadTypes":{ "shape":"InferredWorkloadTypes", "documentation":"

The applications that might be running on the instances in the Auto Scaling group as inferred by Compute Optimizer.

Compute Optimizer can infer if one of the following applications might be running on the instances:

" - }, - "currentInstanceGpuInfo":{ - "shape":"GpuInfo", - "documentation":"

Describes the GPU accelerator settings for the current instance type of the Auto Scaling group.

" } }, "documentation":"

Describes an Auto Scaling group recommendation.

" @@ -622,6 +685,10 @@ "shape":"AutoScalingGroupConfiguration", "documentation":"

An array of objects that describe an Auto Scaling group configuration.

" }, + "instanceGpuInfo":{ + "shape":"GpuInfo", + "documentation":"

Describes the GPU accelerator settings for the recommended instance type of the Auto Scaling group.

" + }, "projectedUtilizationMetrics":{ "shape":"ProjectedUtilizationMetrics", "documentation":"

An array of objects that describe the projected utilization metrics of the Auto Scaling group recommendation option.

The Cpu and Memory metrics are the only projected utilization metrics returned. Additionally, the Memory metric is returned only for resources that have the unified CloudWatch agent installed on them. For more information, see Enabling Memory Utilization with the CloudWatch Agent.

" @@ -638,17 +705,13 @@ "shape":"SavingsOpportunity", "documentation":"

An object that describes the savings opportunity for the Auto Scaling group recommendation option. Savings opportunity includes the estimated monthly savings amount and percentage.

" }, - "migrationEffort":{ - "shape":"MigrationEffort", - "documentation":"

The level of effort required to migrate from the current instance type to the recommended instance type.

For example, the migration effort is Low if Amazon EMR is the inferred workload type and an Amazon Web Services Graviton instance type is recommended. The migration effort is Medium if a workload type couldn't be inferred but an Amazon Web Services Graviton instance type is recommended. The migration effort is VeryLow if both the current and recommended instance types are of the same CPU architecture.

" - }, - "instanceGpuInfo":{ - "shape":"GpuInfo", - "documentation":"

Describes the GPU accelerator settings for the recommended instance type of the Auto Scaling group.

" - }, "savingsOpportunityAfterDiscounts":{ "shape":"AutoScalingGroupSavingsOpportunityAfterDiscounts", "documentation":"

An object that describes the savings opportunity for the Auto Scaling group recommendation option that includes Savings Plans and Reserved Instances discounts. Savings opportunity includes the estimated monthly savings and percentage.

" + }, + "migrationEffort":{ + "shape":"MigrationEffort", + "documentation":"

The level of effort required to migrate from the current instance type to the recommended instance type.

For example, the migration effort is Low if Amazon EMR is the inferred workload type and an Amazon Web Services Graviton instance type is recommended. The migration effort is Medium if a workload type couldn't be inferred but an Amazon Web Services Graviton instance type is recommended. The migration effort is VeryLow if both the current and recommended instance types are of the same CPU architecture.

" } }, "documentation":"

Describes a recommendation option for an Auto Scaling group.

" @@ -741,6 +804,7 @@ "CNY" ] }, + "CurrentDBInstanceClass":{"type":"string"}, "CurrentInstanceType":{"type":"string"}, "CurrentPerformanceRisk":{ "type":"string", @@ -811,6 +875,33 @@ "P99_5" ] }, + "DBInstanceClass":{"type":"string"}, + "DBStorageConfiguration":{ + "type":"structure", + "members":{ + "storageType":{ + "shape":"StorageType", + "documentation":"

The type of RDS storage.

" + }, + "allocatedStorage":{ + "shape":"AllocatedStorage", + "documentation":"

The size of the RDS storage in gigabytes (GB).

" + }, + "iops":{ + "shape":"NullableIOPS", + "documentation":"

The provisioned IOPs of the RDS storage.

" + }, + "maxAllocatedStorage":{ + "shape":"NullableMaxAllocatedStorage", + "documentation":"

The maximum limit in gibibytes (GiB) to which Amazon RDS can automatically scale the storage of the RDS instance.

" + }, + "storageThroughput":{ + "shape":"NullableStorageThroughput", + "documentation":"

The storage throughput of the RDS storage.

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

The configuration of the recommended RDS storage.

" + }, "DeleteRecommendationPreferencesRequest":{ "type":"structure", "required":[ @@ -820,7 +911,7 @@ "members":{ "resourceType":{ "shape":"ResourceType", - "documentation":"

The target resource type of the recommendation preference to delete.

The Ec2Instance option encompasses standalone instances and instances that are part of Auto Scaling groups. The AutoScalingGroup option encompasses only instances that are part of an Auto Scaling group.

The valid values for this parameter are Ec2Instance and AutoScalingGroup.

" + "documentation":"

The target resource type of the recommendation preference to delete.

The Ec2Instance option encompasses standalone instances and instances that are part of Auto Scaling groups. The AutoScalingGroup option encompasses only instances that are part of an Auto Scaling group.

" }, "scope":{ "shape":"Scope", @@ -1167,13 +1258,13 @@ "shape":"CurrentPerformanceRisk", "documentation":"

The risk of the current Amazon ECS service not meeting the performance needs of its workloads. The higher the risk, the more likely the current service can't meet the performance requirements of its workload.

" }, - "tags":{ - "shape":"Tags", - "documentation":"

A list of tags assigned to your Amazon ECS service recommendations.

" - }, "effectiveRecommendationPreferences":{ "shape":"ECSEffectiveRecommendationPreferences", "documentation":"

Describes the effective recommendation preferences for Amazon ECS services.

" + }, + "tags":{ + "shape":"Tags", + "documentation":"

A list of tags assigned to your Amazon ECS service recommendations.

" } }, "documentation":"

Describes an Amazon ECS service recommendation.

" @@ -1236,6 +1327,10 @@ "documentation":"

The CPU size of the Amazon ECS service recommendation option.

" }, "savingsOpportunity":{"shape":"SavingsOpportunity"}, + "savingsOpportunityAfterDiscounts":{ + "shape":"ECSSavingsOpportunityAfterDiscounts", + "documentation":"

Describes the savings opportunity for Amazon ECS service recommendations or for the recommendation option.

Savings opportunity represents the estimated monthly savings after applying Savings Plans discounts. You can achieve this by implementing a given Compute Optimizer recommendation.

" + }, "projectedUtilizationMetrics":{ "shape":"ECSServiceProjectedUtilizationMetrics", "documentation":"

An array of objects that describe the projected utilization metrics of the Amazon ECS service recommendation option.

" @@ -1243,10 +1338,6 @@ "containerRecommendations":{ "shape":"ContainerRecommendations", "documentation":"

The CPU and memory size recommendations for the containers within the task of your Amazon ECS service.

" - }, - "savingsOpportunityAfterDiscounts":{ - "shape":"ECSSavingsOpportunityAfterDiscounts", - "documentation":"

Describes the savings opportunity for Amazon ECS service recommendations or for the recommendation option.

Savings opportunity represents the estimated monthly savings after applying Savings Plans discounts. You can achieve this by implementing a given Compute Optimizer recommendation.

" } }, "documentation":"

Describes the recommendation options for an Amazon ECS service.

" @@ -1334,7 +1425,7 @@ "members":{ "cpuVendorArchitectures":{ "shape":"CpuVendorArchitectures", - "documentation":"

Describes the CPU vendor and architecture for an instance or Auto Scaling group recommendations.

For example, when you specify AWS_ARM64 with:

" + "documentation":"

Describes the CPU vendor and architecture for an instance or Auto Scaling group recommendations.

For example, when you specify AWS_ARM64 with:

" }, "enhancedInfrastructureMetrics":{ "shape":"EnhancedInfrastructureMetrics", @@ -1367,6 +1458,8 @@ }, "documentation":"

Describes the effective recommendation preferences for a resource.

" }, + "Engine":{"type":"string"}, + "EngineVersion":{"type":"string"}, "EnhancedInfrastructureMetrics":{ "type":"string", "enum":[ @@ -1663,6 +1756,44 @@ "s3Destination":{"shape":"S3Destination"} } }, + "ExportRDSDatabaseRecommendationsRequest":{ + "type":"structure", + "required":["s3DestinationConfig"], + "members":{ + "accountIds":{ + "shape":"AccountIds", + "documentation":"

The Amazon Web Services account IDs for the export Amazon RDS recommendations.

If your account is the management account or the delegated administrator of an organization, use this parameter to specify the member account you want to export recommendations to.

This parameter can't be specified together with the include member accounts parameter. The parameters are mutually exclusive.

If this parameter or the include member accounts parameter is omitted, the recommendations for member accounts aren't included in the export.

You can specify multiple account IDs per request.

" + }, + "filters":{ + "shape":"RDSDBRecommendationFilters", + "documentation":"

An array of objects to specify a filter that exports a more specific set of Amazon RDS recommendations.

" + }, + "fieldsToExport":{ + "shape":"ExportableRDSDBFields", + "documentation":"

The recommendations data to include in the export file. For more information about the fields that can be exported, see Exported files in the Compute Optimizer User Guide.

" + }, + "s3DestinationConfig":{"shape":"S3DestinationConfig"}, + "fileFormat":{ + "shape":"FileFormat", + "documentation":"

The format of the export file.

The CSV file is the only export file format currently supported.

" + }, + "includeMemberAccounts":{ + "shape":"IncludeMemberAccounts", + "documentation":"

If your account is the management account or the delegated administrator of an organization, this parameter indicates whether to include recommendations for resources in all member accounts of the organization.

The member accounts must also be opted in to Compute Optimizer, and trusted access for Compute Optimizer must be enabled in the organization account. For more information, see Compute Optimizer and Amazon Web Services Organizations trusted access in the Compute Optimizer User Guide.

If this parameter is omitted, recommendations for member accounts of the organization aren't included in the export file.

If this parameter or the account ID parameter is omitted, recommendations for member accounts aren't included in the export.

" + }, + "recommendationPreferences":{"shape":"RecommendationPreferences"} + } + }, + "ExportRDSDatabaseRecommendationsResponse":{ + "type":"structure", + "members":{ + "jobId":{ + "shape":"JobId", + "documentation":"

The identification number of the export job.

To view the status of an export job, use the DescribeRecommendationExportJobs action and specify the job ID.

" + }, + "s3Destination":{"shape":"S3Destination"} + } + }, "ExportableAutoScalingGroupField":{ "type":"string", "enum":[ @@ -1718,6 +1849,8 @@ "EffectiveRecommendationPreferencesCpuVendorArchitectures", "EffectiveRecommendationPreferencesEnhancedInfrastructureMetrics", "EffectiveRecommendationPreferencesInferredWorkloadTypes", + "EffectiveRecommendationPreferencesPreferredResources", + "EffectiveRecommendationPreferencesLookBackPeriod", "InferredWorkloadTypes", "RecommendationOptionsMigrationEffort", "CurrentInstanceGpuInfo", @@ -1729,9 +1862,7 @@ "EffectiveRecommendationPreferencesSavingsEstimationMode", "RecommendationOptionsSavingsOpportunityAfterDiscountsPercentage", "RecommendationOptionsEstimatedMonthlySavingsCurrencyAfterDiscounts", - "RecommendationOptionsEstimatedMonthlySavingsValueAfterDiscounts", - "EffectiveRecommendationPreferencesPreferredResources", - "EffectiveRecommendationPreferencesLookBackPeriod" + "RecommendationOptionsEstimatedMonthlySavingsValueAfterDiscounts" ] }, "ExportableAutoScalingGroupFields":{ @@ -1831,8 +1962,8 @@ "InferredWorkloadTypes", "RecommendationOptionsMigrationEffort", "EffectiveRecommendationPreferencesExternalMetricsSource", - "InstanceState", "Tags", + "InstanceState", "ExternalMetricStatusCode", "ExternalMetricStatusReason", "CurrentInstanceGpuInfo", @@ -1925,6 +2056,74 @@ "type":"list", "member":{"shape":"ExportableLicenseField"} }, + "ExportableRDSDBField":{ + "type":"string", + "enum":[ + "ResourceArn", + "AccountId", + "Engine", + "EngineVersion", + "Idle", + "MultiAZDBInstance", + "CurrentDBInstanceClass", + "CurrentStorageConfigurationStorageType", + "CurrentStorageConfigurationAllocatedStorage", + "CurrentStorageConfigurationMaxAllocatedStorage", + "CurrentStorageConfigurationIOPS", + "CurrentStorageConfigurationStorageThroughput", + "CurrentInstanceOnDemandHourlyPrice", + "CurrentStorageOnDemandMonthlyPrice", + "LookbackPeriodInDays", + "UtilizationMetricsCpuMaximum", + "UtilizationMetricsMemoryMaximum", + "UtilizationMetricsEBSVolumeStorageSpaceUtilizationMaximum", + "UtilizationMetricsNetworkReceiveThroughputMaximum", + "UtilizationMetricsNetworkTransmitThroughputMaximum", + "UtilizationMetricsEBSVolumeReadIOPSMaximum", + "UtilizationMetricsEBSVolumeWriteIOPSMaximum", + "UtilizationMetricsEBSVolumeReadThroughputMaximum", + "UtilizationMetricsEBSVolumeWriteThroughputMaximum", + "UtilizationMetricsDatabaseConnectionsMaximum", + "InstanceFinding", + "InstanceFindingReasonCodes", + "StorageFinding", + "StorageFindingReasonCodes", + "InstanceRecommendationOptionsDBInstanceClass", + "InstanceRecommendationOptionsRank", + "InstanceRecommendationOptionsPerformanceRisk", + "InstanceRecommendationOptionsProjectedUtilizationMetricsCpuMaximum", + "StorageRecommendationOptionsStorageType", + "StorageRecommendationOptionsAllocatedStorage", + "StorageRecommendationOptionsMaxAllocatedStorage", + "StorageRecommendationOptionsIOPS", + "StorageRecommendationOptionsStorageThroughput", + "StorageRecommendationOptionsRank", + "InstanceRecommendationOptionsInstanceOnDemandHourlyPrice", + "InstanceRecommendationOptionsSavingsOpportunityPercentage", + "InstanceRecommendationOptionsEstimatedMonthlySavingsCurrency", + "InstanceRecommendationOptionsEstimatedMonthlySavingsValue", + "InstanceRecommendationOptionsSavingsOpportunityAfterDiscountsPercentage", + "InstanceRecommendationOptionsEstimatedMonthlySavingsCurrencyAfterDiscounts", + "InstanceRecommendationOptionsEstimatedMonthlySavingsValueAfterDiscounts", + "StorageRecommendationOptionsOnDemandMonthlyPrice", + "StorageRecommendationOptionsSavingsOpportunityPercentage", + "StorageRecommendationOptionsEstimatedMonthlySavingsCurrency", + "StorageRecommendationOptionsEstimatedMonthlySavingsValue", + "StorageRecommendationOptionsSavingsOpportunityAfterDiscountsPercentage", + "StorageRecommendationOptionsEstimatedMonthlySavingsCurrencyAfterDiscounts", + "StorageRecommendationOptionsEstimatedMonthlySavingsValueAfterDiscounts", + "EffectiveRecommendationPreferencesCpuVendorArchitectures", + "EffectiveRecommendationPreferencesEnhancedInfrastructureMetrics", + "EffectiveRecommendationPreferencesLookBackPeriod", + "EffectiveRecommendationPreferencesSavingsEstimationMode", + "LastRefreshTimestamp", + "Tags" + ] + }, + "ExportableRDSDBFields":{ + "type":"list", + "member":{"shape":"ExportableRDSDBField"} + }, "ExportableVolumeField":{ "type":"string", "enum":[ @@ -1956,8 +2155,8 @@ "RecommendationOptionsSavingsOpportunityPercentage", "RecommendationOptionsEstimatedMonthlySavingsCurrency", "RecommendationOptionsEstimatedMonthlySavingsValue", - "RootVolume", "Tags", + "RootVolume", "CurrentConfigurationRootVolume", "EffectiveRecommendationPreferencesSavingsEstimationMode", "RecommendationOptionsSavingsOpportunityAfterDiscountsPercentage", @@ -2514,6 +2713,91 @@ } } }, + "GetRDSDatabaseRecommendationProjectedMetricsRequest":{ + "type":"structure", + "required":[ + "resourceArn", + "stat", + "period", + "startTime", + "endTime" + ], + "members":{ + "resourceArn":{ + "shape":"ResourceArn", + "documentation":"

The ARN that identifies the Amazon RDS.

The following is the format of the ARN:

arn:aws:rds:{region}:{accountId}:db:{resourceName}

" + }, + "stat":{ + "shape":"MetricStatistic", + "documentation":"

The statistic of the projected metrics.

" + }, + "period":{ + "shape":"Period", + "documentation":"

The granularity, in seconds, of the projected metrics data points.

" + }, + "startTime":{ + "shape":"Timestamp", + "documentation":"

The timestamp of the first projected metrics data point to return.

" + }, + "endTime":{ + "shape":"Timestamp", + "documentation":"

The timestamp of the last projected metrics data point to return.

" + }, + "recommendationPreferences":{"shape":"RecommendationPreferences"} + } + }, + "GetRDSDatabaseRecommendationProjectedMetricsResponse":{ + "type":"structure", + "members":{ + "recommendedOptionProjectedMetrics":{ + "shape":"RDSDatabaseRecommendedOptionProjectedMetrics", + "documentation":"

An array of objects that describes the projected metrics.

" + } + } + }, + "GetRDSDatabaseRecommendationsRequest":{ + "type":"structure", + "members":{ + "resourceArns":{ + "shape":"ResourceArns", + "documentation":"

The ARN that identifies the Amazon RDS.

The following is the format of the ARN:

arn:aws:rds:{region}:{accountId}:db:{resourceName}

The following is the format of a DB Cluster ARN:

arn:aws:rds:{region}:{accountId}:cluster:{resourceName}

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

The token to advance to the next page of Amazon RDS recommendations.

" + }, + "maxResults":{ + "shape":"MaxResults", + "documentation":"

The maximum number of Amazon RDS recommendations to return with a single request.

To retrieve the remaining results, make another request with the returned nextToken value.

" + }, + "filters":{ + "shape":"RDSDBRecommendationFilters", + "documentation":"

An array of objects to specify a filter that returns a more specific list of Amazon RDS recommendations.

" + }, + "accountIds":{ + "shape":"AccountIds", + "documentation":"

Return the Amazon RDS recommendations to the specified Amazon Web Services account IDs.

If your account is the management account or the delegated administrator of an organization, use this parameter to return the Amazon RDS recommendations to specific member accounts.

You can only specify one account ID per request.

" + }, + "recommendationPreferences":{"shape":"RecommendationPreferences"} + } + }, + "GetRDSDatabaseRecommendationsResponse":{ + "type":"structure", + "members":{ + "nextToken":{ + "shape":"NextToken", + "documentation":"

The token to advance to the next page of Amazon RDS recommendations.

" + }, + "rdsDBRecommendations":{ + "shape":"RDSDBRecommendations", + "documentation":"

An array of objects that describe the Amazon RDS recommendations.

" + }, + "errors":{ + "shape":"GetRecommendationErrors", + "documentation":"

An array of objects that describe errors of the request.

" + } + } + }, "GetRecommendationError":{ "type":"structure", "members":{ @@ -2542,7 +2826,7 @@ "members":{ "resourceType":{ "shape":"ResourceType", - "documentation":"

The target resource type of the recommendation preference for which to return preferences.

The Ec2Instance option encompasses standalone instances and instances that are part of Auto Scaling groups. The AutoScalingGroup option encompasses only instances that are part of an Auto Scaling group.

The valid values for this parameter are Ec2Instance and AutoScalingGroup.

" + "documentation":"

The target resource type of the recommendation preference for which to return preferences.

The Ec2Instance option encompasses standalone instances and instances that are part of Auto Scaling groups. The AutoScalingGroup option encompasses only instances that are part of an Auto Scaling group.

" }, "scope":{ "shape":"Scope", @@ -2633,6 +2917,13 @@ }, "High":{"type":"long"}, "Identifier":{"type":"string"}, + "Idle":{ + "type":"string", + "enum":[ + "True", + "False" + ] + }, "IncludeMemberAccounts":{"type":"boolean"}, "InferredWorkloadSaving":{ "type":"structure", @@ -2725,7 +3016,7 @@ }, "finding":{ "shape":"Finding", - "documentation":"

The finding classification of the instance.

Findings for instances include:

" + "documentation":"

The finding classification of the instance.

Findings for instances include:

The valid values in your API responses appear as OVER_PROVISIONED, UNDER_PROVISIONED, or OPTIMIZED.

" }, "findingReasonCodes":{ "shape":"InstanceRecommendationFindingReasonCodes", @@ -2822,6 +3113,10 @@ "shape":"InstanceType", "documentation":"

The instance type of the instance recommendation.

" }, + "instanceGpuInfo":{ + "shape":"GpuInfo", + "documentation":"

Describes the GPU accelerator settings for the recommended instance type.

" + }, "projectedUtilizationMetrics":{ "shape":"ProjectedUtilizationMetrics", "documentation":"

An array of objects that describe the projected utilization metrics of the instance recommendation option.

The Cpu and Memory metrics are the only projected utilization metrics returned. Additionally, the Memory metric is returned only for resources that have the unified CloudWatch agent installed on them. For more information, see Enabling Memory Utilization with the CloudWatch Agent.

" @@ -2842,17 +3137,13 @@ "shape":"SavingsOpportunity", "documentation":"

An object that describes the savings opportunity for the instance recommendation option. Savings opportunity includes the estimated monthly savings amount and percentage.

" }, - "migrationEffort":{ - "shape":"MigrationEffort", - "documentation":"

The level of effort required to migrate from the current instance type to the recommended instance type.

For example, the migration effort is Low if Amazon EMR is the inferred workload type and an Amazon Web Services Graviton instance type is recommended. The migration effort is Medium if a workload type couldn't be inferred but an Amazon Web Services Graviton instance type is recommended. The migration effort is VeryLow if both the current and recommended instance types are of the same CPU architecture.

" - }, - "instanceGpuInfo":{ - "shape":"GpuInfo", - "documentation":"

Describes the GPU accelerator settings for the recommended instance type.

" - }, "savingsOpportunityAfterDiscounts":{ "shape":"InstanceSavingsOpportunityAfterDiscounts", "documentation":"

An object that describes the savings opportunity for the instance recommendation option that includes Savings Plans and Reserved Instances discounts. Savings opportunity includes the estimated monthly savings and percentage.

" + }, + "migrationEffort":{ + "shape":"MigrationEffort", + "documentation":"

The level of effort required to migrate from the current instance type to the recommended instance type.

For example, the migration effort is Low if Amazon EMR is the inferred workload type and an Amazon Web Services Graviton instance type is recommended. The migration effort is Medium if a workload type couldn't be inferred but an Amazon Web Services Graviton instance type is recommended. The migration effort is VeryLow if both the current and recommended instance types are of the same CPU architecture.

" } }, "documentation":"

Describes a recommendation option for an Amazon EC2 instance.

" @@ -3115,13 +3406,13 @@ "shape":"CurrentPerformanceRisk", "documentation":"

The risk of the current Lambda function not meeting the performance needs of its workloads. The higher the risk, the more likely the current Lambda function requires more memory.

" }, - "tags":{ - "shape":"Tags", - "documentation":"

A list of tags assigned to your Lambda function recommendations.

" - }, "effectiveRecommendationPreferences":{ "shape":"LambdaEffectiveRecommendationPreferences", "documentation":"

Describes the effective recommendation preferences for Lambda functions.

" + }, + "tags":{ + "shape":"Tags", + "documentation":"

A list of tags assigned to your Lambda function recommendations.

" } }, "documentation":"

Describes an Lambda function recommendation.

" @@ -3534,8 +3825,11 @@ }, "NextToken":{"type":"string"}, "NullableCpu":{"type":"integer"}, + "NullableIOPS":{"type":"integer"}, + "NullableMaxAllocatedStorage":{"type":"integer"}, "NullableMemory":{"type":"integer"}, "NullableMemoryReservation":{"type":"integer"}, + "NullableStorageThroughput":{"type":"integer"}, "NumberOfCores":{"type":"integer"}, "NumberOfInvocations":{"type":"long"}, "NumberOfMemberAccountsOptedIn":{"type":"integer"}, @@ -3633,7 +3927,7 @@ "members":{ "resourceType":{ "shape":"ResourceType", - "documentation":"

The target resource type of the recommendation preference to create.

The Ec2Instance option encompasses standalone instances and instances that are part of Auto Scaling groups. The AutoScalingGroup option encompasses only instances that are part of an Auto Scaling group.

The valid values for this parameter are Ec2Instance and AutoScalingGroup.

" + "documentation":"

The target resource type of the recommendation preference to create.

The Ec2Instance option encompasses standalone instances and instances that are part of Auto Scaling groups. The AutoScalingGroup option encompasses only instances that are part of an Auto Scaling group.

" }, "scope":{ "shape":"Scope", @@ -3674,6 +3968,407 @@ "members":{ } }, + "RDSDBInstanceRecommendationOption":{ + "type":"structure", + "members":{ + "dbInstanceClass":{ + "shape":"DBInstanceClass", + "documentation":"

Describes the DB instance class recommendation option for your Amazon RDS instance.

" + }, + "projectedUtilizationMetrics":{ + "shape":"RDSDBProjectedUtilizationMetrics", + "documentation":"

An array of objects that describe the projected utilization metrics of the RDS instance recommendation option.

" + }, + "performanceRisk":{ + "shape":"PerformanceRisk", + "documentation":"

The performance risk of the RDS instance recommendation option.

" + }, + "rank":{ + "shape":"Rank", + "documentation":"

The rank identifier of the RDS instance recommendation option.

" + }, + "savingsOpportunity":{"shape":"SavingsOpportunity"}, + "savingsOpportunityAfterDiscounts":{ + "shape":"RDSInstanceSavingsOpportunityAfterDiscounts", + "documentation":"

Describes the savings opportunity for Amazon RDS recommendations or for the recommendation option.

Savings opportunity represents the estimated monthly savings after applying Savings Plans discounts. You can achieve this by implementing a given Compute Optimizer recommendation.

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

Describes the recommendation options for an Amazon RDS instance.

" + }, + "RDSDBInstanceRecommendationOptions":{ + "type":"list", + "member":{"shape":"RDSDBInstanceRecommendationOption"} + }, + "RDSDBMetricName":{ + "type":"string", + "enum":[ + "CPU", + "Memory", + "EBSVolumeStorageSpaceUtilization", + "NetworkReceiveThroughput", + "NetworkTransmitThroughput", + "EBSVolumeReadIOPS", + "EBSVolumeWriteIOPS", + "EBSVolumeReadThroughput", + "EBSVolumeWriteThroughput", + "DatabaseConnections" + ] + }, + "RDSDBMetricStatistic":{ + "type":"string", + "enum":[ + "Maximum", + "Minimum", + "Average" + ] + }, + "RDSDBProjectedUtilizationMetrics":{ + "type":"list", + "member":{"shape":"RDSDBUtilizationMetric"} + }, + "RDSDBRecommendation":{ + "type":"structure", + "members":{ + "resourceArn":{ + "shape":"ResourceArn", + "documentation":"

The ARN of the current Amazon RDS.

The following is the format of the ARN:

arn:aws:rds:{region}:{accountId}:db:{resourceName}

" + }, + "accountId":{ + "shape":"AccountId", + "documentation":"

The Amazon Web Services account ID of the Amazon RDS.

" + }, + "engine":{ + "shape":"Engine", + "documentation":"

The engine of the RDS instance.

" + }, + "engineVersion":{ + "shape":"EngineVersion", + "documentation":"

The database engine version.

" + }, + "currentDBInstanceClass":{ + "shape":"CurrentDBInstanceClass", + "documentation":"

The DB instance class of the current RDS instance.

" + }, + "currentStorageConfiguration":{ + "shape":"DBStorageConfiguration", + "documentation":"

The configuration of the current RDS storage.

" + }, + "idle":{ + "shape":"Idle", + "documentation":"

This indicates if the RDS instance is idle or not.

" + }, + "instanceFinding":{ + "shape":"RDSInstanceFinding", + "documentation":"

The finding classification of an Amazon RDS instance.

Findings for Amazon RDS instance include:

" + }, + "storageFinding":{ + "shape":"RDSStorageFinding", + "documentation":"

The finding classification of Amazon RDS storage.

Findings for Amazon RDS instance include:

" + }, + "instanceFindingReasonCodes":{ + "shape":"RDSInstanceFindingReasonCodes", + "documentation":"

The reason for the finding classification of an Amazon RDS instance.

" + }, + "storageFindingReasonCodes":{ + "shape":"RDSStorageFindingReasonCodes", + "documentation":"

The reason for the finding classification of Amazon RDS storage.

" + }, + "instanceRecommendationOptions":{ + "shape":"RDSDBInstanceRecommendationOptions", + "documentation":"

An array of objects that describe the recommendation options for the Amazon RDS instance.

" + }, + "storageRecommendationOptions":{ + "shape":"RDSDBStorageRecommendationOptions", + "documentation":"

An array of objects that describe the recommendation options for Amazon RDS storage.

" + }, + "utilizationMetrics":{ + "shape":"RDSDBUtilizationMetrics", + "documentation":"

An array of objects that describe the utilization metrics of the Amazon RDS.

" + }, + "effectiveRecommendationPreferences":{ + "shape":"RDSEffectiveRecommendationPreferences", + "documentation":"

Describes the effective recommendation preferences for Amazon RDS.

" + }, + "lookbackPeriodInDays":{ + "shape":"LookBackPeriodInDays", + "documentation":"

The number of days the Amazon RDS utilization metrics were analyzed.

" + }, + "lastRefreshTimestamp":{ + "shape":"LastRefreshTimestamp", + "documentation":"

The timestamp of when the Amazon RDS recommendation was last generated.

" + }, + "tags":{ + "shape":"Tags", + "documentation":"

A list of tags assigned to your Amazon RDS recommendations.

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

Describes an Amazon RDS recommendation.

" + }, + "RDSDBRecommendationFilter":{ + "type":"structure", + "members":{ + "name":{ + "shape":"RDSDBRecommendationFilterName", + "documentation":"

The name of the filter.

Specify Finding to return recommendations with a specific finding classification.

You can filter your Amazon RDS recommendations by tag:key and tag-key tags.

A tag:key is a key and value combination of a tag assigned to your Amazon RDS recommendations. Use the tag key in the filter name and the tag value as the filter value. For example, to find all Amazon RDS service recommendations that have a tag with the key of Owner and the value of TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

A tag-key is the key of a tag assigned to your Amazon RDS recommendations. Use this filter to find all of your Amazon RDS recommendations that have a tag with a specific key. This doesn’t consider the tag value. For example, you can find your Amazon RDS service recommendations with a tag key value of Owner or without any tag keys assigned.

" + }, + "values":{ + "shape":"FilterValues", + "documentation":"

The value of the filter.

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

Describes a filter that returns a more specific list of Amazon RDS recommendations. Use this filter with the GetECSServiceRecommendations action.

" + }, + "RDSDBRecommendationFilterName":{ + "type":"string", + "enum":[ + "InstanceFinding", + "InstanceFindingReasonCode", + "StorageFinding", + "StorageFindingReasonCode", + "Idle" + ] + }, + "RDSDBRecommendationFilters":{ + "type":"list", + "member":{"shape":"RDSDBRecommendationFilter"} + }, + "RDSDBRecommendations":{ + "type":"list", + "member":{"shape":"RDSDBRecommendation"} + }, + "RDSDBStorageRecommendationOption":{ + "type":"structure", + "members":{ + "storageConfiguration":{ + "shape":"DBStorageConfiguration", + "documentation":"

The recommended storage configuration.

" + }, + "rank":{ + "shape":"Rank", + "documentation":"

The rank identifier of the RDS storage recommendation option.

" + }, + "savingsOpportunity":{"shape":"SavingsOpportunity"}, + "savingsOpportunityAfterDiscounts":{ + "shape":"RDSStorageSavingsOpportunityAfterDiscounts", + "documentation":"

Describes the savings opportunity for Amazon RDS storage recommendations or for the recommendation option.

Savings opportunity represents the estimated monthly savings after applying Savings Plans discounts. You can achieve this by implementing a given Compute Optimizer recommendation.

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

Describes the recommendation options for Amazon RDS storage.

" + }, + "RDSDBStorageRecommendationOptions":{ + "type":"list", + "member":{"shape":"RDSDBStorageRecommendationOption"} + }, + "RDSDBUtilizationMetric":{ + "type":"structure", + "members":{ + "name":{ + "shape":"RDSDBMetricName", + "documentation":"

The name of the utilization metric.

" + }, + "statistic":{ + "shape":"RDSDBMetricStatistic", + "documentation":"

The statistic of the utilization metric.

The Compute Optimizer API, Command Line Interface (CLI), and SDKs return utilization metrics using only the Maximum statistic, which is the highest value observed during the specified period.

The Compute Optimizer console displays graphs for some utilization metrics using the Average statistic, which is the value of Sum / SampleCount during the specified period. For more information, see Viewing resource recommendations in the Compute Optimizer User Guide. You can also get averaged utilization metric data for your resources using Amazon CloudWatch. For more information, see the Amazon CloudWatch User Guide.

" + }, + "value":{ + "shape":"MetricValue", + "documentation":"

The value of the utilization metric.

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

Describes the utilization metric of an Amazon RDS.

To determine the performance difference between your current Amazon RDS and the recommended option, compare the utilization metric data of your service against its projected utilization metric data.

" + }, + "RDSDBUtilizationMetrics":{ + "type":"list", + "member":{"shape":"RDSDBUtilizationMetric"} + }, + "RDSDatabaseProjectedMetric":{ + "type":"structure", + "members":{ + "name":{ + "shape":"RDSDBMetricName", + "documentation":"

The name of the projected metric.

" + }, + "timestamps":{ + "shape":"Timestamps", + "documentation":"

The timestamps of the projected metric.

" + }, + "values":{ + "shape":"MetricValues", + "documentation":"

The values for the projected metric.

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

Describes the projected metrics of an Amazon RDS recommendation option.

To determine the performance difference between your current Amazon RDS and the recommended option, compare the metric data of your service against its projected metric data.

" + }, + "RDSDatabaseProjectedMetrics":{ + "type":"list", + "member":{"shape":"RDSDatabaseProjectedMetric"} + }, + "RDSDatabaseRecommendedOptionProjectedMetric":{ + "type":"structure", + "members":{ + "recommendedDBInstanceClass":{ + "shape":"RecommendedDBInstanceClass", + "documentation":"

The recommended DB instance class for the Amazon RDS.

" + }, + "rank":{ + "shape":"Rank", + "documentation":"

The rank identifier of the RDS instance recommendation option.

" + }, + "projectedMetrics":{ + "shape":"RDSDatabaseProjectedMetrics", + "documentation":"

An array of objects that describe the projected metric.

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

Describes the projected metrics of an Amazon RDS recommendation option.

To determine the performance difference between your current Amazon RDS and the recommended option, compare the metric data of your service against its projected metric data.

" + }, + "RDSDatabaseRecommendedOptionProjectedMetrics":{ + "type":"list", + "member":{"shape":"RDSDatabaseRecommendedOptionProjectedMetric"} + }, + "RDSEffectiveRecommendationPreferences":{ + "type":"structure", + "members":{ + "cpuVendorArchitectures":{ + "shape":"CpuVendorArchitectures", + "documentation":"

Describes the CPU vendor and architecture for Amazon RDS recommendations.

" + }, + "enhancedInfrastructureMetrics":{ + "shape":"EnhancedInfrastructureMetrics", + "documentation":"

Describes the activation status of the enhanced infrastructure metrics preference.

A status of Active confirms that the preference is applied in the latest recommendation refresh, and a status of Inactive confirms that it's not yet applied to recommendations.

For more information, see Enhanced infrastructure metrics in the Compute Optimizer User Guide.

" + }, + "lookBackPeriod":{ + "shape":"LookBackPeriodPreference", + "documentation":"

The number of days the utilization metrics of the Amazon RDS are analyzed.

" + }, + "savingsEstimationMode":{ + "shape":"RDSSavingsEstimationMode", + "documentation":"

Describes the savings estimation mode preference applied for calculating savings opportunity for Amazon RDS.

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

Describes the effective recommendation preferences for Amazon RDS.

" + }, + "RDSInstanceEstimatedMonthlySavings":{ + "type":"structure", + "members":{ + "currency":{ + "shape":"Currency", + "documentation":"

The currency of the estimated monthly savings.

" + }, + "value":{ + "shape":"Value", + "documentation":"

The value of the estimated monthly savings for Amazon RDS instances.

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

Describes the estimated monthly savings possible for Amazon RDS instances by adopting Compute Optimizer recommendations. This is based on Amazon RDS pricing after applying Savings Plans discounts.

" + }, + "RDSInstanceFinding":{ + "type":"string", + "enum":[ + "Optimized", + "Underprovisioned", + "Overprovisioned" + ] + }, + "RDSInstanceFindingReasonCode":{ + "type":"string", + "enum":[ + "CPUOverprovisioned", + "NetworkBandwidthOverprovisioned", + "EBSIOPSOverprovisioned", + "EBSThroughputOverprovisioned", + "CPUUnderprovisioned", + "NetworkBandwidthUnderprovisioned", + "EBSThroughputUnderprovisioned", + "NewGenerationDBInstanceClassAvailable", + "NewEngineVersionAvailable" + ] + }, + "RDSInstanceFindingReasonCodes":{ + "type":"list", + "member":{"shape":"RDSInstanceFindingReasonCode"} + }, + "RDSInstanceSavingsOpportunityAfterDiscounts":{ + "type":"structure", + "members":{ + "savingsOpportunityPercentage":{ + "shape":"SavingsOpportunityPercentage", + "documentation":"

The estimated monthly savings possible as a percentage of monthly cost by adopting Compute Optimizer’s Amazon RDS instance recommendations. This includes any applicable Savings Plans discounts.

" + }, + "estimatedMonthlySavings":{ + "shape":"RDSInstanceEstimatedMonthlySavings", + "documentation":"

The estimated monthly savings possible by adopting Compute Optimizer’s Amazon RDS instance recommendations. This includes any applicable Savings Plans discounts.

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

Describes the savings opportunity for Amazon RDS instance recommendations after applying Savings Plans discounts.

Savings opportunity represents the estimated monthly savings after applying Savings Plans discounts. You can achieve this by implementing a given Compute Optimizer recommendation.

" + }, + "RDSSavingsEstimationMode":{ + "type":"structure", + "members":{ + "source":{ + "shape":"RDSSavingsEstimationModeSource", + "documentation":"

Describes the source for calculating the savings opportunity for Amazon RDS.

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

Describes the savings estimation mode used for calculating savings opportunity for Amazon RDS.

" + }, + "RDSSavingsEstimationModeSource":{ + "type":"string", + "enum":[ + "PublicPricing", + "CostExplorerRightsizing", + "CostOptimizationHub" + ] + }, + "RDSStorageEstimatedMonthlySavings":{ + "type":"structure", + "members":{ + "currency":{ + "shape":"Currency", + "documentation":"

The currency of the estimated monthly savings.

" + }, + "value":{ + "shape":"Value", + "documentation":"

The value of the estimated monthly savings for Amazon RDS storage.

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

Describes the estimated monthly savings possible for Amazon RDS storage by adopting Compute Optimizer recommendations. This is based on Amazon RDS pricing after applying Savings Plans discounts.

" + }, + "RDSStorageFinding":{ + "type":"string", + "enum":[ + "Optimized", + "Underprovisioned", + "Overprovisioned" + ] + }, + "RDSStorageFindingReasonCode":{ + "type":"string", + "enum":[ + "EBSVolumeAllocatedStorageUnderprovisioned", + "EBSVolumeThroughputUnderprovisioned", + "EBSVolumeIOPSOverprovisioned", + "EBSVolumeThroughputOverprovisioned", + "NewGenerationStorageTypeAvailable" + ] + }, + "RDSStorageFindingReasonCodes":{ + "type":"list", + "member":{"shape":"RDSStorageFindingReasonCode"} + }, + "RDSStorageSavingsOpportunityAfterDiscounts":{ + "type":"structure", + "members":{ + "savingsOpportunityPercentage":{ + "shape":"SavingsOpportunityPercentage", + "documentation":"

The estimated monthly savings possible as a percentage of monthly cost by adopting Compute Optimizer’s Amazon RDS storage recommendations. This includes any applicable Savings Plans discounts.

" + }, + "estimatedMonthlySavings":{ + "shape":"RDSStorageEstimatedMonthlySavings", + "documentation":"

The estimated monthly savings possible by adopting Compute Optimizer’s Amazon RDS storage recommendations. This includes any applicable Savings Plans discounts.

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

Describes the savings opportunity for Amazon RDS storage recommendations after applying Savings Plans discounts.

Savings opportunity represents the estimated monthly savings after applying Savings Plans discounts. You can achieve this by implementing a given Compute Optimizer recommendation.

" + }, "Rank":{"type":"integer"}, "ReasonCodeSummaries":{ "type":"list", @@ -3755,10 +4450,10 @@ "members":{ "cpuVendorArchitectures":{ "shape":"CpuVendorArchitectures", - "documentation":"

Specifies the CPU vendor and architecture for Amazon EC2 instance and Auto Scaling group recommendations.

For example, when you specify AWS_ARM64 with:

" + "documentation":"

Specifies the CPU vendor and architecture for Amazon EC2 instance and Auto Scaling group recommendations.

For example, when you specify AWS_ARM64 with:

" } }, - "documentation":"

Describes the recommendation preferences to return in the response of a GetAutoScalingGroupRecommendations, GetEC2InstanceRecommendations, and GetEC2RecommendationProjectedMetrics request.

" + "documentation":"

Describes the recommendation preferences to return in the response of a GetAutoScalingGroupRecommendations, GetEC2InstanceRecommendations, GetEC2RecommendationProjectedMetrics, GetRDSDatabaseRecommendations, and GetRDSDatabaseRecommendationProjectedMetrics request.

" }, "RecommendationPreferencesDetail":{ "type":"structure", @@ -3829,7 +4524,9 @@ "EbsVolume", "LambdaFunction", "EcsService", - "License" + "License", + "RdsDBInstance", + "RdsDBInstanceStorage" ] }, "RecommendationSources":{ @@ -3870,6 +4567,7 @@ }, "documentation":"

A summary of a recommendation.

" }, + "RecommendedDBInstanceClass":{"type":"string"}, "RecommendedInstanceType":{"type":"string"}, "RecommendedOptionProjectedMetric":{ "type":"structure", @@ -3916,7 +4614,8 @@ "LambdaFunction", "NotApplicable", "EcsService", - "License" + "License", + "RdsDBInstance" ] }, "RootVolume":{"type":"boolean"}, @@ -4047,6 +4746,7 @@ ] }, "StatusReason":{"type":"string"}, + "StorageType":{"type":"string"}, "Summaries":{ "type":"list", "member":{"shape":"Summary"} @@ -4168,7 +4868,7 @@ "documentation":"

The parameters to set when customizing the resource utilization thresholds.

" } }, - "documentation":"

The preference to control the resource’s CPU utilization thresholds - threshold and headroom.

This preference is only available for the Amazon EC2 instance resource type.

" + "documentation":"

The preference to control the resource’s CPU utilization threshold, CPU utilization headroom, and memory utilization headroom.

This preference is only available for the Amazon EC2 instance resource type.

" }, "UtilizationPreferences":{ "type":"list", @@ -4258,13 +4958,13 @@ "shape":"CurrentPerformanceRisk", "documentation":"

The risk of the current EBS volume not meeting the performance needs of its workloads. The higher the risk, the more likely the current EBS volume doesn't have sufficient capacity.

" }, - "tags":{ - "shape":"Tags", - "documentation":"

A list of tags assigned to your Amazon EBS volume recommendations.

" - }, "effectiveRecommendationPreferences":{ "shape":"EBSEffectiveRecommendationPreferences", "documentation":"

Describes the effective recommendation preferences for Amazon EBS volume.

" + }, + "tags":{ + "shape":"Tags", + "documentation":"

A list of tags assigned to your Amazon EBS volume recommendations.

" } }, "documentation":"

Describes an Amazon Elastic Block Store (Amazon EBS) volume recommendation.

" diff --git a/botocore/data/cost-optimization-hub/2022-07-26/service-2.json b/botocore/data/cost-optimization-hub/2022-07-26/service-2.json index 664c769f59..55ee4f5fc9 100644 --- a/botocore/data/cost-optimization-hub/2022-07-26/service-2.json +++ b/botocore/data/cost-optimization-hub/2022-07-26/service-2.json @@ -2,9 +2,11 @@ "version":"2.0", "metadata":{ "apiVersion":"2022-07-26", + "auth":["aws.auth#sigv4"], "endpointPrefix":"cost-optimization-hub", "jsonVersion":"1.0", "protocol":"json", + "protocols":["json"], "serviceFullName":"Cost Optimization Hub", "serviceId":"Cost Optimization Hub", "signatureVersion":"v4", @@ -144,17 +146,17 @@ "shape":"AccountId", "documentation":"

The Amazon Web Services account ID.

" }, - "createdTimestamp":{ - "shape":"Timestamp", - "documentation":"

The time when the account enrollment status was created.

" + "status":{ + "shape":"EnrollmentStatus", + "documentation":"

The account enrollment status.

" }, "lastUpdatedTimestamp":{ "shape":"Timestamp", "documentation":"

The time when the account enrollment status was last updated.

" }, - "status":{ - "shape":"EnrollmentStatus", - "documentation":"

The account enrollment status.

" + "createdTimestamp":{ + "shape":"Timestamp", + "documentation":"

The time when the account enrollment status was created.

" } }, "documentation":"

Describes the enrollment status of an organization's member accounts in Cost Optimization Hub.

" @@ -165,7 +167,7 @@ }, "AccountId":{ "type":"string", - "pattern":"^[0-9]{12}$" + "pattern":"[0-9]{12}" }, "AccountIdList":{ "type":"list", @@ -211,21 +213,21 @@ "ComputeConfiguration":{ "type":"structure", "members":{ - "architecture":{ - "shape":"String", - "documentation":"

The architecture of the resource.

" + "vCpu":{ + "shape":"Double", + "documentation":"

The number of vCPU cores in the resource.

" }, "memorySizeInMB":{ "shape":"Integer", "documentation":"

The memory size of the resource.

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

The architecture of the resource.

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

The platform of the resource. The platform is the specific combination of operating system, license model, and software on an instance.

" - }, - "vCpu":{ - "shape":"Double", - "documentation":"

The number of vCPU cores in the resource.

" } }, "documentation":"

Describes the performance configuration for compute services such as Amazon EC2, Lambda, and ECS.

" @@ -251,22 +253,32 @@ "shape":"String", "documentation":"

The account scope that you want your recommendations for. Amazon Web Services calculates recommendations including the management account and member accounts if the value is set to PAYER. If the value is LINKED, recommendations are calculated for individual member accounts only.

" }, - "hourlyCommitment":{ + "term":{ "shape":"String", - "documentation":"

The hourly commitment for the Savings Plans type.

" + "documentation":"

The Savings Plans recommendation term in years.

" }, "paymentOption":{ "shape":"String", "documentation":"

The payment option for the commitment.

" }, - "term":{ + "hourlyCommitment":{ "shape":"String", - "documentation":"

The Savings Plans recommendation term in years.

" + "documentation":"

The hourly commitment for the Savings Plans type.

" } }, "documentation":"

The Compute Savings Plans configuration used for recommendations.

" }, "Datetime":{"type":"timestamp"}, + "DbInstanceConfiguration":{ + "type":"structure", + "members":{ + "dbInstanceClass":{ + "shape":"String", + "documentation":"

The DB instance class of the DB instance.

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

The DB instance configuration used for recommendations.

" + }, "Double":{ "type":"double", "box":true @@ -288,17 +300,17 @@ "EbsVolumeConfiguration":{ "type":"structure", "members":{ - "attachmentState":{ - "shape":"String", - "documentation":"

The Amazon Elastic Block Store attachment state.

" + "storage":{ + "shape":"StorageConfiguration", + "documentation":"

The disk storage of the Amazon Elastic Block Store volume.

" }, "performance":{ "shape":"BlockStoragePerformanceConfiguration", "documentation":"

The Amazon Elastic Block Store performance configuration.

" }, - "storage":{ - "shape":"StorageConfiguration", - "documentation":"

The disk storage of the Amazon Elastic Block Store volume.

" + "attachmentState":{ + "shape":"String", + "documentation":"

The Amazon Elastic Block Store attachment state.

" } }, "documentation":"

The Amazon Elastic Block Store volume configuration used for recommendations.

" @@ -372,6 +384,14 @@ "shape":"String", "documentation":"

The account scope that you want your recommendations for.

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

The Savings Plans recommendation term in years.

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

The payment option for the commitment.

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

The hourly commitment for the Savings Plans type.

" @@ -380,17 +400,9 @@ "shape":"String", "documentation":"

The instance family of the recommended Savings Plan.

" }, - "paymentOption":{ - "shape":"String", - "documentation":"

The payment option for the commitment.

" - }, "savingsPlansRegion":{ "shape":"String", "documentation":"

The Amazon Web Services Region of the commitment.

" - }, - "term":{ - "shape":"String", - "documentation":"

The Savings Plans recommendation term in years.

" } }, "documentation":"

The EC2 instance Savings Plans configuration used for recommendations.

" @@ -416,25 +428,21 @@ "shape":"String", "documentation":"

The account scope that you want your recommendations for.

" }, - "currentGeneration":{ - "shape":"String", - "documentation":"

Determines whether the recommendation is for a current generation instance.

" - }, - "instanceFamily":{ + "service":{ "shape":"String", - "documentation":"

The instance family of the recommended reservation.

" + "documentation":"

The service that you want your recommendations for.

" }, - "instanceType":{ + "normalizedUnitsToPurchase":{ "shape":"String", - "documentation":"

The type of instance that Amazon Web Services recommends.

" + "documentation":"

The number of normalized units that Amazon Web Services recommends that you purchase.

" }, - "monthlyRecurringCost":{ + "term":{ "shape":"String", - "documentation":"

How much purchasing reserved instances costs you on a monthly basis.

" + "documentation":"

The reserved instances recommendation term in years.

" }, - "normalizedUnitsToPurchase":{ + "paymentOption":{ "shape":"String", - "documentation":"

The number of normalized units that Amazon Web Services recommends that you purchase.

" + "documentation":"

The payment option for the commitment.

" }, "numberOfInstancesToPurchase":{ "shape":"String", @@ -444,37 +452,41 @@ "shape":"String", "documentation":"

Indicates whether the recommendation is for standard or convertible reservations.

" }, - "paymentOption":{ + "instanceFamily":{ "shape":"String", - "documentation":"

The payment option for the commitment.

" + "documentation":"

The instance family of the recommended reservation.

" }, - "platform":{ + "instanceType":{ "shape":"String", - "documentation":"

The platform of the recommended reservation. The platform is the specific combination of operating system, license model, and software on an instance.

" + "documentation":"

The type of instance that Amazon Web Services recommends.

" }, "reservedInstancesRegion":{ "shape":"String", "documentation":"

The Amazon Web Services Region of the commitment.

" }, - "service":{ + "currentGeneration":{ "shape":"String", - "documentation":"

The service that you want your recommendations for.

" + "documentation":"

Determines whether the recommendation is for a current generation instance.

" }, - "sizeFlexEligible":{ - "shape":"Boolean", - "documentation":"

Determines whether the recommendation is size flexible.

" + "platform":{ + "shape":"String", + "documentation":"

The platform of the recommended reservation. The platform is the specific combination of operating system, license model, and software on an instance.

" }, "tenancy":{ "shape":"String", "documentation":"

Determines whether the recommended reservation is dedicated or shared.

" }, - "term":{ - "shape":"String", - "documentation":"

The reserved instances recommendation term in years.

" + "sizeFlexEligible":{ + "shape":"Boolean", + "documentation":"

Determines whether the recommendation is size flexible.

" }, "upfrontCost":{ "shape":"String", "documentation":"

How much purchasing this instance costs you upfront.

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

How much purchasing reserved instances costs you on a monthly basis.

" } }, "documentation":"

The EC2 reserved instances configuration used for recommendations.

" @@ -524,53 +536,53 @@ "shape":"String", "documentation":"

The account scope that you want your recommendations for.

" }, - "currentGeneration":{ - "shape":"String", - "documentation":"

Determines whether the recommendation is for a current generation instance.

" - }, - "instanceFamily":{ + "service":{ "shape":"String", - "documentation":"

The instance family of the recommended reservation.

" + "documentation":"

The service that you want your recommendations for.

" }, - "instanceType":{ + "normalizedUnitsToPurchase":{ "shape":"String", - "documentation":"

The type of instance that Amazon Web Services recommends.

" + "documentation":"

The number of normalized units that Amazon Web Services recommends that you purchase.

" }, - "monthlyRecurringCost":{ + "term":{ "shape":"String", - "documentation":"

How much purchasing reserved instances costs you on a monthly basis.

" + "documentation":"

The reserved instances recommendation term in years.

" }, - "normalizedUnitsToPurchase":{ + "paymentOption":{ "shape":"String", - "documentation":"

The number of normalized units that Amazon Web Services recommends that you purchase.

" + "documentation":"

The payment option for the commitment.

" }, "numberOfInstancesToPurchase":{ "shape":"String", "documentation":"

The number of instances that Amazon Web Services recommends that you purchase.

" }, - "paymentOption":{ + "instanceFamily":{ "shape":"String", - "documentation":"

The payment option for the commitment.

" + "documentation":"

The instance family of the recommended reservation.

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

The type of instance that Amazon Web Services recommends.

" }, "reservedInstancesRegion":{ "shape":"String", "documentation":"

The Amazon Web Services Region of the commitment.

" }, - "service":{ + "currentGeneration":{ "shape":"String", - "documentation":"

The service that you want your recommendations for.

" + "documentation":"

Determines whether the recommendation is for a current generation instance.

" }, "sizeFlexEligible":{ "shape":"Boolean", "documentation":"

Determines whether the recommendation is size flexible.

" }, - "term":{ - "shape":"String", - "documentation":"

The reserved instances recommendation term in years.

" - }, "upfrontCost":{ "shape":"String", "documentation":"

How much purchasing this instance costs you upfront.

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

How much purchasing reserved instances costs you on a monthly basis.

" } }, "documentation":"

The ElastiCache reserved instances configuration used for recommendations.

" @@ -585,17 +597,17 @@ "EstimatedDiscounts":{ "type":"structure", "members":{ - "otherDiscount":{ + "savingsPlansDiscount":{ "shape":"Double", - "documentation":"

Estimated other discounts include all discounts that are not itemized. Itemized discounts include reservedInstanceDiscount and savingsPlansDiscount.

" + "documentation":"

Estimated Savings Plans discounts.

" }, "reservedInstancesDiscount":{ "shape":"Double", "documentation":"

Estimated reserved instance discounts.

" }, - "savingsPlansDiscount":{ + "otherDiscount":{ "shape":"Double", - "documentation":"

Estimated Savings Plans discounts.

" + "documentation":"

Estimated other discounts include all discounts that are not itemized. Itemized discounts include reservedInstanceDiscount and savingsPlansDiscount.

" } }, "documentation":"

Estimated discount details of the current and recommended resource configuration for a recommendation.

" @@ -603,49 +615,49 @@ "Filter":{ "type":"structure", "members":{ - "accountIds":{ - "shape":"AccountIdList", - "documentation":"

The account that the recommendation is for.

" + "restartNeeded":{ + "shape":"Boolean", + "documentation":"

Whether or not implementing the recommendation requires a restart.

" }, - "actionTypes":{ - "shape":"ActionTypeList", - "documentation":"

The type of action you can take by adopting the recommendation.

" + "rollbackPossible":{ + "shape":"Boolean", + "documentation":"

Whether or not implementing the recommendation can be rolled back.

" }, "implementationEfforts":{ "shape":"ImplementationEffortList", "documentation":"

The effort required to implement the recommendation.

" }, - "recommendationIds":{ - "shape":"RecommendationIdList", - "documentation":"

The IDs for the recommendations.

" + "accountIds":{ + "shape":"AccountIdList", + "documentation":"

The account that the recommendation is for.

" }, "regions":{ "shape":"RegionList", "documentation":"

The Amazon Web Services Region of the resource.

" }, - "resourceArns":{ - "shape":"ResourceArnList", - "documentation":"

The Amazon Resource Name (ARN) of the recommendation.

" - }, - "resourceIds":{ - "shape":"ResourceIdList", - "documentation":"

The resource ID of the recommendation.

" - }, "resourceTypes":{ "shape":"ResourceTypeList", "documentation":"

The resource type of the recommendation.

" }, - "restartNeeded":{ - "shape":"Boolean", - "documentation":"

Whether or not implementing the recommendation requires a restart.

" - }, - "rollbackPossible":{ - "shape":"Boolean", - "documentation":"

Whether or not implementing the recommendation can be rolled back.

" + "actionTypes":{ + "shape":"ActionTypeList", + "documentation":"

The type of action you can take by adopting the recommendation.

" }, "tags":{ "shape":"TagList", "documentation":"

A list of tags assigned to the recommendation.

" + }, + "resourceIds":{ + "shape":"ResourceIdList", + "documentation":"

The resource ID of the recommendation.

" + }, + "resourceArns":{ + "shape":"ResourceArnList", + "documentation":"

The Amazon Resource Name (ARN) of the recommendation.

" + }, + "recommendationIds":{ + "shape":"RecommendationIdList", + "documentation":"

The IDs for the recommendations.

" } }, "documentation":"

Describes a filter that returns a more specific list of recommendations. Filters recommendations by different dimensions.

" @@ -658,13 +670,13 @@ "GetPreferencesResponse":{ "type":"structure", "members":{ - "memberAccountDiscountVisibility":{ - "shape":"MemberAccountDiscountVisibility", - "documentation":"

Retrieves the status of the \"member account discount visibility\" preference.

" - }, "savingsEstimationMode":{ "shape":"SavingsEstimationMode", "documentation":"

Retrieves the status of the \"savings estimation mode\" preference.

" + }, + "memberAccountDiscountVisibility":{ + "shape":"MemberAccountDiscountVisibility", + "documentation":"

Retrieves the status of the \"member account discount visibility\" preference.

" } } }, @@ -681,93 +693,93 @@ "GetRecommendationResponse":{ "type":"structure", "members":{ + "recommendationId":{ + "shape":"String", + "documentation":"

The ID for the recommendation.

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

The unique identifier for the resource. This is the same as the Amazon Resource Name (ARN), if available.

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

The Amazon Resource Name (ARN) of the resource.

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

The account that the recommendation is for.

" }, - "actionType":{ - "shape":"ActionType", - "documentation":"

The type of action you can take by adopting the recommendation.

" + "currencyCode":{ + "shape":"String", + "documentation":"

The currency code used for the recommendation.

" + }, + "recommendationLookbackPeriodInDays":{ + "shape":"Integer", + "documentation":"

The lookback period that's used to generate the recommendation.

" }, "costCalculationLookbackPeriodInDays":{ "shape":"Integer", "documentation":"

The lookback period used to calculate cost impact for a recommendation.

" }, - "currencyCode":{ - "shape":"String", - "documentation":"

The currency code used for the recommendation.

" + "estimatedSavingsPercentage":{ + "shape":"Double", + "documentation":"

The estimated savings percentage relative to the total cost over the cost calculation lookback period.

" }, - "currentResourceDetails":{ - "shape":"ResourceDetails", - "documentation":"

The details for the resource.

" + "estimatedSavingsOverCostCalculationLookbackPeriod":{ + "shape":"Double", + "documentation":"

The estimated savings amount over the lookback period used to calculate cost impact for a recommendation.

" }, "currentResourceType":{ "shape":"ResourceType", "documentation":"

The type of resource.

" }, - "estimatedMonthlyCost":{ - "shape":"Double", - "documentation":"

The estimated monthly cost of the recommendation.

" + "recommendedResourceType":{ + "shape":"ResourceType", + "documentation":"

The resource type of the recommendation.

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

The Amazon Web Services Region of the resource.

" + }, + "source":{ + "shape":"Source", + "documentation":"

The source of the recommendation.

" + }, + "lastRefreshTimestamp":{ + "shape":"Datetime", + "documentation":"

The time when the recommendation was last generated.

" }, "estimatedMonthlySavings":{ "shape":"Double", "documentation":"

The estimated monthly savings amount for the recommendation.

" }, - "estimatedSavingsOverCostCalculationLookbackPeriod":{ - "shape":"Double", - "documentation":"

The estimated savings amount over the lookback period used to calculate cost impact for a recommendation.

" - }, - "estimatedSavingsPercentage":{ + "estimatedMonthlyCost":{ "shape":"Double", - "documentation":"

The estimated savings percentage relative to the total cost over the cost calculation lookback period.

" + "documentation":"

The estimated monthly cost of the current resource. For Reserved Instances and Savings Plans, it refers to the cost for eligible usage.

" }, "implementationEffort":{ "shape":"ImplementationEffort", "documentation":"

The effort required to implement the recommendation.

" }, - "lastRefreshTimestamp":{ - "shape":"Datetime", - "documentation":"

The time when the recommendation was last generated.

" - }, - "recommendationId":{ - "shape":"String", - "documentation":"

The ID for the recommendation.

" - }, - "recommendationLookbackPeriodInDays":{ - "shape":"Integer", - "documentation":"

The lookback period that's used to generate the recommendation.

" - }, - "recommendedResourceDetails":{ - "shape":"ResourceDetails", - "documentation":"

The details about the recommended resource.

" - }, - "recommendedResourceType":{ - "shape":"ResourceType", - "documentation":"

The resource type of the recommendation.

" - }, - "region":{ - "shape":"String", - "documentation":"

The Amazon Web Services Region of the resource.

" - }, - "resourceArn":{ - "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the resource.

" - }, - "resourceId":{ - "shape":"String", - "documentation":"

The unique identifier for the resource. This is the same as the Amazon Resource Name (ARN), if available.

" - }, "restartNeeded":{ "shape":"Boolean", "documentation":"

Whether or not implementing the recommendation requires a restart.

" }, + "actionType":{ + "shape":"ActionType", + "documentation":"

The type of action you can take by adopting the recommendation.

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

Whether or not implementing the recommendation can be rolled back.

" }, - "source":{ - "shape":"Source", - "documentation":"

The source of the recommendation.

" + "currentResourceDetails":{ + "shape":"ResourceDetails", + "documentation":"

The details for the resource.

" + }, + "recommendedResourceDetails":{ + "shape":"ResourceDetails", + "documentation":"

The details about the recommended resource.

" }, "tags":{ "shape":"TagList", @@ -842,35 +854,35 @@ "ListEnrollmentStatusesRequest":{ "type":"structure", "members":{ - "accountId":{ - "shape":"AccountId", - "documentation":"

The account ID of a member account in the organization.

" - }, "includeOrganizationInfo":{ "shape":"PrimitiveBoolean", "documentation":"

Indicates whether to return the enrollment status for the organization.

" }, - "maxResults":{ - "shape":"MaxResults", - "documentation":"

The maximum number of objects that are returned for the request.

" + "accountId":{ + "shape":"AccountId", + "documentation":"

The account ID of a member account in the organization.

" }, "nextToken":{ "shape":"String", "documentation":"

The token to retrieve the next set of results.

" + }, + "maxResults":{ + "shape":"MaxResults", + "documentation":"

The maximum number of objects that are returned for the request.

" } } }, "ListEnrollmentStatusesResponse":{ "type":"structure", "members":{ - "includeMemberAccounts":{ - "shape":"Boolean", - "documentation":"

The enrollment status of all member accounts in the organization if the account is the management account.

" - }, "items":{ "shape":"AccountEnrollmentStatuses", "documentation":"

The enrollment status of a specific account ID, including creation and last updated timestamps.

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

The enrollment status of all member accounts in the organization if the account is the management account.

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

The token to retrieve the next set of results.

" @@ -905,21 +917,21 @@ "ListRecommendationSummariesResponse":{ "type":"structure", "members":{ - "currencyCode":{ - "shape":"String", - "documentation":"

The currency code used for the recommendation.

" - }, "estimatedTotalDedupedSavings":{ "shape":"Double", "documentation":"

The total overall savings for the aggregated view.

" }, + "items":{ + "shape":"RecommendationSummariesList", + "documentation":"

List of all savings recommendations.

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

The dimension used to group the recommendations by.

" }, - "items":{ - "shape":"RecommendationSummariesList", - "documentation":"

List of all savings recommendations.

" + "currencyCode":{ + "shape":"String", + "documentation":"

The currency code used for the recommendation.

" }, "nextToken":{ "shape":"String", @@ -934,6 +946,10 @@ "shape":"Filter", "documentation":"

The constraints that you want all returned recommendations to match.

" }, + "orderBy":{ + "shape":"OrderBy", + "documentation":"

The ordering of recommendations by a dimension.

" + }, "includeAllRecommendations":{ "shape":"PrimitiveBoolean", "documentation":"

List of all recommendations for a resource, or a single recommendation if de-duped by resourceId.

" @@ -945,10 +961,6 @@ "nextToken":{ "shape":"String", "documentation":"

The token to retrieve the next set of results.

" - }, - "orderBy":{ - "shape":"OrderBy", - "documentation":"

The ordering of recommendations by a dimension.

" } } }, @@ -1005,49 +1017,49 @@ "shape":"String", "documentation":"

The account scope that you want your recommendations for.

" }, - "currentGeneration":{ + "service":{ "shape":"String", - "documentation":"

Determines whether the recommendation is for a current generation instance.

" + "documentation":"

The service that you want your recommendations for.

" }, - "instanceType":{ + "normalizedUnitsToPurchase":{ "shape":"String", - "documentation":"

The type of instance that Amazon Web Services recommends.

" + "documentation":"

The number of normalized units that Amazon Web Services recommends that you purchase.

" }, - "monthlyRecurringCost":{ + "term":{ "shape":"String", - "documentation":"

How much purchasing reserved instances costs you on a monthly basis.

" + "documentation":"

The reserved instances recommendation term in years.

" }, - "normalizedUnitsToPurchase":{ + "paymentOption":{ "shape":"String", - "documentation":"

The number of normalized units that Amazon Web Services recommends that you purchase.

" + "documentation":"

The payment option for the commitment.

" }, "numberOfInstancesToPurchase":{ "shape":"String", "documentation":"

The number of instances that Amazon Web Services recommends that you purchase.

" }, - "paymentOption":{ + "instanceType":{ "shape":"String", - "documentation":"

The payment option for the commitment.

" + "documentation":"

The type of instance that Amazon Web Services recommends.

" }, "reservedInstancesRegion":{ "shape":"String", "documentation":"

The Amazon Web Services Region of the commitment.

" }, - "service":{ + "currentGeneration":{ "shape":"String", - "documentation":"

The service that you want your recommendations for.

" + "documentation":"

Determines whether the recommendation is for a current generation instance.

" }, "sizeFlexEligible":{ "shape":"Boolean", "documentation":"

Determines whether the recommendation is size flexible.

" }, - "term":{ - "shape":"String", - "documentation":"

The reserved instances recommendation term in years.

" - }, "upfrontCost":{ "shape":"String", "documentation":"

How much purchasing this instance costs you upfront.

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

How much purchasing reserved instances costs you on a monthly basis.

" } }, "documentation":"

The OpenSearch reserved instances configuration used for recommendations.

" @@ -1074,6 +1086,60 @@ "documentation":"

Defines how rows will be sorted in the response.

" }, "PrimitiveBoolean":{"type":"boolean"}, + "RdsDbInstance":{ + "type":"structure", + "members":{ + "configuration":{ + "shape":"RdsDbInstanceConfiguration", + "documentation":"

The Amazon RDS DB instance configuration used for recommendations.

" + }, + "costCalculation":{"shape":"ResourceCostCalculation"} + }, + "documentation":"

Contains the details of an Amazon RDS DB instance.

" + }, + "RdsDbInstanceConfiguration":{ + "type":"structure", + "members":{ + "instance":{ + "shape":"DbInstanceConfiguration", + "documentation":"

Details about the instance configuration.

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

The Amazon RDS DB instance configuration used for recommendations.

" + }, + "RdsDbInstanceStorage":{ + "type":"structure", + "members":{ + "configuration":{ + "shape":"RdsDbInstanceStorageConfiguration", + "documentation":"

The Amazon RDS DB instance storage configuration used for recommendations.

" + }, + "costCalculation":{"shape":"ResourceCostCalculation"} + }, + "documentation":"

Contains the details of an Amazon RDS DB instance storage.

" + }, + "RdsDbInstanceStorageConfiguration":{ + "type":"structure", + "members":{ + "storageType":{ + "shape":"String", + "documentation":"

The storage type to associate with the DB instance.

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

The new amount of storage in GB to allocate for the DB instance.

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

The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for the DB instance.

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

The storage throughput for the DB instance.

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

The Amazon RDS DB instance storage configuration used for recommendations.

" + }, "RdsReservedInstances":{ "type":"structure", "members":{ @@ -1095,21 +1161,25 @@ "shape":"String", "documentation":"

The account scope that you want your recommendations for.

" }, - "currentGeneration":{ + "service":{ "shape":"String", - "documentation":"

Determines whether the recommendation is for a current generation instance.

" + "documentation":"

The service that you want your recommendations for.

" }, - "databaseEdition":{ + "normalizedUnitsToPurchase":{ "shape":"String", - "documentation":"

The database edition that the recommended reservation supports.

" + "documentation":"

The number of normalized units that Amazon Web Services recommends that you purchase.

" }, - "databaseEngine":{ + "term":{ "shape":"String", - "documentation":"

The database engine that the recommended reservation supports.

" + "documentation":"

The reserved instances recommendation term in years.

" }, - "deploymentOption":{ + "paymentOption":{ "shape":"String", - "documentation":"

Determines whether the recommendation is for a reservation in a single Availability Zone or a reservation with a backup in a second Availability Zone.

" + "documentation":"

The payment option for the commitment.

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

The number of instances that Amazon Web Services recommends that you purchase.

" }, "instanceFamily":{ "shape":"String", @@ -1119,45 +1189,41 @@ "shape":"String", "documentation":"

The type of instance that Amazon Web Services recommends.

" }, - "licenseModel":{ + "reservedInstancesRegion":{ "shape":"String", - "documentation":"

The license model that the recommended reservation supports.

" + "documentation":"

The Amazon Web Services Region of the commitment.

" }, - "monthlyRecurringCost":{ - "shape":"String", - "documentation":"

How much purchasing this instance costs you on a monthly basis.

" + "sizeFlexEligible":{ + "shape":"Boolean", + "documentation":"

Determines whether the recommendation is size flexible.

" }, - "normalizedUnitsToPurchase":{ + "currentGeneration":{ "shape":"String", - "documentation":"

The number of normalized units that Amazon Web Services recommends that you purchase.

" + "documentation":"

Determines whether the recommendation is for a current generation instance.

" }, - "numberOfInstancesToPurchase":{ + "upfrontCost":{ "shape":"String", - "documentation":"

The number of instances that Amazon Web Services recommends that you purchase.

" + "documentation":"

How much purchasing this instance costs you upfront.

" }, - "paymentOption":{ + "monthlyRecurringCost":{ "shape":"String", - "documentation":"

The payment option for the commitment.

" + "documentation":"

How much purchasing this instance costs you on a monthly basis.

" }, - "reservedInstancesRegion":{ + "licenseModel":{ "shape":"String", - "documentation":"

The Amazon Web Services Region of the commitment.

" + "documentation":"

The license model that the recommended reservation supports.

" }, - "service":{ + "databaseEdition":{ "shape":"String", - "documentation":"

The service that you want your recommendations for.

" - }, - "sizeFlexEligible":{ - "shape":"Boolean", - "documentation":"

Determines whether the recommendation is size flexible.

" + "documentation":"

The database edition that the recommended reservation supports.

" }, - "term":{ + "databaseEngine":{ "shape":"String", - "documentation":"

The reserved instances recommendation term in years.

" + "documentation":"

The database engine that the recommended reservation supports.

" }, - "upfrontCost":{ + "deploymentOption":{ "shape":"String", - "documentation":"

How much purchasing this instance costs you upfront.

" + "documentation":"

Determines whether the recommendation is for a reservation in a single Availability Zone or a reservation with a backup in a second Availability Zone.

" } }, "documentation":"

The RDS reserved instances configuration used for recommendations.

" @@ -1165,82 +1231,82 @@ "Recommendation":{ "type":"structure", "members":{ - "accountId":{ - "shape":"String", - "documentation":"

The account that the recommendation is for.

" - }, - "actionType":{ - "shape":"String", - "documentation":"

The type of tasks that can be carried out by this action.

" - }, - "currencyCode":{ - "shape":"String", - "documentation":"

The currency code used for the recommendation.

" - }, - "currentResourceSummary":{ + "recommendationId":{ "shape":"String", - "documentation":"

Describes the current resource.

" + "documentation":"

The ID for the recommendation.

" }, - "currentResourceType":{ + "accountId":{ "shape":"String", - "documentation":"

The current resource type.

" - }, - "estimatedMonthlyCost":{ - "shape":"Double", - "documentation":"

The estimated monthly cost for the recommendation.

" - }, - "estimatedMonthlySavings":{ - "shape":"Double", - "documentation":"

The estimated monthly savings amount for the recommendation.

" - }, - "estimatedSavingsPercentage":{ - "shape":"Double", - "documentation":"

The estimated savings percentage relative to the total cost over the cost calculation lookback period.

" + "documentation":"

The account that the recommendation is for.

" }, - "implementationEffort":{ + "region":{ "shape":"String", - "documentation":"

The effort required to implement the recommendation.

" - }, - "lastRefreshTimestamp":{ - "shape":"Datetime", - "documentation":"

The time when the recommendation was last generated.

" + "documentation":"

The Amazon Web Services Region of the resource.

" }, - "recommendationId":{ + "resourceId":{ "shape":"String", - "documentation":"

The ID for the recommendation.

" + "documentation":"

The resource ID for the recommendation.

" }, - "recommendationLookbackPeriodInDays":{ - "shape":"Integer", - "documentation":"

The lookback period that's used to generate the recommendation.

" + "resourceArn":{ + "shape":"String", + "documentation":"

The Amazon Resource Name (ARN) for the recommendation.

" }, - "recommendedResourceSummary":{ + "currentResourceType":{ "shape":"String", - "documentation":"

Describes the recommended resource.

" + "documentation":"

The current resource type.

" }, "recommendedResourceType":{ "shape":"String", "documentation":"

The recommended resource type.

" }, - "region":{ - "shape":"String", - "documentation":"

The Amazon Web Services Region of the resource.

" + "estimatedMonthlySavings":{ + "shape":"Double", + "documentation":"

The estimated monthly savings amount for the recommendation.

" }, - "resourceArn":{ + "estimatedSavingsPercentage":{ + "shape":"Double", + "documentation":"

The estimated savings percentage relative to the total cost over the cost calculation lookback period.

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

The estimated monthly cost of the current resource. For Reserved Instances and Savings Plans, it refers to the cost for eligible usage.

" + }, + "currencyCode":{ "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) for the recommendation.

" + "documentation":"

The currency code used for the recommendation.

" }, - "resourceId":{ + "implementationEffort":{ "shape":"String", - "documentation":"

The resource ID for the recommendation.

" + "documentation":"

The effort required to implement the recommendation.

" }, "restartNeeded":{ "shape":"Boolean", "documentation":"

Whether or not implementing the recommendation requires a restart.

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

The type of tasks that can be carried out by this action.

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

Whether or not implementing the recommendation can be rolled back.

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

Describes the current resource.

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

Describes the recommended resource.

" + }, + "lastRefreshTimestamp":{ + "shape":"Datetime", + "documentation":"

The time when the recommendation was last generated.

" + }, + "recommendationLookbackPeriodInDays":{ + "shape":"Integer", + "documentation":"

The lookback period that's used to generate the recommendation.

" + }, "source":{ "shape":"Source", "documentation":"

The source of the recommendation.

" @@ -1269,14 +1335,14 @@ "RecommendationSummary":{ "type":"structure", "members":{ - "estimatedMonthlySavings":{ - "shape":"Double", - "documentation":"

The estimated total savings resulting from modifications, on a monthly basis.

" - }, "group":{ "shape":"String", "documentation":"

The grouping of recommendations.

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

The estimated total savings resulting from modifications, on a monthly basis.

" + }, "recommendationCount":{ "shape":"Integer", "documentation":"

The total number of instance recommendations.

" @@ -1305,53 +1371,53 @@ "shape":"String", "documentation":"

The account scope that you want your recommendations for.

" }, - "currentGeneration":{ - "shape":"String", - "documentation":"

Determines whether the recommendation is for a current generation instance.

" - }, - "instanceFamily":{ + "service":{ "shape":"String", - "documentation":"

The instance family of the recommended reservation.

" + "documentation":"

The service that you want your recommendations for.

" }, - "instanceType":{ + "normalizedUnitsToPurchase":{ "shape":"String", - "documentation":"

The type of instance that Amazon Web Services recommends.

" + "documentation":"

The number of normalized units that Amazon Web Services recommends that you purchase.

" }, - "monthlyRecurringCost":{ + "term":{ "shape":"String", - "documentation":"

How much purchasing reserved instances costs you on a monthly basis.

" + "documentation":"

The reserved instances recommendation term in years.

" }, - "normalizedUnitsToPurchase":{ + "paymentOption":{ "shape":"String", - "documentation":"

The number of normalized units that Amazon Web Services recommends that you purchase.

" + "documentation":"

The payment option for the commitment.

" }, "numberOfInstancesToPurchase":{ "shape":"String", "documentation":"

The number of instances that Amazon Web Services recommends that you purchase.

" }, - "paymentOption":{ + "instanceFamily":{ "shape":"String", - "documentation":"

The payment option for the commitment.

" + "documentation":"

The instance family of the recommended reservation.

" }, - "reservedInstancesRegion":{ + "instanceType":{ "shape":"String", - "documentation":"

The Amazon Web Services Region of the commitment.

" + "documentation":"

The type of instance that Amazon Web Services recommends.

" }, - "service":{ + "reservedInstancesRegion":{ "shape":"String", - "documentation":"

The service that you want your recommendations for.

" + "documentation":"

The Amazon Web Services Region of the commitment.

" }, "sizeFlexEligible":{ "shape":"Boolean", "documentation":"

Determines whether the recommendation is size flexible.

" }, - "term":{ + "currentGeneration":{ "shape":"String", - "documentation":"

The reserved instances recommendation term in years.

" + "documentation":"

Determines whether the recommendation is for a current generation instance.

" }, "upfrontCost":{ "shape":"String", "documentation":"

How much purchasing this instance costs you upfront.

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

How much purchasing reserved instances costs you on a monthly basis.

" } }, "documentation":"

The Redshift reserved instances configuration used for recommendations.

" @@ -1375,10 +1441,6 @@ "ReservedInstancesPricing":{ "type":"structure", "members":{ - "estimatedMonthlyAmortizedReservationCost":{ - "shape":"Double", - "documentation":"

The estimated cost of your recurring monthly fees for the recommended reserved instance across the month.

" - }, "estimatedOnDemandCost":{ "shape":"Double", "documentation":"

The remaining On-Demand cost estimated to not be covered by the recommended reserved instance, over the length of the lookback period.

" @@ -1390,6 +1452,10 @@ "savingsPercentage":{ "shape":"Double", "documentation":"

The savings percentage relative to the total On-Demand costs that are associated with this instance.

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

The estimated cost of your recurring monthly fees for the recommended reserved instance across the month.

" } }, "documentation":"

Pricing details for your recommended reserved instance.

" @@ -1403,13 +1469,13 @@ "ResourceCostCalculation":{ "type":"structure", "members":{ - "pricing":{ - "shape":"ResourcePricing", - "documentation":"

Pricing details of the resource recommendation.

" - }, "usages":{ "shape":"UsageList", "documentation":"

Usage details of the resource recommendation.

" + }, + "pricing":{ + "shape":"ResourcePricing", + "documentation":"

Pricing details of the resource recommendation.

" } }, "documentation":"

Cost impact of the resource recommendation.

" @@ -1417,9 +1483,17 @@ "ResourceDetails":{ "type":"structure", "members":{ - "computeSavingsPlans":{ - "shape":"ComputeSavingsPlans", - "documentation":"

The Compute Savings Plans recommendation details.

" + "lambdaFunction":{ + "shape":"LambdaFunction", + "documentation":"

The Lambda function recommendation details.

" + }, + "ecsService":{ + "shape":"EcsService", + "documentation":"

The ECS service recommendation details.

" + }, + "ec2Instance":{ + "shape":"Ec2Instance", + "documentation":"

The EC2 instance recommendation details.

" }, "ebsVolume":{ "shape":"EbsVolume", @@ -1429,45 +1503,45 @@ "shape":"Ec2AutoScalingGroup", "documentation":"

The EC2 Auto Scaling group recommendation details.

" }, - "ec2Instance":{ - "shape":"Ec2Instance", - "documentation":"

The EC2 instance recommendation details.

" - }, - "ec2InstanceSavingsPlans":{ - "shape":"Ec2InstanceSavingsPlans", - "documentation":"

The EC2 instance Savings Plans recommendation details.

" - }, "ec2ReservedInstances":{ "shape":"Ec2ReservedInstances", "documentation":"

The EC2 reserved instances recommendation details.

" }, - "ecsService":{ - "shape":"EcsService", - "documentation":"

The ECS service recommendation details.

" + "rdsReservedInstances":{ + "shape":"RdsReservedInstances", + "documentation":"

The RDS reserved instances recommendation details.

" }, "elastiCacheReservedInstances":{ "shape":"ElastiCacheReservedInstances", "documentation":"

The ElastiCache reserved instances recommendation details.

" }, - "lambdaFunction":{ - "shape":"LambdaFunction", - "documentation":"

The Lambda function recommendation details.

" - }, "openSearchReservedInstances":{ "shape":"OpenSearchReservedInstances", "documentation":"

The OpenSearch reserved instances recommendation details.

" }, - "rdsReservedInstances":{ - "shape":"RdsReservedInstances", - "documentation":"

The RDS reserved instances recommendation details.

" - }, "redshiftReservedInstances":{ "shape":"RedshiftReservedInstances", "documentation":"

The Redshift reserved instances recommendation details.

" }, + "ec2InstanceSavingsPlans":{ + "shape":"Ec2InstanceSavingsPlans", + "documentation":"

The EC2 instance Savings Plans recommendation details.

" + }, + "computeSavingsPlans":{ + "shape":"ComputeSavingsPlans", + "documentation":"

The Compute Savings Plans recommendation details.

" + }, "sageMakerSavingsPlans":{ "shape":"SageMakerSavingsPlans", "documentation":"

The SageMaker Savings Plans recommendation details.

" + }, + "rdsDbInstance":{ + "shape":"RdsDbInstance", + "documentation":"

The DB instance recommendation details.

" + }, + "rdsDbInstanceStorage":{ + "shape":"RdsDbInstanceStorage", + "documentation":"

The DB instance storage recommendation details.

" } }, "documentation":"

Contains detailed information about the specified resource.

", @@ -1498,21 +1572,21 @@ "ResourcePricing":{ "type":"structure", "members":{ - "estimatedCostAfterDiscounts":{ - "shape":"Double", - "documentation":"

The savings estimate incorporating all discounts with Amazon Web Services, such as Reserved Instances and Savings Plans.

" - }, "estimatedCostBeforeDiscounts":{ "shape":"Double", "documentation":"

The savings estimate using Amazon Web Services public pricing without incorporating any discounts.

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

The estimated net unused amortized commitment for the recommendation.

" + }, "estimatedDiscounts":{ "shape":"EstimatedDiscounts", "documentation":"

The estimated discounts for a recommendation.

" }, - "estimatedNetUnusedAmortizedCommitments":{ + "estimatedCostAfterDiscounts":{ "shape":"Double", - "documentation":"

The estimated net unused amortized commitment for the recommendation.

" + "documentation":"

The savings estimate incorporating all discounts with Amazon Web Services, such as Reserved Instances and Savings Plans.

" } }, "documentation":"

Contains pricing information about the specified resource.

" @@ -1532,7 +1606,9 @@ "RdsReservedInstances", "OpenSearchReservedInstances", "RedshiftReservedInstances", - "ElastiCacheReservedInstances" + "ElastiCacheReservedInstances", + "RdsDbInstanceStorage", + "RdsDbInstance" ] }, "ResourceTypeList":{ @@ -1562,17 +1638,17 @@ "shape":"String", "documentation":"

The account scope that you want your recommendations for.

" }, - "hourlyCommitment":{ + "term":{ "shape":"String", - "documentation":"

The hourly commitment for the Savings Plans type.

" + "documentation":"

The Savings Plans recommendation term in years.

" }, "paymentOption":{ "shape":"String", "documentation":"

The payment option for the commitment.

" }, - "term":{ + "hourlyCommitment":{ "shape":"String", - "documentation":"

The Savings Plans recommendation term in years.

" + "documentation":"

The hourly commitment for the Savings Plans type.

" } }, "documentation":"

The SageMaker Savings Plans configuration used for recommendations.

" @@ -1597,21 +1673,21 @@ "SavingsPlansPricing":{ "type":"structure", "members":{ - "estimatedMonthlyCommitment":{ - "shape":"Double", - "documentation":"

Estimated monthly commitment for the Savings Plan.

" - }, - "estimatedOnDemandCost":{ - "shape":"Double", - "documentation":"

Estimated On-Demand cost you will pay after buying the Savings Plan.

" - }, "monthlySavingsPlansEligibleCost":{ "shape":"Double", "documentation":"

The cost of paying for the recommended Savings Plan monthly.

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

Estimated monthly commitment for the Savings Plan.

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

Estimated savings as a percentage of your overall costs after buying the Savings Plan.

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

Estimated On-Demand cost you will pay after buying the Savings Plan.

" } }, "documentation":"

Pricing information about a Savings Plan.

" @@ -1626,13 +1702,13 @@ "StorageConfiguration":{ "type":"structure", "members":{ - "sizeInGb":{ - "shape":"Double", - "documentation":"

The storage volume.

" - }, "type":{ "shape":"String", "documentation":"

The storage type.

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

The storage volume.

" } }, "documentation":"

The storage configuration used for recommendations.

" @@ -1671,13 +1747,13 @@ "type":"structure", "required":["status"], "members":{ - "includeMemberAccounts":{ - "shape":"Boolean", - "documentation":"

Indicates whether to enroll member accounts of the organization if the account is the management account.

" - }, "status":{ "shape":"EnrollmentStatus", "documentation":"

Sets the account status.

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

Indicates whether to enroll member accounts of the organization if the account is the management account.

" } } }, @@ -1693,32 +1769,40 @@ "UpdatePreferencesRequest":{ "type":"structure", "members":{ - "memberAccountDiscountVisibility":{ - "shape":"MemberAccountDiscountVisibility", - "documentation":"

Sets the \"member account discount visibility\" preference.

" - }, "savingsEstimationMode":{ "shape":"SavingsEstimationMode", "documentation":"

Sets the \"savings estimation mode\" preference.

" + }, + "memberAccountDiscountVisibility":{ + "shape":"MemberAccountDiscountVisibility", + "documentation":"

Sets the \"member account discount visibility\" preference.

" } } }, "UpdatePreferencesResponse":{ "type":"structure", "members":{ - "memberAccountDiscountVisibility":{ - "shape":"MemberAccountDiscountVisibility", - "documentation":"

Shows the status of the \"member account discount visibility\" preference.

" - }, "savingsEstimationMode":{ "shape":"SavingsEstimationMode", "documentation":"

Shows the status of the \"savings estimation mode\" preference.

" + }, + "memberAccountDiscountVisibility":{ + "shape":"MemberAccountDiscountVisibility", + "documentation":"

Shows the status of the \"member account discount visibility\" preference.

" } } }, "Usage":{ "type":"structure", "members":{ + "usageType":{ + "shape":"String", + "documentation":"

The usage type.

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

The usage amount.

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

The operation value.

" @@ -1730,14 +1814,6 @@ "unit":{ "shape":"String", "documentation":"

The usage unit.

" - }, - "usageAmount":{ - "shape":"Double", - "documentation":"

The usage amount.

" - }, - "usageType":{ - "shape":"String", - "documentation":"

The usage type.

" } }, "documentation":"

Details about the usage.

" @@ -1750,14 +1826,14 @@ "type":"structure", "required":["message"], "members":{ - "fields":{ - "shape":"ValidationExceptionDetails", - "documentation":"

The list of fields that are invalid.

" - }, "message":{"shape":"String"}, "reason":{ "shape":"ValidationExceptionReason", "documentation":"

The reason for the validation exception.

" + }, + "fields":{ + "shape":"ValidationExceptionDetails", + "documentation":"

The list of fields that are invalid.

" } }, "documentation":"

The input fails to satisfy the constraints specified by an Amazon Web Services service.

", diff --git a/botocore/data/cost-optimization-hub/2022-07-26/waiters-2.json b/botocore/data/cost-optimization-hub/2022-07-26/waiters-2.json new file mode 100644 index 0000000000..13f60ee66b --- /dev/null +++ b/botocore/data/cost-optimization-hub/2022-07-26/waiters-2.json @@ -0,0 +1,5 @@ +{ + "version": 2, + "waiters": { + } +} diff --git a/botocore/data/dynamodb/2012-08-10/service-2.json b/botocore/data/dynamodb/2012-08-10/service-2.json index af3d6fb19f..d1a34493c5 100644 --- a/botocore/data/dynamodb/2012-08-10/service-2.json +++ b/botocore/data/dynamodb/2012-08-10/service-2.json @@ -11,7 +11,8 @@ "serviceId":"DynamoDB", "signatureVersion":"v4", "targetPrefix":"DynamoDB_20120810", - "uid":"dynamodb-2012-08-10" + "uid":"dynamodb-2012-08-10", + "auth":["aws.auth#sigv4"] }, "operations":{ "BatchExecuteStatement":{ @@ -99,7 +100,7 @@ {"shape":"GlobalTableAlreadyExistsException"}, {"shape":"TableNotFoundException"} ], - "documentation":"

Creates a global table from an existing table. A global table creates a replication relationship between two or more DynamoDB tables with the same table name in the provided Regions.

For global tables, this operation only applies to global tables using Version 2019.11.21 (Current version), as it provides greater flexibility, higher efficiency and consumes less write capacity than 2017.11.29 (Legacy). To determine which version you are using, see Determining the version. To update existing global tables from version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see Updating global tables.

If you want to add a new replica table to a global table, each of the following conditions must be true:

If global secondary indexes are specified, then the following conditions must also be met:

If local secondary indexes are specified, then the following conditions must also be met:

Write capacity settings should be set consistently across your replica tables and secondary indexes. DynamoDB strongly recommends enabling auto scaling to manage the write capacity settings for all of your global tables replicas and indexes.

If you prefer to manage write capacity settings manually, you should provision equal replicated write capacity units to your replica tables. You should also provision equal replicated write capacity units to matching secondary indexes across your global table.

", + "documentation":"

Creates a global table from an existing table. A global table creates a replication relationship between two or more DynamoDB tables with the same table name in the provided Regions.

This documentation is for version 2017.11.29 (Legacy) of global tables, which should be avoided for new global tables. Customers should use Global Tables version 2019.11.21 (Current) when possible, because it provides greater flexibility, higher efficiency, and consumes less write capacity than 2017.11.29 (Legacy).

To determine which version you're using, see Determining the global table version you are using. To update existing global tables from version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see Upgrading global tables.

If you want to add a new replica table to a global table, each of the following conditions must be true:

If global secondary indexes are specified, then the following conditions must also be met:

If local secondary indexes are specified, then the following conditions must also be met:

Write capacity settings should be set consistently across your replica tables and secondary indexes. DynamoDB strongly recommends enabling auto scaling to manage the write capacity settings for all of your global tables replicas and indexes.

If you prefer to manage write capacity settings manually, you should provision equal replicated write capacity units to your replica tables. You should also provision equal replicated write capacity units to matching secondary indexes across your global table.

", "endpointdiscovery":{ } }, @@ -280,7 +281,7 @@ {"shape":"InternalServerError"}, {"shape":"GlobalTableNotFoundException"} ], - "documentation":"

Returns information about the specified global table.

For global tables, this operation only applies to global tables using Version 2019.11.21 (Current version), as it provides greater flexibility, higher efficiency and consumes less write capacity than 2017.11.29 (Legacy). To determine which version you are using, see Determining the version. To update existing global tables from version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see Updating global tables.

", + "documentation":"

Returns information about the specified global table.

This documentation is for version 2017.11.29 (Legacy) of global tables, which should be avoided for new global tables. Customers should use Global Tables version 2019.11.21 (Current) when possible, because it provides greater flexibility, higher efficiency, and consumes less write capacity than 2017.11.29 (Legacy).

To determine which version you're using, see Determining the global table version you are using. To update existing global tables from version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see Upgrading global tables.

", "endpointdiscovery":{ } }, @@ -296,7 +297,7 @@ {"shape":"GlobalTableNotFoundException"}, {"shape":"InternalServerError"} ], - "documentation":"

Describes Region-specific settings for a global table.

For global tables, this operation only applies to global tables using Version 2019.11.21 (Current version), as it provides greater flexibility, higher efficiency and consumes less write capacity than 2017.11.29 (Legacy). To determine which version you are using, see Determining the version. To update existing global tables from version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see Updating global tables.

", + "documentation":"

Describes Region-specific settings for a global table.

This documentation is for version 2017.11.29 (Legacy) of global tables, which should be avoided for new global tables. Customers should use Global Tables version 2019.11.21 (Current) when possible, because it provides greater flexibility, higher efficiency, and consumes less write capacity than 2017.11.29 (Legacy).

To determine which version you're using, see Determining the global table version you are using. To update existing global tables from version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see Upgrading global tables.

", "endpointdiscovery":{ } }, @@ -587,7 +588,7 @@ "errors":[ {"shape":"InternalServerError"} ], - "documentation":"

Lists all global tables that have a replica in the specified Region.

For global tables, this operation only applies to global tables using Version 2019.11.21 (Current version), as it provides greater flexibility, higher efficiency and consumes less write capacity than 2017.11.29 (Legacy). To determine which version you are using, see Determining the version. To update existing global tables from version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see Updating global tables.

", + "documentation":"

Lists all global tables that have a replica in the specified Region.

This documentation is for version 2017.11.29 (Legacy) of global tables, which should be avoided for new global tables. Customers should use Global Tables version 2019.11.21 (Current) when possible, because it provides greater flexibility, higher efficiency, and consumes less write capacity than 2017.11.29 (Legacy).

To determine which version you're using, see Determining the global table version you are using. To update existing global tables from version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see Upgrading global tables.

", "endpointdiscovery":{ } }, @@ -872,7 +873,7 @@ {"shape":"ReplicaNotFoundException"}, {"shape":"TableNotFoundException"} ], - "documentation":"

Adds or removes replicas in the specified global table. The global table must already exist to be able to use this operation. Any replica to be added must be empty, have the same name as the global table, have the same key schema, have DynamoDB Streams enabled, and have the same provisioned and maximum write capacity units.

For global tables, this operation only applies to global tables using Version 2019.11.21 (Current version), as it provides greater flexibility, higher efficiency and consumes less write capacity than 2017.11.29 (Legacy). To determine which version you are using, see Determining the version. To update existing global tables from version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see Updating global tables.

For global tables, this operation only applies to global tables using Version 2019.11.21 (Current version). If you are using global tables Version 2019.11.21 you can use UpdateTable instead.

Although you can use UpdateGlobalTable to add replicas and remove replicas in a single request, for simplicity we recommend that you issue separate requests for adding or removing replicas.

If global secondary indexes are specified, then the following conditions must also be met:

", + "documentation":"

Adds or removes replicas in the specified global table. The global table must already exist to be able to use this operation. Any replica to be added must be empty, have the same name as the global table, have the same key schema, have DynamoDB Streams enabled, and have the same provisioned and maximum write capacity units.

This documentation is for version 2017.11.29 (Legacy) of global tables, which should be avoided for new global tables. Customers should use Global Tables version 2019.11.21 (Current) when possible, because it provides greater flexibility, higher efficiency, and consumes less write capacity than 2017.11.29 (Legacy).

To determine which version you're using, see Determining the global table version you are using. To update existing global tables from version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see Upgrading global tables.

For global tables, this operation only applies to global tables using Version 2019.11.21 (Current version). If you are using global tables Version 2019.11.21 you can use UpdateTable instead.

Although you can use UpdateGlobalTable to add replicas and remove replicas in a single request, for simplicity we recommend that you issue separate requests for adding or removing replicas.

If global secondary indexes are specified, then the following conditions must also be met:

", "endpointdiscovery":{ } }, @@ -892,7 +893,7 @@ {"shape":"ResourceInUseException"}, {"shape":"InternalServerError"} ], - "documentation":"

Updates settings for a global table.

For global tables, this operation only applies to global tables using Version 2019.11.21 (Current version), as it provides greater flexibility, higher efficiency and consumes less write capacity than 2017.11.29 (Legacy). To determine which version you are using, see Determining the version. To update existing global tables from version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see Updating global tables.

", + "documentation":"

Updates settings for a global table.

This documentation is for version 2017.11.29 (Legacy) of global tables, which should be avoided for new global tables. Customers should use Global Tables version 2019.11.21 (Current) when possible, because it provides greater flexibility, higher efficiency, and consumes less write capacity than 2017.11.29 (Legacy).

To determine which version you're using, see Determining the global table version you are using. To update existing global tables from version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see Upgrading global tables.

", "endpointdiscovery":{ } }, diff --git a/botocore/data/glue/2017-03-31/paginators-1.json b/botocore/data/glue/2017-03-31/paginators-1.json index 85fe18b9e5..62622ad921 100644 --- a/botocore/data/glue/2017-03-31/paginators-1.json +++ b/botocore/data/glue/2017-03-31/paginators-1.json @@ -118,6 +118,36 @@ "limit_key": "MaxResults", "output_token": "NextToken", "result_key": "Profiles" + }, + "GetWorkflowRuns": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "Runs" + }, + "ListBlueprints": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "Blueprints" + }, + "ListJobs": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "JobNames" + }, + "ListTriggers": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "TriggerNames" + }, + "ListWorkflows": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "Workflows" } } } diff --git a/botocore/data/ivs-realtime/2020-07-14/service-2.json b/botocore/data/ivs-realtime/2020-07-14/service-2.json index 66e5b9e9ab..e5a249f25e 100644 --- a/botocore/data/ivs-realtime/2020-07-14/service-2.json +++ b/botocore/data/ivs-realtime/2020-07-14/service-2.json @@ -509,7 +509,28 @@ "type":"string", "max":128, "min":0, - "pattern":"^[a-zA-Z0-9-_]*$" + "pattern":"[a-zA-Z0-9-_]*" + }, + "AutoParticipantRecordingConfiguration":{ + "type":"structure", + "required":["storageConfigurationArn"], + "members":{ + "storageConfigurationArn":{ + "shape":"AutoParticipantRecordingStorageConfigurationArn", + "documentation":"

ARN of the StorageConfiguration resource to use for auto participant recording. Default: \"\" (empty string, no storage configuration is specified). Individual participant recording cannot be started unless a storage configuration is specified, when a Stage is created or updated.

" + }, + "mediaTypes":{ + "shape":"ParticipantRecordingMediaTypeList", + "documentation":"

Types of media to be recorded. Default: AUDIO_VIDEO.

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

Object specifying an auto-participant-recording configuration.

" + }, + "AutoParticipantRecordingStorageConfigurationArn":{ + "type":"string", + "max":128, + "min":0, + "pattern":"^$|^arn:aws:ivs:[a-z0-9-]+:[0-9]+:storage-configuration/[a-zA-Z0-9-]+$" }, "Bitrate":{ "type":"integer", @@ -521,7 +542,7 @@ "type":"string", "max":128, "min":1, - "pattern":"^arn:aws:ivs:[a-z0-9-]+:[0-9]+:channel/[a-zA-Z0-9-]+$" + "pattern":"arn:aws:ivs:[a-z0-9-]+:[0-9]+:channel/[a-zA-Z0-9-]+" }, "ChannelDestinationConfiguration":{ "type":"structure", @@ -542,43 +563,43 @@ "type":"structure", "required":[ "arn", - "destinations", - "layout", "stageArn", - "state" + "state", + "layout", + "destinations" ], "members":{ "arn":{ "shape":"CompositionArn", "documentation":"

ARN of the Composition resource.

" }, - "destinations":{ - "shape":"DestinationList", - "documentation":"

Array of Destination objects. A Composition can contain either one destination (channel or s3) or two (one channel and one s3).

" - }, - "endTime":{ - "shape":"Time", - "documentation":"

UTC time of the Composition end. This is an ISO 8601 timestamp; note that this is returned as a string.

" - }, - "layout":{ - "shape":"LayoutConfiguration", - "documentation":"

Layout object to configure composition parameters.

" - }, "stageArn":{ "shape":"StageArn", "documentation":"

ARN of the stage used as input

" }, - "startTime":{ - "shape":"Time", - "documentation":"

UTC time of the Composition start. This is an ISO 8601 timestamp; note that this is returned as a string.

" - }, "state":{ "shape":"CompositionState", "documentation":"

State of the Composition.

" }, + "layout":{ + "shape":"LayoutConfiguration", + "documentation":"

Layout object to configure composition parameters.

" + }, + "destinations":{ + "shape":"DestinationList", + "documentation":"

Array of Destination objects. A Composition can contain either one destination (channel or s3) or two (one channel and one s3).

" + }, "tags":{ "shape":"Tags", "documentation":"

Tags attached to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.

" + }, + "startTime":{ + "shape":"Time", + "documentation":"

UTC time of the Composition start. This is an ISO 8601 timestamp; note that this is returned as a string.

" + }, + "endTime":{ + "shape":"Time", + "documentation":"

UTC time of the Composition end. This is an ISO 8601 timestamp; note that this is returned as a string.

" } }, "documentation":"

Object specifying a Composition resource.

" @@ -587,13 +608,13 @@ "type":"string", "max":128, "min":1, - "pattern":"^arn:aws:ivs:[a-z0-9-]+:[0-9]+:composition/[a-zA-Z0-9-]+$" + "pattern":"arn:aws:ivs:[a-z0-9-]+:[0-9]+:composition/[a-zA-Z0-9-]+" }, "CompositionClientToken":{ "type":"string", "max":64, "min":1, - "pattern":"^[a-zA-Z0-9-_]*$" + "pattern":"[a-zA-Z0-9-_]*" }, "CompositionState":{ "type":"string", @@ -609,8 +630,8 @@ "type":"structure", "required":[ "arn", - "destinations", "stageArn", + "destinations", "state" ], "members":{ @@ -618,21 +639,13 @@ "shape":"CompositionArn", "documentation":"

ARN of the Composition resource.

" }, - "destinations":{ - "shape":"DestinationSummaryList", - "documentation":"

Array of Destination objects.

" - }, - "endTime":{ - "shape":"Time", - "documentation":"

UTC time of the Composition end. This is an ISO 8601 timestamp; note that this is returned as a string.

" - }, "stageArn":{ "shape":"StageArn", "documentation":"

ARN of the attached stage.

" }, - "startTime":{ - "shape":"Time", - "documentation":"

UTC time of the Composition start. This is an ISO 8601 timestamp; note that this is returned as a string.

" + "destinations":{ + "shape":"DestinationSummaryList", + "documentation":"

Array of Destination objects.

" }, "state":{ "shape":"CompositionState", @@ -641,6 +654,14 @@ "tags":{ "shape":"Tags", "documentation":"

Tags attached to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.

" + }, + "startTime":{ + "shape":"Time", + "documentation":"

UTC time of the Composition start. This is an ISO 8601 timestamp; note that this is returned as a string.

" + }, + "endTime":{ + "shape":"Time", + "documentation":"

UTC time of the Composition end. This is an ISO 8601 timestamp; note that this is returned as a string.

" } }, "documentation":"

Summary information about a Composition.

" @@ -671,13 +692,13 @@ "shape":"EncoderConfigurationName", "documentation":"

Optional name to identify the resource.

" }, - "tags":{ - "shape":"Tags", - "documentation":"

Tags attached to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.

" - }, "video":{ "shape":"Video", "documentation":"

Video configuration. Default: video resolution 1280x720, bitrate 2500 kbps, 30 fps.

" + }, + "tags":{ + "shape":"Tags", + "documentation":"

Tags attached to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.

" } } }, @@ -694,25 +715,25 @@ "type":"structure", "required":["stageArn"], "members":{ - "attributes":{ - "shape":"ParticipantTokenAttributes", - "documentation":"

Application-provided attributes to encode into the token and attach to a stage. Map keys and values can contain UTF-8 encoded text. The maximum length of this field is 1 KB total. This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.

" - }, - "capabilities":{ - "shape":"ParticipantTokenCapabilities", - "documentation":"

Set of capabilities that the user is allowed to perform in the stage. Default: PUBLISH, SUBSCRIBE.

" + "stageArn":{ + "shape":"StageArn", + "documentation":"

ARN of the stage to which this token is scoped.

" }, "duration":{ "shape":"ParticipantTokenDurationMinutes", "documentation":"

Duration (in minutes), after which the token expires. Default: 720 (12 hours).

" }, - "stageArn":{ - "shape":"StageArn", - "documentation":"

ARN of the stage to which this token is scoped.

" - }, "userId":{ "shape":"ParticipantTokenUserId", "documentation":"

Name that can be specified to help identify the token. This can be any UTF-8 encoded text. This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.

" + }, + "attributes":{ + "shape":"ParticipantTokenAttributes", + "documentation":"

Application-provided attributes to encode into the token and attach to a stage. Map keys and values can contain UTF-8 encoded text. The maximum length of this field is 1 KB total. This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.

" + }, + "capabilities":{ + "shape":"ParticipantTokenCapabilities", + "documentation":"

Set of capabilities that the user is allowed to perform in the stage. Default: PUBLISH, SUBSCRIBE.

" } } }, @@ -739,19 +760,23 @@ "tags":{ "shape":"Tags", "documentation":"

Tags attached to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.

" + }, + "autoParticipantRecordingConfiguration":{ + "shape":"AutoParticipantRecordingConfiguration", + "documentation":"

Auto participant recording configuration object attached to the stage.

" } } }, "CreateStageResponse":{ "type":"structure", "members":{ - "participantTokens":{ - "shape":"ParticipantTokenList", - "documentation":"

Participant tokens attached to the stage. These correspond to the participants in the request.

" - }, "stage":{ "shape":"Stage", "documentation":"

The stage that was created.

" + }, + "participantTokens":{ + "shape":"ParticipantTokenList", + "documentation":"

Participant tokens attached to the stage. These correspond to the participants in the request.

" } } }, @@ -830,34 +855,34 @@ "Destination":{ "type":"structure", "required":[ - "configuration", "id", - "state" + "state", + "configuration" ], "members":{ - "configuration":{ - "shape":"DestinationConfiguration", - "documentation":"

Configuration used to create this destination.

" - }, - "detail":{ - "shape":"DestinationDetail", - "documentation":"

Optional details regarding the status of the destination.

" - }, - "endTime":{ - "shape":"Time", - "documentation":"

UTC time of the destination end. This is an ISO 8601 timestamp; note that this is returned as a string.

" - }, "id":{ "shape":"String", "documentation":"

Unique identifier for this destination, assigned by IVS.

" }, + "state":{ + "shape":"DestinationState", + "documentation":"

State of the Composition Destination.

" + }, "startTime":{ "shape":"Time", "documentation":"

UTC time of the destination start. This is an ISO 8601 timestamp; note that this is returned as a string.

" }, - "state":{ - "shape":"DestinationState", - "documentation":"

State of the Composition Destination.

" + "endTime":{ + "shape":"Time", + "documentation":"

UTC time of the destination end. This is an ISO 8601 timestamp; note that this is returned as a string.

" + }, + "configuration":{ + "shape":"DestinationConfiguration", + "documentation":"

Configuration used to create this destination.

" + }, + "detail":{ + "shape":"DestinationDetail", + "documentation":"

Optional details regarding the status of the destination.

" } }, "documentation":"

Object specifying the status of a Destination.

" @@ -865,14 +890,14 @@ "DestinationConfiguration":{ "type":"structure", "members":{ - "channel":{ - "shape":"ChannelDestinationConfiguration", - "documentation":"

An IVS channel to be used for broadcasting, for server-side composition. Either a channel or an s3 must be specified.

" - }, "name":{ "shape":"DestinationConfigurationName", "documentation":"

Name that can be specified to help identify the destination.

" }, + "channel":{ + "shape":"ChannelDestinationConfiguration", + "documentation":"

An IVS channel to be used for broadcasting, for server-side composition. Either a channel or an s3 must be specified.

" + }, "s3":{ "shape":"S3DestinationConfiguration", "documentation":"

An S3 storage configuration to be used for recording video data. Either a channel or an s3 must be specified.

" @@ -890,7 +915,7 @@ "type":"string", "max":128, "min":0, - "pattern":"^[a-zA-Z0-9-_]*$" + "pattern":"[a-zA-Z0-9-_]*" }, "DestinationDetail":{ "type":"structure", @@ -926,21 +951,21 @@ "state" ], "members":{ - "endTime":{ - "shape":"Time", - "documentation":"

UTC time of the destination end. This is an ISO 8601 timestamp; note that this is returned as a string.

" - }, "id":{ "shape":"String", "documentation":"

Unique identifier for this destination, assigned by IVS.

" }, + "state":{ + "shape":"DestinationState", + "documentation":"

State of the Composition Destination.

" + }, "startTime":{ "shape":"Time", "documentation":"

UTC time of the destination start. This is an ISO 8601 timestamp; note that this is returned as a string.

" }, - "state":{ - "shape":"DestinationState", - "documentation":"

State of the Composition Destination.

" + "endTime":{ + "shape":"Time", + "documentation":"

UTC time of the destination end. This is an ISO 8601 timestamp; note that this is returned as a string.

" } }, "documentation":"

Summary information about a Destination.

" @@ -959,10 +984,14 @@ "DisconnectParticipantRequest":{ "type":"structure", "required":[ - "participantId", - "stageArn" + "stageArn", + "participantId" ], "members":{ + "stageArn":{ + "shape":"StageArn", + "documentation":"

ARN of the stage to which the participant is attached.

" + }, "participantId":{ "shape":"ParticipantTokenId", "documentation":"

Identifier of the participant to be disconnected. This is assigned by IVS and returned by CreateParticipantToken.

" @@ -970,10 +999,6 @@ "reason":{ "shape":"DisconnectParticipantReason", "documentation":"

Description of why this participant is being disconnected.

" - }, - "stageArn":{ - "shape":"StageArn", - "documentation":"

ARN of the stage to which the participant is attached.

" } } }, @@ -994,13 +1019,13 @@ "shape":"EncoderConfigurationName", "documentation":"

Optional name to identify the resource.

" }, - "tags":{ - "shape":"Tags", - "documentation":"

Tags attached to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.

" - }, "video":{ "shape":"Video", "documentation":"

Video configuration. Default: video resolution 1280x720, bitrate 2500 kbps, 30 fps

" + }, + "tags":{ + "shape":"Tags", + "documentation":"

Tags attached to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.

" } }, "documentation":"

Settings for transcoding.

" @@ -1009,7 +1034,7 @@ "type":"string", "max":128, "min":1, - "pattern":"^arn:aws:ivs:[a-z0-9-]+:[0-9]+:encoder-configuration/[a-zA-Z0-9-]+$" + "pattern":"arn:aws:ivs:[a-z0-9-]+:[0-9]+:encoder-configuration/[a-zA-Z0-9-]+" }, "EncoderConfigurationArnList":{ "type":"list", @@ -1021,7 +1046,7 @@ "type":"string", "max":128, "min":0, - "pattern":"^[a-zA-Z0-9-_]*$" + "pattern":"[a-zA-Z0-9-_]*" }, "EncoderConfigurationSummary":{ "type":"structure", @@ -1049,14 +1074,6 @@ "Event":{ "type":"structure", "members":{ - "errorCode":{ - "shape":"EventErrorCode", - "documentation":"

If the event is an error event, the error code is provided to give insight into the specific error that occurred. If the event is not an error event, this field is null. INSUFFICIENT_CAPABILITIES indicates that the participant tried to take an action that the participant’s token is not allowed to do. For more information about participant capabilities, see the capabilities field in CreateParticipantToken. QUOTA_EXCEEDED indicates that the number of participants who want to publish/subscribe to a stage exceeds the quota; for more information, see Service Quotas. PUBLISHER_NOT_FOUND indicates that the participant tried to subscribe to a publisher that doesn’t exist.

" - }, - "eventTime":{ - "shape":"Time", - "documentation":"

ISO 8601 timestamp (returned as a string) for when the event occurred.

" - }, "name":{ "shape":"EventName", "documentation":"

The name of the event.

" @@ -1065,9 +1082,17 @@ "shape":"ParticipantId", "documentation":"

Unique identifier for the participant who triggered the event. This is assigned by IVS.

" }, + "eventTime":{ + "shape":"Time", + "documentation":"

ISO 8601 timestamp (returned as a string) for when the event occurred.

" + }, "remoteParticipantId":{ "shape":"ParticipantId", "documentation":"

Unique identifier for the remote participant. For a subscribe event, this is the publisher. For a publish or join event, this is null. This is assigned by IVS.

" + }, + "errorCode":{ + "shape":"EventErrorCode", + "documentation":"

If the event is an error event, the error code is provided to give insight into the specific error that occurred. If the event is not an error event, this field is null. INSUFFICIENT_CAPABILITIES indicates that the participant tried to take an action that the participant’s token is not allowed to do. For more information about participant capabilities, see the capabilities field in CreateParticipantToken. QUOTA_EXCEEDED indicates that the number of participants who want to publish/subscribe to a stage exceeds the quota; for more information, see Service Quotas. PUBLISHER_NOT_FOUND indicates that the participant tried to subscribe to a publisher that doesn’t exist.

" } }, "documentation":"

An occurrence during a stage session.

" @@ -1145,22 +1170,22 @@ "GetParticipantRequest":{ "type":"structure", "required":[ - "participantId", + "stageArn", "sessionId", - "stageArn" + "participantId" ], "members":{ - "participantId":{ - "shape":"ParticipantId", - "documentation":"

Unique identifier for the participant. This is assigned by IVS and returned by CreateParticipantToken.

" + "stageArn":{ + "shape":"StageArn", + "documentation":"

Stage ARN.

" }, "sessionId":{ "shape":"StageSessionId", "documentation":"

ID of a session within the stage.

" }, - "stageArn":{ - "shape":"StageArn", - "documentation":"

Stage ARN.

" + "participantId":{ + "shape":"ParticipantId", + "documentation":"

Unique identifier for the participant. This is assigned by IVS and returned by CreateParticipantToken.

" } } }, @@ -1195,17 +1220,17 @@ "GetStageSessionRequest":{ "type":"structure", "required":[ - "sessionId", - "stageArn" + "stageArn", + "sessionId" ], "members":{ - "sessionId":{ - "shape":"StageSessionId", - "documentation":"

ID of a session within the stage.

" - }, "stageArn":{ "shape":"StageArn", "documentation":"

ARN of the stage for which the information is to be retrieved.

" + }, + "sessionId":{ + "shape":"StageSessionId", + "documentation":"

ID of a session within the stage.

" } } }, @@ -1244,10 +1269,6 @@ "shape":"AttributeKey", "documentation":"

This attribute name identifies the featured slot. A participant with this attribute set to \"true\" (as a string value) in ParticipantTokenConfiguration is placed in the featured slot.

" }, - "gridGap":{ - "shape":"GridGap", - "documentation":"

Specifies the spacing between participant tiles in pixels. Default: 2.

" - }, "omitStoppedVideo":{ "shape":"OmitStoppedVideo", "documentation":"

Determines whether to omit participants with stopped video in the composition. Default: false.

" @@ -1259,6 +1280,10 @@ "videoFillMode":{ "shape":"VideoFillMode", "documentation":"

Defines how video fits within the participant tile. When not set, videoFillMode defaults to COVER fill mode for participants in the grid and to CONTAIN fill mode for featured participants.

" + }, + "gridGap":{ + "shape":"GridGap", + "documentation":"

Specifies the spacing between participant tiles in pixels. Default: 2.

" } }, "documentation":"

Configuration information specific to Grid layout, for server-side composition. See \"Layouts\" in Server-Side Composition.

" @@ -1303,21 +1328,21 @@ "ListCompositionsRequest":{ "type":"structure", "members":{ - "filterByEncoderConfigurationArn":{ - "shape":"EncoderConfigurationArn", - "documentation":"

Filters the Composition list to match the specified EncoderConfiguration attached to at least one of its output.

" - }, "filterByStageArn":{ "shape":"StageArn", "documentation":"

Filters the Composition list to match the specified Stage ARN.

" }, - "maxResults":{ - "shape":"MaxCompositionResults", - "documentation":"

Maximum number of results to return. Default: 100.

" + "filterByEncoderConfigurationArn":{ + "shape":"EncoderConfigurationArn", + "documentation":"

Filters the Composition list to match the specified EncoderConfiguration attached to at least one of its output.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

The first Composition to retrieve. This is used for pagination; see the nextToken response field.

" + }, + "maxResults":{ + "shape":"MaxCompositionResults", + "documentation":"

Maximum number of results to return. Default: 100.

" } } }, @@ -1338,13 +1363,13 @@ "ListEncoderConfigurationsRequest":{ "type":"structure", "members":{ - "maxResults":{ - "shape":"MaxEncoderConfigurationResults", - "documentation":"

Maximum number of results to return. Default: 100.

" - }, "nextToken":{ "shape":"PaginationToken", "documentation":"

The first encoder configuration to retrieve. This is used for pagination; see the nextToken response field.

" + }, + "maxResults":{ + "shape":"MaxEncoderConfigurationResults", + "documentation":"

Maximum number of results to return. Default: 100.

" } } }, @@ -1365,30 +1390,30 @@ "ListParticipantEventsRequest":{ "type":"structure", "required":[ - "participantId", + "stageArn", "sessionId", - "stageArn" + "participantId" ], "members":{ - "maxResults":{ - "shape":"MaxParticipantEventResults", - "documentation":"

Maximum number of results to return. Default: 50.

" + "stageArn":{ + "shape":"StageArn", + "documentation":"

Stage ARN.

" }, - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

The first participant event to retrieve. This is used for pagination; see the nextToken response field.

" + "sessionId":{ + "shape":"StageSessionId", + "documentation":"

ID of a session within the stage.

" }, "participantId":{ "shape":"ParticipantId", "documentation":"

Unique identifier for this participant. This is assigned by IVS and returned by CreateParticipantToken.

" }, - "sessionId":{ - "shape":"StageSessionId", - "documentation":"

ID of a session within the stage.

" + "nextToken":{ + "shape":"PaginationToken", + "documentation":"

The first participant event to retrieve. This is used for pagination; see the nextToken response field.

" }, - "stageArn":{ - "shape":"StageArn", - "documentation":"

Stage ARN.

" + "maxResults":{ + "shape":"MaxParticipantEventResults", + "documentation":"

Maximum number of results to return. Default: 50.

" } } }, @@ -1409,37 +1434,41 @@ "ListParticipantsRequest":{ "type":"structure", "required":[ - "sessionId", - "stageArn" + "stageArn", + "sessionId" ], "members":{ - "filterByPublished":{ - "shape":"Published", - "documentation":"

Filters the response list to only show participants who published during the stage session. Only one of filterByUserId, filterByPublished, or filterByState can be provided per request.

" + "stageArn":{ + "shape":"StageArn", + "documentation":"

Stage ARN.

" }, - "filterByState":{ - "shape":"ParticipantState", - "documentation":"

Filters the response list to only show participants in the specified state. Only one of filterByUserId, filterByPublished, or filterByState can be provided per request.

" + "sessionId":{ + "shape":"StageSessionId", + "documentation":"

ID of the session within the stage.

" }, "filterByUserId":{ "shape":"UserId", - "documentation":"

Filters the response list to match the specified user ID. Only one of filterByUserId, filterByPublished, or filterByState can be provided per request. A userId is a customer-assigned name to help identify the token; this can be used to link a participant to a user in the customer’s own systems.

" + "documentation":"

Filters the response list to match the specified user ID. Only one of filterByUserId, filterByPublished, filterByState, or filterByRecordingState can be provided per request. A userId is a customer-assigned name to help identify the token; this can be used to link a participant to a user in the customer’s own systems.

" }, - "maxResults":{ - "shape":"MaxParticipantResults", - "documentation":"

Maximum number of results to return. Default: 50.

" + "filterByPublished":{ + "shape":"Published", + "documentation":"

Filters the response list to only show participants who published during the stage session. Only one of filterByUserId, filterByPublished, filterByState, or filterByRecordingState can be provided per request.

" + }, + "filterByState":{ + "shape":"ParticipantState", + "documentation":"

Filters the response list to only show participants in the specified state. Only one of filterByUserId, filterByPublished, filterByState, or filterByRecordingState can be provided per request.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

The first participant to retrieve. This is used for pagination; see the nextToken response field.

" }, - "sessionId":{ - "shape":"StageSessionId", - "documentation":"

ID of the session within the stage.

" + "maxResults":{ + "shape":"MaxParticipantResults", + "documentation":"

Maximum number of results to return. Default: 50.

" }, - "stageArn":{ - "shape":"StageArn", - "documentation":"

Stage ARN.

" + "filterByRecordingState":{ + "shape":"ParticipantRecordingFilterByRecordingState", + "documentation":"

Filters the response list to only show participants with the specified recording state. Only one of filterByUserId, filterByPublished, filterByState, or filterByRecordingState can be provided per request.

" } } }, @@ -1447,13 +1476,13 @@ "type":"structure", "required":["participants"], "members":{ - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

If there are more participants than maxResults, use nextToken in the request to get the next set.

" - }, "participants":{ "shape":"ParticipantList", "documentation":"

List of the matching participants (summary information only).

" + }, + "nextToken":{ + "shape":"PaginationToken", + "documentation":"

If there are more participants than maxResults, use nextToken in the request to get the next set.

" } } }, @@ -1461,17 +1490,17 @@ "type":"structure", "required":["stageArn"], "members":{ - "maxResults":{ - "shape":"MaxStageSessionResults", - "documentation":"

Maximum number of results to return. Default: 50.

" + "stageArn":{ + "shape":"StageArn", + "documentation":"

Stage ARN.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

The first stage session to retrieve. This is used for pagination; see the nextToken response field.

" }, - "stageArn":{ - "shape":"StageArn", - "documentation":"

Stage ARN.

" + "maxResults":{ + "shape":"MaxStageSessionResults", + "documentation":"

Maximum number of results to return. Default: 50.

" } } }, @@ -1479,26 +1508,26 @@ "type":"structure", "required":["stageSessions"], "members":{ - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

If there are more stage sessions than maxResults, use nextToken in the request to get the next set.

" - }, "stageSessions":{ "shape":"StageSessionList", "documentation":"

List of matching stage sessions.

" + }, + "nextToken":{ + "shape":"PaginationToken", + "documentation":"

If there are more stage sessions than maxResults, use nextToken in the request to get the next set.

" } } }, "ListStagesRequest":{ "type":"structure", "members":{ - "maxResults":{ - "shape":"MaxStageResults", - "documentation":"

Maximum number of results to return. Default: 50.

" - }, "nextToken":{ "shape":"PaginationToken", "documentation":"

The first stage to retrieve. This is used for pagination; see the nextToken response field.

" + }, + "maxResults":{ + "shape":"MaxStageResults", + "documentation":"

Maximum number of results to return. Default: 50.

" } } }, @@ -1506,26 +1535,26 @@ "type":"structure", "required":["stages"], "members":{ - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

If there are more stages than maxResults, use nextToken in the request to get the next set.

" - }, "stages":{ "shape":"StageSummaryList", "documentation":"

List of the matching stages (summary information only).

" + }, + "nextToken":{ + "shape":"PaginationToken", + "documentation":"

If there are more stages than maxResults, use nextToken in the request to get the next set.

" } } }, "ListStorageConfigurationsRequest":{ "type":"structure", "members":{ - "maxResults":{ - "shape":"MaxStorageConfigurationResults", - "documentation":"

Maximum number of storage configurations to return. Default: your service quota or 100, whichever is smaller.

" - }, "nextToken":{ "shape":"PaginationToken", "documentation":"

The first storage configuration to retrieve. This is used for pagination; see the nextToken response field.

" + }, + "maxResults":{ + "shape":"MaxStorageConfigurationResults", + "documentation":"

Maximum number of storage configurations to return. Default: your service quota or 100, whichever is smaller.

" } } }, @@ -1533,13 +1562,13 @@ "type":"structure", "required":["storageConfigurations"], "members":{ - "nextToken":{ - "shape":"PaginationToken", - "documentation":"

If there are more storage configurations than maxResults, use nextToken in the request to get the next set.

" - }, "storageConfigurations":{ "shape":"StorageConfigurationSummaryList", "documentation":"

List of the matching storage configurations.

" + }, + "nextToken":{ + "shape":"PaginationToken", + "documentation":"

If there are more storage configurations than maxResults, use nextToken in the request to get the next set.

" } } }, @@ -1612,27 +1641,35 @@ "type":"string", "max":1024, "min":0, - "pattern":"^[a-zA-Z0-9+/=_-]*$" + "pattern":"[a-zA-Z0-9+/=_-]*" }, "Participant":{ "type":"structure", "members":{ - "attributes":{ - "shape":"ParticipantAttributes", - "documentation":"

Application-provided attributes to encode into the token and attach to a stage. Map keys and values can contain UTF-8 encoded text. The maximum length of this field is 1 KB total. This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.

" + "participantId":{ + "shape":"ParticipantId", + "documentation":"

Unique identifier for this participant, assigned by IVS.

" }, - "browserName":{ - "shape":"ParticipantClientAttribute", - "documentation":"

The participant’s browser.

" + "userId":{ + "shape":"UserId", + "documentation":"

Customer-assigned name to help identify the token; this can be used to link a participant to a user in the customer’s own systems. This can be any UTF-8 encoded text. This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.

" }, - "browserVersion":{ - "shape":"ParticipantClientAttribute", - "documentation":"

The participant’s browser version.

" + "state":{ + "shape":"ParticipantState", + "documentation":"

Whether the participant is connected to or disconnected from the stage.

" }, "firstJoinTime":{ "shape":"Time", "documentation":"

ISO 8601 timestamp (returned as a string) when the participant first joined the stage session.

" }, + "attributes":{ + "shape":"ParticipantAttributes", + "documentation":"

Application-provided attributes to encode into the token and attach to a stage. Map keys and values can contain UTF-8 encoded text. The maximum length of this field is 1 KB total. This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.

" + }, + "published":{ + "shape":"Published", + "documentation":"

Whether the participant ever published to the stage session.

" + }, "ispName":{ "shape":"ParticipantClientAttribute", "documentation":"

The participant’s Internet Service Provider.

" @@ -1645,25 +1682,29 @@ "shape":"ParticipantClientAttribute", "documentation":"

The participant’s operating system version.

" }, - "participantId":{ - "shape":"ParticipantId", - "documentation":"

Unique identifier for this participant, assigned by IVS.

" + "browserName":{ + "shape":"ParticipantClientAttribute", + "documentation":"

The participant’s browser.

" }, - "published":{ - "shape":"Published", - "documentation":"

Whether the participant ever published to the stage session.

" + "browserVersion":{ + "shape":"ParticipantClientAttribute", + "documentation":"

The participant’s browser version.

" }, "sdkVersion":{ "shape":"ParticipantClientAttribute", "documentation":"

The participant’s SDK version.

" }, - "state":{ - "shape":"ParticipantState", - "documentation":"

Whether the participant is connected to or disconnected from the stage.

" + "recordingS3BucketName":{ + "shape":"ParticipantRecordingS3BucketName", + "documentation":"

Name of the S3 bucket to where the participant is being recorded, if individual participant recording is enabled, or \"\" (empty string), if recording is not enabled.

" }, - "userId":{ - "shape":"UserId", - "documentation":"

Customer-assigned name to help identify the token; this can be used to link a participant to a user in the customer’s own systems. This can be any UTF-8 encoded text. This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.

" + "recordingS3Prefix":{ + "shape":"ParticipantRecordingS3Prefix", + "documentation":"

S3 prefix of the S3 bucket to where the participant is being recorded, if individual participant recording is enabled, or \"\" (empty string), if recording is not enabled.

" + }, + "recordingState":{ + "shape":"ParticipantRecordingState", + "documentation":"

Participant’s recording state.

" } }, "documentation":"

Object describing a participant that has joined a stage.

" @@ -1677,18 +1718,64 @@ "type":"string", "max":128, "min":0, - "pattern":"^[a-zA-Z0-9-_.,:;\\s]*$" + "pattern":"[a-zA-Z0-9-_.,:;\\s]*" }, "ParticipantId":{ "type":"string", "max":64, "min":0, - "pattern":"^[a-zA-Z0-9-]*$" + "pattern":"[a-zA-Z0-9-]*" }, "ParticipantList":{ "type":"list", "member":{"shape":"ParticipantSummary"} }, + "ParticipantRecordingFilterByRecordingState":{ + "type":"string", + "enum":[ + "STARTING", + "ACTIVE", + "STOPPING", + "STOPPED", + "FAILED" + ] + }, + "ParticipantRecordingMediaType":{ + "type":"string", + "enum":[ + "AUDIO_VIDEO", + "AUDIO_ONLY" + ] + }, + "ParticipantRecordingMediaTypeList":{ + "type":"list", + "member":{"shape":"ParticipantRecordingMediaType"}, + "max":1, + "min":0 + }, + "ParticipantRecordingS3BucketName":{ + "type":"string", + "max":63, + "min":0, + "pattern":"[a-z0-9-.]*" + }, + "ParticipantRecordingS3Prefix":{ + "type":"string", + "max":256, + "min":0, + "pattern":"[a-zA-Z0-9-]*" + }, + "ParticipantRecordingState":{ + "type":"string", + "enum":[ + "STARTING", + "ACTIVE", + "STOPPING", + "STOPPED", + "FAILED", + "DISABLED" + ] + }, "ParticipantState":{ "type":"string", "enum":[ @@ -1699,25 +1786,29 @@ "ParticipantSummary":{ "type":"structure", "members":{ - "firstJoinTime":{ - "shape":"Time", - "documentation":"

ISO 8601 timestamp (returned as a string) when the participant first joined the stage session.

" - }, "participantId":{ "shape":"ParticipantId", "documentation":"

Unique identifier for this participant, assigned by IVS.

" }, - "published":{ - "shape":"Published", - "documentation":"

Whether the participant ever published to the stage session.

" + "userId":{ + "shape":"UserId", + "documentation":"

Customer-assigned name to help identify the token; this can be used to link a participant to a user in the customer’s own systems. This can be any UTF-8 encoded text. This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.

" }, "state":{ "shape":"ParticipantState", "documentation":"

Whether the participant is connected to or disconnected from the stage.

" }, - "userId":{ - "shape":"UserId", - "documentation":"

Customer-assigned name to help identify the token; this can be used to link a participant to a user in the customer’s own systems. This can be any UTF-8 encoded text. This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.

" + "firstJoinTime":{ + "shape":"Time", + "documentation":"

ISO 8601 timestamp (returned as a string) when the participant first joined the stage session.

" + }, + "published":{ + "shape":"Published", + "documentation":"

Whether the participant ever published to the stage session.

" + }, + "recordingState":{ + "shape":"ParticipantRecordingState", + "documentation":"

Participant’s recording state.

" } }, "documentation":"

Summary object describing a participant that has joined a stage.

" @@ -1725,22 +1816,6 @@ "ParticipantToken":{ "type":"structure", "members":{ - "attributes":{ - "shape":"ParticipantTokenAttributes", - "documentation":"

Application-provided attributes to encode into the token and attach to a stage. This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.

" - }, - "capabilities":{ - "shape":"ParticipantTokenCapabilities", - "documentation":"

Set of capabilities that the user is allowed to perform in the stage.

" - }, - "duration":{ - "shape":"ParticipantTokenDurationMinutes", - "documentation":"

Duration (in minutes), after which the participant token expires. Default: 720 (12 hours).

" - }, - "expirationTime":{ - "shape":"ParticipantTokenExpirationTime", - "documentation":"

ISO 8601 timestamp (returned as a string) for when this token expires.

" - }, "participantId":{ "shape":"ParticipantTokenId", "documentation":"

Unique identifier for this participant token, assigned by IVS.

" @@ -1752,6 +1827,22 @@ "userId":{ "shape":"ParticipantTokenUserId", "documentation":"

Customer-assigned name to help identify the token; this can be used to link a participant to a user in the customer’s own systems. This can be any UTF-8 encoded text. This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.

" + }, + "attributes":{ + "shape":"ParticipantTokenAttributes", + "documentation":"

Application-provided attributes to encode into the token and attach to a stage. This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.

" + }, + "duration":{ + "shape":"ParticipantTokenDurationMinutes", + "documentation":"

Duration (in minutes), after which the participant token expires. Default: 720 (12 hours).

" + }, + "capabilities":{ + "shape":"ParticipantTokenCapabilities", + "documentation":"

Set of capabilities that the user is allowed to perform in the stage.

" + }, + "expirationTime":{ + "shape":"ParticipantTokenExpirationTime", + "documentation":"

ISO 8601 timestamp (returned as a string) for when this token expires.

" } }, "documentation":"

Object specifying a participant token in a stage.

Important: Treat tokens as opaque; i.e., do not build functionality based on token contents. The format of tokens could change in the future.

" @@ -1777,14 +1868,6 @@ "ParticipantTokenConfiguration":{ "type":"structure", "members":{ - "attributes":{ - "shape":"ParticipantTokenAttributes", - "documentation":"

Application-provided attributes to encode into the corresponding participant token and attach to a stage. Map keys and values can contain UTF-8 encoded text. The maximum length of this field is 1 KB total. This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.

" - }, - "capabilities":{ - "shape":"ParticipantTokenCapabilities", - "documentation":"

Set of capabilities that the user is allowed to perform in the stage.

" - }, "duration":{ "shape":"ParticipantTokenDurationMinutes", "documentation":"

Duration (in minutes), after which the corresponding participant token expires. Default: 720 (12 hours).

" @@ -1792,6 +1875,14 @@ "userId":{ "shape":"ParticipantTokenUserId", "documentation":"

Customer-assigned name to help identify the token; this can be used to link a participant to a user in the customer’s own systems. This can be any UTF-8 encoded text. This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.

" + }, + "attributes":{ + "shape":"ParticipantTokenAttributes", + "documentation":"

Application-provided attributes to encode into the corresponding participant token and attach to a stage. Map keys and values can contain UTF-8 encoded text. The maximum length of this field is 1 KB total. This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.

" + }, + "capabilities":{ + "shape":"ParticipantTokenCapabilities", + "documentation":"

Set of capabilities that the user is allowed to perform in the stage.

" } }, "documentation":"

Object specifying a participant token configuration in a stage.

" @@ -1855,30 +1946,30 @@ "shape":"AttributeKey", "documentation":"

This attribute name identifies the featured slot. A participant with this attribute set to \"true\" (as a string value) in ParticipantTokenConfiguration is placed in the featured slot.

" }, + "omitStoppedVideo":{ + "shape":"OmitStoppedVideo", + "documentation":"

Determines whether to omit participants with stopped video in the composition. Default: false.

" + }, + "videoFillMode":{ + "shape":"VideoFillMode", + "documentation":"

Defines how video fits within the participant tile. Default: COVER.

" + }, "gridGap":{ "shape":"GridGap", "documentation":"

Specifies the spacing between participant tiles in pixels. Default: 0.

" }, - "omitStoppedVideo":{ - "shape":"OmitStoppedVideo", - "documentation":"

Determines whether to omit participants with stopped video in the composition. Default: false.

" + "pipParticipantAttribute":{ + "shape":"AttributeKey", + "documentation":"

Identifies the PiP slot. A participant with this attribute set to \"true\" (as a string value) in ParticipantTokenConfiguration is placed in the PiP slot.

" }, "pipBehavior":{ "shape":"PipBehavior", "documentation":"

Defines PiP behavior when all participants have left. Default: STATIC.

" }, - "pipHeight":{ - "shape":"PipHeight", - "documentation":"

Specifies the height of the PiP window in pixels. When this is not set explicitly, pipHeight’s value will be based on the size of the composition and the aspect ratio of the participant’s video.

" - }, "pipOffset":{ "shape":"PipOffset", "documentation":"

Sets the PiP window’s offset position in pixels from the closest edges determined by PipPosition. Default: 0.

" }, - "pipParticipantAttribute":{ - "shape":"AttributeKey", - "documentation":"

Identifies the PiP slot. A participant with this attribute set to \"true\" (as a string value) in ParticipantTokenConfiguration is placed in the PiP slot.

" - }, "pipPosition":{ "shape":"PipPosition", "documentation":"

Determines the corner position of the PiP window. Default: BOTTOM_RIGHT.

" @@ -1887,9 +1978,9 @@ "shape":"PipWidth", "documentation":"

Specifies the width of the PiP window in pixels. When this is not set explicitly, pipWidth’s value will be based on the size of the composition and the aspect ratio of the participant’s video.

" }, - "videoFillMode":{ - "shape":"VideoFillMode", - "documentation":"

Defines how video fits within the participant tile. Default: COVER.

" + "pipHeight":{ + "shape":"PipHeight", + "documentation":"

Specifies the height of the PiP window in pixels. When this is not set explicitly, pipHeight’s value will be based on the size of the composition and the aspect ratio of the participant’s video.

" } }, "documentation":"

Configuration information specific to Picture-in-Picture (PiP) layout, for server-side composition.

" @@ -1936,7 +2027,7 @@ "type":"string", "max":128, "min":1, - "pattern":"^arn:aws:ivs:[a-z0-9-]+:[0-9]+:[a-z-]/[a-zA-Z0-9-]+$" + "pattern":"arn:aws:ivs:[a-z0-9-]+:[0-9]+:[a-z-]/[a-zA-Z0-9-]+" }, "ResourceNotFoundException":{ "type":"structure", @@ -1957,15 +2048,19 @@ "type":"string", "max":63, "min":3, - "pattern":"^[a-z0-9-.]+$" + "pattern":"[a-z0-9-.]+" }, "S3DestinationConfiguration":{ "type":"structure", "required":[ - "encoderConfigurationArns", - "storageConfigurationArn" + "storageConfigurationArn", + "encoderConfigurationArns" ], "members":{ + "storageConfigurationArn":{ + "shape":"StorageConfigurationArn", + "documentation":"

ARN of the StorageConfiguration where recorded videos will be stored.

" + }, "encoderConfigurationArns":{ "shape":"EncoderConfigurationArnList", "documentation":"

ARNs of the EncoderConfiguration resource. The encoder configuration and stage resources must be in the same AWS account and region.

" @@ -1973,10 +2068,6 @@ "recordingConfiguration":{ "shape":"RecordingConfiguration", "documentation":"

Array of maps, each of the form string:string (key:value). This is an optional customer specification, currently used only to specify the recording format for storing a recording in Amazon S3.

" - }, - "storageConfigurationArn":{ - "shape":"StorageConfigurationArn", - "documentation":"

ARN of the StorageConfiguration where recorded videos will be stored.

" } }, "documentation":"

A complex type that describes an S3 location where recorded videos will be stored.

" @@ -2022,10 +2113,6 @@ "type":"structure", "required":["arn"], "members":{ - "activeSessionId":{ - "shape":"StageSessionId", - "documentation":"

ID of the active session within the stage.

" - }, "arn":{ "shape":"StageArn", "documentation":"

Stage ARN.

" @@ -2034,9 +2121,17 @@ "shape":"StageName", "documentation":"

Stage name.

" }, + "activeSessionId":{ + "shape":"StageSessionId", + "documentation":"

ID of the active session within the stage.

" + }, "tags":{ "shape":"Tags", "documentation":"

Tags attached to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.

" + }, + "autoParticipantRecordingConfiguration":{ + "shape":"AutoParticipantRecordingConfiguration", + "documentation":"

Auto-participant-recording configuration object attached to the stage.

" } }, "documentation":"

Object specifying a stage.

" @@ -2045,21 +2140,17 @@ "type":"string", "max":128, "min":1, - "pattern":"^arn:aws:ivs:[a-z0-9-]+:[0-9]+:stage/[a-zA-Z0-9-]+$" + "pattern":"arn:aws:ivs:[a-z0-9-]+:[0-9]+:stage/[a-zA-Z0-9-]+" }, "StageName":{ "type":"string", "max":128, "min":0, - "pattern":"^[a-zA-Z0-9-_]*$" + "pattern":"[a-zA-Z0-9-_]*" }, "StageSession":{ "type":"structure", "members":{ - "endTime":{ - "shape":"Time", - "documentation":"

ISO 8601 timestamp (returned as a string) when the stage session ended. This is null if the stage is active.

" - }, "sessionId":{ "shape":"StageSessionId", "documentation":"

ID of the session within the stage.

" @@ -2067,6 +2158,10 @@ "startTime":{ "shape":"Time", "documentation":"

ISO 8601 timestamp (returned as a string) when this stage session began.

" + }, + "endTime":{ + "shape":"Time", + "documentation":"

ISO 8601 timestamp (returned as a string) when the stage session ended. This is null if the stage is active.

" } }, "documentation":"

A stage session begins when the first participant joins a stage and ends after the last participant leaves the stage. A stage session helps with debugging stages by grouping events and participants into shorter periods of time (i.e., a session), which is helpful when stages are used over long periods of time.

" @@ -2075,7 +2170,7 @@ "type":"string", "max":16, "min":16, - "pattern":"^st-[a-zA-Z0-9]+$" + "pattern":"st-[a-zA-Z0-9]+" }, "StageSessionList":{ "type":"list", @@ -2084,10 +2179,6 @@ "StageSessionSummary":{ "type":"structure", "members":{ - "endTime":{ - "shape":"Time", - "documentation":"

ISO 8601 timestamp (returned as a string) when the stage session ended. This is null if the stage is active.

" - }, "sessionId":{ "shape":"StageSessionId", "documentation":"

ID of the session within the stage.

" @@ -2095,6 +2186,10 @@ "startTime":{ "shape":"Time", "documentation":"

ISO 8601 timestamp (returned as a string) when this stage session began.

" + }, + "endTime":{ + "shape":"Time", + "documentation":"

ISO 8601 timestamp (returned as a string) when the stage session ended. This is null if the stage is active.

" } }, "documentation":"

Summary information about a stage session.

" @@ -2103,10 +2198,6 @@ "type":"structure", "required":["arn"], "members":{ - "activeSessionId":{ - "shape":"StageSessionId", - "documentation":"

ID of the active session within the stage.

" - }, "arn":{ "shape":"StageArn", "documentation":"

Stage ARN.

" @@ -2115,6 +2206,10 @@ "shape":"StageName", "documentation":"

Stage name.

" }, + "activeSessionId":{ + "shape":"StageSessionId", + "documentation":"

ID of the active session within the stage.

" + }, "tags":{ "shape":"Tags", "documentation":"

Tags attached to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.

" @@ -2129,13 +2224,13 @@ "StartCompositionRequest":{ "type":"structure", "required":[ - "destinations", - "stageArn" + "stageArn", + "destinations" ], "members":{ - "destinations":{ - "shape":"DestinationConfigurationList", - "documentation":"

Array of destination configuration.

" + "stageArn":{ + "shape":"StageArn", + "documentation":"

ARN of the stage to be used for compositing.

" }, "idempotencyToken":{ "shape":"CompositionClientToken", @@ -2146,9 +2241,9 @@ "shape":"LayoutConfiguration", "documentation":"

Layout object to configure composition parameters.

" }, - "stageArn":{ - "shape":"StageArn", - "documentation":"

ARN of the stage to be used for compositing.

" + "destinations":{ + "shape":"DestinationConfigurationList", + "documentation":"

Array of destination configuration.

" }, "tags":{ "shape":"Tags", @@ -2207,13 +2302,13 @@ "type":"string", "max":128, "min":1, - "pattern":"^arn:aws:ivs:[a-z0-9-]+:[0-9]+:storage-configuration/[a-zA-Z0-9-]+$" + "pattern":"arn:aws:ivs:[a-z0-9-]+:[0-9]+:storage-configuration/[a-zA-Z0-9-]+" }, "StorageConfigurationName":{ "type":"string", "max":128, "min":0, - "pattern":"^[a-zA-Z0-9-_]*$" + "pattern":"[a-zA-Z0-9-_]*" }, "StorageConfigurationSummary":{ "type":"structure", @@ -2331,6 +2426,10 @@ "name":{ "shape":"StageName", "documentation":"

Name of the stage to be updated.

" + }, + "autoParticipantRecordingConfiguration":{ + "shape":"AutoParticipantRecordingConfiguration", + "documentation":"

Auto-participant-recording configuration object to attach to the stage. Auto-participant-recording configuration cannot be updated while recording is active.

" } } }, @@ -2366,21 +2465,21 @@ "Video":{ "type":"structure", "members":{ - "bitrate":{ - "shape":"Bitrate", - "documentation":"

Bitrate for generated output, in bps. Default: 2500000.

" - }, - "framerate":{ - "shape":"Framerate", - "documentation":"

Video frame rate, in fps. Default: 30.

" + "width":{ + "shape":"Width", + "documentation":"

Video-resolution width. Note that the maximum value is determined by width times height, such that the maximum total pixels is 2073600 (1920x1080 or 1080x1920). Default: 1280.

" }, "height":{ "shape":"Height", "documentation":"

Video-resolution height. Note that the maximum value is determined by width times height, such that the maximum total pixels is 2073600 (1920x1080 or 1080x1920). Default: 720.

" }, - "width":{ - "shape":"Width", - "documentation":"

Video-resolution width. Note that the maximum value is determined by width times height, such that the maximum total pixels is 2073600 (1920x1080 or 1080x1920). Default: 1280.

" + "framerate":{ + "shape":"Framerate", + "documentation":"

Video frame rate, in fps. Default: 30.

" + }, + "bitrate":{ + "shape":"Bitrate", + "documentation":"

Bitrate for generated output, in bps. Default: 2500000.

" } }, "documentation":"

Settings for video.

" diff --git a/botocore/data/ivs-realtime/2020-07-14/waiters-2.json b/botocore/data/ivs-realtime/2020-07-14/waiters-2.json new file mode 100644 index 0000000000..13f60ee66b --- /dev/null +++ b/botocore/data/ivs-realtime/2020-07-14/waiters-2.json @@ -0,0 +1,5 @@ +{ + "version": 2, + "waiters": { + } +} diff --git a/botocore/data/sagemaker/2017-07-24/service-2.json b/botocore/data/sagemaker/2017-07-24/service-2.json index 5127433ebc..a6fff66f94 100644 --- a/botocore/data/sagemaker/2017-07-24/service-2.json +++ b/botocore/data/sagemaker/2017-07-24/service-2.json @@ -363,7 +363,22 @@ {"shape":"ResourceInUse"}, {"shape":"ResourceLimitExceeded"} ], - "documentation":"

Create a hub.

Hub APIs are only callable through SageMaker Studio.

" + "documentation":"

Create a hub.

" + }, + "CreateHubContentReference":{ + "name":"CreateHubContentReference", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"CreateHubContentReferenceRequest"}, + "output":{"shape":"CreateHubContentReferenceResponse"}, + "errors":[ + {"shape":"ResourceNotFound"}, + {"shape":"ResourceInUse"}, + {"shape":"ResourceLimitExceeded"} + ], + "documentation":"

Create a hub content reference in order to add a model in the JumpStart public hub to a private hub.

" }, "CreateHumanTaskUi":{ "name":"CreateHumanTaskUi", @@ -1095,7 +1110,7 @@ {"shape":"ResourceInUse"}, {"shape":"ResourceNotFound"} ], - "documentation":"

Delete a hub.

Hub APIs are only callable through SageMaker Studio.

" + "documentation":"

Delete a hub.

" }, "DeleteHubContent":{ "name":"DeleteHubContent", @@ -1108,7 +1123,19 @@ {"shape":"ResourceInUse"}, {"shape":"ResourceNotFound"} ], - "documentation":"

Delete the contents of a hub.

Hub APIs are only callable through SageMaker Studio.

" + "documentation":"

Delete the contents of a hub.

" + }, + "DeleteHubContentReference":{ + "name":"DeleteHubContentReference", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeleteHubContentReferenceRequest"}, + "errors":[ + {"shape":"ResourceNotFound"} + ], + "documentation":"

Delete a hub content reference in order to remove a model from a private hub.

" }, "DeleteHumanTaskUi":{ "name":"DeleteHumanTaskUi", @@ -1761,7 +1788,7 @@ "errors":[ {"shape":"ResourceNotFound"} ], - "documentation":"

Describe a hub.

Hub APIs are only callable through SageMaker Studio.

" + "documentation":"

Describes a hub.

" }, "DescribeHubContent":{ "name":"DescribeHubContent", @@ -1774,7 +1801,7 @@ "errors":[ {"shape":"ResourceNotFound"} ], - "documentation":"

Describe the content of a hub.

Hub APIs are only callable through SageMaker Studio.

" + "documentation":"

Describe the content of a hub.

" }, "DescribeHumanTaskUi":{ "name":"DescribeHumanTaskUi", @@ -2327,7 +2354,7 @@ {"shape":"ResourceLimitExceeded"}, {"shape":"ResourceNotFound"} ], - "documentation":"

Import hub content.

Hub APIs are only callable through SageMaker Studio.

" + "documentation":"

Import hub content.

" }, "ListActions":{ "name":"ListActions", @@ -2611,7 +2638,7 @@ "errors":[ {"shape":"ResourceNotFound"} ], - "documentation":"

List hub content versions.

Hub APIs are only callable through SageMaker Studio.

" + "documentation":"

List hub content versions.

" }, "ListHubContents":{ "name":"ListHubContents", @@ -2624,7 +2651,7 @@ "errors":[ {"shape":"ResourceNotFound"} ], - "documentation":"

List the contents of a hub.

Hub APIs are only callable through SageMaker Studio.

" + "documentation":"

List the contents of a hub.

" }, "ListHubs":{ "name":"ListHubs", @@ -2634,7 +2661,7 @@ }, "input":{"shape":"ListHubsRequest"}, "output":{"shape":"ListHubsResponse"}, - "documentation":"

List all existing hubs.

Hub APIs are only callable through SageMaker Studio.

" + "documentation":"

List all existing hubs.

" }, "ListHumanTaskUis":{ "name":"ListHumanTaskUis", @@ -3724,7 +3751,7 @@ "errors":[ {"shape":"ResourceNotFound"} ], - "documentation":"

Update a hub.

Hub APIs are only callable through SageMaker Studio.

" + "documentation":"

Update a hub.

" }, "UpdateImage":{ "name":"UpdateImage", @@ -9072,6 +9099,52 @@ } } }, + "CreateHubContentReferenceRequest":{ + "type":"structure", + "required":[ + "HubName", + "SageMakerPublicHubContentArn" + ], + "members":{ + "HubName":{ + "shape":"HubNameOrArn", + "documentation":"

The name of the hub to add the hub content reference to.

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

The ARN of the public hub content to reference.

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

The name of the hub content to reference.

" + }, + "MinVersion":{ + "shape":"HubContentVersion", + "documentation":"

The minimum version of the hub content to reference.

" + }, + "Tags":{ + "shape":"TagList", + "documentation":"

Any tags associated with the hub content to reference.

" + } + } + }, + "CreateHubContentReferenceResponse":{ + "type":"structure", + "required":[ + "HubArn", + "HubContentArn" + ], + "members":{ + "HubArn":{ + "shape":"HubArn", + "documentation":"

The ARN of the hub that the hub content reference was added to.

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

The ARN of the hub content.

" + } + } + }, "CreateHubRequest":{ "type":"structure", "required":[ @@ -11707,6 +11780,28 @@ "members":{ } }, + "DeleteHubContentReferenceRequest":{ + "type":"structure", + "required":[ + "HubName", + "HubContentType", + "HubContentName" + ], + "members":{ + "HubName":{ + "shape":"HubNameOrArn", + "documentation":"

The name of the hub to delete the hub content reference from.

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

The type of hub content to delete.

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

The name of the hub content to delete.

" + } + } + }, "DeleteHubContentRequest":{ "type":"structure", "required":[ @@ -11717,7 +11812,7 @@ ], "members":{ "HubName":{ - "shape":"HubName", + "shape":"HubNameOrArn", "documentation":"

The name of the hub that you want to delete content in.

" }, "HubContentType":{ @@ -11739,7 +11834,7 @@ "required":["HubName"], "members":{ "HubName":{ - "shape":"HubName", + "shape":"HubNameOrArn", "documentation":"

The name of the hub to delete.

" } } @@ -13952,7 +14047,7 @@ ], "members":{ "HubName":{ - "shape":"HubName", + "shape":"HubNameOrArn", "documentation":"

The name of the hub that contains the content to describe.

" }, "HubContentType":{ @@ -14028,6 +14123,18 @@ "shape":"HubContentDocument", "documentation":"

The hub content document that describes information about the hub content such as type, associated containers, scripts, and more.

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

The ARN of the public hub content.

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

The minimum version of the hub content.

" + }, + "SupportStatus":{ + "shape":"HubContentSupportStatus", + "documentation":"

The support status of the hub content.

" + }, "HubContentSearchKeywords":{ "shape":"HubContentSearchKeywordList", "documentation":"

The searchable keywords for the hub content.

" @@ -14055,7 +14162,7 @@ "required":["HubName"], "members":{ "HubName":{ - "shape":"HubName", + "shape":"HubNameOrArn", "documentation":"

The name of the hub to describe.

" } } @@ -19285,6 +19392,10 @@ "shape":"HubContentArn", "documentation":"

The Amazon Resource Name (ARN) of the hub content.

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

The ARN of the public hub content.

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

The version of the hub content.

" @@ -19305,6 +19416,10 @@ "shape":"HubContentDescription", "documentation":"

A description of the hub content.

" }, + "SupportStatus":{ + "shape":"HubContentSupportStatus", + "documentation":"

The support status of the hub content.

" + }, "HubContentSearchKeywords":{ "shape":"HubContentSearchKeywordList", "documentation":"

The searchable keywords for the hub content.

" @@ -19316,6 +19431,10 @@ "CreationTime":{ "shape":"Timestamp", "documentation":"

The date and time that the hub content was created.

" + }, + "OriginalCreationTime":{ + "shape":"Timestamp", + "documentation":"

The date and time when the hub content was originally created, before any updates or revisions.

" } }, "documentation":"

Information about hub content.

" @@ -19326,8 +19445,7 @@ }, "HubContentMarkdown":{ "type":"string", - "max":65535, - "pattern":".*" + "max":65535 }, "HubContentName":{ "type":"string", @@ -19357,11 +19475,19 @@ "DeleteFailed" ] }, + "HubContentSupportStatus":{ + "type":"string", + "enum":[ + "Supported", + "Deprecated" + ] + }, "HubContentType":{ "type":"string", "enum":[ "Model", - "Notebook" + "Notebook", + "ModelReference" ] }, "HubContentVersion":{ @@ -19434,6 +19560,10 @@ "max":63, "pattern":"^[a-zA-Z0-9](-*[a-zA-Z0-9]){0,62}" }, + "HubNameOrArn":{ + "type":"string", + "pattern":"^(arn:[a-z0-9-\\.]{1,63}:sagemaker:\\w+(?:-\\w+)+:(\\d{12}|aws):hub\\/)?[a-zA-Z0-9](-*[a-zA-Z0-9]){0,62}$" + }, "HubS3StorageConfig":{ "type":"structure", "members":{ @@ -20637,7 +20767,7 @@ "documentation":"

The version of the hub content schema to import.

" }, "HubName":{ - "shape":"HubName", + "shape":"HubNameOrArn", "documentation":"

The name of the hub to import content into.

" }, "HubContentDisplayName":{ @@ -21061,6 +21191,17 @@ "type":"string", "enum":["ShadowMode"] }, + "InferenceHubAccessConfig":{ + "type":"structure", + "required":["HubContentArn"], + "members":{ + "HubContentArn":{ + "shape":"HubContentArn", + "documentation":"

The ARN of the hub content for which deployment access is allowed.

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

Configuration information specifying which hub contents have accessible deployment options.

" + }, "InferenceImage":{ "type":"string", "max":256 @@ -21086,7 +21227,6 @@ "InferenceRecommendation":{ "type":"structure", "required":[ - "Metrics", "EndpointConfiguration", "ModelConfiguration" ], @@ -23552,7 +23692,7 @@ ], "members":{ "HubName":{ - "shape":"HubName", + "shape":"HubNameOrArn", "documentation":"

The name of the hub to list the content versions of.

" }, "HubContentType":{ @@ -23619,7 +23759,7 @@ ], "members":{ "HubName":{ - "shape":"HubName", + "shape":"HubNameOrArn", "documentation":"

The name of the hub to list the contents of.

" }, "HubContentType":{ @@ -32170,12 +32310,6 @@ }, "RecommendationMetrics":{ "type":"structure", - "required":[ - "CostPerHour", - "CostPerInference", - "MaxInvocations", - "ModelLatency" - ], "members":{ "CostPerHour":{ "shape":"Float", @@ -32308,6 +32442,12 @@ "min":1, "pattern":".*" }, + "ReferenceMinVersion":{ + "type":"string", + "max":14, + "min":5, + "pattern":"^\\d{1,4}.\\d{1,4}.\\d{1,4}$" + }, "RegisterDevicesRequest":{ "type":"structure", "required":[ @@ -32902,6 +33042,10 @@ "ModelAccessConfig":{ "shape":"ModelAccessConfig", "documentation":"

Specifies the access configuration file for the ML model. You can explicitly accept the model end-user license agreement (EULA) within the ModelAccessConfig. You are responsible for reviewing and complying with any applicable license terms and making sure they are acceptable for your use case before downloading or using a model.

" + }, + "HubAccessConfig":{ + "shape":"InferenceHubAccessConfig", + "documentation":"

Configuration information for hub access.

" } }, "documentation":"

Specifies the S3 location of ML model data to deploy.

" @@ -32967,6 +33111,11 @@ "type":"list", "member":{"shape":"SageMakerImageVersionAlias"} }, + "SageMakerPublicHubContentArn":{ + "type":"string", + "max":255, + "pattern":"^arn:[a-z0-9-\\.]{1,63}:sagemaker:\\w+(?:-\\w+)+:aws:hub-content\\/[a-zA-Z0-9](-*[a-zA-Z0-9]){0,62}\\/Model\\/[a-zA-Z0-9](-*[a-zA-Z0-9]){0,63}$" + }, "SagemakerServicecatalogStatus":{ "type":"string", "enum":[ @@ -37129,7 +37278,7 @@ "required":["HubName"], "members":{ "HubName":{ - "shape":"HubName", + "shape":"HubNameOrArn", "documentation":"

The name of the hub to update.

" }, "HubDescription":{ diff --git a/botocore/data/securityhub/2018-10-26/service-2.json b/botocore/data/securityhub/2018-10-26/service-2.json index 03b8548f07..8781e7fbed 100644 --- a/botocore/data/securityhub/2018-10-26/service-2.json +++ b/botocore/data/securityhub/2018-10-26/service-2.json @@ -10,7 +10,8 @@ "serviceId":"SecurityHub", "signatureVersion":"v4", "signingName":"securityhub", - "uid":"securityhub-2018-10-26" + "uid":"securityhub-2018-10-26", + "auth":["aws.auth#sigv4"] }, "operations":{ "AcceptAdministratorInvitation":{ @@ -17121,7 +17122,7 @@ "documentation":"

One or more finding types in the format of namespace/category/classifier that classify a finding.

Valid namespace values are: Software and Configuration Checks | TTPs | Effects | Unusual Behaviors | Sensitive Data Identifications

" } }, - "documentation":"

In a BatchImportFindings request, finding providers use FindingProviderFields to provide and update values for confidence, criticality, related findings, severity, and types.

" + "documentation":"

In a BatchImportFindings request, finding providers use FindingProviderFields to provide and update values for the following fields:

The preceding fields are nested under the FindingProviderFields object, but also have analogues of the same name as top-level ASFF fields. When a new finding is sent to Security Hub by a finding provider, Security Hub populates the FindingProviderFields object automatically, if it is empty, based on the corresponding top-level fields.

Finding providers can update FindingProviderFields only by using the BatchImportFindings operation. Finding providers can't update this object with the BatchUpdateFindings operation. Customers can update the top-level fields by using the BatchUpdateFindings operation. Customers can't update FindingProviderFields.

For information about how Security Hub handles updates from BatchImportFindings to FindingProviderFields and to the corresponding top-level attributes, see Using FindingProviderFields in the Security Hub User Guide.

" }, "FindingProviderSeverity":{ "type":"structure", @@ -17135,7 +17136,7 @@ "documentation":"

The finding provider's original value for the severity.

Length Constraints: Minimum length of 1. Maximum length of 64.

" } }, - "documentation":"

The severity assigned to the finding by the finding provider.

" + "documentation":"

The severity assigned to a finding by the finding provider. This object may include one or more of the following attributes:

If a BatchImportFindings request for a new finding only provides Label or only provides Normalized, Security Hub automatically populates the value of the other field.

The Normalized and Product attributes are included in the FindingProviderSeverity structure to preserve the historical information associated with the finding, even if the top-level Severity object is later modified using the BatchUpdateFindings operation.

If the top-level Finding.Severity object is present, but Finding.FindingProviderFields isn't present, Security Hub creates the FindingProviderFields.Severity object and copies the entire Finding.Severity object into it. This ensures that the original, provider-supplied details are retained within the FindingProviderFields.Severity object, even if the top-level Severity object is overwritten.

" }, "FirewallPolicyDetails":{ "type":"structure", From 57ddd00340d587ca706969689cb8a9671de59c76 Mon Sep 17 00:00:00 2001 From: aws-sdk-python-automation Date: Thu, 20 Jun 2024 18:09:29 +0000 Subject: [PATCH 2/3] Update endpoints model --- botocore/data/endpoints.json | 2 ++ 1 file changed, 2 insertions(+) diff --git a/botocore/data/endpoints.json b/botocore/data/endpoints.json index ee333c2c88..ccdbbfc356 100644 --- a/botocore/data/endpoints.json +++ b/botocore/data/endpoints.json @@ -547,10 +547,12 @@ "ap-south-1" : { }, "ap-southeast-1" : { }, "ap-southeast-2" : { }, + "ca-central-1" : { }, "eu-central-1" : { }, "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "sa-east-1" : { }, "us-east-1" : { }, "us-east-2" : { }, "us-west-2" : { } From ffdb2929871f0fb276bddea52d6838052fb13874 Mon Sep 17 00:00:00 2001 From: aws-sdk-python-automation Date: Thu, 20 Jun 2024 18:10:21 +0000 Subject: [PATCH 3/3] Bumping version to 1.34.131 --- .changes/1.34.131.json | 47 +++++++++++++++++++ .../api-change-bedrockruntime-87779.json | 5 -- .../api-change-codeartifact-37143.json | 5 -- .../api-change-computeoptimizer-26348.json | 5 -- .../api-change-costoptimizationhub-37.json | 5 -- .../next-release/api-change-dynamodb-925.json | 5 -- .../next-release/api-change-glue-63425.json | 5 -- .../api-change-ivsrealtime-98511.json | 5 -- .../api-change-sagemaker-52623.json | 5 -- .../api-change-securityhub-2982.json | 5 -- CHANGELOG.rst | 14 ++++++ botocore/__init__.py | 2 +- docs/source/conf.py | 2 +- 13 files changed, 63 insertions(+), 47 deletions(-) create mode 100644 .changes/1.34.131.json delete mode 100644 .changes/next-release/api-change-bedrockruntime-87779.json delete mode 100644 .changes/next-release/api-change-codeartifact-37143.json delete mode 100644 .changes/next-release/api-change-computeoptimizer-26348.json delete mode 100644 .changes/next-release/api-change-costoptimizationhub-37.json delete mode 100644 .changes/next-release/api-change-dynamodb-925.json delete mode 100644 .changes/next-release/api-change-glue-63425.json delete mode 100644 .changes/next-release/api-change-ivsrealtime-98511.json delete mode 100644 .changes/next-release/api-change-sagemaker-52623.json delete mode 100644 .changes/next-release/api-change-securityhub-2982.json diff --git a/.changes/1.34.131.json b/.changes/1.34.131.json new file mode 100644 index 0000000000..bb7c0df1ae --- /dev/null +++ b/.changes/1.34.131.json @@ -0,0 +1,47 @@ +[ + { + "category": "``bedrock-runtime``", + "description": "This release adds document support to Converse and ConverseStream APIs", + "type": "api-change" + }, + { + "category": "``codeartifact``", + "description": "Add support for the Cargo package format.", + "type": "api-change" + }, + { + "category": "``compute-optimizer``", + "description": "This release enables AWS Compute Optimizer to analyze and generate optimization recommendations for Amazon RDS MySQL and RDS PostgreSQL.", + "type": "api-change" + }, + { + "category": "``cost-optimization-hub``", + "description": "This release enables AWS Cost Optimization Hub to show cost optimization recommendations for Amazon RDS MySQL and RDS PostgreSQL.", + "type": "api-change" + }, + { + "category": "``dynamodb``", + "description": "Doc-only update for DynamoDB. Fixed Important note in 6 Global table APIs - CreateGlobalTable, DescribeGlobalTable, DescribeGlobalTableSettings, ListGlobalTables, UpdateGlobalTable, and UpdateGlobalTableSettings.", + "type": "api-change" + }, + { + "category": "``glue``", + "description": "Fix Glue paginators for Jobs, JobRuns, Triggers, Blueprints and Workflows.", + "type": "api-change" + }, + { + "category": "``ivs-realtime``", + "description": "IVS Real-Time now offers customers the ability to record individual stage participants to S3.", + "type": "api-change" + }, + { + "category": "``sagemaker``", + "description": "Adds support for model references in Hub service, and adds support for cross-account access of Hubs", + "type": "api-change" + }, + { + "category": "``securityhub``", + "description": "Documentation updates for Security Hub", + "type": "api-change" + } +] \ No newline at end of file diff --git a/.changes/next-release/api-change-bedrockruntime-87779.json b/.changes/next-release/api-change-bedrockruntime-87779.json deleted file mode 100644 index ba45d7c8f3..0000000000 --- a/.changes/next-release/api-change-bedrockruntime-87779.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``bedrock-runtime``", - "description": "This release adds document support to Converse and ConverseStream APIs" -} diff --git a/.changes/next-release/api-change-codeartifact-37143.json b/.changes/next-release/api-change-codeartifact-37143.json deleted file mode 100644 index 1116f603b6..0000000000 --- a/.changes/next-release/api-change-codeartifact-37143.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``codeartifact``", - "description": "Add support for the Cargo package format." -} diff --git a/.changes/next-release/api-change-computeoptimizer-26348.json b/.changes/next-release/api-change-computeoptimizer-26348.json deleted file mode 100644 index 3d917c2941..0000000000 --- a/.changes/next-release/api-change-computeoptimizer-26348.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``compute-optimizer``", - "description": "This release enables AWS Compute Optimizer to analyze and generate optimization recommendations for Amazon RDS MySQL and RDS PostgreSQL." -} diff --git a/.changes/next-release/api-change-costoptimizationhub-37.json b/.changes/next-release/api-change-costoptimizationhub-37.json deleted file mode 100644 index 6ba04f5454..0000000000 --- a/.changes/next-release/api-change-costoptimizationhub-37.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``cost-optimization-hub``", - "description": "This release enables AWS Cost Optimization Hub to show cost optimization recommendations for Amazon RDS MySQL and RDS PostgreSQL." -} diff --git a/.changes/next-release/api-change-dynamodb-925.json b/.changes/next-release/api-change-dynamodb-925.json deleted file mode 100644 index 60a52f69bc..0000000000 --- a/.changes/next-release/api-change-dynamodb-925.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``dynamodb``", - "description": "Doc-only update for DynamoDB. Fixed Important note in 6 Global table APIs - CreateGlobalTable, DescribeGlobalTable, DescribeGlobalTableSettings, ListGlobalTables, UpdateGlobalTable, and UpdateGlobalTableSettings." -} diff --git a/.changes/next-release/api-change-glue-63425.json b/.changes/next-release/api-change-glue-63425.json deleted file mode 100644 index ad0fc85c01..0000000000 --- a/.changes/next-release/api-change-glue-63425.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``glue``", - "description": "Fix Glue paginators for Jobs, JobRuns, Triggers, Blueprints and Workflows." -} diff --git a/.changes/next-release/api-change-ivsrealtime-98511.json b/.changes/next-release/api-change-ivsrealtime-98511.json deleted file mode 100644 index 409bc56d63..0000000000 --- a/.changes/next-release/api-change-ivsrealtime-98511.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``ivs-realtime``", - "description": "IVS Real-Time now offers customers the ability to record individual stage participants to S3." -} diff --git a/.changes/next-release/api-change-sagemaker-52623.json b/.changes/next-release/api-change-sagemaker-52623.json deleted file mode 100644 index 0b3bfe0cce..0000000000 --- a/.changes/next-release/api-change-sagemaker-52623.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``sagemaker``", - "description": "Adds support for model references in Hub service, and adds support for cross-account access of Hubs" -} diff --git a/.changes/next-release/api-change-securityhub-2982.json b/.changes/next-release/api-change-securityhub-2982.json deleted file mode 100644 index 24ff2c5ba5..0000000000 --- a/.changes/next-release/api-change-securityhub-2982.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``securityhub``", - "description": "Documentation updates for Security Hub" -} diff --git a/CHANGELOG.rst b/CHANGELOG.rst index cb252668e6..384a93b636 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -2,6 +2,20 @@ CHANGELOG ========= +1.34.131 +======== + +* api-change:``bedrock-runtime``: This release adds document support to Converse and ConverseStream APIs +* api-change:``codeartifact``: Add support for the Cargo package format. +* api-change:``compute-optimizer``: This release enables AWS Compute Optimizer to analyze and generate optimization recommendations for Amazon RDS MySQL and RDS PostgreSQL. +* api-change:``cost-optimization-hub``: This release enables AWS Cost Optimization Hub to show cost optimization recommendations for Amazon RDS MySQL and RDS PostgreSQL. +* api-change:``dynamodb``: Doc-only update for DynamoDB. Fixed Important note in 6 Global table APIs - CreateGlobalTable, DescribeGlobalTable, DescribeGlobalTableSettings, ListGlobalTables, UpdateGlobalTable, and UpdateGlobalTableSettings. +* api-change:``glue``: Fix Glue paginators for Jobs, JobRuns, Triggers, Blueprints and Workflows. +* api-change:``ivs-realtime``: IVS Real-Time now offers customers the ability to record individual stage participants to S3. +* api-change:``sagemaker``: Adds support for model references in Hub service, and adds support for cross-account access of Hubs +* api-change:``securityhub``: Documentation updates for Security Hub + + 1.34.130 ======== diff --git a/botocore/__init__.py b/botocore/__init__.py index d1cc761e96..e52b3b3278 100644 --- a/botocore/__init__.py +++ b/botocore/__init__.py @@ -16,7 +16,7 @@ import os import re -__version__ = '1.34.130' +__version__ = '1.34.131' class NullHandler(logging.Handler): diff --git a/docs/source/conf.py b/docs/source/conf.py index 546ae9c085..e88246ae0b 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -59,7 +59,7 @@ # The short X.Y version. version = '1.34.1' # The full version, including alpha/beta/rc tags. -release = '1.34.130' +release = '1.34.131' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages.