New in version 2.6.
The below requirements are needed on the host that executes this module.
Parameter | Choices/Defaults | Comments |
---|---|---|
auth_kind
required |
|
The type of credential used.
|
managed_zone
required |
A reference to ManagedZone resource.
|
|
name
required |
For example, www.example.com.
|
|
project |
The Google Cloud Platform project to use.
|
|
scopes
required |
Array of scopes to be used.
|
|
service_account_email |
An optional service account email address if machineaccount is selected and the user does not wish to use the default email.
|
|
service_account_file |
The path of a Service Account JSON file if serviceaccount is selected as type.
|
|
state
required |
|
Whether the given object should exist in GCP
|
target |
As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1).
|
|
ttl |
Number of seconds that this ResourceRecordSet can be cached by resolvers.
|
|
type
required |
|
One of valid DNS resource types.
|
Note
GCP_SERVICE_ACCOUNT_FILE
env variable.GCP_SERVICE_ACCOUNT_EMAIL
env variable.GCP_AUTH_KIND
env variable.GCP_SCOPES
env variable.- name: create a managed zone
gcp_dns_managed_zone:
name: 'managedzone-rrs'
dns_name: 'testzone-4.com.'
description: 'test zone'
project: "{{ gcp_project }}"
auth_kind: "{{ gcp_cred_kind }}"
service_account_file: "{{ gcp_cred_file }}"
scopes:
- https://www.googleapis.com/auth/ndev.clouddns.readwrite
state: present
register: managed_zone
- name: create a resource record set
gcp_dns_resource_record_set:
name: 'www.testzone-4.com.'
managed_zone: "{{ managed_zone }}"
type: 'A'
ttl: 600
target:
- 10.1.2.3
- 40.5.6.7
project: testProject
auth_kind: service_account
service_account_file: /tmp/auth.pem
scopes:
- https://www.googleapis.com/auth/ndev.clouddns.readwrite
state: present
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
managed_zone
dict
|
success |
A reference to ManagedZone resource.
|
name
str
|
success |
For example, www.example.com.
|
target
list
|
success |
As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1).
|
ttl
int
|
success |
Number of seconds that this ResourceRecordSet can be cached by resolvers.
|
type
str
|
success |
One of valid DNS resource types.
|
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Hint
If you notice any issues in this documentation you can edit this document to improve it.