Skip to content

image_policy_info.py

Description

Query one or more image policies by name.

Example configuration file

config/config_image_policy_info.yaml
---
config:
    - name: nxos64-cs.10.2.5.M.bin_N9K_All
    - name: FOO_POLICY

Example Usage

The example below uses environment variables for credentials, so requires only the --config argument. See Running the Example Scripts for details around specifying credentials from the command line, from environment variables, from Ansible Vault, or a combination of these credentials sources.

export ND_DOMAIN=local
export ND_IP4=10.1.1.2
export ND_PASSWORD=MySecret
export ND_USERNAME=admin
./device_info.py --config config/config_device_info.yaml
# output not shown

Example output

Image policy exists on the controller

Image policy exists
(.venv) AROBEL-M-G793% ./image_policy_info.py --config prod/config_image_policy_info.yaml
{
    "changed": false,
    "diff": [
        {
            "agnostic": false,
            "epldImgName": "",
            "fabricPolicyName": "nxos64-cs.10.2.5.M.bin",
            "imageName": "nxos64-cs.10.2.5.M.bin",
            "imagePresent": "Present",
            "nxosVersion": "10.2.5_nxos64-cs_64bit",
            "packageName": "",
            "platform": "N9K/N3K",
            "platformPolicies": "",
            "policyDescr": null,
            "policyName": "nxos64-cs.10.2.5.M.bin_N9K_All",
            "policyType": "FABRIC",
            "ref_count": 0,
            "role": "All",
            "rpmimages": "false",
            "sequence_number": 1,
            "unInstall": false
        }
    ],
    "failed": false,
    "metadata": [
        {
            "action": "query",
            "check_mode": false,
            "sequence_number": 1,
            "state": "query"
        }
    ],
    "response": [
        {
            "DATA": {
                "lastOperDataObject": [
                    {
                        "agnostic": false,
                        "epldImgName": "",
                        "fabricPolicyName": "nxos64-cs.10.2.5.M.bin",
                        "imageName": "nxos64-cs.10.2.5.M.bin",
                        "imagePresent": "Present",
                        "nxosVersion": "10.2.5_nxos64-cs_64bit",
                        "packageName": "",
                        "platform": "N9K/N3K",
                        "platformPolicies": "",
                        "policyDescr": null,
                        "policyName": "nxos64-cs.10.2.5.M.bin_N9K_All",
                        "policyType": "FABRIC",
                        "ref_count": 0,
                        "role": "All",
                        "rpmimages": "false",
                        "unInstall": false
                    }
                ],
                "message": "",
                "status": "SUCCESS"
            },
            "MESSAGE": "OK",
            "METHOD": "GET",
            "REQUEST_PATH": "https://10.1.1.2/appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/policies",
            "RETURN_CODE": 200,
            "sequence_number": 1
        }
    ],
    "result": [
        {
            "found": true,
            "sequence_number": 1,
            "success": true
        }
    ]
}
(.venv) AROBEL-M-G793%

Image policy does not exist on the controller

Image policy does not exist
(.venv) AROBEL-M-G793% ./image_policy_info.py --config prod/config_image_policy_info.yaml --nd-ip4 10.1.1.3
{
    "changed": false,
    "diff": [
        {
            "sequence_number": 1
        }
    ],
    "failed": false,
    "metadata": [
        {
            "action": "query",
            "check_mode": false,
            "sequence_number": 1,
            "state": "query"
        }
    ],
    "response": [
        {
            "DATA": {
                "lastOperDataObject": [],
                "message": "",
                "status": "SUCCESS"
            },
            "MESSAGE": "OK",
            "METHOD": "GET",
            "REQUEST_PATH": "https://10.1.1.3/appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/policies",
            "RETURN_CODE": 200,
            "sequence_number": 1
        }
    ],
    "result": [
        {
            "sequence_number": 1,
            "success": true
        }
    ]
}
(.venv) AROBEL-M-G793%