Update Element for Associations (v3.1)
PUT/v3.1/api/tenants/:tenant_id/elements/:element_id
Update element for associations.
Request
Path Parameters
The tenant ID.
The element ID.
- application/json
Body
Update to the element
- Array [
- ]
- Array [
- ]
The cluster ID.
The description of the element.
The device profile ID.
The element ID.
The L3 direct private WAN is enabled. True or False.
The L3 LAN forwarding is enabled. Yes indicates that traffic forwarding to and from LAN interface, when Enable L3 Direct Private WAN Forwarding is enabled.
led_config LedConfig
Valid LED config.
Service Led On
The main power usage threshold. Allowed range is 50-100.
The name of the device.
ID for the NAT Policyset Stack. Can be retrieved using natpolicysetstack API.
The ID for the Path Policyset Stack. Can be retrieved using networkpolicysetstack API.
ID for the QoS Policyset Stack. Can be retrieved using prioritypolicysetstack API.
The site ID.
spoke_ha_config SpokeHAConfigV2
The details of the spoke HA configuration.
The spoke HA config cluster ID.
The spoke HA config enabled. True or False.
The priority of the spoke HA config.
The spoke HA config source interface ID.
track TrackV2
Track: Valid
interfaces TrackInterface[]
The details of the interfaces.
The interface ID
Reduce priority of the spoke HA config.
waninterfaces TrackWANInterface[]
Waninterfaces: Valid
Reduce priority of the spoke HA config.
The WAN interface ID
sw_obj Software
The location and version of the software.
Location
Version
switch_config SwitchConfig
The details of the switch configuration.
Default VLAN ID is 1.
The MSTP enabled. True or False.
The STP aging Timer between 10 - 1000000 seconds.
Forward Delay is the length of time spent in listening state, set the value between 4 - 30 seconds.
Hello Time is the time Interval between BPDU transmission, set the value between 1-10 seconds.
The length of Max Age time that the switch retains information learned from BPDUs, set the value between 6 - 40 seconds.
Possible values: [RSTP
]
The STP Mode is RSTP, default STP mode is RSTP
The Priority value is between 0 - 61440, in multiples of 4096.
A information field that can be added to identify the element.
Tenant Id: NotNull Digits(fraction = 0, integer = 20, TENANT_ID_INVALID_0001)
VPN to VPN forwarding. True or False.
Responses
- 200
- 400
Successful Operation
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
- Array [
- ]
The cluster ID.
The description of the element.
The device profile ID.
The element ID.
The L3 direct private WAN is enabled. True or False.
The L3 LAN forwarding is enabled. Yes indicates that traffic forwarding to and from LAN interface, when Enable L3 Direct Private WAN Forwarding is enabled.
led_config LedConfig
Valid LED config.
Service Led On
The main power usage threshold. Allowed range is 50-100.
The name of the device.
ID for the NAT Policyset Stack. Can be retrieved using natpolicysetstack API.
The ID for the Path Policyset Stack. Can be retrieved using networkpolicysetstack API.
ID for the QoS Policyset Stack. Can be retrieved using prioritypolicysetstack API.
The site ID.
spoke_ha_config SpokeHAConfigV2
The details of the spoke HA configuration.
The spoke HA config cluster ID.
The spoke HA config enabled. True or False.
The priority of the spoke HA config.
The spoke HA config source interface ID.
track TrackV2
Track: Valid
interfaces TrackInterface[]
The details of the interfaces.
The interface ID
Reduce priority of the spoke HA config.
waninterfaces TrackWANInterface[]
Waninterfaces: Valid
Reduce priority of the spoke HA config.
The WAN interface ID
sw_obj Software
The location and version of the software.
Location
Version
switch_config SwitchConfig
The details of the switch configuration.
Default VLAN ID is 1.
The MSTP enabled. True or False.
The STP aging Timer between 10 - 1000000 seconds.
Forward Delay is the length of time spent in listening state, set the value between 4 - 30 seconds.
Hello Time is the time Interval between BPDU transmission, set the value between 1-10 seconds.
The length of Max Age time that the switch retains information learned from BPDUs, set the value between 6 - 40 seconds.
Possible values: [RSTP
]
The STP Mode is RSTP, default STP mode is RSTP
The Priority value is between 0 - 61440, in multiples of 4096.
A information field that can be added to identify the element.
Tenant Id: NotNull Digits(fraction = 0, integer = 20, TENANT_ID_INVALID_0001)
VPN to VPN forwarding. True or False.
{
"cluster_id": "string",
"device_profile_id": "string",
"id": "string",
"l3_direct_private_wan_forwarding": true,
"l3_lan_forwarding": true,
"led_config": {
"service_led_on": true
},
"main_power_usage_threshold": 0,
"name": "string",
"nat_policysetstack_id": "string",
"network_policysetstack_id": "string",
"priority_policysetstack_id": "string",
"site_id": "string",
"spoke_ha_config": {
"cluster_id": "string",
"enable": true,
"priority": 0,
"source_interface": "string",
"track": {
"interfaces": [
{
"interface_id": "string",
"reduce_priority": 0
}
],
"waninterfaces": [
{
"reduce_priority": 0,
"wan_interface_id": "string"
}
]
}
},
"sw_obj": {
"location": "string",
"version": "string"
},
"switch_config": {
"default_vlan_id": 0,
"mstp_enabled": true,
"stp_aging_timer": 0,
"stp_forward_delay": 0,
"stp_hello_time": 0,
"stp_max_age": 0,
"stp_mode": "RSTP",
"stp_priority": 0
},
"tags": [
"string"
],
"tenant_id": "string",
"vpn_to_vpn_forwarding": true
}
Bad Request
- application/json
- Schema
- Example (from schema)
- Example
Schema
- Array [
- ]
_error ErrorResponse[]
The error code.
The error message.
{
"_error": [
{
"code": "string",
"message": "string"
}
]
}
{
"value": {
"_error": [
{
"code": "NAME_EXCEEDS_LIMIT"
},
{
"code": "DESCRIPTION_EXCEEDS_LIMIT"
},
{
"code": "INVALID_NETWORK_POLICYSETSTACK_ID"
},
{
"code": "INVALID_PRIORITY_POLICYSETSTACK_ID"
},
{
"code": "INVALID_NAT_POLICYSETSTACK_ID"
},
{
"code": "INVALID_TAG"
},
{
"code": "ELEMENT_NOT_FOUND"
},
{
"code": "INVALID_JSON_EXTRA_ATTRIBUTE"
},
{
"code": "INVALID_JSON_COMMON_ATTR_MISMATCH"
},
{
"code": "GENERAL_CONFIG_ERROR"
},
{
"code": "ELEMENT_SITE_STACKED_SECURITY_POLICY_INCOMPATIBLE"
},
{
"code": "INVALID_OPERATION"
},
{
"code": "NO_DEFAULT_CLUSTER_DEFINED"
},
{
"code": "SITE_NOT_FOUND"
},
{
"code": "L3_FORWARDING_SUPPORTED_BY_BRANCH_DEVICES"
},
{
"code": "POLICY_REQUIRED"
},
{
"code": "SPOKE_SITE_CLUSTER_ID_INVALID"
},
{
"code": "ELEMENT_CONFIG_INVALID_VALUES"
},
{
"code": "ELEMENT_CLUSTER_UPDATE_NOT_ALLOWED"
},
{
"code": "CLUSTER_ID_NOT_PRESENT"
},
{
"code": "CLUSTER_ID_INVALID"
},
{
"code": "CLUSTER_CAPACITY_FULL"
},
{
"code": "ELEMENT_SOFTWARE_NON_CG_SERVICE_LINK_NOT_SUPPORTED"
},
{
"code": "CLUSTER_ID_NOT_NULL"
},
{
"code": "ELEMENT_NOT_BOUND"
},
{
"code": "FIPS_MODE_PLEASE_RETRY_RECOVER_LATER"
},
{
"code": "ELEMENT_SPOKE_CLUSTER_MEMBER"
},
{
"code": "SITE_WAN_INTERFACE_ID_EXISTS"
},
{
"code": "ELEMENT_BOUND_ERROR"
},
{
"code": "INVALID_CLUSTER_ID"
},
{
"code": "CLUSTER_ID_SHOULD_BE_NULL_FOR_SPOKE"
},
{
"code": "ELEMENT_NOT_ASSIGNED_TO_SITE"
},
{
"code": "ELEMENT_CONFIG_POLICY_FOR_HUB_NOT_ALLOWED"
},
{
"code": "ELEMENT_NAT_POLICY_SUPPORT_REQUIRED"
},
{
"code": "ELEMENT_CONFIG_NAT_POLICYSETSTACK_NOT_FOUND"
},
{
"code": "L3_FORWARDING_NOT_SUPPORTED_BY_ELEMENT"
},
{
"code": "ENABLE_L3_LAN_FORWARDING_NOT_ALLOWED"
},
{
"code": "DISABLE_L3_LAN_FORWARDING_NOT_ALLOWED_SECONDARY_IP_PRESENT"
},
{
"code": "DISABLE_L3_LAN_FORWARDING_NOT_ALLOWED_STATIC_ARP_PRESENT"
},
{
"code": "L3_LAN_FORWARDING_DISABLE_NOT_SUPPORTED_WHEN_MULTICAST_ENABLED_ON_INTERFACE"
},
{
"code": "ELEMENT_HA_CONFIG_NOT_SUPPORTED"
},
{
"code": "ELEMENT_INVALID_HA_CONFIG_SITE"
},
{
"code": "ELEMENT_HA_CONFIG_TRACK_WAN_INTERFACES_NOT_SUPPORTED"
},
{
"code": "ELEMENT_INVALID_HA_CONFIG_CLUSTER_ID"
},
{
"code": "ELEMENT_INVALID_HA_CONFIG_EXCEEDS_LIMIT"
},
{
"code": "ELEMENT_INVALID_HA_CONFIG_SOURCE_INTERFACE"
},
{
"code": "ELEMENT_INVALID_HA_CONFIG_SOURCE_INTERFACE_CELLULAR"
},
{
"code": "ELEMENT_INVALID_HA_CONFIG_TRACK_INTERFACES"
},
{
"code": "ELEMENT_INVALID_HA_CONFIG_TRACK_INTERFACE_BYPASSPAIR"
},
{
"code": "ELEMENT_INVALID_HA_CONFIG_TRACK_INTERFACE_CELLULAR"
},
{
"code": "ELEMENT_INVALID_HA_CONFIG_TRACK_WAN_INTERFACES"
},
{
"code": "DUPLICATE_HA_CONFIG_TRACK_WAN_INTERFACES"
},
{
"code": "ELEMENT_INVALID_HA_CONFIG_TRACK_WAN_INTERFACES_BYPASSPAIR_PRIVATE_L2"
},
{
"code": "ELEMENT_INVALID_HA_CONFIG_TRACK_WAN_INTERFACES_WITHOUT_PORT"
},
{
"code": "ELEMENT_VPN_TO_VPN_FORWARDING_NOT_SUPPORTED"
},
{
"code": "ELEMENT_INVALID_VPN_TO_VPN_FORWARDING_SITE"
}
]
}
}