purestorage.flashblade.purefb_pingtrace (1.17.0) — module

Employ the internal FlashBlade ping and trace mechanisms

| "added in version" 1.11.0 of purestorage.flashblade"

Authors: Pure Storage Ansible Team (@sdodsley) <pure-ansible-team@purestorage.com>

preview | supported by community

Install collection

Install with ansible-galaxy collection install purestorage.flashblade:==1.17.0


Add to requirements.yml

  collections:
    - name: purestorage.flashblade
      version: 1.17.0

Description

Ping or trace a destination


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- 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
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- 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

Inputs

    
port:
    description:
    - Used by trace to specify a destination port
    type: str

count:
    default: 1
    description:
    - Used by ping to specify the number of packets to send
    type: int

action:
    choices:
    - ping
    - trace
    default: ping
    description:
    - Which action is required, ping or trace
    type: str

fb_url:
    description:
    - FlashBlade management IP address or Hostname.
    type: str

method:
    choices:
    - icmp
    - tcp
    - udp
    default: udp
    description:
    - Used by trace to specify the method to use for operations
    type: str

source:
    description:
    - 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
    type: str

latency:
    default: false
    description:
    - Specify whether or not to print the full user-to-user latency
    type: bool

resolve:
    default: true
    description:
    - Specify whether or not to map IP addresses to host names
    type: bool

fragment:
    default: true
    description:
    - Used by trace to specify whether or not to fragment packets
    type: bool

api_token:
    description:
    - FlashBlade API token for admin privileged user.
    type: str

component:
    description:
    - 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
    type: str

destination:
    description:
    - IP addtress or hostname used to run ping or trace against.
    required: true
    type: str

packet_size:
    default: 56
    description:
    - Used by ping to specify the number of data bytes to send per packet
    type: int

discover_mtu:
    default: false
    description:
    - Used by trace to specify whether or not to discover the MTU along the path being
      traced
    type: bool