diff --git a/.changes/1.35.66.json b/.changes/1.35.66.json new file mode 100644 index 0000000000..855bee29fc --- /dev/null +++ b/.changes/1.35.66.json @@ -0,0 +1,102 @@ +[ + { + "category": "``autoscaling``", + "description": "With this release, customers can prioritize launching instances into ODCRs using targets from ASGs or Launch Templates. Customers can express their baseline instances' CPU-performance in attribute-based Instance Requirements configuration by referencing an instance family that meets their needs.", + "type": "api-change" + }, + { + "category": "``bedrock-agent-runtime``", + "description": "Releasing new Prompt Optimization to enhance your prompts for improved performance", + "type": "api-change" + }, + { + "category": "``cloudfront``", + "description": "Add support for gRPC, VPC origins, and Anycast IP Lists. Allow LoggingConfig IncludeCookies to be set regardless of whether the LoggingConfig is enabled.", + "type": "api-change" + }, + { + "category": "``compute-optimizer``", + "description": "This release enables AWS Compute Optimizer to analyze and generate optimization recommendations for Amazon Aurora database instances. It also enables Compute Optimizer to identify idle Amazon EC2 instances, Amazon EBS volumes, Amazon ECS services running on Fargate, and Amazon RDS databases.", + "type": "api-change" + }, + { + "category": "``controltower``", + "description": "Adds support for child enabled baselines which allow you to see the enabled baseline status for individual accounts.", + "type": "api-change" + }, + { + "category": "``cost-optimization-hub``", + "description": "This release adds action type \"Delete\" to the GetRecommendation, ListRecommendations and ListRecommendationSummaries APIs to support new EBS and ECS recommendations with action type \"Delete\".", + "type": "api-change" + }, + { + "category": "``datazone``", + "description": "This release supports Metadata Enforcement Rule feature for Create Subscription Request action.", + "type": "api-change" + }, + { + "category": "``discovery``", + "description": "Add support to import data from commercially available discovery tools without file manipulation.", + "type": "api-change" + }, + { + "category": "``ec2``", + "description": "With this release, customers can express their desire to launch instances only in an ODCR or ODCR group rather than OnDemand capacity. Customers can express their baseline instances' CPU-performance in attribute-based Instance Requirements configuration by referencing an instance family.", + "type": "api-change" + }, + { + "category": "``ecs``", + "description": "This release adds support for the Availability Zone rebalancing feature on Amazon ECS.", + "type": "api-change" + }, + { + "category": "``elbv2``", + "description": "This release adds support for configuring Load balancer Capacity Unit reservations", + "type": "api-change" + }, + { + "category": "``lambda``", + "description": "Add Node 22.x (node22.x) support to AWS Lambda", + "type": "api-change" + }, + { + "category": "``mediaconvert``", + "description": "This release adds the ability to reconfigure concurrent job settings for existing queues and create queues with custom concurrent job settings.", + "type": "api-change" + }, + { + "category": "``mediapackagev2``", + "description": "MediaPackage v2 now supports the Media Quality Confidence Score (MQCS) published from MediaLive. Customers can control input switching based on the MQCS and publishing HTTP Headers for the MQCS via the API.", + "type": "api-change" + }, + { + "category": "``omics``", + "description": "Enabling call caching feature that allows customers to reuse previously computed results from a set of completed tasks in a new workflow run.", + "type": "api-change" + }, + { + "category": "``rbin``", + "description": "This release adds support for exclusion tags for Recycle Bin, which allows you to identify resources that are to be excluded, or ignored, by a Region-level retention rule.", + "type": "api-change" + }, + { + "category": "``rds``", + "description": "This release adds support for scale storage on the DB instance using a Blue/Green Deployment.", + "type": "api-change" + }, + { + "category": "``timestream-query``", + "description": "This release adds support for Provisioning Timestream Compute Units (TCUs), a new feature that allows provisioning dedicated compute resources for your queries, providing predictable and cost-effective query performance.", + "type": "api-change" + }, + { + "category": "``workspaces``", + "description": "Added support for Rocky Linux 8 on Amazon WorkSpaces Personal.", + "type": "api-change" + }, + { + "category": "``workspaces-web``", + "description": "Added data protection settings with support for inline data redaction.", + "type": "api-change" + } +] \ No newline at end of file diff --git a/CHANGELOG.rst b/CHANGELOG.rst index c97527af89..460e232492 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -2,6 +2,31 @@ CHANGELOG ========= +1.35.66 +======= + +* api-change:``autoscaling``: With this release, customers can prioritize launching instances into ODCRs using targets from ASGs or Launch Templates. Customers can express their baseline instances' CPU-performance in attribute-based Instance Requirements configuration by referencing an instance family that meets their needs. +* api-change:``bedrock-agent-runtime``: Releasing new Prompt Optimization to enhance your prompts for improved performance +* api-change:``cloudfront``: Add support for gRPC, VPC origins, and Anycast IP Lists. Allow LoggingConfig IncludeCookies to be set regardless of whether the LoggingConfig is enabled. +* api-change:``compute-optimizer``: This release enables AWS Compute Optimizer to analyze and generate optimization recommendations for Amazon Aurora database instances. It also enables Compute Optimizer to identify idle Amazon EC2 instances, Amazon EBS volumes, Amazon ECS services running on Fargate, and Amazon RDS databases. +* api-change:``controltower``: Adds support for child enabled baselines which allow you to see the enabled baseline status for individual accounts. +* api-change:``cost-optimization-hub``: This release adds action type "Delete" to the GetRecommendation, ListRecommendations and ListRecommendationSummaries APIs to support new EBS and ECS recommendations with action type "Delete". +* api-change:``datazone``: This release supports Metadata Enforcement Rule feature for Create Subscription Request action. +* api-change:``discovery``: Add support to import data from commercially available discovery tools without file manipulation. +* api-change:``ec2``: With this release, customers can express their desire to launch instances only in an ODCR or ODCR group rather than OnDemand capacity. Customers can express their baseline instances' CPU-performance in attribute-based Instance Requirements configuration by referencing an instance family. +* api-change:``ecs``: This release adds support for the Availability Zone rebalancing feature on Amazon ECS. +* api-change:``elbv2``: This release adds support for configuring Load balancer Capacity Unit reservations +* api-change:``lambda``: Add Node 22.x (node22.x) support to AWS Lambda +* api-change:``mediaconvert``: This release adds the ability to reconfigure concurrent job settings for existing queues and create queues with custom concurrent job settings. +* api-change:``mediapackagev2``: MediaPackage v2 now supports the Media Quality Confidence Score (MQCS) published from MediaLive. Customers can control input switching based on the MQCS and publishing HTTP Headers for the MQCS via the API. +* api-change:``omics``: Enabling call caching feature that allows customers to reuse previously computed results from a set of completed tasks in a new workflow run. +* api-change:``rbin``: This release adds support for exclusion tags for Recycle Bin, which allows you to identify resources that are to be excluded, or ignored, by a Region-level retention rule. +* api-change:``rds``: This release adds support for scale storage on the DB instance using a Blue/Green Deployment. +* api-change:``timestream-query``: This release adds support for Provisioning Timestream Compute Units (TCUs), a new feature that allows provisioning dedicated compute resources for your queries, providing predictable and cost-effective query performance. +* api-change:``workspaces``: Added support for Rocky Linux 8 on Amazon WorkSpaces Personal. +* api-change:``workspaces-web``: Added data protection settings with support for inline data redaction. + + 1.35.65 ======= diff --git a/botocore/__init__.py b/botocore/__init__.py index 920be1decd..ce7ae0bd71 100644 --- a/botocore/__init__.py +++ b/botocore/__init__.py @@ -16,7 +16,7 @@ import os import re -__version__ = '1.35.65' +__version__ = '1.35.66' class NullHandler(logging.Handler): diff --git a/botocore/data/autoscaling/2011-01-01/service-2.json b/botocore/data/autoscaling/2011-01-01/service-2.json index 8e69926881..e0a73bb122 100644 --- a/botocore/data/autoscaling/2011-01-01/service-2.json +++ b/botocore/data/autoscaling/2011-01-01/service-2.json @@ -1533,6 +1533,10 @@ "AvailabilityZoneImpairmentPolicy":{ "shape":"AvailabilityZoneImpairmentPolicy", "documentation":"

The Availability Zone impairment policy.

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

The capacity reservation specification.

" } }, "documentation":"

Describes an Auto Scaling group.

" @@ -1719,6 +1723,16 @@ }, "documentation":"

Specifies the minimum and maximum for the BaselineEbsBandwidthMbps object when you specify InstanceRequirements for an Auto Scaling group.

" }, + "BaselinePerformanceFactorsRequest":{ + "type":"structure", + "members":{ + "Cpu":{ + "shape":"CpuPerformanceFactorRequest", + "documentation":"

The CPU performance to consider, using an instance family as the baseline reference.

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

The baseline performance to consider, using an instance family as a baseline reference. The instance family establishes the lowest acceptable level of performance. Auto Scaling uses this baseline to guide instance type selection, but there is no guarantee that the selected instance types will always exceed the baseline for every application.

Currently, this parameter only supports CPU performance as a baseline performance factor. For example, specifying c6i uses the CPU performance of the c6i family as the baseline reference.

" + }, "BatchDeleteScheduledActionAnswer":{ "type":"structure", "members":{ @@ -1873,6 +1887,51 @@ "documentation":"

A GetPredictiveScalingForecast call returns the capacity forecast for a predictive scaling policy. This structure includes the data points for that capacity forecast, along with the timestamps of those data points.

" }, "CapacityRebalanceEnabled":{"type":"boolean"}, + "CapacityReservationIds":{ + "type":"list", + "member":{"shape":"AsciiStringMaxLen255"} + }, + "CapacityReservationPreference":{ + "type":"string", + "enum":[ + "capacity-reservations-only", + "capacity-reservations-first", + "none", + "default" + ] + }, + "CapacityReservationResourceGroupArns":{ + "type":"list", + "member":{"shape":"ResourceName"} + }, + "CapacityReservationSpecification":{ + "type":"structure", + "members":{ + "CapacityReservationPreference":{ + "shape":"CapacityReservationPreference", + "documentation":"

The capacity reservation preference. The following options are available:

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

Describes a target Capacity Reservation or Capacity Reservation resource group.

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

Describes the Capacity Reservation preference and targeting options. If you specify open or none for CapacityReservationPreference, do not specify a CapacityReservationTarget.

" + }, + "CapacityReservationTarget":{ + "type":"structure", + "members":{ + "CapacityReservationIds":{ + "shape":"CapacityReservationIds", + "documentation":"

The Capacity Reservation IDs to launch instances into.

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

The resource group ARNs of the Capacity Reservation to launch instances into.

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

The target for the Capacity Reservation. Specify Capacity Reservations IDs or Capacity Reservation resource group ARNs.

" + }, "CheckpointDelay":{ "type":"integer", "max":172800, @@ -1935,6 +1994,17 @@ "type":"list", "member":{"shape":"CpuManufacturer"} }, + "CpuPerformanceFactorRequest":{ + "type":"structure", + "members":{ + "References":{ + "shape":"PerformanceFactorReferenceSetRequest", + "documentation":"

Specify an instance family to use as the baseline reference for CPU performance. All instance types that match your specified attributes will be compared against the CPU performance of the referenced instance family, regardless of CPU manufacturer or architecture differences.

Currently only one instance family can be specified in the list.

", + "locationName":"Reference" + } + }, + "documentation":"

The CPU performance to consider, using an instance family as the baseline reference.

" + }, "CreateAutoScalingGroupType":{ "type":"structure", "required":[ @@ -2066,6 +2136,10 @@ "SkipZonalShiftValidation":{ "shape":"SkipZonalShiftValidation", "documentation":"

If you enable zonal shift with cross-zone disabled load balancers, capacity could become imbalanced across Availability Zones. To skip the validation, specify true. For more information, see Auto Scaling group zonal shift in the Amazon EC2 Auto Scaling User Guide.

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

The capacity reservation specification for the Auto Scaling group.

" } } }, @@ -3462,6 +3536,10 @@ "AllowedInstanceTypes":{ "shape":"AllowedInstanceTypes", "documentation":"

The instance types to apply your specified attributes against. All other instance types are ignored, even if they match your specified attributes.

You can use strings with one or more wild cards, represented by an asterisk (*), to allow an instance type, size, or generation. The following are examples: m5.8xlarge, c5*.*, m5a.*, r*, *3*.

For example, if you specify c5*, Amazon EC2 Auto Scaling will allow the entire C5 instance family, which includes all C5a and C5n instance types. If you specify m5a.*, Amazon EC2 Auto Scaling will allow all the M5a instance types, but not the M5n instance types.

If you specify AllowedInstanceTypes, you can't specify ExcludedInstanceTypes.

Default: All instance types

" + }, + "BaselinePerformanceFactors":{ + "shape":"BaselinePerformanceFactorsRequest", + "documentation":"

The baseline performance factors for the instance requirements.

" } }, "documentation":"

The attributes for the instance types for a mixed instances policy. Amazon EC2 Auto Scaling uses your specified requirements to identify instance types. Then, it uses your On-Demand and Spot allocation strategies to launch instances from these instance types.

When you specify multiple attributes, you get instance types that satisfy all of the specified attributes. If you specify multiple values for an attribute, you get instance types that satisfy any of the specified values.

To limit the list of instance types from which Amazon EC2 Auto Scaling can identify matching instance types, you can use one of the following parameters, but not both in the same request:

You must specify VCpuCount and MemoryMiB. All other attributes are optional. Any unspecified optional attribute is set to its default.

For more information, see Create a mixed instances group using attribute-based instance type selection in the Amazon EC2 Auto Scaling User Guide. For help determining which instance types match your attributes before you apply them to your Auto Scaling group, see Preview instance types with specified attributes in the Amazon EC2 User Guide for Linux Instances.

" @@ -4289,6 +4367,23 @@ "type":"list", "member":{"shape":"LaunchTemplateOverrides"} }, + "PerformanceFactorReferenceRequest":{ + "type":"structure", + "members":{ + "InstanceFamily":{ + "shape":"String", + "documentation":"

The instance family to use as a baseline reference.

Make sure that you specify the correct value for the instance family. The instance family is everything before the period (.) in the instance type name. For example, in the instance c6i.large, the instance family is c6i, not c6. For more information, see Amazon EC2 instance type naming conventions in Amazon EC2 Instance Types.

The following instance types are not supported for performance protection.

If you performance protection by specifying a supported instance family, the returned instance types will exclude the preceding unsupported instance families.

If you specify an unsupported instance family as a value for baseline performance, the API returns an empty response.

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

Specify an instance family to use as the baseline reference for CPU performance. All instance types that All instance types that match your specified attributes will be compared against the CPU performance of the referenced instance family, regardless of CPU manufacturer or architecture differences.

Currently only one instance family can be specified in the list.

" + }, + "PerformanceFactorReferenceSetRequest":{ + "type":"list", + "member":{ + "shape":"PerformanceFactorReferenceRequest", + "locationName":"item" + } + }, "PoliciesType":{ "type":"structure", "members":{ @@ -5362,6 +5457,7 @@ "type":"list", "member":{"shape":"StepAdjustment"} }, + "String":{"type":"string"}, "SuspendedProcess":{ "type":"structure", "members":{ @@ -5732,6 +5828,10 @@ "SkipZonalShiftValidation":{ "shape":"SkipZonalShiftValidation", "documentation":"

If you enable zonal shift with cross-zone disabled load balancers, capacity could become imbalanced across Availability Zones. To skip the validation, specify true. For more information, see Auto Scaling group zonal shift in the Amazon EC2 Auto Scaling User Guide.

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

The capacity reservation specification for the Auto Scaling group.

" } } }, diff --git a/botocore/data/bedrock-agent-runtime/2023-07-26/service-2.json b/botocore/data/bedrock-agent-runtime/2023-07-26/service-2.json index 6e3f692d33..c3eaf0f9d6 100644 --- a/botocore/data/bedrock-agent-runtime/2023-07-26/service-2.json +++ b/botocore/data/bedrock-agent-runtime/2023-07-26/service-2.json @@ -101,7 +101,26 @@ {"shape":"AccessDeniedException"}, {"shape":"ServiceQuotaExceededException"} ], - "documentation":"

Invokes an alias of a flow to run the inputs that you specify and return the output of each node as a stream. If there's an error, the error is returned. For more information, see Test a flow in Amazon Bedrock in the Amazon Bedrock User Guide.

The CLI doesn't support streaming operations in Amazon Bedrock, including InvokeFlow.

" + "documentation":"

Invokes an alias of a flow to run the inputs that you specify and return the output of each node as a stream. If there's an error, the error is returned. For more information, see Test a flow in Amazon Bedrock in the Amazon Bedrock User Guide.

The CLI doesn't support streaming operations in Amazon Bedrock, including InvokeFlow.

" + }, + "OptimizePrompt":{ + "name":"OptimizePrompt", + "http":{ + "method":"POST", + "requestUri":"/optimize-prompt", + "responseCode":200 + }, + "input":{"shape":"OptimizePromptRequest"}, + "output":{"shape":"OptimizePromptResponse"}, + "errors":[ + {"shape":"ValidationException"}, + {"shape":"InternalServerException"}, + {"shape":"DependencyFailedException"}, + {"shape":"BadGatewayException"}, + {"shape":"ThrottlingException"}, + {"shape":"AccessDeniedException"} + ], + "documentation":"

Optimizes a prompt for the task that you specify. For more information, see Optimize a prompt in the Amazon Bedrock User Guide.

" }, "Retrieve":{ "name":"Retrieve", @@ -197,7 +216,7 @@ "documentation":"

The API method being used, based off the action group.

" } }, - "documentation":"

Contains information about the action group being invoked. For more information about the possible structures, see the InvocationInput tab in OrchestrationTrace in the Amazon Bedrock User Guide.

" + "documentation":"

Contains information about the action group being invoked. For more information about the possible structures, see the InvocationInput tab in OrchestrationTrace in the Amazon Bedrock User Guide.

" }, "ActionGroupInvocationOutput":{ "type":"structure", @@ -259,6 +278,18 @@ "min":1, "pattern":"^(DRAFT|[0-9]{0,4}[1-9][0-9]{0,4})$" }, + "AnalyzePromptEvent":{ + "type":"structure", + "members":{ + "message":{ + "shape":"String", + "documentation":"

A message describing the analysis of the prompt.

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

An event in which the prompt was analyzed in preparation for optimization.

", + "event":true, + "sensitive":true + }, "ApiContentMap":{ "type":"map", "key":{"shape":"String"}, @@ -1774,6 +1805,17 @@ "type":"list", "member":{"shape":"InputFile"} }, + "InputPrompt":{ + "type":"structure", + "members":{ + "textPrompt":{ + "shape":"TextPrompt", + "documentation":"

Contains information about the text prompt to optimize.

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

Contains information about the prompt to optimize.

", + "union":true + }, "InputText":{ "type":"string", "max":25000000, @@ -2349,6 +2391,102 @@ "documentation":"

Contains the result or output of an action group or knowledge base, or the response to the user.

", "sensitive":true }, + "OptimizePromptRequest":{ + "type":"structure", + "required":[ + "input", + "targetModelId" + ], + "members":{ + "input":{ + "shape":"InputPrompt", + "documentation":"

Contains the prompt to optimize.

" + }, + "targetModelId":{ + "shape":"OptimizePromptRequestTargetModelIdString", + "documentation":"

The unique identifier of the model that you want to optimize the prompt for.

" + } + } + }, + "OptimizePromptRequestTargetModelIdString":{ + "type":"string", + "max":2048, + "min":1, + "pattern":"^(arn:aws(-[^:]+)?:bedrock:[a-z0-9-]{1,20}:(([0-9]{12}:custom-model/[a-z0-9-]{1,63}[.]{1}[a-z0-9-]{1,63}/[a-z0-9]{12})|(:foundation-model/[a-z0-9-]{1,63}[.]{1}[a-z0-9-]{1,63}([.:]?[a-z0-9-]{1,63}))|([0-9]{12}:provisioned-model/[a-z0-9]{12})))|([a-z0-9-]{1,63}[.]{1}[a-z0-9-]{1,63}([.:]?[a-z0-9-]{1,63}))|(([0-9a-zA-Z][_-]?)+)$" + }, + "OptimizePromptResponse":{ + "type":"structure", + "required":["optimizedPrompt"], + "members":{ + "optimizedPrompt":{ + "shape":"OptimizedPromptStream", + "documentation":"

The prompt after being optimized for the task.

" + } + }, + "payload":"optimizedPrompt" + }, + "OptimizedPrompt":{ + "type":"structure", + "members":{ + "textPrompt":{ + "shape":"TextPrompt", + "documentation":"

Contains information about the text in the prompt that was optimized.

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

Contains information about the optimized prompt.

", + "union":true + }, + "OptimizedPromptEvent":{ + "type":"structure", + "members":{ + "optimizedPrompt":{ + "shape":"OptimizedPrompt", + "documentation":"

Contains information about the optimized prompt.

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

An event in which the prompt was optimized.

", + "event":true, + "sensitive":true + }, + "OptimizedPromptStream":{ + "type":"structure", + "members":{ + "accessDeniedException":{ + "shape":"AccessDeniedException", + "documentation":"

The request is denied because of missing access permissions. Check your permissions and retry your request.

" + }, + "analyzePromptEvent":{ + "shape":"AnalyzePromptEvent", + "documentation":"

An event in which the prompt was analyzed in preparation for optimization.

" + }, + "badGatewayException":{ + "shape":"BadGatewayException", + "documentation":"

There was an issue with a dependency due to a server issue. Retry your request.

" + }, + "dependencyFailedException":{ + "shape":"DependencyFailedException", + "documentation":"

There was an issue with a dependency. Check the resource configurations and retry the request.

" + }, + "internalServerException":{ + "shape":"InternalServerException", + "documentation":"

An internal server error occurred. Retry your request.

" + }, + "optimizedPromptEvent":{ + "shape":"OptimizedPromptEvent", + "documentation":"

An event in which the prompt was optimized.

" + }, + "throttlingException":{ + "shape":"ThrottlingException", + "documentation":"

Your request was throttled because of service-wide limitations. Resubmit your request later or in a different region. You can also purchase Provisioned Throughput to increase the rate or number of tokens you can process.

" + }, + "validationException":{ + "shape":"ValidationException", + "documentation":"

Input validation failed. Check your request parameters and retry the request.

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

The stream containing events in the prompt optimization process.

", + "eventstream":true + }, "OrchestrationConfiguration":{ "type":"structure", "members":{ @@ -3347,12 +3485,29 @@ }, "documentation":"

Configuration settings for text generation using a language model via the RetrieveAndGenerate operation. Includes parameters like temperature, top-p, maximum token count, and stop sequences.

The valid range of maxTokens depends on the accepted values for your chosen model's inference parameters. To see the inference parameters for your model, see Inference parameters for foundation models.

" }, + "TextPrompt":{ + "type":"structure", + "required":["text"], + "members":{ + "text":{ + "shape":"TextPromptTextString", + "documentation":"

The text in the text prompt to optimize.

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

Contains information about the text prompt to optimize.

", + "sensitive":true + }, "TextPromptTemplate":{ "type":"string", "max":4000, "min":1, "sensitive":true }, + "TextPromptTextString":{ + "type":"string", + "max":200000, + "min":1 + }, "TextResponsePart":{ "type":"structure", "members":{ diff --git a/botocore/data/cloudfront/2020-05-31/service-2.json b/botocore/data/cloudfront/2020-05-31/service-2.json index 943bdb84c5..3685ab76b5 100644 --- a/botocore/data/cloudfront/2020-05-31/service-2.json +++ b/botocore/data/cloudfront/2020-05-31/service-2.json @@ -113,6 +113,29 @@ ], "documentation":"

Creates a staging distribution using the configuration of the provided primary distribution. A staging distribution is a copy of an existing distribution (called the primary distribution) that you can use in a continuous deployment workflow.

After you create a staging distribution, you can use UpdateDistribution to modify the staging distribution's configuration. Then you can use CreateContinuousDeploymentPolicy to incrementally move traffic to the staging distribution.

This API operation requires the following IAM permissions:

" }, + "CreateAnycastIpList":{ + "name":"CreateAnycastIpList2020_05_31", + "http":{ + "method":"POST", + "requestUri":"/2020-05-31/anycast-ip-list", + "responseCode":202 + }, + "input":{ + "shape":"CreateAnycastIpListRequest", + "locationName":"CreateAnycastIpListRequest", + "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2020-05-31/"} + }, + "output":{"shape":"CreateAnycastIpListResult"}, + "errors":[ + {"shape":"AccessDenied"}, + {"shape":"UnsupportedOperation"}, + {"shape":"EntityAlreadyExists"}, + {"shape":"InvalidTagging"}, + {"shape":"InvalidArgument"}, + {"shape":"EntityLimitExceeded"} + ], + "documentation":"

Creates an Anycast static IP list.

" + }, "CreateCachePolicy":{ "name":"CreateCachePolicy2020_05_31", "http":{ @@ -210,6 +233,7 @@ {"shape":"InvalidArgument"}, {"shape":"InvalidOriginReadTimeout"}, {"shape":"InvalidOriginAccessControl"}, + {"shape":"EntityNotFound"}, {"shape":"InvalidHeadersForS3Origin"}, {"shape":"TrustedSignerDoesNotExist"}, {"shape":"InvalidWebACLId"}, @@ -288,6 +312,7 @@ {"shape":"InvalidArgument"}, {"shape":"InvalidOriginReadTimeout"}, {"shape":"InvalidOriginAccessControl"}, + {"shape":"EntityNotFound"}, {"shape":"InvalidHeadersForS3Origin"}, {"shape":"TrustedSignerDoesNotExist"}, {"shape":"InvalidWebACLId"}, @@ -617,6 +642,50 @@ ], "documentation":"

This API is deprecated. Amazon CloudFront is deprecating real-time messaging protocol (RTMP) distributions on December 31, 2020. For more information, read the announcement on the Amazon CloudFront discussion forum.

" }, + "CreateVpcOrigin":{ + "name":"CreateVpcOrigin2020_05_31", + "http":{ + "method":"POST", + "requestUri":"/2020-05-31/vpc-origin", + "responseCode":202 + }, + "input":{ + "shape":"CreateVpcOriginRequest", + "locationName":"CreateVpcOriginRequest", + "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2020-05-31/"} + }, + "output":{"shape":"CreateVpcOriginResult"}, + "errors":[ + {"shape":"AccessDenied"}, + {"shape":"UnsupportedOperation"}, + {"shape":"InconsistentQuantities"}, + {"shape":"EntityAlreadyExists"}, + {"shape":"InvalidTagging"}, + {"shape":"InvalidArgument"}, + {"shape":"EntityLimitExceeded"} + ], + "documentation":"

Create an Amazon CloudFront VPC origin.

" + }, + "DeleteAnycastIpList":{ + "name":"DeleteAnycastIpList2020_05_31", + "http":{ + "method":"DELETE", + "requestUri":"/2020-05-31/anycast-ip-list/{Id}", + "responseCode":204 + }, + "input":{"shape":"DeleteAnycastIpListRequest"}, + "errors":[ + {"shape":"CannotDeleteEntityWhileInUse"}, + {"shape":"PreconditionFailed"}, + {"shape":"EntityNotFound"}, + {"shape":"AccessDenied"}, + {"shape":"IllegalDelete"}, + {"shape":"UnsupportedOperation"}, + {"shape":"InvalidArgument"}, + {"shape":"InvalidIfMatchVersion"} + ], + "documentation":"

Deletes an Anycast static IP list.

" + }, "DeleteCachePolicy":{ "name":"DeleteCachePolicy2020_05_31", "http":{ @@ -897,6 +966,27 @@ ], "documentation":"

Delete a streaming distribution. To delete an RTMP distribution using the CloudFront API, perform the following steps.

To delete an RTMP distribution using the CloudFront API:

  1. Disable the RTMP distribution.

  2. Submit a GET Streaming Distribution Config request to get the current configuration and the Etag header for the distribution.

  3. Update the XML document that was returned in the response to your GET Streaming Distribution Config request to change the value of Enabled to false.

  4. Submit a PUT Streaming Distribution Config request to update the configuration for your distribution. In the request body, include the XML document that you updated in Step 3. Then set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Streaming Distribution Config request in Step 2.

  5. Review the response to the PUT Streaming Distribution Config request to confirm that the distribution was successfully disabled.

  6. Submit a GET Streaming Distribution Config request to confirm that your changes have propagated. When propagation is complete, the value of Status is Deployed.

  7. Submit a DELETE Streaming Distribution request. Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Streaming Distribution Config request in Step 2.

  8. Review the response to your DELETE Streaming Distribution request to confirm that the distribution was successfully deleted.

For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the Amazon CloudFront Developer Guide.

" }, + "DeleteVpcOrigin":{ + "name":"DeleteVpcOrigin2020_05_31", + "http":{ + "method":"DELETE", + "requestUri":"/2020-05-31/vpc-origin/{Id}", + "responseCode":202 + }, + "input":{"shape":"DeleteVpcOriginRequest"}, + "output":{"shape":"DeleteVpcOriginResult"}, + "errors":[ + {"shape":"CannotDeleteEntityWhileInUse"}, + {"shape":"PreconditionFailed"}, + {"shape":"EntityNotFound"}, + {"shape":"AccessDenied"}, + {"shape":"IllegalDelete"}, + {"shape":"UnsupportedOperation"}, + {"shape":"InvalidArgument"}, + {"shape":"InvalidIfMatchVersion"} + ], + "documentation":"

Delete an Amazon CloudFront VPC origin.

" + }, "DescribeFunction":{ "name":"DescribeFunction2020_05_31", "http":{ @@ -929,6 +1019,23 @@ ], "documentation":"

Specifies the key value store and its configuration.

" }, + "GetAnycastIpList":{ + "name":"GetAnycastIpList2020_05_31", + "http":{ + "method":"GET", + "requestUri":"/2020-05-31/anycast-ip-list/{Id}", + "responseCode":200 + }, + "input":{"shape":"GetAnycastIpListRequest"}, + "output":{"shape":"GetAnycastIpListResult"}, + "errors":[ + {"shape":"EntityNotFound"}, + {"shape":"AccessDenied"}, + {"shape":"UnsupportedOperation"}, + {"shape":"InvalidArgument"} + ], + "documentation":"

Gets an Anycast static IP list.

" + }, "GetCachePolicy":{ "name":"GetCachePolicy2020_05_31", "http":{ @@ -1355,6 +1462,40 @@ ], "documentation":"

Get the configuration information about a streaming distribution.

" }, + "GetVpcOrigin":{ + "name":"GetVpcOrigin2020_05_31", + "http":{ + "method":"GET", + "requestUri":"/2020-05-31/vpc-origin/{Id}", + "responseCode":200 + }, + "input":{"shape":"GetVpcOriginRequest"}, + "output":{"shape":"GetVpcOriginResult"}, + "errors":[ + {"shape":"EntityNotFound"}, + {"shape":"AccessDenied"}, + {"shape":"UnsupportedOperation"}, + {"shape":"InvalidArgument"} + ], + "documentation":"

Get the details of an Amazon CloudFront VPC origin.

" + }, + "ListAnycastIpLists":{ + "name":"ListAnycastIpLists2020_05_31", + "http":{ + "method":"GET", + "requestUri":"/2020-05-31/anycast-ip-list", + "responseCode":200 + }, + "input":{"shape":"ListAnycastIpListsRequest"}, + "output":{"shape":"ListAnycastIpListsResult"}, + "errors":[ + {"shape":"EntityNotFound"}, + {"shape":"AccessDenied"}, + {"shape":"UnsupportedOperation"}, + {"shape":"InvalidArgument"} + ], + "documentation":"

Lists your Anycast static IP lists.

" + }, "ListCachePolicies":{ "name":"ListCachePolicies2020_05_31", "http":{ @@ -1430,6 +1571,23 @@ ], "documentation":"

List CloudFront distributions.

" }, + "ListDistributionsByAnycastIpListId":{ + "name":"ListDistributionsByAnycastIpListId2020_05_31", + "http":{ + "method":"GET", + "requestUri":"/2020-05-31/distributionsByAnycastIpListId/{AnycastIpListId}", + "responseCode":200 + }, + "input":{"shape":"ListDistributionsByAnycastIpListIdRequest"}, + "output":{"shape":"ListDistributionsByAnycastIpListIdResult"}, + "errors":[ + {"shape":"EntityNotFound"}, + {"shape":"AccessDenied"}, + {"shape":"UnsupportedOperation"}, + {"shape":"InvalidArgument"} + ], + "documentation":"

Lists the distributions in your account that are associated with the specified AnycastIpListId.

" + }, "ListDistributionsByCachePolicyId":{ "name":"ListDistributionsByCachePolicyId2020_05_31", "http":{ @@ -1511,6 +1669,23 @@ ], "documentation":"

Gets a list of distribution IDs for distributions that have a cache behavior that's associated with the specified response headers policy.

You can optionally specify the maximum number of items to receive in the response. If the total number of items in the list exceeds the maximum that you specify, or the default maximum, the response is paginated. To get the next page of items, send a subsequent request that specifies the NextMarker value from the current response as the Marker value in the subsequent request.

" }, + "ListDistributionsByVpcOriginId":{ + "name":"ListDistributionsByVpcOriginId2020_05_31", + "http":{ + "method":"GET", + "requestUri":"/2020-05-31/distributionsByVpcOriginId/{VpcOriginId}", + "responseCode":200 + }, + "input":{"shape":"ListDistributionsByVpcOriginIdRequest"}, + "output":{"shape":"ListDistributionsByVpcOriginIdResult"}, + "errors":[ + {"shape":"EntityNotFound"}, + {"shape":"AccessDenied"}, + {"shape":"UnsupportedOperation"}, + {"shape":"InvalidArgument"} + ], + "documentation":"

List CloudFront distributions by their VPC origin ID.

" + }, "ListDistributionsByWebACLId":{ "name":"ListDistributionsByWebACLId2020_05_31", "http":{ @@ -1722,6 +1897,23 @@ ], "documentation":"

List tags for a CloudFront resource. For more information, see Tagging a distribution in the Amazon CloudFront Developer Guide.

" }, + "ListVpcOrigins":{ + "name":"ListVpcOrigins2020_05_31", + "http":{ + "method":"GET", + "requestUri":"/2020-05-31/vpc-origin", + "responseCode":200 + }, + "input":{"shape":"ListVpcOriginsRequest"}, + "output":{"shape":"ListVpcOriginsResult"}, + "errors":[ + {"shape":"EntityNotFound"}, + {"shape":"AccessDenied"}, + {"shape":"UnsupportedOperation"}, + {"shape":"InvalidArgument"} + ], + "documentation":"

List the CloudFront VPC origins in your account.

" + }, "PublishFunction":{ "name":"PublishFunction2020_05_31", "http":{ @@ -1896,6 +2088,7 @@ {"shape":"InvalidOriginReadTimeout"}, {"shape":"IllegalUpdate"}, {"shape":"InvalidOriginAccessControl"}, + {"shape":"EntityNotFound"}, {"shape":"StagingDistributionInUse"}, {"shape":"InvalidHeadersForS3Origin"}, {"shape":"TrustedSignerDoesNotExist"}, @@ -1973,6 +2166,7 @@ {"shape":"InvalidOriginReadTimeout"}, {"shape":"IllegalUpdate"}, {"shape":"InvalidOriginAccessControl"}, + {"shape":"EntityNotFound"}, {"shape":"InvalidHeadersForS3Origin"}, {"shape":"TrustedSignerDoesNotExist"}, {"shape":"InvalidWebACLId"}, @@ -2261,6 +2455,30 @@ {"shape":"NoSuchStreamingDistribution"} ], "documentation":"

Update a streaming distribution.

" + }, + "UpdateVpcOrigin":{ + "name":"UpdateVpcOrigin2020_05_31", + "http":{ + "method":"PUT", + "requestUri":"/2020-05-31/vpc-origin/{Id}", + "responseCode":202 + }, + "input":{"shape":"UpdateVpcOriginRequest"}, + "output":{"shape":"UpdateVpcOriginResult"}, + "errors":[ + {"shape":"PreconditionFailed"}, + {"shape":"EntityNotFound"}, + {"shape":"AccessDenied"}, + {"shape":"UnsupportedOperation"}, + {"shape":"InconsistentQuantities"}, + {"shape":"EntityAlreadyExists"}, + {"shape":"CannotUpdateEntityWhileInUse"}, + {"shape":"InvalidArgument"}, + {"shape":"EntityLimitExceeded"}, + {"shape":"IllegalUpdate"}, + {"shape":"InvalidIfMatchVersion"} + ], + "documentation":"

Update an Amazon CloudFront VPC origin in your account.

" } }, "shapes":{ @@ -2410,6 +2628,143 @@ }, "documentation":"

A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices:

If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin.

" }, + "AnycastIpList":{ + "type":"structure", + "required":[ + "Id", + "Name", + "Status", + "Arn", + "AnycastIps", + "IpCount", + "LastModifiedTime" + ], + "members":{ + "Id":{ + "shape":"string", + "documentation":"

The ID of the Anycast static IP list.

" + }, + "Name":{ + "shape":"AnycastIpListName", + "documentation":"

The name of the Anycast static IP list.

" + }, + "Status":{ + "shape":"string", + "documentation":"

The status of the Anycast static IP list. Valid values: Deployed, Deploying, or Failed.

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

The Amazon Resource Name (ARN) of the Anycast static IP list.

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

The static IP addresses that are allocated to the Anycast static IP list.

" + }, + "IpCount":{ + "shape":"integer", + "documentation":"

The number of IP addresses in the Anycast static IP list.

" + }, + "LastModifiedTime":{ + "shape":"timestamp", + "documentation":"

The last time the Anycast static IP list was modified.

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

An Anycast static IP list.

" + }, + "AnycastIpListCollection":{ + "type":"structure", + "required":[ + "Marker", + "MaxItems", + "IsTruncated", + "Quantity" + ], + "members":{ + "Items":{ + "shape":"AnycastIpListSummaries", + "documentation":"

Items in the Anycast static IP list collection. Each item is of the AnycastIpListSummary structure type.

" + }, + "Marker":{ + "shape":"string", + "documentation":"

Use this field when paginating results to indicate where to begin in your list. The response includes items in the list that occur after the marker. To get the next page of the list, set this field's value to the value of NextMarker from the current page's response.

" + }, + "NextMarker":{ + "shape":"string", + "documentation":"

Indicates the next page of the Anycast static IP list collection. To get the next page of the list, use this value in the Marker field of your request.

" + }, + "MaxItems":{ + "shape":"integer", + "documentation":"

The maximum number of Anycast static IP list collections that you want returned in the response.

" + }, + "IsTruncated":{ + "shape":"boolean", + "documentation":"

If there are more items in the list collection than are in this response, this value is true.

" + }, + "Quantity":{ + "shape":"integer", + "documentation":"

The quantity of Anycast static IP lists in the collection.

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

The Anycast static IP list collection.

" + }, + "AnycastIpListName":{ + "type":"string", + "max":64, + "min":1, + "pattern":"[a-zA-Z0-9-_]{1,64}" + }, + "AnycastIpListSummaries":{ + "type":"list", + "member":{ + "shape":"AnycastIpListSummary", + "locationName":"AnycastIpListSummary" + } + }, + "AnycastIpListSummary":{ + "type":"structure", + "required":[ + "Id", + "Name", + "Status", + "Arn", + "IpCount", + "LastModifiedTime" + ], + "members":{ + "Id":{ + "shape":"string", + "documentation":"

The ID of the Anycast static IP list.

" + }, + "Name":{ + "shape":"AnycastIpListName", + "documentation":"

The name of the Anycast static IP list.

" + }, + "Status":{ + "shape":"string", + "documentation":"

The deployment status of the Anycast static IP list. Valid values: Deployed, Deploying, or Failed.

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

The Amazon Resource Name (ARN) of the Anycast static IP list.

" + }, + "IpCount":{ + "shape":"integer", + "documentation":"

The number of IP addresses in the Anycast static IP list.

" + }, + "LastModifiedTime":{ + "shape":"timestamp", + "documentation":"

The last time the Anycast static IP list was modified.

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

An abbreviated version of the AnycastIpList structure. Omits the allocated static IP addresses (AnycastIpList$AnycastIps).

" + }, + "AnycastIps":{ + "type":"list", + "member":{ + "shape":"string", + "locationName":"AnycastIp" + } + }, "AssociateAliasRequest":{ "type":"structure", "required":[ @@ -2527,6 +2882,10 @@ "shape":"string", "documentation":"

The identifier for a response headers policy.

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

The gRPC configuration for your cache behavior.

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

This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. For more information, see Working with policies in the Amazon CloudFront Developer Guide.

If you want to include values in the cache key, use a cache policy. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.

If you want to send values to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.

A CacheBehavior must include either a CachePolicyId or ForwardedValues. We recommend that you use a CachePolicyId.

A complex type that specifies how CloudFront handles query strings, cookies, and HTTP headers.

", @@ -2810,7 +3169,19 @@ "members":{ "Message":{"shape":"string"} }, - "documentation":"

The key value store entity cannot be deleted while it is in use.

", + "documentation":"

The entity cannot be deleted while it is in use.

", + "error":{ + "httpStatusCode":409, + "senderFault":true + }, + "exception":true + }, + "CannotUpdateEntityWhileInUse":{ + "type":"structure", + "members":{ + "Message":{"shape":"string"} + }, + "documentation":"

The entity cannot be updated while it is in use.

", "error":{ "httpStatusCode":409, "senderFault":true @@ -3303,6 +3674,40 @@ }, "payload":"Distribution" }, + "CreateAnycastIpListRequest":{ + "type":"structure", + "required":[ + "Name", + "IpCount" + ], + "members":{ + "Name":{ + "shape":"AnycastIpListName", + "documentation":"

Name of the Anycast static IP list.

" + }, + "IpCount":{ + "shape":"integer", + "documentation":"

The number of static IP addresses that are allocated to the Anycast static IP list.

" + }, + "Tags":{"shape":"Tags"} + } + }, + "CreateAnycastIpListResult":{ + "type":"structure", + "members":{ + "AnycastIpList":{ + "shape":"AnycastIpList", + "documentation":"

A response structure that includes the version identifier (ETag) and the created AnycastIpList structure.

" + }, + "ETag":{ + "shape":"string", + "documentation":"

The version identifier for the current version of the Anycast static IP list.

", + "location":"header", + "locationName":"ETag" + } + }, + "payload":"AnycastIpList" + }, "CreateCachePolicyRequest":{ "type":"structure", "required":["CachePolicyConfig"], @@ -3995,6 +4400,39 @@ "documentation":"

The returned result of the corresponding request.

", "payload":"StreamingDistribution" }, + "CreateVpcOriginRequest":{ + "type":"structure", + "required":["VpcOriginEndpointConfig"], + "members":{ + "VpcOriginEndpointConfig":{ + "shape":"VpcOriginEndpointConfig", + "documentation":"

The VPC origin endpoint configuration.

" + }, + "Tags":{"shape":"Tags"} + } + }, + "CreateVpcOriginResult":{ + "type":"structure", + "members":{ + "VpcOrigin":{ + "shape":"VpcOrigin", + "documentation":"

The VPC origin.

" + }, + "Location":{ + "shape":"string", + "documentation":"

The VPC origin location.

", + "location":"header", + "locationName":"Location" + }, + "ETag":{ + "shape":"string", + "documentation":"

The VPC origin ETag.

", + "location":"header", + "locationName":"ETag" + } + }, + "payload":"VpcOrigin" + }, "CustomErrorResponse":{ "type":"structure", "required":["ErrorCode"], @@ -4150,6 +4588,10 @@ "shape":"string", "documentation":"

The identifier for a response headers policy.

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

The gRPC configuration for your cache behavior.

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

This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. For more information, see Working with policies in the Amazon CloudFront Developer Guide.

If you want to include values in the cache key, use a cache policy. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.

If you want to send values to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.

A DefaultCacheBehavior must include either a CachePolicyId or ForwardedValues. We recommend that you use a CachePolicyId.

A complex type that specifies how CloudFront handles query strings, cookies, and HTTP headers.

", @@ -4173,6 +4615,27 @@ }, "documentation":"

A complex type that describes the default cache behavior if you don't specify a CacheBehavior element or if request URLs don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.

" }, + "DeleteAnycastIpListRequest":{ + "type":"structure", + "required":[ + "Id", + "IfMatch" + ], + "members":{ + "Id":{ + "shape":"string", + "documentation":"

The ID of the Anycast static IP list.

", + "location":"uri", + "locationName":"Id" + }, + "IfMatch":{ + "shape":"string", + "documentation":"

The current version (ETag value) of the Anycast static IP list that you are deleting.

", + "location":"header", + "locationName":"If-Match" + } + } + }, "DeleteCachePolicyRequest":{ "type":"structure", "required":["Id"], @@ -4464,6 +4927,43 @@ }, "documentation":"

The request to delete a streaming distribution.

" }, + "DeleteVpcOriginRequest":{ + "type":"structure", + "required":[ + "Id", + "IfMatch" + ], + "members":{ + "Id":{ + "shape":"string", + "documentation":"

The VPC origin ID.

", + "location":"uri", + "locationName":"Id" + }, + "IfMatch":{ + "shape":"string", + "documentation":"

The VPC origin to delete, if a match occurs.

", + "location":"header", + "locationName":"If-Match" + } + } + }, + "DeleteVpcOriginResult":{ + "type":"structure", + "members":{ + "VpcOrigin":{ + "shape":"VpcOrigin", + "documentation":"

The VPC origin.

" + }, + "ETag":{ + "shape":"string", + "documentation":"

The VPC origin ETag.

", + "location":"header", + "locationName":"ETag" + } + }, + "payload":"VpcOrigin" + }, "DescribeFunctionRequest":{ "type":"structure", "required":["Name"], @@ -4678,6 +5178,10 @@ "Staging":{ "shape":"boolean", "documentation":"

A Boolean that indicates whether this is a staging distribution. When this value is true, this is a staging distribution. When this value is false, this is not a staging distribution.

" + }, + "AnycastIpListId":{ + "shape":"string", + "documentation":"

ID of the Anycast static IP list that is associated with the distribution.

" } }, "documentation":"

A distribution configuration.

" @@ -4898,6 +5402,10 @@ "Staging":{ "shape":"boolean", "documentation":"

A Boolean that indicates whether this is a staging distribution. When this value is true, this is a staging distribution. When this value is false, this is not a staging distribution.

" + }, + "AnycastIpListId":{ + "shape":"string", + "documentation":"

ID of the Anycast static IP list that is associated with the distribution.

" } }, "documentation":"

A summary of the information about a CloudFront distribution.

" @@ -4978,7 +5486,7 @@ "members":{ "Message":{"shape":"string"} }, - "documentation":"

The key value store entity already exists. You must provide a unique key value store entity.

", + "documentation":"

The entity already exists. You must provide a unique entity.

", "error":{ "httpStatusCode":409, "senderFault":true @@ -4990,7 +5498,7 @@ "members":{ "Message":{"shape":"string"} }, - "documentation":"

The key value store entity limit has been exceeded.

", + "documentation":"

The entity limit has been exceeded.

", "error":{ "httpStatusCode":400, "senderFault":true @@ -5002,7 +5510,7 @@ "members":{ "Message":{"shape":"string"} }, - "documentation":"

The key value store entity was not found.

", + "documentation":"

The entity was not found.

", "error":{ "httpStatusCode":404, "senderFault":true @@ -5014,7 +5522,7 @@ "members":{ "Message":{"shape":"string"} }, - "documentation":"

The key value store entity size limit was exceeded.

", + "documentation":"

The entity size limit was exceeded.

", "error":{ "httpStatusCode":413, "senderFault":true @@ -5637,6 +6145,34 @@ "none" ] }, + "GetAnycastIpListRequest":{ + "type":"structure", + "required":["Id"], + "members":{ + "Id":{ + "shape":"string", + "documentation":"

The ID of the Anycast static IP list.

", + "location":"uri", + "locationName":"Id" + } + } + }, + "GetAnycastIpListResult":{ + "type":"structure", + "members":{ + "AnycastIpList":{ + "shape":"AnycastIpList", + "documentation":"

The Anycast static IP list details.

" + }, + "ETag":{ + "shape":"string", + "documentation":"

The version identifier for the current version of the Anycast static IP list.

", + "location":"header", + "locationName":"ETag" + } + }, + "payload":"AnycastIpList" + }, "GetCachePolicyConfigRequest":{ "type":"structure", "required":["Id"], @@ -6405,35 +6941,74 @@ "documentation":"

The returned result of the corresponding request.

", "payload":"StreamingDistributionConfig" }, - "GetStreamingDistributionRequest":{ + "GetStreamingDistributionRequest":{ + "type":"structure", + "required":["Id"], + "members":{ + "Id":{ + "shape":"string", + "documentation":"

The streaming distribution's ID.

", + "location":"uri", + "locationName":"Id" + } + }, + "documentation":"

The request to get a streaming distribution's information.

" + }, + "GetStreamingDistributionResult":{ + "type":"structure", + "members":{ + "StreamingDistribution":{ + "shape":"StreamingDistribution", + "documentation":"

The streaming distribution's information.

" + }, + "ETag":{ + "shape":"string", + "documentation":"

The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL.

", + "location":"header", + "locationName":"ETag" + } + }, + "documentation":"

The returned result of the corresponding request.

", + "payload":"StreamingDistribution" + }, + "GetVpcOriginRequest":{ "type":"structure", "required":["Id"], "members":{ "Id":{ "shape":"string", - "documentation":"

The streaming distribution's ID.

", + "documentation":"

The VPC origin ID.

", "location":"uri", "locationName":"Id" } - }, - "documentation":"

The request to get a streaming distribution's information.

" + } }, - "GetStreamingDistributionResult":{ + "GetVpcOriginResult":{ "type":"structure", "members":{ - "StreamingDistribution":{ - "shape":"StreamingDistribution", - "documentation":"

The streaming distribution's information.

" + "VpcOrigin":{ + "shape":"VpcOrigin", + "documentation":"

The VPC origin.

" }, "ETag":{ "shape":"string", - "documentation":"

The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL.

", + "documentation":"

The VPC origin ETag.

", "location":"header", "locationName":"ETag" } }, - "documentation":"

The returned result of the corresponding request.

", - "payload":"StreamingDistribution" + "payload":"VpcOrigin" + }, + "GrpcConfig":{ + "type":"structure", + "required":["Enabled"], + "members":{ + "Enabled":{ + "shape":"boolean", + "documentation":"

Enables your CloudFront distribution to receive gRPC requests and to proxy them directly to your origins.

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

Amazon CloudFront supports gRPC, an open-source remote procedure call (RPC) framework built on HTTP/2. gRPC offers bi-directional streaming and binary protocol that buffers payloads, making it suitable for applications that require low latency communications.

To enable your distribution to handle gRPC requests, you must include HTTP/2 as one of the supported HTTP versions and allow HTTP methods, including POST.

For more information, see Using gRPC with CloudFront distributions in the Amazon CloudFront Developer Guide.

" }, "HeaderList":{ "type":"list", @@ -6479,7 +7054,7 @@ "members":{ "Message":{"shape":"string"} }, - "documentation":"

You cannot delete a managed policy.

", + "documentation":"

Deletion is not allowed for this entity.

", "error":{ "httpStatusCode":400, "senderFault":true @@ -7312,6 +7887,34 @@ }, "documentation":"

A complex type that specifies a list of Lambda@Edge functions associations for a cache behavior.

If you want to invoke one or more Lambda@Edge functions triggered by requests that match the PathPattern of the cache behavior, specify the applicable values for Quantity and Items. Note that there can be up to 4 LambdaFunctionAssociation items in this list (one for each possible value of EventType) and each EventType can be associated with only one function.

If you don't want to invoke any Lambda@Edge functions for the requests that match PathPattern, specify 0 for Quantity and omit Items.

" }, + "ListAnycastIpListsRequest":{ + "type":"structure", + "members":{ + "Marker":{ + "shape":"string", + "documentation":"

Use this field when paginating results to indicate where to begin in your list. The response includes items in the list that occur after the marker. To get the next page of the list, set this field's value to the value of NextMarker from the current page's response.

", + "location":"querystring", + "locationName":"Marker" + }, + "MaxItems":{ + "shape":"integer", + "documentation":"

The maximum number of Anycast static IP lists that you want returned in the response.

", + "location":"querystring", + "locationName":"MaxItems" + } + } + }, + "ListAnycastIpListsResult":{ + "type":"structure", + "members":{ + "AnycastIpLists":{ + "shape":"AnycastIpListCollection", + "documentation":"

Root level tag for the AnycastIpLists parameters.

", + "locationName":"AnycastIpListCollection" + } + }, + "payload":"AnycastIpLists" + }, "ListCachePoliciesRequest":{ "type":"structure", "members":{ @@ -7444,6 +8047,37 @@ }, "payload":"ContinuousDeploymentPolicyList" }, + "ListDistributionsByAnycastIpListIdRequest":{ + "type":"structure", + "required":["AnycastIpListId"], + "members":{ + "Marker":{ + "shape":"string", + "documentation":"

Use this field when paginating results to indicate where to begin in your list. The response includes items in the list that occur after the marker. To get the next page of the list, set this field's value to the value of NextMarker from the current page's response.

", + "location":"querystring", + "locationName":"Marker" + }, + "MaxItems":{ + "shape":"string", + "documentation":"

The maximum number of distributions that you want returned in the response.

", + "location":"querystring", + "locationName":"MaxItems" + }, + "AnycastIpListId":{ + "shape":"string", + "documentation":"

The ID of the Anycast static IP list.

", + "location":"uri", + "locationName":"AnycastIpListId" + } + } + }, + "ListDistributionsByAnycastIpListIdResult":{ + "type":"structure", + "members":{ + "DistributionList":{"shape":"DistributionList"} + }, + "payload":"DistributionList" + }, "ListDistributionsByCachePolicyIdRequest":{ "type":"structure", "required":["CachePolicyId"], @@ -7602,6 +8236,37 @@ }, "payload":"DistributionIdList" }, + "ListDistributionsByVpcOriginIdRequest":{ + "type":"structure", + "required":["VpcOriginId"], + "members":{ + "Marker":{ + "shape":"string", + "documentation":"

The marker associated with the VPC origin distributions list.

", + "location":"querystring", + "locationName":"Marker" + }, + "MaxItems":{ + "shape":"string", + "documentation":"

The maximum number of items included in the list.

", + "location":"querystring", + "locationName":"MaxItems" + }, + "VpcOriginId":{ + "shape":"string", + "documentation":"

The VPC origin ID.

", + "location":"uri", + "locationName":"VpcOriginId" + } + } + }, + "ListDistributionsByVpcOriginIdResult":{ + "type":"structure", + "members":{ + "DistributionIdList":{"shape":"DistributionIdList"} + }, + "payload":"DistributionIdList" + }, "ListDistributionsByWebACLIdRequest":{ "type":"structure", "required":["WebACLId"], @@ -8051,6 +8716,33 @@ "documentation":"

The returned result of the corresponding request.

", "payload":"Tags" }, + "ListVpcOriginsRequest":{ + "type":"structure", + "members":{ + "Marker":{ + "shape":"string", + "documentation":"

The marker associated with the VPC origins list.

", + "location":"querystring", + "locationName":"Marker" + }, + "MaxItems":{ + "shape":"string", + "documentation":"

The maximum number of items included in the list.

", + "location":"querystring", + "locationName":"MaxItems" + } + } + }, + "ListVpcOriginsResult":{ + "type":"structure", + "members":{ + "VpcOriginList":{ + "shape":"VpcOriginList", + "documentation":"

List of VPC origins.

" + } + }, + "payload":"VpcOriginList" + }, "LocationList":{ "type":"list", "member":{ @@ -8060,31 +8752,27 @@ }, "LoggingConfig":{ "type":"structure", - "required":[ - "Enabled", - "IncludeCookies", - "Bucket", - "Prefix" - ], "members":{ "Enabled":{ "shape":"boolean", - "documentation":"

Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you don't want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket, prefix, and IncludeCookies, the values are automatically deleted.

" + "documentation":"

Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you don't want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify false for Enabled, and specify empty Bucket and Prefix elements. If you specify false for Enabled but you specify values for Bucket and prefix, the values are automatically deleted.

", + "box":true }, "IncludeCookies":{ "shape":"boolean", - "documentation":"

Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you don't want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies.

" + "documentation":"

Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you don't want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies.

", + "box":true }, "Bucket":{ "shape":"string", - "documentation":"

The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com.

" + "documentation":"

The Amazon S3 bucket to store the access logs in, for example, amzn-s3-demo-bucket.s3.amazonaws.com.

" }, "Prefix":{ "shape":"string", "documentation":"

An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/. If you want to enable logging, but you don't want to specify a prefix, you still must include an empty Prefix element in the Logging element.

" } }, - "documentation":"

A complex type that controls whether access logs are written for the distribution.

" + "documentation":"

A complex type that specifies whether access logs are written for the distribution.

If you already enabled standard logging (legacy) and you want to enable standard logging (v2) to send your access logs to Amazon S3, we recommend that you specify a different Amazon S3 bucket or use a separate path in the same bucket (for example, use a log prefix or partitioning). This helps you keep track of which log files are associated with which logging subscription and prevents log files from overwriting each other. For more information, see Standard logging (access logs) in the Amazon CloudFront Developer Guide.

" }, "Method":{ "type":"string", @@ -8386,6 +9074,10 @@ "shape":"CustomOriginConfig", "documentation":"

Use this type to specify an origin that is not an Amazon S3 bucket, with one exception. If the Amazon S3 bucket is configured with static website hosting, use this type. If the Amazon S3 bucket is not configured with static website hosting, use the S3OriginConfig type instead.

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

The VPC origin configuration.

" + }, "ConnectionAttempts":{ "shape":"integer", "documentation":"

The number of times that CloudFront attempts to connect to the origin. The minimum number is 1, the maximum is 3, and the default (if you don't specify otherwise) is 3.

For a custom origin (including an Amazon S3 bucket that's configured with static website hosting), this value also specifies the number of times that CloudFront attempts to get a response from the origin, in the case of an Origin Response Timeout.

For more information, see Origin Connection Attempts in the Amazon CloudFront Developer Guide.

" @@ -10411,7 +11103,7 @@ }, "Bucket":{ "shape":"string", - "documentation":"

The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com.

" + "documentation":"

The Amazon S3 bucket to store the access logs in, for example, amzn-s3-demo-bucket.s3.amazonaws.com.

" }, "Prefix":{ "shape":"string", @@ -12028,6 +12720,51 @@ "documentation":"

The returned result of the corresponding request.

", "payload":"StreamingDistribution" }, + "UpdateVpcOriginRequest":{ + "type":"structure", + "required":[ + "VpcOriginEndpointConfig", + "Id", + "IfMatch" + ], + "members":{ + "VpcOriginEndpointConfig":{ + "shape":"VpcOriginEndpointConfig", + "documentation":"

The VPC origin endpoint configuration.

", + "locationName":"VpcOriginEndpointConfig", + "xmlNamespace":{"uri":"http://cloudfront.amazonaws.com/doc/2020-05-31/"} + }, + "Id":{ + "shape":"string", + "documentation":"

The VPC origin ID.

", + "location":"uri", + "locationName":"Id" + }, + "IfMatch":{ + "shape":"string", + "documentation":"

The VPC origin to update, if a match occurs.

", + "location":"header", + "locationName":"If-Match" + } + }, + "payload":"VpcOriginEndpointConfig" + }, + "UpdateVpcOriginResult":{ + "type":"structure", + "members":{ + "VpcOrigin":{ + "shape":"VpcOrigin", + "documentation":"

The VPC origin.

" + }, + "ETag":{ + "shape":"string", + "documentation":"

The VPC origin ETag.

", + "location":"header", + "locationName":"ETag" + } + }, + "payload":"VpcOrigin" + }, "ViewerCertificate":{ "type":"structure", "members":{ @@ -12072,6 +12809,175 @@ "redirect-to-https" ] }, + "VpcOrigin":{ + "type":"structure", + "required":[ + "Id", + "Arn", + "Status", + "CreatedTime", + "LastModifiedTime", + "VpcOriginEndpointConfig" + ], + "members":{ + "Id":{ + "shape":"string", + "documentation":"

The VPC origin ID.

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

The VPC origin ARN.

" + }, + "Status":{ + "shape":"string", + "documentation":"

The VPC origin status.

" + }, + "CreatedTime":{ + "shape":"timestamp", + "documentation":"

The VPC origin created time.

" + }, + "LastModifiedTime":{ + "shape":"timestamp", + "documentation":"

The VPC origin last modified time.

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

The VPC origin endpoint configuration.

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

An Amazon CloudFront VPC origin.

" + }, + "VpcOriginConfig":{ + "type":"structure", + "required":["VpcOriginId"], + "members":{ + "VpcOriginId":{ + "shape":"string", + "documentation":"

The VPC origin ID.

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

An Amazon CloudFront VPC origin configuration.

" + }, + "VpcOriginEndpointConfig":{ + "type":"structure", + "required":[ + "Name", + "Arn", + "HTTPPort", + "HTTPSPort", + "OriginProtocolPolicy" + ], + "members":{ + "Name":{ + "shape":"string", + "documentation":"

The name of the CloudFront VPC origin endpoint configuration.

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

The ARN of the CloudFront VPC origin endpoint configuration.

" + }, + "HTTPPort":{ + "shape":"integer", + "documentation":"

The HTTP port for the CloudFront VPC origin endpoint configuration.

" + }, + "HTTPSPort":{ + "shape":"integer", + "documentation":"

The HTTPS port of the CloudFront VPC origin endpoint configuration.

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

The origin protocol policy for the CloudFront VPC origin endpoint configuration.

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

An Amazon CloudFront VPC origin endpoint configuration.

" + }, + "VpcOriginList":{ + "type":"structure", + "required":[ + "Marker", + "MaxItems", + "IsTruncated", + "Quantity" + ], + "members":{ + "Marker":{ + "shape":"string", + "documentation":"

The marker associated with the VPC origins list.

" + }, + "NextMarker":{ + "shape":"string", + "documentation":"

The next marker associated with the VPC origins list.

" + }, + "MaxItems":{ + "shape":"integer", + "documentation":"

The maximum number of items included in the list.

" + }, + "IsTruncated":{ + "shape":"boolean", + "documentation":"

A flag that indicates whether more VPC origins remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more VPC origins in the list.

" + }, + "Quantity":{ + "shape":"integer", + "documentation":"

The number of VPC origins in the list.

" + }, + "Items":{ + "shape":"VpcOriginSummaryList", + "documentation":"

The items of the VPC origins list.

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

A list of CloudFront VPC origins.

" + }, + "VpcOriginSummary":{ + "type":"structure", + "required":[ + "Id", + "Name", + "Status", + "CreatedTime", + "LastModifiedTime", + "Arn", + "OriginEndpointArn" + ], + "members":{ + "Id":{ + "shape":"string", + "documentation":"

The VPC origin summary ID.

" + }, + "Name":{ + "shape":"string", + "documentation":"

The VPC origin summary name.

" + }, + "Status":{ + "shape":"string", + "documentation":"

The VPC origin summary status.

" + }, + "CreatedTime":{ + "shape":"timestamp", + "documentation":"

The VPC origin summary created time.

" + }, + "LastModifiedTime":{ + "shape":"timestamp", + "documentation":"

The VPC origin summary last modified time.

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

The VPC origin summary ARN.

" + }, + "OriginEndpointArn":{ + "shape":"string", + "documentation":"

The VPC origin summary origin endpoint ARN.

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

A summary of the CloudFront VPC origin.

" + }, + "VpcOriginSummaryList":{ + "type":"list", + "member":{ + "shape":"VpcOriginSummary", + "locationName":"VpcOriginSummary" + } + }, "aliasString":{ "type":"string", "max":253, 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 779b6921c7..11bdef413d 100644 --- a/botocore/data/compute-optimizer/2019-11-01/service-2.json +++ b/botocore/data/compute-optimizer/2019-11-01/service-2.json @@ -135,6 +135,26 @@ ], "documentation":"

Exports optimization recommendations for Amazon ECS services on Fargate.

Recommendations are exported in a CSV file, and its metadata in a 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 only have one Amazon ECS service export job in progress per Amazon Web Services Region.

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

Export optimization recommendations for your idle resources.

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 idle resource export job in progress per Amazon Web Services Region.

" + }, "ExportLambdaFunctionRecommendations":{ "name":"ExportLambdaFunctionRecommendations", "http":{ @@ -371,6 +391,26 @@ ], "documentation":"

Returns the Compute Optimizer enrollment (opt-in) status of organization member accounts, if your account is an organization management account.

To get the enrollment status of standalone accounts, use the GetEnrollmentStatus action.

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

Returns idle resource recommendations. Compute Optimizer generates recommendations for idle resources that meet a specific set of requirements. For more information, see Resource requirements in the Compute Optimizer User Guide

" + }, "GetLambdaFunctionRecommendations":{ "name":"GetLambdaFunctionRecommendations", "http":{ @@ -875,6 +915,7 @@ "P99_5" ] }, + "DBClusterIdentifier":{"type":"string"}, "DBInstanceClass":{"type":"string"}, "DBStorageConfiguration":{ "type":"structure", @@ -966,6 +1007,13 @@ "DestinationBucket":{"type":"string"}, "DestinationKey":{"type":"string"}, "DestinationKeyPrefix":{"type":"string"}, + "Dimension":{ + "type":"string", + "enum":[ + "SavingsValue", + "SavingsValueAfterDiscount" + ] + }, "EBSEffectiveRecommendationPreferences":{ "type":"structure", "members":{ @@ -1682,6 +1730,43 @@ "s3Destination":{"shape":"S3Destination"} } }, + "ExportIdleRecommendationsRequest":{ + "type":"structure", + "required":["s3DestinationConfig"], + "members":{ + "accountIds":{ + "shape":"AccountIds", + "documentation":"

The Amazon Web Services account IDs for the export idle resource 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":"IdleRecommendationFilters", + "documentation":"

An array of objects to specify a filter that exports a more specific set of idle resource recommendations.

" + }, + "fieldsToExport":{ + "shape":"ExportableIdleFields", + "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.

" + } + } + }, + "ExportIdleRecommendationsResponse":{ + "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"} + } + }, "ExportLambdaFunctionRecommendationsRequest":{ "type":"structure", "required":["s3DestinationConfig"], @@ -1906,6 +1991,35 @@ "type":"list", "member":{"shape":"ExportableECSServiceField"} }, + "ExportableIdleField":{ + "type":"string", + "enum":[ + "AccountId", + "ResourceArn", + "ResourceId", + "ResourceType", + "LastRefreshTimestamp", + "LookbackPeriodInDays", + "SavingsOpportunity", + "SavingsOpportunityAfterDiscount", + "UtilizationMetricsCpuMaximum", + "UtilizationMetricsMemoryMaximum", + "UtilizationMetricsNetworkOutBytesPerSecondMaximum", + "UtilizationMetricsNetworkInBytesPerSecondMaximum", + "UtilizationMetricsDatabaseConnectionsMaximum", + "UtilizationMetricsEBSVolumeReadIOPSMaximum", + "UtilizationMetricsEBSVolumeWriteIOPSMaximum", + "UtilizationMetricsVolumeReadOpsPerSecondMaximum", + "UtilizationMetricsVolumeWriteOpsPerSecondMaximum", + "Finding", + "FindingDescription", + "Tags" + ] + }, + "ExportableIdleFields":{ + "type":"list", + "member":{"shape":"ExportableIdleField"} + }, "ExportableInstanceField":{ "type":"string", "enum":[ @@ -2074,6 +2188,7 @@ "CurrentInstanceOnDemandHourlyPrice", "CurrentStorageOnDemandMonthlyPrice", "LookbackPeriodInDays", + "CurrentInstancePerformanceRisk", "UtilizationMetricsCpuMaximum", "UtilizationMetricsMemoryMaximum", "UtilizationMetricsEBSVolumeStorageSpaceUtilizationMaximum", @@ -2084,6 +2199,14 @@ "UtilizationMetricsEBSVolumeReadThroughputMaximum", "UtilizationMetricsEBSVolumeWriteThroughputMaximum", "UtilizationMetricsDatabaseConnectionsMaximum", + "UtilizationMetricsStorageNetworkReceiveThroughputMaximum", + "UtilizationMetricsStorageNetworkTransmitThroughputMaximum", + "UtilizationMetricsAuroraMemoryHealthStateMaximum", + "UtilizationMetricsAuroraMemoryNumDeclinedSqlTotalMaximum", + "UtilizationMetricsAuroraMemoryNumKillConnTotalMaximum", + "UtilizationMetricsAuroraMemoryNumKillQueryTotalMaximum", + "UtilizationMetricsReadIOPSEphemeralStorageMaximum", + "UtilizationMetricsWriteIOPSEphemeralStorageMaximum", "InstanceFinding", "InstanceFindingReasonCodes", "StorageFinding", @@ -2117,7 +2240,9 @@ "EffectiveRecommendationPreferencesLookBackPeriod", "EffectiveRecommendationPreferencesSavingsEstimationMode", "LastRefreshTimestamp", - "Tags" + "Tags", + "DBClusterIdentifier", + "PromotionTier" ] }, "ExportableRDSDBFields":{ @@ -2633,6 +2758,52 @@ } } }, + "GetIdleRecommendationsRequest":{ + "type":"structure", + "members":{ + "resourceArns":{ + "shape":"ResourceArns", + "documentation":"

The ARN that identifies the idle resource.

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

The token to advance to the next page of idle resource recommendations.

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

The maximum number of idle resource recommendations to return with a single request.

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

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

An array of objects to specify a filter that returns a more specific list of idle resource recommendations.

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

Return the idle resource 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 idle resource recommendations to specific member accounts.

You can only specify one account ID per request.

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

The order to sort the idle resource recommendations.

" + } + } + }, + "GetIdleRecommendationsResponse":{ + "type":"structure", + "members":{ + "nextToken":{ + "shape":"NextToken", + "documentation":"

The token to advance to the next page of idle resource recommendations.

" + }, + "idleRecommendations":{ + "shape":"IdleRecommendations", + "documentation":"

An array of objects that describe the idle resource recommendations.

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

An array of objects that describe errors of the request.

" + } + } + }, "GetLambdaFunctionRecommendationsRequest":{ "type":"structure", "members":{ @@ -2924,6 +3095,235 @@ "False" ] }, + "IdleEstimatedMonthlySavings":{ + "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 Idle resources.

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

Describes the estimated monthly savings possible for idle resources by adopting Compute Optimizer recommendations.

" + }, + "IdleFinding":{ + "type":"string", + "enum":[ + "Idle", + "Unattached" + ] + }, + "IdleFindingDescription":{"type":"string"}, + "IdleMaxResults":{ + "type":"integer", + "box":true, + "max":100, + "min":0 + }, + "IdleMetricName":{ + "type":"string", + "enum":[ + "CPU", + "Memory", + "NetworkOutBytesPerSecond", + "NetworkInBytesPerSecond", + "DatabaseConnections", + "EBSVolumeReadIOPS", + "EBSVolumeWriteIOPS", + "VolumeReadOpsPerSecond", + "VolumeWriteOpsPerSecond" + ] + }, + "IdleRecommendation":{ + "type":"structure", + "members":{ + "resourceArn":{ + "shape":"ResourceArn", + "documentation":"

The ARN of the current idle resource.

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

The unique identifier for the resource.

" + }, + "resourceType":{ + "shape":"IdleRecommendationResourceType", + "documentation":"

The type of resource that is idle.

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

The Amazon Web Services account ID of the idle resource.

" + }, + "finding":{ + "shape":"IdleFinding", + "documentation":"

The finding classification of an idle resource.

" + }, + "findingDescription":{ + "shape":"IdleFindingDescription", + "documentation":"

A summary of the findings for the resource.

" + }, + "savingsOpportunity":{ + "shape":"IdleSavingsOpportunity", + "documentation":"

The savings opportunity for the idle resource.

" + }, + "savingsOpportunityAfterDiscounts":{ + "shape":"IdleSavingsOpportunityAfterDiscounts", + "documentation":"

The savings opportunity for the idle resource after any applying discounts.

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

An array of objects that describe the utilization metrics of the idle resource.

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

The number of days the idle resource utilization metrics were analyzed.

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

The timestamp of when the idle resource recommendation was last generated.

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

A list of tags assigned to your idle resource recommendations.

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

Describes an Idle resource recommendation.

" + }, + "IdleRecommendationError":{ + "type":"structure", + "members":{ + "identifier":{ + "shape":"Identifier", + "documentation":"

The ID of the error.

" + }, + "code":{ + "shape":"Code", + "documentation":"

The error code.

" + }, + "message":{ + "shape":"Message", + "documentation":"

The error message.

" + }, + "resourceType":{ + "shape":"IdleRecommendationResourceType", + "documentation":"

The type of resource associated with the error.

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

Returns of list of resources that doesn't have idle recommendations.

" + }, + "IdleRecommendationErrors":{ + "type":"list", + "member":{"shape":"IdleRecommendationError"} + }, + "IdleRecommendationFilter":{ + "type":"structure", + "members":{ + "name":{ + "shape":"IdleRecommendationFilterName", + "documentation":"

The name of the filter.

Specify Finding to return recommendations with a specific finding classification.

You can filter your idle resource recommendations by tag:key and tag-key tags.

A tag:key is a key and value combination of a tag assigned to your idle resource recommendations. Use the tag key in the filter name and the tag value as the filter value. For example, to find all idle resource 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 idle resource recommendations. Use this filter to find all of your idle resource recommendations that have a tag with a specific key. This doesn’t consider the tag value. For example, you can find your idle resource 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 idle resource recommendations.

" + }, + "IdleRecommendationFilterName":{ + "type":"string", + "enum":[ + "Finding", + "ResourceType" + ] + }, + "IdleRecommendationFilters":{ + "type":"list", + "member":{"shape":"IdleRecommendationFilter"} + }, + "IdleRecommendationResourceType":{ + "type":"string", + "enum":[ + "EC2Instance", + "AutoScalingGroup", + "EBSVolume", + "ECSService", + "RDSDBInstance" + ] + }, + "IdleRecommendations":{ + "type":"list", + "member":{"shape":"IdleRecommendation"} + }, + "IdleSavingsOpportunity":{ + "type":"structure", + "members":{ + "savingsOpportunityPercentage":{ + "shape":"SavingsOpportunityPercentage", + "documentation":"

The estimated monthly savings possible as a percentage of monthly cost by adopting Compute Optimizer's idle resource recommendations.

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

The estimated monthly savings possible by adopting Compute Optimizer's idle resource recommendations.

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

Describes the savings opportunity for idle resource recommendations.

" + }, + "IdleSavingsOpportunityAfterDiscounts":{ + "type":"structure", + "members":{ + "savingsOpportunityPercentage":{ + "shape":"SavingsOpportunityPercentage", + "documentation":"

The estimated monthly savings possible as a percentage of monthly cost by adopting Compute Optimizer's idle resource recommendations. This includes any applicable discounts.

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

The estimated monthly savings possible by adopting Compute Optimizer's idle resource recommendations. This includes any applicable discounts.

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

Describes the savings opportunity for idle resource recommendations after applying discounts.

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

" + }, + "IdleSummaries":{ + "type":"list", + "member":{"shape":"IdleSummary"} + }, + "IdleSummary":{ + "type":"structure", + "members":{ + "name":{ + "shape":"IdleFinding", + "documentation":"

The name of the finding group for the idle resources.

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

The count of idle resources in the finding group.

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

Describes the findings summary of the idle resources.

" + }, + "IdleUtilizationMetric":{ + "type":"structure", + "members":{ + "name":{ + "shape":"IdleMetricName", + "documentation":"

The name of the utilization metric.

" + }, + "statistic":{ + "shape":"MetricStatistic", + "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 idle resource.

" + }, + "IdleUtilizationMetrics":{ + "type":"list", + "member":{"shape":"IdleUtilizationMetric"} + }, "IncludeMemberAccounts":{"type":"boolean"}, "InferredWorkloadSaving":{ "type":"structure", @@ -3843,6 +4243,27 @@ "exception":true, "synthetic":true }, + "Order":{ + "type":"string", + "enum":[ + "Asc", + "Desc" + ] + }, + "OrderBy":{ + "type":"structure", + "members":{ + "dimension":{ + "shape":"Dimension", + "documentation":"

The dimension values to sort the recommendations.

" + }, + "order":{ + "shape":"Order", + "documentation":"

The order to sort the recommendations.

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

Describes how the recommendations are ordered.

" + }, "PerformanceRisk":{ "type":"double", "max":4, @@ -3921,6 +4342,7 @@ "type":"list", "member":{"shape":"UtilizationMetric"} }, + "PromotionTier":{"type":"integer"}, "PutRecommendationPreferencesRequest":{ "type":"structure", "required":["resourceType"], @@ -3968,6 +4390,15 @@ "members":{ } }, + "RDSCurrentInstancePerformanceRisk":{ + "type":"string", + "enum":[ + "VeryLow", + "Low", + "Medium", + "High" + ] + }, "RDSDBInstanceRecommendationOption":{ "type":"structure", "members":{ @@ -4011,7 +4442,15 @@ "EBSVolumeWriteIOPS", "EBSVolumeReadThroughput", "EBSVolumeWriteThroughput", - "DatabaseConnections" + "DatabaseConnections", + "StorageNetworkReceiveThroughput", + "StorageNetworkTransmitThroughput", + "AuroraMemoryHealthState", + "AuroraMemoryNumDeclinedSql", + "AuroraMemoryNumKillConnTotal", + "AuroraMemoryNumKillQueryTotal", + "ReadIOPSEphemeralStorage", + "WriteIOPSEphemeralStorage" ] }, "RDSDBMetricStatistic":{ @@ -4045,6 +4484,10 @@ "shape":"EngineVersion", "documentation":"

The database engine version.

" }, + "promotionTier":{ + "shape":"PromotionTier", + "documentation":"

The promotion tier for the Aurora instance.

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

The DB instance class of the current RDS instance.

" @@ -4053,6 +4496,10 @@ "shape":"DBStorageConfiguration", "documentation":"

The configuration of the current RDS storage.

" }, + "dbClusterIdentifier":{ + "shape":"DBClusterIdentifier", + "documentation":"

The identifier for DB cluster.

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

This indicates if the RDS instance is idle or not.

" @@ -4069,6 +4516,10 @@ "shape":"RDSInstanceFindingReasonCodes", "documentation":"

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

" }, + "currentInstancePerformanceRisk":{ + "shape":"RDSCurrentInstancePerformanceRisk", + "documentation":"

The performance risk for the current DB instance.

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

The reason for the finding classification of Amazon RDS storage.

" @@ -4275,12 +4726,17 @@ "CPUOverprovisioned", "NetworkBandwidthOverprovisioned", "EBSIOPSOverprovisioned", + "EBSIOPSUnderprovisioned", "EBSThroughputOverprovisioned", "CPUUnderprovisioned", "NetworkBandwidthUnderprovisioned", "EBSThroughputUnderprovisioned", "NewGenerationDBInstanceClassAvailable", - "NewEngineVersionAvailable" + "NewEngineVersionAvailable", + "DBClusterWriterUnderprovisioned", + "MemoryUnderprovisioned", + "InstanceStorageReadIOPSUnderprovisioned", + "InstanceStorageWriteIOPSUnderprovisioned" ] }, "RDSInstanceFindingReasonCodes":{ @@ -4544,6 +5000,10 @@ "shape":"Summaries", "documentation":"

An array of objects that describe a recommendation summary.

" }, + "idleSummaries":{ + "shape":"IdleSummaries", + "documentation":"

Describes the findings summary of the idle resources.

" + }, "recommendationResourceType":{ "shape":"RecommendationSourceType", "documentation":"

The resource type that the recommendation summary applies to.

" @@ -4556,6 +5016,8 @@ "shape":"SavingsOpportunity", "documentation":"

An object that describes the savings opportunity for a given resource type. Savings opportunity includes the estimated monthly savings amount and percentage.

" }, + "idleSavingsOpportunity":{"shape":"SavingsOpportunity"}, + "aggregatedSavingsOpportunity":{"shape":"SavingsOpportunity"}, "currentPerformanceRiskRatings":{ "shape":"CurrentPerformanceRiskRatings", "documentation":"

An object that describes the performance risk ratings for a given resource type.

" @@ -4596,6 +5058,7 @@ "type":"list", "member":{"shape":"ResourceArn"} }, + "ResourceId":{"type":"string"}, "ResourceNotFoundException":{ "type":"structure", "members":{ @@ -4615,7 +5078,8 @@ "NotApplicable", "EcsService", "License", - "RdsDBInstance" + "RdsDBInstance", + "Idle" ] }, "RootVolume":{"type":"boolean"}, @@ -4890,7 +5354,7 @@ "members":{ "volumeType":{ "shape":"VolumeType", - "documentation":"

The volume type.

This can be gp2 for General Purpose SSD, io1 or io2 for Provisioned IOPS SSD, st1 for Throughput Optimized HDD, sc1 for Cold HDD, or standard for Magnetic volumes.

" + "documentation":"

The volume type.

The volume types can be the following:

" }, "volumeSize":{ "shape":"VolumeSize", diff --git a/botocore/data/controltower/2018-05-10/service-2.json b/botocore/data/controltower/2018-05-10/service-2.json index 386edf6b9d..e14e24a113 100644 --- a/botocore/data/controltower/2018-05-10/service-2.json +++ b/botocore/data/controltower/2018-05-10/service-2.json @@ -632,6 +632,10 @@ "type":"list", "member":{"shape":"BaselineSummary"} }, + "Boolean":{ + "type":"boolean", + "box":true + }, "ConflictException":{ "type":"structure", "required":["message"], @@ -1053,6 +1057,10 @@ "shape":"EnabledBaselineParameterSummaries", "documentation":"

Shows the parameters that are applied when enabling this Baseline.

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

An ARN that represents the parent EnabledBaseline at the Organizational Unit (OU) level, from which the child EnabledBaseline inherits its configuration. The value is returned by GetEnabledBaseline.

" + }, "statusSummary":{"shape":"EnablementStatusSummary"}, "targetIdentifier":{ "shape":"String", @@ -1068,6 +1076,10 @@ "shape":"EnabledBaselineBaselineIdentifiers", "documentation":"

Identifiers for the Baseline objects returned as part of the filter operation.

" }, + "parentIdentifiers":{ + "shape":"EnabledBaselineParentIdentifiers", + "documentation":"

An optional filter that sets up a list of parentIdentifiers to filter the results of the ListEnabledBaseline output.

" + }, "targetIdentifiers":{ "shape":"EnabledBaselineTargetIdentifiers", "documentation":"

Identifiers for the targets of the Baseline filter operation.

" @@ -1125,6 +1137,12 @@ "type":"list", "member":{"shape":"EnabledBaselineParameter"} }, + "EnabledBaselineParentIdentifiers":{ + "type":"list", + "member":{"shape":"Arn"}, + "max":5, + "min":1 + }, "EnabledBaselineSummary":{ "type":"structure", "required":[ @@ -1146,6 +1164,10 @@ "shape":"String", "documentation":"

The enabled version of the baseline.

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

An ARN that represents an object returned by ListEnabledBaseline, to describe an enabled baseline.

" + }, "statusSummary":{"shape":"EnablementStatusSummary"}, "targetIdentifier":{ "shape":"String", @@ -1741,6 +1763,10 @@ "shape":"EnabledBaselineFilter", "documentation":"

A filter applied on the ListEnabledBaseline operation. Allowed filters are baselineIdentifiers and targetIdentifiers. The filter can be applied for either, or both.

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

A value that can be set to include the child enabled baselines in responses. The default value is false.

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

The maximum number of results to be shown.

" 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 b66cf10f53..08c7a9f946 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 @@ -183,7 +183,8 @@ "Upgrade", "PurchaseSavingsPlans", "PurchaseReservedInstances", - "MigrateToGraviton" + "MigrateToGraviton", + "Delete" ] }, "ActionTypeList":{ diff --git a/botocore/data/datazone/2018-05-10/paginators-1.json b/botocore/data/datazone/2018-05-10/paginators-1.json index 2899e839b1..7b8bc81c41 100644 --- a/botocore/data/datazone/2018-05-10/paginators-1.json +++ b/botocore/data/datazone/2018-05-10/paginators-1.json @@ -179,6 +179,12 @@ "output_token": "nextToken", "limit_key": "maxResults", "result_key": "grantList" + }, + "ListRules": { + "input_token": "nextToken", + "output_token": "nextToken", + "limit_key": "maxResults", + "result_key": "items" } } } diff --git a/botocore/data/datazone/2018-05-10/service-2.json b/botocore/data/datazone/2018-05-10/service-2.json index 8ccd2c3b71..461a935b90 100644 --- a/botocore/data/datazone/2018-05-10/service-2.json +++ b/botocore/data/datazone/2018-05-10/service-2.json @@ -556,6 +556,28 @@ ], "documentation":"

Creates a project membership in Amazon DataZone.

" }, + "CreateRule":{ + "name":"CreateRule", + "http":{ + "method":"POST", + "requestUri":"/v2/domains/{domainIdentifier}/rules", + "responseCode":201 + }, + "input":{"shape":"CreateRuleInput"}, + "output":{"shape":"CreateRuleOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ServiceQuotaExceededException"}, + {"shape":"ConflictException"}, + {"shape":"ValidationException"}, + {"shape":"UnauthorizedException"} + ], + "documentation":"

Creates a rule in Amazon DataZone. A rule is a formal agreement that enforces specific requirements across user workflows (e.g., publishing assets to the catalog, requesting subscriptions, creating projects) within the Amazon DataZone data portal. These rules help maintain consistency, ensure compliance, and uphold governance standards in data management processes. For instance, a metadata enforcement rule can specify the required information for creating a subscription request or publishing a data asset to the catalog, ensuring alignment with organizational standards.

", + "idempotent":true + }, "CreateSubscriptionGrant":{ "name":"CreateSubscriptionGrant", "http":{ @@ -983,6 +1005,27 @@ "documentation":"

Deletes project membership in Amazon DataZone.

", "idempotent":true }, + "DeleteRule":{ + "name":"DeleteRule", + "http":{ + "method":"DELETE", + "requestUri":"/v2/domains/{domainIdentifier}/rules/{identifier}", + "responseCode":204 + }, + "input":{"shape":"DeleteRuleInput"}, + "output":{"shape":"DeleteRuleOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ConflictException"}, + {"shape":"ValidationException"}, + {"shape":"UnauthorizedException"} + ], + "documentation":"

Deletes a rule in Amazon DataZone. A rule is a formal agreement that enforces specific requirements across user workflows (e.g., publishing assets to the catalog, requesting subscriptions, creating projects) within the Amazon DataZone data portal. These rules help maintain consistency, ensure compliance, and uphold governance standards in data management processes. For instance, a metadata enforcement rule can specify the required information for creating a subscription request or publishing a data asset to the catalog, ensuring alignment with organizational standards.

", + "idempotent":true + }, "DeleteSubscriptionGrant":{ "name":"DeleteSubscriptionGrant", "http":{ @@ -1524,6 +1567,25 @@ ], "documentation":"

Gets a project in Amazon DataZone.

" }, + "GetRule":{ + "name":"GetRule", + "http":{ + "method":"GET", + "requestUri":"/v2/domains/{domainIdentifier}/rules/{identifier}", + "responseCode":200 + }, + "input":{"shape":"GetRuleInput"}, + "output":{"shape":"GetRuleOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ValidationException"}, + {"shape":"UnauthorizedException"} + ], + "documentation":"

Gets the details of a rule in Amazon DataZone. A rule is a formal agreement that enforces specific requirements across user workflows (e.g., publishing assets to the catalog, requesting subscriptions, creating projects) within the Amazon DataZone data portal. These rules help maintain consistency, ensure compliance, and uphold governance standards in data management processes. For instance, a metadata enforcement rule can specify the required information for creating a subscription request or publishing a data asset to the catalog, ensuring alignment with organizational standards.

" + }, "GetSubscription":{ "name":"GetSubscription", "http":{ @@ -2019,6 +2081,25 @@ ], "documentation":"

Lists Amazon DataZone projects.

" }, + "ListRules":{ + "name":"ListRules", + "http":{ + "method":"GET", + "requestUri":"/v2/domains/{domainIdentifier}/list-rules/{targetType}/{targetIdentifier}", + "responseCode":200 + }, + "input":{"shape":"ListRulesInput"}, + "output":{"shape":"ListRulesOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ValidationException"}, + {"shape":"UnauthorizedException"} + ], + "documentation":"

Lists existing rules. In Amazon DataZone, a rule is a formal agreement that enforces specific requirements across user workflows (e.g., publishing assets to the catalog, requesting subscriptions, creating projects) within the Amazon DataZone data portal. These rules help maintain consistency, ensure compliance, and uphold governance standards in data management processes. For instance, a metadata enforcement rule can specify the required information for creating a subscription request or publishing a data asset to the catalog, ensuring alignment with organizational standards.

" + }, "ListSubscriptionGrants":{ "name":"ListSubscriptionGrants", "http":{ @@ -2704,6 +2785,28 @@ "documentation":"

Updates the specified project in Amazon DataZone.

", "idempotent":true }, + "UpdateRule":{ + "name":"UpdateRule", + "http":{ + "method":"PATCH", + "requestUri":"/v2/domains/{domainIdentifier}/rules/{identifier}", + "responseCode":200 + }, + "input":{"shape":"UpdateRuleInput"}, + "output":{"shape":"UpdateRuleOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ServiceQuotaExceededException"}, + {"shape":"ConflictException"}, + {"shape":"ValidationException"}, + {"shape":"UnauthorizedException"} + ], + "documentation":"

Updates a rule. In Amazon DataZone, a rule is a formal agreement that enforces specific requirements across user workflows (e.g., publishing assets to the catalog, requesting subscriptions, creating projects) within the Amazon DataZone data portal. These rules help maintain consistency, ensure compliance, and uphold governance standards in data management processes. For instance, a metadata enforcement rule can specify the required information for creating a subscription request or publishing a data asset to the catalog, ensuring alignment with organizational standards.

", + "idempotent":true + }, "UpdateSubscriptionGrantStatus":{ "name":"UpdateSubscriptionGrantStatus", "http":{ @@ -2953,10 +3056,18 @@ "shape":"DomainId", "documentation":"

The unique identifier of the Amazon DataZone domain where the specified subscription request was accepted.

" }, + "existingSubscriptionId":{ + "shape":"SubscriptionId", + "documentation":"

The ID of the existing subscription.

" + }, "id":{ "shape":"SubscriptionRequestId", "documentation":"

The identifier of the subscription request.

" }, + "metadataForms":{ + "shape":"MetadataForms", + "documentation":"

The metadata form in the subscription request.

" + }, "requestReason":{ "shape":"RequestReason", "documentation":"

Specifies the reason for requesting a subscription to the asset.

" @@ -3579,6 +3690,10 @@ "min":1, "pattern":"^(?!\\.)[\\w\\.]*\\w$" }, + "AssetTypeIdentifiers":{ + "type":"list", + "member":{"shape":"AssetTypeIdentifier"} + }, "AssetTypeItem":{ "type":"structure", "required":[ @@ -3640,6 +3755,21 @@ }, "documentation":"

The details of the asset type.

" }, + "AssetTypesForRule":{ + "type":"structure", + "required":["selectionMode"], + "members":{ + "selectionMode":{ + "shape":"RuleScopeSelectionMode", + "documentation":"

The selection mode for the rule.

" + }, + "specificAssetTypes":{ + "shape":"RuleAssetTypeList", + "documentation":"

The specific asset types that are included in the rule.

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

The asset type for the rule details.

" + }, "AssociateEnvironmentRoleInput":{ "type":"structure", "required":[ @@ -5816,6 +5946,114 @@ }, "documentation":"

The details of the policy grant.

" }, + "CreateRuleInput":{ + "type":"structure", + "required":[ + "action", + "detail", + "domainIdentifier", + "name", + "scope", + "target" + ], + "members":{ + "action":{ + "shape":"RuleAction", + "documentation":"

The action of the rule.

" + }, + "clientToken":{ + "shape":"ClientToken", + "documentation":"

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

", + "idempotencyToken":true + }, + "description":{ + "shape":"Description", + "documentation":"

The description of the rule.

" + }, + "detail":{ + "shape":"RuleDetail", + "documentation":"

The detail of the rule.

" + }, + "domainIdentifier":{ + "shape":"DomainId", + "documentation":"

The ID of the domain where the rule is created.

", + "location":"uri", + "locationName":"domainIdentifier" + }, + "name":{ + "shape":"RuleName", + "documentation":"

The name of the rule.

" + }, + "scope":{ + "shape":"RuleScope", + "documentation":"

The scope of the rule.

" + }, + "target":{ + "shape":"RuleTarget", + "documentation":"

The target of the rule.

" + } + } + }, + "CreateRuleOutput":{ + "type":"structure", + "required":[ + "action", + "createdAt", + "createdBy", + "detail", + "identifier", + "name", + "ruleType", + "scope", + "target" + ], + "members":{ + "action":{ + "shape":"RuleAction", + "documentation":"

The action of the rule.

" + }, + "createdAt":{ + "shape":"CreatedAt", + "documentation":"

The timestamp at which the rule is created.

" + }, + "createdBy":{ + "shape":"CreatedBy", + "documentation":"

The user who creates the rule.

" + }, + "description":{ + "shape":"Description", + "documentation":"

The description of the rule.

" + }, + "detail":{ + "shape":"RuleDetail", + "documentation":"

The detail of the rule.

" + }, + "identifier":{ + "shape":"RuleId", + "documentation":"

The ID of the rule.

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

The name of the rule.

" + }, + "ruleType":{ + "shape":"RuleType", + "documentation":"

The type of the rule.

" + }, + "scope":{ + "shape":"RuleScope", + "documentation":"

The scope of the rule.

" + }, + "target":{ + "shape":"RuleTarget", + "documentation":"

The target of the rule.

" + }, + "targetType":{ + "shape":"RuleTargetType", + "documentation":"

The target type of the rule.

" + } + } + }, "CreateSubscriptionGrantInput":{ "type":"structure", "required":[ @@ -5935,6 +6173,10 @@ "location":"uri", "locationName":"domainIdentifier" }, + "metadataForms":{ + "shape":"MetadataFormInputs", + "documentation":"

The metadata form included in the subscription request.

" + }, "requestReason":{ "shape":"RequestReason", "documentation":"

The reason for the subscription request.

" @@ -5979,10 +6221,18 @@ "shape":"DomainId", "documentation":"

The ID of the Amazon DataZone domain in whcih the subscription request is created.

" }, + "existingSubscriptionId":{ + "shape":"SubscriptionId", + "documentation":"

The ID of the existing subscription.

" + }, "id":{ "shape":"SubscriptionRequestId", "documentation":"

The ID of the subscription request.

" }, + "metadataForms":{ + "shape":"MetadataForms", + "documentation":"

The metadata form included in the subscription request.

" + }, "requestReason":{ "shape":"RequestReason", "documentation":"

The reason for the subscription request.

" @@ -7380,6 +7630,32 @@ "members":{ } }, + "DeleteRuleInput":{ + "type":"structure", + "required":[ + "domainIdentifier", + "identifier" + ], + "members":{ + "domainIdentifier":{ + "shape":"DomainId", + "documentation":"

The ID of the domain that where the rule is to be deleted.

", + "location":"uri", + "locationName":"domainIdentifier" + }, + "identifier":{ + "shape":"RuleId", + "documentation":"

The ID of the rule that is to be deleted.

", + "location":"uri", + "locationName":"identifier" + } + } + }, + "DeleteRuleOutput":{ + "type":"structure", + "members":{ + } + }, "DeleteSubscriptionGrantInput":{ "type":"structure", "required":[ @@ -7896,6 +8172,21 @@ }, "documentation":"

The summary of the domain unit.

" }, + "DomainUnitTarget":{ + "type":"structure", + "required":["domainUnitId"], + "members":{ + "domainUnitId":{ + "shape":"DomainUnitId", + "documentation":"

The ID of the domain unit.

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

Specifies whether to apply a rule to the child domain units.

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

The target for the domain unit.

" + }, "DomainUnitUserProperties":{ "type":"structure", "members":{ @@ -8514,7 +8805,7 @@ "documentation":"

The ID of the metadata form type.

" }, "typeRevision":{ - "shape":"Revision", + "shape":"RevisionInput", "documentation":"

The revision of the metadata form type.

" } }, @@ -10466,6 +10757,108 @@ } } }, + "GetRuleInput":{ + "type":"structure", + "required":[ + "domainIdentifier", + "identifier" + ], + "members":{ + "domainIdentifier":{ + "shape":"DomainId", + "documentation":"

The ID of the domain where the GetRule action is to be invoked.

", + "location":"uri", + "locationName":"domainIdentifier" + }, + "identifier":{ + "shape":"RuleId", + "documentation":"

The ID of the rule.

", + "location":"uri", + "locationName":"identifier" + }, + "revision":{ + "shape":"Revision", + "documentation":"

The revision of the rule.

", + "location":"querystring", + "locationName":"revision" + } + } + }, + "GetRuleOutput":{ + "type":"structure", + "required":[ + "action", + "createdAt", + "createdBy", + "detail", + "identifier", + "lastUpdatedBy", + "name", + "revision", + "ruleType", + "scope", + "target", + "updatedAt" + ], + "members":{ + "action":{ + "shape":"RuleAction", + "documentation":"

The action of the rule.

" + }, + "createdAt":{ + "shape":"CreatedAt", + "documentation":"

The timestamp at which the rule was created.

" + }, + "createdBy":{ + "shape":"CreatedBy", + "documentation":"

The user who created the rule.

" + }, + "description":{ + "shape":"Description", + "documentation":"

The description of the rule.

" + }, + "detail":{ + "shape":"RuleDetail", + "documentation":"

The detail of the rule.

" + }, + "identifier":{ + "shape":"RuleId", + "documentation":"

The ID of the rule.

" + }, + "lastUpdatedBy":{ + "shape":"UpdatedBy", + "documentation":"

The timestamp at which the rule was last updated.

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

The name of the rule.

" + }, + "revision":{ + "shape":"Revision", + "documentation":"

The revision of the rule.

" + }, + "ruleType":{ + "shape":"RuleType", + "documentation":"

The type of the rule.

" + }, + "scope":{ + "shape":"RuleScope", + "documentation":"

The scope of the rule.

" + }, + "target":{ + "shape":"RuleTarget", + "documentation":"

The target of the rule.

" + }, + "targetType":{ + "shape":"RuleTargetType", + "documentation":"

The target type of the rule.

" + }, + "updatedAt":{ + "shape":"UpdatedAt", + "documentation":"

The timestamp at which the rule was last updated.

" + } + } + }, "GetSubscriptionGrantInput":{ "type":"structure", "required":[ @@ -10679,10 +11072,18 @@ "shape":"DomainId", "documentation":"

The Amazon DataZone domain of the subscription request.

" }, - "id":{ + "existingSubscriptionId":{ + "shape":"SubscriptionId", + "documentation":"

The ID of the existing subscription.

" + }, + "id":{ "shape":"SubscriptionRequestId", "documentation":"

The identifier of the subscription request.

" }, + "metadataForms":{ + "shape":"MetadataForms", + "documentation":"

The metadata forms included in the subscription request.

" + }, "requestReason":{ "shape":"RequestReason", "documentation":"

The reason for the subscription request.

" @@ -12774,6 +13175,102 @@ } } }, + "ListRulesInput":{ + "type":"structure", + "required":[ + "domainIdentifier", + "targetIdentifier", + "targetType" + ], + "members":{ + "action":{ + "shape":"RuleAction", + "documentation":"

The action of the rule.

", + "location":"querystring", + "locationName":"ruleAction" + }, + "assetTypes":{ + "shape":"AssetTypeIdentifiers", + "documentation":"

The asset types of the rule.

", + "location":"querystring", + "locationName":"assetTypes" + }, + "dataProduct":{ + "shape":"Boolean", + "documentation":"

The data product of the rule.

", + "location":"querystring", + "locationName":"dataProduct" + }, + "domainIdentifier":{ + "shape":"DomainId", + "documentation":"

The ID of the domain in which the rules are to be listed.

", + "location":"uri", + "locationName":"domainIdentifier" + }, + "includeCascaded":{ + "shape":"Boolean", + "documentation":"

Specifies whether to include cascading rules in the results.

", + "location":"querystring", + "locationName":"includeCascaded" + }, + "maxResults":{ + "shape":"ListRulesInputMaxResultsInteger", + "documentation":"

The maximum number of rules to return in a single call to ListRules. When the number of rules to be listed is greater than the value of MaxResults, the response contains a NextToken value that you can use in a subsequent call to ListRules to list the next set of rules.

", + "location":"querystring", + "locationName":"maxResults" + }, + "nextToken":{ + "shape":"PaginationToken", + "documentation":"

When the number of rules is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of rules, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListRules to list the next set of rules.

", + "location":"querystring", + "locationName":"nextToken" + }, + "projectIds":{ + "shape":"ProjectIds", + "documentation":"

The IDs of projects in which rules are to be listed.

", + "location":"querystring", + "locationName":"projectIds" + }, + "ruleType":{ + "shape":"RuleType", + "documentation":"

The type of the rule.

", + "location":"querystring", + "locationName":"ruleType" + }, + "targetIdentifier":{ + "shape":"String", + "documentation":"

The target ID of the rule.

", + "location":"uri", + "locationName":"targetIdentifier" + }, + "targetType":{ + "shape":"RuleTargetType", + "documentation":"

The target type of the rule.

", + "location":"uri", + "locationName":"targetType" + } + } + }, + "ListRulesInputMaxResultsInteger":{ + "type":"integer", + "box":true, + "max":50, + "min":25 + }, + "ListRulesOutput":{ + "type":"structure", + "required":["items"], + "members":{ + "items":{ + "shape":"RuleSummaries", + "documentation":"

The results of the ListRules action.

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

When the number of rules is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of rules, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListRules to list the next set of rules.

" + } + } + }, "ListSubscriptionGrantsInput":{ "type":"structure", "required":["domainIdentifier"], @@ -13342,6 +13839,68 @@ "min":0, "sensitive":true }, + "MetadataFormEnforcementDetail":{ + "type":"structure", + "members":{ + "requiredMetadataForms":{ + "shape":"RequiredMetadataFormList", + "documentation":"

The required metadata forms.

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

The enforcement details of a metadata form.

" + }, + "MetadataFormInputs":{ + "type":"list", + "member":{"shape":"FormInput"} + }, + "MetadataFormReference":{ + "type":"structure", + "required":[ + "typeIdentifier", + "typeRevision" + ], + "members":{ + "typeIdentifier":{ + "shape":"FormTypeIdentifier", + "documentation":"

The type ID of the metadata form reference.

" + }, + "typeRevision":{ + "shape":"Revision", + "documentation":"

The type revision of the metadata form reference.

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

The reference of a metadata form.

" + }, + "MetadataFormSummary":{ + "type":"structure", + "required":[ + "typeName", + "typeRevision" + ], + "members":{ + "formName":{ + "shape":"FormName", + "documentation":"

The form name of the metadata form.

" + }, + "typeName":{ + "shape":"FormTypeName", + "documentation":"

The type name of the metadata form.

" + }, + "typeRevision":{ + "shape":"Revision", + "documentation":"

The type revision of the metadata form.

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

The summary of the metadata form.

" + }, + "MetadataForms":{ + "type":"list", + "member":{"shape":"FormOutput"} + }, + "MetadataFormsSummary":{ + "type":"list", + "member":{"shape":"MetadataFormSummary"} + }, "MetadataGenerationRunIdentifier":{ "type":"string", "pattern":"^[a-zA-Z0-9_-]{1,36}$" @@ -13961,6 +14520,10 @@ "type":"string", "pattern":"^[a-zA-Z0-9_-]{1,36}$" }, + "ProjectIds":{ + "type":"list", + "member":{"shape":"ProjectId"} + }, "ProjectMember":{ "type":"structure", "required":[ @@ -14073,6 +14636,21 @@ }, "documentation":"

The details of a Amazon DataZone project.

" }, + "ProjectsForRule":{ + "type":"structure", + "required":["selectionMode"], + "members":{ + "selectionMode":{ + "shape":"RuleScopeSelectionMode", + "documentation":"

The selection mode of the rule.

" + }, + "specificProjects":{ + "shape":"RuleProjectIdentifierList", + "documentation":"

The specific projects in which the rule is created.

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

Specifies projects in which the rule is created.

" + }, "ProvisioningConfiguration":{ "type":"structure", "members":{ @@ -14516,10 +15094,18 @@ "shape":"DomainId", "documentation":"

The identifier of the Amazon DataZone domain in which the subscription request was rejected.

" }, + "existingSubscriptionId":{ + "shape":"SubscriptionId", + "documentation":"

The ID of the existing subscription.

" + }, "id":{ "shape":"SubscriptionRequestId", "documentation":"

The identifier of the subscription request that was rejected.

" }, + "metadataForms":{ + "shape":"MetadataForms", + "documentation":"

Metadata forms included in the subscription request.

" + }, "requestReason":{ "shape":"RequestReason", "documentation":"

The reason for the subscription request.

" @@ -14692,6 +15278,12 @@ "min":1, "sensitive":true }, + "RequiredMetadataFormList":{ + "type":"list", + "member":{"shape":"MetadataFormReference"}, + "max":5, + "min":1 + }, "Resource":{ "type":"structure", "required":[ @@ -14740,6 +15332,12 @@ "max":64, "min":1 }, + "RevisionInput":{ + "type":"string", + "max":64, + "min":1, + "pattern":"^[a-zA-Z0-9_-]+$" + }, "RevokeSubscriptionInput":{ "type":"structure", "required":[ @@ -14921,6 +15519,136 @@ "type":"list", "member":{"shape":"RowFilter"} }, + "RuleAction":{ + "type":"string", + "enum":["CREATE_SUBSCRIPTION_REQUEST"] + }, + "RuleAssetTypeList":{ + "type":"list", + "member":{"shape":"AssetTypeIdentifier"}, + "min":1 + }, + "RuleDetail":{ + "type":"structure", + "members":{ + "metadataFormEnforcementDetail":{ + "shape":"MetadataFormEnforcementDetail", + "documentation":"

The enforcement detail of the metadata form.

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

The details of a rule.

", + "union":true + }, + "RuleId":{ + "type":"string", + "pattern":"^[a-zA-Z0-9_-]{1,36}$" + }, + "RuleName":{ + "type":"string", + "max":256, + "min":1, + "pattern":"^[\\w -]+$", + "sensitive":true + }, + "RuleProjectIdentifierList":{ + "type":"list", + "member":{"shape":"ProjectId"}, + "min":1 + }, + "RuleScope":{ + "type":"structure", + "members":{ + "assetType":{ + "shape":"AssetTypesForRule", + "documentation":"

The asset type included in the rule scope.

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

The data product included in the rule scope.

" + }, + "project":{ + "shape":"ProjectsForRule", + "documentation":"

The project included in the rule scope.

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

The scope of a rule.

" + }, + "RuleScopeSelectionMode":{ + "type":"string", + "enum":[ + "ALL", + "SPECIFIC" + ] + }, + "RuleSummaries":{ + "type":"list", + "member":{"shape":"RuleSummary"} + }, + "RuleSummary":{ + "type":"structure", + "members":{ + "action":{ + "shape":"RuleAction", + "documentation":"

The action of the rule.

" + }, + "identifier":{ + "shape":"RuleId", + "documentation":"

The ID of the rule.

" + }, + "lastUpdatedBy":{ + "shape":"UpdatedBy", + "documentation":"

The timestamp at which the rule was last updated.

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

The name of the rule.

" + }, + "revision":{ + "shape":"Revision", + "documentation":"

The revision of the rule.

" + }, + "ruleType":{ + "shape":"RuleType", + "documentation":"

The type of the rule.

" + }, + "scope":{ + "shape":"RuleScope", + "documentation":"

The scope of the rule.

" + }, + "target":{ + "shape":"RuleTarget", + "documentation":"

The target of the rule.

" + }, + "targetType":{ + "shape":"RuleTargetType", + "documentation":"

The target type of the rule.

" + }, + "updatedAt":{ + "shape":"UpdatedAt", + "documentation":"

The timestamp at which the rule was last updated.

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

The summary of the rule.

" + }, + "RuleTarget":{ + "type":"structure", + "members":{ + "domainUnitTarget":{ + "shape":"DomainUnitTarget", + "documentation":"

The ID of the domain unit.

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

The target of the rule.

", + "union":true + }, + "RuleTargetType":{ + "type":"string", + "enum":["DOMAIN_UNIT"] + }, + "RuleType":{ + "type":"string", + "enum":["METADATA_FORM_ENFORCEMENT"] + }, "RunStatisticsForAssets":{ "type":"structure", "members":{ @@ -16052,10 +16780,18 @@ "shape":"DomainId", "documentation":"

The identifier of the Amazon DataZone domain in which a subscription request exists.

" }, + "existingSubscriptionId":{ + "shape":"SubscriptionId", + "documentation":"

The ID of the existing subscription.

" + }, "id":{ "shape":"SubscriptionRequestId", "documentation":"

The identifier of the subscription request.

" }, + "metadataFormsSummary":{ + "shape":"MetadataFormsSummary", + "documentation":"

The summary of the metadata forms.

" + }, "requestReason":{ "shape":"RequestReason", "documentation":"

The reason for the subscription request.

" @@ -17704,6 +18440,118 @@ } } }, + "UpdateRuleInput":{ + "type":"structure", + "required":[ + "domainIdentifier", + "identifier" + ], + "members":{ + "description":{ + "shape":"Description", + "documentation":"

The description of the rule.

" + }, + "detail":{ + "shape":"RuleDetail", + "documentation":"

The detail of the rule.

" + }, + "domainIdentifier":{ + "shape":"DomainId", + "documentation":"

The ID of the domain in which a rule is to be updated.

", + "location":"uri", + "locationName":"domainIdentifier" + }, + "identifier":{ + "shape":"RuleId", + "documentation":"

The ID of the rule that is to be updated

", + "location":"uri", + "locationName":"identifier" + }, + "includeChildDomainUnits":{ + "shape":"Boolean", + "documentation":"

Specifies whether to update this rule in the child domain units.

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

The name of the rule.

" + }, + "scope":{ + "shape":"RuleScope", + "documentation":"

The scrope of the rule.

" + } + } + }, + "UpdateRuleOutput":{ + "type":"structure", + "required":[ + "action", + "createdAt", + "createdBy", + "detail", + "identifier", + "lastUpdatedBy", + "name", + "revision", + "ruleType", + "scope", + "target", + "updatedAt" + ], + "members":{ + "action":{ + "shape":"RuleAction", + "documentation":"

The action of the rule.

" + }, + "createdAt":{ + "shape":"CreatedAt", + "documentation":"

The timestamp at which the rule was created.

" + }, + "createdBy":{ + "shape":"CreatedBy", + "documentation":"

The user who created the rule.

" + }, + "description":{ + "shape":"Description", + "documentation":"

The description of the rule.

" + }, + "detail":{ + "shape":"RuleDetail", + "documentation":"

The detail of the rule.

" + }, + "identifier":{ + "shape":"RuleId", + "documentation":"

The ID of the rule.

" + }, + "lastUpdatedBy":{ + "shape":"UpdatedBy", + "documentation":"

The timestamp at which the rule was last updated.

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

The name of the rule.

" + }, + "revision":{ + "shape":"Revision", + "documentation":"

The revision of the rule.

" + }, + "ruleType":{ + "shape":"RuleType", + "documentation":"

The type of the rule.

" + }, + "scope":{ + "shape":"RuleScope", + "documentation":"

The scope of the rule.

" + }, + "target":{ + "shape":"RuleTarget", + "documentation":"

The target of the rule.

" + }, + "updatedAt":{ + "shape":"UpdatedAt", + "documentation":"

The timestamp at which the rule was last updated.

" + } + } + }, "UpdateSubscriptionGrantStatusInput":{ "type":"structure", "required":[ @@ -17862,10 +18710,18 @@ "shape":"DomainId", "documentation":"

The identifier of the Amazon DataZone domain in which a subscription request is to be updated.

" }, + "existingSubscriptionId":{ + "shape":"SubscriptionId", + "documentation":"

The ID of the existing subscription.

" + }, "id":{ "shape":"SubscriptionRequestId", "documentation":"

The identifier of the subscription request that is to be updated.

" }, + "metadataForms":{ + "shape":"MetadataForms", + "documentation":"

Metadata forms included in the subscription request.

" + }, "requestReason":{ "shape":"RequestReason", "documentation":"

The reason for the UpdateSubscriptionRequest action.

" diff --git a/botocore/data/discovery/2015-11-01/service-2.json b/botocore/data/discovery/2015-11-01/service-2.json index 51aea48223..a1346de046 100644 --- a/botocore/data/discovery/2015-11-01/service-2.json +++ b/botocore/data/discovery/2015-11-01/service-2.json @@ -10,7 +10,8 @@ "serviceId":"Application Discovery Service", "signatureVersion":"v4", "targetPrefix":"AWSPoseidonService_V2015_11_01", - "uid":"discovery-2015-11-01" + "uid":"discovery-2015-11-01", + "auth":["aws.auth#sigv4"] }, "operations":{ "AssociateConfigurationItemsToApplication":{ @@ -374,7 +375,8 @@ {"shape":"ServerInternalErrorException"}, {"shape":"HomeRegionNotSetException"}, {"shape":"OperationNotPermittedException"}, - {"shape":"InvalidParameterValueException"} + {"shape":"InvalidParameterValueException"}, + {"shape":"InvalidParameterException"} ], "documentation":"

Takes a list of configurationId as input and starts an asynchronous deletion task to remove the configurationItems. Returns a unique deletion task identifier.

" }, @@ -638,6 +640,12 @@ "max":127, "pattern":"[\\s\\S]*\\S[\\s\\S]*" }, + "ApplicationWave":{ + "type":"string", + "max":256, + "min":0, + "pattern":"^($|[^\\s\\x00]( *[^\\s\\x00])*$)" + }, "AssociateConfigurationItemsToApplicationRequest":{ "type":"structure", "required":[ @@ -970,11 +978,15 @@ "members":{ "name":{ "shape":"ApplicationName", - "documentation":"

Name of the application to be created.

" + "documentation":"

The name of the application to be created.

" }, "description":{ "shape":"ApplicationDescription", - "documentation":"

Description of the application to be created.

" + "documentation":"

The description of the application to be created.

" + }, + "wave":{ + "shape":"ApplicationWave", + "documentation":"

The name of the migration wave of the application to be created.

" } } }, @@ -983,7 +995,7 @@ "members":{ "configurationId":{ "shape":"String", - "documentation":"

Configuration ID of an application to be created.

" + "documentation":"

The configuration ID of an application to be created.

" } } }, @@ -1738,6 +1750,15 @@ "type":"list", "member":{"shape":"FailedConfiguration"} }, + "FileClassification":{ + "type":"string", + "enum":[ + "MODELIZEIT_EXPORT", + "RVTOOLS_EXPORT", + "VMWARE_NSX_EXPORT", + "IMPORT_TEMPLATE" + ] + }, "Filter":{ "type":"structure", "required":[ @@ -1838,6 +1859,7 @@ "IMPORT_FAILED", "IMPORT_FAILED_SERVER_LIMIT_EXCEEDED", "IMPORT_FAILED_RECORD_LIMIT_EXCEEDED", + "IMPORT_FAILED_UNSUPPORTED_FILE_TYPE", "DELETE_IN_PROGRESS", "DELETE_COMPLETE", "DELETE_FAILED", @@ -1880,6 +1902,10 @@ "shape":"TimeStamp", "documentation":"

The time that the import task request was deleted, presented in the Unix time stamp format.

" }, + "fileClassification":{ + "shape":"FileClassification", + "documentation":"

The type of file detected by the import task.

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

The total number of server records in the import file that were successfully imported.

" @@ -1922,7 +1948,8 @@ "enum":[ "IMPORT_TASK_ID", "STATUS", - "NAME" + "NAME", + "FILE_CLASSIFICATION" ] }, "ImportTaskFilterValue":{ @@ -2484,6 +2511,10 @@ "description":{ "shape":"ApplicationDescription", "documentation":"

New description of the application to be updated.

" + }, + "wave":{ + "shape":"ApplicationWave", + "documentation":"

The new migration wave of the application that you want to update.

" } } }, diff --git a/botocore/data/ec2/2016-11-15/service-2.json b/botocore/data/ec2/2016-11-15/service-2.json index be0c87389a..2e7b33a6fe 100644 --- a/botocore/data/ec2/2016-11-15/service-2.json +++ b/botocore/data/ec2/2016-11-15/service-2.json @@ -5153,7 +5153,7 @@ }, "input":{"shape":"ModifyInstanceCapacityReservationAttributesRequest"}, "output":{"shape":"ModifyInstanceCapacityReservationAttributesResult"}, - "documentation":"

Modifies the Capacity Reservation settings for a stopped instance. Use this action to configure an instance to target a specific Capacity Reservation, run in any open Capacity Reservation with matching attributes, or run On-Demand Instance capacity.

" + "documentation":"

Modifies the Capacity Reservation settings for a stopped instance. Use this action to configure an instance to target a specific Capacity Reservation, run in any open Capacity Reservation with matching attributes, run in On-Demand Instance capacity, or only run in a Capacity Reservation.

" }, "ModifyInstanceCpuOptions":{ "name":"ModifyInstanceCpuOptions", @@ -9699,6 +9699,27 @@ "documentation":"

The minimum and maximum baseline bandwidth to Amazon EBS, in Mbps. For more information, see Amazon EBS–optimized instances in the Amazon EC2 User Guide.

" }, "BaselineIops":{"type":"integer"}, + "BaselinePerformanceFactors":{ + "type":"structure", + "members":{ + "Cpu":{ + "shape":"CpuPerformanceFactor", + "documentation":"

The CPU performance to consider, using an instance family as the baseline reference.

", + "locationName":"cpu" + } + }, + "documentation":"

The baseline performance to consider, using an instance family as a baseline reference. The instance family establishes the lowest acceptable level of performance. Amazon EC2 uses this baseline to guide instance type selection, but there is no guarantee that the selected instance types will always exceed the baseline for every application.

Currently, this parameter only supports CPU performance as a baseline performance factor. For example, specifying c6i would use the CPU performance of the c6i family as the baseline reference.

" + }, + "BaselinePerformanceFactorsRequest":{ + "type":"structure", + "members":{ + "Cpu":{ + "shape":"CpuPerformanceFactorRequest", + "documentation":"

The CPU performance to consider, using an instance family as the baseline reference.

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

The baseline performance to consider, using an instance family as a baseline reference. The instance family establishes the lowest acceptable level of performance. Amazon EC2 uses this baseline to guide instance type selection, but there is no guarantee that the selected instance types will always exceed the baseline for every application.

Currently, this parameter only supports CPU performance as a baseline performance factor. For example, specifying c6i would use the CPU performance of the c6i family as the baseline reference.

" + }, "BaselineThroughputInMBps":{"type":"double"}, "BatchState":{ "type":"string", @@ -10939,6 +10960,7 @@ "CapacityReservationPreference":{ "type":"string", "enum":[ + "capacity-reservations-only", "open", "none" ] @@ -10955,14 +10977,14 @@ "members":{ "CapacityReservationPreference":{ "shape":"CapacityReservationPreference", - "documentation":"

Indicates the instance's Capacity Reservation preferences. Possible preferences include:

" + "documentation":"

Indicates the instance's Capacity Reservation preferences. Possible preferences include:

" }, "CapacityReservationTarget":{ "shape":"CapacityReservationTarget", "documentation":"

Information about the target Capacity Reservation or Capacity Reservation group.

" } }, - "documentation":"

Describes an instance's Capacity Reservation targeting option. You can specify only one parameter at a time. If you specify CapacityReservationPreference and CapacityReservationTarget, the request fails.

Use the CapacityReservationPreference parameter to configure the instance to run as an On-Demand Instance or to run in any open Capacity Reservation that has matching attributes (instance type, platform, Availability Zone). Use the CapacityReservationTarget parameter to explicitly target a specific Capacity Reservation or a Capacity Reservation group.

" + "documentation":"

Describes an instance's Capacity Reservation targeting option.

Use the CapacityReservationPreference parameter to configure the instance to run as an On-Demand Instance, to run in any open Capacity Reservation that has matching attributes, or to run only in a Capacity Reservation or Capacity Reservation group. Use the CapacityReservationTarget parameter to explicitly target a specific Capacity Reservation or a Capacity Reservation group.

You can only specify CapacityReservationPreference and CapacityReservationTarget if the CapacityReservationPreference is capacity-reservations-only.

" }, "CapacityReservationSpecificationResponse":{ "type":"structure", @@ -12467,7 +12489,8 @@ "enum":[ "intel", "amd", - "amazon-web-services" + "amazon-web-services", + "apple" ] }, "CpuManufacturerName":{"type":"string"}, @@ -12517,6 +12540,28 @@ }, "documentation":"

The CPU options for the instance. Both the core count and threads per core must be specified in the request.

" }, + "CpuPerformanceFactor":{ + "type":"structure", + "members":{ + "References":{ + "shape":"PerformanceFactorReferenceSet", + "documentation":"

Specify an instance family to use as the baseline reference for CPU performance. All instance types that match your specified attributes will be compared against the CPU performance of the referenced instance family, regardless of CPU manufacturer or architecture differences.

Currently, only one instance family can be specified in the list.

", + "locationName":"referenceSet" + } + }, + "documentation":"

The CPU performance to consider, using an instance family as the baseline reference.

" + }, + "CpuPerformanceFactorRequest":{ + "type":"structure", + "members":{ + "References":{ + "shape":"PerformanceFactorReferenceSetRequest", + "documentation":"

Specify an instance family to use as the baseline reference for CPU performance. All instance types that match your specified attributes will be compared against the CPU performance of the referenced instance family, regardless of CPU manufacturer or architecture differences.

Currently, only one instance family can be specified in the list.

", + "locationName":"Reference" + } + }, + "documentation":"

The CPU performance to consider, using an instance family as the baseline reference.

" + }, "CreateCapacityReservationBySplittingRequest":{ "type":"structure", "required":[ @@ -37049,6 +37094,11 @@ "shape":"Integer", "documentation":"

[Price protection] The price protection threshold for Spot Instances, as a percentage of an identified On-Demand price. The identified On-Demand price is the price of the lowest priced current generation C, M, or R instance type with your specified attributes. If no current generation C, M, or R instance type matches your attributes, then the identified price is from the lowest priced current generation instance types, and failing that, from the lowest priced previous generation instance types that match your attributes. When Amazon EC2 selects instance types with your attributes, it will exclude instance types whose price exceeds your specified threshold.

The parameter accepts an integer, which Amazon EC2 interprets as a percentage.

If you set TargetCapacityUnitType to vcpu or memory-mib, the price protection threshold is based on the per vCPU or per memory price instead of the per instance price.

Only one of SpotMaxPricePercentageOverLowestPrice or MaxSpotPriceAsPercentageOfOptimalOnDemandPrice can be specified. If you don't specify either, Amazon EC2 will automatically apply optimal price protection to consistently select from a wide range of instance types. To indicate no price protection threshold for Spot Instances, meaning you want to consider all instance types that match your attributes, include one of these parameters and specify a high value, such as 999999.

", "locationName":"maxSpotPriceAsPercentageOfOptimalOnDemandPrice" + }, + "BaselinePerformanceFactors":{ + "shape":"BaselinePerformanceFactors", + "documentation":"

The baseline performance to consider, using an instance family as a baseline reference. The instance family establishes the lowest acceptable level of performance. Amazon EC2 uses this baseline to guide instance type selection, but there is no guarantee that the selected instance types will always exceed the baseline for every application. Currently, this parameter only supports CPU performance as a baseline performance factor. For more information, see Performance protection in the Amazon EC2 User Guide.

", + "locationName":"baselinePerformanceFactors" } }, "documentation":"

The attributes for the instance types. When you specify instance attributes, Amazon EC2 will identify instance types with these attributes.

You must specify VCpuCount and MemoryMiB. All other attributes are optional. Any unspecified optional attribute is set to its default.

When you specify multiple attributes, you get instance types that satisfy all of the specified attributes. If you specify multiple values for an attribute, you get instance types that satisfy any of the specified values.

To limit the list of instance types from which Amazon EC2 can identify matching instance types, you can use one of the following parameters, but not both in the same request:

If you specify InstanceRequirements, you can't specify InstanceType.

Attribute-based instance type selection is only supported when using Auto Scaling groups, EC2 Fleet, and Spot Fleet to launch instances. If you plan to use the launch template in the launch instance wizard or with the RunInstances API, you can't specify InstanceRequirements.

For more information, see Create mixed instances group using attribute-based instance type selection in the Amazon EC2 Auto Scaling User Guide, and also Specify attributes for instance type selection for EC2 Fleet or Spot Fleet and Spot placement score in the Amazon EC2 User Guide.

" @@ -37163,6 +37213,10 @@ "MaxSpotPriceAsPercentageOfOptimalOnDemandPrice":{ "shape":"Integer", "documentation":"

[Price protection] The price protection threshold for Spot Instances, as a percentage of an identified On-Demand price. The identified On-Demand price is the price of the lowest priced current generation C, M, or R instance type with your specified attributes. If no current generation C, M, or R instance type matches your attributes, then the identified price is from the lowest priced current generation instance types, and failing that, from the lowest priced previous generation instance types that match your attributes. When Amazon EC2 selects instance types with your attributes, it will exclude instance types whose price exceeds your specified threshold.

The parameter accepts an integer, which Amazon EC2 interprets as a percentage.

If you set TargetCapacityUnitType to vcpu or memory-mib, the price protection threshold is based on the per vCPU or per memory price instead of the per instance price.

Only one of SpotMaxPricePercentageOverLowestPrice or MaxSpotPriceAsPercentageOfOptimalOnDemandPrice can be specified. If you don't specify either, Amazon EC2 will automatically apply optimal price protection to consistently select from a wide range of instance types. To indicate no price protection threshold for Spot Instances, meaning you want to consider all instance types that match your attributes, include one of these parameters and specify a high value, such as 999999.

" + }, + "BaselinePerformanceFactors":{ + "shape":"BaselinePerformanceFactorsRequest", + "documentation":"

The baseline performance to consider, using an instance family as a baseline reference. The instance family establishes the lowest acceptable level of performance. Amazon EC2 uses this baseline to guide instance type selection, but there is no guarantee that the selected instance types will always exceed the baseline for every application. Currently, this parameter only supports CPU performance as a baseline performance factor. For more information, see Performance protection in the Amazon EC2 User Guide.

" } }, "documentation":"

The attributes for the instance types. When you specify instance attributes, Amazon EC2 will identify instance types with these attributes.

You must specify VCpuCount and MemoryMiB. All other attributes are optional. Any unspecified optional attribute is set to its default.

When you specify multiple attributes, you get instance types that satisfy all of the specified attributes. If you specify multiple values for an attribute, you get instance types that satisfy any of the specified values.

To limit the list of instance types from which Amazon EC2 can identify matching instance types, you can use one of the following parameters, but not both in the same request:

If you specify InstanceRequirements, you can't specify InstanceType.

Attribute-based instance type selection is only supported when using Auto Scaling groups, EC2 Fleet, and Spot Fleet to launch instances. If you plan to use the launch template in the launch instance wizard, or with the RunInstances API or AWS::EC2::Instance Amazon Web Services CloudFormation resource, you can't specify InstanceRequirements.

For more information, see Specify attributes for instance type selection for EC2 Fleet or Spot Fleet and Spot placement score in the Amazon EC2 User Guide.

" @@ -48544,6 +48598,41 @@ }, "documentation":"

Information about the transit gateway in the peering attachment.

" }, + "PerformanceFactorReference":{ + "type":"structure", + "members":{ + "InstanceFamily":{ + "shape":"String", + "documentation":"

The instance family to use as a baseline reference.

Ensure that you specify the correct value for the instance family. The instance family is everything before the period (.) in the instance type name. For example, in the instance type c6i.large, the instance family is c6i, not c6. For more information, see Amazon EC2 instance type naming conventions in Amazon EC2 Instance Types.

The following instance families are not supported for performance protection:

If you enable performance protection by specifying a supported instance family, the returned instance types will exclude the above unsupported instance families.

If you specify an unsupported instance family as a value for baseline performance, the API returns an empty response for and an exception for , , , and .

", + "locationName":"instanceFamily" + } + }, + "documentation":"

Specify an instance family to use as the baseline reference for CPU performance. All instance types that match your specified attributes will be compared against the CPU performance of the referenced instance family, regardless of CPU manufacturer or architecture.

Currently, only one instance family can be specified in the list.

" + }, + "PerformanceFactorReferenceRequest":{ + "type":"structure", + "members":{ + "InstanceFamily":{ + "shape":"String", + "documentation":"

The instance family to use as a baseline reference.

Ensure that you specify the correct value for the instance family. The instance family is everything before the period (.) in the instance type name. For example, in the instance type c6i.large, the instance family is c6i, not c6. For more information, see Amazon EC2 instance type naming conventions in Amazon EC2 Instance Types.

The following instance families are not supported for performance protection:

If you enable performance protection by specifying a supported instance family, the returned instance types will exclude the above unsupported instance families.

If you specify an unsupported instance family as a value for baseline performance, the API returns an empty response for and an exception for , , , and .

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

Specify an instance family to use as the baseline reference for CPU performance. All instance types that match your specified attributes will be compared against the CPU performance of the referenced instance family, regardless of CPU manufacturer or architecture.

Currently, only one instance family can be specified in the list.

" + }, + "PerformanceFactorReferenceSet":{ + "type":"list", + "member":{ + "shape":"PerformanceFactorReference", + "locationName":"item" + } + }, + "PerformanceFactorReferenceSetRequest":{ + "type":"list", + "member":{ + "shape":"PerformanceFactorReferenceRequest", + "locationName":"item" + } + }, "PeriodType":{ "type":"string", "enum":[ @@ -53633,7 +53722,7 @@ }, "CapacityReservationSpecification":{ "shape":"CapacityReservationSpecification", - "documentation":"

Information about the Capacity Reservation targeting option. If you do not specify this parameter, the instance's Capacity Reservation preference defaults to open, which enables it to run in any open Capacity Reservation that has matching attributes (instance type, platform, Availability Zone).

" + "documentation":"

Information about the Capacity Reservation targeting option. If you do not specify this parameter, the instance's Capacity Reservation preference defaults to open, which enables it to run in any open Capacity Reservation that has matching attributes (instance type, platform, Availability Zone, and tenancy).

" }, "HibernationOptions":{ "shape":"HibernationOptionsRequest", diff --git a/botocore/data/ecs/2014-11-13/service-2.json b/botocore/data/ecs/2014-11-13/service-2.json index f4a14ae092..955d7e80c1 100644 --- a/botocore/data/ecs/2014-11-13/service-2.json +++ b/botocore/data/ecs/2014-11-13/service-2.json @@ -135,7 +135,7 @@ {"shape":"ClientException"}, {"shape":"InvalidParameterException"} ], - "documentation":"

Deletes the specified capacity provider.

The FARGATE and FARGATE_SPOT capacity providers are reserved and can't be deleted. You can disassociate them from a cluster using either PutCapacityProviderProviders or by deleting the cluster.

Prior to a capacity provider being deleted, the capacity provider must be removed from the capacity provider strategy from all services. The UpdateService API can be used to remove a capacity provider from a service's capacity provider strategy. When updating a service, the forceNewDeployment option can be used to ensure that any tasks using the Amazon EC2 instance capacity provided by the capacity provider are transitioned to use the capacity from the remaining capacity providers. Only capacity providers that aren't associated with a cluster can be deleted. To remove a capacity provider from a cluster, you can either use PutCapacityProviderProviders or delete the cluster.

" + "documentation":"

Deletes the specified capacity provider.

The FARGATE and FARGATE_SPOT capacity providers are reserved and can't be deleted. You can disassociate them from a cluster using either PutCapacityProviderProviders or by deleting the cluster.

Prior to a capacity provider being deleted, the capacity provider must be removed from the capacity provider strategy from all services. The UpdateService API can be used to remove a capacity provider from a service's capacity provider strategy. When updating a service, the forceNewDeployment option can be used to ensure that any tasks using the Amazon EC2 instance capacity provided by the capacity provider are transitioned to use the capacity from the remaining capacity providers. Only capacity providers that aren't associated with a cluster can be deleted. To remove a capacity provider from a cluster, you can either use PutClusterCapacityProviders or delete the cluster.

" }, "DeleteCluster":{ "name":"DeleteCluster", @@ -1176,6 +1176,13 @@ }, "documentation":"

The details of the Auto Scaling group capacity provider to update.

" }, + "AvailabilityZoneRebalancing":{ + "type":"string", + "enum":[ + "ENABLED", + "DISABLED" + ] + }, "AwsVpcConfiguration":{ "type":"structure", "required":["subnets"], @@ -2142,6 +2149,10 @@ "shape":"String", "documentation":"

The family and revision (family:revision) or full ARN of the task definition to run in your service. If a revision isn't specified, the latest ACTIVE revision is used.

A task definition must be specified if the service uses either the ECS or CODE_DEPLOY deployment controllers.

For more information about deployment types, see Amazon ECS deployment types.

" }, + "availabilityZoneRebalancing":{ + "shape":"AvailabilityZoneRebalancing", + "documentation":"

Indicates whether to use Availability Zone rebalancing for the service.

For more information, see Balancing an Amazon ECS service across Availability Zones in the Amazon Elastic Container Service Developer Guide.

" + }, "loadBalancers":{ "shape":"LoadBalancers", "documentation":"

A load balancer object representing the load balancers to use with your service. For more information, see Service load balancing in the Amazon Elastic Container Service Developer Guide.

If the service uses the rolling update (ECS) deployment controller and using either an Application Load Balancer or Network Load Balancer, you must specify one or more target group ARNs to attach to the service. The service-linked role is required for services that use multiple target groups. For more information, see Using service-linked roles for Amazon ECS in the Amazon Elastic Container Service Developer Guide.

If the service uses the CODE_DEPLOY deployment controller, the service is required to use either an Application Load Balancer or Network Load Balancer. When creating an CodeDeploy deployment group, you specify two target groups (referred to as a targetGroupPair). During a deployment, CodeDeploy determines which task set in your service has the status PRIMARY, and it associates one target group with it. Then, it also associates the other target group with the replacement task set. The load balancer can also have up to two listeners: a required listener for production traffic and an optional listener that you can use to perform validation tests with Lambda functions before routing production traffic to it.

If you use the CODE_DEPLOY deployment controller, these values can be changed when updating the service.

For Application Load Balancers and Network Load Balancers, this object must contain the load balancer target group ARN, the container name, and the container port to access from the load balancer. The container name must be as it appears in a container definition. The load balancer name parameter must be omitted. When a task from this service is placed on a container instance, the container instance and port combination is registered as a target in the target group that's specified here.

For Classic Load Balancers, this object must contain the load balancer name, the container name , and the container port to access from the load balancer. The container name must be as it appears in a container definition. The target group ARN parameter must be omitted. When a task from this service is placed on a container instance, the container instance is registered with the load balancer that's specified here.

Services with tasks that use the awsvpc network mode (for example, those with the Fargate launch type) only support Application Load Balancers and Network Load Balancers. Classic Load Balancers aren't supported. Also, when you create any target groups for these services, you must choose ip as the target type, not instance. This is because tasks that use the awsvpc network mode are associated with an elastic network interface, not an Amazon EC2 instance.

" @@ -2654,10 +2665,10 @@ "members":{ "type":{ "shape":"DeploymentControllerType", - "documentation":"

The deployment controller type to use.

There are three deployment controller types available:

ECS

The rolling update (ECS) deployment type involves replacing the current running version of the container with the latest version. The number of containers Amazon ECS adds or removes from the service during a rolling update is controlled by adjusting the minimum and maximum number of healthy tasks allowed during a service deployment, as specified in the DeploymentConfiguration.

CODE_DEPLOY

The blue/green (CODE_DEPLOY) deployment type uses the blue/green deployment model powered by CodeDeploy, which allows you to verify a new deployment of a service before sending production traffic to it.

EXTERNAL

The external (EXTERNAL) deployment type enables you to use any third-party deployment controller for full control over the deployment process for an Amazon ECS service.

" + "documentation":"

The deployment controller type to use.

There are three deployment controller types available:

ECS

The rolling update (ECS) deployment type involves replacing the current running version of the container with the latest version. The number of containers Amazon ECS adds or removes from the service during a rolling update is controlled by adjusting the minimum and maximum number of healthy tasks allowed during a service deployment, as specified in the DeploymentConfiguration.

For more information about rolling deployments, see Deploy Amazon ECS services by replacing tasks in the Amazon Elastic Container Service Developer Guide.

CODE_DEPLOY

The blue/green (CODE_DEPLOY) deployment type uses the blue/green deployment model powered by CodeDeploy, which allows you to verify a new deployment of a service before sending production traffic to it.

For more information about blue/green deployments, see Validate the state of an Amazon ECS service before deployment in the Amazon Elastic Container Service Developer Guide.

EXTERNAL

The external (EXTERNAL) deployment type enables you to use any third-party deployment controller for full control over the deployment process for an Amazon ECS service.

For more information about external deployments, see Deploy Amazon ECS services using a third-party controller in the Amazon Elastic Container Service Developer Guide.

" } }, - "documentation":"

The deployment controller to use for the service. For more information, see Amazon ECS deployment types in the Amazon Elastic Container Service Developer Guide.

" + "documentation":"

The deployment controller to use for the service.

" }, "DeploymentControllerType":{ "type":"string", @@ -5319,6 +5330,10 @@ "enableExecuteCommand":{ "shape":"Boolean", "documentation":"

Determines whether the execute command functionality is turned on for the service. If true, the execute command functionality is turned on for all containers in tasks as part of the service.

" + }, + "availabilityZoneRebalancing":{ + "shape":"AvailabilityZoneRebalancing", + "documentation":"

Indicates whether to use Availability Zone rebalancing for the service.

For more information, see Balancing an Amazon ECS service across Availability Zones in the Amazon Elastic Container Service Developer Guide.

" } }, "documentation":"

Details on a service within a cluster.

" @@ -7195,6 +7210,10 @@ "shape":"DeploymentConfiguration", "documentation":"

Optional deployment parameters that control how many tasks run during the deployment and the ordering of stopping and starting tasks.

" }, + "availabilityZoneRebalancing":{ + "shape":"AvailabilityZoneRebalancing", + "documentation":"

Indicates whether to use Availability Zone rebalancing for the service.

For more information, see Balancing an Amazon ECS service across Availability Zones in the Amazon Elastic Container Service Developer Guide.

" + }, "networkConfiguration":{ "shape":"NetworkConfiguration", "documentation":"

An object representing the network configuration for the service.

" diff --git a/botocore/data/elbv2/2015-12-01/service-2.json b/botocore/data/elbv2/2015-12-01/service-2.json index 28d71382af..c83e92397d 100644 --- a/botocore/data/elbv2/2015-12-01/service-2.json +++ b/botocore/data/elbv2/2015-12-01/service-2.json @@ -339,6 +339,22 @@ }, "documentation":"

Describes the current Elastic Load Balancing resource limits for your Amazon Web Services account.

For more information, see the following:

" }, + "DescribeCapacityReservation":{ + "name":"DescribeCapacityReservation", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DescribeCapacityReservationInput"}, + "output":{ + "shape":"DescribeCapacityReservationOutput", + "resultWrapper":"DescribeCapacityReservationResult" + }, + "errors":[ + {"shape":"LoadBalancerNotFoundException"} + ], + "documentation":"

Describes the capacity reservation status for the specified load balancer.

" + }, "DescribeListenerAttributes":{ "name":"DescribeListenerAttributes", "http":{ @@ -624,6 +640,29 @@ ], "documentation":"

Retrieves the specified revocation file.

This action returns a pre-signed S3 URI which is active for ten minutes.

" }, + "ModifyCapacityReservation":{ + "name":"ModifyCapacityReservation", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ModifyCapacityReservationInput"}, + "output":{ + "shape":"ModifyCapacityReservationOutput", + "resultWrapper":"ModifyCapacityReservationResult" + }, + "errors":[ + {"shape":"LoadBalancerNotFoundException"}, + {"shape":"InvalidConfigurationRequestException"}, + {"shape":"CapacityUnitsLimitExceededException"}, + {"shape":"CapacityReservationPendingException"}, + {"shape":"InsufficientCapacityException"}, + {"shape":"CapacityDecreaseRequestsLimitExceededException"}, + {"shape":"PriorRequestNotCompleteException"}, + {"shape":"OperationNotPermittedException"} + ], + "documentation":"

Modifies the capacity reservation of the specified load balancer.

When modifying capacity reservation, you must include at least one MinimumLoadBalancerCapacity or ResetCapacityReservation.

" + }, "ModifyListener":{ "name":"ModifyListener", "http":{ @@ -915,7 +954,8 @@ {"shape":"SubnetNotFoundException"}, {"shape":"InvalidSubnetException"}, {"shape":"AllocationIdNotFoundException"}, - {"shape":"AvailabilityZoneNotSupportedException"} + {"shape":"AvailabilityZoneNotSupportedException"}, + {"shape":"CapacityReservationPendingException"} ], "documentation":"

Enables the Availability Zones for the specified public subnets for the specified Application Load Balancer, Network Load Balancer or Gateway Load Balancer. The specified subnets replace the previously enabled subnets.

When you specify subnets for a Network Load Balancer, or Gateway Load Balancer you must include all subnets that were enabled previously, with their existing configurations, plus any additional subnets.

" } @@ -1324,6 +1364,67 @@ "exception":true }, "CanonicalHostedZoneId":{"type":"string"}, + "CapacityDecreaseRequestsLimitExceededException":{ + "type":"structure", + "members":{ + }, + "documentation":"

You've exceeded the daily capacity decrease limit for this reservation.

", + "error":{ + "code":"CapacityDecreaseRequestLimitExceeded", + "httpStatusCode":400, + "senderFault":true + }, + "exception":true + }, + "CapacityReservationPendingException":{ + "type":"structure", + "members":{ + }, + "documentation":"

There is a pending capacity reservation.

", + "error":{ + "code":"CapacityReservationPending", + "httpStatusCode":400, + "senderFault":true + }, + "exception":true + }, + "CapacityReservationStateEnum":{ + "type":"string", + "enum":[ + "provisioned", + "pending", + "rebalancing", + "failed" + ] + }, + "CapacityReservationStatus":{ + "type":"structure", + "members":{ + "Code":{ + "shape":"CapacityReservationStateEnum", + "documentation":"

The status code.

" + }, + "Reason":{ + "shape":"StateReason", + "documentation":"

The reason code for the status.

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

The status of a capacity reservation.

" + }, + "CapacityUnits":{"type":"integer"}, + "CapacityUnitsDouble":{"type":"double"}, + "CapacityUnitsLimitExceededException":{ + "type":"structure", + "members":{ + }, + "documentation":"

You've exceeded the capacity units limit.

", + "error":{ + "code":"CapacityUnitsLimitExceeded", + "httpStatusCode":400, + "senderFault":true + }, + "exception":true + }, "Certificate":{ "type":"structure", "members":{ @@ -1657,6 +1758,7 @@ "pattern":"^(ipv4pool-coip-)[a-zA-Z0-9]+$" }, "DNSName":{"type":"string"}, + "DecreaseRequestsRemaining":{"type":"integer"}, "Default":{"type":"boolean"}, "DeleteAssociationSameAccountException":{ "type":"structure", @@ -1815,6 +1917,37 @@ } } }, + "DescribeCapacityReservationInput":{ + "type":"structure", + "required":["LoadBalancerArn"], + "members":{ + "LoadBalancerArn":{ + "shape":"LoadBalancerArn", + "documentation":"

The Amazon Resource Name (ARN) of the load balancer.

" + } + } + }, + "DescribeCapacityReservationOutput":{ + "type":"structure", + "members":{ + "LastModifiedTime":{ + "shape":"LastModifiedTime", + "documentation":"

The last time the capacity reservation was modified.

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

The amount of daily capacity decreases remaining.

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

The requested minimum capacity reservation for the load balancer

" + }, + "CapacityReservationState":{ + "shape":"ZonalCapacityReservationStates", + "documentation":"

The state of the capacity reservation.

" + } + } + }, "DescribeListenerAttributesInput":{ "type":"structure", "required":["ListenerArn"], @@ -2522,6 +2655,17 @@ }, "exception":true }, + "InsufficientCapacityException":{ + "type":"structure", + "members":{ + }, + "documentation":"

There is insufficient capacity to reserve.

", + "error":{ + "code":"InsufficientCapacity", + "httpStatusCode":500 + }, + "exception":true + }, "InvalidCaCertificatesBundleException":{ "type":"structure", "members":{ @@ -2628,6 +2772,7 @@ ] }, "IsDefault":{"type":"boolean"}, + "LastModifiedTime":{"type":"timestamp"}, "Limit":{ "type":"structure", "members":{ @@ -2942,6 +3087,16 @@ "documentation":"

The codes to use when checking for a successful response from a target. If the protocol version is gRPC, these are gRPC codes. Otherwise, these are HTTP codes.

" }, "Max":{"type":"string"}, + "MinimumLoadBalancerCapacity":{ + "type":"structure", + "members":{ + "CapacityUnits":{ + "shape":"CapacityUnits", + "documentation":"

The number of capacity units.

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

The minimum capacity for a load balancer.

" + }, "MitigationInEffectEnum":{ "type":"string", "enum":[ @@ -2950,6 +3105,45 @@ ] }, "Mode":{"type":"string"}, + "ModifyCapacityReservationInput":{ + "type":"structure", + "required":["LoadBalancerArn"], + "members":{ + "LoadBalancerArn":{ + "shape":"LoadBalancerArn", + "documentation":"

The Amazon Resource Name (ARN) of the load balancer.

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

The minimum load balancer capacity reserved.

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

Resets the capacity reservation.

" + } + } + }, + "ModifyCapacityReservationOutput":{ + "type":"structure", + "members":{ + "LastModifiedTime":{ + "shape":"LastModifiedTime", + "documentation":"

The last time the capacity reservation was modified.

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

The amount of daily capacity decreases remaining.

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

The requested minimum capacity reservation for the load balancer

" + }, + "CapacityReservationState":{ + "shape":"ZonalCapacityReservationStates", + "documentation":"

The state of the capacity reservation.

" + } + } + }, "ModifyListenerAttributesInput":{ "type":"structure", "required":[ @@ -3259,6 +3453,18 @@ "max":65535, "min":1 }, + "PriorRequestNotCompleteException":{ + "type":"structure", + "members":{ + }, + "documentation":"

This operation is not allowed while a prior request has not been completed.

", + "error":{ + "code":"PriorRequestNotComplete", + "httpStatusCode":429, + "senderFault":true + }, + "exception":true + }, "PriorityInUseException":{ "type":"structure", "members":{ @@ -3459,6 +3665,7 @@ "members":{ } }, + "ResetCapacityReservation":{"type":"boolean"}, "ResourceArn":{"type":"string"}, "ResourceArns":{ "type":"list", @@ -4572,6 +4779,28 @@ "exception":true }, "VpcId":{"type":"string"}, + "ZonalCapacityReservationState":{ + "type":"structure", + "members":{ + "State":{ + "shape":"CapacityReservationStatus", + "documentation":"

The state of the capacity reservation.

" + }, + "AvailabilityZone":{ + "shape":"ZoneName", + "documentation":"

Information about the availability zone.

" + }, + "EffectiveCapacityUnits":{ + "shape":"CapacityUnitsDouble", + "documentation":"

The number of effective capacity units.

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

The capacity reservation status for each availability zone.

" + }, + "ZonalCapacityReservationStates":{ + "type":"list", + "member":{"shape":"ZonalCapacityReservationState"} + }, "ZoneName":{"type":"string"} }, "documentation":"Elastic Load Balancing

A load balancer distributes incoming traffic across targets, such as your EC2 instances. This enables you to increase the availability of your application. The load balancer also monitors the health of its registered targets and ensures that it routes traffic only to healthy targets. You configure your load balancer to accept incoming traffic by specifying one or more listeners, which are configured with a protocol and port number for connections from clients to the load balancer. You configure a target group with a protocol and port number for connections from the load balancer to the targets, and with health check settings to be used when checking the health status of the targets.

Elastic Load Balancing supports the following types of load balancers: Application Load Balancers, Network Load Balancers, Gateway Load Balancers, and Classic Load Balancers. This reference covers the following load balancer types:

For more information, see the Elastic Load Balancing User Guide.

All Elastic Load Balancing operations are idempotent, which means that they complete at most one time. If you repeat an operation, it succeeds.

" diff --git a/botocore/data/endpoints.json b/botocore/data/endpoints.json index 0d53406cc0..e40b671e25 100644 --- a/botocore/data/endpoints.json +++ b/botocore/data/endpoints.json @@ -21631,6 +21631,7 @@ "ap-northeast-2" : { }, "ap-northeast-3" : { }, "ap-south-1" : { }, + "ap-south-2" : { }, "ap-southeast-1" : { }, "ap-southeast-2" : { }, "ap-southeast-3" : { }, diff --git a/botocore/data/lambda/2015-03-31/service-2.json b/botocore/data/lambda/2015-03-31/service-2.json index 8a09127abd..2ebb29fa01 100644 --- a/botocore/data/lambda/2015-03-31/service-2.json +++ b/botocore/data/lambda/2015-03-31/service-2.json @@ -5453,7 +5453,8 @@ "provided.al2023", "python3.12", "java21", - "python3.13" + "python3.13", + "nodejs22.x" ] }, "RuntimeVersionArn":{ diff --git a/botocore/data/mediaconvert/2017-08-29/paginators-1.sdk-extras.json b/botocore/data/mediaconvert/2017-08-29/paginators-1.sdk-extras.json new file mode 100644 index 0000000000..c1219900be --- /dev/null +++ b/botocore/data/mediaconvert/2017-08-29/paginators-1.sdk-extras.json @@ -0,0 +1,13 @@ +{ + "version": 1.0, + "merge": { + "pagination": { + "ListQueues": { + "non_aggregate_keys": [ + "TotalConcurrentJobs", + "UnallocatedConcurrentJobs" + ] + } + } + } +} diff --git a/botocore/data/mediaconvert/2017-08-29/service-2.json b/botocore/data/mediaconvert/2017-08-29/service-2.json index 82a39c0632..55a0ff8e02 100644 --- a/botocore/data/mediaconvert/2017-08-29/service-2.json +++ b/botocore/data/mediaconvert/2017-08-29/service-2.json @@ -4031,6 +4031,11 @@ "CreateQueueRequest": { "type": "structure", "members": { + "ConcurrentJobs": { + "shape": "__integer", + "locationName": "concurrentJobs", + "documentation": "Specify the maximum number of jobs your queue can process concurrently. For on-demand queues, the value you enter is constrained by your service quotas for Maximum concurrent jobs, per on-demand queue and Maximum concurrent jobs, per account. For reserved queues, specify the number of jobs you can process concurrently in your reservation plan instead." + }, "Description": { "shape": "__string", "locationName": "description", @@ -8947,6 +8952,16 @@ "shape": "__listOfQueue", "locationName": "queues", "documentation": "List of queues." + }, + "TotalConcurrentJobs": { + "shape": "__integer", + "locationName": "totalConcurrentJobs", + "documentation": "The maximum number of jobs that MediaConvert can process at one time, across all of your on-demand queues in the current AWS Region." + }, + "UnallocatedConcurrentJobs": { + "shape": "__integer", + "locationName": "unallocatedConcurrentJobs", + "documentation": "The remaining number of concurrent jobs that are not associated with a queue and are available to allocate to a queue. You can allocate these jobs when you create or update a queue." } } }, @@ -11275,6 +11290,11 @@ "locationName": "arn", "documentation": "An identifier for this resource that is unique within all of AWS." }, + "ConcurrentJobs": { + "shape": "__integer", + "locationName": "concurrentJobs", + "documentation": "The maximum number of jobs your queue can process concurrently." + }, "CreatedAt": { "shape": "__timestampUnix", "locationName": "createdAt", @@ -11310,6 +11330,11 @@ "locationName": "reservationPlan", "documentation": "Details about the pricing plan for your reserved queue. Required for reserved queues and not applicable to on-demand queues." }, + "ServiceOverrides": { + "shape": "__listOfServiceOverride", + "locationName": "serviceOverrides", + "documentation": "A list of any service overrides applied by MediaConvert to the settings that you have configured. If you see any overrides, we recommend that you contact AWS Support." + }, "Status": { "shape": "QueueStatus", "locationName": "status", @@ -11728,6 +11753,32 @@ } } }, + "ServiceOverride": { + "type": "structure", + "members": { + "Message": { + "shape": "__string", + "locationName": "message", + "documentation": "Details about the service override that MediaConvert has applied." + }, + "Name": { + "shape": "__string", + "locationName": "name", + "documentation": "The name of the setting that MediaConvert has applied an override to." + }, + "OverrideValue": { + "shape": "__string", + "locationName": "overrideValue", + "documentation": "The current value of the service override that MediaConvert has applied." + }, + "Value": { + "shape": "__string", + "locationName": "value", + "documentation": "The value of the setting that you configured, prior to any overrides that MediaConvert has applied." + } + }, + "documentation": "A service override applied by MediaConvert to the settings that you have configured. If you see any overrides, we recommend that you contact AWS Support." + }, "SimulateReservedQueue": { "type": "string", "documentation": "Enable this setting when you run a test job to estimate how many reserved transcoding slots (RTS) you need. When this is enabled, MediaConvert runs your job from an on-demand queue with similar performance to what you will see with one RTS in a reserved queue. This setting is disabled by default.", @@ -12340,6 +12391,11 @@ "UpdateQueueRequest": { "type": "structure", "members": { + "ConcurrentJobs": { + "shape": "__integer", + "locationName": "concurrentJobs", + "documentation": "Specify the maximum number of jobs your queue can process concurrently. For on-demand queues, the value you enter is constrained by your service quotas for Maximum concurrent jobs, per on-demand queue and Maximum concurrent jobs, per account. For reserved queues, update your reservation plan instead in order to increase your yearly commitment." + }, "Description": { "shape": "__string", "locationName": "description", @@ -14432,6 +14488,12 @@ "shape": "QueueTransition" } }, + "__listOfServiceOverride": { + "type": "list", + "member": { + "shape": "ServiceOverride" + } + }, "__listOfTeletextPageType": { "type": "list", "member": { diff --git a/botocore/data/mediapackagev2/2022-12-25/service-2.json b/botocore/data/mediapackagev2/2022-12-25/service-2.json index 63534ce8d9..f204fafd57 100644 --- a/botocore/data/mediapackagev2/2022-12-25/service-2.json +++ b/botocore/data/mediapackagev2/2022-12-25/service-2.json @@ -830,6 +830,14 @@ "shape":"ResourceDescription", "documentation":"

Enter any descriptive text that helps you to identify the channel.

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

The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when InputType is CMAF.

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

The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when InputType is CMAF.

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

A comma-separated list of tag key:value pairs that you define. For example:

\"Key1\": \"Value1\",

\"Key2\": \"Value2\"

", @@ -883,6 +891,14 @@ "Tags":{ "shape":"TagMap", "documentation":"

The comma-separated list of tag key:value pairs assigned to the channel.

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

The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when InputType is CMAF.

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

The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when InputType is CMAF.

" } } }, @@ -1123,7 +1139,7 @@ }, "ProgramDateTimeIntervalSeconds":{ "shape":"CreateHlsManifestConfigurationProgramDateTimeIntervalSecondsInteger", - "documentation":"

Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player. ID3Timed metadata messages generate every 5 seconds whenever the content is ingested.

Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.

" + "documentation":"

Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player.

Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.

" }, "FilterConfiguration":{"shape":"FilterConfiguration"} }, @@ -1164,7 +1180,7 @@ }, "ProgramDateTimeIntervalSeconds":{ "shape":"CreateLowLatencyHlsManifestConfigurationProgramDateTimeIntervalSecondsInteger", - "documentation":"

Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player. ID3Timed metadata messages generate every 5 seconds whenever the content is ingested.

Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.

" + "documentation":"

Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player.

Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.

" }, "FilterConfiguration":{"shape":"FilterConfiguration"} }, @@ -1858,6 +1874,14 @@ "Tags":{ "shape":"TagMap", "documentation":"

The comma-separated list of tag key:value pairs assigned to the channel.

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

The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when InputType is CMAF.

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

The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when InputType is CMAF.

" } } }, @@ -2060,7 +2084,7 @@ }, "ProgramDateTimeIntervalSeconds":{ "shape":"Integer", - "documentation":"

Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player. ID3Timed metadata messages generate every 5 seconds whenever the content is ingested.

Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.

" + "documentation":"

Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player.

Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.

" }, "ScteHls":{"shape":"ScteHls"}, "FilterConfiguration":{"shape":"FilterConfiguration"}, @@ -2097,7 +2121,7 @@ }, "ProgramDateTimeIntervalSeconds":{ "shape":"Integer", - "documentation":"

Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player. ID3Timed metadata messages generate every 5 seconds whenever the content is ingested.

Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.

" + "documentation":"

Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player.

Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.

" }, "ScteHls":{"shape":"ScteHls"}, "FilterConfiguration":{"shape":"FilterConfiguration"}, @@ -2463,6 +2487,16 @@ "member":{"shape":"IngestEndpoint"}, "documentation":"

The list of ingest endpoints.

" }, + "InputSwitchConfiguration":{ + "type":"structure", + "members":{ + "MQCSInputSwitching":{ + "shape":"Boolean", + "documentation":"

When true, AWS Elemental MediaPackage performs input switching based on the MQCS. Default is true. This setting is valid only when InputType is CMAF.

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

The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive.

" + }, "InputType":{ "type":"string", "enum":[ @@ -2836,6 +2870,16 @@ "type":"list", "member":{"shape":"OriginEndpointListConfiguration"} }, + "OutputHeaderConfiguration":{ + "type":"structure", + "members":{ + "PublishMQCS":{ + "shape":"Boolean", + "documentation":"

When true, AWS Elemental MediaPackage includes the MQCS in responses to the CDN. This setting is valid only when InputType is CMAF.

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

The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN.

" + }, "PolicyText":{ "type":"string", "max":6144, @@ -3344,6 +3388,14 @@ "Description":{ "shape":"ResourceDescription", "documentation":"

Any descriptive information that you want to add to the channel for future identification purposes.

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

The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when InputType is CMAF.

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

The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when InputType is CMAF.

" } } }, @@ -3394,6 +3446,14 @@ "shape":"TagMap", "documentation":"

The comma-separated list of tag key:value pairs assigned to the channel.

", "locationName":"tags" + }, + "InputSwitchConfiguration":{ + "shape":"InputSwitchConfiguration", + "documentation":"

The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when InputType is CMAF.

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

The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when InputType is CMAF.

" } } }, @@ -3621,7 +3681,9 @@ "HARVEST_JOB_UNABLE_TO_WRITE_TO_S3_DESTINATION", "HARVEST_JOB_CUSTOMER_ENDPOINT_READ_ACCESS_DENIED", "CLIP_START_TIME_WITH_START_OR_END", - "START_TAG_TIME_OFFSET_INVALID" + "START_TAG_TIME_OFFSET_INVALID", + "ONLY_CMAF_INPUT_TYPE_ALLOW_MQCS_INPUT_SWITCHING", + "ONLY_CMAF_INPUT_TYPE_ALLOW_MQCS_OUTPUT_CONFIGURATION" ] } }, diff --git a/botocore/data/omics/2022-11-28/paginators-1.json b/botocore/data/omics/2022-11-28/paginators-1.json index bbb13cb116..b34caad3df 100644 --- a/botocore/data/omics/2022-11-28/paginators-1.json +++ b/botocore/data/omics/2022-11-28/paginators-1.json @@ -119,6 +119,12 @@ "output_token": "nextToken", "limit_key": "maxResults", "result_key": "shares" + }, + "ListRunCaches": { + "input_token": "startingToken", + "output_token": "nextToken", + "limit_key": "maxResults", + "result_key": "items" } } } diff --git a/botocore/data/omics/2022-11-28/service-2.json b/botocore/data/omics/2022-11-28/service-2.json index a721306338..0d5e0374a0 100644 --- a/botocore/data/omics/2022-11-28/service-2.json +++ b/botocore/data/omics/2022-11-28/service-2.json @@ -244,6 +244,28 @@ "documentation":"

Creates a reference store.

", "endpoint":{"hostPrefix":"control-storage-"} }, + "CreateRunCache":{ + "name":"CreateRunCache", + "http":{ + "method":"POST", + "requestUri":"/runCache", + "responseCode":201 + }, + "input":{"shape":"CreateRunCacheRequest"}, + "output":{"shape":"CreateRunCacheResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"ServiceQuotaExceededException"}, + {"shape":"ThrottlingException"}, + {"shape":"ValidationException"}, + {"shape":"ConflictException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"RequestTimeoutException"} + ], + "documentation":"

You can create a run cache to save the task outputs from completed tasks in a run for a private workflow. Subsequent runs use the task outputs from the cache, rather than computing the task outputs again. You specify an Amazon S3 location where HealthOmics saves the cached data. This data must be immediately accessible (not in an archived state).

For more information, see Creating a run cache in the AWS HealthOmics User Guide.

", + "endpoint":{"hostPrefix":"workflows-"} + }, "CreateRunGroup":{ "name":"CreateRunGroup", "http":{ @@ -458,6 +480,28 @@ "endpoint":{"hostPrefix":"workflows-"}, "idempotent":true }, + "DeleteRunCache":{ + "name":"DeleteRunCache", + "http":{ + "method":"DELETE", + "requestUri":"/runCache/{id}", + "responseCode":202 + }, + "input":{"shape":"DeleteRunCacheRequest"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"ServiceQuotaExceededException"}, + {"shape":"ThrottlingException"}, + {"shape":"ValidationException"}, + {"shape":"ConflictException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"RequestTimeoutException"} + ], + "documentation":"

Delete a run cache. This action removes the cache metadata stored in the service account, but doesn't delete the data in Amazon S3. You can access the cache data in Amazon S3, for inspection or to troubleshoot issues. You can remove old cache data using standard S3 Delete operations.

For more information, see Deleting a run cache in the AWS HealthOmics User Guide.

", + "endpoint":{"hostPrefix":"workflows-"}, + "idempotent":true + }, "DeleteRunGroup":{ "name":"DeleteRunGroup", "http":{ @@ -826,7 +870,29 @@ {"shape":"AccessDeniedException"}, {"shape":"RequestTimeoutException"} ], - "documentation":"

Gets information about a workflow run.

If a workflow is shared with you, you cannot export information about the run.

", + "documentation":"

Gets information about a workflow run.

If a workflow is shared with you, you cannot export information about the run.

HealthOmics stores a fixed number of runs that are available to the console and API. If GetRun doesn't return the requested run, you can find run logs for all runs in the CloudWatch logs. For more information about viewing the run logs, see CloudWatch logs in the AWS HealthOmics User Guide.

", + "endpoint":{"hostPrefix":"workflows-"} + }, + "GetRunCache":{ + "name":"GetRunCache", + "http":{ + "method":"GET", + "requestUri":"/runCache/{id}", + "responseCode":200 + }, + "input":{"shape":"GetRunCacheRequest"}, + "output":{"shape":"GetRunCacheResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"ServiceQuotaExceededException"}, + {"shape":"ThrottlingException"}, + {"shape":"ValidationException"}, + {"shape":"ConflictException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"RequestTimeoutException"} + ], + "documentation":"

Retrieve the details for the specified run cache.

For more information, see Call caching for HealthOmics runs in the AWS HealthOmics User Guide.

", "endpoint":{"hostPrefix":"workflows-"} }, "GetRunGroup":{ @@ -1214,6 +1280,28 @@ "documentation":"

Retrieves a list of references.

", "endpoint":{"hostPrefix":"control-storage-"} }, + "ListRunCaches":{ + "name":"ListRunCaches", + "http":{ + "method":"GET", + "requestUri":"/runCache", + "responseCode":200 + }, + "input":{"shape":"ListRunCachesRequest"}, + "output":{"shape":"ListRunCachesResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"ServiceQuotaExceededException"}, + {"shape":"ThrottlingException"}, + {"shape":"ValidationException"}, + {"shape":"ConflictException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"RequestTimeoutException"} + ], + "documentation":"

Retrieves a list of your run caches.

", + "endpoint":{"hostPrefix":"workflows-"} + }, "ListRunGroups":{ "name":"ListRunGroups", "http":{ @@ -1277,7 +1365,7 @@ {"shape":"AccessDeniedException"}, {"shape":"RequestTimeoutException"} ], - "documentation":"

Retrieves a list of runs.

", + "documentation":"

Retrieves a list of runs.

HealthOmics stores a fixed number of runs that are available to the console and API. If the ListRuns response doesn't include specific runs that you expected, you can find run logs for all runs in the CloudWatch logs. For more information about viewing the run logs, see CloudWatch logs in the AWS HealthOmics User Guide.

", "endpoint":{"hostPrefix":"workflows-"} }, "ListSequenceStores":{ @@ -1525,7 +1613,7 @@ {"shape":"AccessDeniedException"}, {"shape":"RequestTimeoutException"} ], - "documentation":"

Starts a workflow run. To duplicate a run, specify the run's ID and a role ARN. The remaining parameters are copied from the previous run.

StartRun will not support re-run for a workflow that is shared with you.

The total number of runs in your account is subject to a quota per Region. To avoid needing to delete runs manually, you can set the retention mode to REMOVE. Runs with this setting are deleted automatically when the run quoata is exceeded.

By default, the run uses STATIC storage. For STATIC storage, set the storageCapacity field. You can set the storage type to DYNAMIC. You do not set storageCapacity, because HealthOmics dynamically scales the storage up or down as required. For more information about static and dynamic storage, see Running workflows in the AWS HealthOmics User Guide.

", + "documentation":"

Starts a workflow run. To duplicate a run, specify the run's ID and a role ARN. The remaining parameters are copied from the previous run.

StartRun will not support re-run for a workflow that is shared with you.

HealthOmics stores a fixed number of runs that are available to the console and API. By default, HealthOmics doesn't any remove any runs. If HealthOmics reaches the maximum number of runs, you must manually remove runs. To have older runs removed automatically, set the retention mode to REMOVE.

By default, the run uses STATIC storage. For STATIC storage, set the storageCapacity field. You can set the storage type to DYNAMIC. You do not set storageCapacity, because HealthOmics dynamically scales the storage up or down as required. For more information about static and dynamic storage, see Running workflows in the AWS HealthOmics User Guide.

", "endpoint":{"hostPrefix":"workflows-"} }, "StartVariantImportJob":{ @@ -1631,6 +1719,27 @@ "documentation":"

Updates the description of an annotation store version.

", "endpoint":{"hostPrefix":"analytics-"} }, + "UpdateRunCache":{ + "name":"UpdateRunCache", + "http":{ + "method":"POST", + "requestUri":"/runCache/{id}", + "responseCode":202 + }, + "input":{"shape":"UpdateRunCacheRequest"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"ServiceQuotaExceededException"}, + {"shape":"ThrottlingException"}, + {"shape":"ValidationException"}, + {"shape":"ConflictException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"RequestTimeoutException"} + ], + "documentation":"

Update a run cache.

", + "endpoint":{"hostPrefix":"workflows-"} + }, "UpdateRunGroup":{ "name":"UpdateRunGroup", "http":{ @@ -2147,6 +2256,12 @@ "max":10, "min":1 }, + "AwsAccountId":{ + "type":"string", + "max":12, + "min":12, + "pattern":"[0-9]+" + }, "BatchDeleteReadSetRequest":{ "type":"structure", "required":[ @@ -2180,6 +2295,15 @@ "type":"boolean", "box":true }, + "CacheBehavior":{ + "type":"string", + "enum":[ + "CACHE_ON_FAILURE", + "CACHE_ALWAYS" + ], + "max":64, + "min":1 + }, "CancelAnnotationImportRequest":{ "type":"structure", "required":["jobId"], @@ -2655,6 +2779,65 @@ } } }, + "CreateRunCacheRequest":{ + "type":"structure", + "required":[ + "cacheS3Location", + "requestId" + ], + "members":{ + "cacheBehavior":{ + "shape":"CacheBehavior", + "documentation":"

Default cache behavior for runs that use this cache. Supported values are:

CACHE_ON_FAILURE: Caches task outputs from completed tasks for runs that fail. This setting is useful if you're debugging a workflow that fails after several tasks completed successfully. The subsequent run uses the cache outputs for previously-completed tasks if the task definition, inputs, and container in ECR are identical to the prior run.

CACHE_ALWAYS: Caches task outputs from completed tasks for all runs. This setting is useful in development mode, but do not use it in a production setting.

If you don't specify a value, the default behavior is CACHE_ON_FAILURE. When you start a run that uses this cache, you can override the default cache behavior.

For more information, see Run cache behavior in the AWS HealthOmics User Guide.

" + }, + "cacheS3Location":{ + "shape":"S3UriForBucketOrObject", + "documentation":"

Specify the S3 location for storing the cached task outputs. This data must be immediately accessible (not in an archived state).

" + }, + "description":{ + "shape":"UserCustomDescription", + "documentation":"

Enter a description of the run cache.

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

Enter a user-friendly name for the run cache.

" + }, + "requestId":{ + "shape":"RunCacheRequestId", + "documentation":"

A unique request token, to ensure idempotency. If you don't specify a token, HealthOmics automatically generates a universally unique identifier (UUID) for the request.

", + "idempotencyToken":true + }, + "tags":{ + "shape":"TagMap", + "documentation":"

Specify one or more tags to associate with this run cache.

" + }, + "cacheBucketOwnerId":{ + "shape":"AwsAccountId", + "documentation":"

The AWS account ID of the expected owner of the S3 bucket for the run cache. If not provided, your account ID is set as the owner of the bucket.

" + } + } + }, + "CreateRunCacheResponse":{ + "type":"structure", + "members":{ + "arn":{ + "shape":"RunCacheArn", + "documentation":"

Unique resource identifier for the run cache.

" + }, + "id":{ + "shape":"RunCacheId", + "documentation":"

Identifier for the run cache.

" + }, + "status":{ + "shape":"RunCacheStatus", + "documentation":"

Run cache status.

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

The tags associated with this run cache.

" + } + } + }, "CreateRunGroupRequest":{ "type":"structure", "required":["requestId"], @@ -3102,6 +3285,18 @@ "members":{ } }, + "DeleteRunCacheRequest":{ + "type":"structure", + "required":["id"], + "members":{ + "id":{ + "shape":"RunCacheId", + "documentation":"

Run cache identifier for the cache you want to delete.

", + "location":"uri", + "locationName":"id" + } + } + }, "DeleteRunGroupRequest":{ "type":"structure", "required":["id"], @@ -3262,6 +3457,10 @@ "type":"string", "pattern":"[\\p{L}||\\p{M}||\\p{Z}||\\p{S}||\\p{N}||\\p{P}]+" }, + "EngineVersion":{ + "type":"string", + "pattern":"[0-9]{2}.[0-9]{2}.[0-9]" + }, "EscapeChar":{ "type":"string", "max":1, @@ -4336,6 +4535,63 @@ } } }, + "GetRunCacheRequest":{ + "type":"structure", + "required":["id"], + "members":{ + "id":{ + "shape":"RunCacheId", + "documentation":"

The identifier of the run cache to retrieve.

", + "location":"uri", + "locationName":"id" + } + } + }, + "GetRunCacheResponse":{ + "type":"structure", + "members":{ + "arn":{ + "shape":"RunCacheArn", + "documentation":"

Unique resource identifier for the run cache.

" + }, + "cacheBehavior":{ + "shape":"CacheBehavior", + "documentation":"

The default cache behavior for runs using this cache.

" + }, + "cacheBucketOwnerId":{ + "shape":"AwsAccountId", + "documentation":"

The identifier of the bucket owner.

" + }, + "cacheS3Uri":{ + "shape":"S3UriForBucketOrObject", + "documentation":"

The S3 URI where the cache data is stored.

" + }, + "creationTime":{ + "shape":"RunCacheTimestamp", + "documentation":"

Creation time of the run cache (an ISO 8601 formatted string).

" + }, + "description":{ + "shape":"UserCustomDescription", + "documentation":"

The run cache description.

" + }, + "id":{ + "shape":"RunCacheId", + "documentation":"

The run cache ID.

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

The run cache name.

" + }, + "status":{ + "shape":"RunCacheStatus", + "documentation":"

The run cache status.

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

The tags associated with the run cache.

" + } + } + }, "GetRunGroupRequest":{ "type":"structure", "required":["id"], @@ -4442,6 +4698,18 @@ "shape":"RunId", "documentation":"

The run's ID.

" }, + "cacheId":{ + "shape":"NumericIdInArn", + "documentation":"

The run cache associated with the run.

" + }, + "cacheBehavior":{ + "shape":"CacheBehavior", + "documentation":"

The run cache behavior for the run.

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

The workflow engine version.

" + }, "status":{ "shape":"RunStatus", "documentation":"

The run's status.

" @@ -4612,6 +4880,14 @@ "shape":"GetRunTaskResponseCpusInteger", "documentation":"

The task's CPU usage.

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

Set to true if AWS HealthOmics found a matching entry in the run cache for this task.

" + }, + "cacheS3Uri":{ + "shape":"S3UriForBucketOrObject", + "documentation":"

The S3 URI of the cache location.

" + }, "memory":{ "shape":"GetRunTaskResponseMemoryInteger", "documentation":"

The task's memory use in gigabytes.

" @@ -5897,6 +6173,42 @@ } } }, + "ListRunCachesRequest":{ + "type":"structure", + "members":{ + "maxResults":{ + "shape":"ListRunCachesRequestMaxResultsInteger", + "documentation":"

The maximum number of results to return.

", + "location":"querystring", + "locationName":"maxResults" + }, + "startingToken":{ + "shape":"ListToken", + "documentation":"

Optional pagination token returned from a prior call to the ListRunCaches API operation.

", + "location":"querystring", + "locationName":"startingToken" + } + } + }, + "ListRunCachesRequestMaxResultsInteger":{ + "type":"integer", + "box":true, + "max":100, + "min":1 + }, + "ListRunCachesResponse":{ + "type":"structure", + "members":{ + "items":{ + "shape":"RunCacheList", + "documentation":"

Details about each run cache in the response.

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

Pagination token to retrieve additional run caches. If the response does not have a nextTokenvalue, you have reached to the end of the list.

" + } + } + }, "ListRunGroupsRequest":{ "type":"structure", "members":{ @@ -6145,6 +6457,12 @@ } } }, + "ListToken":{ + "type":"string", + "max":128, + "min":1, + "pattern":"[\\p{L}||\\p{M}||\\p{Z}||\\p{S}||\\p{N}||\\p{P}]+" + }, "ListVariantImportJobsFilter":{ "type":"structure", "members":{ @@ -6420,6 +6738,12 @@ }, "exception":true }, + "NumericIdInArn":{ + "type":"string", + "max":18, + "min":1, + "pattern":"[0-9]+" + }, "PrimitiveBoolean":{"type":"boolean"}, "Quote":{ "type":"string", @@ -7172,6 +7496,76 @@ "min":1, "pattern":"arn:.+" }, + "RunCacheArn":{ + "type":"string", + "max":128, + "min":1, + "pattern":"arn:.+" + }, + "RunCacheId":{ + "type":"string", + "max":18, + "min":1, + "pattern":"[0-9]+" + }, + "RunCacheList":{ + "type":"list", + "member":{"shape":"RunCacheListItem"} + }, + "RunCacheListItem":{ + "type":"structure", + "members":{ + "arn":{ + "shape":"RunCacheArn", + "documentation":"

Unique resource identifier for the run cache.

" + }, + "cacheBehavior":{ + "shape":"CacheBehavior", + "documentation":"

Default cache behavior for the run cache.

" + }, + "cacheS3Uri":{ + "shape":"S3UriForBucketOrObject", + "documentation":"

The S3 uri for the run cache data.

" + }, + "creationTime":{ + "shape":"RunCacheTimestamp", + "documentation":"

The time that this run cache was created (an ISO 8601 formatted string).

" + }, + "id":{ + "shape":"RunCacheId", + "documentation":"

The identifier for this run cache.

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

The name of the run cache.

" + }, + "status":{ + "shape":"RunCacheStatus", + "documentation":"

The run cache status.

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

List entry for one run cache.

" + }, + "RunCacheRequestId":{ + "type":"string", + "max":128, + "min":1, + "pattern":"[\\p{L}||\\p{M}||\\p{Z}||\\p{S}||\\p{N}||\\p{P}]+" + }, + "RunCacheStatus":{ + "type":"string", + "enum":[ + "ACTIVE", + "DELETED", + "FAILED" + ], + "max":64, + "min":1 + }, + "RunCacheTimestamp":{ + "type":"timestamp", + "timestampFormat":"iso8601" + }, "RunExport":{ "type":"string", "enum":["DEFINITION"], @@ -7502,6 +7896,11 @@ "type":"string", "pattern":"s3://([a-z0-9][a-z0-9-.]{1,61}[a-z0-9])/(.{1,1024})" }, + "S3UriForBucketOrObject":{ + "type":"string", + "documentation":"

Uri to a S3 object or bucket

", + "pattern":"s3://([a-z0-9][a-z0-9-.]{1,61}[a-z0-9])(/(.{0,1024}))?" + }, "SampleId":{ "type":"string", "max":127, @@ -8203,6 +8602,14 @@ "shape":"RunName", "documentation":"

A name for the run.

" }, + "cacheId":{ + "shape":"NumericIdInArn", + "documentation":"

Identifier of the cache associated with this run. If you don't specify a cache ID, no task outputs are cached for this run.

" + }, + "cacheBehavior":{ + "shape":"CacheBehavior", + "documentation":"

The cache behavior for the run. You specify this value if you want to override the default behavior for the cache. You had set the default value when you created the cache. For more information, see Run cache behavior in the AWS HealthOmics User Guide.

" + }, "runGroupId":{ "shape":"RunGroupId", "documentation":"

The run's group ID.

" @@ -8238,7 +8645,7 @@ }, "retentionMode":{ "shape":"RunRetentionMode", - "documentation":"

The retention mode for the run.

" + "documentation":"

The retention mode for the run. The default value is RETAIN.

HealthOmics stores a fixed number of runs that are available to the console and API. In the default mode (RETAIN), you need to remove runs manually when the number of run exceeds the maximum. If you set the retention mode to REMOVE, HealthOmics automatically removes runs (that have mode set to REMOVE) when the number of run exceeds the maximum. All run logs are available in CloudWatch logs, if you need information about a run that is no longer available to the API.

For more information about retention mode, see Specifying run retention mode in the AWS HealthOmics User Guide.

" }, "storageType":{ "shape":"StorageType", @@ -8267,7 +8674,7 @@ "members":{ "arn":{ "shape":"RunArn", - "documentation":"

The run's ARN.

" + "documentation":"

Unique resource identifier for the run.

" }, "id":{ "shape":"RunId", @@ -8494,6 +8901,14 @@ "shape":"TaskListItemCpusInteger", "documentation":"

The task's CPU count.

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

Set to true if AWS HealthOmics found a matching entry in the run cache for this task.

" + }, + "cacheS3Uri":{ + "shape":"S3UriForBucketOrObject", + "documentation":"

The S3 URI of the cache location.

" + }, "memory":{ "shape":"TaskListItemMemoryInteger", "documentation":"

The task's memory use in gigabyes.

" @@ -8815,6 +9230,30 @@ } } }, + "UpdateRunCacheRequest":{ + "type":"structure", + "required":["id"], + "members":{ + "cacheBehavior":{ + "shape":"CacheBehavior", + "documentation":"

Update the default run cache behavior.

" + }, + "description":{ + "shape":"UserCustomDescription", + "documentation":"

Update the run cache description.

" + }, + "id":{ + "shape":"RunCacheId", + "documentation":"

The identifier of the run cache you want to update.

", + "location":"uri", + "locationName":"id" + }, + "name":{ + "shape":"UserCustomName", + "documentation":"

Update the name of the run cache.

" + } + } + }, "UpdateRunGroupRequest":{ "type":"structure", "required":["id"], @@ -9016,6 +9455,18 @@ } } }, + "UserCustomDescription":{ + "type":"string", + "max":256, + "min":1, + "pattern":"[\\p{L}||\\p{M}||\\p{Z}||\\p{S}||\\p{N}||\\p{P}]+" + }, + "UserCustomName":{ + "type":"string", + "max":128, + "min":1, + "pattern":"[\\p{L}||\\p{M}||\\p{Z}||\\p{S}||\\p{N}||\\p{P}]+" + }, "ValidationException":{ "type":"structure", "required":["message"], diff --git a/botocore/data/rbin/2021-06-15/service-2.json b/botocore/data/rbin/2021-06-15/service-2.json index ae2fc62030..bafd6f7093 100644 --- a/botocore/data/rbin/2021-06-15/service-2.json +++ b/botocore/data/rbin/2021-06-15/service-2.json @@ -5,11 +5,13 @@ "endpointPrefix":"rbin", "jsonVersion":"1.1", "protocol":"rest-json", + "protocols":["rest-json"], "serviceFullName":"Amazon Recycle Bin", "serviceId":"rbin", "signatureVersion":"v4", "signingName":"rbin", - "uid":"rbin-2021-06-15" + "uid":"rbin-2021-06-15", + "auth":["aws.auth#sigv4"] }, "operations":{ "CreateRule":{ @@ -26,7 +28,7 @@ {"shape":"ServiceQuotaExceededException"}, {"shape":"InternalServerException"} ], - "documentation":"

Creates a Recycle Bin retention rule. For more information, see Create Recycle Bin retention rules in the Amazon Elastic Compute Cloud User Guide.

" + "documentation":"

Creates a Recycle Bin retention rule. You can create two types of retention rules:

For more information, see Create Recycle Bin retention rules in the Amazon EBS User Guide.

" }, "DeleteRule":{ "name":"DeleteRule", @@ -107,7 +109,7 @@ {"shape":"ValidationException"}, {"shape":"ConflictException"} ], - "documentation":"

Locks a retention rule. A locked retention rule can't be modified or deleted.

" + "documentation":"

Locks a Region-level retention rule. A locked retention rule can't be modified or deleted.

You can't lock tag-level retention rules, or Region-level retention rules that have exclusion tags.

" }, "TagResource":{ "name":"TagResource", @@ -221,11 +223,15 @@ }, "ResourceTags":{ "shape":"ResourceTags", - "documentation":"

Specifies the resource tags to use to identify resources that are to be retained by a tag-level retention rule. For tag-level retention rules, only deleted resources, of the specified resource type, that have one or more of the specified tag key and value pairs are retained. If a resource is deleted, but it does not have any of the specified tag key and value pairs, it is immediately deleted without being retained by the retention rule.

You can add the same tag key and value pair to a maximum or five retention rules.

To create a Region-level retention rule, omit this parameter. A Region-level retention rule does not have any resource tags specified. It retains all deleted resources of the specified resource type in the Region in which the rule is created, even if the resources are not tagged.

" + "documentation":"

[Tag-level retention rules only] Specifies the resource tags to use to identify resources that are to be retained by a tag-level retention rule. For tag-level retention rules, only deleted resources, of the specified resource type, that have one or more of the specified tag key and value pairs are retained. If a resource is deleted, but it does not have any of the specified tag key and value pairs, it is immediately deleted without being retained by the retention rule.

You can add the same tag key and value pair to a maximum or five retention rules.

To create a Region-level retention rule, omit this parameter. A Region-level retention rule does not have any resource tags specified. It retains all deleted resources of the specified resource type in the Region in which the rule is created, even if the resources are not tagged.

" }, "LockConfiguration":{ "shape":"LockConfiguration", "documentation":"

Information about the retention rule lock configuration.

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

[Region-level retention rules only] Specifies the exclusion tags to use to identify resources that are to be excluded, or ignored, by a Region-level retention rule. Resources that have any of these tags are not retained by the retention rule upon deletion.

You can't specify exclusion tags for tag-level retention rules.

" } } }, @@ -251,7 +257,7 @@ }, "ResourceTags":{ "shape":"ResourceTags", - "documentation":"

Information about the resource tags used to identify resources that are retained by the retention rule.

" + "documentation":"

[Tag-level retention rules only] Information about the resource tags used to identify resources that are retained by the retention rule.

" }, "Status":{ "shape":"RuleStatus", @@ -263,11 +269,15 @@ }, "LockState":{ "shape":"LockState", - "documentation":"

The lock state for the retention rule.

" + "documentation":"

[Region-level retention rules only] The lock state for the retention rule.

" }, "RuleArn":{ "shape":"RuleArn", "documentation":"

The Amazon Resource Name (ARN) of the retention rule.

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

[Region-level retention rules only] Information about the exclusion tags used to identify resources that are to be excluded, or ignored, by the retention rule.

" } } }, @@ -293,6 +303,12 @@ "pattern":"^[\\S ]{0,255}$" }, "ErrorMessage":{"type":"string"}, + "ExcludeResourceTags":{ + "type":"list", + "member":{"shape":"ResourceTag"}, + "max":5, + "min":0 + }, "GetRuleRequest":{ "type":"structure", "required":["Identifier"], @@ -326,7 +342,7 @@ }, "ResourceTags":{ "shape":"ResourceTags", - "documentation":"

Information about the resource tags used to identify resources that are retained by the retention rule.

" + "documentation":"

[Tag-level retention rules only] Information about the resource tags used to identify resources that are retained by the retention rule.

" }, "Status":{ "shape":"RuleStatus", @@ -338,7 +354,7 @@ }, "LockState":{ "shape":"LockState", - "documentation":"

The lock state for the retention rule.

" + "documentation":"

[Region-level retention rules only] The lock state for the retention rule.

" }, "LockEndTime":{ "shape":"TimeStamp", @@ -347,6 +363,10 @@ "RuleArn":{ "shape":"RuleArn", "documentation":"

The Amazon Resource Name (ARN) of the retention rule.

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

[Region-level retention rules only] Information about the exclusion tags used to identify resources that are to be excluded, or ignored, by the retention rule.

" } } }, @@ -378,11 +398,15 @@ }, "ResourceTags":{ "shape":"ResourceTags", - "documentation":"

Information about the resource tags used to identify resources that are retained by the retention rule.

" + "documentation":"

[Tag-level retention rules only] Information about the resource tags used to identify resources that are retained by the retention rule.

" }, "LockState":{ "shape":"LockState", "documentation":"

The lock state of the retention rules to list. Only retention rules with the specified lock state are returned.

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

[Region-level retention rules only] Information about the exclusion tags used to identify resources that are to be excluded, or ignored, by the retention rule.

" } } }, @@ -468,7 +492,7 @@ "RetentionPeriod":{"shape":"RetentionPeriod"}, "ResourceTags":{ "shape":"ResourceTags", - "documentation":"

Information about the resource tags used to identify resources that are retained by the retention rule.

" + "documentation":"

[Tag-level retention rules only] Information about the resource tags used to identify resources that are retained by the retention rule.

" }, "Status":{ "shape":"RuleStatus", @@ -480,11 +504,15 @@ }, "LockState":{ "shape":"LockState", - "documentation":"

The lock state for the retention rule.

" + "documentation":"

[Region-level retention rules only] The lock state for the retention rule.

" }, "RuleArn":{ "shape":"RuleArn", "documentation":"

The Amazon Resource Name (ARN) of the retention rule.

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

[Region-level retention rules only] Information about the exclusion tags used to identify resources that are to be excluded, or ignored, by the retention rule.

" } } }, @@ -535,7 +563,7 @@ "documentation":"

The tag value.

" } }, - "documentation":"

Information about the resource tags used to identify resources that are retained by the retention rule.

" + "documentation":"

[Tag-level retention rules only] Information about the resource tags used to identify resources that are retained by the retention rule.

" }, "ResourceTagKey":{ "type":"string", @@ -619,7 +647,7 @@ }, "LockState":{ "shape":"LockState", - "documentation":"

The lock state for the retention rule.

" + "documentation":"

[Region-level retention rules only] The lock state for the retention rule.

" }, "RuleArn":{ "shape":"RuleArn", @@ -773,7 +801,7 @@ "RetentionPeriod":{"shape":"RetentionPeriod"}, "ResourceTags":{ "shape":"ResourceTags", - "documentation":"

Information about the resource tags used to identify resources that are retained by the retention rule.

" + "documentation":"

[Tag-level retention rules only] Information about the resource tags used to identify resources that are retained by the retention rule.

" }, "Status":{ "shape":"RuleStatus", @@ -785,7 +813,7 @@ }, "LockState":{ "shape":"LockState", - "documentation":"

The lock state for the retention rule.

" + "documentation":"

[Region-level retention rules only] The lock state for the retention rule.

" }, "LockEndTime":{ "shape":"TimeStamp", @@ -794,6 +822,10 @@ "RuleArn":{ "shape":"RuleArn", "documentation":"

The Amazon Resource Name (ARN) of the retention rule.

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

[Region-level retention rules only] Information about the exclusion tags used to identify resources that are to be excluded, or ignored, by the retention rule.

" } } }, @@ -847,7 +879,11 @@ }, "ResourceTags":{ "shape":"ResourceTags", - "documentation":"

Specifies the resource tags to use to identify resources that are to be retained by a tag-level retention rule. For tag-level retention rules, only deleted resources, of the specified resource type, that have one or more of the specified tag key and value pairs are retained. If a resource is deleted, but it does not have any of the specified tag key and value pairs, it is immediately deleted without being retained by the retention rule.

You can add the same tag key and value pair to a maximum or five retention rules.

To create a Region-level retention rule, omit this parameter. A Region-level retention rule does not have any resource tags specified. It retains all deleted resources of the specified resource type in the Region in which the rule is created, even if the resources are not tagged.

" + "documentation":"

[Tag-level retention rules only] Specifies the resource tags to use to identify resources that are to be retained by a tag-level retention rule. For tag-level retention rules, only deleted resources, of the specified resource type, that have one or more of the specified tag key and value pairs are retained. If a resource is deleted, but it does not have any of the specified tag key and value pairs, it is immediately deleted without being retained by the retention rule.

You can add the same tag key and value pair to a maximum or five retention rules.

To create a Region-level retention rule, omit this parameter. A Region-level retention rule does not have any resource tags specified. It retains all deleted resources of the specified resource type in the Region in which the rule is created, even if the resources are not tagged.

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

[Region-level retention rules only] Specifies the exclusion tags to use to identify resources that are to be excluded, or ignored, by a Region-level retention rule. Resources that have any of these tags are not retained by the retention rule upon deletion.

You can't specify exclusion tags for tag-level retention rules.

" } } }, @@ -869,7 +905,7 @@ }, "ResourceTags":{ "shape":"ResourceTags", - "documentation":"

Information about the resource tags used to identify resources that are retained by the retention rule.

" + "documentation":"

[Tag-level retention rules only] Information about the resource tags used to identify resources that are retained by the retention rule.

" }, "Status":{ "shape":"RuleStatus", @@ -877,7 +913,7 @@ }, "LockState":{ "shape":"LockState", - "documentation":"

The lock state for the retention rule.

" + "documentation":"

[Region-level retention rules only] The lock state for the retention rule.

" }, "LockEndTime":{ "shape":"TimeStamp", @@ -886,6 +922,10 @@ "RuleArn":{ "shape":"RuleArn", "documentation":"

The Amazon Resource Name (ARN) of the retention rule.

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

[Region-level retention rules only] Information about the exclusion tags used to identify resources that are to be excluded, or ignored, by the retention rule.

" } } }, diff --git a/botocore/data/rds/2014-10-31/service-2.json b/botocore/data/rds/2014-10-31/service-2.json index 95d2f7a55a..eec1601cfb 100644 --- a/botocore/data/rds/2014-10-31/service-2.json +++ b/botocore/data/rds/2014-10-31/service-2.json @@ -272,7 +272,7 @@ {"shape":"InvalidDBInstanceStateFault"}, {"shape":"InvalidDBClusterStateFault"} ], - "documentation":"

Creates a blue/green deployment.

A blue/green deployment creates a staging environment that copies the production environment. In a blue/green deployment, the blue environment is the current production environment. The green environment is the staging environment. The staging environment stays in sync with the current production environment using logical replication.

You can make changes to the databases in the green environment without affecting production workloads. For example, you can upgrade the major or minor DB engine version, change database parameters, or make schema changes in the staging environment. You can thoroughly test changes in the green environment. When ready, you can switch over the environments to promote the green environment to be the new production environment. The switchover typically takes under a minute.

For more information, see Using Amazon RDS Blue/Green Deployments for database updates in the Amazon RDS User Guide and Using Amazon RDS Blue/Green Deployments for database updates in the Amazon Aurora User Guide.

" + "documentation":"

Creates a blue/green deployment.

A blue/green deployment creates a staging environment that copies the production environment. In a blue/green deployment, the blue environment is the current production environment. The green environment is the staging environment, and it stays in sync with the current production environment.

You can make changes to the databases in the green environment without affecting production workloads. For example, you can upgrade the major or minor DB engine version, change database parameters, or make schema changes in the staging environment. You can thoroughly test changes in the green environment. When ready, you can switch over the environments to promote the green environment to be the new production environment. The switchover typically takes under a minute.

For more information, see Using Amazon RDS Blue/Green Deployments for database updates in the Amazon RDS User Guide and Using Amazon RDS Blue/Green Deployments for database updates in the Amazon Aurora User Guide.

" }, "CreateCustomDBEngineVersion":{ "name":"CreateCustomDBEngineVersion", @@ -4011,6 +4011,22 @@ "UpgradeTargetStorageConfig":{ "shape":"BooleanOptional", "documentation":"

Whether to upgrade the storage file system configuration on the green database. This option migrates the green DB instance from the older 32-bit file system to the preferred configuration. For more information, see Upgrading the storage file system for a DB instance.

" + }, + "TargetIops":{ + "shape":"IntegerOptional", + "documentation":"

The amount of Provisioned IOPS (input/output operations per second) to allocate for the green DB instance. For information about valid IOPS values, see Amazon RDS DB instance storage in the Amazon RDS User Guide.

This setting doesn't apply to Amazon Aurora blue/green deployments.

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

The storage type to associate with the green DB instance.

Valid Values: gp2 | gp3 | io1 | io2

This setting doesn't apply to Amazon Aurora blue/green deployments.

" + }, + "TargetAllocatedStorage":{ + "shape":"IntegerOptional", + "documentation":"

The amount of storage in gibibytes (GiB) to allocate for the green DB instance. You can choose to increase or decrease the allocated storage on the green DB instance.

This setting doesn't apply to Amazon Aurora blue/green deployments.

" + }, + "TargetStorageThroughput":{ + "shape":"IntegerOptional", + "documentation":"

The storage throughput value for the green DB instance.

This setting applies only to the gp3 storage type.

This setting doesn't apply to Amazon Aurora blue/green deployments.

" } } }, @@ -16779,6 +16795,7 @@ "UNAVAILABLE" ] }, + "TargetStorageType":{"type":"string"}, "TargetType":{ "type":"string", "enum":[ diff --git a/botocore/data/timestream-query/2018-11-01/service-2.json b/botocore/data/timestream-query/2018-11-01/service-2.json index 08f3fd5184..8d22d4ea2e 100644 --- a/botocore/data/timestream-query/2018-11-01/service-2.json +++ b/botocore/data/timestream-query/2018-11-01/service-2.json @@ -142,7 +142,7 @@ {"shape":"ValidationException"}, {"shape":"InvalidEndpointException"} ], - "documentation":"

You can use this API to run a scheduled query manually.

If you enabled QueryInsights, this API also returns insights and metrics related to the query that you executed as part of an Amazon SNS notification. QueryInsights helps with performance tuning of your query.

", + "documentation":"

You can use this API to run a scheduled query manually.

If you enabled QueryInsights, this API also returns insights and metrics related to the query that you executed as part of an Amazon SNS notification. QueryInsights helps with performance tuning of your query. For more information about QueryInsights, see Using query insights to optimize queries in Amazon Timestream.

", "endpointdiscovery":{"required":true}, "idempotent":true }, @@ -217,7 +217,7 @@ {"shape":"ValidationException"}, {"shape":"InvalidEndpointException"} ], - "documentation":"

Query is a synchronous operation that enables you to run a query against your Amazon Timestream data.

If you enabled QueryInsights, this API also returns insights and metrics related to the query that you executed. QueryInsights helps with performance tuning of your query.

The maximum number of Query API requests you're allowed to make with QueryInsights enabled is 1 query per second (QPS). If you exceed this query rate, it might result in throttling.

Query will time out after 60 seconds. You must update the default timeout in the SDK to support a timeout of 60 seconds. See the code sample for details.

Your query request will fail in the following cases:

", + "documentation":"

Query is a synchronous operation that enables you to run a query against your Amazon Timestream data.

If you enabled QueryInsights, this API also returns insights and metrics related to the query that you executed. QueryInsights helps with performance tuning of your query. For more information about QueryInsights, see Using query insights to optimize queries in Amazon Timestream.

The maximum number of Query API requests you're allowed to make with QueryInsights enabled is 1 query per second (QPS). If you exceed this query rate, it might result in throttling.

Query will time out after 60 seconds. You must update the default timeout in the SDK to support a timeout of 60 seconds. See the code sample for details.

Your query request will fail in the following cases:

", "endpointdiscovery":{"required":true}, "idempotent":true }, @@ -300,10 +300,22 @@ "members":{ "Message":{"shape":"ServiceErrorMessage"} }, - "documentation":"

You are not authorized to perform this action.

", + "documentation":"

You do not have the necessary permissions to access the account settings.

", "exception":true, "synthetic":true }, + "AccountSettingsNotificationConfiguration":{ + "type":"structure", + "required":["RoleArn"], + "members":{ + "SnsConfiguration":{"shape":"SnsConfiguration"}, + "RoleArn":{ + "shape":"AmazonResourceName", + "documentation":"

An Amazon Resource Name (ARN) that grants Timestream permission to publish notifications. This field is only visible if SNS Topic is provided when updating the account settings.

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

Configuration settings for notifications related to account settings.

" + }, "AmazonResourceName":{ "type":"string", "max":2048, @@ -359,6 +371,13 @@ "type":"list", "member":{"shape":"ColumnInfo"} }, + "ComputeMode":{ + "type":"string", + "enum":[ + "ON_DEMAND", + "PROVISIONED" + ] + }, "ConflictException":{ "type":"structure", "members":{ @@ -481,11 +500,15 @@ "members":{ "MaxQueryTCU":{ "shape":"MaxQueryCapacity", - "documentation":"

The maximum number of Timestream compute units (TCUs) the service will use at any point in time to serve your queries.

" + "documentation":"

The maximum number of Timestream compute units (TCUs) the service will use at any point in time to serve your queries. To run queries, you must set a minimum capacity of 4 TCU. You can set the maximum number of TCU in multiples of 4, for example, 4, 8, 16, 32, and so on. This configuration is applicable only for on-demand usage of (TCUs).

" }, "QueryPricingModel":{ "shape":"QueryPricingModel", - "documentation":"

The pricing model for queries in your account.

" + "documentation":"

The pricing model for queries in your account.

The QueryPricingModel parameter is used by several Timestream operations; however, the UpdateAccountSettings API operation doesn't recognize any values other than COMPUTE_UNITS.

" + }, + "QueryCompute":{ + "shape":"QueryComputeResponse", + "documentation":"

An object that contains the usage settings for Timestream Compute Units (TCUs) in your account for the query workload.

" } } }, @@ -656,7 +679,7 @@ "members":{ "Message":{"shape":"ErrorMessage"} }, - "documentation":"

The service was unable to fully process this request because of an internal server error.

", + "documentation":"

An internal server error occurred while processing the request.

", "exception":true }, "InvalidEndpointException":{ @@ -664,9 +687,35 @@ "members":{ "Message":{"shape":"ErrorMessage"} }, - "documentation":"

The requested endpoint was not valid.

", + "documentation":"

The requested endpoint is invalid.

", "exception":true }, + "LastUpdate":{ + "type":"structure", + "members":{ + "TargetQueryTCU":{ + "shape":"QueryTCU", + "documentation":"

The number of TimeStream Compute Units (TCUs) requested in the last account settings update.

" + }, + "Status":{ + "shape":"LastUpdateStatus", + "documentation":"

The status of the last update. Can be either PENDING, FAILED, or SUCCEEDED.

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

Error message describing the last account settings update status, visible only if an error occurred.

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

Configuration object that contains the most recent account settings update, visible only if settings have been updated previously.

" + }, + "LastUpdateStatus":{ + "type":"string", + "enum":[ + "PENDING", + "FAILED", + "SUCCEEDED" + ] + }, "ListScheduledQueriesRequest":{ "type":"structure", "members":{ @@ -838,7 +887,7 @@ "members":{ "SnsConfiguration":{ "shape":"SnsConfiguration", - "documentation":"

Details on SNS configuration.

" + "documentation":"

Details about the Amazon Simple Notification Service (SNS) configuration. This field is visible only when SNS Topic is provided when updating the account settings.

" } }, "documentation":"

Notification configuration for a scheduled query. A notification is sent by Timestream when a scheduled query is created, its state is updated or when it is deleted.

" @@ -912,6 +961,67 @@ } } }, + "ProvisionedCapacityRequest":{ + "type":"structure", + "required":["TargetQueryTCU"], + "members":{ + "TargetQueryTCU":{ + "shape":"QueryTCU", + "documentation":"

The target compute capacity for querying data, specified in Timestream Compute Units (TCUs).

" + }, + "NotificationConfiguration":{ + "shape":"AccountSettingsNotificationConfiguration", + "documentation":"

Configuration settings for notifications related to the provisioned capacity update.

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

A request to update the provisioned capacity settings for querying data.

" + }, + "ProvisionedCapacityResponse":{ + "type":"structure", + "members":{ + "ActiveQueryTCU":{ + "shape":"QueryTCU", + "documentation":"

The number of Timestream Compute Units (TCUs) provisioned in the account. This field is only visible when the compute mode is PROVISIONED.

" + }, + "NotificationConfiguration":{ + "shape":"AccountSettingsNotificationConfiguration", + "documentation":"

An object that contains settings for notifications that are sent whenever the provisioned capacity settings are modified. This field is only visible when the compute mode is PROVISIONED.

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

Information about the last update to the provisioned capacity settings.

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

The response to a request to update the provisioned capacity settings for querying data.

" + }, + "QueryComputeRequest":{ + "type":"structure", + "members":{ + "ComputeMode":{ + "shape":"ComputeMode", + "documentation":"

The mode in which Timestream Compute Units (TCUs) are allocated and utilized within an account. Note that in the Asia Pacific (Mumbai) region, the API operation only recognizes the value PROVISIONED.

" + }, + "ProvisionedCapacity":{ + "shape":"ProvisionedCapacityRequest", + "documentation":"

Configuration object that contains settings for provisioned Timestream Compute Units (TCUs) in your account.

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

A request to retrieve or update the compute capacity settings for querying data.

" + }, + "QueryComputeResponse":{ + "type":"structure", + "members":{ + "ComputeMode":{ + "shape":"ComputeMode", + "documentation":"

The mode in which Timestream Compute Units (TCUs) are allocated and utilized within an account. Note that in the Asia Pacific (Mumbai) region, the API operation only recognizes the value PROVISIONED.

" + }, + "ProvisionedCapacity":{ + "shape":"ProvisionedCapacityResponse", + "documentation":"

Configuration object that contains settings for provisioned Timestream Compute Units (TCUs) in your account.

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

The response to a request to retrieve or update the compute capacity settings for querying data.

" + }, "QueryExecutionException":{ "type":"structure", "members":{ @@ -1108,6 +1218,7 @@ "min":1, "sensitive":true }, + "QueryTCU":{"type":"integer"}, "QueryTemporalRange":{ "type":"structure", "members":{ @@ -1630,7 +1741,7 @@ "members":{ "Message":{"shape":"ErrorMessage"} }, - "documentation":"

The request was denied due to request throttling.

", + "documentation":"

The request was throttled due to excessive requests.

", "exception":true }, "Time":{"type":"timestamp"}, @@ -1760,11 +1871,15 @@ "members":{ "MaxQueryTCU":{ "shape":"MaxQueryCapacity", - "documentation":"

The maximum number of compute units the service will use at any point in time to serve your queries. To run queries, you must set a minimum capacity of 4 TCU. You can set the maximum number of TCU in multiples of 4, for example, 4, 8, 16, 32, and so on.

The maximum value supported for MaxQueryTCU is 1000. To request an increase to this soft limit, contact Amazon Web Services Support. For information about the default quota for maxQueryTCU, see Default quotas.

" + "documentation":"

The maximum number of compute units the service will use at any point in time to serve your queries. To run queries, you must set a minimum capacity of 4 TCU. You can set the maximum number of TCU in multiples of 4, for example, 4, 8, 16, 32, and so on. The maximum value supported for MaxQueryTCU is 1000. To request an increase to this soft limit, contact Amazon Web Services Support. For information about the default quota for maxQueryTCU, see Default quotas. This configuration is applicable only for on-demand usage of Timestream Compute Units (TCUs).

The maximum value supported for MaxQueryTCU is 1000. To request an increase to this soft limit, contact Amazon Web Services Support. For information about the default quota for maxQueryTCU, see Default quotas.

" }, "QueryPricingModel":{ "shape":"QueryPricingModel", "documentation":"

The pricing model for queries in an account.

The QueryPricingModel parameter is used by several Timestream operations; however, the UpdateAccountSettings API operation doesn't recognize any values other than COMPUTE_UNITS.

" + }, + "QueryCompute":{ + "shape":"QueryComputeRequest", + "documentation":"

Modifies the query compute settings configured in your account, including the query pricing model and provisioned Timestream Compute Units (TCUs) in your account.

This API is idempotent, meaning that making the same request multiple times will have the same effect as making the request once.

" } } }, @@ -1778,6 +1893,10 @@ "QueryPricingModel":{ "shape":"QueryPricingModel", "documentation":"

The pricing model for an account.

" + }, + "QueryCompute":{ + "shape":"QueryComputeResponse", + "documentation":"

Confirms the updated account settings for querying data in your account.

" } } }, diff --git a/botocore/data/workspaces-web/2020-07-08/paginators-1.json b/botocore/data/workspaces-web/2020-07-08/paginators-1.json index 14b5114c40..73743e3455 100644 --- a/botocore/data/workspaces-web/2020-07-08/paginators-1.json +++ b/botocore/data/workspaces-web/2020-07-08/paginators-1.json @@ -5,6 +5,12 @@ "output_token": "nextToken", "limit_key": "maxResults", "result_key": "sessions" + }, + "ListDataProtectionSettings": { + "input_token": "nextToken", + "output_token": "nextToken", + "limit_key": "maxResults", + "result_key": "dataProtectionSettings" } } } diff --git a/botocore/data/workspaces-web/2020-07-08/service-2.json b/botocore/data/workspaces-web/2020-07-08/service-2.json index 8fc91d9a90..4f4b3490ad 100644 --- a/botocore/data/workspaces-web/2020-07-08/service-2.json +++ b/botocore/data/workspaces-web/2020-07-08/service-2.json @@ -34,6 +34,26 @@ "documentation":"

Associates a browser settings resource with a web portal.

", "idempotent":true }, + "AssociateDataProtectionSettings":{ + "name":"AssociateDataProtectionSettings", + "http":{ + "method":"PUT", + "requestUri":"/portals/{portalArn+}/dataProtectionSettings", + "responseCode":200 + }, + "input":{"shape":"AssociateDataProtectionSettingsRequest"}, + "output":{"shape":"AssociateDataProtectionSettingsResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ValidationException"}, + {"shape":"ConflictException"} + ], + "documentation":"

Associates a data protection settings resource with a web portal.

", + "idempotent":true + }, "AssociateIpAccessSettings":{ "name":"AssociateIpAccessSettings", "http":{ @@ -154,6 +174,26 @@ ], "documentation":"

Creates a browser settings resource that can be associated with a web portal. Once associated with a web portal, browser settings control how the browser will behave once a user starts a streaming session for the web portal.

" }, + "CreateDataProtectionSettings":{ + "name":"CreateDataProtectionSettings", + "http":{ + "method":"POST", + "requestUri":"/dataProtectionSettings", + "responseCode":200 + }, + "input":{"shape":"CreateDataProtectionSettingsRequest"}, + "output":{"shape":"CreateDataProtectionSettingsResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ServiceQuotaExceededException"}, + {"shape":"ValidationException"}, + {"shape":"ConflictException"} + ], + "documentation":"

Creates a data protection settings resource that can be associated with a web portal.

" + }, "CreateIdentityProvider":{ "name":"CreateIdentityProvider", "http":{ @@ -308,6 +348,25 @@ "documentation":"

Deletes browser settings.

", "idempotent":true }, + "DeleteDataProtectionSettings":{ + "name":"DeleteDataProtectionSettings", + "http":{ + "method":"DELETE", + "requestUri":"/dataProtectionSettings/{dataProtectionSettingsArn+}", + "responseCode":200 + }, + "input":{"shape":"DeleteDataProtectionSettingsRequest"}, + "output":{"shape":"DeleteDataProtectionSettingsResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ValidationException"}, + {"shape":"ConflictException"} + ], + "documentation":"

Deletes data protection settings.

", + "idempotent":true + }, "DeleteIdentityProvider":{ "name":"DeleteIdentityProvider", "http":{ @@ -461,6 +520,26 @@ "documentation":"

Disassociates browser settings from a web portal.

", "idempotent":true }, + "DisassociateDataProtectionSettings":{ + "name":"DisassociateDataProtectionSettings", + "http":{ + "method":"DELETE", + "requestUri":"/portals/{portalArn+}/dataProtectionSettings", + "responseCode":200 + }, + "input":{"shape":"DisassociateDataProtectionSettingsRequest"}, + "output":{"shape":"DisassociateDataProtectionSettingsResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ValidationException"}, + {"shape":"ConflictException"} + ], + "documentation":"

Disassociates data protection settings from a web portal.

", + "idempotent":true + }, "DisassociateIpAccessSettings":{ "name":"DisassociateIpAccessSettings", "http":{ @@ -598,6 +677,24 @@ ], "documentation":"

Gets browser settings.

" }, + "GetDataProtectionSettings":{ + "name":"GetDataProtectionSettings", + "http":{ + "method":"GET", + "requestUri":"/dataProtectionSettings/{dataProtectionSettingsArn+}", + "responseCode":200 + }, + "input":{"shape":"GetDataProtectionSettingsRequest"}, + "output":{"shape":"GetDataProtectionSettingsResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ValidationException"} + ], + "documentation":"

Gets the data protection settings.

" + }, "GetIdentityProvider":{ "name":"GetIdentityProvider", "http":{ @@ -795,6 +892,23 @@ ], "documentation":"

Retrieves a list of browser settings.

" }, + "ListDataProtectionSettings":{ + "name":"ListDataProtectionSettings", + "http":{ + "method":"GET", + "requestUri":"/dataProtectionSettings", + "responseCode":200 + }, + "input":{"shape":"ListDataProtectionSettingsRequest"}, + "output":{"shape":"ListDataProtectionSettingsResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ValidationException"} + ], + "documentation":"

Retrieves a list of data protection settings.

" + }, "ListIdentityProviders":{ "name":"ListIdentityProviders", "http":{ @@ -1024,6 +1138,24 @@ ], "documentation":"

Updates browser settings.

" }, + "UpdateDataProtectionSettings":{ + "name":"UpdateDataProtectionSettings", + "http":{ + "method":"PATCH", + "requestUri":"/dataProtectionSettings/{dataProtectionSettingsArn+}", + "responseCode":200 + }, + "input":{"shape":"UpdateDataProtectionSettingsRequest"}, + "output":{"shape":"UpdateDataProtectionSettingsResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ThrottlingException"}, + {"shape":"ValidationException"} + ], + "documentation":"

Updates data protection settings.

" + }, "UpdateIdentityProvider":{ "name":"UpdateIdentityProvider", "http":{ @@ -1216,6 +1348,44 @@ } } }, + "AssociateDataProtectionSettingsRequest":{ + "type":"structure", + "required":[ + "dataProtectionSettingsArn", + "portalArn" + ], + "members":{ + "dataProtectionSettingsArn":{ + "shape":"ARN", + "documentation":"

The ARN of the data protection settings.

", + "location":"querystring", + "locationName":"dataProtectionSettingsArn" + }, + "portalArn":{ + "shape":"ARN", + "documentation":"

The ARN of the web portal.

", + "location":"uri", + "locationName":"portalArn" + } + } + }, + "AssociateDataProtectionSettingsResponse":{ + "type":"structure", + "required":[ + "dataProtectionSettingsArn", + "portalArn" + ], + "members":{ + "dataProtectionSettingsArn":{ + "shape":"ARN", + "documentation":"

The ARN of the data protection settings resource.

" + }, + "portalArn":{ + "shape":"ARN", + "documentation":"

The ARN of the web portal.

" + } + } + }, "AssociateIpAccessSettingsRequest":{ "type":"structure", "required":[ @@ -1466,6 +1636,13 @@ "type":"string", "enum":["Chrome"] }, + "BuiltInPatternId":{ + "type":"string", + "max":50, + "min":1, + "pattern":"^[_\\-\\d\\w]+$", + "sensitive":true + }, "Certificate":{ "type":"structure", "members":{ @@ -1552,6 +1729,12 @@ "max":512, "min":1 }, + "ConfidenceLevel":{ + "type":"integer", + "box":true, + "max":3, + "min":1 + }, "ConflictException":{ "type":"structure", "members":{ @@ -1670,6 +1853,50 @@ } } }, + "CreateDataProtectionSettingsRequest":{ + "type":"structure", + "members":{ + "additionalEncryptionContext":{ + "shape":"EncryptionContextMap", + "documentation":"

Additional encryption context of the data protection settings.

" + }, + "clientToken":{ + "shape":"ClientToken", + "documentation":"

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. Idempotency ensures that an API request completes only once. With an idempotent request, if the original request completes successfully, subsequent retries with the same client token returns the result from the original successful request.

If you do not specify a client token, one is automatically generated by the Amazon Web Services SDK.

", + "idempotencyToken":true + }, + "customerManagedKey":{ + "shape":"keyArn", + "documentation":"

The custom managed key of the data protection settings.

" + }, + "description":{ + "shape":"DescriptionSafe", + "documentation":"

The description of the data protection settings.

" + }, + "displayName":{ + "shape":"DisplayNameSafe", + "documentation":"

The display name of the data protection settings.

" + }, + "inlineRedactionConfiguration":{ + "shape":"InlineRedactionConfiguration", + "documentation":"

The inline redaction configuration of the data protection settings that will be applied to all sessions.

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

The tags to add to the data protection settings resource. A tag is a key-value pair.

" + } + } + }, + "CreateDataProtectionSettingsResponse":{ + "type":"structure", + "required":["dataProtectionSettingsArn"], + "members":{ + "dataProtectionSettingsArn":{ + "shape":"ARN", + "documentation":"

The ARN of the data protection settings resource.

" + } + } + }, "CreateIdentityProviderRequest":{ "type":"structure", "required":[ @@ -1990,6 +2217,98 @@ } } }, + "CustomPattern":{ + "type":"structure", + "required":[ + "patternName", + "patternRegex" + ], + "members":{ + "keywordRegex":{ + "shape":"Regex", + "documentation":"

The keyword regex for the customer pattern. After there is a match to the pattern regex, the keyword regex is used to search within the proximity of the match. If there is a keyword match, then the match is confirmed. If no keyword regex is provided, the pattern regex match will automatically be confirmed. The format must follow JavaScript regex format. The pattern must be enclosed between slashes, and can have flags behind the second slash. For example, “/ab+c/gi”

" + }, + "patternDescription":{ + "shape":"DescriptionSafe", + "documentation":"

The pattern description for the customer pattern.

" + }, + "patternName":{ + "shape":"PatternName", + "documentation":"

The pattern name for the custom pattern.

" + }, + "patternRegex":{ + "shape":"Regex", + "documentation":"

The pattern regex for the customer pattern. The format must follow JavaScript regex format. The pattern must be enclosed between slashes, and can have flags behind the second slash. For example: “/ab+c/gi”.

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

The pattern configuration for redacting custom data types in session.

" + }, + "DataProtectionSettings":{ + "type":"structure", + "required":["dataProtectionSettingsArn"], + "members":{ + "additionalEncryptionContext":{ + "shape":"EncryptionContextMap", + "documentation":"

The additional encryption context of the data protection settings.

" + }, + "associatedPortalArns":{ + "shape":"ArnList", + "documentation":"

A list of web portal ARNs that this data protection settings resource is associated with.

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

The creation date timestamp of the data protection settings.

" + }, + "customerManagedKey":{ + "shape":"keyArn", + "documentation":"

The customer managed key used to encrypt sensitive information in the data protection settings.

" + }, + "dataProtectionSettingsArn":{ + "shape":"ARN", + "documentation":"

The ARN of the data protection settings resource.

" + }, + "description":{ + "shape":"DescriptionSafe", + "documentation":"

The description of the data protection settings.

" + }, + "displayName":{ + "shape":"DisplayNameSafe", + "documentation":"

The display name of the data protection settings.

" + }, + "inlineRedactionConfiguration":{ + "shape":"InlineRedactionConfiguration", + "documentation":"

The inline redaction configuration for the data protection settings.

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

The data protection settings resource that can be associated with a web portal.

" + }, + "DataProtectionSettingsList":{ + "type":"list", + "member":{"shape":"DataProtectionSettingsSummary"} + }, + "DataProtectionSettingsSummary":{ + "type":"structure", + "required":["dataProtectionSettingsArn"], + "members":{ + "creationDate":{ + "shape":"Timestamp", + "documentation":"

The creation date timestamp of the data protection settings.

" + }, + "dataProtectionSettingsArn":{ + "shape":"ARN", + "documentation":"

The ARN of the data protection settings.

" + }, + "description":{ + "shape":"DescriptionSafe", + "documentation":"

The description of the data protection settings.

" + }, + "displayName":{ + "shape":"DisplayNameSafe", + "documentation":"

The display name of the data protection settings.

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

The summary of the data protection settings.

" + }, "DeleteBrowserSettingsRequest":{ "type":"structure", "required":["browserSettingsArn"], @@ -2007,6 +2326,23 @@ "members":{ } }, + "DeleteDataProtectionSettingsRequest":{ + "type":"structure", + "required":["dataProtectionSettingsArn"], + "members":{ + "dataProtectionSettingsArn":{ + "shape":"ARN", + "documentation":"

The ARN of the data protection settings.

", + "location":"uri", + "locationName":"dataProtectionSettingsArn" + } + } + }, + "DeleteDataProtectionSettingsResponse":{ + "type":"structure", + "members":{ + } + }, "DeleteIdentityProviderRequest":{ "type":"structure", "required":["identityProviderArn"], @@ -2133,6 +2469,13 @@ "pattern":"^.+$", "sensitive":true }, + "DescriptionSafe":{ + "type":"string", + "max":256, + "min":1, + "pattern":"^[ _\\-\\d\\w]+$", + "sensitive":true + }, "DisassociateBrowserSettingsRequest":{ "type":"structure", "required":["portalArn"], @@ -2150,6 +2493,23 @@ "members":{ } }, + "DisassociateDataProtectionSettingsRequest":{ + "type":"structure", + "required":["portalArn"], + "members":{ + "portalArn":{ + "shape":"ARN", + "documentation":"

The ARN of the web portal.

", + "location":"uri", + "locationName":"portalArn" + } + } + }, + "DisassociateDataProtectionSettingsResponse":{ + "type":"structure", + "members":{ + } + }, "DisassociateIpAccessSettingsRequest":{ "type":"structure", "required":["portalArn"], @@ -2248,6 +2608,13 @@ "pattern":"^.+$", "sensitive":true }, + "DisplayNameSafe":{ + "type":"string", + "max":64, + "min":1, + "pattern":"^[ _\\-\\d\\w]+$", + "sensitive":true + }, "EnabledType":{ "type":"string", "enum":[ @@ -2309,6 +2676,27 @@ } } }, + "GetDataProtectionSettingsRequest":{ + "type":"structure", + "required":["dataProtectionSettingsArn"], + "members":{ + "dataProtectionSettingsArn":{ + "shape":"ARN", + "documentation":"

The ARN of the data protection settings.

", + "location":"uri", + "locationName":"dataProtectionSettingsArn" + } + } + }, + "GetDataProtectionSettingsResponse":{ + "type":"structure", + "members":{ + "dataProtectionSettings":{ + "shape":"DataProtectionSettings", + "documentation":"

The data protection settings.

" + } + } + }, "GetIdentityProviderRequest":{ "type":"structure", "required":["identityProviderArn"], @@ -2547,6 +2935,12 @@ } } }, + "GlobalInlineRedactionUrls":{ + "type":"list", + "member":{"shape":"InlineRedactionUrl"}, + "max":100, + "min":1 + }, "IdentityProvider":{ "type":"structure", "required":["identityProviderArn"], @@ -2623,6 +3017,77 @@ "max":60, "min":0 }, + "InlineRedactionConfiguration":{ + "type":"structure", + "required":["inlineRedactionPatterns"], + "members":{ + "globalConfidenceLevel":{ + "shape":"ConfidenceLevel", + "documentation":"

The global confidence level for the inline redaction configuration. This indicates the certainty of data type matches in the redaction process. Confidence level 3 means high confidence, and requires a formatted text pattern match in order for content to be redacted. Confidence level 2 means medium confidence, and redaction considers both formatted and unformatted text, and adds keyword associate to the logic. Confidence level 1 means low confidence, and redaction is enforced for both formatted pattern + unformatted pattern without keyword. This is applied to patterns that do not have a pattern-level confidence level. Defaults to confidence level 2.

" + }, + "globalEnforcedUrls":{ + "shape":"GlobalInlineRedactionUrls", + "documentation":"

The global enforced URL configuration for the inline redaction configuration. This is applied to patterns that do not have a pattern-level enforced URL list.

" + }, + "globalExemptUrls":{ + "shape":"GlobalInlineRedactionUrls", + "documentation":"

The global exempt URL configuration for the inline redaction configuration. This is applied to patterns that do not have a pattern-level exempt URL list.

" + }, + "inlineRedactionPatterns":{ + "shape":"InlineRedactionPatterns", + "documentation":"

The inline redaction patterns to be enabled for the inline redaction configuration.

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

The configuration for in-session inline redaction.

" + }, + "InlineRedactionPattern":{ + "type":"structure", + "required":["redactionPlaceHolder"], + "members":{ + "builtInPatternId":{ + "shape":"BuiltInPatternId", + "documentation":"

The built-in pattern from the list of preconfigured patterns. Either a customPattern or builtInPatternId is required.

" + }, + "confidenceLevel":{ + "shape":"ConfidenceLevel", + "documentation":"

The confidence level for inline redaction pattern. This indicates the certainty of data type matches in the redaction process. Confidence level 3 means high confidence, and requires a formatted text pattern match in order for content to be redacted. Confidence level 2 means medium confidence, and redaction considers both formatted and unformatted text, and adds keyword associate to the logic. Confidence level 1 means low confidence, and redaction is enforced for both formatted pattern + unformatted pattern without keyword. This overrides the global confidence level.

" + }, + "customPattern":{ + "shape":"CustomPattern", + "documentation":"

>The configuration for a custom pattern. Either a customPattern or builtInPatternId is required.

" + }, + "enforcedUrls":{ + "shape":"InlineRedactionUrls", + "documentation":"

The enforced URL configuration for the inline redaction pattern. This will override the global enforced URL configuration.

" + }, + "exemptUrls":{ + "shape":"InlineRedactionUrls", + "documentation":"

The exempt URL configuration for the inline redaction pattern. This will override the global exempt URL configuration for the inline redaction pattern.

" + }, + "redactionPlaceHolder":{ + "shape":"RedactionPlaceHolder", + "documentation":"

The redaction placeholder that will replace the redacted text in session for the inline redaction pattern.

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

The set of patterns that determine the data types redacted in session.

" + }, + "InlineRedactionPatterns":{ + "type":"list", + "member":{"shape":"InlineRedactionPattern"}, + "max":150, + "min":0 + }, + "InlineRedactionUrl":{ + "type":"string", + "pattern":"^((([a-zA-Z][a-zA-Z0-9+.-]*):\\/\\/(\\*|[\\w%._\\-\\+~#=@]+)?(\\/[^@\\s]*)?(?:\\?([^*\\s]+(?:\\*?)))?)|(\\*|[\\w%._\\-\\+~#=@]+\\.[\\w%._\\-\\+~#=@]+)(?::(\\d{1,5}))?(\\/[^@\\s]*)?(?:\\?([^*\\s]+(?:\\*?)))?|(([a-zA-Z][a-zA-Z0-9+.-]*):(\\/\\/)?\\*))$", + "sensitive":true + }, + "InlineRedactionUrls":{ + "type":"list", + "member":{"shape":"InlineRedactionUrl"}, + "max":20, + "min":1 + }, "InstanceType":{ "type":"string", "enum":[ @@ -2791,6 +3256,36 @@ } } }, + "ListDataProtectionSettingsRequest":{ + "type":"structure", + "members":{ + "maxResults":{ + "shape":"MaxResults", + "documentation":"

The maximum number of results to be included in the next page.

", + "location":"querystring", + "locationName":"maxResults" + }, + "nextToken":{ + "shape":"PaginationToken", + "documentation":"

The pagination token used to retrieve the next page of results for this operation.

", + "location":"querystring", + "locationName":"nextToken" + } + } + }, + "ListDataProtectionSettingsResponse":{ + "type":"structure", + "members":{ + "dataProtectionSettings":{ + "shape":"DataProtectionSettingsList", + "documentation":"

The data protection settings.

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

The pagination token used to retrieve the next page of results for this operation.

" + } + } + }, "ListIdentityProvidersRequest":{ "type":"structure", "required":["portalArn"], @@ -3196,6 +3691,13 @@ "min":1, "pattern":"^\\S+$" }, + "PatternName":{ + "type":"string", + "max":20, + "min":1, + "pattern":"^[_\\-\\d\\w]+$", + "sensitive":true + }, "Portal":{ "type":"structure", "required":["portalArn"], @@ -3224,6 +3726,10 @@ "shape":"keyArn", "documentation":"

The customer managed key used to encrypt sensitive information in the portal.

" }, + "dataProtectionSettingsArn":{ + "shape":"ARN", + "documentation":"

The ARN of the data protection settings.

" + }, "displayName":{ "shape":"DisplayName", "documentation":"

The name of the web portal.

" @@ -3323,6 +3829,10 @@ "shape":"Timestamp", "documentation":"

The creation date of the web portal.

" }, + "dataProtectionSettingsArn":{ + "shape":"ARN", + "documentation":"

The ARN of the data protection settings.

" + }, "displayName":{ "shape":"DisplayName", "documentation":"

The name of the web portal.

" @@ -3375,6 +3885,39 @@ "documentation":"

The summary of the portal.

" }, "QuotaCode":{"type":"string"}, + "RedactionPlaceHolder":{ + "type":"structure", + "required":["redactionPlaceHolderType"], + "members":{ + "redactionPlaceHolderText":{ + "shape":"RedactionPlaceHolderText", + "documentation":"

The redaction placeholder text that will replace the redacted text in session for the custom text redaction placeholder type.

" + }, + "redactionPlaceHolderType":{ + "shape":"RedactionPlaceHolderType", + "documentation":"

The redaction placeholder type that will replace the redacted text in session.

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

The redaction placeholder that will replace the redacted text in session.

" + }, + "RedactionPlaceHolderText":{ + "type":"string", + "max":20, + "min":1, + "pattern":"^[*_\\-\\d\\w]+$", + "sensitive":true + }, + "RedactionPlaceHolderType":{ + "type":"string", + "enum":["CustomText"] + }, + "Regex":{ + "type":"string", + "max":300, + "min":0, + "pattern":"^\\/((?:[^\\n])+)\\/([gimsuyvd]{0,8})$", + "sensitive":true + }, "RendererType":{ "type":"string", "enum":["AppStream"] @@ -3771,6 +4314,45 @@ } } }, + "UpdateDataProtectionSettingsRequest":{ + "type":"structure", + "required":["dataProtectionSettingsArn"], + "members":{ + "clientToken":{ + "shape":"ClientToken", + "documentation":"

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. Idempotency ensures that an API request completes only once. With an idempotent request, if the original request completes successfully, subsequent retries with the same client token return the result from the original successful request.

If you do not specify a client token, one is automatically generated by the Amazon Web Services SDK.

", + "idempotencyToken":true + }, + "dataProtectionSettingsArn":{ + "shape":"ARN", + "documentation":"

The ARN of the data protection settings.

", + "location":"uri", + "locationName":"dataProtectionSettingsArn" + }, + "description":{ + "shape":"DescriptionSafe", + "documentation":"

The description of the data protection settings.

" + }, + "displayName":{ + "shape":"DisplayNameSafe", + "documentation":"

The display name of the data protection settings.

" + }, + "inlineRedactionConfiguration":{ + "shape":"InlineRedactionConfiguration", + "documentation":"

The inline redaction configuration of the data protection settings that will be applied to all sessions.

" + } + } + }, + "UpdateDataProtectionSettingsResponse":{ + "type":"structure", + "required":["dataProtectionSettings"], + "members":{ + "dataProtectionSettings":{ + "shape":"DataProtectionSettings", + "documentation":"

The data protection settings.

" + } + } + }, "UpdateIdentityProviderRequest":{ "type":"structure", "required":["identityProviderArn"], diff --git a/botocore/data/workspaces/2015-04-08/service-2.json b/botocore/data/workspaces/2015-04-08/service-2.json index 7b23663543..4e6df230e7 100644 --- a/botocore/data/workspaces/2015-04-08/service-2.json +++ b/botocore/data/workspaces/2015-04-08/service-2.json @@ -293,7 +293,7 @@ {"shape":"ResourceLimitExceededException"}, {"shape":"InvalidParameterValuesException"} ], - "documentation":"

Creates one or more WorkSpaces.

This operation is asynchronous and returns before the WorkSpaces are created.

" + "documentation":"

Creates one or more WorkSpaces.

This operation is asynchronous and returns before the WorkSpaces are created.

" }, "CreateWorkspacesPool":{ "name":"CreateWorkspacesPool", @@ -1435,7 +1435,7 @@ }, "ClientToken":{ "shape":"ClientToken", - "documentation":"

A string of up to 64 ASCII characters that Amazon EFS uses to ensure idempotent creation.

" + "documentation":"

A string of up to 64 ASCII characters that Amazon WorkSpaces uses to ensure idempotent creation.

" } } }, @@ -2300,7 +2300,7 @@ }, "ClientToken":{ "shape":"ClientToken", - "documentation":"

A string of up to 64 ASCII characters that Amazon EFS uses to ensure idempotent creation.

" + "documentation":"

A string of up to 64 ASCII characters that Amazon WorkSpaces uses to ensure idempotent creation.

" } } }, @@ -2837,7 +2837,7 @@ }, "ClientToken":{ "shape":"ClientToken", - "documentation":"

A string of up to 64 ASCII characters that Amazon EFS uses to ensure idempotent creation.

" + "documentation":"

A string of up to 64 ASCII characters that Amazon WorkSpaces uses to ensure idempotent creation.

" } } }, @@ -3918,7 +3918,7 @@ }, "DomainName":{ "type":"string", - "pattern":"^([a-zA-Z0-9]+[\\\\.-])+([a-zA-Z0-9])+$" + "pattern":"^([a-zA-Z0-9]+[.-])+([a-zA-Z0-9])+$" }, "Ec2ImageId":{ "type":"string", @@ -4214,7 +4214,7 @@ }, "IngestionProcess":{ "shape":"WorkspaceImageIngestionProcess", - "documentation":"

The ingestion process to be used when importing the image, depending on which protocol you want to use for your BYOL Workspace image, either PCoIP, WorkSpaces Streaming Protocol (WSP), or bring your own protocol (BYOP). To use WSP, specify a value that ends in _WSP. To use PCoIP, specify a value that does not end in _WSP. To use BYOP, specify a value that ends in _BYOP.

For non-GPU-enabled bundles (bundles other than Graphics or GraphicsPro), specify BYOL_REGULAR, BYOL_REGULAR_WSP, or BYOL_REGULAR_BYOP, depending on the protocol.

The BYOL_REGULAR_BYOP and BYOL_GRAPHICS_G4DN_BYOP values are only supported by Amazon WorkSpaces Core. Contact your account team to be allow-listed to use these values. For more information, see Amazon WorkSpaces Core.

" + "documentation":"

The ingestion process to be used when importing the image, depending on which protocol you want to use for your BYOL Workspace image, either PCoIP, DCV, or bring your own protocol (BYOP). To use WSP, specify a value that ends in _DCV. To use PCoIP, specify a value that does not end in _DCV. To use BYOP, specify a value that ends in _BYOP.

For non-GPU-enabled bundles (bundles other than Graphics or GraphicsPro), specify BYOL_REGULAR, BYOL_REGULAR_DCV, or BYOL_REGULAR_BYOP, depending on the protocol.

The BYOL_REGULAR_BYOP and BYOL_GRAPHICS_G4DN_BYOP values are only supported by Amazon WorkSpaces Core. Contact your account team to be allow-listed to use these values. For more information, see Amazon WorkSpaces Core.

" }, "ImageName":{ "shape":"WorkspaceImageName", @@ -4230,7 +4230,7 @@ }, "Applications":{ "shape":"ApplicationList", - "documentation":"

If specified, the version of Microsoft Office to subscribe to. Valid only for Windows 10 and 11 BYOL images. For more information about subscribing to Office for BYOL images, see Bring Your Own Windows Desktop Licenses.

" + "documentation":"

If specified, the version of Microsoft Office to subscribe to. Valid only for Windows 10 and 11 BYOL images. For more information about subscribing to Office for BYOL images, see Bring Your Own Windows Desktop Licenses.

" } } }, @@ -4843,7 +4843,8 @@ "WINDOWS_SERVER_2016", "WINDOWS_SERVER_2019", "WINDOWS_SERVER_2022", - "RHEL_8" + "RHEL_8", + "ROCKY_8" ] }, "OperatingSystemNameList":{ @@ -6725,7 +6726,7 @@ }, "Protocols":{ "shape":"ProtocolList", - "documentation":"

The protocol. For more information, see Protocols for Amazon WorkSpaces.

" + "documentation":"

The protocol. For more information, see Protocols for Amazon WorkSpaces.

" }, "OperatingSystemName":{ "shape":"OperatingSystemName", diff --git a/docs/source/conf.py b/docs/source/conf.py index 317a05c025..339de14631 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -59,7 +59,7 @@ # The short X.Y version. version = '1.35.' # The full version, including alpha/beta/rc tags. -release = '1.35.65' +release = '1.35.66' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages.