Update Networks

Use this API call to update a network.

Requires the sdn-networks-manage permission.

query
  • include

    Accepted Values: creatorsenvironments

  • sort

    Sorts can be performed on any field - see sorting

  • filter

    Collections of resources can be filtered based on certain criteria - see filtering 

Arguments
  • name
    string

    A new name for the network.

Returns

Returns a network resource (the one you just updated), otherwise returns an Error.

PATCH /v1/sdn/networks/{ID}

Example Request
$ curl https://api.cycle.io/v1/sdn/networks/5a98710df231a500017f9aa4 \
-H
"Authorization: Bearer API_KEY"
\
-H
"X-HUB-ID: HUB_ID"
\
-d {"name":"new network name"} \
-X PATCH
Example Response
{
"data": {
"id": "5a98710df231a500017f9aa4",
"name": "Test",
"identifier": "test",
"cluster": "production",
"creator": {
"type": "account",
"id": "3a78910df231a500017f9bb4"
},
"hub_id": "5cc78aa0db2ab000014a8b98",
"state": {
"changed": "2018-09-14T21:39:29.428Z",
"current": "live"
},
"private_network": {
"vxlan_tag": 25564,
"subnet": "a325",
"mac_addr_suffix": 233,
"ipv6": {
"ip": "fdoo:feee:b870::",
"cidr": "fdoo:feee:b870::/64"
}
},
"environments": [
{
"id": "3a78910df231a500017f9bb4",
"added": "2018-10-12T21:43:42.557Z"
}
],
"events": {
"created": "2018-09-14T21:39:03.096Z",
"updated": "2018-09-17T16:50:54.107Z",
"deleted": "0001-01-01T00:00:00Z"
}
}
}