Update generated code (#1813)

async-aws-bot · web-flow · commit 2a3cbecd745f · 2024-12-04T09:16:56.000+01:00
update generated code
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Added
+
+- AWS api-change: Add FEDERATED type to CreateDataCatalog. This creates Athena Data Catalog, AWS Lambda connector, and AWS Glue connection. Create/DeleteDataCatalog returns DataCatalog. Add Status, ConnectionType, and Error to DataCatalog and DataCatalogSummary. Add DeleteCatalogOnly to delete Athena Catalog only.
+
 ## 3.0.0
 
 ### BC-BREAK
diff --git a/composer.json b/composer.json
@@ -29,7 +29,7 @@
     },
     "extra": {
         "branch-alias": {
-            "dev-master": "3.0-dev"
+            "dev-master": "3.1-dev"
         }
     }
 }
diff --git a/src/Enum/ConnectionType.php b/src/Enum/ConnectionType.php
@@ -0,0 +1,53 @@
+<?php
+
+namespace AsyncAws\Athena\Enum;
+
+final class ConnectionType
+{
+    public const BIGQUERY = 'BIGQUERY';
+    public const CMDB = 'CMDB';
+    public const DATALAKEGEN2 = 'DATALAKEGEN2';
+    public const DB2 = 'DB2';
+    public const DB2AS400 = 'DB2AS400';
+    public const DOCUMENTDB = 'DOCUMENTDB';
+    public const DYNAMODB = 'DYNAMODB';
+    public const GOOGLECLOUDSTORAGE = 'GOOGLECLOUDSTORAGE';
+    public const HBASE = 'HBASE';
+    public const MYSQL = 'MYSQL';
+    public const OPENSEARCH = 'OPENSEARCH';
+    public const ORACLE = 'ORACLE';
+    public const POSTGRESQL = 'POSTGRESQL';
+    public const REDSHIFT = 'REDSHIFT';
+    public const SAPHANA = 'SAPHANA';
+    public const SNOWFLAKE = 'SNOWFLAKE';
+    public const SQLSERVER = 'SQLSERVER';
+    public const SYNAPSE = 'SYNAPSE';
+    public const TIMESTREAM = 'TIMESTREAM';
+    public const TPCDS = 'TPCDS';
+
+    public static function exists(string $value): bool
+    {
+        return isset([
+            self::BIGQUERY => true,
+            self::CMDB => true,
+            self::DATALAKEGEN2 => true,
+            self::DB2 => true,
+            self::DB2AS400 => true,
+            self::DOCUMENTDB => true,
+            self::DYNAMODB => true,
+            self::GOOGLECLOUDSTORAGE => true,
+            self::HBASE => true,
+            self::MYSQL => true,
+            self::OPENSEARCH => true,
+            self::ORACLE => true,
+            self::POSTGRESQL => true,
+            self::REDSHIFT => true,
+            self::SAPHANA => true,
+            self::SNOWFLAKE => true,
+            self::SQLSERVER => true,
+            self::SYNAPSE => true,
+            self::TIMESTREAM => true,
+            self::TPCDS => true,
+        ][$value]);
+    }
+}
diff --git a/src/Enum/DataCatalogStatus.php b/src/Enum/DataCatalogStatus.php
@@ -0,0 +1,31 @@
+<?php
+
+namespace AsyncAws\Athena\Enum;
+
+final class DataCatalogStatus
+{
+    public const CREATE_COMPLETE = 'CREATE_COMPLETE';
+    public const CREATE_FAILED = 'CREATE_FAILED';
+    public const CREATE_FAILED_CLEANUP_COMPLETE = 'CREATE_FAILED_CLEANUP_COMPLETE';
+    public const CREATE_FAILED_CLEANUP_FAILED = 'CREATE_FAILED_CLEANUP_FAILED';
+    public const CREATE_FAILED_CLEANUP_IN_PROGRESS = 'CREATE_FAILED_CLEANUP_IN_PROGRESS';
+    public const CREATE_IN_PROGRESS = 'CREATE_IN_PROGRESS';
+    public const DELETE_COMPLETE = 'DELETE_COMPLETE';
+    public const DELETE_FAILED = 'DELETE_FAILED';
+    public const DELETE_IN_PROGRESS = 'DELETE_IN_PROGRESS';
+
+    public static function exists(string $value): bool
+    {
+        return isset([
+            self::CREATE_COMPLETE => true,
+            self::CREATE_FAILED => true,
+            self::CREATE_FAILED_CLEANUP_COMPLETE => true,
+            self::CREATE_FAILED_CLEANUP_FAILED => true,
+            self::CREATE_FAILED_CLEANUP_IN_PROGRESS => true,
+            self::CREATE_IN_PROGRESS => true,
+            self::DELETE_COMPLETE => true,
+            self::DELETE_FAILED => true,
+            self::DELETE_IN_PROGRESS => true,
+        ][$value]);
+    }
+}
diff --git a/src/Enum/DataCatalogType.php b/src/Enum/DataCatalogType.php
@@ -4,13 +4,15 @@
 
 final class DataCatalogType
 {
+    public const FEDERATED = 'FEDERATED';
     public const GLUE = 'GLUE';
     public const HIVE = 'HIVE';
     public const LAMBDA = 'LAMBDA';
 
     public static function exists(string $value): bool
     {
         return isset([
+            self::FEDERATED => true,
             self::GLUE => true,
             self::HIVE => true,
             self::LAMBDA => true,
diff --git a/src/Result/GetDataCatalogOutput.php b/src/Result/GetDataCatalogOutput.php
@@ -36,6 +36,9 @@ private function populateResultDataCatalog(array $json): DataCatalog
             'Description' => isset($json['Description']) ? (string) $json['Description'] : null,
             'Type' => (string) $json['Type'],
             'Parameters' => !isset($json['Parameters']) ? null : $this->populateResultParametersMap($json['Parameters']),
+            'Status' => isset($json['Status']) ? (string) $json['Status'] : null,
+            'ConnectionType' => isset($json['ConnectionType']) ? (string) $json['ConnectionType'] : null,
+            'Error' => isset($json['Error']) ? (string) $json['Error'] : null,
         ]);
     }
 
diff --git a/src/ValueObject/DataCatalog.php b/src/ValueObject/DataCatalog.php
@@ -2,6 +2,8 @@
 
 namespace AsyncAws\Athena\ValueObject;
 
+use AsyncAws\Athena\Enum\ConnectionType;
+use AsyncAws\Athena\Enum\DataCatalogStatus;
 use AsyncAws\Athena\Enum\DataCatalogType;
 use AsyncAws\Core\Exception\InvalidArgument;
 
@@ -30,8 +32,9 @@ final class DataCatalog
     private $description;
 
     /**
-     * The type of data catalog to create: `LAMBDA` for a federated catalog, `HIVE` for an external hive metastore, or
-     * `GLUE` for an Glue Data Catalog.
+     * The type of data catalog to create: `LAMBDA` for a federated catalog, `GLUE` for an Glue Data Catalog, and `HIVE` for
+     * an external Apache Hive metastore. `FEDERATED` is a federated catalog for which Athena creates the connection and the
+     * Lambda function for you based on the parameters that you pass.
      *
      * @var DataCatalogType::*
      */
@@ -64,16 +67,73 @@ final class DataCatalog
      *   - The `GLUE` data catalog type also applies to the default `AwsDataCatalog` that already exists in your account, of
      *     which you can have only one and cannot modify.
      *
+     * - The `FEDERATED` data catalog type uses one of the following parameters, but not both. Use `connection-arn` for an
+     *   existing Glue connection. Use `connection-type` and `connection-properties` to specify the configuration setting
+     *   for a new connection.
+     *
+     *   - `connection-arn:*<glue_connection_arn_to_reuse>*`
+     *   - `connection-type:MYSQL|REDSHIFT|...., connection-properties:"*<json_string>*"`
+     *
+     *     For *`<json_string>`*, use escaped JSON text, as in the following example.
+     *
+     *     `"{\"spill_bucket\":\"my_spill\",\"spill_prefix\":\"athena-spill\",\"host\":\"abc12345.snowflakecomputing.com\",\"port\":\"1234\",\"warehouse\":\"DEV_WH\",\"database\":\"TEST\",\"schema\":\"PUBLIC\",\"SecretArn\":\"arn:aws:secretsmanager:ap-south-1:111122223333:secret:snowflake-XHb67j\"}"`
+     *
      * @var array<string, string>|null
      */
     private $parameters;
 
+    /**
+     * The status of the creation or deletion of the data catalog.
+     *
+     * - The `LAMBDA`, `GLUE`, and `HIVE` data catalog types are created synchronously. Their status is either
+     *   `CREATE_COMPLETE` or `CREATE_FAILED`.
+     * - The `FEDERATED` data catalog type is created asynchronously.
+     *
+     * Data catalog creation status:
+     *
+     * - `CREATE_IN_PROGRESS`: Federated data catalog creation in progress.
+     * - `CREATE_COMPLETE`: Data catalog creation complete.
+     * - `CREATE_FAILED`: Data catalog could not be created.
+     * - `CREATE_FAILED_CLEANUP_IN_PROGRESS`: Federated data catalog creation failed and is being removed.
+     * - `CREATE_FAILED_CLEANUP_COMPLETE`: Federated data catalog creation failed and was removed.
+     * - `CREATE_FAILED_CLEANUP_FAILED`: Federated data catalog creation failed but could not be removed.
+     *
+     * Data catalog deletion status:
+     *
+     * - `DELETE_IN_PROGRESS`: Federated data catalog deletion in progress.
+     * - `DELETE_COMPLETE`: Federated data catalog deleted.
+     * - `DELETE_FAILED`: Federated data catalog could not be deleted.
+     *
+     * @var DataCatalogStatus::*|null
+     */
+    private $status;
+
+    /**
+     * The type of connection for a `FEDERATED` data catalog (for example, `REDSHIFT`, `MYSQL`, or `SQLSERVER`). For
+     * information about individual connectors, see Available data source connectors [^1].
+     *
+     * [^1]: https://docs.aws.amazon.com/athena/latest/ug/connectors-available.html
+     *
+     * @var ConnectionType::*|null
+     */
+    private $connectionType;
+
+    /**
+     * Text of the error that occurred during data catalog creation or deletion.
+     *
+     * @var string|null
+     */
+    private $error;
+
     /**
      * @param array{
      *   Name: string,
      *   Description?: null|string,
      *   Type: DataCatalogType::*,
      *   Parameters?: null|array<string, string>,
+     *   Status?: null|DataCatalogStatus::*,
+     *   ConnectionType?: null|ConnectionType::*,
+     *   Error?: null|string,
      * } $input
      */
     public function __construct(array $input)
@@ -82,6 +142,9 @@ public function __construct(array $input)
         $this->description = $input['Description'] ?? null;
         $this->type = $input['Type'] ?? $this->throwException(new InvalidArgument('Missing required field "Type".'));
         $this->parameters = $input['Parameters'] ?? null;
+        $this->status = $input['Status'] ?? null;
+        $this->connectionType = $input['ConnectionType'] ?? null;
+        $this->error = $input['Error'] ?? null;
     }
 
     /**
@@ -90,18 +153,34 @@ public function __construct(array $input)
      *   Description?: null|string,
      *   Type: DataCatalogType::*,
      *   Parameters?: null|array<string, string>,
+     *   Status?: null|DataCatalogStatus::*,
+     *   ConnectionType?: null|ConnectionType::*,
+     *   Error?: null|string,
      * }|DataCatalog $input
      */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
     }
 
+    /**
+     * @return ConnectionType::*|null
+     */
+    public function getConnectionType(): ?string
+    {
+        return $this->connectionType;
+    }
+
     public function getDescription(): ?string
     {
         return $this->description;
     }
 
+    public function getError(): ?string
+    {
+        return $this->error;
+    }
+
     public function getName(): string
     {
         return $this->name;
@@ -115,6 +194,14 @@ public function getParameters(): array
         return $this->parameters ?? [];
     }
 
+    /**
+     * @return DataCatalogStatus::*|null
+     */
+    public function getStatus(): ?string
+    {
+        return $this->status;
+    }
+
     /**
      * @return DataCatalogType::*
      */

Original file line number	Diff line number	Diff line change
`@@ -29,7 +29,7 @@`
`29`	`29`	`},`
`30`	`30`	`"extra": {`
`31`	`31`	`"branch-alias": {`
`32`		`- "dev-master": "3.0-dev"`
	`32`	`+ "dev-master": "3.1-dev"`
`33`	`33`	`}`
`34`	`34`	`}`
`35`	`35`	`}`
Original file line number	Diff line number	Diff line change
`@@ -4,13 +4,15 @@`
`4`	`4`
`5`	`5`	`final class DataCatalogType`
`6`	`6`	`{`
	`7`	`+ public const FEDERATED = 'FEDERATED';`
`7`	`8`	`public const GLUE = 'GLUE';`
`8`	`9`	`public const HIVE = 'HIVE';`
`9`	`10`	`public const LAMBDA = 'LAMBDA';`
`10`	`11`
`11`	`12`	`public static function exists(string $value): bool`
`12`	`13`	`{`
`13`	`14`	`return isset([`
	`15`	`+ self::FEDERATED => true,`
`14`	`16`	`self::GLUE => true,`
`15`	`17`	`self::HIVE => true,`
`16`	`18`	`self::LAMBDA => true,`
Original file line number	Diff line number	Diff line change
`@@ -36,6 +36,9 @@ private function populateResultDataCatalog(array $json): DataCatalog`
`36`	`36`	`'Description' => isset($json['Description']) ? (string) $json['Description'] : null,`
`37`	`37`	`'Type' => (string) $json['Type'],`
`38`	`38`	`'Parameters' => !isset($json['Parameters']) ? null : $this->populateResultParametersMap($json['Parameters']),`
	`39`	`+ 'Status' => isset($json['Status']) ? (string) $json['Status'] : null,`
	`40`	`+ 'ConnectionType' => isset($json['ConnectionType']) ? (string) $json['ConnectionType'] : null,`
	`41`	`+ 'Error' => isset($json['Error']) ? (string) $json['Error'] : null,`
`39`	`42`	`]);`
`40`	`43`	`}`
`41`	`44`