feat(client-redshift): This release launches S3 event integrations to…

… create and manage integrations from an Amazon S3 source into an Amazon Redshift database.
aws · Oct 30, 2024 · 32d38b0 · 32d38b0
1 parent c86827e
commit 32d38b0
Show file tree

Hide file tree

Showing 8 changed files with 53 additions and 23 deletions.
diff --git a/clients/client-redshift/README.md b/clients/client-redshift/README.md
@@ -31,7 +31,7 @@ build, query, and maintain the databases that make up your data warehouse. </p>
 
 ## Installing
 
-To install the this package, simply type add or install @aws-sdk/client-redshift
+To install this package, simply type add or install @aws-sdk/client-redshift
 using your favorite package manager:
 
 - `npm install @aws-sdk/client-redshift`

diff --git a/clients/client-redshift/src/commands/CreateIntegrationCommand.ts b/clients/client-redshift/src/commands/CreateIntegrationCommand.ts
@@ -28,7 +28,7 @@ export interface CreateIntegrationCommandInput extends CreateIntegrationMessage
 export interface CreateIntegrationCommandOutput extends Integration, __MetadataBearer {}
 
 /**
- * <p>Creates a zero-ETL integration with Amazon Redshift.</p>
+ * <p>Creates a zero-ETL integration or S3 event integration with Amazon Redshift.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -96,7 +96,7 @@ export interface CreateIntegrationCommandOutput extends Integration, __MetadataB
  *             and these requests conflict with each other.</p>
  *
  * @throws {@link IntegrationQuotaExceededFault} (client fault)
- *  <p>You can't create any more zero-ETL integrations because the quota has been reached.</p>
+ *  <p>You can't create any more zero-ETL or S3 event integrations because the quota has been reached.</p>
  *
  * @throws {@link IntegrationSourceNotFoundFault} (client fault)
  *  <p>The specified integration source can't be found.</p>

diff --git a/clients/client-redshift/src/commands/DeleteIntegrationCommand.ts b/clients/client-redshift/src/commands/DeleteIntegrationCommand.ts
@@ -28,7 +28,7 @@ export interface DeleteIntegrationCommandInput extends DeleteIntegrationMessage
 export interface DeleteIntegrationCommandOutput extends Integration, __MetadataBearer {}
 
 /**
- * <p>Deletes a zero-ETL integration with Amazon Redshift.</p>
+ * <p>Deletes a zero-ETL integration or S3 event integration with Amazon Redshift.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

diff --git a/clients/client-redshift/src/commands/DescribeIntegrationsCommand.ts b/clients/client-redshift/src/commands/DescribeIntegrationsCommand.ts
@@ -28,7 +28,7 @@ export interface DescribeIntegrationsCommandInput extends DescribeIntegrationsMe
 export interface DescribeIntegrationsCommandOutput extends IntegrationsMessage, __MetadataBearer {}
 
 /**
- * <p>Describes one or more zero-ETL integrations with Amazon Redshift.</p>
+ * <p>Describes one or more zero-ETL or S3 event integrations with Amazon Redshift.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

diff --git a/clients/client-redshift/src/commands/ModifyIntegrationCommand.ts b/clients/client-redshift/src/commands/ModifyIntegrationCommand.ts
@@ -29,7 +29,7 @@ export interface ModifyIntegrationCommandInput extends ModifyIntegrationMessage
 export interface ModifyIntegrationCommandOutput extends Integration, __MetadataBearer {}
 
 /**
- * <p>Modifies a zero-ETL integration with Amazon Redshift.</p>
+ * <p>Modifies a zero-ETL integration or S3 event integration with Amazon Redshift.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

diff --git a/clients/client-redshift/src/models/models_0.ts b/clients/client-redshift/src/models/models_0.ts
@@ -6511,7 +6511,7 @@ export class IntegrationConflictOperationFault extends __BaseException {
 }
 
 /**
- * <p>You can't create any more zero-ETL integrations because the quota has been reached.</p>
+ * <p>You can't create any more zero-ETL or S3 event integrations because the quota has been reached.</p>
  * @public
  */
 export class IntegrationQuotaExceededFault extends __BaseException {

diff --git a/clients/client-redshift/src/models/models_1.ts b/clients/client-redshift/src/models/models_1.ts
@@ -2961,7 +2961,7 @@ export interface DescribeTagsMessage {
    *                <p>Snapshot copy grant</p>
    *             </li>
    *             <li>
-   *                <p>Integration (zero-ETL integration)</p>
+   *                <p>Integration (zero-ETL integration or S3 event integration)</p>
    *                <note>
    *                   <p>To describe the tags associated with an <code>integration</code>, don't specify <code>ResourceType</code>,
    *                     instead specify the <code>ResourceName</code> of the integration.</p>

diff --git a/codegen/sdk-codegen/aws-models/redshift.json b/codegen/sdk-codegen/aws-models/redshift.json
@@ -3852,22 +3852,22 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Creates a zero-ETL integration with Amazon Redshift.</p>"
+        "smithy.api#documentation": "<p>Creates a zero-ETL integration or S3 event integration with Amazon Redshift.</p>"
       }
     },
     "com.amazonaws.redshift#CreateIntegrationMessage": {
       "type": "structure",
       "members": {
         "SourceArn": {
-          "target": "com.amazonaws.redshift#String",
+          "target": "com.amazonaws.redshift#SourceArn",
           "traits": {
             "smithy.api#clientOptional": {},
             "smithy.api#documentation": "<p>The Amazon Resource Name (ARN) of the database to use as the source for replication.</p>",
             "smithy.api#required": {}
           }
         },
         "TargetArn": {
-          "target": "com.amazonaws.redshift#String",
+          "target": "com.amazonaws.redshift#TargetArn",
           "traits": {
             "smithy.api#clientOptional": {},
             "smithy.api#documentation": "<p>The Amazon Resource Name (ARN) of the Amazon Redshift data warehouse to use as the target for replication.</p>",
@@ -5372,7 +5372,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Deletes a zero-ETL integration with Amazon Redshift.</p>"
+        "smithy.api#documentation": "<p>Deletes a zero-ETL integration or S3 event integration with Amazon Redshift.</p>"
       }
     },
     "com.amazonaws.redshift#DeleteIntegrationMessage": {
@@ -7325,13 +7325,13 @@
       "type": "structure",
       "members": {
         "IntegrationArn": {
-          "target": "com.amazonaws.redshift#String",
+          "target": "com.amazonaws.redshift#InboundIntegrationArn",
           "traits": {
             "smithy.api#documentation": "<p>The Amazon Resource Name (ARN) of the inbound integration.</p>"
           }
         },
         "TargetArn": {
-          "target": "com.amazonaws.redshift#String",
+          "target": "com.amazonaws.redshift#TargetArn",
           "traits": {
             "smithy.api#documentation": "<p>The Amazon Resource Name (ARN) of the target of an inbound integration.</p>"
           }
@@ -7370,7 +7370,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Describes one or more zero-ETL integrations with Amazon Redshift.</p>",
+        "smithy.api#documentation": "<p>Describes one or more zero-ETL or S3 event integrations with Amazon Redshift.</p>",
         "smithy.api#paginated": {
           "inputToken": "Marker",
           "outputToken": "Marker",
@@ -8383,7 +8383,7 @@
         "ResourceType": {
           "target": "com.amazonaws.redshift#String",
           "traits": {
-            "smithy.api#documentation": "<p>The type of resource with which you want to view tags. Valid resource types are: </p>\n         <ul>\n            <li>\n               <p>Cluster</p>\n            </li>\n            <li>\n               <p>CIDR/IP</p>\n            </li>\n            <li>\n               <p>EC2 security group</p>\n            </li>\n            <li>\n               <p>Snapshot</p>\n            </li>\n            <li>\n               <p>Cluster security group</p>\n            </li>\n            <li>\n               <p>Subnet group</p>\n            </li>\n            <li>\n               <p>HSM connection</p>\n            </li>\n            <li>\n               <p>HSM certificate</p>\n            </li>\n            <li>\n               <p>Parameter group</p>\n            </li>\n            <li>\n               <p>Snapshot copy grant</p>\n            </li>\n            <li>\n               <p>Integration (zero-ETL integration)</p>\n               <note>\n                  <p>To describe the tags associated with an <code>integration</code>, don't specify <code>ResourceType</code>, \n                    instead specify the <code>ResourceName</code> of the integration.</p>\n               </note>\n            </li>\n         </ul>\n         <p>For more information about Amazon Redshift resource types and constructing ARNs, go to\n                <a href=\"https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-access-control-overview.html#redshift-iam-access-control-specify-actions\">Specifying Policy Elements: Actions, Effects, Resources, and Principals</a> in\n            the Amazon Redshift Cluster Management Guide. </p>"
+            "smithy.api#documentation": "<p>The type of resource with which you want to view tags. Valid resource types are: </p>\n         <ul>\n            <li>\n               <p>Cluster</p>\n            </li>\n            <li>\n               <p>CIDR/IP</p>\n            </li>\n            <li>\n               <p>EC2 security group</p>\n            </li>\n            <li>\n               <p>Snapshot</p>\n            </li>\n            <li>\n               <p>Cluster security group</p>\n            </li>\n            <li>\n               <p>Subnet group</p>\n            </li>\n            <li>\n               <p>HSM connection</p>\n            </li>\n            <li>\n               <p>HSM certificate</p>\n            </li>\n            <li>\n               <p>Parameter group</p>\n            </li>\n            <li>\n               <p>Snapshot copy grant</p>\n            </li>\n            <li>\n               <p>Integration (zero-ETL integration or S3 event integration)</p>\n               <note>\n                  <p>To describe the tags associated with an <code>integration</code>, don't specify <code>ResourceType</code>, \n                    instead specify the <code>ResourceName</code> of the integration.</p>\n               </note>\n            </li>\n         </ul>\n         <p>For more information about Amazon Redshift resource types and constructing ARNs, go to\n                <a href=\"https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-access-control-overview.html#redshift-iam-access-control-specify-actions\">Specifying Policy Elements: Actions, Effects, Resources, and Principals</a> in\n            the Amazon Redshift Cluster Management Guide. </p>"
           }
         },
         "MaxRecords": {
@@ -10331,7 +10331,7 @@
       "type": "structure",
       "members": {
         "IntegrationArn": {
-          "target": "com.amazonaws.redshift#String",
+          "target": "com.amazonaws.redshift#InboundIntegrationArn",
           "traits": {
             "smithy.api#documentation": "<p>The Amazon Resource Name (ARN) of an inbound integration.</p>"
           }
@@ -10343,7 +10343,7 @@
           }
         },
         "TargetArn": {
-          "target": "com.amazonaws.redshift#String",
+          "target": "com.amazonaws.redshift#TargetArn",
           "traits": {
             "smithy.api#documentation": "<p>The Amazon Resource Name (ARN) of the target of an inbound integration.</p>"
           }
@@ -10371,6 +10371,16 @@
         "smithy.api#documentation": "<p>The content of an inbound integration.</p>"
       }
     },
+    "com.amazonaws.redshift#InboundIntegrationArn": {
+      "type": "string",
+      "traits": {
+        "smithy.api#length": {
+          "min": 1,
+          "max": 255
+        },
+        "smithy.api#pattern": "^arn:aws[a-z\\-]*:.+:[a-z0-9\\-]*:[0-9]*:integration:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
+      }
+    },
     "com.amazonaws.redshift#InboundIntegrationList": {
       "type": "list",
       "member": {
@@ -10461,7 +10471,7 @@
       "type": "structure",
       "members": {
         "IntegrationArn": {
-          "target": "com.amazonaws.redshift#String",
+          "target": "com.amazonaws.redshift#IntegrationArn",
           "traits": {
             "smithy.api#documentation": "<p>The Amazon Resource Name (ARN) of the integration.</p>"
           }
@@ -10473,13 +10483,13 @@
           }
         },
         "SourceArn": {
-          "target": "com.amazonaws.redshift#String",
+          "target": "com.amazonaws.redshift#SourceArn",
           "traits": {
             "smithy.api#documentation": "<p>The Amazon Resource Name (ARN) of the database used as the source for\n            replication.</p>"
           }
         },
         "TargetArn": {
-          "target": "com.amazonaws.redshift#String",
+          "target": "com.amazonaws.redshift#TargetArn",
           "traits": {
             "smithy.api#documentation": "<p>The Amazon Resource Name (ARN) of the Amazon Redshift data warehouse to use as the target for replication.</p>"
           }
@@ -10678,7 +10688,7 @@
           "code": "IntegrationQuotaExceededFault",
           "httpResponseCode": 400
         },
-        "smithy.api#documentation": "<p>You can't create any more zero-ETL integrations because the quota has been reached.</p>",
+        "smithy.api#documentation": "<p>You can't create any more zero-ETL or S3 event integrations because the quota has been reached.</p>",
         "smithy.api#error": "client",
         "smithy.api#httpError": 400
       }
@@ -12653,7 +12663,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Modifies a zero-ETL integration with Amazon Redshift.</p>"
+        "smithy.api#documentation": "<p>Modifies a zero-ETL integration or S3 event integration with Amazon Redshift.</p>"
       }
     },
     "com.amazonaws.redshift#ModifyIntegrationMessage": {
@@ -18621,6 +18631,16 @@
         }
       }
     },
+    "com.amazonaws.redshift#SourceArn": {
+      "type": "string",
+      "traits": {
+        "smithy.api#length": {
+          "min": 1,
+          "max": 255
+        },
+        "smithy.api#pattern": "^arn:aws[a-z\\-]*:(s3|dynamodb):.*:.*:[a-zA-Z0-9._\\-\\/]+$"
+      }
+    },
     "com.amazonaws.redshift#SourceIdsList": {
       "type": "list",
       "member": {
@@ -19197,6 +19217,16 @@
         "smithy.api#output": {}
       }
     },
+    "com.amazonaws.redshift#TargetArn": {
+      "type": "string",
+      "traits": {
+        "smithy.api#length": {
+          "min": 20,
+          "max": 2048
+        },
+        "smithy.api#pattern": "^arn:aws[a-z\\-]*:redshift(-serverless)?:[a-z0-9\\-]+:[0-9]{12}:(namespace\\/|namespace:)[a-z0-9\\-]+$"
+      }
+    },
     "com.amazonaws.redshift#TrackList": {
       "type": "list",
       "member": {