New in version 2.8.
The below requirements are needed on the host that executes this module.
Parameter | Choices/Defaults | Comments |
---|---|---|
auth_kind
string
/ required
|
|
The type of credential used.
|
managed_zone
-
/ required
|
Identifies the managed zone addressed by this request.
This field represents a link to a ManagedZone resource in GCP. It can be specified in two ways. First, you can place a dictionary with key 'name' and value of your resource's name Alternatively, you can add `register: name-of-resource` to a gcp_dns_managed_zone task and then set this managed_zone field to "{{ name-of-resource }}"
|
|
project
string
|
The Google Cloud Platform project to use.
|
|
scopes
list
|
Array of scopes to be used.
|
|
service_account_contents
string
|
A string representing the contents of a Service Account JSON file.
This should not be passed in as a dictionary, but a string that has the exact contents of a service account json file (valid JSON)
|
|
service_account_email
string
|
An optional service account email address if machineaccount is selected and the user does not wish to use the default email.
|
|
service_account_file
path
|
The path of a Service Account JSON file if serviceaccount is selected as type.
|
Note
GCP_SERVICE_ACCOUNT_FILE
env variable.GCP_SERVICE_ACCOUNT_EMAIL
env variable.GCP_SERVICE_ACCOUNT_CONTENTS
env variable.GCP_AUTH_KIND
env variable.GCP_SCOPES
env variable.- name: " a resource record set facts"
gcp_dns_resource_record_set_facts:
managed_zone: "{{ managed_zone }}"
project: test_project
auth_kind: serviceaccount
service_account_file: "/tmp/auth.pem"
state: facts
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description | |
---|---|---|---|
items
complex
|
always |
List of items
|
|
managed_zone
dictionary
|
success |
Identifies the managed zone addressed by this request.
|
|
name
string
|
success |
For example, www.example.com.
|
|
target
list
|
success |
As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) .
|
|
ttl
integer
|
success |
Number of seconds that this ResourceRecordSet can be cached by resolvers.
|
|
type
string
|
success |
One of valid DNS resource types.
|
Hint
If you notice any issues in this documentation you can edit this document to improve it.