google_redis_instance resource
Syntax
A google_redis_instance
is used to test a Google Instance 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_redis_instance(project: 'chef-gcp-inspec', region: 'us-central1', name: 'my-redis-cache') do
it { should exist }
its('tier') { should cmp 'STANDARD_HA' }
its('memory_size_gb') { should cmp '1' }
its('alternative_location_id') { should cmp 'us-central1-f' }
its('redis_version') { should cmp 'REDIS_3_2' }
its('display_name') { should cmp 'InSpec test instance' }
its('reserved_ip_range') { should cmp '192.168.0.0/29' }
its('labels') { should include('key' => 'value') }
end
describe google_redis_instance(project: 'chef-gcp-inspec', region: 'us-central1', name: 'nonexistent') do
it { should_not exist }
end
Properties
Properties that can be accessed from the google_redis_instance
resource:
alternative_location_id
- Only applicable to STANDARD_HA tier which protects the instance against zonal failures by provisioning it across two zones. If provided, it must be a different zone from the one provided in [locationId].
authorized_network
- The full name of the Google Compute Engine network to which the instance is connected. If left unspecified, the default network will be used.
connect_mode
- The connection mode of the Redis instance.
Possible values:
- DIRECT_PEERING
- PRIVATE_SERVICE_ACCESS
create_time
- The time the instance was created in RFC3339 UTC"Zulu" format, accurate to nanoseconds.
current_location_id
- The current zone where the Redis endpoint is placed. For Basic Tier instances, this will always be the same as the [locationId] provided by the user at creation time. For Standard Tier instances, this can be either [locationId] or [alternativeLocationId] and can change after a failover event.
display_name
- An arbitrary and optional user-provided name for the instance.
host
- Hostname or IP address of the exposed Redis endpoint used by clients to connect to the service.
labels
- Resource labels to represent user provided metadata.
redis_configs
- Redis configuration parameters, according to http://redis.io/topics/config. Please check Memorystore documentation for the list of supported parameters: https://cloud.google.com/memorystore/docs/redis/reference/rest/v1/projects.locations.instances#Instance.FIELDS.redis_configs
location_id
- The zone where the instance will be provisioned. If not provided, the service will choose a zone for the instance. For STANDARD_HA tier, instances will be created across two zones for protection against zonal failures. If [alternativeLocationId] is also provided, it must be different from [locationId].
name
- The ID of the instance or a fully qualified identifier for the instance.
memory_size_gb
- Redis memory size in GiB.
port
- The port number of the exposed Redis endpoint.
redis_version
- The version of Redis software. If not provided, latest supported version will be used. Currently, the supported values are: - REDIS_4_0 for Redis 4.0 compatibility - REDIS_3_2 for Redis 3.2 compatibility
reserved_ip_range
- The CIDR range of internal addresses that are reserved for this instance. If not provided, the service will choose an unused /29 block, for example, 10.0.0.0/29 or 192.168.0.0/29. Ranges must be unique and non-overlapping with existing subnets in an authorized network.
tier
- The service tier of the instance. Must be one of these values: - BASIC: standalone instance - STANDARD_HA: highly available primary/replica instances
Possible values:
- BASIC
- STANDARD_HA
region
- The name of the Redis region of the instance.