Resource Type: gstorage_bucket

Defined in:

lib/puppet/type/gstorage_bucket.rb

Providers:

google

Overview

The Buckets resource represents a bucket in Google Cloud Storage. There is a single global namespace shared by all buckets. For more information, see Bucket Name Requirements. Buckets contain objects which can be accessed by their own methods. In addition to the acl property, buckets contain bucketAccessControls, for use in fine-grained manipulation of an existing bucket’s access controls. A bucket is always owned by the project team owners group.

Properties

• acl

  Access controls on the bucket.

• cors

  The bucket’s Cross-Origin Resource Sharing (CORS) configuration.

• default_object_acl

  Default access controls to apply to new objects when no ACL is provided.

• ensure (defaults to: present)

  The basic property that the resource should be in.

  Supported values:

  • present
  • absent
• id

  The ID of the bucket. For buckets, the id and name properities are the same. (output only)

• lifecycle

  The bucket’s lifecycle configuration. See developers.google.com/storage/docs/lifecycle for more information.

• location

  The location of the bucket. Object data for objects in the bucket resides in physical storage within this region. Defaults to US. See the developer’s guide for the authoritative list.

• logging

  The bucket’s logging configuration, which defines the destination bucket and optional name prefix for the current bucket’s logs.

• metageneration

  The metadata generation of this bucket.

• name (namevar)

  The name of the bucket

• owner

  The owner of the bucket. This is always the project team’s owner group.

• project_number

  The project number of the project the bucket belongs to. (output only)

• storage_class

  The bucket’s default storage class, used whenever no storageClass is specified for a newly-created object. This defines how objects in the bucket are stored and determines the SLA and the cost of storage. Values include MULTI_REGIONAL, REGIONAL, STANDARD, NEARLINE, COLDLINE, and DURABLE_REDUCED_AVAILABILITY. If this value is not specified when the bucket is created, it will default to STANDARD. For more information, see storage classes.

  Supported values:

  • MULTI_REGIONAL
  • REGIONAL
  • STANDARD
  • NEARLINE
  • COLDLINE
  • DURABLE_REDUCED_AVAILABILITY
• time_created

  The creation time of the bucket in RFC 3339 format. (output only)

• updated

  The modification time of the bucket in RFC 3339 format. (output only)

• versioning

  The bucket’s versioning configuration.

• website

  The bucket’s website configuration, controlling how the service behaves when accessing bucket contents as a web site. See the Static Website Examples for more information.

Parameters

• credential

  A gauth_credential name to be used to authenticate with Google Cloud Platform.

• name

  The name of the Bucket.

• predefined_default_object_acl

  Apply a predefined set of default object access controls to this bucket. Acceptable values are: - “authenticatedRead”: Object owner gets OWNER access, and allAuthenticatedUsers get READER access. - “bucketOwnerFullControl”: Object owner gets OWNER access, and project team owners get OWNER access. - “bucketOwnerRead”: Object owner gets OWNER access, and project team owners get READER access. - “private”: Object owner gets OWNER access. - “projectPrivate”: Object owner gets OWNER access, and project team members get access according to their roles. - “publicRead”: Object owner gets OWNER access, and allUsers get READER access.

  Supported values:

  • authenticatedRead
  • bucketOwnerFullControl
  • bucketOwnerRead
  • private
  • projectPrivate
  • publicRead
• project

  A valid API project identifier.

• provider

  The specific backend to use for this ‘gstorage_bucket` resource. You will seldom need to specify this — Puppet will usually discover the appropriate provider for your platform.