azure_rm_dnsrecordset_facts - Get DNS Record Set facts.
New in version 2.4.
Synopsis
- Get facts for a specific DNS Record Set in a Zone, or a specific type in all Zones or in one Zone etc.
Requirements (on host that executes module)
- python >= 2.7
- azure >= 2.0.0
Options
| parameter | required | default | choices | comments |
|---|---|---|---|---|
| ad_user |
no |
Active Directory username. Use when authenticating with an Active Directory user rather than service principal.
|
||
| client_id |
no |
Azure client ID. Use when authenticating with a Service Principal.
|
||
| cloud_environment |
no | AzureCloud |
For cloud environments other than the US public cloud, the environment name (as defined by Azure Python SDK, eg, AzureChinaCloud, AzureUSGovernment), or a metadata discovery endpoint URL (required for Azure Stack). Can also be set via credential file profile or the AZURE_CLOUD_ENVIRONMENT environment variable.
|
|
| password |
no |
Active Directory user password. Use when authenticating with an Active Directory user rather than service principal.
|
||
| profile |
no |
Security profile found in ~/.azure/credentials file.
|
||
| record_type |
no |
Limit record sets by record type.
|
||
| relative_name |
no |
Only show results for a Record Set.
|
||
| resource_group |
no |
Limit results by resource group. Required when filtering by name or type.
|
||
| secret |
no |
Azure client secret. Use when authenticating with a Service Principal.
|
||
| subscription_id |
no |
Your Azure subscription Id.
|
||
| tenant |
no |
Azure tenant ID. Use when authenticating with a Service Principal.
|
||
| top |
no | 100 |
Limit the maximum number of record sets to return
|
|
| zone_name |
no |
Limit results by zones. Required when filtering by name or type.
|
Examples
- name: Get facts for one Record Set
azure_rm_dnsrecordset_facts:
resource_group: Testing
zone_name: example.com
relative_name: server10
record_type: A
- name: Get facts for all Type A Record Sets in a Zone
azure_rm_dnsrecordset_facts:
resource_group: Testing
zone_name: example.com
record_type: A
- name: Get all record sets in one zone
azure_rm_dnsrecordset_facts:
resource_group: Testing
zone_name: example.com
Return Values
Common return values are documented here Return Values, the following are the fields unique to this module:
| name | description | returned | type | sample |
|---|---|---|---|---|
| azure_dnsrecordset |
List of record set dicts.
|
always | list |
Notes
Note
- For authentication with Azure you can pass parameters, set environment variables or use a profile stored in ~/.azure/credentials. Authentication is possible using a service principal or Active Directory user. To authenticate via service principal, pass subscription_id, client_id, secret and tenant or set environment variables AZURE_SUBSCRIPTION_ID, AZURE_CLIENT_ID, AZURE_SECRET and AZURE_TENANT.
- To authenticate via Active Directory user, pass ad_user and password, or set AZURE_AD_USER and AZURE_PASSWORD in the environment.
- Alternatively, credentials can be stored in ~/.azure/credentials. This is an ini file containing a [default] section and the following keys: subscription_id, client_id, secret and tenant or subscription_id, ad_user and password. It is also possible to add additional profiles. Specify the profile by passing profile or setting AZURE_PROFILE in the environment.
Status
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/azure_rm_dnsrecordset_facts_module.html