UNPKG

@pulumi/gcp

Version:

A Pulumi package for creating and managing Google Cloud Platform resources.

94 lines 3.63 kB
"use strict"; // *** WARNING: this file was generated by pulumi-language-nodejs. *** // *** Do not edit by hand unless you're certain you know what you are doing! *** Object.defineProperty(exports, "__esModule", { value: true }); exports.DefaultObjectACL = void 0; const pulumi = require("@pulumi/pulumi"); const utilities = require("../utilities"); /** * Authoritatively manages the default object ACLs for a Google Cloud Storage bucket * without managing the bucket itself. * * > Note that for each object, its creator will have the `"OWNER"` role in addition * to the default ACL that has been defined. * * For more information see * [the official documentation](https://cloud.google.com/storage/docs/access-control/lists) * and * [API](https://cloud.google.com/storage/docs/json_api/v1/defaultObjectAccessControls). * * > Want fine-grained control over default object ACLs? Use `gcp.storage.DefaultObjectAccessControl` * to control individual role entity pairs. * * ## Example Usage * * Example creating a default object ACL on a bucket with one owner, and one reader. * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const image_store = new gcp.storage.Bucket("image-store", { * name: "image-store-bucket", * location: "EU", * }); * const image_store_default_acl = new gcp.storage.DefaultObjectACL("image-store-default-acl", { * bucket: image_store.name, * roleEntities: [ * "OWNER:user-my.email@gmail.com", * "READER:group-mygroup", * ], * }); * ``` * * ## Import * * This resource does not support import. */ class DefaultObjectACL extends pulumi.CustomResource { /** * Get an existing DefaultObjectACL resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name, id, state, opts) { return new DefaultObjectACL(name, state, { ...opts, id: id }); } /** * Returns true if the given object is an instance of DefaultObjectACL. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj) { if (obj === undefined || obj === null) { return false; } return obj['__pulumiType'] === DefaultObjectACL.__pulumiType; } constructor(name, argsOrState, opts) { let resourceInputs = {}; opts = opts || {}; if (opts.id) { const state = argsOrState; resourceInputs["bucket"] = state?.bucket; resourceInputs["roleEntities"] = state?.roleEntities; } else { const args = argsOrState; if (args?.bucket === undefined && !opts.urn) { throw new Error("Missing required property 'bucket'"); } resourceInputs["bucket"] = args?.bucket; resourceInputs["roleEntities"] = args?.roleEntities; } opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts); super(DefaultObjectACL.__pulumiType, name, resourceInputs, opts); } } exports.DefaultObjectACL = DefaultObjectACL; /** @internal */ DefaultObjectACL.__pulumiType = 'gcp:storage/defaultObjectACL:DefaultObjectACL'; //# sourceMappingURL=defaultObjectACL.js.map