google_compute_zones.md

title	platform
About the google_compute_zones resource	gcp

Syntax

A google_compute_zones is used to test a Google Zone resource

Beta Resource

This resource has beta fields available. To retrieve these fields, include beta: true in the constructor for the resource

Examples

google_compute_zones(project: 'chef-gcp-inspec').zone_names.each do |zone_name|
  describe google_compute_zone(project: 'chef-gcp-inspec', name: zone_name) do
    it { should exist }
    it { should be_up }
  end
end

Test that there are no more than a specified number of zones available for the project

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

Test the exact number of zones in the project

describe google_compute_zones(project: 'chef-inspec-gcp') do
  its('zone_ids.count') { should cmp 9 }
end

Test that an expected zone is available for the project

describe google_compute_zones(project: 'chef-inspec-gcp') do
  its('zone_names') { should include "us-east1-b" }
end

Test whether any zones are in status "DOWN"

describe google_compute_zones(project: 'chef-inspec-gcp') do
  its('zone_statuses') { should_not include "DOWN" }
end

Test that a subset of all zones matching "us*" are "UP"

google_compute_zones(project: 'chef-inspec-gcp').where(zone_name: /^us/).zone_names.each do |zone_name|
  describe google_compute_zone(project: 'chef-inspec-gcp',  zone: zone_name) do
    it { should exist }
    its('status') { should eq 'UP' }
  end
end

Properties

Properties that can be accessed from the google_compute_zones resource:

See google_compute_zone.md for more detailed information

• creation_timestamps: an array of google_compute_zone creation_timestamp
• deprecateds: an array of google_compute_zone deprecated
• descriptions: an array of google_compute_zone description
• zone_ids: an array of google_compute_zone id
• zone_names: an array of google_compute_zone name
• regions: an array of google_compute_zone region
• zone_statuses: an array of google_compute_zone status
• available_cpu_platforms: an array of google_compute_zone available_cpu_platforms

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.