From 5a5d367559684605f2019666c2158cb4d65e7932 Mon Sep 17 00:00:00 2001 From: aws-sdk-python-automation Date: Wed, 24 Jan 2024 19:14:04 +0000 Subject: [PATCH 1/2] Update to latest models --- .../next-release/api-change-ec2-33673.json | 5 + .../next-release/api-change-ecs-86206.json | 5 + .../api-change-outposts-54047.json | 5 + .../next-release/api-change-rds-22061.json | 5 + .../api-change-storagegateway-6273.json | 5 + botocore/data/ec2/2016-11-15/service-2.json | 30 +- botocore/data/ecs/2014-11-13/service-2.json | 21 +- .../2019-12-03/endpoint-rule-set-1.json | 44 +-- .../data/outposts/2019-12-03/service-2.json | 2 - botocore/data/rds/2014-10-31/service-2.json | 354 +++++++++++++++++- .../2013-06-30/endpoint-rule-set-1.json | 40 +- .../storagegateway/2013-06-30/service-2.json | 16 +- 12 files changed, 467 insertions(+), 65 deletions(-) create mode 100644 .changes/next-release/api-change-ec2-33673.json create mode 100644 .changes/next-release/api-change-ecs-86206.json create mode 100644 .changes/next-release/api-change-outposts-54047.json create mode 100644 .changes/next-release/api-change-rds-22061.json create mode 100644 .changes/next-release/api-change-storagegateway-6273.json diff --git a/.changes/next-release/api-change-ec2-33673.json b/.changes/next-release/api-change-ec2-33673.json new file mode 100644 index 0000000000..439e861405 --- /dev/null +++ b/.changes/next-release/api-change-ec2-33673.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``ec2``", + "description": "Introduced a new clientToken request parameter on CreateNetworkAcl and CreateRouteTable APIs. The clientToken parameter allows idempotent operations on the APIs." +} diff --git a/.changes/next-release/api-change-ecs-86206.json b/.changes/next-release/api-change-ecs-86206.json new file mode 100644 index 0000000000..a2658e0335 --- /dev/null +++ b/.changes/next-release/api-change-ecs-86206.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``ecs``", + "description": "Documentation updates for Amazon ECS." +} diff --git a/.changes/next-release/api-change-outposts-54047.json b/.changes/next-release/api-change-outposts-54047.json new file mode 100644 index 0000000000..e5b32a387a --- /dev/null +++ b/.changes/next-release/api-change-outposts-54047.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``outposts``", + "description": "DeviceSerialNumber parameter is now optional in StartConnection API" +} diff --git a/.changes/next-release/api-change-rds-22061.json b/.changes/next-release/api-change-rds-22061.json new file mode 100644 index 0000000000..a058bb7033 --- /dev/null +++ b/.changes/next-release/api-change-rds-22061.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``rds``", + "description": "This release adds support for Aurora Limitless Database." +} diff --git a/.changes/next-release/api-change-storagegateway-6273.json b/.changes/next-release/api-change-storagegateway-6273.json new file mode 100644 index 0000000000..4c8b340ac4 --- /dev/null +++ b/.changes/next-release/api-change-storagegateway-6273.json @@ -0,0 +1,5 @@ +{ + "type": "api-change", + "category": "``storagegateway``", + "description": "Add DeprecationDate and SoftwareVersion to response of ListGateways." +} diff --git a/botocore/data/ec2/2016-11-15/service-2.json b/botocore/data/ec2/2016-11-15/service-2.json index c3bf7edf5a..c9826397f8 100644 --- a/botocore/data/ec2/2016-11-15/service-2.json +++ b/botocore/data/ec2/2016-11-15/service-2.json @@ -9245,7 +9245,8 @@ "available", "information", "impaired", - "unavailable" + "unavailable", + "constrained" ] }, "AvailabilityZoneStringList":{ @@ -12595,7 +12596,7 @@ "members":{ "ClientToken":{ "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to ensure idempotency.

" + "documentation":"

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

" }, "DryRun":{ "shape":"Boolean", @@ -13674,7 +13675,7 @@ }, "ClientToken":{ "shape":"String", - "documentation":"

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to ensure idempotency.

Constraint: Maximum 64 ASCII characters.

", + "documentation":"

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

Constraint: Maximum 64 ASCII characters.

", "idempotencyToken":true }, "DryRun":{ @@ -13809,6 +13810,11 @@ "shape":"TagSpecificationList", "documentation":"

The tags to assign to the network ACL.

", "locationName":"TagSpecification" + }, + "ClientToken":{ + "shape":"String", + "documentation":"

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

", + "idempotencyToken":true } } }, @@ -13819,6 +13825,11 @@ "shape":"NetworkAcl", "documentation":"

Information about the network ACL.

", "locationName":"networkAcl" + }, + "ClientToken":{ + "shape":"String", + "documentation":"

Unique, case-sensitive identifier to ensure the idempotency of the request. Only returned if a client token was provided in the request.

", + "locationName":"clientToken" } } }, @@ -14384,6 +14395,11 @@ "shape":"TagSpecificationList", "documentation":"

The tags to assign to the route table.

", "locationName":"TagSpecification" + }, + "ClientToken":{ + "shape":"String", + "documentation":"

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

", + "idempotencyToken":true } } }, @@ -14394,6 +14410,11 @@ "shape":"RouteTable", "documentation":"

Information about the route table.

", "locationName":"routeTable" + }, + "ClientToken":{ + "shape":"String", + "documentation":"

Unique, case-sensitive identifier to ensure the idempotency of the request. Only returned if a client token was provided in the request.

", + "locationName":"clientToken" } } }, @@ -54690,7 +54711,8 @@ "type":"string", "enum":[ "pending", - "available" + "available", + "unavailable" ] }, "Subscription":{ diff --git a/botocore/data/ecs/2014-11-13/service-2.json b/botocore/data/ecs/2014-11-13/service-2.json index 174e2a494f..3b0cda1575 100644 --- a/botocore/data/ecs/2014-11-13/service-2.json +++ b/botocore/data/ecs/2014-11-13/service-2.json @@ -88,7 +88,7 @@ {"shape":"ServiceNotActiveException"}, {"shape":"NamespaceNotFoundException"} ], - "documentation":"

Create a task set in the specified cluster and service. This is used when a service uses the EXTERNAL deployment controller type. For more information, see Amazon ECS deployment types in the Amazon Elastic Container Service Developer Guide.

You can create a maximum of 5 tasks sets for a deployment.

" + "documentation":"

Create a task set in the specified cluster and service. This is used when a service uses the EXTERNAL deployment controller type. For more information, see Amazon ECS deployment types in the Amazon Elastic Container Service Developer Guide.

For information about the maximum number of task sets and otther quotas, see Amazon ECS service quotas in the Amazon Elastic Container Service Developer Guide.

" }, "DeleteAccountSetting":{ "name":"DeleteAccountSetting", @@ -1135,7 +1135,7 @@ "documentation":"

Whether the task's elastic network interface receives a public IP address. The default value is DISABLED.

" } }, - "documentation":"

An object representing the networking details for a task or service.

" + "documentation":"

An object representing the networking details for a task or service. For example awsvpcConfiguration={subnets=[\"subnet-12344321\"],securityGroups=[\"sg-12344321\"]}

" }, "BlockedException":{ "type":"structure", @@ -1687,7 +1687,7 @@ }, "ulimits":{ "shape":"UlimitList", - "documentation":"

A list of ulimits to set in the container. If a ulimit value is specified in a task definition, it overrides the default values set by Docker. This parameter maps to Ulimits in the Create a container section of the Docker Remote API and the --ulimit option to docker run. Valid naming values are displayed in the Ulimit data type.

Amazon ECS tasks hosted on Fargate use the default resource limit values set by the operating system with the exception of the nofile resource limit parameter which Fargate overrides. The nofile resource limit sets a restriction on the number of open files that a container can use. The default nofile soft limit is 1024 and the default hard limit is 4096.

This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version --format '{{.Server.APIVersion}}'

This parameter is not supported for Windows containers.

" + "documentation":"

A list of ulimits to set in the container. If a ulimit value is specified in a task definition, it overrides the default values set by Docker. This parameter maps to Ulimits in the Create a container section of the Docker Remote API and the --ulimit option to docker run. Valid naming values are displayed in the Ulimit data type.

Amazon ECS tasks hosted on Fargate use the default resource limit values set by the operating system with the exception of the nofile resource limit parameter which Fargate overrides. The nofile resource limit sets a restriction on the number of open files that a container can use. The default nofile soft limit is 1024 and the default hard limit is 65535.

This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version --format '{{.Server.APIVersion}}'

This parameter is not supported for Windows containers.

" }, "logConfiguration":{ "shape":"LogConfiguration", @@ -1740,7 +1740,7 @@ "documentation":"

The dependency condition of the container. The following are the available conditions and their behavior:

" } }, - "documentation":"

The dependencies defined for container startup and shutdown. A container can contain multiple dependencies. When a dependency is defined for container startup, for container shutdown it is reversed.

Your Amazon ECS container instances require at least version 1.26.0 of the container agent to use container dependencies. However, we recommend using the latest container agent version. For information about checking your agent version and updating to the latest version, see Updating the Amazon ECS Container Agent in the Amazon Elastic Container Service Developer Guide. If you're using an Amazon ECS-optimized Linux AMI, your instance needs at least version 1.26.0-1 of the ecs-init package. If your container instances are launched from version 20190301 or later, then they contain the required versions of the container agent and ecs-init. For more information, see Amazon ECS-optimized Linux AMI in the Amazon Elastic Container Service Developer Guide.

For tasks that use the Fargate launch type, the task or service requires the following platforms:

" + "documentation":"

The dependencies defined for container startup and shutdown. A container can contain multiple dependencies. When a dependency is defined for container startup, for container shutdown it is reversed.

Your Amazon ECS container instances require at least version 1.26.0 of the container agent to use container dependencies. However, we recommend using the latest container agent version. For information about checking your agent version and updating to the latest version, see Updating the Amazon ECS Container Agent in the Amazon Elastic Container Service Developer Guide. If you're using an Amazon ECS-optimized Linux AMI, your instance needs at least version 1.26.0-1 of the ecs-init package. If your container instances are launched from version 20190301 or later, then they contain the required versions of the container agent and ecs-init. For more information, see Amazon ECS-optimized Linux AMI in the Amazon Elastic Container Service Developer Guide.

For tasks that use the Fargate launch type, the task or service requires the following platforms:

For more information about how to create a container dependency, see Container dependency in the Amazon Elastic Container Service Developer Guide.

" }, "ContainerInstance":{ "type":"structure", @@ -2502,7 +2502,7 @@ }, "minimumHealthyPercent":{ "shape":"BoxedInteger", - "documentation":"

If a service is using the rolling update (ECS) deployment type, the minimumHealthyPercent represents a lower limit on the number of your service's tasks that must remain in the RUNNING state during a deployment, as a percentage of the desiredCount (rounded up to the nearest integer). This parameter enables you to deploy without using additional cluster capacity. For example, if your service has a desiredCount of four tasks and a minimumHealthyPercent of 50%, the service scheduler may stop two existing tasks to free up cluster capacity before starting two new tasks.

For services that do not use a load balancer, the following should be noted:

For services are that do use a load balancer, the following should be noted:

If a service is using either the blue/green (CODE_DEPLOY) or EXTERNAL deployment types and is running tasks that use the EC2 launch type, the minimum healthy percent value is set to the default value and is used to define the lower limit on the number of the tasks in the service that remain in the RUNNING state while the container instances are in the DRAINING state. If a service is using either the blue/green (CODE_DEPLOY) or EXTERNAL deployment types and is running tasks that use the Fargate launch type, the minimum healthy percent value is not used, although it is returned when describing your service.

" + "documentation":"

If a service is using the rolling update (ECS) deployment type, the minimumHealthyPercent represents a lower limit on the number of your service's tasks that must remain in the RUNNING state during a deployment, as a percentage of the desiredCount (rounded up to the nearest integer). This parameter enables you to deploy without using additional cluster capacity. For example, if your service has a desiredCount of four tasks and a minimumHealthyPercent of 50%, the service scheduler may stop two existing tasks to free up cluster capacity before starting two new tasks.

For services that do not use a load balancer, the following should be noted:

For services that do use a load balancer, the following should be noted:

If a service is using either the blue/green (CODE_DEPLOY) or EXTERNAL deployment types and is running tasks that use the EC2 launch type, the minimum healthy percent value is set to the default value and is used to define the lower limit on the number of the tasks in the service that remain in the RUNNING state while the container instances are in the DRAINING state. If a service is using either the blue/green (CODE_DEPLOY) or EXTERNAL deployment types and is running tasks that use the Fargate launch type, the minimum healthy percent value is not used, although it is returned when describing your service.

" }, "alarms":{ "shape":"DeploymentAlarms", @@ -5114,7 +5114,10 @@ "shape":"TimeoutConfiguration", "documentation":"

A reference to an object that represents the configured timeouts for Service Connect.

" }, - "tls":{"shape":"ServiceConnectTlsConfiguration"} + "tls":{ + "shape":"ServiceConnectTlsConfiguration", + "documentation":"

A reference to an object that represents a Transport Layer Security (TLS) configuration.

" + } }, "documentation":"

The Service Connect service object configuration. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

" }, @@ -5480,7 +5483,7 @@ }, "reason":{ "shape":"String", - "documentation":"

An optional message specified when a task is stopped. For example, if you're using a custom scheduler, you can use this parameter to specify the reason for stopping the task here, and the message appears in subsequent DescribeTasks API operations on this task. Up to 255 characters are allowed in this message.

" + "documentation":"

An optional message specified when a task is stopped. For example, if you're using a custom scheduler, you can use this parameter to specify the reason for stopping the task here, and the message appears in subsequent DescribeTasks API operations on this task.

" } } }, @@ -5833,7 +5836,7 @@ }, "stopCode":{ "shape":"TaskStopCode", - "documentation":"

The stop code indicating why a task was stopped. The stoppedReason might contain additional details.

For more information about stop code, see Stopped tasks error codes in the Amazon ECS User Guide.

The following are valid values:

" + "documentation":"

The stop code indicating why a task was stopped. The stoppedReason might contain additional details.

For more information about stop code, see Stopped tasks error codes in the Amazon ECS User Guide.

" }, "stoppedAt":{ "shape":"Timestamp", @@ -6358,7 +6361,7 @@ "documentation":"

The hard limit for the ulimit type.

" } }, - "documentation":"

The ulimit settings to pass to the container.

Amazon ECS tasks hosted on Fargate use the default resource limit values set by the operating system with the exception of the nofile resource limit parameter which Fargate overrides. The nofile resource limit sets a restriction on the number of open files that a container can use. The default nofile soft limit is 1024 and the default hard limit is 4096.

You can specify the ulimit settings for a container in a task definition.

" + "documentation":"

The ulimit settings to pass to the container.

Amazon ECS tasks hosted on Fargate use the default resource limit values set by the operating system with the exception of the nofile resource limit parameter which Fargate overrides. The nofile resource limit sets a restriction on the number of open files that a container can use. The default nofile soft limit is 1024 and the default hard limit is 65535.

You can specify the ulimit settings for a container in a task definition.

" }, "UlimitList":{ "type":"list", diff --git a/botocore/data/outposts/2019-12-03/endpoint-rule-set-1.json b/botocore/data/outposts/2019-12-03/endpoint-rule-set-1.json index bca1f55e1e..840c00e4b8 100644 --- a/botocore/data/outposts/2019-12-03/endpoint-rule-set-1.json +++ b/botocore/data/outposts/2019-12-03/endpoint-rule-set-1.json @@ -40,7 +40,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -83,7 +82,8 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -96,7 +96,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -110,7 +109,6 @@ "assign": "PartitionResult" } ], - "type": "tree", "rules": [ { "conditions": [ @@ -133,7 +131,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -168,7 +165,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -179,14 +175,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "FIPS and DualStack are enabled, but this partition does not support one or both", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -200,14 +198,12 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ - true, { "fn": "getAttr", "argv": [ @@ -216,18 +212,17 @@ }, "supportsFIPS" ] - } + }, + true ] } ], - "type": "tree", "rules": [ { "conditions": [ { "fn": "stringEquals", "argv": [ - "aws-us-gov", { "fn": "getAttr", "argv": [ @@ -236,7 +231,8 @@ }, "name" ] - } + }, + "aws-us-gov" ] } ], @@ -256,14 +252,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "FIPS is enabled but this partition does not support FIPS", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -277,7 +275,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -297,7 +294,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -308,14 +304,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "DualStack is enabled but this partition does not support DualStack", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [], @@ -326,9 +324,11 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" } - ] + ], + "type": "tree" }, { "conditions": [], diff --git a/botocore/data/outposts/2019-12-03/service-2.json b/botocore/data/outposts/2019-12-03/service-2.json index f1aadf4145..82acb0c945 100644 --- a/botocore/data/outposts/2019-12-03/service-2.json +++ b/botocore/data/outposts/2019-12-03/service-2.json @@ -1309,7 +1309,6 @@ }, "LineItemQuantity":{ "type":"integer", - "max":20, "min":1 }, "LineItemRequest":{ @@ -2048,7 +2047,6 @@ "StartConnectionRequest":{ "type":"structure", "required":[ - "DeviceSerialNumber", "AssetId", "ClientPublicKey", "NetworkInterfaceDeviceIndex" diff --git a/botocore/data/rds/2014-10-31/service-2.json b/botocore/data/rds/2014-10-31/service-2.json index f0d86b3eef..e9f1eca556 100644 --- a/botocore/data/rds/2014-10-31/service-2.json +++ b/botocore/data/rds/2014-10-31/service-2.json @@ -534,6 +534,28 @@ ], "documentation":"

Creates a new DB security group. DB security groups control access to a DB instance.

A DB security group controls access to EC2-Classic DB instances that are not in a VPC.

EC2-Classic was retired on August 15, 2022. If you haven't migrated from EC2-Classic to a VPC, we recommend that you migrate as soon as possible. For more information, see Migrate from EC2-Classic to a VPC in the Amazon EC2 User Guide, the blog EC2-Classic Networking is Retiring – Here’s How to Prepare, and Moving a DB instance not in a VPC into a VPC in the Amazon RDS User Guide.

" }, + "CreateDBShardGroup":{ + "name":"CreateDBShardGroup", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"CreateDBShardGroupMessage"}, + "output":{ + "shape":"DBShardGroup", + "resultWrapper":"CreateDBShardGroupResult" + }, + "errors":[ + {"shape":"DBShardGroupAlreadyExistsFault"}, + {"shape":"DBClusterNotFoundFault"}, + {"shape":"MaxDBShardGroupLimitReached"}, + {"shape":"InvalidDBClusterStateFault"}, + {"shape":"InvalidMaxAcuFault"}, + {"shape":"UnsupportedDBEngineVersionFault"}, + {"shape":"InvalidVPCNetworkStateFault"} + ], + "documentation":"

Creates a new DB shard group for Aurora Limitless Database. You must enable Aurora Limitless Database to create a DB shard group.

Valid for: Aurora DB clusters only

" + }, "CreateDBSnapshot":{ "name":"CreateDBSnapshot", "http":{ @@ -889,6 +911,24 @@ ], "documentation":"

Deletes a DB security group.

The specified DB security group must not be associated with any DB instances.

EC2-Classic was retired on August 15, 2022. If you haven't migrated from EC2-Classic to a VPC, we recommend that you migrate as soon as possible. For more information, see Migrate from EC2-Classic to a VPC in the Amazon EC2 User Guide, the blog EC2-Classic Networking is Retiring – Here’s How to Prepare, and Moving a DB instance not in a VPC into a VPC in the Amazon RDS User Guide.

" }, + "DeleteDBShardGroup":{ + "name":"DeleteDBShardGroup", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeleteDBShardGroupMessage"}, + "output":{ + "shape":"DBShardGroup", + "resultWrapper":"DeleteDBShardGroupResult" + }, + "errors":[ + {"shape":"DBShardGroupNotFoundFault"}, + {"shape":"InvalidDBShardGroupStateFault"}, + {"shape":"InvalidDBClusterStateFault"} + ], + "documentation":"

Deletes an Aurora Limitless Database DB shard group.

" + }, "DeleteDBSnapshot":{ "name":"DeleteDBSnapshot", "http":{ @@ -1388,6 +1428,23 @@ ], "documentation":"

Returns a list of DBSecurityGroup descriptions. If a DBSecurityGroupName is specified, the list will contain only the descriptions of the specified DB security group.

EC2-Classic was retired on August 15, 2022. If you haven't migrated from EC2-Classic to a VPC, we recommend that you migrate as soon as possible. For more information, see Migrate from EC2-Classic to a VPC in the Amazon EC2 User Guide, the blog EC2-Classic Networking is Retiring – Here’s How to Prepare, and Moving a DB instance not in a VPC into a VPC in the Amazon RDS User Guide.

" }, + "DescribeDBShardGroups":{ + "name":"DescribeDBShardGroups", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DescribeDBShardGroupsMessage"}, + "output":{ + "shape":"DescribeDBShardGroupsResponse", + "resultWrapper":"DescribeDBShardGroupsResult" + }, + "errors":[ + {"shape":"DBShardGroupNotFoundFault"}, + {"shape":"DBClusterNotFoundFault"} + ], + "documentation":"

Describes existing Aurora Limitless Database DB shard groups.

" + }, "DescribeDBSnapshotAttributes":{ "name":"DescribeDBSnapshotAttributes", "http":{ @@ -1771,7 +1828,7 @@ {"shape":"InvalidDBClusterStateFault"}, {"shape":"InvalidDBInstanceStateFault"} ], - "documentation":"

Forces a failover for a DB cluster.

For an Aurora DB cluster, failover for a DB cluster promotes one of the Aurora Replicas (read-only instances) in the DB cluster to be the primary DB instance (the cluster writer).

For a Multi-AZ DB cluster, failover for a DB cluster promotes one of the readable standby DB instances (read-only instances) in the DB cluster to be the primary DB instance (the cluster writer).

An Amazon Aurora DB cluster automatically fails over to an Aurora Replica, if one exists, when the primary DB instance fails. A Multi-AZ DB cluster automatically fails over to a readable standby DB instance when the primary DB instance fails.

To simulate a failure of a primary instance for testing, you can force a failover. Because each instance in a DB cluster has its own endpoint address, make sure to clean up and re-establish any existing connections that use those endpoint addresses when the failover is complete.

For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.

For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.

" + "documentation":"

Forces a failover for a DB cluster.

For an Aurora DB cluster, failover for a DB cluster promotes one of the Aurora Replicas (read-only instances) in the DB cluster to be the primary DB instance (the cluster writer).

For a Multi-AZ DB cluster, after RDS terminates the primary DB instance, the internal monitoring system detects that the primary DB instance is unhealthy and promotes a readable standby (read-only instances) in the DB cluster to be the primary DB instance (the cluster writer). Failover times are typically less than 35 seconds.

An Amazon Aurora DB cluster automatically fails over to an Aurora Replica, if one exists, when the primary DB instance fails. A Multi-AZ DB cluster automatically fails over to a readable standby DB instance when the primary DB instance fails.

To simulate a failure of a primary instance for testing, you can force a failover. Because each instance in a DB cluster has its own endpoint address, make sure to clean up and re-establish any existing connections that use those endpoint addresses when the failover is complete.

For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.

For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.

" }, "FailoverGlobalCluster":{ "name":"FailoverGlobalCluster", @@ -2092,6 +2149,25 @@ "errors":[], "documentation":"

Updates the recommendation status and recommended action status for the specified recommendation.

" }, + "ModifyDBShardGroup":{ + "name":"ModifyDBShardGroup", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ModifyDBShardGroupMessage"}, + "output":{ + "shape":"DBShardGroup", + "resultWrapper":"ModifyDBShardGroupResult" + }, + "errors":[ + {"shape":"InvalidDBClusterStateFault"}, + {"shape":"DBShardGroupAlreadyExistsFault"}, + {"shape":"DBShardGroupNotFoundFault"}, + {"shape":"InvalidMaxAcuFault"} + ], + "documentation":"

Modifies the settings of an Aurora Limitless Database DB shard group. You can change one or more settings by specifying these parameters and the new values in the request.

" + }, "ModifyDBSnapshot":{ "name":"ModifyDBSnapshot", "http":{ @@ -2309,6 +2385,23 @@ ], "documentation":"

You might need to reboot your DB instance, usually for maintenance reasons. For example, if you make certain modifications, or if you change the DB parameter group associated with the DB instance, you must reboot the instance for the changes to take effect.

Rebooting a DB instance restarts the database engine service. Rebooting a DB instance results in a momentary outage, during which the DB instance status is set to rebooting.

For more information about rebooting, see Rebooting a DB Instance in the Amazon RDS User Guide.

This command doesn't apply to RDS Custom.

If your DB instance is part of a Multi-AZ DB cluster, you can reboot the DB cluster with the RebootDBCluster operation.

" }, + "RebootDBShardGroup":{ + "name":"RebootDBShardGroup", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"RebootDBShardGroupMessage"}, + "output":{ + "shape":"DBShardGroup", + "resultWrapper":"RebootDBShardGroupResult" + }, + "errors":[ + {"shape":"DBShardGroupNotFoundFault"}, + {"shape":"InvalidDBShardGroupStateFault"} + ], + "documentation":"

You might need to reboot your DB shard group, usually for maintenance reasons. For example, if you make certain modifications, reboot the DB shard group for the changes to take effect.

This operation applies only to Aurora Limitless Database DBb shard groups.

" + }, "RegisterDBProxyTargets":{ "name":"RegisterDBProxyTargets", "http":{ @@ -3877,7 +3970,7 @@ }, "TargetDBInstanceClass":{ "shape":"TargetDBInstanceClass", - "documentation":"

Specify the DB instance class for the databases in the green environment.

" + "documentation":"

Specify the DB instance class for the databases in the green environment.

This parameter only applies to RDS DB instances, because DB instances within an Aurora DB cluster can have multiple different instance classes. If you're creating a blue/green deployment from an Aurora DB cluster, don't specify this parameter. After the green environment is created, you can individually modify the instance classes of the DB instances within the green DB cluster.

" }, "UpgradeTargetStorageConfig":{ "shape":"BooleanOptional", @@ -4174,6 +4267,10 @@ "shape":"IntegerOptional", "documentation":"

The number of days to retain Performance Insights data.

Valid for Cluster Type: Multi-AZ DB clusters only

Valid Values:

Default: 7 days

If you specify a retention period that isn't valid, such as 94, Amazon RDS issues an error.

" }, + "EnableLimitlessDatabase":{ + "shape":"BooleanOptional", + "documentation":"

Specifies whether to enable Aurora Limitless Database. You must enable Aurora Limitless Database to create a DB shard group.

Valid for: Aurora DB clusters only

" + }, "ServerlessV2ScalingConfiguration":{"shape":"ServerlessV2ScalingConfiguration"}, "NetworkType":{ "shape":"String", @@ -4877,6 +4974,36 @@ "DBSecurityGroup":{"shape":"DBSecurityGroup"} } }, + "CreateDBShardGroupMessage":{ + "type":"structure", + "required":[ + "DBShardGroupIdentifier", + "DBClusterIdentifier", + "MaxACU" + ], + "members":{ + "DBShardGroupIdentifier":{ + "shape":"String", + "documentation":"

The name of the DB shard group.

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

The name of the primary DB cluster for the DB shard group.

" + }, + "ComputeRedundancy":{ + "shape":"IntegerOptional", + "documentation":"

Specifies whether to create standby instances for the DB shard group. Valid values are the following:

" + }, + "MaxACU":{ + "shape":"DoubleOptional", + "documentation":"

The maximum capacity of the DB shard group in Aurora capacity units (ACUs).

" + }, + "PubliclyAccessible":{ + "shape":"BooleanOptional", + "documentation":"

Specifies whether the DB shard group is publicly accessible.

When the DB shard group is publicly accessible, its Domain Name System (DNS) endpoint resolves to the private IP address from within the DB shard group's virtual private cloud (VPC). It resolves to the public IP address from outside of the DB shard group's VPC. Access to the DB shard group is ultimately controlled by the security group it uses. That public access is not permitted if the security group assigned to the DB shard group doesn't permit it.

When the DB shard group isn't publicly accessible, it is an internal DB shard group with a DNS name that resolves to a private IP address.

Default: The default behavior varies depending on whether DBSubnetGroupName is specified.

If DBSubnetGroupName isn't specified, and PubliclyAccessible isn't specified, the following applies:

If DBSubnetGroupName is specified, and PubliclyAccessible isn't specified, the following applies:

" + } + } + }, "CreateDBSnapshotMessage":{ "type":"structure", "required":[ @@ -4948,7 +5075,7 @@ }, "SnsTopicArn":{ "shape":"String", - "documentation":"

The Amazon Resource Name (ARN) of the SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.

" + "documentation":"

The Amazon Resource Name (ARN) of the SNS topic created for event notification. SNS automatically creates the ARN when you create a topic and subscribe to it.

RDS doesn't support FIFO (first in, first out) topics. For more information, see Message ordering and deduplication (FIFO topics) in the Amazon Simple Notification Service Developer Guide.

" }, "SourceType":{ "shape":"String", @@ -5511,6 +5638,10 @@ "AwsBackupRecoveryPointArn":{ "shape":"String", "documentation":"

The Amazon Resource Name (ARN) of the recovery point in Amazon Web Services Backup.

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

The details for Aurora Limitless Database.

" } }, "documentation":"

Contains the details of an Amazon Aurora DB cluster or Multi-AZ DB cluster.

For an Amazon Aurora DB cluster, this data type is used as a response element in the operations CreateDBCluster, DeleteDBCluster, DescribeDBClusters, FailoverDBCluster, ModifyDBCluster, PromoteReadReplicaDBCluster, RestoreDBClusterFromS3, RestoreDBClusterFromSnapshot, RestoreDBClusterToPointInTime, StartDBCluster, and StopDBCluster.

For a Multi-AZ DB cluster, this data type is used as a response element in the operations CreateDBCluster, DeleteDBCluster, DescribeDBClusters, FailoverDBCluster, ModifyDBCluster, RebootDBCluster, RestoreDBClusterFromSnapshot, and RestoreDBClusterToPointInTime.

For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.

For more information on Multi-AZ DB clusters, see Multi-AZ deployments with two readable standby DB instances in the Amazon RDS User Guide.

", @@ -7877,6 +8008,74 @@ "locationName":"DBSecurityGroup" } }, + "DBShardGroup":{ + "type":"structure", + "members":{ + "DBShardGroupResourceId":{ + "shape":"String", + "documentation":"

The Amazon Web Services Region-unique, immutable identifier for the DB shard group.

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

The name of the DB shard group.

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

The name of the primary DB cluster for the DB shard group.

" + }, + "MaxACU":{ + "shape":"DoubleOptional", + "documentation":"

The maximum capacity of the DB shard group in Aurora capacity units (ACUs).

" + }, + "ComputeRedundancy":{ + "shape":"IntegerOptional", + "documentation":"

Specifies whether to create standby instances for the DB shard group. Valid values are the following:

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

The status of the DB shard group.

" + }, + "PubliclyAccessible":{ + "shape":"BooleanOptional", + "documentation":"

Indicates whether the DB shard group is publicly accessible.

When the DB shard group is publicly accessible, its Domain Name System (DNS) endpoint resolves to the private IP address from within the DB shard group's virtual private cloud (VPC). It resolves to the public IP address from outside of the DB shard group's VPC. Access to the DB shard group is ultimately controlled by the security group it uses. That public access isn't permitted if the security group assigned to the DB shard group doesn't permit it.

When the DB shard group isn't publicly accessible, it is an internal DB shard group with a DNS name that resolves to a private IP address.

For more information, see CreateDBShardGroup.

This setting is only for Aurora Limitless Database.

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

The connection endpoint for the DB shard group.

" + } + } + }, + "DBShardGroupAlreadyExistsFault":{ + "type":"structure", + "members":{ + }, + "documentation":"

The specified DB shard group name must be unique in your Amazon Web Services account in the specified Amazon Web Services Region.

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

The specified DB shard group name wasn't found.

", + "error":{ + "code":"DBShardGroupNotFound", + "httpStatusCode":404, + "senderFault":true + }, + "exception":true + }, + "DBShardGroupsList":{ + "type":"list", + "member":{ + "shape":"DBShardGroup", + "locationName":"DBShardGroup" + } + }, "DBSnapshot":{ "type":"structure", "members":{ @@ -8570,6 +8769,16 @@ }, "documentation":"

" }, + "DeleteDBShardGroupMessage":{ + "type":"structure", + "required":["DBShardGroupIdentifier"], + "members":{ + "DBShardGroupIdentifier":{ + "shape":"String", + "documentation":"

Teh name of the DB shard group to delete.

" + } + } + }, "DeleteDBSnapshotMessage":{ "type":"structure", "required":["DBSnapshotIdentifier"], @@ -8970,7 +9179,7 @@ }, "MaxRecords":{ "shape":"IntegerOptional", - "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so you can retrieve the remaining results.

Default: 100

Constraints: Minimum 20, maximum 100.

" + "documentation":"

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so you can retrieve the remaining results.

Default: 100

Constraints: Minimum 20, maximum 100

" }, "Marker":{ "shape":"String", @@ -9403,6 +9612,40 @@ }, "documentation":"

" }, + "DescribeDBShardGroupsMessage":{ + "type":"structure", + "members":{ + "DBShardGroupIdentifier":{ + "shape":"String", + "documentation":"

The user-supplied DB shard group identifier or the Amazon Resource Name (ARN) of the DB shard group. If this parameter is specified, information for only the specific DB shard group is returned. This parameter isn't case-sensitive.

Constraints:

" + }, + "Filters":{ + "shape":"FilterList", + "documentation":"

A filter that specifies one or more DB shard groups to describe.

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

An optional pagination token provided by a previous DescribeDBShardGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

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

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so you can retrieve the remaining results.

Default: 100

Constraints: Minimum 20, maximum 100

" + } + } + }, + "DescribeDBShardGroupsResponse":{ + "type":"structure", + "members":{ + "DBShardGroups":{ + "shape":"DBShardGroupsList", + "documentation":"

Contains a list of DB shard groups for the user.

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

A pagination token that can be used in a later DescribeDBClusters request.

" + } + } + }, "DescribeDBSnapshotAttributesMessage":{ "type":"structure", "required":["DBSnapshotIdentifier"], @@ -11285,6 +11528,18 @@ }, "exception":true }, + "InvalidDBShardGroupStateFault":{ + "type":"structure", + "members":{ + }, + "documentation":"

The DB shard group must be in the available state.

", + "error":{ + "code":"InvalidDBShardGroupState", + "httpStatusCode":400, + "senderFault":true + }, + "exception":true + }, "InvalidDBSnapshotStateFault":{ "type":"structure", "members":{ @@ -11405,6 +11660,18 @@ }, "exception":true }, + "InvalidMaxAcuFault":{ + "type":"structure", + "members":{ + }, + "documentation":"

The maximum capacity of the DB shard group must be 48-7168 Aurora capacity units (ACUs).

", + "error":{ + "code":"InvalidMaxAcu", + "httpStatusCode":400, + "senderFault":true + }, + "exception":true + }, "InvalidOptionGroupStateFault":{ "type":"structure", "members":{ @@ -11509,6 +11776,33 @@ "min":1, "pattern":"[a-zA-Z0-9_:\\-\\/]+" }, + "LimitlessDatabase":{ + "type":"structure", + "members":{ + "Status":{ + "shape":"LimitlessDatabaseStatus", + "documentation":"

The status of Aurora Limitless Database.

" + }, + "MinRequiredACU":{ + "shape":"DoubleOptional", + "documentation":"

The minimum required capacity for Aurora Limitless Database in Aurora capacity units (ACUs).

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

Contains details for Aurora Limitless Database.

" + }, + "LimitlessDatabaseStatus":{ + "type":"string", + "enum":[ + "active", + "not-in-use", + "enabled", + "disabled", + "enabling", + "disabling", + "modifying-max-capacity", + "error" + ] + }, "ListTagsForResourceMessage":{ "type":"structure", "required":["ResourceName"], @@ -11563,6 +11857,18 @@ }, "documentation":"

Contains the secret managed by RDS in Amazon Web Services Secrets Manager for the master user password.

For more information, see Password management with Amazon Web Services Secrets Manager in the Amazon RDS User Guide and Password management with Amazon Web Services Secrets Manager in the Amazon Aurora User Guide.

" }, + "MaxDBShardGroupLimitReached":{ + "type":"structure", + "members":{ + }, + "documentation":"

The maximum number of DB shard groups for your Amazon Web Services account in the specified Amazon Web Services Region has been reached.

", + "error":{ + "code":"MaxDBShardGroupLimitReached", + "httpStatusCode":400, + "senderFault":true + }, + "exception":true + }, "MaxRecords":{ "type":"integer", "max":100, @@ -11945,6 +12251,10 @@ "AwsBackupRecoveryPointArn":{ "shape":"AwsBackupRecoveryPointArn", "documentation":"

The Amazon Resource Name (ARN) of the recovery point in Amazon Web Services Backup.

" + }, + "EnableLimitlessDatabase":{ + "shape":"BooleanOptional", + "documentation":"

Specifies whether to enable Aurora Limitless Database. You must enable Aurora Limitless Database to create a DB shard group.

Valid for: Aurora DB clusters only

" } }, "documentation":"

" @@ -12406,6 +12716,20 @@ } } }, + "ModifyDBShardGroupMessage":{ + "type":"structure", + "required":["DBShardGroupIdentifier"], + "members":{ + "DBShardGroupIdentifier":{ + "shape":"String", + "documentation":"

The name of the DB shard group to modify.

" + }, + "MaxACU":{ + "shape":"DoubleOptional", + "documentation":"

The maximum capacity of the DB shard group in Aurora capacity units (ACUs).

" + } + } + }, "ModifyDBSnapshotAttributeMessage":{ "type":"structure", "required":[ @@ -13749,6 +14073,16 @@ "DBInstance":{"shape":"DBInstance"} } }, + "RebootDBShardGroupMessage":{ + "type":"structure", + "required":["DBShardGroupIdentifier"], + "members":{ + "DBShardGroupIdentifier":{ + "shape":"String", + "documentation":"

The name of the DB shard group to reboot.

" + } + } + }, "RecommendedAction":{ "type":"structure", "members":{ @@ -16303,6 +16637,18 @@ }, "documentation":"

A time zone associated with a DBInstance or a DBSnapshot. This data type is an element in the response to the DescribeDBInstances, the DescribeDBSnapshots, and the DescribeDBEngineVersions actions.

" }, + "UnsupportedDBEngineVersionFault":{ + "type":"structure", + "members":{ + }, + "documentation":"

The specified DB engine version isn't supported for Aurora Limitless Database.

", + "error":{ + "code":"UnsupportedDBEngineVersion", + "httpStatusCode":400, + "senderFault":true + }, + "exception":true + }, "UpgradeTarget":{ "type":"structure", "members":{ diff --git a/botocore/data/storagegateway/2013-06-30/endpoint-rule-set-1.json b/botocore/data/storagegateway/2013-06-30/endpoint-rule-set-1.json index 9f3c8e2c2b..b0a53a28b9 100644 --- a/botocore/data/storagegateway/2013-06-30/endpoint-rule-set-1.json +++ b/botocore/data/storagegateway/2013-06-30/endpoint-rule-set-1.json @@ -40,7 +40,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -83,7 +82,8 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -96,7 +96,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -110,7 +109,6 @@ "assign": "PartitionResult" } ], - "type": "tree", "rules": [ { "conditions": [ @@ -133,7 +131,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -168,7 +165,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -179,14 +175,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "FIPS and DualStack are enabled, but this partition does not support one or both", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -200,14 +198,12 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ - true, { "fn": "getAttr", "argv": [ @@ -216,11 +212,11 @@ }, "supportsFIPS" ] - } + }, + true ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -231,14 +227,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "FIPS is enabled but this partition does not support FIPS", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -252,7 +250,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -272,7 +269,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -283,14 +279,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "DualStack is enabled but this partition does not support DualStack", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [], @@ -301,9 +299,11 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" } - ] + ], + "type": "tree" }, { "conditions": [], diff --git a/botocore/data/storagegateway/2013-06-30/service-2.json b/botocore/data/storagegateway/2013-06-30/service-2.json index 153f65c18c..f86ef02157 100644 --- a/botocore/data/storagegateway/2013-06-30/service-2.json +++ b/botocore/data/storagegateway/2013-06-30/service-2.json @@ -656,7 +656,7 @@ {"shape":"InvalidGatewayRequestException"}, {"shape":"InternalServerError"} ], - "documentation":"

Returns a description of the specified Amazon Resource Name (ARN) of virtual tapes. If a TapeARN is not specified, returns a description of all virtual tapes associated with the specified gateway. This operation is only supported in the tape gateway type.

" + "documentation":"

Returns a description of virtual tapes that correspond to the specified Amazon Resource Names (ARNs). If TapeARN is not specified, returns a description of the virtual tapes associated with the specified gateway. This operation is only supported for the tape gateway type.

The operation supports pagination. By default, the operation returns a maximum of up to 100 tapes. You can optionally specify the Limit field in the body to limit the number of tapes in the response. If the number of tapes returned in the response is truncated, the response includes a Marker field. You can use this Marker value in your subsequent request to retrieve the next set of tapes.

" }, "DescribeUploadBuffer":{ "name":"DescribeUploadBuffer", @@ -922,7 +922,7 @@ {"shape":"InvalidGatewayRequestException"}, {"shape":"InternalServerError"} ], - "documentation":"

Sends you notification through CloudWatch Events when all files written to your file share have been uploaded to S3. Amazon S3.

Storage Gateway can send a notification through Amazon CloudWatch Events when all files written to your file share up to that point in time have been uploaded to Amazon S3. These files include files written to the file share up to the time that you make a request for notification. When the upload is done, Storage Gateway sends you notification through an Amazon CloudWatch Event. You can configure CloudWatch Events to send the notification through event targets such as Amazon SNS or Lambda function. This operation is only supported for S3 File Gateways.

For more information, see Getting file upload notification in the Amazon S3 File Gateway User Guide.

" + "documentation":"

Sends you notification through CloudWatch Events when all files written to your file share have been uploaded to Amazon S3.

Storage Gateway can send a notification through Amazon CloudWatch Events when all files written to your file share up to that point in time have been uploaded to Amazon S3. These files include files written to the file share up to the time that you make a request for notification. When the upload is done, Storage Gateway sends you notification through an Amazon CloudWatch Event. You can configure CloudWatch Events to send the notification through event targets such as Amazon SNS or Lambda function. This operation is only supported for S3 File Gateways.

For more information, see Getting file upload notification in the Amazon S3 File Gateway User Guide.

" }, "RefreshCache":{ "name":"RefreshCache", @@ -936,7 +936,7 @@ {"shape":"InvalidGatewayRequestException"}, {"shape":"InternalServerError"} ], - "documentation":"

Refreshes the cached inventory of objects for the specified file share. This operation finds objects in the Amazon S3 bucket that were added, removed, or replaced since the gateway last listed the bucket's contents and cached the results. This operation does not import files into the S3 File Gateway cache storage. It only updates the cached inventory to reflect changes in the inventory of the objects in the S3 bucket. This operation is only supported in the S3 File Gateway types.

You can subscribe to be notified through an Amazon CloudWatch event when your RefreshCache operation completes. For more information, see Getting notified about file operations in the Storage Gateway User Guide. This operation is Only supported for S3 File Gateways.

When this API is called, it only initiates the refresh operation. When the API call completes and returns a success code, it doesn't necessarily mean that the file refresh has completed. You should use the refresh-complete notification to determine that the operation has completed before you check for new files on the gateway file share. You can subscribe to be notified through a CloudWatch event when your RefreshCache operation completes.

Throttle limit: This API is asynchronous, so the gateway will accept no more than two refreshes at any time. We recommend using the refresh-complete CloudWatch event notification before issuing additional requests. For more information, see Getting notified about file operations in the Storage Gateway User Guide.

The S3 bucket name does not need to be included when entering the list of folders in the FolderList parameter.

For more information, see Getting notified about file operations in the Storage Gateway User Guide.

" + "documentation":"

Refreshes the cached inventory of objects for the specified file share. This operation finds objects in the Amazon S3 bucket that were added, removed, or replaced since the gateway last listed the bucket's contents and cached the results. This operation does not import files into the S3 File Gateway cache storage. It only updates the cached inventory to reflect changes in the inventory of the objects in the S3 bucket. This operation is only supported in the S3 File Gateway types.

You can subscribe to be notified through an Amazon CloudWatch event when your RefreshCache operation completes. For more information, see Getting notified about file operations in the Amazon S3 File Gateway User Guide. This operation is Only supported for S3 File Gateways.

When this API is called, it only initiates the refresh operation. When the API call completes and returns a success code, it doesn't necessarily mean that the file refresh has completed. You should use the refresh-complete notification to determine that the operation has completed before you check for new files on the gateway file share. You can subscribe to be notified through a CloudWatch event when your RefreshCache operation completes.

Throttle limit: This API is asynchronous, so the gateway will accept no more than two refreshes at any time. We recommend using the refresh-complete CloudWatch event notification before issuing additional requests. For more information, see Getting notified about file operations in the Amazon S3 File Gateway User Guide.

The S3 bucket name does not need to be included when entering the list of folders in the FolderList parameter.

For more information, see Getting notified about file operations in the Amazon S3 File Gateway User Guide.

" }, "RemoveTagsFromResource":{ "name":"RemoveTagsFromResource", @@ -1034,7 +1034,7 @@ {"shape":"InvalidGatewayRequestException"}, {"shape":"InternalServerError"} ], - "documentation":"

Shuts down a gateway. To specify which gateway to shut down, use the Amazon Resource Name (ARN) of the gateway in the body of your request.

The operation shuts down the gateway service component running in the gateway's virtual machine (VM) and not the host VM.

If you want to shut down the VM, it is recommended that you first shut down the gateway component in the VM to avoid unpredictable conditions.

After the gateway is shutdown, you cannot call any other API except StartGateway, DescribeGatewayInformation, and ListGateways. For more information, see ActivateGateway. Your applications cannot read from or write to the gateway's storage volumes, and there are no snapshots taken.

When you make a shutdown request, you will get a 200 OK success response immediately. However, it might take some time for the gateway to shut down. You can call the DescribeGatewayInformation API to check the status. For more information, see ActivateGateway.

If do not intend to use the gateway again, you must delete the gateway (using DeleteGateway) to no longer pay software charges associated with the gateway.

" + "documentation":"

Shuts down a Tape Gateway or Volume Gateway. To specify which gateway to shut down, use the Amazon Resource Name (ARN) of the gateway in the body of your request.

This API action cannot be used to shut down S3 File Gateway or FSx File Gateway.

The operation shuts down the gateway service component running in the gateway's virtual machine (VM) and not the host VM.

If you want to shut down the VM, it is recommended that you first shut down the gateway component in the VM to avoid unpredictable conditions.

After the gateway is shutdown, you cannot call any other API except StartGateway, DescribeGatewayInformation, and ListGateways. For more information, see ActivateGateway. Your applications cannot read from or write to the gateway's storage volumes, and there are no snapshots taken.

When you make a shutdown request, you will get a 200 OK success response immediately. However, it might take some time for the gateway to shut down. You can call the DescribeGatewayInformation API to check the status. For more information, see ActivateGateway.

If do not intend to use the gateway again, you must delete the gateway (using DeleteGateway) to no longer pay software charges associated with the gateway.

" }, "StartAvailabilityMonitorTest":{ "name":"StartAvailabilityMonitorTest", @@ -3808,6 +3808,14 @@ "HostEnvironmentId":{ "shape":"HostEnvironmentId", "documentation":"

A unique identifier for the specific instance of the host platform running the gateway. This value is only available for certain host environments, and its format depends on the host environment type.

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

Date after which this gateway will not receive software updates for new features and bug fixes.

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

The version number of the software running on the gateway appliance.

" } }, "documentation":"

Describes a gateway object.

" From 51ad58d315da474323e770d3b73ec616e8a02264 Mon Sep 17 00:00:00 2001 From: aws-sdk-python-automation Date: Wed, 24 Jan 2024 19:14:15 +0000 Subject: [PATCH 2/2] Bumping version to 1.34.27 --- .changes/1.34.27.json | 27 +++++++++++++++++++ .../next-release/api-change-ec2-33673.json | 5 ---- .../next-release/api-change-ecs-86206.json | 5 ---- .../api-change-outposts-54047.json | 5 ---- .../next-release/api-change-rds-22061.json | 5 ---- .../api-change-storagegateway-6273.json | 5 ---- CHANGELOG.rst | 10 +++++++ botocore/__init__.py | 2 +- docs/source/conf.py | 2 +- 9 files changed, 39 insertions(+), 27 deletions(-) create mode 100644 .changes/1.34.27.json delete mode 100644 .changes/next-release/api-change-ec2-33673.json delete mode 100644 .changes/next-release/api-change-ecs-86206.json delete mode 100644 .changes/next-release/api-change-outposts-54047.json delete mode 100644 .changes/next-release/api-change-rds-22061.json delete mode 100644 .changes/next-release/api-change-storagegateway-6273.json diff --git a/.changes/1.34.27.json b/.changes/1.34.27.json new file mode 100644 index 0000000000..7d910fe6f2 --- /dev/null +++ b/.changes/1.34.27.json @@ -0,0 +1,27 @@ +[ + { + "category": "``ec2``", + "description": "Introduced a new clientToken request parameter on CreateNetworkAcl and CreateRouteTable APIs. The clientToken parameter allows idempotent operations on the APIs.", + "type": "api-change" + }, + { + "category": "``ecs``", + "description": "Documentation updates for Amazon ECS.", + "type": "api-change" + }, + { + "category": "``outposts``", + "description": "DeviceSerialNumber parameter is now optional in StartConnection API", + "type": "api-change" + }, + { + "category": "``rds``", + "description": "This release adds support for Aurora Limitless Database.", + "type": "api-change" + }, + { + "category": "``storagegateway``", + "description": "Add DeprecationDate and SoftwareVersion to response of ListGateways.", + "type": "api-change" + } +] \ No newline at end of file diff --git a/.changes/next-release/api-change-ec2-33673.json b/.changes/next-release/api-change-ec2-33673.json deleted file mode 100644 index 439e861405..0000000000 --- a/.changes/next-release/api-change-ec2-33673.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``ec2``", - "description": "Introduced a new clientToken request parameter on CreateNetworkAcl and CreateRouteTable APIs. The clientToken parameter allows idempotent operations on the APIs." -} diff --git a/.changes/next-release/api-change-ecs-86206.json b/.changes/next-release/api-change-ecs-86206.json deleted file mode 100644 index a2658e0335..0000000000 --- a/.changes/next-release/api-change-ecs-86206.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``ecs``", - "description": "Documentation updates for Amazon ECS." -} diff --git a/.changes/next-release/api-change-outposts-54047.json b/.changes/next-release/api-change-outposts-54047.json deleted file mode 100644 index e5b32a387a..0000000000 --- a/.changes/next-release/api-change-outposts-54047.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``outposts``", - "description": "DeviceSerialNumber parameter is now optional in StartConnection API" -} diff --git a/.changes/next-release/api-change-rds-22061.json b/.changes/next-release/api-change-rds-22061.json deleted file mode 100644 index a058bb7033..0000000000 --- a/.changes/next-release/api-change-rds-22061.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``rds``", - "description": "This release adds support for Aurora Limitless Database." -} diff --git a/.changes/next-release/api-change-storagegateway-6273.json b/.changes/next-release/api-change-storagegateway-6273.json deleted file mode 100644 index 4c8b340ac4..0000000000 --- a/.changes/next-release/api-change-storagegateway-6273.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "type": "api-change", - "category": "``storagegateway``", - "description": "Add DeprecationDate and SoftwareVersion to response of ListGateways." -} diff --git a/CHANGELOG.rst b/CHANGELOG.rst index c9299bf769..19287034ce 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -2,6 +2,16 @@ CHANGELOG ========= +1.34.27 +======= + +* api-change:``ec2``: Introduced a new clientToken request parameter on CreateNetworkAcl and CreateRouteTable APIs. The clientToken parameter allows idempotent operations on the APIs. +* api-change:``ecs``: Documentation updates for Amazon ECS. +* api-change:``outposts``: DeviceSerialNumber parameter is now optional in StartConnection API +* api-change:``rds``: This release adds support for Aurora Limitless Database. +* api-change:``storagegateway``: Add DeprecationDate and SoftwareVersion to response of ListGateways. + + 1.34.26 ======= diff --git a/botocore/__init__.py b/botocore/__init__.py index 28cad4e0e2..1bfd09b3ec 100644 --- a/botocore/__init__.py +++ b/botocore/__init__.py @@ -16,7 +16,7 @@ import os import re -__version__ = '1.34.26' +__version__ = '1.34.27' class NullHandler(logging.Handler): diff --git a/docs/source/conf.py b/docs/source/conf.py index 95d4374c8b..cb84826a5a 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -59,7 +59,7 @@ # The short X.Y version. version = '1.34.' # The full version, including alpha/beta/rc tags. -release = '1.34.26' +release = '1.34.27' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages.