adding ansible types in documentation (#303)

Signed-off-by: Modular Magician <magic-modules@google.com>
This commit is contained in:
The Magician 2019-07-16 14:19:07 -07:00 committed by Alex Stephen
parent 72e4cc7214
commit 43536a1e38
81 changed files with 844 additions and 0 deletions

View file

@ -52,16 +52,19 @@ options:
description: description:
- An optional string description of this rule. - An optional string description of this rule.
required: false required: false
type: str
source_range: source_range:
description: description:
- IP address or range, defined using CIDR notation, of requests that this rule - IP address or range, defined using CIDR notation, of requests that this rule
applies to. applies to.
required: true required: true
type: str
action: action:
description: description:
- The action to take if this rule matches. - The action to take if this rule matches.
- 'Some valid choices include: "UNSPECIFIED_ACTION", "ALLOW", "DENY"' - 'Some valid choices include: "UNSPECIFIED_ACTION", "ALLOW", "DENY"'
required: true required: true
type: str
priority: priority:
description: description:
- A positive integer that defines the order of rule evaluation. - A positive integer that defines the order of rule evaluation.
@ -70,6 +73,7 @@ options:
when no previous rule matches. Only the action of this rule can be modified when no previous rule matches. Only the action of this rule can be modified
by the user. by the user.
required: false required: false
type: int
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.firewall.ingressRules)' - 'API Reference: U(https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.firewall.ingressRules)'

View file

@ -51,35 +51,42 @@ options:
description: description:
- Dataset name. - Dataset name.
required: false required: false
type: str
access: access:
description: description:
- Access controls on the bucket. - Access controls on the bucket.
required: false required: false
type: list
suboptions: suboptions:
domain: domain:
description: description:
- A domain to grant access to. Any users signed in with the domain specified - A domain to grant access to. Any users signed in with the domain specified
will be granted the specified access . will be granted the specified access .
required: false required: false
type: str
group_by_email: group_by_email:
description: description:
- An email address of a Google Group to grant access to. - An email address of a Google Group to grant access to.
required: false required: false
type: str
role: role:
description: description:
- Describes the rights granted to the user specified by the other member of - Describes the rights granted to the user specified by the other member of
the access object . the access object .
- 'Some valid choices include: "READER", "WRITER", "OWNER"' - 'Some valid choices include: "READER", "WRITER", "OWNER"'
required: false required: false
type: str
special_group: special_group:
description: description:
- A special group to grant access to. - A special group to grant access to.
required: false required: false
type: str
user_by_email: user_by_email:
description: description:
- 'An email address of a user to grant access to. For example: fred@example.com - 'An email address of a user to grant access to. For example: fred@example.com
.' .'
required: false required: false
type: str
view: view:
description: description:
- A view from a different dataset to grant access to. Queries executed against - A view from a different dataset to grant access to. Queries executed against
@ -87,24 +94,29 @@ options:
is not required when this field is set. If that view is updated by any user, is not required when this field is set. If that view is updated by any user,
access to the view needs to be granted again via an update operation. access to the view needs to be granted again via an update operation.
required: false required: false
type: dict
suboptions: suboptions:
dataset_id: dataset_id:
description: description:
- The ID of the dataset containing this table. - The ID of the dataset containing this table.
required: true required: true
type: str
project_id: project_id:
description: description:
- The ID of the project containing this table. - The ID of the project containing this table.
required: true required: true
type: str
table_id: table_id:
description: description:
- The ID of the table. The ID must contain only letters (a-z, A-Z), numbers - The ID of the table. The ID must contain only letters (a-z, A-Z), numbers
(0-9), or underscores. The maximum length is 1,024 characters. (0-9), or underscores. The maximum length is 1,024 characters.
required: true required: true
type: str
dataset_reference: dataset_reference:
description: description:
- A reference that identifies the dataset. - A reference that identifies the dataset.
required: true required: true
type: dict
suboptions: suboptions:
dataset_id: dataset_id:
description: description:
@ -112,33 +124,40 @@ options:
only letters (a-z, A-Z), numbers (0-9), or underscores. The maximum length only letters (a-z, A-Z), numbers (0-9), or underscores. The maximum length
is 1,024 characters. is 1,024 characters.
required: true required: true
type: str
project_id: project_id:
description: description:
- The ID of the project containing this dataset. - The ID of the project containing this dataset.
required: false required: false
type: str
default_table_expiration_ms: default_table_expiration_ms:
description: description:
- The default lifetime of all tables in the dataset, in milliseconds . - The default lifetime of all tables in the dataset, in milliseconds .
required: false required: false
type: int
description: description:
description: description:
- A user-friendly description of the dataset. - A user-friendly description of the dataset.
required: false required: false
type: str
friendly_name: friendly_name:
description: description:
- A descriptive name for the dataset. - A descriptive name for the dataset.
required: false required: false
type: str
labels: labels:
description: description:
- The labels associated with this dataset. You can use these to organize and group - The labels associated with this dataset. You can use these to organize and group
your datasets . your datasets .
required: false required: false
type: dict
location: location:
description: description:
- The geographic location where the dataset should reside. Possible values include - The geographic location where the dataset should reside. Possible values include
EU and US. The default value is US. EU and US. The default value is US.
required: false required: false
default: US default: US
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -51,40 +51,49 @@ options:
description: description:
- Reference describing the ID of this table. - Reference describing the ID of this table.
required: false required: false
type: dict
suboptions: suboptions:
dataset_id: dataset_id:
description: description:
- The ID of the dataset containing this table. - The ID of the dataset containing this table.
required: false required: false
type: str
project_id: project_id:
description: description:
- The ID of the project containing this table. - The ID of the project containing this table.
required: false required: false
type: str
table_id: table_id:
description: description:
- The ID of the the table. - The ID of the the table.
required: false required: false
type: str
description: description:
description: description:
- A user-friendly description of the dataset. - A user-friendly description of the dataset.
required: false required: false
type: str
friendly_name: friendly_name:
description: description:
- A descriptive name for this table. - A descriptive name for this table.
required: false required: false
type: str
labels: labels:
description: description:
- The labels associated with this dataset. You can use these to organize and group - The labels associated with this dataset. You can use these to organize and group
your datasets . your datasets .
required: false required: false
type: dict
name: name:
description: description:
- Name of the table. - Name of the table.
required: false required: false
type: str
view: view:
description: description:
- The view definition. - The view definition.
required: false required: false
type: dict
suboptions: suboptions:
use_legacy_sql: use_legacy_sql:
description: description:
@ -95,6 +104,7 @@ options:
description: description:
- Describes user-defined function resources used in the query. - Describes user-defined function resources used in the query.
required: false required: false
type: list
suboptions: suboptions:
inline_code: inline_code:
description: description:
@ -102,61 +112,74 @@ options:
Providing a inline code resource is equivalent to providing a URI for Providing a inline code resource is equivalent to providing a URI for
a file containing the same code. a file containing the same code.
required: false required: false
type: str
resource_uri: resource_uri:
description: description:
- A code resource to load from a Google Cloud Storage URI (gs://bucket/path). - A code resource to load from a Google Cloud Storage URI (gs://bucket/path).
required: false required: false
type: str
time_partitioning: time_partitioning:
description: description:
- If specified, configures time-based partitioning for this table. - If specified, configures time-based partitioning for this table.
required: false required: false
type: dict
suboptions: suboptions:
expiration_ms: expiration_ms:
description: description:
- Number of milliseconds for which to keep the storage for a partition. - Number of milliseconds for which to keep the storage for a partition.
required: false required: false
type: int
type: type:
description: description:
- The only type supported is DAY, which will generate one partition per day. - The only type supported is DAY, which will generate one partition per day.
- 'Some valid choices include: "DAY"' - 'Some valid choices include: "DAY"'
required: false required: false
type: str
schema: schema:
description: description:
- Describes the schema of this table. - Describes the schema of this table.
required: false required: false
type: dict
suboptions: suboptions:
fields: fields:
description: description:
- Describes the fields in a table. - Describes the fields in a table.
required: false required: false
type: list
suboptions: suboptions:
description: description:
description: description:
- The field description. The maximum length is 1,024 characters. - The field description. The maximum length is 1,024 characters.
required: false required: false
type: str
fields: fields:
description: description:
- Describes the nested schema fields if the type property is set to RECORD. - Describes the nested schema fields if the type property is set to RECORD.
required: false required: false
type: list
mode: mode:
description: description:
- The field mode. - The field mode.
- 'Some valid choices include: "NULLABLE", "REQUIRED", "REPEATED"' - 'Some valid choices include: "NULLABLE", "REQUIRED", "REPEATED"'
required: false required: false
type: str
name: name:
description: description:
- The field name. - The field name.
required: false required: false
type: str
type: type:
description: description:
- The field data type. - The field data type.
- 'Some valid choices include: "STRING", "BYTES", "INTEGER", "FLOAT", - 'Some valid choices include: "STRING", "BYTES", "INTEGER", "FLOAT",
"TIMESTAMP", "DATE", "TIME", "DATETIME", "RECORD"' "TIMESTAMP", "DATE", "TIME", "DATETIME", "RECORD"'
required: false required: false
type: str
encryption_configuration: encryption_configuration:
description: description:
- Custom encryption configuration. - Custom encryption configuration.
required: false required: false
type: dict
suboptions: suboptions:
kms_key_name: kms_key_name:
description: description:
@ -164,17 +187,20 @@ options:
BigQuery table. The BigQuery Service Account associated with your project BigQuery table. The BigQuery Service Account associated with your project
requires access to this encryption key. requires access to this encryption key.
required: false required: false
type: str
expiration_time: expiration_time:
description: description:
- The time when this table expires, in milliseconds since the epoch. If not present, - The time when this table expires, in milliseconds since the epoch. If not present,
the table will persist indefinitely. the table will persist indefinitely.
required: false required: false
type: int
external_data_configuration: external_data_configuration:
description: description:
- Describes the data format, location, and other properties of a table stored - Describes the data format, location, and other properties of a table stored
outside of BigQuery. By defining these properties, the data source can then outside of BigQuery. By defining these properties, the data source can then
be queried as if it were a standard BigQuery table. be queried as if it were a standard BigQuery table.
required: false required: false
type: dict
suboptions: suboptions:
autodetect: autodetect:
description: description:
@ -187,6 +213,7 @@ options:
- The compression type of the data source. - The compression type of the data source.
- 'Some valid choices include: "GZIP", "NONE"' - 'Some valid choices include: "GZIP", "NONE"'
required: false required: false
type: str
ignore_unknown_values: ignore_unknown_values:
description: description:
- Indicates if BigQuery should allow extra values that are not represented - Indicates if BigQuery should allow extra values that are not represented
@ -199,12 +226,14 @@ options:
data . data .
required: false required: false
default: '0' default: '0'
type: int
source_format: source_format:
description: description:
- The data format. - The data format.
- 'Some valid choices include: "CSV", "GOOGLE_SHEETS", "NEWLINE_DELIMITED_JSON", - 'Some valid choices include: "CSV", "GOOGLE_SHEETS", "NEWLINE_DELIMITED_JSON",
"AVRO", "DATASTORE_BACKUP", "BIGTABLE"' "AVRO", "DATASTORE_BACKUP", "BIGTABLE"'
required: false required: false
type: str
source_uris: source_uris:
description: description:
- The fully-qualified URIs that point to your data in Google Cloud. - The fully-qualified URIs that point to your data in Google Cloud.
@ -216,44 +245,53 @@ options:
backups, exactly one URI can be specified. Also, the ''*'' wildcard character backups, exactly one URI can be specified. Also, the ''*'' wildcard character
is not allowed.' is not allowed.'
required: false required: false
type: list
schema: schema:
description: description:
- The schema for the data. Schema is required for CSV and JSON formats. - The schema for the data. Schema is required for CSV and JSON formats.
required: false required: false
type: dict
suboptions: suboptions:
fields: fields:
description: description:
- Describes the fields in a table. - Describes the fields in a table.
required: false required: false
type: list
suboptions: suboptions:
description: description:
description: description:
- The field description. - The field description.
required: false required: false
type: str
fields: fields:
description: description:
- Describes the nested schema fields if the type property is set to - Describes the nested schema fields if the type property is set to
RECORD . RECORD .
required: false required: false
type: list
mode: mode:
description: description:
- Field mode. - Field mode.
- 'Some valid choices include: "NULLABLE", "REQUIRED", "REPEATED"' - 'Some valid choices include: "NULLABLE", "REQUIRED", "REPEATED"'
required: false required: false
type: str
name: name:
description: description:
- Field name. - Field name.
required: false required: false
type: str
type: type:
description: description:
- Field data type. - Field data type.
- 'Some valid choices include: "STRING", "BYTES", "INTEGER", "FLOAT", - 'Some valid choices include: "STRING", "BYTES", "INTEGER", "FLOAT",
"TIMESTAMP", "DATE", "TIME", "DATETIME", "RECORD"' "TIMESTAMP", "DATE", "TIME", "DATETIME", "RECORD"'
required: false required: false
type: str
google_sheets_options: google_sheets_options:
description: description:
- Additional options if sourceFormat is set to GOOGLE_SHEETS. - Additional options if sourceFormat is set to GOOGLE_SHEETS.
required: false required: false
type: dict
suboptions: suboptions:
skip_leading_rows: skip_leading_rows:
description: description:
@ -261,10 +299,12 @@ options:
when reading the data. when reading the data.
required: false required: false
default: '0' default: '0'
type: int
csv_options: csv_options:
description: description:
- Additional properties to set if sourceFormat is set to CSV. - Additional properties to set if sourceFormat is set to CSV.
required: false required: false
type: dict
suboptions: suboptions:
allow_jagged_rows: allow_jagged_rows:
description: description:
@ -283,24 +323,29 @@ options:
- The character encoding of the data. - The character encoding of the data.
- 'Some valid choices include: "UTF-8", "ISO-8859-1"' - 'Some valid choices include: "UTF-8", "ISO-8859-1"'
required: false required: false
type: str
field_delimiter: field_delimiter:
description: description:
- The separator for fields in a CSV file. - The separator for fields in a CSV file.
required: false required: false
type: str
quote: quote:
description: description:
- The value that is used to quote data sections in a CSV file. - The value that is used to quote data sections in a CSV file.
required: false required: false
type: str
skip_leading_rows: skip_leading_rows:
description: description:
- The number of rows at the top of a CSV file that BigQuery will skip - The number of rows at the top of a CSV file that BigQuery will skip
when reading the data. when reading the data.
required: false required: false
default: '0' default: '0'
type: int
bigtable_options: bigtable_options:
description: description:
- Additional options if sourceFormat is set to BIGTABLE. - Additional options if sourceFormat is set to BIGTABLE.
required: false required: false
type: dict
suboptions: suboptions:
ignore_unspecified_column_families: ignore_unspecified_column_families:
description: description:
@ -319,24 +364,28 @@ options:
- List of column families to expose in the table schema along with their - List of column families to expose in the table schema along with their
types. types.
required: false required: false
type: list
suboptions: suboptions:
columns: columns:
description: description:
- Lists of columns that should be exposed as individual fields as - Lists of columns that should be exposed as individual fields as
opposed to a list of (column name, value) pairs. opposed to a list of (column name, value) pairs.
required: false required: false
type: list
suboptions: suboptions:
encoding: encoding:
description: description:
- The encoding of the values when the type is not STRING. - The encoding of the values when the type is not STRING.
- 'Some valid choices include: "TEXT", "BINARY"' - 'Some valid choices include: "TEXT", "BINARY"'
required: false required: false
type: str
field_name: field_name:
description: description:
- If the qualifier is not a valid BigQuery field identifier, a - If the qualifier is not a valid BigQuery field identifier, a
valid identifier must be provided as the column field name and valid identifier must be provided as the column field name and
is used as field name in queries. is used as field name in queries.
required: false required: false
type: str
only_read_latest: only_read_latest:
description: description:
- If this is set, only the latest version of value in this column - If this is set, only the latest version of value in this column
@ -347,21 +396,25 @@ options:
description: description:
- Qualifier of the column. - Qualifier of the column.
required: true required: true
type: str
type: type:
description: description:
- The type to convert the value in cells of this column. - The type to convert the value in cells of this column.
- 'Some valid choices include: "BYTES", "STRING", "INTEGER", "FLOAT", - 'Some valid choices include: "BYTES", "STRING", "INTEGER", "FLOAT",
"BOOLEAN"' "BOOLEAN"'
required: false required: false
type: str
encoding: encoding:
description: description:
- The encoding of the values when the type is not STRING. - The encoding of the values when the type is not STRING.
- 'Some valid choices include: "TEXT", "BINARY"' - 'Some valid choices include: "TEXT", "BINARY"'
required: false required: false
type: str
family_id: family_id:
description: description:
- Identifier of the column family. - Identifier of the column family.
required: false required: false
type: str
only_read_latest: only_read_latest:
description: description:
- If this is set only the latest version of value are exposed for - If this is set only the latest version of value are exposed for
@ -374,10 +427,12 @@ options:
- 'Some valid choices include: "BYTES", "STRING", "INTEGER", "FLOAT", - 'Some valid choices include: "BYTES", "STRING", "INTEGER", "FLOAT",
"BOOLEAN"' "BOOLEAN"'
required: false required: false
type: str
dataset: dataset:
description: description:
- Name of the dataset. - Name of the dataset.
required: false required: false
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -44,6 +44,7 @@ options:
description: description:
- Name of the dataset. - Name of the dataset.
required: false required: false
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -51,10 +51,12 @@ options:
description: description:
- The unique identifier for the trigger. - The unique identifier for the trigger.
required: false required: false
type: str
description: description:
description: description:
- Human-readable description of the trigger. - Human-readable description of the trigger.
required: false required: false
type: str
disabled: disabled:
description: description:
- Whether the trigger is disabled or not. If true, the trigger will never result - Whether the trigger is disabled or not. If true, the trigger will never result
@ -65,11 +67,13 @@ options:
description: description:
- Substitutions data for Build resource. - Substitutions data for Build resource.
required: false required: false
type: dict
filename: filename:
description: description:
- Path, from the source root, to a file whose contents is used for the template. - Path, from the source root, to a file whose contents is used for the template.
Either a filename or build template must be provided. Either a filename or build template must be provided.
required: false required: false
type: str
ignored_files: ignored_files:
description: description:
- ignoredFiles and includedFiles are file glob matches using http://godoc/pkg/path/filepath#Match - ignoredFiles and includedFiles are file glob matches using http://godoc/pkg/path/filepath#Match
@ -80,6 +84,7 @@ options:
ignored_file globs. If the change has no files that are outside of the ignoredFiles ignored_file globs. If the change has no files that are outside of the ignoredFiles
globs, then we do not trigger a build. globs, then we do not trigger a build.
required: false required: false
type: list
included_files: included_files:
description: description:
- ignoredFiles and includedFiles are file glob matches using http://godoc/pkg/path/filepath#Match - ignoredFiles and includedFiles are file glob matches using http://godoc/pkg/path/filepath#Match
@ -90,6 +95,7 @@ options:
is not empty, then we make sure that at least one of those files matches a includedFiles is not empty, then we make sure that at least one of those files matches a includedFiles
glob. If not, then we do not trigger a build. glob. If not, then we do not trigger a build.
required: false required: false
type: list
trigger_template: trigger_template:
description: description:
- Template describing the types of source changes to trigger a build. - Template describing the types of source changes to trigger a build.
@ -97,48 +103,57 @@ options:
Any branch or tag change that matches that regular expression will trigger a Any branch or tag change that matches that regular expression will trigger a
build. build.
required: false required: false
type: dict
suboptions: suboptions:
project_id: project_id:
description: description:
- ID of the project that owns the Cloud Source Repository. If omitted, the - ID of the project that owns the Cloud Source Repository. If omitted, the
project ID requesting the build is assumed. project ID requesting the build is assumed.
required: false required: false
type: str
repo_name: repo_name:
description: description:
- Name of the Cloud Source Repository. If omitted, the name "default" is assumed. - Name of the Cloud Source Repository. If omitted, the name "default" is assumed.
required: false required: false
default: default default: default
type: str
dir: dir:
description: description:
- Directory, relative to the source root, in which to run the build. - Directory, relative to the source root, in which to run the build.
- This must be a relative path. If a step's dir is specified and is an absolute - This must be a relative path. If a step's dir is specified and is an absolute
path, this value is ignored for that step's execution. path, this value is ignored for that step's execution.
required: false required: false
type: str
branch_name: branch_name:
description: description:
- Name of the branch to build. Exactly one a of branch name, tag, or commit - Name of the branch to build. Exactly one a of branch name, tag, or commit
SHA must be provided. SHA must be provided.
required: false required: false
type: str
tag_name: tag_name:
description: description:
- Name of the tag to build. Exactly one of a branch name, tag, or commit SHA - Name of the tag to build. Exactly one of a branch name, tag, or commit SHA
must be provided. must be provided.
required: false required: false
type: str
commit_sha: commit_sha:
description: description:
- Explicit commit SHA to build. Exactly one of a branch name, tag, or commit - Explicit commit SHA to build. Exactly one of a branch name, tag, or commit
SHA must be provided. SHA must be provided.
required: false required: false
type: str
build: build:
description: description:
- Contents of the build template. Either a filename or build template must be - Contents of the build template. Either a filename or build template must be
provided. provided.
required: false required: false
type: dict
suboptions: suboptions:
tags: tags:
description: description:
- Tags for annotation of a Build. These are not docker tags. - Tags for annotation of a Build. These are not docker tags.
required: false required: false
type: list
images: images:
description: description:
- A list of images to be pushed upon the successful completion of all build - A list of images to be pushed upon the successful completion of all build
@ -148,10 +163,12 @@ options:
results field. results field.
- If any of the images fail to be pushed, the build status is marked FAILURE. - If any of the images fail to be pushed, the build status is marked FAILURE.
required: false required: false
type: list
steps: steps:
description: description:
- The operations to be performed on the workspace. - The operations to be performed on the workspace.
required: false required: false
type: list
suboptions: suboptions:
name: name:
description: description:
@ -169,6 +186,7 @@ options:
the host's Docker daemon's cache and is available to use as the name the host's Docker daemon's cache and is available to use as the name
for a later build step. for a later build step.
required: false required: false
type: str
args: args:
description: description:
- A list of arguments that will be presented to the step when it is started. - A list of arguments that will be presented to the step when it is started.
@ -177,6 +195,7 @@ options:
define an entrypoint, the first element in args is used as the entrypoint, define an entrypoint, the first element in args is used as the entrypoint,
and the remainder will be used as arguments. and the remainder will be used as arguments.
required: false required: false
type: list
env: env:
description: description:
- A list of environment variable definitions to be used when running a - A list of environment variable definitions to be used when running a
@ -184,16 +203,19 @@ options:
- The elements are of the form "KEY=VALUE" for the environment variable - The elements are of the form "KEY=VALUE" for the environment variable
"KEY" being given the value "VALUE". "KEY" being given the value "VALUE".
required: false required: false
type: list
id: id:
description: description:
- Unique identifier for this build step, used in `wait_for` to reference - Unique identifier for this build step, used in `wait_for` to reference
this build step as a dependency. this build step as a dependency.
required: false required: false
type: str
entrypoint: entrypoint:
description: description:
- Entrypoint to be used instead of the build step image's default entrypoint. - Entrypoint to be used instead of the build step image's default entrypoint.
- If unset, the image's default entrypoint is used . - If unset, the image's default entrypoint is used .
required: false required: false
type: str
dir: dir:
description: description:
- Working directory to use when running this step's container. - Working directory to use when running this step's container.
@ -206,22 +228,26 @@ options:
which specifies an absolute path, the `RepoSource` `dir` is ignored which specifies an absolute path, the `RepoSource` `dir` is ignored
for the step's execution. for the step's execution.
required: false required: false
type: str
secret_env: secret_env:
description: description:
- A list of environment variables which are encrypted using a Cloud Key - A list of environment variables which are encrypted using a Cloud Key
Management Service crypto key. These values must be specified in the Management Service crypto key. These values must be specified in the
build's `Secret`. build's `Secret`.
required: false required: false
type: list
timeout: timeout:
description: description:
- Time limit for executing this build step. If not defined, the step has - Time limit for executing this build step. If not defined, the step has
no time limit and will be allowed to continue to run until either it no time limit and will be allowed to continue to run until either it
completes or the build itself times out. completes or the build itself times out.
required: false required: false
type: str
timing: timing:
description: description:
- Output only. Stores timing information for executing this build step. - Output only. Stores timing information for executing this build step.
required: false required: false
type: str
volumes: volumes:
description: description:
- List of volumes to mount into the build step. - List of volumes to mount into the build step.
@ -231,6 +257,7 @@ options:
- Using a named volume in only one step is not valid as it is indicative - Using a named volume in only one step is not valid as it is indicative
of a build request with an incorrect configuration. of a build request with an incorrect configuration.
required: false required: false
type: list
suboptions: suboptions:
name: name:
description: description:
@ -239,12 +266,14 @@ options:
for Docker volumes. Each named volume must be used by at least two for Docker volumes. Each named volume must be used by at least two
build steps. build steps.
required: false required: false
type: str
path: path:
description: description:
- Path at which to mount the volume. - Path at which to mount the volume.
- Paths must be absolute and cannot conflict with other volume paths - Paths must be absolute and cannot conflict with other volume paths
on the same build step or with certain reserved volume paths. on the same build step or with certain reserved volume paths.
required: false required: false
type: str
wait_for: wait_for:
description: description:
- The ID(s) of the step(s) that this build step depends on. - The ID(s) of the step(s) that this build step depends on.
@ -253,6 +282,7 @@ options:
will start when all previous build steps in the `Build.Steps` list have will start when all previous build steps in the `Build.Steps` list have
completed successfully. completed successfully.
required: false required: false
type: list
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/cloud-build/docs/api/reference/rest/)' - 'API Reference: U(https://cloud.google.com/cloud-build/docs/api/reference/rest/)'

View file

@ -55,27 +55,32 @@ options:
description: description:
- The name of the job. - The name of the job.
required: true required: true
type: str
description: description:
description: description:
- A human-readable description for the job. This string must not contain more - A human-readable description for the job. This string must not contain more
than 500 characters. than 500 characters.
required: false required: false
type: str
schedule: schedule:
description: description:
- Describes the schedule on which the job will be executed. - Describes the schedule on which the job will be executed.
required: false required: false
type: str
time_zone: time_zone:
description: description:
- Specifies the time zone to be used in interpreting schedule. - Specifies the time zone to be used in interpreting schedule.
- The value of this field must be a time zone name from the tz database. - The value of this field must be a time zone name from the tz database.
required: false required: false
default: Etc/UTC default: Etc/UTC
type: str
retry_config: retry_config:
description: description:
- By default, if a job does not complete successfully, meaning that an acknowledgement - By default, if a job does not complete successfully, meaning that an acknowledgement
is not received from the handler, then it will be retried with exponential backoff is not received from the handler, then it will be retried with exponential backoff
according to the settings . according to the settings .
required: false required: false
type: dict
suboptions: suboptions:
retry_count: retry_count:
description: description:
@ -83,6 +88,7 @@ options:
exponential backoff procedure described by maxDoublings. exponential backoff procedure described by maxDoublings.
- Values greater than 5 and negative values are not allowed. - Values greater than 5 and negative values are not allowed.
required: false required: false
type: int
max_retry_duration: max_retry_duration:
description: description:
- The time limit for retrying a failed job, measured from time when an execution - The time limit for retrying a failed job, measured from time when an execution
@ -90,16 +96,19 @@ options:
until both limits are reached. until both limits are reached.
- A duration in seconds with up to nine fractional digits, terminated by 's'. - A duration in seconds with up to nine fractional digits, terminated by 's'.
required: false required: false
type: str
min_backoff_duration: min_backoff_duration:
description: description:
- The minimum amount of time to wait before retrying a job after it fails. - The minimum amount of time to wait before retrying a job after it fails.
- A duration in seconds with up to nine fractional digits, terminated by 's'. - A duration in seconds with up to nine fractional digits, terminated by 's'.
required: false required: false
type: str
max_backoff_duration: max_backoff_duration:
description: description:
- The maximum amount of time to wait before retrying a job after it fails. - The maximum amount of time to wait before retrying a job after it fails.
- A duration in seconds with up to nine fractional digits, terminated by 's'. - A duration in seconds with up to nine fractional digits, terminated by 's'.
required: false required: false
type: str
max_doublings: max_doublings:
description: description:
- The time between retries will double maxDoublings times. - The time between retries will double maxDoublings times.
@ -107,11 +116,13 @@ options:
times, then increases linearly, and finally retries retries at intervals times, then increases linearly, and finally retries retries at intervals
of maxBackoffDuration up to retryCount times. of maxBackoffDuration up to retryCount times.
required: false required: false
type: int
pubsub_target: pubsub_target:
description: description:
- Pub/Sub target If the job providers a Pub/Sub target the cron will publish a - Pub/Sub target If the job providers a Pub/Sub target the cron will publish a
message to the provided topic . message to the provided topic .
required: false required: false
type: dict
suboptions: suboptions:
topic_name: topic_name:
description: description:
@ -119,31 +130,37 @@ options:
when a job is delivered. The topic name must be in the same format as required when a job is delivered. The topic name must be in the same format as required
by PubSub's PublishRequest.name, for example projects/PROJECT_ID/topics/TOPIC_ID. by PubSub's PublishRequest.name, for example projects/PROJECT_ID/topics/TOPIC_ID.
required: true required: true
type: str
data: data:
description: description:
- The message payload for PubsubMessage. - The message payload for PubsubMessage.
- Pubsub message must contain either non-empty data, or at least one attribute. - Pubsub message must contain either non-empty data, or at least one attribute.
required: false required: false
type: str
attributes: attributes:
description: description:
- Attributes for PubsubMessage. - Attributes for PubsubMessage.
- Pubsub message must contain either non-empty data, or at least one attribute. - Pubsub message must contain either non-empty data, or at least one attribute.
required: false required: false
type: dict
app_engine_http_target: app_engine_http_target:
description: description:
- App Engine HTTP target. - App Engine HTTP target.
- If the job providers a App Engine HTTP target the cron will send a request to - If the job providers a App Engine HTTP target the cron will send a request to
the service instance . the service instance .
required: false required: false
type: dict
suboptions: suboptions:
http_method: http_method:
description: description:
- Which HTTP method to use for the request. - Which HTTP method to use for the request.
required: false required: false
type: str
app_engine_routing: app_engine_routing:
description: description:
- App Engine Routing setting for the job. - App Engine Routing setting for the job.
required: false required: false
type: dict
suboptions: suboptions:
service: service:
description: description:
@ -151,64 +168,76 @@ options:
- By default, the job is sent to the service which is the default service - By default, the job is sent to the service which is the default service
when the job is attempted. when the job is attempted.
required: false required: false
type: str
version: version:
description: description:
- App version. - App version.
- By default, the job is sent to the version which is the default version - By default, the job is sent to the version which is the default version
when the job is attempted. when the job is attempted.
required: false required: false
type: str
instance: instance:
description: description:
- App instance. - App instance.
- By default, the job is sent to an instance which is available when the - By default, the job is sent to an instance which is available when the
job is attempted. job is attempted.
required: false required: false
type: str
relative_uri: relative_uri:
description: description:
- The relative URI. - The relative URI.
required: true required: true
type: str
body: body:
description: description:
- HTTP request body. A request body is allowed only if the HTTP method is - HTTP request body. A request body is allowed only if the HTTP method is
POST or PUT. It will result in invalid argument error to set a body on a POST or PUT. It will result in invalid argument error to set a body on a
job with an incompatible HttpMethod. job with an incompatible HttpMethod.
required: false required: false
type: str
headers: headers:
description: description:
- HTTP request headers. - HTTP request headers.
- This map contains the header field names and values. Headers can be set - This map contains the header field names and values. Headers can be set
when the job is created. when the job is created.
required: false required: false
type: dict
http_target: http_target:
description: description:
- HTTP target. - HTTP target.
- If the job providers a http_target the cron will send a request to the targeted - If the job providers a http_target the cron will send a request to the targeted
url . url .
required: false required: false
type: dict
suboptions: suboptions:
uri: uri:
description: description:
- The full URI path that the request will be sent to. - The full URI path that the request will be sent to.
required: true required: true
type: str
http_method: http_method:
description: description:
- Which HTTP method to use for the request. - Which HTTP method to use for the request.
required: false required: false
type: str
body: body:
description: description:
- HTTP request body. A request body is allowed only if the HTTP method is - HTTP request body. A request body is allowed only if the HTTP method is
POST, PUT, or PATCH. It is an error to set body on a job with an incompatible POST, PUT, or PATCH. It is an error to set body on a job with an incompatible
HttpMethod. HttpMethod.
required: false required: false
type: str
headers: headers:
description: description:
- This map contains the header field names and values. Repeated headers are - This map contains the header field names and values. Repeated headers are
not supported, but a header value can contain commas. not supported, but a header value can contain commas.
required: false required: false
type: dict
region: region:
description: description:
- Region where the scheduler job resides . - Region where the scheduler job resides .
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/scheduler/docs/reference/rest/)' - 'API Reference: U(https://cloud.google.com/scheduler/docs/reference/rest/)'

View file

@ -44,6 +44,7 @@ options:
description: description:
- Region where the scheduler job resides . - Region where the scheduler job resides .
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -62,6 +62,7 @@ options:
An address may only be specified for INTERNAL address types. The IP address An address may only be specified for INTERNAL address types. The IP address
must be inside the specified subnetwork, if any. must be inside the specified subnetwork, if any.
required: false required: false
type: str
address_type: address_type:
description: description:
- The type of address to reserve, either INTERNAL or EXTERNAL. - The type of address to reserve, either INTERNAL or EXTERNAL.
@ -69,11 +70,13 @@ options:
- 'Some valid choices include: "INTERNAL", "EXTERNAL"' - 'Some valid choices include: "INTERNAL", "EXTERNAL"'
required: false required: false
default: EXTERNAL default: EXTERNAL
type: str
version_added: 2.7 version_added: 2.7
description: description:
description: description:
- An optional description of this resource. - An optional description of this resource.
required: false required: false
type: str
name: name:
description: description:
- Name of the resource. The name must be 1-63 characters long, and comply with - Name of the resource. The name must be 1-63 characters long, and comply with
@ -82,6 +85,7 @@ options:
be a lowercase letter, and all following characters must be a dash, lowercase be a lowercase letter, and all following characters must be a dash, lowercase
letter, or digit, except the last character, which cannot be a dash. letter, or digit, except the last character, which cannot be a dash.
required: true required: true
type: str
network_tier: network_tier:
description: description:
- 'The networking tier used for configuring this address. This field can take - 'The networking tier used for configuring this address. This field can take
@ -89,6 +93,7 @@ options:
is assumed to be PREMIUM.' is assumed to be PREMIUM.'
- 'Some valid choices include: "PREMIUM", "STANDARD"' - 'Some valid choices include: "PREMIUM", "STANDARD"'
required: false required: false
type: str
version_added: 2.8 version_added: 2.8
subnetwork: subnetwork:
description: description:
@ -102,12 +107,14 @@ options:
to a gcp_compute_subnetwork task and then set this subnetwork field to "{{ name-of-resource to a gcp_compute_subnetwork task and then set this subnetwork field to "{{ name-of-resource
}}"' }}"'
required: false required: false
type: dict
version_added: 2.7 version_added: 2.7
region: region:
description: description:
- URL of the region where the regional address resides. - URL of the region where the regional address resides.
- This field is not applicable to global addresses. - This field is not applicable to global addresses.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/beta/addresses)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/beta/addresses)'

View file

@ -50,6 +50,7 @@ options:
- URL of the region where the regional address resides. - URL of the region where the regional address resides.
- This field is not applicable to global addresses. - This field is not applicable to global addresses.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -55,10 +55,12 @@ options:
description: description:
- Cloud Storage bucket name. - Cloud Storage bucket name.
required: true required: true
type: str
cdn_policy: cdn_policy:
description: description:
- Cloud CDN configuration for this Backend Bucket. - Cloud CDN configuration for this Backend Bucket.
required: false required: false
type: dict
version_added: 2.8 version_added: 2.8
suboptions: suboptions:
signed_url_cache_max_age_sec: signed_url_cache_max_age_sec:
@ -72,11 +74,13 @@ options:
The actual headers served in responses will not be altered.' The actual headers served in responses will not be altered.'
required: false required: false
default: '3600' default: '3600'
type: int
description: description:
description: description:
- An optional textual description of the resource; provided by the client when - An optional textual description of the resource; provided by the client when
the resource is created. the resource is created.
required: false required: false
type: str
enable_cdn: enable_cdn:
description: description:
- If true, enable Cloud CDN for this BackendBucket. - If true, enable Cloud CDN for this BackendBucket.
@ -91,6 +95,7 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/backendBuckets)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/backendBuckets)'

View file

@ -58,10 +58,12 @@ options:
session (or equivalent). The maximum allowed value for TTL is one day. session (or equivalent). The maximum allowed value for TTL is one day.
- When the load balancing scheme is INTERNAL, this field is not used. - When the load balancing scheme is INTERNAL, this field is not used.
required: false required: false
type: int
backends: backends:
description: description:
- The set of backends that serve this BackendService. - The set of backends that serve this BackendService.
required: false required: false
type: list
suboptions: suboptions:
balancing_mode: balancing_mode:
description: description:
@ -71,6 +73,7 @@ options:
- 'Some valid choices include: "UTILIZATION", "RATE", "CONNECTION"' - 'Some valid choices include: "UTILIZATION", "RATE", "CONNECTION"'
required: false required: false
default: UTILIZATION default: UTILIZATION
type: str
capacity_scaler: capacity_scaler:
description: description:
- A multiplier applied to the group's maximum servicing capacity (based on - A multiplier applied to the group's maximum servicing capacity (based on
@ -81,11 +84,13 @@ options:
[0.0,1.0]. [0.0,1.0].
required: false required: false
default: '1.0' default: '1.0'
type: str
description: description:
description: description:
- An optional description of this resource. - An optional description of this resource.
- Provide this property when you create the resource. - Provide this property when you create the resource.
required: false required: false
type: str
group: group:
description: description:
- The fully-qualified URL of an Instance Group or Network Endpoint Group resource. - The fully-qualified URL of an Instance Group or Network Endpoint Group resource.
@ -101,6 +106,7 @@ options:
- Note that you must specify an Instance Group or Network Endpoint Group resource - Note that you must specify an Instance Group or Network Endpoint Group resource
using the fully-qualified URL, rather than a partial URL. using the fully-qualified URL, rather than a partial URL.
required: false required: false
type: str
max_connections: max_connections:
description: description:
- The max number of simultaneous connections for the group. Can be used with - The max number of simultaneous connections for the group. Can be used with
@ -108,6 +114,7 @@ options:
- For CONNECTION mode, either maxConnections or one of maxConnectionsPerInstance - For CONNECTION mode, either maxConnections or one of maxConnectionsPerInstance
or maxConnectionsPerEndpoint, as appropriate for group type, must be set. or maxConnectionsPerEndpoint, as appropriate for group type, must be set.
required: false required: false
type: int
max_connections_per_instance: max_connections_per_instance:
description: description:
- The max number of simultaneous connections that a single backend instance - The max number of simultaneous connections that a single backend instance
@ -116,6 +123,7 @@ options:
- For CONNECTION mode, either maxConnections or maxConnectionsPerInstance - For CONNECTION mode, either maxConnections or maxConnectionsPerInstance
must be set. must be set.
required: false required: false
type: int
max_connections_per_endpoint: max_connections_per_endpoint:
description: description:
- The max number of simultaneous connections that a single backend network - The max number of simultaneous connections that a single backend network
@ -124,6 +132,7 @@ options:
- For CONNECTION mode, either maxConnections or maxConnectionsPerEndpoint - For CONNECTION mode, either maxConnections or maxConnectionsPerEndpoint
must be set. must be set.
required: false required: false
type: int
version_added: 2.9 version_added: 2.9
max_rate: max_rate:
description: description:
@ -132,6 +141,7 @@ options:
if RATE mode. For RATE mode, either maxRate or one of maxRatePerInstance if RATE mode. For RATE mode, either maxRate or one of maxRatePerInstance
or maxRatePerEndpoint, as appropriate for group type, must be set. or maxRatePerEndpoint, as appropriate for group type, must be set.
required: false required: false
type: int
max_rate_per_instance: max_rate_per_instance:
description: description:
- The max requests per second (RPS) that a single backend instance can handle. - The max requests per second (RPS) that a single backend instance can handle.
@ -139,6 +149,7 @@ options:
balancing mode. For RATE mode, either maxRate or maxRatePerInstance must balancing mode. For RATE mode, either maxRate or maxRatePerInstance must
be set. be set.
required: false required: false
type: str
max_rate_per_endpoint: max_rate_per_endpoint:
description: description:
- The max requests per second (RPS) that a single backend network endpoint - The max requests per second (RPS) that a single backend network endpoint
@ -146,6 +157,7 @@ options:
used in either balancing mode. For RATE mode, either maxRate or maxRatePerEndpoint used in either balancing mode. For RATE mode, either maxRate or maxRatePerEndpoint
must be set. must be set.
required: false required: false
type: str
version_added: 2.9 version_added: 2.9
max_utilization: max_utilization:
description: description:
@ -153,15 +165,18 @@ options:
target for the group. The default is 0.8. Valid range is [0.0, 1.0]. target for the group. The default is 0.8. Valid range is [0.0, 1.0].
required: false required: false
default: '0.8' default: '0.8'
type: str
cdn_policy: cdn_policy:
description: description:
- Cloud CDN configuration for this BackendService. - Cloud CDN configuration for this BackendService.
required: false required: false
type: dict
suboptions: suboptions:
cache_key_policy: cache_key_policy:
description: description:
- The CacheKeyPolicy for this CdnPolicy. - The CacheKeyPolicy for this CdnPolicy.
required: false required: false
type: dict
suboptions: suboptions:
include_host: include_host:
description: description:
@ -188,6 +203,7 @@ options:
or query_string_blacklist, not both. or query_string_blacklist, not both.
- "'&' and '=' will be percent encoded and not treated as delimiters." - "'&' and '=' will be percent encoded and not treated as delimiters."
required: false required: false
type: list
query_string_whitelist: query_string_whitelist:
description: description:
- Names of query string parameters to include in cache keys. - Names of query string parameters to include in cache keys.
@ -195,6 +211,7 @@ options:
or query_string_blacklist, not both. or query_string_blacklist, not both.
- "'&' and '=' will be percent encoded and not treated as delimiters." - "'&' and '=' will be percent encoded and not treated as delimiters."
required: false required: false
type: list
signed_url_cache_max_age_sec: signed_url_cache_max_age_sec:
description: description:
- Maximum number of seconds the response to a signed URL request will be considered - Maximum number of seconds the response to a signed URL request will be considered
@ -206,11 +223,13 @@ options:
The actual headers served in responses will not be altered.' The actual headers served in responses will not be altered.'
required: false required: false
default: '3600' default: '3600'
type: int
version_added: 2.8 version_added: 2.8
connection_draining: connection_draining:
description: description:
- Settings for connection draining . - Settings for connection draining .
required: false required: false
type: dict
suboptions: suboptions:
draining_timeout_sec: draining_timeout_sec:
description: description:
@ -218,10 +237,12 @@ options:
still work to finish started). still work to finish started).
required: false required: false
default: '300' default: '300'
type: int
description: description:
description: description:
- An optional description of this resource. - An optional description of this resource.
required: false required: false
type: str
enable_cdn: enable_cdn:
description: description:
- If true, enable Cloud CDN for this BackendService. - If true, enable Cloud CDN for this BackendService.
@ -235,10 +256,12 @@ options:
- For internal load balancing, a URL to a HealthCheck resource must be specified - For internal load balancing, a URL to a HealthCheck resource must be specified
instead. instead.
required: true required: true
type: list
iap: iap:
description: description:
- Settings for enabling Cloud Identity Aware Proxy. - Settings for enabling Cloud Identity Aware Proxy.
required: false required: false
type: dict
version_added: 2.7 version_added: 2.7
suboptions: suboptions:
enabled: enabled:
@ -250,10 +273,12 @@ options:
description: description:
- OAuth2 Client ID for IAP . - OAuth2 Client ID for IAP .
required: true required: true
type: str
oauth2_client_secret: oauth2_client_secret:
description: description:
- OAuth2 Client Secret for IAP . - OAuth2 Client Secret for IAP .
required: true required: true
type: str
load_balancing_scheme: load_balancing_scheme:
description: description:
- Indicates whether the backend service will be used with internal or external - Indicates whether the backend service will be used with internal or external
@ -263,6 +288,7 @@ options:
- 'Some valid choices include: "EXTERNAL", "INTERNAL_SELF_MANAGED"' - 'Some valid choices include: "EXTERNAL", "INTERNAL_SELF_MANAGED"'
required: false required: false
default: EXTERNAL default: EXTERNAL
type: str
version_added: 2.7 version_added: 2.7
name: name:
description: description:
@ -273,11 +299,13 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
port_name: port_name:
description: description:
- Name of backend port. The same name should appear in the instance groups referenced - Name of backend port. The same name should appear in the instance groups referenced
by this service. Required when the load balancing scheme is EXTERNAL. by this service. Required when the load balancing scheme is EXTERNAL.
required: false required: false
type: str
protocol: protocol:
description: description:
- The protocol this BackendService uses to communicate with backends. - The protocol this BackendService uses to communicate with backends.
@ -286,10 +314,12 @@ options:
in errors if used with the GA API.' in errors if used with the GA API.'
- 'Some valid choices include: "HTTP", "HTTPS", "HTTP2", "TCP", "SSL"' - 'Some valid choices include: "HTTP", "HTTPS", "HTTP2", "TCP", "SSL"'
required: false required: false
type: str
security_policy: security_policy:
description: description:
- The security policy associated with this backend service. - The security policy associated with this backend service.
required: false required: false
type: str
version_added: 2.8 version_added: 2.8
session_affinity: session_affinity:
description: description:
@ -298,11 +328,13 @@ options:
- When the protocol is UDP, this field is not used. - When the protocol is UDP, this field is not used.
- 'Some valid choices include: "NONE", "CLIENT_IP", "GENERATED_COOKIE"' - 'Some valid choices include: "NONE", "CLIENT_IP", "GENERATED_COOKIE"'
required: false required: false
type: str
timeout_sec: timeout_sec:
description: description:
- How many seconds to wait for the backend before considering it a failed request. - How many seconds to wait for the backend before considering it a failed request.
Default is 30 seconds. Valid range is [1, 86400]. Default is 30 seconds. Valid range is [1, 86400].
required: false required: false
type: int
aliases: aliases:
- timeout_seconds - timeout_seconds
extends_documentation_fragment: gcp extends_documentation_fragment: gcp

View file

@ -62,15 +62,18 @@ options:
- An optional description of this resource. Provide this property when you create - An optional description of this resource. Provide this property when you create
the resource. the resource.
required: false required: false
type: str
labels: labels:
description: description:
- Labels to apply to this disk. A list of key->value pairs. - Labels to apply to this disk. A list of key->value pairs.
required: false required: false
type: dict
version_added: 2.7 version_added: 2.7
licenses: licenses:
description: description:
- Any applicable publicly visible licenses. - Any applicable publicly visible licenses.
required: false required: false
type: list
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -80,6 +83,7 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
size_gb: size_gb:
description: description:
- Size of the persistent disk, specified in GB. You can specify this field when - Size of the persistent disk, specified in GB. You can specify this field when
@ -89,6 +93,7 @@ options:
of sizeGb must not be less than the size of the sourceImage or the size of the of sizeGb must not be less than the size of the sourceImage or the size of the
snapshot. snapshot.
required: false required: false
type: int
physical_block_size_bytes: physical_block_size_bytes:
description: description:
- Physical block size of the persistent disk, in bytes. If not present in a request, - Physical block size of the persistent disk, in bytes. If not present in a request,
@ -97,12 +102,14 @@ options:
- If an unsupported value is requested, the error message will list the supported - If an unsupported value is requested, the error message will list the supported
values for the caller's project. values for the caller's project.
required: false required: false
type: int
version_added: 2.8 version_added: 2.8
type: type:
description: description:
- URL of the disk type resource describing which disk type to use to create the - URL of the disk type resource describing which disk type to use to create the
disk. Provide this when creating the disk. disk. Provide this when creating the disk.
required: false required: false
type: str
version_added: 2.7 version_added: 2.7
source_image: source_image:
description: description:
@ -118,25 +125,30 @@ options:
image in that family. Replace the image name with family/family-name: global/images/family/my-private-family image in that family. Replace the image name with family/family-name: global/images/family/my-private-family
.' .'
required: false required: false
type: str
zone: zone:
description: description:
- A reference to the zone where the disk resides. - A reference to the zone where the disk resides.
required: true required: true
type: str
source_image_encryption_key: source_image_encryption_key:
description: description:
- The customer-supplied encryption key of the source image. Required if the source - The customer-supplied encryption key of the source image. Required if the source
image is protected by a customer-supplied encryption key. image is protected by a customer-supplied encryption key.
required: false required: false
type: dict
suboptions: suboptions:
raw_key: raw_key:
description: description:
- Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648 - Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648
base64 to either encrypt or decrypt this resource. base64 to either encrypt or decrypt this resource.
required: false required: false
type: str
kms_key_name: kms_key_name:
description: description:
- The name of the encryption key that is stored in Google Cloud KMS. - The name of the encryption key that is stored in Google Cloud KMS.
required: false required: false
type: str
disk_encryption_key: disk_encryption_key:
description: description:
- Encrypts the disk using a customer-supplied encryption key. - Encrypts the disk using a customer-supplied encryption key.
@ -148,16 +160,19 @@ options:
will be encrypted using an automatically generated key and you do not need to will be encrypted using an automatically generated key and you do not need to
provide a key to use the disk later. provide a key to use the disk later.
required: false required: false
type: dict
suboptions: suboptions:
raw_key: raw_key:
description: description:
- Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648 - Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648
base64 to either encrypt or decrypt this resource. base64 to either encrypt or decrypt this resource.
required: false required: false
type: str
kms_key_name: kms_key_name:
description: description:
- The name of the encryption key that is stored in Google Cloud KMS. - The name of the encryption key that is stored in Google Cloud KMS.
required: false required: false
type: str
source_snapshot: source_snapshot:
description: description:
- The source snapshot used to create this disk. You can provide this as a partial - The source snapshot used to create this disk. You can provide this as a partial
@ -168,21 +183,25 @@ options:
to a gcp_compute_snapshot task and then set this source_snapshot field to "{{ to a gcp_compute_snapshot task and then set this source_snapshot field to "{{
name-of-resource }}"' name-of-resource }}"'
required: false required: false
type: dict
source_snapshot_encryption_key: source_snapshot_encryption_key:
description: description:
- The customer-supplied encryption key of the source snapshot. Required if the - The customer-supplied encryption key of the source snapshot. Required if the
source snapshot is protected by a customer-supplied encryption key. source snapshot is protected by a customer-supplied encryption key.
required: false required: false
type: dict
suboptions: suboptions:
raw_key: raw_key:
description: description:
- Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648 - Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648
base64 to either encrypt or decrypt this resource. base64 to either encrypt or decrypt this resource.
required: false required: false
type: str
kms_key_name: kms_key_name:
description: description:
- The name of the encryption key that is stored in Google Cloud KMS. - The name of the encryption key that is stored in Google Cloud KMS.
required: false required: false
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/disks)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/disks)'

View file

@ -49,6 +49,7 @@ options:
description: description:
- A reference to the zone where the disk resides. - A reference to the zone where the disk resides.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -59,6 +59,7 @@ options:
- The list of ALLOW rules specified by this firewall. Each rule specifies a protocol - The list of ALLOW rules specified by this firewall. Each rule specifies a protocol
and port-range tuple that describes a permitted connection. and port-range tuple that describes a permitted connection.
required: false required: false
type: list
suboptions: suboptions:
ip_protocol: ip_protocol:
description: description:
@ -67,6 +68,7 @@ options:
well known protocol strings (tcp, udp, icmp, esp, ah, sctp), or the IP protocol well known protocol strings (tcp, udp, icmp, esp, ah, sctp), or the IP protocol
number. number.
required: true required: true
type: str
ports: ports:
description: description:
- An optional list of ports to which this rule applies. This field is only - An optional list of ports to which this rule applies. This field is only
@ -75,11 +77,13 @@ options:
port. port.
- 'Example inputs include: ["22"], ["80","443"], and ["12345-12349"].' - 'Example inputs include: ["22"], ["80","443"], and ["12345-12349"].'
required: false required: false
type: list
denied: denied:
description: description:
- The list of DENY rules specified by this firewall. Each rule specifies a protocol - The list of DENY rules specified by this firewall. Each rule specifies a protocol
and port-range tuple that describes a denied connection. and port-range tuple that describes a denied connection.
required: false required: false
type: list
version_added: 2.8 version_added: 2.8
suboptions: suboptions:
ip_protocol: ip_protocol:
@ -89,6 +93,7 @@ options:
well known protocol strings (tcp, udp, icmp, esp, ah, sctp), or the IP protocol well known protocol strings (tcp, udp, icmp, esp, ah, sctp), or the IP protocol
number. number.
required: true required: true
type: str
ports: ports:
description: description:
- An optional list of ports to which this rule applies. This field is only - An optional list of ports to which this rule applies. This field is only
@ -97,17 +102,20 @@ options:
port. port.
- 'Example inputs include: ["22"], ["80","443"], and ["12345-12349"].' - 'Example inputs include: ["22"], ["80","443"], and ["12345-12349"].'
required: false required: false
type: list
description: description:
description: description:
- An optional description of this resource. Provide this property when you create - An optional description of this resource. Provide this property when you create
the resource. the resource.
required: false required: false
type: str
destination_ranges: destination_ranges:
description: description:
- If destination ranges are specified, the firewall will apply only to traffic - If destination ranges are specified, the firewall will apply only to traffic
that has destination IP address in these ranges. These ranges must be expressed that has destination IP address in these ranges. These ranges must be expressed
in CIDR format. Only IPv4 is supported. in CIDR format. Only IPv4 is supported.
required: false required: false
type: list
version_added: 2.8 version_added: 2.8
direction: direction:
description: description:
@ -116,6 +124,7 @@ options:
traffic, it is NOT supported to specify sourceRanges OR sourceTags.' traffic, it is NOT supported to specify sourceRanges OR sourceTags.'
- 'Some valid choices include: "INGRESS", "EGRESS"' - 'Some valid choices include: "INGRESS", "EGRESS"'
required: false required: false
type: str
version_added: 2.8 version_added: 2.8
disabled: disabled:
description: description:
@ -135,6 +144,7 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
network: network:
description: description:
- 'URL of the network resource for this firewall rule. If not specified when creating - 'URL of the network resource for this firewall rule. If not specified when creating
@ -151,6 +161,7 @@ options:
required: false required: false
default: default:
selfLink: global/networks/default selfLink: global/networks/default
type: dict
priority: priority:
description: description:
- Priority for this rule. This is an integer between 0 and 65535, both inclusive. - Priority for this rule. This is an integer between 0 and 65535, both inclusive.
@ -160,6 +171,7 @@ options:
1). DENY rules take precedence over ALLOW rules having equal priority. 1). DENY rules take precedence over ALLOW rules having equal priority.
required: false required: false
default: '1000' default: '1000'
type: int
version_added: 2.8 version_added: 2.8
source_ranges: source_ranges:
description: description:
@ -171,6 +183,7 @@ options:
property. The connection does not need to match both properties for the firewall property. The connection does not need to match both properties for the firewall
to apply. Only IPv4 is supported. to apply. Only IPv4 is supported.
required: false required: false
type: list
source_service_accounts: source_service_accounts:
description: description:
- If source service accounts are specified, the firewall will apply only to traffic - If source service accounts are specified, the firewall will apply only to traffic
@ -183,6 +196,7 @@ options:
The connection does not need to match both properties for the firewall to apply. The connection does not need to match both properties for the firewall to apply.
sourceServiceAccounts cannot be used at the same time as sourceTags or targetTags. sourceServiceAccounts cannot be used at the same time as sourceTags or targetTags.
required: false required: false
type: list
version_added: 2.8 version_added: 2.8
source_tags: source_tags:
description: description:
@ -195,6 +209,7 @@ options:
tag listed in the sourceTags property. The connection does not need to match tag listed in the sourceTags property. The connection does not need to match
both properties for the firewall to apply. both properties for the firewall to apply.
required: false required: false
type: list
target_service_accounts: target_service_accounts:
description: description:
- A list of service accounts indicating sets of instances located in the network - A list of service accounts indicating sets of instances located in the network
@ -203,6 +218,7 @@ options:
If neither targetServiceAccounts nor targetTags are specified, the firewall If neither targetServiceAccounts nor targetTags are specified, the firewall
rule applies to all instances on the specified network. rule applies to all instances on the specified network.
required: false required: false
type: list
version_added: 2.8 version_added: 2.8
target_tags: target_tags:
description: description:
@ -211,6 +227,7 @@ options:
- If no targetTags are specified, the firewall rule applies to all instances on - If no targetTags are specified, the firewall rule applies to all instances on
the specified network. the specified network.
required: false required: false
type: list
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/firewalls)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/firewalls)'

View file

@ -54,6 +54,7 @@ options:
- An optional description of this resource. Provide this property when you create - An optional description of this resource. Provide this property when you create
the resource. the resource.
required: false required: false
type: str
ip_address: ip_address:
description: description:
- The IP address that this forwarding rule is serving on behalf of. - The IP address that this forwarding rule is serving on behalf of.
@ -76,6 +77,7 @@ options:
* projects/project/regions/region/addresses/address * regions/region/addresses/address * projects/project/regions/region/addresses/address * regions/region/addresses/address
* global/addresses/address * address .' * global/addresses/address * address .'
required: false required: false
type: str
ip_protocol: ip_protocol:
description: description:
- The IP protocol to which this rule applies. Valid options are TCP, UDP, ESP, - The IP protocol to which this rule applies. Valid options are TCP, UDP, ESP,
@ -83,6 +85,7 @@ options:
- When the load balancing scheme is INTERNAL, only TCP and UDP are valid. - When the load balancing scheme is INTERNAL, only TCP and UDP are valid.
- 'Some valid choices include: "TCP", "UDP", "ESP", "AH", "SCTP", "ICMP"' - 'Some valid choices include: "TCP", "UDP", "ESP", "AH", "SCTP", "ICMP"'
required: false required: false
type: str
backend_service: backend_service:
description: description:
- A BackendService to receive the matched traffic. This is used only for INTERNAL - A BackendService to receive the matched traffic. This is used only for INTERNAL
@ -93,11 +96,13 @@ options:
name-of-resource` to a gcp_compute_backend_service task and then set this backend_service name-of-resource` to a gcp_compute_backend_service task and then set this backend_service
field to "{{ name-of-resource }}"' field to "{{ name-of-resource }}"'
required: false required: false
type: dict
ip_version: ip_version:
description: description:
- ipVersion is not a valid field for regional forwarding rules. - ipVersion is not a valid field for regional forwarding rules.
- 'Some valid choices include: "IPV4", "IPV6"' - 'Some valid choices include: "IPV4", "IPV6"'
required: false required: false
type: str
load_balancing_scheme: load_balancing_scheme:
description: description:
- 'This signifies what the ForwardingRule will be used for and can only take the - 'This signifies what the ForwardingRule will be used for and can only take the
@ -107,6 +112,7 @@ options:
TCP/UDP LB, SSL Proxy) .' TCP/UDP LB, SSL Proxy) .'
- 'Some valid choices include: "INTERNAL", "EXTERNAL"' - 'Some valid choices include: "INTERNAL", "EXTERNAL"'
required: false required: false
type: str
name: name:
description: description:
- Name of the resource; provided by the client when the resource is created. The - Name of the resource; provided by the client when the resource is created. The
@ -116,6 +122,7 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
network: network:
description: description:
- For internal load balancing, this field identifies the network that the load - For internal load balancing, this field identifies the network that the load
@ -128,6 +135,7 @@ options:
to a gcp_compute_network task and then set this network field to "{{ name-of-resource to a gcp_compute_network task and then set this network field to "{{ name-of-resource
}}"' }}"'
required: false required: false
type: dict
port_range: port_range:
description: description:
- This field is used along with the target field for TargetHttpProxy, TargetHttpsProxy, - This field is used along with the target field for TargetHttpProxy, TargetHttpsProxy,
@ -142,6 +150,7 @@ options:
43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1883, 5222 * TargetVpnGateway: 43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1883, 5222 * TargetVpnGateway:
500, 4500 .' 500, 4500 .'
required: false required: false
type: str
ports: ports:
description: description:
- This field is used along with the backend_service field for internal load balancing. - This field is used along with the backend_service field for internal load balancing.
@ -150,6 +159,7 @@ options:
be forwarded to the backends configured with this forwarding rule. be forwarded to the backends configured with this forwarding rule.
- You may specify a maximum of up to 5 ports. - You may specify a maximum of up to 5 ports.
required: false required: false
type: list
subnetwork: subnetwork:
description: description:
- The subnetwork that the load balanced IP should belong to for this Forwarding - The subnetwork that the load balanced IP should belong to for this Forwarding
@ -162,6 +172,7 @@ options:
to a gcp_compute_subnetwork task and then set this subnetwork field to "{{ name-of-resource to a gcp_compute_subnetwork task and then set this subnetwork field to "{{ name-of-resource
}}"' }}"'
required: false required: false
type: dict
target: target:
description: description:
- This field is only used for EXTERNAL load balancing. - This field is only used for EXTERNAL load balancing.
@ -174,6 +185,7 @@ options:
to a gcp_compute_target_pool task and then set this target field to "{{ name-of-resource to a gcp_compute_target_pool task and then set this target field to "{{ name-of-resource
}}"' }}"'
required: false required: false
type: dict
version_added: 2.7 version_added: 2.7
all_ports: all_ports:
description: description:
@ -191,6 +203,7 @@ options:
is assumed to be PREMIUM.' is assumed to be PREMIUM.'
- 'Some valid choices include: "PREMIUM", "STANDARD"' - 'Some valid choices include: "PREMIUM", "STANDARD"'
required: false required: false
type: str
version_added: 2.8 version_added: 2.8
service_label: service_label:
description: description:
@ -203,12 +216,14 @@ options:
except the last character, which cannot be a dash. except the last character, which cannot be a dash.
- This field is only used for INTERNAL load balancing. - This field is only used for INTERNAL load balancing.
required: false required: false
type: str
version_added: 2.8 version_added: 2.8
region: region:
description: description:
- A reference to the region where the regional forwarding rule resides. - A reference to the region where the regional forwarding rule resides.
- This field is not applicable to global forwarding rules. - This field is not applicable to global forwarding rules.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/forwardingRule)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/forwardingRule)'

View file

@ -50,6 +50,7 @@ options:
- A reference to the region where the regional forwarding rule resides. - A reference to the region where the regional forwarding rule resides.
- This field is not applicable to global forwarding rules. - This field is not applicable to global forwarding rules.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -52,11 +52,13 @@ options:
description: description:
- The static external IP address represented by this resource. - The static external IP address represented by this resource.
required: false required: false
type: str
version_added: 2.8 version_added: 2.8
description: description:
description: description:
- An optional description of this resource. - An optional description of this resource.
required: false required: false
type: str
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -66,18 +68,21 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
ip_version: ip_version:
description: description:
- The IP Version that will be used by this address. Valid options are `IPV4` or - The IP Version that will be used by this address. Valid options are `IPV4` or
`IPV6`. The default value is `IPV4`. `IPV6`. The default value is `IPV4`.
- 'Some valid choices include: "IPV4", "IPV6"' - 'Some valid choices include: "IPV4", "IPV6"'
required: false required: false
type: str
prefix_length: prefix_length:
description: description:
- The prefix length of the IP range. If not present, it means the address field - The prefix length of the IP range. If not present, it means the address field
is a single IP address. is a single IP address.
- This field is not applicable to addresses with addressType=EXTERNAL. - This field is not applicable to addresses with addressType=EXTERNAL.
required: false required: false
type: int
version_added: 2.9 version_added: 2.9
address_type: address_type:
description: description:
@ -87,6 +92,7 @@ options:
- 'Some valid choices include: "EXTERNAL", "INTERNAL"' - 'Some valid choices include: "EXTERNAL", "INTERNAL"'
required: false required: false
default: EXTERNAL default: EXTERNAL
type: str
version_added: 2.8 version_added: 2.8
purpose: purpose:
description: description:
@ -94,6 +100,7 @@ options:
- for peer networks This should only be set when using an Internal address. - for peer networks This should only be set when using an Internal address.
- 'Some valid choices include: "VPC_PEERING"' - 'Some valid choices include: "VPC_PEERING"'
required: false required: false
type: str
version_added: 2.9 version_added: 2.9
network: network:
description: description:
@ -107,6 +114,7 @@ options:
to a gcp_compute_network task and then set this network field to "{{ name-of-resource to a gcp_compute_network task and then set this network field to "{{ name-of-resource
}}"' }}"'
required: false required: false
type: dict
version_added: 2.9 version_added: 2.9
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:

View file

@ -56,6 +56,7 @@ options:
- An optional description of this resource. Provide this property when you create - An optional description of this resource. Provide this property when you create
the resource. the resource.
required: false required: false
type: str
ip_address: ip_address:
description: description:
- The IP address that this forwarding rule is serving on behalf of. - The IP address that this forwarding rule is serving on behalf of.
@ -78,6 +79,7 @@ options:
* projects/project/regions/region/addresses/address * regions/region/addresses/address * projects/project/regions/region/addresses/address * regions/region/addresses/address
* global/addresses/address * address .' * global/addresses/address * address .'
required: false required: false
type: str
ip_protocol: ip_protocol:
description: description:
- The IP protocol to which this rule applies. Valid options are TCP, UDP, ESP, - The IP protocol to which this rule applies. Valid options are TCP, UDP, ESP,
@ -85,12 +87,14 @@ options:
TCP is valid. TCP is valid.
- 'Some valid choices include: "TCP", "UDP", "ESP", "AH", "SCTP", "ICMP"' - 'Some valid choices include: "TCP", "UDP", "ESP", "AH", "SCTP", "ICMP"'
required: false required: false
type: str
ip_version: ip_version:
description: description:
- The IP Version that will be used by this global forwarding rule. - The IP Version that will be used by this global forwarding rule.
- Valid options are IPV4 or IPV6. - Valid options are IPV4 or IPV6.
- 'Some valid choices include: "IPV4", "IPV6"' - 'Some valid choices include: "IPV4", "IPV6"'
required: false required: false
type: str
load_balancing_scheme: load_balancing_scheme:
description: description:
- This signifies what the GlobalForwardingRule will be used for. - This signifies what the GlobalForwardingRule will be used for.
@ -101,6 +105,7 @@ options:
- 'Some valid choices include: "INTERNAL_SELF_MANAGED", "EXTERNAL"' - 'Some valid choices include: "INTERNAL_SELF_MANAGED", "EXTERNAL"'
required: false required: false
default: EXTERNAL default: EXTERNAL
type: str
name: name:
description: description:
- Name of the resource; provided by the client when the resource is created. The - Name of the resource; provided by the client when the resource is created. The
@ -110,6 +115,7 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
network: network:
description: description:
- This field is not used for external load balancing. - This field is not used for external load balancing.
@ -122,6 +128,7 @@ options:
to a gcp_compute_network task and then set this network field to "{{ name-of-resource to a gcp_compute_network task and then set this network field to "{{ name-of-resource
}}"' }}"'
required: false required: false
type: dict
port_range: port_range:
description: description:
- This field is used along with the target field for TargetHttpProxy, TargetHttpsProxy, - This field is used along with the target field for TargetHttpProxy, TargetHttpsProxy,
@ -136,11 +143,13 @@ options:
43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1883, 5222 * TargetVpnGateway: 43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1883, 5222 * TargetVpnGateway:
500, 4500 .' 500, 4500 .'
required: false required: false
type: str
target: target:
description: description:
- The URL of the target resource to receive the matched traffic. - The URL of the target resource to receive the matched traffic.
- The forwarded traffic must be of a type appropriate to the target object. - The forwarded traffic must be of a type appropriate to the target object.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -60,17 +60,20 @@ options:
- How often (in seconds) to send a health check. The default value is 5 seconds. - How often (in seconds) to send a health check. The default value is 5 seconds.
required: false required: false
default: '5' default: '5'
type: int
description: description:
description: description:
- An optional description of this resource. Provide this property when you create - An optional description of this resource. Provide this property when you create
the resource. the resource.
required: false required: false
type: str
healthy_threshold: healthy_threshold:
description: description:
- A so-far unhealthy instance will be marked healthy after this many consecutive - A so-far unhealthy instance will be marked healthy after this many consecutive
successes. The default value is 2. successes. The default value is 2.
required: false required: false
default: '2' default: '2'
type: int
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -80,6 +83,7 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
timeout_sec: timeout_sec:
description: description:
- How long (in seconds) to wait before claiming failure. - How long (in seconds) to wait before claiming failure.
@ -87,6 +91,7 @@ options:
value than checkIntervalSec. value than checkIntervalSec.
required: false required: false
default: '5' default: '5'
type: int
aliases: aliases:
- timeout_seconds - timeout_seconds
unhealthy_threshold: unhealthy_threshold:
@ -95,6 +100,7 @@ options:
failures. The default value is 2. failures. The default value is 2.
required: false required: false
default: '2' default: '2'
type: int
type: type:
description: description:
- Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not - Specifies the type of the healthCheck, either TCP, SSL, HTTP or HTTPS. If not
@ -102,10 +108,12 @@ options:
field must be specified, which must match type field. field must be specified, which must match type field.
- 'Some valid choices include: "TCP", "SSL", "HTTP", "HTTPS"' - 'Some valid choices include: "TCP", "SSL", "HTTP", "HTTPS"'
required: false required: false
type: str
http_health_check: http_health_check:
description: description:
- A nested object resource. - A nested object resource.
required: false required: false
type: dict
suboptions: suboptions:
host: host:
description: description:
@ -113,28 +121,33 @@ options:
- If left empty (default value), the public IP on behalf of which this health - If left empty (default value), the public IP on behalf of which this health
check is performed will be used. check is performed will be used.
required: false required: false
type: str
request_path: request_path:
description: description:
- The request path of the HTTP health check request. - The request path of the HTTP health check request.
- The default value is /. - The default value is /.
required: false required: false
default: "/" default: "/"
type: str
response: response:
description: description:
- The bytes to match against the beginning of the response data. If left empty - The bytes to match against the beginning of the response data. If left empty
(the default value), any response will indicate health. The response data (the default value), any response will indicate health. The response data
can only be ASCII. can only be ASCII.
required: false required: false
type: str
port: port:
description: description:
- The TCP port number for the HTTP health check request. - The TCP port number for the HTTP health check request.
- The default value is 80. - The default value is 80.
required: false required: false
type: int
port_name: port_name:
description: description:
- Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name - Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name
are defined, port takes precedence. are defined, port takes precedence.
required: false required: false
type: str
proxy_header: proxy_header:
description: description:
- Specifies the type of proxy header to append before sending data to the - Specifies the type of proxy header to append before sending data to the
@ -142,10 +155,12 @@ options:
- 'Some valid choices include: "NONE", "PROXY_V1"' - 'Some valid choices include: "NONE", "PROXY_V1"'
required: false required: false
default: NONE default: NONE
type: str
https_health_check: https_health_check:
description: description:
- A nested object resource. - A nested object resource.
required: false required: false
type: dict
suboptions: suboptions:
host: host:
description: description:
@ -153,28 +168,33 @@ options:
- If left empty (default value), the public IP on behalf of which this health - If left empty (default value), the public IP on behalf of which this health
check is performed will be used. check is performed will be used.
required: false required: false
type: str
request_path: request_path:
description: description:
- The request path of the HTTPS health check request. - The request path of the HTTPS health check request.
- The default value is /. - The default value is /.
required: false required: false
default: "/" default: "/"
type: str
response: response:
description: description:
- The bytes to match against the beginning of the response data. If left empty - The bytes to match against the beginning of the response data. If left empty
(the default value), any response will indicate health. The response data (the default value), any response will indicate health. The response data
can only be ASCII. can only be ASCII.
required: false required: false
type: str
port: port:
description: description:
- The TCP port number for the HTTPS health check request. - The TCP port number for the HTTPS health check request.
- The default value is 443. - The default value is 443.
required: false required: false
type: int
port_name: port_name:
description: description:
- Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name - Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name
are defined, port takes precedence. are defined, port takes precedence.
required: false required: false
type: str
proxy_header: proxy_header:
description: description:
- Specifies the type of proxy header to append before sending data to the - Specifies the type of proxy header to append before sending data to the
@ -182,10 +202,12 @@ options:
- 'Some valid choices include: "NONE", "PROXY_V1"' - 'Some valid choices include: "NONE", "PROXY_V1"'
required: false required: false
default: NONE default: NONE
type: str
tcp_health_check: tcp_health_check:
description: description:
- A nested object resource. - A nested object resource.
required: false required: false
type: dict
suboptions: suboptions:
request: request:
description: description:
@ -193,22 +215,26 @@ options:
(default value is empty). If both request and response are empty, the connection (default value is empty). If both request and response are empty, the connection
establishment alone will indicate health. The request data can only be ASCII. establishment alone will indicate health. The request data can only be ASCII.
required: false required: false
type: str
response: response:
description: description:
- The bytes to match against the beginning of the response data. If left empty - The bytes to match against the beginning of the response data. If left empty
(the default value), any response will indicate health. The response data (the default value), any response will indicate health. The response data
can only be ASCII. can only be ASCII.
required: false required: false
type: str
port: port:
description: description:
- The TCP port number for the TCP health check request. - The TCP port number for the TCP health check request.
- The default value is 443. - The default value is 443.
required: false required: false
type: int
port_name: port_name:
description: description:
- Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name - Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name
are defined, port takes precedence. are defined, port takes precedence.
required: false required: false
type: str
proxy_header: proxy_header:
description: description:
- Specifies the type of proxy header to append before sending data to the - Specifies the type of proxy header to append before sending data to the
@ -216,10 +242,12 @@ options:
- 'Some valid choices include: "NONE", "PROXY_V1"' - 'Some valid choices include: "NONE", "PROXY_V1"'
required: false required: false
default: NONE default: NONE
type: str
ssl_health_check: ssl_health_check:
description: description:
- A nested object resource. - A nested object resource.
required: false required: false
type: dict
suboptions: suboptions:
request: request:
description: description:
@ -227,22 +255,26 @@ options:
(default value is empty). If both request and response are empty, the connection (default value is empty). If both request and response are empty, the connection
establishment alone will indicate health. The request data can only be ASCII. establishment alone will indicate health. The request data can only be ASCII.
required: false required: false
type: str
response: response:
description: description:
- The bytes to match against the beginning of the response data. If left empty - The bytes to match against the beginning of the response data. If left empty
(the default value), any response will indicate health. The response data (the default value), any response will indicate health. The response data
can only be ASCII. can only be ASCII.
required: false required: false
type: str
port: port:
description: description:
- The TCP port number for the SSL health check request. - The TCP port number for the SSL health check request.
- The default value is 443. - The default value is 443.
required: false required: false
type: int
port_name: port_name:
description: description:
- Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name - Port name as defined in InstanceGroup#NamedPort#name. If both port and port_name
are defined, port takes precedence. are defined, port takes precedence.
required: false required: false
type: str
proxy_header: proxy_header:
description: description:
- Specifies the type of proxy header to append before sending data to the - Specifies the type of proxy header to append before sending data to the
@ -250,6 +282,7 @@ options:
- 'Some valid choices include: "NONE", "PROXY_V1"' - 'Some valid choices include: "NONE", "PROXY_V1"'
required: false required: false
default: NONE default: NONE
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks)'

View file

@ -53,6 +53,7 @@ options:
- How often (in seconds) to send a health check. The default value is 5 seconds. - How often (in seconds) to send a health check. The default value is 5 seconds.
required: false required: false
default: '5' default: '5'
type: int
aliases: aliases:
- check_interval_seconds - check_interval_seconds
description: description:
@ -60,17 +61,20 @@ options:
- An optional description of this resource. Provide this property when you create - An optional description of this resource. Provide this property when you create
the resource. the resource.
required: false required: false
type: str
healthy_threshold: healthy_threshold:
description: description:
- A so-far unhealthy instance will be marked healthy after this many consecutive - A so-far unhealthy instance will be marked healthy after this many consecutive
successes. The default value is 2. successes. The default value is 2.
required: false required: false
type: int
host: host:
description: description:
- The value of the host header in the HTTP health check request. If left empty - The value of the host header in the HTTP health check request. If left empty
(default value), the public IP on behalf of which this health check is performed (default value), the public IP on behalf of which this health check is performed
will be used. will be used.
required: false required: false
type: str
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -80,22 +84,26 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
port: port:
description: description:
- The TCP port number for the HTTP health check request. - The TCP port number for the HTTP health check request.
- The default value is 80. - The default value is 80.
required: false required: false
type: int
request_path: request_path:
description: description:
- The request path of the HTTP health check request. - The request path of the HTTP health check request.
- The default value is /. - The default value is /.
required: false required: false
type: str
timeout_sec: timeout_sec:
description: description:
- How long (in seconds) to wait before claiming failure. - How long (in seconds) to wait before claiming failure.
- The default value is 5 seconds. It is invalid for timeoutSec to have greater - The default value is 5 seconds. It is invalid for timeoutSec to have greater
value than checkIntervalSec. value than checkIntervalSec.
required: false required: false
type: int
aliases: aliases:
- timeout_seconds - timeout_seconds
unhealthy_threshold: unhealthy_threshold:
@ -103,6 +111,7 @@ options:
- A so-far healthy instance will be marked unhealthy after this many consecutive - A so-far healthy instance will be marked unhealthy after this many consecutive
failures. The default value is 2. failures. The default value is 2.
required: false required: false
type: int
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/httpHealthChecks)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/httpHealthChecks)'

View file

@ -52,22 +52,26 @@ options:
description: description:
- How often (in seconds) to send a health check. The default value is 5 seconds. - How often (in seconds) to send a health check. The default value is 5 seconds.
required: false required: false
type: int
description: description:
description: description:
- An optional description of this resource. Provide this property when you create - An optional description of this resource. Provide this property when you create
the resource. the resource.
required: false required: false
type: str
healthy_threshold: healthy_threshold:
description: description:
- A so-far unhealthy instance will be marked healthy after this many consecutive - A so-far unhealthy instance will be marked healthy after this many consecutive
successes. The default value is 2. successes. The default value is 2.
required: false required: false
type: int
host: host:
description: description:
- The value of the host header in the HTTPS health check request. If left empty - The value of the host header in the HTTPS health check request. If left empty
(default value), the public IP on behalf of which this health check is performed (default value), the public IP on behalf of which this health check is performed
will be used. will be used.
required: false required: false
type: str
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -77,22 +81,26 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
port: port:
description: description:
- The TCP port number for the HTTPS health check request. - The TCP port number for the HTTPS health check request.
- The default value is 80. - The default value is 80.
required: false required: false
type: int
request_path: request_path:
description: description:
- The request path of the HTTPS health check request. - The request path of the HTTPS health check request.
- The default value is /. - The default value is /.
required: false required: false
type: str
timeout_sec: timeout_sec:
description: description:
- How long (in seconds) to wait before claiming failure. - How long (in seconds) to wait before claiming failure.
- The default value is 5 seconds. It is invalid for timeoutSec to have greater - The default value is 5 seconds. It is invalid for timeoutSec to have greater
value than checkIntervalSec. value than checkIntervalSec.
required: false required: false
type: int
aliases: aliases:
- timeout_seconds - timeout_seconds
unhealthy_threshold: unhealthy_threshold:
@ -100,6 +108,7 @@ options:
- A so-far healthy instance will be marked unhealthy after this many consecutive - A so-far healthy instance will be marked unhealthy after this many consecutive
failures. The default value is 2. failures. The default value is 2.
required: false required: false
type: int
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/httpsHealthChecks)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/httpsHealthChecks)'

View file

@ -62,10 +62,12 @@ options:
- An optional description of this resource. Provide this property when you create - An optional description of this resource. Provide this property when you create
the resource. the resource.
required: false required: false
type: str
disk_size_gb: disk_size_gb:
description: description:
- Size of the image when restored onto a persistent disk (in GB). - Size of the image when restored onto a persistent disk (in GB).
required: false required: false
type: int
family: family:
description: description:
- The name of the image family to which this image belongs. You can create disks - The name of the image family to which this image belongs. You can create disks
@ -73,6 +75,7 @@ options:
always returns its latest image that is not deprecated. The name of the image always returns its latest image that is not deprecated. The name of the image
family must comply with RFC1035. family must comply with RFC1035.
required: false required: false
type: str
guest_os_features: guest_os_features:
description: description:
- A list of features to enable on the guest OS. Applicable for bootable images - A list of features to enable on the guest OS. Applicable for bootable images
@ -84,6 +87,7 @@ options:
WINDOWS, to indicate that this is a Windows image. WINDOWS, to indicate that this is a Windows image.
- This value is purely informational and does not enable or disable any features. - This value is purely informational and does not enable or disable any features.
required: false required: false
type: list
suboptions: suboptions:
type: type:
description: description:
@ -93,27 +97,32 @@ options:
purely informational and does not enable or disable any features. purely informational and does not enable or disable any features.
- 'Some valid choices include: "VIRTIO_SCSI_MULTIQUEUE"' - 'Some valid choices include: "VIRTIO_SCSI_MULTIQUEUE"'
required: false required: false
type: str
image_encryption_key: image_encryption_key:
description: description:
- Encrypts the image using a customer-supplied encryption key. - Encrypts the image using a customer-supplied encryption key.
- After you encrypt an image with a customer-supplied key, you must provide the - After you encrypt an image with a customer-supplied key, you must provide the
same key if you use the image later (e.g. to create a disk from the image) . same key if you use the image later (e.g. to create a disk from the image) .
required: false required: false
type: dict
suboptions: suboptions:
raw_key: raw_key:
description: description:
- Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648 - Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648
base64 to either encrypt or decrypt this resource. base64 to either encrypt or decrypt this resource.
required: false required: false
type: str
labels: labels:
description: description:
- Labels to apply to this Image. - Labels to apply to this Image.
required: false required: false
type: dict
version_added: 2.8 version_added: 2.8
licenses: licenses:
description: description:
- Any applicable license URI. - Any applicable license URI.
required: false required: false
type: list
name: name:
description: description:
- Name of the resource; provided by the client when the resource is created. The - Name of the resource; provided by the client when the resource is created. The
@ -123,10 +132,12 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
raw_disk: raw_disk:
description: description:
- The parameters of the raw disk image. - The parameters of the raw disk image.
required: false required: false
type: dict
suboptions: suboptions:
container_type: container_type:
description: description:
@ -135,16 +146,19 @@ options:
format. Provided by the client when the disk image is created. format. Provided by the client when the disk image is created.
- 'Some valid choices include: "TAR"' - 'Some valid choices include: "TAR"'
required: false required: false
type: str
sha1_checksum: sha1_checksum:
description: description:
- An optional SHA1 checksum of the disk image before unpackaging. - An optional SHA1 checksum of the disk image before unpackaging.
- This is provided by the client when the disk image is created. - This is provided by the client when the disk image is created.
required: false required: false
type: str
source: source:
description: description:
- The full Google Cloud Storage URL where disk storage is stored You must - The full Google Cloud Storage URL where disk storage is stored You must
provide either this property or the sourceDisk property but not both. provide either this property or the sourceDisk property but not both.
required: true required: true
type: str
source_disk: source_disk:
description: description:
- The source disk to create this image based on. - The source disk to create this image based on.
@ -156,29 +170,34 @@ options:
to a gcp_compute_disk task and then set this source_disk field to "{{ name-of-resource to a gcp_compute_disk task and then set this source_disk field to "{{ name-of-resource
}}"' }}"'
required: false required: false
type: dict
source_disk_encryption_key: source_disk_encryption_key:
description: description:
- The customer-supplied encryption key of the source disk. Required if the source - The customer-supplied encryption key of the source disk. Required if the source
disk is protected by a customer-supplied encryption key. disk is protected by a customer-supplied encryption key.
required: false required: false
type: dict
suboptions: suboptions:
raw_key: raw_key:
description: description:
- Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648 - Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648
base64 to either encrypt or decrypt this resource. base64 to either encrypt or decrypt this resource.
required: false required: false
type: str
source_disk_id: source_disk_id:
description: description:
- The ID value of the disk used to create this image. This value may be used to - The ID value of the disk used to create this image. This value may be used to
determine whether the image was taken from the current or a previous instance determine whether the image was taken from the current or a previous instance
of a given disk name. of a given disk name.
required: false required: false
type: str
source_type: source_type:
description: description:
- The type of the image used to create this disk. The default and only value is - The type of the image used to create this disk. The default and only value is
RAW . RAW .
- 'Some valid choices include: "RAW"' - 'Some valid choices include: "RAW"'
required: false required: false
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/images)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/images)'

View file

@ -61,6 +61,7 @@ options:
- An array of disks that are associated with the instances that are created from - An array of disks that are associated with the instances that are created from
this template. this template.
required: false required: false
type: list
suboptions: suboptions:
auto_delete: auto_delete:
description: description:
@ -83,21 +84,25 @@ options:
the instance. This name can be used to reference the device for mounting, the instance. This name can be used to reference the device for mounting,
resizing, and so on, from within the instance. resizing, and so on, from within the instance.
required: false required: false
type: str
disk_encryption_key: disk_encryption_key:
description: description:
- Encrypts or decrypts a disk using a customer-supplied encryption key. - Encrypts or decrypts a disk using a customer-supplied encryption key.
required: false required: false
type: dict
suboptions: suboptions:
raw_key: raw_key:
description: description:
- Specifies a 256-bit customer-supplied encryption key, encoded in RFC - Specifies a 256-bit customer-supplied encryption key, encoded in RFC
4648 base64 to either encrypt or decrypt this resource. 4648 base64 to either encrypt or decrypt this resource.
required: false required: false
type: str
rsa_encrypted_key: rsa_encrypted_key:
description: description:
- Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit customer-supplied - Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit customer-supplied
encryption key to either encrypt or decrypt this resource. encryption key to either encrypt or decrypt this resource.
required: false required: false
type: str
index: index:
description: description:
- Assigns a zero-based index to this disk, where 0 is reserved for the boot - Assigns a zero-based index to this disk, where 0 is reserved for the boot
@ -105,28 +110,33 @@ options:
disk would have a unique index number. If not specified, the server will disk would have a unique index number. If not specified, the server will
choose an appropriate value. choose an appropriate value.
required: false required: false
type: int
initialize_params: initialize_params:
description: description:
- Specifies the parameters for a new disk that will be created alongside the - Specifies the parameters for a new disk that will be created alongside the
new instance. Use initialization parameters to create boot disks or local new instance. Use initialization parameters to create boot disks or local
SSDs attached to the new instance. SSDs attached to the new instance.
required: false required: false
type: dict
suboptions: suboptions:
disk_name: disk_name:
description: description:
- Specifies the disk name. If not specified, the default is to use the - Specifies the disk name. If not specified, the default is to use the
name of the instance. name of the instance.
required: false required: false
type: str
disk_size_gb: disk_size_gb:
description: description:
- Specifies the size of the disk in base-2 GB. - Specifies the size of the disk in base-2 GB.
required: false required: false
type: int
disk_type: disk_type:
description: description:
- Reference to a disk type. - Reference to a disk type.
- Specifies the disk type to use to create the instance. - Specifies the disk type to use to create the instance.
- If not specified, the default is pd-standard. - If not specified, the default is pd-standard.
required: false required: false
type: str
source_image: source_image:
description: description:
- The source image to create this disk. When creating a new instance, - The source image to create this disk. When creating a new instance,
@ -134,6 +144,7 @@ options:
create a disk with one of the public operating system images, specify create a disk with one of the public operating system images, specify
the image by its family name. the image by its family name.
required: false required: false
type: str
aliases: aliases:
- image - image
- image_family - image_family
@ -145,12 +156,14 @@ options:
you cannot create disks for instances in a managed instance group if you cannot create disks for instances in a managed instance group if
the source images are encrypted with your own keys. the source images are encrypted with your own keys.
required: false required: false
type: dict
suboptions: suboptions:
raw_key: raw_key:
description: description:
- Specifies a 256-bit customer-supplied encryption key, encoded in - Specifies a 256-bit customer-supplied encryption key, encoded in
RFC 4648 base64 to either encrypt or decrypt this resource. RFC 4648 base64 to either encrypt or decrypt this resource.
required: false required: false
type: str
interface: interface:
description: description:
- Specifies the disk interface to use for attaching this disk, which is either - Specifies the disk interface to use for attaching this disk, which is either
@ -159,12 +172,14 @@ options:
to attach a persistent disk in any other format than SCSI. to attach a persistent disk in any other format than SCSI.
- 'Some valid choices include: "SCSI", "NVME"' - 'Some valid choices include: "SCSI", "NVME"'
required: false required: false
type: str
mode: mode:
description: description:
- The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If - The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If
not specified, the default is to attach the disk in READ_WRITE mode. not specified, the default is to attach the disk in READ_WRITE mode.
- 'Some valid choices include: "READ_WRITE", "READ_ONLY"' - 'Some valid choices include: "READ_WRITE", "READ_ONLY"'
required: false required: false
type: str
source: source:
description: description:
- Reference to a disk. When creating a new instance, one of initializeParams.sourceImage - Reference to a disk. When creating a new instance, one of initializeParams.sourceImage
@ -177,44 +192,53 @@ options:
name-of-resource` to a gcp_compute_disk task and then set this source field name-of-resource` to a gcp_compute_disk task and then set this source field
to "{{ name-of-resource }}"' to "{{ name-of-resource }}"'
required: false required: false
type: dict
type: type:
description: description:
- Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, - Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified,
the default is PERSISTENT. the default is PERSISTENT.
- 'Some valid choices include: "SCRATCH", "PERSISTENT"' - 'Some valid choices include: "SCRATCH", "PERSISTENT"'
required: false required: false
type: str
guest_accelerators: guest_accelerators:
description: description:
- List of the type and count of accelerator cards attached to the instance . - List of the type and count of accelerator cards attached to the instance .
required: false required: false
type: list
suboptions: suboptions:
accelerator_count: accelerator_count:
description: description:
- The number of the guest accelerator cards exposed to this instance. - The number of the guest accelerator cards exposed to this instance.
required: false required: false
type: int
accelerator_type: accelerator_type:
description: description:
- Full or partial URL of the accelerator type resource to expose to this instance. - Full or partial URL of the accelerator type resource to expose to this instance.
required: false required: false
type: str
labels: labels:
description: description:
- Labels to apply to this instance. A list of key->value pairs. - Labels to apply to this instance. A list of key->value pairs.
required: false required: false
type: dict
version_added: 2.9 version_added: 2.9
metadata: metadata:
description: description:
- The metadata key/value pairs to assign to instances that are created from this - The metadata key/value pairs to assign to instances that are created from this
template. These pairs can consist of custom metadata or predefined keys. template. These pairs can consist of custom metadata or predefined keys.
required: false required: false
type: dict
machine_type: machine_type:
description: description:
- A reference to a machine type which defines VM kind. - A reference to a machine type which defines VM kind.
required: false required: false
type: str
min_cpu_platform: min_cpu_platform:
description: description:
- Specifies a minimum CPU platform for the VM instance. Applicable values are - Specifies a minimum CPU platform for the VM instance. Applicable values are
the friendly names of CPU platforms . the friendly names of CPU platforms .
required: false required: false
type: str
name: name:
description: description:
- The name of the resource, provided by the client when initially creating the - The name of the resource, provided by the client when initially creating the
@ -224,12 +248,14 @@ options:
letter, and all following characters must be a dash, lowercase letter, or digit, letter, and all following characters must be a dash, lowercase letter, or digit,
except the last character, which cannot be a dash. except the last character, which cannot be a dash.
required: false required: false
type: str
network_interfaces: network_interfaces:
description: description:
- An array of configurations for this interface. This specifies how this interface - An array of configurations for this interface. This specifies how this interface
is configured to interact with other network services, such as connecting to is configured to interact with other network services, such as connecting to
the internet. Only one network interface is supported per instance. the internet. Only one network interface is supported per instance.
required: false required: false
type: list
suboptions: suboptions:
access_configs: access_configs:
description: description:
@ -237,6 +263,7 @@ options:
config, ONE_TO_ONE_NAT, is supported. If there are no accessConfigs specified, config, ONE_TO_ONE_NAT, is supported. If there are no accessConfigs specified,
then this instance will have no external internet access. then this instance will have no external internet access.
required: false required: false
type: list
suboptions: suboptions:
name: name:
description: description:
@ -244,6 +271,7 @@ options:
is External NAT but you can use any arbitrary string you would like. is External NAT but you can use any arbitrary string you would like.
For example, My external IP or Network Access. For example, My external IP or Network Access.
required: true required: true
type: str
nat_ip: nat_ip:
description: description:
- Reference to an address. - Reference to an address.
@ -258,16 +286,19 @@ options:
name-of-resource` to a gcp_compute_address task and then set this nat_ip name-of-resource` to a gcp_compute_address task and then set this nat_ip
field to "{{ name-of-resource }}"' field to "{{ name-of-resource }}"'
required: false required: false
type: dict
type: type:
description: description:
- The type of configuration. The default and only option is ONE_TO_ONE_NAT. - The type of configuration. The default and only option is ONE_TO_ONE_NAT.
- 'Some valid choices include: "ONE_TO_ONE_NAT"' - 'Some valid choices include: "ONE_TO_ONE_NAT"'
required: true required: true
type: str
alias_ip_ranges: alias_ip_ranges:
description: description:
- An array of alias IP ranges for this network interface. Can only be specified - An array of alias IP ranges for this network interface. Can only be specified
for network interfaces on subnet-mode networks. for network interfaces on subnet-mode networks.
required: false required: false
type: list
suboptions: suboptions:
ip_cidr_range: ip_cidr_range:
description: description:
@ -277,12 +308,14 @@ options:
This range may be a single IP address (e.g. 10.2.3.4), a netmask (e.g. This range may be a single IP address (e.g. 10.2.3.4), a netmask (e.g.
/24) or a CIDR format string (e.g. 10.1.2.0/24). /24) or a CIDR format string (e.g. 10.1.2.0/24).
required: false required: false
type: str
subnetwork_range_name: subnetwork_range_name:
description: description:
- Optional subnetwork secondary range name specifying the secondary range - Optional subnetwork secondary range name specifying the secondary range
from which to allocate the IP CIDR range for this alias IP range. If from which to allocate the IP CIDR range for this alias IP range. If
left unspecified, the primary range of the subnetwork will be used. left unspecified, the primary range of the subnetwork will be used.
required: false required: false
type: str
network: network:
description: description:
- Specifies the title of an existing network. When creating an instance, if - Specifies the title of an existing network. When creating an instance, if
@ -295,12 +328,14 @@ options:
name-of-resource` to a gcp_compute_network task and then set this network name-of-resource` to a gcp_compute_network task and then set this network
field to "{{ name-of-resource }}"' field to "{{ name-of-resource }}"'
required: false required: false
type: dict
network_ip: network_ip:
description: description:
- An IPv4 internal network address to assign to the instance for this network - An IPv4 internal network address to assign to the instance for this network
interface. If not specified by the user, an unused internal IP is assigned interface. If not specified by the user, an unused internal IP is assigned
by the system. by the system.
required: false required: false
type: str
subnetwork: subnetwork:
description: description:
- Reference to a VPC network. - Reference to a VPC network.
@ -313,10 +348,12 @@ options:
name-of-resource` to a gcp_compute_subnetwork task and then set this subnetwork name-of-resource` to a gcp_compute_subnetwork task and then set this subnetwork
field to "{{ name-of-resource }}"' field to "{{ name-of-resource }}"'
required: false required: false
type: dict
scheduling: scheduling:
description: description:
- Sets the scheduling options for this instance. - Sets the scheduling options for this instance.
required: false required: false
type: dict
suboptions: suboptions:
automatic_restart: automatic_restart:
description: description:
@ -333,6 +370,7 @@ options:
and only possible behavior is TERMINATE. and only possible behavior is TERMINATE.
- For more information, see Setting Instance Scheduling Options. - For more information, see Setting Instance Scheduling Options.
required: false required: false
type: str
preemptible: preemptible:
description: description:
- Defines whether the instance is preemptible. This can only be set during - Defines whether the instance is preemptible. This can only be set during
@ -345,15 +383,18 @@ options:
- A list of service accounts, with their specified scopes, authorized for this - A list of service accounts, with their specified scopes, authorized for this
instance. Only one service account per VM instance is supported. instance. Only one service account per VM instance is supported.
required: false required: false
type: list
suboptions: suboptions:
email: email:
description: description:
- Email address of the service account. - Email address of the service account.
required: false required: false
type: str
scopes: scopes:
description: description:
- The list of scopes to be made available for this service account. - The list of scopes to be made available for this service account.
required: false required: false
type: list
status: status:
description: description:
- 'The status of the instance. One of the following values: PROVISIONING, STAGING, - 'The status of the instance. One of the following values: PROVISIONING, STAGING,
@ -363,6 +404,7 @@ options:
- 'Some valid choices include: "PROVISIONING", "STAGING", "RUNNING", "STOPPING", - 'Some valid choices include: "PROVISIONING", "STAGING", "RUNNING", "STOPPING",
"SUSPENDING", "SUSPENDED", "TERMINATED"' "SUSPENDING", "SUSPENDED", "TERMINATED"'
required: false required: false
type: str
version_added: 2.8 version_added: 2.8
tags: tags:
description: description:
@ -371,6 +413,7 @@ options:
creation. The tags can be later modified by the setTags method. Each tag within creation. The tags can be later modified by the setTags method. Each tag within
the list must comply with RFC1035. the list must comply with RFC1035.
required: false required: false
type: dict
suboptions: suboptions:
fingerprint: fingerprint:
description: description:
@ -380,15 +423,18 @@ options:
every request to modify or update metadata. You must always provide an up-to-date every request to modify or update metadata. You must always provide an up-to-date
fingerprint hash in order to update or change metadata. fingerprint hash in order to update or change metadata.
required: false required: false
type: str
items: items:
description: description:
- An array of tags. Each tag must be 1-63 characters long, and comply with - An array of tags. Each tag must be 1-63 characters long, and comply with
RFC1035. RFC1035.
required: false required: false
type: list
zone: zone:
description: description:
- A reference to the zone where the machine resides. - A reference to the zone where the machine resides.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -49,6 +49,7 @@ options:
description: description:
- A reference to the zone where the machine resides. - A reference to the zone where the machine resides.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -55,11 +55,13 @@ options:
- An optional description of this resource. Provide this property when you create - An optional description of this resource. Provide this property when you create
the resource. the resource.
required: false required: false
type: str
name: name:
description: description:
- The name of the instance group. - The name of the instance group.
- The name must be 1-63 characters long, and comply with RFC1035. - The name must be 1-63 characters long, and comply with RFC1035.
required: false required: false
type: str
named_ports: named_ports:
description: description:
- Assigns a name to a port number. - Assigns a name to a port number.
@ -69,16 +71,19 @@ options:
- 'For example: [{name: "http", port: 80},{name: "http", port: 8080}] Named ports - 'For example: [{name: "http", port: 80},{name: "http", port: 8080}] Named ports
apply to all instances in this instance group.' apply to all instances in this instance group.'
required: false required: false
type: list
suboptions: suboptions:
name: name:
description: description:
- The name for this named port. - The name for this named port.
- The name must be 1-63 characters long, and comply with RFC1035. - The name must be 1-63 characters long, and comply with RFC1035.
required: false required: false
type: str
port: port:
description: description:
- The port number, which can be a value between 1 and 65535. - The port number, which can be a value between 1 and 65535.
required: false required: false
type: int
network: network:
description: description:
- The network to which all instances in the instance group belong. - The network to which all instances in the instance group belong.
@ -88,10 +93,12 @@ options:
to a gcp_compute_network task and then set this network field to "{{ name-of-resource to a gcp_compute_network task and then set this network field to "{{ name-of-resource
}}"' }}"'
required: false required: false
type: dict
region: region:
description: description:
- The region where the instance group is located (for regional resources). - The region where the instance group is located (for regional resources).
required: false required: false
type: str
subnetwork: subnetwork:
description: description:
- The subnetwork to which all instances in the instance group belong. - The subnetwork to which all instances in the instance group belong.
@ -101,10 +108,12 @@ options:
to a gcp_compute_subnetwork task and then set this subnetwork field to "{{ name-of-resource to a gcp_compute_subnetwork task and then set this subnetwork field to "{{ name-of-resource
}}"' }}"'
required: false required: false
type: dict
zone: zone:
description: description:
- A reference to the zone where the instance group resides. - A reference to the zone where the instance group resides.
required: true required: true
type: str
instances: instances:
description: description:
- The list of instances associated with this InstanceGroup. - The list of instances associated with this InstanceGroup.
@ -113,6 +122,7 @@ options:
not be deleted. not be deleted.
- Only the full identifier of the instance will be returned. - Only the full identifier of the instance will be returned.
required: false required: false
type: list
version_added: 2.8 version_added: 2.8
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -49,6 +49,7 @@ options:
description: description:
- A reference to the zone where the instance group resides. - A reference to the zone where the instance group resides.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -59,11 +59,13 @@ options:
four-character string to the base instance name. four-character string to the base instance name.
- The base instance name must comply with RFC1035. - The base instance name must comply with RFC1035.
required: true required: true
type: str
description: description:
description: description:
- An optional description of this resource. Provide this property when you create - An optional description of this resource. Provide this property when you create
the resource. the resource.
required: false required: false
type: str
instance_template: instance_template:
description: description:
- The instance template that is specified for this managed instance group. The - The instance template that is specified for this managed instance group. The
@ -75,42 +77,50 @@ options:
name-of-resource` to a gcp_compute_instance_template task and then set this name-of-resource` to a gcp_compute_instance_template task and then set this
instance_template field to "{{ name-of-resource }}"' instance_template field to "{{ name-of-resource }}"'
required: true required: true
type: dict
name: name:
description: description:
- The name of the managed instance group. The name must be 1-63 characters long, - The name of the managed instance group. The name must be 1-63 characters long,
and comply with RFC1035. and comply with RFC1035.
required: true required: true
type: str
named_ports: named_ports:
description: description:
- Named ports configured for the Instance Groups complementary to this Instance - Named ports configured for the Instance Groups complementary to this Instance
Group Manager. Group Manager.
required: false required: false
type: list
suboptions: suboptions:
name: name:
description: description:
- The name for this named port. The name must be 1-63 characters long, and - The name for this named port. The name must be 1-63 characters long, and
comply with RFC1035. comply with RFC1035.
required: false required: false
type: str
port: port:
description: description:
- The port number, which can be a value between 1 and 65535. - The port number, which can be a value between 1 and 65535.
required: false required: false
type: int
target_pools: target_pools:
description: description:
- TargetPool resources to which instances in the instanceGroup field are added. - TargetPool resources to which instances in the instanceGroup field are added.
The target pools automatically apply to all of the instances in the managed The target pools automatically apply to all of the instances in the managed
instance group. instance group.
required: false required: false
type: list
target_size: target_size:
description: description:
- The target number of running instances for this managed instance group. Deleting - The target number of running instances for this managed instance group. Deleting
or abandoning instances reduces this number. Resizing the group changes this or abandoning instances reduces this number. Resizing the group changes this
number. number.
required: false required: false
type: int
zone: zone:
description: description:
- The zone the managed instance group resides. - The zone the managed instance group resides.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -49,6 +49,7 @@ options:
description: description:
- The zone the managed instance group resides. - The zone the managed instance group resides.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -58,14 +58,17 @@ options:
- An optional description of this resource. Provide this property when you create - An optional description of this resource. Provide this property when you create
the resource. the resource.
required: false required: false
type: str
name: name:
description: description:
- Name of the resource. The name is 1-63 characters long and complies with RFC1035. - Name of the resource. The name is 1-63 characters long and complies with RFC1035.
required: true required: true
type: str
properties: properties:
description: description:
- The instance properties for this instance template. - The instance properties for this instance template.
required: false required: false
type: dict
suboptions: suboptions:
can_ip_forward: can_ip_forward:
description: description:
@ -81,11 +84,13 @@ options:
- An optional text description for the instances that are created from this - An optional text description for the instances that are created from this
instance template. instance template.
required: false required: false
type: str
disks: disks:
description: description:
- An array of disks that are associated with the instances that are created - An array of disks that are associated with the instances that are created
from this template. from this template.
required: false required: false
type: list
suboptions: suboptions:
auto_delete: auto_delete:
description: description:
@ -108,21 +113,25 @@ options:
within the instance. This name can be used to reference the device for within the instance. This name can be used to reference the device for
mounting, resizing, and so on, from within the instance. mounting, resizing, and so on, from within the instance.
required: false required: false
type: str
disk_encryption_key: disk_encryption_key:
description: description:
- Encrypts or decrypts a disk using a customer-supplied encryption key. - Encrypts or decrypts a disk using a customer-supplied encryption key.
required: false required: false
type: dict
suboptions: suboptions:
raw_key: raw_key:
description: description:
- Specifies a 256-bit customer-supplied encryption key, encoded in - Specifies a 256-bit customer-supplied encryption key, encoded in
RFC 4648 base64 to either encrypt or decrypt this resource. RFC 4648 base64 to either encrypt or decrypt this resource.
required: false required: false
type: str
rsa_encrypted_key: rsa_encrypted_key:
description: description:
- Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit customer-supplied - Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit customer-supplied
encryption key to either encrypt or decrypt this resource. encryption key to either encrypt or decrypt this resource.
required: false required: false
type: str
index: index:
description: description:
- Assigns a zero-based index to this disk, where 0 is reserved for the - Assigns a zero-based index to this disk, where 0 is reserved for the
@ -130,28 +139,33 @@ options:
each disk would have a unique index number. If not specified, the server each disk would have a unique index number. If not specified, the server
will choose an appropriate value. will choose an appropriate value.
required: false required: false
type: int
initialize_params: initialize_params:
description: description:
- Specifies the parameters for a new disk that will be created alongside - Specifies the parameters for a new disk that will be created alongside
the new instance. Use initialization parameters to create boot disks the new instance. Use initialization parameters to create boot disks
or local SSDs attached to the new instance. or local SSDs attached to the new instance.
required: false required: false
type: dict
suboptions: suboptions:
disk_name: disk_name:
description: description:
- Specifies the disk name. If not specified, the default is to use - Specifies the disk name. If not specified, the default is to use
the name of the instance. the name of the instance.
required: false required: false
type: str
disk_size_gb: disk_size_gb:
description: description:
- Specifies the size of the disk in base-2 GB. - Specifies the size of the disk in base-2 GB.
required: false required: false
type: int
disk_type: disk_type:
description: description:
- Reference to a disk type. - Reference to a disk type.
- Specifies the disk type to use to create the instance. - Specifies the disk type to use to create the instance.
- If not specified, the default is pd-standard. - If not specified, the default is pd-standard.
required: false required: false
type: str
source_image: source_image:
description: description:
- The source image to create this disk. When creating a new instance, - The source image to create this disk. When creating a new instance,
@ -159,6 +173,7 @@ options:
To create a disk with one of the public operating system images, To create a disk with one of the public operating system images,
specify the image by its family name. specify the image by its family name.
required: false required: false
type: str
source_image_encryption_key: source_image_encryption_key:
description: description:
- The customer-supplied encryption key of the source image. Required - The customer-supplied encryption key of the source image. Required
@ -168,12 +183,14 @@ options:
so you cannot create disks for instances in a managed instance group so you cannot create disks for instances in a managed instance group
if the source images are encrypted with your own keys. if the source images are encrypted with your own keys.
required: false required: false
type: dict
suboptions: suboptions:
raw_key: raw_key:
description: description:
- Specifies a 256-bit customer-supplied encryption key, encoded - Specifies a 256-bit customer-supplied encryption key, encoded
in RFC 4648 base64 to either encrypt or decrypt this resource. in RFC 4648 base64 to either encrypt or decrypt this resource.
required: false required: false
type: str
interface: interface:
description: description:
- Specifies the disk interface to use for attaching this disk, which is - Specifies the disk interface to use for attaching this disk, which is
@ -182,12 +199,14 @@ options:
attempt to attach a persistent disk in any other format than SCSI. attempt to attach a persistent disk in any other format than SCSI.
- 'Some valid choices include: "SCSI", "NVME"' - 'Some valid choices include: "SCSI", "NVME"'
required: false required: false
type: str
mode: mode:
description: description:
- The mode in which to attach this disk, either READ_WRITE or READ_ONLY. - The mode in which to attach this disk, either READ_WRITE or READ_ONLY.
If not specified, the default is to attach the disk in READ_WRITE mode. If not specified, the default is to attach the disk in READ_WRITE mode.
- 'Some valid choices include: "READ_WRITE", "READ_ONLY"' - 'Some valid choices include: "READ_WRITE", "READ_ONLY"'
required: false required: false
type: str
source: source:
description: description:
- Reference to a disk. When creating a new instance, one of initializeParams.sourceImage - Reference to a disk. When creating a new instance, one of initializeParams.sourceImage
@ -202,48 +221,57 @@ options:
name-of-resource` to a gcp_compute_disk task and then set this source name-of-resource` to a gcp_compute_disk task and then set this source
field to "{{ name-of-resource }}"' field to "{{ name-of-resource }}"'
required: false required: false
type: dict
type: type:
description: description:
- Specifies the type of the disk, either SCRATCH or PERSISTENT. If not - Specifies the type of the disk, either SCRATCH or PERSISTENT. If not
specified, the default is PERSISTENT. specified, the default is PERSISTENT.
- 'Some valid choices include: "SCRATCH", "PERSISTENT"' - 'Some valid choices include: "SCRATCH", "PERSISTENT"'
required: false required: false
type: str
machine_type: machine_type:
description: description:
- The machine type to use in the VM instance template. - The machine type to use in the VM instance template.
required: true required: true
type: str
min_cpu_platform: min_cpu_platform:
description: description:
- Specifies a minimum CPU platform for the VM instance. Applicable values - Specifies a minimum CPU platform for the VM instance. Applicable values
are the friendly names of CPU platforms . are the friendly names of CPU platforms .
required: false required: false
type: str
metadata: metadata:
description: description:
- The metadata key/value pairs to assign to instances that are created from - The metadata key/value pairs to assign to instances that are created from
this template. These pairs can consist of custom metadata or predefined this template. These pairs can consist of custom metadata or predefined
keys. keys.
required: false required: false
type: dict
guest_accelerators: guest_accelerators:
description: description:
- List of the type and count of accelerator cards attached to the instance - List of the type and count of accelerator cards attached to the instance
. .
required: false required: false
type: list
suboptions: suboptions:
accelerator_count: accelerator_count:
description: description:
- The number of the guest accelerator cards exposed to this instance. - The number of the guest accelerator cards exposed to this instance.
required: false required: false
type: int
accelerator_type: accelerator_type:
description: description:
- Full or partial URL of the accelerator type resource to expose to this - Full or partial URL of the accelerator type resource to expose to this
instance. instance.
required: false required: false
type: str
network_interfaces: network_interfaces:
description: description:
- An array of configurations for this interface. This specifies how this interface - An array of configurations for this interface. This specifies how this interface
is configured to interact with other network services, such as connecting is configured to interact with other network services, such as connecting
to the internet. Only one network interface is supported per instance. to the internet. Only one network interface is supported per instance.
required: false required: false
type: list
suboptions: suboptions:
access_configs: access_configs:
description: description:
@ -251,6 +279,7 @@ options:
config, ONE_TO_ONE_NAT, is supported. If there are no accessConfigs config, ONE_TO_ONE_NAT, is supported. If there are no accessConfigs
specified, then this instance will have no external internet access. specified, then this instance will have no external internet access.
required: false required: false
type: list
suboptions: suboptions:
name: name:
description: description:
@ -258,6 +287,7 @@ options:
name is External NAT but you can use any arbitrary string you would name is External NAT but you can use any arbitrary string you would
like. For example, My external IP or Network Access. like. For example, My external IP or Network Access.
required: true required: true
type: str
nat_ip: nat_ip:
description: description:
- Reference to an address. - Reference to an address.
@ -272,16 +302,19 @@ options:
you can add `register: name-of-resource` to a gcp_compute_address you can add `register: name-of-resource` to a gcp_compute_address
task and then set this nat_ip field to "{{ name-of-resource }}"' task and then set this nat_ip field to "{{ name-of-resource }}"'
required: false required: false
type: dict
type: type:
description: description:
- The type of configuration. The default and only option is ONE_TO_ONE_NAT. - The type of configuration. The default and only option is ONE_TO_ONE_NAT.
- 'Some valid choices include: "ONE_TO_ONE_NAT"' - 'Some valid choices include: "ONE_TO_ONE_NAT"'
required: true required: true
type: str
alias_ip_ranges: alias_ip_ranges:
description: description:
- An array of alias IP ranges for this network interface. Can only be - An array of alias IP ranges for this network interface. Can only be
specified for network interfaces on subnet-mode networks. specified for network interfaces on subnet-mode networks.
required: false required: false
type: list
suboptions: suboptions:
ip_cidr_range: ip_cidr_range:
description: description:
@ -291,6 +324,7 @@ options:
interfaces. This range may be a single IP address (e.g. 10.2.3.4), interfaces. This range may be a single IP address (e.g. 10.2.3.4),
a netmask (e.g. /24) or a CIDR format string (e.g. 10.1.2.0/24). a netmask (e.g. /24) or a CIDR format string (e.g. 10.1.2.0/24).
required: false required: false
type: str
subnetwork_range_name: subnetwork_range_name:
description: description:
- Optional subnetwork secondary range name specifying the secondary - Optional subnetwork secondary range name specifying the secondary
@ -298,6 +332,7 @@ options:
range. If left unspecified, the primary range of the subnetwork range. If left unspecified, the primary range of the subnetwork
will be used. will be used.
required: false required: false
type: str
network: network:
description: description:
- Specifies the title of an existing network. When creating an instance, - Specifies the title of an existing network. When creating an instance,
@ -310,12 +345,14 @@ options:
name-of-resource` to a gcp_compute_network task and then set this network name-of-resource` to a gcp_compute_network task and then set this network
field to "{{ name-of-resource }}"' field to "{{ name-of-resource }}"'
required: false required: false
type: dict
network_ip: network_ip:
description: description:
- An IPv4 internal network address to assign to the instance for this - An IPv4 internal network address to assign to the instance for this
network interface. If not specified by the user, an unused internal network interface. If not specified by the user, an unused internal
IP is assigned by the system. IP is assigned by the system.
required: false required: false
type: str
subnetwork: subnetwork:
description: description:
- Reference to a VPC network. - Reference to a VPC network.
@ -328,10 +365,12 @@ options:
can add `register: name-of-resource` to a gcp_compute_subnetwork task can add `register: name-of-resource` to a gcp_compute_subnetwork task
and then set this subnetwork field to "{{ name-of-resource }}"' and then set this subnetwork field to "{{ name-of-resource }}"'
required: false required: false
type: dict
scheduling: scheduling:
description: description:
- Sets the scheduling options for this instance. - Sets the scheduling options for this instance.
required: false required: false
type: dict
suboptions: suboptions:
automatic_restart: automatic_restart:
description: description:
@ -348,6 +387,7 @@ options:
and only possible behavior is TERMINATE. and only possible behavior is TERMINATE.
- For more information, see Setting Instance Scheduling Options. - For more information, see Setting Instance Scheduling Options.
required: false required: false
type: str
preemptible: preemptible:
description: description:
- Defines whether the instance is preemptible. This can only be set during - Defines whether the instance is preemptible. This can only be set during
@ -360,15 +400,18 @@ options:
- A list of service accounts, with their specified scopes, authorized for - A list of service accounts, with their specified scopes, authorized for
this instance. Only one service account per VM instance is supported. this instance. Only one service account per VM instance is supported.
required: false required: false
type: list
suboptions: suboptions:
email: email:
description: description:
- Email address of the service account. - Email address of the service account.
required: false required: false
type: str
scopes: scopes:
description: description:
- The list of scopes to be made available for this service account. - The list of scopes to be made available for this service account.
required: false required: false
type: list
tags: tags:
description: description:
- A list of tags to apply to this instance. Tags are used to identify valid - A list of tags to apply to this instance. Tags are used to identify valid
@ -376,6 +419,7 @@ options:
during instance creation. The tags can be later modified by the setTags during instance creation. The tags can be later modified by the setTags
method. Each tag within the list must comply with RFC1035. method. Each tag within the list must comply with RFC1035.
required: false required: false
type: dict
suboptions: suboptions:
fingerprint: fingerprint:
description: description:
@ -385,11 +429,13 @@ options:
after every request to modify or update metadata. You must always provide after every request to modify or update metadata. You must always provide
an up-to-date fingerprint hash in order to update or change metadata. an up-to-date fingerprint hash in order to update or change metadata.
required: false required: false
type: str
items: items:
description: description:
- An array of tags. Each tag must be 1-63 characters long, and comply - An array of tags. Each tag must be 1-63 characters long, and comply
with RFC1035. with RFC1035.
required: false required: false
type: list
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -54,10 +54,12 @@ options:
traverse through. Required if type is DEDICATED, must not be set if type is traverse through. Required if type is DEDICATED, must not be set if type is
PARTNER. PARTNER.
required: false required: false
type: str
description: description:
description: description:
- An optional description of this resource. - An optional description of this resource.
required: false required: false
type: str
edge_availability_domain: edge_availability_domain:
description: description:
- Desired availability domain for the attachment. Only available for type PARTNER, - Desired availability domain for the attachment. Only available for type PARTNER,
@ -67,11 +69,13 @@ options:
circuit will lie in the specified domain. If not specified, the value will default circuit will lie in the specified domain. If not specified, the value will default
to AVAILABILITY_DOMAIN_ANY. to AVAILABILITY_DOMAIN_ANY.
required: false required: false
type: str
type: type:
description: description:
- The type of InterconnectAttachment you wish to create. Defaults to DEDICATED. - The type of InterconnectAttachment you wish to create. Defaults to DEDICATED.
- 'Some valid choices include: "DEDICATED", "PARTNER", "PARTNER_PROVIDER"' - 'Some valid choices include: "DEDICATED", "PARTNER", "PARTNER_PROVIDER"'
required: false required: false
type: str
router: router:
description: description:
- URL of the cloud router to be used for dynamic routing. This router must be - URL of the cloud router to be used for dynamic routing. This router must be
@ -84,6 +88,7 @@ options:
to a gcp_compute_router task and then set this router field to "{{ name-of-resource to a gcp_compute_router task and then set this router field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -93,6 +98,7 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
candidate_subnets: candidate_subnets:
description: description:
- Up to 16 candidate prefixes that can be used to restrict the allocation of cloudRouterIpAddress - Up to 16 candidate prefixes that can be used to restrict the allocation of cloudRouterIpAddress
@ -103,15 +109,18 @@ options:
/29s are in use on Google's edge. If not supplied, Google will randomly select /29s are in use on Google's edge. If not supplied, Google will randomly select
an unused /29 from all of link-local space. an unused /29 from all of link-local space.
required: false required: false
type: list
vlan_tag8021q: vlan_tag8021q:
description: description:
- The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4094. When using - The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4094. When using
PARTNER type this will be managed upstream. PARTNER type this will be managed upstream.
required: false required: false
type: int
region: region:
description: description:
- Region where the regional interconnect attachment resides. - Region where the regional interconnect attachment resides.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -49,6 +49,7 @@ options:
description: description:
- Region where the regional interconnect attachment resides. - Region where the regional interconnect attachment resides.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -52,6 +52,7 @@ options:
- An optional description of this resource. The resource must be recreated to - An optional description of this resource. The resource must be recreated to
modify this field. modify this field.
required: false required: false
type: str
ipv4_range: ipv4_range:
description: description:
- If this field is specified, a deprecated legacy network is created. - If this field is specified, a deprecated legacy network is created.
@ -62,6 +63,7 @@ options:
- 'This range is a CIDR specification, for example: `192.168.0.0/16`.' - 'This range is a CIDR specification, for example: `192.168.0.0/16`.'
- The resource must be recreated to modify this field. - The resource must be recreated to modify this field.
required: false required: false
type: str
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -71,6 +73,7 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
auto_create_subnetworks: auto_create_subnetworks:
description: description:
- When set to `true`, the network is created in "auto subnet mode" and it will - When set to `true`, the network is created in "auto subnet mode" and it will
@ -85,6 +88,7 @@ options:
- The network-level routing configuration for this network. Used by Cloud Router - The network-level routing configuration for this network. Used by Cloud Router
to determine what type of network-wide routing behavior to enforce. to determine what type of network-wide routing behavior to enforce.
required: false required: false
type: dict
version_added: 2.8 version_added: 2.8
suboptions: suboptions:
routing_mode: routing_mode:
@ -96,6 +100,7 @@ options:
regions. regions.
- 'Some valid choices include: "REGIONAL", "GLOBAL"' - 'Some valid choices include: "REGIONAL", "GLOBAL"'
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/networks)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/networks)'

View file

@ -62,14 +62,17 @@ options:
- An optional description of this resource. Provide this property when you create - An optional description of this resource. Provide this property when you create
the resource. the resource.
required: false required: false
type: str
labels: labels:
description: description:
- Labels to apply to this disk. A list of key->value pairs. - Labels to apply to this disk. A list of key->value pairs.
required: false required: false
type: dict
licenses: licenses:
description: description:
- Any applicable publicly visible licenses. - Any applicable publicly visible licenses.
required: false required: false
type: list
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -79,6 +82,7 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
size_gb: size_gb:
description: description:
- Size of the persistent disk, specified in GB. You can specify this field when - Size of the persistent disk, specified in GB. You can specify this field when
@ -88,6 +92,7 @@ options:
of sizeGb must not be less than the size of the sourceImage or the size of the of sizeGb must not be less than the size of the sourceImage or the size of the
snapshot. snapshot.
required: false required: false
type: int
physical_block_size_bytes: physical_block_size_bytes:
description: description:
- Physical block size of the persistent disk, in bytes. If not present in a request, - Physical block size of the persistent disk, in bytes. If not present in a request,
@ -96,19 +101,23 @@ options:
- If an unsupported value is requested, the error message will list the supported - If an unsupported value is requested, the error message will list the supported
values for the caller's project. values for the caller's project.
required: false required: false
type: int
replica_zones: replica_zones:
description: description:
- URLs of the zones where the disk should be replicated to. - URLs of the zones where the disk should be replicated to.
required: true required: true
type: list
type: type:
description: description:
- URL of the disk type resource describing which disk type to use to create the - URL of the disk type resource describing which disk type to use to create the
disk. Provide this when creating the disk. disk. Provide this when creating the disk.
required: false required: false
type: str
region: region:
description: description:
- A reference to the region where the disk resides. - A reference to the region where the disk resides.
required: true required: true
type: str
disk_encryption_key: disk_encryption_key:
description: description:
- Encrypts the disk using a customer-supplied encryption key. - Encrypts the disk using a customer-supplied encryption key.
@ -120,12 +129,14 @@ options:
will be encrypted using an automatically generated key and you do not need to will be encrypted using an automatically generated key and you do not need to
provide a key to use the disk later. provide a key to use the disk later.
required: false required: false
type: dict
suboptions: suboptions:
raw_key: raw_key:
description: description:
- Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648 - Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648
base64 to either encrypt or decrypt this resource. base64 to either encrypt or decrypt this resource.
required: false required: false
type: str
source_snapshot: source_snapshot:
description: description:
- The source snapshot used to create this disk. You can provide this as a partial - The source snapshot used to create this disk. You can provide this as a partial
@ -136,17 +147,20 @@ options:
to a gcp_compute_snapshot task and then set this source_snapshot field to "{{ to a gcp_compute_snapshot task and then set this source_snapshot field to "{{
name-of-resource }}"' name-of-resource }}"'
required: false required: false
type: dict
source_snapshot_encryption_key: source_snapshot_encryption_key:
description: description:
- The customer-supplied encryption key of the source snapshot. Required if the - The customer-supplied encryption key of the source snapshot. Required if the
source snapshot is protected by a customer-supplied encryption key. source snapshot is protected by a customer-supplied encryption key.
required: false required: false
type: dict
suboptions: suboptions:
raw_key: raw_key:
description: description:
- Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648 - Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648
base64 to either encrypt or decrypt this resource. base64 to either encrypt or decrypt this resource.
required: false required: false
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/beta/regionDisks)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/beta/regionDisks)'

View file

@ -49,6 +49,7 @@ options:
description: description:
- A reference to the region where the disk resides. - A reference to the region where the disk resides.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -67,11 +67,13 @@ options:
- The destination range of outgoing packets that this route applies to. - The destination range of outgoing packets that this route applies to.
- Only IPv4 is supported. - Only IPv4 is supported.
required: true required: true
type: str
description: description:
description: description:
- An optional description of this resource. Provide this property when you create - An optional description of this resource. Provide this property when you create
the resource. the resource.
required: false required: false
type: str
version_added: 2.7 version_added: 2.7
name: name:
description: description:
@ -82,6 +84,7 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
network: network:
description: description:
- The network that this route applies to. - The network that this route applies to.
@ -91,6 +94,7 @@ options:
to a gcp_compute_network task and then set this network field to "{{ name-of-resource to a gcp_compute_network task and then set this network field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
priority: priority:
description: description:
- The priority of this route. Priority is used to break ties in cases where there - The priority of this route. Priority is used to break ties in cases where there
@ -99,10 +103,12 @@ options:
priority value wins. priority value wins.
- Default value is 1000. Valid range is 0 through 65535. - Default value is 1000. Valid range is 0 through 65535.
required: false required: false
type: int
tags: tags:
description: description:
- A list of instance tags to which this route applies. - A list of instance tags to which this route applies.
required: false required: false
type: list
next_hop_gateway: next_hop_gateway:
description: description:
- URL to a gateway that should handle matching packets. - URL to a gateway that should handle matching packets.
@ -111,6 +117,7 @@ options:
* projects/project/global/gateways/default-internet-gateway * global/gateways/default-internet-gateway * projects/project/global/gateways/default-internet-gateway * global/gateways/default-internet-gateway
.' .'
required: false required: false
type: str
next_hop_instance: next_hop_instance:
description: description:
- URL to an instance that should handle matching packets. - URL to an instance that should handle matching packets.
@ -123,10 +130,12 @@ options:
to a gcp_compute_instance task and then set this next_hop_instance field to to a gcp_compute_instance task and then set this next_hop_instance field to
"{{ name-of-resource }}"' "{{ name-of-resource }}"'
required: false required: false
type: dict
next_hop_ip: next_hop_ip:
description: description:
- Network IP address of an instance that should handle matching packets. - Network IP address of an instance that should handle matching packets.
required: false required: false
type: str
next_hop_vpn_tunnel: next_hop_vpn_tunnel:
description: description:
- URL to a VpnTunnel that should handle matching packets. - URL to a VpnTunnel that should handle matching packets.
@ -136,6 +145,7 @@ options:
to a gcp_compute_vpn_tunnel task and then set this next_hop_vpn_tunnel field to a gcp_compute_vpn_tunnel task and then set this next_hop_vpn_tunnel field
to "{{ name-of-resource }}"' to "{{ name-of-resource }}"'
required: false required: false
type: dict
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/routes)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/routes)'

View file

@ -55,10 +55,12 @@ options:
be a lowercase letter, and all following characters must be a dash, lowercase be a lowercase letter, and all following characters must be a dash, lowercase
letter, or digit, except the last character, which cannot be a dash. letter, or digit, except the last character, which cannot be a dash.
required: true required: true
type: str
description: description:
description: description:
- An optional description of this resource. - An optional description of this resource.
required: false required: false
type: str
network: network:
description: description:
- A reference to the network to which this router belongs. - A reference to the network to which this router belongs.
@ -68,10 +70,12 @@ options:
to a gcp_compute_network task and then set this network field to "{{ name-of-resource to a gcp_compute_network task and then set this network field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
bgp: bgp:
description: description:
- BGP information specific to this router. - BGP information specific to this router.
required: false required: false
type: dict
suboptions: suboptions:
asn: asn:
description: description:
@ -79,6 +83,7 @@ options:
either 16-bit or 32-bit. The value will be fixed for this router resource. either 16-bit or 32-bit. The value will be fixed for this router resource.
All VPN tunnels that link to this router will have the same local ASN. All VPN tunnels that link to this router will have the same local ASN.
required: true required: true
type: int
advertise_mode: advertise_mode:
description: description:
- User-specified flag to indicate which mode to use for advertisement. - User-specified flag to indicate which mode to use for advertisement.
@ -86,6 +91,7 @@ options:
- 'Some valid choices include: "DEFAULT", "CUSTOM"' - 'Some valid choices include: "DEFAULT", "CUSTOM"'
required: false required: false
default: DEFAULT default: DEFAULT
type: str
advertised_groups: advertised_groups:
description: description:
- User-specified list of prefix groups to advertise in custom mode. - User-specified list of prefix groups to advertise in custom mode.
@ -95,6 +101,7 @@ options:
groups. groups.
- 'This enum field has the one valid value: ALL_SUBNETS .' - 'This enum field has the one valid value: ALL_SUBNETS .'
required: false required: false
type: list
advertised_ip_ranges: advertised_ip_ranges:
description: description:
- User-specified list of individual IP ranges to advertise in custom mode. - User-specified list of individual IP ranges to advertise in custom mode.
@ -103,19 +110,23 @@ options:
to any specified groups. to any specified groups.
- Leave this field blank to advertise no custom IP ranges. - Leave this field blank to advertise no custom IP ranges.
required: false required: false
type: list
suboptions: suboptions:
range: range:
description: description:
- The IP range to advertise. The value must be a CIDR-formatted string. - The IP range to advertise. The value must be a CIDR-formatted string.
required: false required: false
type: str
description: description:
description: description:
- User-specified description for the IP range. - User-specified description for the IP range.
required: false required: false
type: str
region: region:
description: description:
- Region where the router resides. - Region where the router resides.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/routers)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/routers)'

View file

@ -49,6 +49,7 @@ options:
description: description:
- Region where the router resides. - Region where the router resides.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -55,10 +55,12 @@ options:
- The certificate chain must be no greater than 5 certs long. - The certificate chain must be no greater than 5 certs long.
- The chain must include at least one intermediate cert. - The chain must include at least one intermediate cert.
required: true required: true
type: str
description: description:
description: description:
- An optional description of this resource. - An optional description of this resource.
required: false required: false
type: str
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -68,10 +70,12 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: false required: false
type: str
private_key: private_key:
description: description:
- The write-only private key in PEM format. - The write-only private key in PEM format.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/sslCertificates)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/sslCertificates)'

View file

@ -52,6 +52,7 @@ options:
description: description:
- An optional description of this resource. - An optional description of this resource.
required: false required: false
type: str
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -61,6 +62,7 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
profile: profile:
description: description:
- Profile specifies the set of SSL features that can be used by the load balancer - Profile specifies the set of SSL features that can be used by the load balancer
@ -69,6 +71,7 @@ options:
must be specified in the `customFeatures` field. must be specified in the `customFeatures` field.
- 'Some valid choices include: "COMPATIBLE", "MODERN", "RESTRICTED", "CUSTOM"' - 'Some valid choices include: "COMPATIBLE", "MODERN", "RESTRICTED", "CUSTOM"'
required: false required: false
type: str
min_tls_version: min_tls_version:
description: description:
- The minimum version of SSL protocol that can be used by the clients to establish - The minimum version of SSL protocol that can be used by the clients to establish
@ -76,12 +79,14 @@ options:
`TLS_1_2`. `TLS_1_2`.
- 'Some valid choices include: "TLS_1_0", "TLS_1_1", "TLS_1_2"' - 'Some valid choices include: "TLS_1_0", "TLS_1_1", "TLS_1_2"'
required: false required: false
type: str
custom_features: custom_features:
description: description:
- A list of features enabled when the selected profile is CUSTOM. The method returns - A list of features enabled when the selected profile is CUSTOM. The method returns
the set of features that can be specified in this list. This field must be empty the set of features that can be specified in this list. This field must be empty
if the profile is not CUSTOM. if the profile is not CUSTOM.
required: false required: false
type: list
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/sslPolicies)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/sslPolicies)'

View file

@ -68,6 +68,7 @@ options:
- An optional description of this resource. Provide this property when you create - An optional description of this resource. Provide this property when you create
the resource. This field can be set only at resource creation time. the resource. This field can be set only at resource creation time.
required: false required: false
type: str
ip_cidr_range: ip_cidr_range:
description: description:
- The range of internal addresses that are owned by this subnetwork. - The range of internal addresses that are owned by this subnetwork.
@ -75,6 +76,7 @@ options:
or 192.168.0.0/16. Ranges must be unique and non-overlapping within a network. or 192.168.0.0/16. Ranges must be unique and non-overlapping within a network.
Only IPv4 is supported. Only IPv4 is supported.
required: true required: true
type: str
name: name:
description: description:
- The name of the resource, provided by the client when initially creating the - The name of the resource, provided by the client when initially creating the
@ -84,6 +86,7 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
network: network:
description: description:
- The network this subnet belongs to. - The network this subnet belongs to.
@ -94,6 +97,7 @@ options:
to a gcp_compute_network task and then set this network field to "{{ name-of-resource to a gcp_compute_network task and then set this network field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
enable_flow_logs: enable_flow_logs:
description: description:
- Whether to enable flow logging for this subnetwork. - Whether to enable flow logging for this subnetwork.
@ -106,6 +110,7 @@ options:
in this subnetwork. The primary IP of such VM must belong to the primary ipCidrRange in this subnetwork. The primary IP of such VM must belong to the primary ipCidrRange
of the subnetwork. The alias IPs may belong to either primary or secondary ranges. of the subnetwork. The alias IPs may belong to either primary or secondary ranges.
required: false required: false
type: list
version_added: 2.8 version_added: 2.8
suboptions: suboptions:
range_name: range_name:
@ -114,6 +119,7 @@ options:
an alias IP range to a VM instance. The name must be 1-63 characters long, an alias IP range to a VM instance. The name must be 1-63 characters long,
and comply with RFC1035. The name must be unique within the subnetwork. and comply with RFC1035. The name must be unique within the subnetwork.
required: true required: true
type: str
ip_cidr_range: ip_cidr_range:
description: description:
- The range of IP addresses belonging to this subnetwork secondary range. - The range of IP addresses belonging to this subnetwork secondary range.
@ -121,6 +127,7 @@ options:
- Ranges must be unique and non-overlapping with all primary and secondary - Ranges must be unique and non-overlapping with all primary and secondary
IP ranges within a network. Only IPv4 is supported. IP ranges within a network. Only IPv4 is supported.
required: true required: true
type: str
private_ip_google_access: private_ip_google_access:
description: description:
- When enabled, VMs in this subnetwork without external IP addresses can access - When enabled, VMs in this subnetwork without external IP addresses can access
@ -131,6 +138,7 @@ options:
description: description:
- URL of the GCP region for this subnetwork. - URL of the GCP region for this subnetwork.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/beta/subnetworks)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/beta/subnetworks)'

View file

@ -49,6 +49,7 @@ options:
description: description:
- URL of the GCP region for this subnetwork. - URL of the GCP region for this subnetwork.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -52,6 +52,7 @@ options:
description: description:
- An optional description of this resource. - An optional description of this resource.
required: false required: false
type: str
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -61,6 +62,7 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
url_map: url_map:
description: description:
- A reference to the UrlMap resource that defines the mapping from URL to the - A reference to the UrlMap resource that defines the mapping from URL to the
@ -71,6 +73,7 @@ options:
to a gcp_compute_url_map task and then set this url_map field to "{{ name-of-resource to a gcp_compute_url_map task and then set this url_map field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/targetHttpProxies)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/targetHttpProxies)'

View file

@ -52,6 +52,7 @@ options:
description: description:
- An optional description of this resource. - An optional description of this resource.
required: false required: false
type: str
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -61,6 +62,7 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
quic_override: quic_override:
description: description:
- Specifies the QUIC override policy for this resource. This determines whether - Specifies the QUIC override policy for this resource. This determines whether
@ -70,6 +72,7 @@ options:
field is equivalent to specifying NONE. field is equivalent to specifying NONE.
- 'Some valid choices include: "NONE", "ENABLE", "DISABLE"' - 'Some valid choices include: "NONE", "ENABLE", "DISABLE"'
required: false required: false
type: str
version_added: 2.7 version_added: 2.7
ssl_certificates: ssl_certificates:
description: description:
@ -77,6 +80,7 @@ options:
between users and the load balancer. Currently, exactly one SSL certificate between users and the load balancer. Currently, exactly one SSL certificate
must be specified. must be specified.
required: true required: true
type: list
ssl_policy: ssl_policy:
description: description:
- A reference to the SslPolicy resource that will be associated with the TargetHttpsProxy - A reference to the SslPolicy resource that will be associated with the TargetHttpsProxy
@ -88,6 +92,7 @@ options:
to a gcp_compute_ssl_policy task and then set this ssl_policy field to "{{ name-of-resource to a gcp_compute_ssl_policy task and then set this ssl_policy field to "{{ name-of-resource
}}"' }}"'
required: false required: false
type: dict
version_added: 2.8 version_added: 2.8
url_map: url_map:
description: description:
@ -99,6 +104,7 @@ options:
to a gcp_compute_url_map task and then set this url_map field to "{{ name-of-resource to a gcp_compute_url_map task and then set this url_map field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/targetHttpsProxies)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/targetHttpsProxies)'

View file

@ -66,10 +66,12 @@ options:
to a gcp_compute_target_pool task and then set this backup_pool field to "{{ to a gcp_compute_target_pool task and then set this backup_pool field to "{{
name-of-resource }}"' name-of-resource }}"'
required: false required: false
type: dict
description: description:
description: description:
- An optional description of this resource. - An optional description of this resource.
required: false required: false
type: str
failover_ratio: failover_ratio:
description: description:
- This field is applicable only when the containing target pool is serving a forwarding - This field is applicable only when the containing target pool is serving a forwarding
@ -84,6 +86,7 @@ options:
"force" mode, where traffic will be spread to the healthy instances with the "force" mode, where traffic will be spread to the healthy instances with the
best effort, or to all instances when no instance is healthy. best effort, or to all instances when no instance is healthy.
required: false required: false
type: str
health_check: health_check:
description: description:
- A reference to a HttpHealthCheck resource. - A reference to a HttpHealthCheck resource.
@ -96,11 +99,13 @@ options:
name-of-resource` to a gcp_compute_http_health_check task and then set this name-of-resource` to a gcp_compute_http_health_check task and then set this
health_check field to "{{ name-of-resource }}"' health_check field to "{{ name-of-resource }}"'
required: false required: false
type: dict
instances: instances:
description: description:
- A list of virtual machine instances serving this pool. - A list of virtual machine instances serving this pool.
- They must live in zones contained in the same region as this pool. - They must live in zones contained in the same region as this pool.
required: false required: false
type: list
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -110,6 +115,7 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
session_affinity: session_affinity:
description: description:
- 'Session affinity option. Must be one of these values: - NONE: Connections from - 'Session affinity option. Must be one of these values: - NONE: Connections from
@ -120,10 +126,12 @@ options:
will go to the same instance in the pool while that instance remains healthy." will go to the same instance in the pool while that instance remains healthy."
- 'Some valid choices include: "NONE", "CLIENT_IP", "CLIENT_IP_PROTO"' - 'Some valid choices include: "NONE", "CLIENT_IP", "CLIENT_IP_PROTO"'
required: false required: false
type: str
region: region:
description: description:
- The region where the target pool resides. - The region where the target pool resides.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/targetPools)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/targetPools)'

View file

@ -49,6 +49,7 @@ options:
description: description:
- The region where the target pool resides. - The region where the target pool resides.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -52,6 +52,7 @@ options:
description: description:
- An optional description of this resource. - An optional description of this resource.
required: false required: false
type: str
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -61,12 +62,14 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
proxy_header: proxy_header:
description: description:
- Specifies the type of proxy header to append before sending data to the backend, - Specifies the type of proxy header to append before sending data to the backend,
either NONE or PROXY_V1. The default is NONE. either NONE or PROXY_V1. The default is NONE.
- 'Some valid choices include: "NONE", "PROXY_V1"' - 'Some valid choices include: "NONE", "PROXY_V1"'
required: false required: false
type: str
service: service:
description: description:
- A reference to the BackendService resource. - A reference to the BackendService resource.
@ -76,12 +79,14 @@ options:
name-of-resource` to a gcp_compute_backend_service task and then set this service name-of-resource` to a gcp_compute_backend_service task and then set this service
field to "{{ name-of-resource }}"' field to "{{ name-of-resource }}"'
required: true required: true
type: dict
ssl_certificates: ssl_certificates:
description: description:
- A list of SslCertificate resources that are used to authenticate connections - A list of SslCertificate resources that are used to authenticate connections
between users and the load balancer. Currently, exactly one SSL certificate between users and the load balancer. Currently, exactly one SSL certificate
must be specified. must be specified.
required: true required: true
type: list
ssl_policy: ssl_policy:
description: description:
- A reference to the SslPolicy resource that will be associated with the TargetSslProxy - A reference to the SslPolicy resource that will be associated with the TargetSslProxy
@ -93,6 +98,7 @@ options:
to a gcp_compute_ssl_policy task and then set this ssl_policy field to "{{ name-of-resource to a gcp_compute_ssl_policy task and then set this ssl_policy field to "{{ name-of-resource
}}"' }}"'
required: false required: false
type: dict
version_added: 2.8 version_added: 2.8
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:

View file

@ -52,6 +52,7 @@ options:
description: description:
- An optional description of this resource. - An optional description of this resource.
required: false required: false
type: str
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -61,12 +62,14 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
proxy_header: proxy_header:
description: description:
- Specifies the type of proxy header to append before sending data to the backend, - Specifies the type of proxy header to append before sending data to the backend,
either NONE or PROXY_V1. The default is NONE. either NONE or PROXY_V1. The default is NONE.
- 'Some valid choices include: "NONE", "PROXY_V1"' - 'Some valid choices include: "NONE", "PROXY_V1"'
required: false required: false
type: str
service: service:
description: description:
- A reference to the BackendService resource. - A reference to the BackendService resource.
@ -76,6 +79,7 @@ options:
name-of-resource` to a gcp_compute_backend_service task and then set this service name-of-resource` to a gcp_compute_backend_service task and then set this service
field to "{{ name-of-resource }}"' field to "{{ name-of-resource }}"'
required: true required: true
type: dict
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/targetTcpProxies)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/targetTcpProxies)'

View file

@ -52,6 +52,7 @@ options:
description: description:
- An optional description of this resource. - An optional description of this resource.
required: false required: false
type: str
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -61,6 +62,7 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
network: network:
description: description:
- The network this VPN gateway is accepting traffic for. - The network this VPN gateway is accepting traffic for.
@ -70,10 +72,12 @@ options:
to a gcp_compute_network task and then set this network field to "{{ name-of-resource to a gcp_compute_network task and then set this network field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
region: region:
description: description:
- The region this gateway should sit in. - The region this gateway should sit in.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/targetVpnGateways)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/targetVpnGateways)'

View file

@ -49,6 +49,7 @@ options:
description: description:
- The region this gateway should sit in. - The region this gateway should sit in.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -57,32 +57,38 @@ options:
name-of-resource` to a gcp_compute_backend_service task and then set this default_service name-of-resource` to a gcp_compute_backend_service task and then set this default_service
field to "{{ name-of-resource }}"' field to "{{ name-of-resource }}"'
required: true required: true
type: dict
description: description:
description: description:
- An optional description of this resource. Provide this property when you create - An optional description of this resource. Provide this property when you create
the resource. the resource.
required: false required: false
type: str
host_rules: host_rules:
description: description:
- The list of HostRules to use against the URL. - The list of HostRules to use against the URL.
required: false required: false
type: list
suboptions: suboptions:
description: description:
description: description:
- An optional description of this HostRule. Provide this property when you - An optional description of this HostRule. Provide this property when you
create the resource. create the resource.
required: false required: false
type: str
hosts: hosts:
description: description:
- The list of host patterns to match. They must be valid hostnames, except - The list of host patterns to match. They must be valid hostnames, except
* will match any string of ([a-z0-9-.]*). In that case, * must be the first * will match any string of ([a-z0-9-.]*). In that case, * must be the first
character and must be followed in the pattern by either - or . character and must be followed in the pattern by either - or .
required: true required: true
type: list
path_matcher: path_matcher:
description: description:
- The name of the PathMatcher to use to match the path portion of the URL - The name of the PathMatcher to use to match the path portion of the URL
if the hostRule matches the URL's host portion. if the hostRule matches the URL's host portion.
required: true required: true
type: str
name: name:
description: description:
- Name of the resource. Provided by the client when the resource is created. The - Name of the resource. Provided by the client when the resource is created. The
@ -92,10 +98,12 @@ options:
characters must be a dash, lowercase letter, or digit, except the last character, characters must be a dash, lowercase letter, or digit, except the last character,
which cannot be a dash. which cannot be a dash.
required: true required: true
type: str
path_matchers: path_matchers:
description: description:
- The list of named PathMatchers to use against the URL. - The list of named PathMatchers to use against the URL.
required: false required: false
type: list
suboptions: suboptions:
default_service: default_service:
description: description:
@ -107,18 +115,22 @@ options:
name-of-resource` to a gcp_compute_backend_service task and then set this name-of-resource` to a gcp_compute_backend_service task and then set this
default_service field to "{{ name-of-resource }}"' default_service field to "{{ name-of-resource }}"'
required: true required: true
type: dict
description: description:
description: description:
- An optional description of this resource. - An optional description of this resource.
required: false required: false
type: str
name: name:
description: description:
- The name to which this PathMatcher is referred by the HostRule. - The name to which this PathMatcher is referred by the HostRule.
required: true required: true
type: str
path_rules: path_rules:
description: description:
- The list of path rules. - The list of path rules.
required: false required: false
type: list
suboptions: suboptions:
paths: paths:
description: description:
@ -127,6 +139,7 @@ options:
to the path matcher does not include any text after the first ? or #, to the path matcher does not include any text after the first ? or #,
and those chars are not allowed here.' and those chars are not allowed here.'
required: true required: true
type: list
service: service:
description: description:
- A reference to the BackendService resource if this rule is matched. - A reference to the BackendService resource if this rule is matched.
@ -136,24 +149,29 @@ options:
you can add `register: name-of-resource` to a gcp_compute_backend_service you can add `register: name-of-resource` to a gcp_compute_backend_service
task and then set this service field to "{{ name-of-resource }}"' task and then set this service field to "{{ name-of-resource }}"'
required: true required: true
type: dict
tests: tests:
description: description:
- The list of expected URL mappings. Requests to update this UrlMap will succeed - The list of expected URL mappings. Requests to update this UrlMap will succeed
only if all of the test cases pass. only if all of the test cases pass.
required: false required: false
type: list
suboptions: suboptions:
description: description:
description: description:
- Description of this test case. - Description of this test case.
required: false required: false
type: str
host: host:
description: description:
- Host portion of the URL. - Host portion of the URL.
required: true required: true
type: str
path: path:
description: description:
- Path portion of the URL. - Path portion of the URL.
required: true required: true
type: str
service: service:
description: description:
- A reference to expected BackendService resource the given URL should be - A reference to expected BackendService resource the given URL should be
@ -164,6 +182,7 @@ options:
name-of-resource` to a gcp_compute_backend_service task and then set this name-of-resource` to a gcp_compute_backend_service task and then set this
service field to "{{ name-of-resource }}"' service field to "{{ name-of-resource }}"'
required: true required: true
type: dict
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -55,10 +55,12 @@ options:
be a lowercase letter, and all following characters must be a dash, lowercase be a lowercase letter, and all following characters must be a dash, lowercase
letter, or digit, except the last character, which cannot be a dash. letter, or digit, except the last character, which cannot be a dash.
required: true required: true
type: str
description: description:
description: description:
- An optional description of this resource. - An optional description of this resource.
required: false required: false
type: str
target_vpn_gateway: target_vpn_gateway:
description: description:
- URL of the Target VPN gateway with which this VPN tunnel is associated. - URL of the Target VPN gateway with which this VPN tunnel is associated.
@ -68,6 +70,7 @@ options:
name-of-resource` to a gcp_compute_target_vpn_gateway task and then set this name-of-resource` to a gcp_compute_target_vpn_gateway task and then set this
target_vpn_gateway field to "{{ name-of-resource }}"' target_vpn_gateway field to "{{ name-of-resource }}"'
required: false required: false
type: dict
router: router:
description: description:
- URL of router resource to be used for dynamic routing. - URL of router resource to be used for dynamic routing.
@ -77,21 +80,25 @@ options:
to a gcp_compute_router task and then set this router field to "{{ name-of-resource to a gcp_compute_router task and then set this router field to "{{ name-of-resource
}}"' }}"'
required: false required: false
type: dict
peer_ip: peer_ip:
description: description:
- IP address of the peer VPN gateway. Only IPv4 is supported. - IP address of the peer VPN gateway. Only IPv4 is supported.
required: false required: false
type: str
shared_secret: shared_secret:
description: description:
- Shared secret used to set the secure session between the Cloud VPN gateway and - Shared secret used to set the secure session between the Cloud VPN gateway and
the peer VPN gateway. the peer VPN gateway.
required: true required: true
type: str
ike_version: ike_version:
description: description:
- IKE protocol version to use when establishing the VPN tunnel with peer VPN gateway. - IKE protocol version to use when establishing the VPN tunnel with peer VPN gateway.
- Acceptable IKE versions are 1 or 2. Default version is 2. - Acceptable IKE versions are 1 or 2. Default version is 2.
required: false required: false
default: '2' default: '2'
type: int
local_traffic_selector: local_traffic_selector:
description: description:
- Local traffic selector to use when establishing the VPN tunnel with peer VPN - Local traffic selector to use when establishing the VPN tunnel with peer VPN
@ -99,6 +106,7 @@ options:
The ranges should be disjoint. The ranges should be disjoint.
- Only IPv4 is supported. - Only IPv4 is supported.
required: false required: false
type: list
remote_traffic_selector: remote_traffic_selector:
description: description:
- Remote traffic selector to use when establishing the VPN tunnel with peer VPN - Remote traffic selector to use when establishing the VPN tunnel with peer VPN
@ -106,10 +114,12 @@ options:
The ranges should be disjoint. The ranges should be disjoint.
- Only IPv4 is supported. - Only IPv4 is supported.
required: false required: false
type: list
region: region:
description: description:
- The region where the tunnel is located. - The region where the tunnel is located.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/vpnTunnels)' - 'API Reference: U(https://cloud.google.com/compute/docs/reference/rest/v1/vpnTunnels)'

View file

@ -49,6 +49,7 @@ options:
description: description:
- The region where the tunnel is located. - The region where the tunnel is located.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -53,10 +53,12 @@ options:
and can be up to 40 characters. Must be Lowercase letters, numbers, and hyphens and can be up to 40 characters. Must be Lowercase letters, numbers, and hyphens
only. Must start with a letter. Must end with a number or a letter. only. Must start with a letter. Must end with a number or a letter.
required: false required: false
type: str
description: description:
description: description:
- An optional description of this cluster. - An optional description of this cluster.
required: false required: false
type: str
initial_node_count: initial_node_count:
description: description:
- The number of nodes to create in this cluster. You must ensure that your Compute - The number of nodes to create in this cluster. You must ensure that your Compute
@ -67,6 +69,7 @@ options:
name. Do not use this and a nodePool at the same time. name. Do not use this and a nodePool at the same time.
- This field has been deprecated. Please use nodePool.initial_node_count instead. - This field has been deprecated. Please use nodePool.initial_node_count instead.
required: false required: false
type: int
node_config: node_config:
description: description:
- Parameters used in creating the cluster's nodes. - Parameters used in creating the cluster's nodes.
@ -77,17 +80,20 @@ options:
the node configuration of the first node pool. If unspecified, the defaults the node configuration of the first node pool. If unspecified, the defaults
are used. are used.
required: false required: false
type: dict
suboptions: suboptions:
machine_type: machine_type:
description: description:
- The name of a Google Compute Engine machine type (e.g. - The name of a Google Compute Engine machine type (e.g.
- n1-standard-1). If unspecified, the default machine type is n1-standard-1. - n1-standard-1). If unspecified, the default machine type is n1-standard-1.
required: false required: false
type: str
disk_size_gb: disk_size_gb:
description: description:
- Size of the disk attached to each node, specified in GB. The smallest allowed - Size of the disk attached to each node, specified in GB. The smallest allowed
disk size is 10GB. If unspecified, the default disk size is 100GB. disk size is 10GB. If unspecified, the default disk size is 100GB.
required: false required: false
type: int
oauth_scopes: oauth_scopes:
description: description:
- The set of Google API scopes to be made available on all of the node VMs - The set of Google API scopes to be made available on all of the node VMs
@ -100,11 +106,13 @@ options:
- If unspecified, no scopes are added, unless Cloud Logging or Cloud Monitoring - If unspecified, no scopes are added, unless Cloud Logging or Cloud Monitoring
are enabled, in which case their required scopes will be added. are enabled, in which case their required scopes will be added.
required: false required: false
type: list
service_account: service_account:
description: description:
- The Google Cloud Platform Service Account to be used by the node VMs. If - The Google Cloud Platform Service Account to be used by the node VMs. If
no Service Account is specified, the "default" service account is used. no Service Account is specified, the "default" service account is used.
required: false required: false
type: str
metadata: metadata:
description: description:
- The metadata key/value pairs assigned to instances in the cluster. - The metadata key/value pairs assigned to instances in the cluster.
@ -120,11 +128,13 @@ options:
- 'An object containing a list of "key": value pairs.' - 'An object containing a list of "key": value pairs.'
- 'Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.' - 'Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.'
required: false required: false
type: dict
image_type: image_type:
description: description:
- The image type to use for this node. Note that for a given image type, the - The image type to use for this node. Note that for a given image type, the
latest version of it will be used. latest version of it will be used.
required: false required: false
type: str
labels: labels:
description: description:
- 'The map of Kubernetes labels (key/value pairs) to be applied to each node. - 'The map of Kubernetes labels (key/value pairs) to be applied to each node.
@ -136,6 +146,7 @@ options:
An object containing a list of "key": value pairs.' An object containing a list of "key": value pairs.'
- 'Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.' - 'Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.'
required: false required: false
type: dict
local_ssd_count: local_ssd_count:
description: description:
- The number of local SSD disks to be attached to the node. - The number of local SSD disks to be attached to the node.
@ -143,6 +154,7 @@ options:
available on a machine per zone. See: U(https://cloud.google.com/compute/docs/disks/local-ssd#local_ssd_limits) available on a machine per zone. See: U(https://cloud.google.com/compute/docs/disks/local-ssd#local_ssd_limits)
for more information.' for more information.'
required: false required: false
type: int
tags: tags:
description: description:
- The list of instance tags applied to all nodes. Tags are used to identify - The list of instance tags applied to all nodes. Tags are used to identify
@ -150,6 +162,7 @@ options:
client during cluster or node pool creation. Each tag within the list must client during cluster or node pool creation. Each tag within the list must
comply with RFC1035. comply with RFC1035.
required: false required: false
type: list
preemptible: preemptible:
description: description:
- 'Whether the nodes are created as preemptible VM instances. See: U(https://cloud.google.com/compute/docs/instances/preemptible) - 'Whether the nodes are created as preemptible VM instances. See: U(https://cloud.google.com/compute/docs/instances/preemptible)
@ -161,27 +174,32 @@ options:
- A list of hardware accelerators to be attached to each node. See U(https://cloud.google.com/compute/docs/gpus) - A list of hardware accelerators to be attached to each node. See U(https://cloud.google.com/compute/docs/gpus)
for more information about support for GPUs. for more information about support for GPUs.
required: false required: false
type: list
version_added: 2.9 version_added: 2.9
suboptions: suboptions:
accelerator_count: accelerator_count:
description: description:
- The number of accelerator cards exposed to an instance. - The number of accelerator cards exposed to an instance.
required: false required: false
type: str
accelerator_type: accelerator_type:
description: description:
- The accelerator type resource name. - The accelerator type resource name.
required: false required: false
type: str
disk_type: disk_type:
description: description:
- Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd') - Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
If unspecified, the default disk type is 'pd-standard' . If unspecified, the default disk type is 'pd-standard' .
required: false required: false
type: str
version_added: 2.9 version_added: 2.9
min_cpu_platform: min_cpu_platform:
description: description:
- Minimum CPU platform to be used by this instance. The instance may be scheduled - Minimum CPU platform to be used by this instance. The instance may be scheduled
on the specified or newer CPU platform. on the specified or newer CPU platform.
required: false required: false
type: str
version_added: 2.9 version_added: 2.9
taints: taints:
description: description:
@ -189,43 +207,51 @@ options:
- 'For more information, including usage and the valid values, see: U(https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/) - 'For more information, including usage and the valid values, see: U(https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/)
.' .'
required: false required: false
type: list
version_added: 2.9 version_added: 2.9
suboptions: suboptions:
key: key:
description: description:
- Key for taint. - Key for taint.
required: false required: false
type: str
value: value:
description: description:
- Value for taint. - Value for taint.
required: false required: false
type: str
effect: effect:
description: description:
- Effect for taint. - Effect for taint.
- 'Some valid choices include: "EFFECT_UNSPECIFIED", "NO_SCHEDULE", "PREFER_NO_SCHEDULE", - 'Some valid choices include: "EFFECT_UNSPECIFIED", "NO_SCHEDULE", "PREFER_NO_SCHEDULE",
"NO_EXECUTE"' "NO_EXECUTE"'
required: false required: false
type: str
master_auth: master_auth:
description: description:
- The authentication information for accessing the master endpoint. - The authentication information for accessing the master endpoint.
required: false required: false
type: dict
suboptions: suboptions:
username: username:
description: description:
- The username to use for HTTP basic authentication to the master endpoint. - The username to use for HTTP basic authentication to the master endpoint.
required: false required: false
type: str
password: password:
description: description:
- The password to use for HTTP basic authentication to the master endpoint. - The password to use for HTTP basic authentication to the master endpoint.
Because the master endpoint is open to the Internet, you should create a Because the master endpoint is open to the Internet, you should create a
strong password with a minimum of 16 characters. strong password with a minimum of 16 characters.
required: false required: false
type: str
client_certificate_config: client_certificate_config:
description: description:
- Configuration for client certificate authentication on the cluster. For - Configuration for client certificate authentication on the cluster. For
clusters before v1.12, if no configuration is specified, a client certificate clusters before v1.12, if no configuration is specified, a client certificate
is issued. is issued.
required: false required: false
type: dict
version_added: 2.9 version_added: 2.9
suboptions: suboptions:
issue_client_certificate: issue_client_certificate:
@ -241,6 +267,7 @@ options:
- if left as an empty string,logging.googleapis.com will be used. - if left as an empty string,logging.googleapis.com will be used.
- 'Some valid choices include: "logging.googleapis.com", "none"' - 'Some valid choices include: "logging.googleapis.com", "none"'
required: false required: false
type: str
monitoring_service: monitoring_service:
description: description:
- The monitoring service the cluster should use to write metrics. - The monitoring service the cluster should use to write metrics.
@ -250,15 +277,18 @@ options:
- if left as an empty string, monitoring.googleapis.com will be used. - if left as an empty string, monitoring.googleapis.com will be used.
- 'Some valid choices include: "monitoring.googleapis.com", "none"' - 'Some valid choices include: "monitoring.googleapis.com", "none"'
required: false required: false
type: str
network: network:
description: description:
- The name of the Google Compute Engine network to which the cluster is connected. - The name of the Google Compute Engine network to which the cluster is connected.
If left unspecified, the default network will be used. If left unspecified, the default network will be used.
required: false required: false
type: str
private_cluster_config: private_cluster_config:
description: description:
- Configuration for a private cluster. - Configuration for a private cluster.
required: false required: false
type: dict
version_added: 2.8 version_added: 2.8
suboptions: suboptions:
enable_private_nodes: enable_private_nodes:
@ -280,22 +310,26 @@ options:
set of masters, as well as the ILB VIP. This range must not overlap with set of masters, as well as the ILB VIP. This range must not overlap with
any other ranges in use within the cluster's network. any other ranges in use within the cluster's network.
required: false required: false
type: str
cluster_ipv4_cidr: cluster_ipv4_cidr:
description: description:
- The IP address range of the container pods in this cluster, in CIDR notation - The IP address range of the container pods in this cluster, in CIDR notation
(e.g. 10.96.0.0/14). Leave blank to have one automatically chosen or specify (e.g. 10.96.0.0/14). Leave blank to have one automatically chosen or specify
a /14 block in 10.0.0.0/8. a /14 block in 10.0.0.0/8.
required: false required: false
type: str
addons_config: addons_config:
description: description:
- Configurations for the various addons available to run in the cluster. - Configurations for the various addons available to run in the cluster.
required: false required: false
type: dict
suboptions: suboptions:
http_load_balancing: http_load_balancing:
description: description:
- Configuration for the HTTP (L7) load balancing controller addon, which makes - Configuration for the HTTP (L7) load balancing controller addon, which makes
it easy to set up HTTP load balancers for services in a cluster. it easy to set up HTTP load balancers for services in a cluster.
required: false required: false
type: dict
suboptions: suboptions:
disabled: disabled:
description: description:
@ -310,6 +344,7 @@ options:
or decreases the number of replica pods a replication controller has based or decreases the number of replica pods a replication controller has based
on the resource usage of the existing pods. on the resource usage of the existing pods.
required: false required: false
type: dict
suboptions: suboptions:
disabled: disabled:
description: description:
@ -324,6 +359,7 @@ options:
or not on the Master, it does not track whether network policy is enabled or not on the Master, it does not track whether network policy is enabled
for the nodes. for the nodes.
required: false required: false
type: dict
version_added: 2.9 version_added: 2.9
suboptions: suboptions:
disabled: disabled:
@ -335,11 +371,13 @@ options:
description: description:
- The name of the Google Compute Engine subnetwork to which the cluster is connected. - The name of the Google Compute Engine subnetwork to which the cluster is connected.
required: false required: false
type: str
locations: locations:
description: description:
- The list of Google Compute Engine zones in which the cluster's nodes should - The list of Google Compute Engine zones in which the cluster's nodes should
be located. be located.
required: false required: false
type: list
aliases: aliases:
- nodeLocations - nodeLocations
version_added: 2.9 version_added: 2.9
@ -348,11 +386,13 @@ options:
- The resource labels for the cluster to use to annotate any related Google Compute - The resource labels for the cluster to use to annotate any related Google Compute
Engine resources. Engine resources.
required: false required: false
type: dict
version_added: 2.9 version_added: 2.9
legacy_abac: legacy_abac:
description: description:
- Configuration for the legacy ABAC authorization mode. - Configuration for the legacy ABAC authorization mode.
required: false required: false
type: dict
version_added: 2.9 version_added: 2.9
suboptions: suboptions:
enabled: enabled:
@ -367,6 +407,7 @@ options:
description: description:
- Configuration options for the NetworkPolicy feature. - Configuration options for the NetworkPolicy feature.
required: false required: false
type: dict
version_added: 2.9 version_added: 2.9
suboptions: suboptions:
provider: provider:
@ -374,6 +415,7 @@ options:
- The selected network policy provider. - The selected network policy provider.
- 'Some valid choices include: "PROVIDER_UNSPECIFIED", "CALICO"' - 'Some valid choices include: "PROVIDER_UNSPECIFIED", "CALICO"'
required: false required: false
type: str
enabled: enabled:
description: description:
- Whether network policy is enabled on the cluster. - Whether network policy is enabled on the cluster.
@ -385,12 +427,14 @@ options:
on a node in the node pool of this cluster. on a node in the node pool of this cluster.
- Only honored if cluster created with IP Alias support. - Only honored if cluster created with IP Alias support.
required: false required: false
type: dict
version_added: 2.9 version_added: 2.9
suboptions: suboptions:
max_pods_per_node: max_pods_per_node:
description: description:
- Constraint enforced on the max num of pods per node. - Constraint enforced on the max num of pods per node.
required: false required: false
type: str
enable_tpu: enable_tpu:
description: description:
- Enable the ability to use Cloud TPUs in this cluster. - Enable the ability to use Cloud TPUs in this cluster.
@ -401,11 +445,13 @@ options:
description: description:
- The IP address range of the Cloud TPUs in this cluster, in CIDR notation. - The IP address range of the Cloud TPUs in this cluster, in CIDR notation.
required: false required: false
type: str
version_added: 2.9 version_added: 2.9
location: location:
description: description:
- The location where the cluster is deployed. - The location where the cluster is deployed.
required: true required: true
type: str
aliases: aliases:
- zone - zone
version_added: 2.8 version_added: 2.8
@ -416,12 +462,14 @@ options:
- Any existing file at this path will be completely overwritten. - Any existing file at this path will be completely overwritten.
- This requires the PyYaml library. - This requires the PyYaml library.
required: false required: false
type: str
version_added: 2.9 version_added: 2.9
kubectl_context: kubectl_context:
description: description:
- The name of the context for the kubectl config file. Will default to the cluster - The name of the context for the kubectl config file. Will default to the cluster
name. name.
required: false required: false
type: str
version_added: 2.9 version_added: 2.9
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -44,6 +44,7 @@ options:
description: description:
- The location where the cluster is deployed. - The location where the cluster is deployed.
required: true required: true
type: str
aliases: aliases:
- region - region
- zone - zone

View file

@ -55,21 +55,25 @@ options:
description: description:
- The name of the node pool. - The name of the node pool.
required: false required: false
type: str
config: config:
description: description:
- The node configuration of the pool. - The node configuration of the pool.
required: false required: false
type: dict
suboptions: suboptions:
machine_type: machine_type:
description: description:
- The name of a Google Compute Engine machine type (e.g. - The name of a Google Compute Engine machine type (e.g.
- n1-standard-1). If unspecified, the default machine type is n1-standard-1. - n1-standard-1). If unspecified, the default machine type is n1-standard-1.
required: false required: false
type: str
disk_size_gb: disk_size_gb:
description: description:
- Size of the disk attached to each node, specified in GB. The smallest allowed - Size of the disk attached to each node, specified in GB. The smallest allowed
disk size is 10GB. If unspecified, the default disk size is 100GB. disk size is 10GB. If unspecified, the default disk size is 100GB.
required: false required: false
type: int
oauth_scopes: oauth_scopes:
description: description:
- The set of Google API scopes to be made available on all of the node VMs - The set of Google API scopes to be made available on all of the node VMs
@ -82,11 +86,13 @@ options:
- If unspecified, no scopes are added, unless Cloud Logging or Cloud Monitoring - If unspecified, no scopes are added, unless Cloud Logging or Cloud Monitoring
are enabled, in which case their required scopes will be added. are enabled, in which case their required scopes will be added.
required: false required: false
type: list
service_account: service_account:
description: description:
- The Google Cloud Platform Service Account to be used by the node VMs. If - The Google Cloud Platform Service Account to be used by the node VMs. If
no Service Account is specified, the "default" service account is used. no Service Account is specified, the "default" service account is used.
required: false required: false
type: str
metadata: metadata:
description: description:
- The metadata key/value pairs assigned to instances in the cluster. - The metadata key/value pairs assigned to instances in the cluster.
@ -102,11 +108,13 @@ options:
- 'An object containing a list of "key": value pairs.' - 'An object containing a list of "key": value pairs.'
- 'Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.' - 'Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.'
required: false required: false
type: dict
image_type: image_type:
description: description:
- The image type to use for this node. Note that for a given image type, the - The image type to use for this node. Note that for a given image type, the
latest version of it will be used. latest version of it will be used.
required: false required: false
type: str
labels: labels:
description: description:
- 'The map of Kubernetes labels (key/value pairs) to be applied to each node. - 'The map of Kubernetes labels (key/value pairs) to be applied to each node.
@ -118,6 +126,7 @@ options:
An object containing a list of "key": value pairs.' An object containing a list of "key": value pairs.'
- 'Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.' - 'Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.'
required: false required: false
type: dict
local_ssd_count: local_ssd_count:
description: description:
- The number of local SSD disks to be attached to the node. - The number of local SSD disks to be attached to the node.
@ -125,6 +134,7 @@ options:
available on a machine per zone. See: U(https://cloud.google.com/compute/docs/disks/local-ssd#local_ssd_limits) available on a machine per zone. See: U(https://cloud.google.com/compute/docs/disks/local-ssd#local_ssd_limits)
for more information.' for more information.'
required: false required: false
type: int
tags: tags:
description: description:
- The list of instance tags applied to all nodes. Tags are used to identify - The list of instance tags applied to all nodes. Tags are used to identify
@ -132,6 +142,7 @@ options:
client during cluster or node pool creation. Each tag within the list must client during cluster or node pool creation. Each tag within the list must
comply with RFC1035. comply with RFC1035.
required: false required: false
type: list
preemptible: preemptible:
description: description:
- 'Whether the nodes are created as preemptible VM instances. See: U(https://cloud.google.com/compute/docs/instances/preemptible) - 'Whether the nodes are created as preemptible VM instances. See: U(https://cloud.google.com/compute/docs/instances/preemptible)
@ -142,62 +153,74 @@ options:
description: description:
- A list of hardware accelerators to be attached to each node. - A list of hardware accelerators to be attached to each node.
required: false required: false
type: list
version_added: 2.9 version_added: 2.9
suboptions: suboptions:
accelerator_count: accelerator_count:
description: description:
- The number of the accelerator cards exposed to an instance. - The number of the accelerator cards exposed to an instance.
required: false required: false
type: int
accelerator_type: accelerator_type:
description: description:
- The accelerator type resource name. - The accelerator type resource name.
required: false required: false
type: str
disk_type: disk_type:
description: description:
- Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd') - Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
If unspecified, the default disk type is 'pd-standard' . If unspecified, the default disk type is 'pd-standard' .
required: false required: false
type: str
version_added: 2.9 version_added: 2.9
min_cpu_platform: min_cpu_platform:
description: description:
- Minimum CPU platform to be used by this instance. The instance may be scheduled - Minimum CPU platform to be used by this instance. The instance may be scheduled
on the specified or newer CPU platform . on the specified or newer CPU platform .
required: false required: false
type: str
version_added: 2.9 version_added: 2.9
taints: taints:
description: description:
- List of kubernetes taints to be applied to each node. - List of kubernetes taints to be applied to each node.
required: false required: false
type: list
version_added: 2.9 version_added: 2.9
suboptions: suboptions:
key: key:
description: description:
- Key for taint. - Key for taint.
required: false required: false
type: str
value: value:
description: description:
- Value for taint. - Value for taint.
required: false required: false
type: str
effect: effect:
description: description:
- Effect for taint. - Effect for taint.
required: false required: false
type: str
initial_node_count: initial_node_count:
description: description:
- The initial node count for the pool. You must ensure that your Compute Engine - The initial node count for the pool. You must ensure that your Compute Engine
resource quota is sufficient for this number of instances. You must also have resource quota is sufficient for this number of instances. You must also have
available firewall and routes quota. available firewall and routes quota.
required: true required: true
type: int
version: version:
description: description:
- The version of the Kubernetes of this node. - The version of the Kubernetes of this node.
required: false required: false
type: str
version_added: 2.8 version_added: 2.8
autoscaling: autoscaling:
description: description:
- Autoscaler configuration for this NodePool. Autoscaler is enabled only if a - Autoscaler configuration for this NodePool. Autoscaler is enabled only if a
valid configuration is present. valid configuration is present.
required: false required: false
type: dict
suboptions: suboptions:
enabled: enabled:
description: description:
@ -208,15 +231,18 @@ options:
description: description:
- Minimum number of nodes in the NodePool. Must be >= 1 and <= maxNodeCount. - Minimum number of nodes in the NodePool. Must be >= 1 and <= maxNodeCount.
required: false required: false
type: int
max_node_count: max_node_count:
description: description:
- Maximum number of nodes in the NodePool. Must be >= minNodeCount. - Maximum number of nodes in the NodePool. Must be >= minNodeCount.
- There has to enough quota to scale up the cluster. - There has to enough quota to scale up the cluster.
required: false required: false
type: int
management: management:
description: description:
- Management configuration for this NodePool. - Management configuration for this NodePool.
required: false required: false
type: dict
suboptions: suboptions:
auto_upgrade: auto_upgrade:
description: description:
@ -237,22 +263,26 @@ options:
description: description:
- Specifies the Auto Upgrade knobs for the node pool. - Specifies the Auto Upgrade knobs for the node pool.
required: false required: false
type: dict
suboptions: {} suboptions: {}
max_pods_constraint: max_pods_constraint:
description: description:
- The constraint on the maximum number of pods that can be run simultaneously - The constraint on the maximum number of pods that can be run simultaneously
on a node in the node pool. on a node in the node pool.
required: false required: false
type: dict
version_added: 2.9 version_added: 2.9
suboptions: suboptions:
max_pods_per_node: max_pods_per_node:
description: description:
- Constraint enforced on the max num of pods per node. - Constraint enforced on the max num of pods per node.
required: false required: false
type: int
conditions: conditions:
description: description:
- Which conditions caused the current node pool state. - Which conditions caused the current node pool state.
required: false required: false
type: list
version_added: 2.9 version_added: 2.9
suboptions: suboptions:
code: code:
@ -261,6 +291,7 @@ options:
- 'Some valid choices include: "UNKNOWN", "GCE_STOCKOUT", "GKE_SERVICE_ACCOUNT_DELETED", - 'Some valid choices include: "UNKNOWN", "GCE_STOCKOUT", "GKE_SERVICE_ACCOUNT_DELETED",
"GCE_QUOTA_EXCEEDED", "SET_BY_OPERATOR"' "GCE_QUOTA_EXCEEDED", "SET_BY_OPERATOR"'
required: false required: false
type: str
cluster: cluster:
description: description:
- The cluster this node pool belongs to. - The cluster this node pool belongs to.
@ -270,10 +301,12 @@ options:
to a gcp_container_cluster task and then set this cluster field to "{{ name-of-resource to a gcp_container_cluster task and then set this cluster field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
location: location:
description: description:
- The location where the node pool is deployed. - The location where the node pool is deployed.
required: true required: true
type: str
aliases: aliases:
- region - region
- zone - zone

View file

@ -44,6 +44,7 @@ options:
description: description:
- The location where the node pool is deployed. - The location where the node pool is deployed.
required: true required: true
type: str
aliases: aliases:
- region - region
- zone - zone
@ -57,6 +58,7 @@ options:
to a gcp_container_cluster task and then set this cluster field to "{{ name-of-resource to a gcp_container_cluster task and then set this cluster field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -53,14 +53,17 @@ options:
- A mutable string of at most 1024 characters associated with this resource for - A mutable string of at most 1024 characters associated with this resource for
the user's convenience. Has no effect on the managed zone's function. the user's convenience. Has no effect on the managed zone's function.
required: true required: true
type: str
dns_name: dns_name:
description: description:
- The DNS name of this managed zone, for instance "example.com.". - The DNS name of this managed zone, for instance "example.com.".
required: true required: true
type: str
dnssec_config: dnssec_config:
description: description:
- DNSSEC configuration. - DNSSEC configuration.
required: false required: false
type: dict
version_added: 2.9 version_added: 2.9
suboptions: suboptions:
kind: kind:
@ -68,23 +71,27 @@ options:
- Identifies what kind of resource this is. - Identifies what kind of resource this is.
required: false required: false
default: dns#managedZoneDnsSecConfig default: dns#managedZoneDnsSecConfig
type: str
non_existence: non_existence:
description: description:
- Specifies the mechanism used to provide authenticated denial-of-existence - Specifies the mechanism used to provide authenticated denial-of-existence
responses. responses.
- 'Some valid choices include: "nsec", "nsec3"' - 'Some valid choices include: "nsec", "nsec3"'
required: false required: false
type: str
state: state:
description: description:
- Specifies whether DNSSEC is enabled, and what mode it is in. - Specifies whether DNSSEC is enabled, and what mode it is in.
- 'Some valid choices include: "off", "on", "transfer"' - 'Some valid choices include: "off", "on", "transfer"'
required: false required: false
type: str
default_key_specs: default_key_specs:
description: description:
- Specifies parameters that will be used for generating initial DnsKeys for - Specifies parameters that will be used for generating initial DnsKeys for
this ManagedZone. If you provide a spec for keySigning or zoneSigning, you this ManagedZone. If you provide a spec for keySigning or zoneSigning, you
must also provide one for the other. must also provide one for the other.
required: false required: false
type: list
suboptions: suboptions:
algorithm: algorithm:
description: description:
@ -92,10 +99,12 @@ options:
- 'Some valid choices include: "ecdsap256sha256", "ecdsap384sha384", "rsasha1", - 'Some valid choices include: "ecdsap256sha256", "ecdsap384sha384", "rsasha1",
"rsasha256", "rsasha512"' "rsasha256", "rsasha512"'
required: false required: false
type: str
key_length: key_length:
description: description:
- Length of the keys in bits. - Length of the keys in bits.
required: false required: false
type: int
key_type: key_type:
description: description:
- Specifies whether this is a key signing key (KSK) or a zone signing - Specifies whether this is a key signing key (KSK) or a zone signing
@ -105,26 +114,31 @@ options:
and will be used to sign all other types of resource record sets. . and will be used to sign all other types of resource record sets. .
- 'Some valid choices include: "keySigning", "zoneSigning"' - 'Some valid choices include: "keySigning", "zoneSigning"'
required: false required: false
type: str
kind: kind:
description: description:
- Identifies what kind of resource this is. - Identifies what kind of resource this is.
required: false required: false
default: dns#dnsKeySpec default: dns#dnsKeySpec
type: str
name: name:
description: description:
- User assigned name for this resource. - User assigned name for this resource.
- Must be unique within the project. - Must be unique within the project.
required: true required: true
type: str
name_server_set: name_server_set:
description: description:
- Optionally specifies the NameServerSet for this ManagedZone. A NameServerSet - Optionally specifies the NameServerSet for this ManagedZone. A NameServerSet
is a set of DNS name servers that all host the same ManagedZones. Most users is a set of DNS name servers that all host the same ManagedZones. Most users
will leave this field unset. will leave this field unset.
required: false required: false
type: str
labels: labels:
description: description:
- A set of key/value label pairs to assign to this ManagedZone. - A set of key/value label pairs to assign to this ManagedZone.
required: false required: false
type: dict
version_added: 2.8 version_added: 2.8
visibility: visibility:
description: description:
@ -134,18 +148,21 @@ options:
- 'Some valid choices include: "private", "public"' - 'Some valid choices include: "private", "public"'
required: false required: false
default: public default: public
type: str
version_added: 2.8 version_added: 2.8
private_visibility_config: private_visibility_config:
description: description:
- For privately visible zones, the set of Virtual Private Cloud resources that - For privately visible zones, the set of Virtual Private Cloud resources that
the zone is visible from. the zone is visible from.
required: false required: false
type: dict
version_added: 2.8 version_added: 2.8
suboptions: suboptions:
networks: networks:
description: description:
- The list of VPC networks that can see this zone. - The list of VPC networks that can see this zone.
required: false required: false
type: list
suboptions: suboptions:
network_url: network_url:
description: description:
@ -153,6 +170,7 @@ options:
- This should be formatted like `U(https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}`) - This should be formatted like `U(https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}`)
. .
required: false required: false
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/dns/api/v1/managedZones)' - 'API Reference: U(https://cloud.google.com/dns/api/v1/managedZones)'

View file

@ -55,20 +55,24 @@ options:
description: description:
- For example, U(www.example.com). - For example, U(www.example.com).
required: true required: true
type: str
type: type:
description: description:
- One of valid DNS resource types. - One of valid DNS resource types.
- 'Some valid choices include: "A", "AAAA", "CAA", "CNAME", "MX", "NAPTR", "NS", - 'Some valid choices include: "A", "AAAA", "CAA", "CNAME", "MX", "NAPTR", "NS",
"PTR", "SOA", "SPF", "SRV", "TLSA", "TXT"' "PTR", "SOA", "SPF", "SRV", "TLSA", "TXT"'
required: true required: true
type: str
ttl: ttl:
description: description:
- Number of seconds that this ResourceRecordSet can be cached by resolvers. - Number of seconds that this ResourceRecordSet can be cached by resolvers.
required: false required: false
type: int
target: target:
description: description:
- As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) . - As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) .
required: false required: false
type: list
managed_zone: managed_zone:
description: description:
- Identifies the managed zone addressed by this request. - Identifies the managed zone addressed by this request.
@ -78,6 +82,7 @@ options:
to a gcp_dns_managed_zone task and then set this managed_zone field to "{{ name-of-resource to a gcp_dns_managed_zone task and then set this managed_zone field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -49,6 +49,7 @@ options:
to a gcp_dns_managed_zone task and then set this managed_zone field to "{{ name-of-resource to a gcp_dns_managed_zone task and then set this managed_zone field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -51,25 +51,30 @@ options:
description: description:
- The name of the role. - The name of the role.
required: true required: true
type: str
title: title:
description: description:
- A human-readable title for the role. Typically this is limited to 100 UTF-8 - A human-readable title for the role. Typically this is limited to 100 UTF-8
bytes. bytes.
required: false required: false
type: str
description: description:
description: description:
- Human-readable description for the role. - Human-readable description for the role.
required: false required: false
type: str
included_permissions: included_permissions:
description: description:
- Names of permissions this role grants when bound in an IAM policy. - Names of permissions this role grants when bound in an IAM policy.
required: false required: false
type: list
stage: stage:
description: description:
- The current launch stage of the role. - The current launch stage of the role.
- 'Some valid choices include: "ALPHA", "BETA", "GA", "DEPRECATED", "DISABLED", - 'Some valid choices include: "ALPHA", "BETA", "GA", "DEPRECATED", "DISABLED",
"EAP"' "EAP"'
required: false required: false
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -51,10 +51,12 @@ options:
description: description:
- The name of the service account. - The name of the service account.
required: false required: false
type: str
display_name: display_name:
description: description:
- User specified description of service account. - User specified description of service account.
required: false required: false
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -52,11 +52,13 @@ options:
- Output format for the service account key. - Output format for the service account key.
- 'Some valid choices include: "TYPE_UNSPECIFIED", "TYPE_PKCS12_FILE", "TYPE_GOOGLE_CREDENTIALS_FILE"' - 'Some valid choices include: "TYPE_UNSPECIFIED", "TYPE_PKCS12_FILE", "TYPE_GOOGLE_CREDENTIALS_FILE"'
required: false required: false
type: str
key_algorithm: key_algorithm:
description: description:
- Specifies the algorithm for the key. - Specifies the algorithm for the key.
- 'Some valid choices include: "KEY_ALG_UNSPECIFIED", "KEY_ALG_RSA_1024", "KEY_ALG_RSA_2048"' - 'Some valid choices include: "KEY_ALG_UNSPECIFIED", "KEY_ALG_RSA_1024", "KEY_ALG_RSA_2048"'
required: false required: false
type: str
service_account: service_account:
description: description:
- The name of the serviceAccount. - The name of the serviceAccount.
@ -66,12 +68,14 @@ options:
to a gcp_iam_service_account task and then set this service_account field to to a gcp_iam_service_account task and then set this service_account field to
"{{ name-of-resource }}"' "{{ name-of-resource }}"'
required: false required: false
type: dict
path: path:
description: description:
- The full name of the file that will hold the service account private key. The - The full name of the file that will hold the service account private key. The
management of this file will depend on the value of sync_file parameter. management of this file will depend on the value of sync_file parameter.
- File path must be absolute. - File path must be absolute.
required: false required: false
type: path
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -52,6 +52,7 @@ options:
description: description:
- Name of the subscription. - Name of the subscription.
required: true required: true
type: str
topic: topic:
description: description:
- A reference to a Topic resource. - A reference to a Topic resource.
@ -61,10 +62,12 @@ options:
to a gcp_pubsub_topic task and then set this topic field to "{{ name-of-resource to a gcp_pubsub_topic task and then set this topic field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
labels: labels:
description: description:
- A set of key/value label pairs to assign to this Subscription. - A set of key/value label pairs to assign to this Subscription.
required: false required: false
type: dict
version_added: 2.8 version_added: 2.8
push_config: push_config:
description: description:
@ -72,12 +75,14 @@ options:
it. An empty pushConfig signifies that the subscriber will pull and ack messages it. An empty pushConfig signifies that the subscriber will pull and ack messages
using API methods. using API methods.
required: false required: false
type: dict
suboptions: suboptions:
push_endpoint: push_endpoint:
description: description:
- A URL locating the endpoint to which messages should be pushed. - A URL locating the endpoint to which messages should be pushed.
- For example, a Webhook endpoint might use "U(https://example.com/push"). - For example, a Webhook endpoint might use "U(https://example.com/push").
required: true required: true
type: str
attributes: attributes:
description: description:
- Endpoint configuration attributes. - Endpoint configuration attributes.
@ -97,6 +102,7 @@ options:
defined in the v1beta1 Pub/Sub API.' defined in the v1beta1 Pub/Sub API.'
- "- v1 or v1beta2: uses the push format defined in the v1 Pub/Sub API." - "- v1 or v1beta2: uses the push format defined in the v1 Pub/Sub API."
required: false required: false
type: dict
ack_deadline_seconds: ack_deadline_seconds:
description: description:
- This value is the maximum time after a subscriber receives a message before - This value is the maximum time after a subscriber receives a message before
@ -114,6 +120,7 @@ options:
- If the subscriber never acknowledges the message, the Pub/Sub system will eventually - If the subscriber never acknowledges the message, the Pub/Sub system will eventually
redeliver the message. redeliver the message.
required: false required: false
type: int
message_retention_duration: message_retention_duration:
description: description:
- How long to retain unacknowledged messages in the subscription's backlog, from - How long to retain unacknowledged messages in the subscription's backlog, from
@ -125,6 +132,7 @@ options:
Example: `"600.5s"`.' Example: `"600.5s"`.'
required: false required: false
default: 604800s default: 604800s
type: str
version_added: 2.8 version_added: 2.8
retain_acked_messages: retain_acked_messages:
description: description:
@ -142,6 +150,7 @@ options:
If expirationPolicy is not set, a default policy with ttl of 31 days will be If expirationPolicy is not set, a default policy with ttl of 31 days will be
used. The minimum allowed value for expirationPolicy.ttl is 1 day. used. The minimum allowed value for expirationPolicy.ttl is 1 day.
required: false required: false
type: dict
version_added: 2.9 version_added: 2.9
suboptions: suboptions:
ttl: ttl:
@ -154,6 +163,7 @@ options:
- A duration in seconds with up to nine fractional digits, terminated by 's'. - A duration in seconds with up to nine fractional digits, terminated by 's'.
- Example - "3.5s". - Example - "3.5s".
required: false required: false
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.subscriptions)' - 'API Reference: U(https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.subscriptions)'

View file

@ -51,6 +51,7 @@ options:
description: description:
- Name of the topic. - Name of the topic.
required: true required: true
type: str
kms_key_name: kms_key_name:
description: description:
- The resource name of the Cloud KMS CryptoKey to be used to protect access to - The resource name of the Cloud KMS CryptoKey to be used to protect access to
@ -58,11 +59,13 @@ options:
must have `roles/cloudkms.cryptoKeyEncrypterDecrypter` to use this feature. must have `roles/cloudkms.cryptoKeyEncrypterDecrypter` to use this feature.
- The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*` . - The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*` .
required: false required: false
type: str
version_added: 2.9 version_added: 2.9
labels: labels:
description: description:
- A set of key/value label pairs to assign to this Topic. - A set of key/value label pairs to assign to this Topic.
required: false required: false
type: dict
version_added: 2.8 version_added: 2.8
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:

View file

@ -53,19 +53,23 @@ options:
failures by provisioning it across two zones. failures by provisioning it across two zones.
- If provided, it must be a different zone from the one provided in [locationId]. - If provided, it must be a different zone from the one provided in [locationId].
required: false required: false
type: str
authorized_network: authorized_network:
description: description:
- The full name of the Google Compute Engine network to which the instance is - The full name of the Google Compute Engine network to which the instance is
connected. If left unspecified, the default network will be used. connected. If left unspecified, the default network will be used.
required: false required: false
type: str
display_name: display_name:
description: description:
- An arbitrary and optional user-provided name for the instance. - An arbitrary and optional user-provided name for the instance.
required: false required: false
type: str
labels: labels:
description: description:
- Resource labels to represent user provided metadata. - Resource labels to represent user provided metadata.
required: false required: false
type: dict
redis_configs: redis_configs:
description: description:
- Redis configuration parameters, according to U(http://redis.io/topics/config). - Redis configuration parameters, according to U(http://redis.io/topics/config).
@ -73,6 +77,7 @@ options:
U(https://cloud.google.com/memorystore/docs/redis/reference/rest/v1/projects.locations.instances#Instance.FIELDS.redis_configs) U(https://cloud.google.com/memorystore/docs/redis/reference/rest/v1/projects.locations.instances#Instance.FIELDS.redis_configs)
.' .'
required: false required: false
type: dict
location_id: location_id:
description: description:
- The zone where the instance will be provisioned. If not provided, the service - The zone where the instance will be provisioned. If not provided, the service
@ -80,20 +85,24 @@ options:
created across two zones for protection against zonal failures. If [alternativeLocationId] created across two zones for protection against zonal failures. If [alternativeLocationId]
is also provided, it must be different from [locationId]. is also provided, it must be different from [locationId].
required: false required: false
type: str
name: name:
description: description:
- The ID of the instance or a fully qualified identifier for the instance. . - The ID of the instance or a fully qualified identifier for the instance. .
required: true required: true
type: str
memory_size_gb: memory_size_gb:
description: description:
- Redis memory size in GiB. - Redis memory size in GiB.
required: true required: true
type: int
redis_version: redis_version:
description: description:
- The version of Redis software. If not provided, latest supported version will - The version of Redis software. If not provided, latest supported version will
be used. Updating the version will perform an upgrade/downgrade to the new version. be used. Updating the version will perform an upgrade/downgrade to the new version.
Currently, the supported values are REDIS_3_2 for Redis 3.2. Currently, the supported values are REDIS_3_2 for Redis 3.2.
required: false required: false
type: str
reserved_ip_range: reserved_ip_range:
description: description:
- The CIDR range of internal addresses that are reserved for this instance. If - The CIDR range of internal addresses that are reserved for this instance. If
@ -101,6 +110,7 @@ options:
or 192.168.0.0/29. Ranges must be unique and non-overlapping with existing subnets or 192.168.0.0/29. Ranges must be unique and non-overlapping with existing subnets
in an authorized network. in an authorized network.
required: false required: false
type: str
tier: tier:
description: description:
- 'The service tier of the instance. Must be one of these values: - BASIC: standalone - 'The service tier of the instance. Must be one of these values: - BASIC: standalone
@ -108,10 +118,12 @@ options:
- 'Some valid choices include: "BASIC", "STANDARD_HA"' - 'Some valid choices include: "BASIC", "STANDARD_HA"'
required: false required: false
default: BASIC default: BASIC
type: str
region: region:
description: description:
- The name of the Redis region of the instance. - The name of the Redis region of the instance.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/memorystore/docs/redis/reference/rest/)' - 'API Reference: U(https://cloud.google.com/memorystore/docs/redis/reference/rest/)'

View file

@ -44,6 +44,7 @@ options:
description: description:
- The name of the Redis region of the instance. - The name of the Redis region of the instance.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -54,6 +54,7 @@ options:
Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote,
double-quote, space, and exclamation point.' double-quote, space, and exclamation point.'
required: false required: false
type: str
labels: labels:
description: description:
- The labels associated with this Project. - The labels associated with this Project.
@ -65,25 +66,30 @@ options:
- Clients should store labels in a representation such as JSON that does not depend - Clients should store labels in a representation such as JSON that does not depend
on specific characters being disallowed . on specific characters being disallowed .
required: false required: false
type: dict
parent: parent:
description: description:
- A parent organization. - A parent organization.
required: false required: false
type: dict
suboptions: suboptions:
type: type:
description: description:
- Must be organization. - Must be organization.
required: false required: false
type: str
id: id:
description: description:
- Id of the organization. - Id of the organization.
required: false required: false
type: str
id: id:
description: description:
- The unique, user-assigned ID of the Project. It must be 6 to 30 lowercase letters, - The unique, user-assigned ID of the Project. It must be 6 to 30 lowercase letters,
digits, or hyphens. It must start with a letter. digits, or hyphens. It must start with a letter.
- Trailing hyphens are prohibited. - Trailing hyphens are prohibited.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -53,6 +53,7 @@ options:
- The repo name may contain slashes. eg, projects/myproject/repos/name/with/slash - The repo name may contain slashes. eg, projects/myproject/repos/name/with/slash
. .
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/source-repositories/docs/reference/rest/v1/projects.repos)' - 'API Reference: U(https://cloud.google.com/source-repositories/docs/reference/rest/v1/projects.repos)'

View file

@ -52,6 +52,7 @@ options:
- A unique identifier for the database, which cannot be changed after the instance - A unique identifier for the database, which cannot be changed after the instance
is created. Values are of the form [a-z][-a-z0-9]*[a-z0-9]. is created. Values are of the form [a-z][-a-z0-9]*[a-z0-9].
required: true required: true
type: str
extra_statements: extra_statements:
description: description:
- 'An optional list of DDL statements to run inside the newly created database. - 'An optional list of DDL statements to run inside the newly created database.
@ -59,6 +60,7 @@ options:
with the creation of the database: if there is an error in any statement, the with the creation of the database: if there is an error in any statement, the
database is not created.' database is not created.'
required: false required: false
type: list
instance: instance:
description: description:
- The instance to create the database on. - The instance to create the database on.
@ -68,6 +70,7 @@ options:
to a gcp_spanner_instance task and then set this instance field to "{{ name-of-resource to a gcp_spanner_instance task and then set this instance field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases)' - 'API Reference: U(https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases)'

View file

@ -49,6 +49,7 @@ options:
to a gcp_spanner_instance task and then set this instance field to "{{ name-of-resource to a gcp_spanner_instance task and then set this instance field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -52,6 +52,7 @@ options:
- A unique identifier for the instance, which cannot be changed after the instance - A unique identifier for the instance, which cannot be changed after the instance
is created. The name must be between 6 and 30 characters in length. is created. The name must be between 6 and 30 characters in length.
required: true required: true
type: str
config: config:
description: description:
- The name of the instance's configuration (similar but not quite the same as - The name of the instance's configuration (similar but not quite the same as
@ -61,21 +62,25 @@ options:
- In order to obtain a valid list please consult the [Configuration section of - In order to obtain a valid list please consult the [Configuration section of
the docs](U(https://cloud.google.com/spanner/docs/instances)). the docs](U(https://cloud.google.com/spanner/docs/instances)).
required: true required: true
type: str
display_name: display_name:
description: description:
- The descriptive name for this instance as it appears in UIs. Must be unique - The descriptive name for this instance as it appears in UIs. Must be unique
per project and between 4 and 30 characters in length. per project and between 4 and 30 characters in length.
required: true required: true
type: str
node_count: node_count:
description: description:
- The number of nodes allocated to this instance. - The number of nodes allocated to this instance.
required: false required: false
default: '1' default: '1'
type: int
labels: labels:
description: description:
- 'An object containing a list of "key": value pairs.' - 'An object containing a list of "key": value pairs.'
- 'Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.' - 'Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.'
required: false required: false
type: dict
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances)' - 'API Reference: U(https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances)'

View file

@ -51,19 +51,23 @@ options:
description: description:
- The MySQL charset value. - The MySQL charset value.
required: false required: false
type: str
collation: collation:
description: description:
- The MySQL collation value. - The MySQL collation value.
required: false required: false
type: str
name: name:
description: description:
- The name of the database in the Cloud SQL instance. - The name of the database in the Cloud SQL instance.
- This does not include the project ID or instance name. - This does not include the project ID or instance name.
required: true required: true
type: str
instance: instance:
description: description:
- The name of the Cloud SQL instance. This does not include the project ID. - The name of the Cloud SQL instance. This does not include the project ID.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -44,6 +44,7 @@ options:
description: description:
- The name of the Cloud SQL instance. This does not include the project ID. - The name of the Cloud SQL instance. This does not include the project ID.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -56,10 +56,12 @@ options:
- "* EXTERNAL: A database server that is not managed by Google." - "* EXTERNAL: A database server that is not managed by Google."
- 'Some valid choices include: "FIRST_GEN", "SECOND_GEN", "EXTERNAL"' - 'Some valid choices include: "FIRST_GEN", "SECOND_GEN", "EXTERNAL"'
required: false required: false
type: str
connection_name: connection_name:
description: description:
- Connection name of the Cloud SQL instance used in connection strings. - Connection name of the Cloud SQL instance used in connection strings.
required: false required: false
type: str
database_version: database_version:
description: description:
- The database engine type and version. For First Generation instances, can be - The database engine type and version. For First Generation instances, can be
@ -69,11 +71,13 @@ options:
changed after instance creation.' changed after instance creation.'
- 'Some valid choices include: "MYSQL_5_5", "MYSQL_5_6", "MYSQL_5_7", "POSTGRES_9_6"' - 'Some valid choices include: "MYSQL_5_5", "MYSQL_5_6", "MYSQL_5_7", "POSTGRES_9_6"'
required: false required: false
type: str
failover_replica: failover_replica:
description: description:
- The name and status of the failover replica. This property is applicable only - The name and status of the failover replica. This property is applicable only
to Second Generation instances. to Second Generation instances.
required: false required: false
type: dict
suboptions: suboptions:
name: name:
description: description:
@ -81,6 +85,7 @@ options:
replica is created for the instance. The name doesn't include the project replica is created for the instance. The name doesn't include the project
ID. This property is applicable only to Second Generation instances. ID. This property is applicable only to Second Generation instances.
required: false required: false
type: str
instance_type: instance_type:
description: description:
- The instance type. This can be one of the following. - The instance type. This can be one of the following.
@ -89,32 +94,39 @@ options:
- "* READ_REPLICA_INSTANCE: A Cloud SQL instance configured as a read-replica." - "* READ_REPLICA_INSTANCE: A Cloud SQL instance configured as a read-replica."
- 'Some valid choices include: "CLOUD_SQL_INSTANCE", "ON_PREMISES_INSTANCE", "READ_REPLICA_INSTANCE"' - 'Some valid choices include: "CLOUD_SQL_INSTANCE", "ON_PREMISES_INSTANCE", "READ_REPLICA_INSTANCE"'
required: false required: false
type: str
ipv6_address: ipv6_address:
description: description:
- The IPv6 address assigned to the instance. This property is applicable only - The IPv6 address assigned to the instance. This property is applicable only
to First Generation instances. to First Generation instances.
required: false required: false
type: str
master_instance_name: master_instance_name:
description: description:
- The name of the instance which will act as master in the replication setup. - The name of the instance which will act as master in the replication setup.
required: false required: false
type: str
max_disk_size: max_disk_size:
description: description:
- The maximum disk size of the instance in bytes. - The maximum disk size of the instance in bytes.
required: false required: false
type: int
name: name:
description: description:
- Name of the Cloud SQL instance. This does not include the project ID. - Name of the Cloud SQL instance. This does not include the project ID.
required: true required: true
type: str
region: region:
description: description:
- The geographical region. Defaults to us-central or us-central1 depending on - The geographical region. Defaults to us-central or us-central1 depending on
the instance type (First Generation or Second Generation/PostgreSQL). the instance type (First Generation or Second Generation/PostgreSQL).
required: false required: false
type: str
replica_configuration: replica_configuration:
description: description:
- Configuration specific to failover replicas and read replicas. - Configuration specific to failover replicas and read replicas.
required: false required: false
type: dict
suboptions: suboptions:
failover_target: failover_target:
description: description:
@ -134,24 +146,29 @@ options:
is used only to set up the replication connection and is stored by MySQL is used only to set up the replication connection and is stored by MySQL
in a file named master.info in the data directory. in a file named master.info in the data directory.
required: false required: false
type: dict
suboptions: suboptions:
ca_certificate: ca_certificate:
description: description:
- PEM representation of the trusted CA's x509 certificate. - PEM representation of the trusted CA's x509 certificate.
required: false required: false
type: str
client_certificate: client_certificate:
description: description:
- PEM representation of the slave's x509 certificate . - PEM representation of the slave's x509 certificate .
required: false required: false
type: str
client_key: client_key:
description: description:
- PEM representation of the slave's private key. The corresponding public - PEM representation of the slave's private key. The corresponding public
key is encoded in the client's certificate. key is encoded in the client's certificate.
required: false required: false
type: str
connect_retry_interval: connect_retry_interval:
description: description:
- Seconds to wait between connect retries. MySQL's default is 60 seconds. - Seconds to wait between connect retries. MySQL's default is 60 seconds.
required: false required: false
type: int
dump_file_path: dump_file_path:
description: description:
- Path to a SQL dump file in Google Cloud Storage from which the slave - Path to a SQL dump file in Google Cloud Storage from which the slave
@ -160,22 +177,27 @@ options:
binlog co-ordinates from which replication should begin. This can be binlog co-ordinates from which replication should begin. This can be
accomplished by setting --master-data to 1 when using mysqldump. accomplished by setting --master-data to 1 when using mysqldump.
required: false required: false
type: str
master_heartbeat_period: master_heartbeat_period:
description: description:
- Interval in milliseconds between replication heartbeats. - Interval in milliseconds between replication heartbeats.
required: false required: false
type: int
password: password:
description: description:
- The password for the replication connection. - The password for the replication connection.
required: false required: false
type: str
ssl_cipher: ssl_cipher:
description: description:
- A list of permissible ciphers to use for SSL encryption. - A list of permissible ciphers to use for SSL encryption.
required: false required: false
type: str
username: username:
description: description:
- The username for the replication connection. - The username for the replication connection.
required: false required: false
type: str
verify_server_certificate: verify_server_certificate:
description: description:
- Whether or not to check the master's Common Name value in the certificate - Whether or not to check the master's Common Name value in the certificate
@ -186,20 +208,24 @@ options:
description: description:
- The replicas of the instance. - The replicas of the instance.
required: false required: false
type: list
service_account_email_address: service_account_email_address:
description: description:
- The service account email address assigned to the instance. This property - The service account email address assigned to the instance. This property
is applicable only to Second Generation instances. is applicable only to Second Generation instances.
required: false required: false
type: str
settings: settings:
description: description:
- The user settings. - The user settings.
required: false required: false
type: dict
suboptions: suboptions:
database_flags: database_flags:
description: description:
- The database flags passed to the instance at startup. - The database flags passed to the instance at startup.
required: false required: false
type: list
version_added: 2.9 version_added: 2.9
suboptions: suboptions:
name: name:
@ -208,17 +234,20 @@ options:
include both server options and system variables for MySQL. Flags should include both server options and system variables for MySQL. Flags should
be specified with underscores, not hyphens. be specified with underscores, not hyphens.
required: false required: false
type: str
value: value:
description: description:
- The value of the flag. Booleans should be set to on for true and off - The value of the flag. Booleans should be set to on for true and off
for false. This field must be omitted if the flag doesn't take a value. for false. This field must be omitted if the flag doesn't take a value.
required: false required: false
type: str
ip_configuration: ip_configuration:
description: description:
- The settings for IP Management. This allows to enable or disable the instance - The settings for IP Management. This allows to enable or disable the instance
IP and manage which external networks can connect to the instance. The IPv4 IP and manage which external networks can connect to the instance. The IPv4
address cannot be disabled for Second Generation instances. address cannot be disabled for Second Generation instances.
required: false required: false
type: dict
suboptions: suboptions:
ipv4_enabled: ipv4_enabled:
description: description:
@ -231,22 +260,26 @@ options:
using the IP. In CIDR notation, also known as 'slash' notation (e.g. using the IP. In CIDR notation, also known as 'slash' notation (e.g.
192.168.100.0/24). 192.168.100.0/24).
required: false required: false
type: list
suboptions: suboptions:
expiration_time: expiration_time:
description: description:
- The time when this access control entry expires in RFC 3339 format, - The time when this access control entry expires in RFC 3339 format,
for example 2012-11-15T16:19:00.094Z. for example 2012-11-15T16:19:00.094Z.
required: false required: false
type: str
name: name:
description: description:
- An optional label to identify this entry. - An optional label to identify this entry.
required: false required: false
type: str
value: value:
description: description:
- The whitelisted value for the access control list. For example, - The whitelisted value for the access control list. For example,
to grant access to a client from an external IP (IPv4 or IPv6) address to grant access to a client from an external IP (IPv4 or IPv6) address
or subnet, use that address or subnet here. or subnet, use that address or subnet here.
required: false required: false
type: str
require_ssl: require_ssl:
description: description:
- Whether the mysqld should default to 'REQUIRE X509' for users connecting - Whether the mysqld should default to 'REQUIRE X509' for users connecting
@ -259,15 +292,18 @@ options:
For MySQL instances, this field determines whether the instance is Second For MySQL instances, this field determines whether the instance is Second
Generation (recommended) or First Generation. Generation (recommended) or First Generation.
required: false required: false
type: str
availability_type: availability_type:
description: description:
- The availabilityType define if your postgres instance is run zonal or regional. - The availabilityType define if your postgres instance is run zonal or regional.
- 'Some valid choices include: "ZONAL", "REGIONAL"' - 'Some valid choices include: "ZONAL", "REGIONAL"'
required: false required: false
type: str
backup_configuration: backup_configuration:
description: description:
- The daily backup configuration for the instance. - The daily backup configuration for the instance.
required: false required: false
type: dict
suboptions: suboptions:
enabled: enabled:
description: description:
@ -284,6 +320,7 @@ options:
description: description:
- Define the backup start time in UTC (HH:MM) . - Define the backup start time in UTC (HH:MM) .
required: false required: false
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -53,10 +53,12 @@ options:
to an empty string. For update operations, host is specified as part of the to an empty string. For update operations, host is specified as part of the
request URL. The host name cannot be updated after insertion. request URL. The host name cannot be updated after insertion.
required: true required: true
type: str
name: name:
description: description:
- The name of the user in the Cloud SQL instance. - The name of the user in the Cloud SQL instance.
required: true required: true
type: str
instance: instance:
description: description:
- The name of the Cloud SQL instance. This does not include the project ID. - The name of the Cloud SQL instance. This does not include the project ID.
@ -66,10 +68,12 @@ options:
to a gcp_sql_instance task and then set this instance field to "{{ name-of-resource to a gcp_sql_instance task and then set this instance field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
password: password:
description: description:
- The password for the user. - The password for the user.
required: false required: false
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -49,6 +49,7 @@ options:
to a gcp_sql_instance task and then set this instance field to "{{ name-of-resource to a gcp_sql_instance task and then set this instance field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -56,6 +56,7 @@ options:
description: description:
- Access controls on the bucket. - Access controls on the bucket.
required: false required: false
type: list
suboptions: suboptions:
bucket: bucket:
description: description:
@ -66,6 +67,7 @@ options:
to a gcp_storage_bucket task and then set this bucket field to "{{ name-of-resource to a gcp_storage_bucket task and then set this bucket field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
entity: entity:
description: description:
- 'The entity holding the permission, in one of the following forms: user-userId - 'The entity holding the permission, in one of the following forms: user-userId
@ -76,59 +78,71 @@ options:
- To refer to all members of the Google Apps for Business domain example.com, - To refer to all members of the Google Apps for Business domain example.com,
the entity would be domain-example.com. the entity would be domain-example.com.
required: true required: true
type: str
entity_id: entity_id:
description: description:
- The ID for the entity. - The ID for the entity.
required: false required: false
type: str
project_team: project_team:
description: description:
- The project team associated with the entity. - The project team associated with the entity.
required: false required: false
type: dict
suboptions: suboptions:
project_number: project_number:
description: description:
- The project team associated with the entity. - The project team associated with the entity.
required: false required: false
type: str
team: team:
description: description:
- The team. - The team.
- 'Some valid choices include: "editors", "owners", "viewers"' - 'Some valid choices include: "editors", "owners", "viewers"'
required: false required: false
type: str
role: role:
description: description:
- The access permission for the entity. - The access permission for the entity.
- 'Some valid choices include: "OWNER", "READER", "WRITER"' - 'Some valid choices include: "OWNER", "READER", "WRITER"'
required: false required: false
type: str
cors: cors:
description: description:
- The bucket's Cross-Origin Resource Sharing (CORS) configuration. - The bucket's Cross-Origin Resource Sharing (CORS) configuration.
required: false required: false
type: list
suboptions: suboptions:
max_age_seconds: max_age_seconds:
description: description:
- The value, in seconds, to return in the Access-Control-Max-Age header used - The value, in seconds, to return in the Access-Control-Max-Age header used
in preflight responses. in preflight responses.
required: false required: false
type: int
method: method:
description: description:
- 'The list of HTTP methods on which to include CORS response headers, (GET, - 'The list of HTTP methods on which to include CORS response headers, (GET,
OPTIONS, POST, etc) Note: "*" is permitted in the list of methods, and means OPTIONS, POST, etc) Note: "*" is permitted in the list of methods, and means
"any method".' "any method".'
required: false required: false
type: list
origin: origin:
description: description:
- The list of Origins eligible to receive CORS response headers. - The list of Origins eligible to receive CORS response headers.
- 'Note: "*" is permitted in the list of origins, and means "any Origin".' - 'Note: "*" is permitted in the list of origins, and means "any Origin".'
required: false required: false
type: list
response_header: response_header:
description: description:
- The list of HTTP headers other than the simple response headers to give - The list of HTTP headers other than the simple response headers to give
permission for the user-agent to share across domains. permission for the user-agent to share across domains.
required: false required: false
type: list
default_object_acl: default_object_acl:
description: description:
- Default access controls to apply to new objects when no ACL is provided. - Default access controls to apply to new objects when no ACL is provided.
required: false required: false
type: list
version_added: 2.7 version_added: 2.7
suboptions: suboptions:
bucket: bucket:
@ -140,6 +154,7 @@ options:
to a gcp_storage_bucket task and then set this bucket field to "{{ name-of-resource to a gcp_storage_bucket task and then set this bucket field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
entity: entity:
description: description:
- 'The entity holding the permission, in one of the following forms: * user-{{userId}} - 'The entity holding the permission, in one of the following forms: * user-{{userId}}
@ -148,58 +163,69 @@ options:
(such as "domain-example.com") * project-team-{{projectId}} * allUsers * (such as "domain-example.com") * project-team-{{projectId}} * allUsers *
allAuthenticatedUsers .' allAuthenticatedUsers .'
required: true required: true
type: str
object: object:
description: description:
- The name of the object, if applied to an object. - The name of the object, if applied to an object.
required: false required: false
type: str
role: role:
description: description:
- The access permission for the entity. - The access permission for the entity.
- 'Some valid choices include: "OWNER", "READER"' - 'Some valid choices include: "OWNER", "READER"'
required: true required: true
type: str
lifecycle: lifecycle:
description: description:
- The bucket's lifecycle configuration. - The bucket's lifecycle configuration.
- See U(https://developers.google.com/storage/docs/lifecycle) for more information. - See U(https://developers.google.com/storage/docs/lifecycle) for more information.
required: false required: false
type: dict
suboptions: suboptions:
rule: rule:
description: description:
- A lifecycle management rule, which is made of an action to take and the - A lifecycle management rule, which is made of an action to take and the
condition(s) under which the action will be taken. condition(s) under which the action will be taken.
required: false required: false
type: list
suboptions: suboptions:
action: action:
description: description:
- The action to take. - The action to take.
required: false required: false
type: dict
suboptions: suboptions:
storage_class: storage_class:
description: description:
- Target storage class. Required iff the type of the action is SetStorageClass. - Target storage class. Required iff the type of the action is SetStorageClass.
required: false required: false
type: str
type: type:
description: description:
- Type of the action. Currently, only Delete and SetStorageClass are - Type of the action. Currently, only Delete and SetStorageClass are
supported. supported.
- 'Some valid choices include: "Delete", "SetStorageClass"' - 'Some valid choices include: "Delete", "SetStorageClass"'
required: false required: false
type: str
condition: condition:
description: description:
- The condition(s) under which the action will be taken. - The condition(s) under which the action will be taken.
required: false required: false
type: dict
suboptions: suboptions:
age_days: age_days:
description: description:
- Age of an object (in days). This condition is satisfied when an - Age of an object (in days). This condition is satisfied when an
object reaches the specified age. object reaches the specified age.
required: false required: false
type: int
created_before: created_before:
description: description:
- A date in RFC 3339 format with only the date part (for instance, - A date in RFC 3339 format with only the date part (for instance,
"2013-01-15"). This condition is satisfied when an object is created "2013-01-15"). This condition is satisfied when an object is created
before midnight of the specified date in UTC. before midnight of the specified date in UTC.
required: false required: false
type: str
is_live: is_live:
description: description:
- Relevant only for versioned objects. If the value is true, this - Relevant only for versioned objects. If the value is true, this
@ -213,49 +239,59 @@ options:
will be matched. Values include MULTI_REGIONAL, REGIONAL, NEARLINE, will be matched. Values include MULTI_REGIONAL, REGIONAL, NEARLINE,
COLDLINE, STANDARD, and DURABLE_REDUCED_AVAILABILITY. COLDLINE, STANDARD, and DURABLE_REDUCED_AVAILABILITY.
required: false required: false
type: list
num_newer_versions: num_newer_versions:
description: description:
- Relevant only for versioned objects. If the value is N, this condition - Relevant only for versioned objects. If the value is N, this condition
is satisfied when there are at least N versions (including the live is satisfied when there are at least N versions (including the live
version) newer than this version of the object. version) newer than this version of the object.
required: false required: false
type: int
location: location:
description: description:
- The location of the bucket. Object data for objects in the bucket resides in - The location of the bucket. Object data for objects in the bucket resides in
physical storage within this region. Defaults to US. See the developer's guide physical storage within this region. Defaults to US. See the developer's guide
for the authoritative list. for the authoritative list.
required: false required: false
type: str
logging: logging:
description: description:
- The bucket's logging configuration, which defines the destination bucket and - The bucket's logging configuration, which defines the destination bucket and
optional name prefix for the current bucket's logs. optional name prefix for the current bucket's logs.
required: false required: false
type: dict
suboptions: suboptions:
log_bucket: log_bucket:
description: description:
- The destination bucket where the current bucket's logs should be placed. - The destination bucket where the current bucket's logs should be placed.
required: false required: false
type: str
log_object_prefix: log_object_prefix:
description: description:
- A prefix for log object names. - A prefix for log object names.
required: false required: false
type: str
metageneration: metageneration:
description: description:
- The metadata generation of this bucket. - The metadata generation of this bucket.
required: false required: false
type: int
name: name:
description: description:
- The name of the bucket. - The name of the bucket.
required: false required: false
type: str
owner: owner:
description: description:
- The owner of the bucket. This is always the project team's owner group. - The owner of the bucket. This is always the project team's owner group.
required: false required: false
type: dict
suboptions: suboptions:
entity: entity:
description: description:
- The entity, in the form project-owner-projectId. - The entity, in the form project-owner-projectId.
required: false required: false
type: str
storage_class: storage_class:
description: description:
- The bucket's default storage class, used whenever no storageClass is specified - The bucket's default storage class, used whenever no storageClass is specified
@ -267,10 +303,12 @@ options:
- 'Some valid choices include: "MULTI_REGIONAL", "REGIONAL", "STANDARD", "NEARLINE", - 'Some valid choices include: "MULTI_REGIONAL", "REGIONAL", "STANDARD", "NEARLINE",
"COLDLINE", "DURABLE_REDUCED_AVAILABILITY"' "COLDLINE", "DURABLE_REDUCED_AVAILABILITY"'
required: false required: false
type: str
versioning: versioning:
description: description:
- The bucket's versioning configuration. - The bucket's versioning configuration.
required: false required: false
type: dict
suboptions: suboptions:
enabled: enabled:
description: description:
@ -283,6 +321,7 @@ options:
accessing bucket contents as a web site. See the Static Website Examples for accessing bucket contents as a web site. See the Static Website Examples for
more information. more information.
required: false required: false
type: dict
suboptions: suboptions:
main_page_suffix: main_page_suffix:
description: description:
@ -291,16 +330,19 @@ options:
object. This allows the creation of index.html objects to represent directory object. This allows the creation of index.html objects to represent directory
pages. pages.
required: false required: false
type: str
not_found_page: not_found_page:
description: description:
- If the requested object path is missing, and any mainPageSuffix object is - If the requested object path is missing, and any mainPageSuffix object is
missing, if applicable, the service will return the named object from this missing, if applicable, the service will return the named object from this
bucket as the content for a 404 Not Found result. bucket as the content for a 404 Not Found result.
required: false required: false
type: str
project: project:
description: description:
- A valid API project identifier. - A valid API project identifier.
required: false required: false
type: str
predefined_default_object_acl: predefined_default_object_acl:
description: description:
- Apply a predefined set of default object access controls to this bucket. - Apply a predefined set of default object access controls to this bucket.
@ -317,6 +359,7 @@ options:
- 'Some valid choices include: "authenticatedRead", "bucketOwnerFullControl", - 'Some valid choices include: "authenticatedRead", "bucketOwnerFullControl",
"bucketOwnerRead", "private", "projectPrivate", "publicRead"' "bucketOwnerRead", "private", "projectPrivate", "publicRead"'
required: false required: false
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -65,6 +65,7 @@ options:
to a gcp_storage_bucket task and then set this bucket field to "{{ name-of-resource to a gcp_storage_bucket task and then set this bucket field to "{{ name-of-resource
}}"' }}"'
required: true required: true
type: dict
entity: entity:
description: description:
- 'The entity holding the permission, in one of the following forms: user-userId - 'The entity holding the permission, in one of the following forms: user-userId
@ -74,29 +75,35 @@ options:
- To refer to all members of the Google Apps for Business domain example.com, - To refer to all members of the Google Apps for Business domain example.com,
the entity would be domain-example.com. the entity would be domain-example.com.
required: true required: true
type: str
entity_id: entity_id:
description: description:
- The ID for the entity. - The ID for the entity.
required: false required: false
type: str
project_team: project_team:
description: description:
- The project team associated with the entity. - The project team associated with the entity.
required: false required: false
type: dict
suboptions: suboptions:
project_number: project_number:
description: description:
- The project team associated with the entity. - The project team associated with the entity.
required: false required: false
type: str
team: team:
description: description:
- The team. - The team.
- 'Some valid choices include: "editors", "owners", "viewers"' - 'Some valid choices include: "editors", "owners", "viewers"'
required: false required: false
type: str
role: role:
description: description:
- The access permission for the entity. - The access permission for the entity.
- 'Some valid choices include: "OWNER", "READER", "WRITER"' - 'Some valid choices include: "OWNER", "READER", "WRITER"'
required: false required: false
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -52,6 +52,7 @@ options:
- Upload or download from the bucket. - Upload or download from the bucket.
- 'Some valid choices include: "download", "upload"' - 'Some valid choices include: "download", "upload"'
required: false required: false
type: str
overwrite: overwrite:
description: description:
- "'Overwrite the file on the bucket/local machine. If overwrite is false and - "'Overwrite the file on the bucket/local machine. If overwrite is false and
@ -62,14 +63,17 @@ options:
description: description:
- Source location of file (may be local machine or cloud depending on action). - Source location of file (may be local machine or cloud depending on action).
required: false required: false
type: path
dest: dest:
description: description:
- Destination location of file (may be local machine or cloud depending on action). - Destination location of file (may be local machine or cloud depending on action).
required: false required: false
type: path
bucket: bucket:
description: description:
- The name of the bucket. - The name of the bucket.
required: false required: false
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''

View file

@ -51,24 +51,29 @@ options:
description: description:
- The immutable name of the TPU. - The immutable name of the TPU.
required: true required: true
type: str
description: description:
description: description:
- The user-supplied description of the TPU. Maximum of 512 characters. - The user-supplied description of the TPU. Maximum of 512 characters.
required: false required: false
type: str
accelerator_type: accelerator_type:
description: description:
- The type of hardware accelerators associated with this node. - The type of hardware accelerators associated with this node.
required: true required: true
type: str
tensorflow_version: tensorflow_version:
description: description:
- The version of Tensorflow running in the Node. - The version of Tensorflow running in the Node.
required: true required: true
type: str
network: network:
description: description:
- The name of a network to peer the TPU node to. It must be a preexisting Compute - The name of a network to peer the TPU node to. It must be a preexisting Compute
Engine network inside of the project on which this API has been activated. If Engine network inside of the project on which this API has been activated. If
none is provided, "default" will be used. none is provided, "default" will be used.
required: false required: false
type: str
cidr_block: cidr_block:
description: description:
- The CIDR block that the TPU node will use when selecting an IP address. This - The CIDR block that the TPU node will use when selecting an IP address. This
@ -80,10 +85,12 @@ options:
network, or the provided network is peered with another network that is using network, or the provided network is peered with another network that is using
that CIDR block. that CIDR block.
required: true required: true
type: str
scheduling_config: scheduling_config:
description: description:
- Sets the scheduling options for this TPU instance. - Sets the scheduling options for this TPU instance.
required: false required: false
type: dict
suboptions: suboptions:
preemptible: preemptible:
description: description:
@ -95,10 +102,12 @@ options:
description: description:
- Resource labels to represent user provided metadata. - Resource labels to represent user provided metadata.
required: false required: false
type: dict
zone: zone:
description: description:
- The GCP location for the TPU. - The GCP location for the TPU.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
notes: notes:
- 'API Reference: U(https://cloud.google.com/tpu/docs/reference/rest/)' - 'API Reference: U(https://cloud.google.com/tpu/docs/reference/rest/)'

View file

@ -44,6 +44,7 @@ options:
description: description:
- The GCP location for the TPU. - The GCP location for the TPU.
required: true required: true
type: str
extends_documentation_fragment: gcp extends_documentation_fragment: gcp
''' '''