avantra.core.sapsystem_info module – load SAP system information

Note

This module is part of the avantra.core collection (version 23.0.3).

To install it, use: ansible-galaxy collection install avantra.core.

To use it in a playbook, specify: avantra.core.sapsystem_info.

New in avantra.core 23.0.0

Synopsis

  • This module allows to load information about a SAP system from Avantra. The SAP system information can be obtained using the Unified SAP SID together with a customer name.

Note

This module has a corresponding action plugin.

Parameters

Parameter

Comments

avantra_api_password

string

The password or API key for the selected Avantra user.

We highly recommend to use Ansible Vaults to protect you sensitive content.

avantra_api_url

string / required

A valid URL pointing to an Avantra UI.

For example https://avantra-ui/xn

avantra_api_user

string

Valid Avantra user principal.

customer_name

string / required

A customer name known by Avantra. Together with unified_sap_sid it identifies the SAP system.

fail_if_not_found

boolean

Whether the task should fail in case the SAP system can not be found.

Choices:

  • false ← (default)

  • true

token

string

The token used to authenticate during the task execution. A token can be fetched with the avantra.core.login module. If token is defined avantra_api_user and avantra_api_password are not necessary.

unified_sap_sid

string / required

The Unified SAP SID of the SAP system. Together with customer_name it identifies the SAP system.

See Also

See also

Avantra Documentation

The official Avantra documentation.

Examples

# Find a SAP system given its unified SAP SID and a customer name
- name: Get SAP system AVA_DBG
  avantra.core.sapsystem_info:
    unified_sap_sid: AVA_DBG
    customer_name: "My Customer"

# Fail if the SAP system can not be found
- name: Get SAP system AVA_DBG
  avantra.core.sapsystem_info:
    unified_sap_sid: AVA_DBG
    customer_name: "My Customer"
    fail_if_not_found: true

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

sap_system

dictionary

If the SAP system can be identified the system information is returned.

Returned: present

Authors

  • Michael Szediwy (@avantra-mis)