@google-cloud/storage-control 0.5.0 → 0.6.0

package/build/src/v2/gapic_metadata.json

@@ -95,6 +95,21 @@
                                 "updateOrganizationIntelligenceConfig"
                             ]
                         },
+                        "GetIamPolicy": {
+                            "methods": [
+                                "getIamPolicy"
+                            ]
+                        },
+                        "SetIamPolicy": {
+                            "methods": [
+                                "setIamPolicy"
+                            ]
+                        },
+                        "TestIamPermissions": {
+                            "methods": [
+                                "testIamPermissions"
+                            ]
+                        },
                         "RenameFolder": {
                             "methods": [
                                 "renameFolder"
@@ -221,6 +236,21 @@
                                 "updateOrganizationIntelligenceConfig"
                             ]
                         },
+                        "GetIamPolicy": {
+                            "methods": [
+                                "getIamPolicy"
+                            ]
+                        },
+                        "SetIamPolicy": {
+                            "methods": [
+                                "setIamPolicy"
+                            ]
+                        },
+                        "TestIamPermissions": {
+                            "methods": [
+                                "testIamPermissions"
+                            ]
+                        },
                         "RenameFolder": {
                             "methods": [
                                 "renameFolder"

package/build/src/v2/storage_control_client.d.ts

@@ -645,6 +645,111 @@ export declare class StorageControlClient {
     ]>;
     updateOrganizationIntelligenceConfig(request: protos.google.storage.control.v2.IUpdateOrganizationIntelligenceConfigRequest, options: CallOptions, callback: Callback<protos.google.storage.control.v2.IIntelligenceConfig, protos.google.storage.control.v2.IUpdateOrganizationIntelligenceConfigRequest | null | undefined, {} | null | undefined>): void;
     updateOrganizationIntelligenceConfig(request: protos.google.storage.control.v2.IUpdateOrganizationIntelligenceConfigRequest, callback: Callback<protos.google.storage.control.v2.IIntelligenceConfig, protos.google.storage.control.v2.IUpdateOrganizationIntelligenceConfigRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * Gets the IAM policy for a specified bucket.
+     * The `resource` field in the request should be
+     * `projects/_/buckets/{bucket}` for a bucket, or
+     * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
+     * for a managed folder.
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.resource
+     *   REQUIRED: The resource for which the policy is being requested.
+     *   See the operation documentation for the appropriate value for this field.
+     * @param {google.iam.v1.GetPolicyOptions} request.options
+     *   OPTIONAL: A `GetPolicyOptions` object for specifying options to
+     *   `GetIamPolicy`.
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Promise} - The promise which resolves to an array.
+     *   The first element of the array is an object representing {@link protos.google.iam.v1.Policy|Policy}.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
+     *   for more details and examples.
+     * @example <caption>include:samples/generated/v2/storage_control.get_iam_policy.js</caption>
+     * region_tag:storage_v2_generated_StorageControl_GetIamPolicy_async
+     */
+    getIamPolicy(request?: protos.google.iam.v1.IGetIamPolicyRequest, options?: CallOptions): Promise<[
+        protos.google.iam.v1.IPolicy,
+        protos.google.iam.v1.IGetIamPolicyRequest | undefined,
+        {} | undefined
+    ]>;
+    getIamPolicy(request: protos.google.iam.v1.IGetIamPolicyRequest, options: CallOptions, callback: Callback<protos.google.iam.v1.IPolicy, protos.google.iam.v1.IGetIamPolicyRequest | null | undefined, {} | null | undefined>): void;
+    getIamPolicy(request: protos.google.iam.v1.IGetIamPolicyRequest, callback: Callback<protos.google.iam.v1.IPolicy, protos.google.iam.v1.IGetIamPolicyRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * Updates an IAM policy for the specified bucket.
+     * The `resource` field in the request should be
+     * `projects/_/buckets/{bucket}` for a bucket, or
+     * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
+     * for a managed folder.
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.resource
+     *   REQUIRED: The resource for which the policy is being specified.
+     *   See the operation documentation for the appropriate value for this field.
+     * @param {google.iam.v1.Policy} request.policy
+     *   REQUIRED: The complete policy to be applied to the `resource`. The size of
+     *   the policy is limited to a few 10s of KB. An empty policy is a
+     *   valid policy but certain Cloud Platform services (such as Projects)
+     *   might reject them.
+     * @param {google.protobuf.FieldMask} request.updateMask
+     *   OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
+     *   the fields in the mask will be modified. If no mask is provided, the
+     *   following default mask is used:
+     *
+     *   `paths: "bindings, etag"`
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Promise} - The promise which resolves to an array.
+     *   The first element of the array is an object representing {@link protos.google.iam.v1.Policy|Policy}.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
+     *   for more details and examples.
+     * @example <caption>include:samples/generated/v2/storage_control.set_iam_policy.js</caption>
+     * region_tag:storage_v2_generated_StorageControl_SetIamPolicy_async
+     */
+    setIamPolicy(request?: protos.google.iam.v1.ISetIamPolicyRequest, options?: CallOptions): Promise<[
+        protos.google.iam.v1.IPolicy,
+        protos.google.iam.v1.ISetIamPolicyRequest | undefined,
+        {} | undefined
+    ]>;
+    setIamPolicy(request: protos.google.iam.v1.ISetIamPolicyRequest, options: CallOptions, callback: Callback<protos.google.iam.v1.IPolicy, protos.google.iam.v1.ISetIamPolicyRequest | null | undefined, {} | null | undefined>): void;
+    setIamPolicy(request: protos.google.iam.v1.ISetIamPolicyRequest, callback: Callback<protos.google.iam.v1.IPolicy, protos.google.iam.v1.ISetIamPolicyRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * Tests a set of permissions on the given bucket, object, or managed folder
+     * to see which, if any, are held by the caller.
+     * The `resource` field in the request should be
+     * `projects/_/buckets/{bucket}` for a bucket,
+     * `projects/_/buckets/{bucket}/objects/{object}` for an object, or
+     * `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
+     * for a managed folder.
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.resource
+     *   REQUIRED: The resource for which the policy detail is being requested.
+     *   See the operation documentation for the appropriate value for this field.
+     * @param {string[]} request.permissions
+     *   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).
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Promise} - The promise which resolves to an array.
+     *   The first element of the array is an object representing {@link protos.google.iam.v1.TestIamPermissionsResponse|TestIamPermissionsResponse}.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
+     *   for more details and examples.
+     * @example <caption>include:samples/generated/v2/storage_control.test_iam_permissions.js</caption>
+     * region_tag:storage_v2_generated_StorageControl_TestIamPermissions_async
+     */
+    testIamPermissions(request?: protos.google.iam.v1.ITestIamPermissionsRequest, options?: CallOptions): Promise<[
+        protos.google.iam.v1.ITestIamPermissionsResponse,
+        protos.google.iam.v1.ITestIamPermissionsRequest | undefined,
+        {} | undefined
+    ]>;
+    testIamPermissions(request: protos.google.iam.v1.ITestIamPermissionsRequest, options: CallOptions, callback: Callback<protos.google.iam.v1.ITestIamPermissionsResponse, protos.google.iam.v1.ITestIamPermissionsRequest | null | undefined, {} | null | undefined>): void;
+    testIamPermissions(request: protos.google.iam.v1.ITestIamPermissionsRequest, callback: Callback<protos.google.iam.v1.ITestIamPermissionsResponse, protos.google.iam.v1.ITestIamPermissionsRequest | null | undefined, {} | null | undefined>): void;
     /**
      * Renames a source folder to a destination folder. This operation is only
      * applicable to a hierarchical namespace enabled bucket. During a rename, the

package/build/src/v2/storage_control_client.js

@@ -238,7 +238,7 @@ class StorageControlClient {
             this._protos.google.storage.control.v2.StorageControl, this._opts, this._providedCustomServicePath);
         // Iterate over each of the methods that the service provides
         // and create an API call method for each.
-        const storageControlStubMethods = ['createFolder', 'deleteFolder', 'getFolder', 'listFolders', 'renameFolder', 'getStorageLayout', 'createManagedFolder', 'deleteManagedFolder', 'getManagedFolder', 'listManagedFolders', 'createAnywhereCache', 'updateAnywhereCache', 'disableAnywhereCache', 'pauseAnywhereCache', 'resumeAnywhereCache', 'getAnywhereCache', 'listAnywhereCaches', 'getProjectIntelligenceConfig', 'updateProjectIntelligenceConfig', 'getFolderIntelligenceConfig', 'updateFolderIntelligenceConfig', 'getOrganizationIntelligenceConfig', 'updateOrganizationIntelligenceConfig'];
+        const storageControlStubMethods = ['createFolder', 'deleteFolder', 'getFolder', 'listFolders', 'renameFolder', 'getStorageLayout', 'createManagedFolder', 'deleteManagedFolder', 'getManagedFolder', 'listManagedFolders', 'createAnywhereCache', 'updateAnywhereCache', 'disableAnywhereCache', 'pauseAnywhereCache', 'resumeAnywhereCache', 'getAnywhereCache', 'listAnywhereCaches', 'getProjectIntelligenceConfig', 'updateProjectIntelligenceConfig', 'getFolderIntelligenceConfig', 'updateFolderIntelligenceConfig', 'getOrganizationIntelligenceConfig', 'updateOrganizationIntelligenceConfig', 'getIamPolicy', 'setIamPolicy', 'testIamPermissions'];
         for (const methodName of storageControlStubMethods) {
             const callPromise = this.storageControlStub.then(stub => (...args) => {
                 if (this._terminated) {
@@ -1065,6 +1065,181 @@ class StorageControlClient {
             throw error;
         });
     }
+    getIamPolicy(request, optionsOrCallback, callback) {
+        request = request || {};
+        let options;
+        if (typeof optionsOrCallback === 'function' && callback === undefined) {
+            callback = optionsOrCallback;
+            options = {};
+        }
+        else {
+            options = optionsOrCallback;
+        }
+        options = options || {};
+        options.otherArgs = options.otherArgs || {};
+        options.otherArgs.headers = options.otherArgs.headers || {};
+        let routingParameter = {};
+        {
+            const fieldValue = request.resource;
+            if (fieldValue !== undefined && fieldValue !== null) {
+                const match = fieldValue.toString().match(RegExp('(?<bucket>(?:.*)?)'));
+                if (match) {
+                    const parameterValue = match.groups?.['bucket'] ?? fieldValue;
+                    Object.assign(routingParameter, { bucket: parameterValue });
+                }
+            }
+        }
+        {
+            const fieldValue = request.resource;
+            if (fieldValue !== undefined && fieldValue !== null) {
+                const match = fieldValue.toString().match(RegExp('(?<bucket>projects/[^/]+/buckets/[^/]+)(?:/.*)?'));
+                if (match) {
+                    const parameterValue = match.groups?.['bucket'] ?? fieldValue;
+                    Object.assign(routingParameter, { bucket: parameterValue });
+                }
+            }
+        }
+        options.otherArgs.headers['x-goog-request-params'] = this._gaxModule.routingHeader.fromParams(routingParameter);
+        this.initialize().catch(err => { throw err; });
+        this._log.info('getIamPolicy request %j', request);
+        const wrappedCallback = callback
+            ? (error, response, options, rawResponse) => {
+                this._log.info('getIamPolicy response %j', response);
+                callback(error, response, options, rawResponse); // We verified callback above.
+            }
+            : undefined;
+        return this.innerApiCalls.getIamPolicy(request, options, wrappedCallback)
+            ?.then(([response, options, rawResponse]) => {
+            this._log.info('getIamPolicy response %j', response);
+            return [response, options, rawResponse];
+        }).catch((error) => {
+            if (error && 'statusDetails' in error && error.statusDetails instanceof Array) {
+                const protos = this._gaxModule.protobuf.Root.fromJSON(jsonProtos);
+                error.statusDetails = (0, google_gax_1.decodeAnyProtosInArray)(error.statusDetails, protos);
+            }
+            throw error;
+        });
+    }
+    setIamPolicy(request, optionsOrCallback, callback) {
+        request = request || {};
+        let options;
+        if (typeof optionsOrCallback === 'function' && callback === undefined) {
+            callback = optionsOrCallback;
+            options = {};
+        }
+        else {
+            options = optionsOrCallback;
+        }
+        options = options || {};
+        options.otherArgs = options.otherArgs || {};
+        options.otherArgs.headers = options.otherArgs.headers || {};
+        let routingParameter = {};
+        {
+            const fieldValue = request.resource;
+            if (fieldValue !== undefined && fieldValue !== null) {
+                const match = fieldValue.toString().match(RegExp('(?<bucket>(?:.*)?)'));
+                if (match) {
+                    const parameterValue = match.groups?.['bucket'] ?? fieldValue;
+                    Object.assign(routingParameter, { bucket: parameterValue });
+                }
+            }
+        }
+        {
+            const fieldValue = request.resource;
+            if (fieldValue !== undefined && fieldValue !== null) {
+                const match = fieldValue.toString().match(RegExp('(?<bucket>projects/[^/]+/buckets/[^/]+)(?:/.*)?'));
+                if (match) {
+                    const parameterValue = match.groups?.['bucket'] ?? fieldValue;
+                    Object.assign(routingParameter, { bucket: parameterValue });
+                }
+            }
+        }
+        options.otherArgs.headers['x-goog-request-params'] = this._gaxModule.routingHeader.fromParams(routingParameter);
+        this.initialize().catch(err => { throw err; });
+        this._log.info('setIamPolicy request %j', request);
+        const wrappedCallback = callback
+            ? (error, response, options, rawResponse) => {
+                this._log.info('setIamPolicy response %j', response);
+                callback(error, response, options, rawResponse); // We verified callback above.
+            }
+            : undefined;
+        return this.innerApiCalls.setIamPolicy(request, options, wrappedCallback)
+            ?.then(([response, options, rawResponse]) => {
+            this._log.info('setIamPolicy response %j', response);
+            return [response, options, rawResponse];
+        }).catch((error) => {
+            if (error && 'statusDetails' in error && error.statusDetails instanceof Array) {
+                const protos = this._gaxModule.protobuf.Root.fromJSON(jsonProtos);
+                error.statusDetails = (0, google_gax_1.decodeAnyProtosInArray)(error.statusDetails, protos);
+            }
+            throw error;
+        });
+    }
+    testIamPermissions(request, optionsOrCallback, callback) {
+        request = request || {};
+        let options;
+        if (typeof optionsOrCallback === 'function' && callback === undefined) {
+            callback = optionsOrCallback;
+            options = {};
+        }
+        else {
+            options = optionsOrCallback;
+        }
+        options = options || {};
+        options.otherArgs = options.otherArgs || {};
+        options.otherArgs.headers = options.otherArgs.headers || {};
+        let routingParameter = {};
+        {
+            const fieldValue = request.resource;
+            if (fieldValue !== undefined && fieldValue !== null) {
+                const match = fieldValue.toString().match(RegExp('(?<bucket>(?:.*)?)'));
+                if (match) {
+                    const parameterValue = match.groups?.['bucket'] ?? fieldValue;
+                    Object.assign(routingParameter, { bucket: parameterValue });
+                }
+            }
+        }
+        {
+            const fieldValue = request.resource;
+            if (fieldValue !== undefined && fieldValue !== null) {
+                const match = fieldValue.toString().match(RegExp('(?<bucket>projects/[^/]+/buckets/[^/]+)/objects(?:/.*)?'));
+                if (match) {
+                    const parameterValue = match.groups?.['bucket'] ?? fieldValue;
+                    Object.assign(routingParameter, { bucket: parameterValue });
+                }
+            }
+        }
+        {
+            const fieldValue = request.resource;
+            if (fieldValue !== undefined && fieldValue !== null) {
+                const match = fieldValue.toString().match(RegExp('(?<bucket>projects/[^/]+/buckets/[^/]+)/managedFolders(?:/.*)?'));
+                if (match) {
+                    const parameterValue = match.groups?.['bucket'] ?? fieldValue;
+                    Object.assign(routingParameter, { bucket: parameterValue });
+                }
+            }
+        }
+        options.otherArgs.headers['x-goog-request-params'] = this._gaxModule.routingHeader.fromParams(routingParameter);
+        this.initialize().catch(err => { throw err; });
+        this._log.info('testIamPermissions request %j', request);
+        const wrappedCallback = callback
+            ? (error, response, options, rawResponse) => {
+                this._log.info('testIamPermissions response %j', response);
+                callback(error, response, options, rawResponse); // We verified callback above.
+            }
+            : undefined;
+        return this.innerApiCalls.testIamPermissions(request, options, wrappedCallback)
+            ?.then(([response, options, rawResponse]) => {
+            this._log.info('testIamPermissions response %j', response);
+            return [response, options, rawResponse];
+        }).catch((error) => {
+            if (error && 'statusDetails' in error && error.statusDetails instanceof Array) {
+                const protos = this._gaxModule.protobuf.Root.fromJSON(jsonProtos);
+                error.statusDetails = (0, google_gax_1.decodeAnyProtosInArray)(error.statusDetails, protos);
+            }
+            throw error;
+        });
+    }
     renameFolder(request, optionsOrCallback, callback) {
         request = request || {};
         if (!request.requestId) {