Managing Images

Reloading an Image

Reload an Image

POST  http://<IP_Address>/api/mo/sys/action.json

{
    "actionLSubj": {
        "attributes": {
            "dn": "sys/action/lsubj-[sys]"
        }   
        "children" : [{
            "eqptChReloadLTask": {
                "attributes": {
                    "adminSt": "start",
                    "dn": "sys/action/lsubj-[sys]/eqptChReloadLTask",
                    "freq": "one-shot"
                }   
            }   
        }]  
    }   
}

<reload xmlns="http://cisco.com/ns/yang/cisco-nx-os-device"/>

Note: The property information for this example was added in Release 9.3(3).

Verifying a DME Configuration
The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.

MO	DN
actionLSubj	sys/action/lsubj-{[oDn]}
eqptChReloadLTask	sys/action/lsubj-{[oDn]}/eqptChReloadLTask

actionLSubj Properties

The following table contains information about the actionLSubj properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Property Name	Data Type	Description	Values
dn	reference:BinRef	A tag or metadata is a non-hierarchical keyword or term assigned to the fabric module.

eqptChReloadLTask Properties

The following table contains information about the eqptChReloadLTask properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Property Name	Data Type	Description	Values
adminSt	action:AdminSt scalar:Enum8	The administrative state of the object or policy.	SELECTION: 0 - unknown 1 - start 2 - stop 3 - suspend DEFAULT: unknown(0)
dn	reference:BinRef	A tag or metadata is a non-hierarchical keyword or term assigned to the fabric module.
freq	action:Freq scalar:Time	Frequency at which tasks are executed	SELECTION: 0ull - one-shot DEFAULT: 0

Related Documentation

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:

http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Deleting a File

Deleting a File

POST http://<IP_Address>/api/mo.json

{
    "actionLSubj": {
        "attributes": {
            "dn": "sys/action/lsubj-[sys]"
        }
        "children" : [{
            "topSystemDeleteFileLTask": {
                "attributes": {
                    "adminSt": "start",
                    
                    "uri": "bootflash://sup-local/t7",
                    
                    "dn": "sys/action/lsubj-[sys]/topSystemDeleteFileLTask",
                    "freq": "one-shot"
                }
            }
        }]
    }
}

<delete xmlns="http://cisco.com/ns/yang/cisco-nx-os-device">
     <target>sample_copy_file.txt</target> 
</delete>

Note: The property information for this example was added in Release 9.3(3).

MO	DN
actionLSubj	sys/action/lsubj-{[oDn]}
topSystemDeleteFileLTask	sys/action/lsubj-{[oDn]}/topSystemDeleteFileLTask

actionLSubj Properties

Property Name	Data Type	Description	Values
dn	reference:BinRef	A tag or metadata is a non-hierarchical keyword or term assigned to the fabric module.

topSystemDeleteFileLTask Properties

The following table contains information about the topSystemDeleteFileLTask properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Property Name	Data Type	Description	Values
adminSt	action:AdminSt scalar:Enum8	The administrative state of the object or policy.	SELECTION: 0 - unknown 1 - start 2 - stop 3 - suspend DEFAULT: unknown(0)
uri	string:Basic	The generated path for the data export destination.	RANGE: Min: "0" Max: "512"
dn	reference:BinRef	A tag or metadata is a non-hierarchical keyword or term assigned to the fabric module.
freq	action:Freq scalar:Time	Frequency at which tasks are executed	SELECTION: 0ull - one-shot DEFAULT: 0

Related Documentation

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:

http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Confirming a File was Deleted

Confirming a File was Deleted

GET http://<IP_Address>/api/mo/sys/action.json?rsp-subtree=full

{
    "totalCount": "1",
    "imdata": [
        {
            "actionLCont": {
                "attributes": {
                    "childAction": "",
                    "dn": "sys/action",
                    "modTs": "2011-02-03T15:06:15.754+00:00",
                    "monPolDn": "uni/fabric/monfab-default",
                    "persistentOnReload": "true",
                    "status": "",
                    "uid": "0"
                },
                "children": [
                    {
                        "actionLSubj": {
                            "attributes": {
                                "childAction": "",
                                "modTs": "2011-02-03T15:21:51.904+00:00",
                                "monPolDn": "uni/fabric/monfab-default",
                                "oCl": "unspecified",
                                "oDn": "sys",
                                "persistentOnReload": "true",
                                "rn": "lsubj-[sys]",
                                "status": "",
                                "uid": "0"
                            },
                            "children": [
                                {
                                    "topSystemDeleteFileLTask": {
                                        "attributes": {
                                            "adminSt": "unknown",
                                            "childAction": "",
                                            "descr": "",
                                            "freq": "one-shot",
                                            "modTs": "2011-02-08T09:41:52.305+00:00",
                                            "peerClassId": "topSystemDeleteFileRslt",
                                            "persistentOnReload": "true",
                                            "rSz": "100",
                                            "rTm": "00:00:00:00.000",
                                            "rn": "topSystemDeleteFileLTask",
                                            "startTs": "2011-02-08T09:41:52.305+00:00",
                                            "status": "",
                                            "type": "clear",
                                            "uid": "0",
                                            "uri": "bootflash://sup-local/t7"
                                        }
                                    }
                                },
                                {
                                    "topSystemDeleteFileRslt": {
                                        "attributes": {
                                            "ack": "no",
                                            "childAction": "",
                                            "descr": "SUCCESS",
                                            "endTs": "2011-02-08T09:41:52.305+00:00",
                                            "modTs": "never",
                                            "operSt": "completed",
                                            "peerClassId": "unspecified",
                                            "persistentOnReload": "false",
                                            "qual": "",
                                            "rSz": "0",
                                            "rTm": "00:00:00:00.000",
                                            "rn": "topSystemDeleteFileRslt",
                                            "startTs": "2011-02-08T09:41:52.305+00:00",
                                            "status": "",
                                            "type": "0"
                                        }
                                    }
                                }
                            ]
                        }
                    }
                ]
            }
        }
    ]
}

Note: The property information for this example was added in Release 9.3(3).

MO	DN
actionLCont	sys/action
actionLSubj	sys/action/lsubj-{[oDn]}
topSystemDeleteFileLTask	sys/action/lsubj-{[oDn]}/topSystemDeleteFileLTask
topSystemDeleteFileRslt	sys/action/lsubj-{[oDn]}/topSystemDeleteFileRslt

actionLCont Properties

The following table contains information about the actionLCont properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Property Name	Data Type	Description	Values
childAction	mo:ModificationChildAction scalar:Bitmask32	Delete or ignore. For internal use only.	SELECTION: 16384u - deleteAll 4096u - ignore 8192u - deleteNonPresent DEFAULT: 0
dn	reference:BinRef	A tag or metadata is a non-hierarchical keyword or term assigned to the fabric module.
modTs	mo:TStamp (scalar:Date)	The time when this object was last modified.	SELECTION: 0 - never DEFAULT: never
monPolDn	reference:BinRef
persistentOnReload	mo:Persistent scalar:Enum8	NO COMMENTS	SELECTION: 0 - false 1 - true DEFAULT: true(1)
status	mo:ModificationStatus (scalar:Bitmask32)	The upgrade status. This property is for internal use only.	SELECTION: 2 - created 4 - modified 8 - deleted 16 - replaced
uid	scalar:Uint16	A unique identifier for this object.

actionLSubj Properties

Property Name	Data Type	Description	Values
childAction	mo:ModificationChildAction scalar:Bitmask32	Delete or ignore. For internal use only.	SELECTION: 16384u - deleteAll 4096u - ignore 8192u - deleteNonPresent DEFAULT: 0
modTs	mo:TStamp (scalar:Date)	The time when this object was last modified.	SELECTION: 0 - never DEFAULT: never
monPolDn	reference:BinRef
oCl	mo:MoClassId	Target Object's subject Class id
oDn	reference:BinRef	Target Object's Subject DN
persistentOnReload	mo:Persistent scalar:Enum8	NO COMMENTS	SELECTION: 0 - false 1 - true DEFAULT: true(1)
rn	reference:BinRN	Identifies an object from its siblings within the context of its parent object. The distinguished name contains a sequence of relative names.
status	mo:ModificationStatus (scalar:Bitmask32)	The upgrade status. This property is for internal use only.	SELECTION: 2 - created 4 - modified 8 - deleted 16 - replaced
uid	scalar:Uint16	A unique identifier for this object.

topSystemDeleteFileLTask Properties

Property Name	Data Type	Description	Values
adminSt	action:AdminSt scalar:Enum8	The administrative state of the object or policy.	SELECTION: 0 - unknown 1 - start 2 - stop 3 - suspend DEFAULT: unknown(0)
childAction	mo:ModificationChildAction scalar:Bitmask32	Delete or ignore. For internal use only.	SELECTION: 16384u - deleteAll 4096u - ignore 8192u - deleteNonPresent DEFAULT: 0
descr	action:Descr string:Basic		RANGE: Min: "0" Max: "128"
freq	action:Freq scalar:Time	Frequency at which tasks are executed	SELECTION: 0ull - one-shot DEFAULT: 0
modTs	mo:TStamp scalar:Date	The time when this object was last modified.	SELECTION: 0ull - never DEFAULT: never(0ull)
peerClassId	mo:MoClassId	The BGP neighbor.	DEFAULT: topSystemDeleteFileRslt
persistentOnReload	mo:Persistent scalar:Enum8	NO COMMENTS	SELECTION: 0 - false 1 - true DEFAULT: true(1)
rSz	action:RetentionSize scalar:Uint16	The retention size of the task results.	RANGE: Min: 1 Max: 1024 DEFAULT: 100
rTm	action:RetentionTime scalar:Time	The retention time of the task results.
rn	reference:BinRN	Identifies an object from its siblings within the context of its parent object. The distinguished name contains a sequence of relative names.
startTs	mo:TStamp scalar:Date	The date and time when the task began.	SELECTION: 0ull - never DEFAULT: never(0ull)
status	mo:ModificationStatus scalar:Bitmask32	The upgrade status. This property is for internal use only.	SELECTION: 16u - replaced 2u - created 4u - modified 8u - deleted DEFAULT: 0
type	action:Type scalar:Enum8	The specific type of the object or component.	SELECTION: 1 - clear 2 - reset 3 - reload 4 - locate 5 - install 6 - test 7 - collect 8 - interface-in-service DEFAULT: clear(1)
uid	scalar:Uint16	A unique identifier for this object.
uri	string:Basic	The generated path for the data export destination.	RANGE: Min: "0" Max: "512"

topSystemDeleteFileRslt Properties

The following table contains information about the topSystemDeleteFileRslt properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Property Name	Data Type	Description	Values
ack	scalar:Bool	The acknowledgement status of the fault. If a fault is acknowledged and cleared, it is immediately deleted. If a fault is not acknowledged and cleared, it is deleted after the retention interval.	SELECTION: false - no true - yes DEFAULT: no(false)
childAction	mo:ModificationChildAction scalar:Bitmask32	Delete or ignore. For internal use only.	SELECTION: 16384u - deleteAll 4096u - ignore 8192u - deleteNonPresent DEFAULT: 0
descr	action:Descr string:Basic		RANGE: Min: "0" Max: "128"
endTs	mo:TStamp scalar:Date	The date and time when the task ended.	SELECTION: 0ull - never DEFAULT: never(0ull)
modTs	mo:TStamp scalar:Date	The time when this object was last modified.	SELECTION: 0ull - never DEFAULT: never(0ull)
operSt	action:OperSt scalar:Enum8	The runtime state of the object or policy.	SELECTION: 0 - scheduled 1 - processing 2 - completed 3 - cancelled 4 - failed 5 - indeterminate 6 - suspended 7 - crashsuspect DEFAULT: scheduled(0)
peerClassId	mo:MoClassId	The BGP neighbor.	DEFAULT: topSystemDeleteFileLTask
persistentOnReload	mo:Persistent scalar:Enum8	NO COMMENTS	SELECTION: 0 - false 1 - true DEFAULT: true(1)
qual	action:Qual string:Basic	The qualifier for the component status.	RANGE: Min: "0" Max: "512"
rSz	action:RetentionSize scalar:Uint16	The retention size of the task results.	RANGE: Min: 1 Max: 1024 DEFAULT: 100
rTm	action:RetentionTime scalar:Time	The retention time of the task results.
rn	reference:BinRN	Identifies an object from its siblings within the context of its parent object. The distinguished name contains a sequence of relative names.
startTs	mo:TStamp scalar:Date	The date and time when the task began.	SELECTION: 0ull - never DEFAULT: never(0ull)
status	mo:ModificationStatus scalar:Bitmask32	The upgrade status. This property is for internal use only.	SELECTION: 16u - replaced 2u - created 4u - modified 8u - deleted DEFAULT: 0
type	action:Type scalar:Enum8	The specific type of the object or component.	SELECTION: 1 - clear 2 - reset 3 - reload 4 - locate 5 - install 6 - test 7 - collect 8 - interface-in-service DEFAULT: clear(1)

Related Documentation

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:

http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Enabling Image Signature Verification

Enabling Image Signature Verification

POST http://<mgmt0_IP>/api/mo/sys/boot.json

{
  "bootBoot": {
    "children": [
      {
        "bootImage": {
          "attributes": {
            "imageverification": "enable"
}}}]}}

{
    imdata:[]
}

<System>
  <boot-items>
    <image-items>
      <imageverification>enable</imageverification>
    </image-items>
  </boot-items>
</System>

Note: This example was added in Release 9.2(2).

CLI Commands

The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.

feature signature-verification

Note: The property information for this example was added in Release 9.3(3).

MO	DN
bootBoot	sys/boot
bootImage	sys/boot/image

bootImage Properties

The following table contains information about the bootImage properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Property Name	Data Type	Description	Values
imageverification	boot:ImageVerify (scalar:Enum8)	Enable/Disable Image Verification	SELECTION: 0 - disable 1 - enable DEFAULT: enable

Related Documentation

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:

http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Disabling Image Signature Verification

Disabling Image Signature Verification

POST http://<mgmt0_IP>/api/mo/sys/boot.json

{
  "bootBoot": {
    "children": [
      {
        "bootImage": {
          "attributes": {
            "imageverification": "disable"
}}}]}}

{
    imdata:[]
}

<System>
  <boot-items>
    <image-items>
      <imageverification>disable</imageverification>
    </image-items>
  </boot-items>
</System>

Note: This example was added in Release 9.2(2).

CLI Commands

no feature signature-verification

Note: The property information for this example was added in Release 9.3(3).

MO	DN
bootBoot	sys/boot
bootImage	sys/boot/image

bootImage Properties

Property Name	Data Type	Description	Values
imageverification	boot:ImageVerify (scalar:Enum8)	Enable/Disable Image Verification	SELECTION: 0 - disable 1 - enable DEFAULT: enable

Related Documentation

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:

http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:

https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html