google_compute_subnetworks.md

title	platform
About the google_compute_subnetworks resource	gcp

Syntax

A google_compute_subnetworks is used to test a Google Subnetwork 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_subnetworks(project: 'chef-gcp-inspec', region: 'europe-west2') do
  its('ip_cidr_ranges') { should include '10.2.0.0/16' }
  its('subnetwork_names') { should include 'inspec-subnet' }
end

Test that there are no more than a specified number of subnetworks available for the project and region

describe google_compute_subnetworks(project: 'chef-inspec-gcp', region: 'europe-west2') do
  its('count') { should be <= 100}
end

Test that an expected subnetwork identifier is present in the project and region

describe google_compute_subnetworks(project: 'chef-inspec-gcp', region: 'europe-west2') do
  its('subnetwork_ids') { should include 12345678975432 }
end

Test that an expected subnetwork name is available for the project and region

describe google_compute_subnetworks(project: 'chef-inspec-gcp', region: 'europe-west2') do
  its('subnetwork_names') { should include "subnetwork-name" }
end

Test that an expected subnetwork network name is not present for the project and region

describe google_compute_subnetworks(project: 'chef-inspec-gcp', region: 'europe-west2') do
  its('subnetwork_networks') { should not include "network-name" }
end

Properties

Properties that can be accessed from the google_compute_subnetworks resource:

See google_compute_subnetwork.md for more detailed information

• creation_timestamps: an array of google_compute_subnetwork creation_timestamp
• descriptions: an array of google_compute_subnetwork description
• gateway_addresses: an array of google_compute_subnetwork gateway_address
• subnetwork_ids: an array of google_compute_subnetwork id
• ip_cidr_ranges: an array of google_compute_subnetwork ip_cidr_range
• subnetwork_names: an array of google_compute_subnetwork name
• networks: an array of google_compute_subnetwork network
• purposes: (Beta only) an array of google_compute_subnetwork purpose
• roles: (Beta only) an array of google_compute_subnetwork role
• secondary_ip_ranges: an array of google_compute_subnetwork secondary_ip_ranges
• private_ip_google_accesses: an array of google_compute_subnetwork private_ip_google_access
• private_ipv6_google_accesses: an array of google_compute_subnetwork private_ipv6_google_access
• regions: an array of google_compute_subnetwork region
• log_configs: an array of google_compute_subnetwork log_config

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.