purestorage.flashblade.purefb_pingtrace module – Employ the internal FlashBlade ping and trace mechanisms
Note
This module is part of the purestorage.flashblade collection (version 1.18.0).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install purestorage.flashblade
.
You need further requirements to be able to use this module,
see Requirements for details.
To use it in a playbook, specify: purestorage.flashblade.purefb_pingtrace
.
New in purestorage.flashblade 1.11.0
Synopsis
Ping or trace a destination
Requirements
The below requirements are needed on the host that executes this module.
python >= 2.7
purity_fb >= 1.9
netaddr
pytz
urllib3
Parameters
Parameter |
Comments |
---|---|
Which action is required, ping or trace Choices:
|
|
FlashBlade API token for admin privileged user. |
|
Used by ping and trace to specify where to run the operation. Valid values are controllers and blades from hardware list. If not specified defaults to all available controllers and selected blades |
|
Used by ping to specify the number of packets to send Default: |
|
IP addtress or hostname used to run ping or trace against. |
|
Disable insecure certificate warnings Choices:
|
|
Used by trace to specify whether or not to discover the MTU along the path being traced Choices:
|
|
FlashBlade management IP address or Hostname. |
|
Used by trace to specify whether or not to fragment packets Choices:
|
|
Specify whether or not to print the full user-to-user latency Choices:
|
|
Used by trace to specify the method to use for operations Choices:
|
|
Used by ping to specify the number of data bytes to send per packet Default: |
|
Used by trace to specify a destination port |
|
Specify whether or not to map IP addresses to host names Choices:
|
|
IP address or hostname used by ping and trace to specify where to start to run the specified operation If not specified will use all available sources |
Notes
Note
This module requires the
purity_fb
Python libraryYou must set
PUREFB_URL
andPUREFB_API
environment variables if fb_url and api_token arguments are not passed to the module directly
Examples
- name: ping Google DNS server
purestorage.flashblade.purefb_pingtrace:
destination: 8.8.8.8
fb_url: 10.10.10.2
api_token: T-68618f31-0c9e-4e57-aa44-5306a2cf10e3
- name: trace to Google DNS server from CH1.FM0
purestorage.flashblade.purefb_pingtrace:
action: trace
destination: 8.8.8.8
fragment_packet: true
source: CH1.FM0
discover_mtu: true
fb_url: 10.10.10.2
api_token: T-68618f31-0c9e-4e57-aa44-5306a2cf10e3