Skip to main content

google_storage_buckets resource

[edit on GitHub]

Syntax

A google_storage_buckets is used to test a Google Bucket resource

Examples

describe google_storage_buckets(project: 'chef-gcp-inspec') do
  its('bucket_names') { should include bucket-name }
end

Test that there are no more than a specified number of storage buckets for the project

describe google_storage_buckets(project: 'chef-inspec-gcp') do
  its('count') { should be <= 100}
end

Test that an expected named bucket is available

describe google_storage_buckets do
  its('bucket_names'){ should include "my_expected_bucket" }
end

Test that all buckets belong to the expected project number

google_storage_buckets(project: 'chef-inspec-gcp').bucket_names.each do |bucket_name|
  describe google_storage_bucket(name: bucket_name) do
    it { should exist }
    its('project_number'){ should eq 1122334455 }
  end
end

Properties

Properties that can be accessed from the google_storage_buckets resource:

See the google_storage_bucket resource for more information.

acls
an array of google_storage_bucket acl
cors
an array of google_storage_bucket cors
default_event_based_holds
an array of google_storage_bucket default_event_based_hold
default_object_acls
an array of google_storage_bucket default_object_acl
bucket_ids
an array of google_storage_bucket id
lifecycles
an array of google_storage_bucket lifecycle
bucket_locations
an array of google_storage_bucket location
loggings
an array of google_storage_bucket logging
metagenerations
an array of google_storage_bucket metageneration
bucket_names
an array of google_storage_bucket name
owners
an array of google_storage_bucket owner
bucket_project_numbers
an array of google_storage_bucket project_number
storage_classes
an array of google_storage_bucket storage_class
time_createds
an array of google_storage_bucket time_created
updateds
an array of google_storage_bucket updated
versionings
an array of google_storage_bucket versioning
websites
an array of google_storage_bucket website
labels
an array of google_storage_bucket labels
encryptions
an array of google_storage_bucket encryption
retention_policies
an array of google_storage_bucket retention_policy
projects
an array of google_storage_bucket project
predefined_default_object_acls
an array of google_storage_bucket predefined_default_object_acl

Filter Criteria

This resource supports all of the above properties as filter criteria, which can be used with where as a block or a method.

GCP Permissions

Ensure the Google Cloud Storage is enabled for the current project.

Was this page helpful?