os_subnets_info – Retrieve information about one or more OpenStack subnets¶
Synopsis¶
- Retrieve information about one or more subnets from OpenStack.
- This module was called os_subnets_factsbefore Ansible 2.9, returningansible_facts. Note that the os_subnets_info module no longer returnsansible_facts!
Aliases: os_subnets_facts
Requirements¶
The below requirements are needed on the host that executes this module.
- openstacksdk
- openstacksdk >= 0.12.0
- python >= 2.7
Parameters¶
Notes¶
Note
- The standard OpenStack environment variables, such as OS_USERNAMEmay be used instead of providing explicit values.
- Auth information is driven by openstacksdk, which means that values can come from a yaml config file in /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml or ~/.config/openstack/clouds.yaml, then from standard environment variables, then finally by explicit parameters in plays. More information can be found at https://docs.openstack.org/openstacksdk/
Examples¶
- name: Gather information about previously created subnets
  os_subnets_info:
    auth:
      auth_url: https://identity.example.com
      username: user
      password: password
      project_name: someproject
  register: result
- name: Show openstack subnets
  debug:
    msg: "{{ result.openstack_subnets }}"
- name: Gather information about a previously created subnet by name
  os_subnets_info:
    auth:
      auth_url: https://identity.example.com
      username: user
      password: password
      project_name: someproject
    name: subnet1
  register: result
- name: Show openstack subnets
  debug:
    msg: "{{ result.openstack_subnets }}"
- name: Gather information about a previously created subnet with filter
  # Note: name and filters parameters are not mutually exclusive
  os_subnets_info:
    auth:
      auth_url: https://identity.example.com
      username: user
      password: password
      project_name: someproject
    filters:
      tenant_id: 55e2ce24b2a245b09f181bf025724cbe
  register: result
- name: Show openstack subnets
  debug:
    msg: "{{ result.openstack_subnets }}"
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Status¶
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors¶
- Davide Agnello (@dagnello)
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
