S3 Tables now supports getting details about a table via its table ARN.

Author: aws-sdk-dotnet-automation

generator/ServiceModels/s3tables/s3tables-2018-05-10.api.json

@@ -198,7 +198,7 @@
       "name":"GetTable",
       "http":{
         "method":"GET",
-        "requestUri":"/tables/{tableBucketARN}/{namespace}/{name}",
+        "requestUri":"/get-table",
         "responseCode":200
       },
       "input":{"shape":"GetTableRequest"},
@@ -1112,26 +1112,26 @@
     },
     "GetTableRequest":{
       "type":"structure",
-      "required":[
-        "tableBucketARN",
-        "namespace",
-        "name"
-      ],
       "members":{
         "tableBucketARN":{
           "shape":"TableBucketARN",
-          "location":"uri",
+          "location":"querystring",
           "locationName":"tableBucketARN"
         },
         "namespace":{
           "shape":"NamespaceName",
-          "location":"uri",
+          "location":"querystring",
           "locationName":"namespace"
         },
         "name":{
           "shape":"TableName",
-          "location":"uri",
+          "location":"querystring",
           "locationName":"name"
+        },
+        "tableArn":{
+          "shape":"TableARN",
+          "location":"querystring",
+          "locationName":"tableArn"
         }
       }
     },

generator/ServiceModels/s3tables/s3tables-2018-05-10.docs.json

@@ -3,7 +3,7 @@
   "service": "<p>An Amazon S3 table represents a structured dataset consisting of tabular data in <a href=\"https://parquet.apache.org/docs/\">Apache Parquet</a> format and related metadata. This data is stored inside an S3 table as a subresource. All tables in a table bucket are stored in the <a href=\"https://iceberg.apache.org/docs/latest/\">Apache Iceberg</a> table format. Through integration with the <a href=\"https://docs.aws.amazon.com/https:/docs.aws.amazon.com/glue/latest/dg/catalog-and-crawler.html\">Amazon Web Services Glue Data Catalog</a> you can interact with your tables using Amazon Web Services analytics services, such as <a href=\"https://docs.aws.amazon.com/https:/docs.aws.amazon.com/athena/\">Amazon Athena</a> and <a href=\"https://docs.aws.amazon.com/https:/docs.aws.amazon.com/redshift/\">Amazon Redshift</a>. Amazon S3 manages maintenance of your tables through automatic file compaction and snapshot management. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets.html\">Amazon S3 table buckets</a>.</p>",
   "operations": {
     "CreateNamespace": "<p>Creates a namespace. A namespace is a logical grouping of tables within your table bucket, which you can use to organize tables. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace-create.html\">Create a namespace</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3tables:CreateNamespace</code> permission to use this operation. </p> </dd> </dl>",
-    "CreateTable": "<p>Creates a new table associated with the given namespace in a table bucket. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-create.html\">Creating an Amazon S3 table</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <ul> <li> <p>You must have the <code>s3tables:CreateTable</code> permission to use this operation. </p> </li> <li> <p>If you use this operation with the optional <code>metadata</code> request parameter you must have the <code>s3tables:PutTableData</code> permission. </p> </li> <li> <p>If you use this operation with the optional <code>encryptionConfiguration</code> request parameter you must have the <code>s3tables:PutTableEncryption</code> permission. </p> </li> </ul> <note> <p>Additionally, </p> </note> </dd> </dl>",
+    "CreateTable": "<p>Creates a new table associated with the given namespace in a table bucket. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-create.html\">Creating an Amazon S3 table</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <ul> <li> <p>You must have the <code>s3tables:CreateTable</code> permission to use this operation. </p> </li> <li> <p>If you use this operation with the optional <code>metadata</code> request parameter you must have the <code>s3tables:PutTableData</code> permission. </p> </li> <li> <p>If you use this operation with the optional <code>encryptionConfiguration</code> request parameter you must have the <code>s3tables:PutTableEncryption</code> permission. </p> </li> </ul> <note> <p>Additionally, If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-kms-permissions.html\">Permissions requirements for S3 Tables SSE-KMS encryption</a>. </p> </note> </dd> </dl>",
     "CreateTableBucket": "<p>Creates a table bucket. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets-create.html\">Creating a table bucket</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <ul> <li> <p>You must have the <code>s3tables:CreateTableBucket</code> permission to use this operation. </p> </li> <li> <p>If you use this operation with the optional <code>encryptionConfiguration</code> parameter you must have the <code>s3tables:PutTableBucketEncryption</code> permission.</p> </li> </ul> </dd> </dl>",
     "DeleteNamespace": "<p>Deletes a namespace. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace-delete.html\">Delete a namespace</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3tables:DeleteNamespace</code> permission to use this operation. </p> </dd> </dl>",
     "DeleteTable": "<p>Deletes a table. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-delete.html\">Deleting an Amazon S3 table</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3tables:DeleteTable</code> permission to use this operation. </p> </dd> </dl>",
@@ -25,7 +25,7 @@
     "ListNamespaces": "<p>Lists the namespaces within a table bucket. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace.html\">Table namespaces</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3tables:ListNamespaces</code> permission to use this operation. </p> </dd> </dl>",
     "ListTableBuckets": "<p>Lists table buckets for your account. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets.html\">S3 Table buckets</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3tables:ListTableBuckets</code> permission to use this operation. </p> </dd> </dl>",
     "ListTables": "<p>List tables in the given table bucket. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-tables.html\">S3 Tables</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3tables:ListTables</code> permission to use this operation. </p> </dd> </dl>",
-    "PutTableBucketEncryption": "<p>Sets the encryption configuration for a table bucket.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3tables:PutTableBucketEncryption</code> permission to use this operation.</p> <note> <p>If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see <a href=\"AmazonS3/latest/userguide/s3-tables-kms-permissions.html\">Permissions requirements for S3 Tables SSE-KMS encryption</a> </p> </note> </dd> </dl>",
+    "PutTableBucketEncryption": "<p>Sets the encryption configuration for a table bucket.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3tables:PutTableBucketEncryption</code> permission to use this operation.</p> <note> <p>If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-kms-permissions.html\">Permissions requirements for S3 Tables SSE-KMS encryption</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> </note> </dd> </dl>",
     "PutTableBucketMaintenanceConfiguration": "<p>Creates a new maintenance configuration or replaces an existing maintenance configuration for a table bucket. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-table-buckets-maintenance.html\">Amazon S3 table bucket maintenance</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3tables:PutTableBucketMaintenanceConfiguration</code> permission to use this operation. </p> </dd> </dl>",
     "PutTableBucketPolicy": "<p>Creates a new maintenance configuration or replaces an existing table bucket policy for a table bucket. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-bucket-policy.html#table-bucket-policy-add\">Adding a table bucket policy</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3tables:PutTableBucketPolicy</code> permission to use this operation. </p> </dd> </dl>",
     "PutTableMaintenanceConfiguration": "<p>Creates a new maintenance configuration or replaces an existing maintenance configuration for a table. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-maintenance.html\">S3 Tables maintenance</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3tables:PutTableMaintenanceConfiguration</code> permission to use this operation. </p> </dd> </dl>",
@@ -432,7 +432,7 @@
         "GetNamespaceRequest$namespace": "<p>The name of the namespace.</p>",
         "GetTableEncryptionRequest$namespace": "<p>The namespace associated with the table.</p>",
         "GetTableMaintenanceConfigurationRequest$namespace": "<p>The namespace associated with the table.</p>",
-        "GetTableMaintenanceJobStatusRequest$namespace": "<p>The name of the namespace the table is associated with. <pre><code>&lt;/p&gt; </code></pre>",
+        "GetTableMaintenanceJobStatusRequest$namespace": "<p>The name of the namespace the table is associated with. </p>",
         "GetTableMetadataLocationRequest$namespace": "<p>The namespace of the table.</p>",
         "GetTablePolicyRequest$namespace": "<p>The namespace associated with the table.</p>",
         "GetTableRequest$namespace": "<p>The name of the namespace the table is associated with.</p>",
@@ -576,6 +576,7 @@
         "CreateTableResponse$tableARN": "<p>The Amazon Resource Name (ARN) of the table.</p>",
         "GetTableMaintenanceConfigurationResponse$tableARN": "<p>The Amazon Resource Name (ARN) of the table.</p>",
         "GetTableMaintenanceJobStatusResponse$tableARN": "<p>The Amazon Resource Name (ARN) of the table.</p>",
+        "GetTableRequest$tableArn": "<p>The Amazon Resource Name (ARN) of the table.</p>",
         "GetTableResponse$tableARN": "<p>The Amazon Resource Name (ARN) of the table.</p>",
         "TableSummary$tableARN": "<p>The Amazon Resource Name (ARN) of the table.</p>",
         "UpdateTableMetadataLocationResponse$tableARN": "<p>The Amazon Resource Name (ARN) of the table.</p>"

generator/ServiceModels/s3tables/s3tables-2018-05-10.normal.json

@@ -49,7 +49,7 @@
         {"shape":"ConflictException"},
         {"shape":"BadRequestException"}
       ],
-      "documentation":"<p>Creates a new table associated with the given namespace in a table bucket. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-create.html\">Creating an Amazon S3 table</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <ul> <li> <p>You must have the <code>s3tables:CreateTable</code> permission to use this operation. </p> </li> <li> <p>If you use this operation with the optional <code>metadata</code> request parameter you must have the <code>s3tables:PutTableData</code> permission. </p> </li> <li> <p>If you use this operation with the optional <code>encryptionConfiguration</code> request parameter you must have the <code>s3tables:PutTableEncryption</code> permission. </p> </li> </ul> <note> <p>Additionally, </p> </note> </dd> </dl>"
+      "documentation":"<p>Creates a new table associated with the given namespace in a table bucket. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-create.html\">Creating an Amazon S3 table</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <ul> <li> <p>You must have the <code>s3tables:CreateTable</code> permission to use this operation. </p> </li> <li> <p>If you use this operation with the optional <code>metadata</code> request parameter you must have the <code>s3tables:PutTableData</code> permission. </p> </li> <li> <p>If you use this operation with the optional <code>encryptionConfiguration</code> request parameter you must have the <code>s3tables:PutTableEncryption</code> permission. </p> </li> </ul> <note> <p>Additionally, If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-kms-permissions.html\">Permissions requirements for S3 Tables SSE-KMS encryption</a>. </p> </note> </dd> </dl>"
     },
     "CreateTableBucket":{
       "name":"CreateTableBucket",
@@ -208,7 +208,7 @@
       "name":"GetTable",
       "http":{
         "method":"GET",
-        "requestUri":"/tables/{tableBucketARN}/{namespace}/{name}",
+        "requestUri":"/get-table",
         "responseCode":200
       },
       "input":{"shape":"GetTableRequest"},
@@ -471,7 +471,7 @@
         {"shape":"ConflictException"},
         {"shape":"BadRequestException"}
       ],
-      "documentation":"<p>Sets the encryption configuration for a table bucket.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3tables:PutTableBucketEncryption</code> permission to use this operation.</p> <note> <p>If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see <a href=\"AmazonS3/latest/userguide/s3-tables-kms-permissions.html\">Permissions requirements for S3 Tables SSE-KMS encryption</a> </p> </note> </dd> </dl>",
+      "documentation":"<p>Sets the encryption configuration for a table bucket.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3tables:PutTableBucketEncryption</code> permission to use this operation.</p> <note> <p>If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-kms-permissions.html\">Permissions requirements for S3 Tables SSE-KMS encryption</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> </note> </dd> </dl>",
       "idempotent":true
     },
     "PutTableBucketMaintenanceConfiguration":{
@@ -1179,7 +1179,7 @@
         },
         "namespace":{
           "shape":"NamespaceName",
-          "documentation":"<p>The name of the namespace the table is associated with. <pre><code>&lt;/p&gt; </code></pre>",
+          "documentation":"<p>The name of the namespace the table is associated with. </p>",
           "location":"uri",
           "locationName":"namespace"
         },
@@ -1297,29 +1297,30 @@
     },
     "GetTableRequest":{
       "type":"structure",
-      "required":[
-        "tableBucketARN",
-        "namespace",
-        "name"
-      ],
       "members":{
         "tableBucketARN":{
           "shape":"TableBucketARN",
           "documentation":"<p>The Amazon Resource Name (ARN) of the table bucket associated with the table.</p>",
-          "location":"uri",
+          "location":"querystring",
           "locationName":"tableBucketARN"
         },
         "namespace":{
           "shape":"NamespaceName",
           "documentation":"<p>The name of the namespace the table is associated with.</p>",
-          "location":"uri",
+          "location":"querystring",
           "locationName":"namespace"
         },
         "name":{
           "shape":"TableName",
           "documentation":"<p>The name of the table.</p>",
-          "location":"uri",
+          "location":"querystring",
           "locationName":"name"
+        },
+        "tableArn":{
+          "shape":"TableARN",
+          "documentation":"<p>The Amazon Resource Name (ARN) of the table.</p>",
+          "location":"querystring",
+          "locationName":"tableArn"
         }
       }
     },

generator/ServiceModels/s3tables/s3tables-2018-05-10.smoke2.json

@@ -1,12 +1,10 @@
 {
   "version" : 2,
   "testCases" : [ {
-    "id" : "GetTable_AccessDeniedException",
-    "operationName" : "GetTable",
+    "id" : "ListNamespaces_AccessDeniedException",
+    "operationName" : "ListNamespaces",
     "input" : {
-      "tableBucketARN" : "arn:aws:s3tables:us-east-1:123456789012:bucket/does-not-exist",
-      "namespace" : "doesnotexist",
-      "name" : "doesnotexist"
+      "tableBucketARN" : "arn:aws:s3tables:us-east-1:123456789012:bucket/does-not-exist"
     },
     "expectation" : {
       "failure" : {
@@ -20,8 +18,8 @@
       "useAccountIdRouting" : true
     }
   }, {
-    "id" : "ListTables_AccessDeniedException",
-    "operationName" : "ListTables",
+    "id" : "GetTableBucket_AccessDeniedException",
+    "operationName" : "GetTableBucket",
     "input" : {
       "tableBucketARN" : "arn:aws:s3tables:us-east-1:123456789012:bucket/does-not-exist"
     },
@@ -55,8 +53,8 @@
       "useAccountIdRouting" : true
     }
   }, {
-    "id" : "GetTableBucket_AccessDeniedException",
-    "operationName" : "GetTableBucket",
+    "id" : "ListTables_AccessDeniedException",
+    "operationName" : "ListTables",
     "input" : {
       "tableBucketARN" : "arn:aws:s3tables:us-east-1:123456789012:bucket/does-not-exist"
     },
@@ -72,11 +70,17 @@
       "useAccountIdRouting" : true
     }
   }, {
-    "id" : "ListTableBuckets_Success",
-    "operationName" : "ListTableBuckets",
-    "input" : { },
+    "id" : "GetTable_AccessDeniedException",
+    "operationName" : "GetTable",
+    "input" : {
+      "tableBucketARN" : "arn:aws:s3tables:us-east-1:123456789012:bucket/does-not-exist",
+      "namespace" : "doesnotexist",
+      "name" : "doesnotexist"
+    },
     "expectation" : {
-      "success" : { }
+      "failure" : {
+        "errorId" : "AccessDeniedException"
+      }
     },
     "config" : {
       "region" : "us-east-1",
@@ -85,10 +89,10 @@
       "useAccountIdRouting" : true
     }
   }, {
-    "id" : "ListNamespaces_AccessDeniedException",
-    "operationName" : "ListNamespaces",
+    "id" : "GetTableArn_AccessDeniedException",
+    "operationName" : "GetTable",
     "input" : {
-      "tableBucketARN" : "arn:aws:s3tables:us-east-1:123456789012:bucket/does-not-exist"
+      "tableArn" : "arn:aws:s3tables:us-east-1:123456789012:bucket/does-not-exist/table/f577d6ca-c1dd-4686-9f41-62130a40e91b"
     },
     "expectation" : {
       "failure" : {
@@ -101,5 +105,18 @@
       "useDualstack" : false,
       "useAccountIdRouting" : true
     }
+  }, {
+    "id" : "ListTableBuckets_Success",
+    "operationName" : "ListTableBuckets",
+    "input" : { },
+    "expectation" : {
+      "success" : { }
+    },
+    "config" : {
+      "region" : "us-east-1",
+      "useFips" : false,
+      "useDualstack" : false,
+      "useAccountIdRouting" : true
+    }
   } ]
 }