point

You can use the point query parameter in conjunction with the insert parameter to specify the insertion point for a data resource that is being created or moved within an ordered-by user list or leaf-list.

The value of the point parameter is a string that identifies the path to the insertion point object. The format is the same as a target resource URI string.

Note

The point parameter is supported only for the POST and PUT methods. It is also only supported if the target resource is a data resource, and that data represents a YANG list or leaf-list that is ordered-by user.

If the insert query parameter is not present or has a value other than before or after, then a 400 Bad Request status is returned.

Sample request from client to insert a new access control entry in the access control list after ace1

POST  /rest/restconf/data/ietf-access-control-list:acls/acl=acl/aces?insert=after&point=ace1
    HTTP/1.1
    Host: 10.50.130.172
    Content-Type: application/yang-data+json
    
    { 
        "ietf-access-control-list:aces": [    
          {   
            "actions": {           
                "forwarding": "drop"      
            },       
            "matches": {      
                "eth": {  
               "ethertype": 2        
                }     
            },       
            "name": "ace2"   
          }
         ]
    }

Sample response data from server

{
  "ietf-access-control-list:aces": {
    "ace": [
      {
        "actions": {
          "forwarding": "drop"
        }, 
        "matches": {
          "eth": {
            "ethertype": 65535
          }
        }, 
        "name": "aceOVERFLOW", 
        "statistics": {
          "matched-packets": 0
        }
      }, 
      {
        "actions": {
          "forwarding": "drop"
        }, 
        "matches": {
          "eth": {
            "ethertype": 0
          }
        }, 
        "name": "ace0", 
        "statistics": {
          "matched-packets": 0
        }
      }, 
      {
        "actions": {
          "forwarding": "drop"
        }, 
        "matches": {
          "eth": {
            "ethertype": 1
          }
        }, 
        "name": "ace1", 
        "statistics": {
          "matched-packets": 0
        }
      }, 
      {
        "actions": {
          "forwarding": "drop"
        }, 
        "matches": {
          "eth": {
            "ethertype": 288
          }
        }, 
        "name": "ace2", 
        "statistics": {
          "matched-packets": 0
        }
      }, 
      {
        "actions": {
          "forwarding": "drop"
        }, 
        "matches": {
          "eth": {
            "ethertype": 3
          }
        }, 
        "name": "ace3", 
        "statistics": {
          "matched-packets": 0
        }
      }, 
      {
        "actions": {
          "forwarding": "drop"
        }, 
        "matches": {
          "eth": {
            "ethertype": 4
          }
        }, 
        "name": "ace4", 
        "statistics": {
          "matched-packets": 0
        }
      }
    ]
  }
}