Merge pull request #5944 from sbadia/doc-gcp

docs/google: Update links, fix syntax errors and remove whitespaces
This commit is contained in:
Martin Atkins 2016-04-02 16:32:30 -10:00
commit 0fe01b0bc4
19 changed files with 47 additions and 47 deletions

View File

@ -27,8 +27,8 @@ The following arguments are supported:
* `name` - (Required) A unique name for the resource, required by GCE. * `name` - (Required) A unique name for the resource, required by GCE.
Changing this forces a new resource to be created. Changing this forces a new resource to be created.
* `region` - (Optional) The Region in which the created address should reside. * `region` - (Optional) The Region in which the created address should reside.
If it is not provided, the provider region is used. If it is not provided, the provider region is used.
## Attributes Reference ## Attributes Reference

View File

@ -114,7 +114,7 @@ The `metric` block contains (more documentation
[here](https://cloud.google.com/monitoring/api/metrics)): [here](https://cloud.google.com/monitoring/api/metrics)):
* `name` - The name of the Google Cloud Monitoring metric to follow, e.g. * `name` - The name of the Google Cloud Monitoring metric to follow, e.g.
compute.googleapis.com/instance/network/received_bytes_count `compute.googleapis.com/instance/network/received_bytes_count`
* `type` - Either "cumulative", "delta", or "gauge". * `type` - Either "cumulative", "delta", or "gauge".

View File

@ -61,7 +61,7 @@ The following arguments are supported:
* `description` - (Optional) A brief description of this resource. * `description` - (Optional) A brief description of this resource.
* `machine_type` - (Required) The machine type to create.To create a custom machine type, value should be * `machine_type` - (Required) The machine type to create.To create a custom machine type, value should be
set as specified [here](https://cloud.google.com/compute/docs/reference/latest/instances#machineType) set as specified [here](https://cloud.google.com/compute/docs/reference/latest/instances#machineType)
* `zone` - (Required) The zone that the machine should be created in. * `zone` - (Required) The zone that the machine should be created in.
@ -123,7 +123,7 @@ The `network_interface` block supports:
* `network` - (Optional) The name of the network to attach this interface to. Either * `network` - (Optional) The name of the network to attach this interface to. Either
`network` or `subnetwork` must be provided. `network` or `subnetwork` must be provided.
* `subnetwork` - (Optional) the name of the subnetwork to attach this interface to. The subnetwork * `subnetwork` - (Optional) the name of the subnetwork to attach this interface to. The subnetwork
must exist in the same region this instance will be created in. Either `network` must exist in the same region this instance will be created in. Either `network`
or `subnetwork` must be provided. or `subnetwork` must be provided.
@ -159,7 +159,7 @@ The `scheduling` block supports:
* `preemptible` - (Optional) Is the instance preemptible. * `preemptible` - (Optional) Is the instance preemptible.
* `on_host_maintenance` - (Optional) Describes maintenance behavior for * `on_host_maintenance` - (Optional) Describes maintenance behavior for
the instance. Can be MIGRATE or TERMINATE, for more info, read the instance. Can be MIGRATE or TERMINATE, for more info, read
[here](https://cloud.google.com/compute/docs/instances/setting-instance-scheduling-options) [here](https://cloud.google.com/compute/docs/instances/setting-instance-scheduling-options)

View File

@ -57,12 +57,12 @@ Supported characters include lowercase letters, numbers, and hyphens.
group. group.
* `instances` - (Optional) List of instances in the group. They should be given as * `instances` - (Optional) List of instances in the group. They should be given as
self_link URLs. When adding instances they must all be in the same network and self_link URLs. When adding instances they must all be in the same network and
zone as the instance group. zone as the instance group.
* `named_port` - (Optional) Named ports are key:value pairs that represent a * `named_port` - (Optional) Named ports are key:value pairs that represent a
service name and the port number that the service runs on. The key:value pairs service name and the port number that the service runs on. The key:value pairs
are simple metadata that the Load Balancing service can use. This can specified are simple metadata that the Load Balancing service can use. This can specified
multiple times multiple times
* `zone` - (Required) The zone that this instance group should be created in. * `zone` - (Required) The zone that this instance group should be created in.

View File

@ -48,11 +48,11 @@ instance name.
group manager. group manager.
* `instance_template` - (Required) The full URL to an instance template from * `instance_template` - (Required) The full URL to an instance template from
which all new instances will be created. which all new instances will be created.
* `update_strategy` - (Optional, Default `"RESTART"`) If the `instance_template` resource is * `update_strategy` - (Optional, Default `"RESTART"`) If the `instance_template` resource is
modified, a value of `"NONE"` will prevent any of the managed instances from modified, a value of `"NONE"` will prevent any of the managed instances from
being restarted by Terraform. A value of `"RESTART"` will restart all of the being restarted by Terraform. A value of `"RESTART"` will restart all of the
instances at once. In the future, as the GCE API matures we will support instances at once. In the future, as the GCE API matures we will support
`"ROLLING_UPDATE"` as well. `"ROLLING_UPDATE"` as well.
@ -69,7 +69,7 @@ affect existing instances.
* `zone` - (Required) The zone that instances in this group should be created in. * `zone` - (Required) The zone that instances in this group should be created in.
The `named_port` block supports: (Include a named_port block for each named-port required). The `named_port` block supports: (Include a `named_port` block for each named-port required).
* `name` - (Required) The name of the port. * `name` - (Required) The name of the port.

View File

@ -85,20 +85,20 @@ The following arguments are supported:
* `network_interface` - (Required) Networks to attach to instances created from this template. * `network_interface` - (Required) Networks to attach to instances created from this template.
This can be specified multiple times for multiple networks. Structure is This can be specified multiple times for multiple networks. Structure is
documented below. documented below.
* `region` - (Optional) An instance template is a global resource that is not bound to a zone * `region` - (Optional) An instance template is a global resource that is not bound to a zone
or a region. However, you can still specify some regional resources in an instance template, or a region. However, you can still specify some regional resources in an instance template,
which restricts the template to the region where that resource resides. For example, a which restricts the template to the region where that resource resides. For example, a
custom `subnetwork` resource is tied to a specific region. custom `subnetwork` resource is tied to a specific region.
Defaults to the region of the Provider if no value is given. Defaults to the region of the Provider if no value is given.
* `automatic_restart` - (Optional, Deprecated - see `scheduling`) * `automatic_restart` - (Optional, Deprecated - see `scheduling`)
Specifies whether the instance should be Specifies whether the instance should be
automatically restarted if it is terminated by Compute Engine (not automatically restarted if it is terminated by Compute Engine (not
terminated by a user). terminated by a user).
This defaults to true. This defaults to true.
* `on_host_maintenance` - (Optional, Deprecated - see `scheduling`) * `on_host_maintenance` - (Optional, Deprecated - see `scheduling`)
Defines the maintenance behavior for this instance. Defines the maintenance behavior for this instance.
* `service_account` - (Optional) Service account to attach to the instance. * `service_account` - (Optional) Service account to attach to the instance.
@ -138,7 +138,7 @@ The `disk` block supports:
* `disk_type` - (Optional) The GCE disk type. Can be either `"pd-ssd"`, * `disk_type` - (Optional) The GCE disk type. Can be either `"pd-ssd"`,
`"local-ssd"`, or `"pd-standard"`. `"local-ssd"`, or `"pd-standard"`.
* `disk_size_gb` - (Optional) The size of the image in gigabytes. If not specified, * `disk_size_gb` - (Optional) The size of the image in gigabytes. If not specified,
it will inherit the size of its base image. it will inherit the size of its base image.
* `type` - (Optional) The type of GCE disk, can be either `"SCRATCH"` or * `type` - (Optional) The type of GCE disk, can be either `"SCRATCH"` or
@ -179,7 +179,7 @@ The `scheduling` block supports:
* `on_host_maintenance` - (Optional) Defines the maintenance behavior for this instance. * `on_host_maintenance` - (Optional) Defines the maintenance behavior for this instance.
* `preemptible` - (Optional) Allows instance to be preempted. Read * `preemptible` - (Optional) Allows instance to be preempted. Read
more on this [here](https://cloud.google.com/compute/docs/instances/preemptible). more on this [here](https://cloud.google.com/compute/docs/instances/preemptible).
## Attributes Reference ## Attributes Reference

View File

@ -31,8 +31,8 @@ The following arguments are supported:
set, an auto or custom subnetted network will be created, depending set, an auto or custom subnetted network will be created, depending
on the value of `auto_create_subnetworks` attribute. This attribute on the value of `auto_create_subnetworks` attribute. This attribute
may not be used if `auto_create_subnets` is specified. may not be used if `auto_create_subnets` is specified.
* `auto_create_subnetworks` - (Optional) If set to true, this network * `auto_create_subnetworks` - (Optional) If set to true, this network
will be created in auto subnet mode, and Google will create a will be created in auto subnet mode, and Google will create a
subnet for each region automatically. subnet for each region automatically.
If set to false, and `ipv4_range` is not set, a custom subnetted If set to false, and `ipv4_range` is not set, a custom subnetted

View File

@ -53,7 +53,7 @@ The following arguments are supported:
* `next_hop_vpn_gateway` - (Optional) The name of the VPN to route to if this * `next_hop_vpn_gateway` - (Optional) The name of the VPN to route to if this
route is matched. route is matched.
* `priority` - (Required) The priority of this route, used to break ties. * `priority` - (Required) The priority of this route, used to break ties.
* `tags` - (Optional) The tags that this route applies to. * `tags` - (Optional) The tags that this route applies to.

View File

@ -8,7 +8,7 @@ description: |-
# google\_compute\_ssl\_certificate # google\_compute\_ssl\_certificate
Creates an SSL certificate resource necessary for HTTPS load balancing in GCE. Creates an SSL certificate resource necessary for HTTPS load balancing in GCE.
For more information see For more information see
[the official documentation](https://cloud.google.com/compute/docs/load-balancing/http/ssl-certificates) and [the official documentation](https://cloud.google.com/compute/docs/load-balancing/http/ssl-certificates) and
[API](https://cloud.google.com/compute/docs/reference/latest/sslCertificates). [API](https://cloud.google.com/compute/docs/reference/latest/sslCertificates).

View File

@ -33,8 +33,8 @@ The following arguments are supported:
* `ip_cidr_range` - (Required) The IP address range that machines in this * `ip_cidr_range` - (Required) The IP address range that machines in this
network are assigned to, represented as a CIDR block. network are assigned to, represented as a CIDR block.
* `region` - (Required) The region this subnetwork will be created in. * `region` - (Required) The region this subnetwork will be created in.
* `description` - (Optional) Description of this subnetwork. * `description` - (Optional) Description of this subnetwork.

View File

@ -86,7 +86,7 @@ The following arguments are supported:
* `description` - (Optional) A brief description of this resource. * `description` - (Optional) A brief description of this resource.
* `default_service` - (Required) The URL of the backend service to use when none of the * `default_service` - (Required) The URL of the backend service to use when none of the
given rules match. See the documentation for formatting the service URL given rules match. See the documentation for formatting the service URL
[here](https://cloud.google.com/compute/docs/reference/latest/urlMaps#defaultService) [here](https://cloud.google.com/compute/docs/reference/latest/urlMaps#defaultService)
The `host_rule` block supports: (Note that this block can be defined an arbitrary The `host_rule` block supports: (Note that this block can be defined an arbitrary
@ -97,14 +97,14 @@ number of times.)
* `description` - (Optional) An optional description of the host rule. * `description` - (Optional) An optional description of the host rule.
* `path_matcher` - (Required) The name of the `path_matcher` (defined below) * `path_matcher` - (Required) The name of the `path_matcher` (defined below)
to apply this host rule to. to apply this host rule to.
The `path_matcher` block supports: (Note that this block can be defined an arbitrary The `path_matcher` block supports: (Note that this block can be defined an arbitrary
number of times.) number of times.)
* `default_service` - (Required) The URL for the backend service to use if none * `default_service` - (Required) The URL for the backend service to use if none
of the given paths match. See the documentation for formatting the service URL of the given paths match. See the documentation for formatting the service URL
[here](https://cloud.google.com/compute/docs/reference/latest/urlMaps#pathMatcher.defaultService) [here](https://cloud.google.com/compute/docs/reference/latest/urlMaps#pathMatcher.defaultService)
* `name` - (Required) The name of the `path_matcher` resource. Used by the `host_rule` * `name` - (Required) The name of the `path_matcher` resource. Used by the `host_rule`
@ -119,10 +119,10 @@ number of times.)
documentation for formatting these [here](https://cloud.google.com/compute/docs/reference/latest/urlMaps#pathMatchers.pathRules.paths) documentation for formatting these [here](https://cloud.google.com/compute/docs/reference/latest/urlMaps#pathMatchers.pathRules.paths)
* `default_service` - (Required) The URL for the backend service to use if any * `default_service` - (Required) The URL for the backend service to use if any
of the given paths match. See the documentation for formatting the service URL of the given paths match. See the documentation for formatting the service URL
[here](https://cloud.google.com/compute/docs/reference/latest/urlMaps#pathMatcher.defaultService) [here](https://cloud.google.com/compute/docs/reference/latest/urlMaps#pathMatcher.defaultService)
The optional `test` block supports: (Note that this block can be defined an arbitary The optional `test` block supports: (Note that this block can be defined an arbitary
number of times.) number of times.)
* `service` - (Required) The service that should be matched by this test. * `service` - (Required) The service that should be matched by this test.

View File

@ -8,7 +8,7 @@ description: |-
# google\_compute\_vpn\_gateway # google\_compute\_vpn\_gateway
Manages a VPN Gateway in the GCE network. For more info, read the Manages a VPN Gateway in the GCE network. For more info, read the
[documentation](https://cloud.google.com/compute/docs/vpn). [documentation](https://cloud.google.com/compute/docs/vpn).
@ -93,7 +93,7 @@ The following arguments are supported:
Changing this forces a new resource to be created. Changing this forces a new resource to be created.
* `region` - (Optional) The region this gateway should sit in. If not specified, * `region` - (Optional) The region this gateway should sit in. If not specified,
the project region will be used. Changing this forces a new resource to be the project region will be used. Changing this forces a new resource to be
created. created.
## Attributes Reference ## Attributes Reference

View File

@ -8,7 +8,7 @@ description: |-
# google\_compute\_vpn\_tunnel # google\_compute\_vpn\_tunnel
Manages a VPN Tunnel to the GCE network. For more info, read the Manages a VPN Tunnel to the GCE network. For more info, read the
[documentation](https://cloud.google.com/compute/docs/vpn). [documentation](https://cloud.google.com/compute/docs/vpn).
## Example Usage ## Example Usage
@ -91,7 +91,7 @@ The following arguments are supported:
Changing this forces a new resource to be created. Changing this forces a new resource to be created.
* `region` - (Optional) The region this tunnel should sit in. If not specified, * `region` - (Optional) The region this tunnel should sit in. If not specified,
the project region will be used. Changing this forces a new resource to be the project region will be used. Changing this forces a new resource to be
created. created.
* `shared_secret` - (Required) A passphrase shared between the two VPN gateways. * `shared_secret` - (Required) A passphrase shared between the two VPN gateways.
@ -102,7 +102,7 @@ The following arguments are supported:
* `ike_version` - (Optional) Either version 1 or 2. Default is 2. * `ike_version` - (Optional) Either version 1 or 2. Default is 2.
Changing this forces a new resource to be created. Changing this forces a new resource to be created.
* `local_traffic_selector` - (Optional) Specifies which CIDR ranges are announced * `local_traffic_selector` - (Optional) Specifies which CIDR ranges are announced
to the VPN peer. Mandatory if the VPN gateway is attached to a custom subnetted to the VPN peer. Mandatory if the VPN gateway is attached to a custom subnetted
network. Refer to Google documentation for more information. network. Refer to Google documentation for more information.
@ -113,4 +113,4 @@ The following attributes are exported:
* `self_link` - A GCE server assigned link to this resource. * `self_link` - A GCE server assigned link to this resource.
* `detailed_status` - Information about the status of the VPN tunnel. * `detailed_status` - Information about the status of the VPN tunnel.

View File

@ -17,7 +17,7 @@ Example creating a SQL Database.
``` ```
resource "google_sql_database_instance" "master" { resource "google_sql_database_instance" "master" {
name = "master-instance" name = "master-instance"
settings { settings {
tier = "D0" tier = "D0"
} }

View File

@ -30,7 +30,7 @@ The following arguments are supported:
* `name` - (Optional, Computed) The name of the instance. If the name is left * `name` - (Optional, Computed) The name of the instance. If the name is left
blank, Terraform will randomly generate one when the instance is first blank, Terraform will randomly generate one when the instance is first
created. This is done because after a name is used, it cannot be reused created. This is done because after a name is used, it cannot be reused
for up to [two months](https://cloud.google.com/sql/docs/delete-instance). for up to [two months](https://cloud.google.com/sql/docs/delete-instance).
* `region` - (Required) The region the instance will sit in. Note, this does * `region` - (Required) The region the instance will sit in. Note, this does

View File

@ -17,7 +17,7 @@ Example creating a SQL User.
``` ```
resource "google_sql_database_instance" "master" { resource "google_sql_database_instance" "master" {
name = "master-instance" name = "master-instance"
settings { settings {
tier = "D0" tier = "D0"
} }

View File

@ -13,7 +13,7 @@ Creates a new bucket in Google cloud storage service(GCS). Currently, it will no
## Example Usage ## Example Usage
Example creating a private bucket in standard storage, in the EU region. Example creating a private bucket in standard storage, in the EU region.
``` ```
resource "google_storage_bucket" "image-store" { resource "google_storage_bucket" "image-store" {
@ -34,8 +34,8 @@ The following arguments are supported:
* `name` - (Required) The name of the bucket. * `name` - (Required) The name of the bucket.
* `predefined_acl` - (Optional, Deprecated) The [canned GCS ACL](https://cloud.google.com/storage/docs/access-control#predefined-acl) to apply. Please switch * `predefined_acl` - (Optional, Deprecated) The [canned GCS ACL](https://cloud.google.com/storage/docs/access-control#predefined-acl) to apply. Please switch
to `google_storage_bucket_acl.predefined_acl`. to `google_storage_bucket_acl.predefined_acl`.
* `location` - (Optional, Default: 'US') The [GCS location](https://cloud.google.com/storage/docs/bucket-locations) * `location` - (Optional, Default: 'US') The [GCS location](https://cloud.google.com/storage/docs/bucket-locations)
* `force_destroy` - (Optional, Default: false) When deleting a bucket, this boolean option will delete all contained objects. If you try to delete a bucket that contains objects, Terraform will fail that run. * `force_destroy` - (Optional, Default: false) When deleting a bucket, this boolean option will delete all contained objects. If you try to delete a bucket that contains objects, Terraform will fail that run.
The optional `website` block supports: The optional `website` block supports:

View File

@ -8,7 +8,7 @@ description: |-
# google\_storage\_bucket\_acl # google\_storage\_bucket\_acl
Creates a new bucket ACL in Google cloud storage service(GCS). Creates a new bucket ACL in Google cloud storage service(GCS).
## Example Usage ## Example Usage
@ -22,7 +22,7 @@ resource "google_storage_bucket" "image-store" {
resource "google_storage_bucket_acl" "image-store-acl" { resource "google_storage_bucket_acl" "image-store-acl" {
bucket = "${google_storage_bucket.image_store.name}" bucket = "${google_storage_bucket.image_store.name}"
role_entity = ["OWNER:user-my.email@gmail.com", role_entity = ["OWNER:user-my.email@gmail.com",
"READER:group-mygroup"] "READER:group-mygroup"]
} }

View File

@ -38,7 +38,7 @@ if `content` is not.
* `content` - (Optional) Data as `string` to be uploaded. Must be defined if * `content` - (Optional) Data as `string` to be uploaded. Must be defined if
`source` is not. `source` is not.
* `predefined_acl` - (Optional, Deprecated) The [canned GCS ACL](https://cloud.google.com/storage/docs/access-control#predefined-acl) apply. Please switch * `predefined_acl` - (Optional, Deprecated) The [canned GCS ACL](https://cloud.google.com/storage/docs/access-control#predefined-acl) apply. Please switch
to `google_storage_object_acl.predefined_acl`. to `google_storage_object_acl.predefined_acl`.
## Attributes Reference ## Attributes Reference