broadcom.ops.show_resource (4.1.8) — module

Display data associated with the specified SSM resource

| "added in version" 1.0.0 of broadcom.ops"

Authors: David Jones <david.jones@broadcom.com> (@broadcom)

| supported by Broadcom

This plugin has a corresponding action plugin.

Install collection

Install with ansible-galaxy collection install broadcom.ops:==4.1.8


Add to requirements.yml

  collections:
    - name: broadcom.ops
      version: 4.1.8

Description

Display data associated with the specified SSM resource. Currently, only resource state is displayed.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Show current and desired state of RESOURCE1 on table MYTABLE on subsystem OPSS.
  broadcom.ops.show_resource:
    resourcename: RESOURCE1
    tablename: MYTABLE
    subsystem: OPSS

Inputs

    
host:
    description:
    - The hostname of the server where OPS Web Services is running.
    required: false
    type: str

port:
    description:
    - The port number for OPS Web Services.
    required: false
    type: int

user:
    description:
    - Your z/OS user name used to authenticate to OPS Web Services.
    required: false
    type: str

password:
    description:
    - Your z/OS password used to authenticate to OPS Web Services.
    required: false
    type: str

protocol:
    choices:
    - http
    - https
    default: https
    description:
    - The protocol used for connecting to OPS Web Services.
    required: true
    type: str

cert_file:
    description:
    - The file path to a certificate file to use for authentication.
    - ''
    - 'Note: The CLI does not support certificate files that require a password. For more
      information, search Troubleshooting PEM Certificates in Zowe Docs.'
    required: false
    type: path

subsystem:
    description:
    - Specifies the subsystem id of the OPS/MVS instance to which commands will be directed.
    required: false
    type: str

tablename:
    description:
    - 'The name of the table that contains the resource. If not specified, the command
      will search the SSM tables to find the resource. If the resource exists in multiple
      tables, the desired state of the resource will be set to the appropriate DOWN state
      in all the tables where the resource exists. '
    required: false
    type: str

resourcename:
    description:
    - The name of the resource.
    required: true
    type: str

cert_key_file:
    description:
    - The file path to a certificate key file to use for authentication.
    required: false
    type: path

reject_unauthorized:
    default: true
    description:
    - If set to true, the server certificate is verified against the list of supplied
      CAs. If set to false, certificate verification is not performed.
    required: false
    type: bool

Outputs

data:
  description: Data from the module execution (a data structure). The items of this
    dict are set as individual return values on the top level as well.
  elements: dict
  returned: when returned data is a dictionary
  type: list
error:
  contains:
    additional_details:
      description: Detailed message about the failure.
      type: str
    msg:
      description: Short description of the result or failure.
      type: str
    request:
      description: HTTP method used to invoke API service request.
      returned: API request failed
      type: str
    resource:
      description: URI of the resource of the API service request.
      returned: API request failed
      type: str
  description: More details about why the action has failed. If the failure is when
    calling an API service, the response contains the connection parameters.
  returned: error
  type: complex
failed:
  description: A boolean that indicates if the task was failed or not.
  returned: always
  type: bool
list:
  description: Data from the module execution (a list of data structures).
  elements: dict
  returned: when returned data is a list
  type: list
msg:
  description: Short description of the result or failure.
  returned: sometimes
  type: str
rc:
  description: Exit code of the module, successful exit code is 0, failure is typically
    1 or higher.
  returned: always
  type: int
stderr:
  description: Details of the error.
  returned: error
  type: str
stdout:
  description: Summary of the result.
  returned: success
  type: str