asns/{{id}}

See also

The Autonomous System Wikipedia page for an explanation of what an ASN actually is.

PUT

Allows user to edit an existing ASN-to-Cache Group association.

Auth. Required:

Yes

Roles Required:

“admin” or “operations”

Permissions Required:

ASN:UPDATE, ASN:READ, CACHE-GROUP:UPDATE, CACHE-GROUP:READ

Response Type:

Object

Request Structure

asn:

The new ASN which will be associated with the identified Cache Group - must not conflict with existing associations

cachegroup:

An optional field which, if present, is a string that specifies the Name of a Cache Group to which this ASN will be assigned

Note

While this endpoint accepts the cachegroup field, sending this in the request payload has no effect except that the response will (erroneously) name the Cache Group to which the ASN was assigned. Any subsequent requests will reveal that, in fact, the Cache Group is set entirely by the cachegroupId field, and so the actual Name may differ from what was in the request.

cachegroupId:

An integer that is the ID of a Cache Group to which this ASN will be assigned - must not conflict with existing associations

Table 447 Request Path Parameters

Name

Required

Description

id

yes

The integral, unique identifier of the desired ASN-to-Cache Group association

#1117 Request Example
PUT /api/5.0/asns/1 HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...
Content-Length: 29
Content-Type: application/json

{"asn": 2, "cachegroupId": 1}

Response Structure

asn:

An ASN as specified by IANA for identifying a service provider

cachegroup:

A string that is the Name of the Cache Group that is associated with this ASN

cachegroupId:

An integer that is the ID of the Cache Group that is associated with this ASN

id:

An integral, unique identifier for this association between an ASN and a Cache Group

lastUpdated:

The time and date this server entry was last updated in Traffic Ops’s Custom Date/Time Format

Changed in version 5.0: Prior to version 5.0 of the API, this field was in Traffic Ops’s Custom Date/Time Format.

#1118 Response Example
HTTP/1.1 200 OK
Access-Control-Allow-Credentials: true
Access-Control-Allow-Headers: Origin, X-Requested-With, Content-Type, Accept, Set-Cookie, Cookie
Access-Control-Allow-Methods: POST,GET,OPTIONS,PUT,DELETE
Access-Control-Allow-Origin: *
Content-Type: application/json
Set-Cookie: mojolicious=...; Path=/; Expires=Mon, 18 Nov 2019 17:40:54 GMT; Max-Age=3600; HttpOnly
Whole-Content-Sha512: /83P4LJVsrQx9BKHFxo5pbhQMlB4o3a9v3PpkspyOJcpNx1S/GJhCPpiANBki547sbY+0vTq76IriHZ4GYp8bA==
X-Server-Name: traffic_ops_golang/
Date: Thu, 25 May 2023 21:59:33 GMT
Content-Length: 160

{ "alerts": [
    {
        "text": "asn was updated.",
        "level": "success"
    }
],
"response": {
    "asn": 2,
    "cachegroup": null,
    "cachegroupId": 1,
    "id": 1,
    "lastUpdated": "2023-05-25T15:59:33.7096-06:00"
}}

DELETE

Deletes an association between an ASN and a Cache Group.

Auth. Required:

Yes

Roles Required:

“admin” or “operations”

Permissions Required:

ASN:DELETE, ASN:READ, CACHE-GROUP:READ, CACHE-GROUP:UPDATE

Response Type:

undefined

Request Structure

Table 448 Request Path Parameters

Name

Required

Description

id

yes

The integral, unique identifier of the desired ASN-to-Cache Group association

#1119 Request Example
DELETE /api/5.0/asns/1 HTTP/1.1
User-Agent: python-requests/2.22.0
Accept-Encoding: gzip, deflate
Accept: */*
Connection: keep-alive
Cookie: mojolicious=...
Content-Length: 0

Response Structure

#1120 Response Example
HTTP/1.1 200 OK
Access-Control-Allow-Credentials: true
Access-Control-Allow-Headers: Origin, X-Requested-With, Content-Type, Accept, Set-Cookie, Cookie
Access-Control-Allow-Methods: POST,GET,OPTIONS,PUT,DELETE
Access-Control-Allow-Origin: *
Content-Encoding: gzip
Content-Type: application/json
Set-Cookie: mojolicious=...; Path=/; Expires=Mon, 02 Dec 2019 23:06:24 GMT; Max-Age=3600; HttpOnly
Whole-Content-Sha512: 6t3WA+DOcfPJB5UnvDpzEVx5ySfmJgEV9wgkO71U5k32L1VXpxcaTdDVLNGgDDl9sdNftmYnKXf5jpfWUuFYJQ==
X-Server-Name: traffic_ops_golang/
Date: Mon, 02 Dec 2019 22:06:24 GMT
Content-Length: 81

{ "alerts": [
    {
        "text": "asn was deleted.",
        "level": "success"
    }
]}