From c3c141facd56e3da4c0db23e12cf9f6cfcdb8b19 Mon Sep 17 00:00:00 2001 From: aws-sdk-go-automation <43143561+aws-sdk-go-automation@users.noreply.github.com> Date: Thu, 7 Apr 2022 11:21:25 -0700 Subject: [PATCH] Release v1.43.35 (#4356) Release v1.43.35 (2022-04-07) === ### Service Client Updates * `service/apigateway`: Updates service paginators * ApiGateway CLI command get-usage now includes usagePlanId, startDate, and endDate fields in the output to match documentation. * `service/docdb`: Updates service API and documentation * Added support to enable/disable performance insights when creating or modifying db instances * `service/eventbridge`: Updates service API and documentation * `service/personalize`: Updates service API and documentation * `service/pi`: Updates service documentation * `service/sagemaker`: Updates service API * Amazon Sagemaker Notebook Instances now supports G5 instance types --- CHANGELOG.md | 14 + aws/version.go | 2 +- .../apigateway/2015-07-09/paginators-1.json | 5 + models/apis/docdb/2014-10-31/api-2.json | 8 +- models/apis/docdb/2014-10-31/docs-2.json | 74 +- models/apis/eventbridge/2015-10-07/api-2.json | 355 ++- .../apis/eventbridge/2015-10-07/docs-2.json | 250 +- models/apis/personalize/2018-05-22/api-2.json | 211 +- .../apis/personalize/2018-05-22/docs-2.json | 232 +- models/apis/pi/2018-02-27/docs-2.json | 52 +- models/apis/sagemaker/2017-07-24/api-2.json | 10 +- private/model/api/customization_passes.go | 49 + service/docdb/api.go | 289 ++- service/eventbridge/api.go | 2051 ++++++++++++++++- .../eventbridge/eventbridgeiface/interface.go | 20 + service/personalize/api.go | 1327 +++++++++-- service/personalize/errors.go | 15 + .../personalize/personalizeiface/interface.go | 12 + service/pi/api.go | 266 ++- service/pi/doc.go | 7 +- service/sagemaker/api.go | 32 + 21 files changed, 4646 insertions(+), 635 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index b0ca11080fe..790f5e02ef2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,17 @@ +Release v1.43.35 (2022-04-07) +=== + +### Service Client Updates +* `service/apigateway`: Updates service paginators + * ApiGateway CLI command get-usage now includes usagePlanId, startDate, and endDate fields in the output to match documentation. +* `service/docdb`: Updates service API and documentation + * Added support to enable/disable performance insights when creating or modifying db instances +* `service/eventbridge`: Updates service API and documentation +* `service/personalize`: Updates service API and documentation +* `service/pi`: Updates service documentation +* `service/sagemaker`: Updates service API + * Amazon Sagemaker Notebook Instances now supports G5 instance types + Release v1.43.34 (2022-04-06) === diff --git a/aws/version.go b/aws/version.go index 3ec894aafe3..008f41933e4 100644 --- a/aws/version.go +++ b/aws/version.go @@ -5,4 +5,4 @@ package aws const SDKName = "aws-sdk-go" // SDKVersion is the version of this SDK -const SDKVersion = "1.43.34" +const SDKVersion = "1.43.35" diff --git a/models/apis/apigateway/2015-07-09/paginators-1.json b/models/apis/apigateway/2015-07-09/paginators-1.json index a095aef737d..d54943e63c9 100644 --- a/models/apis/apigateway/2015-07-09/paginators-1.json +++ b/models/apis/apigateway/2015-07-09/paginators-1.json @@ -51,6 +51,11 @@ "GetUsage": { "input_token": "position", "limit_key": "limit", + "non_aggregate_keys": [ + "usagePlanId", + "startDate", + "endDate" + ], "output_token": "position", "result_key": "items" }, diff --git a/models/apis/docdb/2014-10-31/api-2.json b/models/apis/docdb/2014-10-31/api-2.json index a90de12ce5f..958a61699cc 100644 --- a/models/apis/docdb/2014-10-31/api-2.json +++ b/models/apis/docdb/2014-10-31/api-2.json @@ -1202,7 +1202,9 @@ "AutoMinorVersionUpgrade":{"shape":"BooleanOptional"}, "Tags":{"shape":"TagList"}, "DBClusterIdentifier":{"shape":"String"}, - "PromotionTier":{"shape":"IntegerOptional"} + "PromotionTier":{"shape":"IntegerOptional"}, + "EnablePerformanceInsights":{"shape":"BooleanOptional"}, + "PerformanceInsightsKMSKeyId":{"shape":"String"} } }, "CreateDBInstanceResult":{ @@ -2556,7 +2558,9 @@ "AutoMinorVersionUpgrade":{"shape":"BooleanOptional"}, "NewDBInstanceIdentifier":{"shape":"String"}, "CACertificateIdentifier":{"shape":"String"}, - "PromotionTier":{"shape":"IntegerOptional"} + "PromotionTier":{"shape":"IntegerOptional"}, + "EnablePerformanceInsights":{"shape":"BooleanOptional"}, + "PerformanceInsightsKMSKeyId":{"shape":"String"} } }, "ModifyDBInstanceResult":{ diff --git a/models/apis/docdb/2014-10-31/docs-2.json b/models/apis/docdb/2014-10-31/docs-2.json index f9c6cc6f789..8093117c078 100644 --- a/models/apis/docdb/2014-10-31/docs-2.json +++ b/models/apis/docdb/2014-10-31/docs-2.json @@ -6,14 +6,14 @@ "AddTagsToResource": "

Adds metadata tags to an Amazon DocumentDB resource. You can use these tags with cost allocation reporting to track costs that are associated with Amazon DocumentDB resources or in a Condition statement in an Identity and Access Management (IAM) policy for Amazon DocumentDB.

", "ApplyPendingMaintenanceAction": "

Applies a pending maintenance action to a resource (for example, to an Amazon DocumentDB instance).

", "CopyDBClusterParameterGroup": "

Copies the specified cluster parameter group.

", - "CopyDBClusterSnapshot": "

Copies a snapshot of a cluster.

To copy a cluster snapshot from a shared manual cluster snapshot, SourceDBClusterSnapshotIdentifier must be the Amazon Resource Name (ARN) of the shared cluster snapshot. You can only copy a shared DB cluster snapshot, whether encrypted or not, in the same Region.

To cancel the copy operation after it is in progress, delete the target cluster snapshot identified by TargetDBClusterSnapshotIdentifier while that cluster snapshot is in the copying status.

", + "CopyDBClusterSnapshot": "

Copies a snapshot of a cluster.

To copy a cluster snapshot from a shared manual cluster snapshot, SourceDBClusterSnapshotIdentifier must be the Amazon Resource Name (ARN) of the shared cluster snapshot. You can only copy a shared DB cluster snapshot, whether encrypted or not, in the same Amazon Web Services Region.

To cancel the copy operation after it is in progress, delete the target cluster snapshot identified by TargetDBClusterSnapshotIdentifier while that cluster snapshot is in the copying status.

", "CreateDBCluster": "

Creates a new Amazon DocumentDB cluster.

", "CreateDBClusterParameterGroup": "

Creates a new cluster parameter group.

Parameters in a cluster parameter group apply to all of the instances in a cluster.

A cluster parameter group is initially created with the default parameters for the database engine used by instances in the cluster. In Amazon DocumentDB, you cannot make modifications directly to the default.docdb3.6 cluster parameter group. If your Amazon DocumentDB cluster is using the default cluster parameter group and you want to modify a value in it, you must first create a new parameter group or copy an existing parameter group, modify it, and then apply the modified parameter group to your cluster. For the new cluster parameter group and associated settings to take effect, you must then reboot the instances in the cluster without failover. For more information, see Modifying Amazon DocumentDB Cluster Parameter Groups.

", "CreateDBClusterSnapshot": "

Creates a snapshot of a cluster.

", "CreateDBInstance": "

Creates a new instance.

", - "CreateDBSubnetGroup": "

Creates a new subnet group. subnet groups must contain at least one subnet in at least two Availability Zones in the Region.

", + "CreateDBSubnetGroup": "

Creates a new subnet group. subnet groups must contain at least one subnet in at least two Availability Zones in the Amazon Web Services Region.

", "CreateEventSubscription": "

Creates an Amazon DocumentDB event notification subscription. This action requires a topic Amazon Resource Name (ARN) created by using the Amazon DocumentDB console, the Amazon SNS console, or the Amazon SNS API. To obtain an ARN with Amazon SNS, you must create a topic in Amazon SNS and subscribe to the topic. The ARN is displayed in the Amazon SNS console.

You can specify the type of source (SourceType) that you want to be notified of. You can also provide a list of Amazon DocumentDB sources (SourceIds) that trigger the events, and you can provide a list of event categories (EventCategories) for events that you want to be notified of. For example, you can specify SourceType = db-instance, SourceIds = mydbinstance1, mydbinstance2 and EventCategories = Availability, Backup.

If you specify both the SourceType and SourceIds (such as SourceType = db-instance and SourceIdentifier = myDBInstance1), you are notified of all the db-instance events for the specified source. If you specify a SourceType but do not specify a SourceIdentifier, you receive notice of the events for that source type for all your Amazon DocumentDB sources. If you do not specify either the SourceType or the SourceIdentifier, you are notified of events generated from all Amazon DocumentDB sources belonging to your customer account.

", - "CreateGlobalCluster": "

Creates an Amazon DocumentDB global cluster that can span multiple multiple Regions. The global cluster contains one primary cluster with read-write capability, and up-to give read-only secondary clusters. Global clusters uses storage-based fast replication across regions with latencies less than one second, using dedicated infrastructure with no impact to your workload’s performance.

You can create a global cluster that is initially empty, and then add a primary and a secondary to it. Or you can specify an existing cluster during the create operation, and this cluster becomes the primary of the global cluster.

This action only applies to Amazon DocumentDB clusters.

", + "CreateGlobalCluster": "

Creates an Amazon DocumentDB global cluster that can span multiple multiple Amazon Web Services Regions. The global cluster contains one primary cluster with read-write capability, and up-to give read-only secondary clusters. Global clusters uses storage-based fast replication across regions with latencies less than one second, using dedicated infrastructure with no impact to your workload’s performance.

You can create a global cluster that is initially empty, and then add a primary and a secondary to it. Or you can specify an existing cluster during the create operation, and this cluster becomes the primary of the global cluster.

This action only applies to Amazon DocumentDB clusters.

", "DeleteDBCluster": "

Deletes a previously provisioned cluster. When you delete a cluster, all automated backups for that cluster are deleted and can't be recovered. Manual DB cluster snapshots of the specified cluster are not deleted.

", "DeleteDBClusterParameterGroup": "

Deletes a specified cluster parameter group. The cluster parameter group to be deleted can't be associated with any clusters.

", "DeleteDBClusterSnapshot": "

Deletes a cluster snapshot. If the snapshot is being copied, the copy operation is terminated.

The cluster snapshot must be in the available state to be deleted.

", @@ -21,10 +21,10 @@ "DeleteDBSubnetGroup": "

Deletes a subnet group.

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

", "DeleteEventSubscription": "

Deletes an Amazon DocumentDB event notification subscription.

", "DeleteGlobalCluster": "

Deletes a global cluster. The primary and secondary clusters must already be detached or deleted before attempting to delete a global cluster.

This action only applies to Amazon DocumentDB clusters.

", - "DescribeCertificates": "

Returns a list of certificate authority (CA) certificates provided by Amazon DocumentDB for this account.

", + "DescribeCertificates": "

Returns a list of certificate authority (CA) certificates provided by Amazon DocumentDB for this Amazon Web Services account.

", "DescribeDBClusterParameterGroups": "

Returns a list of DBClusterParameterGroup descriptions. If a DBClusterParameterGroupName parameter is specified, the list contains only the description of the specified cluster parameter group.

", "DescribeDBClusterParameters": "

Returns the detailed parameter list for a particular cluster parameter group.

", - "DescribeDBClusterSnapshotAttributes": "

Returns a list of cluster snapshot attribute names and values for a manual DB cluster snapshot.

When you share snapshots with other accounts, DescribeDBClusterSnapshotAttributes returns the restore attribute and a list of IDs for the accounts that are authorized to copy or restore the manual cluster snapshot. If all is included in the list of values for the restore attribute, then the manual cluster snapshot is public and can be copied or restored by all accounts.

", + "DescribeDBClusterSnapshotAttributes": "

Returns a list of cluster snapshot attribute names and values for a manual DB cluster snapshot.

When you share snapshots with other Amazon Web Services accounts, DescribeDBClusterSnapshotAttributes returns the restore attribute and a list of IDs for the Amazon Web Services accounts that are authorized to copy or restore the manual cluster snapshot. If all is included in the list of values for the restore attribute, then the manual cluster snapshot is public and can be copied or restored by all Amazon Web Services accounts.

", "DescribeDBClusterSnapshots": "

Returns information about cluster snapshots. This API operation supports pagination.

", "DescribeDBClusters": "

Returns information about provisioned Amazon DocumentDB clusters. This API operation supports pagination. For certain management features such as cluster and instance lifecycle management, Amazon DocumentDB leverages operational technology that is shared with Amazon RDS and Amazon Neptune. Use the filterName=engine,Values=docdb filter parameter to return only Amazon DocumentDB clusters.

", "DescribeDBEngineVersions": "

Returns a list of the available engines.

", @@ -41,9 +41,9 @@ "ListTagsForResource": "

Lists all tags on an Amazon DocumentDB resource.

", "ModifyDBCluster": "

Modifies a setting for an Amazon DocumentDB cluster. You can change one or more database configuration parameters by specifying these parameters and the new values in the request.

", "ModifyDBClusterParameterGroup": "

Modifies the parameters of a cluster parameter group. To modify more than one parameter, submit a list of the following: ParameterName, ParameterValue, and ApplyMethod. A maximum of 20 parameters can be modified in a single request.

Changes to dynamic parameters are applied immediately. Changes to static parameters require a reboot or maintenance window before the change can take effect.

After you create a cluster parameter group, you should wait at least 5 minutes before creating your first cluster that uses that cluster parameter group as the default parameter group. This allows Amazon DocumentDB to fully complete the create action before the parameter group is used as the default for a new cluster. This step is especially important for parameters that are critical when creating the default database for a cluster, such as the character set for the default database defined by the character_set_database parameter.

", - "ModifyDBClusterSnapshotAttribute": "

Adds an attribute and values to, or removes an attribute and values from, a manual cluster snapshot.

To share a manual cluster snapshot with other accounts, specify restore as the AttributeName, and use the ValuesToAdd parameter to add a list of IDs of the accounts that are authorized to restore the manual cluster snapshot. Use the value all to make the manual cluster snapshot public, which means that it can be copied or restored by all accounts. Do not add the all value for any manual cluster snapshots that contain private information that you don't want available to all accounts. If a manual cluster snapshot is encrypted, it can be shared, but only by specifying a list of authorized account IDs for the ValuesToAdd parameter. You can't use all as a value for that parameter in this case.

", + "ModifyDBClusterSnapshotAttribute": "

Adds an attribute and values to, or removes an attribute and values from, a manual cluster snapshot.

To share a manual cluster snapshot with other Amazon Web Services accounts, specify restore as the AttributeName, and use the ValuesToAdd parameter to add a list of IDs of the Amazon Web Services accounts that are authorized to restore the manual cluster snapshot. Use the value all to make the manual cluster snapshot public, which means that it can be copied or restored by all Amazon Web Services accounts. Do not add the all value for any manual cluster snapshots that contain private information that you don't want available to all Amazon Web Services accounts. If a manual cluster snapshot is encrypted, it can be shared, but only by specifying a list of authorized Amazon Web Services account IDs for the ValuesToAdd parameter. You can't use all as a value for that parameter in this case.

", "ModifyDBInstance": "

Modifies settings for an instance. You can change one or more database configuration parameters by specifying these parameters and the new values in the request.

", - "ModifyDBSubnetGroup": "

Modifies an existing subnet group. subnet groups must contain at least one subnet in at least two Availability Zones in the Region.

", + "ModifyDBSubnetGroup": "

Modifies an existing subnet group. subnet groups must contain at least one subnet in at least two Availability Zones in the Amazon Web Services Region.

", "ModifyEventSubscription": "

Modifies an existing Amazon DocumentDB event notification subscription.

", "ModifyGlobalCluster": "

Modify a setting for an Amazon DocumentDB global cluster. You can change one or more configuration parameters (for example: deletion protection), or the global cluster identifier by specifying these parameters and the new values in the request.

This action only applies to Amazon DocumentDB clusters.

", "RebootDBInstance": "

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

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

", @@ -91,9 +91,9 @@ "AttributeValueList": { "base": null, "refs": { - "DBClusterSnapshotAttribute$AttributeValues": "

The values for the manual cluster snapshot attribute.

If the AttributeName field is set to restore, then this element returns a list of IDs of the accounts that are authorized to copy or restore the manual cluster snapshot. If a value of all is in the list, then the manual cluster snapshot is public and available for any account to copy or restore.

", - "ModifyDBClusterSnapshotAttributeMessage$ValuesToAdd": "

A list of cluster snapshot attributes to add to the attribute specified by AttributeName.

To authorize other accounts to copy or restore a manual cluster snapshot, set this list to include one or more account IDs. To make the manual cluster snapshot restorable by any account, set it to all. Do not add the all value for any manual cluster snapshots that contain private information that you don't want to be available to all accounts.

", - "ModifyDBClusterSnapshotAttributeMessage$ValuesToRemove": "

A list of cluster snapshot attributes to remove from the attribute specified by AttributeName.

To remove authorization for other accounts to copy or restore a manual cluster snapshot, set this list to include one or more account identifiers. To remove authorization for any account to copy or restore the cluster snapshot, set it to all . If you specify all, an account whose account ID is explicitly added to the restore attribute can still copy or restore a manual cluster snapshot.

" + "DBClusterSnapshotAttribute$AttributeValues": "

The values for the manual cluster snapshot attribute.

If the AttributeName field is set to restore, then this element returns a list of IDs of the Amazon Web Services accounts that are authorized to copy or restore the manual cluster snapshot. If a value of all is in the list, then the manual cluster snapshot is public and available for any Amazon Web Services account to copy or restore.

", + "ModifyDBClusterSnapshotAttributeMessage$ValuesToAdd": "

A list of cluster snapshot attributes to add to the attribute specified by AttributeName.

To authorize other Amazon Web Services accounts to copy or restore a manual cluster snapshot, set this list to include one or more Amazon Web Services account IDs. To make the manual cluster snapshot restorable by any Amazon Web Services account, set it to all. Do not add the all value for any manual cluster snapshots that contain private information that you don't want to be available to all Amazon Web Services accounts.

", + "ModifyDBClusterSnapshotAttributeMessage$ValuesToRemove": "

A list of cluster snapshot attributes to remove from the attribute specified by AttributeName.

To remove authorization for other Amazon Web Services accounts to copy or restore a manual cluster snapshot, set this list to include one or more Amazon Web Services account identifiers. To remove authorization for any Amazon Web Services account to copy or restore the cluster snapshot, set it to all . If you specify all, an Amazon Web Services account whose account ID is explicitly added to the restore attribute can still copy or restore a manual cluster snapshot.

" } }, "AuthorizationNotFoundFault": { @@ -137,8 +137,8 @@ "DBInstance$StorageEncrypted": "

Specifies whether or not the instance is encrypted.

", "DBInstanceStatusInfo$Normal": "

A Boolean value that is true if the instance is operating normally, or false if the instance is in an error state.

", "DeleteDBClusterMessage$SkipFinalSnapshot": "

Determines whether a final cluster snapshot is created before the cluster is deleted. If true is specified, no cluster snapshot is created. If false is specified, a cluster snapshot is created before the DB cluster is deleted.

If SkipFinalSnapshot is false, you must specify a FinalDBSnapshotIdentifier parameter.

Default: false

", - "DescribeDBClusterSnapshotsMessage$IncludeShared": "

Set to true to include shared manual cluster snapshots from other accounts that this account has been given permission to copy or restore, and otherwise false. The default is false.

", - "DescribeDBClusterSnapshotsMessage$IncludePublic": "

Set to true to include manual cluster snapshots that are public and can be copied or restored by any account, and otherwise false. The default is false.

", + "DescribeDBClusterSnapshotsMessage$IncludeShared": "

Set to true to include shared manual cluster snapshots from other Amazon Web Services accounts that this Amazon Web Services account has been given permission to copy or restore, and otherwise false. The default is false.

", + "DescribeDBClusterSnapshotsMessage$IncludePublic": "

Set to true to include manual cluster snapshots that are public and can be copied or restored by any Amazon Web Services account, and otherwise false. The default is false.

", "DescribeDBEngineVersionsMessage$DefaultOnly": "

Indicates that only the default version of the specified engine or engine and major version combination is returned.

", "EventSubscription$Enabled": "

A Boolean value indicating whether the subscription is enabled. A value of true indicates that the subscription is enabled.

", "GlobalClusterMember$IsWriter": "

Specifies whether the Amazon DocumentDB cluster is the primary cluster (that is, has read-write capability) for the Amazon DocumentDB global cluster with which it is associated.

", @@ -159,6 +159,7 @@ "CreateDBClusterMessage$StorageEncrypted": "

Specifies whether the cluster is encrypted.

", "CreateDBClusterMessage$DeletionProtection": "

Specifies whether this cluster can be deleted. If DeletionProtection is enabled, the cluster cannot be deleted unless it is modified and DeletionProtection is disabled. DeletionProtection protects clusters from being accidentally deleted.

", "CreateDBInstanceMessage$AutoMinorVersionUpgrade": "

This parameter does not apply to Amazon DocumentDB. Amazon DocumentDB does not perform minor version upgrades regardless of the value set.

Default: false

", + "CreateDBInstanceMessage$EnablePerformanceInsights": "

A value that indicates whether to enable Performance Insights for the DB Instance. For more information, see Using Amazon Performance Insights.

", "CreateEventSubscriptionMessage$Enabled": "

A Boolean value; set to true to activate the subscription, set to false to create the subscription but not active it.

", "CreateGlobalClusterMessage$DeletionProtection": "

The deletion protection setting for the new global cluster. The global cluster can't be deleted when deletion protection is enabled.

", "CreateGlobalClusterMessage$StorageEncrypted": "

The storage encryption setting for the new global cluster.

", @@ -169,6 +170,7 @@ "GlobalCluster$DeletionProtection": "

The deletion protection setting for the new global cluster.

", "ModifyDBClusterMessage$DeletionProtection": "

Specifies whether this cluster can be deleted. If DeletionProtection is enabled, the cluster cannot be deleted unless it is modified and DeletionProtection is disabled. DeletionProtection protects clusters from being accidentally deleted.

", "ModifyDBInstanceMessage$AutoMinorVersionUpgrade": "

This parameter does not apply to Amazon DocumentDB. Amazon DocumentDB does not perform minor version upgrades regardless of the value set.

", + "ModifyDBInstanceMessage$EnablePerformanceInsights": "

A value that indicates whether to enable Performance Insights for the DB Instance. For more information, see Using Amazon Performance Insights.

", "ModifyEventSubscriptionMessage$Enabled": "

A Boolean value; set to true to activate the subscription.

", "ModifyGlobalClusterMessage$DeletionProtection": "

Indicates if the global cluster has deletion protection enabled. The global cluster can't be deleted when deletion protection is enabled.

", "PendingModifiedValues$MultiAZ": "

Indicates that the Single-AZ instance is to change to a Multi-AZ deployment.

", @@ -178,7 +180,7 @@ } }, "Certificate": { - "base": "

A certificate authority (CA) certificate for an account.

", + "base": "

A certificate authority (CA) certificate for an Amazon Web Services account.

", "refs": { "CertificateList$member": null } @@ -186,7 +188,7 @@ "CertificateList": { "base": null, "refs": { - "CertificateMessage$Certificates": "

A list of certificates for this account.

" + "CertificateMessage$Certificates": "

A list of certificates for this Amazon Web Services account.

" } }, "CertificateMessage": { @@ -408,7 +410,7 @@ } }, "DBClusterSnapshotAttribute": { - "base": "

Contains the name and values of a manual cluster snapshot attribute.

Manual cluster snapshot attributes are used to authorize other accounts to restore a manual cluster snapshot.

", + "base": "

Contains the name and values of a manual cluster snapshot attribute.

Manual cluster snapshot attributes are used to authorize other Amazon Web Services accounts to restore a manual cluster snapshot.

", "refs": { "DBClusterSnapshotAttributeList$member": null } @@ -1388,13 +1390,13 @@ "Certificate$Thumbprint": "

The thumbprint of the certificate.

", "Certificate$CertificateArn": "

The Amazon Resource Name (ARN) for the certificate.

Example: arn:aws:rds:us-east-1::cert:rds-ca-2019

", "CertificateMessage$Marker": "

An optional pagination token provided if the number of records retrieved is greater than MaxRecords. If this parameter is specified, the marker specifies the next record in the list. Including the value of Marker in the next call to DescribeCertificates results in the next page of certificates.

", - "CopyDBClusterParameterGroupMessage$SourceDBClusterParameterGroupIdentifier": "

The identifier or Amazon Resource Name (ARN) for the source cluster parameter group.

Constraints:

", + "CopyDBClusterParameterGroupMessage$SourceDBClusterParameterGroupIdentifier": "

The identifier or Amazon Resource Name (ARN) for the source cluster parameter group.

Constraints:

", "CopyDBClusterParameterGroupMessage$TargetDBClusterParameterGroupIdentifier": "

The identifier for the copied cluster parameter group.

Constraints:

Example: my-cluster-param-group1

", "CopyDBClusterParameterGroupMessage$TargetDBClusterParameterGroupDescription": "

A description for the copied cluster parameter group.

", - "CopyDBClusterSnapshotMessage$SourceDBClusterSnapshotIdentifier": "

The identifier of the cluster snapshot to copy. This parameter is not case sensitive.

Constraints:

Example: my-cluster-snapshot1

", + "CopyDBClusterSnapshotMessage$SourceDBClusterSnapshotIdentifier": "

The identifier of the cluster snapshot to copy. This parameter is not case sensitive.

Constraints:

Example: my-cluster-snapshot1

", "CopyDBClusterSnapshotMessage$TargetDBClusterSnapshotIdentifier": "

The identifier of the new cluster snapshot to create from the source cluster snapshot. This parameter is not case sensitive.

Constraints:

Example: my-cluster-snapshot2

", - "CopyDBClusterSnapshotMessage$KmsKeyId": "

The KMS key ID for an encrypted cluster snapshot. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

If you copy an encrypted cluster snapshot from your account, you can specify a value for KmsKeyId to encrypt the copy with a new KMS encryption key. If you don't specify a value for KmsKeyId, then the copy of the cluster snapshot is encrypted with the same KMS key as the source cluster snapshot.

If you copy an encrypted cluster snapshot that is shared from another account, then you must specify a value for KmsKeyId.

To copy an encrypted cluster snapshot to another Region, set KmsKeyId to the KMS key ID that you want to use to encrypt the copy of the cluster snapshot in the destination Region. KMS encryption keys are specific to the Region that they are created in, and you can't use encryption keys from one Region in another Region.

If you copy an unencrypted cluster snapshot and specify a value for the KmsKeyId parameter, an error is returned.

", - "CopyDBClusterSnapshotMessage$PreSignedUrl": "

The URL that contains a Signature Version 4 signed request for theCopyDBClusterSnapshot API action in the Region that contains the source cluster snapshot to copy. You must use the PreSignedUrl parameter when copying a cluster snapshot from another Region.

If you are using an Amazon Web Services SDK tool or the CLI, you can specify SourceRegion (or --source-region for the CLI) instead of specifying PreSignedUrl manually. Specifying SourceRegion autogenerates a pre-signed URL that is a valid request for the operation that can be executed in the source Region.

The presigned URL must be a valid request for the CopyDBClusterSnapshot API action that can be executed in the source Region that contains the cluster snapshot to be copied. The presigned URL request must contain the following parameter values:

", + "CopyDBClusterSnapshotMessage$KmsKeyId": "

The KMS key ID for an encrypted cluster snapshot. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

If you copy an encrypted cluster snapshot from your Amazon Web Services account, you can specify a value for KmsKeyId to encrypt the copy with a new KMS encryption key. If you don't specify a value for KmsKeyId, then the copy of the cluster snapshot is encrypted with the same KMS key as the source cluster snapshot.

If you copy an encrypted cluster snapshot that is shared from another Amazon Web Services account, then you must specify a value for KmsKeyId.

To copy an encrypted cluster snapshot to another Amazon Web Services Region, set KmsKeyId to the KMS key ID that you want to use to encrypt the copy of the cluster snapshot in the destination Region. KMS encryption keys are specific to the Amazon Web Services Region that they are created in, and you can't use encryption keys from one Amazon Web Services Region in another Amazon Web Services Region.

If you copy an unencrypted cluster snapshot and specify a value for the KmsKeyId parameter, an error is returned.

", + "CopyDBClusterSnapshotMessage$PreSignedUrl": "

The URL that contains a Signature Version 4 signed request for theCopyDBClusterSnapshot API action in the Amazon Web Services Region that contains the source cluster snapshot to copy. You must use the PreSignedUrl parameter when copying a cluster snapshot from another Amazon Web Services Region.

If you are using an Amazon Web Services SDK tool or the CLI, you can specify SourceRegion (or --source-region for the CLI) instead of specifying PreSignedUrl manually. Specifying SourceRegion autogenerates a pre-signed URL that is a valid request for the operation that can be executed in the source Amazon Web Services Region.

The presigned URL must be a valid request for the CopyDBClusterSnapshot API action that can be executed in the source Amazon Web Services Region that contains the cluster snapshot to be copied. The presigned URL request must contain the following parameter values:

", "CreateDBClusterMessage$DBClusterIdentifier": "

The cluster identifier. This parameter is stored as a lowercase string.

Constraints:

Example: my-cluster

", "CreateDBClusterMessage$DBClusterParameterGroupName": "

The name of the cluster parameter group to associate with this cluster.

", "CreateDBClusterMessage$DBSubnetGroupName": "

A subnet group to associate with this cluster.

Constraints: Must match the name of an existing DBSubnetGroup. Must not be default.

Example: mySubnetgroup

", @@ -1402,9 +1404,9 @@ "CreateDBClusterMessage$EngineVersion": "

The version number of the database engine to use. The --engine-version will default to the latest major engine version. For production workloads, we recommend explicitly declaring this parameter with the intended major engine version.

", "CreateDBClusterMessage$MasterUsername": "

The name of the master user for the cluster.

Constraints:

", "CreateDBClusterMessage$MasterUserPassword": "

The password for the master database user. This password can contain any printable ASCII character except forward slash (/), double quote (\"), or the \"at\" symbol (@).

Constraints: Must contain from 8 to 100 characters.

", - "CreateDBClusterMessage$PreferredBackupWindow": "

The daily time range during which automated backups are created if automated backups are enabled using the BackupRetentionPeriod parameter.

The default is a 30-minute window selected at random from an 8-hour block of time for each Region.

Constraints:

", - "CreateDBClusterMessage$PreferredMaintenanceWindow": "

The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).

Format: ddd:hh24:mi-ddd:hh24:mi

The default is a 30-minute window selected at random from an 8-hour block of time for each Region, occurring on a random day of the week.

Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun

Constraints: Minimum 30-minute window.

", - "CreateDBClusterMessage$KmsKeyId": "

The KMS key identifier for an encrypted cluster.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are creating a cluster using the same account that owns the KMS encryption key that is used to encrypt the new cluster, you can use the KMS key alias instead of the ARN for the KMS encryption key.

If an encryption key is not specified in KmsKeyId:

KMS creates the default encryption key for your account. Your account has a different default encryption key for each Regions.

", + "CreateDBClusterMessage$PreferredBackupWindow": "

The daily time range during which automated backups are created if automated backups are enabled using the BackupRetentionPeriod parameter.

The default is a 30-minute window selected at random from an 8-hour block of time for each Amazon Web Services Region.

Constraints:

", + "CreateDBClusterMessage$PreferredMaintenanceWindow": "

The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).

Format: ddd:hh24:mi-ddd:hh24:mi

The default is a 30-minute window selected at random from an 8-hour block of time for each Amazon Web Services Region, occurring on a random day of the week.

Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun

Constraints: Minimum 30-minute window.

", + "CreateDBClusterMessage$KmsKeyId": "

The KMS key identifier for an encrypted cluster.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are creating a cluster using the same Amazon Web Services account that owns the KMS encryption key that is used to encrypt the new cluster, you can use the KMS key alias instead of the ARN for the KMS encryption key.

If an encryption key is not specified in KmsKeyId:

KMS creates the default encryption key for your Amazon Web Services account. Your Amazon Web Services account has a different default encryption key for each Amazon Web Services Regions.

", "CreateDBClusterMessage$PreSignedUrl": "

Not currently supported.

", "CreateDBClusterParameterGroupMessage$DBClusterParameterGroupName": "

The name of the cluster parameter group.

Constraints:

This value is stored as a lowercase string.

", "CreateDBClusterParameterGroupMessage$DBParameterGroupFamily": "

The cluster parameter group family name.

", @@ -1414,9 +1416,10 @@ "CreateDBInstanceMessage$DBInstanceIdentifier": "

The instance identifier. This parameter is stored as a lowercase string.

Constraints:

Example: mydbinstance

", "CreateDBInstanceMessage$DBInstanceClass": "

The compute and memory capacity of the instance; for example, db.r5.large.

", "CreateDBInstanceMessage$Engine": "

The name of the database engine to be used for this instance.

Valid value: docdb

", - "CreateDBInstanceMessage$AvailabilityZone": "

The Amazon EC2 Availability Zone that the instance is created in.

Default: A random, system-chosen Availability Zone in the endpoint's Region.

Example: us-east-1d

", - "CreateDBInstanceMessage$PreferredMaintenanceWindow": "

The time range each week during which system maintenance can occur, in Universal Coordinated Time (UTC).

Format: ddd:hh24:mi-ddd:hh24:mi

The default is a 30-minute window selected at random from an 8-hour block of time for each Region, occurring on a random day of the week.

Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun

Constraints: Minimum 30-minute window.

", + "CreateDBInstanceMessage$AvailabilityZone": "

The Amazon EC2 Availability Zone that the instance is created in.

Default: A random, system-chosen Availability Zone in the endpoint's Amazon Web Services Region.

Example: us-east-1d

", + "CreateDBInstanceMessage$PreferredMaintenanceWindow": "

The time range each week during which system maintenance can occur, in Universal Coordinated Time (UTC).

Format: ddd:hh24:mi-ddd:hh24:mi

The default is a 30-minute window selected at random from an 8-hour block of time for each Amazon Web Services Region, occurring on a random day of the week.

Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun

Constraints: Minimum 30-minute window.

", "CreateDBInstanceMessage$DBClusterIdentifier": "

The identifier of the cluster that the instance will belong to.

", + "CreateDBInstanceMessage$PerformanceInsightsKMSKeyId": "

The KMS key identifier for encryption of Performance Insights data.

The KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.

If you do not specify a value for PerformanceInsightsKMSKeyId, then Amazon DocumentDB uses your default KMS key. There is a default KMS key for your Amazon Web Services account. Your Amazon Web Services account has a different default KMS key for each Amazon Web Services region.

", "CreateDBSubnetGroupMessage$DBSubnetGroupName": "

The name for the subnet group. This value is stored as a lowercase string.

Constraints: Must contain no more than 255 letters, numbers, periods, underscores, spaces, or hyphens. Must not be default.

Example: mySubnetgroup

", "CreateDBSubnetGroupMessage$DBSubnetGroupDescription": "

The description for the subnet group.

", "CreateEventSubscriptionMessage$SubscriptionName": "

The name of the subscription.

Constraints: The name must be fewer than 255 characters.

", @@ -1441,7 +1444,7 @@ "DBCluster$ReplicationSourceIdentifier": "

Contains the identifier of the source cluster if this cluster is a secondary cluster.

", "DBCluster$HostedZoneId": "

Specifies the ID that Amazon Route 53 assigns when you create a hosted zone.

", "DBCluster$KmsKeyId": "

If StorageEncrypted is true, the KMS key identifier for the encrypted cluster.

", - "DBCluster$DbClusterResourceId": "

The Region-unique, immutable identifier for the cluster. This identifier is found in CloudTrail log entries whenever the KMS key for the cluster is accessed.

", + "DBCluster$DbClusterResourceId": "

The Amazon Web Services Region-unique, immutable identifier for the cluster. This identifier is found in CloudTrail log entries whenever the KMS key for the cluster is accessed.

", "DBCluster$DBClusterArn": "

The Amazon Resource Name (ARN) for the cluster.

", "DBClusterMember$DBInstanceIdentifier": "

Specifies the instance identifier for this member of the cluster.

", "DBClusterMember$DBClusterParameterGroupStatus": "

Specifies the status of the cluster parameter group for this member of the DB cluster.

", @@ -1466,7 +1469,7 @@ "DBClusterSnapshot$KmsKeyId": "

If StorageEncrypted is true, the KMS key identifier for the encrypted cluster snapshot.

", "DBClusterSnapshot$DBClusterSnapshotArn": "

The Amazon Resource Name (ARN) for the cluster snapshot.

", "DBClusterSnapshot$SourceDBClusterSnapshotArn": "

If the cluster snapshot was copied from a source cluster snapshot, the ARN for the source cluster snapshot; otherwise, a null value.

", - "DBClusterSnapshotAttribute$AttributeName": "

The name of the manual cluster snapshot attribute.

The attribute named restore refers to the list of accounts that have permission to copy or restore the manual cluster snapshot.

", + "DBClusterSnapshotAttribute$AttributeName": "

The name of the manual cluster snapshot attribute.

The attribute named restore refers to the list of Amazon Web Services accounts that have permission to copy or restore the manual cluster snapshot.

", "DBClusterSnapshotAttributesResult$DBClusterSnapshotIdentifier": "

The identifier of the cluster snapshot that the attributes apply to.

", "DBClusterSnapshotMessage$Marker": "

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

", "DBEngineVersion$Engine": "

The name of the database engine.

", @@ -1485,7 +1488,7 @@ "DBInstance$EngineVersion": "

Indicates the database engine version.

", "DBInstance$DBClusterIdentifier": "

Contains the name of the cluster that the instance is a member of if the instance is a member of a cluster.

", "DBInstance$KmsKeyId": "

If StorageEncrypted is true, the KMS key identifier for the encrypted instance.

", - "DBInstance$DbiResourceId": "

The Region-unique, immutable identifier for the instance. This identifier is found in CloudTrail log entries whenever the KMS key for the instance is accessed.

", + "DBInstance$DbiResourceId": "

The Amazon Web Services Region-unique, immutable identifier for the instance. This identifier is found in CloudTrail log entries whenever the KMS key for the instance is accessed.

", "DBInstance$CACertificateIdentifier": "

The identifier of the CA certificate for this DB instance.

", "DBInstance$DBInstanceArn": "

The Amazon Resource Name (ARN) for the instance.

", "DBInstanceMessage$Marker": "

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

", @@ -1515,7 +1518,7 @@ "DescribeDBClusterSnapshotAttributesMessage$DBClusterSnapshotIdentifier": "

The identifier for the cluster snapshot to describe the attributes for.

", "DescribeDBClusterSnapshotsMessage$DBClusterIdentifier": "

The ID of the cluster to retrieve the list of cluster snapshots for. This parameter can't be used with the DBClusterSnapshotIdentifier parameter. This parameter is not case sensitive.

Constraints:

", "DescribeDBClusterSnapshotsMessage$DBClusterSnapshotIdentifier": "

A specific cluster snapshot identifier to describe. This parameter can't be used with the DBClusterIdentifier parameter. This value is stored as a lowercase string.

Constraints:

", - "DescribeDBClusterSnapshotsMessage$SnapshotType": "

The type of cluster snapshots to be returned. You can specify one of the following values:

If you don't specify a SnapshotType value, then both automated and manual cluster snapshots are returned. You can include shared cluster snapshots with these results by setting the IncludeShared parameter to true. You can include public cluster snapshots with these results by setting theIncludePublic parameter to true.

The IncludeShared and IncludePublic parameters don't apply for SnapshotType values of manual or automated. The IncludePublic parameter doesn't apply when SnapshotType is set to shared. The IncludeShared parameter doesn't apply when SnapshotType is set to public.

", + "DescribeDBClusterSnapshotsMessage$SnapshotType": "

The type of cluster snapshots to be returned. You can specify one of the following values:

If you don't specify a SnapshotType value, then both automated and manual cluster snapshots are returned. You can include shared cluster snapshots with these results by setting the IncludeShared parameter to true. You can include public cluster snapshots with these results by setting theIncludePublic parameter to true.

The IncludeShared and IncludePublic parameters don't apply for SnapshotType values of manual or automated. The IncludePublic parameter doesn't apply when SnapshotType is set to shared. The IncludeShared parameter doesn't apply when SnapshotType is set to public.

", "DescribeDBClusterSnapshotsMessage$Marker": "

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

", "DescribeDBClustersMessage$DBClusterIdentifier": "

The user-provided cluster identifier. If this parameter is specified, information from only the specific cluster is returned. This parameter isn't case sensitive.

Constraints:

", "DescribeDBClustersMessage$Marker": "

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

", @@ -1564,7 +1567,7 @@ "FailoverDBClusterMessage$TargetDBInstanceIdentifier": "

The name of the instance to promote to the primary instance.

You must specify the instance identifier for an Amazon DocumentDB replica in the cluster. For example, mydbcluster-replica1.

", "Filter$Name": "

The name of the filter. Filter names are case sensitive.

", "FilterValueList$member": null, - "GlobalCluster$GlobalClusterResourceId": "

The Region-unique, immutable identifier for the global database cluster. This identifier is found in AWS CloudTrail log entries whenever the AWS KMS customer master key (CMK) for the cluster is accessed.

", + "GlobalCluster$GlobalClusterResourceId": "

The Amazon Web Services Region-unique, immutable identifier for the global database cluster. This identifier is found in AWS CloudTrail log entries whenever the AWS KMS customer master key (CMK) for the cluster is accessed.

", "GlobalCluster$GlobalClusterArn": "

The Amazon Resource Name (ARN) for the global cluster.

", "GlobalCluster$Status": "

Specifies the current state of this global cluster.

", "GlobalCluster$Engine": "

The Amazon DocumentDB database engine used by the global cluster.

", @@ -1579,17 +1582,18 @@ "ModifyDBClusterMessage$NewDBClusterIdentifier": "

The new cluster identifier for the cluster when renaming a cluster. This value is stored as a lowercase string.

Constraints:

Example: my-cluster2

", "ModifyDBClusterMessage$DBClusterParameterGroupName": "

The name of the cluster parameter group to use for the cluster.

", "ModifyDBClusterMessage$MasterUserPassword": "

The password for the master database user. This password can contain any printable ASCII character except forward slash (/), double quote (\"), or the \"at\" symbol (@).

Constraints: Must contain from 8 to 100 characters.

", - "ModifyDBClusterMessage$PreferredBackupWindow": "

The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter.

The default is a 30-minute window selected at random from an 8-hour block of time for each Region.

Constraints:

", - "ModifyDBClusterMessage$PreferredMaintenanceWindow": "

The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).

Format: ddd:hh24:mi-ddd:hh24:mi

The default is a 30-minute window selected at random from an 8-hour block of time for each Region, occurring on a random day of the week.

Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun

Constraints: Minimum 30-minute window.

", + "ModifyDBClusterMessage$PreferredBackupWindow": "

The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter.

The default is a 30-minute window selected at random from an 8-hour block of time for each Amazon Web Services Region.

Constraints:

", + "ModifyDBClusterMessage$PreferredMaintenanceWindow": "

The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).

Format: ddd:hh24:mi-ddd:hh24:mi

The default is a 30-minute window selected at random from an 8-hour block of time for each Amazon Web Services Region, occurring on a random day of the week.

Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun

Constraints: Minimum 30-minute window.

", "ModifyDBClusterMessage$EngineVersion": "

The version number of the database engine to which you want to upgrade. Modifying engine version is not supported on Amazon DocumentDB.

", "ModifyDBClusterParameterGroupMessage$DBClusterParameterGroupName": "

The name of the cluster parameter group to modify.

", "ModifyDBClusterSnapshotAttributeMessage$DBClusterSnapshotIdentifier": "

The identifier for the cluster snapshot to modify the attributes for.

", - "ModifyDBClusterSnapshotAttributeMessage$AttributeName": "

The name of the cluster snapshot attribute to modify.

To manage authorization for other accounts to copy or restore a manual cluster snapshot, set this value to restore.

", + "ModifyDBClusterSnapshotAttributeMessage$AttributeName": "

The name of the cluster snapshot attribute to modify.

To manage authorization for other Amazon Web Services accounts to copy or restore a manual cluster snapshot, set this value to restore.

", "ModifyDBInstanceMessage$DBInstanceIdentifier": "

The instance identifier. This value is stored as a lowercase string.

Constraints:

", - "ModifyDBInstanceMessage$DBInstanceClass": "

The new compute and memory capacity of the instance; for example, db.r5.large. Not all instance classes are available in all Regions.

If you modify the instance class, an outage occurs during the change. The change is applied during the next maintenance window, unless ApplyImmediately is specified as true for this request.

Default: Uses existing setting.

", + "ModifyDBInstanceMessage$DBInstanceClass": "

The new compute and memory capacity of the instance; for example, db.r5.large. Not all instance classes are available in all Amazon Web Services Regions.

If you modify the instance class, an outage occurs during the change. The change is applied during the next maintenance window, unless ApplyImmediately is specified as true for this request.

Default: Uses existing setting.

", "ModifyDBInstanceMessage$PreferredMaintenanceWindow": "

The weekly time range (in UTC) during which system maintenance can occur, which might result in an outage. Changing this parameter doesn't result in an outage except in the following situation, and the change is asynchronously applied as soon as possible. If there are pending actions that cause a reboot, and the maintenance window is changed to include the current time, changing this parameter causes a reboot of the instance. If you are moving this window to the current time, there must be at least 30 minutes between the current time and end of the window to ensure that pending changes are applied.

Default: Uses existing setting.

Format: ddd:hh24:mi-ddd:hh24:mi

Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun

Constraints: Must be at least 30 minutes.

", "ModifyDBInstanceMessage$NewDBInstanceIdentifier": "

The new instance identifier for the instance when renaming an instance. When you change the instance identifier, an instance reboot occurs immediately if you set Apply Immediately to true. It occurs during the next maintenance window if you set Apply Immediately to false. This value is stored as a lowercase string.

Constraints:

Example: mydbinstance

", "ModifyDBInstanceMessage$CACertificateIdentifier": "

Indicates the certificate that needs to be associated with the instance.

", + "ModifyDBInstanceMessage$PerformanceInsightsKMSKeyId": "

The KMS key identifier for encryption of Performance Insights data.

The KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.

If you do not specify a value for PerformanceInsightsKMSKeyId, then Amazon DocumentDB uses your default KMS key. There is a default KMS key for your Amazon Web Services account. Your Amazon Web Services account has a different default KMS key for each Amazon Web Services region.

", "ModifyDBSubnetGroupMessage$DBSubnetGroupName": "

The name for the subnet group. This value is stored as a lowercase string. You can't modify the default subnet group.

Constraints: Must match the name of an existing DBSubnetGroup. Must not be default.

Example: mySubnetgroup

", "ModifyDBSubnetGroupMessage$DBSubnetGroupDescription": "

The description for the subnet group.

", "ModifyEventSubscriptionMessage$SubscriptionName": "

The name of the Amazon DocumentDB event notification subscription.

", @@ -1634,11 +1638,11 @@ "RestoreDBClusterFromSnapshotMessage$Engine": "

The database engine to use for the new cluster.

Default: The same as source.

Constraint: Must be compatible with the engine of the source.

", "RestoreDBClusterFromSnapshotMessage$EngineVersion": "

The version of the database engine to use for the new cluster.

", "RestoreDBClusterFromSnapshotMessage$DBSubnetGroupName": "

The name of the subnet group to use for the new cluster.

Constraints: If provided, must match the name of an existing DBSubnetGroup.

Example: mySubnetgroup

", - "RestoreDBClusterFromSnapshotMessage$KmsKeyId": "

The KMS key identifier to use when restoring an encrypted cluster from a DB snapshot or cluster snapshot.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are restoring a cluster with the same account that owns the KMS encryption key used to encrypt the new cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.

If you do not specify a value for the KmsKeyId parameter, then the following occurs:

", + "RestoreDBClusterFromSnapshotMessage$KmsKeyId": "

The KMS key identifier to use when restoring an encrypted cluster from a DB snapshot or cluster snapshot.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are restoring a cluster with the same Amazon Web Services account that owns the KMS encryption key used to encrypt the new cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.

If you do not specify a value for the KmsKeyId parameter, then the following occurs:

", "RestoreDBClusterToPointInTimeMessage$DBClusterIdentifier": "

The name of the new cluster to be created.

Constraints:

", "RestoreDBClusterToPointInTimeMessage$SourceDBClusterIdentifier": "

The identifier of the source cluster from which to restore.

Constraints:

", "RestoreDBClusterToPointInTimeMessage$DBSubnetGroupName": "

The subnet group name to use for the new cluster.

Constraints: If provided, must match the name of an existing DBSubnetGroup.

Example: mySubnetgroup

", - "RestoreDBClusterToPointInTimeMessage$KmsKeyId": "

The KMS key identifier to use when restoring an encrypted cluster from an encrypted cluster.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are restoring a cluster with the same account that owns the KMS encryption key used to encrypt the new cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.

You can restore to a new cluster and encrypt the new cluster with an KMS key that is different from the KMS key used to encrypt the source cluster. The new DB cluster is encrypted with the KMS key identified by the KmsKeyId parameter.

If you do not specify a value for the KmsKeyId parameter, then the following occurs:

If DBClusterIdentifier refers to a cluster that is not encrypted, then the restore request is rejected.

", + "RestoreDBClusterToPointInTimeMessage$KmsKeyId": "

The KMS key identifier to use when restoring an encrypted cluster from an encrypted cluster.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are restoring a cluster with the same Amazon Web Services account that owns the KMS encryption key used to encrypt the new cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.

You can restore to a new cluster and encrypt the new cluster with an KMS key that is different from the KMS key used to encrypt the source cluster. The new DB cluster is encrypted with the KMS key identified by the KmsKeyId parameter.

If you do not specify a value for the KmsKeyId parameter, then the following occurs:

If DBClusterIdentifier refers to a cluster that is not encrypted, then the restore request is rejected.

", "SourceIdsList$member": null, "StartDBClusterMessage$DBClusterIdentifier": "

The identifier of the cluster to restart. Example: docdb-2019-05-28-15-24-52

", "StopDBClusterMessage$DBClusterIdentifier": "

The identifier of the cluster to stop. Example: docdb-2019-05-28-15-24-52

", diff --git a/models/apis/eventbridge/2015-10-07/api-2.json b/models/apis/eventbridge/2015-10-07/api-2.json index 52ae1f852c7..37e24daa801 100644 --- a/models/apis/eventbridge/2015-10-07/api-2.json +++ b/models/apis/eventbridge/2015-10-07/api-2.json @@ -88,6 +88,20 @@ {"shape":"InternalException"} ] }, + "CreateEndpoint":{ + "name":"CreateEndpoint", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"CreateEndpointRequest"}, + "output":{"shape":"CreateEndpointResponse"}, + "errors":[ + {"shape":"ResourceAlreadyExistsException"}, + {"shape":"LimitExceededException"}, + {"shape":"InternalException"} + ] + }, "CreateEventBus":{ "name":"CreateEventBus", "http":{ @@ -193,6 +207,20 @@ {"shape":"InternalException"} ] }, + "DeleteEndpoint":{ + "name":"DeleteEndpoint", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeleteEndpointRequest"}, + "output":{"shape":"DeleteEndpointResponse"}, + "errors":[ + {"shape":"ConcurrentModificationException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"InternalException"} + ] + }, "DeleteEventBus":{ "name":"DeleteEventBus", "http":{ @@ -272,6 +300,19 @@ {"shape":"InternalException"} ] }, + "DescribeEndpoint":{ + "name":"DescribeEndpoint", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DescribeEndpointRequest"}, + "output":{"shape":"DescribeEndpointResponse"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"InternalException"} + ] + }, "DescribeEventBus":{ "name":"DescribeEventBus", "http":{ @@ -404,6 +445,18 @@ {"shape":"InternalException"} ] }, + "ListEndpoints":{ + "name":"ListEndpoints", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListEndpointsRequest"}, + "output":{"shape":"ListEndpointsResponse"}, + "errors":[ + {"shape":"InternalException"} + ] + }, "ListEventBuses":{ "name":"ListEventBuses", "http":{ @@ -726,6 +779,20 @@ {"shape":"InternalException"}, {"shape":"LimitExceededException"} ] + }, + "UpdateEndpoint":{ + "name":"UpdateEndpoint", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"UpdateEndpointRequest"}, + "output":{"shape":"UpdateEndpointResponse"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"ConcurrentModificationException"}, + {"shape":"InternalException"} + ] } }, "shapes":{ @@ -1253,6 +1320,34 @@ "LastModifiedTime":{"shape":"Timestamp"} } }, + "CreateEndpointRequest":{ + "type":"structure", + "required":[ + "Name", + "RoutingConfig", + "EventBuses" + ], + "members":{ + "Name":{"shape":"EndpointName"}, + "Description":{"shape":"EndpointDescription"}, + "RoutingConfig":{"shape":"RoutingConfig"}, + "ReplicationConfig":{"shape":"ReplicationConfig"}, + "EventBuses":{"shape":"EndpointEventBusList"}, + "RoleArn":{"shape":"IamRoleArn"} + } + }, + "CreateEndpointResponse":{ + "type":"structure", + "members":{ + "Name":{"shape":"EndpointName"}, + "Arn":{"shape":"EndpointArn"}, + "RoutingConfig":{"shape":"RoutingConfig"}, + "ReplicationConfig":{"shape":"ReplicationConfig"}, + "EventBuses":{"shape":"EndpointEventBusList"}, + "RoleArn":{"shape":"IamRoleArn"}, + "State":{"shape":"EndpointState"} + } + }, "CreateEventBusRequest":{ "type":"structure", "required":["Name"], @@ -1371,6 +1466,18 @@ "LastAuthorizedTime":{"shape":"Timestamp"} } }, + "DeleteEndpointRequest":{ + "type":"structure", + "required":["Name"], + "members":{ + "Name":{"shape":"EndpointName"} + } + }, + "DeleteEndpointResponse":{ + "type":"structure", + "members":{ + } + }, "DeleteEventBusRequest":{ "type":"structure", "required":["Name"], @@ -1466,6 +1573,32 @@ "LastAuthorizedTime":{"shape":"Timestamp"} } }, + "DescribeEndpointRequest":{ + "type":"structure", + "required":["Name"], + "members":{ + "Name":{"shape":"EndpointName"}, + "HomeRegion":{"shape":"HomeRegion"} + } + }, + "DescribeEndpointResponse":{ + "type":"structure", + "members":{ + "Name":{"shape":"EndpointName"}, + "Description":{"shape":"EndpointDescription"}, + "Arn":{"shape":"EndpointArn"}, + "RoutingConfig":{"shape":"RoutingConfig"}, + "ReplicationConfig":{"shape":"ReplicationConfig"}, + "EventBuses":{"shape":"EndpointEventBusList"}, + "RoleArn":{"shape":"IamRoleArn"}, + "EndpointId":{"shape":"EndpointId"}, + "EndpointUrl":{"shape":"EndpointUrl"}, + "State":{"shape":"EndpointState"}, + "StateReason":{"shape":"EndpointStateReason"}, + "CreationTime":{"shape":"Timestamp"}, + "LastModifiedTime":{"shape":"Timestamp"} + } + }, "DescribeEventBusRequest":{ "type":"structure", "members":{ @@ -1595,6 +1728,88 @@ "EventBusName":{"shape":"EventBusNameOrArn"} } }, + "Endpoint":{ + "type":"structure", + "members":{ + "Name":{"shape":"EndpointName"}, + "Description":{"shape":"EndpointDescription"}, + "Arn":{"shape":"EndpointArn"}, + "RoutingConfig":{"shape":"RoutingConfig"}, + "ReplicationConfig":{"shape":"ReplicationConfig"}, + "EventBuses":{"shape":"EndpointEventBusList"}, + "RoleArn":{"shape":"IamRoleArn"}, + "EndpointId":{"shape":"EndpointId"}, + "EndpointUrl":{"shape":"EndpointUrl"}, + "State":{"shape":"EndpointState"}, + "StateReason":{"shape":"EndpointStateReason"}, + "CreationTime":{"shape":"Timestamp"}, + "LastModifiedTime":{"shape":"Timestamp"} + } + }, + "EndpointArn":{ + "type":"string", + "max":1600, + "min":1, + "pattern":"^arn:aws([a-z]|\\-)*:events:([a-z]|\\d|\\-)*:([0-9]{12})?:endpoint\\/[/\\.\\-_A-Za-z0-9]+$" + }, + "EndpointDescription":{ + "type":"string", + "max":512, + "pattern":".*" + }, + "EndpointEventBus":{ + "type":"structure", + "required":["EventBusArn"], + "members":{ + "EventBusArn":{"shape":"NonPartnerEventBusArn"} + } + }, + "EndpointEventBusList":{ + "type":"list", + "member":{"shape":"EndpointEventBus"}, + "max":2, + "min":2 + }, + "EndpointId":{ + "type":"string", + "max":50, + "min":1, + "pattern":"^[A-Za-z0-9\\-]+[\\.][A-Za-z0-9\\-]+$" + }, + "EndpointList":{ + "type":"list", + "member":{"shape":"Endpoint"} + }, + "EndpointName":{ + "type":"string", + "max":64, + "min":1, + "pattern":"[\\.\\-_A-Za-z0-9]+" + }, + "EndpointState":{ + "type":"string", + "enum":[ + "ACTIVE", + "CREATING", + "UPDATING", + "DELETING", + "CREATE_FAILED", + "UPDATE_FAILED", + "DELETE_FAILED" + ] + }, + "EndpointStateReason":{ + "type":"string", + "max":512, + "min":1, + "pattern":".*" + }, + "EndpointUrl":{ + "type":"string", + "max":256, + "min":1, + "pattern":"^(https://)?[\\.\\-a-z0-9]+$" + }, "ErrorCode":{"type":"string"}, "ErrorMessage":{"type":"string"}, "EventBus":{ @@ -1621,9 +1836,18 @@ "min":1, "pattern":"(arn:aws[\\w-]*:events:[a-z]{2}-[a-z]+-[\\w-]+:[0-9]{12}:event-bus\\/)?[/\\.\\-_A-Za-z0-9]+" }, - "EventId":{"type":"string"}, - "EventPattern":{"type":"string"}, - "EventResource":{"type":"string"}, + "EventId":{ + "type":"string", + "max":64 + }, + "EventPattern":{ + "type":"string", + "max":4096 + }, + "EventResource":{ + "type":"string", + "max":2048 + }, "EventResourceList":{ "type":"list", "member":{"shape":"EventResource"} @@ -1664,6 +1888,17 @@ ] }, "EventTime":{"type":"timestamp"}, + "FailoverConfig":{ + "type":"structure", + "required":[ + "Primary", + "Secondary" + ], + "members":{ + "Primary":{"shape":"Primary"}, + "Secondary":{"shape":"Secondary"} + } + }, "HeaderKey":{ "type":"string", "max":512, @@ -1679,6 +1914,18 @@ "max":512, "pattern":"^[ \\t]*[\\x20-\\x7E]+([ \\t]+[\\x20-\\x7E]+)*[ \\t]*$" }, + "HealthCheck":{ + "type":"string", + "max":1600, + "min":1, + "pattern":"^arn:aws([a-z]|\\-)*:route53:::healthcheck/[\\-a-z0-9]+$" + }, + "HomeRegion":{ + "type":"string", + "max":20, + "min":9, + "pattern":"^[\\-a-z0-9]+$" + }, "HttpParameters":{ "type":"structure", "members":{ @@ -1693,6 +1940,12 @@ "min":1, "pattern":"^((%[0-9A-Fa-f]{2}|[-()_.!~*';/?:@\\x26=+$,A-Za-z0-9])+)([).!';/?:,])?$" }, + "IamRoleArn":{ + "type":"string", + "max":256, + "min":1, + "pattern":"^arn:aws[a-z-]*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$" + }, "IllegalStatusException":{ "type":"structure", "members":{ @@ -1812,6 +2065,22 @@ "NextToken":{"shape":"NextToken"} } }, + "ListEndpointsRequest":{ + "type":"structure", + "members":{ + "NamePrefix":{"shape":"EndpointName"}, + "HomeRegion":{"shape":"HomeRegion"}, + "NextToken":{"shape":"NextToken"}, + "MaxResults":{"shape":"LimitMax100"} + } + }, + "ListEndpointsResponse":{ + "type":"structure", + "members":{ + "Endpoints":{"shape":"EndpointList"}, + "NextToken":{"shape":"NextToken"} + } + }, "ListEventBusesRequest":{ "type":"structure", "members":{ @@ -1976,7 +2245,10 @@ "max":185, "min":0 }, - "MessageGroupId":{"type":"string"}, + "MessageGroupId":{ + "type":"string", + "max":100 + }, "NetworkConfiguration":{ "type":"structure", "members":{ @@ -1988,6 +2260,12 @@ "max":2048, "min":1 }, + "NonPartnerEventBusArn":{ + "type":"string", + "max":512, + "min":1, + "pattern":"^arn:aws[a-z-]*:events:[a-z]{2}-[a-z-]+-\\d+:\\d{12}:event-bus/[\\w.-]+$" + }, "NonPartnerEventBusName":{ "type":"string", "max":256, @@ -2097,6 +2375,13 @@ }, "exception":true }, + "Primary":{ + "type":"structure", + "required":["HealthCheck"], + "members":{ + "HealthCheck":{"shape":"HealthCheck"} + } + }, "Principal":{ "type":"string", "max":12, @@ -2111,7 +2396,8 @@ "type":"structure", "required":["Entries"], "members":{ - "Entries":{"shape":"PutEventsRequestEntryList"} + "Entries":{"shape":"PutEventsRequestEntryList"}, + "EndpointId":{"shape":"EndpointId"} } }, "PutEventsRequestEntry":{ @@ -2398,6 +2684,19 @@ "max":512, "pattern":".*" }, + "ReplicationConfig":{ + "type":"structure", + "members":{ + "State":{"shape":"ReplicationState"} + } + }, + "ReplicationState":{ + "type":"string", + "enum":[ + "ENABLED", + "DISABLED" + ] + }, "ResourceAlreadyExistsException":{ "type":"structure", "members":{ @@ -2431,6 +2730,19 @@ "max":1600, "min":1 }, + "Route":{ + "type":"string", + "max":20, + "min":9, + "pattern":"^[\\-a-z0-9]+$" + }, + "RoutingConfig":{ + "type":"structure", + "required":["FailoverConfig"], + "members":{ + "FailoverConfig":{"shape":"FailoverConfig"} + } + }, "Rule":{ "type":"structure", "members":{ @@ -2553,6 +2865,13 @@ "type":"string", "max":256 }, + "Secondary":{ + "type":"structure", + "required":["Route"], + "members":{ + "Route":{"shape":"Route"} + } + }, "SecretsManagerSecretArn":{ "type":"string", "max":2048, @@ -2866,6 +3185,32 @@ "LastModifiedTime":{"shape":"Timestamp"}, "LastAuthorizedTime":{"shape":"Timestamp"} } + }, + "UpdateEndpointRequest":{ + "type":"structure", + "required":["Name"], + "members":{ + "Name":{"shape":"EndpointName"}, + "Description":{"shape":"EndpointDescription"}, + "RoutingConfig":{"shape":"RoutingConfig"}, + "ReplicationConfig":{"shape":"ReplicationConfig"}, + "EventBuses":{"shape":"EndpointEventBusList"}, + "RoleArn":{"shape":"IamRoleArn"} + } + }, + "UpdateEndpointResponse":{ + "type":"structure", + "members":{ + "Name":{"shape":"EndpointName"}, + "Arn":{"shape":"EndpointArn"}, + "RoutingConfig":{"shape":"RoutingConfig"}, + "ReplicationConfig":{"shape":"ReplicationConfig"}, + "EventBuses":{"shape":"EndpointEventBusList"}, + "RoleArn":{"shape":"IamRoleArn"}, + "EndpointId":{"shape":"EndpointId"}, + "EndpointUrl":{"shape":"EndpointUrl"}, + "State":{"shape":"EndpointState"} + } } } } diff --git a/models/apis/eventbridge/2015-10-07/docs-2.json b/models/apis/eventbridge/2015-10-07/docs-2.json index ed0b882f4ad..40155807f80 100644 --- a/models/apis/eventbridge/2015-10-07/docs-2.json +++ b/models/apis/eventbridge/2015-10-07/docs-2.json @@ -7,6 +7,7 @@ "CreateApiDestination": "

Creates an API destination, which is an HTTP invocation endpoint configured as a target for events.

", "CreateArchive": "

Creates an archive of events with the specified settings. When you create an archive, incoming events might not immediately start being sent to the archive. Allow a short period of time for changes to take effect. If you do not specify a pattern to filter events sent to the archive, all events are sent to the archive except replayed events. Replayed events are not sent to an archive.

", "CreateConnection": "

Creates a connection. A connection defines the authorization type and credentials to use for authorization with an API destination HTTP endpoint.

", + "CreateEndpoint": "

Creates a global endpoint. Global endpoints improve your application's availability by making it regional-fault tolerant. To do this, you define a primary and secondary Region with event buses in each Region. You also create a Amazon Route 53 health check that will tell EventBridge to route events to the secondary Region when an \"unhealthy\" state is encountered and events will be routed back to the primary Region when the health check reports a \"healthy\" state.

", "CreateEventBus": "

Creates a new event bus within your account. This can be a custom event bus which you can use to receive events from your custom applications and services, or it can be a partner event bus which can be matched to a partner event source.

", "CreatePartnerEventSource": "

Called by an SaaS partner to create a partner event source. This operation is not used by Amazon Web Services customers.

Each partner event source can be used by one Amazon Web Services account to create a matching partner event bus in that Amazon Web Services account. A SaaS partner must create one partner event source for each Amazon Web Services account that wants to receive those event types.

A partner event source creates events based on resources within the SaaS partner's service or application.

An Amazon Web Services account that creates a partner event bus that matches the partner event source can use that event bus to receive events from the partner, and then process them using Amazon Web Services Events rules and targets.

Partner event source names follow this format:

partner_name/event_namespace/event_name

partner_name is determined during partner registration and identifies the partner to Amazon Web Services customers. event_namespace is determined by the partner and is a way for the partner to categorize their events. event_name is determined by the partner, and should uniquely identify an event-generating resource within the partner system. The combination of event_namespace and event_name should help Amazon Web Services customers decide whether to create an event bus to receive these events.

", "DeactivateEventSource": "

You can use this operation to temporarily stop receiving events from the specified partner event source. The matching event bus is not deleted.

When you deactivate a partner event source, the source goes into PENDING state. If it remains in PENDING state for more than two weeks, it is deleted.

To activate a deactivated partner event source, use ActivateEventSource.

", @@ -14,12 +15,14 @@ "DeleteApiDestination": "

Deletes the specified API destination.

", "DeleteArchive": "

Deletes the specified archive.

", "DeleteConnection": "

Deletes a connection.

", + "DeleteEndpoint": "

Delete an existing global endpoint. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide.

", "DeleteEventBus": "

Deletes the specified custom event bus or partner event bus. All rules associated with this event bus need to be deleted. You can't delete your account's default event bus.

", "DeletePartnerEventSource": "

This operation is used by SaaS partners to delete a partner event source. This operation is not used by Amazon Web Services customers.

When you delete an event source, the status of the corresponding partner event bus in the Amazon Web Services customer account becomes DELETED.

", "DeleteRule": "

Deletes the specified rule.

Before you can delete the rule, you must remove all targets, using RemoveTargets.

When you delete a rule, incoming events might continue to match to the deleted rule. Allow a short period of time for changes to take effect.

If you call delete rule multiple times for the same rule, all calls will succeed. When you call delete rule for a non-existent custom eventbus, ResourceNotFoundException is returned.

Managed rules are rules created and managed by another Amazon Web Services service on your behalf. These rules are created by those other Amazon Web Services services to support functionality in those services. You can delete these rules using the Force option, but you should do so only if you are sure the other service is not still using that rule.

", "DescribeApiDestination": "

Retrieves details about an API destination.

", "DescribeArchive": "

Retrieves details about an archive.

", "DescribeConnection": "

Retrieves details about a connection.

", + "DescribeEndpoint": "

Get the information about an existing global endpoint. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide..

", "DescribeEventBus": "

Displays details about an event bus in your account. This can include the external Amazon Web Services accounts that are permitted to write events to your default event bus, and the associated policy. For custom event buses and partner event buses, it displays the name, ARN, policy, state, and creation time.

To enable your account to receive events from other accounts on its default event bus, use PutPermission.

For more information about partner event buses, see CreateEventBus.

", "DescribeEventSource": "

This operation lists details about a partner event source that is shared with your account.

", "DescribePartnerEventSource": "

An SaaS partner can use this operation to list details about a partner event source that they have created. Amazon Web Services customers do not use this operation. Instead, Amazon Web Services customers can use DescribeEventSource to see details about a partner event source that is shared with them.

", @@ -30,6 +33,7 @@ "ListApiDestinations": "

Retrieves a list of API destination in the account in the current Region.

", "ListArchives": "

Lists your archives. You can either list all the archives or you can provide a prefix to match to the archive names. Filter parameters are exclusive.

", "ListConnections": "

Retrieves a list of connections from the account.

", + "ListEndpoints": "

List the global endpoints associated with this account. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide..

", "ListEventBuses": "

Lists all the event buses in your account, including the default event bus, custom event buses, and partner event buses.

", "ListEventSources": "

You can use this to see all the partner event sources that have been shared with your Amazon Web Services account. For more information about partner event sources, see CreateEventBus.

", "ListPartnerEventSourceAccounts": "

An SaaS partner can use this operation to display the Amazon Web Services account ID that a particular partner event source name is associated with. This operation is not used by Amazon Web Services customers.

", @@ -39,11 +43,11 @@ "ListRules": "

Lists your Amazon EventBridge rules. You can either list all the rules or you can provide a prefix to match to the rule names.

ListRules does not list the targets of a rule. To see the targets associated with a rule, use ListTargetsByRule.

", "ListTagsForResource": "

Displays the tags associated with an EventBridge resource. In EventBridge, rules and event buses can be tagged.

", "ListTargetsByRule": "

Lists the targets assigned to the specified rule.

", - "PutEvents": "

Sends custom events to Amazon EventBridge so that they can be matched to rules.

", + "PutEvents": "

Sends custom events to Amazon EventBridge so that they can be matched to rules.

PutEvents will only process nested JSON up to 1100 levels deep.

", "PutPartnerEvents": "

This is used by SaaS partners to write events to a customer's partner event bus. Amazon Web Services customers do not use this operation.

", "PutPermission": "

Running PutPermission permits the specified Amazon Web Services account or Amazon Web Services organization to put events to the specified event bus. Amazon EventBridge (CloudWatch Events) rules in your account are triggered by these events arriving to an event bus in your account.

For another account to send events to your account, that external account must have an EventBridge rule with your account's event bus as a target.

To enable multiple Amazon Web Services accounts to put events to your event bus, run PutPermission once for each of these accounts. Or, if all the accounts are members of the same Amazon Web Services organization, you can run PutPermission once specifying Principal as \"*\" and specifying the Amazon Web Services organization ID in Condition, to grant permissions to all accounts in that organization.

If you grant permissions using an organization, then accounts in that organization must specify a RoleArn with proper permissions when they use PutTarget to add your account's event bus as a target. For more information, see Sending and Receiving Events Between Amazon Web Services Accounts in the Amazon EventBridge User Guide.

The permission policy on the event bus cannot exceed 10 KB in size.

", "PutRule": "

Creates or updates the specified rule. Rules are enabled by default, or based on value of the state. You can disable a rule using DisableRule.

A single rule watches for events from a single event bus. Events generated by Amazon Web Services services go to your account's default event bus. Events generated by SaaS partner services or applications go to the matching partner event bus. If you have custom applications or services, you can specify whether their events go to your default event bus or a custom event bus that you have created. For more information, see CreateEventBus.

If you are updating an existing rule, the rule is replaced with what you specify in this PutRule command. If you omit arguments in PutRule, the old values for those arguments are not kept. Instead, they are replaced with null values.

When you create or update a rule, incoming events might not immediately start matching to new or updated rules. Allow a short period of time for changes to take effect.

A rule must contain at least an EventPattern or ScheduleExpression. Rules with EventPatterns are triggered when a matching event is observed. Rules with ScheduleExpressions self-trigger based on the given schedule. A rule can have both an EventPattern and a ScheduleExpression, in which case the rule triggers on matching events as well as on a schedule.

When you initially create a rule, you can optionally assign one or more tags to the rule. Tags can help you organize and categorize your resources. You can also use them to scope user permissions, by granting a user permission to access or change only rules with certain tag values. To use the PutRule operation and assign tags, you must have both the events:PutRule and events:TagResource permissions.

If you are updating an existing rule, any tags you specify in the PutRule operation are ignored. To update the tags of an existing rule, use TagResource and UntagResource.

Most services in Amazon Web Services treat : or / as the same character in Amazon Resource Names (ARNs). However, EventBridge uses an exact match in event patterns and rules. Be sure to use the correct ARN characters when creating event patterns so that they match the ARN syntax in the event you want to match.

In EventBridge, it is possible to create rules that lead to infinite loops, where a rule is fired repeatedly. For example, a rule might detect that ACLs have changed on an S3 bucket, and trigger software to change them to the desired state. If the rule is not written carefully, the subsequent change to the ACLs fires the rule again, creating an infinite loop.

To prevent this, write the rules so that the triggered actions do not re-fire the same rule. For example, your rule could fire only if ACLs are found to be in a bad state, instead of after any change.

An infinite loop can quickly cause higher than expected charges. We recommend that you use budgeting, which alerts you when charges exceed your specified limit. For more information, see Managing Your Costs with Budgets.

", - "PutTargets": "

Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule.

Targets are the resources that are invoked when a rule is triggered.

Each rule can have up to five (5) targets associated with it at one time.

You can configure the following as targets for Events:

Creating rules with built-in targets is supported only in the Amazon Web Services Management Console. The built-in targets are EC2 CreateSnapshot API call, EC2 RebootInstances API call, EC2 StopInstances API call, and EC2 TerminateInstances API call.

For some target types, PutTargets provides target-specific parameters. If the target is a Kinesis data stream, you can optionally specify which shard the event goes to by using the KinesisParameters argument. To invoke a command on multiple EC2 instances with one rule, you can use the RunCommandParameters field.

To be able to make API calls against the resources that you own, Amazon EventBridge needs the appropriate permissions. For Lambda and Amazon SNS resources, EventBridge relies on resource-based policies. For EC2 instances, Kinesis Data Streams, Step Functions state machines and API Gateway REST APIs, EventBridge relies on IAM roles that you specify in the RoleARN argument in PutTargets. For more information, see Authentication and Access Control in the Amazon EventBridge User Guide.

If another Amazon Web Services account is in the same region and has granted you permission (using PutPermission), you can send events to that account. Set that account's event bus as a target of the rules in your account. To send the matched events to the other account, specify that account's event bus as the Arn value when you run PutTargets. If your account sends events to another account, your account is charged for each sent event. Each event sent to another account is charged as a custom event. The account receiving the event is not charged. For more information, see Amazon EventBridge Pricing.

Input, InputPath, and InputTransformer are not available with PutTarget if the target is an event bus of a different Amazon Web Services account.

If you are setting the event bus of another account as the target, and that account granted permission to your account through an organization instead of directly by the account ID, then you must specify a RoleArn with proper permissions in the Target structure. For more information, see Sending and Receiving Events Between Amazon Web Services Accounts in the Amazon EventBridge User Guide.

For more information about enabling cross-account events, see PutPermission.

Input, InputPath, and InputTransformer are mutually exclusive and optional parameters of a target. When a rule is triggered due to a matched event:

When you specify InputPath or InputTransformer, you must use JSON dot notation, not bracket notation.

When you add targets to a rule and the associated rule triggers soon after, new or updated targets might not be immediately invoked. Allow a short period of time for changes to take effect.

This action can partially fail if too many requests are made at the same time. If that happens, FailedEntryCount is non-zero in the response and each entry in FailedEntries provides the ID of the failed target and the error code.

", + "PutTargets": "

Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule.

Targets are the resources that are invoked when a rule is triggered.

Each rule can have up to five (5) targets associated with it at one time.

You can configure the following as targets for Events:

Creating rules with built-in targets is supported only in the Amazon Web Services Management Console. The built-in targets are EC2 CreateSnapshot API call, EC2 RebootInstances API call, EC2 StopInstances API call, and EC2 TerminateInstances API call.

For some target types, PutTargets provides target-specific parameters. If the target is a Kinesis data stream, you can optionally specify which shard the event goes to by using the KinesisParameters argument. To invoke a command on multiple EC2 instances with one rule, you can use the RunCommandParameters field.

To be able to make API calls against the resources that you own, Amazon EventBridge needs the appropriate permissions. For Lambda and Amazon SNS resources, EventBridge relies on resource-based policies. For EC2 instances, Kinesis Data Streams, Step Functions state machines and API Gateway REST APIs, EventBridge relies on IAM roles that you specify in the RoleARN argument in PutTargets. For more information, see Authentication and Access Control in the Amazon EventBridge User Guide.

If another Amazon Web Services account is in the same region and has granted you permission (using PutPermission), you can send events to that account. Set that account's event bus as a target of the rules in your account. To send the matched events to the other account, specify that account's event bus as the Arn value when you run PutTargets. If your account sends events to another account, your account is charged for each sent event. Each event sent to another account is charged as a custom event. The account receiving the event is not charged. For more information, see Amazon EventBridge Pricing.

Input, InputPath, and InputTransformer are not available with PutTarget if the target is an event bus of a different Amazon Web Services account.

If you are setting the event bus of another account as the target, and that account granted permission to your account through an organization instead of directly by the account ID, then you must specify a RoleArn with proper permissions in the Target structure. For more information, see Sending and Receiving Events Between Amazon Web Services Accounts in the Amazon EventBridge User Guide.

For more information about enabling cross-account events, see PutPermission.

Input, InputPath, and InputTransformer are mutually exclusive and optional parameters of a target. When a rule is triggered due to a matched event:

When you specify InputPath or InputTransformer, you must use JSON dot notation, not bracket notation.

When you add targets to a rule and the associated rule triggers soon after, new or updated targets might not be immediately invoked. Allow a short period of time for changes to take effect.

This action can partially fail if too many requests are made at the same time. If that happens, FailedEntryCount is non-zero in the response and each entry in FailedEntries provides the ID of the failed target and the error code.

", "RemovePermission": "

Revokes the permission of another Amazon Web Services account to be able to put events to the specified event bus. Specify the account to revoke by the StatementId value that you associated with the account when you granted it permission with PutPermission. You can find the StatementId by using DescribeEventBus.

", "RemoveTargets": "

Removes the specified targets from the specified rule. When the rule is triggered, those targets are no longer be invoked.

A successful execution of RemoveTargets doesn't guarantee all targets are removed from the rule, it means that the target(s) listed in the request are removed.

When you remove a target, when the associated rule triggers, removed targets might continue to be invoked. Allow a short period of time for changes to take effect.

This action can partially fail if too many requests are made at the same time. If that happens, FailedEntryCount is non-zero in the response and each entry in FailedEntries provides the ID of the failed target and the error code.

", "StartReplay": "

Starts the specified replay. Events are not necessarily replayed in the exact same order that they were added to the archive. A replay processes events to replay based on the time in the event, and replays them using 1 minute intervals. If you specify an EventStartTime and an EventEndTime that covers a 20 minute time range, the events are replayed from the first minute of that 20 minute range first. Then the events from the second minute are replayed. You can use DescribeReplay to determine the progress of a replay. The value returned for EventLastReplayedTime indicates the time within the specified time range associated with the last event replayed.

", @@ -52,7 +56,8 @@ "UntagResource": "

Removes one or more tags from the specified EventBridge resource. In Amazon EventBridge (CloudWatch Events), rules and event buses can be tagged.

", "UpdateApiDestination": "

Updates an API destination.

", "UpdateArchive": "

Updates the specified archive.

", - "UpdateConnection": "

Updates settings for a connection.

" + "UpdateConnection": "

Updates settings for a connection.

", + "UpdateEndpoint": "

Update an existing endpoint. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide..

" }, "shapes": { "AccountId": { @@ -558,6 +563,16 @@ "refs": { } }, + "CreateEndpointRequest": { + "base": null, + "refs": { + } + }, + "CreateEndpointResponse": { + "base": null, + "refs": { + } + }, "CreateEventBusRequest": { "base": null, "refs": { @@ -647,6 +662,16 @@ "refs": { } }, + "DeleteEndpointRequest": { + "base": null, + "refs": { + } + }, + "DeleteEndpointResponse": { + "base": null, + "refs": { + } + }, "DeleteEventBusRequest": { "base": null, "refs": { @@ -692,6 +717,16 @@ "refs": { } }, + "DescribeEndpointRequest": { + "base": null, + "refs": { + } + }, + "DescribeEndpointResponse": { + "base": null, + "refs": { + } + }, "DescribeEventBusRequest": { "base": null, "refs": { @@ -758,6 +793,100 @@ "refs": { } }, + "Endpoint": { + "base": "

An global endpoint used to improve your application's availability by making it regional-fault tolerant. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide..

", + "refs": { + "EndpointList$member": null + } + }, + "EndpointArn": { + "base": null, + "refs": { + "CreateEndpointResponse$Arn": "

The ARN of the endpoint that was created by this request.

", + "DescribeEndpointResponse$Arn": "

The ARN of the endpoint you asked for information about.

", + "Endpoint$Arn": "

The ARN of the endpoint.

", + "UpdateEndpointResponse$Arn": "

The ARN of the endpoint you updated in this request.

" + } + }, + "EndpointDescription": { + "base": null, + "refs": { + "CreateEndpointRequest$Description": "

A description of the global endpoint.

", + "DescribeEndpointResponse$Description": "

The description of the endpoint you asked for information about.

", + "Endpoint$Description": "

A description for the endpoint.

", + "UpdateEndpointRequest$Description": "

A description for the endpoint.

" + } + }, + "EndpointEventBus": { + "base": "

The event buses the endpoint is associated with.

", + "refs": { + "EndpointEventBusList$member": null + } + }, + "EndpointEventBusList": { + "base": null, + "refs": { + "CreateEndpointRequest$EventBuses": "

Define the event buses used.

The names of the event buses must be identical in each Region.

", + "CreateEndpointResponse$EventBuses": "

The event buses used by this request.

", + "DescribeEndpointResponse$EventBuses": "

The event buses being used by the endpoint you asked for information about.

", + "Endpoint$EventBuses": "

The event buses being used by the endpoint.

", + "UpdateEndpointRequest$EventBuses": "

Define event buses used for replication.

", + "UpdateEndpointResponse$EventBuses": "

The event buses used for replication for the endpoint you updated in this request.

" + } + }, + "EndpointId": { + "base": null, + "refs": { + "DescribeEndpointResponse$EndpointId": "

The ID of the endpoint you asked for information about.

", + "Endpoint$EndpointId": "

The URL subdomain of the endpoint. For example, if the URL for Endpoint is abcde.veo.endpoints.event.amazonaws.com, then the EndpointId is abcde.veo.

", + "PutEventsRequest$EndpointId": "

The URL subdomain of the endpoint. For example, if the URL for Endpoint is abcde.veo.endpoints.event.amazonaws.com, then the EndpointId is abcde.veo.

When using Java, you must include auth-crt on the class path.

", + "UpdateEndpointResponse$EndpointId": "

The ID of the endpoint you updated in this request.

" + } + }, + "EndpointList": { + "base": null, + "refs": { + "ListEndpointsResponse$Endpoints": "

The endpoints returned by the call.

" + } + }, + "EndpointName": { + "base": null, + "refs": { + "CreateEndpointRequest$Name": "

The name of the global endpoint. For example, \"Name\":\"us-east-2-custom_bus_A-endpoint\".

", + "CreateEndpointResponse$Name": "

The name of the endpoint that was created by this request.

", + "DeleteEndpointRequest$Name": "

The name of the endpoint you want to delete. For example, \"Name\":\"us-east-2-custom_bus_A-endpoint\"..

", + "DescribeEndpointRequest$Name": "

The name of the endpoint you want to get information about. For example, \"Name\":\"us-east-2-custom_bus_A-endpoint\".

", + "DescribeEndpointResponse$Name": "

The name of the endpoint you asked for information about.

", + "Endpoint$Name": "

The name of the endpoint.

", + "ListEndpointsRequest$NamePrefix": "

A value that will return a subset of the endpoints associated with this account. For example, \"NamePrefix\": \"ABC\" will return all endpoints with \"ABC\" in the name.

", + "UpdateEndpointRequest$Name": "

The name of the endpoint you want to update.

", + "UpdateEndpointResponse$Name": "

The name of the endpoint you updated in this request.

" + } + }, + "EndpointState": { + "base": null, + "refs": { + "CreateEndpointResponse$State": "

The state of the endpoint that was created by this request.

", + "DescribeEndpointResponse$State": "

The current state of the endpoint you asked for information about.

", + "Endpoint$State": "

The current state of the endpoint.

", + "UpdateEndpointResponse$State": "

The state of the endpoint you updated in this request.

" + } + }, + "EndpointStateReason": { + "base": null, + "refs": { + "DescribeEndpointResponse$StateReason": "

The reason the endpoint you asked for information about is in its current state.

", + "Endpoint$StateReason": "

The reason the endpoint is in its current state.

" + } + }, + "EndpointUrl": { + "base": null, + "refs": { + "DescribeEndpointResponse$EndpointUrl": "

The URL of the endpoint you asked for information about.

", + "Endpoint$EndpointUrl": "

The URL of the endpoint.

", + "UpdateEndpointResponse$EndpointUrl": "

The URL of the endpoint you updated in this request.

" + } + }, "ErrorCode": { "base": null, "refs": { @@ -827,7 +956,7 @@ "CreateArchiveRequest$EventPattern": "

An event pattern to use to filter events sent to the archive.

", "DescribeArchiveResponse$EventPattern": "

The event pattern used to filter events sent to the archive.

", "DescribeRuleResponse$EventPattern": "

The event pattern. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.

", - "PutRuleRequest$EventPattern": "

The event pattern. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.

", + "PutRuleRequest$EventPattern": "

The event pattern. For more information, see EventBridge event patterns in the Amazon EventBridge User Guide.

", "Rule$EventPattern": "

The event pattern of the rule. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.

", "TestEventPatternRequest$EventPattern": "

The event pattern. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.

", "UpdateArchiveRequest$EventPattern": "

The event pattern to use to filter events sent to the archive.

" @@ -893,6 +1022,12 @@ "PutPartnerEventsRequestEntry$Time": "

The date and time of the event.

" } }, + "FailoverConfig": { + "base": "

The failover configuration for an endpoint. This includes what triggers failover and what happens when it's triggered.

", + "refs": { + "RoutingConfig$FailoverConfig": "

The failover configuration for an endpoint. This includes what triggers failover and what happens when it's triggered.

" + } + }, "HeaderKey": { "base": null, "refs": { @@ -913,6 +1048,19 @@ "HeaderParametersMap$value": null } }, + "HealthCheck": { + "base": null, + "refs": { + "Primary$HealthCheck": "

The ARN of the health check used by the endpoint to determine whether failover is triggered.

" + } + }, + "HomeRegion": { + "base": null, + "refs": { + "DescribeEndpointRequest$HomeRegion": "

The primary Region of the endpoint you want to get information about. For example \"HomeRegion\": \"us-east-1\".

", + "ListEndpointsRequest$HomeRegion": "

The primary Region of the endpoints associated with this account. For example \"HomeRegion\": \"us-east-1\".

" + } + }, "HttpParameters": { "base": "

These are custom parameter to be used when the target is an API Gateway REST APIs or EventBridge ApiDestinations. In the latter case, these are merged with any InvocationParameters specified on the Connection, with any values from the Connection taking precedence.

", "refs": { @@ -931,6 +1079,17 @@ "UpdateConnectionOAuthRequestParameters$AuthorizationEndpoint": "

The URL to the authorization endpoint when OAuth is specified as the authorization type.

" } }, + "IamRoleArn": { + "base": null, + "refs": { + "CreateEndpointRequest$RoleArn": "

The ARN of the role used for replication.

", + "CreateEndpointResponse$RoleArn": "

The ARN of the role used by event replication for this request.

", + "DescribeEndpointResponse$RoleArn": "

The ARN of the role used by the endpoint you asked for information about.

", + "Endpoint$RoleArn": "

The ARN of the role used by event replication for the endpoint.

", + "UpdateEndpointRequest$RoleArn": "

The ARN of the role used by event replication for this request.

", + "UpdateEndpointResponse$RoleArn": "

The ARN of the role used by event replication for the endpoint you updated in this request.

" + } + }, "IllegalStatusException": { "base": "

An error occurred because a replay can be canceled only when the state is Running or Starting.

", "refs": { @@ -997,6 +1156,7 @@ "ListApiDestinationsRequest$Limit": "

The maximum number of API destinations to include in the response.

", "ListArchivesRequest$Limit": "

The maximum number of results to return.

", "ListConnectionsRequest$Limit": "

The maximum number of connections to return.

", + "ListEndpointsRequest$MaxResults": "

The maximum number of results returned by the call.

", "ListEventBusesRequest$Limit": "

Specifying this limits the number of results returned by this operation. The operation also returns a NextToken which you can use in a subsequent operation to retrieve the next set of results.

", "ListEventSourcesRequest$Limit": "

Specifying this limits the number of results returned by this operation. The operation also returns a NextToken which you can use in a subsequent operation to retrieve the next set of results.

", "ListPartnerEventSourceAccountsRequest$Limit": "

Specifying this limits the number of results returned by this operation. The operation also returns a NextToken which you can use in a subsequent operation to retrieve the next set of results.

", @@ -1043,6 +1203,16 @@ "refs": { } }, + "ListEndpointsRequest": { + "base": null, + "refs": { + } + }, + "ListEndpointsResponse": { + "base": null, + "refs": { + } + }, "ListEventBusesRequest": { "base": null, "refs": { @@ -1187,6 +1357,8 @@ "ListArchivesResponse$NextToken": "

The token returned by a previous call to retrieve the next set of results.

", "ListConnectionsRequest$NextToken": "

The token returned by a previous call to retrieve the next set of results.

", "ListConnectionsResponse$NextToken": "

A token you can use in a subsequent request to retrieve the next set of results.

", + "ListEndpointsRequest$NextToken": "

If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error.

", + "ListEndpointsResponse$NextToken": "

If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error.

", "ListEventBusesRequest$NextToken": "

The token returned by a previous call to retrieve the next set of results.

", "ListEventBusesResponse$NextToken": "

A token you can use in a subsequent operation to retrieve the next set of results.

", "ListEventSourcesRequest$NextToken": "

The token returned by a previous call to retrieve the next set of results.

", @@ -1205,6 +1377,12 @@ "ListTargetsByRuleResponse$NextToken": "

Indicates whether there are additional results to retrieve. If there are no more results, the value is null.

" } }, + "NonPartnerEventBusArn": { + "base": null, + "refs": { + "EndpointEventBus$EventBusArn": "

The ARN of the event bus the endpoint is associated with.

" + } + }, "NonPartnerEventBusName": { "base": null, "refs": { @@ -1215,7 +1393,7 @@ "NonPartnerEventBusNameOrArn": { "base": null, "refs": { - "PutEventsRequestEntry$EventBusName": "

The name or ARN of the event bus to receive the event. Only the rules that are associated with this event bus are used to match the event. If you omit this, the default event bus is used.

" + "PutEventsRequestEntry$EventBusName": "

The name or ARN of the event bus to receive the event. Only the rules that are associated with this event bus are used to match the event. If you omit this, the default event bus is used.

If you're using a global endpoint with a custom bus, you must enter the name, not the ARN, of the event bus in either the primary or secondary Region here and the corresponding event bus in the other Region will be determined based on the endpoint referenced by the EndpointId.

" } }, "OperationDisabledException": { @@ -1318,6 +1496,12 @@ "refs": { } }, + "Primary": { + "base": "

The primary Region of the endpoint.

", + "refs": { + "FailoverConfig$Primary": "

The main Region of the endpoint.

" + } + }, "Principal": { "base": null, "refs": { @@ -1570,6 +1754,23 @@ "StartReplayResponse$StateReason": "

The reason that the replay is in the state.

" } }, + "ReplicationConfig": { + "base": "

Endpoints can replicate all events to the secondary Region.

", + "refs": { + "CreateEndpointRequest$ReplicationConfig": "

Enable or disable event replication.

", + "CreateEndpointResponse$ReplicationConfig": "

Whether event replication was enabled or disabled by this request.

", + "DescribeEndpointResponse$ReplicationConfig": "

Whether replication is enabled or disabled for the endpoint you asked for information about.

", + "Endpoint$ReplicationConfig": "

Whether event replication was enabled or disabled for this endpoint.

", + "UpdateEndpointRequest$ReplicationConfig": "

Whether event replication was enabled or disabled by this request.

", + "UpdateEndpointResponse$ReplicationConfig": "

Whether event replication was enabled or disabled for the endpoint you updated in this request.

" + } + }, + "ReplicationState": { + "base": null, + "refs": { + "ReplicationConfig$State": "

The state of event replication.

" + } + }, "ResourceAlreadyExistsException": { "base": "

The resource you are trying to create already exists.

", "refs": { @@ -1610,6 +1811,23 @@ "Target$RoleArn": "

The Amazon Resource Name (ARN) of the IAM role to be used for this target when the rule is triggered. If one rule triggers multiple targets, you can use a different IAM role for each target.

" } }, + "Route": { + "base": null, + "refs": { + "Secondary$Route": "

Defines the secondary Region.

" + } + }, + "RoutingConfig": { + "base": "

The routing configuration of the endpoint.

", + "refs": { + "CreateEndpointRequest$RoutingConfig": "

Configure the routing policy, including the health check and secondary Region..

", + "CreateEndpointResponse$RoutingConfig": "

The routing configuration defined by this request.

", + "DescribeEndpointResponse$RoutingConfig": "

The routing configuration of the endpoint you asked for information about.

", + "Endpoint$RoutingConfig": "

The routing configuration of the endpoint.

", + "UpdateEndpointRequest$RoutingConfig": "

Configure the routing policy, including the health check and secondary Region..

", + "UpdateEndpointResponse$RoutingConfig": "

The routing configuration you updated in this request.

" + } + }, "Rule": { "base": "

Contains information about a rule in Amazon EventBridge.

", "refs": { @@ -1743,6 +1961,12 @@ "Rule$ScheduleExpression": "

The scheduling expression. For example, \"cron(0 20 * * ? *)\", \"rate(5 minutes)\". For more information, see Creating an Amazon EventBridge rule that runs on a schedule.

" } }, + "Secondary": { + "base": "

The secondary Region that processes events when failover is triggered or replication is enabled.

", + "refs": { + "FailoverConfig$Secondary": "

The Region that events are routed to when failover is triggered or event replication is enabled.

" + } + }, "SecretsManagerSecretArn": { "base": null, "refs": { @@ -1816,7 +2040,7 @@ "PartnerEventSource$Name": "

The name of the partner event source.

", "PutEventsRequestEntry$Source": "

The source of the event.

", "PutEventsRequestEntry$DetailType": "

Free-form string used to decide what fields to expect in the event detail.

", - "PutEventsRequestEntry$Detail": "

A valid JSON string. There is no other schema imposed. The JSON string may contain fields and nested subobjects.

", + "PutEventsRequestEntry$Detail": "

A valid JSON object. There is no other schema imposed. The JSON object may contain fields and nested subobjects.

", "PutPartnerEventsRequestEntry$DetailType": "

A free-form string used to decide what fields to expect in the event detail.

", "PutPartnerEventsRequestEntry$Detail": "

A valid JSON string. There is no other schema imposed. The JSON string may contain fields and nested subobjects.

", "PutPermissionRequest$Policy": "

A JSON string that describes the permission policy statement. You can include a Policy parameter in the request instead of using the StatementId, Action, Principal, or Condition parameters.

", @@ -1966,6 +2190,8 @@ "DescribeConnectionResponse$CreationTime": "

A time stamp for the time that the connection was created.

", "DescribeConnectionResponse$LastModifiedTime": "

A time stamp for the time that the connection was last modified.

", "DescribeConnectionResponse$LastAuthorizedTime": "

A time stamp for the time that the connection was last authorized.

", + "DescribeEndpointResponse$CreationTime": "

The time the endpoint you asked for information about was created.

", + "DescribeEndpointResponse$LastModifiedTime": "

The last time the endpoint you asked for information about was modified.

", "DescribeEventSourceResponse$CreationTime": "

The date and time that the event source was created.

", "DescribeEventSourceResponse$ExpirationTime": "

The date and time that the event source will expire if you do not create a matching event bus.

", "DescribeReplayResponse$EventStartTime": "

The time stamp of the first event that was last replayed from the archive.

", @@ -1973,6 +2199,8 @@ "DescribeReplayResponse$EventLastReplayedTime": "

The time that the event was last replayed.

", "DescribeReplayResponse$ReplayStartTime": "

A time stamp for the time that the replay started.

", "DescribeReplayResponse$ReplayEndTime": "

A time stamp for the time that the replay stopped.

", + "Endpoint$CreationTime": "

The time the endpoint was created.

", + "Endpoint$LastModifiedTime": "

The last time the endpoint was modified.

", "EventSource$CreationTime": "

The date and time the event source was created.

", "EventSource$ExpirationTime": "

The date and time that the event source will expire, if the Amazon Web Services account doesn't create a matching event bus for it.

", "PartnerEventSourceAccount$CreationTime": "

The date and time the event source was created.

", @@ -2080,6 +2308,16 @@ "base": null, "refs": { } + }, + "UpdateEndpointRequest": { + "base": null, + "refs": { + } + }, + "UpdateEndpointResponse": { + "base": null, + "refs": { + } } } } diff --git a/models/apis/personalize/2018-05-22/api-2.json b/models/apis/personalize/2018-05-22/api-2.json index f1d42648b11..c357c5dbdc8 100644 --- a/models/apis/personalize/2018-05-22/api-2.json +++ b/models/apis/personalize/2018-05-22/api-2.json @@ -26,7 +26,8 @@ {"shape":"ResourceAlreadyExistsException"}, {"shape":"LimitExceededException"}, {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"} + {"shape":"ResourceInUseException"}, + {"shape":"TooManyTagsException"} ] }, "CreateBatchSegmentJob":{ @@ -42,7 +43,8 @@ {"shape":"ResourceAlreadyExistsException"}, {"shape":"LimitExceededException"}, {"shape":"ResourceNotFoundException"}, - {"shape":"ResourceInUseException"} + {"shape":"ResourceInUseException"}, + {"shape":"TooManyTagsException"} ] }, "CreateCampaign":{ @@ -58,7 +60,8 @@ {"shape":"ResourceNotFoundException"}, {"shape":"ResourceAlreadyExistsException"}, {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"} + {"shape":"ResourceInUseException"}, + {"shape":"TooManyTagsException"} ], "idempotent":true }, @@ -75,7 +78,8 @@ {"shape":"ResourceNotFoundException"}, {"shape":"ResourceAlreadyExistsException"}, {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"} + {"shape":"ResourceInUseException"}, + {"shape":"TooManyTagsException"} ], "idempotent":true }, @@ -92,7 +96,8 @@ {"shape":"ResourceNotFoundException"}, {"shape":"ResourceAlreadyExistsException"}, {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"} + {"shape":"ResourceInUseException"}, + {"shape":"TooManyTagsException"} ], "idempotent":true }, @@ -107,7 +112,8 @@ "errors":[ {"shape":"InvalidInputException"}, {"shape":"ResourceAlreadyExistsException"}, - {"shape":"LimitExceededException"} + {"shape":"LimitExceededException"}, + {"shape":"TooManyTagsException"} ] }, "CreateDatasetImportJob":{ @@ -123,7 +129,8 @@ {"shape":"ResourceNotFoundException"}, {"shape":"ResourceAlreadyExistsException"}, {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"} + {"shape":"ResourceInUseException"}, + {"shape":"TooManyTagsException"} ] }, "CreateEventTracker":{ @@ -139,7 +146,8 @@ {"shape":"ResourceAlreadyExistsException"}, {"shape":"ResourceNotFoundException"}, {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"} + {"shape":"ResourceInUseException"}, + {"shape":"TooManyTagsException"} ], "idempotent":true }, @@ -155,7 +163,8 @@ {"shape":"InvalidInputException"}, {"shape":"ResourceAlreadyExistsException"}, {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"} + {"shape":"LimitExceededException"}, + {"shape":"TooManyTagsException"} ] }, "CreateRecommender":{ @@ -170,7 +179,8 @@ {"shape":"InvalidInputException"}, {"shape":"ResourceAlreadyExistsException"}, {"shape":"ResourceNotFoundException"}, - {"shape":"LimitExceededException"} + {"shape":"LimitExceededException"}, + {"shape":"TooManyTagsException"} ], "idempotent":true }, @@ -202,7 +212,8 @@ {"shape":"ResourceAlreadyExistsException"}, {"shape":"ResourceNotFoundException"}, {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"} + {"shape":"ResourceInUseException"}, + {"shape":"TooManyTagsException"} ] }, "CreateSolutionVersion":{ @@ -217,7 +228,8 @@ {"shape":"InvalidInputException"}, {"shape":"ResourceNotFoundException"}, {"shape":"LimitExceededException"}, - {"shape":"ResourceInUseException"} + {"shape":"ResourceInUseException"}, + {"shape":"TooManyTagsException"} ] }, "DeleteCampaign":{ @@ -764,6 +776,20 @@ ], "idempotent":true }, + "ListTagsForResource":{ + "name":"ListTagsForResource", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListTagsForResourceRequest"}, + "output":{"shape":"ListTagsForResourceResponse"}, + "errors":[ + {"shape":"InvalidInputException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"ResourceInUseException"} + ] + }, "StopSolutionVersionCreation":{ "name":"StopSolutionVersionCreation", "http":{ @@ -778,6 +804,37 @@ ], "idempotent":true }, + "TagResource":{ + "name":"TagResource", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"TagResourceRequest"}, + "output":{"shape":"TagResourceResponse"}, + "errors":[ + {"shape":"InvalidInputException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"TooManyTagsException"}, + {"shape":"ResourceInUseException"}, + {"shape":"LimitExceededException"} + ] + }, + "UntagResource":{ + "name":"UntagResource", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"UntagResourceRequest"}, + "output":{"shape":"UntagResourceResponse"}, + "errors":[ + {"shape":"InvalidInputException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"TooManyTagKeysException"}, + {"shape":"ResourceInUseException"} + ] + }, "UpdateCampaign":{ "name":"UpdateCampaign", "http":{ @@ -1076,7 +1133,8 @@ "jobInput":{"shape":"BatchInferenceJobInput"}, "jobOutput":{"shape":"BatchInferenceJobOutput"}, "roleArn":{"shape":"RoleArn"}, - "batchInferenceJobConfig":{"shape":"BatchInferenceJobConfig"} + "batchInferenceJobConfig":{"shape":"BatchInferenceJobConfig"}, + "tags":{"shape":"Tags"} } }, "CreateBatchInferenceJobResponse":{ @@ -1101,7 +1159,8 @@ "numResults":{"shape":"NumBatchResults"}, "jobInput":{"shape":"BatchSegmentJobInput"}, "jobOutput":{"shape":"BatchSegmentJobOutput"}, - "roleArn":{"shape":"RoleArn"} + "roleArn":{"shape":"RoleArn"}, + "tags":{"shape":"Tags"} } }, "CreateBatchSegmentJobResponse":{ @@ -1120,7 +1179,8 @@ "name":{"shape":"Name"}, "solutionVersionArn":{"shape":"Arn"}, "minProvisionedTPS":{"shape":"TransactionsPerSecond"}, - "campaignConfig":{"shape":"CampaignConfig"} + "campaignConfig":{"shape":"CampaignConfig"}, + "tags":{"shape":"Tags"} } }, "CreateCampaignResponse":{ @@ -1142,7 +1202,8 @@ "datasetArn":{"shape":"Arn"}, "ingestionMode":{"shape":"IngestionMode"}, "roleArn":{"shape":"RoleArn"}, - "jobOutput":{"shape":"DatasetExportJobOutput"} + "jobOutput":{"shape":"DatasetExportJobOutput"}, + "tags":{"shape":"Tags"} } }, "CreateDatasetExportJobResponse":{ @@ -1158,7 +1219,8 @@ "name":{"shape":"Name"}, "roleArn":{"shape":"RoleArn"}, "kmsKeyArn":{"shape":"KmsKeyArn"}, - "domain":{"shape":"Domain"} + "domain":{"shape":"Domain"}, + "tags":{"shape":"Tags"} } }, "CreateDatasetGroupResponse":{ @@ -1180,7 +1242,8 @@ "jobName":{"shape":"Name"}, "datasetArn":{"shape":"Arn"}, "dataSource":{"shape":"DataSource"}, - "roleArn":{"shape":"RoleArn"} + "roleArn":{"shape":"RoleArn"}, + "tags":{"shape":"Tags"} } }, "CreateDatasetImportJobResponse":{ @@ -1201,7 +1264,8 @@ "name":{"shape":"Name"}, "schemaArn":{"shape":"Arn"}, "datasetGroupArn":{"shape":"Arn"}, - "datasetType":{"shape":"DatasetType"} + "datasetType":{"shape":"DatasetType"}, + "tags":{"shape":"Tags"} } }, "CreateDatasetResponse":{ @@ -1218,7 +1282,8 @@ ], "members":{ "name":{"shape":"Name"}, - "datasetGroupArn":{"shape":"Arn"} + "datasetGroupArn":{"shape":"Arn"}, + "tags":{"shape":"Tags"} } }, "CreateEventTrackerResponse":{ @@ -1238,7 +1303,8 @@ "members":{ "name":{"shape":"Name"}, "datasetGroupArn":{"shape":"Arn"}, - "filterExpression":{"shape":"FilterExpression"} + "filterExpression":{"shape":"FilterExpression"}, + "tags":{"shape":"Tags"} } }, "CreateFilterResponse":{ @@ -1258,7 +1324,8 @@ "name":{"shape":"Name"}, "datasetGroupArn":{"shape":"Arn"}, "recipeArn":{"shape":"Arn"}, - "recommenderConfig":{"shape":"RecommenderConfig"} + "recommenderConfig":{"shape":"RecommenderConfig"}, + "tags":{"shape":"Tags"} } }, "CreateRecommenderResponse":{ @@ -1298,7 +1365,8 @@ "recipeArn":{"shape":"Arn"}, "datasetGroupArn":{"shape":"Arn"}, "eventType":{"shape":"EventType"}, - "solutionConfig":{"shape":"SolutionConfig"} + "solutionConfig":{"shape":"SolutionConfig"}, + "tags":{"shape":"Tags"} } }, "CreateSolutionResponse":{ @@ -1312,7 +1380,8 @@ "required":["solutionArn"], "members":{ "solutionArn":{"shape":"Arn"}, - "trainingMode":{"shape":"TrainingMode"} + "trainingMode":{"shape":"TrainingMode"}, + "tags":{"shape":"Tags"} } }, "CreateSolutionVersionResponse":{ @@ -2231,6 +2300,19 @@ "nextToken":{"shape":"NextToken"} } }, + "ListTagsForResourceRequest":{ + "type":"structure", + "required":["resourceArn"], + "members":{ + "resourceArn":{"shape":"Arn"} + } + }, + "ListTagsForResourceResponse":{ + "type":"structure", + "members":{ + "tags":{"shape":"Tags"} + } + }, "MaxResults":{ "type":"integer", "max":100, @@ -2516,6 +2598,71 @@ "solutionVersionArn":{"shape":"Arn"} } }, + "Tag":{ + "type":"structure", + "required":[ + "tagKey", + "tagValue" + ], + "members":{ + "tagKey":{"shape":"TagKey"}, + "tagValue":{"shape":"TagValue"} + } + }, + "TagKey":{ + "type":"string", + "max":128, + "min":1, + "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" + }, + "TagKeys":{ + "type":"list", + "member":{"shape":"TagKey"}, + "max":200, + "min":0 + }, + "TagResourceRequest":{ + "type":"structure", + "required":[ + "resourceArn", + "tags" + ], + "members":{ + "resourceArn":{"shape":"Arn"}, + "tags":{"shape":"Tags"} + } + }, + "TagResourceResponse":{ + "type":"structure", + "members":{ + } + }, + "TagValue":{ + "type":"string", + "max":256, + "min":0, + "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" + }, + "Tags":{ + "type":"list", + "member":{"shape":"Tag"}, + "max":200, + "min":0 + }, + "TooManyTagKeysException":{ + "type":"structure", + "members":{ + "message":{"shape":"ErrorMessage"} + }, + "exception":true + }, + "TooManyTagsException":{ + "type":"structure", + "members":{ + "message":{"shape":"ErrorMessage"} + }, + "exception":true + }, "TrackingId":{ "type":"string", "max":256 @@ -2546,6 +2693,22 @@ "algorithmHyperParameters":{"shape":"HyperParameters"} } }, + "UntagResourceRequest":{ + "type":"structure", + "required":[ + "resourceArn", + "tagKeys" + ], + "members":{ + "resourceArn":{"shape":"Arn"}, + "tagKeys":{"shape":"TagKeys"} + } + }, + "UntagResourceResponse":{ + "type":"structure", + "members":{ + } + }, "UpdateCampaignRequest":{ "type":"structure", "required":["campaignArn"], diff --git a/models/apis/personalize/2018-05-22/docs-2.json b/models/apis/personalize/2018-05-22/docs-2.json index 17b477912d5..a6993ec93cc 100644 --- a/models/apis/personalize/2018-05-22/docs-2.json +++ b/models/apis/personalize/2018-05-22/docs-2.json @@ -2,60 +2,63 @@ "version": "2.0", "service": "

Amazon Personalize is a machine learning service that makes it easy to add individualized recommendations to customers.

", "operations": { - "CreateBatchInferenceJob": "

Creates a batch inference job. The operation can handle up to 50 million records and the input file must be in JSON format. For more information, see recommendations-batch.

", - "CreateBatchSegmentJob": "

Creates a batch segment job. The operation can handle up to 50 million records and the input file must be in JSON format. For more information, see recommendations-batch.

", - "CreateCampaign": "

Creates a campaign that deploys a solution version. When a client calls the GetRecommendations and GetPersonalizedRanking APIs, a campaign is specified in the request.

Minimum Provisioned TPS and Auto-Scaling

A transaction is a single GetRecommendations or GetPersonalizedRanking call. Transactions per second (TPS) is the throughput and unit of billing for Amazon Personalize. The minimum provisioned TPS (minProvisionedTPS) specifies the baseline throughput provisioned by Amazon Personalize, and thus, the minimum billing charge.

If your TPS increases beyond minProvisionedTPS, Amazon Personalize auto-scales the provisioned capacity up and down, but never below minProvisionedTPS. There's a short time delay while the capacity is increased that might cause loss of transactions.

The actual TPS used is calculated as the average requests/second within a 5-minute window. You pay for maximum of either the minimum provisioned TPS or the actual TPS. We recommend starting with a low minProvisionedTPS, track your usage using Amazon CloudWatch metrics, and then increase the minProvisionedTPS as necessary.

Status

A campaign can be in one of the following states:

To get the campaign status, call DescribeCampaign.

Wait until the status of the campaign is ACTIVE before asking the campaign for recommendations.

Related APIs

", - "CreateDataset": "

Creates an empty dataset and adds it to the specified dataset group. Use CreateDatasetImportJob to import your training data to a dataset.

There are three types of datasets:

Each dataset type has an associated schema with required field types. Only the Interactions dataset is required in order to train a model (also referred to as creating a solution).

A dataset can be in one of the following states:

To get the status of the dataset, call DescribeDataset.

Related APIs

", - "CreateDatasetExportJob": "

Creates a job that exports data from your dataset to an Amazon S3 bucket. To allow Amazon Personalize to export the training data, you must specify an service-linked IAM role that gives Amazon Personalize PutObject permissions for your Amazon S3 bucket. For information, see Exporting a dataset in the Amazon Personalize developer guide.

Status

A dataset export job can be in one of the following states:

To get the status of the export job, call DescribeDatasetExportJob, and specify the Amazon Resource Name (ARN) of the dataset export job. The dataset export is complete when the status shows as ACTIVE. If the status shows as CREATE FAILED, the response includes a failureReason key, which describes why the job failed.

", - "CreateDatasetGroup": "

Creates an empty dataset group. A dataset group is a container for Amazon Personalize resources. A dataset group can contain at most three datasets, one for each type of dataset:

A dataset group can be a Domain dataset group, where you specify a domain and use pre-configured resources like recommenders, or a Custom dataset group, where you use custom resources, such as a solution with a solution version, that you deploy with a campaign. If you start with a Domain dataset group, you can still add custom resources such as solutions and solution versions trained with recipes for custom use cases and deployed with campaigns.

A dataset group can be in one of the following states:

To get the status of the dataset group, call DescribeDatasetGroup. If the status shows as CREATE FAILED, the response includes a failureReason key, which describes why the creation failed.

You must wait until the status of the dataset group is ACTIVE before adding a dataset to the group.

You can specify an Key Management Service (KMS) key to encrypt the datasets in the group. If you specify a KMS key, you must also include an Identity and Access Management (IAM) role that has permission to access the key.

APIs that require a dataset group ARN in the request

Related APIs

", - "CreateDatasetImportJob": "

Creates a job that imports training data from your data source (an Amazon S3 bucket) to an Amazon Personalize dataset. To allow Amazon Personalize to import the training data, you must specify an IAM service role that has permission to read from the data source, as Amazon Personalize makes a copy of your data and processes it internally. For information on granting access to your Amazon S3 bucket, see Giving Amazon Personalize Access to Amazon S3 Resources.

The dataset import job replaces any existing data in the dataset that you imported in bulk.

Status

A dataset import job can be in one of the following states:

To get the status of the import job, call DescribeDatasetImportJob, providing the Amazon Resource Name (ARN) of the dataset import job. The dataset import is complete when the status shows as ACTIVE. If the status shows as CREATE FAILED, the response includes a failureReason key, which describes why the job failed.

Importing takes time. You must wait until the status shows as ACTIVE before training a model using the dataset.

Related APIs

", - "CreateEventTracker": "

Creates an event tracker that you use when adding event data to a specified dataset group using the PutEvents API.

Only one event tracker can be associated with a dataset group. You will get an error if you call CreateEventTracker using the same dataset group as an existing event tracker.

When you create an event tracker, the response includes a tracking ID, which you pass as a parameter when you use the PutEvents operation. Amazon Personalize then appends the event data to the Interactions dataset of the dataset group you specify in your event tracker.

The event tracker can be in one of the following states:

To get the status of the event tracker, call DescribeEventTracker.

The event tracker must be in the ACTIVE state before using the tracking ID.

Related APIs

", - "CreateFilter": "

Creates a recommendation filter. For more information, see filter.

", - "CreateRecommender": "

Creates a recommender with the recipe (a Domain dataset group use case) you specify. You create recommenders for a Domain dataset group and specify the recommender's Amazon Resource Name (ARN) when you make a GetRecommendations request.

Minimum recommendation requests per second

When you create a recommender, you can configure the recommender's minimum recommendation requests per second. The minimum recommendation requests per second (minRecommendationRequestsPerSecond) specifies the baseline recommendation request throughput provisioned by Amazon Personalize. The default minRecommendationRequestsPerSecond is 1. A recommendation request is a single GetRecommendations operation. Request throughput is measured in requests per second and Amazon Personalize uses your requests per second to derive your requests per hour and the price of your recommender usage.

If your requests per second increases beyond minRecommendationRequestsPerSecond, Amazon Personalize auto-scales the provisioned capacity up and down, but never below minRecommendationRequestsPerSecond. There's a short time delay while the capacity is increased that might cause loss of requests.

Your bill is the greater of either the minimum requests per hour (based on minRecommendationRequestsPerSecond) or the actual number of requests. The actual request throughput used is calculated as the average requests/second within a one-hour window. We recommend starting with the default minRecommendationRequestsPerSecond, track your usage using Amazon CloudWatch metrics, and then increase the minRecommendationRequestsPerSecond as necessary.

Status

A recommender can be in one of the following states:

To get the recommender status, call DescribeRecommender.

Wait until the status of the recommender is ACTIVE before asking the recommender for recommendations.

Related APIs

", - "CreateSchema": "

Creates an Amazon Personalize schema from the specified schema string. The schema you create must be in Avro JSON format.

Amazon Personalize recognizes three schema variants. Each schema is associated with a dataset type and has a set of required field and keywords. If you are creating a schema for a dataset in a Domain dataset group, you provide the domain of the Domain dataset group. You specify a schema when you call CreateDataset.

Related APIs

", - "CreateSolution": "

Creates the configuration for training a model. A trained model is known as a solution. After the configuration is created, you train the model (create a solution) by calling the CreateSolutionVersion operation. Every time you call CreateSolutionVersion, a new version of the solution is created.

After creating a solution version, you check its accuracy by calling GetSolutionMetrics. When you are satisfied with the version, you deploy it using CreateCampaign. The campaign provides recommendations to a client through the GetRecommendations API.

To train a model, Amazon Personalize requires training data and a recipe. The training data comes from the dataset group that you provide in the request. A recipe specifies the training algorithm and a feature transformation. You can specify one of the predefined recipes provided by Amazon Personalize. Alternatively, you can specify performAutoML and Amazon Personalize will analyze your data and select the optimum USER_PERSONALIZATION recipe for you.

Amazon Personalize doesn't support configuring the hpoObjective for solution hyperparameter optimization at this time.

Status

A solution can be in one of the following states:

To get the status of the solution, call DescribeSolution. Wait until the status shows as ACTIVE before calling CreateSolutionVersion.

Related APIs

", - "CreateSolutionVersion": "

Trains or retrains an active solution in a Custom dataset group. A solution is created using the CreateSolution operation and must be in the ACTIVE state before calling CreateSolutionVersion. A new version of the solution is created every time you call this operation.

Status

A solution version can be in one of the following states:

To get the status of the version, call DescribeSolutionVersion. Wait until the status shows as ACTIVE before calling CreateCampaign.

If the status shows as CREATE FAILED, the response includes a failureReason key, which describes why the job failed.

Related APIs

", - "DeleteCampaign": "

Removes a campaign by deleting the solution deployment. The solution that the campaign is based on is not deleted and can be redeployed when needed. A deleted campaign can no longer be specified in a GetRecommendations request. For more information on campaigns, see CreateCampaign.

", - "DeleteDataset": "

Deletes a dataset. You can't delete a dataset if an associated DatasetImportJob or SolutionVersion is in the CREATE PENDING or IN PROGRESS state. For more information on datasets, see CreateDataset.

", + "CreateBatchInferenceJob": "

Creates a batch inference job. The operation can handle up to 50 million records and the input file must be in JSON format. For more information, see Creating a batch inference job.

", + "CreateBatchSegmentJob": "

Creates a batch segment job. The operation can handle up to 50 million records and the input file must be in JSON format. For more information, see Getting batch recommendations and user segments.

", + "CreateCampaign": "

Creates a campaign that deploys a solution version. When a client calls the GetRecommendations and GetPersonalizedRanking APIs, a campaign is specified in the request.

Minimum Provisioned TPS and Auto-Scaling

A transaction is a single GetRecommendations or GetPersonalizedRanking call. Transactions per second (TPS) is the throughput and unit of billing for Amazon Personalize. The minimum provisioned TPS (minProvisionedTPS) specifies the baseline throughput provisioned by Amazon Personalize, and thus, the minimum billing charge.

If your TPS increases beyond minProvisionedTPS, Amazon Personalize auto-scales the provisioned capacity up and down, but never below minProvisionedTPS. There's a short time delay while the capacity is increased that might cause loss of transactions.

The actual TPS used is calculated as the average requests/second within a 5-minute window. You pay for maximum of either the minimum provisioned TPS or the actual TPS. We recommend starting with a low minProvisionedTPS, track your usage using Amazon CloudWatch metrics, and then increase the minProvisionedTPS as necessary.

Status

A campaign can be in one of the following states:

To get the campaign status, call DescribeCampaign.

Wait until the status of the campaign is ACTIVE before asking the campaign for recommendations.

Related APIs

", + "CreateDataset": "

Creates an empty dataset and adds it to the specified dataset group. Use CreateDatasetImportJob to import your training data to a dataset.

There are three types of datasets:

Each dataset type has an associated schema with required field types. Only the Interactions dataset is required in order to train a model (also referred to as creating a solution).

A dataset can be in one of the following states:

To get the status of the dataset, call DescribeDataset.

Related APIs

", + "CreateDatasetExportJob": "

Creates a job that exports data from your dataset to an Amazon S3 bucket. To allow Amazon Personalize to export the training data, you must specify an service-linked IAM role that gives Amazon Personalize PutObject permissions for your Amazon S3 bucket. For information, see Exporting a dataset in the Amazon Personalize developer guide.

Status

A dataset export job can be in one of the following states:

To get the status of the export job, call DescribeDatasetExportJob, and specify the Amazon Resource Name (ARN) of the dataset export job. The dataset export is complete when the status shows as ACTIVE. If the status shows as CREATE FAILED, the response includes a failureReason key, which describes why the job failed.

", + "CreateDatasetGroup": "

Creates an empty dataset group. A dataset group is a container for Amazon Personalize resources. A dataset group can contain at most three datasets, one for each type of dataset:

A dataset group can be a Domain dataset group, where you specify a domain and use pre-configured resources like recommenders, or a Custom dataset group, where you use custom resources, such as a solution with a solution version, that you deploy with a campaign. If you start with a Domain dataset group, you can still add custom resources such as solutions and solution versions trained with recipes for custom use cases and deployed with campaigns.

A dataset group can be in one of the following states:

To get the status of the dataset group, call DescribeDatasetGroup. If the status shows as CREATE FAILED, the response includes a failureReason key, which describes why the creation failed.

You must wait until the status of the dataset group is ACTIVE before adding a dataset to the group.

You can specify an Key Management Service (KMS) key to encrypt the datasets in the group. If you specify a KMS key, you must also include an Identity and Access Management (IAM) role that has permission to access the key.

APIs that require a dataset group ARN in the request

Related APIs

", + "CreateDatasetImportJob": "

Creates a job that imports training data from your data source (an Amazon S3 bucket) to an Amazon Personalize dataset. To allow Amazon Personalize to import the training data, you must specify an IAM service role that has permission to read from the data source, as Amazon Personalize makes a copy of your data and processes it internally. For information on granting access to your Amazon S3 bucket, see Giving Amazon Personalize Access to Amazon S3 Resources.

The dataset import job replaces any existing data in the dataset that you imported in bulk.

Status

A dataset import job can be in one of the following states:

To get the status of the import job, call DescribeDatasetImportJob, providing the Amazon Resource Name (ARN) of the dataset import job. The dataset import is complete when the status shows as ACTIVE. If the status shows as CREATE FAILED, the response includes a failureReason key, which describes why the job failed.

Importing takes time. You must wait until the status shows as ACTIVE before training a model using the dataset.

Related APIs

", + "CreateEventTracker": "

Creates an event tracker that you use when adding event data to a specified dataset group using the PutEvents API.

Only one event tracker can be associated with a dataset group. You will get an error if you call CreateEventTracker using the same dataset group as an existing event tracker.

When you create an event tracker, the response includes a tracking ID, which you pass as a parameter when you use the PutEvents operation. Amazon Personalize then appends the event data to the Interactions dataset of the dataset group you specify in your event tracker.

The event tracker can be in one of the following states:

To get the status of the event tracker, call DescribeEventTracker.

The event tracker must be in the ACTIVE state before using the tracking ID.

Related APIs

", + "CreateFilter": "

Creates a recommendation filter. For more information, see Filtering recommendations and user segments.

", + "CreateRecommender": "

Creates a recommender with the recipe (a Domain dataset group use case) you specify. You create recommenders for a Domain dataset group and specify the recommender's Amazon Resource Name (ARN) when you make a GetRecommendations request.

Minimum recommendation requests per second

When you create a recommender, you can configure the recommender's minimum recommendation requests per second. The minimum recommendation requests per second (minRecommendationRequestsPerSecond) specifies the baseline recommendation request throughput provisioned by Amazon Personalize. The default minRecommendationRequestsPerSecond is 1. A recommendation request is a single GetRecommendations operation. Request throughput is measured in requests per second and Amazon Personalize uses your requests per second to derive your requests per hour and the price of your recommender usage.

If your requests per second increases beyond minRecommendationRequestsPerSecond, Amazon Personalize auto-scales the provisioned capacity up and down, but never below minRecommendationRequestsPerSecond. There's a short time delay while the capacity is increased that might cause loss of requests.

Your bill is the greater of either the minimum requests per hour (based on minRecommendationRequestsPerSecond) or the actual number of requests. The actual request throughput used is calculated as the average requests/second within a one-hour window. We recommend starting with the default minRecommendationRequestsPerSecond, track your usage using Amazon CloudWatch metrics, and then increase the minRecommendationRequestsPerSecond as necessary.

Status

A recommender can be in one of the following states:

To get the recommender status, call DescribeRecommender.

Wait until the status of the recommender is ACTIVE before asking the recommender for recommendations.

Related APIs

", + "CreateSchema": "

Creates an Amazon Personalize schema from the specified schema string. The schema you create must be in Avro JSON format.

Amazon Personalize recognizes three schema variants. Each schema is associated with a dataset type and has a set of required field and keywords. If you are creating a schema for a dataset in a Domain dataset group, you provide the domain of the Domain dataset group. You specify a schema when you call CreateDataset.

Related APIs

", + "CreateSolution": "

Creates the configuration for training a model. A trained model is known as a solution. After the configuration is created, you train the model (create a solution) by calling the CreateSolutionVersion operation. Every time you call CreateSolutionVersion, a new version of the solution is created.

After creating a solution version, you check its accuracy by calling GetSolutionMetrics. When you are satisfied with the version, you deploy it using CreateCampaign. The campaign provides recommendations to a client through the GetRecommendations API.

To train a model, Amazon Personalize requires training data and a recipe. The training data comes from the dataset group that you provide in the request. A recipe specifies the training algorithm and a feature transformation. You can specify one of the predefined recipes provided by Amazon Personalize. Alternatively, you can specify performAutoML and Amazon Personalize will analyze your data and select the optimum USER_PERSONALIZATION recipe for you.

Amazon Personalize doesn't support configuring the hpoObjective for solution hyperparameter optimization at this time.

Status

A solution can be in one of the following states:

To get the status of the solution, call DescribeSolution. Wait until the status shows as ACTIVE before calling CreateSolutionVersion.

Related APIs

", + "CreateSolutionVersion": "

Trains or retrains an active solution in a Custom dataset group. A solution is created using the CreateSolution operation and must be in the ACTIVE state before calling CreateSolutionVersion. A new version of the solution is created every time you call this operation.

Status

A solution version can be in one of the following states:

To get the status of the version, call DescribeSolutionVersion. Wait until the status shows as ACTIVE before calling CreateCampaign.

If the status shows as CREATE FAILED, the response includes a failureReason key, which describes why the job failed.

Related APIs

", + "DeleteCampaign": "

Removes a campaign by deleting the solution deployment. The solution that the campaign is based on is not deleted and can be redeployed when needed. A deleted campaign can no longer be specified in a GetRecommendations request. For information on creating campaigns, see CreateCampaign.

", + "DeleteDataset": "

Deletes a dataset. You can't delete a dataset if an associated DatasetImportJob or SolutionVersion is in the CREATE PENDING or IN PROGRESS state. For more information on datasets, see CreateDataset.

", "DeleteDatasetGroup": "

Deletes a dataset group. Before you delete a dataset group, you must delete the following:

", - "DeleteEventTracker": "

Deletes the event tracker. Does not delete the event-interactions dataset from the associated dataset group. For more information on event trackers, see CreateEventTracker.

", + "DeleteEventTracker": "

Deletes the event tracker. Does not delete the event-interactions dataset from the associated dataset group. For more information on event trackers, see CreateEventTracker.

", "DeleteFilter": "

Deletes a filter.

", "DeleteRecommender": "

Deactivates and removes a recommender. A deleted recommender can no longer be specified in a GetRecommendations request.

", - "DeleteSchema": "

Deletes a schema. Before deleting a schema, you must delete all datasets referencing the schema. For more information on schemas, see CreateSchema.

", - "DeleteSolution": "

Deletes all versions of a solution and the Solution object itself. Before deleting a solution, you must delete all campaigns based on the solution. To determine what campaigns are using the solution, call ListCampaigns and supply the Amazon Resource Name (ARN) of the solution. You can't delete a solution if an associated SolutionVersion is in the CREATE PENDING or IN PROGRESS state. For more information on solutions, see CreateSolution.

", + "DeleteSchema": "

Deletes a schema. Before deleting a schema, you must delete all datasets referencing the schema. For more information on schemas, see CreateSchema.

", + "DeleteSolution": "

Deletes all versions of a solution and the Solution object itself. Before deleting a solution, you must delete all campaigns based on the solution. To determine what campaigns are using the solution, call ListCampaigns and supply the Amazon Resource Name (ARN) of the solution. You can't delete a solution if an associated SolutionVersion is in the CREATE PENDING or IN PROGRESS state. For more information on solutions, see CreateSolution.

", "DescribeAlgorithm": "

Describes the given algorithm.

", "DescribeBatchInferenceJob": "

Gets the properties of a batch inference job including name, Amazon Resource Name (ARN), status, input and output configurations, and the ARN of the solution version used to generate the recommendations.

", "DescribeBatchSegmentJob": "

Gets the properties of a batch segment job including name, Amazon Resource Name (ARN), status, input and output configurations, and the ARN of the solution version used to generate segments.

", - "DescribeCampaign": "

Describes the given campaign, including its status.

A campaign can be in one of the following states:

When the status is CREATE FAILED, the response includes the failureReason key, which describes why.

For more information on campaigns, see CreateCampaign.

", - "DescribeDataset": "

Describes the given dataset. For more information on datasets, see CreateDataset.

", - "DescribeDatasetExportJob": "

Describes the dataset export job created by CreateDatasetExportJob, including the export job status.

", - "DescribeDatasetGroup": "

Describes the given dataset group. For more information on dataset groups, see CreateDatasetGroup.

", - "DescribeDatasetImportJob": "

Describes the dataset import job created by CreateDatasetImportJob, including the import job status.

", - "DescribeEventTracker": "

Describes an event tracker. The response includes the trackingId and status of the event tracker. For more information on event trackers, see CreateEventTracker.

", + "DescribeCampaign": "

Describes the given campaign, including its status.

A campaign can be in one of the following states:

When the status is CREATE FAILED, the response includes the failureReason key, which describes why.

For more information on campaigns, see CreateCampaign.

", + "DescribeDataset": "

Describes the given dataset. For more information on datasets, see CreateDataset.

", + "DescribeDatasetExportJob": "

Describes the dataset export job created by CreateDatasetExportJob, including the export job status.

", + "DescribeDatasetGroup": "

Describes the given dataset group. For more information on dataset groups, see CreateDatasetGroup.

", + "DescribeDatasetImportJob": "

Describes the dataset import job created by CreateDatasetImportJob, including the import job status.

", + "DescribeEventTracker": "

Describes an event tracker. The response includes the trackingId and status of the event tracker. For more information on event trackers, see CreateEventTracker.

", "DescribeFeatureTransformation": "

Describes the given feature transformation.

", "DescribeFilter": "

Describes a filter's properties.

", - "DescribeRecipe": "

Describes a recipe.

A recipe contains three items:

Amazon Personalize provides a set of predefined recipes. You specify a recipe when you create a solution with the CreateSolution API. CreateSolution trains a model by using the algorithm in the specified recipe and a training dataset. The solution, when deployed as a campaign, can provide recommendations using the GetRecommendations API.

", + "DescribeRecipe": "

Describes a recipe.

A recipe contains three items:

Amazon Personalize provides a set of predefined recipes. You specify a recipe when you create a solution with the CreateSolution API. CreateSolution trains a model by using the algorithm in the specified recipe and a training dataset. The solution, when deployed as a campaign, can provide recommendations using the GetRecommendations API.

", "DescribeRecommender": "

Describes the given recommender, including its status.

A recommender can be in one of the following states:

When the status is CREATE FAILED, the response includes the failureReason key, which describes why.

For more information on recommenders, see CreateRecommender.

", - "DescribeSchema": "

Describes a schema. For more information on schemas, see CreateSchema.

", - "DescribeSolution": "

Describes a solution. For more information on solutions, see CreateSolution.

", - "DescribeSolutionVersion": "

Describes a specific version of a solution. For more information on solutions, see CreateSolution.

", + "DescribeSchema": "

Describes a schema. For more information on schemas, see CreateSchema.

", + "DescribeSolution": "

Describes a solution. For more information on solutions, see CreateSolution.

", + "DescribeSolutionVersion": "

Describes a specific version of a solution. For more information on solutions, see CreateSolution

", "GetSolutionMetrics": "

Gets the metrics for the specified solution version.

", "ListBatchInferenceJobs": "

Gets a list of the batch inference jobs that have been performed off of a solution version.

", "ListBatchSegmentJobs": "

Gets a list of the batch segment jobs that have been performed off of a solution version that you specify.

", - "ListCampaigns": "

Returns a list of campaigns that use the given solution. When a solution is not specified, all the campaigns associated with the account are listed. The response provides the properties for each campaign, including the Amazon Resource Name (ARN). For more information on campaigns, see CreateCampaign.

", - "ListDatasetExportJobs": "

Returns a list of dataset export jobs that use the given dataset. When a dataset is not specified, all the dataset export jobs associated with the account are listed. The response provides the properties for each dataset export job, including the Amazon Resource Name (ARN). For more information on dataset export jobs, see CreateDatasetExportJob. For more information on datasets, see CreateDataset.

", - "ListDatasetGroups": "

Returns a list of dataset groups. The response provides the properties for each dataset group, including the Amazon Resource Name (ARN). For more information on dataset groups, see CreateDatasetGroup.

", - "ListDatasetImportJobs": "

Returns a list of dataset import jobs that use the given dataset. When a dataset is not specified, all the dataset import jobs associated with the account are listed. The response provides the properties for each dataset import job, including the Amazon Resource Name (ARN). For more information on dataset import jobs, see CreateDatasetImportJob. For more information on datasets, see CreateDataset.

", - "ListDatasets": "

Returns the list of datasets contained in the given dataset group. The response provides the properties for each dataset, including the Amazon Resource Name (ARN). For more information on datasets, see CreateDataset.

", - "ListEventTrackers": "

Returns the list of event trackers associated with the account. The response provides the properties for each event tracker, including the Amazon Resource Name (ARN) and tracking ID. For more information on event trackers, see CreateEventTracker.

", + "ListCampaigns": "

Returns a list of campaigns that use the given solution. When a solution is not specified, all the campaigns associated with the account are listed. The response provides the properties for each campaign, including the Amazon Resource Name (ARN). For more information on campaigns, see CreateCampaign.

", + "ListDatasetExportJobs": "

Returns a list of dataset export jobs that use the given dataset. When a dataset is not specified, all the dataset export jobs associated with the account are listed. The response provides the properties for each dataset export job, including the Amazon Resource Name (ARN). For more information on dataset export jobs, see CreateDatasetExportJob. For more information on datasets, see CreateDataset.

", + "ListDatasetGroups": "

Returns a list of dataset groups. The response provides the properties for each dataset group, including the Amazon Resource Name (ARN). For more information on dataset groups, see CreateDatasetGroup.

", + "ListDatasetImportJobs": "

Returns a list of dataset import jobs that use the given dataset. When a dataset is not specified, all the dataset import jobs associated with the account are listed. The response provides the properties for each dataset import job, including the Amazon Resource Name (ARN). For more information on dataset import jobs, see CreateDatasetImportJob. For more information on datasets, see CreateDataset.

", + "ListDatasets": "

Returns the list of datasets contained in the given dataset group. The response provides the properties for each dataset, including the Amazon Resource Name (ARN). For more information on datasets, see CreateDataset.

", + "ListEventTrackers": "

Returns the list of event trackers associated with the account. The response provides the properties for each event tracker, including the Amazon Resource Name (ARN) and tracking ID. For more information on event trackers, see CreateEventTracker.

", "ListFilters": "

Lists all filters that belong to a given dataset group.

", "ListRecipes": "

Returns a list of available recipes. The response provides the properties for each recipe, including the recipe's Amazon Resource Name (ARN).

", "ListRecommenders": "

Returns a list of recommenders in a given Domain dataset group. When a Domain dataset group is not specified, all the recommenders associated with the account are listed. The response provides the properties for each recommender, including the Amazon Resource Name (ARN). For more information on recommenders, see CreateRecommender.

", - "ListSchemas": "

Returns the list of schemas associated with the account. The response provides the properties for each schema, including the Amazon Resource Name (ARN). For more information on schemas, see CreateSchema.

", - "ListSolutionVersions": "

Returns a list of solution versions for the given solution. When a solution is not specified, all the solution versions associated with the account are listed. The response provides the properties for each solution version, including the Amazon Resource Name (ARN). For more information on solutions, see CreateSolution.

", - "ListSolutions": "

Returns a list of solutions that use the given dataset group. When a dataset group is not specified, all the solutions associated with the account are listed. The response provides the properties for each solution, including the Amazon Resource Name (ARN). For more information on solutions, see CreateSolution.

", + "ListSchemas": "

Returns the list of schemas associated with the account. The response provides the properties for each schema, including the Amazon Resource Name (ARN). For more information on schemas, see CreateSchema.

", + "ListSolutionVersions": "

Returns a list of solution versions for the given solution. When a solution is not specified, all the solution versions associated with the account are listed. The response provides the properties for each solution version, including the Amazon Resource Name (ARN).

", + "ListSolutions": "

Returns a list of solutions that use the given dataset group. When a dataset group is not specified, all the solutions associated with the account are listed. The response provides the properties for each solution, including the Amazon Resource Name (ARN). For more information on solutions, see CreateSolution.

", + "ListTagsForResource": "

Get a list of tags attached to a resource.

", "StopSolutionVersionCreation": "

Stops creating a solution version that is in a state of CREATE_PENDING or CREATE IN_PROGRESS.

Depending on the current state of the solution version, the solution version state changes as follows:

You are billed for all of the training completed up until you stop the solution version creation. You cannot resume creating a solution version once it has been stopped.

", - "UpdateCampaign": "

Updates a campaign by either deploying a new solution or changing the value of the campaign's minProvisionedTPS parameter.

To update a campaign, the campaign status must be ACTIVE or CREATE FAILED. Check the campaign status using the DescribeCampaign API.

You must wait until the status of the updated campaign is ACTIVE before asking the campaign for recommendations.

For more information on campaigns, see CreateCampaign.

", + "TagResource": "

Add a list of tags to a resource.

", + "UntagResource": "

Remove tags that are attached to a resource.

", + "UpdateCampaign": "

Updates a campaign by either deploying a new solution or changing the value of the campaign's minProvisionedTPS parameter.

To update a campaign, the campaign status must be ACTIVE or CREATE FAILED. Check the campaign status using the DescribeCampaign operation.

You must wait until the status of the updated campaign is ACTIVE before asking the campaign for recommendations.

For more information on campaigns, see CreateCampaign.

", "UpdateRecommender": "

Updates the recommender to modify the recommender configuration.

" }, "shapes": { @@ -99,10 +102,10 @@ "CampaignSummary$campaignArn": "

The Amazon Resource Name (ARN) of the campaign.

", "CampaignUpdateSummary$solutionVersionArn": "

The Amazon Resource Name (ARN) of the deployed solution version.

", "CreateBatchInferenceJobRequest$solutionVersionArn": "

The Amazon Resource Name (ARN) of the solution version that will be used to generate the batch inference recommendations.

", - "CreateBatchInferenceJobRequest$filterArn": "

The ARN of the filter to apply to the batch inference job. For more information on using filters, see Filtering Batch Recommendations..

", + "CreateBatchInferenceJobRequest$filterArn": "

The ARN of the filter to apply to the batch inference job. For more information on using filters, see Filtering batch recommendations.

", "CreateBatchInferenceJobResponse$batchInferenceJobArn": "

The ARN of the batch inference job.

", "CreateBatchSegmentJobRequest$solutionVersionArn": "

The Amazon Resource Name (ARN) of the solution version you want the batch segment job to use to generate batch segments.

", - "CreateBatchSegmentJobRequest$filterArn": "

The ARN of the filter to apply to the batch segment job. For more information on using filters, see filter-batch.

", + "CreateBatchSegmentJobRequest$filterArn": "

The ARN of the filter to apply to the batch segment job. For more information on using filters, see Filtering batch recommendations.

", "CreateBatchSegmentJobResponse$batchSegmentJobArn": "

The ARN of the batch segment job.

", "CreateCampaignRequest$solutionVersionArn": "

The Amazon Resource Name (ARN) of the solution version to deploy.

", "CreateCampaignResponse$campaignArn": "

The Amazon Resource Name (ARN) of the campaign.

", @@ -188,6 +191,7 @@ "ListRecommendersRequest$datasetGroupArn": "

The Amazon Resource Name (ARN) of the Domain dataset group to list the recommenders for. When a Domain dataset group is not specified, all the recommenders associated with the account are listed.

", "ListSolutionVersionsRequest$solutionArn": "

The Amazon Resource Name (ARN) of the solution.

", "ListSolutionsRequest$datasetGroupArn": "

The Amazon Resource Name (ARN) of the dataset group.

", + "ListTagsForResourceRequest$resourceArn": "

The resource's Amazon Resource Name.

", "Recipe$recipeArn": "

The Amazon Resource Name (ARN) of the recipe.

", "Recipe$algorithmArn": "

The Amazon Resource Name (ARN) of the algorithm that Amazon Personalize uses to train the model.

", "Recipe$featureTransformationArn": "

The ARN of the FeatureTransformation object.

", @@ -208,6 +212,8 @@ "SolutionVersion$datasetGroupArn": "

The Amazon Resource Name (ARN) of the dataset group providing the training data.

", "SolutionVersionSummary$solutionVersionArn": "

The Amazon Resource Name (ARN) of the solution version.

", "StopSolutionVersionCreationRequest$solutionVersionArn": "

The Amazon Resource Name (ARN) of the solution version you want to stop creating.

", + "TagResourceRequest$resourceArn": "

The resource's Amazon Resource Name (ARN).

", + "UntagResourceRequest$resourceArn": "

The resource's Amazon Resource Name (ARN).

", "UpdateCampaignRequest$campaignArn": "

The Amazon Resource Name (ARN) of the campaign.

", "UpdateCampaignRequest$solutionVersionArn": "

The ARN of a new solution version to deploy.

", "UpdateCampaignResponse$campaignArn": "

The same campaign ARN as given in the request.

", @@ -222,13 +228,13 @@ } }, "AutoMLConfig": { - "base": "

When the solution performs AutoML (performAutoML is true in CreateSolution), Amazon Personalize determines which recipe, from the specified list, optimizes the given metric. Amazon Personalize then uses that recipe for the solution.

", + "base": "

When the solution performs AutoML (performAutoML is true in CreateSolution), Amazon Personalize determines which recipe, from the specified list, optimizes the given metric. Amazon Personalize then uses that recipe for the solution.

", "refs": { - "SolutionConfig$autoMLConfig": "

The AutoMLConfig object containing a list of recipes to search when AutoML is performed.

" + "SolutionConfig$autoMLConfig": "

The AutoMLConfig object containing a list of recipes to search when AutoML is performed.

" } }, "AutoMLResult": { - "base": "

When the solution performs AutoML (performAutoML is true in CreateSolution), specifies the recipe that best optimized the specified metric.

", + "base": "

When the solution performs AutoML (performAutoML is true in CreateSolution), specifies the recipe that best optimized the specified metric.

", "refs": { "Solution$autoMLResult": "

When performAutoML is true, specifies the best recipe found.

" } @@ -268,7 +274,7 @@ } }, "BatchInferenceJobSummary": { - "base": "

A truncated version of the BatchInferenceJob datatype. The ListBatchInferenceJobs operation returns a list of batch inference job summaries.

", + "base": "

A truncated version of the BatchInferenceJob. The ListBatchInferenceJobs operation returns a list of batch inference job summaries.

", "refs": { "BatchInferenceJobs$member": null } @@ -300,7 +306,7 @@ } }, "BatchSegmentJobSummary": { - "base": "

A truncated version of the BatchSegmentJob datatype. The ListBatchSegmentJobs operation returns a list of batch segment job summaries.

", + "base": "

A truncated version of the BatchSegmentJob datatype. ListBatchSegmentJobs operation returns a list of batch segment job summaries.

", "refs": { "BatchSegmentJobs$member": null } @@ -318,7 +324,7 @@ } }, "Campaign": { - "base": "

An object that describes the deployment of a solution version. For more information on campaigns, see CreateCampaign.

", + "base": "

An object that describes the deployment of a solution version. For more information on campaigns, see CreateCampaign.

", "refs": { "DescribeCampaignResponse$campaign": "

The properties of the campaign.

" } @@ -333,13 +339,13 @@ } }, "CampaignSummary": { - "base": "

Provides a summary of the properties of a campaign. For a complete listing, call the DescribeCampaign API.

", + "base": "

Provides a summary of the properties of a campaign. For a complete listing, call the DescribeCampaign API.

", "refs": { "Campaigns$member": null } }, "CampaignUpdateSummary": { - "base": "

Provides a summary of the properties of a campaign update. For a complete listing, call the DescribeCampaign API.

", + "base": "

Provides a summary of the properties of a campaign update. For a complete listing, call the DescribeCampaign API.

", "refs": { "Campaign$latestCampaignUpdate": null } @@ -545,7 +551,7 @@ } }, "DatasetExportJob": { - "base": "

Describes a job that exports a dataset to an Amazon S3 bucket. For more information, see CreateDatasetExportJob.

A dataset export job can be in one of the following states:

", + "base": "

Describes a job that exports a dataset to an Amazon S3 bucket. For more information, see CreateDatasetExportJob.

A dataset export job can be in one of the following states:

", "refs": { "DescribeDatasetExportJobResponse$datasetExportJob": "

Information about the dataset export job, including the status.

The status is one of the following values:

" } @@ -558,7 +564,7 @@ } }, "DatasetExportJobSummary": { - "base": "

Provides a summary of the properties of a dataset export job. For a complete listing, call the DescribeDatasetExportJob API.

", + "base": "

Provides a summary of the properties of a dataset export job. For a complete listing, call the DescribeDatasetExportJob API.

", "refs": { "DatasetExportJobs$member": null } @@ -570,13 +576,13 @@ } }, "DatasetGroup": { - "base": "

A dataset group is a collection of related datasets (Interactions, User, and Item). You create a dataset group by calling CreateDatasetGroup. You then create a dataset and add it to a dataset group by calling CreateDataset. The dataset group is used to create and train a solution by calling CreateSolution. A dataset group can contain only one of each type of dataset.

You can specify an Key Management Service (KMS) key to encrypt the datasets in the group.

", + "base": "

A dataset group is a collection of related datasets (Interactions, User, and Item). You create a dataset group by calling CreateDatasetGroup. You then create a dataset and add it to a dataset group by calling CreateDataset. The dataset group is used to create and train a solution by calling CreateSolution. A dataset group can contain only one of each type of dataset.

You can specify an Key Management Service (KMS) key to encrypt the datasets in the group.

", "refs": { "DescribeDatasetGroupResponse$datasetGroup": "

A listing of the dataset group's properties.

" } }, "DatasetGroupSummary": { - "base": "

Provides a summary of the properties of a dataset group. For a complete listing, call the DescribeDatasetGroup API.

", + "base": "

Provides a summary of the properties of a dataset group. For a complete listing, call the DescribeDatasetGroup API.

", "refs": { "DatasetGroups$member": null } @@ -588,13 +594,13 @@ } }, "DatasetImportJob": { - "base": "

Describes a job that imports training data from a data source (Amazon S3 bucket) to an Amazon Personalize dataset. For more information, see CreateDatasetImportJob.

A dataset import job can be in one of the following states:

", + "base": "

Describes a job that imports training data from a data source (Amazon S3 bucket) to an Amazon Personalize dataset. For more information, see CreateDatasetImportJob.

A dataset import job can be in one of the following states:

", "refs": { "DescribeDatasetImportJobResponse$datasetImportJob": "

Information about the dataset import job, including the status.

The status is one of the following values:

" } }, "DatasetImportJobSummary": { - "base": "

Provides a summary of the properties of a dataset import job. For a complete listing, call the DescribeDatasetImportJob API.

", + "base": "

Provides a summary of the properties of a dataset import job. For a complete listing, call the DescribeDatasetImportJob API.

", "refs": { "DatasetImportJobs$member": null } @@ -606,19 +612,19 @@ } }, "DatasetSchema": { - "base": "

Describes the schema for a dataset. For more information on schemas, see CreateSchema.

", + "base": "

Describes the schema for a dataset. For more information on schemas, see CreateSchema.

", "refs": { "DescribeSchemaResponse$schema": "

The requested schema.

" } }, "DatasetSchemaSummary": { - "base": "

Provides a summary of the properties of a dataset schema. For a complete listing, call the DescribeSchema API.

", + "base": "

Provides a summary of the properties of a dataset schema. For a complete listing, call the DescribeSchema API.

", "refs": { "Schemas$member": null } }, "DatasetSummary": { - "base": "

Provides a summary of the properties of a dataset. For a complete listing, call the DescribeDataset API.

", + "base": "

Provides a summary of the properties of a dataset. For a complete listing, call the DescribeDataset API.

", "refs": { "Datasets$member": null } @@ -970,7 +976,7 @@ "DatasetGroupSummary$domain": "

The domain of a Domain dataset group.

", "DatasetSchema$domain": "

The domain of a schema that you created for a dataset in a Domain dataset group.

", "DatasetSchemaSummary$domain": "

The domain of a schema that you created for a dataset in a Domain dataset group.

", - "ListRecipesRequest$domain": "

Filters returned recipes by domain for a Domain dataset group. Only recipes (Domain dataset group use cases) for this domain are included in the response. If you don't specify a domain, only non-domain recipes are returned.

", + "ListRecipesRequest$domain": "

Filters returned recipes by domain for a Domain dataset group. Only recipes (Domain dataset group use cases) for this domain are included in the response. If you don't specify a domain, all recipes are returned.

", "RecipeSummary$domain": "

The domain of the recipe (if the recipe is a Domain dataset group use case).

" } }, @@ -982,7 +988,9 @@ "LimitExceededException$message": null, "ResourceAlreadyExistsException$message": null, "ResourceInUseException$message": null, - "ResourceNotFoundException$message": null + "ResourceNotFoundException$message": null, + "TooManyTagKeysException$message": null, + "TooManyTagsException$message": null } }, "EventTracker": { @@ -992,7 +1000,7 @@ } }, "EventTrackerSummary": { - "base": "

Provides a summary of the properties of an event tracker. For a complete listing, call the DescribeEventTracker API.

", + "base": "

Provides a summary of the properties of an event tracker. For a complete listing, call the DescribeEventTracker API.

", "refs": { "EventTrackers$member": null } @@ -1068,8 +1076,8 @@ "FilterExpression": { "base": null, "refs": { - "CreateFilterRequest$filterExpression": "

The filter expression defines which items are included or excluded from recommendations. Filter expression must follow specific format rules. For information about filter expression structure and syntax, see filter-expressions.

", - "Filter$filterExpression": "

Specifies the type of item interactions to filter out of recommendation results. The filter expression must follow specific format rules. For information about filter expression structure and syntax, see filter-expressions.

" + "CreateFilterRequest$filterExpression": "

The filter expression defines which items are included or excluded from recommendations. Filter expression must follow specific format rules. For information about filter expression structure and syntax, see Filter expressions.

", + "Filter$filterExpression": "

Specifies the type of item interactions to filter out of recommendation results. The filter expression must follow specific format rules. For information about filter expression structure and syntax, see Filter expressions.

" } }, "FilterSummary": { @@ -1344,6 +1352,16 @@ "refs": { } }, + "ListTagsForResourceRequest": { + "base": null, + "refs": { + } + }, + "ListTagsForResourceResponse": { + "base": null, + "refs": { + } + }, "MaxResults": { "base": null, "refs": { @@ -1442,7 +1460,7 @@ "ListBatchInferenceJobsResponse$nextToken": "

The token to use to retrieve the next page of results. The value is null when there are no more results to return.

", "ListBatchSegmentJobsRequest$nextToken": "

The token to request the next page of results.

", "ListBatchSegmentJobsResponse$nextToken": "

The token to use to retrieve the next page of results. The value is null when there are no more results to return.

", - "ListCampaignsRequest$nextToken": "

A token returned from the previous call to ListCampaigns for getting the next set of campaigns (if they exist).

", + "ListCampaignsRequest$nextToken": "

A token returned from the previous call to ListCampaigns for getting the next set of campaigns (if they exist).

", "ListCampaignsResponse$nextToken": "

A token for getting the next set of campaigns (if they exist).

", "ListDatasetExportJobsRequest$nextToken": "

A token returned from the previous call to ListDatasetExportJobs for getting the next set of dataset export jobs (if they exist).

", "ListDatasetExportJobsResponse$nextToken": "

A token for getting the next set of dataset export jobs (if they exist).

", @@ -1473,7 +1491,7 @@ "refs": { "BatchInferenceJob$numResults": "

The number of recommendations generated by the batch inference job. This number includes the error messages generated for failed input records.

", "BatchSegmentJob$numResults": "

The number of predicted users generated by the batch segment job for each line of input data.

", - "CreateBatchInferenceJobRequest$numResults": "

The number of recommendations to retreive.

", + "CreateBatchInferenceJobRequest$numResults": "

The number of recommendations to retrieve.

", "CreateBatchSegmentJobRequest$numResults": "

The number of predicted users generated by the batch segment job for each line of input data.

" } }, @@ -1529,7 +1547,7 @@ } }, "Recipe": { - "base": "

Provides information about a recipe. Each recipe provides an algorithm that Amazon Personalize uses in model training when you use the CreateSolution operation.

", + "base": "

Provides information about a recipe. Each recipe provides an algorithm that Amazon Personalize uses in model training when you use the CreateSolution operation.

", "refs": { "DescribeRecipeResponse$recipe": "

An object that describes the recipe.

" } @@ -1541,7 +1559,7 @@ } }, "RecipeSummary": { - "base": "

Provides a summary of the properties of a recipe. For a complete listing, call the DescribeRecipe API.

", + "base": "

Provides a summary of the properties of a recipe. For a complete listing, call the DescribeRecipe API.

", "refs": { "Recipes$member": null } @@ -1581,7 +1599,7 @@ } }, "RecommenderUpdateSummary": { - "base": "

Provides a summary of the properties of a recommender update. For a complete listing, call the DescribeRecommender API operation.

", + "base": "

Provides a summary of the properties of a recommender update. For a complete listing, call the DescribeRecommender API.

", "refs": { "Recommender$latestRecommenderUpdate": "

Provides a summary of the latest updates to the recommender.

" } @@ -1664,19 +1682,19 @@ } }, "SolutionSummary": { - "base": "

Provides a summary of the properties of a solution. For a complete listing, call the DescribeSolution API.

", + "base": "

Provides a summary of the properties of a solution. For a complete listing, call the DescribeSolution API.

", "refs": { "Solutions$member": null } }, "SolutionVersion": { - "base": "

An object that provides information about a specific version of a Solution in a Custom dataset group.

", + "base": "

An object that provides information about a specific version of a Solution in a Custom dataset group.

", "refs": { "DescribeSolutionVersionResponse$solutionVersion": "

The solution version.

" } }, "SolutionVersionSummary": { - "base": "

Provides a summary of the properties of a solution version. For a complete listing, call the DescribeSolutionVersion API.

", + "base": "

Provides a summary of the properties of a solution version. For a complete listing, call the DescribeSolutionVersion API.

", "refs": { "Solution$latestSolutionVersion": "

Describes the latest version of the solution, including the status and the ARN.

", "SolutionVersions$member": null @@ -1733,6 +1751,70 @@ "refs": { } }, + "Tag": { + "base": "

The optional metadata that you apply to resources to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define. For more information see Tagging Personalize resources.

", + "refs": { + "Tags$member": null + } + }, + "TagKey": { + "base": null, + "refs": { + "Tag$tagKey": "

One part of a key-value pair that makes up a tag. A key is a general label that acts like a category for more specific tag values.

", + "TagKeys$member": null + } + }, + "TagKeys": { + "base": null, + "refs": { + "UntagResourceRequest$tagKeys": "

Keys to remove from the resource's tags.

" + } + }, + "TagResourceRequest": { + "base": null, + "refs": { + } + }, + "TagResourceResponse": { + "base": null, + "refs": { + } + }, + "TagValue": { + "base": null, + "refs": { + "Tag$tagValue": "

The optional part of a key-value pair that makes up a tag. A value acts as a descriptor within a tag category (key).

" + } + }, + "Tags": { + "base": null, + "refs": { + "CreateBatchInferenceJobRequest$tags": "

A list of tags to apply to the batch inference job.

", + "CreateBatchSegmentJobRequest$tags": "

A list of tags to apply to the batch segment job.

", + "CreateCampaignRequest$tags": "

A list of tags to apply to the campaign.

", + "CreateDatasetExportJobRequest$tags": "

A list of tags to apply to the dataset export job.

", + "CreateDatasetGroupRequest$tags": "

A list of tags to apply to the dataset group.

", + "CreateDatasetImportJobRequest$tags": "

A list of tags to apply to the dataset import job.

", + "CreateDatasetRequest$tags": "

A list of tags to apply to the dataset.

", + "CreateEventTrackerRequest$tags": "

A list of tags to apply to the event tracker.

", + "CreateFilterRequest$tags": "

A list of tags to apply to the filter.

", + "CreateRecommenderRequest$tags": "

A list of tags to apply to the recommender.

", + "CreateSolutionRequest$tags": "

A list of tags to apply to the solution.

", + "CreateSolutionVersionRequest$tags": "

A list of tags to apply to the solution version.

", + "ListTagsForResourceResponse$tags": "

The resource's tags.

", + "TagResourceRequest$tags": "

Tags to apply to the resource. For more information see Tagging Personalize resources.

" + } + }, + "TooManyTagKeysException": { + "base": "

The request contains more tag keys than can be associated with a resource (50 tag keys per resource).

", + "refs": { + } + }, + "TooManyTagsException": { + "base": "

You have exceeded the maximum number of tags you can apply to this resource.

", + "refs": { + } + }, "TrackingId": { "base": null, "refs": { @@ -1783,6 +1865,16 @@ "SolutionVersion$tunedHPOParams": "

If hyperparameter optimization was performed, contains the hyperparameter values of the best performing model.

" } }, + "UntagResourceRequest": { + "base": null, + "refs": { + } + }, + "UntagResourceResponse": { + "base": null, + "refs": { + } + }, "UpdateCampaignRequest": { "base": null, "refs": { diff --git a/models/apis/pi/2018-02-27/docs-2.json b/models/apis/pi/2018-02-27/docs-2.json index 63c9b5ae6a8..823f616d41b 100644 --- a/models/apis/pi/2018-02-27/docs-2.json +++ b/models/apis/pi/2018-02-27/docs-2.json @@ -1,11 +1,11 @@ { "version": "2.0", - "service": "Amazon RDS Performance Insights

Amazon RDS Performance Insights enables you to monitor and explore different dimensions of database load based on data captured from a running DB instance. The guide provides detailed information about Performance Insights data types, parameters and errors.

When Performance Insights is enabled, the Amazon RDS Performance Insights API provides visibility into the performance of your DB instance. Amazon CloudWatch provides the authoritative source for Amazon Web Services service-vended monitoring metrics. Performance Insights offers a domain-specific view of DB load.

DB load is measured as average active sessions. Performance Insights provides the data to API consumers as a two-dimensional time-series dataset. The time dimension provides DB load data for each time point in the queried time range. Each time point decomposes overall load in relation to the requested dimensions, measured at that time point. Examples include SQL, Wait event, User, and Host.

", + "service": "Amazon RDS Performance Insights

Amazon RDS Performance Insights enables you to monitor and explore different dimensions of database load based on data captured from a running DB instance. The guide provides detailed information about Performance Insights data types, parameters and errors.

When Performance Insights is enabled, the Amazon RDS Performance Insights API provides visibility into the performance of your DB instance. Amazon CloudWatch provides the authoritative source for Amazon Web Services service-vended monitoring metrics. Performance Insights offers a domain-specific view of DB load.

DB load is measured as average active sessions. Performance Insights provides the data to API consumers as a two-dimensional time-series dataset. The time dimension provides DB load data for each time point in the queried time range. Each time point decomposes overall load in relation to the requested dimensions, measured at that time point. Examples include SQL, Wait event, User, and Host.

", "operations": { "DescribeDimensionKeys": "

For a specific time period, retrieve the top N dimension keys for a metric.

Each response element returns a maximum of 500 bytes. For larger elements, such as SQL statements, only the first 500 bytes are returned.

", - "GetDimensionKeyDetails": "

Get the attributes of the specified dimension group for a DB instance or data source. For example, if you specify a SQL ID, GetDimensionKeyDetails retrieves the full text of the dimension db.sql.statementcassociated with this ID. This operation is useful because GetResourceMetrics and DescribeDimensionKeys don't support retrieval of large SQL statement text.

", + "GetDimensionKeyDetails": "

Get the attributes of the specified dimension group for a DB instance or data source. For example, if you specify a SQL ID, GetDimensionKeyDetails retrieves the full text of the dimension db.sql.statement associated with this ID. This operation is useful because GetResourceMetrics and DescribeDimensionKeys don't support retrieval of large SQL statement text.

", "GetResourceMetadata": "

Retrieve the metadata for different features. For example, the metadata might indicate that a feature is turned on or off on a specific DB instance.

", - "GetResourceMetrics": "

Retrieve Performance Insights metrics for a set of data sources, over a time period. You can provide specific dimension groups and dimensions, and provide aggregation and filtering criteria for each group.

Each response element returns a maximum of 500 bytes. For larger elements, such as SQL statements, only the first 500 bytes are returned.

", + "GetResourceMetrics": "

Retrieve Performance Insights metrics for a set of data sources over a time period. You can provide specific dimension groups and dimensions, and provide aggregation and filtering criteria for each group.

Each response element returns a maximum of 500 bytes. For larger elements, such as SQL statements, only the first 500 bytes are returned.

", "ListAvailableResourceDimensions": "

Retrieve the dimensions that can be queried for each specified metric type on a specified DB instance.

", "ListAvailableResourceMetrics": "

Retrieve metrics of the specified types that can be queried for a specified DB instance.

" }, @@ -13,7 +13,7 @@ "AdditionalMetricsList": { "base": null, "refs": { - "DescribeDimensionKeysRequest$AdditionalMetrics": "

Additional metrics for the top N dimension keys. If the specified dimension group in the GroupBy parameter is db.sql_tokenized, you can specify per-SQL metrics to get the values for the top N SQL digests. The response syntax is \"AdditionalMetrics\" : { \"string\" : \"string\" }.

" + "DescribeDimensionKeysRequest$AdditionalMetrics": "

Additional metrics for the top N dimension keys. If the specified dimension group in the GroupBy parameter is db.sql_tokenized, you can specify per-SQL metrics to get the values for the top N SQL digests. The response syntax is as follows: \"AdditionalMetrics\" : { \"string\" : \"string\" }.

" } }, "AdditionalMetricsMap": { @@ -53,7 +53,7 @@ "DetailStatus": { "base": null, "refs": { - "DimensionKeyDetail$Status": "

The status of the dimension detail data. Possible values include the following:

" + "DimensionKeyDetail$Status": "

The status of the dimension detail data. Possible values include the following:

" } }, "DimensionDetail": { @@ -69,7 +69,7 @@ } }, "DimensionGroup": { - "base": "

A logical grouping of Performance Insights metrics for a related subject area. For example, the db.sql dimension group consists of the following dimensions: db.sql.id, db.sql.db_id, db.sql.statement, and db.sql.tokenized_id.

Each response element returns a maximum of 500 bytes. For larger elements, such as SQL statements, only the first 500 bytes are returned.

", + "base": "

A logical grouping of Performance Insights metrics for a related subject area. For example, the db.sql dimension group consists of the following dimensions:

Each response element returns a maximum of 500 bytes. For larger elements, such as SQL statements, only the first 500 bytes are returned.

", "refs": { "DescribeDimensionKeysRequest$GroupBy": "

A specification for how to aggregate the data points from a query result. You must specify a valid dimension group. Performance Insights returns all dimensions within this group, unless you provide the names of specific dimensions within this group. You can also request that Performance Insights return a limited number of values for a dimension.

", "DescribeDimensionKeysRequest$PartitionBy": "

For each dimension specified in GroupBy, specify a secondary dimension to further subdivide the partition keys in the response.

", @@ -158,7 +158,7 @@ "FeatureStatus": { "base": null, "refs": { - "FeatureMetadata$Status": "

The status of the feature on the DB instance. Possible values include the following:

" + "FeatureMetadata$Status": "

The status of the feature on the DB instance. Possible values include the following:

" } }, "GetDimensionKeyDetailsRequest": { @@ -199,8 +199,8 @@ "DescribeDimensionKeysRequest$EndTime": "

The date and time specifying the end of the requested time series data. The value specified is exclusive, which means that data points less than (but not equal to) EndTime are returned.

The value for EndTime must be later than the value for StartTime.

", "DescribeDimensionKeysResponse$AlignedStartTime": "

The start time for the returned dimension keys, after alignment to a granular boundary (as specified by PeriodInSeconds). AlignedStartTime will be less than or equal to the value of the user-specified StartTime.

", "DescribeDimensionKeysResponse$AlignedEndTime": "

The end time for the returned dimension keys, after alignment to a granular boundary (as specified by PeriodInSeconds). AlignedEndTime will be greater than or equal to the value of the user-specified Endtime.

", - "GetResourceMetricsRequest$StartTime": "

The date and time specifying the beginning of the requested time series data. You can't specify a StartTime that's earlier than 7 days ago. The value specified is inclusive - data points equal to or greater than StartTime will be returned.

The value for StartTime must be earlier than the value for EndTime.

", - "GetResourceMetricsRequest$EndTime": "

The date and time specifying the end of the requested time series data. The value specified is exclusive - data points less than (but not equal to) EndTime will be returned.

The value for EndTime must be later than the value for StartTime.

", + "GetResourceMetricsRequest$StartTime": "

The date and time specifying the beginning of the requested time series query range. You can't specify a StartTime that is earlier than 7 days ago. By default, Performance Insights has 7 days of retention, but you can extend this range up to 2 years. The value specified is inclusive. Thus, the command returns data points equal to or greater than StartTime.

The value for StartTime must be earlier than the value for EndTime.

", + "GetResourceMetricsRequest$EndTime": "

The date and time specifying the end of the requested time series query range. The value specified is exclusive. Thus, the command returns data points less than (but not equal to) EndTime.

The value for EndTime must be later than the value for StartTime.

", "GetResourceMetricsResponse$AlignedStartTime": "

The start time for the returned metrics, after alignment to a granular boundary (as specified by PeriodInSeconds). AlignedStartTime will be less than or equal to the value of the user-specified StartTime.

", "GetResourceMetricsResponse$AlignedEndTime": "

The end time for the returned metrics, after alignment to a granular boundary (as specified by PeriodInSeconds). AlignedEndTime will be greater than or equal to the value of the user-specified Endtime.

" } @@ -284,7 +284,7 @@ "MetricKeyDataPointsList": { "base": null, "refs": { - "GetResourceMetricsResponse$MetricList": "

An array of metric results,, where each array element contains all of the data points for a particular dimension.

" + "GetResourceMetricsResponse$MetricList": "

An array of metric results, where each array element contains all of the data points for a particular dimension.

" } }, "MetricQuery": { @@ -309,7 +309,7 @@ "MetricTypeList": { "base": null, "refs": { - "ListAvailableResourceMetricsRequest$MetricTypes": "

The types of metrics to return in the response. Valid values in the array include the following:

" + "ListAvailableResourceMetricsRequest$MetricTypes": "

The types of metrics to return in the response. Valid values in the array include the following:

" } }, "MetricValuesList": { @@ -321,7 +321,7 @@ "NextToken": { "base": null, "refs": { - "DescribeDimensionKeysRequest$NextToken": "

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

", + "DescribeDimensionKeysRequest$NextToken": "

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

", "DescribeDimensionKeysResponse$NextToken": "

A pagination token that indicates the response didn’t return all available records because MaxRecords was specified in the previous request. To get the remaining records, specify NextToken in a separate request with this value.

", "GetResourceMetricsRequest$NextToken": "

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

", "GetResourceMetricsResponse$NextToken": "

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

", @@ -342,18 +342,18 @@ "AdditionalMetricsList$member": null, "AdditionalMetricsMap$key": null, "DescribeDimensionKeysRequest$Identifier": "

An immutable, Amazon Web Services Region-unique identifier for a data source. Performance Insights gathers metrics from this data source.

To use an Amazon RDS instance as a data source, you specify its DbiResourceId value. For example, specify db-FAIHNTYBKTGAUSUZQYPDS2GW4A.

", - "DescribeDimensionKeysRequest$Metric": "

The name of a Performance Insights metric to be measured.

Valid values for Metric are:

If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg and db.sampledload.avg are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg showing the scaled values, db.sampledload.avg showing the raw values, and db.sampledload.avg less than db.load.avg. For most use cases, you can query db.load.avg only.

", - "DimensionGroup$Group": "

The name of the dimension group. Valid values are:

", + "DescribeDimensionKeysRequest$Metric": "

The name of a Performance Insights metric to be measured.

Valid values for Metric are:

If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg and db.sampledload.avg are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg showing the scaled values, db.sampledload.avg showing the raw values, and db.sampledload.avg less than db.load.avg. For most use cases, you can query db.load.avg only.

", + "DimensionGroup$Group": "

The name of the dimension group. Valid values are as follows:

", "DimensionMap$key": null, "DimensionMap$value": null, "DimensionsMetricList$member": null, - "GetDimensionKeyDetailsRequest$Group": "

The name of the dimension group. The only valid value is db.sql. Performance Insights searches the specified group for the dimension group ID.

", - "GetDimensionKeyDetailsRequest$GroupIdentifier": "

The ID of the dimension group from which to retrieve dimension details. For dimension group db.sql, the group ID is db.sql.id.

", + "GetDimensionKeyDetailsRequest$Group": "

The name of the dimension group. Performance Insights searches the specified group for the dimension group ID. The following group name values are valid:

", + "GetDimensionKeyDetailsRequest$GroupIdentifier": "

The ID of the dimension group from which to retrieve dimension details. For dimension group db.sql, the group ID is db.sql.id. The following group ID values are valid:

", "GetResourceMetadataRequest$Identifier": "

An immutable identifier for a data source that is unique for an Amazon Web Services Region. Performance Insights gathers metrics from this data source. To use a DB instance as a data source, specify its DbiResourceId value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X.

", - "GetResourceMetricsRequest$Identifier": "

An immutable, Amazon Web Services Region-unique identifier for a data source. Performance Insights gathers metrics from this data source.

To use a DB instance as a data source, specify its DbiResourceId value. For example, specify db-FAIHNTYBKTGAUSUZQYPDS2GW4A.

", + "GetResourceMetricsRequest$Identifier": "

An immutable identifier for a data source that is unique for an Amazon Web Services Region. Performance Insights gathers metrics from this data source. In the console, the identifier is shown as ResourceID. When you call DescribeDBInstances, the identifier is returned as DbiResourceId.

To use a DB instance as a data source, specify its DbiResourceId value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X.

", "ListAvailableResourceDimensionsRequest$Identifier": "

An immutable identifier for a data source that is unique within an Amazon Web Services Region. Performance Insights gathers metrics from this data source. To use an Amazon RDS DB instance as a data source, specify its DbiResourceId value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VWZ.

", "ListAvailableResourceMetricsRequest$Identifier": "

An immutable identifier for a data source that is unique within an Amazon Web Services Region. Performance Insights gathers metrics from this data source. To use an Amazon RDS DB instance as a data source, specify its DbiResourceId value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VWZ.

", - "MetricQuery$Metric": "

The name of a Performance Insights metric to be measured.

Valid values for Metric are:

If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg and db.sampledload.avg are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg showing the scaled values, db.sampledload.avg showing the raw values, and db.sampledload.avg less than db.load.avg. For most use cases, you can query db.load.avg only.

", + "MetricQuery$Metric": "

The name of a Performance Insights metric to be measured.

Valid values for Metric are:

If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg and db.sampledload.avg are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg showing the scaled values, db.sampledload.avg showing the raw values, and db.sampledload.avg less than db.load.avg. For most use cases, you can query db.load.avg only.

", "MetricQueryFilterMap$key": null, "MetricQueryFilterMap$value": null, "MetricTypeList$member": null, @@ -364,13 +364,13 @@ "RequestStringList": { "base": null, "refs": { - "DimensionGroup$Dimensions": "

A list of specific dimensions from a dimension group. If this parameter is not present, then it signifies that all of the dimensions in the group were requested, or are present in the response.

Valid values for elements in the Dimensions array are:

" + "DimensionGroup$Dimensions": "

A list of specific dimensions from a dimension group. If this parameter is not present, then it signifies that all of the dimensions in the group were requested, or are present in the response.

Valid values for elements in the Dimensions array are:

" } }, "RequestedDimensionList": { "base": null, "refs": { - "GetDimensionKeyDetailsRequest$RequestedDimensions": "

A list of dimensions to retrieve the detail data for within the given dimension group. For the dimension group db.sql, specify either the full dimension name db.sql.statement or the short dimension name statement. If you don't specify this parameter, Performance Insights returns all dimension data within the specified dimension group.

" + "GetDimensionKeyDetailsRequest$RequestedDimensions": "

A list of dimensions to retrieve the detail data for within the given dimension group. If you don't specify this parameter, Performance Insights returns all dimension data within the specified dimension group. Specify dimension names for the following dimension groups:

" } }, "ResponsePartitionKey": { @@ -406,10 +406,10 @@ "ServiceType": { "base": null, "refs": { - "DescribeDimensionKeysRequest$ServiceType": "

The Amazon Web Services service for which Performance Insights will return metrics. The only valid value for ServiceType is RDS.

", + "DescribeDimensionKeysRequest$ServiceType": "

The Amazon Web Services service for which Performance Insights will return metrics. Valid values are as follows:

", "GetDimensionKeyDetailsRequest$ServiceType": "

The Amazon Web Services service for which Performance Insights returns data. The only valid value is RDS.

", "GetResourceMetadataRequest$ServiceType": "

The Amazon Web Services service for which Performance Insights returns metrics.

", - "GetResourceMetricsRequest$ServiceType": "

The Amazon Web Services service for which Performance Insights returns metrics. The only valid value for ServiceType is RDS.

", + "GetResourceMetricsRequest$ServiceType": "

The Amazon Web Services service for which Performance Insights returns metrics. Valid values are as follows:

", "ListAvailableResourceDimensionsRequest$ServiceType": "

The Amazon Web Services service for which Performance Insights returns metrics.

", "ListAvailableResourceMetricsRequest$ServiceType": "

The Amazon Web Services service for which Performance Insights returns metrics.

" } @@ -419,15 +419,15 @@ "refs": { "DimensionDetail$Identifier": "

The identifier of a dimension.

", "DimensionGroupDetail$Group": "

The name of the dimension group.

", - "DimensionKeyDetail$Value": "

The value of the dimension detail data. For the db.sql.statement dimension, this value is either the full or truncated SQL query, depending on the return status.

", - "DimensionKeyDetail$Dimension": "

The full name of the dimension. The full name includes the group name and key name. The only valid value is db.sql.statement.

", + "DimensionKeyDetail$Value": "

The value of the dimension detail data. Depending on the return status, this value is either the full or truncated SQL query for the following dimensions:

", + "DimensionKeyDetail$Dimension": "

The full name of the dimension. The full name includes the group name and key name. The following values are valid:

", "FeatureMetadataMap$key": null, "GetResourceMetadataResponse$Identifier": "

An immutable identifier for a data source that is unique for an Amazon Web Services Region. Performance Insights gathers metrics from this data source. To use a DB instance as a data source, specify its DbiResourceId value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X.

", - "GetResourceMetricsResponse$Identifier": "

An immutable, Amazon Web Services Region-unique identifier for a data source. Performance Insights gathers metrics from this data source.

To use a DB instance as a data source, you specify its DbiResourceId value - for example: db-FAIHNTYBKTGAUSUZQYPDS2GW4A

", + "GetResourceMetricsResponse$Identifier": "

An immutable identifier for a data source that is unique for an Amazon Web Services Region. Performance Insights gathers metrics from this data source. In the console, the identifier is shown as ResourceID. When you call DescribeDBInstances, the identifier is returned as DbiResourceId.

", "MetricDimensionGroups$Metric": "

The metric type to which the dimension information belongs.

", "ResponseResourceMetric$Metric": "

The full name of the metric.

", "ResponseResourceMetric$Unit": "

The unit of the metric.

", - "ResponseResourceMetricKey$Metric": "

The name of a Performance Insights metric to be measured.

Valid values for Metric are:

If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg and db.sampledload.avg are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg showing the scaled values, db.sampledload.avg showing the raw values, and db.sampledload.avg less than db.load.avg. For most use cases, you can query db.load.avg only.

" + "ResponseResourceMetricKey$Metric": "

The name of a Performance Insights metric to be measured.

Valid values for Metric are:

If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg and db.sampledload.avg are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg showing the scaled values, db.sampledload.avg showing the raw values, and db.sampledload.avg less than db.load.avg. For most use cases, you can query db.load.avg only.

" } } } diff --git a/models/apis/sagemaker/2017-07-24/api-2.json b/models/apis/sagemaker/2017-07-24/api-2.json index 5b50c4174fe..668b53eb7de 100644 --- a/models/apis/sagemaker/2017-07-24/api-2.json +++ b/models/apis/sagemaker/2017-07-24/api-2.json @@ -9606,7 +9606,15 @@ "ml.r5.8xlarge", "ml.r5.12xlarge", "ml.r5.16xlarge", - "ml.r5.24xlarge" + "ml.r5.24xlarge", + "ml.g5.xlarge", + "ml.g5.2xlarge", + "ml.g5.4xlarge", + "ml.g5.8xlarge", + "ml.g5.16xlarge", + "ml.g5.12xlarge", + "ml.g5.24xlarge", + "ml.g5.48xlarge" ] }, "Integer":{"type":"integer"}, diff --git a/private/model/api/customization_passes.go b/private/model/api/customization_passes.go index c32f65cec5e..0b7b8e6950f 100644 --- a/private/model/api/customization_passes.go +++ b/private/model/api/customization_passes.go @@ -75,6 +75,7 @@ func (a *API) customizationPasses() error { "AssumeRoleWithSAML", "AssumeRoleWithWebIdentity", ), + "eventbridge": eventBridgeCustomizations, } for k := range mergeServices { @@ -147,6 +148,54 @@ func addHTTPChecksumCustomDocumentation(a *API) error { return nil } +func eventBridgeCustomizations(a *API) error { + // Inject documentation to indicate PutEvents API does not support EndpointId routing to a multi-region endpoint + // using SigV4a signing. + + const docAddon = "// This AWS SDK does not support calling multi-region endpoints with SigV4a authentication." + + var sb strings.Builder + + op, ok := a.Operations["PutEvents"] + if !ok { + return nil + } + + op.Documentation = appendDocString(&sb, op.Documentation, docAddon) + + const putEventsInputShape = "PutEventsInput" + input, ok := a.Shapes[putEventsInputShape] + if !ok { + return nil + } + + const endpointIdMember = "EndpointId" + mref, ok := input.MemberRefs[endpointIdMember] + if !ok { + return nil + } + + mref.Documentation = appendDocString(&sb, mref.Documentation, docAddon) + + return nil +} + +func appendDocString(sb *strings.Builder, doc, content string) string { + if len(content) == 0 { + return doc + } + sb.Reset() + sb.WriteString(doc) + if sb.Len() > 0 { + if doc[len(doc)-1] != '\n' { + sb.WriteRune('\n') + } + sb.WriteString("//\n") + } + sb.WriteString(content) + return sb.String() +} + func supressSmokeTest(a *API) error { a.SmokeTests.TestCases = []SmokeTestCase{} return nil diff --git a/service/docdb/api.go b/service/docdb/api.go index 580e166fdc6..843076c9c5d 100644 --- a/service/docdb/api.go +++ b/service/docdb/api.go @@ -404,7 +404,7 @@ func (c *DocDB) CopyDBClusterSnapshotRequest(input *CopyDBClusterSnapshotInput) // To copy a cluster snapshot from a shared manual cluster snapshot, SourceDBClusterSnapshotIdentifier // must be the Amazon Resource Name (ARN) of the shared cluster snapshot. You // can only copy a shared DB cluster snapshot, whether encrypted or not, in -// the same Region. +// the same Amazon Web Services Region. // // To cancel the copy operation after it is in progress, delete the target cluster // snapshot identified by TargetDBClusterSnapshotIdentifier while that cluster @@ -956,7 +956,7 @@ func (c *DocDB) CreateDBSubnetGroupRequest(input *CreateDBSubnetGroupInput) (req // CreateDBSubnetGroup API operation for Amazon DocumentDB with MongoDB compatibility. // // Creates a new subnet group. subnet groups must contain at least one subnet -// in at least two Availability Zones in the Region. +// in at least two Availability Zones in the Amazon Web Services Region. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -1168,11 +1168,11 @@ func (c *DocDB) CreateGlobalClusterRequest(input *CreateGlobalClusterInput) (req // CreateGlobalCluster API operation for Amazon DocumentDB with MongoDB compatibility. // // Creates an Amazon DocumentDB global cluster that can span multiple multiple -// Regions. The global cluster contains one primary cluster with read-write -// capability, and up-to give read-only secondary clusters. Global clusters -// uses storage-based fast replication across regions with latencies less than -// one second, using dedicated infrastructure with no impact to your workload’s -// performance. +// Amazon Web Services Regions. The global cluster contains one primary cluster +// with read-write capability, and up-to give read-only secondary clusters. +// Global clusters uses storage-based fast replication across regions with latencies +// less than one second, using dedicated infrastructure with no impact to your +// workload’s performance. // // You can create a global cluster that is initially empty, and then add a primary // and a secondary to it. Or you can specify an existing cluster during the @@ -1886,7 +1886,7 @@ func (c *DocDB) DescribeCertificatesRequest(input *DescribeCertificatesInput) (r // DescribeCertificates API operation for Amazon DocumentDB with MongoDB compatibility. // // Returns a list of certificate authority (CA) certificates provided by Amazon -// DocumentDB for this account. +// DocumentDB for this Amazon Web Services account. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -2296,11 +2296,12 @@ func (c *DocDB) DescribeDBClusterSnapshotAttributesRequest(input *DescribeDBClus // Returns a list of cluster snapshot attribute names and values for a manual // DB cluster snapshot. // -// When you share snapshots with other accounts, DescribeDBClusterSnapshotAttributes -// returns the restore attribute and a list of IDs for the accounts that are -// authorized to copy or restore the manual cluster snapshot. If all is included -// in the list of values for the restore attribute, then the manual cluster -// snapshot is public and can be copied or restored by all accounts. +// When you share snapshots with other Amazon Web Services accounts, DescribeDBClusterSnapshotAttributes +// returns the restore attribute and a list of IDs for the Amazon Web Services +// accounts that are authorized to copy or restore the manual cluster snapshot. +// If all is included in the list of values for the restore attribute, then +// the manual cluster snapshot is public and can be copied or restored by all +// Amazon Web Services accounts. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -4295,16 +4296,17 @@ func (c *DocDB) ModifyDBClusterSnapshotAttributeRequest(input *ModifyDBClusterSn // Adds an attribute and values to, or removes an attribute and values from, // a manual cluster snapshot. // -// To share a manual cluster snapshot with other accounts, specify restore as -// the AttributeName, and use the ValuesToAdd parameter to add a list of IDs -// of the accounts that are authorized to restore the manual cluster snapshot. -// Use the value all to make the manual cluster snapshot public, which means -// that it can be copied or restored by all accounts. Do not add the all value -// for any manual cluster snapshots that contain private information that you -// don't want available to all accounts. If a manual cluster snapshot is encrypted, -// it can be shared, but only by specifying a list of authorized account IDs -// for the ValuesToAdd parameter. You can't use all as a value for that parameter -// in this case. +// To share a manual cluster snapshot with other Amazon Web Services accounts, +// specify restore as the AttributeName, and use the ValuesToAdd parameter to +// add a list of IDs of the Amazon Web Services accounts that are authorized +// to restore the manual cluster snapshot. Use the value all to make the manual +// cluster snapshot public, which means that it can be copied or restored by +// all Amazon Web Services accounts. Do not add the all value for any manual +// cluster snapshots that contain private information that you don't want available +// to all Amazon Web Services accounts. If a manual cluster snapshot is encrypted, +// it can be shared, but only by specifying a list of authorized Amazon Web +// Services account IDs for the ValuesToAdd parameter. You can't use all as +// a value for that parameter in this case. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -4514,7 +4516,7 @@ func (c *DocDB) ModifyDBSubnetGroupRequest(input *ModifyDBSubnetGroupInput) (req // ModifyDBSubnetGroup API operation for Amazon DocumentDB with MongoDB compatibility. // // Modifies an existing subnet group. subnet groups must contain at least one -// subnet in at least two Availability Zones in the Region. +// subnet in at least two Availability Zones in the Amazon Web Services Region. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -5968,7 +5970,7 @@ func (s *AvailabilityZone) SetName(v string) *AvailabilityZone { return s } -// A certificate authority (CA) certificate for an account. +// A certificate authority (CA) certificate for an Amazon Web Services account. type Certificate struct { _ struct{} `type:"structure"` @@ -6112,12 +6114,13 @@ type CopyDBClusterParameterGroupInput struct { // // * Must specify a valid cluster parameter group. // - // * If the source cluster parameter group is in the same Region as the copy, - // specify a valid parameter group identifier; for example, my-db-cluster-param-group, - // or a valid ARN. + // * If the source cluster parameter group is in the same Amazon Web Services + // Region as the copy, specify a valid parameter group identifier; for example, + // my-db-cluster-param-group, or a valid ARN. // - // * If the source parameter group is in a different Region than the copy, - // specify a valid cluster parameter group ARN; for example, arn:aws:rds:us-east-1:123456789012:sample-cluster:sample-parameter-group. + // * If the source parameter group is in a different Amazon Web Services + // Region than the copy, specify a valid cluster parameter group ARN; for + // example, arn:aws:rds:us-east-1:123456789012:sample-cluster:sample-parameter-group. // // SourceDBClusterParameterGroupIdentifier is a required field SourceDBClusterParameterGroupIdentifier *string `type:"string" required:"true"` @@ -6255,47 +6258,50 @@ type CopyDBClusterSnapshotInput struct { // Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS // encryption key. // - // If you copy an encrypted cluster snapshot from your account, you can specify - // a value for KmsKeyId to encrypt the copy with a new KMS encryption key. If - // you don't specify a value for KmsKeyId, then the copy of the cluster snapshot - // is encrypted with the same KMS key as the source cluster snapshot. + // If you copy an encrypted cluster snapshot from your Amazon Web Services account, + // you can specify a value for KmsKeyId to encrypt the copy with a new KMS encryption + // key. If you don't specify a value for KmsKeyId, then the copy of the cluster + // snapshot is encrypted with the same KMS key as the source cluster snapshot. // - // If you copy an encrypted cluster snapshot that is shared from another account, - // then you must specify a value for KmsKeyId. + // If you copy an encrypted cluster snapshot that is shared from another Amazon + // Web Services account, then you must specify a value for KmsKeyId. // - // To copy an encrypted cluster snapshot to another Region, set KmsKeyId to - // the KMS key ID that you want to use to encrypt the copy of the cluster snapshot - // in the destination Region. KMS encryption keys are specific to the Region - // that they are created in, and you can't use encryption keys from one Region - // in another Region. + // To copy an encrypted cluster snapshot to another Amazon Web Services Region, + // set KmsKeyId to the KMS key ID that you want to use to encrypt the copy of + // the cluster snapshot in the destination Region. KMS encryption keys are specific + // to the Amazon Web Services Region that they are created in, and you can't + // use encryption keys from one Amazon Web Services Region in another Amazon + // Web Services Region. // // If you copy an unencrypted cluster snapshot and specify a value for the KmsKeyId // parameter, an error is returned. KmsKeyId *string `type:"string"` // The URL that contains a Signature Version 4 signed request for theCopyDBClusterSnapshot - // API action in the Region that contains the source cluster snapshot to copy. - // You must use the PreSignedUrl parameter when copying a cluster snapshot from - // another Region. + // API action in the Amazon Web Services Region that contains the source cluster + // snapshot to copy. You must use the PreSignedUrl parameter when copying a + // cluster snapshot from another Amazon Web Services Region. // // If you are using an Amazon Web Services SDK tool or the CLI, you can specify // SourceRegion (or --source-region for the CLI) instead of specifying PreSignedUrl // manually. Specifying SourceRegion autogenerates a pre-signed URL that is - // a valid request for the operation that can be executed in the source Region. + // a valid request for the operation that can be executed in the source Amazon + // Web Services Region. // // The presigned URL must be a valid request for the CopyDBClusterSnapshot API - // action that can be executed in the source Region that contains the cluster - // snapshot to be copied. The presigned URL request must contain the following - // parameter values: + // action that can be executed in the source Amazon Web Services Region that + // contains the cluster snapshot to be copied. The presigned URL request must + // contain the following parameter values: // // * SourceRegion - The ID of the region that contains the snapshot to be // copied. // // * SourceDBClusterSnapshotIdentifier - The identifier for the the encrypted // cluster snapshot to be copied. This identifier must be in the Amazon Resource - // Name (ARN) format for the source Region. For example, if you are copying - // an encrypted cluster snapshot from the us-east-1 Region, then your SourceDBClusterSnapshotIdentifier - // looks something like the following: arn:aws:rds:us-east-1:12345678012:sample-cluster:sample-cluster-snapshot. + // Name (ARN) format for the source Amazon Web Services Region. For example, + // if you are copying an encrypted cluster snapshot from the us-east-1 Amazon + // Web Services Region, then your SourceDBClusterSnapshotIdentifier looks + // something like the following: arn:aws:rds:us-east-1:12345678012:sample-cluster:sample-cluster-snapshot. // // * TargetDBClusterSnapshotIdentifier - The identifier for the new cluster // snapshot to be created. This parameter isn't case sensitive. @@ -6308,11 +6314,11 @@ type CopyDBClusterSnapshotInput struct { // // * Must specify a valid system snapshot in the available state. // - // * If the source snapshot is in the same Region as the copy, specify a - // valid snapshot identifier. + // * If the source snapshot is in the same Amazon Web Services Region as + // the copy, specify a valid snapshot identifier. // - // * If the source snapshot is in a different Region than the copy, specify - // a valid cluster snapshot ARN. + // * If the source snapshot is in a different Amazon Web Services Region + // than the copy, specify a valid cluster snapshot ARN. // // Example: my-cluster-snapshot1 // @@ -6535,17 +6541,18 @@ type CreateDBClusterInput struct { // The KMS key identifier for an encrypted cluster. // // The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption - // key. If you are creating a cluster using the same account that owns the KMS - // encryption key that is used to encrypt the new cluster, you can use the KMS - // key alias instead of the ARN for the KMS encryption key. + // key. If you are creating a cluster using the same Amazon Web Services account + // that owns the KMS encryption key that is used to encrypt the new cluster, + // you can use the KMS key alias instead of the ARN for the KMS encryption key. // // If an encryption key is not specified in KmsKeyId: // // * If the StorageEncrypted parameter is true, Amazon DocumentDB uses your // default encryption key. // - // KMS creates the default encryption key for your account. Your account has - // a different default encryption key for each Regions. + // KMS creates the default encryption key for your Amazon Web Services account. + // Your Amazon Web Services account has a different default encryption key for + // each Amazon Web Services Regions. KmsKeyId *string `type:"string"` // The password for the master database user. This password can contain any @@ -6576,7 +6583,7 @@ type CreateDBClusterInput struct { // backups are enabled using the BackupRetentionPeriod parameter. // // The default is a 30-minute window selected at random from an 8-hour block - // of time for each Region. + // of time for each Amazon Web Services Region. // // Constraints: // @@ -6595,7 +6602,8 @@ type CreateDBClusterInput struct { // Format: ddd:hh24:mi-ddd:hh24:mi // // The default is a 30-minute window selected at random from an 8-hour block - // of time for each Region, occurring on a random day of the week. + // of time for each Amazon Web Services Region, occurring on a random day of + // the week. // // Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun // @@ -7069,7 +7077,8 @@ type CreateDBInstanceInput struct { // The Amazon EC2 Availability Zone that the instance is created in. // - // Default: A random, system-chosen Availability Zone in the endpoint's Region. + // Default: A random, system-chosen Availability Zone in the endpoint's Amazon + // Web Services Region. // // Example: us-east-1d AvailabilityZone *string `type:"string"` @@ -7099,6 +7108,10 @@ type CreateDBInstanceInput struct { // DBInstanceIdentifier is a required field DBInstanceIdentifier *string `type:"string" required:"true"` + // A value that indicates whether to enable Performance Insights for the DB + // Instance. For more information, see Using Amazon Performance Insights (https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html). + EnablePerformanceInsights *bool `type:"boolean"` + // The name of the database engine to be used for this instance. // // Valid value: docdb @@ -7106,13 +7119,25 @@ type CreateDBInstanceInput struct { // Engine is a required field Engine *string `type:"string" required:"true"` + // The KMS key identifier for encryption of Performance Insights data. + // + // The KMS key identifier is the key ARN, key ID, alias ARN, or alias name for + // the KMS key. + // + // If you do not specify a value for PerformanceInsightsKMSKeyId, then Amazon + // DocumentDB uses your default KMS key. There is a default KMS key for your + // Amazon Web Services account. Your Amazon Web Services account has a different + // default KMS key for each Amazon Web Services region. + PerformanceInsightsKMSKeyId *string `type:"string"` + // The time range each week during which system maintenance can occur, in Universal // Coordinated Time (UTC). // // Format: ddd:hh24:mi-ddd:hh24:mi // // The default is a 30-minute window selected at random from an 8-hour block - // of time for each Region, occurring on a random day of the week. + // of time for each Amazon Web Services Region, occurring on a random day of + // the week. // // Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun // @@ -7203,12 +7228,24 @@ func (s *CreateDBInstanceInput) SetDBInstanceIdentifier(v string) *CreateDBInsta return s } +// SetEnablePerformanceInsights sets the EnablePerformanceInsights field's value. +func (s *CreateDBInstanceInput) SetEnablePerformanceInsights(v bool) *CreateDBInstanceInput { + s.EnablePerformanceInsights = &v + return s +} + // SetEngine sets the Engine field's value. func (s *CreateDBInstanceInput) SetEngine(v string) *CreateDBInstanceInput { s.Engine = &v return s } +// SetPerformanceInsightsKMSKeyId sets the PerformanceInsightsKMSKeyId field's value. +func (s *CreateDBInstanceInput) SetPerformanceInsightsKMSKeyId(v string) *CreateDBInstanceInput { + s.PerformanceInsightsKMSKeyId = &v + return s +} + // SetPreferredMaintenanceWindow sets the PreferredMaintenanceWindow field's value. func (s *CreateDBInstanceInput) SetPreferredMaintenanceWindow(v string) *CreateDBInstanceInput { s.PreferredMaintenanceWindow = &v @@ -7718,9 +7755,9 @@ type DBCluster struct { // including the name, description, and subnets in the subnet group. DBSubnetGroup *string `type:"string"` - // The Region-unique, immutable identifier for the cluster. This identifier - // is found in CloudTrail log entries whenever the KMS key for the cluster is - // accessed. + // The Amazon Web Services Region-unique, immutable identifier for the cluster. + // This identifier is found in CloudTrail log entries whenever the KMS key for + // the cluster is accessed. DbClusterResourceId *string `type:"string"` // Specifies whether this cluster can be deleted. If DeletionProtection is enabled, @@ -8372,23 +8409,24 @@ func (s *DBClusterSnapshot) SetVpcId(v string) *DBClusterSnapshot { // Contains the name and values of a manual cluster snapshot attribute. // -// Manual cluster snapshot attributes are used to authorize other accounts to -// restore a manual cluster snapshot. +// Manual cluster snapshot attributes are used to authorize other Amazon Web +// Services accounts to restore a manual cluster snapshot. type DBClusterSnapshotAttribute struct { _ struct{} `type:"structure"` // The name of the manual cluster snapshot attribute. // - // The attribute named restore refers to the list of accounts that have permission - // to copy or restore the manual cluster snapshot. + // The attribute named restore refers to the list of Amazon Web Services accounts + // that have permission to copy or restore the manual cluster snapshot. AttributeName *string `type:"string"` // The values for the manual cluster snapshot attribute. // // If the AttributeName field is set to restore, then this element returns a - // list of IDs of the accounts that are authorized to copy or restore the manual - // cluster snapshot. If a value of all is in the list, then the manual cluster - // snapshot is public and available for any account to copy or restore. + // list of IDs of the Amazon Web Services accounts that are authorized to copy + // or restore the manual cluster snapshot. If a value of all is in the list, + // then the manual cluster snapshot is public and available for any Amazon Web + // Services account to copy or restore. AttributeValues []*string `locationNameList:"AttributeValue" type:"list"` } @@ -8602,9 +8640,9 @@ type DBInstance struct { // including the name, description, and subnets in the subnet group. DBSubnetGroup *DBSubnetGroup `type:"structure"` - // The Region-unique, immutable identifier for the instance. This identifier - // is found in CloudTrail log entries whenever the KMS key for the instance - // is accessed. + // The Amazon Web Services Region-unique, immutable identifier for the instance. + // This identifier is found in CloudTrail log entries whenever the KMS key for + // the instance is accessed. DbiResourceId *string `type:"string"` // A list of log types that this instance is configured to export to CloudWatch @@ -9674,7 +9712,7 @@ func (s *DescribeCertificatesInput) SetMaxRecords(v int64) *DescribeCertificates type DescribeCertificatesOutput struct { _ struct{} `type:"structure"` - // A list of certificates for this account. + // A list of certificates for this Amazon Web Services account. Certificates []*Certificate `locationNameList:"Certificate" type:"list"` // An optional pagination token provided if the number of records retrieved @@ -10106,12 +10144,13 @@ type DescribeDBClusterSnapshotsInput struct { Filters []*Filter `locationNameList:"Filter" type:"list"` // Set to true to include manual cluster snapshots that are public and can be - // copied or restored by any account, and otherwise false. The default is false. + // copied or restored by any Amazon Web Services account, and otherwise false. + // The default is false. IncludePublic *bool `type:"boolean"` - // Set to true to include shared manual cluster snapshots from other accounts - // that this account has been given permission to copy or restore, and otherwise - // false. The default is false. + // Set to true to include shared manual cluster snapshots from other Amazon + // Web Services accounts that this Amazon Web Services account has been given + // permission to copy or restore, and otherwise false. The default is false. IncludeShared *bool `type:"boolean"` // An optional pagination token provided by a previous request. If this parameter @@ -10132,13 +10171,13 @@ type DescribeDBClusterSnapshotsInput struct { // following values: // // * automated - Return all cluster snapshots that Amazon DocumentDB has - // automatically created for your account. + // automatically created for your Amazon Web Services account. // // * manual - Return all cluster snapshots that you have manually created - // for your account. + // for your Amazon Web Services account. // // * shared - Return all manual cluster snapshots that have been shared to - // your account. + // your Amazon Web Services account. // // * public - Return all cluster snapshots that have been marked as public. // @@ -12404,9 +12443,9 @@ type GlobalCluster struct { // Currently limited to one item. GlobalClusterMembers []*GlobalClusterMember `locationNameList:"GlobalClusterMember" type:"list"` - // The Region-unique, immutable identifier for the global database cluster. - // This identifier is found in AWS CloudTrail log entries whenever the AWS KMS - // customer master key (CMK) for the cluster is accessed. + // The Amazon Web Services Region-unique, immutable identifier for the global + // database cluster. This identifier is found in AWS CloudTrail log entries + // whenever the AWS KMS customer master key (CMK) for the cluster is accessed. GlobalClusterResourceId *string `type:"string"` // Specifies the current state of this global cluster. @@ -12737,7 +12776,7 @@ type ModifyDBClusterInput struct { // backups are enabled, using the BackupRetentionPeriod parameter. // // The default is a 30-minute window selected at random from an 8-hour block - // of time for each Region. + // of time for each Amazon Web Services Region. // // Constraints: // @@ -12756,7 +12795,8 @@ type ModifyDBClusterInput struct { // Format: ddd:hh24:mi-ddd:hh24:mi // // The default is a 30-minute window selected at random from an 8-hour block - // of time for each Region, occurring on a random day of the week. + // of time for each Amazon Web Services Region, occurring on a random day of + // the week. // // Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun // @@ -13017,8 +13057,8 @@ type ModifyDBClusterSnapshotAttributeInput struct { // The name of the cluster snapshot attribute to modify. // - // To manage authorization for other accounts to copy or restore a manual cluster - // snapshot, set this value to restore. + // To manage authorization for other Amazon Web Services accounts to copy or + // restore a manual cluster snapshot, set this value to restore. // // AttributeName is a required field AttributeName *string `type:"string" required:"true"` @@ -13031,22 +13071,24 @@ type ModifyDBClusterSnapshotAttributeInput struct { // A list of cluster snapshot attributes to add to the attribute specified by // AttributeName. // - // To authorize other accounts to copy or restore a manual cluster snapshot, - // set this list to include one or more account IDs. To make the manual cluster - // snapshot restorable by any account, set it to all. Do not add the all value - // for any manual cluster snapshots that contain private information that you - // don't want to be available to all accounts. + // To authorize other Amazon Web Services accounts to copy or restore a manual + // cluster snapshot, set this list to include one or more Amazon Web Services + // account IDs. To make the manual cluster snapshot restorable by any Amazon + // Web Services account, set it to all. Do not add the all value for any manual + // cluster snapshots that contain private information that you don't want to + // be available to all Amazon Web Services accounts. ValuesToAdd []*string `locationNameList:"AttributeValue" type:"list"` // A list of cluster snapshot attributes to remove from the attribute specified // by AttributeName. // - // To remove authorization for other accounts to copy or restore a manual cluster - // snapshot, set this list to include one or more account identifiers. To remove - // authorization for any account to copy or restore the cluster snapshot, set - // it to all . If you specify all, an account whose account ID is explicitly - // added to the restore attribute can still copy or restore a manual cluster - // snapshot. + // To remove authorization for other Amazon Web Services accounts to copy or + // restore a manual cluster snapshot, set this list to include one or more Amazon + // Web Services account identifiers. To remove authorization for any Amazon + // Web Services account to copy or restore the cluster snapshot, set it to all + // . If you specify all, an Amazon Web Services account whose account ID is + // explicitly added to the restore attribute can still copy or restore a manual + // cluster snapshot. ValuesToRemove []*string `locationNameList:"AttributeValue" type:"list"` } @@ -13163,7 +13205,7 @@ type ModifyDBInstanceInput struct { CACertificateIdentifier *string `type:"string"` // The new compute and memory capacity of the instance; for example, db.r5.large. - // Not all instance classes are available in all Regions. + // Not all instance classes are available in all Amazon Web Services Regions. // // If you modify the instance class, an outage occurs during the change. The // change is applied during the next maintenance window, unless ApplyImmediately @@ -13181,6 +13223,10 @@ type ModifyDBInstanceInput struct { // DBInstanceIdentifier is a required field DBInstanceIdentifier *string `type:"string" required:"true"` + // A value that indicates whether to enable Performance Insights for the DB + // Instance. For more information, see Using Amazon Performance Insights (https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html). + EnablePerformanceInsights *bool `type:"boolean"` + // The new instance identifier for the instance when renaming an instance. When // you change the instance identifier, an instance reboot occurs immediately // if you set Apply Immediately to true. It occurs during the next maintenance @@ -13198,6 +13244,17 @@ type ModifyDBInstanceInput struct { // Example: mydbinstance NewDBInstanceIdentifier *string `type:"string"` + // The KMS key identifier for encryption of Performance Insights data. + // + // The KMS key identifier is the key ARN, key ID, alias ARN, or alias name for + // the KMS key. + // + // If you do not specify a value for PerformanceInsightsKMSKeyId, then Amazon + // DocumentDB uses your default KMS key. There is a default KMS key for your + // Amazon Web Services account. Your Amazon Web Services account has a different + // default KMS key for each Amazon Web Services region. + PerformanceInsightsKMSKeyId *string `type:"string"` + // The weekly time range (in UTC) during which system maintenance can occur, // which might result in an outage. Changing this parameter doesn't result in // an outage except in the following situation, and the change is asynchronously @@ -13287,12 +13344,24 @@ func (s *ModifyDBInstanceInput) SetDBInstanceIdentifier(v string) *ModifyDBInsta return s } +// SetEnablePerformanceInsights sets the EnablePerformanceInsights field's value. +func (s *ModifyDBInstanceInput) SetEnablePerformanceInsights(v bool) *ModifyDBInstanceInput { + s.EnablePerformanceInsights = &v + return s +} + // SetNewDBInstanceIdentifier sets the NewDBInstanceIdentifier field's value. func (s *ModifyDBInstanceInput) SetNewDBInstanceIdentifier(v string) *ModifyDBInstanceInput { s.NewDBInstanceIdentifier = &v return s } +// SetPerformanceInsightsKMSKeyId sets the PerformanceInsightsKMSKeyId field's value. +func (s *ModifyDBInstanceInput) SetPerformanceInsightsKMSKeyId(v string) *ModifyDBInstanceInput { + s.PerformanceInsightsKMSKeyId = &v + return s +} + // SetPreferredMaintenanceWindow sets the PreferredMaintenanceWindow field's value. func (s *ModifyDBInstanceInput) SetPreferredMaintenanceWindow(v string) *ModifyDBInstanceInput { s.PreferredMaintenanceWindow = &v @@ -14735,9 +14804,9 @@ type RestoreDBClusterFromSnapshotInput struct { // DB snapshot or cluster snapshot. // // The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption - // key. If you are restoring a cluster with the same account that owns the KMS - // encryption key used to encrypt the new cluster, then you can use the KMS - // key alias instead of the ARN for the KMS encryption key. + // key. If you are restoring a cluster with the same Amazon Web Services account + // that owns the KMS encryption key used to encrypt the new cluster, then you + // can use the KMS key alias instead of the ARN for the KMS encryption key. // // If you do not specify a value for the KmsKeyId parameter, then the following // occurs: @@ -14955,9 +15024,9 @@ type RestoreDBClusterToPointInTimeInput struct { // encrypted cluster. // // The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption - // key. If you are restoring a cluster with the same account that owns the KMS - // encryption key used to encrypt the new cluster, then you can use the KMS - // key alias instead of the ARN for the KMS encryption key. + // key. If you are restoring a cluster with the same Amazon Web Services account + // that owns the KMS encryption key used to encrypt the new cluster, then you + // can use the KMS key alias instead of the ARN for the KMS encryption key. // // You can restore to a new cluster and encrypt the new cluster with an KMS // key that is different from the KMS key used to encrypt the source cluster. diff --git a/service/eventbridge/api.go b/service/eventbridge/api.go index 21c5fa8dfb7..a8969b93ab2 100644 --- a/service/eventbridge/api.go +++ b/service/eventbridge/api.go @@ -472,6 +472,97 @@ func (c *EventBridge) CreateConnectionWithContext(ctx aws.Context, input *Create return out, req.Send() } +const opCreateEndpoint = "CreateEndpoint" + +// CreateEndpointRequest generates a "aws/request.Request" representing the +// client's request for the CreateEndpoint operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See CreateEndpoint for more information on using the CreateEndpoint +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the CreateEndpointRequest method. +// req, resp := client.CreateEndpointRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/eventbridge-2015-10-07/CreateEndpoint +func (c *EventBridge) CreateEndpointRequest(input *CreateEndpointInput) (req *request.Request, output *CreateEndpointOutput) { + op := &request.Operation{ + Name: opCreateEndpoint, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &CreateEndpointInput{} + } + + output = &CreateEndpointOutput{} + req = c.newRequest(op, input, output) + return +} + +// CreateEndpoint API operation for Amazon EventBridge. +// +// Creates a global endpoint. Global endpoints improve your application's availability +// by making it regional-fault tolerant. To do this, you define a primary and +// secondary Region with event buses in each Region. You also create a Amazon +// Route 53 health check that will tell EventBridge to route events to the secondary +// Region when an "unhealthy" state is encountered and events will be routed +// back to the primary Region when the health check reports a "healthy" state. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon EventBridge's +// API operation CreateEndpoint for usage and error information. +// +// Returned Error Types: +// * ResourceAlreadyExistsException +// The resource you are trying to create already exists. +// +// * LimitExceededException +// The request failed because it attempted to create resource beyond the allowed +// service quota. +// +// * InternalException +// This exception occurs due to unexpected causes. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/eventbridge-2015-10-07/CreateEndpoint +func (c *EventBridge) CreateEndpoint(input *CreateEndpointInput) (*CreateEndpointOutput, error) { + req, out := c.CreateEndpointRequest(input) + return out, req.Send() +} + +// CreateEndpointWithContext is the same as CreateEndpoint with the addition of +// the ability to pass a context and additional request options. +// +// See CreateEndpoint for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *EventBridge) CreateEndpointWithContext(ctx aws.Context, input *CreateEndpointInput, opts ...request.Option) (*CreateEndpointOutput, error) { + req, out := c.CreateEndpointRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opCreateEventBus = "CreateEventBus" // CreateEventBusRequest generates a "aws/request.Request" representing the @@ -1133,6 +1224,95 @@ func (c *EventBridge) DeleteConnectionWithContext(ctx aws.Context, input *Delete return out, req.Send() } +const opDeleteEndpoint = "DeleteEndpoint" + +// DeleteEndpointRequest generates a "aws/request.Request" representing the +// client's request for the DeleteEndpoint operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See DeleteEndpoint for more information on using the DeleteEndpoint +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the DeleteEndpointRequest method. +// req, resp := client.DeleteEndpointRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/eventbridge-2015-10-07/DeleteEndpoint +func (c *EventBridge) DeleteEndpointRequest(input *DeleteEndpointInput) (req *request.Request, output *DeleteEndpointOutput) { + op := &request.Operation{ + Name: opDeleteEndpoint, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DeleteEndpointInput{} + } + + output = &DeleteEndpointOutput{} + req = c.newRequest(op, input, output) + req.Handlers.Unmarshal.Swap(jsonrpc.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler) + return +} + +// DeleteEndpoint API operation for Amazon EventBridge. +// +// Delete an existing global endpoint. For more information about global endpoints, +// see Making applications Regional-fault tolerant with global endpoints and +// event replication (https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-global-endpoints.html) +// in the Amazon EventBridge User Guide. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon EventBridge's +// API operation DeleteEndpoint for usage and error information. +// +// Returned Error Types: +// * ConcurrentModificationException +// There is concurrent modification on a rule, target, archive, or replay. +// +// * ResourceNotFoundException +// An entity that you specified does not exist. +// +// * InternalException +// This exception occurs due to unexpected causes. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/eventbridge-2015-10-07/DeleteEndpoint +func (c *EventBridge) DeleteEndpoint(input *DeleteEndpointInput) (*DeleteEndpointOutput, error) { + req, out := c.DeleteEndpointRequest(input) + return out, req.Send() +} + +// DeleteEndpointWithContext is the same as DeleteEndpoint with the addition of +// the ability to pass a context and additional request options. +// +// See DeleteEndpoint for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *EventBridge) DeleteEndpointWithContext(ctx aws.Context, input *DeleteEndpointInput, opts ...request.Option) (*DeleteEndpointOutput, error) { + req, out := c.DeleteEndpointRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDeleteEventBus = "DeleteEventBus" // DeleteEventBusRequest generates a "aws/request.Request" representing the @@ -1667,6 +1847,91 @@ func (c *EventBridge) DescribeConnectionWithContext(ctx aws.Context, input *Desc return out, req.Send() } +const opDescribeEndpoint = "DescribeEndpoint" + +// DescribeEndpointRequest generates a "aws/request.Request" representing the +// client's request for the DescribeEndpoint operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See DescribeEndpoint for more information on using the DescribeEndpoint +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the DescribeEndpointRequest method. +// req, resp := client.DescribeEndpointRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/eventbridge-2015-10-07/DescribeEndpoint +func (c *EventBridge) DescribeEndpointRequest(input *DescribeEndpointInput) (req *request.Request, output *DescribeEndpointOutput) { + op := &request.Operation{ + Name: opDescribeEndpoint, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DescribeEndpointInput{} + } + + output = &DescribeEndpointOutput{} + req = c.newRequest(op, input, output) + return +} + +// DescribeEndpoint API operation for Amazon EventBridge. +// +// Get the information about an existing global endpoint. For more information +// about global endpoints, see Making applications Regional-fault tolerant with +// global endpoints and event replication (https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-global-endpoints.html) +// in the Amazon EventBridge User Guide.. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon EventBridge's +// API operation DescribeEndpoint for usage and error information. +// +// Returned Error Types: +// * ResourceNotFoundException +// An entity that you specified does not exist. +// +// * InternalException +// This exception occurs due to unexpected causes. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/eventbridge-2015-10-07/DescribeEndpoint +func (c *EventBridge) DescribeEndpoint(input *DescribeEndpointInput) (*DescribeEndpointOutput, error) { + req, out := c.DescribeEndpointRequest(input) + return out, req.Send() +} + +// DescribeEndpointWithContext is the same as DescribeEndpoint with the addition of +// the ability to pass a context and additional request options. +// +// See DescribeEndpoint for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *EventBridge) DescribeEndpointWithContext(ctx aws.Context, input *DescribeEndpointInput, opts ...request.Option) (*DescribeEndpointOutput, error) { + req, out := c.DescribeEndpointRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDescribeEventBus = "DescribeEventBus" // DescribeEventBusRequest generates a "aws/request.Request" representing the @@ -2545,6 +2810,88 @@ func (c *EventBridge) ListConnectionsWithContext(ctx aws.Context, input *ListCon return out, req.Send() } +const opListEndpoints = "ListEndpoints" + +// ListEndpointsRequest generates a "aws/request.Request" representing the +// client's request for the ListEndpoints operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See ListEndpoints for more information on using the ListEndpoints +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the ListEndpointsRequest method. +// req, resp := client.ListEndpointsRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/eventbridge-2015-10-07/ListEndpoints +func (c *EventBridge) ListEndpointsRequest(input *ListEndpointsInput) (req *request.Request, output *ListEndpointsOutput) { + op := &request.Operation{ + Name: opListEndpoints, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &ListEndpointsInput{} + } + + output = &ListEndpointsOutput{} + req = c.newRequest(op, input, output) + return +} + +// ListEndpoints API operation for Amazon EventBridge. +// +// List the global endpoints associated with this account. For more information +// about global endpoints, see Making applications Regional-fault tolerant with +// global endpoints and event replication (https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-global-endpoints.html) +// in the Amazon EventBridge User Guide.. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon EventBridge's +// API operation ListEndpoints for usage and error information. +// +// Returned Error Types: +// * InternalException +// This exception occurs due to unexpected causes. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/eventbridge-2015-10-07/ListEndpoints +func (c *EventBridge) ListEndpoints(input *ListEndpointsInput) (*ListEndpointsOutput, error) { + req, out := c.ListEndpointsRequest(input) + return out, req.Send() +} + +// ListEndpointsWithContext is the same as ListEndpoints with the addition of +// the ability to pass a context and additional request options. +// +// See ListEndpoints for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *EventBridge) ListEndpointsWithContext(ctx aws.Context, input *ListEndpointsInput, opts ...request.Option) (*ListEndpointsOutput, error) { + req, out := c.ListEndpointsRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opListEventBuses = "ListEventBuses" // ListEventBusesRequest generates a "aws/request.Request" representing the @@ -3341,6 +3688,10 @@ func (c *EventBridge) PutEventsRequest(input *PutEventsInput) (req *request.Requ // Sends custom events to Amazon EventBridge so that they can be matched to // rules. // +// PutEvents will only process nested JSON up to 1100 levels deep. +// +// This AWS SDK does not support calling multi-region endpoints with SigV4a authentication. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -3779,55 +4130,59 @@ func (c *EventBridge) PutTargetsRequest(input *PutTargetsInput) (req *request.Re // // * API destination (https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-api-destinations.html) // -// * Amazon API Gateway REST API endpoints -// -// * API Gateway +// * API Gateway (https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-api-gateway-target.html) // // * Batch job queue // -// * CloudWatch Logs group +// * CloudWatch group // // * CodeBuild project // // * CodePipeline // -// * Amazon EC2 CreateSnapshot API call +// * EC2 CreateSnapshot API call // // * EC2 Image Builder // -// * Amazon EC2 RebootInstances API call +// * EC2 RebootInstances API call +// +// * EC2 StopInstances API call +// +// * EC2 TerminateInstances API call +// +// * ECS task // -// * Amazon EC2 StopInstances API call +// * Event bus in a different account or Region (https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cross-account.html) // -// * Amazon EC2 TerminateInstances API call +// * Event bus in the same account and Region (https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-bus-to-bus.html) // -// * Amazon ECS tasks +// * Firehose delivery stream // -// * Event bus in a different Amazon Web Services account or Region. You -// can use an event bus in the US East (N. Virginia) us-east-1, US West (Oregon) -// us-west-2, or Europe (Ireland) eu-west-1 Regions as a target for a rule. +// * Glue workflow // -// * Firehose delivery stream (Kinesis Data Firehose) +// * Incident Manager response plan (https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-creation.html#incident-tracking-auto-eventbridge) // -// * Inspector assessment template (Amazon Inspector) +// * Inspector assessment template // -// * Kinesis stream (Kinesis Data Stream) +// * Kinesis stream // // * Lambda function // -// * Redshift clusters (Data API statement execution) +// * Redshift cluster // -// * Amazon SNS topic +// * SageMaker Pipeline // -// * Amazon SQS queues (includes FIFO queues) +// * SNS topic // -// * SSM Automation +// * SQS queue // -// * SSM OpsItem +// * Step Functions state machine // -// * SSM Run Command +// * Systems Manager Automation // -// * Step Functions state machines +// * Systems Manager OpsItem +// +// * Systems Manager Run Command // // Creating rules with built-in targets is supported only in the Amazon Web // Services Management Console. The built-in targets are EC2 CreateSnapshot @@ -4815,6 +5170,94 @@ func (c *EventBridge) UpdateConnectionWithContext(ctx aws.Context, input *Update return out, req.Send() } +const opUpdateEndpoint = "UpdateEndpoint" + +// UpdateEndpointRequest generates a "aws/request.Request" representing the +// client's request for the UpdateEndpoint operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See UpdateEndpoint for more information on using the UpdateEndpoint +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the UpdateEndpointRequest method. +// req, resp := client.UpdateEndpointRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/eventbridge-2015-10-07/UpdateEndpoint +func (c *EventBridge) UpdateEndpointRequest(input *UpdateEndpointInput) (req *request.Request, output *UpdateEndpointOutput) { + op := &request.Operation{ + Name: opUpdateEndpoint, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &UpdateEndpointInput{} + } + + output = &UpdateEndpointOutput{} + req = c.newRequest(op, input, output) + return +} + +// UpdateEndpoint API operation for Amazon EventBridge. +// +// Update an existing endpoint. For more information about global endpoints, +// see Making applications Regional-fault tolerant with global endpoints and +// event replication (https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-global-endpoints.html) +// in the Amazon EventBridge User Guide.. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon EventBridge's +// API operation UpdateEndpoint for usage and error information. +// +// Returned Error Types: +// * ResourceNotFoundException +// An entity that you specified does not exist. +// +// * ConcurrentModificationException +// There is concurrent modification on a rule, target, archive, or replay. +// +// * InternalException +// This exception occurs due to unexpected causes. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/eventbridge-2015-10-07/UpdateEndpoint +func (c *EventBridge) UpdateEndpoint(input *UpdateEndpointInput) (*UpdateEndpointOutput, error) { + req, out := c.UpdateEndpointRequest(input) + return out, req.Send() +} + +// UpdateEndpointWithContext is the same as UpdateEndpoint with the addition of +// the ability to pass a context and additional request options. +// +// See UpdateEndpoint for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *EventBridge) UpdateEndpointWithContext(ctx aws.Context, input *UpdateEndpointInput, opts ...request.Option) (*UpdateEndpointOutput, error) { + req, out := c.UpdateEndpointRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + type ActivateEventSourceInput struct { _ struct{} `type:"structure"` @@ -7024,6 +7467,218 @@ func (s *CreateConnectionOutput) SetLastModifiedTime(v time.Time) *CreateConnect return s } +type CreateEndpointInput struct { + _ struct{} `type:"structure"` + + // A description of the global endpoint. + Description *string `type:"string"` + + // Define the event buses used. + // + // The names of the event buses must be identical in each Region. + // + // EventBuses is a required field + EventBuses []*EndpointEventBus `min:"2" type:"list" required:"true"` + + // The name of the global endpoint. For example, "Name":"us-east-2-custom_bus_A-endpoint". + // + // Name is a required field + Name *string `min:"1" type:"string" required:"true"` + + // Enable or disable event replication. + ReplicationConfig *ReplicationConfig `type:"structure"` + + // The ARN of the role used for replication. + RoleArn *string `min:"1" type:"string"` + + // Configure the routing policy, including the health check and secondary Region.. + // + // RoutingConfig is a required field + RoutingConfig *RoutingConfig `type:"structure" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s CreateEndpointInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s CreateEndpointInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *CreateEndpointInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "CreateEndpointInput"} + if s.EventBuses == nil { + invalidParams.Add(request.NewErrParamRequired("EventBuses")) + } + if s.EventBuses != nil && len(s.EventBuses) < 2 { + invalidParams.Add(request.NewErrParamMinLen("EventBuses", 2)) + } + if s.Name == nil { + invalidParams.Add(request.NewErrParamRequired("Name")) + } + if s.Name != nil && len(*s.Name) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Name", 1)) + } + if s.RoleArn != nil && len(*s.RoleArn) < 1 { + invalidParams.Add(request.NewErrParamMinLen("RoleArn", 1)) + } + if s.RoutingConfig == nil { + invalidParams.Add(request.NewErrParamRequired("RoutingConfig")) + } + if s.EventBuses != nil { + for i, v := range s.EventBuses { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "EventBuses", i), err.(request.ErrInvalidParams)) + } + } + } + if s.RoutingConfig != nil { + if err := s.RoutingConfig.Validate(); err != nil { + invalidParams.AddNested("RoutingConfig", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetDescription sets the Description field's value. +func (s *CreateEndpointInput) SetDescription(v string) *CreateEndpointInput { + s.Description = &v + return s +} + +// SetEventBuses sets the EventBuses field's value. +func (s *CreateEndpointInput) SetEventBuses(v []*EndpointEventBus) *CreateEndpointInput { + s.EventBuses = v + return s +} + +// SetName sets the Name field's value. +func (s *CreateEndpointInput) SetName(v string) *CreateEndpointInput { + s.Name = &v + return s +} + +// SetReplicationConfig sets the ReplicationConfig field's value. +func (s *CreateEndpointInput) SetReplicationConfig(v *ReplicationConfig) *CreateEndpointInput { + s.ReplicationConfig = v + return s +} + +// SetRoleArn sets the RoleArn field's value. +func (s *CreateEndpointInput) SetRoleArn(v string) *CreateEndpointInput { + s.RoleArn = &v + return s +} + +// SetRoutingConfig sets the RoutingConfig field's value. +func (s *CreateEndpointInput) SetRoutingConfig(v *RoutingConfig) *CreateEndpointInput { + s.RoutingConfig = v + return s +} + +type CreateEndpointOutput struct { + _ struct{} `type:"structure"` + + // The ARN of the endpoint that was created by this request. + Arn *string `min:"1" type:"string"` + + // The event buses used by this request. + EventBuses []*EndpointEventBus `min:"2" type:"list"` + + // The name of the endpoint that was created by this request. + Name *string `min:"1" type:"string"` + + // Whether event replication was enabled or disabled by this request. + ReplicationConfig *ReplicationConfig `type:"structure"` + + // The ARN of the role used by event replication for this request. + RoleArn *string `min:"1" type:"string"` + + // The routing configuration defined by this request. + RoutingConfig *RoutingConfig `type:"structure"` + + // The state of the endpoint that was created by this request. + State *string `type:"string" enum:"EndpointState"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s CreateEndpointOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s CreateEndpointOutput) GoString() string { + return s.String() +} + +// SetArn sets the Arn field's value. +func (s *CreateEndpointOutput) SetArn(v string) *CreateEndpointOutput { + s.Arn = &v + return s +} + +// SetEventBuses sets the EventBuses field's value. +func (s *CreateEndpointOutput) SetEventBuses(v []*EndpointEventBus) *CreateEndpointOutput { + s.EventBuses = v + return s +} + +// SetName sets the Name field's value. +func (s *CreateEndpointOutput) SetName(v string) *CreateEndpointOutput { + s.Name = &v + return s +} + +// SetReplicationConfig sets the ReplicationConfig field's value. +func (s *CreateEndpointOutput) SetReplicationConfig(v *ReplicationConfig) *CreateEndpointOutput { + s.ReplicationConfig = v + return s +} + +// SetRoleArn sets the RoleArn field's value. +func (s *CreateEndpointOutput) SetRoleArn(v string) *CreateEndpointOutput { + s.RoleArn = &v + return s +} + +// SetRoutingConfig sets the RoutingConfig field's value. +func (s *CreateEndpointOutput) SetRoutingConfig(v *RoutingConfig) *CreateEndpointOutput { + s.RoutingConfig = v + return s +} + +// SetState sets the State field's value. +func (s *CreateEndpointOutput) SetState(v string) *CreateEndpointOutput { + s.State = &v + return s +} + type CreateEventBusInput struct { _ struct{} `type:"structure"` @@ -7737,10 +8392,10 @@ func (s *DeleteConnectionOutput) SetLastModifiedTime(v time.Time) *DeleteConnect return s } -type DeleteEventBusInput struct { +type DeleteEndpointInput struct { _ struct{} `type:"structure"` - // The name of the event bus to delete. + // The name of the endpoint you want to delete. For example, "Name":"us-east-2-custom_bus_A-endpoint".. // // Name is a required field Name *string `min:"1" type:"string" required:"true"` @@ -7751,7 +8406,7 @@ type DeleteEventBusInput struct { // API parameter values that are decorated as "sensitive" in the API will not // be included in the string output. The member name will be present, but the // value will be replaced with "sensitive". -func (s DeleteEventBusInput) String() string { +func (s DeleteEndpointInput) String() string { return awsutil.Prettify(s) } @@ -7760,13 +8415,13 @@ func (s DeleteEventBusInput) String() string { // API parameter values that are decorated as "sensitive" in the API will not // be included in the string output. The member name will be present, but the // value will be replaced with "sensitive". -func (s DeleteEventBusInput) GoString() string { +func (s DeleteEndpointInput) GoString() string { return s.String() } // Validate inspects the fields of the type to determine if they are valid. -func (s *DeleteEventBusInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DeleteEventBusInput"} +func (s *DeleteEndpointInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DeleteEndpointInput"} if s.Name == nil { invalidParams.Add(request.NewErrParamRequired("Name")) } @@ -7781,12 +8436,12 @@ func (s *DeleteEventBusInput) Validate() error { } // SetName sets the Name field's value. -func (s *DeleteEventBusInput) SetName(v string) *DeleteEventBusInput { +func (s *DeleteEndpointInput) SetName(v string) *DeleteEndpointInput { s.Name = &v return s } -type DeleteEventBusOutput struct { +type DeleteEndpointOutput struct { _ struct{} `type:"structure"` } @@ -7795,7 +8450,7 @@ type DeleteEventBusOutput struct { // API parameter values that are decorated as "sensitive" in the API will not // be included in the string output. The member name will be present, but the // value will be replaced with "sensitive". -func (s DeleteEventBusOutput) String() string { +func (s DeleteEndpointOutput) String() string { return awsutil.Prettify(s) } @@ -7804,20 +8459,14 @@ func (s DeleteEventBusOutput) String() string { // API parameter values that are decorated as "sensitive" in the API will not // be included in the string output. The member name will be present, but the // value will be replaced with "sensitive". -func (s DeleteEventBusOutput) GoString() string { +func (s DeleteEndpointOutput) GoString() string { return s.String() } -type DeletePartnerEventSourceInput struct { +type DeleteEventBusInput struct { _ struct{} `type:"structure"` - // The Amazon Web Services account ID of the Amazon Web Services customer that - // the event source was created for. - // - // Account is a required field - Account *string `min:"12" type:"string" required:"true"` - - // The name of the event source to delete. + // The name of the event bus to delete. // // Name is a required field Name *string `min:"1" type:"string" required:"true"` @@ -7828,7 +8477,7 @@ type DeletePartnerEventSourceInput struct { // API parameter values that are decorated as "sensitive" in the API will not // be included in the string output. The member name will be present, but the // value will be replaced with "sensitive". -func (s DeletePartnerEventSourceInput) String() string { +func (s DeleteEventBusInput) String() string { return awsutil.Prettify(s) } @@ -7837,19 +8486,13 @@ func (s DeletePartnerEventSourceInput) String() string { // API parameter values that are decorated as "sensitive" in the API will not // be included in the string output. The member name will be present, but the // value will be replaced with "sensitive". -func (s DeletePartnerEventSourceInput) GoString() string { +func (s DeleteEventBusInput) GoString() string { return s.String() } // Validate inspects the fields of the type to determine if they are valid. -func (s *DeletePartnerEventSourceInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DeletePartnerEventSourceInput"} - if s.Account == nil { - invalidParams.Add(request.NewErrParamRequired("Account")) - } - if s.Account != nil && len(*s.Account) < 12 { - invalidParams.Add(request.NewErrParamMinLen("Account", 12)) - } +func (s *DeleteEventBusInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DeleteEventBusInput"} if s.Name == nil { invalidParams.Add(request.NewErrParamRequired("Name")) } @@ -7863,19 +8506,102 @@ func (s *DeletePartnerEventSourceInput) Validate() error { return nil } -// SetAccount sets the Account field's value. -func (s *DeletePartnerEventSourceInput) SetAccount(v string) *DeletePartnerEventSourceInput { - s.Account = &v - return s -} - // SetName sets the Name field's value. -func (s *DeletePartnerEventSourceInput) SetName(v string) *DeletePartnerEventSourceInput { +func (s *DeleteEventBusInput) SetName(v string) *DeleteEventBusInput { s.Name = &v return s } -type DeletePartnerEventSourceOutput struct { +type DeleteEventBusOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s DeleteEventBusOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s DeleteEventBusOutput) GoString() string { + return s.String() +} + +type DeletePartnerEventSourceInput struct { + _ struct{} `type:"structure"` + + // The Amazon Web Services account ID of the Amazon Web Services customer that + // the event source was created for. + // + // Account is a required field + Account *string `min:"12" type:"string" required:"true"` + + // The name of the event source to delete. + // + // Name is a required field + Name *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s DeletePartnerEventSourceInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s DeletePartnerEventSourceInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DeletePartnerEventSourceInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DeletePartnerEventSourceInput"} + if s.Account == nil { + invalidParams.Add(request.NewErrParamRequired("Account")) + } + if s.Account != nil && len(*s.Account) < 12 { + invalidParams.Add(request.NewErrParamMinLen("Account", 12)) + } + if s.Name == nil { + invalidParams.Add(request.NewErrParamRequired("Name")) + } + if s.Name != nil && len(*s.Name) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Name", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetAccount sets the Account field's value. +func (s *DeletePartnerEventSourceInput) SetAccount(v string) *DeletePartnerEventSourceInput { + s.Account = &v + return s +} + +// SetName sets the Name field's value. +func (s *DeletePartnerEventSourceInput) SetName(v string) *DeletePartnerEventSourceInput { + s.Name = &v + return s +} + +type DeletePartnerEventSourceOutput struct { _ struct{} `type:"structure"` } @@ -8502,6 +9228,210 @@ func (s *DescribeConnectionOutput) SetStateReason(v string) *DescribeConnectionO return s } +type DescribeEndpointInput struct { + _ struct{} `type:"structure"` + + // The primary Region of the endpoint you want to get information about. For + // example "HomeRegion": "us-east-1". + HomeRegion *string `min:"9" type:"string"` + + // The name of the endpoint you want to get information about. For example, + // "Name":"us-east-2-custom_bus_A-endpoint". + // + // Name is a required field + Name *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s DescribeEndpointInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s DescribeEndpointInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DescribeEndpointInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DescribeEndpointInput"} + if s.HomeRegion != nil && len(*s.HomeRegion) < 9 { + invalidParams.Add(request.NewErrParamMinLen("HomeRegion", 9)) + } + if s.Name == nil { + invalidParams.Add(request.NewErrParamRequired("Name")) + } + if s.Name != nil && len(*s.Name) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Name", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetHomeRegion sets the HomeRegion field's value. +func (s *DescribeEndpointInput) SetHomeRegion(v string) *DescribeEndpointInput { + s.HomeRegion = &v + return s +} + +// SetName sets the Name field's value. +func (s *DescribeEndpointInput) SetName(v string) *DescribeEndpointInput { + s.Name = &v + return s +} + +type DescribeEndpointOutput struct { + _ struct{} `type:"structure"` + + // The ARN of the endpoint you asked for information about. + Arn *string `min:"1" type:"string"` + + // The time the endpoint you asked for information about was created. + CreationTime *time.Time `type:"timestamp"` + + // The description of the endpoint you asked for information about. + Description *string `type:"string"` + + // The ID of the endpoint you asked for information about. + EndpointId *string `min:"1" type:"string"` + + // The URL of the endpoint you asked for information about. + EndpointUrl *string `min:"1" type:"string"` + + // The event buses being used by the endpoint you asked for information about. + EventBuses []*EndpointEventBus `min:"2" type:"list"` + + // The last time the endpoint you asked for information about was modified. + LastModifiedTime *time.Time `type:"timestamp"` + + // The name of the endpoint you asked for information about. + Name *string `min:"1" type:"string"` + + // Whether replication is enabled or disabled for the endpoint you asked for + // information about. + ReplicationConfig *ReplicationConfig `type:"structure"` + + // The ARN of the role used by the endpoint you asked for information about. + RoleArn *string `min:"1" type:"string"` + + // The routing configuration of the endpoint you asked for information about. + RoutingConfig *RoutingConfig `type:"structure"` + + // The current state of the endpoint you asked for information about. + State *string `type:"string" enum:"EndpointState"` + + // The reason the endpoint you asked for information about is in its current + // state. + StateReason *string `min:"1" type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s DescribeEndpointOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s DescribeEndpointOutput) GoString() string { + return s.String() +} + +// SetArn sets the Arn field's value. +func (s *DescribeEndpointOutput) SetArn(v string) *DescribeEndpointOutput { + s.Arn = &v + return s +} + +// SetCreationTime sets the CreationTime field's value. +func (s *DescribeEndpointOutput) SetCreationTime(v time.Time) *DescribeEndpointOutput { + s.CreationTime = &v + return s +} + +// SetDescription sets the Description field's value. +func (s *DescribeEndpointOutput) SetDescription(v string) *DescribeEndpointOutput { + s.Description = &v + return s +} + +// SetEndpointId sets the EndpointId field's value. +func (s *DescribeEndpointOutput) SetEndpointId(v string) *DescribeEndpointOutput { + s.EndpointId = &v + return s +} + +// SetEndpointUrl sets the EndpointUrl field's value. +func (s *DescribeEndpointOutput) SetEndpointUrl(v string) *DescribeEndpointOutput { + s.EndpointUrl = &v + return s +} + +// SetEventBuses sets the EventBuses field's value. +func (s *DescribeEndpointOutput) SetEventBuses(v []*EndpointEventBus) *DescribeEndpointOutput { + s.EventBuses = v + return s +} + +// SetLastModifiedTime sets the LastModifiedTime field's value. +func (s *DescribeEndpointOutput) SetLastModifiedTime(v time.Time) *DescribeEndpointOutput { + s.LastModifiedTime = &v + return s +} + +// SetName sets the Name field's value. +func (s *DescribeEndpointOutput) SetName(v string) *DescribeEndpointOutput { + s.Name = &v + return s +} + +// SetReplicationConfig sets the ReplicationConfig field's value. +func (s *DescribeEndpointOutput) SetReplicationConfig(v *ReplicationConfig) *DescribeEndpointOutput { + s.ReplicationConfig = v + return s +} + +// SetRoleArn sets the RoleArn field's value. +func (s *DescribeEndpointOutput) SetRoleArn(v string) *DescribeEndpointOutput { + s.RoleArn = &v + return s +} + +// SetRoutingConfig sets the RoutingConfig field's value. +func (s *DescribeEndpointOutput) SetRoutingConfig(v *RoutingConfig) *DescribeEndpointOutput { + s.RoutingConfig = v + return s +} + +// SetState sets the State field's value. +func (s *DescribeEndpointOutput) SetState(v string) *DescribeEndpointOutput { + s.State = &v + return s +} + +// SetStateReason sets the StateReason field's value. +func (s *DescribeEndpointOutput) SetStateReason(v string) *DescribeEndpointOutput { + s.StateReason = &v + return s +} + type DescribeEventBusInput struct { _ struct{} `type:"structure"` @@ -9484,23 +10414,249 @@ func (s *EcsParameters) SetTaskCount(v int64) *EcsParameters { return s } -// SetTaskDefinitionArn sets the TaskDefinitionArn field's value. -func (s *EcsParameters) SetTaskDefinitionArn(v string) *EcsParameters { - s.TaskDefinitionArn = &v +// SetTaskDefinitionArn sets the TaskDefinitionArn field's value. +func (s *EcsParameters) SetTaskDefinitionArn(v string) *EcsParameters { + s.TaskDefinitionArn = &v + return s +} + +type EnableRuleInput struct { + _ struct{} `type:"structure"` + + // The name or ARN of the event bus associated with the rule. If you omit this, + // the default event bus is used. + EventBusName *string `min:"1" type:"string"` + + // The name of the rule. + // + // Name is a required field + Name *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s EnableRuleInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s EnableRuleInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *EnableRuleInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "EnableRuleInput"} + if s.EventBusName != nil && len(*s.EventBusName) < 1 { + invalidParams.Add(request.NewErrParamMinLen("EventBusName", 1)) + } + if s.Name == nil { + invalidParams.Add(request.NewErrParamRequired("Name")) + } + if s.Name != nil && len(*s.Name) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Name", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetEventBusName sets the EventBusName field's value. +func (s *EnableRuleInput) SetEventBusName(v string) *EnableRuleInput { + s.EventBusName = &v + return s +} + +// SetName sets the Name field's value. +func (s *EnableRuleInput) SetName(v string) *EnableRuleInput { + s.Name = &v + return s +} + +type EnableRuleOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s EnableRuleOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s EnableRuleOutput) GoString() string { + return s.String() +} + +// An global endpoint used to improve your application's availability by making +// it regional-fault tolerant. For more information about global endpoints, +// see Making applications Regional-fault tolerant with global endpoints and +// event replication (https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-global-endpoints.html) +// in the Amazon EventBridge User Guide.. +type Endpoint struct { + _ struct{} `type:"structure"` + + // The ARN of the endpoint. + Arn *string `min:"1" type:"string"` + + // The time the endpoint was created. + CreationTime *time.Time `type:"timestamp"` + + // A description for the endpoint. + Description *string `type:"string"` + + // The URL subdomain of the endpoint. For example, if the URL for Endpoint is + // abcde.veo.endpoints.event.amazonaws.com, then the EndpointId is abcde.veo. + EndpointId *string `min:"1" type:"string"` + + // The URL of the endpoint. + EndpointUrl *string `min:"1" type:"string"` + + // The event buses being used by the endpoint. + EventBuses []*EndpointEventBus `min:"2" type:"list"` + + // The last time the endpoint was modified. + LastModifiedTime *time.Time `type:"timestamp"` + + // The name of the endpoint. + Name *string `min:"1" type:"string"` + + // Whether event replication was enabled or disabled for this endpoint. + ReplicationConfig *ReplicationConfig `type:"structure"` + + // The ARN of the role used by event replication for the endpoint. + RoleArn *string `min:"1" type:"string"` + + // The routing configuration of the endpoint. + RoutingConfig *RoutingConfig `type:"structure"` + + // The current state of the endpoint. + State *string `type:"string" enum:"EndpointState"` + + // The reason the endpoint is in its current state. + StateReason *string `min:"1" type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s Endpoint) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s Endpoint) GoString() string { + return s.String() +} + +// SetArn sets the Arn field's value. +func (s *Endpoint) SetArn(v string) *Endpoint { + s.Arn = &v + return s +} + +// SetCreationTime sets the CreationTime field's value. +func (s *Endpoint) SetCreationTime(v time.Time) *Endpoint { + s.CreationTime = &v + return s +} + +// SetDescription sets the Description field's value. +func (s *Endpoint) SetDescription(v string) *Endpoint { + s.Description = &v + return s +} + +// SetEndpointId sets the EndpointId field's value. +func (s *Endpoint) SetEndpointId(v string) *Endpoint { + s.EndpointId = &v + return s +} + +// SetEndpointUrl sets the EndpointUrl field's value. +func (s *Endpoint) SetEndpointUrl(v string) *Endpoint { + s.EndpointUrl = &v + return s +} + +// SetEventBuses sets the EventBuses field's value. +func (s *Endpoint) SetEventBuses(v []*EndpointEventBus) *Endpoint { + s.EventBuses = v + return s +} + +// SetLastModifiedTime sets the LastModifiedTime field's value. +func (s *Endpoint) SetLastModifiedTime(v time.Time) *Endpoint { + s.LastModifiedTime = &v + return s +} + +// SetName sets the Name field's value. +func (s *Endpoint) SetName(v string) *Endpoint { + s.Name = &v + return s +} + +// SetReplicationConfig sets the ReplicationConfig field's value. +func (s *Endpoint) SetReplicationConfig(v *ReplicationConfig) *Endpoint { + s.ReplicationConfig = v + return s +} + +// SetRoleArn sets the RoleArn field's value. +func (s *Endpoint) SetRoleArn(v string) *Endpoint { + s.RoleArn = &v + return s +} + +// SetRoutingConfig sets the RoutingConfig field's value. +func (s *Endpoint) SetRoutingConfig(v *RoutingConfig) *Endpoint { + s.RoutingConfig = v + return s +} + +// SetState sets the State field's value. +func (s *Endpoint) SetState(v string) *Endpoint { + s.State = &v + return s +} + +// SetStateReason sets the StateReason field's value. +func (s *Endpoint) SetStateReason(v string) *Endpoint { + s.StateReason = &v return s } -type EnableRuleInput struct { +// The event buses the endpoint is associated with. +type EndpointEventBus struct { _ struct{} `type:"structure"` - // The name or ARN of the event bus associated with the rule. If you omit this, - // the default event bus is used. - EventBusName *string `min:"1" type:"string"` - - // The name of the rule. + // The ARN of the event bus the endpoint is associated with. // - // Name is a required field - Name *string `min:"1" type:"string" required:"true"` + // EventBusArn is a required field + EventBusArn *string `min:"1" type:"string" required:"true"` } // String returns the string representation. @@ -9508,7 +10664,7 @@ type EnableRuleInput struct { // API parameter values that are decorated as "sensitive" in the API will not // be included in the string output. The member name will be present, but the // value will be replaced with "sensitive". -func (s EnableRuleInput) String() string { +func (s EndpointEventBus) String() string { return awsutil.Prettify(s) } @@ -9517,21 +10673,18 @@ func (s EnableRuleInput) String() string { // API parameter values that are decorated as "sensitive" in the API will not // be included in the string output. The member name will be present, but the // value will be replaced with "sensitive". -func (s EnableRuleInput) GoString() string { +func (s EndpointEventBus) GoString() string { return s.String() } // Validate inspects the fields of the type to determine if they are valid. -func (s *EnableRuleInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "EnableRuleInput"} - if s.EventBusName != nil && len(*s.EventBusName) < 1 { - invalidParams.Add(request.NewErrParamMinLen("EventBusName", 1)) - } - if s.Name == nil { - invalidParams.Add(request.NewErrParamRequired("Name")) +func (s *EndpointEventBus) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "EndpointEventBus"} + if s.EventBusArn == nil { + invalidParams.Add(request.NewErrParamRequired("EventBusArn")) } - if s.Name != nil && len(*s.Name) < 1 { - invalidParams.Add(request.NewErrParamMinLen("Name", 1)) + if s.EventBusArn != nil && len(*s.EventBusArn) < 1 { + invalidParams.Add(request.NewErrParamMinLen("EventBusArn", 1)) } if invalidParams.Len() > 0 { @@ -9540,40 +10693,12 @@ func (s *EnableRuleInput) Validate() error { return nil } -// SetEventBusName sets the EventBusName field's value. -func (s *EnableRuleInput) SetEventBusName(v string) *EnableRuleInput { - s.EventBusName = &v - return s -} - -// SetName sets the Name field's value. -func (s *EnableRuleInput) SetName(v string) *EnableRuleInput { - s.Name = &v +// SetEventBusArn sets the EventBusArn field's value. +func (s *EndpointEventBus) SetEventBusArn(v string) *EndpointEventBus { + s.EventBusArn = &v return s } -type EnableRuleOutput struct { - _ struct{} `type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s EnableRuleOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s EnableRuleOutput) GoString() string { - return s.String() -} - // An event bus receives events from a source and routes them to rules associated // with that event bus. Your account's default event bus receives events from // Amazon Web Services services. A custom event bus can receive events from @@ -9714,6 +10839,79 @@ func (s *EventSource) SetState(v string) *EventSource { return s } +// The failover configuration for an endpoint. This includes what triggers failover +// and what happens when it's triggered. +type FailoverConfig struct { + _ struct{} `type:"structure"` + + // The main Region of the endpoint. + // + // Primary is a required field + Primary *Primary `type:"structure" required:"true"` + + // The Region that events are routed to when failover is triggered or event + // replication is enabled. + // + // Secondary is a required field + Secondary *Secondary `type:"structure" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s FailoverConfig) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s FailoverConfig) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *FailoverConfig) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "FailoverConfig"} + if s.Primary == nil { + invalidParams.Add(request.NewErrParamRequired("Primary")) + } + if s.Secondary == nil { + invalidParams.Add(request.NewErrParamRequired("Secondary")) + } + if s.Primary != nil { + if err := s.Primary.Validate(); err != nil { + invalidParams.AddNested("Primary", err.(request.ErrInvalidParams)) + } + } + if s.Secondary != nil { + if err := s.Secondary.Validate(); err != nil { + invalidParams.AddNested("Secondary", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetPrimary sets the Primary field's value. +func (s *FailoverConfig) SetPrimary(v *Primary) *FailoverConfig { + s.Primary = v + return s +} + +// SetSecondary sets the Secondary field's value. +func (s *FailoverConfig) SetSecondary(v *Secondary) *FailoverConfig { + s.Secondary = v + return s +} + // These are custom parameter to be used when the target is an API Gateway REST // APIs or EventBridge ApiDestinations. In the latter case, these are merged // with any InvocationParameters specified on the Connection, with any values @@ -10629,6 +11827,137 @@ func (s *ListConnectionsOutput) SetNextToken(v string) *ListConnectionsOutput { return s } +type ListEndpointsInput struct { + _ struct{} `type:"structure"` + + // The primary Region of the endpoints associated with this account. For example + // "HomeRegion": "us-east-1". + HomeRegion *string `min:"9" type:"string"` + + // The maximum number of results returned by the call. + MaxResults *int64 `min:"1" type:"integer"` + + // A value that will return a subset of the endpoints associated with this account. + // For example, "NamePrefix": "ABC" will return all endpoints with "ABC" in + // the name. + NamePrefix *string `min:"1" type:"string"` + + // If nextToken is returned, there are more results available. The value of + // nextToken is a unique pagination token for each page. Make the call again + // using the returned token to retrieve the next page. Keep all other arguments + // unchanged. Each pagination token expires after 24 hours. Using an expired + // pagination token will return an HTTP 400 InvalidToken error. + NextToken *string `min:"1" type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListEndpointsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListEndpointsInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ListEndpointsInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ListEndpointsInput"} + if s.HomeRegion != nil && len(*s.HomeRegion) < 9 { + invalidParams.Add(request.NewErrParamMinLen("HomeRegion", 9)) + } + if s.MaxResults != nil && *s.MaxResults < 1 { + invalidParams.Add(request.NewErrParamMinValue("MaxResults", 1)) + } + if s.NamePrefix != nil && len(*s.NamePrefix) < 1 { + invalidParams.Add(request.NewErrParamMinLen("NamePrefix", 1)) + } + if s.NextToken != nil && len(*s.NextToken) < 1 { + invalidParams.Add(request.NewErrParamMinLen("NextToken", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetHomeRegion sets the HomeRegion field's value. +func (s *ListEndpointsInput) SetHomeRegion(v string) *ListEndpointsInput { + s.HomeRegion = &v + return s +} + +// SetMaxResults sets the MaxResults field's value. +func (s *ListEndpointsInput) SetMaxResults(v int64) *ListEndpointsInput { + s.MaxResults = &v + return s +} + +// SetNamePrefix sets the NamePrefix field's value. +func (s *ListEndpointsInput) SetNamePrefix(v string) *ListEndpointsInput { + s.NamePrefix = &v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *ListEndpointsInput) SetNextToken(v string) *ListEndpointsInput { + s.NextToken = &v + return s +} + +type ListEndpointsOutput struct { + _ struct{} `type:"structure"` + + // The endpoints returned by the call. + Endpoints []*Endpoint `type:"list"` + + // If nextToken is returned, there are more results available. The value of + // nextToken is a unique pagination token for each page. Make the call again + // using the returned token to retrieve the next page. Keep all other arguments + // unchanged. Each pagination token expires after 24 hours. Using an expired + // pagination token will return an HTTP 400 InvalidToken error. + NextToken *string `min:"1" type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListEndpointsOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListEndpointsOutput) GoString() string { + return s.String() +} + +// SetEndpoints sets the Endpoints field's value. +func (s *ListEndpointsOutput) SetEndpoints(v []*Endpoint) *ListEndpointsOutput { + s.Endpoints = v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *ListEndpointsOutput) SetNextToken(v string) *ListEndpointsOutput { + s.NextToken = &v + return s +} + type ListEventBusesInput struct { _ struct{} `type:"structure"` @@ -12131,9 +13460,68 @@ func (s *PolicyLengthExceededException) RequestID() string { return s.RespMetadata.RequestID } +// The primary Region of the endpoint. +type Primary struct { + _ struct{} `type:"structure"` + + // The ARN of the health check used by the endpoint to determine whether failover + // is triggered. + // + // HealthCheck is a required field + HealthCheck *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s Primary) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s Primary) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *Primary) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "Primary"} + if s.HealthCheck == nil { + invalidParams.Add(request.NewErrParamRequired("HealthCheck")) + } + if s.HealthCheck != nil && len(*s.HealthCheck) < 1 { + invalidParams.Add(request.NewErrParamMinLen("HealthCheck", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetHealthCheck sets the HealthCheck field's value. +func (s *Primary) SetHealthCheck(v string) *Primary { + s.HealthCheck = &v + return s +} + type PutEventsInput struct { _ struct{} `type:"structure"` + // The URL subdomain of the endpoint. For example, if the URL for Endpoint is + // abcde.veo.endpoints.event.amazonaws.com, then the EndpointId is abcde.veo. + // + // When using Java, you must include auth-crt on the class path. + // + // This AWS SDK does not support calling multi-region endpoints with SigV4a authentication. + EndpointId *string `min:"1" type:"string"` + // The entry that defines an event in your system. You can specify several parameters // for the entry such as the source and type of the event, resources associated // with the event, and so on. @@ -12163,6 +13551,9 @@ func (s PutEventsInput) GoString() string { // Validate inspects the fields of the type to determine if they are valid. func (s *PutEventsInput) Validate() error { invalidParams := request.ErrInvalidParams{Context: "PutEventsInput"} + if s.EndpointId != nil && len(*s.EndpointId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("EndpointId", 1)) + } if s.Entries == nil { invalidParams.Add(request.NewErrParamRequired("Entries")) } @@ -12186,6 +13577,12 @@ func (s *PutEventsInput) Validate() error { return nil } +// SetEndpointId sets the EndpointId field's value. +func (s *PutEventsInput) SetEndpointId(v string) *PutEventsInput { + s.EndpointId = &v + return s +} + // SetEntries sets the Entries field's value. func (s *PutEventsInput) SetEntries(v []*PutEventsRequestEntry) *PutEventsInput { s.Entries = v @@ -12238,7 +13635,7 @@ func (s *PutEventsOutput) SetFailedEntryCount(v int64) *PutEventsOutput { type PutEventsRequestEntry struct { _ struct{} `type:"structure"` - // A valid JSON string. There is no other schema imposed. The JSON string may + // A valid JSON object. There is no other schema imposed. The JSON object may // contain fields and nested subobjects. Detail *string `type:"string"` @@ -12248,6 +13645,11 @@ type PutEventsRequestEntry struct { // The name or ARN of the event bus to receive the event. Only the rules that // are associated with this event bus are used to match the event. If you omit // this, the default event bus is used. + // + // If you're using a global endpoint with a custom bus, you must enter the name, + // not the ARN, of the event bus in either the primary or secondary Region here + // and the corresponding event bus in the other Region will be determined based + // on the endpoint referenced by the EndpointId. EventBusName *string `min:"1" type:"string"` // Amazon Web Services resources, identified by Amazon Resource Name (ARN), @@ -12791,7 +14193,7 @@ type PutRuleInput struct { // this, the default event bus is used. EventBusName *string `min:"1" type:"string"` - // The event pattern. For more information, see Events and Event Patterns (https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html) + // The event pattern. For more information, see EventBridge event patterns (https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html.html) // in the Amazon EventBridge User Guide. EventPattern *string `type:"string"` @@ -13672,15 +15074,47 @@ func (s *ReplayDestination) Validate() error { return nil } -// SetArn sets the Arn field's value. -func (s *ReplayDestination) SetArn(v string) *ReplayDestination { - s.Arn = &v - return s +// SetArn sets the Arn field's value. +func (s *ReplayDestination) SetArn(v string) *ReplayDestination { + s.Arn = &v + return s +} + +// SetFilterArns sets the FilterArns field's value. +func (s *ReplayDestination) SetFilterArns(v []*string) *ReplayDestination { + s.FilterArns = v + return s +} + +// Endpoints can replicate all events to the secondary Region. +type ReplicationConfig struct { + _ struct{} `type:"structure"` + + // The state of event replication. + State *string `type:"string" enum:"ReplicationState"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ReplicationConfig) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ReplicationConfig) GoString() string { + return s.String() } -// SetFilterArns sets the FilterArns field's value. -func (s *ReplayDestination) SetFilterArns(v []*string) *ReplayDestination { - s.FilterArns = v +// SetState sets the State field's value. +func (s *ReplicationConfig) SetState(v string) *ReplicationConfig { + s.State = &v return s } @@ -13868,6 +15302,59 @@ func (s *RetryPolicy) SetMaximumRetryAttempts(v int64) *RetryPolicy { return s } +// The routing configuration of the endpoint. +type RoutingConfig struct { + _ struct{} `type:"structure"` + + // The failover configuration for an endpoint. This includes what triggers failover + // and what happens when it's triggered. + // + // FailoverConfig is a required field + FailoverConfig *FailoverConfig `type:"structure" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s RoutingConfig) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s RoutingConfig) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *RoutingConfig) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "RoutingConfig"} + if s.FailoverConfig == nil { + invalidParams.Add(request.NewErrParamRequired("FailoverConfig")) + } + if s.FailoverConfig != nil { + if err := s.FailoverConfig.Validate(); err != nil { + invalidParams.AddNested("FailoverConfig", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetFailoverConfig sets the FailoverConfig field's value. +func (s *RoutingConfig) SetFailoverConfig(v *FailoverConfig) *RoutingConfig { + s.FailoverConfig = v + return s +} + // Contains information about a rule in Amazon EventBridge. type Rule struct { _ struct{} `type:"structure"` @@ -14235,6 +15722,57 @@ func (s *SageMakerPipelineParameters) SetPipelineParameterList(v []*SageMakerPip return s } +// The secondary Region that processes events when failover is triggered or +// replication is enabled. +type Secondary struct { + _ struct{} `type:"structure"` + + // Defines the secondary Region. + // + // Route is a required field + Route *string `min:"9" type:"string" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s Secondary) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s Secondary) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *Secondary) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "Secondary"} + if s.Route == nil { + invalidParams.Add(request.NewErrParamRequired("Route")) + } + if s.Route != nil && len(*s.Route) < 9 { + invalidParams.Add(request.NewErrParamMinLen("Route", 9)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetRoute sets the Route field's value. +func (s *Secondary) SetRoute(v string) *Secondary { + s.Route = &v + return s +} + // This structure includes the custom parameter to be used when the target is // an SQS FIFO queue. type SqsParameters struct { @@ -15877,6 +17415,227 @@ func (s *UpdateConnectionOutput) SetLastModifiedTime(v time.Time) *UpdateConnect return s } +type UpdateEndpointInput struct { + _ struct{} `type:"structure"` + + // A description for the endpoint. + Description *string `type:"string"` + + // Define event buses used for replication. + EventBuses []*EndpointEventBus `min:"2" type:"list"` + + // The name of the endpoint you want to update. + // + // Name is a required field + Name *string `min:"1" type:"string" required:"true"` + + // Whether event replication was enabled or disabled by this request. + ReplicationConfig *ReplicationConfig `type:"structure"` + + // The ARN of the role used by event replication for this request. + RoleArn *string `min:"1" type:"string"` + + // Configure the routing policy, including the health check and secondary Region.. + RoutingConfig *RoutingConfig `type:"structure"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UpdateEndpointInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UpdateEndpointInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *UpdateEndpointInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "UpdateEndpointInput"} + if s.EventBuses != nil && len(s.EventBuses) < 2 { + invalidParams.Add(request.NewErrParamMinLen("EventBuses", 2)) + } + if s.Name == nil { + invalidParams.Add(request.NewErrParamRequired("Name")) + } + if s.Name != nil && len(*s.Name) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Name", 1)) + } + if s.RoleArn != nil && len(*s.RoleArn) < 1 { + invalidParams.Add(request.NewErrParamMinLen("RoleArn", 1)) + } + if s.EventBuses != nil { + for i, v := range s.EventBuses { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "EventBuses", i), err.(request.ErrInvalidParams)) + } + } + } + if s.RoutingConfig != nil { + if err := s.RoutingConfig.Validate(); err != nil { + invalidParams.AddNested("RoutingConfig", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetDescription sets the Description field's value. +func (s *UpdateEndpointInput) SetDescription(v string) *UpdateEndpointInput { + s.Description = &v + return s +} + +// SetEventBuses sets the EventBuses field's value. +func (s *UpdateEndpointInput) SetEventBuses(v []*EndpointEventBus) *UpdateEndpointInput { + s.EventBuses = v + return s +} + +// SetName sets the Name field's value. +func (s *UpdateEndpointInput) SetName(v string) *UpdateEndpointInput { + s.Name = &v + return s +} + +// SetReplicationConfig sets the ReplicationConfig field's value. +func (s *UpdateEndpointInput) SetReplicationConfig(v *ReplicationConfig) *UpdateEndpointInput { + s.ReplicationConfig = v + return s +} + +// SetRoleArn sets the RoleArn field's value. +func (s *UpdateEndpointInput) SetRoleArn(v string) *UpdateEndpointInput { + s.RoleArn = &v + return s +} + +// SetRoutingConfig sets the RoutingConfig field's value. +func (s *UpdateEndpointInput) SetRoutingConfig(v *RoutingConfig) *UpdateEndpointInput { + s.RoutingConfig = v + return s +} + +type UpdateEndpointOutput struct { + _ struct{} `type:"structure"` + + // The ARN of the endpoint you updated in this request. + Arn *string `min:"1" type:"string"` + + // The ID of the endpoint you updated in this request. + EndpointId *string `min:"1" type:"string"` + + // The URL of the endpoint you updated in this request. + EndpointUrl *string `min:"1" type:"string"` + + // The event buses used for replication for the endpoint you updated in this + // request. + EventBuses []*EndpointEventBus `min:"2" type:"list"` + + // The name of the endpoint you updated in this request. + Name *string `min:"1" type:"string"` + + // Whether event replication was enabled or disabled for the endpoint you updated + // in this request. + ReplicationConfig *ReplicationConfig `type:"structure"` + + // The ARN of the role used by event replication for the endpoint you updated + // in this request. + RoleArn *string `min:"1" type:"string"` + + // The routing configuration you updated in this request. + RoutingConfig *RoutingConfig `type:"structure"` + + // The state of the endpoint you updated in this request. + State *string `type:"string" enum:"EndpointState"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UpdateEndpointOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UpdateEndpointOutput) GoString() string { + return s.String() +} + +// SetArn sets the Arn field's value. +func (s *UpdateEndpointOutput) SetArn(v string) *UpdateEndpointOutput { + s.Arn = &v + return s +} + +// SetEndpointId sets the EndpointId field's value. +func (s *UpdateEndpointOutput) SetEndpointId(v string) *UpdateEndpointOutput { + s.EndpointId = &v + return s +} + +// SetEndpointUrl sets the EndpointUrl field's value. +func (s *UpdateEndpointOutput) SetEndpointUrl(v string) *UpdateEndpointOutput { + s.EndpointUrl = &v + return s +} + +// SetEventBuses sets the EventBuses field's value. +func (s *UpdateEndpointOutput) SetEventBuses(v []*EndpointEventBus) *UpdateEndpointOutput { + s.EventBuses = v + return s +} + +// SetName sets the Name field's value. +func (s *UpdateEndpointOutput) SetName(v string) *UpdateEndpointOutput { + s.Name = &v + return s +} + +// SetReplicationConfig sets the ReplicationConfig field's value. +func (s *UpdateEndpointOutput) SetReplicationConfig(v *ReplicationConfig) *UpdateEndpointOutput { + s.ReplicationConfig = v + return s +} + +// SetRoleArn sets the RoleArn field's value. +func (s *UpdateEndpointOutput) SetRoleArn(v string) *UpdateEndpointOutput { + s.RoleArn = &v + return s +} + +// SetRoutingConfig sets the RoutingConfig field's value. +func (s *UpdateEndpointOutput) SetRoutingConfig(v *RoutingConfig) *UpdateEndpointOutput { + s.RoutingConfig = v + return s +} + +// SetState sets the State field's value. +func (s *UpdateEndpointOutput) SetState(v string) *UpdateEndpointOutput { + s.State = &v + return s +} + const ( // ApiDestinationHttpMethodPost is a ApiDestinationHttpMethod enum value ApiDestinationHttpMethodPost = "POST" @@ -16053,6 +17812,42 @@ func ConnectionState_Values() []string { } } +const ( + // EndpointStateActive is a EndpointState enum value + EndpointStateActive = "ACTIVE" + + // EndpointStateCreating is a EndpointState enum value + EndpointStateCreating = "CREATING" + + // EndpointStateUpdating is a EndpointState enum value + EndpointStateUpdating = "UPDATING" + + // EndpointStateDeleting is a EndpointState enum value + EndpointStateDeleting = "DELETING" + + // EndpointStateCreateFailed is a EndpointState enum value + EndpointStateCreateFailed = "CREATE_FAILED" + + // EndpointStateUpdateFailed is a EndpointState enum value + EndpointStateUpdateFailed = "UPDATE_FAILED" + + // EndpointStateDeleteFailed is a EndpointState enum value + EndpointStateDeleteFailed = "DELETE_FAILED" +) + +// EndpointState_Values returns all elements of the EndpointState enum +func EndpointState_Values() []string { + return []string{ + EndpointStateActive, + EndpointStateCreating, + EndpointStateUpdating, + EndpointStateDeleting, + EndpointStateCreateFailed, + EndpointStateUpdateFailed, + EndpointStateDeleteFailed, + } +} + const ( // EventSourceStatePending is a EventSourceState enum value EventSourceStatePending = "PENDING" @@ -16173,6 +17968,22 @@ func ReplayState_Values() []string { } } +const ( + // ReplicationStateEnabled is a ReplicationState enum value + ReplicationStateEnabled = "ENABLED" + + // ReplicationStateDisabled is a ReplicationState enum value + ReplicationStateDisabled = "DISABLED" +) + +// ReplicationState_Values returns all elements of the ReplicationState enum +func ReplicationState_Values() []string { + return []string{ + ReplicationStateEnabled, + ReplicationStateDisabled, + } +} + const ( // RuleStateEnabled is a RuleState enum value RuleStateEnabled = "ENABLED" diff --git a/service/eventbridge/eventbridgeiface/interface.go b/service/eventbridge/eventbridgeiface/interface.go index 398644d6367..d6911a328ea 100644 --- a/service/eventbridge/eventbridgeiface/interface.go +++ b/service/eventbridge/eventbridgeiface/interface.go @@ -80,6 +80,10 @@ type EventBridgeAPI interface { CreateConnectionWithContext(aws.Context, *eventbridge.CreateConnectionInput, ...request.Option) (*eventbridge.CreateConnectionOutput, error) CreateConnectionRequest(*eventbridge.CreateConnectionInput) (*request.Request, *eventbridge.CreateConnectionOutput) + CreateEndpoint(*eventbridge.CreateEndpointInput) (*eventbridge.CreateEndpointOutput, error) + CreateEndpointWithContext(aws.Context, *eventbridge.CreateEndpointInput, ...request.Option) (*eventbridge.CreateEndpointOutput, error) + CreateEndpointRequest(*eventbridge.CreateEndpointInput) (*request.Request, *eventbridge.CreateEndpointOutput) + CreateEventBus(*eventbridge.CreateEventBusInput) (*eventbridge.CreateEventBusOutput, error) CreateEventBusWithContext(aws.Context, *eventbridge.CreateEventBusInput, ...request.Option) (*eventbridge.CreateEventBusOutput, error) CreateEventBusRequest(*eventbridge.CreateEventBusInput) (*request.Request, *eventbridge.CreateEventBusOutput) @@ -108,6 +112,10 @@ type EventBridgeAPI interface { DeleteConnectionWithContext(aws.Context, *eventbridge.DeleteConnectionInput, ...request.Option) (*eventbridge.DeleteConnectionOutput, error) DeleteConnectionRequest(*eventbridge.DeleteConnectionInput) (*request.Request, *eventbridge.DeleteConnectionOutput) + DeleteEndpoint(*eventbridge.DeleteEndpointInput) (*eventbridge.DeleteEndpointOutput, error) + DeleteEndpointWithContext(aws.Context, *eventbridge.DeleteEndpointInput, ...request.Option) (*eventbridge.DeleteEndpointOutput, error) + DeleteEndpointRequest(*eventbridge.DeleteEndpointInput) (*request.Request, *eventbridge.DeleteEndpointOutput) + DeleteEventBus(*eventbridge.DeleteEventBusInput) (*eventbridge.DeleteEventBusOutput, error) DeleteEventBusWithContext(aws.Context, *eventbridge.DeleteEventBusInput, ...request.Option) (*eventbridge.DeleteEventBusOutput, error) DeleteEventBusRequest(*eventbridge.DeleteEventBusInput) (*request.Request, *eventbridge.DeleteEventBusOutput) @@ -132,6 +140,10 @@ type EventBridgeAPI interface { DescribeConnectionWithContext(aws.Context, *eventbridge.DescribeConnectionInput, ...request.Option) (*eventbridge.DescribeConnectionOutput, error) DescribeConnectionRequest(*eventbridge.DescribeConnectionInput) (*request.Request, *eventbridge.DescribeConnectionOutput) + DescribeEndpoint(*eventbridge.DescribeEndpointInput) (*eventbridge.DescribeEndpointOutput, error) + DescribeEndpointWithContext(aws.Context, *eventbridge.DescribeEndpointInput, ...request.Option) (*eventbridge.DescribeEndpointOutput, error) + DescribeEndpointRequest(*eventbridge.DescribeEndpointInput) (*request.Request, *eventbridge.DescribeEndpointOutput) + DescribeEventBus(*eventbridge.DescribeEventBusInput) (*eventbridge.DescribeEventBusOutput, error) DescribeEventBusWithContext(aws.Context, *eventbridge.DescribeEventBusInput, ...request.Option) (*eventbridge.DescribeEventBusOutput, error) DescribeEventBusRequest(*eventbridge.DescribeEventBusInput) (*request.Request, *eventbridge.DescribeEventBusOutput) @@ -172,6 +184,10 @@ type EventBridgeAPI interface { ListConnectionsWithContext(aws.Context, *eventbridge.ListConnectionsInput, ...request.Option) (*eventbridge.ListConnectionsOutput, error) ListConnectionsRequest(*eventbridge.ListConnectionsInput) (*request.Request, *eventbridge.ListConnectionsOutput) + ListEndpoints(*eventbridge.ListEndpointsInput) (*eventbridge.ListEndpointsOutput, error) + ListEndpointsWithContext(aws.Context, *eventbridge.ListEndpointsInput, ...request.Option) (*eventbridge.ListEndpointsOutput, error) + ListEndpointsRequest(*eventbridge.ListEndpointsInput) (*request.Request, *eventbridge.ListEndpointsOutput) + ListEventBuses(*eventbridge.ListEventBusesInput) (*eventbridge.ListEventBusesOutput, error) ListEventBusesWithContext(aws.Context, *eventbridge.ListEventBusesInput, ...request.Option) (*eventbridge.ListEventBusesOutput, error) ListEventBusesRequest(*eventbridge.ListEventBusesInput) (*request.Request, *eventbridge.ListEventBusesOutput) @@ -263,6 +279,10 @@ type EventBridgeAPI interface { UpdateConnection(*eventbridge.UpdateConnectionInput) (*eventbridge.UpdateConnectionOutput, error) UpdateConnectionWithContext(aws.Context, *eventbridge.UpdateConnectionInput, ...request.Option) (*eventbridge.UpdateConnectionOutput, error) UpdateConnectionRequest(*eventbridge.UpdateConnectionInput) (*request.Request, *eventbridge.UpdateConnectionOutput) + + UpdateEndpoint(*eventbridge.UpdateEndpointInput) (*eventbridge.UpdateEndpointOutput, error) + UpdateEndpointWithContext(aws.Context, *eventbridge.UpdateEndpointInput, ...request.Option) (*eventbridge.UpdateEndpointOutput, error) + UpdateEndpointRequest(*eventbridge.UpdateEndpointInput) (*request.Request, *eventbridge.UpdateEndpointOutput) } var _ EventBridgeAPI = (*eventbridge.EventBridge)(nil) diff --git a/service/personalize/api.go b/service/personalize/api.go index 3826b27f57d..465b5e46211 100644 --- a/service/personalize/api.go +++ b/service/personalize/api.go @@ -59,7 +59,7 @@ func (c *Personalize) CreateBatchInferenceJobRequest(input *CreateBatchInference // // Creates a batch inference job. The operation can handle up to 50 million // records and the input file must be in JSON format. For more information, -// see recommendations-batch. +// see Creating a batch inference job (https://docs.aws.amazon.com/personalize/latest/dg/creating-batch-inference-job.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -84,6 +84,9 @@ func (c *Personalize) CreateBatchInferenceJobRequest(input *CreateBatchInference // * ResourceInUseException // The specified resource is in use. // +// * TooManyTagsException +// You have exceeded the maximum number of tags you can apply to this resource. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateBatchInferenceJob func (c *Personalize) CreateBatchInferenceJob(input *CreateBatchInferenceJobInput) (*CreateBatchInferenceJobOutput, error) { req, out := c.CreateBatchInferenceJobRequest(input) @@ -151,7 +154,8 @@ func (c *Personalize) CreateBatchSegmentJobRequest(input *CreateBatchSegmentJobI // CreateBatchSegmentJob API operation for Amazon Personalize. // // Creates a batch segment job. The operation can handle up to 50 million records -// and the input file must be in JSON format. For more information, see recommendations-batch. +// and the input file must be in JSON format. For more information, see Getting +// batch recommendations and user segments (https://docs.aws.amazon.com/personalize/latest/dg/recommendations-batch.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -176,6 +180,9 @@ func (c *Personalize) CreateBatchSegmentJobRequest(input *CreateBatchSegmentJobI // * ResourceInUseException // The specified resource is in use. // +// * TooManyTagsException +// You have exceeded the maximum number of tags you can apply to this resource. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateBatchSegmentJob func (c *Personalize) CreateBatchSegmentJob(input *CreateBatchSegmentJobInput) (*CreateBatchSegmentJobOutput, error) { req, out := c.CreateBatchSegmentJobRequest(input) @@ -274,20 +281,20 @@ func (c *Personalize) CreateCampaignRequest(input *CreateCampaignInput) (req *re // // * DELETE PENDING > DELETE IN_PROGRESS // -// To get the campaign status, call DescribeCampaign. +// To get the campaign status, call DescribeCampaign (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html). // // Wait until the status of the campaign is ACTIVE before asking the campaign // for recommendations. // // Related APIs // -// * ListCampaigns +// * ListCampaigns (https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html) // -// * DescribeCampaign +// * DescribeCampaign (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) // -// * UpdateCampaign +// * UpdateCampaign (https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateCampaign.html) // -// * DeleteCampaign +// * DeleteCampaign (https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteCampaign.html) // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -312,6 +319,9 @@ func (c *Personalize) CreateCampaignRequest(input *CreateCampaignInput) (req *re // * ResourceInUseException // The specified resource is in use. // +// * TooManyTagsException +// You have exceeded the maximum number of tags you can apply to this resource. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateCampaign func (c *Personalize) CreateCampaign(input *CreateCampaignInput) (*CreateCampaignOutput, error) { req, out := c.CreateCampaignRequest(input) @@ -379,7 +389,8 @@ func (c *Personalize) CreateDatasetRequest(input *CreateDatasetInput) (req *requ // CreateDataset API operation for Amazon Personalize. // // Creates an empty dataset and adds it to the specified dataset group. Use -// CreateDatasetImportJob to import your training data to a dataset. +// CreateDatasetImportJob (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html) +// to import your training data to a dataset. // // There are three types of datasets: // @@ -399,17 +410,17 @@ func (c *Personalize) CreateDatasetRequest(input *CreateDatasetInput) (req *requ // // * DELETE PENDING > DELETE IN_PROGRESS // -// To get the status of the dataset, call DescribeDataset. +// To get the status of the dataset, call DescribeDataset (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html). // // Related APIs // -// * CreateDatasetGroup +// * CreateDatasetGroup (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html) // -// * ListDatasets +// * ListDatasets (https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasets.html) // -// * DescribeDataset +// * DescribeDataset (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html) // -// * DeleteDataset +// * DeleteDataset (https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteDataset.html) // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -434,6 +445,9 @@ func (c *Personalize) CreateDatasetRequest(input *CreateDatasetInput) (req *requ // * ResourceInUseException // The specified resource is in use. // +// * TooManyTagsException +// You have exceeded the maximum number of tags you can apply to this resource. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateDataset func (c *Personalize) CreateDataset(input *CreateDatasetInput) (*CreateDatasetOutput, error) { req, out := c.CreateDatasetRequest(input) @@ -512,11 +526,11 @@ func (c *Personalize) CreateDatasetExportJobRequest(input *CreateDatasetExportJo // // * CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED // -// To get the status of the export job, call DescribeDatasetExportJob, and specify -// the Amazon Resource Name (ARN) of the dataset export job. The dataset export -// is complete when the status shows as ACTIVE. If the status shows as CREATE -// FAILED, the response includes a failureReason key, which describes why the -// job failed. +// To get the status of the export job, call DescribeDatasetExportJob (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html), +// and specify the Amazon Resource Name (ARN) of the dataset export job. The +// dataset export is complete when the status shows as ACTIVE. If the status +// shows as CREATE FAILED, the response includes a failureReason key, which +// describes why the job failed. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -541,6 +555,9 @@ func (c *Personalize) CreateDatasetExportJobRequest(input *CreateDatasetExportJo // * ResourceInUseException // The specified resource is in use. // +// * TooManyTagsException +// You have exceeded the maximum number of tags you can apply to this resource. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateDatasetExportJob func (c *Personalize) CreateDatasetExportJob(input *CreateDatasetExportJobInput) (*CreateDatasetExportJobOutput, error) { req, out := c.CreateDatasetExportJobRequest(input) @@ -630,9 +647,9 @@ func (c *Personalize) CreateDatasetGroupRequest(input *CreateDatasetGroupInput) // // * DELETE PENDING // -// To get the status of the dataset group, call DescribeDatasetGroup. If the -// status shows as CREATE FAILED, the response includes a failureReason key, -// which describes why the creation failed. +// To get the status of the dataset group, call DescribeDatasetGroup (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html). +// If the status shows as CREATE FAILED, the response includes a failureReason +// key, which describes why the creation failed. // // You must wait until the status of the dataset group is ACTIVE before adding // a dataset to the group. @@ -643,19 +660,19 @@ func (c *Personalize) CreateDatasetGroupRequest(input *CreateDatasetGroupInput) // // APIs that require a dataset group ARN in the request // -// * CreateDataset +// * CreateDataset (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html) // -// * CreateEventTracker +// * CreateEventTracker (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html) // -// * CreateSolution +// * CreateSolution (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) // // Related APIs // -// * ListDatasetGroups +// * ListDatasetGroups (https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasetGroups.html) // -// * DescribeDatasetGroup +// * DescribeDatasetGroup (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html) // -// * DeleteDatasetGroup +// * DeleteDatasetGroup (https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteDatasetGroup.html) // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -674,6 +691,9 @@ func (c *Personalize) CreateDatasetGroupRequest(input *CreateDatasetGroupInput) // * LimitExceededException // The limit on the number of requests per second has been exceeded. // +// * TooManyTagsException +// You have exceeded the maximum number of tags you can apply to this resource. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateDatasetGroup func (c *Personalize) CreateDatasetGroup(input *CreateDatasetGroupInput) (*CreateDatasetGroupOutput, error) { req, out := c.CreateDatasetGroupRequest(input) @@ -757,20 +777,20 @@ func (c *Personalize) CreateDatasetImportJobRequest(input *CreateDatasetImportJo // // * CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED // -// To get the status of the import job, call DescribeDatasetImportJob, providing -// the Amazon Resource Name (ARN) of the dataset import job. The dataset import -// is complete when the status shows as ACTIVE. If the status shows as CREATE -// FAILED, the response includes a failureReason key, which describes why the -// job failed. +// To get the status of the import job, call DescribeDatasetImportJob (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html), +// providing the Amazon Resource Name (ARN) of the dataset import job. The dataset +// import is complete when the status shows as ACTIVE. If the status shows as +// CREATE FAILED, the response includes a failureReason key, which describes +// why the job failed. // // Importing takes time. You must wait until the status shows as ACTIVE before // training a model using the dataset. // // Related APIs // -// * ListDatasetImportJobs +// * ListDatasetImportJobs (https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasetImportJobs.html) // -// * DescribeDatasetImportJob +// * DescribeDatasetImportJob (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html) // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -795,6 +815,9 @@ func (c *Personalize) CreateDatasetImportJobRequest(input *CreateDatasetImportJo // * ResourceInUseException // The specified resource is in use. // +// * TooManyTagsException +// You have exceeded the maximum number of tags you can apply to this resource. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateDatasetImportJob func (c *Personalize) CreateDatasetImportJob(input *CreateDatasetImportJobInput) (*CreateDatasetImportJobOutput, error) { req, out := c.CreateDatasetImportJobRequest(input) @@ -880,17 +903,17 @@ func (c *Personalize) CreateEventTrackerRequest(input *CreateEventTrackerInput) // // * DELETE PENDING > DELETE IN_PROGRESS // -// To get the status of the event tracker, call DescribeEventTracker. +// To get the status of the event tracker, call DescribeEventTracker (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html). // // The event tracker must be in the ACTIVE state before using the tracking ID. // // Related APIs // -// * ListEventTrackers +// * ListEventTrackers (https://docs.aws.amazon.com/personalize/latest/dg/API_ListEventTrackers.html) // -// * DescribeEventTracker +// * DescribeEventTracker (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html) // -// * DeleteEventTracker +// * DeleteEventTracker (https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteEventTracker.html) // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -915,6 +938,9 @@ func (c *Personalize) CreateEventTrackerRequest(input *CreateEventTrackerInput) // * ResourceInUseException // The specified resource is in use. // +// * TooManyTagsException +// You have exceeded the maximum number of tags you can apply to this resource. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateEventTracker func (c *Personalize) CreateEventTracker(input *CreateEventTrackerInput) (*CreateEventTrackerOutput, error) { req, out := c.CreateEventTrackerRequest(input) @@ -981,7 +1007,8 @@ func (c *Personalize) CreateFilterRequest(input *CreateFilterInput) (req *reques // CreateFilter API operation for Amazon Personalize. // -// Creates a recommendation filter. For more information, see filter. +// Creates a recommendation filter. For more information, see Filtering recommendations +// and user segments (https://docs.aws.amazon.com/personalize/latest/dg/filter.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -1003,6 +1030,9 @@ func (c *Personalize) CreateFilterRequest(input *CreateFilterInput) (req *reques // * LimitExceededException // The limit on the number of requests per second has been exceeded. // +// * TooManyTagsException +// You have exceeded the maximum number of tags you can apply to this resource. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateFilter func (c *Personalize) CreateFilter(input *CreateFilterInput) (*CreateFilterOutput, error) { req, out := c.CreateFilterRequest(input) @@ -1106,20 +1136,20 @@ func (c *Personalize) CreateRecommenderRequest(input *CreateRecommenderInput) (r // // * DELETE PENDING > DELETE IN_PROGRESS // -// To get the recommender status, call DescribeRecommender. +// To get the recommender status, call DescribeRecommender (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html). // // Wait until the status of the recommender is ACTIVE before asking the recommender // for recommendations. // // Related APIs // -// * ListRecommenders +// * ListRecommenders (https://docs.aws.amazon.com/personalize/latest/dg/API_ListRecommenders.html) // -// * DescribeRecommender +// * DescribeRecommender (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) // -// * UpdateRecommender +// * UpdateRecommender (https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateRecommender.html) // -// * DeleteRecommender +// * DeleteRecommender (https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteRecommender.html) // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -1141,6 +1171,9 @@ func (c *Personalize) CreateRecommenderRequest(input *CreateRecommenderInput) (r // * LimitExceededException // The limit on the number of requests per second has been exceeded. // +// * TooManyTagsException +// You have exceeded the maximum number of tags you can apply to this resource. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateRecommender func (c *Personalize) CreateRecommender(input *CreateRecommenderInput) (*CreateRecommenderOutput, error) { req, out := c.CreateRecommenderRequest(input) @@ -1214,15 +1247,15 @@ func (c *Personalize) CreateSchemaRequest(input *CreateSchemaInput) (req *reques // with a dataset type and has a set of required field and keywords. If you // are creating a schema for a dataset in a Domain dataset group, you provide // the domain of the Domain dataset group. You specify a schema when you call -// CreateDataset. +// CreateDataset (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html). // // Related APIs // -// * ListSchemas +// * ListSchemas (https://docs.aws.amazon.com/personalize/latest/dg/API_ListSchemas.html) // -// * DescribeSchema +// * DescribeSchema (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSchema.html) // -// * DeleteSchema +// * DeleteSchema (https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSchema.html) // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -1309,11 +1342,14 @@ func (c *Personalize) CreateSolutionRequest(input *CreateSolutionInput) (req *re // // Creates the configuration for training a model. A trained model is known // as a solution. After the configuration is created, you train the model (create -// a solution) by calling the CreateSolutionVersion operation. Every time you -// call CreateSolutionVersion, a new version of the solution is created. -// -// After creating a solution version, you check its accuracy by calling GetSolutionMetrics. -// When you are satisfied with the version, you deploy it using CreateCampaign. +// a solution) by calling the CreateSolutionVersion (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html) +// operation. Every time you call CreateSolutionVersion, a new version of the +// solution is created. +// +// After creating a solution version, you check its accuracy by calling GetSolutionMetrics +// (https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html). +// When you are satisfied with the version, you deploy it using CreateCampaign +// (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html). // The campaign provides recommendations to a client through the GetRecommendations // (https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) // API. @@ -1337,22 +1373,22 @@ func (c *Personalize) CreateSolutionRequest(input *CreateSolutionInput) (req *re // // * DELETE PENDING > DELETE IN_PROGRESS // -// To get the status of the solution, call DescribeSolution. Wait until the -// status shows as ACTIVE before calling CreateSolutionVersion. +// To get the status of the solution, call DescribeSolution (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html). +// Wait until the status shows as ACTIVE before calling CreateSolutionVersion. // // Related APIs // -// * ListSolutions +// * ListSolutions (https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html) // -// * CreateSolutionVersion +// * CreateSolutionVersion (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html) // -// * DescribeSolution +// * DescribeSolution (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) // -// * DeleteSolution +// * DeleteSolution (https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html) // -// * ListSolutionVersions +// * ListSolutionVersions (https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) // -// * DescribeSolutionVersion +// * DescribeSolutionVersion (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -1377,6 +1413,9 @@ func (c *Personalize) CreateSolutionRequest(input *CreateSolutionInput) (req *re // * ResourceInUseException // The specified resource is in use. // +// * TooManyTagsException +// You have exceeded the maximum number of tags you can apply to this resource. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateSolution func (c *Personalize) CreateSolution(input *CreateSolutionInput) (*CreateSolutionOutput, error) { req, out := c.CreateSolutionRequest(input) @@ -1444,9 +1483,9 @@ func (c *Personalize) CreateSolutionVersionRequest(input *CreateSolutionVersionI // CreateSolutionVersion API operation for Amazon Personalize. // // Trains or retrains an active solution in a Custom dataset group. A solution -// is created using the CreateSolution operation and must be in the ACTIVE state -// before calling CreateSolutionVersion. A new version of the solution is created -// every time you call this operation. +// is created using the CreateSolution (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) +// operation and must be in the ACTIVE state before calling CreateSolutionVersion. +// A new version of the solution is created every time you call this operation. // // Status // @@ -1464,25 +1503,25 @@ func (c *Personalize) CreateSolutionVersionRequest(input *CreateSolutionVersionI // // * CREATE STOPPED // -// To get the status of the version, call DescribeSolutionVersion. Wait until -// the status shows as ACTIVE before calling CreateCampaign. +// To get the status of the version, call DescribeSolutionVersion (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html). +// Wait until the status shows as ACTIVE before calling CreateCampaign. // // If the status shows as CREATE FAILED, the response includes a failureReason // key, which describes why the job failed. // // Related APIs // -// * ListSolutionVersions +// * ListSolutionVersions (https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) // -// * DescribeSolutionVersion +// * DescribeSolutionVersion (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) // -// * ListSolutions +// * ListSolutions (https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html) // -// * CreateSolution +// * CreateSolution (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) // -// * DescribeSolution +// * DescribeSolution (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) // -// * DeleteSolution +// * DeleteSolution (https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html) // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -1504,6 +1543,9 @@ func (c *Personalize) CreateSolutionVersionRequest(input *CreateSolutionVersionI // * ResourceInUseException // The specified resource is in use. // +// * TooManyTagsException +// You have exceeded the maximum number of tags you can apply to this resource. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateSolutionVersion func (c *Personalize) CreateSolutionVersion(input *CreateSolutionVersionInput) (*CreateSolutionVersionOutput, error) { req, out := c.CreateSolutionVersionRequest(input) @@ -1574,7 +1616,7 @@ func (c *Personalize) DeleteCampaignRequest(input *DeleteCampaignInput) (req *re // Removes a campaign by deleting the solution deployment. The solution that // the campaign is based on is not deleted and can be redeployed when needed. // A deleted campaign can no longer be specified in a GetRecommendations (https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) -// request. For more information on campaigns, see CreateCampaign. +// request. For information on creating campaigns, see CreateCampaign (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -1662,7 +1704,7 @@ func (c *Personalize) DeleteDatasetRequest(input *DeleteDatasetInput) (req *requ // // Deletes a dataset. You can't delete a dataset if an associated DatasetImportJob // or SolutionVersion is in the CREATE PENDING or IN PROGRESS state. For more -// information on datasets, see CreateDataset. +// information on datasets, see CreateDataset (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -1843,7 +1885,7 @@ func (c *Personalize) DeleteEventTrackerRequest(input *DeleteEventTrackerInput) // // Deletes the event tracker. Does not delete the event-interactions dataset // from the associated dataset group. For more information on event trackers, -// see CreateEventTracker. +// see CreateEventTracker (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -2104,7 +2146,8 @@ func (c *Personalize) DeleteSchemaRequest(input *DeleteSchemaInput) (req *reques // DeleteSchema API operation for Amazon Personalize. // // Deletes a schema. Before deleting a schema, you must delete all datasets -// referencing the schema. For more information on schemas, see CreateSchema. +// referencing the schema. For more information on schemas, see CreateSchema +// (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -2192,10 +2235,10 @@ func (c *Personalize) DeleteSolutionRequest(input *DeleteSolutionInput) (req *re // // Deletes all versions of a solution and the Solution object itself. Before // deleting a solution, you must delete all campaigns based on the solution. -// To determine what campaigns are using the solution, call ListCampaigns and -// supply the Amazon Resource Name (ARN) of the solution. You can't delete a -// solution if an associated SolutionVersion is in the CREATE PENDING or IN -// PROGRESS state. For more information on solutions, see CreateSolution. +// To determine what campaigns are using the solution, call ListCampaigns (https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html) +// and supply the Amazon Resource Name (ARN) of the solution. You can't delete +// a solution if an associated SolutionVersion is in the CREATE PENDING or IN +// PROGRESS state. For more information on solutions, see CreateSolution (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -2541,7 +2584,7 @@ func (c *Personalize) DescribeCampaignRequest(input *DescribeCampaignInput) (req // When the status is CREATE FAILED, the response includes the failureReason // key, which describes why. // -// For more information on campaigns, see CreateCampaign. +// For more information on campaigns, see CreateCampaign (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -2623,7 +2666,8 @@ func (c *Personalize) DescribeDatasetRequest(input *DescribeDatasetInput) (req * // DescribeDataset API operation for Amazon Personalize. // -// Describes the given dataset. For more information on datasets, see CreateDataset. +// Describes the given dataset. For more information on datasets, see CreateDataset +// (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -2705,8 +2749,8 @@ func (c *Personalize) DescribeDatasetExportJobRequest(input *DescribeDatasetExpo // DescribeDatasetExportJob API operation for Amazon Personalize. // -// Describes the dataset export job created by CreateDatasetExportJob, including -// the export job status. +// Describes the dataset export job created by CreateDatasetExportJob (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html), +// including the export job status. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -2789,7 +2833,7 @@ func (c *Personalize) DescribeDatasetGroupRequest(input *DescribeDatasetGroupInp // DescribeDatasetGroup API operation for Amazon Personalize. // // Describes the given dataset group. For more information on dataset groups, -// see CreateDatasetGroup. +// see CreateDatasetGroup (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -2871,8 +2915,8 @@ func (c *Personalize) DescribeDatasetImportJobRequest(input *DescribeDatasetImpo // DescribeDatasetImportJob API operation for Amazon Personalize. // -// Describes the dataset import job created by CreateDatasetImportJob, including -// the import job status. +// Describes the dataset import job created by CreateDatasetImportJob (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html), +// including the import job status. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -2955,7 +2999,8 @@ func (c *Personalize) DescribeEventTrackerRequest(input *DescribeEventTrackerInp // DescribeEventTracker API operation for Amazon Personalize. // // Describes an event tracker. The response includes the trackingId and status -// of the event tracker. For more information on event trackers, see CreateEventTracker. +// of the event tracker. For more information on event trackers, see CreateEventTracker +// (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -3213,10 +3258,10 @@ func (c *Personalize) DescribeRecipeRequest(input *DescribeRecipeInput) (req *re // training. // // Amazon Personalize provides a set of predefined recipes. You specify a recipe -// when you create a solution with the CreateSolution API. CreateSolution trains -// a model by using the algorithm in the specified recipe and a training dataset. -// The solution, when deployed as a campaign, can provide recommendations using -// the GetRecommendations (https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) +// when you create a solution with the CreateSolution (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) +// API. CreateSolution trains a model by using the algorithm in the specified +// recipe and a training dataset. The solution, when deployed as a campaign, +// can provide recommendations using the GetRecommendations (https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) // API. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -3392,7 +3437,7 @@ func (c *Personalize) DescribeSchemaRequest(input *DescribeSchemaInput) (req *re // DescribeSchema API operation for Amazon Personalize. // -// Describes a schema. For more information on schemas, see CreateSchema. +// Describes a schema. For more information on schemas, see CreateSchema (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -3474,7 +3519,8 @@ func (c *Personalize) DescribeSolutionRequest(input *DescribeSolutionInput) (req // DescribeSolution API operation for Amazon Personalize. // -// Describes a solution. For more information on solutions, see CreateSolution. +// Describes a solution. For more information on solutions, see CreateSolution +// (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -3557,7 +3603,7 @@ func (c *Personalize) DescribeSolutionVersionRequest(input *DescribeSolutionVers // DescribeSolutionVersion API operation for Amazon Personalize. // // Describes a specific version of a solution. For more information on solutions, -// see CreateSolution. +// see CreateSolution (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -4015,7 +4061,8 @@ func (c *Personalize) ListCampaignsRequest(input *ListCampaignsInput) (req *requ // Returns a list of campaigns that use the given solution. When a solution // is not specified, all the campaigns associated with the account are listed. // The response provides the properties for each campaign, including the Amazon -// Resource Name (ARN). For more information on campaigns, see CreateCampaign. +// Resource Name (ARN). For more information on campaigns, see CreateCampaign +// (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -4159,8 +4206,8 @@ func (c *Personalize) ListDatasetExportJobsRequest(input *ListDatasetExportJobsI // dataset is not specified, all the dataset export jobs associated with the // account are listed. The response provides the properties for each dataset // export job, including the Amazon Resource Name (ARN). For more information -// on dataset export jobs, see CreateDatasetExportJob. For more information -// on datasets, see CreateDataset. +// on dataset export jobs, see CreateDatasetExportJob (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html). +// For more information on datasets, see CreateDataset (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -4302,7 +4349,7 @@ func (c *Personalize) ListDatasetGroupsRequest(input *ListDatasetGroupsInput) (r // // Returns a list of dataset groups. The response provides the properties for // each dataset group, including the Amazon Resource Name (ARN). For more information -// on dataset groups, see CreateDatasetGroup. +// on dataset groups, see CreateDatasetGroup (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -4443,8 +4490,8 @@ func (c *Personalize) ListDatasetImportJobsRequest(input *ListDatasetImportJobsI // dataset is not specified, all the dataset import jobs associated with the // account are listed. The response provides the properties for each dataset // import job, including the Amazon Resource Name (ARN). For more information -// on dataset import jobs, see CreateDatasetImportJob. For more information -// on datasets, see CreateDataset. +// on dataset import jobs, see CreateDatasetImportJob (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html). +// For more information on datasets, see CreateDataset (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -4586,7 +4633,7 @@ func (c *Personalize) ListDatasetsRequest(input *ListDatasetsInput) (req *reques // // Returns the list of datasets contained in the given dataset group. The response // provides the properties for each dataset, including the Amazon Resource Name -// (ARN). For more information on datasets, see CreateDataset. +// (ARN). For more information on datasets, see CreateDataset (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -4728,7 +4775,8 @@ func (c *Personalize) ListEventTrackersRequest(input *ListEventTrackersInput) (r // // Returns the list of event trackers associated with the account. The response // provides the properties for each event tracker, including the Amazon Resource -// Name (ARN) and tracking ID. For more information on event trackers, see CreateEventTracker. +// Name (ARN) and tracking ID. For more information on event trackers, see CreateEventTracker +// (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -5295,7 +5343,7 @@ func (c *Personalize) ListSchemasRequest(input *ListSchemasInput) (req *request. // // Returns the list of schemas associated with the account. The response provides // the properties for each schema, including the Amazon Resource Name (ARN). -// For more information on schemas, see CreateSchema. +// For more information on schemas, see CreateSchema (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -5435,7 +5483,7 @@ func (c *Personalize) ListSolutionVersionsRequest(input *ListSolutionVersionsInp // Returns a list of solution versions for the given solution. When a solution // is not specified, all the solution versions associated with the account are // listed. The response provides the properties for each solution version, including -// the Amazon Resource Name (ARN). For more information on solutions, see CreateSolution. +// the Amazon Resource Name (ARN). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -5581,7 +5629,8 @@ func (c *Personalize) ListSolutionsRequest(input *ListSolutionsInput) (req *requ // Returns a list of solutions that use the given dataset group. When a dataset // group is not specified, all the solutions associated with the account are // listed. The response provides the properties for each solution, including -// the Amazon Resource Name (ARN). For more information on solutions, see CreateSolution. +// the Amazon Resource Name (ARN). For more information on solutions, see CreateSolution +// (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -5671,6 +5720,92 @@ func (c *Personalize) ListSolutionsPagesWithContext(ctx aws.Context, input *List return p.Err() } +const opListTagsForResource = "ListTagsForResource" + +// ListTagsForResourceRequest generates a "aws/request.Request" representing the +// client's request for the ListTagsForResource operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See ListTagsForResource for more information on using the ListTagsForResource +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the ListTagsForResourceRequest method. +// req, resp := client.ListTagsForResourceRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListTagsForResource +func (c *Personalize) ListTagsForResourceRequest(input *ListTagsForResourceInput) (req *request.Request, output *ListTagsForResourceOutput) { + op := &request.Operation{ + Name: opListTagsForResource, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &ListTagsForResourceInput{} + } + + output = &ListTagsForResourceOutput{} + req = c.newRequest(op, input, output) + return +} + +// ListTagsForResource API operation for Amazon Personalize. +// +// Get a list of tags (https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html) +// attached to a resource. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon Personalize's +// API operation ListTagsForResource for usage and error information. +// +// Returned Error Types: +// * InvalidInputException +// Provide a valid value for the field or parameter. +// +// * ResourceNotFoundException +// Could not find the specified resource. +// +// * ResourceInUseException +// The specified resource is in use. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListTagsForResource +func (c *Personalize) ListTagsForResource(input *ListTagsForResourceInput) (*ListTagsForResourceOutput, error) { + req, out := c.ListTagsForResourceRequest(input) + return out, req.Send() +} + +// ListTagsForResourceWithContext is the same as ListTagsForResource with the addition of +// the ability to pass a context and additional request options. +// +// See ListTagsForResource for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Personalize) ListTagsForResourceWithContext(ctx aws.Context, input *ListTagsForResourceInput, opts ...request.Option) (*ListTagsForResourceOutput, error) { + req, out := c.ListTagsForResourceRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opStopSolutionVersionCreation = "StopSolutionVersionCreation" // StopSolutionVersionCreationRequest generates a "aws/request.Request" representing the @@ -5769,6 +5904,189 @@ func (c *Personalize) StopSolutionVersionCreationWithContext(ctx aws.Context, in return out, req.Send() } +const opTagResource = "TagResource" + +// TagResourceRequest generates a "aws/request.Request" representing the +// client's request for the TagResource operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See TagResource for more information on using the TagResource +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the TagResourceRequest method. +// req, resp := client.TagResourceRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/TagResource +func (c *Personalize) TagResourceRequest(input *TagResourceInput) (req *request.Request, output *TagResourceOutput) { + op := &request.Operation{ + Name: opTagResource, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &TagResourceInput{} + } + + output = &TagResourceOutput{} + req = c.newRequest(op, input, output) + req.Handlers.Unmarshal.Swap(jsonrpc.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler) + return +} + +// TagResource API operation for Amazon Personalize. +// +// Add a list of tags to a resource. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon Personalize's +// API operation TagResource for usage and error information. +// +// Returned Error Types: +// * InvalidInputException +// Provide a valid value for the field or parameter. +// +// * ResourceNotFoundException +// Could not find the specified resource. +// +// * TooManyTagsException +// You have exceeded the maximum number of tags you can apply to this resource. +// +// * ResourceInUseException +// The specified resource is in use. +// +// * LimitExceededException +// The limit on the number of requests per second has been exceeded. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/TagResource +func (c *Personalize) TagResource(input *TagResourceInput) (*TagResourceOutput, error) { + req, out := c.TagResourceRequest(input) + return out, req.Send() +} + +// TagResourceWithContext is the same as TagResource with the addition of +// the ability to pass a context and additional request options. +// +// See TagResource for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Personalize) TagResourceWithContext(ctx aws.Context, input *TagResourceInput, opts ...request.Option) (*TagResourceOutput, error) { + req, out := c.TagResourceRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opUntagResource = "UntagResource" + +// UntagResourceRequest generates a "aws/request.Request" representing the +// client's request for the UntagResource operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See UntagResource for more information on using the UntagResource +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the UntagResourceRequest method. +// req, resp := client.UntagResourceRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/UntagResource +func (c *Personalize) UntagResourceRequest(input *UntagResourceInput) (req *request.Request, output *UntagResourceOutput) { + op := &request.Operation{ + Name: opUntagResource, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &UntagResourceInput{} + } + + output = &UntagResourceOutput{} + req = c.newRequest(op, input, output) + req.Handlers.Unmarshal.Swap(jsonrpc.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler) + return +} + +// UntagResource API operation for Amazon Personalize. +// +// Remove tags (https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html) +// that are attached to a resource. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon Personalize's +// API operation UntagResource for usage and error information. +// +// Returned Error Types: +// * InvalidInputException +// Provide a valid value for the field or parameter. +// +// * ResourceNotFoundException +// Could not find the specified resource. +// +// * TooManyTagKeysException +// The request contains more tag keys than can be associated with a resource +// (50 tag keys per resource). +// +// * ResourceInUseException +// The specified resource is in use. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/UntagResource +func (c *Personalize) UntagResource(input *UntagResourceInput) (*UntagResourceOutput, error) { + req, out := c.UntagResourceRequest(input) + return out, req.Send() +} + +// UntagResourceWithContext is the same as UntagResource with the addition of +// the ability to pass a context and additional request options. +// +// See UntagResource for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Personalize) UntagResourceWithContext(ctx aws.Context, input *UntagResourceInput, opts ...request.Option) (*UntagResourceOutput, error) { + req, out := c.UntagResourceRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opUpdateCampaign = "UpdateCampaign" // UpdateCampaignRequest generates a "aws/request.Request" representing the @@ -5817,12 +6135,13 @@ func (c *Personalize) UpdateCampaignRequest(input *UpdateCampaignInput) (req *re // of the campaign's minProvisionedTPS parameter. // // To update a campaign, the campaign status must be ACTIVE or CREATE FAILED. -// Check the campaign status using the DescribeCampaign API. +// Check the campaign status using the DescribeCampaign (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) +// operation. // // You must wait until the status of the updated campaign is ACTIVE before asking // the campaign for recommendations. // -// For more information on campaigns, see CreateCampaign. +// For more information on campaigns, see CreateCampaign (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -6107,7 +6426,8 @@ func (s *AlgorithmImage) SetName(v string) *AlgorithmImage { return s } -// When the solution performs AutoML (performAutoML is true in CreateSolution), +// When the solution performs AutoML (performAutoML is true in CreateSolution +// (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)), // Amazon Personalize determines which recipe, from the specified list, optimizes // the given metric. Amazon Personalize then uses that recipe for the solution. type AutoMLConfig struct { @@ -6150,7 +6470,8 @@ func (s *AutoMLConfig) SetRecipeList(v []*string) *AutoMLConfig { return s } -// When the solution performs AutoML (performAutoML is true in CreateSolution), +// When the solution performs AutoML (performAutoML is true in CreateSolution +// (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)), // specifies the recipe that best optimized the specified metric. type AutoMLResult struct { _ struct{} `type:"structure"` @@ -6479,7 +6800,8 @@ func (s *BatchInferenceJobOutput) SetS3DataDestination(v *S3DataConfig) *BatchIn return s } -// A truncated version of the BatchInferenceJob datatype. The ListBatchInferenceJobs +// A truncated version of the BatchInferenceJob (https://docs.aws.amazon.com/personalize/latest/dg/API_BatchInferenceJob.html). +// The ListBatchInferenceJobs (https://docs.aws.amazon.com/personalize/latest/dg/API_ListBatchInferenceJobs.html) // operation returns a list of batch inference job summaries. type BatchInferenceJobSummary struct { _ struct{} `type:"structure"` @@ -6823,7 +7145,8 @@ func (s *BatchSegmentJobOutput_) SetS3DataDestination(v *S3DataConfig) *BatchSeg return s } -// A truncated version of the BatchSegmentJob datatype. The ListBatchSegmentJobs +// A truncated version of the BatchSegmentJob (https://docs.aws.amazon.com/personalize/latest/dg/API_BatchSegmentJob.html) +// datatype. ListBatchSegmentJobs (https://docs.aws.amazon.com/personalize/latest/dg/API_ListBatchSegmentJobs.html) // operation returns a list of batch segment job summaries. type BatchSegmentJobSummary struct { _ struct{} `type:"structure"` @@ -6920,7 +7243,7 @@ func (s *BatchSegmentJobSummary) SetStatus(v string) *BatchSegmentJobSummary { } // An object that describes the deployment of a solution version. For more information -// on campaigns, see CreateCampaign. +// on campaigns, see CreateCampaign (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html). type Campaign struct { _ struct{} `type:"structure"` @@ -6940,7 +7263,8 @@ type Campaign struct { LastUpdatedDateTime *time.Time `locationName:"lastUpdatedDateTime" type:"timestamp"` // Provides a summary of the properties of a campaign update. For a complete - // listing, call the DescribeCampaign API. + // listing, call the DescribeCampaign (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) + // API. LatestCampaignUpdate *CampaignUpdateSummary `locationName:"latestCampaignUpdate" type:"structure"` // Specifies the requested minimum provisioned transactions (recommendations) @@ -7079,7 +7403,8 @@ func (s *CampaignConfig) SetItemExplorationConfig(v map[string]*string) *Campaig } // Provides a summary of the properties of a campaign. For a complete listing, -// call the DescribeCampaign API. +// call the DescribeCampaign (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) +// API. type CampaignSummary struct { _ struct{} `type:"structure"` @@ -7163,7 +7488,8 @@ func (s *CampaignSummary) SetStatus(v string) *CampaignSummary { } // Provides a summary of the properties of a campaign update. For a complete -// listing, call the DescribeCampaign API. +// listing, call the DescribeCampaign (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) +// API. type CampaignUpdateSummary struct { _ struct{} `type:"structure"` @@ -7370,7 +7696,7 @@ type CreateBatchInferenceJobInput struct { BatchInferenceJobConfig *BatchInferenceJobConfig `locationName:"batchInferenceJobConfig" type:"structure"` // The ARN of the filter to apply to the batch inference job. For more information - // on using filters, see Filtering Batch Recommendations (https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html).. + // on using filters, see Filtering batch recommendations (https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html). FilterArn *string `locationName:"filterArn" type:"string"` // The Amazon S3 path that leads to the input file to base your recommendations @@ -7389,7 +7715,7 @@ type CreateBatchInferenceJobInput struct { // JobOutput is a required field JobOutput *BatchInferenceJobOutput `locationName:"jobOutput" type:"structure" required:"true"` - // The number of recommendations to retreive. + // The number of recommendations to retrieve. NumResults *int64 `locationName:"numResults" type:"integer"` // The ARN of the Amazon Identity and Access Management role that has permissions @@ -7403,6 +7729,10 @@ type CreateBatchInferenceJobInput struct { // // SolutionVersionArn is a required field SolutionVersionArn *string `locationName:"solutionVersionArn" type:"string" required:"true"` + + // A list of tags (https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html) + // to apply to the batch inference job. + Tags []*Tag `locationName:"tags" type:"list"` } // String returns the string representation. @@ -7454,6 +7784,16 @@ func (s *CreateBatchInferenceJobInput) Validate() error { invalidParams.AddNested("JobOutput", err.(request.ErrInvalidParams)) } } + if s.Tags != nil { + for i, v := range s.Tags { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) + } + } + } if invalidParams.Len() > 0 { return invalidParams @@ -7509,6 +7849,12 @@ func (s *CreateBatchInferenceJobInput) SetSolutionVersionArn(v string) *CreateBa return s } +// SetTags sets the Tags field's value. +func (s *CreateBatchInferenceJobInput) SetTags(v []*Tag) *CreateBatchInferenceJobInput { + s.Tags = v + return s +} + type CreateBatchInferenceJobOutput struct { _ struct{} `type:"structure"` @@ -7544,7 +7890,7 @@ type CreateBatchSegmentJobInput struct { _ struct{} `type:"structure"` // The ARN of the filter to apply to the batch segment job. For more information - // on using filters, see filter-batch. + // on using filters, see Filtering batch recommendations (https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html). FilterArn *string `locationName:"filterArn" type:"string"` // The Amazon S3 path for the input data used to generate the batch segment @@ -7578,6 +7924,10 @@ type CreateBatchSegmentJobInput struct { // // SolutionVersionArn is a required field SolutionVersionArn *string `locationName:"solutionVersionArn" type:"string" required:"true"` + + // A list of tags (https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html) + // to apply to the batch segment job. + Tags []*Tag `locationName:"tags" type:"list"` } // String returns the string representation. @@ -7629,6 +7979,16 @@ func (s *CreateBatchSegmentJobInput) Validate() error { invalidParams.AddNested("JobOutput", err.(request.ErrInvalidParams)) } } + if s.Tags != nil { + for i, v := range s.Tags { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) + } + } + } if invalidParams.Len() > 0 { return invalidParams @@ -7678,6 +8038,12 @@ func (s *CreateBatchSegmentJobInput) SetSolutionVersionArn(v string) *CreateBatc return s } +// SetTags sets the Tags field's value. +func (s *CreateBatchSegmentJobInput) SetTags(v []*Tag) *CreateBatchSegmentJobInput { + s.Tags = v + return s +} + type CreateBatchSegmentJobOutput struct { _ struct{} `type:"structure"` @@ -7729,6 +8095,10 @@ type CreateCampaignInput struct { // // SolutionVersionArn is a required field SolutionVersionArn *string `locationName:"solutionVersionArn" type:"string" required:"true"` + + // A list of tags (https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html) + // to apply to the campaign. + Tags []*Tag `locationName:"tags" type:"list"` } // String returns the string representation. @@ -7764,6 +8134,16 @@ func (s *CreateCampaignInput) Validate() error { if s.SolutionVersionArn == nil { invalidParams.Add(request.NewErrParamRequired("SolutionVersionArn")) } + if s.Tags != nil { + for i, v := range s.Tags { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) + } + } + } if invalidParams.Len() > 0 { return invalidParams @@ -7795,6 +8175,12 @@ func (s *CreateCampaignInput) SetSolutionVersionArn(v string) *CreateCampaignInp return s } +// SetTags sets the Tags field's value. +func (s *CreateCampaignInput) SetTags(v []*Tag) *CreateCampaignInput { + s.Tags = v + return s +} + type CreateCampaignOutput struct { _ struct{} `type:"structure"` @@ -7855,6 +8241,10 @@ type CreateDatasetExportJobInput struct { // // RoleArn is a required field RoleArn *string `locationName:"roleArn" type:"string" required:"true"` + + // A list of tags (https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html) + // to apply to the dataset export job. + Tags []*Tag `locationName:"tags" type:"list"` } // String returns the string representation. @@ -7898,11 +8288,21 @@ func (s *CreateDatasetExportJobInput) Validate() error { invalidParams.AddNested("JobOutput", err.(request.ErrInvalidParams)) } } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil + if s.Tags != nil { + for i, v := range s.Tags { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) + } + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil } // SetDatasetArn sets the DatasetArn field's value. @@ -7935,6 +8335,12 @@ func (s *CreateDatasetExportJobInput) SetRoleArn(v string) *CreateDatasetExportJ return s } +// SetTags sets the Tags field's value. +func (s *CreateDatasetExportJobInput) SetTags(v []*Tag) *CreateDatasetExportJobInput { + s.Tags = v + return s +} + type CreateDatasetExportJobOutput struct { _ struct{} `type:"structure"` @@ -7989,6 +8395,10 @@ type CreateDatasetGroupInput struct { // to access the Key Management Service (KMS) key. Supplying an IAM role is // only valid when also specifying a KMS key. RoleArn *string `locationName:"roleArn" type:"string"` + + // A list of tags (https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html) + // to apply to the dataset group. + Tags []*Tag `locationName:"tags" type:"list"` } // String returns the string representation. @@ -8018,6 +8428,16 @@ func (s *CreateDatasetGroupInput) Validate() error { if s.Name != nil && len(*s.Name) < 1 { invalidParams.Add(request.NewErrParamMinLen("Name", 1)) } + if s.Tags != nil { + for i, v := range s.Tags { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) + } + } + } if invalidParams.Len() > 0 { return invalidParams @@ -8049,6 +8469,12 @@ func (s *CreateDatasetGroupInput) SetRoleArn(v string) *CreateDatasetGroupInput return s } +// SetTags sets the Tags field's value. +func (s *CreateDatasetGroupInput) SetTags(v []*Tag) *CreateDatasetGroupInput { + s.Tags = v + return s +} + type CreateDatasetGroupOutput struct { _ struct{} `type:"structure"` @@ -8112,6 +8538,10 @@ type CreateDatasetImportJobInput struct { // // RoleArn is a required field RoleArn *string `locationName:"roleArn" type:"string" required:"true"` + + // A list of tags (https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html) + // to apply to the dataset import job. + Tags []*Tag `locationName:"tags" type:"list"` } // String returns the string representation. @@ -8150,6 +8580,16 @@ func (s *CreateDatasetImportJobInput) Validate() error { if s.RoleArn == nil { invalidParams.Add(request.NewErrParamRequired("RoleArn")) } + if s.Tags != nil { + for i, v := range s.Tags { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) + } + } + } if invalidParams.Len() > 0 { return invalidParams @@ -8181,6 +8621,12 @@ func (s *CreateDatasetImportJobInput) SetRoleArn(v string) *CreateDatasetImportJ return s } +// SetTags sets the Tags field's value. +func (s *CreateDatasetImportJobInput) SetTags(v []*Tag) *CreateDatasetImportJobInput { + s.Tags = v + return s +} + type CreateDatasetImportJobOutput struct { _ struct{} `type:"structure"` @@ -8243,6 +8689,10 @@ type CreateDatasetInput struct { // // SchemaArn is a required field SchemaArn *string `locationName:"schemaArn" type:"string" required:"true"` + + // A list of tags (https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html) + // to apply to the dataset. + Tags []*Tag `locationName:"tags" type:"list"` } // String returns the string representation. @@ -8281,6 +8731,16 @@ func (s *CreateDatasetInput) Validate() error { if s.SchemaArn == nil { invalidParams.Add(request.NewErrParamRequired("SchemaArn")) } + if s.Tags != nil { + for i, v := range s.Tags { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) + } + } + } if invalidParams.Len() > 0 { return invalidParams @@ -8312,6 +8772,12 @@ func (s *CreateDatasetInput) SetSchemaArn(v string) *CreateDatasetInput { return s } +// SetTags sets the Tags field's value. +func (s *CreateDatasetInput) SetTags(v []*Tag) *CreateDatasetInput { + s.Tags = v + return s +} + type CreateDatasetOutput struct { _ struct{} `type:"structure"` @@ -8356,6 +8822,10 @@ type CreateEventTrackerInput struct { // // Name is a required field Name *string `locationName:"name" min:"1" type:"string" required:"true"` + + // A list of tags (https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html) + // to apply to the event tracker. + Tags []*Tag `locationName:"tags" type:"list"` } // String returns the string representation. @@ -8388,6 +8858,16 @@ func (s *CreateEventTrackerInput) Validate() error { if s.Name != nil && len(*s.Name) < 1 { invalidParams.Add(request.NewErrParamMinLen("Name", 1)) } + if s.Tags != nil { + for i, v := range s.Tags { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) + } + } + } if invalidParams.Len() > 0 { return invalidParams @@ -8407,6 +8887,12 @@ func (s *CreateEventTrackerInput) SetName(v string) *CreateEventTrackerInput { return s } +// SetTags sets the Tags field's value. +func (s *CreateEventTrackerInput) SetTags(v []*Tag) *CreateEventTrackerInput { + s.Tags = v + return s +} + type CreateEventTrackerOutput struct { _ struct{} `type:"structure"` @@ -8459,7 +8945,7 @@ type CreateFilterInput struct { // The filter expression defines which items are included or excluded from recommendations. // Filter expression must follow specific format rules. For information about - // filter expression structure and syntax, see filter-expressions. + // filter expression structure and syntax, see Filter expressions (https://docs.aws.amazon.com/personalize/latest/dg/filter-expressions.html). // // FilterExpression is a sensitive parameter and its value will be // replaced with "sensitive" in string returned by CreateFilterInput's @@ -8472,6 +8958,10 @@ type CreateFilterInput struct { // // Name is a required field Name *string `locationName:"name" min:"1" type:"string" required:"true"` + + // A list of tags (https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html) + // to apply to the filter. + Tags []*Tag `locationName:"tags" type:"list"` } // String returns the string representation. @@ -8510,6 +9000,16 @@ func (s *CreateFilterInput) Validate() error { if s.Name != nil && len(*s.Name) < 1 { invalidParams.Add(request.NewErrParamMinLen("Name", 1)) } + if s.Tags != nil { + for i, v := range s.Tags { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) + } + } + } if invalidParams.Len() > 0 { return invalidParams @@ -8535,6 +9035,12 @@ func (s *CreateFilterInput) SetName(v string) *CreateFilterInput { return s } +// SetTags sets the Tags field's value. +func (s *CreateFilterInput) SetTags(v []*Tag) *CreateFilterInput { + s.Tags = v + return s +} + type CreateFilterOutput struct { _ struct{} `type:"structure"` @@ -8590,6 +9096,10 @@ type CreateRecommenderInput struct { // The configuration details of the recommender. RecommenderConfig *RecommenderConfig `locationName:"recommenderConfig" type:"structure"` + + // A list of tags (https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html) + // to apply to the recommender. + Tags []*Tag `locationName:"tags" type:"list"` } // String returns the string representation. @@ -8630,6 +9140,16 @@ func (s *CreateRecommenderInput) Validate() error { invalidParams.AddNested("RecommenderConfig", err.(request.ErrInvalidParams)) } } + if s.Tags != nil { + for i, v := range s.Tags { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) + } + } + } if invalidParams.Len() > 0 { return invalidParams @@ -8661,6 +9181,12 @@ func (s *CreateRecommenderInput) SetRecommenderConfig(v *RecommenderConfig) *Cre return s } +// SetTags sets the Tags field's value. +func (s *CreateRecommenderInput) SetTags(v []*Tag) *CreateRecommenderInput { + s.Tags = v + return s +} + type CreateRecommenderOutput struct { _ struct{} `type:"structure"` @@ -8846,6 +9372,10 @@ type CreateSolutionInput struct { // // Amazon Personalize doesn't support configuring the hpoObjective at this time. SolutionConfig *SolutionConfig `locationName:"solutionConfig" type:"structure"` + + // A list of tags (https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html) + // to apply to the solution. + Tags []*Tag `locationName:"tags" type:"list"` } // String returns the string representation. @@ -8883,6 +9413,16 @@ func (s *CreateSolutionInput) Validate() error { invalidParams.AddNested("SolutionConfig", err.(request.ErrInvalidParams)) } } + if s.Tags != nil { + for i, v := range s.Tags { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) + } + } + } if invalidParams.Len() > 0 { return invalidParams @@ -8932,6 +9472,12 @@ func (s *CreateSolutionInput) SetSolutionConfig(v *SolutionConfig) *CreateSoluti return s } +// SetTags sets the Tags field's value. +func (s *CreateSolutionInput) SetTags(v []*Tag) *CreateSolutionInput { + s.Tags = v + return s +} + type CreateSolutionOutput struct { _ struct{} `type:"structure"` @@ -8972,6 +9518,10 @@ type CreateSolutionVersionInput struct { // SolutionArn is a required field SolutionArn *string `locationName:"solutionArn" type:"string" required:"true"` + // A list of tags (https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html) + // to apply to the solution version. + Tags []*Tag `locationName:"tags" type:"list"` + // The scope of training to be performed when creating the solution version. // The FULL option trains the solution version based on the entirety of the // input solution's training data, while the UPDATE option processes only the @@ -9011,6 +9561,16 @@ func (s *CreateSolutionVersionInput) Validate() error { if s.SolutionArn == nil { invalidParams.Add(request.NewErrParamRequired("SolutionArn")) } + if s.Tags != nil { + for i, v := range s.Tags { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) + } + } + } if invalidParams.Len() > 0 { return invalidParams @@ -9024,6 +9584,12 @@ func (s *CreateSolutionVersionInput) SetSolutionArn(v string) *CreateSolutionVer return s } +// SetTags sets the Tags field's value. +func (s *CreateSolutionVersionInput) SetTags(v []*Tag) *CreateSolutionVersionInput { + s.Tags = v + return s +} + // SetTrainingMode sets the TrainingMode field's value. func (s *CreateSolutionVersionInput) SetTrainingMode(v string) *CreateSolutionVersionInput { s.TrainingMode = &v @@ -9204,7 +9770,7 @@ func (s *Dataset) SetStatus(v string) *Dataset { } // Describes a job that exports a dataset to an Amazon S3 bucket. For more information, -// see CreateDatasetExportJob. +// see CreateDatasetExportJob (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html). // // A dataset export job can be in one of the following states: // @@ -9385,7 +9951,8 @@ func (s *DatasetExportJobOutput) SetS3DataDestination(v *S3DataConfig) *DatasetE } // Provides a summary of the properties of a dataset export job. For a complete -// listing, call the DescribeDatasetExportJob API. +// listing, call the DescribeDatasetExportJob (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html) +// API. type DatasetExportJobSummary struct { _ struct{} `type:"structure"` @@ -9468,9 +10035,11 @@ func (s *DatasetExportJobSummary) SetStatus(v string) *DatasetExportJobSummary { } // A dataset group is a collection of related datasets (Interactions, User, -// and Item). You create a dataset group by calling CreateDatasetGroup. You -// then create a dataset and add it to a dataset group by calling CreateDataset. -// The dataset group is used to create and train a solution by calling CreateSolution. +// and Item). You create a dataset group by calling CreateDatasetGroup (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html). +// You then create a dataset and add it to a dataset group by calling CreateDataset +// (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html). +// The dataset group is used to create and train a solution by calling CreateSolution +// (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html). // A dataset group can contain only one of each type of dataset. // // You can specify an Key Management Service (KMS) key to encrypt the datasets @@ -9586,7 +10155,8 @@ func (s *DatasetGroup) SetStatus(v string) *DatasetGroup { } // Provides a summary of the properties of a dataset group. For a complete listing, -// call the DescribeDatasetGroup API. +// call the DescribeDatasetGroup (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html) +// API. type DatasetGroupSummary struct { _ struct{} `type:"structure"` @@ -9679,7 +10249,8 @@ func (s *DatasetGroupSummary) SetStatus(v string) *DatasetGroupSummary { } // Describes a job that imports training data from a data source (Amazon S3 -// bucket) to an Amazon Personalize dataset. For more information, see CreateDatasetImportJob. +// bucket) to an Amazon Personalize dataset. For more information, see CreateDatasetImportJob +// (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html). // // A dataset import job can be in one of the following states: // @@ -9794,7 +10365,8 @@ func (s *DatasetImportJob) SetStatus(v string) *DatasetImportJob { } // Provides a summary of the properties of a dataset import job. For a complete -// listing, call the DescribeDatasetImportJob API. +// listing, call the DescribeDatasetImportJob (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html) +// API. type DatasetImportJobSummary struct { _ struct{} `type:"structure"` @@ -9877,7 +10449,7 @@ func (s *DatasetImportJobSummary) SetStatus(v string) *DatasetImportJobSummary { } // Describes the schema for a dataset. For more information on schemas, see -// CreateSchema. +// CreateSchema (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html). type DatasetSchema struct { _ struct{} `type:"structure"` @@ -9956,7 +10528,8 @@ func (s *DatasetSchema) SetSchemaArn(v string) *DatasetSchema { } // Provides a summary of the properties of a dataset schema. For a complete -// listing, call the DescribeSchema API. +// listing, call the DescribeSchema (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSchema.html) +// API. type DatasetSchemaSummary struct { _ struct{} `type:"structure"` @@ -10026,7 +10599,8 @@ func (s *DatasetSchemaSummary) SetSchemaArn(v string) *DatasetSchemaSummary { } // Provides a summary of the properties of a dataset. For a complete listing, -// call the DescribeDataset API. +// call the DescribeDataset (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html) +// API. type DatasetSummary struct { _ struct{} `type:"structure"` @@ -12243,7 +12817,8 @@ func (s *EventTracker) SetTrackingId(v string) *EventTracker { } // Provides a summary of the properties of an event tracker. For a complete -// listing, call the DescribeEventTracker API. +// listing, call the DescribeEventTracker (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html) +// API. type EventTrackerSummary struct { _ struct{} `type:"structure"` @@ -12418,7 +12993,7 @@ type Filter struct { // Specifies the type of item interactions to filter out of recommendation results. // The filter expression must follow specific format rules. For information - // about filter expression structure and syntax, see filter-expressions. + // about filter expression structure and syntax, see Filter expressions (https://docs.aws.amazon.com/personalize/latest/dg/filter-expressions.html). // // FilterExpression is a sensitive parameter and its value will be // replaced with "sensitive" in string returned by Filter's @@ -13387,8 +13962,8 @@ type ListCampaignsInput struct { // The maximum number of campaigns to return. MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"` - // A token returned from the previous call to ListCampaigns for getting the - // next set of campaigns (if they exist). + // A token returned from the previous call to ListCampaigns (https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html) + // for getting the next set of campaigns (if they exist). NextToken *string `locationName:"nextToken" type:"string"` // The Amazon Resource Name (ARN) of the solution to list the campaigns for. @@ -14103,7 +14678,7 @@ type ListRecipesInput struct { // Filters returned recipes by domain for a Domain dataset group. Only recipes // (Domain dataset group use cases) for this domain are included in the response. - // If you don't specify a domain, only non-domain recipes are returned. + // If you don't specify a domain, all recipes are returned. Domain *string `locationName:"domain" type:"string" enum:"Domain"` // The maximum number of recipes to return. @@ -14617,6 +15192,83 @@ func (s *ListSolutionsOutput) SetSolutions(v []*SolutionSummary) *ListSolutionsO return s } +type ListTagsForResourceInput struct { + _ struct{} `type:"structure"` + + // The resource's Amazon Resource Name. + // + // ResourceArn is a required field + ResourceArn *string `locationName:"resourceArn" type:"string" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListTagsForResourceInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListTagsForResourceInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ListTagsForResourceInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ListTagsForResourceInput"} + if s.ResourceArn == nil { + invalidParams.Add(request.NewErrParamRequired("ResourceArn")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetResourceArn sets the ResourceArn field's value. +func (s *ListTagsForResourceInput) SetResourceArn(v string) *ListTagsForResourceInput { + s.ResourceArn = &v + return s +} + +type ListTagsForResourceOutput struct { + _ struct{} `type:"structure"` + + // The resource's tags. + Tags []*Tag `locationName:"tags" type:"list"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListTagsForResourceOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListTagsForResourceOutput) GoString() string { + return s.String() +} + +// SetTags sets the Tags field's value. +func (s *ListTagsForResourceOutput) SetTags(v []*Tag) *ListTagsForResourceOutput { + s.Tags = v + return s +} + // Describes the additional objective for the solution, such as maximizing streaming // minutes or increasing revenue. For more information see Optimizing a solution // (https://docs.aws.amazon.com/personalize/latest/dg/optimizing-solution-for-objective.html). @@ -14678,6 +15330,7 @@ func (s *OptimizationObjective) SetObjectiveSensitivity(v string) *OptimizationO // Provides information about a recipe. Each recipe provides an algorithm that // Amazon Personalize uses in model training when you use the CreateSolution +// (https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) // operation. type Recipe struct { _ struct{} `type:"structure"` @@ -14790,7 +15443,8 @@ func (s *Recipe) SetStatus(v string) *Recipe { } // Provides a summary of the properties of a recipe. For a complete listing, -// call the DescribeRecipe API. +// call the DescribeRecipe (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecipe.html) +// API. type RecipeSummary struct { _ struct{} `type:"structure"` @@ -15153,7 +15807,8 @@ func (s *RecommenderSummary) SetStatus(v string) *RecommenderSummary { } // Provides a summary of the properties of a recommender update. For a complete -// listing, call the DescribeRecommender API operation. +// listing, call the DescribeRecommender (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) +// API. type RecommenderUpdateSummary struct { _ struct{} `type:"structure"` @@ -15638,8 +16293,8 @@ type SolutionConfig struct { // Lists the hyperparameter names and ranges. AlgorithmHyperParameters map[string]*string `locationName:"algorithmHyperParameters" type:"map"` - // The AutoMLConfig object containing a list of recipes to search when AutoML - // is performed. + // The AutoMLConfig (https://docs.aws.amazon.com/personalize/latest/dg/API_AutoMLConfig.html) + // object containing a list of recipes to search when AutoML is performed. AutoMLConfig *AutoMLConfig `locationName:"autoMLConfig" type:"structure"` // Only events with a value greater than or equal to this threshold are used @@ -15733,7 +16388,8 @@ func (s *SolutionConfig) SetOptimizationObjective(v *OptimizationObjective) *Sol } // Provides a summary of the properties of a solution. For a complete listing, -// call the DescribeSolution API. +// call the DescribeSolution (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) +// API. type SolutionSummary struct { _ struct{} `type:"structure"` @@ -15808,7 +16464,8 @@ func (s *SolutionSummary) SetStatus(v string) *SolutionSummary { } // An object that provides information about a specific version of a Solution -// in a Custom dataset group. +// (https://docs.aws.amazon.com/personalize/latest/dg/API_Solution.html) in +// a Custom dataset group. type SolutionVersion struct { _ struct{} `type:"structure"` @@ -16000,7 +16657,8 @@ func (s *SolutionVersion) SetTunedHPOParams(v *TunedHPOParams) *SolutionVersion } // Provides a summary of the properties of a solution version. For a complete -// listing, call the DescribeSolutionVersion API. +// listing, call the DescribeSolutionVersion (https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) +// API. type SolutionVersionSummary struct { _ struct{} `type:"structure"` @@ -16140,6 +16798,297 @@ func (s StopSolutionVersionCreationOutput) GoString() string { return s.String() } +// The optional metadata that you apply to resources to help you categorize +// and organize them. Each tag consists of a key and an optional value, both +// of which you define. For more information see Tagging Personalize resources +// (https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html). +type Tag struct { + _ struct{} `type:"structure"` + + // One part of a key-value pair that makes up a tag. A key is a general label + // that acts like a category for more specific tag values. + // + // TagKey is a required field + TagKey *string `locationName:"tagKey" min:"1" type:"string" required:"true"` + + // The optional part of a key-value pair that makes up a tag. A value acts as + // a descriptor within a tag category (key). + // + // TagValue is a required field + TagValue *string `locationName:"tagValue" type:"string" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s Tag) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s Tag) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *Tag) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "Tag"} + if s.TagKey == nil { + invalidParams.Add(request.NewErrParamRequired("TagKey")) + } + if s.TagKey != nil && len(*s.TagKey) < 1 { + invalidParams.Add(request.NewErrParamMinLen("TagKey", 1)) + } + if s.TagValue == nil { + invalidParams.Add(request.NewErrParamRequired("TagValue")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetTagKey sets the TagKey field's value. +func (s *Tag) SetTagKey(v string) *Tag { + s.TagKey = &v + return s +} + +// SetTagValue sets the TagValue field's value. +func (s *Tag) SetTagValue(v string) *Tag { + s.TagValue = &v + return s +} + +type TagResourceInput struct { + _ struct{} `type:"structure"` + + // The resource's Amazon Resource Name (ARN). + // + // ResourceArn is a required field + ResourceArn *string `locationName:"resourceArn" type:"string" required:"true"` + + // Tags to apply to the resource. For more information see Tagging Personalize + // resources (https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html). + // + // Tags is a required field + Tags []*Tag `locationName:"tags" type:"list" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s TagResourceInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s TagResourceInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *TagResourceInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "TagResourceInput"} + if s.ResourceArn == nil { + invalidParams.Add(request.NewErrParamRequired("ResourceArn")) + } + if s.Tags == nil { + invalidParams.Add(request.NewErrParamRequired("Tags")) + } + if s.Tags != nil { + for i, v := range s.Tags { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) + } + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetResourceArn sets the ResourceArn field's value. +func (s *TagResourceInput) SetResourceArn(v string) *TagResourceInput { + s.ResourceArn = &v + return s +} + +// SetTags sets the Tags field's value. +func (s *TagResourceInput) SetTags(v []*Tag) *TagResourceInput { + s.Tags = v + return s +} + +type TagResourceOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s TagResourceOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s TagResourceOutput) GoString() string { + return s.String() +} + +// The request contains more tag keys than can be associated with a resource +// (50 tag keys per resource). +type TooManyTagKeysException struct { + _ struct{} `type:"structure"` + RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` + + Message_ *string `locationName:"message" type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s TooManyTagKeysException) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s TooManyTagKeysException) GoString() string { + return s.String() +} + +func newErrorTooManyTagKeysException(v protocol.ResponseMetadata) error { + return &TooManyTagKeysException{ + RespMetadata: v, + } +} + +// Code returns the exception type name. +func (s *TooManyTagKeysException) Code() string { + return "TooManyTagKeysException" +} + +// Message returns the exception's message. +func (s *TooManyTagKeysException) Message() string { + if s.Message_ != nil { + return *s.Message_ + } + return "" +} + +// OrigErr always returns nil, satisfies awserr.Error interface. +func (s *TooManyTagKeysException) OrigErr() error { + return nil +} + +func (s *TooManyTagKeysException) Error() string { + return fmt.Sprintf("%s: %s", s.Code(), s.Message()) +} + +// Status code returns the HTTP status code for the request's response error. +func (s *TooManyTagKeysException) StatusCode() int { + return s.RespMetadata.StatusCode +} + +// RequestID returns the service's response RequestID for request. +func (s *TooManyTagKeysException) RequestID() string { + return s.RespMetadata.RequestID +} + +// You have exceeded the maximum number of tags you can apply to this resource. +type TooManyTagsException struct { + _ struct{} `type:"structure"` + RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` + + Message_ *string `locationName:"message" type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s TooManyTagsException) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s TooManyTagsException) GoString() string { + return s.String() +} + +func newErrorTooManyTagsException(v protocol.ResponseMetadata) error { + return &TooManyTagsException{ + RespMetadata: v, + } +} + +// Code returns the exception type name. +func (s *TooManyTagsException) Code() string { + return "TooManyTagsException" +} + +// Message returns the exception's message. +func (s *TooManyTagsException) Message() string { + if s.Message_ != nil { + return *s.Message_ + } + return "" +} + +// OrigErr always returns nil, satisfies awserr.Error interface. +func (s *TooManyTagsException) OrigErr() error { + return nil +} + +func (s *TooManyTagsException) Error() string { + return fmt.Sprintf("%s: %s", s.Code(), s.Message()) +} + +// Status code returns the HTTP status code for the request's response error. +func (s *TooManyTagsException) StatusCode() int { + return s.RespMetadata.StatusCode +} + +// RequestID returns the service's response RequestID for request. +func (s *TooManyTagsException) RequestID() string { + return s.RespMetadata.RequestID +} + // If hyperparameter optimization (HPO) was performed, contains the hyperparameter // values of the best performing model. type TunedHPOParams struct { @@ -16173,6 +17122,88 @@ func (s *TunedHPOParams) SetAlgorithmHyperParameters(v map[string]*string) *Tune return s } +type UntagResourceInput struct { + _ struct{} `type:"structure"` + + // The resource's Amazon Resource Name (ARN). + // + // ResourceArn is a required field + ResourceArn *string `locationName:"resourceArn" type:"string" required:"true"` + + // Keys to remove from the resource's tags. + // + // TagKeys is a required field + TagKeys []*string `locationName:"tagKeys" type:"list" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UntagResourceInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UntagResourceInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *UntagResourceInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "UntagResourceInput"} + if s.ResourceArn == nil { + invalidParams.Add(request.NewErrParamRequired("ResourceArn")) + } + if s.TagKeys == nil { + invalidParams.Add(request.NewErrParamRequired("TagKeys")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetResourceArn sets the ResourceArn field's value. +func (s *UntagResourceInput) SetResourceArn(v string) *UntagResourceInput { + s.ResourceArn = &v + return s +} + +// SetTagKeys sets the TagKeys field's value. +func (s *UntagResourceInput) SetTagKeys(v []*string) *UntagResourceInput { + s.TagKeys = v + return s +} + +type UntagResourceOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UntagResourceOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UntagResourceOutput) GoString() string { + return s.String() +} + type UpdateCampaignInput struct { _ struct{} `type:"structure"` diff --git a/service/personalize/errors.go b/service/personalize/errors.go index c764bbb02d9..a83243d756a 100644 --- a/service/personalize/errors.go +++ b/service/personalize/errors.go @@ -43,6 +43,19 @@ const ( // // Could not find the specified resource. ErrCodeResourceNotFoundException = "ResourceNotFoundException" + + // ErrCodeTooManyTagKeysException for service response error code + // "TooManyTagKeysException". + // + // The request contains more tag keys than can be associated with a resource + // (50 tag keys per resource). + ErrCodeTooManyTagKeysException = "TooManyTagKeysException" + + // ErrCodeTooManyTagsException for service response error code + // "TooManyTagsException". + // + // You have exceeded the maximum number of tags you can apply to this resource. + ErrCodeTooManyTagsException = "TooManyTagsException" ) var exceptionFromCode = map[string]func(protocol.ResponseMetadata) error{ @@ -52,4 +65,6 @@ var exceptionFromCode = map[string]func(protocol.ResponseMetadata) error{ "ResourceAlreadyExistsException": newErrorResourceAlreadyExistsException, "ResourceInUseException": newErrorResourceInUseException, "ResourceNotFoundException": newErrorResourceNotFoundException, + "TooManyTagKeysException": newErrorTooManyTagKeysException, + "TooManyTagsException": newErrorTooManyTagsException, } diff --git a/service/personalize/personalizeiface/interface.go b/service/personalize/personalizeiface/interface.go index 11babe18591..9e38b56d105 100644 --- a/service/personalize/personalizeiface/interface.go +++ b/service/personalize/personalizeiface/interface.go @@ -310,10 +310,22 @@ type PersonalizeAPI interface { ListSolutionsPages(*personalize.ListSolutionsInput, func(*personalize.ListSolutionsOutput, bool) bool) error ListSolutionsPagesWithContext(aws.Context, *personalize.ListSolutionsInput, func(*personalize.ListSolutionsOutput, bool) bool, ...request.Option) error + ListTagsForResource(*personalize.ListTagsForResourceInput) (*personalize.ListTagsForResourceOutput, error) + ListTagsForResourceWithContext(aws.Context, *personalize.ListTagsForResourceInput, ...request.Option) (*personalize.ListTagsForResourceOutput, error) + ListTagsForResourceRequest(*personalize.ListTagsForResourceInput) (*request.Request, *personalize.ListTagsForResourceOutput) + StopSolutionVersionCreation(*personalize.StopSolutionVersionCreationInput) (*personalize.StopSolutionVersionCreationOutput, error) StopSolutionVersionCreationWithContext(aws.Context, *personalize.StopSolutionVersionCreationInput, ...request.Option) (*personalize.StopSolutionVersionCreationOutput, error) StopSolutionVersionCreationRequest(*personalize.StopSolutionVersionCreationInput) (*request.Request, *personalize.StopSolutionVersionCreationOutput) + TagResource(*personalize.TagResourceInput) (*personalize.TagResourceOutput, error) + TagResourceWithContext(aws.Context, *personalize.TagResourceInput, ...request.Option) (*personalize.TagResourceOutput, error) + TagResourceRequest(*personalize.TagResourceInput) (*request.Request, *personalize.TagResourceOutput) + + UntagResource(*personalize.UntagResourceInput) (*personalize.UntagResourceOutput, error) + UntagResourceWithContext(aws.Context, *personalize.UntagResourceInput, ...request.Option) (*personalize.UntagResourceOutput, error) + UntagResourceRequest(*personalize.UntagResourceInput) (*request.Request, *personalize.UntagResourceOutput) + UpdateCampaign(*personalize.UpdateCampaignInput) (*personalize.UpdateCampaignOutput, error) UpdateCampaignWithContext(aws.Context, *personalize.UpdateCampaignInput, ...request.Option) (*personalize.UpdateCampaignOutput, error) UpdateCampaignRequest(*personalize.UpdateCampaignInput) (*request.Request, *personalize.UpdateCampaignOutput) diff --git a/service/pi/api.go b/service/pi/api.go index d87da6c0771..8b1c4c3503a 100644 --- a/service/pi/api.go +++ b/service/pi/api.go @@ -204,7 +204,7 @@ func (c *PI) GetDimensionKeyDetailsRequest(input *GetDimensionKeyDetailsInput) ( // // Get the attributes of the specified dimension group for a DB instance or // data source. For example, if you specify a SQL ID, GetDimensionKeyDetails -// retrieves the full text of the dimension db.sql.statementcassociated with +// retrieves the full text of the dimension db.sql.statement associated with // this ID. This operation is useful because GetResourceMetrics and DescribeDimensionKeys // don't support retrieval of large SQL statement text. // @@ -383,7 +383,7 @@ func (c *PI) GetResourceMetricsRequest(input *GetResourceMetricsInput) (req *req // GetResourceMetrics API operation for AWS Performance Insights. // -// Retrieve Performance Insights metrics for a set of data sources, over a time +// Retrieve Performance Insights metrics for a set of data sources over a time // period. You can provide specific dimension groups and dimensions, and provide // aggregation and filtering criteria for each group. // @@ -821,7 +821,7 @@ type DescribeDimensionKeysInput struct { // Additional metrics for the top N dimension keys. If the specified dimension // group in the GroupBy parameter is db.sql_tokenized, you can specify per-SQL // metrics to get the values for the top N SQL digests. The response syntax - // is "AdditionalMetrics" : { "string" : "string" }. + // is as follows: "AdditionalMetrics" : { "string" : "string" }. AdditionalMetrics []*string `min:"1" type:"list"` // The date and time specifying the end of the requested time series data. The @@ -868,10 +868,10 @@ type DescribeDimensionKeysInput struct { // // Valid values for Metric are: // - // * db.load.avg - a scaled representation of the number of active sessions + // * db.load.avg - A scaled representation of the number of active sessions // for the database engine. // - // * db.sampledload.avg - the raw number of active sessions for the database + // * db.sampledload.avg - The raw number of active sessions for the database // engine. // // If the number of active sessions is less than an internal Performance Insights @@ -913,7 +913,11 @@ type DescribeDimensionKeysInput struct { PeriodInSeconds *int64 `type:"integer"` // The Amazon Web Services service for which Performance Insights will return - // metrics. The only valid value for ServiceType is RDS. + // metrics. Valid values are as follows: + // + // * RDS + // + // * DOCDB // // ServiceType is a required field ServiceType *string `type:"string" required:"true" enum:"ServiceType"` @@ -1172,7 +1176,18 @@ func (s *DimensionDetail) SetIdentifier(v string) *DimensionDetail { // A logical grouping of Performance Insights metrics for a related subject // area. For example, the db.sql dimension group consists of the following dimensions: -// db.sql.id, db.sql.db_id, db.sql.statement, and db.sql.tokenized_id. +// +// * db.sql.id - The hash of a running SQL statement, generated by Performance +// Insights. +// +// * db.sql.db_id - Either the SQL ID generated by the database engine, or +// a value generated by Performance Insights that begins with pi-. +// +// * db.sql.statement - The full text of the SQL statement that is running, +// for example, SELECT * FROM employees. +// +// * db.sql_tokenized.id - The hash of the SQL digest generated by Performance +// Insights. // // Each response element returns a maximum of 500 bytes. For larger elements, // such as SQL statements, only the first 500 bytes are returned. @@ -1186,74 +1201,119 @@ type DimensionGroup struct { // Valid values for elements in the Dimensions array are: // // * db.application.name - The name of the application that is connected - // to the database (only Aurora PostgreSQL and RDS PostgreSQL) + // to the database. Valid values are as follows: Aurora PostgreSQL Amazon + // RDS PostgreSQL Amazon DocumentDB + // + // * db.host.id - The host ID of the connected client (all engines). + // + // * db.host.name - The host name of the connected client (all engines). + // + // * db.name - The name of the database to which the client is connected. + // Valid values are as follows: Aurora PostgreSQL Amazon RDS PostgreSQL Aurora + // MySQL Amazon RDS MySQL Amazon RDS MariaDB Amazon DocumentDB + // + // * db.query.id - The query ID generated by Performance Insights (only Amazon + // DocumentDB). + // + // * db.query.db_id - The query ID generated by the database (only Amazon + // DocumentDB). // - // * db.host.id - The host ID of the connected client (all engines) + // * db.query.statement - The text of the query that is being run (only Amazon + // DocumentDB). // - // * db.host.name - The host name of the connected client (all engines) + // * db.query.tokenized_id // - // * db.name - The name of the database to which the client is connected - // (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS - // MySQL, and MariaDB) + // * db.query.tokenized.id - The query digest ID generated by Performance + // Insights (only Amazon DocumentDB). // - // * db.session_type.name - The type of the current session (only Aurora - // PostgreSQL and RDS PostgreSQL) + // * db.query.tokenized.db_id - The query digest ID generated by Performance + // Insights (only Amazon DocumentDB). // - // * db.sql.id - The SQL ID generated by Performance Insights (all engines) + // * db.query.tokenized.statement - The text of the query digest (only Amazon + // DocumentDB). // - // * db.sql.db_id - The SQL ID generated by the database (all engines) + // * db.session_type.name - The type of the current session (only Amazon + // DocumentDB). // - // * db.sql.statement - The SQL text that is being executed (all engines) + // * db.sql.id - The hash of the full, non-tokenized SQL statement generated + // by Performance Insights (all engines except Amazon DocumentDB). + // + // * db.sql.db_id - Either the SQL ID generated by the database engine, or + // a value generated by Performance Insights that begins with pi- (all engines + // except Amazon DocumentDB). + // + // * db.sql.statement - The full text of the SQL statement that is running, + // as in SELECT * FROM employees (all engines except Amazon DocumentDB) // // * db.sql.tokenized_id // - // * db.sql_tokenized.id - The SQL digest ID generated by Performance Insights - // (all engines) + // * db.sql_tokenized.id - The hash of the SQL digest generated by Performance + // Insights (all engines except Amazon DocumentDB). In the console, db.sql_tokenized.id + // is called the Support ID because Amazon Web Services Support can look + // at this data to help you troubleshoot database issues. // - // * db.sql_tokenized.db_id - SQL digest ID generated by the database (all - // engines) + // * db.sql_tokenized.db_id - Either the native database ID used to refer + // to the SQL statement, or a synthetic ID such as pi-2372568224 that Performance + // Insights generates if the native database ID isn't available (all engines + // except Amazon DocumentDB). // - // * db.sql_tokenized.statement - The SQL digest text (all engines) + // * db.sql_tokenized.statement - The text of the SQL digest, as in SELECT + // * FROM employees WHERE employee_id = ? (all engines except Amazon DocumentDB) // - // * db.user.id - The ID of the user logged in to the database (all engines) + // * db.user.id - The ID of the user logged in to the database (all engines + // except Amazon DocumentDB). // - // * db.user.name - The name of the user logged in to the database (all engines) + // * db.user.name - The name of the user logged in to the database (all engines + // except Amazon DocumentDB). // // * db.wait_event.name - The event for which the backend is waiting (all - // engines) + // engines except Amazon DocumentDB). // // * db.wait_event.type - The type of event for which the backend is waiting - // (all engines) + // (all engines except Amazon DocumentDB). // // * db.wait_event_type.name - The name of the event type for which the backend - // is waiting (all engines) + // is waiting (all engines except Amazon DocumentDB). + // + // * db.wait_state.name - The event for which the backend is waiting (only + // Amazon DocumentDB). Dimensions []*string `min:"1" type:"list"` - // The name of the dimension group. Valid values are: + // The name of the dimension group. Valid values are as follows: // - // * db - The name of the database to which the client is connected (only - // Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, - // and MariaDB) + // * db - The name of the database to which the client is connected. The + // following values are permitted: Aurora PostgreSQL Amazon RDS PostgreSQL + // Aurora MySQL Amazon RDS MySQL Amazon RDS MariaDB Amazon DocumentDB // // * db.application - The name of the application that is connected to the - // database (only Aurora PostgreSQL and RDS PostgreSQL) + // database. The following values are permitted: Aurora PostgreSQL Amazon + // RDS PostgreSQL Amazon DocumentDB // - // * db.host - The host name of the connected client (all engines) + // * db.host - The host name of the connected client (all engines). + // + // * db.query - The query that is currently running (only Amazon DocumentDB). + // + // * db.query_tokenized - The digest query (only Amazon DocumentDB). // // * db.session_type - The type of the current session (only Aurora PostgreSQL - // and RDS PostgreSQL) + // and RDS PostgreSQL). + // + // * db.sql - The text of the SQL statement that is currently running (all + // engines except Amazon DocumentDB). // - // * db.sql - The SQL that is currently executing (all engines) + // * db.sql_tokenized - The SQL digest (all engines except Amazon DocumentDB). // - // * db.sql_tokenized - The SQL digest (all engines) + // * db.user - The user logged in to the database (all engines except Amazon + // DocumentDB). // // * db.wait_event - The event for which the database backend is waiting - // (all engines) + // (all engines except Amazon DocumentDB). // // * db.wait_event_type - The type of event for which the database backend - // is waiting (all engines) + // is waiting (all engines except Amazon DocumentDB). // - // * db.user - The user logged in to the database (all engines) + // * db.wait_state - The event for which the database backend is waiting + // (only Amazon DocumentDB). // // Group is a required field Group *string `type:"string" required:"true"` @@ -1424,7 +1484,11 @@ type DimensionKeyDetail struct { _ struct{} `type:"structure"` // The full name of the dimension. The full name includes the group name and - // key name. The only valid value is db.sql.statement. + // key name. The following values are valid: + // + // * db.query.statement (Amazon DocumentDB) + // + // * db.sql.statement (Amazon RDS and Aurora) Dimension *string `type:"string"` // The status of the dimension detail data. Possible values include the following: @@ -1432,16 +1496,18 @@ type DimensionKeyDetail struct { // * AVAILABLE - The dimension detail data is ready to be retrieved. // // * PROCESSING - The dimension detail data isn't ready to be retrieved because - // more processing time is required. If the requested detail data for db.sql.statement - // has the status PROCESSING, Performance Insights returns the truncated - // query. + // more processing time is required. If the requested detail data has the + // status PROCESSING, Performance Insights returns the truncated query. // // * UNAVAILABLE - The dimension detail data could not be collected successfully. Status *string `type:"string" enum:"DetailStatus"` - // The value of the dimension detail data. For the db.sql.statement dimension, - // this value is either the full or truncated SQL query, depending on the return - // status. + // The value of the dimension detail data. Depending on the return status, this + // value is either the full or truncated SQL query for the following dimensions: + // + // * db.query.statement (Amazon DocumentDB) + // + // * db.sql.statement (Amazon RDS and Aurora) Value *string `type:"string"` } @@ -1489,19 +1555,19 @@ type FeatureMetadata struct { // The status of the feature on the DB instance. Possible values include the // following: // - // * ENABLED: the feature is enabled on the instance. + // * ENABLED - The feature is enabled on the instance. // - // * DISABLED: the feature is disabled on the instance. + // * DISABLED - The feature is disabled on the instance. // - // * UNSUPPORTED: the feature isn't supported on the instance. + // * UNSUPPORTED - The feature isn't supported on the instance. // - // * ENABLED_PENDING_REBOOT: the feature is enabled on the instance but requires - // a reboot to take effect. + // * ENABLED_PENDING_REBOOT - The feature is enabled on the instance but + // requires a reboot to take effect. // - // * DISABLED_PENDING_REBOOT: the feature is disabled on the instance but + // * DISABLED_PENDING_REBOOT - The feature is disabled on the instance but // requires a reboot to take effect. // - // * UNKNOWN: the feature status couldn't be determined. + // * UNKNOWN - The feature status couldn't be determined. Status *string `type:"string" enum:"FeatureStatus"` } @@ -1532,14 +1598,23 @@ func (s *FeatureMetadata) SetStatus(v string) *FeatureMetadata { type GetDimensionKeyDetailsInput struct { _ struct{} `type:"structure"` - // The name of the dimension group. The only valid value is db.sql. Performance - // Insights searches the specified group for the dimension group ID. + // The name of the dimension group. Performance Insights searches the specified + // group for the dimension group ID. The following group name values are valid: + // + // * db.query (Amazon DocumentDB only) + // + // * db.sql (Amazon RDS and Aurora only) // // Group is a required field Group *string `type:"string" required:"true"` // The ID of the dimension group from which to retrieve dimension details. For - // dimension group db.sql, the group ID is db.sql.id. + // dimension group db.sql, the group ID is db.sql.id. The following group ID + // values are valid: + // + // * db.sql.id for dimension group db.sql (Aurora and RDS only) + // + // * db.query.id for dimension group db.query (DocumentDB only) // // GroupIdentifier is a required field GroupIdentifier *string `type:"string" required:"true"` @@ -1553,10 +1628,15 @@ type GetDimensionKeyDetailsInput struct { Identifier *string `type:"string" required:"true"` // A list of dimensions to retrieve the detail data for within the given dimension - // group. For the dimension group db.sql, specify either the full dimension - // name db.sql.statement or the short dimension name statement. If you don't - // specify this parameter, Performance Insights returns all dimension data within - // the specified dimension group. + // group. If you don't specify this parameter, Performance Insights returns + // all dimension data within the specified dimension group. Specify dimension + // names for the following dimension groups: + // + // * db.sql - Specify either the full dimension name db.sql.statement or + // the short dimension name statement (Aurora and RDS only). + // + // * db.query - Specify either the full dimension name db.query.statement + // or the short dimension name statement (DocumentDB only). RequestedDimensions []*string `min:"1" type:"list"` // The Amazon Web Services service for which Performance Insights returns data. @@ -1780,20 +1860,22 @@ func (s *GetResourceMetadataOutput) SetIdentifier(v string) *GetResourceMetadata type GetResourceMetricsInput struct { _ struct{} `type:"structure"` - // The date and time specifying the end of the requested time series data. The - // value specified is exclusive - data points less than (but not equal to) EndTime - // will be returned. + // The date and time specifying the end of the requested time series query range. + // The value specified is exclusive. Thus, the command returns data points less + // than (but not equal to) EndTime. // // The value for EndTime must be later than the value for StartTime. // // EndTime is a required field EndTime *time.Time `type:"timestamp" required:"true"` - // An immutable, Amazon Web Services Region-unique identifier for a data source. - // Performance Insights gathers metrics from this data source. + // An immutable identifier for a data source that is unique for an Amazon Web + // Services Region. Performance Insights gathers metrics from this data source. + // In the console, the identifier is shown as ResourceID. When you call DescribeDBInstances, + // the identifier is returned as DbiResourceId. // // To use a DB instance as a data source, specify its DbiResourceId value. For - // example, specify db-FAIHNTYBKTGAUSUZQYPDS2GW4A. + // example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X. // // Identifier is a required field Identifier *string `type:"string" required:"true"` @@ -1834,14 +1916,20 @@ type GetResourceMetricsInput struct { PeriodInSeconds *int64 `type:"integer"` // The Amazon Web Services service for which Performance Insights returns metrics. - // The only valid value for ServiceType is RDS. + // Valid values are as follows: + // + // * RDS + // + // * DOCDB // // ServiceType is a required field ServiceType *string `type:"string" required:"true" enum:"ServiceType"` - // The date and time specifying the beginning of the requested time series data. - // You can't specify a StartTime that's earlier than 7 days ago. The value specified - // is inclusive - data points equal to or greater than StartTime will be returned. + // The date and time specifying the beginning of the requested time series query + // range. You can't specify a StartTime that is earlier than 7 days ago. By + // default, Performance Insights has 7 days of retention, but you can extend + // this range up to 2 years. The value specified is inclusive. Thus, the command + // returns data points equal to or greater than StartTime. // // The value for StartTime must be earlier than the value for EndTime. // @@ -1969,14 +2057,13 @@ type GetResourceMetricsOutput struct { // equal to the value of the user-specified StartTime. AlignedStartTime *time.Time `type:"timestamp"` - // An immutable, Amazon Web Services Region-unique identifier for a data source. - // Performance Insights gathers metrics from this data source. - // - // To use a DB instance as a data source, you specify its DbiResourceId value - // - for example: db-FAIHNTYBKTGAUSUZQYPDS2GW4A + // An immutable identifier for a data source that is unique for an Amazon Web + // Services Region. Performance Insights gathers metrics from this data source. + // In the console, the identifier is shown as ResourceID. When you call DescribeDBInstances, + // the identifier is returned as DbiResourceId. Identifier *string `type:"string"` - // An array of metric results,, where each array element contains all of the + // An array of metric results, where each array element contains all of the // data points for a particular dimension. MetricList []*MetricKeyDataPoints `type:"list"` @@ -2328,13 +2415,14 @@ type ListAvailableResourceMetricsInput struct { // The types of metrics to return in the response. Valid values in the array // include the following: // - // * os (OS counter metrics) + // * os (OS counter metrics) - All engines // - // * db (DB load metrics) + // * db (DB load metrics) - All engines except for Amazon DocumentDB // - // * db.sql.stats (per-SQL metrics) + // * db.sql.stats (per-SQL metrics) - All engines except for Amazon DocumentDB // - // * db.sql_tokenized.stats (per-SQL digest metrics) + // * db.sql_tokenized.stats (per-SQL digest metrics) - All engines except + // for Amazon DocumentDB // // MetricTypes is a required field MetricTypes []*string `type:"list" required:"true"` @@ -2575,12 +2663,16 @@ type MetricQuery struct { // // Valid values for Metric are: // - // * db.load.avg - a scaled representation of the number of active sessions + // * db.load.avg - A scaled representation of the number of active sessions // for the database engine. // - // * db.sampledload.avg - the raw number of active sessions for the database + // * db.sampledload.avg - The raw number of active sessions for the database // engine. // + // * The counter metrics listed in Performance Insights operating system + // counters (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights_Counters.html#USER_PerfInsights_Counters.OS) + // in the Amazon Aurora User Guide. + // // If the number of active sessions is less than an internal Performance Insights // threshold, db.load.avg and db.sampledload.avg are the same value. If the // number of active sessions is greater than the internal threshold, Performance @@ -2807,12 +2899,16 @@ type ResponseResourceMetricKey struct { // // Valid values for Metric are: // - // * db.load.avg - a scaled representation of the number of active sessions + // * db.load.avg - A scaled representation of the number of active sessions // for the database engine. // - // * db.sampledload.avg - the raw number of active sessions for the database + // * db.sampledload.avg - The raw number of active sessions for the database // engine. // + // * The counter metrics listed in Performance Insights operating system + // counters (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights_Counters.html#USER_PerfInsights_Counters.OS) + // in the Amazon Aurora User Guide. + // // If the number of active sessions is less than an internal Performance Insights // threshold, db.load.avg and db.sampledload.avg are the same value. If the // number of active sessions is greater than the internal threshold, Performance diff --git a/service/pi/doc.go b/service/pi/doc.go index 129f6e477a9..bc22af75a7a 100644 --- a/service/pi/doc.go +++ b/service/pi/doc.go @@ -22,10 +22,13 @@ // Host. // // * To learn more about Performance Insights and Amazon Aurora DB instances, -// go to the Amazon Aurora User Guide (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.html). +// go to the Amazon Aurora User Guide (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.html) . // // * To learn more about Performance Insights and Amazon RDS DB instances, -// go to the Amazon RDS User Guide (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html). +// go to the Amazon RDS User Guide (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html) . +// +// * To learn more about Performance Insights and Amazon DocumentDB clusters, +// go to the Amazon DocumentDB Developer Guide (https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html) . // // See https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27 for more information on this service. // diff --git a/service/sagemaker/api.go b/service/sagemaker/api.go index d1a85ea85e7..2aed892a184 100644 --- a/service/sagemaker/api.go +++ b/service/sagemaker/api.go @@ -95322,6 +95322,30 @@ const ( // InstanceTypeMlR524xlarge is a InstanceType enum value InstanceTypeMlR524xlarge = "ml.r5.24xlarge" + + // InstanceTypeMlG5Xlarge is a InstanceType enum value + InstanceTypeMlG5Xlarge = "ml.g5.xlarge" + + // InstanceTypeMlG52xlarge is a InstanceType enum value + InstanceTypeMlG52xlarge = "ml.g5.2xlarge" + + // InstanceTypeMlG54xlarge is a InstanceType enum value + InstanceTypeMlG54xlarge = "ml.g5.4xlarge" + + // InstanceTypeMlG58xlarge is a InstanceType enum value + InstanceTypeMlG58xlarge = "ml.g5.8xlarge" + + // InstanceTypeMlG516xlarge is a InstanceType enum value + InstanceTypeMlG516xlarge = "ml.g5.16xlarge" + + // InstanceTypeMlG512xlarge is a InstanceType enum value + InstanceTypeMlG512xlarge = "ml.g5.12xlarge" + + // InstanceTypeMlG524xlarge is a InstanceType enum value + InstanceTypeMlG524xlarge = "ml.g5.24xlarge" + + // InstanceTypeMlG548xlarge is a InstanceType enum value + InstanceTypeMlG548xlarge = "ml.g5.48xlarge" ) // InstanceType_Values returns all elements of the InstanceType enum @@ -95388,6 +95412,14 @@ func InstanceType_Values() []string { InstanceTypeMlR512xlarge, InstanceTypeMlR516xlarge, InstanceTypeMlR524xlarge, + InstanceTypeMlG5Xlarge, + InstanceTypeMlG52xlarge, + InstanceTypeMlG54xlarge, + InstanceTypeMlG58xlarge, + InstanceTypeMlG516xlarge, + InstanceTypeMlG512xlarge, + InstanceTypeMlG524xlarge, + InstanceTypeMlG548xlarge, } }