Associates tags with an OpenSearch Serverless resource. For more information, see Tagging Amazon OpenSearch Serverless collections.
", "UntagResource": "Removes a tag or set of tags from an OpenSearch Serverless resource. For more information, see Tagging Amazon OpenSearch Serverless collections.
", "UpdateAccessPolicy": "Updates an OpenSearch Serverless access policy. For more information, see Data access control for Amazon OpenSearch Serverless.
", - "UpdateAccountSettings": "Update the OpenSearch Serverless settings for the current Amazon Web Services account. For more information, see Autoscaling.
", + "UpdateAccountSettings": "Update the OpenSearch Serverless settings for the current Amazon Web Services account. For more information, see Managing capacity limits for Amazon OpenSearch Serverless.
", "UpdateCollection": "Updates an OpenSearch Serverless collection.
", "UpdateSecurityConfig": "Updates a security configuration for OpenSearch Serverless. For more information, see SAML authentication for Amazon OpenSearch Serverless.
", "UpdateSecurityPolicy": "Updates an OpenSearch Serverless security policy. For more information, see Network access for Amazon OpenSearch Serverless and Encryption at rest for Amazon OpenSearch Serverless.
", @@ -109,7 +109,7 @@ } }, "CapacityLimits": { - "base": "The maximum capacity limits for all OpenSearch Serverless collections, in OpenSearch Compute Units (OCUs). These limits are used to scale your collections based on the current workload. For more information, see Autoscaling.
", + "base": "The maximum capacity limits for all OpenSearch Serverless collections, in OpenSearch Compute Units (OCUs). These limits are used to scale your collections based on the current workload. For more information, see Managing capacity limits for Amazon OpenSearch Serverless.
", "refs": { "AccountSettingsDetail$capacityLimits": null, "UpdateAccountSettingsRequest$capacityLimits": null @@ -253,7 +253,7 @@ } }, "ConflictException": { - "base": "When creating a collection, thrown when a collection with the same name already exists or is being created. When deleting a collection, thrown when the collection is not in the ACTIVE or FAILED state.
", + "base": "When creating a resource, thrown when a resource with the same name already exists or is being created. When deleting a resource, thrown when the resource is not in the ACTIVE or FAILED state.
", "refs": { } }, @@ -469,7 +469,7 @@ "ListAccessPoliciesRequestResourceList": { "base": null, "refs": { - "ListAccessPoliciesRequest$resource": "Resource filters (can be collection or indexes) that policies can apply to.
" + "ListAccessPoliciesRequest$resource": "Resource filters (can be collections or indexes) that policies can apply to.
" } }, "ListAccessPoliciesResponse": { @@ -587,6 +587,11 @@ "VpcEndpointDetail$createdDate": "The date the endpoint was created.
" } }, + "OcuLimitExceededException": { + "base": "OCU Limit Exceeded for service limits
", + "refs": { + } + }, "PolicyDescription": { "base": null, "refs": { @@ -655,7 +660,7 @@ "SamlConfigOptions": { "base": "Describes SAML options for an OpenSearch Serverless security configuration in the form of a key-value map.
", "refs": { - "CreateSecurityConfigRequest$samlOptions": "Describes SAML options in in the form of a key-value map.
", + "CreateSecurityConfigRequest$samlOptions": "Describes SAML options in in the form of a key-value map. This field is required if you specify saml for the type parameter.
SAML options for the security configuration in the form of a key-value map.
", "UpdateSecurityConfigRequest$samlOptions": "SAML options in in the form of a key-value map.
" } @@ -663,7 +668,7 @@ "SamlConfigOptionsSessionTimeoutInteger": { "base": null, "refs": { - "SamlConfigOptions$sessionTimeout": "The session timeout, in minutes. Minimum is 15 minutes and maximum is 1440 minutes (24 hours or 1 day). Default is 60 minutes.
" + "SamlConfigOptions$sessionTimeout": "The session timeout, in minutes. Default is 60 minutes (12 hours).
" } }, "SearchCapacityValue": { @@ -771,6 +776,11 @@ "UpdateSecurityPolicyRequest$type": "The type of access policy.
" } }, + "ServiceQuotaExceededException": { + "base": "Thrown when you attempt to create more resources than the service allows based on service quotas.
", + "refs": { + } + }, "String": { "base": null, "refs": { @@ -797,7 +807,13 @@ "ListSecurityPoliciesResponse$nextToken": "When nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page.
If your initial ListVpcEndpoints operation returns a nextToken, you can include the returned nextToken in subsequent ListVpcEndpoints operations, which returns results in the next page.
When nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page.
Description of the error.
", "ResourceNotFoundException$message": null, + "ServiceQuotaExceededException$message": "Description of the error.
", + "ServiceQuotaExceededException$quotaCode": "Service Quotas requirement to identify originating quota.
", + "ServiceQuotaExceededException$resourceId": "Identifier of the resource affected.
", + "ServiceQuotaExceededException$resourceType": "Type of the resource affected.
", + "ServiceQuotaExceededException$serviceCode": "Service Quotas requirement to identify originating service.
", "UpdateCollectionDetail$arn": "The Amazon Resource Name (ARN) of the collection.
", "UpdateCollectionDetail$description": "The description of the collection.
", "ValidationException$message": null, @@ -1045,7 +1061,7 @@ "base": null, "refs": { "CreateVpcEndpointRequest$vpcId": "The ID of the VPC from which you'll access OpenSearch Serverless.
", - "VpcEndpointDetail$vpcId": "The ID of the VPC from which you access OpenSearch Serverless
" + "VpcEndpointDetail$vpcId": "The ID of the VPC from which you access OpenSearch Serverless.
" } }, "samlGroupAttribute": { diff --git a/models/apis/opensearchserverless/2021-11-01/endpoint-rule-set-1.json b/models/apis/opensearchserverless/2021-11-01/endpoint-rule-set-1.json index 6c4f0a782a..879c877db3 100644 --- a/models/apis/opensearchserverless/2021-11-01/endpoint-rule-set-1.json +++ b/models/apis/opensearchserverless/2021-11-01/endpoint-rule-set-1.json @@ -3,7 +3,7 @@ "parameters": { "Region": { "builtIn": "AWS::Region", - "required": true, + "required": false, "documentation": "The AWS region used to dispatch the request.", "type": "String" }, @@ -32,13 +32,12 @@ { "conditions": [ { - "fn": "aws.partition", + "fn": "isSet", "argv": [ { - "ref": "Region" + "ref": "Endpoint" } - ], - "assign": "PartitionResult" + ] } ], "type": "tree", @@ -46,23 +45,20 @@ { "conditions": [ { - "fn": "isSet", + "fn": "booleanEquals", "argv": [ { - "ref": "Endpoint" - } + "ref": "UseFIPS" + }, + true ] - }, - { - "fn": "parseURL", - "argv": [ - { - "ref": "Endpoint" - } - ], - "assign": "url" } ], + "error": "Invalid Configuration: FIPS and custom endpoint are not supported", + "type": "error" + }, + { + "conditions": [], "type": "tree", "rules": [ { @@ -71,67 +67,42 @@ "fn": "booleanEquals", "argv": [ { - "ref": "UseFIPS" + "ref": "UseDualStack" }, true ] } ], - "error": "Invalid Configuration: FIPS and custom endpoint are not supported", + "error": "Invalid Configuration: Dualstack and custom endpoint are not supported", "type": "error" }, { "conditions": [], - "type": "tree", - "rules": [ - { - "conditions": [ - { - "fn": "booleanEquals", - "argv": [ - { - "ref": "UseDualStack" - }, - true - ] - } - ], - "error": "Invalid Configuration: Dualstack and custom endpoint are not supported", - "type": "error" + "endpoint": { + "url": { + "ref": "Endpoint" }, - { - "conditions": [], - "endpoint": { - "url": { - "ref": "Endpoint" - }, - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } - ] + "properties": {}, + "headers": {} + }, + "type": "endpoint" } ] - }, + } + ] + }, + { + "conditions": [], + "type": "tree", + "rules": [ { "conditions": [ { - "fn": "booleanEquals", - "argv": [ - { - "ref": "UseFIPS" - }, - true - ] - }, - { - "fn": "booleanEquals", + "fn": "isSet", "argv": [ { - "ref": "UseDualStack" - }, - true + "ref": "Region" + } ] } ], @@ -140,168 +111,238 @@ { "conditions": [ { - "fn": "booleanEquals", + "fn": "aws.partition", "argv": [ - true, { - "fn": "getAttr", + "ref": "Region" + } + ], + "assign": "PartitionResult" + } + ], + "type": "tree", + "rules": [ + { + "conditions": [ + { + "fn": "booleanEquals", "argv": [ { - "ref": "PartitionResult" + "ref": "UseFIPS" }, - "supportsFIPS" + true ] - } - ] - }, - { - "fn": "booleanEquals", - "argv": [ - true, + }, { - "fn": "getAttr", + "fn": "booleanEquals", "argv": [ { - "ref": "PartitionResult" + "ref": "UseDualStack" + }, + true + ] + } + ], + "type": "tree", + "rules": [ + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + true, + { + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsFIPS" + ] + } + ] }, - "supportsDualStack" + { + "fn": "booleanEquals", + "argv": [ + true, + { + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsDualStack" + ] + } + ] + } + ], + "type": "tree", + "rules": [ + { + "conditions": [], + "type": "tree", + "rules": [ + { + "conditions": [], + "endpoint": { + "url": "https://aoss-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" + } + ] + } ] + }, + { + "conditions": [], + "error": "FIPS and DualStack are enabled, but this partition does not support one or both", + "type": "error" } ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://aoss-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } - ] - }, - { - "conditions": [], - "error": "FIPS and DualStack are enabled, but this partition does not support one or both", - "type": "error" - } - ] - }, - { - "conditions": [ - { - "fn": "booleanEquals", - "argv": [ - { - "ref": "UseFIPS" }, - true - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [ { - "fn": "booleanEquals", - "argv": [ - true, + "conditions": [ { - "fn": "getAttr", + "fn": "booleanEquals", "argv": [ { - "ref": "PartitionResult" + "ref": "UseFIPS" }, - "supportsFIPS" + true + ] + } + ], + "type": "tree", + "rules": [ + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + true, + { + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsFIPS" + ] + } + ] + } + ], + "type": "tree", + "rules": [ + { + "conditions": [], + "type": "tree", + "rules": [ + { + "conditions": [], + "endpoint": { + "url": "https://aoss-fips.{Region}.{PartitionResult#dnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" + } + ] + } ] + }, + { + "conditions": [], + "error": "FIPS is enabled but this partition does not support FIPS", + "type": "error" } ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://aoss-fips.{Region}.{PartitionResult#dnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } - ] - }, - { - "conditions": [], - "error": "FIPS is enabled but this partition does not support FIPS", - "type": "error" - } - ] - }, - { - "conditions": [ - { - "fn": "booleanEquals", - "argv": [ - { - "ref": "UseDualStack" }, - true - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [ { - "fn": "booleanEquals", - "argv": [ - true, + "conditions": [ { - "fn": "getAttr", + "fn": "booleanEquals", "argv": [ { - "ref": "PartitionResult" + "ref": "UseDualStack" }, - "supportsDualStack" + true + ] + } + ], + "type": "tree", + "rules": [ + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + true, + { + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsDualStack" + ] + } + ] + } + ], + "type": "tree", + "rules": [ + { + "conditions": [], + "type": "tree", + "rules": [ + { + "conditions": [], + "endpoint": { + "url": "https://aoss.{Region}.{PartitionResult#dualStackDnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" + } + ] + } ] + }, + { + "conditions": [], + "error": "DualStack is enabled but this partition does not support DualStack", + "type": "error" } ] - } - ], - "type": "tree", - "rules": [ + }, { "conditions": [], - "endpoint": { - "url": "https://aoss.{Region}.{PartitionResult#dualStackDnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" + "type": "tree", + "rules": [ + { + "conditions": [], + "endpoint": { + "url": "https://aoss.{Region}.{PartitionResult#dnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" + } + ] } ] - }, - { - "conditions": [], - "error": "DualStack is enabled but this partition does not support DualStack", - "type": "error" } ] }, { "conditions": [], - "endpoint": { - "url": "https://aoss.{Region}.{PartitionResult#dnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" + "error": "Invalid Configuration: Missing Region", + "type": "error" } ] } diff --git a/models/apis/opensearchserverless/2021-11-01/endpoint-tests-1.json b/models/apis/opensearchserverless/2021-11-01/endpoint-tests-1.json index c00d2d53e4..394379dc69 100644 --- a/models/apis/opensearchserverless/2021-11-01/endpoint-tests-1.json +++ b/models/apis/opensearchserverless/2021-11-01/endpoint-tests-1.json @@ -9,8 +9,8 @@ }, "params": { "UseDualStack": true, - "UseFIPS": true, - "Region": "us-gov-east-1" + "Region": "us-gov-east-1", + "UseFIPS": true } }, { @@ -22,8 +22,8 @@ }, "params": { "UseDualStack": false, - "UseFIPS": true, - "Region": "us-gov-east-1" + "Region": "us-gov-east-1", + "UseFIPS": true } }, { @@ -35,8 +35,8 @@ }, "params": { "UseDualStack": true, - "UseFIPS": false, - "Region": "us-gov-east-1" + "Region": "us-gov-east-1", + "UseFIPS": false } }, { @@ -48,8 +48,8 @@ }, "params": { "UseDualStack": false, - "UseFIPS": false, - "Region": "us-gov-east-1" + "Region": "us-gov-east-1", + "UseFIPS": false } }, { @@ -61,8 +61,8 @@ }, "params": { "UseDualStack": true, - "UseFIPS": true, - "Region": "cn-north-1" + "Region": "cn-north-1", + "UseFIPS": true } }, { @@ -74,8 +74,8 @@ }, "params": { "UseDualStack": false, - "UseFIPS": true, - "Region": "cn-north-1" + "Region": "cn-north-1", + "UseFIPS": true } }, { @@ -87,8 +87,8 @@ }, "params": { "UseDualStack": true, - "UseFIPS": false, - "Region": "cn-north-1" + "Region": "cn-north-1", + "UseFIPS": false } }, { @@ -100,8 +100,8 @@ }, "params": { "UseDualStack": false, - "UseFIPS": false, - "Region": "cn-north-1" + "Region": "cn-north-1", + "UseFIPS": false } }, { @@ -111,8 +111,8 @@ }, "params": { "UseDualStack": true, - "UseFIPS": true, - "Region": "us-iso-east-1" + "Region": "us-iso-east-1", + "UseFIPS": true } }, { @@ -124,8 +124,8 @@ }, "params": { "UseDualStack": false, - "UseFIPS": true, - "Region": "us-iso-east-1" + "Region": "us-iso-east-1", + "UseFIPS": true } }, { @@ -135,8 +135,8 @@ }, "params": { "UseDualStack": true, - "UseFIPS": false, - "Region": "us-iso-east-1" + "Region": "us-iso-east-1", + "UseFIPS": false } }, { @@ -148,8 +148,8 @@ }, "params": { "UseDualStack": false, - "UseFIPS": false, - "Region": "us-iso-east-1" + "Region": "us-iso-east-1", + "UseFIPS": false } }, { @@ -161,8 +161,8 @@ }, "params": { "UseDualStack": true, - "UseFIPS": true, - "Region": "us-east-1" + "Region": "us-east-1", + "UseFIPS": true } }, { @@ -174,8 +174,8 @@ }, "params": { "UseDualStack": false, - "UseFIPS": true, - "Region": "us-east-1" + "Region": "us-east-1", + "UseFIPS": true } }, { @@ -187,8 +187,8 @@ }, "params": { "UseDualStack": true, - "UseFIPS": false, - "Region": "us-east-1" + "Region": "us-east-1", + "UseFIPS": false } }, { @@ -200,8 +200,8 @@ }, "params": { "UseDualStack": false, - "UseFIPS": false, - "Region": "us-east-1" + "Region": "us-east-1", + "UseFIPS": false } }, { @@ -211,8 +211,8 @@ }, "params": { "UseDualStack": true, - "UseFIPS": true, - "Region": "us-isob-east-1" + "Region": "us-isob-east-1", + "UseFIPS": true } }, { @@ -224,8 +224,8 @@ }, "params": { "UseDualStack": false, - "UseFIPS": true, - "Region": "us-isob-east-1" + "Region": "us-isob-east-1", + "UseFIPS": true } }, { @@ -235,8 +235,8 @@ }, "params": { "UseDualStack": true, - "UseFIPS": false, - "Region": "us-isob-east-1" + "Region": "us-isob-east-1", + "UseFIPS": false } }, { @@ -248,8 +248,8 @@ }, "params": { "UseDualStack": false, - "UseFIPS": false, - "Region": "us-isob-east-1" + "Region": "us-isob-east-1", + "UseFIPS": false } }, { @@ -261,8 +261,8 @@ }, "params": { "UseDualStack": false, - "UseFIPS": false, "Region": "us-east-1", + "UseFIPS": false, "Endpoint": "https://example.com" } }, @@ -273,8 +273,8 @@ }, "params": { "UseDualStack": false, - "UseFIPS": true, "Region": "us-east-1", + "UseFIPS": true, "Endpoint": "https://example.com" } }, @@ -285,8 +285,8 @@ }, "params": { "UseDualStack": true, - "UseFIPS": false, "Region": "us-east-1", + "UseFIPS": false, "Endpoint": "https://example.com" } } diff --git a/models/apis/rds/2014-10-31/api-2.json b/models/apis/rds/2014-10-31/api-2.json index 490e592dcf..3fee5db06e 100644 --- a/models/apis/rds/2014-10-31/api-2.json +++ b/models/apis/rds/2014-10-31/api-2.json @@ -415,7 +415,9 @@ {"shape":"InstanceQuotaExceededFault"}, {"shape":"StorageQuotaExceededFault"}, {"shape":"DBInstanceNotFoundFault"}, + {"shape":"DBClusterNotFoundFault"}, {"shape":"InvalidDBInstanceStateFault"}, + {"shape":"InvalidDBClusterStateFault"}, {"shape":"DBSubnetGroupNotFoundFault"}, {"shape":"DBSubnetGroupDoesNotCoverEnoughAZs"}, {"shape":"InvalidSubnet"}, @@ -3298,10 +3300,7 @@ }, "CreateDBInstanceReadReplicaMessage":{ "type":"structure", - "required":[ - "DBInstanceIdentifier", - "SourceDBInstanceIdentifier" - ], + "required":["DBInstanceIdentifier"], "members":{ "DBInstanceIdentifier":{"shape":"String"}, "SourceDBInstanceIdentifier":{"shape":"String"}, @@ -3339,7 +3338,8 @@ "NetworkType":{"shape":"String"}, "StorageThroughput":{"shape":"IntegerOptional"}, "EnableCustomerOwnedIp":{"shape":"BooleanOptional"}, - "AllocatedStorage":{"shape":"IntegerOptional"} + "AllocatedStorage":{"shape":"IntegerOptional"}, + "SourceDBClusterIdentifier":{"shape":"String"} } }, "CreateDBInstanceReadReplicaResult":{ @@ -4203,7 +4203,8 @@ "StorageThroughput":{"shape":"IntegerOptional"}, "DBSystemId":{"shape":"String"}, "MasterUserSecret":{"shape":"MasterUserSecret"}, - "CertificateDetails":{"shape":"CertificateDetails"} + "CertificateDetails":{"shape":"CertificateDetails"}, + "ReadReplicaSourceDBClusterIdentifier":{"shape":"String"} }, "wrapper":true }, diff --git a/models/apis/rds/2014-10-31/docs-2.json b/models/apis/rds/2014-10-31/docs-2.json index 49e1155cdb..4dcd72566a 100644 --- a/models/apis/rds/2014-10-31/docs-2.json +++ b/models/apis/rds/2014-10-31/docs-2.json @@ -17,12 +17,12 @@ "CopyOptionGroup": "Copies the specified option group.
", "CreateBlueGreenDeployment": "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.
", "CreateCustomDBEngineVersion": "Creates a custom DB engine version (CEV).
", - "CreateDBCluster": "Creates a new Amazon Aurora DB cluster or Multi-AZ DB cluster.
If you create an Aurora DB cluster, the request creates an empty cluster. You must explicitly create the writer instance for your DB cluster using the CreateDBInstance operation. If you create a Multi-AZ DB cluster, the request creates a writer and two reader DB instances for you, each in a different Availability Zone.
You can use the ReplicationSourceIdentifier parameter to create an Amazon Aurora DB cluster as a read replica of another DB cluster or Amazon RDS MySQL or PostgreSQL DB instance. For more information about Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
You can also use the ReplicationSourceIdentifier parameter to create a Multi-AZ DB cluster read replica with an RDS for PostgreSQL DB instance as the source. For more information about Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
Creates a new Amazon Aurora DB cluster or Multi-AZ DB cluster.
If you create an Aurora DB cluster, the request creates an empty cluster. You must explicitly create the writer instance for your DB cluster using the CreateDBInstance operation. If you create a Multi-AZ DB cluster, the request creates a writer and two reader DB instances for you, each in a different Availability Zone.
You can use the ReplicationSourceIdentifier parameter to create an Amazon Aurora DB cluster as a read replica of another DB cluster or Amazon RDS for MySQL or PostgreSQL DB instance. For more information about Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.
You can also use the ReplicationSourceIdentifier parameter to create a Multi-AZ DB cluster read replica with an RDS for MySQL or PostgreSQL DB instance as the source. For more information about Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
Creates a new custom endpoint and associates it with an Amazon Aurora DB cluster.
This action applies only to Aurora DB clusters.
Creates a new DB cluster parameter group.
Parameters in a DB cluster parameter group apply to all of the instances in a DB cluster.
A DB cluster parameter group is initially created with the default parameters for the database engine used by instances in the DB cluster. To provide custom values for any of the parameters, you must modify the group after creating it using ModifyDBClusterParameterGroup. Once you've created a DB cluster parameter group, you need to associate it with your DB cluster using ModifyDBCluster.
When you associate a new DB cluster parameter group with a running Aurora DB cluster, reboot the DB instances in the DB cluster without failover for the new DB cluster parameter group and associated settings to take effect.
When you associate a new DB cluster parameter group with a running Multi-AZ DB cluster, reboot the DB cluster without failover for the new DB cluster parameter group and associated settings to take effect.
After you create a DB cluster parameter group, you should wait at least 5 minutes before creating your first DB cluster that uses that DB cluster parameter group as the default parameter group. This allows Amazon RDS to fully complete the create action before the DB cluster parameter group is used as the default for a new DB cluster. This is especially important for parameters that are critical when creating the default database for a DB cluster, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon RDS console or the DescribeDBClusterParameters operation to verify that your DB cluster parameter group has been created or modified.
For more information on Amazon Aurora, 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.
", "CreateDBClusterSnapshot": "Creates a snapshot of a DB cluster.
For more information on Amazon Aurora, 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.
", "CreateDBInstance": "Creates a new DB instance.
The new DB instance can be an RDS DB instance, or it can be a DB instance in an Aurora DB cluster. For an Aurora DB cluster, you can call this operation multiple times to add more than one DB instance to the cluster.
For more information about creating an RDS DB instance, see Creating an Amazon RDS DB instance in the Amazon RDS User Guide.
For more information about creating a DB instance in an Aurora DB cluster, see Creating an Amazon Aurora DB cluster in the Amazon Aurora User Guide.
", - "CreateDBInstanceReadReplica": "Creates a new DB instance that acts as a read replica for an existing source DB instance. You can create a read replica for a DB instance running MySQL, MariaDB, Oracle, PostgreSQL, or SQL Server. For more information, see Working with Read Replicas in the Amazon RDS User Guide.
Amazon Aurora doesn't support this operation. Call the CreateDBInstance operation to create a DB instance for an Aurora DB cluster.
All read replica DB instances are created with backups disabled. All other DB instance attributes (including DB security groups and DB parameter groups) are inherited from the source DB instance, except as specified.
Your source DB instance must have backup retention enabled.
Creates a new DB instance that acts as a read replica for an existing source DB instance or Multi-AZ DB cluster. You can create a read replica for a DB instance running MySQL, MariaDB, Oracle, PostgreSQL, or SQL Server. You can create a read replica for a Multi-AZ DB cluster running MySQL or PostgreSQL. For more information, see Working with read replicas and Migrating from a Multi-AZ DB cluster to a DB instance using a read replica in the Amazon RDS User Guide.
Amazon Aurora doesn't support this operation. Call the CreateDBInstance operation to create a DB instance for an Aurora DB cluster.
All read replica DB instances are created with backups disabled. All other attributes (including DB security groups and DB parameter groups) are inherited from the source DB instance or cluster, except as specified.
Your source DB instance or cluster must have backup retention enabled.
Creates a new DB parameter group.
A DB parameter group is initially created with the default parameters for the database engine used by the DB instance. To provide custom values for any of the parameters, you must modify the group after creating it using ModifyDBParameterGroup. Once you've created a DB parameter group, you need to associate it with your DB instance using ModifyDBInstance. When you associate a new DB parameter group with a running DB instance, you need to reboot the DB instance without failover for the new DB parameter group and associated settings to take effect.
This command doesn't apply to RDS Custom.
After you create a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon RDS to fully complete the create action before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon RDS console or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.
Creates a new DB proxy.
", "CreateDBProxyEndpoint": "Creates a DBProxyEndpoint. Only applies to proxies that are associated with Aurora DB clusters. You can use DB proxy endpoints to specify read/write or read-only access to the DB cluster. You can also use DB proxy endpoints to access a DB proxy through a different VPC than the proxy's default VPC.
Creates a new option group. You can create up to 20 option groups.
This command doesn't apply to RDS Custom.
", "DeleteBlueGreenDeployment": "Deletes a blue/green deployment.
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.
", "DeleteCustomDBEngineVersion": "Deletes a custom engine version. To run this command, make sure you meet the following prerequisites:
The CEV must not be the default for RDS Custom. If it is, change the default before running this command.
The CEV must not be associated with an RDS Custom DB instance, RDS Custom instance snapshot, or automated backup of your RDS Custom instance.
Typically, deletion takes a few minutes.
The MediaImport service that imports files from Amazon S3 to create CEVs isn't integrated with Amazon Web Services CloudTrail. If you turn on data logging for Amazon RDS in CloudTrail, calls to the DeleteCustomDbEngineVersion event aren't logged. However, you might see calls from the API gateway that accesses your Amazon S3 bucket. These calls originate from the MediaImport service for the DeleteCustomDbEngineVersion event.
For more information, see Deleting a CEV in the Amazon RDS User Guide.
", - "DeleteDBCluster": "The DeleteDBCluster action deletes a previously provisioned DB cluster. When you delete a DB cluster, all automated backups for that DB cluster are deleted and can't be recovered. Manual DB cluster snapshots of the specified DB cluster are not deleted.
For more information on Amazon Aurora, 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.
", + "DeleteDBCluster": "The DeleteDBCluster action deletes a previously provisioned DB cluster. When you delete a DB cluster, all automated backups for that DB cluster are deleted and can't be recovered. Manual DB cluster snapshots of the specified DB cluster are not deleted.
If you're deleting a Multi-AZ DB cluster with read replicas, all cluster members are terminated and read replicas are promoted to standalone instances.
For more information on Amazon Aurora, 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.
", "DeleteDBClusterEndpoint": "Deletes a custom endpoint and removes it from an Amazon Aurora DB cluster.
This action only applies to Aurora DB clusters.
Deletes a specified DB cluster parameter group. The DB cluster parameter group to be deleted can't be associated with any DB clusters.
For more information on Amazon Aurora, 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.
", "DeleteDBClusterSnapshot": "Deletes a DB cluster snapshot. If the snapshot is being copied, the copy operation is terminated.
The DB cluster snapshot must be in the available state to be deleted.
For more information on Amazon Aurora, 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.
", @@ -538,7 +538,7 @@ "CreateDBInstanceMessage$DeletionProtection": "A value that indicates whether the DB instance has deletion protection enabled. The database can't be deleted when deletion protection is enabled. By default, deletion protection isn't enabled. For more information, see Deleting a DB Instance.
Amazon Aurora
Not applicable. You can enable or disable deletion protection for the DB cluster. For more information, see CreateDBCluster. DB instances in a DB cluster can be deleted even when deletion protection is enabled for the DB cluster.
A value that indicates whether to enable a customer-owned IP address (CoIP) for an RDS on Outposts DB instance.
A CoIP provides local or external connectivity to resources in your Outpost subnets through your on-premises network. For some use cases, a CoIP can provide lower latency for connections to the DB instance from outside of its virtual private cloud (VPC) on your local network.
For more information about RDS on Outposts, see Working with Amazon RDS on Amazon Web Services Outposts in the Amazon RDS User Guide.
For more information about CoIPs, see Customer-owned IP addresses in the Amazon Web Services Outposts User Guide.
", "CreateDBInstanceMessage$ManageMasterUserPassword": "A value that indicates whether to manage the master user password with Amazon Web Services Secrets Manager.
For more information, see Password management with Amazon Web Services Secrets Manager in the Amazon RDS User Guide.
Constraints:
Can't manage the master user password with Amazon Web Services Secrets Manager if MasterUserPassword is specified.
A value that indicates whether the read replica is in a Multi-AZ deployment.
You can create a read replica as a Multi-AZ DB instance. RDS creates a standby of your replica in another Availability Zone for failover support for the replica. Creating your read replica as a Multi-AZ DB instance is independent of whether the source database is a Multi-AZ DB instance.
This setting doesn't apply to RDS Custom.
", + "CreateDBInstanceReadReplicaMessage$MultiAZ": "A value that indicates whether the read replica is in a Multi-AZ deployment.
You can create a read replica as a Multi-AZ DB instance. RDS creates a standby of your replica in another Availability Zone for failover support for the replica. Creating your read replica as a Multi-AZ DB instance is independent of whether the source is a Multi-AZ DB instance or a Multi-AZ DB cluster.
This setting doesn't apply to RDS Custom.
", "CreateDBInstanceReadReplicaMessage$AutoMinorVersionUpgrade": "A value that indicates whether minor engine upgrades are applied automatically to the read replica during the maintenance window.
This setting doesn't apply to RDS Custom.
Default: Inherits from the source DB instance
", "CreateDBInstanceReadReplicaMessage$PubliclyAccessible": "A value that indicates whether the DB instance is publicly accessible.
When the DB cluster is publicly accessible, its Domain Name System (DNS) endpoint resolves to the private IP address from within the DB cluster's virtual private cloud (VPC). It resolves to the public IP address from outside of the DB cluster's VPC. Access to the DB cluster is ultimately controlled by the security group it uses. That public access isn't permitted if the security group assigned to the DB cluster doesn't permit it.
When the DB instance isn't publicly accessible, it is an internal DB instance with a DNS name that resolves to a private IP address.
For more information, see CreateDBInstance.
", "CreateDBInstanceReadReplicaMessage$CopyTagsToSnapshot": "A value that indicates whether to copy all tags from the read replica to snapshots of the read replica. By default, tags are not copied.
", @@ -4004,7 +4004,7 @@ "CreateDBClusterMessage$OptionGroupName": "A value that indicates that the DB cluster should be associated with the specified option group.
DB clusters are associated with a default option group that can't be modified.
", "CreateDBClusterMessage$PreferredBackupWindow": "The daily time range during which automated backups are created if automated backups are enabled using the BackupRetentionPeriod parameter.
The default is a 30-minute window selected at random from an 8-hour block of time for each Amazon Web Services Region. To view the time blocks available, see Backup window in the Amazon Aurora User Guide.
Constraints:
Must be in the format hh24:mi-hh24:mi.
Must be in Universal Coordinated Time (UTC).
Must not conflict with the preferred maintenance window.
Must be at least 30 minutes.
Valid for: Aurora DB clusters and Multi-AZ DB clusters
", "CreateDBClusterMessage$PreferredMaintenanceWindow": "The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).
Format: ddd:hh24:mi-ddd:hh24:mi
The default is a 30-minute window selected at random from an 8-hour block of time for each Amazon Web Services Region, occurring on a random day of the week. To see the time blocks available, see Adjusting the Preferred DB Cluster Maintenance Window in the Amazon Aurora User Guide.
Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.
Constraints: Minimum 30-minute window.
Valid for: Aurora DB clusters and Multi-AZ DB clusters
", - "CreateDBClusterMessage$ReplicationSourceIdentifier": "The Amazon Resource Name (ARN) of the source DB instance or DB cluster if this DB cluster is created as a read replica.
Valid for: Aurora DB clusters and RDS for PostgreSQL Multi-AZ DB clusters
", + "CreateDBClusterMessage$ReplicationSourceIdentifier": "The Amazon Resource Name (ARN) of the source DB instance or DB cluster if this DB cluster is created as a read replica.
Valid for: Aurora DB clusters and Multi-AZ DB clusters
", "CreateDBClusterMessage$KmsKeyId": "The Amazon Web Services KMS key identifier for an encrypted DB cluster.
The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key. To use a KMS key in a different Amazon Web Services account, specify the key ARN or alias ARN.
When a KMS key isn't specified in KmsKeyId:
If ReplicationSourceIdentifier identifies an encrypted source, then Amazon RDS will use the KMS key used to encrypt the source. Otherwise, Amazon RDS will use your default KMS key.
If the StorageEncrypted parameter is enabled and ReplicationSourceIdentifier isn't specified, then Amazon RDS will use your default KMS key.
There is a default KMS key for your Amazon Web Services account. Your Amazon Web Services account has a different default KMS key for each Amazon Web Services Region.
If you create a read replica of an encrypted DB cluster in another Amazon Web Services Region, you must set KmsKeyId to a KMS key identifier that is valid in the destination Amazon Web Services Region. This KMS key is used to encrypt the read replica in that Amazon Web Services Region.
Valid for: Aurora DB clusters and Multi-AZ DB clusters
", "CreateDBClusterMessage$PreSignedUrl": "When you are replicating a DB cluster from one Amazon Web Services GovCloud (US) Region to another, an URL that contains a Signature Version 4 signed request for the CreateDBCluster operation to be called in the source Amazon Web Services Region where the DB cluster is replicated from. Specify PreSignedUrl only when you are performing cross-Region replication from an encrypted DB cluster.
The presigned URL must be a valid request for the CreateDBCluster API operation that can run in the source Amazon Web Services Region that contains the encrypted DB cluster to copy.
The presigned URL request must contain the following parameter values:
KmsKeyId - The KMS key identifier for the KMS key to use to encrypt the copy of the DB cluster in the destination Amazon Web Services Region. This should refer to the same KMS key for both the CreateDBCluster operation that is called in the destination Amazon Web Services Region, and the operation contained in the presigned URL.
DestinationRegion - The name of the Amazon Web Services Region that Aurora read replica will be created in.
ReplicationSourceIdentifier - The DB cluster identifier for the encrypted DB cluster to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source Amazon Web Services Region. For example, if you are copying an encrypted DB cluster from the us-west-2 Amazon Web Services Region, then your ReplicationSourceIdentifier would look like Example: arn:aws:rds:us-west-2:123456789012:cluster:aurora-cluster1.
To learn how to generate a Signature Version 4 signed request, see Authenticating Requests: Using Query Parameters (Amazon Web Services Signature Version 4) and Signature Version 4 Signing Process.
If you are using an Amazon Web Services SDK tool or the CLI, you can specify SourceRegion (or --source-region for the CLI) instead of specifying PreSignedUrl manually. Specifying SourceRegion autogenerates a presigned URL that is a valid request for the operation that can run in the source Amazon Web Services Region.
Valid for: Aurora DB clusters only
", "CreateDBClusterMessage$EngineMode": "The DB engine mode of the DB cluster, either provisioned or serverless.
The serverless engine mode only applies for Aurora Serverless v1 DB clusters.
Limitations and requirements apply to some DB engine modes. For more information, see the following sections in the Amazon Aurora User Guide:
Valid for: Aurora DB clusters only
", @@ -4055,21 +4055,22 @@ "CreateDBInstanceMessage$MasterUserSecretKmsKeyId": "The Amazon Web Services KMS key identifier to encrypt a secret that is automatically generated and managed in Amazon Web Services Secrets Manager.
This setting is valid only if the master user password is managed by RDS in Amazon Web Services Secrets Manager for the DB instance.
The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key. To use a KMS key in a different Amazon Web Services account, specify the key ARN or alias ARN.
If you don't specify MasterUserSecretKmsKeyId, then the aws/secretsmanager KMS key is used to encrypt the secret. If the secret is in a different Amazon Web Services account, then you can't use the aws/secretsmanager KMS key to encrypt the secret, and you must use a customer managed KMS key.
There is a default KMS key for your Amazon Web Services account. Your Amazon Web Services account has a different default KMS key for each Amazon Web Services Region.
", "CreateDBInstanceMessage$CACertificateIdentifier": "Specifies the CA certificate identifier to use for the DB instance’s server certificate.
This setting doesn't apply to RDS Custom.
For more information, see Using SSL/TLS to encrypt a connection to a DB instance in the Amazon RDS User Guide and Using SSL/TLS to encrypt a connection to a DB cluster in the Amazon Aurora User Guide.
", "CreateDBInstanceReadReplicaMessage$DBInstanceIdentifier": "The DB instance identifier of the read replica. This identifier is the unique key that identifies a DB instance. This parameter is stored as a lowercase string.
", - "CreateDBInstanceReadReplicaMessage$SourceDBInstanceIdentifier": "The identifier of the DB instance that will act as the source for the read replica. Each DB instance can have up to five read replicas.
Constraints:
Must be the identifier of an existing MySQL, MariaDB, Oracle, PostgreSQL, or SQL Server DB instance.
Can specify a DB instance that is a MySQL read replica only if the source is running MySQL 5.6 or later.
For the limitations of Oracle read replicas, see Read Replica Limitations with Oracle in the Amazon RDS User Guide.
For the limitations of SQL Server read replicas, see Read Replica Limitations with Microsoft SQL Server in the Amazon RDS User Guide.
Can specify a PostgreSQL DB instance only if the source is running PostgreSQL 9.3.5 or later (9.4.7 and higher for cross-Region replication).
The specified DB instance must have automatic backups enabled, that is, its backup retention period must be greater than 0.
If the source DB instance is in the same Amazon Web Services Region as the read replica, specify a valid DB instance identifier.
If the source DB instance is in a different Amazon Web Services Region from the read replica, specify a valid DB instance ARN. For more information, see Constructing an ARN for Amazon RDS in the Amazon RDS User Guide. This doesn't apply to SQL Server or RDS Custom, which don't support cross-Region replicas.
The identifier of the DB instance that will act as the source for the read replica. Each DB instance can have up to 15 read replicas, with the exception of Oracle and SQL Server, which can have up to five.
Constraints:
Must be the identifier of an existing MySQL, MariaDB, Oracle, PostgreSQL, or SQL Server DB instance.
Can't be specified if the SourceDBClusterIdentifier parameter is also specified.
For the limitations of Oracle read replicas, see Version and licensing considerations for RDS for Oracle replicas in the Amazon RDS User Guide.
For the limitations of SQL Server read replicas, see Read replica limitations with SQL Server in the Amazon RDS User Guide.
The specified DB instance must have automatic backups enabled, that is, its backup retention period must be greater than 0.
If the source DB instance is in the same Amazon Web Services Region as the read replica, specify a valid DB instance identifier.
If the source DB instance is in a different Amazon Web Services Region from the read replica, specify a valid DB instance ARN. For more information, see Constructing an ARN for Amazon RDS in the Amazon RDS User Guide. This doesn't apply to SQL Server or RDS Custom, which don't support cross-Region replicas.
The compute and memory capacity of the read replica, for example db.m4.large. Not all DB instance classes are available in all Amazon Web Services Regions, or for all database engines. For the full list of DB instance classes, and availability for your engine, see DB Instance Class in the Amazon RDS User Guide.
Default: Inherits from the source DB instance.
", "CreateDBInstanceReadReplicaMessage$AvailabilityZone": "The Availability Zone (AZ) where the read replica will be created.
Default: A random, system-chosen Availability Zone in the endpoint's Amazon Web Services Region.
Example: us-east-1d
The option group the DB instance is associated with. If omitted, the option group associated with the source instance is used.
For SQL Server, you must use the option group associated with the source instance.
This setting doesn't apply to RDS Custom.
", + "CreateDBInstanceReadReplicaMessage$OptionGroupName": "The option group the DB instance is associated with. If omitted, the option group associated with the source instance or cluster is used.
For SQL Server, you must use the option group associated with the source.
This setting doesn't apply to RDS Custom.
", "CreateDBInstanceReadReplicaMessage$DBParameterGroupName": "The name of the DB parameter group to associate with this DB instance.
If you do not specify a value for DBParameterGroupName, then Amazon RDS uses the DBParameterGroup of source DB instance for a same Region read replica, or the default DBParameterGroup for the specified DB engine for a cross-Region read replica.
Specifying a parameter group for this operation is only supported for MySQL and Oracle DB instances. It isn't supported for RDS Custom.
Constraints:
Must be 1 to 255 letters, numbers, or hyphens.
First character must be a letter
Can't end with a hyphen or contain two consecutive hyphens
Specifies a DB subnet group for the DB instance. The new DB instance is created in the VPC associated with the DB subnet group. If no DB subnet group is specified, then the new DB instance isn't created in a VPC.
Constraints:
Can only be specified if the source DB instance identifier specifies a DB instance in another Amazon Web Services Region.
If supplied, must match the name of an existing DBSubnetGroup.
The specified DB subnet group must be in the same Amazon Web Services Region in which the operation is running.
All read replicas in one Amazon Web Services Region that are created from the same source DB instance must either:>
Specify DB subnet groups from the same VPC. All these read replicas are created in the same VPC.
Not specify a DB subnet group. All these read replicas are created outside of any VPC.
Example: mydbsubnetgroup
Specifies the storage type to be associated with the read replica.
Valid values: gp2 | gp3 | io1 | standard
If you specify io1 or gp3, you must also include a value for the Iops parameter.
Default: io1 if the Iops parameter is specified, otherwise gp2
The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to Amazon CloudWatch Logs. For example, arn:aws:iam:123456789012:role/emaccess. For information on creating a monitoring role, go to To create an IAM role for Amazon RDS Enhanced Monitoring in the Amazon RDS User Guide.
If MonitoringInterval is set to a value other than 0, then you must supply a MonitoringRoleArn value.
This setting doesn't apply to RDS Custom.
", - "CreateDBInstanceReadReplicaMessage$KmsKeyId": "The Amazon Web Services KMS key identifier for an encrypted read replica.
The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.
If you create an encrypted read replica in the same Amazon Web Services Region as the source DB instance, then do not specify a value for this parameter. A read replica in the same Amazon Web Services Region is always encrypted with the same KMS key as the source DB instance.
If you create an encrypted read replica in a different Amazon Web Services Region, then you must specify a KMS key identifier for the destination Amazon Web Services Region. KMS keys are specific to the Amazon Web Services Region that they are created in, and you can't use KMS keys from one Amazon Web Services Region in another Amazon Web Services Region.
You can't create an encrypted read replica from an unencrypted DB instance.
This setting doesn't apply to RDS Custom, which uses the same KMS key as the primary replica.
", - "CreateDBInstanceReadReplicaMessage$PreSignedUrl": "When you are creating a read replica from one Amazon Web Services GovCloud (US) Region to another or from one China Amazon Web Services Region to another, the URL that contains a Signature Version 4 signed request for the CreateDBInstanceReadReplica API operation in the source Amazon Web Services Region that contains the source DB instance.
This setting applies only to Amazon Web Services GovCloud (US) Regions and China Amazon Web Services Regions. It's ignored in other Amazon Web Services Regions.
You must specify this parameter when you create an encrypted read replica from another Amazon Web Services Region by using the Amazon RDS API. Don't specify PreSignedUrl when you are creating an encrypted read replica in the same Amazon Web Services Region.
The presigned URL must be a valid request for the CreateDBInstanceReadReplica API operation that can run in the source Amazon Web Services Region that contains the encrypted source DB instance. The presigned URL request must contain the following parameter values:
DestinationRegion - The Amazon Web Services Region that the encrypted read replica is created in. This Amazon Web Services Region is the same one where the CreateDBInstanceReadReplica operation is called that contains this presigned URL.
For example, if you create an encrypted DB instance in the us-west-1 Amazon Web Services Region, from a source DB instance in the us-east-2 Amazon Web Services Region, then you call the CreateDBInstanceReadReplica operation in the us-east-1 Amazon Web Services Region and provide a presigned URL that contains a call to the CreateDBInstanceReadReplica operation in the us-west-2 Amazon Web Services Region. For this example, the DestinationRegion in the presigned URL must be set to the us-east-1 Amazon Web Services Region.
KmsKeyId - The KMS key identifier for the key to use to encrypt the read replica in the destination Amazon Web Services Region. This is the same identifier for both the CreateDBInstanceReadReplica operation that is called in the destination Amazon Web Services Region, and the operation contained in the presigned URL.
SourceDBInstanceIdentifier - The DB instance identifier for the encrypted DB instance to be replicated. This identifier must be in the Amazon Resource Name (ARN) format for the source Amazon Web Services Region. For example, if you are creating an encrypted read replica from a DB instance in the us-west-2 Amazon Web Services Region, then your SourceDBInstanceIdentifier looks like the following example: arn:aws:rds:us-west-2:123456789012:instance:mysql-instance1-20161115.
To learn how to generate a Signature Version 4 signed request, see Authenticating Requests: Using Query Parameters (Amazon Web Services Signature Version 4) and Signature Version 4 Signing Process.
If you are using an Amazon Web Services SDK tool or the CLI, you can specify SourceRegion (or --source-region for the CLI) instead of specifying PreSignedUrl manually. Specifying SourceRegion autogenerates a presigned URL that is a valid request for the operation that can run in the source Amazon Web Services Region.
SourceRegion isn't supported for SQL Server, because Amazon RDS for SQL Server doesn't support cross-Region read replicas.
This setting doesn't apply to RDS Custom.
", + "CreateDBInstanceReadReplicaMessage$KmsKeyId": "The Amazon Web Services KMS key identifier for an encrypted read replica.
The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.
If you create an encrypted read replica in the same Amazon Web Services Region as the source DB instance or Multi-AZ DB cluster, don't specify a value for this parameter. A read replica in the same Amazon Web Services Region is always encrypted with the same KMS key as the source DB instance or cluster.
If you create an encrypted read replica in a different Amazon Web Services Region, then you must specify a KMS key identifier for the destination Amazon Web Services Region. KMS keys are specific to the Amazon Web Services Region that they are created in, and you can't use KMS keys from one Amazon Web Services Region in another Amazon Web Services Region.
You can't create an encrypted read replica from an unencrypted DB instance or Multi-AZ DB cluster.
This setting doesn't apply to RDS Custom, which uses the same KMS key as the primary replica.
", + "CreateDBInstanceReadReplicaMessage$PreSignedUrl": "When you are creating a read replica from one Amazon Web Services GovCloud (US) Region to another or from one China Amazon Web Services Region to another, the URL that contains a Signature Version 4 signed request for the CreateDBInstanceReadReplica API operation in the source Amazon Web Services Region that contains the source DB instance.
This setting applies only to Amazon Web Services GovCloud (US) Regions and China Amazon Web Services Regions. It's ignored in other Amazon Web Services Regions.
This setting applies only when replicating from a source DB instance. Source DB clusters aren't supported in Amazon Web Services GovCloud (US) Regions and China Amazon Web Services Regions.
You must specify this parameter when you create an encrypted read replica from another Amazon Web Services Region by using the Amazon RDS API. Don't specify PreSignedUrl when you are creating an encrypted read replica in the same Amazon Web Services Region.
The presigned URL must be a valid request for the CreateDBInstanceReadReplica API operation that can run in the source Amazon Web Services Region that contains the encrypted source DB instance. The presigned URL request must contain the following parameter values:
DestinationRegion - The Amazon Web Services Region that the encrypted read replica is created in. This Amazon Web Services Region is the same one where the CreateDBInstanceReadReplica operation is called that contains this presigned URL.
For example, if you create an encrypted DB instance in the us-west-1 Amazon Web Services Region, from a source DB instance in the us-east-2 Amazon Web Services Region, then you call the CreateDBInstanceReadReplica operation in the us-east-1 Amazon Web Services Region and provide a presigned URL that contains a call to the CreateDBInstanceReadReplica operation in the us-west-2 Amazon Web Services Region. For this example, the DestinationRegion in the presigned URL must be set to the us-east-1 Amazon Web Services Region.
KmsKeyId - The KMS key identifier for the key to use to encrypt the read replica in the destination Amazon Web Services Region. This is the same identifier for both the CreateDBInstanceReadReplica operation that is called in the destination Amazon Web Services Region, and the operation contained in the presigned URL.
SourceDBInstanceIdentifier - The DB instance identifier for the encrypted DB instance to be replicated. This identifier must be in the Amazon Resource Name (ARN) format for the source Amazon Web Services Region. For example, if you are creating an encrypted read replica from a DB instance in the us-west-2 Amazon Web Services Region, then your SourceDBInstanceIdentifier looks like the following example: arn:aws:rds:us-west-2:123456789012:instance:mysql-instance1-20161115.
To learn how to generate a Signature Version 4 signed request, see Authenticating Requests: Using Query Parameters (Amazon Web Services Signature Version 4) and Signature Version 4 Signing Process.
If you are using an Amazon Web Services SDK tool or the CLI, you can specify SourceRegion (or --source-region for the CLI) instead of specifying PreSignedUrl manually. Specifying SourceRegion autogenerates a presigned URL that is a valid request for the operation that can run in the source Amazon Web Services Region.
SourceRegion isn't supported for SQL Server, because Amazon RDS for SQL Server doesn't support cross-Region read replicas.
This setting doesn't apply to RDS Custom.
", "CreateDBInstanceReadReplicaMessage$PerformanceInsightsKMSKeyId": "The Amazon Web Services KMS key identifier for encryption of Performance Insights data.
The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.
If you do not specify a value for PerformanceInsightsKMSKeyId, then Amazon RDS uses your default KMS key. There is a default KMS key for your Amazon Web Services account. Your Amazon Web Services account has a different default KMS key for each Amazon Web Services Region.
This setting doesn't apply to RDS Custom.
", "CreateDBInstanceReadReplicaMessage$Domain": "The Active Directory directory ID to create the DB instance in. Currently, only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances can be created in an Active Directory Domain.
For more information, see Kerberos Authentication in the Amazon RDS User Guide.
This setting doesn't apply to RDS Custom.
", - "CreateDBInstanceReadReplicaMessage$DomainIAMRoleName": "Specify the name of the IAM role to be used when making API calls to the Directory Service.
This setting doesn't apply to RDS Custom.
", + "CreateDBInstanceReadReplicaMessage$DomainIAMRoleName": "The name of the IAM role to be used when making API calls to the Directory Service.
This setting doesn't apply to RDS Custom.
", "CreateDBInstanceReadReplicaMessage$CustomIamInstanceProfile": "The instance profile associated with the underlying Amazon EC2 instance of an RDS Custom DB instance. The instance profile must meet the following requirements:
The profile must exist in your account.
The profile must have an IAM role that Amazon EC2 has permissions to assume.
The instance profile name and the associated IAM role name must start with the prefix AWSRDSCustom.
For the list of permissions required for the IAM role, see Configure IAM and your VPC in the Amazon RDS User Guide.
This setting is required for RDS Custom.
", "CreateDBInstanceReadReplicaMessage$NetworkType": "The network type of the DB instance.
Valid values:
IPV4
DUAL
The network type is determined by the DBSubnetGroup specified for read replica. A DBSubnetGroup can support only the IPv4 protocol or the IPv4 and the IPv6 protocols (DUAL).
For more information, see Working with a DB instance in a VPC in the Amazon RDS User Guide.
", + "CreateDBInstanceReadReplicaMessage$SourceDBClusterIdentifier": "The identifier of the Multi-AZ DB cluster that will act as the source for the read replica. Each DB cluster can have up to 15 read replicas.
Constraints:
Must be the identifier of an existing Multi-AZ DB cluster.
Can't be specified if the SourceDBInstanceIdentifier parameter is also specified.
The specified DB cluster must have automatic backups enabled, that is, its backup retention period must be greater than 0.
The source DB cluster must be in the same Amazon Web Services Region as the read replica. Cross-Region replication isn't supported.
The name of the DB parameter group.
Constraints:
Must be 1 to 255 letters, numbers, or hyphens.
First character must be a letter
Can't end with a hyphen or contain two consecutive hyphens
This value is stored as a lowercase string.
The DB parameter group family name. A DB parameter group can be associated with one and only one DB parameter group family, and can be applied only to a DB instance running a database engine and engine version compatible with that DB parameter group family.
To list all of the available parameter group families for a DB engine, use the following command:
aws rds describe-db-engine-versions --query \"DBEngineVersions[].DBParameterGroupFamily\" --engine <engine>
For example, to list all of the available parameter group families for the MySQL DB engine, use the following command:
aws rds describe-db-engine-versions --query \"DBEngineVersions[].DBParameterGroupFamily\" --engine mysql
The output contains duplicates.
The following are the valid DB engine values:
aurora (for MySQL 5.6-compatible Aurora)
aurora-mysql (for MySQL 5.7-compatible and MySQL 8.0-compatible Aurora)
aurora-postgresql
mariadb
mysql
oracle-ee
oracle-ee-cdb
oracle-se2
oracle-se2-cdb
postgres
sqlserver-ee
sqlserver-se
sqlserver-ex
sqlserver-web
The description for the DB parameter group.
", @@ -4217,6 +4218,7 @@ "DBInstance$BackupTarget": "Specifies where automated backups and manual snapshots are stored: Amazon Web Services Outposts or the Amazon Web Services Region.
", "DBInstance$NetworkType": "The network type of the DB instance.
Valid values:
IPV4
DUAL
The network type is determined by the DBSubnetGroup specified for the DB instance. A DBSubnetGroup can support only the IPv4 protocol or the IPv4 and the IPv6 protocols (DUAL).
For more information, see Working with a DB instance in a VPC in the Amazon RDS User Guide and Working with a DB instance in a VPC in the Amazon Aurora User Guide.
", "DBInstance$DBSystemId": "The Oracle system ID (Oracle SID) for a container database (CDB). The Oracle SID is also the name of the CDB. This setting is valid for RDS Custom only.
", + "DBInstance$ReadReplicaSourceDBClusterIdentifier": "Contains the identifier of the source DB cluster if this DB instance is a read replica.
", "DBInstanceAutomatedBackup$DBInstanceArn": "The Amazon Resource Name (ARN) for the automated backups.
", "DBInstanceAutomatedBackup$DbiResourceId": "The identifier for the source DB instance, which can't be changed and which is unique to an Amazon Web Services Region.
", "DBInstanceAutomatedBackup$Region": "The Amazon Web Services Region associated with the automated backup.
", @@ -4523,7 +4525,7 @@ "ModifyDBClusterMessage$OptionGroupName": "A value that indicates that the DB cluster should be associated with the specified option group.
DB clusters are associated with a default option group that can't be modified.
", "ModifyDBClusterMessage$PreferredBackupWindow": "The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter.
The default is a 30-minute window selected at random from an 8-hour block of time for each Amazon Web Services Region. To view the time blocks available, see Backup window in the Amazon Aurora User Guide.
Constraints:
Must be in the format hh24:mi-hh24:mi.
Must be in Universal Coordinated Time (UTC).
Must not conflict with the preferred maintenance window.
Must be at least 30 minutes.
Valid for: Aurora DB clusters and Multi-AZ DB clusters
", "ModifyDBClusterMessage$PreferredMaintenanceWindow": "The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).
Format: ddd:hh24:mi-ddd:hh24:mi
The default is a 30-minute window selected at random from an 8-hour block of time for each Amazon Web Services Region, occurring on a random day of the week. To see the time blocks available, see Adjusting the Preferred DB Cluster Maintenance Window in the Amazon Aurora User Guide.
Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.
Constraints: Minimum 30-minute window.
Valid for: Aurora DB clusters and Multi-AZ DB clusters
", - "ModifyDBClusterMessage$EngineVersion": "The version number of the database engine to which you want to upgrade. Changing this parameter results in an outage. The change is applied during the next maintenance window unless ApplyImmediately is enabled.
To list all of the available engine versions for Aurora MySQL version 2 (5.7-compatible) and version 3 (MySQL 8.0-compatible), use the following command:
aws rds describe-db-engine-versions --engine aurora-mysql --query \"DBEngineVersions[].EngineVersion\"
To list all of the available engine versions for Aurora PostgreSQL, use the following command:
aws rds describe-db-engine-versions --engine aurora-postgresql --query \"DBEngineVersions[].EngineVersion\"
To list all of the available engine versions for RDS for MySQL, use the following command:
aws rds describe-db-engine-versions --engine mysql --query \"DBEngineVersions[].EngineVersion\"
To list all of the available engine versions for RDS for PostgreSQL, use the following command:
aws rds describe-db-engine-versions --engine postgres --query \"DBEngineVersions[].EngineVersion\"
Valid for: Aurora DB clusters and Multi-AZ DB clusters
", + "ModifyDBClusterMessage$EngineVersion": "The version number of the database engine to which you want to upgrade. Changing this parameter results in an outage. The change is applied during the next maintenance window unless ApplyImmediately is enabled.
If the cluster that you're modifying has one or more read replicas, all replicas must be running an engine version that's the same or later than the version you specify.
To list all of the available engine versions for Aurora MySQL version 2 (5.7-compatible) and version 3 (MySQL 8.0-compatible), use the following command:
aws rds describe-db-engine-versions --engine aurora-mysql --query \"DBEngineVersions[].EngineVersion\"
To list all of the available engine versions for MySQL 5.6-compatible Aurora, use the following command:
aws rds describe-db-engine-versions --engine aurora --query \"DBEngineVersions[].EngineVersion\"
To list all of the available engine versions for Aurora PostgreSQL, use the following command:
aws rds describe-db-engine-versions --engine aurora-postgresql --query \"DBEngineVersions[].EngineVersion\"
To list all of the available engine versions for RDS for MySQL, use the following command:
aws rds describe-db-engine-versions --engine mysql --query \"DBEngineVersions[].EngineVersion\"
To list all of the available engine versions for RDS for PostgreSQL, use the following command:
aws rds describe-db-engine-versions --engine postgres --query \"DBEngineVersions[].EngineVersion\"
Valid for: Aurora DB clusters and Multi-AZ DB clusters
", "ModifyDBClusterMessage$DBInstanceParameterGroupName": "The name of the DB parameter group to apply to all instances of the DB cluster.
When you apply a parameter group using the DBInstanceParameterGroupName parameter, the DB cluster isn't rebooted automatically. Also, parameter changes are applied immediately rather than during the next maintenance window.
Default: The existing name setting
Constraints:
The DB parameter group must be in the same DB parameter group family as this DB cluster.
The DBInstanceParameterGroupName parameter is valid in combination with the AllowMajorVersionUpgrade parameter for a major version upgrade only.
Valid for: Aurora DB clusters only
", "ModifyDBClusterMessage$Domain": "The Active Directory directory ID to move the DB cluster to. Specify none to remove the cluster from its current domain. The domain must be created prior to this operation.
For more information, see Kerberos Authentication in the Amazon Aurora User Guide.
Valid for: Aurora DB clusters only
", "ModifyDBClusterMessage$DomainIAMRoleName": "Specify the name of the IAM role to be used when making API calls to the Directory Service.
Valid for: Aurora DB clusters only
", @@ -4543,7 +4545,7 @@ "ModifyDBInstanceMessage$DBParameterGroupName": "The name of the DB parameter group to apply to the DB instance.
Changing this setting doesn't result in an outage. The parameter group name itself is changed immediately, but the actual parameter changes are not applied until you reboot the instance without failover. In this case, the DB instance isn't rebooted automatically, and the parameter changes aren't applied during the next maintenance window. However, if you modify dynamic parameters in the newly associated DB parameter group, these changes are applied immediately without a reboot.
This setting doesn't apply to RDS Custom.
Default: Uses existing setting
Constraints: The DB parameter group must be in the same DB parameter group family as the DB instance.
", "ModifyDBInstanceMessage$PreferredBackupWindow": "The daily time range during which automated backups are created if automated backups are enabled, as determined by the BackupRetentionPeriod parameter. Changing this parameter doesn't result in an outage and the change is asynchronously applied as soon as possible. The default is a 30-minute window selected at random from an 8-hour block of time for each Amazon Web Services Region. For more information, see Backup window in the Amazon RDS User Guide.
Amazon Aurora
Not applicable. The daily time range for creating automated backups is managed by the DB cluster. For more information, see ModifyDBCluster.
Constraints:
Must be in the format hh24:mi-hh24:mi
Must be in Universal Time Coordinated (UTC)
Must not conflict with the preferred maintenance window
Must be at least 30 minutes
The weekly time range (in UTC) during which system maintenance can occur, which might result in an outage. Changing this parameter doesn't result in an outage, except in the following situation, and the change is asynchronously applied as soon as possible. If there are pending actions that cause a reboot, and the maintenance window is changed to include the current time, then changing this parameter will cause a reboot of the DB instance. If moving this window to the current time, there must be at least 30 minutes between the current time and end of the window to ensure pending changes are applied.
For more information, see Amazon RDS Maintenance Window in the Amazon RDS User Guide.
Default: Uses existing setting
Format: ddd:hh24:mi-ddd:hh24:mi
Valid Days: Mon | Tue | Wed | Thu | Fri | Sat | Sun
Constraints: Must be at least 30 minutes
", - "ModifyDBInstanceMessage$EngineVersion": "The version number of the database engine to upgrade to. Changing this parameter results in an outage and the change is applied during the next maintenance window unless the ApplyImmediately parameter is enabled for this request.
For major version upgrades, if a nondefault DB parameter group is currently in use, a new DB parameter group in the DB parameter group family for the new engine version must be specified. The new DB parameter group can be the default for that DB parameter group family.
If you specify only a major version, Amazon RDS will update the DB instance to the default minor version if the current minor version is lower. For information about valid engine versions, see CreateDBInstance, or call DescribeDBEngineVersions.
In RDS Custom for Oracle, this parameter is supported for read replicas only if they are in the PATCH_DB_FAILURE lifecycle.
The version number of the database engine to upgrade to. Changing this parameter results in an outage and the change is applied during the next maintenance window unless the ApplyImmediately parameter is enabled for this request.
For major version upgrades, if a nondefault DB parameter group is currently in use, a new DB parameter group in the DB parameter group family for the new engine version must be specified. The new DB parameter group can be the default for that DB parameter group family.
If you specify only a major version, Amazon RDS will update the DB instance to the default minor version if the current minor version is lower. For information about valid engine versions, see CreateDBInstance, or call DescribeDBEngineVersions.
If the instance that you're modifying is acting as a read replica, the engine version that you specify must be the same or later than the version that the source DB instance or cluster is running.
In RDS Custom for Oracle, this parameter is supported for read replicas only if they are in the PATCH_DB_FAILURE lifecycle.
The license model for the DB instance.
This setting doesn't apply to RDS Custom.
Valid values: license-included | bring-your-own-license | general-public-license
A value that indicates the DB instance should be associated with the specified option group.
Changing this parameter doesn't result in an outage, with one exception. If the parameter change results in an option group that enables OEM, it can cause a brief period, lasting less than a second, during which new connections are rejected but existing connections aren't interrupted.
The change is applied during the next maintenance window unless the ApplyImmediately parameter is enabled for this request.
Permanent options, such as the TDE option for Oracle Advanced Security TDE, can't be removed from an option group, and that option group can't be removed from a DB instance after it is associated with a DB instance.
This setting doesn't apply to RDS Custom.
", "ModifyDBInstanceMessage$NewDBInstanceIdentifier": "The new DB instance identifier for the DB instance when renaming a DB instance. When you change the DB instance identifier, an instance reboot occurs immediately if you enable ApplyImmediately, or will occur during the next maintenance window if you disable Apply Immediately. This value is stored as a lowercase string.
This setting doesn't apply to RDS Custom.
Constraints:
Must contain from 1 to 63 letters, numbers, or hyphens.
The first character must be a letter.
Can't end with a hyphen or contain two consecutive hyphens.
Example: mydbinstance
The Amazon Web Services KMS key identifier used for encrypting messages in the database activity stream.
The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.
", "StopActivityStreamResponse$KinesisStreamName": "The name of the Amazon Kinesis data stream used for the database activity stream.
", "StopDBClusterMessage$DBClusterIdentifier": "The DB cluster identifier of the Amazon Aurora DB cluster to be stopped. This parameter is stored as a lowercase string.
", - "StopDBInstanceAutomatedBackupsReplicationMessage$SourceDBInstanceArn": "The Amazon Resource Name (ARN) of the source DB instance for which to stop replicating automated backups, for example, arn:aws:rds:us-west-2:123456789012:db:mydatabase.
The Amazon Resource Name (ARN) of the source DB instance for which to stop replicating automate backups, for example, arn:aws:rds:us-west-2:123456789012:db:mydatabase.
The user-supplied instance identifier.
", "StopDBInstanceMessage$DBSnapshotIdentifier": "The user-supplied instance identifier of the DB Snapshot created immediately before the DB instance is stopped.
", "StringList$member": null, diff --git a/models/apis/rds/2014-10-31/endpoint-tests-1.json b/models/apis/rds/2014-10-31/endpoint-tests-1.json index 239943d839..8b0bc663a1 100644 --- a/models/apis/rds/2014-10-31/endpoint-tests-1.json +++ b/models/apis/rds/2014-10-31/endpoint-tests-1.json @@ -8,9 +8,9 @@ } }, "params": { - "UseDualStack": false, "Region": "af-south-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -21,9 +21,9 @@ } }, "params": { - "UseDualStack": false, "Region": "ap-east-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -34,9 +34,9 @@ } }, "params": { - "UseDualStack": false, "Region": "ap-northeast-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -47,9 +47,9 @@ } }, "params": { - "UseDualStack": false, "Region": "ap-northeast-2", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -60,9 +60,9 @@ } }, "params": { - "UseDualStack": false, "Region": "ap-northeast-3", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -73,9 +73,9 @@ } }, "params": { - "UseDualStack": false, "Region": "ap-south-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -86,9 +86,9 @@ } }, "params": { - "UseDualStack": false, "Region": "ap-southeast-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -99,9 +99,9 @@ } }, "params": { - "UseDualStack": false, "Region": "ap-southeast-2", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -112,9 +112,9 @@ } }, "params": { - "UseDualStack": false, "Region": "ap-southeast-3", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -125,9 +125,9 @@ } }, "params": { - "UseDualStack": false, "Region": "ca-central-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -138,9 +138,9 @@ } }, "params": { - "UseDualStack": false, "Region": "ca-central-1", - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": false } }, { @@ -151,9 +151,9 @@ } }, "params": { - "UseDualStack": false, "Region": "eu-central-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -164,9 +164,9 @@ } }, "params": { - "UseDualStack": false, "Region": "eu-north-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -177,9 +177,9 @@ } }, "params": { - "UseDualStack": false, "Region": "eu-south-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -190,9 +190,9 @@ } }, "params": { - "UseDualStack": false, "Region": "eu-west-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -203,9 +203,9 @@ } }, "params": { - "UseDualStack": false, "Region": "eu-west-2", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -216,9 +216,9 @@ } }, "params": { - "UseDualStack": false, "Region": "eu-west-3", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -229,9 +229,9 @@ } }, "params": { - "UseDualStack": false, "Region": "me-south-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -242,9 +242,9 @@ } }, "params": { - "UseDualStack": false, "Region": "sa-east-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -255,9 +255,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-east-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -268,9 +268,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-east-1", - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": false } }, { @@ -281,9 +281,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-east-2", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -294,9 +294,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-east-2", - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": false } }, { @@ -307,9 +307,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-west-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -320,9 +320,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-west-1", - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": false } }, { @@ -333,9 +333,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-west-2", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -346,9 +346,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-west-2", - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": false } }, { @@ -359,9 +359,9 @@ } }, "params": { - "UseDualStack": true, "Region": "us-east-1", - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": true } }, { @@ -372,9 +372,9 @@ } }, "params": { - "UseDualStack": true, "Region": "us-east-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": true } }, { @@ -385,9 +385,9 @@ } }, "params": { - "UseDualStack": false, "Region": "cn-north-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -398,9 +398,9 @@ } }, "params": { - "UseDualStack": false, "Region": "cn-northwest-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -411,9 +411,9 @@ } }, "params": { - "UseDualStack": true, "Region": "cn-north-1", - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": true } }, { @@ -424,9 +424,9 @@ } }, "params": { - "UseDualStack": false, "Region": "cn-north-1", - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": false } }, { @@ -437,9 +437,9 @@ } }, "params": { - "UseDualStack": true, "Region": "cn-north-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": true } }, { @@ -450,9 +450,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-gov-east-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -463,9 +463,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-gov-east-1", - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": false } }, { @@ -476,9 +476,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-gov-west-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -489,9 +489,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-gov-west-1", - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": false } }, { @@ -502,9 +502,9 @@ } }, "params": { - "UseDualStack": true, "Region": "us-gov-east-1", - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": true } }, { @@ -515,9 +515,9 @@ } }, "params": { - "UseDualStack": true, "Region": "us-gov-east-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": true } }, { @@ -528,9 +528,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-iso-east-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -541,9 +541,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-iso-west-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -552,9 +552,9 @@ "error": "FIPS and DualStack are enabled, but this partition does not support one or both" }, "params": { - "UseDualStack": true, "Region": "us-iso-east-1", - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": true } }, { @@ -565,9 +565,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-iso-east-1", - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": false } }, { @@ -576,9 +576,9 @@ "error": "DualStack is enabled but this partition does not support DualStack" }, "params": { - "UseDualStack": true, "Region": "us-iso-east-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": true } }, { @@ -589,9 +589,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-isob-east-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": false } }, { @@ -600,9 +600,9 @@ "error": "FIPS and DualStack are enabled, but this partition does not support one or both" }, "params": { - "UseDualStack": true, "Region": "us-isob-east-1", - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": true } }, { @@ -613,9 +613,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-isob-east-1", - "UseFIPS": true + "UseFIPS": true, + "UseDualStack": false } }, { @@ -624,9 +624,9 @@ "error": "DualStack is enabled but this partition does not support DualStack" }, "params": { - "UseDualStack": true, "Region": "us-isob-east-1", - "UseFIPS": false + "UseFIPS": false, + "UseDualStack": true } }, { @@ -637,9 +637,9 @@ } }, "params": { - "UseDualStack": false, "Region": "us-east-1", "UseFIPS": false, + "UseDualStack": false, "Endpoint": "https://example.com" } }, @@ -651,8 +651,8 @@ } }, "params": { - "UseDualStack": false, "UseFIPS": false, + "UseDualStack": false, "Endpoint": "https://example.com" } }, @@ -662,9 +662,9 @@ "error": "Invalid Configuration: FIPS and custom endpoint are not supported" }, "params": { - "UseDualStack": false, "Region": "us-east-1", "UseFIPS": true, + "UseDualStack": false, "Endpoint": "https://example.com" } }, @@ -674,9 +674,9 @@ "error": "Invalid Configuration: Dualstack and custom endpoint are not supported" }, "params": { - "UseDualStack": true, "Region": "us-east-1", "UseFIPS": false, + "UseDualStack": true, "Endpoint": "https://example.com" } }, diff --git a/models/endpoints/endpoints.json b/models/endpoints/endpoints.json index 3daa107c02..06534222ec 100644 --- a/models/endpoints/endpoints.json +++ b/models/endpoints/endpoints.json @@ -1818,12 +1818,14 @@ "arc-zonal-shift" : { "endpoints" : { "ap-northeast-1" : { }, + "ap-south-1" : { }, "ap-southeast-1" : { }, "ap-southeast-2" : { }, "ap-southeast-3" : { }, "eu-central-1" : { }, "eu-north-1" : { }, "eu-west-1" : { }, + "eu-west-2" : { }, "us-east-1" : { }, "us-east-2" : { }, "us-west-2" : { } @@ -12638,6 +12640,7 @@ "eu-central-2" : { }, "eu-north-1" : { }, "eu-south-1" : { }, + "eu-south-2" : { }, "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, @@ -13630,13 +13633,16 @@ "ap-northeast-2" : { }, "ap-northeast-3" : { }, "ap-south-1" : { }, + "ap-south-2" : { }, "ap-southeast-1" : { }, "ap-southeast-2" : { }, "ap-southeast-3" : { }, "ca-central-1" : { }, "eu-central-1" : { }, + "eu-central-2" : { }, "eu-north-1" : { }, "eu-south-1" : { }, + "eu-south-2" : { }, "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, diff --git a/service/opensearchserverless/api.go b/service/opensearchserverless/api.go index 95c4179186..46cf3f3619 100644 --- a/service/opensearchserverless/api.go +++ b/service/opensearchserverless/api.go @@ -244,14 +244,18 @@ func (c *OpenSearchServerless) CreateAccessPolicyRequest(input *CreateAccessPoli // Thrown when an error internal to the service occurs while processing a request. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException // Thrown when the HTTP request contains invalid input or is missing required // input. // +// - ServiceQuotaExceededException +// Thrown when you attempt to create more resources than the service allows +// based on service quotas. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/opensearchserverless-2021-11-01/CreateAccessPolicy func (c *OpenSearchServerless) CreateAccessPolicy(input *CreateAccessPolicyInput) (*CreateAccessPolicyOutput, error) { req, out := c.CreateAccessPolicyRequest(input) @@ -329,18 +333,25 @@ func (c *OpenSearchServerless) CreateCollectionRequest(input *CreateCollectionIn // // Returned Error Types: // +// - OcuLimitExceededException +// OCU Limit Exceeded for service limits +// // - InternalServerException // Thrown when an error internal to the service occurs while processing a request. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException // Thrown when the HTTP request contains invalid input or is missing required // input. // +// - ServiceQuotaExceededException +// Thrown when you attempt to create more resources than the service allows +// based on service quotas. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/opensearchserverless-2021-11-01/CreateCollection func (c *OpenSearchServerless) CreateCollection(input *CreateCollectionInput) (*CreateCollectionOutput, error) { req, out := c.CreateCollectionRequest(input) @@ -422,14 +433,18 @@ func (c *OpenSearchServerless) CreateSecurityConfigRequest(input *CreateSecurity // Thrown when an error internal to the service occurs while processing a request. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException // Thrown when the HTTP request contains invalid input or is missing required // input. // +// - ServiceQuotaExceededException +// Thrown when you attempt to create more resources than the service allows +// based on service quotas. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/opensearchserverless-2021-11-01/CreateSecurityConfig func (c *OpenSearchServerless) CreateSecurityConfig(input *CreateSecurityConfigInput) (*CreateSecurityConfigOutput, error) { req, out := c.CreateSecurityConfigRequest(input) @@ -515,14 +530,18 @@ func (c *OpenSearchServerless) CreateSecurityPolicyRequest(input *CreateSecurity // Thrown when an error internal to the service occurs while processing a request. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException // Thrown when the HTTP request contains invalid input or is missing required // input. // +// - ServiceQuotaExceededException +// Thrown when you attempt to create more resources than the service allows +// based on service quotas. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/opensearchserverless-2021-11-01/CreateSecurityPolicy func (c *OpenSearchServerless) CreateSecurityPolicy(input *CreateSecurityPolicyInput) (*CreateSecurityPolicyOutput, error) { req, out := c.CreateSecurityPolicyRequest(input) @@ -605,14 +624,18 @@ func (c *OpenSearchServerless) CreateVpcEndpointRequest(input *CreateVpcEndpoint // Thrown when an error internal to the service occurs while processing a request. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException // Thrown when the HTTP request contains invalid input or is missing required // input. // +// - ServiceQuotaExceededException +// Thrown when you attempt to create more resources than the service allows +// based on service quotas. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/opensearchserverless-2021-11-01/CreateVpcEndpoint func (c *OpenSearchServerless) CreateVpcEndpoint(input *CreateVpcEndpointInput) (*CreateVpcEndpointOutput, error) { req, out := c.CreateVpcEndpointRequest(input) @@ -698,8 +721,8 @@ func (c *OpenSearchServerless) DeleteAccessPolicyRequest(input *DeleteAccessPoli // Thrown when accessing or deleting a resource that does not exist. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException @@ -790,8 +813,8 @@ func (c *OpenSearchServerless) DeleteCollectionRequest(input *DeleteCollectionIn // Thrown when accessing or deleting a resource that does not exist. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException @@ -883,8 +906,8 @@ func (c *OpenSearchServerless) DeleteSecurityConfigRequest(input *DeleteSecurity // Thrown when accessing or deleting a resource that does not exist. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException @@ -975,8 +998,8 @@ func (c *OpenSearchServerless) DeleteSecurityPolicyRequest(input *DeleteSecurity // Thrown when accessing or deleting a resource that does not exist. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException @@ -1067,8 +1090,8 @@ func (c *OpenSearchServerless) DeleteVpcEndpointRequest(input *DeleteVpcEndpoint // Thrown when accessing or deleting a resource that does not exist. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException @@ -2381,14 +2404,18 @@ func (c *OpenSearchServerless) TagResourceRequest(input *TagResourceInput) (req // Thrown when accessing or deleting a resource that does not exist. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException // Thrown when the HTTP request contains invalid input or is missing required // input. // +// - ServiceQuotaExceededException +// Thrown when you attempt to create more resources than the service allows +// based on service quotas. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/opensearchserverless-2021-11-01/TagResource func (c *OpenSearchServerless) TagResource(input *TagResourceInput) (*TagResourceOutput, error) { req, out := c.TagResourceRequest(input) @@ -2474,8 +2501,8 @@ func (c *OpenSearchServerless) UntagResourceRequest(input *UntagResourceInput) ( // Thrown when accessing or deleting a resource that does not exist. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException @@ -2566,8 +2593,8 @@ func (c *OpenSearchServerless) UpdateAccessPolicyRequest(input *UpdateAccessPoli // Thrown when accessing or deleting a resource that does not exist. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException @@ -2640,7 +2667,8 @@ func (c *OpenSearchServerless) UpdateAccountSettingsRequest(input *UpdateAccount // UpdateAccountSettings API operation for OpenSearch Service Serverless. // // Update the OpenSearch Serverless settings for the current Amazon Web Services -// account. For more information, see Autoscaling (https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html#serverless-scaling). +// account. For more information, see Managing capacity limits for Amazon OpenSearch +// Serverless (https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-scaling.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -2738,8 +2766,8 @@ func (c *OpenSearchServerless) UpdateCollectionRequest(input *UpdateCollectionIn // Thrown when an error internal to the service occurs while processing a request. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException @@ -2830,8 +2858,8 @@ func (c *OpenSearchServerless) UpdateSecurityConfigRequest(input *UpdateSecurity // Thrown when accessing or deleting a resource that does not exist. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException @@ -2923,14 +2951,18 @@ func (c *OpenSearchServerless) UpdateSecurityPolicyRequest(input *UpdateSecurity // Thrown when accessing or deleting a resource that does not exist. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException // Thrown when the HTTP request contains invalid input or is missing required // input. // +// - ServiceQuotaExceededException +// Thrown when you attempt to create more resources than the service allows +// based on service quotas. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/opensearchserverless-2021-11-01/UpdateSecurityPolicy func (c *OpenSearchServerless) UpdateSecurityPolicy(input *UpdateSecurityPolicyInput) (*UpdateSecurityPolicyOutput, error) { req, out := c.UpdateSecurityPolicyRequest(input) @@ -3012,8 +3044,8 @@ func (c *OpenSearchServerless) UpdateVpcEndpointRequest(input *UpdateVpcEndpoint // Thrown when an error internal to the service occurs while processing a request. // // - ConflictException -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. // // - ValidationException @@ -3050,7 +3082,7 @@ type AccessPolicyDetail struct { CreatedDate *int64 `locationName:"createdDate" type:"long"` // The description of the policy. - Description *string `locationName:"description" min:"1" type:"string"` + Description *string `locationName:"description" type:"string"` // The timestamp of when the policy was last modified. LastModifiedDate *int64 `locationName:"lastModifiedDate" type:"long"` @@ -3159,7 +3191,7 @@ type AccessPolicySummary struct { CreatedDate *int64 `locationName:"createdDate" type:"long"` // The description of the access policy. - Description *string `locationName:"description" min:"1" type:"string"` + Description *string `locationName:"description" type:"string"` // The date and time when the collection was last modified. LastModifiedDate *int64 `locationName:"lastModifiedDate" type:"long"` @@ -3234,7 +3266,8 @@ type AccountSettingsDetail struct { // The maximum capacity limits for all OpenSearch Serverless collections, in // OpenSearch Compute Units (OCUs). These limits are used to scale your collections - // based on the current workload. For more information, see Autoscaling (https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html#serverless-scaling). + // based on the current workload. For more information, see Managing capacity + // limits for Amazon OpenSearch Serverless (https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-scaling.html). CapacityLimits *CapacityLimits `locationName:"capacityLimits" type:"structure"` } @@ -3452,7 +3485,8 @@ func (s *BatchGetVpcEndpointOutput) SetVpcEndpointErrorDetails(v []*VpcEndpointE // The maximum capacity limits for all OpenSearch Serverless collections, in // OpenSearch Compute Units (OCUs). These limits are used to scale your collections -// based on the current workload. For more information, see Autoscaling (https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html#serverless-scaling). +// based on the current workload. For more information, see Managing capacity +// limits for Amazon OpenSearch Serverless (https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-scaling.html). type CapacityLimits struct { _ struct{} `type:"structure"` @@ -3809,8 +3843,8 @@ func (s *CollectionSummary) SetStatus(v string) *CollectionSummary { return s } -// When creating a collection, thrown when a collection with the same name already -// exists or is being created. When deleting a collection, thrown when the collection +// When creating a resource, thrown when a resource with the same name already +// exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. type ConflictException struct { _ struct{} `type:"structure"` @@ -3883,7 +3917,7 @@ type CreateAccessPolicyInput struct { // A description of the policy. Typically used to store information about the // permissions defined in the policy. - Description *string `locationName:"description" min:"1" type:"string"` + Description *string `locationName:"description" type:"string"` // The name of the policy. // @@ -3925,9 +3959,6 @@ func (s *CreateAccessPolicyInput) Validate() error { if s.ClientToken != nil && len(*s.ClientToken) < 1 { invalidParams.Add(request.NewErrParamMinLen("ClientToken", 1)) } - if s.Description != nil && len(*s.Description) < 1 { - invalidParams.Add(request.NewErrParamMinLen("Description", 1)) - } if s.Name == nil { invalidParams.Add(request.NewErrParamRequired("Name")) } @@ -4259,7 +4290,8 @@ type CreateSecurityConfigInput struct { // Name is a required field Name *string `locationName:"name" min:"3" type:"string" required:"true"` - // Describes SAML options in in the form of a key-value map. + // Describes SAML options in in the form of a key-value map. This field is required + // if you specify saml for the type parameter. SamlOptions *SamlConfigOptions `locationName:"samlOptions" type:"structure"` // The type of security configuration. @@ -4385,7 +4417,7 @@ type CreateSecurityPolicyInput struct { // A description of the policy. Typically used to store information about the // permissions defined in the policy. - Description *string `locationName:"description" min:"1" type:"string"` + Description *string `locationName:"description" type:"string"` // The name of the policy. // @@ -4427,9 +4459,6 @@ func (s *CreateSecurityPolicyInput) Validate() error { if s.ClientToken != nil && len(*s.ClientToken) < 1 { invalidParams.Add(request.NewErrParamMinLen("ClientToken", 1)) } - if s.Description != nil && len(*s.Description) < 1 { - invalidParams.Add(request.NewErrParamMinLen("Description", 1)) - } if s.Name == nil { invalidParams.Add(request.NewErrParamRequired("Name")) } @@ -5747,7 +5776,8 @@ type ListAccessPoliciesInput struct { // which returns results in the next page. NextToken *string `locationName:"nextToken" type:"string"` - // Resource filters (can be collection or indexes) that policies can apply to. + // Resource filters (can be collections or indexes) that policies can apply + // to. Resource []*string `locationName:"resource" min:"1" type:"list"` // The type of access policy. @@ -6397,6 +6427,71 @@ func (s *ListVpcEndpointsOutput) SetVpcEndpointSummaries(v []*VpcEndpointSummary return s } +// OCU Limit Exceeded for service limits +type OcuLimitExceededException struct { + _ struct{} `type:"structure"` + RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` + + // Description of the error. + Message_ *string `locationName:"message" type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s OcuLimitExceededException) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s OcuLimitExceededException) GoString() string { + return s.String() +} + +func newErrorOcuLimitExceededException(v protocol.ResponseMetadata) error { + return &OcuLimitExceededException{ + RespMetadata: v, + } +} + +// Code returns the exception type name. +func (s *OcuLimitExceededException) Code() string { + return "OcuLimitExceededException" +} + +// Message returns the exception's message. +func (s *OcuLimitExceededException) Message() string { + if s.Message_ != nil { + return *s.Message_ + } + return "" +} + +// OrigErr always returns nil, satisfies awserr.Error interface. +func (s *OcuLimitExceededException) OrigErr() error { + return nil +} + +func (s *OcuLimitExceededException) Error() string { + return fmt.Sprintf("%s: %s", s.Code(), s.Message()) +} + +// Status code returns the HTTP status code for the request's response error. +func (s *OcuLimitExceededException) StatusCode() int { + return s.RespMetadata.StatusCode +} + +// RequestID returns the service's response RequestID for request. +func (s *OcuLimitExceededException) RequestID() string { + return s.RespMetadata.RequestID +} + // Thrown when accessing or deleting a resource that does not exist. type ResourceNotFoundException struct { _ struct{} `type:"structure"` @@ -6474,8 +6569,7 @@ type SamlConfigOptions struct { // Metadata is a required field Metadata *string `locationName:"metadata" min:"1" type:"string" required:"true"` - // The session timeout, in minutes. Minimum is 15 minutes and maximum is 1440 - // minutes (24 hours or 1 day). Default is 60 minutes. + // The session timeout, in minutes. Default is 60 minutes (12 hours). SessionTimeout *int64 `locationName:"sessionTimeout" min:"5" type:"integer"` // A user attribute for this SAML integration. @@ -6752,7 +6846,7 @@ type SecurityPolicyDetail struct { CreatedDate *int64 `locationName:"createdDate" type:"long"` // The description of the security policy. - Description *string `locationName:"description" min:"1" type:"string"` + Description *string `locationName:"description" type:"string"` // The timestamp of when the policy was last modified. LastModifiedDate *int64 `locationName:"lastModifiedDate" type:"long"` @@ -6870,7 +6964,7 @@ type SecurityPolicySummary struct { CreatedDate *int64 `locationName:"createdDate" type:"long"` // The description of the security policy. - Description *string `locationName:"description" min:"1" type:"string"` + Description *string `locationName:"description" type:"string"` // The timestamp of when the policy was last modified. LastModifiedDate *int64 `locationName:"lastModifiedDate" type:"long"` @@ -6939,6 +7033,86 @@ func (s *SecurityPolicySummary) SetType(v string) *SecurityPolicySummary { return s } +// Thrown when you attempt to create more resources than the service allows +// based on service quotas. +type ServiceQuotaExceededException struct { + _ struct{} `type:"structure"` + RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` + + // Description of the error. + Message_ *string `locationName:"message" type:"string"` + + // Service Quotas requirement to identify originating quota. + QuotaCode *string `locationName:"quotaCode" type:"string"` + + // Identifier of the resource affected. + ResourceId *string `locationName:"resourceId" type:"string"` + + // Type of the resource affected. + ResourceType *string `locationName:"resourceType" type:"string"` + + // Service Quotas requirement to identify originating service. + // + // ServiceCode is a required field + ServiceCode *string `locationName:"serviceCode" type:"string" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ServiceQuotaExceededException) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ServiceQuotaExceededException) GoString() string { + return s.String() +} + +func newErrorServiceQuotaExceededException(v protocol.ResponseMetadata) error { + return &ServiceQuotaExceededException{ + RespMetadata: v, + } +} + +// Code returns the exception type name. +func (s *ServiceQuotaExceededException) Code() string { + return "ServiceQuotaExceededException" +} + +// Message returns the exception's message. +func (s *ServiceQuotaExceededException) Message() string { + if s.Message_ != nil { + return *s.Message_ + } + return "" +} + +// OrigErr always returns nil, satisfies awserr.Error interface. +func (s *ServiceQuotaExceededException) OrigErr() error { + return nil +} + +func (s *ServiceQuotaExceededException) Error() string { + return fmt.Sprintf("%s: %s\n%s", s.Code(), s.Message(), s.String()) +} + +// Status code returns the HTTP status code for the request's response error. +func (s *ServiceQuotaExceededException) StatusCode() int { + return s.RespMetadata.StatusCode +} + +// RequestID returns the service's response RequestID for request. +func (s *ServiceQuotaExceededException) RequestID() string { + return s.RespMetadata.RequestID +} + // A map of key-value pairs associated to an OpenSearch Serverless resource. type Tag struct { _ struct{} `type:"structure"` @@ -7197,7 +7371,7 @@ type UpdateAccessPolicyInput struct { // A description of the policy. Typically used to store information about the // permissions defined in the policy. - Description *string `locationName:"description" min:"1" type:"string"` + Description *string `locationName:"description" type:"string"` // The name of the policy. // @@ -7242,9 +7416,6 @@ func (s *UpdateAccessPolicyInput) Validate() error { if s.ClientToken != nil && len(*s.ClientToken) < 1 { invalidParams.Add(request.NewErrParamMinLen("ClientToken", 1)) } - if s.Description != nil && len(*s.Description) < 1 { - invalidParams.Add(request.NewErrParamMinLen("Description", 1)) - } if s.Name == nil { invalidParams.Add(request.NewErrParamRequired("Name")) } @@ -7342,7 +7513,8 @@ type UpdateAccountSettingsInput struct { // The maximum capacity limits for all OpenSearch Serverless collections, in // OpenSearch Compute Units (OCUs). These limits are used to scale your collections - // based on the current workload. For more information, see Autoscaling (https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html#serverless-scaling). + // based on the current workload. For more information, see Managing capacity + // limits for Amazon OpenSearch Serverless (https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-scaling.html). CapacityLimits *CapacityLimits `locationName:"capacityLimits" type:"structure"` } @@ -7759,7 +7931,7 @@ type UpdateSecurityPolicyInput struct { // A description of the policy. Typically used to store information about the // permissions defined in the policy. - Description *string `locationName:"description" min:"1" type:"string"` + Description *string `locationName:"description" type:"string"` // The name of the policy. // @@ -7804,9 +7976,6 @@ func (s *UpdateSecurityPolicyInput) Validate() error { if s.ClientToken != nil && len(*s.ClientToken) < 1 { invalidParams.Add(request.NewErrParamMinLen("ClientToken", 1)) } - if s.Description != nil && len(*s.Description) < 1 { - invalidParams.Add(request.NewErrParamMinLen("Description", 1)) - } if s.Name == nil { invalidParams.Add(request.NewErrParamRequired("Name")) } @@ -8207,7 +8376,7 @@ type VpcEndpointDetail struct { // The ID of the subnets from which you access OpenSearch Serverless. SubnetIds []*string `locationName:"subnetIds" min:"1" type:"list"` - // The ID of the VPC from which you access OpenSearch Serverless + // The ID of the VPC from which you access OpenSearch Serverless. VpcId *string `locationName:"vpcId" min:"1" type:"string"` } diff --git a/service/opensearchserverless/errors.go b/service/opensearchserverless/errors.go index 5afed277ce..8c85ad9cc2 100644 --- a/service/opensearchserverless/errors.go +++ b/service/opensearchserverless/errors.go @@ -11,8 +11,8 @@ const ( // ErrCodeConflictException for service response error code // "ConflictException". // - // When creating a collection, thrown when a collection with the same name already - // exists or is being created. When deleting a collection, thrown when the collection + // When creating a resource, thrown when a resource with the same name already + // exists or is being created. When deleting a resource, thrown when the resource // is not in the ACTIVE or FAILED state. ErrCodeConflictException = "ConflictException" @@ -22,12 +22,25 @@ const ( // Thrown when an error internal to the service occurs while processing a request. ErrCodeInternalServerException = "InternalServerException" + // ErrCodeOcuLimitExceededException for service response error code + // "OcuLimitExceededException". + // + // OCU Limit Exceeded for service limits + ErrCodeOcuLimitExceededException = "OcuLimitExceededException" + // ErrCodeResourceNotFoundException for service response error code // "ResourceNotFoundException". // // Thrown when accessing or deleting a resource that does not exist. ErrCodeResourceNotFoundException = "ResourceNotFoundException" + // ErrCodeServiceQuotaExceededException for service response error code + // "ServiceQuotaExceededException". + // + // Thrown when you attempt to create more resources than the service allows + // based on service quotas. + ErrCodeServiceQuotaExceededException = "ServiceQuotaExceededException" + // ErrCodeValidationException for service response error code // "ValidationException". // @@ -37,8 +50,10 @@ const ( ) var exceptionFromCode = map[string]func(protocol.ResponseMetadata) error{ - "ConflictException": newErrorConflictException, - "InternalServerException": newErrorInternalServerException, - "ResourceNotFoundException": newErrorResourceNotFoundException, - "ValidationException": newErrorValidationException, + "ConflictException": newErrorConflictException, + "InternalServerException": newErrorInternalServerException, + "OcuLimitExceededException": newErrorOcuLimitExceededException, + "ResourceNotFoundException": newErrorResourceNotFoundException, + "ServiceQuotaExceededException": newErrorServiceQuotaExceededException, + "ValidationException": newErrorValidationException, } diff --git a/service/rds/api.go b/service/rds/api.go index 6f9a174a0c..676127c1da 100644 --- a/service/rds/api.go +++ b/service/rds/api.go @@ -1521,15 +1521,15 @@ func (c *RDS) CreateDBClusterRequest(input *CreateDBClusterInput) (req *request. // and two reader DB instances for you, each in a different Availability Zone. // // You can use the ReplicationSourceIdentifier parameter to create an Amazon -// Aurora DB cluster as a read replica of another DB cluster or Amazon RDS MySQL -// or PostgreSQL DB instance. For more information about Amazon Aurora, see -// What is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) +// Aurora DB cluster as a read replica of another DB cluster or Amazon RDS for +// MySQL or PostgreSQL DB instance. For more information about Amazon Aurora, +// see What is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) // in the Amazon Aurora User Guide. // // You can also use the ReplicationSourceIdentifier parameter to create a Multi-AZ -// DB cluster read replica with an RDS for PostgreSQL DB instance as the source. -// For more information about Multi-AZ DB clusters, see Multi-AZ DB cluster -// deployments (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html) +// DB cluster read replica with an RDS for MySQL or PostgreSQL DB instance as +// the source. For more information about Multi-AZ DB clusters, see Multi-AZ +// DB cluster deployments (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html) // in the Amazon RDS User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -2145,19 +2145,22 @@ func (c *RDS) CreateDBInstanceReadReplicaRequest(input *CreateDBInstanceReadRepl // CreateDBInstanceReadReplica API operation for Amazon Relational Database Service. // // Creates a new DB instance that acts as a read replica for an existing source -// DB instance. You can create a read replica for a DB instance running MySQL, -// MariaDB, Oracle, PostgreSQL, or SQL Server. For more information, see Working -// with Read Replicas (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html) +// DB instance or Multi-AZ DB cluster. You can create a read replica for a DB +// instance running MySQL, MariaDB, Oracle, PostgreSQL, or SQL Server. You can +// create a read replica for a Multi-AZ DB cluster running MySQL or PostgreSQL. +// For more information, see Working with read replicas (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html) +// and Migrating from a Multi-AZ DB cluster to a DB instance using a read replica +// (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html#multi-az-db-clusters-migrating-to-instance-with-read-replica) // in the Amazon RDS User Guide. // // Amazon Aurora doesn't support this operation. Call the CreateDBInstance operation // to create a DB instance for an Aurora DB cluster. // // All read replica DB instances are created with backups disabled. All other -// DB instance attributes (including DB security groups and DB parameter groups) -// are inherited from the source DB instance, except as specified. +// attributes (including DB security groups and DB parameter groups) are inherited +// from the source DB instance or cluster, except as specified. // -// Your source DB instance must have backup retention enabled. +// Your source DB instance or cluster must have backup retention enabled. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -2191,9 +2194,15 @@ func (c *RDS) CreateDBInstanceReadReplicaRequest(input *CreateDBInstanceReadRepl // - ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" // DBInstanceIdentifier doesn't refer to an existing DB instance. // +// - ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" +// DBClusterIdentifier doesn't refer to an existing DB cluster. +// // - ErrCodeInvalidDBInstanceStateFault "InvalidDBInstanceState" // The DB instance isn't in a valid state. // +// - ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" +// The requested operation can't be performed while the cluster is in this state. +// // - ErrCodeDBSubnetGroupNotFoundFault "DBSubnetGroupNotFoundFault" // DBSubnetGroupName doesn't refer to an existing DB subnet group. // @@ -3380,6 +3389,9 @@ func (c *RDS) DeleteDBClusterRequest(input *DeleteDBClusterInput) (req *request. // and can't be recovered. Manual DB cluster snapshots of the specified DB cluster // are not deleted. // +// If you're deleting a Multi-AZ DB cluster with read replicas, all cluster +// members are terminated and read replicas are promoted to standalone instances. +// // For more information on Amazon Aurora, see What is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) // in the Amazon Aurora User Guide. // @@ -20179,7 +20191,7 @@ type CreateDBClusterInput struct { // The Amazon Resource Name (ARN) of the source DB instance or DB cluster if // this DB cluster is created as a read replica. // - // Valid for: Aurora DB clusters and RDS for PostgreSQL Multi-AZ DB clusters + // Valid for: Aurora DB clusters and Multi-AZ DB clusters ReplicationSourceIdentifier *string `type:"string"` // For DB clusters in serverless DB engine mode, the scaling properties of the @@ -22466,8 +22478,8 @@ type CreateDBInstanceReadReplicaInput struct { // This setting doesn't apply to RDS Custom. Domain *string `type:"string"` - // Specify the name of the IAM role to be used when making API calls to the - // Directory Service. + // The name of the IAM role to be used when making API calls to the Directory + // Service. // // This setting doesn't apply to RDS Custom. DomainIAMRoleName *string `type:"string"` @@ -22526,9 +22538,9 @@ type CreateDBInstanceReadReplicaInput struct { // ARN, or alias name for the KMS key. // // If you create an encrypted read replica in the same Amazon Web Services Region - // as the source DB instance, then do not specify a value for this parameter. - // A read replica in the same Amazon Web Services Region is always encrypted - // with the same KMS key as the source DB instance. + // as the source DB instance or Multi-AZ DB cluster, don't specify a value for + // this parameter. A read replica in the same Amazon Web Services Region is + // always encrypted with the same KMS key as the source DB instance or cluster. // // If you create an encrypted read replica in a different Amazon Web Services // Region, then you must specify a KMS key identifier for the destination Amazon @@ -22536,7 +22548,8 @@ type CreateDBInstanceReadReplicaInput struct { // that they are created in, and you can't use KMS keys from one Amazon Web // Services Region in another Amazon Web Services Region. // - // You can't create an encrypted read replica from an unencrypted DB instance. + // You can't create an encrypted read replica from an unencrypted DB instance + // or Multi-AZ DB cluster. // // This setting doesn't apply to RDS Custom, which uses the same KMS key as // the primary replica. @@ -22580,7 +22593,7 @@ type CreateDBInstanceReadReplicaInput struct { // You can create a read replica as a Multi-AZ DB instance. RDS creates a standby // of your replica in another Availability Zone for failover support for the // replica. Creating your read replica as a Multi-AZ DB instance is independent - // of whether the source database is a Multi-AZ DB instance. + // of whether the source is a Multi-AZ DB instance or a Multi-AZ DB cluster. // // This setting doesn't apply to RDS Custom. MultiAZ *bool `type:"boolean"` @@ -22602,10 +22615,9 @@ type CreateDBInstanceReadReplicaInput struct { NetworkType *string `type:"string"` // The option group the DB instance is associated with. If omitted, the option - // group associated with the source instance is used. + // group associated with the source instance or cluster is used. // - // For SQL Server, you must use the option group associated with the source - // instance. + // For SQL Server, you must use the option group associated with the source. // // This setting doesn't apply to RDS Custom. OptionGroupName *string `type:"string"` @@ -22666,6 +22678,10 @@ type CreateDBInstanceReadReplicaInput struct { // China Amazon Web Services Regions. It's ignored in other Amazon Web Services // Regions. // + // This setting applies only when replicating from a source DB instance. Source + // DB clusters aren't supported in Amazon Web Services GovCloud (US) Regions + // and China Amazon Web Services Regions. + // // You must specify this parameter when you create an encrypted read replica // from another Amazon Web Services Region by using the Amazon RDS API. Don't // specify PreSignedUrl when you are creating an encrypted read replica in the @@ -22759,28 +22775,43 @@ type CreateDBInstanceReadReplicaInput struct { // open mode manually. ReplicaMode *string `type:"string" enum:"ReplicaMode"` + // The identifier of the Multi-AZ DB cluster that will act as the source for + // the read replica. Each DB cluster can have up to 15 read replicas. + // + // Constraints: + // + // * Must be the identifier of an existing Multi-AZ DB cluster. + // + // * Can't be specified if the SourceDBInstanceIdentifier parameter is also + // specified. + // + // * The specified DB cluster must have automatic backups enabled, that is, + // its backup retention period must be greater than 0. + // + // * The source DB cluster must be in the same Amazon Web Services Region + // as the read replica. Cross-Region replication isn't supported. + SourceDBClusterIdentifier *string `type:"string"` + // The identifier of the DB instance that will act as the source for the read - // replica. Each DB instance can have up to five read replicas. + // replica. Each DB instance can have up to 15 read replicas, with the exception + // of Oracle and SQL Server, which can have up to five. // // Constraints: // // * Must be the identifier of an existing MySQL, MariaDB, Oracle, PostgreSQL, // or SQL Server DB instance. // - // * Can specify a DB instance that is a MySQL read replica only if the source - // is running MySQL 5.6 or later. + // * Can't be specified if the SourceDBClusterIdentifier parameter is also + // specified. // - // * For the limitations of Oracle read replicas, see Read Replica Limitations - // with Oracle (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html) + // * For the limitations of Oracle read replicas, see Version and licensing + // considerations for RDS for Oracle replicas (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.limitations.html#oracle-read-replicas.limitations.versions-and-licenses) // in the Amazon RDS User Guide. // - // * For the limitations of SQL Server read replicas, see Read Replica Limitations - // with Microsoft SQL Server (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/SQLServer.ReadReplicas.Limitations.html) + // * For the limitations of SQL Server read replicas, see Read replica limitations + // with SQL Server (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/SQLServer.ReadReplicas.html#SQLServer.ReadReplicas.Limitations) // in the Amazon RDS User Guide. // - // * Can specify a PostgreSQL DB instance only if the source is running PostgreSQL - // 9.3.5 or later (9.4.7 and higher for cross-Region replication). - // // * The specified DB instance must have automatic backups enabled, that // is, its backup retention period must be greater than 0. // @@ -22792,9 +22823,7 @@ type CreateDBInstanceReadReplicaInput struct { // see Constructing an ARN for Amazon RDS (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.html#USER_Tagging.ARN.Constructing) // in the Amazon RDS User Guide. This doesn't apply to SQL Server or RDS // Custom, which don't support cross-Region replicas. - // - // SourceDBInstanceIdentifier is a required field - SourceDBInstanceIdentifier *string `type:"string" required:"true"` + SourceDBInstanceIdentifier *string `type:"string"` // SourceRegion is the source region where the resource exists. This is not // sent over the wire and is only used for presigning. This value should always @@ -22857,9 +22886,6 @@ func (s *CreateDBInstanceReadReplicaInput) Validate() error { if s.DBInstanceIdentifier == nil { invalidParams.Add(request.NewErrParamRequired("DBInstanceIdentifier")) } - if s.SourceDBInstanceIdentifier == nil { - invalidParams.Add(request.NewErrParamRequired("SourceDBInstanceIdentifier")) - } if invalidParams.Len() > 0 { return invalidParams @@ -23059,6 +23085,12 @@ func (s *CreateDBInstanceReadReplicaInput) SetReplicaMode(v string) *CreateDBIns return s } +// SetSourceDBClusterIdentifier sets the SourceDBClusterIdentifier field's value. +func (s *CreateDBInstanceReadReplicaInput) SetSourceDBClusterIdentifier(v string) *CreateDBInstanceReadReplicaInput { + s.SourceDBClusterIdentifier = &v + return s +} + // SetSourceDBInstanceIdentifier sets the SourceDBInstanceIdentifier field's value. func (s *CreateDBInstanceReadReplicaInput) SetSourceDBInstanceIdentifier(v string) *CreateDBInstanceReadReplicaInput { s.SourceDBInstanceIdentifier = &v @@ -26861,6 +26893,10 @@ type DBInstance struct { // DB instance. ReadReplicaDBInstanceIdentifiers []*string `locationNameList:"ReadReplicaDBInstanceIdentifier" type:"list"` + // Contains the identifier of the source DB cluster if this DB instance is a + // read replica. + ReadReplicaSourceDBClusterIdentifier *string `type:"string"` + // Contains the identifier of the source DB instance if this DB instance is // a read replica. ReadReplicaSourceDBInstanceIdentifier *string `type:"string"` @@ -27340,6 +27376,12 @@ func (s *DBInstance) SetReadReplicaDBInstanceIdentifiers(v []*string) *DBInstanc return s } +// SetReadReplicaSourceDBClusterIdentifier sets the ReadReplicaSourceDBClusterIdentifier field's value. +func (s *DBInstance) SetReadReplicaSourceDBClusterIdentifier(v string) *DBInstance { + s.ReadReplicaSourceDBClusterIdentifier = &v + return s +} + // SetReadReplicaSourceDBInstanceIdentifier sets the ReadReplicaSourceDBInstanceIdentifier field's value. func (s *DBInstance) SetReadReplicaSourceDBInstanceIdentifier(v string) *DBInstance { s.ReadReplicaSourceDBInstanceIdentifier = &v @@ -40286,11 +40328,20 @@ type ModifyDBClusterInput struct { // this parameter results in an outage. The change is applied during the next // maintenance window unless ApplyImmediately is enabled. // + // If the cluster that you're modifying has one or more read replicas, all replicas + // must be running an engine version that's the same or later than the version + // you specify. + // // To list all of the available engine versions for Aurora MySQL version 2 (5.7-compatible) // and version 3 (MySQL 8.0-compatible), use the following command: // // aws rds describe-db-engine-versions --engine aurora-mysql --query "DBEngineVersions[].EngineVersion" // + // To list all of the available engine versions for MySQL 5.6-compatible Aurora, + // use the following command: + // + // aws rds describe-db-engine-versions --engine aurora --query "DBEngineVersions[].EngineVersion" + // // To list all of the available engine versions for Aurora PostgreSQL, use the // following command: // @@ -41454,6 +41505,10 @@ type ModifyDBInstanceInput struct { // to the default minor version if the current minor version is lower. For information // about valid engine versions, see CreateDBInstance, or call DescribeDBEngineVersions. // + // If the instance that you're modifying is acting as a read replica, the engine + // version that you specify must be the same or later than the version that + // the source DB instance or cluster is running. + // // In RDS Custom for Oracle, this parameter is supported for read replicas only // if they are in the PATCH_DB_FAILURE lifecycle. EngineVersion *string `type:"string"` @@ -52555,7 +52610,7 @@ type StopDBInstanceAutomatedBackupsReplicationInput struct { _ struct{} `type:"structure"` // The Amazon Resource Name (ARN) of the source DB instance for which to stop - // replicating automated backups, for example, arn:aws:rds:us-west-2:123456789012:db:mydatabase. + // replicating automate backups, for example, arn:aws:rds:us-west-2:123456789012:db:mydatabase. // // SourceDBInstanceArn is a required field SourceDBInstanceArn *string `type:"string" required:"true"` diff --git a/service/rds/examples_test.go b/service/rds/examples_test.go index 072374fb90..93eed41923 100644 --- a/service/rds/examples_test.go +++ b/service/rds/examples_test.go @@ -605,8 +605,12 @@ func ExampleRDS_CreateDBInstanceReadReplica_shared00() { fmt.Println(rds.ErrCodeStorageQuotaExceededFault, aerr.Error()) case rds.ErrCodeDBInstanceNotFoundFault: fmt.Println(rds.ErrCodeDBInstanceNotFoundFault, aerr.Error()) + case rds.ErrCodeDBClusterNotFoundFault: + fmt.Println(rds.ErrCodeDBClusterNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidDBInstanceStateFault: fmt.Println(rds.ErrCodeInvalidDBInstanceStateFault, aerr.Error()) + case rds.ErrCodeInvalidDBClusterStateFault: + fmt.Println(rds.ErrCodeInvalidDBClusterStateFault, aerr.Error()) case rds.ErrCodeDBSubnetGroupNotFoundFault: fmt.Println(rds.ErrCodeDBSubnetGroupNotFoundFault, aerr.Error()) case rds.ErrCodeDBSubnetGroupDoesNotCoverEnoughAZs: