@googleapis/biglake 4.1.1 → 5.0.0

package/build/v1.d.ts

@@ -55,9 +55,9 @@ export declare namespace biglake_v1 {
         upload_protocol?: string;
     }
     /**
-     * BigLake API
+     * Lakehouse API
      *
-     * The BigLake API provides access to BigLake Metastore, a serverless, fully managed, and highly available metastore for open-source data that can be used for querying Apache Iceberg tables in BigQuery.
+     * The Lakehouse API (formerly BigLake API) provides access to a serverless, fully managed, and highly available metastore that provides a single source of truth for your data lakehouse. It lets multiple engines—including Apache Spark, Google Managed Spark, Apache Flink, Trino and BigQuery—share tables and metadata for key open formats (Apache Iceberg, Apache Hive), and query the same copy of data. Plus, through the Lakehouse runtime catalog federation seamlessly unite your lakehouse ecosystem, letting Iceberg compatible engines on Google Cloud (BigQuery, Google Managed Spark) discover and analyze enterprise data across Snowflake, Databricks, and AWS Glue.
      *
      * @example
      * ```js
@@ -375,6 +375,24 @@ export declare namespace biglake_v1 {
          */
         updateTime?: string | null;
     }
+    /**
+     * Request message for `TestIamPermissions` method.
+     */
+    export interface Schema$TestIamPermissionsRequest {
+        /**
+         * The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+         */
+        permissions?: string[] | null;
+    }
+    /**
+     * Response message for `TestIamPermissions` method.
+     */
+    export interface Schema$TestIamPermissionsResponse {
+        /**
+         * A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
+         */
+        permissions?: string[] | null;
+    }
     export class Resource$Projects {
         context: APIRequestContext;
         catalogs: Resource$Projects$Catalogs;
@@ -528,6 +546,77 @@ export declare namespace biglake_v1 {
         setIamPolicy(params: Params$Resource$Projects$Catalogs$Setiampolicy, options: MethodOptions | BodyResponseCallback<Schema$Policy>, callback: BodyResponseCallback<Schema$Policy>): void;
         setIamPolicy(params: Params$Resource$Projects$Catalogs$Setiampolicy, callback: BodyResponseCallback<Schema$Policy>): void;
         setIamPolicy(callback: BodyResponseCallback<Schema$Policy>): void;
+        /**
+         * Tests the IAM permissions for the specified catalog.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/biglake.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const biglake = google.biglake('v1');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/bigquery',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await biglake.projects.catalogs.testIamPermissions({
+         *     // REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
+         *     resource: 'projects/my-project/catalogs/my-catalog',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "permissions": []
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "permissions": []
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        testIamPermissions(params: Params$Resource$Projects$Catalogs$Testiampermissions, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        testIamPermissions(params?: Params$Resource$Projects$Catalogs$Testiampermissions, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$TestIamPermissionsResponse>>;
+        testIamPermissions(params: Params$Resource$Projects$Catalogs$Testiampermissions, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        testIamPermissions(params: Params$Resource$Projects$Catalogs$Testiampermissions, options: MethodOptions | BodyResponseCallback<Schema$TestIamPermissionsResponse>, callback: BodyResponseCallback<Schema$TestIamPermissionsResponse>): void;
+        testIamPermissions(params: Params$Resource$Projects$Catalogs$Testiampermissions, callback: BodyResponseCallback<Schema$TestIamPermissionsResponse>): void;
+        testIamPermissions(callback: BodyResponseCallback<Schema$TestIamPermissionsResponse>): void;
     }
     export interface Params$Resource$Projects$Catalogs$Getiampolicy extends StandardParameters {
         /**
@@ -549,8 +638,19 @@ export declare namespace biglake_v1 {
          */
         requestBody?: Schema$SetIamPolicyRequest;
     }
+    export interface Params$Resource$Projects$Catalogs$Testiampermissions extends StandardParameters {
+        /**
+         * REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
+         */
+        resource?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$TestIamPermissionsRequest;
+    }
     export class Resource$Projects$Catalogs$Namespaces {
         context: APIRequestContext;
+        tables: Resource$Projects$Catalogs$Namespaces$Tables;
         constructor(context: APIRequestContext);
         /**
          * Gets the IAM policy for the specified Catalog.
@@ -695,6 +795,77 @@ export declare namespace biglake_v1 {
         setIamPolicy(params: Params$Resource$Projects$Catalogs$Namespaces$Setiampolicy, options: MethodOptions | BodyResponseCallback<Schema$Policy>, callback: BodyResponseCallback<Schema$Policy>): void;
         setIamPolicy(params: Params$Resource$Projects$Catalogs$Namespaces$Setiampolicy, callback: BodyResponseCallback<Schema$Policy>): void;
         setIamPolicy(callback: BodyResponseCallback<Schema$Policy>): void;
+        /**
+         * Tests the IAM permissions for the specified namespace.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/biglake.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const biglake = google.biglake('v1');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/bigquery',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await biglake.projects.catalogs.namespaces.testIamPermissions({
+         *     // REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
+         *     resource: 'projects/my-project/catalogs/my-catalog/namespaces/my-namespace',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "permissions": []
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "permissions": []
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        testIamPermissions(params: Params$Resource$Projects$Catalogs$Namespaces$Testiampermissions, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        testIamPermissions(params?: Params$Resource$Projects$Catalogs$Namespaces$Testiampermissions, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$TestIamPermissionsResponse>>;
+        testIamPermissions(params: Params$Resource$Projects$Catalogs$Namespaces$Testiampermissions, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        testIamPermissions(params: Params$Resource$Projects$Catalogs$Namespaces$Testiampermissions, options: MethodOptions | BodyResponseCallback<Schema$TestIamPermissionsResponse>, callback: BodyResponseCallback<Schema$TestIamPermissionsResponse>): void;
+        testIamPermissions(params: Params$Resource$Projects$Catalogs$Namespaces$Testiampermissions, callback: BodyResponseCallback<Schema$TestIamPermissionsResponse>): void;
+        testIamPermissions(callback: BodyResponseCallback<Schema$TestIamPermissionsResponse>): void;
     }
     export interface Params$Resource$Projects$Catalogs$Namespaces$Getiampolicy extends StandardParameters {
         /**
@@ -716,6 +887,268 @@ export declare namespace biglake_v1 {
          */
         requestBody?: Schema$SetIamPolicyRequest;
     }
+    export interface Params$Resource$Projects$Catalogs$Namespaces$Testiampermissions extends StandardParameters {
+        /**
+         * REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
+         */
+        resource?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$TestIamPermissionsRequest;
+    }
+    export class Resource$Projects$Catalogs$Namespaces$Tables {
+        context: APIRequestContext;
+        constructor(context: APIRequestContext);
+        /**
+         * Gets the IAM policy for the specified Catalog.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/biglake.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const biglake = google.biglake('v1');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/bigquery',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await biglake.projects.catalogs.namespaces.tables.getIamPolicy({
+         *     // Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+         *     'options.requestedPolicyVersion': 'placeholder-value',
+         *     // REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
+         *     resource:
+         *       'projects/my-project/catalogs/my-catalog/namespaces/my-namespace/tables/my-table',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "auditConfigs": [],
+         *   //   "bindings": [],
+         *   //   "etag": "my_etag",
+         *   //   "version": 0
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        getIamPolicy(params: Params$Resource$Projects$Catalogs$Namespaces$Tables$Getiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        getIamPolicy(params?: Params$Resource$Projects$Catalogs$Namespaces$Tables$Getiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Policy>>;
+        getIamPolicy(params: Params$Resource$Projects$Catalogs$Namespaces$Tables$Getiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        getIamPolicy(params: Params$Resource$Projects$Catalogs$Namespaces$Tables$Getiampolicy, options: MethodOptions | BodyResponseCallback<Schema$Policy>, callback: BodyResponseCallback<Schema$Policy>): void;
+        getIamPolicy(params: Params$Resource$Projects$Catalogs$Namespaces$Tables$Getiampolicy, callback: BodyResponseCallback<Schema$Policy>): void;
+        getIamPolicy(callback: BodyResponseCallback<Schema$Policy>): void;
+        /**
+         * Sets the IAM policy for the specified catalog.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/biglake.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const biglake = google.biglake('v1');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/bigquery',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await biglake.projects.catalogs.namespaces.tables.setIamPolicy({
+         *     // REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
+         *     resource:
+         *       'projects/my-project/catalogs/my-catalog/namespaces/my-namespace/tables/my-table',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "policy": {},
+         *       //   "updateMask": "my_updateMask"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "auditConfigs": [],
+         *   //   "bindings": [],
+         *   //   "etag": "my_etag",
+         *   //   "version": 0
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        setIamPolicy(params: Params$Resource$Projects$Catalogs$Namespaces$Tables$Setiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        setIamPolicy(params?: Params$Resource$Projects$Catalogs$Namespaces$Tables$Setiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Policy>>;
+        setIamPolicy(params: Params$Resource$Projects$Catalogs$Namespaces$Tables$Setiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        setIamPolicy(params: Params$Resource$Projects$Catalogs$Namespaces$Tables$Setiampolicy, options: MethodOptions | BodyResponseCallback<Schema$Policy>, callback: BodyResponseCallback<Schema$Policy>): void;
+        setIamPolicy(params: Params$Resource$Projects$Catalogs$Namespaces$Tables$Setiampolicy, callback: BodyResponseCallback<Schema$Policy>): void;
+        setIamPolicy(callback: BodyResponseCallback<Schema$Policy>): void;
+        /**
+         * Tests the IAM permissions for the specified table.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/biglake.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const biglake = google.biglake('v1');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/bigquery',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res =
+         *     await biglake.projects.catalogs.namespaces.tables.testIamPermissions({
+         *       // REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
+         *       resource:
+         *         'projects/my-project/catalogs/my-catalog/namespaces/my-namespace/tables/my-table',
+         *
+         *       // Request body metadata
+         *       requestBody: {
+         *         // request body parameters
+         *         // {
+         *         //   "permissions": []
+         *         // }
+         *       },
+         *     });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "permissions": []
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        testIamPermissions(params: Params$Resource$Projects$Catalogs$Namespaces$Tables$Testiampermissions, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        testIamPermissions(params?: Params$Resource$Projects$Catalogs$Namespaces$Tables$Testiampermissions, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$TestIamPermissionsResponse>>;
+        testIamPermissions(params: Params$Resource$Projects$Catalogs$Namespaces$Tables$Testiampermissions, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        testIamPermissions(params: Params$Resource$Projects$Catalogs$Namespaces$Tables$Testiampermissions, options: MethodOptions | BodyResponseCallback<Schema$TestIamPermissionsResponse>, callback: BodyResponseCallback<Schema$TestIamPermissionsResponse>): void;
+        testIamPermissions(params: Params$Resource$Projects$Catalogs$Namespaces$Tables$Testiampermissions, callback: BodyResponseCallback<Schema$TestIamPermissionsResponse>): void;
+        testIamPermissions(callback: BodyResponseCallback<Schema$TestIamPermissionsResponse>): void;
+    }
+    export interface Params$Resource$Projects$Catalogs$Namespaces$Tables$Getiampolicy extends StandardParameters {
+        /**
+         * Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+         */
+        'options.requestedPolicyVersion'?: number;
+        /**
+         * REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
+         */
+        resource?: string;
+    }
+    export interface Params$Resource$Projects$Catalogs$Namespaces$Tables$Setiampolicy extends StandardParameters {
+        /**
+         * REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
+         */
+        resource?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$SetIamPolicyRequest;
+    }
+    export interface Params$Resource$Projects$Catalogs$Namespaces$Tables$Testiampermissions extends StandardParameters {
+        /**
+         * REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
+         */
+        resource?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$TestIamPermissionsRequest;
+    }
     export class Resource$Projects$Locations {
         context: APIRequestContext;
         catalogs: Resource$Projects$Locations$Catalogs;