diff --git a/.changelog/0c5f4550b86f4b148f9b4304efdb606f.json b/.changelog/0c5f4550b86f4b148f9b4304efdb606f.json new file mode 100644 index 00000000000..41d307acd8e --- /dev/null +++ b/.changelog/0c5f4550b86f4b148f9b4304efdb606f.json @@ -0,0 +1,8 @@ +{ + "id": "0c5f4550-b86f-4b14-8f9b-4304efdb606f", + "type": "documentation", + "description": "Doc-only update to correct alarm actions list", + "modules": [ + "service/cloudwatch" + ] +} \ No newline at end of file diff --git a/.changelog/346001df4c964df6839be2929a19e0c7.json b/.changelog/346001df4c964df6839be2929a19e0c7.json new file mode 100644 index 00000000000..840fd31f480 --- /dev/null +++ b/.changelog/346001df4c964df6839be2929a19e0c7.json @@ -0,0 +1,8 @@ +{ + "id": "346001df-4c96-4df6-839b-e2929a19e0c7", + "type": "feature", + "description": "Added error code CreateCustomDBEngineVersionFault for when the create custom engine version for Custom engines fails.", + "modules": [ + "service/rds" + ] +} \ No newline at end of file diff --git a/.changelog/58ed5805a7184ac0a8221aeede08e52b.json b/.changelog/58ed5805a7184ac0a8221aeede08e52b.json new file mode 100644 index 00000000000..05981a36725 --- /dev/null +++ b/.changelog/58ed5805a7184ac0a8221aeede08e52b.json @@ -0,0 +1,8 @@ +{ + "id": "58ed5805-a718-4ac0-a822-1aeede08e52b", + "type": "feature", + "description": "This release adds a new field (FlywheelArn) to the EntitiesDetectionJobProperties object. The FlywheelArn field is returned in the DescribeEntitiesDetectionJob and ListEntitiesDetectionJobs responses when the EntitiesDetection job is started with a FlywheelArn instead of an EntityRecognizerArn .", + "modules": [ + "service/comprehend" + ] +} \ No newline at end of file diff --git a/service/cloudwatch/api_op_DeleteAlarms.go b/service/cloudwatch/api_op_DeleteAlarms.go index 649f62d2312..467366cb04c 100644 --- a/service/cloudwatch/api_op_DeleteAlarms.go +++ b/service/cloudwatch/api_op_DeleteAlarms.go @@ -13,8 +13,12 @@ import ( // Deletes the specified alarms. You can delete up to 100 alarms in one operation. // However, this total can include no more than one composite alarm. For example, // you could delete 99 metric alarms and one composite alarms with one operation, -// but you can't delete two composite alarms with one operation. In the event of an -// error, no alarms are deleted. It is possible to create a loop or cycle of +// but you can't delete two composite alarms with one operation. If you specify an +// incorrect alarm name or make any other error in the operation, no alarms are +// deleted. To confirm that alarms were deleted successfully, you can use the +// DescribeAlarms +// (https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarms.html) +// operation after using DeleteAlarms. It is possible to create a loop or cycle of // composite alarms, where composite alarm A depends on composite alarm B, and // composite alarm B also depends on composite alarm A. In this scenario, you can't // delete any composite alarm that is part of the cycle because there is always @@ -41,7 +45,7 @@ func (c *Client) DeleteAlarms(ctx context.Context, params *DeleteAlarmsInput, op type DeleteAlarmsInput struct { - // The alarms to be deleted. + // The alarms to be deleted. Do not enclose the alarm names in quote marks. // // This member is required. AlarmNames []string diff --git a/service/cloudwatch/api_op_PutMetricAlarm.go b/service/cloudwatch/api_op_PutMetricAlarm.go index b6378e10cc6..8e23d54e18a 100644 --- a/service/cloudwatch/api_op_PutMetricAlarm.go +++ b/service/cloudwatch/api_op_PutMetricAlarm.go @@ -25,16 +25,16 @@ import ( // user, you must have Amazon EC2 permissions for some alarm operations: // // * The -// iam:CreateServiceLinkedRole for all alarms with EC2 actions +// iam:CreateServiceLinkedRole permission for all alarms with EC2 actions // // * The -// iam:CreateServiceLinkedRole to create an alarm with Systems Manager OpsItem -// actions. +// iam:CreateServiceLinkedRole permissions to create an alarm with Systems Manager +// OpsItem or response plan actions. // -// The first time you create an alarm in the Amazon Web Services -// Management Console, the CLI, or by using the PutMetricAlarm API, CloudWatch -// creates the necessary service-linked role for you. The service-linked roles are -// called AWSServiceRoleForCloudWatchEvents and +// The first time you create an alarm in the +// Amazon Web Services Management Console, the CLI, or by using the PutMetricAlarm +// API, CloudWatch creates the necessary service-linked role for you. The +// service-linked roles are called AWSServiceRoleForCloudWatchEvents and // AWSServiceRoleForCloudWatchAlarms_ActionSSM. For more information, see Amazon // Web Services service-linked role // (https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role). @@ -75,7 +75,8 @@ func (c *Client) PutMetricAlarm(ctx context.Context, params *PutMetricAlarmInput type PutMetricAlarmInput struct { - // The name for the alarm. This name must be unique within the Region. + // The name for the alarm. This name must be unique within the Region. The name + // must contain only UTF-8 characters, and can't contain ASCII control characters // // This member is required. AlarmName *string @@ -105,17 +106,50 @@ type PutMetricAlarmInput struct { // The actions to execute when this alarm transitions to the ALARM state from any // other state. Each action is specified as an Amazon Resource Name (ARN). Valid - // Values: arn:aws:automate:region:ec2:stop | arn:aws:automate:region:ec2:terminate - // | arn:aws:automate:region:ec2:recover | arn:aws:automate:region:ec2:reboot | - // arn:aws:sns:region:account-id:sns-topic-name | - // arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name - // | arn:aws:ssm:region:account-id:opsitem:severity | - // arn:aws:ssm-incidents::account-id:response-plan:response-plan-name Valid Values - // (for use with IAM roles): - // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0 | - // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0 | - // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0 | + // values: EC2 actions: + // + // * arn:aws:automate:region:ec2:stop + // + // * + // arn:aws:automate:region:ec2:terminate + // + // * arn:aws:automate:region:ec2:reboot + // + // * + // arn:aws:automate:region:ec2:recover + // + // * + // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0 + // + // * + // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0 + // + // * + // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0 + // + // * // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Recover/1.0 + // + // Autoscaling + // action: + // + // * + // arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name + // + // SSN + // notification action: + // + // * + // arn:aws:sns:region:account-id:sns-topic-name:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name + // + // SSM + // integration actions: + // + // * + // arn:aws:ssm:region:account-id:opsitem:severity#CATEGORY=category-name + // + // * + // arn:aws:ssm-incidents::account-id:responseplan/response-plan-name AlarmActions []string // The description for the alarm. @@ -148,15 +182,50 @@ type PutMetricAlarmInput struct { // The actions to execute when this alarm transitions to the INSUFFICIENT_DATA // state from any other state. Each action is specified as an Amazon Resource Name - // (ARN). Valid Values: arn:aws:automate:region:ec2:stop | - // arn:aws:automate:region:ec2:terminate | arn:aws:automate:region:ec2:recover | - // arn:aws:automate:region:ec2:reboot | - // arn:aws:sns:region:account-id:sns-topic-name | - // arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name - // Valid Values (for use with IAM roles): - // >arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0 | - // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0 | + // (ARN). Valid values: EC2 actions: + // + // * arn:aws:automate:region:ec2:stop + // + // * + // arn:aws:automate:region:ec2:terminate + // + // * arn:aws:automate:region:ec2:reboot + // + // * + // arn:aws:automate:region:ec2:recover + // + // * + // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0 + // + // * + // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0 + // + // * // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0 + // + // * + // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Recover/1.0 + // + // Autoscaling + // action: + // + // * + // arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name + // + // SSN + // notification action: + // + // * + // arn:aws:sns:region:account-id:sns-topic-name:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name + // + // SSM + // integration actions: + // + // * + // arn:aws:ssm:region:account-id:opsitem:severity#CATEGORY=category-name + // + // * + // arn:aws:ssm-incidents::account-id:responseplan/response-plan-name InsufficientDataActions []string // The name for the metric associated with the alarm. For each PutMetricAlarm @@ -184,16 +253,51 @@ type PutMetricAlarmInput struct { Namespace *string // The actions to execute when this alarm transitions to an OK state from any other - // state. Each action is specified as an Amazon Resource Name (ARN). Valid Values: - // arn:aws:automate:region:ec2:stop | arn:aws:automate:region:ec2:terminate | - // arn:aws:automate:region:ec2:recover | arn:aws:automate:region:ec2:reboot | - // arn:aws:sns:region:account-id:sns-topic-name | - // arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name - // Valid Values (for use with IAM roles): - // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0 | - // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0 | - // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0 | + // state. Each action is specified as an Amazon Resource Name (ARN). Valid values: + // EC2 actions: + // + // * arn:aws:automate:region:ec2:stop + // + // * + // arn:aws:automate:region:ec2:terminate + // + // * arn:aws:automate:region:ec2:reboot + // + // * + // arn:aws:automate:region:ec2:recover + // + // * + // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0 + // + // * + // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0 + // + // * + // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0 + // + // * // arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Recover/1.0 + // + // Autoscaling + // action: + // + // * + // arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name + // + // SSN + // notification action: + // + // * + // arn:aws:sns:region:account-id:sns-topic-name:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name + // + // SSM + // integration actions: + // + // * + // arn:aws:ssm:region:account-id:opsitem:severity#CATEGORY=category-name + // + // * + // arn:aws:ssm-incidents::account-id:responseplan/response-plan-name OKActions []string // The length, in seconds, used each time the metric specified in MetricName is diff --git a/service/cloudwatch/api_op_PutMetricData.go b/service/cloudwatch/api_op_PutMetricData.go index 3356e00781e..2b0808d653f 100644 --- a/service/cloudwatch/api_op_PutMetricData.go +++ b/service/cloudwatch/api_op_PutMetricData.go @@ -77,8 +77,10 @@ type PutMetricDataInput struct { // This member is required. MetricData []types.MetricDatum - // The namespace for the metric data. To avoid conflicts with Amazon Web Services - // service namespaces, you should not specify a namespace that begins with AWS/ + // The namespace for the metric data. You can use ASCII characters for the + // namespace, except for control characters which are not supported. To avoid + // conflicts with Amazon Web Services service namespaces, you should not specify a + // namespace that begins with AWS/ // // This member is required. Namespace *string diff --git a/service/cloudwatch/types/types.go b/service/cloudwatch/types/types.go index d46095d4811..3aee60b2a08 100644 --- a/service/cloudwatch/types/types.go +++ b/service/cloudwatch/types/types.go @@ -251,13 +251,15 @@ type Dimension struct { // The name of the dimension. Dimension names must contain only ASCII characters, // must include at least one non-whitespace character, and cannot start with a - // colon (:). + // colon (:). ASCII control characters are not supported as part of dimension + // names. // // This member is required. Name *string // The value of the dimension. Dimension values must contain only ASCII characters - // and must include at least one non-whitespace character. + // and must include at least one non-whitespace character. ASCII control characters + // are not supported as part of dimension values. // // This member is required. Value *string @@ -928,7 +930,9 @@ type MetricStreamEntry struct { } // This structure contains the name of one of the metric namespaces that is listed -// in a filter of a metric stream. +// in a filter of a metric stream. The namespace can contain only ASCII printable +// characters (ASCII range 32 through 126). It must contain at least one +// non-whitespace character. type MetricStreamFilter struct { // The name of the metric namespace in the filter. diff --git a/service/comprehend/api_op_BatchDetectSentiment.go b/service/comprehend/api_op_BatchDetectSentiment.go index b0a452d8281..d376c1abed9 100644 --- a/service/comprehend/api_op_BatchDetectSentiment.go +++ b/service/comprehend/api_op_BatchDetectSentiment.go @@ -39,8 +39,6 @@ type BatchDetectSentimentInput struct { // A list containing the UTF-8 encoded text of the input documents. The list can // contain a maximum of 25 documents. The maximum size of each document is 5 KB. - // Amazon Comprehend performs real-time sentiment analysis on the first 500 - // characters of the input text and ignores any additional text in the input. // // This member is required. TextList []string diff --git a/service/comprehend/api_op_CreateDocumentClassifier.go b/service/comprehend/api_op_CreateDocumentClassifier.go index 8bde6609e3b..3e989f690cd 100644 --- a/service/comprehend/api_op_CreateDocumentClassifier.go +++ b/service/comprehend/api_op_CreateDocumentClassifier.go @@ -36,8 +36,8 @@ func (c *Client) CreateDocumentClassifier(ctx context.Context, params *CreateDoc type CreateDocumentClassifierInput struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. // // This member is required. DataAccessRoleArn *string @@ -69,23 +69,23 @@ type CreateDocumentClassifierInput struct { // separated by a delimiter. The default delimiter between labels is a pipe (|). Mode types.DocumentClassifierMode - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt trained custom models. The ModelKmsKeyId can be either of the following - // formats: + // ID for the KMS key that Amazon Comprehend uses to encrypt trained custom models. + // The ModelKmsKeyId can be either of the following formats: // - // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" + // * KMS Key ID: + // "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * Amazon Resource Name (ARN) of a KMS + // Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" ModelKmsKeyId *string // The resource-based policy to attach to your custom document classifier model. - // You can use this policy to allow another AWS account to import your custom - // model. Provide your policy as a JSON body that you enter as a UTF-8 encoded - // string without line breaks. To provide valid JSON, enclose the attribute names - // and values in double quotes. If the JSON body is also enclosed in double quotes, - // then you must escape the double quotes that are inside the policy: + // You can use this policy to allow another Amazon Web Services account to import + // your custom model. Provide your policy as a JSON body that you enter as a UTF-8 + // encoded string without line breaks. To provide valid JSON, enclose the attribute + // names and values in double quotes. If the JSON body is also enclosed in double + // quotes, then you must escape the double quotes that are inside the policy: // "{\"attribute\": \"value\", \"attribute\": [\"value\"]}" To avoid escaping // quotes, you can use single quotes to enclose the policy and double quotes to // enclose the JSON names and values: '{"attribute": "value", "attribute": @@ -105,18 +105,18 @@ type CreateDocumentClassifierInput struct { // The version name given to the newly created classifier. Version names can have a // maximum of 256 characters. Alphanumeric characters, hyphens (-) and underscores // (_) are allowed. The version name must be unique among all models with the same - // classifier name in the account/AWS Region. + // classifier name in the Amazon Web Services account/Amazon Web Services Region. VersionName *string - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt data on the storage volume attached to the ML compute instance(s) that - // process the analysis job. The VolumeKmsKeyId can be either of the following - // formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt data on the storage volume attached to the ML compute + // instance(s) that process the analysis job. The VolumeKmsKeyId can be either of + // the following formats: // // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * + // Amazon Resource Name (ARN) of a KMS Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" VolumeKmsKeyId *string diff --git a/service/comprehend/api_op_CreateEndpoint.go b/service/comprehend/api_op_CreateEndpoint.go index bc59351fc88..02beedd378d 100644 --- a/service/comprehend/api_op_CreateEndpoint.go +++ b/service/comprehend/api_op_CreateEndpoint.go @@ -50,9 +50,9 @@ type CreateEndpointInput struct { // ResourceInUseException. ClientRequestToken *string - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to trained custom models - // encrypted with a customer managed key (ModelKmsKeyId). + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to trained custom models encrypted with a customer managed key + // (ModelKmsKeyId). DataAccessRoleArn *string // The Amazon Resource Number (ARN) of the flywheel to which the endpoint will be diff --git a/service/comprehend/api_op_CreateEntityRecognizer.go b/service/comprehend/api_op_CreateEntityRecognizer.go index b0068fefa52..ad3c0d3aa7b 100644 --- a/service/comprehend/api_op_CreateEntityRecognizer.go +++ b/service/comprehend/api_op_CreateEntityRecognizer.go @@ -32,14 +32,14 @@ func (c *Client) CreateEntityRecognizer(ctx context.Context, params *CreateEntit type CreateEntityRecognizerInput struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. // // This member is required. DataAccessRoleArn *string // Specifies the format and location of the input data. The S3 bucket containing - // the input data must be located in the same region as the entity recognizer being + // the input data must be located in the same Region as the entity recognizer being // created. // // This member is required. @@ -56,7 +56,7 @@ type CreateEntityRecognizerInput struct { // The name given to the newly created recognizer. Recognizer names can be a // maximum of 256 characters. Alphanumeric characters, hyphens (-) and underscores - // (_) are allowed. The name must be unique in the account/region. + // (_) are allowed. The name must be unique in the account/Region. // // This member is required. RecognizerName *string @@ -65,26 +65,27 @@ type CreateEntityRecognizerInput struct { // Amazon Comprehend generates one. ClientRequestToken *string - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt trained custom models. The ModelKmsKeyId can be either of the following - // formats: + // ID for the KMS key that Amazon Comprehend uses to encrypt trained custom models. + // The ModelKmsKeyId can be either of the following formats: // - // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" + // * KMS Key ID: + // "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * Amazon Resource Name (ARN) of a KMS + // Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" ModelKmsKeyId *string // The JSON resource-based policy to attach to your custom entity recognizer model. - // You can use this policy to allow another AWS account to import your custom - // model. Provide your JSON as a UTF-8 encoded string without line breaks. To - // provide valid JSON for your policy, enclose the attribute names and values in - // double quotes. If the JSON body is also enclosed in double quotes, then you must - // escape the double quotes that are inside the policy: "{\"attribute\": \"value\", - // \"attribute\": [\"value\"]}" To avoid escaping quotes, you can use single quotes - // to enclose the policy and double quotes to enclose the JSON names and values: - // '{"attribute": "value", "attribute": ["value"]}' + // You can use this policy to allow another Amazon Web Services account to import + // your custom model. Provide your JSON as a UTF-8 encoded string without line + // breaks. To provide valid JSON for your policy, enclose the attribute names and + // values in double quotes. If the JSON body is also enclosed in double quotes, + // then you must escape the double quotes that are inside the policy: + // "{\"attribute\": \"value\", \"attribute\": [\"value\"]}" To avoid escaping + // quotes, you can use single quotes to enclose the policy and double quotes to + // enclose the JSON names and values: '{"attribute": "value", "attribute": + // ["value"]}' ModelPolicy *string // Tags to associate with the entity recognizer. A tag is a key-value pair that @@ -96,18 +97,18 @@ type CreateEntityRecognizerInput struct { // The version name given to the newly created recognizer. Version names can be a // maximum of 256 characters. Alphanumeric characters, hyphens (-) and underscores // (_) are allowed. The version name must be unique among all models with the same - // recognizer name in the account/ AWS Region. + // recognizer name in the account/Region. VersionName *string - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt data on the storage volume attached to the ML compute instance(s) that - // process the analysis job. The VolumeKmsKeyId can be either of the following - // formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt data on the storage volume attached to the ML compute + // instance(s) that process the analysis job. The VolumeKmsKeyId can be either of + // the following formats: // // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * + // Amazon Resource Name (ARN) of a KMS Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" VolumeKmsKeyId *string diff --git a/service/comprehend/api_op_CreateFlywheel.go b/service/comprehend/api_op_CreateFlywheel.go index 251e1e312a7..0b3a41b1211 100644 --- a/service/comprehend/api_op_CreateFlywheel.go +++ b/service/comprehend/api_op_CreateFlywheel.go @@ -12,14 +12,14 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// A flywheel is an AWS resource that orchestrates the ongoing training of a model -// for custom classification or custom entity recognition. You can create a -// flywheel to start with an existing trained model, or Comprehend can create and -// train a new model. When you create the flywheel, Comprehend creates a data lake -// in your account. The data lake holds the training data and test data for all -// versions of the model. To use a flywheel with an existing trained model, you -// specify the active model version. Comprehend copies the model's training data -// and test data into the flywheel's data lake. To use the flywheel with a new +// A flywheel is an Amazon Web Services resource that orchestrates the ongoing +// training of a model for custom classification or custom entity recognition. You +// can create a flywheel to start with an existing trained model, or Comprehend can +// create and train a new model. When you create the flywheel, Comprehend creates a +// data lake in your account. The data lake holds the training data and test data +// for all versions of the model. To use a flywheel with an existing trained model, +// you specify the active model version. Comprehend copies the model's training +// data and test data into the flywheel's data lake. To use the flywheel with a new // model, you need to provide a dataset for training data (and optional test data) // when you create the flywheel. For more information about flywheels, see // Flywheel overview @@ -42,9 +42,8 @@ func (c *Client) CreateFlywheel(ctx context.Context, params *CreateFlywheelInput type CreateFlywheelInput struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend the permissions required to access the - // flywheel data in the data lake. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend the + // permissions required to access the flywheel data in the data lake. // // This member is required. DataAccessRoleArn *string diff --git a/service/comprehend/api_op_DetectDominantLanguage.go b/service/comprehend/api_op_DetectDominantLanguage.go index 06866669562..79e822d126a 100644 --- a/service/comprehend/api_op_DetectDominantLanguage.go +++ b/service/comprehend/api_op_DetectDominantLanguage.go @@ -42,11 +42,13 @@ type DetectDominantLanguageInput struct { type DetectDominantLanguageOutput struct { - // The languages that Amazon Comprehend detected in the input text. For each - // language, the response returns the RFC 5646 language code and the level of - // confidence that Amazon Comprehend has in the accuracy of its inference. For more - // information about RFC 5646, see Tags for Identifying Languages - // (https://tools.ietf.org/html/rfc5646) on the IETF Tools web site. + // Array of languages that Amazon Comprehend detected in the input text. The array + // is sorted in descending order of the score (the dominant language is always the + // first element in the array). For each language, the response returns the RFC + // 5646 language code and the level of confidence that Amazon Comprehend has in the + // accuracy of its inference. For more information about RFC 5646, see Tags for + // Identifying Languages (https://tools.ietf.org/html/rfc5646) on the IETF Tools + // web site. Languages []types.DominantLanguage // Metadata pertaining to the operation's result. diff --git a/service/comprehend/api_op_DetectSentiment.go b/service/comprehend/api_op_DetectSentiment.go index a21375bcd58..1f680544751 100644 --- a/service/comprehend/api_op_DetectSentiment.go +++ b/service/comprehend/api_op_DetectSentiment.go @@ -37,9 +37,7 @@ type DetectSentimentInput struct { // This member is required. LanguageCode types.LanguageCode - // A UTF-8 text string. The maximum string size is 5 KB. Amazon Comprehend performs - // real-time sentiment analysis on the first 500 characters of the input text and - // ignores any additional text in the input. + // A UTF-8 text string. The maximum string size is 5 KB. // // This member is required. Text *string diff --git a/service/comprehend/api_op_ImportModel.go b/service/comprehend/api_op_ImportModel.go index 7d095ef02ed..96ebf61aba9 100644 --- a/service/comprehend/api_op_ImportModel.go +++ b/service/comprehend/api_op_ImportModel.go @@ -12,11 +12,11 @@ import ( ) // Creates a new custom model that replicates a source custom model that you -// import. The source model can be in your AWS account or another one. If the -// source model is in another AWS account, then it must have a resource-based -// policy that authorizes you to import it. The source model must be in the same -// AWS region that you're using when you import. You can't import a model that's in -// a different region. +// import. The source model can be in your Amazon Web Services account or another +// one. If the source model is in another Amazon Web Services account, then it must +// have a resource-based policy that authorizes you to import it. The source model +// must be in the same Amazon Web Services Region that you're using when you +// import. You can't import a model that's in a different Region. func (c *Client) ImportModel(ctx context.Context, params *ImportModelInput, optFns ...func(*Options)) (*ImportModelOutput, error) { if params == nil { params = &ImportModelInput{} @@ -39,19 +39,19 @@ type ImportModelInput struct { // This member is required. SourceModelArn *string - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend permission to use Amazon Key Management - // Service (KMS) to encrypt or decrypt the custom model. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // permission to use Amazon Key Management Service (KMS) to encrypt or decrypt the + // custom model. DataAccessRoleArn *string - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt trained custom models. The ModelKmsKeyId can be either of the following - // formats: + // ID for the KMS key that Amazon Comprehend uses to encrypt trained custom models. + // The ModelKmsKeyId can be either of the following formats: // - // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" + // * KMS Key ID: + // "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * Amazon Resource Name (ARN) of a KMS + // Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" ModelKmsKeyId *string @@ -68,7 +68,7 @@ type ImportModelInput struct { // The version name given to the custom model that is created by this import. // Version names can have a maximum of 256 characters. Alphanumeric characters, // hyphens (-) and underscores (_) are allowed. The version name must be unique - // among all models with the same classifier name in the account/AWS Region. + // among all models with the same classifier name in the account/Region. VersionName *string noSmithyDocumentSerde diff --git a/service/comprehend/api_op_ListDatasets.go b/service/comprehend/api_op_ListDatasets.go index d2e8691523c..8e06301520e 100644 --- a/service/comprehend/api_op_ListDatasets.go +++ b/service/comprehend/api_op_ListDatasets.go @@ -12,7 +12,7 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// List the datasets that you have configured in this region. For more information +// List the datasets that you have configured in this Region. For more information // about datasets, see Flywheel overview // (https://docs.aws.amazon.com/comprehend/latest/dg/flywheels-about.html) in the // Amazon Comprehend Developer Guide. diff --git a/service/comprehend/api_op_PutResourcePolicy.go b/service/comprehend/api_op_PutResourcePolicy.go index b4c44673b3f..36b7778a2b6 100644 --- a/service/comprehend/api_op_PutResourcePolicy.go +++ b/service/comprehend/api_op_PutResourcePolicy.go @@ -11,8 +11,8 @@ import ( ) // Attaches a resource-based policy to a custom model. You can use this policy to -// authorize an entity in another AWS account to import the custom model, which -// replicates it in Amazon Comprehend in their account. +// authorize an entity in another Amazon Web Services account to import the custom +// model, which replicates it in Amazon Comprehend in their account. func (c *Client) PutResourcePolicy(ctx context.Context, params *PutResourcePolicyInput, optFns ...func(*Options)) (*PutResourcePolicyOutput, error) { if params == nil { params = &PutResourcePolicyInput{} diff --git a/service/comprehend/api_op_StartDocumentClassificationJob.go b/service/comprehend/api_op_StartDocumentClassificationJob.go index 7b11aaff769..2a936333b01 100644 --- a/service/comprehend/api_op_StartDocumentClassificationJob.go +++ b/service/comprehend/api_op_StartDocumentClassificationJob.go @@ -31,8 +31,8 @@ func (c *Client) StartDocumentClassificationJob(ctx context.Context, params *Sta type StartDocumentClassificationJobInput struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. // // This member is required. DataAccessRoleArn *string @@ -68,15 +68,15 @@ type StartDocumentClassificationJobInput struct { // the sales department. Tags []types.Tag - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt data on the storage volume attached to the ML compute instance(s) that - // process the analysis job. The VolumeKmsKeyId can be either of the following - // formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt data on the storage volume attached to the ML compute + // instance(s) that process the analysis job. The VolumeKmsKeyId can be either of + // the following formats: // // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * + // Amazon Resource Name (ARN) of a KMS Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" VolumeKmsKeyId *string @@ -95,10 +95,10 @@ type StartDocumentClassificationJobOutput struct { DocumentClassifierArn *string // The Amazon Resource Name (ARN) of the document classification job. It is a - // unique, fully qualified identifier for the job. It includes the AWS account, - // Region, and the job ID. The format of the ARN is as follows: - // arn::comprehend:::document-classification-job/ The following is an example job - // ARN: + // unique, fully qualified identifier for the job. It includes the Amazon Web + // Services account, Amazon Web Services Region, and the job ID. The format of the + // ARN is as follows: arn::comprehend:::document-classification-job/ The following + // is an example job ARN: // arn:aws:comprehend:us-west-2:111122223333:document-classification-job/1234abcd12ab34cd56ef1234567890ab JobArn *string diff --git a/service/comprehend/api_op_StartDominantLanguageDetectionJob.go b/service/comprehend/api_op_StartDominantLanguageDetectionJob.go index bc7d3656a7b..b56353dade8 100644 --- a/service/comprehend/api_op_StartDominantLanguageDetectionJob.go +++ b/service/comprehend/api_op_StartDominantLanguageDetectionJob.go @@ -31,11 +31,9 @@ func (c *Client) StartDominantLanguageDetectionJob(ctx context.Context, params * type StartDominantLanguageDetectionJobInput struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. For more - // information, see - // https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions - // (https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions). + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. For more information, see Role-based permissions + // (https://docs.aws.amazon.com/comprehend/latest/dg/security_iam_id-based-policy-examples.html#auth-role-permissions). // // This member is required. DataAccessRoleArn *string @@ -63,15 +61,15 @@ type StartDominantLanguageDetectionJobInput struct { // the sales department. Tags []types.Tag - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt data on the storage volume attached to the ML compute instance(s) that - // process the analysis job. The VolumeKmsKeyId can be either of the following - // formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt data on the storage volume attached to the ML compute + // instance(s) that process the analysis job. The VolumeKmsKeyId can be either of + // the following formats: // // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * + // Amazon Resource Name (ARN) of a KMS Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" VolumeKmsKeyId *string @@ -87,10 +85,10 @@ type StartDominantLanguageDetectionJobInput struct { type StartDominantLanguageDetectionJobOutput struct { // The Amazon Resource Name (ARN) of the dominant language detection job. It is a - // unique, fully qualified identifier for the job. It includes the AWS account, - // Region, and the job ID. The format of the ARN is as follows: - // arn::comprehend:::dominant-language-detection-job/ The following is an example - // job ARN: + // unique, fully qualified identifier for the job. It includes the Amazon Web + // Services account, Amazon Web Services Region, and the job ID. The format of the + // ARN is as follows: arn::comprehend:::dominant-language-detection-job/ The + // following is an example job ARN: // arn:aws:comprehend:us-west-2:111122223333:dominant-language-detection-job/1234abcd12ab34cd56ef1234567890ab JobArn *string diff --git a/service/comprehend/api_op_StartEntitiesDetectionJob.go b/service/comprehend/api_op_StartEntitiesDetectionJob.go index 9104eb86beb..39d1eb992cd 100644 --- a/service/comprehend/api_op_StartEntitiesDetectionJob.go +++ b/service/comprehend/api_op_StartEntitiesDetectionJob.go @@ -35,11 +35,9 @@ func (c *Client) StartEntitiesDetectionJob(ctx context.Context, params *StartEnt type StartEntitiesDetectionJobInput struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. For more - // information, see - // https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions - // (https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions). + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. For more information, see Role-based permissions + // (https://docs.aws.amazon.com/comprehend/latest/dg/security_iam_id-based-policy-examples.html#auth-role-permissions). // // This member is required. DataAccessRoleArn *string @@ -84,15 +82,15 @@ type StartEntitiesDetectionJobInput struct { // sales department. Tags []types.Tag - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt data on the storage volume attached to the ML compute instance(s) that - // process the analysis job. The VolumeKmsKeyId can be either of the following - // formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt data on the storage volume attached to the ML compute + // instance(s) that process the analysis job. The VolumeKmsKeyId can be either of + // the following formats: // // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * + // Amazon Resource Name (ARN) of a KMS Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" VolumeKmsKeyId *string @@ -111,9 +109,10 @@ type StartEntitiesDetectionJobOutput struct { EntityRecognizerArn *string // The Amazon Resource Name (ARN) of the entities detection job. It is a unique, - // fully qualified identifier for the job. It includes the AWS account, Region, and - // the job ID. The format of the ARN is as follows: - // arn::comprehend:::entities-detection-job/ The following is an example job ARN: + // fully qualified identifier for the job. It includes the Amazon Web Services + // account, Amazon Web Services Region, and the job ID. The format of the ARN is as + // follows: arn::comprehend:::entities-detection-job/ The following is an example + // job ARN: // arn:aws:comprehend:us-west-2:111122223333:entities-detection-job/1234abcd12ab34cd56ef1234567890ab JobArn *string diff --git a/service/comprehend/api_op_StartEventsDetectionJob.go b/service/comprehend/api_op_StartEventsDetectionJob.go index 2955cf19330..cce4be8365c 100644 --- a/service/comprehend/api_op_StartEventsDetectionJob.go +++ b/service/comprehend/api_op_StartEventsDetectionJob.go @@ -30,8 +30,8 @@ func (c *Client) StartEventsDetectionJob(ctx context.Context, params *StartEvent type StartEventsDetectionJobInput struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. // // This member is required. DataAccessRoleArn *string @@ -75,9 +75,10 @@ type StartEventsDetectionJobInput struct { type StartEventsDetectionJobOutput struct { // The Amazon Resource Name (ARN) of the events detection job. It is a unique, - // fully qualified identifier for the job. It includes the AWS account, Region, and - // the job ID. The format of the ARN is as follows: - // arn::comprehend:::events-detection-job/ The following is an example job ARN: + // fully qualified identifier for the job. It includes the Amazon Web Services + // account, Amazon Web Services Region, and the job ID. The format of the ARN is as + // follows: arn::comprehend:::events-detection-job/ The following is an example job + // ARN: // arn:aws:comprehend:us-west-2:111122223333:events-detection-job/1234abcd12ab34cd56ef1234567890ab JobArn *string diff --git a/service/comprehend/api_op_StartKeyPhrasesDetectionJob.go b/service/comprehend/api_op_StartKeyPhrasesDetectionJob.go index b50b9b235cf..0a1001fb0fa 100644 --- a/service/comprehend/api_op_StartKeyPhrasesDetectionJob.go +++ b/service/comprehend/api_op_StartKeyPhrasesDetectionJob.go @@ -31,11 +31,9 @@ func (c *Client) StartKeyPhrasesDetectionJob(ctx context.Context, params *StartK type StartKeyPhrasesDetectionJobInput struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. For more - // information, see - // https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions - // (https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions). + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. For more information, see Role-based permissions + // (https://docs.aws.amazon.com/comprehend/latest/dg/security_iam_id-based-policy-examples.html#auth-role-permissions). // // This member is required. DataAccessRoleArn *string @@ -70,15 +68,15 @@ type StartKeyPhrasesDetectionJobInput struct { // sales department. Tags []types.Tag - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt data on the storage volume attached to the ML compute instance(s) that - // process the analysis job. The VolumeKmsKeyId can be either of the following - // formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt data on the storage volume attached to the ML compute + // instance(s) that process the analysis job. The VolumeKmsKeyId can be either of + // the following formats: // // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * + // Amazon Resource Name (ARN) of a KMS Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" VolumeKmsKeyId *string @@ -94,10 +92,10 @@ type StartKeyPhrasesDetectionJobInput struct { type StartKeyPhrasesDetectionJobOutput struct { // The Amazon Resource Name (ARN) of the key phrase detection job. It is a unique, - // fully qualified identifier for the job. It includes the AWS account, Region, and - // the job ID. The format of the ARN is as follows: - // arn::comprehend:::key-phrases-detection-job/ The following is an example job - // ARN: + // fully qualified identifier for the job. It includes the Amazon Web Services + // account, Amazon Web Services Region, and the job ID. The format of the ARN is as + // follows: arn::comprehend:::key-phrases-detection-job/ The following is an + // example job ARN: // arn:aws:comprehend:us-west-2:111122223333:key-phrases-detection-job/1234abcd12ab34cd56ef1234567890ab JobArn *string diff --git a/service/comprehend/api_op_StartPiiEntitiesDetectionJob.go b/service/comprehend/api_op_StartPiiEntitiesDetectionJob.go index bd84dd971f4..422bb27a303 100644 --- a/service/comprehend/api_op_StartPiiEntitiesDetectionJob.go +++ b/service/comprehend/api_op_StartPiiEntitiesDetectionJob.go @@ -30,8 +30,8 @@ func (c *Client) StartPiiEntitiesDetectionJob(ctx context.Context, params *Start type StartPiiEntitiesDetectionJobInput struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. // // This member is required. DataAccessRoleArn *string @@ -82,10 +82,10 @@ type StartPiiEntitiesDetectionJobInput struct { type StartPiiEntitiesDetectionJobOutput struct { // The Amazon Resource Name (ARN) of the PII entity detection job. It is a unique, - // fully qualified identifier for the job. It includes the AWS account, Region, and - // the job ID. The format of the ARN is as follows: - // arn::comprehend:::pii-entities-detection-job/ The following is an example job - // ARN: + // fully qualified identifier for the job. It includes the Amazon Web Services + // account, Amazon Web Services Region, and the job ID. The format of the ARN is as + // follows: arn::comprehend:::pii-entities-detection-job/ The following is an + // example job ARN: // arn:aws:comprehend:us-west-2:111122223333:pii-entities-detection-job/1234abcd12ab34cd56ef1234567890ab JobArn *string diff --git a/service/comprehend/api_op_StartSentimentDetectionJob.go b/service/comprehend/api_op_StartSentimentDetectionJob.go index 1693a27d306..7bc53a55fef 100644 --- a/service/comprehend/api_op_StartSentimentDetectionJob.go +++ b/service/comprehend/api_op_StartSentimentDetectionJob.go @@ -31,11 +31,9 @@ func (c *Client) StartSentimentDetectionJob(ctx context.Context, params *StartSe type StartSentimentDetectionJobInput struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. For more - // information, see - // https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions - // (https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions). + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. For more information, see Role-based permissions + // (https://docs.aws.amazon.com/comprehend/latest/dg/security_iam_id-based-policy-examples.html#auth-role-permissions). // // This member is required. DataAccessRoleArn *string @@ -70,15 +68,15 @@ type StartSentimentDetectionJobInput struct { // sales department. Tags []types.Tag - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt data on the storage volume attached to the ML compute instance(s) that - // process the analysis job. The VolumeKmsKeyId can be either of the following - // formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt data on the storage volume attached to the ML compute + // instance(s) that process the analysis job. The VolumeKmsKeyId can be either of + // the following formats: // // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * + // Amazon Resource Name (ARN) of a KMS Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" VolumeKmsKeyId *string @@ -94,9 +92,10 @@ type StartSentimentDetectionJobInput struct { type StartSentimentDetectionJobOutput struct { // The Amazon Resource Name (ARN) of the sentiment detection job. It is a unique, - // fully qualified identifier for the job. It includes the AWS account, Region, and - // the job ID. The format of the ARN is as follows: - // arn::comprehend:::sentiment-detection-job/ The following is an example job ARN: + // fully qualified identifier for the job. It includes the Amazon Web Services + // account, Amazon Web Services Region, and the job ID. The format of the ARN is as + // follows: arn::comprehend:::sentiment-detection-job/ The following is an example + // job ARN: // arn:aws:comprehend:us-west-2:111122223333:sentiment-detection-job/1234abcd12ab34cd56ef1234567890ab JobArn *string diff --git a/service/comprehend/api_op_StartTargetedSentimentDetectionJob.go b/service/comprehend/api_op_StartTargetedSentimentDetectionJob.go index 0cd90709a20..d0f37f36052 100644 --- a/service/comprehend/api_op_StartTargetedSentimentDetectionJob.go +++ b/service/comprehend/api_op_StartTargetedSentimentDetectionJob.go @@ -32,9 +32,8 @@ func (c *Client) StartTargetedSentimentDetectionJob(ctx context.Context, params type StartTargetedSentimentDetectionJobInput struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. For more - // information, see Role-based permissions + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. For more information, see Role-based permissions // (https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions). // // This member is required. @@ -94,10 +93,10 @@ type StartTargetedSentimentDetectionJobInput struct { type StartTargetedSentimentDetectionJobOutput struct { // The Amazon Resource Name (ARN) of the targeted sentiment detection job. It is a - // unique, fully qualified identifier for the job. It includes the AWS account, - // Region, and the job ID. The format of the ARN is as follows: - // arn::comprehend:::targeted-sentiment-detection-job/ The following is an example - // job ARN: + // unique, fully qualified identifier for the job. It includes the Amazon Web + // Services account, Amazon Web Services Region, and the job ID. The format of the + // ARN is as follows: arn::comprehend:::targeted-sentiment-detection-job/ The + // following is an example job ARN: // arn:aws:comprehend:us-west-2:111122223333:targeted-sentiment-detection-job/1234abcd12ab34cd56ef1234567890ab JobArn *string diff --git a/service/comprehend/api_op_StartTopicsDetectionJob.go b/service/comprehend/api_op_StartTopicsDetectionJob.go index e8d46f0ccb0..a5c17cf133d 100644 --- a/service/comprehend/api_op_StartTopicsDetectionJob.go +++ b/service/comprehend/api_op_StartTopicsDetectionJob.go @@ -31,11 +31,9 @@ func (c *Client) StartTopicsDetectionJob(ctx context.Context, params *StartTopic type StartTopicsDetectionJobInput struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. For more - // information, see - // https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions - // (https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions). + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. For more information, see Role-based permissions + // (https://docs.aws.amazon.com/comprehend/latest/dg/security_iam_id-based-policy-examples.html#auth-role-permissions). // // This member is required. DataAccessRoleArn *string @@ -68,15 +66,15 @@ type StartTopicsDetectionJobInput struct { // department. Tags []types.Tag - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt data on the storage volume attached to the ML compute instance(s) that - // process the analysis job. The VolumeKmsKeyId can be either of the following - // formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt data on the storage volume attached to the ML compute + // instance(s) that process the analysis job. The VolumeKmsKeyId can be either of + // the following formats: // // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * + // Amazon Resource Name (ARN) of a KMS Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" VolumeKmsKeyId *string @@ -92,9 +90,10 @@ type StartTopicsDetectionJobInput struct { type StartTopicsDetectionJobOutput struct { // The Amazon Resource Name (ARN) of the topics detection job. It is a unique, - // fully qualified identifier for the job. It includes the AWS account, Region, and - // the job ID. The format of the ARN is as follows: - // arn::comprehend:::topics-detection-job/ The following is an example job ARN: + // fully qualified identifier for the job. It includes the Amazon Web Services + // account, Amazon Web Services Region, and the job ID. The format of the ARN is as + // follows: arn::comprehend:::topics-detection-job/ The following is an example job + // ARN: // arn:aws:comprehend:us-west-2:111122223333:document-classification-job/1234abcd12ab34cd56ef1234567890ab JobArn *string diff --git a/service/comprehend/api_op_UpdateFlywheel.go b/service/comprehend/api_op_UpdateFlywheel.go index ea492051a6c..93a340a8a9a 100644 --- a/service/comprehend/api_op_UpdateFlywheel.go +++ b/service/comprehend/api_op_UpdateFlywheel.go @@ -37,8 +37,8 @@ type UpdateFlywheelInput struct { // The Amazon Resource Number (ARN) of the active model version. ActiveModelArn *string - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend permission to access the flywheel data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // permission to access the flywheel data. DataAccessRoleArn *string // Flywheel data security configuration. diff --git a/service/comprehend/deserializers.go b/service/comprehend/deserializers.go index 05b21e9dc47..c9b98cff74a 100644 --- a/service/comprehend/deserializers.go +++ b/service/comprehend/deserializers.go @@ -13994,6 +13994,15 @@ func awsAwsjson11_deserializeDocumentEntitiesDetectionJobProperties(v **types.En sv.EntityRecognizerArn = ptr.String(jtv) } + case "FlywheelArn": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected ComprehendFlywheelArn to be of type string, got %T instead", value) + } + sv.FlywheelArn = ptr.String(jtv) + } + case "InputDataConfig": if err := awsAwsjson11_deserializeDocumentInputDataConfig(&sv.InputDataConfig, value); err != nil { return err diff --git a/service/comprehend/doc.go b/service/comprehend/doc.go index 747a74bd9df..eabbc512d7a 100644 --- a/service/comprehend/doc.go +++ b/service/comprehend/doc.go @@ -3,8 +3,8 @@ // Package comprehend provides the API client, operations, and parameter types for // Amazon Comprehend. // -// Amazon Comprehend is an AWS service for gaining insight into the content of -// documents. Use these actions to determine the topics contained in your -// documents, the topics they discuss, the predominant sentiment expressed in them, -// the predominant language used, and more. +// Amazon Comprehend is an Amazon Web Services service for gaining insight into the +// content of documents. Use these actions to determine the topics contained in +// your documents, the topics they discuss, the predominant sentiment expressed in +// them, the predominant language used, and more. package comprehend diff --git a/service/comprehend/types/enums.go b/service/comprehend/types/enums.go index 7e448a14ae4..07aca0d1e85 100644 --- a/service/comprehend/types/enums.go +++ b/service/comprehend/types/enums.go @@ -461,13 +461,14 @@ type ModelStatus string // Enum values for ModelStatus const ( - ModelStatusSubmitted ModelStatus = "SUBMITTED" - ModelStatusTraining ModelStatus = "TRAINING" - ModelStatusDeleting ModelStatus = "DELETING" - ModelStatusStopRequested ModelStatus = "STOP_REQUESTED" - ModelStatusStopped ModelStatus = "STOPPED" - ModelStatusInError ModelStatus = "IN_ERROR" - ModelStatusTrained ModelStatus = "TRAINED" + ModelStatusSubmitted ModelStatus = "SUBMITTED" + ModelStatusTraining ModelStatus = "TRAINING" + ModelStatusDeleting ModelStatus = "DELETING" + ModelStatusStopRequested ModelStatus = "STOP_REQUESTED" + ModelStatusStopped ModelStatus = "STOPPED" + ModelStatusInError ModelStatus = "IN_ERROR" + ModelStatusTrained ModelStatus = "TRAINED" + ModelStatusTrainedWithWarning ModelStatus = "TRAINED_WITH_WARNING" ) // Values returns all known values for ModelStatus. Note that this can be expanded @@ -482,6 +483,7 @@ func (ModelStatus) Values() []ModelStatus { "STOPPED", "IN_ERROR", "TRAINED", + "TRAINED_WITH_WARNING", } } diff --git a/service/comprehend/types/types.go b/service/comprehend/types/types.go index 0c6b4f84c6d..476b9f7bed9 100644 --- a/service/comprehend/types/types.go +++ b/service/comprehend/types/types.go @@ -335,14 +335,14 @@ type DataSecurityConfig struct { // lake. DataLakeKmsKeyId *string - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt trained custom models. The ModelKmsKeyId can be either of the following - // formats: + // ID for the KMS key that Amazon Comprehend uses to encrypt trained custom models. + // The ModelKmsKeyId can be either of the following formats: // - // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" + // * KMS Key ID: + // "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * Amazon Resource Name (ARN) of a KMS + // Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" ModelKmsKeyId *string @@ -403,7 +403,7 @@ type DatasetAugmentedManifestsListItem struct { // the Comprehend Developer Guide. type DatasetDocumentClassifierInputDataConfig struct { - // The Amazon S3 URI for the input data. The S3 bucket must be in the same region + // The Amazon S3 URI for the input data. The S3 bucket must be in the same Region // as the API endpoint that you are calling. The URI can point to a single input // file or it can provide the prefix for a collection of input files. For example, // if you use the URI S3://bucketName/prefix, if the prefix is a single file, @@ -429,7 +429,7 @@ type DatasetDocumentClassifierInputDataConfig struct { type DatasetEntityRecognizerAnnotations struct { // Specifies the Amazon S3 location where the training documents for an entity - // recognizer are located. The URI must be in the same region as the API endpoint + // recognizer are located. The URI must be in the same Region as the API endpoint // that you are calling. // // This member is required. @@ -630,8 +630,8 @@ type DocumentClassificationJobFilter struct { // Provides information about a document classification job. type DocumentClassificationJobProperties struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. DataAccessRoleArn *string // The Amazon Resource Name (ARN) that identifies the document classifier. @@ -648,10 +648,10 @@ type DocumentClassificationJobProperties struct { InputDataConfig *InputDataConfig // The Amazon Resource Name (ARN) of the document classification job. It is a - // unique, fully qualified identifier for the job. It includes the AWS account, - // Region, and the job ID. The format of the ARN is as follows: - // arn::comprehend:::document-classification-job/ The following is an example job - // ARN: + // unique, fully qualified identifier for the job. It includes the Amazon Web + // Services account, Amazon Web Services Region, and the job ID. The format of the + // ARN is as follows: arn::comprehend:::document-classification-job/ The following + // is an example job ARN: // arn:aws:comprehend:us-west-2:111122223333:document-classification-job/1234abcd12ab34cd56ef1234567890ab JobArn *string @@ -675,15 +675,15 @@ type DocumentClassificationJobProperties struct { // The time that the document classification job was submitted for processing. SubmitTime *time.Time - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt data on the storage volume attached to the ML compute instance(s) that - // process the analysis job. The VolumeKmsKeyId can be either of the following - // formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt data on the storage volume attached to the ML compute + // instance(s) that process the analysis job. The VolumeKmsKeyId can be either of + // the following formats: // // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * + // Amazon Resource Name (ARN) of a KMS Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" VolumeKmsKeyId *string @@ -757,7 +757,7 @@ type DocumentClassifierInputDataConfig struct { // combined to make a single unique label, such as LABELLABELLABEL. LabelDelimiter *string - // The Amazon S3 URI for the input data. The S3 bucket must be in the same region + // The Amazon S3 URI for the input data. The S3 bucket must be in the same Region // as the API endpoint that you are calling. The URI can point to a single input // file or it can provide the prefix for a collection of input files. For example, // if you use the URI S3://bucketName/prefix, if the prefix is a single file, @@ -767,8 +767,8 @@ type DocumentClassifierInputDataConfig struct { S3Uri *string // This specifies the Amazon S3 location where the test annotations for an entity - // recognizer are located. The URI must be in the same AWS Region as the API - // endpoint that you are calling. + // recognizer are located. The URI must be in the same Amazon Web Services Region + // as the API endpoint that you are calling. TestS3Uri *string noSmithyDocumentSerde @@ -780,14 +780,15 @@ type DocumentClassifierOutputDataConfig struct { // The Amazon S3 prefix for the data lake location of the flywheel statistics. FlywheelStatsS3Prefix *string - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt the output results from an analysis job. The KmsKeyId can be one of the - // following formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt the output results from an analysis job. The KmsKeyId + // can be one of the following formats: // - // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" + // * KMS Key ID: + // "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * - // Amazon Resource Name (ARN) of a KMS Key: + // * Amazon Resource Name (ARN) of a KMS + // Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" // // * @@ -799,7 +800,7 @@ type DocumentClassifierOutputDataConfig struct { // When you use the OutputDataConfig object while creating a custom classifier, you // specify the Amazon S3 location where you want to write the confusion matrix. The - // URI must be in the same region as the API endpoint that you are calling. The + // URI must be in the same Region as the API endpoint that you are calling. The // location is used as the prefix for the actual location of this output file. When // the custom classifier job is finished, the service creates the output file in a // directory specific to the job. The S3Uri field contains the location of the @@ -818,8 +819,8 @@ type DocumentClassifierProperties struct { // classifier, and an accuracy rating. ClassifierMetadata *ClassifierMetadata - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. DataAccessRoleArn *string // The Amazon Resource Name (ARN) that identifies the document classifier. @@ -848,14 +849,14 @@ type DocumentClassifierProperties struct { // the classifier is trained. Mode DocumentClassifierMode - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt trained custom models. The ModelKmsKeyId can be either of the following - // formats: + // ID for the KMS key that Amazon Comprehend uses to encrypt trained custom models. + // The ModelKmsKeyId can be either of the following formats: // - // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" + // * KMS Key ID: + // "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * Amazon Resource Name (ARN) of a KMS + // Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" ModelKmsKeyId *string @@ -863,8 +864,8 @@ type DocumentClassifierProperties struct { OutputDataConfig *DocumentClassifierOutputDataConfig // The Amazon Resource Name (ARN) of the source model. This model was imported from - // a different AWS account to create the document classifier model in your AWS - // account. + // a different Amazon Web Services account to create the document classifier model + // in your Amazon Web Services account. SourceModelArn *string // The status of the document classifier. If the status is TRAINED the classifier @@ -888,15 +889,15 @@ type DocumentClassifierProperties struct { // The version name that you assigned to the document classifier. VersionName *string - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt data on the storage volume attached to the ML compute instance(s) that - // process the analysis job. The VolumeKmsKeyId can be either of the following - // formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt data on the storage volume attached to the ML compute + // instance(s) that process the analysis job. The VolumeKmsKeyId can be either of + // the following formats: // // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * + // Amazon Resource Name (ARN) of a KMS Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" VolumeKmsKeyId *string @@ -1074,8 +1075,8 @@ type DominantLanguageDetectionJobFilter struct { // Provides information about a dominant language detection job. type DominantLanguageDetectionJobProperties struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. DataAccessRoleArn *string // The time that the dominant language detection job completed. @@ -1086,10 +1087,10 @@ type DominantLanguageDetectionJobProperties struct { InputDataConfig *InputDataConfig // The Amazon Resource Name (ARN) of the dominant language detection job. It is a - // unique, fully qualified identifier for the job. It includes the AWS account, - // Region, and the job ID. The format of the ARN is as follows: - // arn::comprehend:::dominant-language-detection-job/ The following is an example - // job ARN: + // unique, fully qualified identifier for the job. It includes the Amazon Web + // Services account, Amazon Web Services Region, and the job ID. The format of the + // ARN is as follows: arn::comprehend:::dominant-language-detection-job/ The + // following is an example job ARN: // arn:aws:comprehend:us-west-2:111122223333:dominant-language-detection-job/1234abcd12ab34cd56ef1234567890ab JobArn *string @@ -1113,15 +1114,15 @@ type DominantLanguageDetectionJobProperties struct { // The time that the dominant language detection job was submitted for processing. SubmitTime *time.Time - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt data on the storage volume attached to the ML compute instance(s) that - // process the analysis job. The VolumeKmsKeyId can be either of the following - // formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt data on the storage volume attached to the ML compute + // instance(s) that process the analysis job. The VolumeKmsKeyId can be either of + // the following formats: // // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * + // Amazon Resource Name (ARN) of a KMS Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" VolumeKmsKeyId *string @@ -1166,9 +1167,9 @@ type EndpointProperties struct { // The number of inference units currently used by the model using this endpoint. CurrentInferenceUnits *int32 - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to trained custom models - // encrypted with a customer managed key (ModelKmsKeyId). + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to trained custom models encrypted with a customer managed key + // (ModelKmsKeyId). DataAccessRoleArn *string // Data access role ARN to use in case the new model is encrypted with a customer @@ -1234,8 +1235,8 @@ type EntitiesDetectionJobFilter struct { // Provides information about an entities detection job. type EntitiesDetectionJobProperties struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. DataAccessRoleArn *string // The time that the entities detection job completed @@ -1244,14 +1245,18 @@ type EntitiesDetectionJobProperties struct { // The Amazon Resource Name (ARN) that identifies the entity recognizer. EntityRecognizerArn *string + // The Amazon Resource Name (ARN) of the flywheel associated with this job. + FlywheelArn *string + // The input data configuration that you supplied when you created the entities // detection job. InputDataConfig *InputDataConfig // The Amazon Resource Name (ARN) of the entities detection job. It is a unique, - // fully qualified identifier for the job. It includes the AWS account, Region, and - // the job ID. The format of the ARN is as follows: - // arn::comprehend:::entities-detection-job/ The following is an example job ARN: + // fully qualified identifier for the job. It includes the Amazon Web Services + // account, Amazon Web Services Region, and the job ID. The format of the ARN is as + // follows: arn::comprehend:::entities-detection-job/ The following is an example + // job ARN: // arn:aws:comprehend:us-west-2:111122223333:entities-detection-job/1234abcd12ab34cd56ef1234567890ab JobArn *string @@ -1278,15 +1283,15 @@ type EntitiesDetectionJobProperties struct { // The time that the entities detection job was submitted for processing. SubmitTime *time.Time - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt data on the storage volume attached to the ML compute instance(s) that - // process the analysis job. The VolumeKmsKeyId can be either of the following - // formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt data on the storage volume attached to the ML compute + // instance(s) that process the analysis job. The VolumeKmsKeyId can be either of + // the following formats: // // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * + // Amazon Resource Name (ARN) of a KMS Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" VolumeKmsKeyId *string @@ -1359,14 +1364,14 @@ type EntityRecognitionConfig struct { type EntityRecognizerAnnotations struct { // Specifies the Amazon S3 location where the annotations for an entity recognizer - // are located. The URI must be in the same region as the API endpoint that you are + // are located. The URI must be in the same Region as the API endpoint that you are // calling. // // This member is required. S3Uri *string // Specifies the Amazon S3 location where the test annotations for an entity - // recognizer are located. The URI must be in the same region as the API endpoint + // recognizer are located. The URI must be in the same Region as the API endpoint // that you are calling. TestS3Uri *string @@ -1377,7 +1382,7 @@ type EntityRecognizerAnnotations struct { type EntityRecognizerDocuments struct { // Specifies the Amazon S3 location where the training documents for an entity - // recognizer are located. The URI must be in the same region as the API endpoint + // recognizer are located. The URI must be in the same Region as the API endpoint // that you are calling. // // This member is required. @@ -1392,8 +1397,8 @@ type EntityRecognizerDocuments struct { InputFormat InputFormat // Specifies the Amazon S3 location where the test documents for an entity - // recognizer are located. The URI must be in the same AWS Region as the API - // endpoint that you are calling. + // recognizer are located. The URI must be in the same Amazon Web Services Region + // as the API endpoint that you are calling. TestS3Uri *string noSmithyDocumentSerde @@ -1403,7 +1408,7 @@ type EntityRecognizerDocuments struct { type EntityRecognizerEntityList struct { // Specifies the Amazon S3 location where the entity list is located. The URI must - // be in the same region as the API endpoint that you are calling. + // be in the same Region as the API endpoint that you are calling. // // This member is required. S3Uri *string @@ -1562,8 +1567,8 @@ type EntityRecognizerOutputDataConfig struct { // Describes information about an entity recognizer. type EntityRecognizerProperties struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. DataAccessRoleArn *string // The time that the recognizer creation completed. @@ -1585,14 +1590,14 @@ type EntityRecognizerProperties struct { // A description of the status of the recognizer. Message *string - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt trained custom models. The ModelKmsKeyId can be either of the following - // formats: + // ID for the KMS key that Amazon Comprehend uses to encrypt trained custom models. + // The ModelKmsKeyId can be either of the following formats: // - // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" + // * KMS Key ID: + // "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * Amazon Resource Name (ARN) of a KMS + // Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" ModelKmsKeyId *string @@ -1603,8 +1608,8 @@ type EntityRecognizerProperties struct { RecognizerMetadata *EntityRecognizerMetadata // The Amazon Resource Name (ARN) of the source model. This model was imported from - // a different AWS account to create the entity recognizer model in your AWS - // account. + // a different Amazon Web Services account to create the entity recognizer model in + // your Amazon Web Services account. SourceModelArn *string // Provides the status of the entity recognizer. @@ -1622,15 +1627,15 @@ type EntityRecognizerProperties struct { // The version name you assigned to the entity recognizer. VersionName *string - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt data on the storage volume attached to the ML compute instance(s) that - // process the analysis job. The VolumeKmsKeyId can be either of the following - // formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt data on the storage volume attached to the ML compute + // instance(s) that process the analysis job. The VolumeKmsKeyId can be either of + // the following formats: // // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * + // Amazon Resource Name (ARN) of a KMS Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" VolumeKmsKeyId *string @@ -1766,8 +1771,8 @@ type EventsDetectionJobFilter struct { // Provides information about an events detection job. type EventsDetectionJobProperties struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. DataAccessRoleArn *string // The time that the events detection job completed. @@ -1778,9 +1783,10 @@ type EventsDetectionJobProperties struct { InputDataConfig *InputDataConfig // The Amazon Resource Name (ARN) of the events detection job. It is a unique, - // fully qualified identifier for the job. It includes the AWS account, Region, and - // the job ID. The format of the ARN is as follows: - // arn::comprehend:::events-detection-job/ The following is an example job ARN: + // fully qualified identifier for the job. It includes the Amazon Web Services + // account, Amazon Web Services Region, and the job ID. The format of the ARN is as + // follows: arn::comprehend:::events-detection-job/ The following is an example job + // ARN: // arn:aws:comprehend:us-west-2:111122223333:events-detection-job/1234abcd12ab34cd56ef1234567890ab JobArn *string @@ -1919,8 +1925,8 @@ type FlywheelProperties struct { // Creation time of the flywheel. CreationTime *time.Time - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend permission to access the flywheel data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // permission to access the flywheel data. DataAccessRoleArn *string // Amazon S3 URI of the data lake location. @@ -2006,7 +2012,7 @@ type Geometry struct { // applies only to non-text inputs for custom analysis. type InputDataConfig struct { - // The Amazon S3 URI for the input data. The URI must be in same region as the API + // The Amazon S3 URI for the input data. The URI must be in same Region as the API // endpoint that you are calling. The URI can point to a single input file or it // can provide the prefix for a collection of data files. For example, if you use // the URI S3://bucketName/prefix, if the prefix is a single file, Amazon @@ -2104,8 +2110,8 @@ type KeyPhrasesDetectionJobFilter struct { // Provides information about a key phrases detection job. type KeyPhrasesDetectionJobProperties struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. DataAccessRoleArn *string // The time that the key phrases detection job completed. @@ -2116,10 +2122,10 @@ type KeyPhrasesDetectionJobProperties struct { InputDataConfig *InputDataConfig // The Amazon Resource Name (ARN) of the key phrases detection job. It is a unique, - // fully qualified identifier for the job. It includes the AWS account, Region, and - // the job ID. The format of the ARN is as follows: - // arn::comprehend:::key-phrases-detection-job/ The following is an example job - // ARN: + // fully qualified identifier for the job. It includes the Amazon Web Services + // account, Amazon Web Services Region, and the job ID. The format of the ARN is as + // follows: arn::comprehend:::key-phrases-detection-job/ The following is an + // example job ARN: // arn:aws:comprehend:us-west-2:111122223333:key-phrases-detection-job/1234abcd12ab34cd56ef1234567890ab JobArn *string @@ -2146,15 +2152,15 @@ type KeyPhrasesDetectionJobProperties struct { // The time that the key phrases detection job was submitted for processing. SubmitTime *time.Time - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt data on the storage volume attached to the ML compute instance(s) that - // process the analysis job. The VolumeKmsKeyId can be either of the following - // formats: + // ID for the KMS key that Amazon Comprehend uses to encrypt data on the storage + // volume attached to the ML compute instance(s) that process the analysis job. The + // VolumeKmsKeyId can be either of the following formats: // - // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" + // * KMS Key ID: + // "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * Amazon Resource Name (ARN) of a KMS + // Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" VolumeKmsKeyId *string @@ -2187,7 +2193,7 @@ type OutputDataConfig struct { // When you use the OutputDataConfig object with asynchronous operations, you // specify the Amazon S3 location where you want to write the output data. The URI - // must be in the same region as the API endpoint that you are calling. The + // must be in the same Region as the API endpoint that you are calling. The // location is used as the prefix for the actual location of the output file. When // the topic detection job is finished, the service creates an output file in a // directory specific to the job. The S3Uri field contains the location of the @@ -2199,14 +2205,15 @@ type OutputDataConfig struct { // This member is required. S3Uri *string - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt the output results from an analysis job. The KmsKeyId can be one of the - // following formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt the output results from an analysis job. The KmsKeyId + // can be one of the following formats: // - // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" + // * KMS Key ID: + // "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * - // Amazon Resource Name (ARN) of a KMS Key: + // * Amazon Resource Name (ARN) of a KMS + // Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" // // * @@ -2262,8 +2269,8 @@ type PiiEntitiesDetectionJobFilter struct { // Provides information about a PII entities detection job. type PiiEntitiesDetectionJobProperties struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. DataAccessRoleArn *string // The time that the PII entities detection job completed. @@ -2273,10 +2280,10 @@ type PiiEntitiesDetectionJobProperties struct { InputDataConfig *InputDataConfig // The Amazon Resource Name (ARN) of the PII entities detection job. It is a - // unique, fully qualified identifier for the job. It includes the AWS account, - // Region, and the job ID. The format of the ARN is as follows: - // arn::comprehend:::pii-entities-detection-job/ The following is an example job - // ARN: + // unique, fully qualified identifier for the job. It includes the Amazon Web + // Services account, Amazon Web Services Region, and the job ID. The format of the + // ARN is as follows: arn::comprehend:::pii-entities-detection-job/ The following + // is an example job ARN: // arn:aws:comprehend:us-west-2:111122223333:pii-entities-detection-job/1234abcd12ab34cd56ef1234567890ab JobArn *string @@ -2348,8 +2355,8 @@ type PiiOutputDataConfig struct { // This member is required. S3Uri *string - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt the output results from an analysis job. + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt the output results from an analysis job. KmsKeyId *string noSmithyDocumentSerde @@ -2426,8 +2433,8 @@ type SentimentDetectionJobFilter struct { // Provides information about a sentiment detection job. type SentimentDetectionJobProperties struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. DataAccessRoleArn *string // The time that the sentiment detection job ended. @@ -2438,9 +2445,10 @@ type SentimentDetectionJobProperties struct { InputDataConfig *InputDataConfig // The Amazon Resource Name (ARN) of the sentiment detection job. It is a unique, - // fully qualified identifier for the job. It includes the AWS account, Region, and - // the job ID. The format of the ARN is as follows: - // arn::comprehend:::sentiment-detection-job/ The following is an example job ARN: + // fully qualified identifier for the job. It includes the Amazon Web Services + // account, Amazon Web Services Region, and the job ID. The format of the ARN is as + // follows: arn::comprehend:::sentiment-detection-job/ The following is an example + // job ARN: // arn:aws:comprehend:us-west-2:111122223333:sentiment-detection-job/1234abcd12ab34cd56ef1234567890ab JobArn *string @@ -2467,15 +2475,15 @@ type SentimentDetectionJobProperties struct { // The time that the sentiment detection job was submitted for processing. SubmitTime *time.Time - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt data on the storage volume attached to the ML compute instance(s) that - // process the analysis job. The VolumeKmsKeyId can be either of the following - // formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt data on the storage volume attached to the ML compute + // instance(s) that process the analysis job. The VolumeKmsKeyId can be either of + // the following formats: // // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * + // Amazon Resource Name (ARN) of a KMS Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" VolumeKmsKeyId *string @@ -2588,8 +2596,8 @@ type TargetedSentimentDetectionJobFilter struct { // Provides information about a targeted sentiment detection job. type TargetedSentimentDetectionJobProperties struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your input data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your input data. DataAccessRoleArn *string // The time that the targeted sentiment detection job ended. @@ -2600,10 +2608,10 @@ type TargetedSentimentDetectionJobProperties struct { InputDataConfig *InputDataConfig // The Amazon Resource Name (ARN) of the targeted sentiment detection job. It is a - // unique, fully qualified identifier for the job. It includes the AWS account, - // Region, and the job ID. The format of the ARN is as follows: - // arn::comprehend:::targeted-sentiment-detection-job/ The following is an example - // job ARN: + // unique, fully qualified identifier for the job. It includes the Amazon Web + // Services account, Amazon Web Services Region, and the job ID. The format of the + // ARN is as follows: arn::comprehend:::targeted-sentiment-detection-job/ The + // following is an example job ARN: // arn:aws:comprehend:us-west-2:111122223333:targeted-sentiment-detection-job/1234abcd12ab34cd56ef1234567890ab JobArn *string @@ -2745,8 +2753,8 @@ type TopicsDetectionJobFilter struct { // Provides information about a topic detection job. type TopicsDetectionJobProperties struct { - // The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) - // role that grants Amazon Comprehend read access to your job data. + // The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend + // read access to your job data. DataAccessRoleArn *string // The time that the topic detection job was completed. @@ -2756,9 +2764,10 @@ type TopicsDetectionJobProperties struct { InputDataConfig *InputDataConfig // The Amazon Resource Name (ARN) of the topics detection job. It is a unique, - // fully qualified identifier for the job. It includes the AWS account, Region, and - // the job ID. The format of the ARN is as follows: - // arn::comprehend:::topics-detection-job/ The following is an example job ARN: + // fully qualified identifier for the job. It includes the Amazon Web Services + // account, Amazon Web Services Region, and the job ID. The format of the ARN is as + // follows: arn::comprehend:::topics-detection-job/ The following is an example job + // ARN: // arn:aws:comprehend:us-west-2:111122223333:topics-detection-job/1234abcd12ab34cd56ef1234567890ab JobArn *string @@ -2785,15 +2794,15 @@ type TopicsDetectionJobProperties struct { // The time that the topic detection job was submitted for processing. SubmitTime *time.Time - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt data on the storage volume attached to the ML compute instance(s) that - // process the analysis job. The VolumeKmsKeyId can be either of the following - // formats: + // ID for the Amazon Web Services Key Management Service (KMS) key that Amazon + // Comprehend uses to encrypt data on the storage volume attached to the ML compute + // instance(s) that process the analysis job. The VolumeKmsKeyId can be either of + // the following formats: // // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * + // Amazon Resource Name (ARN) of a KMS Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" VolumeKmsKeyId *string @@ -2809,14 +2818,14 @@ type TopicsDetectionJobProperties struct { // Data security configuration. type UpdateDataSecurityConfig struct { - // ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to - // encrypt trained custom models. The ModelKmsKeyId can be either of the following - // formats: + // ID for the KMS key that Amazon Comprehend uses to encrypt trained custom models. + // The ModelKmsKeyId can be either of the following formats: // - // * KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab" + // * KMS Key ID: + // "1234abcd-12ab-34cd-56ef-1234567890ab" // - // * Amazon - // Resource Name (ARN) of a KMS Key: + // * Amazon Resource Name (ARN) of a KMS + // Key: // "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" ModelKmsKeyId *string @@ -2850,7 +2859,7 @@ type VpcConfig struct { // The ID for each subnet being used in your private VPC. This subnet is a subset // of the a range of IPv4 addresses used by the VPC and is specific to a given - // availability zone in the VPC’s region. This ID number is preceded by "subnet-", + // availability zone in the VPC’s Region. This ID number is preceded by "subnet-", // for instance: "subnet-04ccf456919e69055". For more information, see VPCs and // Subnets (https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html). // diff --git a/service/ivsrealtime/internal/endpoints/endpoints.go b/service/ivsrealtime/internal/endpoints/endpoints.go index a795e9e7083..941be31b706 100644 --- a/service/ivsrealtime/internal/endpoints/endpoints.go +++ b/service/ivsrealtime/internal/endpoints/endpoints.go @@ -134,6 +134,29 @@ var defaultPartitions = endpoints.Partitions{ }, RegionRegex: partitionRegexp.Aws, IsRegionalized: true, + Endpoints: endpoints.Endpoints{ + endpoints.EndpointKey{ + Region: "ap-northeast-1", + }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "ap-northeast-2", + }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "ap-south-1", + }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "eu-central-1", + }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "eu-west-1", + }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "us-east-1", + }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "us-west-2", + }: endpoints.Endpoint{}, + }, }, { ID: "aws-cn", diff --git a/service/rds/api_op_CreateDBCluster.go b/service/rds/api_op_CreateDBCluster.go index b5ee888211a..633240d6fac 100644 --- a/service/rds/api_op_CreateDBCluster.go +++ b/service/rds/api_op_CreateDBCluster.go @@ -13,10 +13,16 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// Creates a new Amazon Aurora DB cluster or Multi-AZ DB cluster. 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? +// 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 +// (https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) +// 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? // (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 @@ -61,19 +67,16 @@ type CreateDBClusterInput struct { // The name of the database engine to be used for this DB cluster. Valid Values: // // * - // aurora (for MySQL 5.6-compatible Aurora) - // - // * aurora-mysql (for MySQL - // 5.7-compatible and MySQL 8.0-compatible Aurora) + // aurora-mysql // // * aurora-postgresql // // * mysql // - // * - // postgres + // * postgres // - // Valid for: Aurora DB clusters and Multi-AZ DB clusters + // Valid for: Aurora DB + // clusters and Multi-AZ DB clusters // // This member is required. Engine *string @@ -224,20 +227,13 @@ type CreateDBClusterInput struct { // in the Amazon RDS User Guide. Valid for: Multi-AZ DB clusters only EnablePerformanceInsights *bool - // The DB engine mode of the DB cluster, either provisioned, serverless, - // parallelquery, global, or multimaster. The parallelquery engine mode isn't - // required for Aurora MySQL version 1.23 and higher 1.x versions, and version 2.09 - // and higher 2.x versions. The global engine mode isn't required for Aurora MySQL - // version 1.22 and higher 1.x versions, and global engine mode isn't required for - // any 2.x versions. The multimaster engine mode only applies for DB clusters - // created with Aurora MySQL version 5.6.10a. The serverless engine mode only - // applies for Aurora Serverless v1 DB clusters. For Aurora PostgreSQL, the global - // engine mode isn't required, and both the parallelquery and the multimaster - // engine modes currently aren't supported. Limitations and requirements apply to - // some DB engine modes. For more information, see the following sections in the - // Amazon Aurora User Guide: - // - // * Limitations of Aurora Serverless v1 + // 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: + // + // * + // Limitations of Aurora Serverless v1 // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html#aurora-serverless.limitations) // // * @@ -245,29 +241,24 @@ type CreateDBClusterInput struct { // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.requirements.html) // // * - // Limitations of Parallel Query + // Limitations of parallel query // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-mysql-parallel-query.html#aurora-mysql-parallel-query-limitations) // // * - // Limitations of Aurora Global Databases + // Limitations of Aurora global databases // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database.html#aurora-global-database.limitations) // - // * - // Limitations of Multi-Master Clusters - // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-multi-master.html#aurora-multi-master-limitations) - // // Valid // for: Aurora DB clusters only EngineMode *string // The version number of the database engine to use. 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 MySQL 5.7-compatible and MySQL 8.0-compatible Aurora, 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 + // 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" You can supply + // either 5.7 or 8.0 to use the default engine version for Aurora MySQL version 2 + // or version 3, respectively. 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 @@ -275,17 +266,16 @@ type CreateDBClusterInput struct { // "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" Aurora MySQL For information, see MySQL on - // Amazon RDS Versions + // "DBEngineVersions[].EngineVersion" Aurora MySQL For information, see Database + // engine updates for Amazon Aurora MySQL // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Updates.html) // in the Amazon Aurora User Guide. Aurora PostgreSQL For information, see Amazon // Aurora PostgreSQL releases and engine versions // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Updates.20180305.html) - // in the Amazon Aurora User Guide. MySQL For information, see MySQL on Amazon RDS - // Versions + // in the Amazon Aurora User Guide. MySQL For information, see Amazon RDS for MySQL // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt) // in the Amazon RDS User Guide. PostgreSQL For information, see Amazon RDS for - // PostgreSQL versions and extensions + // PostgreSQL // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts) // in the Amazon RDS User Guide. Valid for: Aurora DB clusters and Multi-AZ DB // clusters @@ -297,7 +287,7 @@ type CreateDBClusterInput struct { // The amount of Provisioned IOPS (input/output operations per second) to be // initially allocated for each DB instance in the Multi-AZ DB cluster. For - // information about valid IOPS values, see Amazon RDS Provisioned IOPS storage + // information about valid IOPS values, see Provisioned IOPS storage // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#USER_PIOPS) // in the Amazon RDS User Guide. This setting is required to create a Multi-AZ DB // cluster. Constraints: Must be a multiple between .5 and 50 of the storage amount diff --git a/service/rds/api_op_DescribeDBEngineVersions.go b/service/rds/api_op_DescribeDBEngineVersions.go index b60f2dc0805..d207c28f28f 100644 --- a/service/rds/api_op_DescribeDBEngineVersions.go +++ b/service/rds/api_op_DescribeDBEngineVersions.go @@ -42,37 +42,35 @@ type DescribeDBEngineVersionsInput struct { // The database engine to return. Valid Values: // - // * aurora (for MySQL 5.6-compatible - // Aurora) - // - // * aurora-mysql (for MySQL 5.7-compatible and MySQL 8.0-compatible - // Aurora) + // * aurora-mysql (for MySQL + // 5.7-compatible and MySQL 8.0-compatible Aurora) // // * aurora-postgresql // - // * mariadb + // * + // mariadb // // * mysql // // * oracle-ee // - // * - // oracle-ee-cdb + // * oracle-ee-cdb // // * oracle-se2 // - // * oracle-se2-cdb + // * + // oracle-se2-cdb // // * postgres // // * sqlserver-ee // - // * - // sqlserver-se + // * sqlserver-se // // * sqlserver-ex // - // * sqlserver-web + // * + // sqlserver-web Engine *string // The database engine version to return. Example: 5.1.49 diff --git a/service/rds/api_op_DescribeOrderableDBInstanceOptions.go b/service/rds/api_op_DescribeOrderableDBInstanceOptions.go index e40e3a8aad4..c888d2a5f66 100644 --- a/service/rds/api_op_DescribeOrderableDBInstanceOptions.go +++ b/service/rds/api_op_DescribeOrderableDBInstanceOptions.go @@ -34,15 +34,12 @@ type DescribeOrderableDBInstanceOptionsInput struct { // The name of the engine to retrieve DB instance options for. Valid Values: // // * - // aurora (for MySQL 5.6-compatible Aurora) - // - // * aurora-mysql (for MySQL - // 5.7-compatible and MySQL 8.0-compatible Aurora) - // - // * aurora-postgresql + // aurora-mysql (for MySQL 5.7-compatible and MySQL 8.0-compatible Aurora) // // * - // mariadb + // aurora-postgresql + // + // * mariadb // // * mysql // @@ -50,10 +47,10 @@ type DescribeOrderableDBInstanceOptionsInput struct { // // * oracle-ee-cdb // - // * oracle-se2 - // // * - // oracle-se2-cdb + // oracle-se2 + // + // * oracle-se2-cdb // // * postgres // @@ -61,10 +58,10 @@ type DescribeOrderableDBInstanceOptionsInput struct { // // * sqlserver-se // - // * sqlserver-ex - // // * - // sqlserver-web + // sqlserver-ex + // + // * sqlserver-web // // This member is required. Engine *string diff --git a/service/rds/api_op_ModifyDBCluster.go b/service/rds/api_op_ModifyDBCluster.go index e963b5f8531..b305e30511c 100644 --- a/service/rds/api_op_ModifyDBCluster.go +++ b/service/rds/api_op_ModifyDBCluster.go @@ -196,11 +196,9 @@ type ModifyDBClusterInput struct { // 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 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 MySQL 5.7-compatible and MySQL 8.0-compatible Aurora, use the following - // command: aws rds describe-db-engine-versions --engine aurora-mysql --query + // 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 diff --git a/service/rds/api_op_RestoreDBClusterFromS3.go b/service/rds/api_op_RestoreDBClusterFromS3.go index f2659d8c717..9cbf6d7818c 100644 --- a/service/rds/api_op_RestoreDBClusterFromS3.go +++ b/service/rds/api_op_RestoreDBClusterFromS3.go @@ -61,8 +61,7 @@ type RestoreDBClusterFromS3Input struct { DBClusterIdentifier *string // The name of the database engine to be used for this DB cluster. Valid Values: - // aurora (for MySQL 5.6-compatible Aurora) and aurora-mysql (for MySQL - // 5.7-compatible and MySQL 8.0-compatible Aurora) + // aurora-mysql (for MySQL 5.7-compatible and MySQL 8.0-compatible Aurora) // // This member is required. Engine *string @@ -166,9 +165,9 @@ type RestoreDBClusterFromS3Input struct { // The list of logs that the restored DB cluster is to export to CloudWatch Logs. // The values in the list depend on the DB engine being used. Aurora MySQL Possible - // values are audit, error, general, and slowquery. Aurora PostgreSQL Possible - // value is postgresql. For more information about exporting CloudWatch Logs for - // Amazon Aurora, see Publishing Database Logs to Amazon CloudWatch Logs + // values are audit, error, general, and slowquery. For more information about + // exporting CloudWatch Logs for Amazon Aurora, see Publishing Database Logs to + // Amazon CloudWatch Logs // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch) // in the Amazon Aurora User Guide. EnableCloudwatchLogsExports []string @@ -181,13 +180,10 @@ type RestoreDBClusterFromS3Input struct { EnableIAMDatabaseAuthentication *bool // The version number of the database engine to use. To list all of the available - // engine versions for aurora (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-mysql (for MySQL 5.7-compatible and MySQL 8.0-compatible Aurora), use - // the following command: aws rds describe-db-engine-versions --engine aurora-mysql - // --query "DBEngineVersions[].EngineVersion" Aurora MySQL Example: 5.6.10a, - // 5.6.mysql_aurora.1.19.2, 5.7.mysql_aurora.2.07.1, 8.0.mysql_aurora.3.02.0 + // engine versions for aurora-mysql (MySQL 5.7-compatible and MySQL 8.0-compatible + // Aurora), use the following command: aws rds describe-db-engine-versions --engine + // aurora-mysql --query "DBEngineVersions[].EngineVersion" Aurora MySQL Examples: + // 5.7.mysql_aurora.2.07.1, 8.0.mysql_aurora.3.02.0 EngineVersion *string // The Amazon Web Services KMS key identifier for an encrypted DB cluster. The diff --git a/service/rds/api_op_RestoreDBClusterFromSnapshot.go b/service/rds/api_op_RestoreDBClusterFromSnapshot.go index 39e723648d3..bafa1d58fcb 100644 --- a/service/rds/api_op_RestoreDBClusterFromSnapshot.go +++ b/service/rds/api_op_RestoreDBClusterFromSnapshot.go @@ -183,10 +183,9 @@ type RestoreDBClusterFromSnapshotInput struct { // Valid for: Aurora DB clusters only EngineMode *string - // The version of the database engine to use for the new DB cluster. 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 + // The version of the database engine to use for the new DB cluster. If you don't + // specify an engine version, the default version for the database engine in the + // Amazon Web Services Region is used. To list all of the available engine versions // for MySQL 5.7-compatible and MySQL 8.0-compatible Aurora, use the following // command: aws rds describe-db-engine-versions --engine aurora-mysql --query // "DBEngineVersions[].EngineVersion" To list all of the available engine versions @@ -198,12 +197,13 @@ type RestoreDBClusterFromSnapshotInput struct { // "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" Aurora MySQL See MySQL on Amazon RDS Versions + // "DBEngineVersions[].EngineVersion" Aurora MySQL See Database engine updates for + // Amazon Aurora MySQL // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Updates.html) // in the Amazon Aurora User Guide. Aurora PostgreSQL See Amazon Aurora PostgreSQL // releases and engine versions // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Updates.20180305.html) - // in the Amazon Aurora User Guide. MySQL See MySQL on Amazon RDS Versions + // in the Amazon Aurora User Guide. MySQL See Amazon RDS for MySQL // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt) // in the Amazon RDS User Guide. PostgreSQL See Amazon RDS for PostgreSQL versions // and extensions diff --git a/service/rds/api_op_StartExportTask.go b/service/rds/api_op_StartExportTask.go index dee2d303a0d..63f148e4420 100644 --- a/service/rds/api_op_StartExportTask.go +++ b/service/rds/api_op_StartExportTask.go @@ -19,10 +19,10 @@ import ( // snapshot data to Amazon S3 // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.html) // in the Amazon RDS User Guide or Exporting DB cluster snapshot data to Amazon S3 -// (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/aurora-export-snapshot.html) +// (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-export-snapshot.html) // in the Amazon Aurora User Guide. For more information on exporting DB cluster // data, see Exporting DB cluster data to Amazon S3 -// (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/export-cluster-data.html) +// (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/export-cluster-data.html) // in the Amazon Aurora User Guide. func (c *Client) StartExportTask(ctx context.Context, params *StartExportTaskInput, optFns ...func(*Options)) (*StartExportTaskOutput, error) { if params == nil { @@ -48,7 +48,30 @@ type StartExportTaskInput struct { ExportTaskIdentifier *string // The name of the IAM role to use for writing to the Amazon S3 bucket when - // exporting a snapshot or cluster. + // exporting a snapshot or cluster. In the IAM policy attached to your IAM role, + // include the following required actions to allow the transfer of files from + // Amazon RDS or Amazon Aurora to an S3 bucket: + // + // * s3:PutObject* + // + // * + // s3:GetObject* + // + // * s3:ListBucket + // + // * s3:DeleteObject* + // + // * s3:GetBucketLocation + // + // In + // the policy, include the resources to identify the S3 bucket and objects in the + // bucket. The following list of resources shows the Amazon Resource Name (ARN) + // format for accessing S3: + // + // * arn:aws:s3:::your-s3-bucket + // + // * + // arn:aws:s3:::your-s3-bucket/* // // This member is required. IamRoleArn *string diff --git a/service/rds/deserializers.go b/service/rds/deserializers.go index 19b450b7813..6db91e3c2ef 100644 --- a/service/rds/deserializers.go +++ b/service/rds/deserializers.go @@ -1660,6 +1660,9 @@ func awsAwsquery_deserializeOpErrorCreateCustomDBEngineVersion(response *smithyh } errorBody.Seek(0, io.SeekStart) switch { + case strings.EqualFold("CreateCustomDBEngineVersionFault", errorCode): + return awsAwsquery_deserializeErrorCreateCustomDBEngineVersionFault(response, errorBody) + case strings.EqualFold("CustomDBEngineVersionAlreadyExistsFault", errorCode): return awsAwsquery_deserializeErrorCustomDBEngineVersionAlreadyExistsFault(response, errorBody) @@ -16449,6 +16452,50 @@ func awsAwsquery_deserializeErrorCertificateNotFoundFault(response *smithyhttp.R return output } +func awsAwsquery_deserializeErrorCreateCustomDBEngineVersionFault(response *smithyhttp.Response, errorBody *bytes.Reader) error { + output := &types.CreateCustomDBEngineVersionFault{} + var buff [1024]byte + ringBuffer := smithyio.NewRingBuffer(buff[:]) + body := io.TeeReader(errorBody, ringBuffer) + rootDecoder := xml.NewDecoder(body) + t, err := smithyxml.FetchRootElement(rootDecoder) + if err == io.EOF { + return output + } + if err != nil { + var snapshot bytes.Buffer + io.Copy(&snapshot, ringBuffer) + return &smithy.DeserializationError{ + Err: fmt.Errorf("failed to decode response body, %w", err), + Snapshot: snapshot.Bytes(), + } + } + + decoder := smithyxml.WrapNodeDecoder(rootDecoder, t) + t, err = decoder.GetElement("Error") + if err != nil { + var snapshot bytes.Buffer + io.Copy(&snapshot, ringBuffer) + return &smithy.DeserializationError{ + Err: fmt.Errorf("failed to decode response body, %w", err), + Snapshot: snapshot.Bytes(), + } + } + + decoder = smithyxml.WrapNodeDecoder(decoder.Decoder, t) + err = awsAwsquery_deserializeDocumentCreateCustomDBEngineVersionFault(&output, decoder) + if err != nil { + var snapshot bytes.Buffer + io.Copy(&snapshot, ringBuffer) + return &smithy.DeserializationError{ + Err: fmt.Errorf("failed to decode response body, %w", err), + Snapshot: snapshot.Bytes(), + } + } + + return output +} + func awsAwsquery_deserializeErrorCustomAvailabilityZoneNotFoundFault(response *smithyhttp.Response, errorBody *bytes.Reader) error { output := &types.CustomAvailabilityZoneNotFoundFault{} var buff [1024]byte @@ -23640,6 +23687,55 @@ func awsAwsquery_deserializeDocumentConnectionPoolConfigurationInfo(v **types.Co return nil } +func awsAwsquery_deserializeDocumentCreateCustomDBEngineVersionFault(v **types.CreateCustomDBEngineVersionFault, decoder smithyxml.NodeDecoder) error { + if v == nil { + return fmt.Errorf("unexpected nil of type %T", v) + } + var sv *types.CreateCustomDBEngineVersionFault + if *v == nil { + sv = &types.CreateCustomDBEngineVersionFault{} + } else { + sv = *v + } + + for { + t, done, err := decoder.Token() + if err != nil { + return err + } + if done { + break + } + originalDecoder := decoder + decoder = smithyxml.WrapNodeDecoder(originalDecoder.Decoder, t) + switch { + case strings.EqualFold("message", t.Name.Local): + val, err := decoder.Value() + if err != nil { + return err + } + if val == nil { + break + } + { + xtv := string(val) + sv.Message = ptr.String(xtv) + } + + default: + // Do nothing and ignore the unexpected tag element + err = decoder.Decoder.Skip() + if err != nil { + return err + } + + } + decoder = originalDecoder + } + *v = sv + return nil +} + func awsAwsquery_deserializeDocumentCustomAvailabilityZoneNotFoundFault(v **types.CustomAvailabilityZoneNotFoundFault, decoder smithyxml.NodeDecoder) error { if v == nil { return fmt.Errorf("unexpected nil of type %T", v) diff --git a/service/rds/types/errors.go b/service/rds/types/errors.go index 91353c40497..c0a5132c114 100644 --- a/service/rds/types/errors.go +++ b/service/rds/types/errors.go @@ -194,6 +194,32 @@ func (e *CertificateNotFoundFault) ErrorCode() string { } func (e *CertificateNotFoundFault) ErrorFault() smithy.ErrorFault { return smithy.FaultClient } +// An error occurred while trying to create the CEV. +type CreateCustomDBEngineVersionFault struct { + Message *string + + ErrorCodeOverride *string + + noSmithyDocumentSerde +} + +func (e *CreateCustomDBEngineVersionFault) Error() string { + return fmt.Sprintf("%s: %s", e.ErrorCode(), e.ErrorMessage()) +} +func (e *CreateCustomDBEngineVersionFault) ErrorMessage() string { + if e.Message == nil { + return "" + } + return *e.Message +} +func (e *CreateCustomDBEngineVersionFault) ErrorCode() string { + if e == nil || e.ErrorCodeOverride == nil { + return "CreateCustomDBEngineVersionFault" + } + return *e.ErrorCodeOverride +} +func (e *CreateCustomDBEngineVersionFault) ErrorFault() smithy.ErrorFault { return smithy.FaultClient } + // CustomAvailabilityZoneId doesn't refer to an existing custom Availability Zone // identifier. type CustomAvailabilityZoneNotFoundFault struct { diff --git a/service/rds/types/types.go b/service/rds/types/types.go index 7710a2a7d3b..32895bcaa58 100644 --- a/service/rds/types/types.go +++ b/service/rds/types/types.go @@ -2796,8 +2796,7 @@ type GlobalCluster struct { // the unique key that identifies a global database cluster. GlobalClusterIdentifier *string - // The list of cluster IDs for secondary clusters within the global database - // cluster. Currently limited to 1 item. + // The list of primary and secondary clusters within the global database cluster. GlobalClusterMembers []GlobalClusterMember // The Amazon Web Services Region-unique, immutable identifier for the global @@ -3871,7 +3870,7 @@ type Subnet struct { // Contains the details about a blue/green deployment. For more information, see // Using Amazon RDS Blue/Green Deployments for database updates // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/blue-green-deployments.html) -// in the Amazon RDS User Guide and Using Amazon RDS Blue/Green Deployments for +// in the Amazon RDS User Guide and Using Amazon RDS Blue/Green Deployments for // database updates // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html) // in the Amazon Aurora User Guide. @@ -3883,19 +3882,24 @@ type SwitchoverDetail struct { // The switchover status of a resource in a blue/green deployment. Values: // // * - // preparing-for-switchover - The resource is being prepared to switch over. + // PROVISIONING - The resource is being prepared to switch over. // - // * - // ready-for-switchover - The resource is ready to switch over. + // * AVAILABLE - The + // resource is ready to switch over. // - // * - // switchover-in-progress - The resource is being switched over. + // * SWITCHOVER_IN_PROGRESS - The resource is + // being switched over. // - // * - // switchover-completed - The resource has been switched over. + // * SWITCHOVER_COMPLETED - The resource has been switched + // over. // - // * switchover-failed - // - The resource attempted to switch over but failed. + // * SWITCHOVER_FAILED - The resource attempted to switch over but + // failed. + // + // * MISSING_SOURCE - The source resource has been deleted. + // + // * + // MISSING_TARGET - The target resource has been deleted. Status *string // The Amazon Resource Name (ARN) of a resource in the green environment.