google_compute_regions resource
Syntax
A google_compute_regions
is used to test a Google Region resource
Beta Resource
This resource has beta fields available. To retrieve these fields, include beta: true
in the constructor for the resource
Examples
describe google_compute_regions(project: 'chef-gcp-inspec') do
its('count') { should be >= 1 }
its('region_names') { should include "#{gcp_location}" }
its('region_statuses') { should_not include "DOWN" }
its('region_ids') { should include "1290" }
end
Use this InSpec resource to enumerate IDs then test in-depth using google_compute_region
google_compute_regions(project: 'chef-inspec-gcp').region_names.each do |region_name|
describe google_compute_region(project: 'chef-inspec-gcp', region: region_name) do
it { should be_up }
end
end
Test that there are more than a specified number of regions available for the project
describe google_compute_regions(project: 'chef-inspec-gcp') do
its('count') { should be >= 10}
end
Test that an expected region is available for the project
describe google_compute_regions(project: 'chef-inspec-gcp') do
its('region_names') { should include 'europe-west2' }
end
Test whether any regions are in status “DOWN”
describe google_compute_regions(project: 'chef-inspec-gcp') do
its('region_statuses') { should_not include "DOWN" }
end
Test that a subset of all regions matching “europe*” are “UP”
google_compute_regions(project: gcp_project_id).where(region_name: /^europe/).region_names.each do |region_name|
describe google_compute_region(project: 'chef-inspec-gcp', region: region_name) do
it { should be_up }
end
end
Properties
Properties that can be accessed from the google_compute_regions
resource:
See the google_compute_region resource for more information.
creation_timestamps
- an array of
google_compute_region
creation_timestamp deprecateds
- an array of
google_compute_region
deprecated descriptions
- an array of
google_compute_region
description region_ids
- an array of
google_compute_region
id region_names
- an array of
google_compute_region
name quotas
- an array of
google_compute_region
quotas region_statuses
- an array of
google_compute_region
status zones
- an array of
google_compute_region
zones
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 Compute Engine API is enabled for the current project.