Traceroute

POST /user/:user_code/request/traceroute

Request traceroute

Detail

Request

Header

Content-Type: application/json

Body

Key	Type	Value
sa	Object	Requested service adaptor information (required) code: String SA code
targetTime	String	Execution schedule date/time (required) Can specify up to one month ahead Execute immediately if null
targetAddress	String	Traceroute recipient IP address (required)
maxHop	int	Maximum hop count (0 - 255) (required)
count	int	Packet count per hop (1 - 10) (required)

Response

Status Code

201

Body

Key	Type	Value
targetAddress	String	Traceroute recipient IP address
maxHop	int	maximum hop count (0 - 255)
count	int	Packet count per hop (1 - 10) (required)
resultNodeInfo	Array	List of traceroute results Always null
Other than the above		Shared parameters See “ Request information “

Sample

Request

URL

POST https://*.sacm.jp/public-api/v1/user/tsa99990001/request/traceroute

Header

Content-Type: application/json

Body

{
  "sa": {
    "code": "tss99990001"
  },
  "targetTime": "2012/06/27 14:51:25",
  "targetAddress": "210.130.137.80",
  "maxHop": 100,
  "count": 5
}

Response

Header

Content-Type: application/json

Body

{
  "id": "1:1",
  "sa": {
    "code": "tss99990001",
    "name": "Service adapter 001",
    "description": "MEMO",
    "distributionId": "0001-0000-0101-0000-0000-0000-1234-5678",
    "up": true
  },
  "type": "traceroute",
  "targetTime": "2012/06/27 14:51:25",
  "status": "initial",
  "proxyStatus": "none",
  "resultCode": "none",
  "targetAddress": "210.130.137.80",
  "maxHop": 100,
  "count": 5,
  "resultNodeInfo": null
}

GET /user/:user_code/request/traceroute/:id

Read information for requested traceroute

Detail

Request

No Parameters

Response

Body

Key	Type	Value
targetAddress	String	Traceroute recipient IP address
maxHop	int	maximum hop count (0 - 255)
count	int	Packet count per hop (1 - 10) (required)
resultNodeInfo	Array	List of traceroute results (only when request is done) hop int Hop No. address String Hop IP address
Other than the above		Shared parameters See “ Request information “

Sample

Request

URL

GET https://*.sacm.jp/public-api/v1/user/tsa99990001/request/traceroute/1:1

Response

Header

Content-Type: application/json

Body

{
  "id": "1:1",
  "sa": {
    "code": "tss99990001",
    "name": "Service adapter 001",
    "description": "MEMO",
    "distributionId": "0001-0000-0101-0000-0000-0000-1234-5678",
    "up": true
  },
  "type": "traceroute",
  "targetTime": "2012/06/27 14:51:25",
  "status": "successed",
  "proxyStatus": "success",
  "resultCode": "success",
  "targetAddress": "210.130.137.80",
  "maxHop": 100,
  "count": 5,
  "resultNodeInfo": [
    {
      "hop": 1,
      "address": "192.168.0.1"
    },
    {
      "hop": 2,
      "address": "210.149.34.69"
    },
    {
      "hop": 3,
      "address": "210.149.34.133"
    },
    {
      "hop": 4,
      "address": "210.149.34.97"
    },
    {
      "hop": 5,
      "address": "58.138.100.213"
    },
    {
      "hop": 6,
      "address": "58.138.80.45"
    },
    {
      "hop": 7,
      "address": "58.138.80.242"
    },
    {
      "hop": 8,
      "address": "58.138.104.30"
    },
    {
      "hop": 9,
      "address": "210.130.137.80"
    }
  ]
}

PUT /user/:user_code/request/traceroute/:id

Update information for requested traceroute (stop execution, update execution schedule date/time)

Detail

Request

Header

Content-Type: application/json

Body

Key	Type	Value
status	int	Request status Use to stop execution Can update only if status is “initial” Only “3” (cancel) can be specified
targetTime	String	Execute schedule date/time Use to update execution schedule date/time Can update only if status is “initial” Can specify up to one month ahead,

Response

Body

Key	Type	Value
targetAddress	String	Traceroute recipient IP address
maxHop	int	maximum hop count (0 - 255)
count	int	Packet count per hop (1 - 10) (required)
resultNodeInfo	Array	List of traceroute results Always null
Other than the above		Shared parameters See “ Request information “

Sample (to stop execution)

Request

URL

PUT https://*.sacm.jp/public-api/v1/user/tsa99990001/request/traceroute/1:1

Header

Content-Type: application/json

Body

{"status": 3}

Response

Header

Content-Type: application/json

Body

{
  "id": "1:1",
  "sa": {
    "code": "tss99990001",
    "name": "Service adapter 001",
    "description": "MEMO",
    "distributionId": "0001-0000-0101-0000-0000-0000-1234-5678",
    "up": true
  },
  "type": "traceroute",
  "targetTime": "2012/06/27 14:51:25",
  "status": "canceled",
  "proxyStatus": "none",
  "resultCode": "none",
  "targetAddress": "210.130.137.80",
  "maxHop": 100,
  "count": 5,
  "resultNodeInfo": null
}

Sample (to update execution date/time)

Request

URL

PUT https://*.sacm.jp/public-api/v1/user/tsa99990001/request/traceroute/1:1

Header

Content-Type: application/json

Body

{"targetTime": "2012/06/27 16:00:00"}

Response

Header

Content-Type: application/json

Body

{
  "id": "1:1",
  "sa": {
    "code": "tss99990001",
    "name": "Service adapter 001",
    "description": "MEMO",
    "distributionId": "0001-0000-0101-0000-0000-0000-1234-5678",
    "up": true
  },
  "type": "traceroute",
  "targetTime": "2012/06/27 16:00:00",
  "status": "initial",
  "proxyStatus": "none",
  "resultCode": "none",
  "targetAddress": "210.130.137.80",
  "maxHop": 100,
  "count": 5,
  "resultNodeInfo": null
}

Description

• ID may be updated if the execution schedule date/time is updated

• Simultaneous execution cancel and execution schedule date/time update not allowed