Performing a Virtual Interface Switchover Test

Function

If there are two connections, automatic switchover between the connections is required for connectivity testing.If a switchover is performed, the virtual interface of the connection in use is disabled and traffic is interrupted.You can perform two operations on a virtual interface:- Run the shutdown command to disable the virtual interface.- Run the undo_shutdown command to enable the virtual interface.If shutdown is selected for the switchover test, the virtual interface is in the ADMIN_SHUTDOWN state, and no operations can be performed on the virtual interface.If undo_shutdown is selected for the switchover test, the virtual interface is in the ACTIVE state.

URI

POST /v3/{project_id}/dcaas/switchover-test

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Specifies the project ID.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Specifies the user token. To obtain the token, see section "Obtaining the User Token" in the Identity and Access Management API Reference. The token is the value of X-Subject-Token in the response header. Minimum: 0 Maximum: 10240

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
switchover_test_record	No	CreateSwitchoverTest object	Specifies the parameters for creating a switchover test record.

**Table 4** CreateSwitchoverTest
Parameter	Mandatory	Type	Description
resource_id	Yes	String	Specifies the ID of the resource on which the switchover test is to be performed.
resource_type	No	String	Specifies the type of the resource on which the switchover test is to be performed. Default: virtual_interface Minimum: 0 Maximum: 128 Enumeration values: virtual_interface
operation	Yes	String	Specifies whether to perform a switchover test. Value options: shutdown and undo_shutdown Minimum: 0 Maximum: 128 Enumeration values: shutdown undo_shutdown

Response Parameters

Status code: 201

**Table 5** Response body parameters
Parameter	Type	Description
request_id	String	Specifies the request ID.
switchover_test_record	SwitchoverTestRecord object	Provides supplementary information about the switchover test record.

**Table 6** SwitchoverTestRecord
Parameter	Type	Description
id	String	Specifies the unique ID of the switchover test record.
tenant_id	String	Specifies the tenant ID. Minimum: 32 Maximum: 32
resource_id	String	Specifies the ID of the resource on which the switchover test is to be performed.
resource_type	String	Specifies the type of the resource on which the switchover test is to be performed. Default: virtual_interface Minimum: 0 Maximum: 128 Enumeration values: virtual_interface
operation	String	Specifies whether to perform a switchover test. Value options: shutdown and undo_shutdown Minimum: 0 Maximum: 128 Enumeration values: shutdown undo_shutdown
start_time	String	Specifies the start time of the switchover test.
end_time	String	Specifies the end time of the switchover test.
operate_status	String	Specifies the switchover test status. STARTING: initial status INPROGRESS: delivering configuration COMPLETE: configuration delivered ERROR: Configuration delivery failed Enumeration values: STARTING INPROGRESS COMPLETE ERROR

Example Requests

Shutting down the virtual interface to perform a switchover test

POST https://{dc_endpoint}/v3/de58f033eb664102ba85e4a5db473ca5/dcaas/switchover-test

{
  "switchover_test_record" : {
    "resource_type" : "virtual_interface",
    "resource_id" : "d0b3329c-0063-470c-b1dc-657656b2e540",
    "operation" : "shutdown"
  }
}

Example Responses

Status code: 201

Created

{
  "switchover_test_record" : {
    "id" : "862d61f1-d9ea-4093-ba0e-2b8d415e3ab3",
    "tenant_id" : "de58f033eb664102ba85e4a5db473ca5",
    "resource_type" : "virtual_interface",
    "resource_id" : "d0b3329c-0063-470c-b1dc-657656b2e540",
    "operation" : "shutdown",
    "start_time" : "2023-10-09T18:41:23.000Z",
    "end_time" : "2023-10-09T18:41:23.000Z",
    "operate_status" : "STARTING"
  },
  "request_id" : "f91634a12b116b6f946d7871f5b4de18"
}