HTTP API

    CI/CD: The HTTP API can be used for infrastructure automation to either retrieve data, or to make changes when running in Universal mode. The CLI is built on top of the HTTP API, which you can also access with any other HTTP client like curl.

    By default the HTTP API is listening on port 5681. The endpoints available are:

    • /config
    • /meshes
    • /meshes/{name}
    • /meshes/{name}/dataplanes
    • /meshes/{name}/dataplanes/{name}
    • /meshes/{name}/dataplanes+insights
    • /meshes/{name}/dataplanes+insights/{name}
    • /meshes/{name}/health-checks
    • /meshes/{name}/health-checks/{name}
    • /meshes/{name}/proxytemplates
    • /meshes/{name}/proxytemplates/{name}
    • /meshes/{name}/traffic-logs
    • /meshes/{name}/traffic-logs/{name}
    • /meshes/{name}/traffic-permissions
    • /meshes/{name}/traffic-permissions/{name}
    • /meshes/{name}/traffic-routes
    • /meshes/{name}/traffic-routes/{name}

    You can use GET requests to retrieve the state of Kuma on both Universal and Kubernetes, and PUT and DELETE requests on Universal to change the state.

    Request: GET /config

    Response: 200 OK with the effective configuration of the Control Plane (notice that secrets, such as database passwords, will never appear in the response)

    Example:

    1. {
    2.   "adminServer": {
    3.     "apis": {
    4.       "dataplaneToken": {
    5.         "enabled": true
    6.       }
    7.     },
    8.     "local": {
    9.       "port": 5679
    10.     },
    11.     "public": {
    12.       "clientCertsDir": "/etc/kuma.io/kuma-cp/admin-api/tls/allowed-client-certs.d",
    13.       "enabled": true,
    14.       "interface": "0.0.0.0",
    15.       "port": 5684,
    16.       "tlsCertFile": "/etc/kuma.io/kuma-cp/admin-api/tls/server.cert",
    17.       "tlsKeyFile": "/etc/kuma.io/kuma-cp/admin-api/tls/server.key"
    18.     }
    19.   },
    20.   "apiServer": {
    21.     "corsAllowedDomains": [
    22.       ".*"
    23.     ],
    24.     "port": 5681,
    25.     "readOnly": false
    26.   },
    27.   "bootstrapServer": {
    28.     "params": {
    29.       "adminAccessLogPath": "/dev/null",
    30.       "adminAddress": "127.0.0.1",
    31.       "adminPort": 0,
    32.       "xdsConnectTimeout": "1s",
    33.       "xdsHost": "kuma-control-plane.internal",
    34.       "xdsPort": 5678
    35.     },
    36.     "port": 5682
    37.   },
    38.   "dataplaneTokenServer": {
    39.     "enabled": true,
    40.     "local": {
    41.       "port": 5679
    42.     },
    43.     "public": {
    44.       "clientCertsDir": "/etc/kuma.io/kuma-cp/admin-api/tls/allowed-client-certs.d",
    45.       "enabled": true,
    46.       "interface": "0.0.0.0",
    47.       "port": 5684,
    48.       "tlsCertFile": "/etc/kuma.io/kuma-cp/admin-api/tls/server.cert",
    49.       "tlsKeyFile": "/etc/kuma.io/kuma-cp/admin-api/tls/server.key"
    50.     }
    51.   },
    52.   "defaults": {
    53.     "mesh": "type: Mesh\nname: default\nmtls:\n  ca: {}\n  enabled: false\n"
    54.   },
    55.   "discovery": {
    56.     "universal": {
    57.       "pollingInterval": "1s"
    58.     }
    59.   },
    60.   "environment": "universal",
    61.   "general": {
    62.     "advertisedHostname": "kuma-control-plane.internal"
    63.   },
    64.   "guiServer": {
    65.     "port": 5683
    66.   },
    67.   "monitoringAssignmentServer": {
    68.     "assignmentRefreshInterval": "1s",
    69.     "grpcPort": 5676
    70.   },
    71.   "reports": {
    72.     "enabled": true
    73.   },
    74.   "runtime": {
    75.     "kubernetes": {
    76.       "admissionServer": {
    77.         "address": "",
    78.         "certDir": "",
    79.         "port": 5443
    80.       }
    81.     }
    82.   },
    83.   "sdsServer": {
    84.     "grpcPort": 5677,
    85.     "tlsCertFile": "/tmp/117637813.crt",
    86.     "tlsKeyFile": "/tmp/240596112.key"
    87.   },
    88.   "store": {
    89.     "kubernetes": {
    90.       "systemNamespace": "kuma-system"
    91.     },
    92.     "postgres": {
    93.       "connectionTimeout": 5,
    94.       "dbName": "kuma",
    95.       "host": "127.0.0.1",
    96.       "password": "*****",
    97.       "port": 15432,
    98.       "user": "kuma"
    99.     },
    100.     "type": "memory"
    101.   },
    102.   "xdsServer": {
    103.     "dataplaneConfigurationRefreshInterval": "1s",
    104.     "dataplaneStatusFlushInterval": "1s",
    105.     "diagnosticsPort": 5680,
    106.     "grpcPort": 5678
    107.   }
    108. }

    Meshes

    Get Mesh

    Request: GET /meshes/{name}

    Response: 200 OK with Mesh entity

    Example:

    1. curl http://localhost:5681/meshes/mesh-1
    1. {
    2.   "name": "mesh-1",
    3.   "type": "Mesh",
    4.   "mtls": {
    5.     "ca": {
    6.       "builtin": {}
    7.     },
    8.     "enabled": true
    9.   },
    10.   "tracing": {},
    11.   "logging": {
    12.     "backends": [
    13.       {
    14.         "name": "file-tmp",
    15.         "format": "{ \"destination\": \"%KUMA_DESTINATION_SERVICE%\", \"destinationAddress\": \"%UPSTREAM_LOCAL_ADDRESS%\", \"source\": \"%KUMA_SOURCE_SERVICE%\", \"sourceAddress\": \"%KUMA_SOURCE_ADDRESS%\", \"bytesReceived\": \"%BYTES_RECEIVED%\", \"bytesSent\": \"%BYTES_SENT%\"}",
    16.         "file": {
    17.           "path": "/tmp/access.log"
    18.         }
    19.       },
    20.       {
    21.         "name": "logstash",
    22.         "tcp": {
    23.           "address": "logstash.internal:9000"
    24.         }
    25.       }
    26.     ]
    27.   }
    28. }

    Create/Update Mesh

    Request: PUT /meshes/{name} with Mesh entity in body

    Response: 201 Created when the resource is created and 200 OK when it is updated

    Example:

    1. curl -XPUT http://localhost:5681/meshes/mesh-1 --data @mesh.json -H'content-type: application/json'
    1. {
    2.   "name": "mesh-1",
    3.   "type": "Mesh",
    4.   "mtls": {
    5.     "ca": {
    6.       "builtin": {}
    7.     },
    8.     "enabled": true
    9.   },
    10.   "tracing": {},
    11.   "logging": {
    12.     "backends": [
    13.       {
    14.         "name": "file-tmp",
    15.         "format": "{ \"destination\": \"%KUMA_DESTINATION_SERVICE%\", \"destinationAddress\": \"%UPSTREAM_LOCAL_ADDRESS%\", \"source\": \"%KUMA_SOURCE_SERVICE%\", \"sourceAddress\": \"%KUMA_SOURCE_ADDRESS%\", \"bytesReceived\": \"%BYTES_RECEIVED%\", \"bytesSent\": \"%BYTES_SENT%\"}",
    16.         "file": {
    17.           "path": "/tmp/access.log"
    18.         }
    19.       },
    20.       {
    21.         "name": "logstash",
    22.         "tcp": {
    23.           "address": "logstash.internal:9000"
    24.         }
    25.       }
    26.     ]
    27.   }
    28. }

    List Meshes

    Request: GET /meshes

    Response: 200 OK with body of Mesh entities

    Example:

    1. curl http://localhost:5681/meshes
    1. {
    2.   "items": [
    3.     {
    4.       "type": "Mesh",
    5.       "name": "mesh-1",
    6.       "mtls": {
    7.         "ca": {
    8.           "builtin": {}
    9.         },
    10.         "enabled": true
    11.       },
    12.       "tracing": {},
    13.       "logging": {
    14.         "backends": [
    15.           {
    16.             "name": "file-tmp",
    17.             "format": "{ \"destination\": \"%KUMA_DESTINATION_SERVICE%\", \"destinationAddress\": \"%UPSTREAM_LOCAL_ADDRESS%\", \"source\": \"%KUMA_SOURCE_SERVICE%\", \"sourceAddress\": \"%KUMA_SOURCE_ADDRESS%\", \"bytesReceived\": \"%BYTES_RECEIVED%\", \"bytesSent\": \"%BYTES_SENT%\"}",
    18.             "file": {
    19.               "path": "/tmp/access.log"
    20.             }
    21.           },
    22.           {
    23.             "name": "logstash",
    24.             "tcp": {
    25.               "address": "logstash.internal:9000"
    26.             }
    27.           }
    28.         ]
    29.       }
    30.     }
    31.   ]
    32. }

    Delete Mesh

    Request: DELETE /meshes/{name}

    Response: 200 OK

    Example:

    1. curl -XDELETE http://localhost:5681/meshes/mesh-1

    Dataplanes

    Get Dataplane

    Request: GET /meshes/{mesh}/dataplanes/{name}

    Response: 200 OK with Mesh entity

    Example:

    1. curl http://localhost:5681/meshes/mesh-1/dataplanes/backend-1
    1. {
    2.   "type": "Dataplane",
    3.   "name": "backend-1",
    4.   "mesh": "mesh-1",
    5.   "networking": {
    6.     "address": "127.0.0.1",
    7.     "inbound": [
    8.       {
    9.         "port": 11011,
    10.         "servicePort": 11012,
    11.         "tags": {
    12.           "service": "backend",
    13.           "version": "2.0",
    14.           "env": "production"
    15.         }
    16.       }
    17.     ],
    18.     "outbound": [
    19.       {
    20.         "port": 33033,
    21.         "service": "database"
    22.       },
    23.       {
    24.         "port": 44044,
    25.         "service": "user"
    26.       }
    27.     ]
    28.   }
    29. }

    Create/Update Dataplane

    Request: PUT /meshes/{mesh}/dataplanes/{name} with Dataplane entity in body

    Response: 201 Created when the resource is created and 200 OK when it is updated

    Example:

    1. curl -XPUT http://localhost:5681/meshes/mesh-1/dataplanes/backend-1 --data @dataplane.json -H'content-type: application/json'
    1. {
    2.   "type": "Dataplane",
    3.   "name": "backend-1",
    4.   "mesh": "mesh-1",
    5.   "networking": {
    6.     "address": "127.0.0.1",
    7.     "inbound": [
    8.       {
    9.         "port": 11011,
    10.         "servicePort": 11012,
    11.         "tags": {
    12.           "service": "backend",
    13.           "version": "2.0",
    14.           "env": "production"
    15.         }
    16.       }
    17.     ],
    18.     "outbound": [
    19.       {
    20.         "service": "database"
    21.       },
    22.       {
    23.         "port": 44044,
    24.         "service": "user"
    25.       }
    26.     ]
    27.   }
    28. }

    List Dataplanes

    Request: GET /meshes/{mesh}/dataplanes

    Response: 200 OK with body of Dataplane entities

    Example:

    1. curl http://localhost:5681/meshes/mesh-1/dataplanes
    1. {
    2.   "items": [
    3.     {
    4.       "type": "Dataplane",
    5.       "name": "backend-1",
    6.       "mesh": "mesh-1",
    7.       "networking": {
    8.         "address": "127.0.0.1",
    9.         "inbound": [
    10.           {
    11.             "port": 11011,
    12.             "servicePort": 11012,
    13.             "tags": {
    14.               "service": "backend",
    15.               "version": "2.0",
    16.               "env": "production"
    17.             }
    18.           }
    19.         ],
    20.         "outbound": [
    21.           {
    22.             "port": 33033,
    23.             "service": "database"
    24.           },
    26.             "port": 44044,
    27.             "service": "user"
    28.           }
    29.         ]
    30.       }
    31.     }
    32.   ]
    33. }

    Delete Dataplane

    Request: DELETE /meshes/{mesh}/dataplanes/{name}

    Response: 200 OK

    Example:

    1. curl -XDELETE http://localhost:5681/meshes/mesh-1/dataplanes/backend-1

    Get Dataplane Overview

    Request: GET /meshes/{mesh}/dataplane+insights/{name}

    Response: 200 OK with Dataplane entity including insight

    Example:

    1. curl http://localhost:5681/meshes/default/dataplanes+insights/example
    1. {
    2.  "type": "DataplaneOverview",
    3.  "mesh": "default",
    4.  "name": "example",
    5.  "dataplane": {
    6.   "networking": {
    7.    "address": "127.0.0.1",
    8.    "inbound": [
    9.     {
    10.      "port": 11011,
    11.      "servicePort": 11012,
    12.      "tags": {
    13.       "env": "production",
    14.       "service": "backend",
    15.       "version": "2.0"
    16.      }
    17.     }
    18.    ],
    19.    "outbound": [
    20.     {
    21.      "port": 33033,
    22.      "service": "database"
    23.     }
    24.    ]
    25.   }
    26.  },
    27.  "dataplaneInsight": {
    28.   "subscriptions": [
    29.    {
    30.     "id": "426fe0d8-f667-11e9-b081-acde48001122",
    31.     "controlPlaneInstanceId": "06070748-f667-11e9-b081-acde48001122",
    32.     "connectTime": "2019-10-24T14:04:56.820350Z",
    33.     "status": {
    34.      "lastUpdateTime": "2019-10-24T14:04:57.832482Z",
    35.      "total": {
    36.       "responsesSent": "3",
    37.       "responsesAcknowledged": "3"
    38.      },
    39.      "cds": {
    40.       "responsesSent": "1",
    41.       "responsesAcknowledged": "1"
    42.      },
    43.      "eds": {
    44.       "responsesSent": "1",
    45.       "responsesAcknowledged": "1"
    46.      },
    47.      "lds": {
    48.       "responsesSent": "1",
    49.       "responsesAcknowledged": "1"
    50.      },
    51.      "rds": {}
    52.     }
    53.    }
    54.   ]
    55.  }
    56. }

    List Dataplane Overviews

    Request: GET /meshes/{mesh}/dataplane+insights/

    Response: 200 OK with Dataplane entities including insight

    1. curl http://localhost:5681/meshes/default/dataplanes+insights
    1. {
    2.   "items": [
    3.     {
    4.      "type": "DataplaneOverview",
    5.      "mesh": "default",
    6.      "name": "example",
    7.      "dataplane": {
    8.       "networking": {
    9.        "address": "127.0.0.1",
    10.        "inbound": [
    11.         {
    12.          "port": 11011,
    13.          "servicePort": 11012,
    14.          "tags": {
    15.           "env": "production",
    16.           "service": "backend",
    17.           "version": "2.0"
    18.          }
    19.         }
    20.        ],
    21.        "outbound": [
    22.         {
    23.          "port": 33033,
    24.          "service": "database"
    25.         }
    26.        ]
    27.       }
    28.      },
    29.      "dataplaneInsight": {
    30.       "subscriptions": [
    31.        {
    32.         "id": "426fe0d8-f667-11e9-b081-acde48001122",
    33.         "controlPlaneInstanceId": "06070748-f667-11e9-b081-acde48001122",
    34.         "connectTime": "2019-10-24T14:04:56.820350Z",
    35.         "status": {
    36.          "lastUpdateTime": "2019-10-24T14:04:57.832482Z",
    37.          "total": {
    38.           "responsesSent": "3",
    39.           "responsesAcknowledged": "3"
    40.          },
    41.          "cds": {
    42.           "responsesSent": "1",
    43.           "responsesAcknowledged": "1"
    44.          },
    45.          "eds": {
    46.           "responsesSent": "1",
    47.           "responsesAcknowledged": "1"
    48.          },
    49.          "lds": {
    50.           "responsesSent": "1",
    51.           "responsesAcknowledged": "1"
    52.          },
    53.          "rds": {}
    54.         }
    55.        }
    56.       ]
    57.      }
    58.     }
    59.   ]
    60. }

    Health Check

    Request: GET /meshes/{mesh}/health-checks/{name}

    Response: 200 OK with Health Check entity

    Example:

    1. {
    2.  "conf": {
    3.   "activeChecks": {
    4.    "interval": "10s",
    5.    "timeout": "2s",
    6.    "unhealthyThreshold": 3,
    7.    "healthyThreshold": 1
    8.   }
    9.  },
    10.  "destinations": [
    11.   {
    12.    "match": {
    13.     "service": "backend"
    14.    }
    15.   }
    16.  ],
    17.  "mesh": "mesh-1",
    18.  "name": "web-to-backend",
    19.  "sources": [
    20.   {
    21.    "match": {
    22.     "service": "web"
    23.    }
    24.   }
    25.  ],
    26.  "type": "HealthCheck"
    27. }

    Create/Update Health Check

    Request: PUT /meshes/{mesh}/health-checks/{name} with Health Check entity in body

    Response: 201 Created when the resource is created and 200 OK when it is updated

    Example:

    1. curl -XPUT http://localhost:5681/meshes/mesh-1/health-checks/web-to-backend --data @healthcheck.json -H'content-type: application/json'
    1. {
    2.  "type": "HealthCheck",
    3.  "mesh": "mesh-1",
    4.  "name": "web-to-backend",
    5.  "sources": [
    6.   {
    7.    "match": {
    8.     "service": "web"
    9.    }
    10.   }
    11.  ],
    12.  "destinations": [
    13.   {
    14.    "match": {
    15.     "service": "backend"
    16.    }
    17.   }
    18.  ],
    19.  "conf": {
    20.   "activeChecks": {
    21.    "interval": "10s",
    22.    "timeout": "2s",
    23.    "unhealthyThreshold": 3,
    24.    "healthyThreshold": 1
    25.   }
    26.  }
    27. }

    List Health Checks

    Request: GET /meshes/{mesh}/health-checks

    Response: 200 OK with body of Health Check entities

    Example:

    1. curl http://localhost:5681/meshes/mesh-1/health-checks
    1. {
    2.  "items": [
    3.   {
    4.    "conf": {
    5.     "activeChecks": {
    6.      "interval": "10s",
    7.      "timeout": "2s",
    8.      "unhealthyThreshold": 3,
    9.      "healthyThreshold": 1
    10.     }
    11.    },
    12.    "destinations": [
    13.     {
    14.      "match": {
    15.       "service": "backend"
    16.      }
    17.     }
    18.    ],
    19.    "mesh": "mesh-1",
    20.    "name": "web-to-backend",
    21.    "sources": [
    22.     {
    23.      "match": {
    24.       "service": "web"
    25.      }
    26.     }
    27.    ],
    28.    "type": "HealthCheck"
    29.   }
    30.  ]
    31. }

    Delete Health Check

    Request: DELETE /meshes/{mesh}/health-checks/{name}

    Response: 200 OK

    Example:

    1. curl -XDELETE http://localhost:5681/meshes/mesh-1/health-checks/web-to-backend

    Proxy Template

    Get Proxy Template

    Request: GET /meshes/{mesh}/proxytemplates/{name}

    Response: 200 OK with Proxy Template entity

    Example:

    1. curl http://localhost:5681/meshes/mesh-1/proxytemplates/pt-1
    1. {
    2.  "conf": {
    3.   "imports": [
    4.    "default-proxy"
    5.   ],
    6.   "resources": [
    7.    {
    8.     "name": "raw-name",
    9.     "version": "raw-version",
    10.     "resource": "'@type': type.googleapis.com/envoy.api.v2.Cluster\nconnectTimeout: 5s\nloadAssignment:\n  clusterName: localhost:8443\n  endpoints:\n    - lbEndpoints:\n        - endpoint:\n            address:\n              socketAddress:\n                address: 127.0.0.1\n                portValue: 8443\nname: localhost:8443\ntype: STATIC\n"
    11.    }
    12.   ]
    13.  },
    14.  "mesh": "mesh-1",
    15.  "name": "pt-1",
    16.  "selectors": [
    17.   {
    18.    "match": {
    19.     "service": "backend"
    20.    }
    21.   }
    22.  ],
    23.  "type": "ProxyTemplate"
    24. }

    Create/Update Proxy Template

    Request: PUT /meshes/{mesh}/proxytemplates/{name} with Proxy Template entity in body

    Response: 201 Created when the resource is created and 200 OK when it is updated

    Example:

    1. curl -XPUT http://localhost:5681/meshes/mesh-1/proxytemplates/pt-1 --data @proxytemplate.json -H'content-type: application/json'
    1. {
    2.   "type": "ProxyTemplate",
    3.   "name": "pt-1",
    4.   "mesh": "mesh-1",
    5.   "selectors": [
    6.     {
    7.       "match": {
    8.           "service": "backend"
    9.       }
    10.     }
    11.   ],
    12.   "conf": {
    13.     "imports": [
    14.       "default-proxy"
    15.     ],
    16.     "resources": [
    17.       {
    18.         "name": "raw-name",
    19.         "version": "raw-version",
    20.         "resource": "'@type': type.googleapis.com/envoy.api.v2.Cluster\nconnectTimeout: 5s\nloadAssignment:\n  clusterName: localhost:8443\n  endpoints:\n    - lbEndpoints:\n        - endpoint:\n            address:\n              socketAddress:\n                address: 127.0.0.1\n                portValue: 8443\nname: localhost:8443\ntype: STATIC\n"
    21.       }
    22.     ]
    23.   }
    24. }

    List Proxy Templates

    Request: GET /meshes/{mesh}/proxytemplates

    Response: 200 OK with body of Proxy Template entities

    Example:

    1. curl http://localhost:5681/meshes/mesh-1/proxytemplates
    1. {
    2.  "items": [
    3.   {
    4.    "conf": {
    5.     "imports": [
    6.      "default-proxy"
    7.     ],
    8.     "resources": [
    9.      {
    10.       "name": "raw-name",
    11.       "version": "raw-version",
    12.      }
    13.     ]
    14.    },
    15.    "mesh": "mesh-1",
    16.    "name": "pt-1",
    17.    "selectors": [
    18.     {
    19.      "match": {
    20.       "service": "backend"
    21.      }
    22.     }
    23.    ],
    24.    "type": "ProxyTemplate"
    25.   }
    26.  ]
    27. }

    Delete Proxy Template

    Request: DELETE /meshes/{mesh}/proxytemplates/{name}

    Response: 200 OK

    Example:

    1. curl -XDELETE http://localhost:5681/meshes/mesh-1/proxytemplates/pt-1

    Get Traffic Permission

    Request: GET /meshes/{mesh}/traffic-permissions/{name}

    Response: 200 OK with Traffic Permission entity

    Example:

    1. curl http://localhost:5681/meshes/mesh-1/traffic-permissions/tp-1
    1. {
    2.  "destinations": [
    3.   {
    5.     "service": "redis"
    6.    }
    7.   }
    8.  ],
    9.  "mesh": "mesh-1",
    10.  "name": "tp-1",
    11.  "sources": [
    12.   {
    13.    "match": {
    14.     "service": "backend"
    15.    }
    16.   }
    17.  ],
    18.  "type": "TrafficPermission"
    19. }

    Create/Update Traffic Permission

    Request: PUT /meshes/{mesh}/trafficpermissions/{name} with Traffic Permission entity in body

    Response: 201 Created when the resource is created and 200 OK when it is updated

    Example:

    1. curl -XPUT http://localhost:5681/meshes/mesh-1/traffic-permissions/tp-1 --data @trafficpermission.json -H'content-type: application/json'
    1. {
    2.   "type": "TrafficPermission",
    3.   "name": "tp-1",
    4.   "mesh": "mesh-1",
    5.   "sources": [
    6.     {
    7.       "match": {
    8.         "service": "backend"
    9.       }
    10.     }
    11.   ],
    12.   "destinations": [
    13.     {
    14.       "match": {
    15.         "service": "redis"
    16.       }
    17.     }
    18.   ]
    19. }

    List Traffic Permissions

    Request: GET /meshes/{mesh}/traffic-permissions

    Response: 200 OK with body of Traffic Permission entities

    Example:

    1. curl http://localhost:5681/meshes/mesh-1/traffic-permissions
    1. {
    2.  "items": [
    3.   {
    4.    "destinations": [
    5.     {
    6.      "match": {
    7.       "service": "redis"
    8.      }
    9.     }
    10.    ],
    11.    "mesh": "mesh-1",
    12.    "name": "tp-1",
    13.    "sources": [
    14.     {
    15.      "match": {
    16.       "service": "backend"
    17.      }
    18.     }
    19.    ],
    20.    "type": "TrafficPermission"
    21.   }
    22.  ]
    23. }

    Request: DELETE /meshes/{mesh}/traffic-permissions/{name}

    Response: 200 OK

    Traffic Log

    Get Traffic Log

    Request: GET /meshes/{mesh}/traffic-logs/{name}

    Response: 200 OK with Traffic Log entity

    Example:

    1. curl http://localhost:5681/meshes/mesh-1/traffic-logs/tl-1
    1. {
    2.  "conf": {
    3.   "backend": "file"
    4.  },
    5.  "destinations": [
    6.   {
    7.    "match": {
    8.     "service": "backend"
    9.    }
    10.   }
    11.  ],
    12.  "mesh": "mesh-1",
    13.  "name": "tl-1",
    14.  "sources": [
    15.   {
    16.    "match": {
    17.     "service": "web",
    18.     "version": "1.0"
    19.    }
    20.   }
    21.  ],
    22.  "type": "TrafficLog"
    23. }

    Create/Update Traffic Log

    Request: PUT /meshes/{mesh}/traffic-logs/{name} with Traffic Log entity in body

    Response: 201 Created when the resource is created and 200 OK when it is updated

    Example:

    1. curl -XPUT http://localhost:5681/meshes/mesh-1/traffic-logs/tl-1 --data @trafficlog.json -H'content-type: application/json'
    1. {
    2.   "type": "TrafficLog",
    3.   "mesh": "mesh-1",
    4.   "name": "tl-1",
    5.   "sources": [
    6.     {
    7.       "match": {
    8.         "service": "web",
    9.         "version": "1.0"
    10.       }
    11.     }
    12.   ],
    13.   "destinations": [
    14.     {
    15.       "match": {
    16.         "service": "backend"
    17.       }
    18.     }
    19.   ],
    20.   "conf": {
    21.     "backend": "file"
    22.   }
    23. }

    List Traffic Logs

    Request: GET /meshes/{mesh}/traffic-logs

    Response: 200 OK with body of Traffic Log entities

    Example:

    1. curl http://localhost:5681/meshes/mesh-1/traffic-logs
    1. {
    2.  "items": [
    3.   {
    4.    "conf": {
    5.     "backend": "file"
    6.    },
    7.    "destinations": [
    8.     {
    9.      "match": {
    10.       "service": "backend"
    11.      }
    12.     }
    13.    ],
    14.    "mesh": "mesh-1",
    15.    "name": "tl-1",
    16.    "sources": [
    17.     {
    18.      "match": {
    19.       "service": "web",
    20.       "version": "1.0"
    21.      }
    22.     }
    23.    ],
    24.    "type": "TrafficLog"
    25.   }
    26.  ]
    27. }

    Delete Traffic Log

    Request: DELETE /meshes/{mesh}/traffic-logs/{name}

    Response: 200 OK

    Example:

    1. curl -XDELETE http://localhost:5681/meshes/mesh-1/traffic-logs/tl-1

    Traffic Route

    Get Traffic Route

    Request: GET /meshes/{mesh}/traffic-routes/{name}

    Response: 200 OK with Traffic Route entity

    Example:

    1. curl http://localhost:5681/meshes/mesh-1/traffic-routes/web-to-backend
    1. {
    2.  "conf": [
    3.   {
    4.    "weight": 90,
    5.    "destination": {
    6.     "region": "us-east-1",
    7.     "service": "backend",
    8.     "version": "v2"
    9.    }
    10.   },
    11.   {
    12.    "weight": 10,
    13.    "destination": {
    14.     "service": "backend",
    15.     "version": "v3"
    16.    }
    17.   }
    18.  ],
    19.  "destinations": [
    20.   {
    21.    "match": {
    22.     "service": "backend"
    23.    }
    24.   }
    25.  ],
    26.  "mesh": "mesh-1",
    27.  "name": "web-to-backend",
    28.  "sources": [
    29.   {
    30.    "match": {
    31.     "region": "us-east-1",
    32.     "service": "web",
    33.     "version": "v10"
    34.    }
    35.   }
    36.  ],
    37.  "type": "TrafficRoute"
    38. }

    Create/Update Traffic Route

    Request: PUT /meshes/{mesh}/traffic-routes/{name} with Traffic Route entity in body

    Response: 201 Created when the resource is created and 200 OK when it is updated

    Example:

    1. curl -XPUT http://localhost:5681/meshes/mesh-1/traffic-routes/web-to-backend --data @trafficroute.json -H'content-type: application/json'
    1. {
    2.  "type": "TrafficRoute",
    3.  "name": "web-to-backend",
    4.  "mesh": "mesh-1",
    5.  "sources": [
    6.   {
    7.    "match": {
    8.     "region": "us-east-1",
    9.     "service": "web",
    10.     "version": "v10"
    11.    }
    12.   }
    13.  ],
    14.  "destinations": [
    15.   {
    16.    "match": {
    17.     "service": "backend"
    18.    }
    19.   }
    20.  ],
    21.  "conf": [
    22.   {
    23.    "weight": 90,
    24.    "destination": {
    25.     "region": "us-east-1",
    26.     "service": "backend",
    27.     "version": "v2"
    28.    }
    29.   },
    30.   {
    31.    "weight": 10,
    32.    "destination": {
    33.     "service": "backend",
    34.     "version": "v3"
    35.    }
    36.   }
    37.  ]
    38. }

    List Traffic Routes

    Request: GET /meshes/{mesh}/traffic-routes

    Response: 200 OK with body of Traffic Route entities

    Example:

    1. curl http://localhost:5681/meshes/mesh-1/traffic-routes
    1. {
    2.  "items": [
    3.   {
    4.    "conf": [
    5.     {
    6.      "weight": 90,
    7.      "destination": {
    8.       "region": "us-east-1",
    9.       "service": "backend",
    10.       "version": "v2"
    11.      }
    12.     },
    13.     {
    14.      "weight": 10,
    15.      "destination": {
    16.       "service": "backend",
    17.       "version": "v3"
    18.      }
    19.     }
    20.    ],
    21.    "destinations": [
    22.     {
    23.      "match": {
    24.       "service": "backend"
    25.      }
    26.     }
    27.    ],
    28.    "mesh": "mesh-1",
    29.    "name": "web-to-backend",
    30.    "sources": [
    31.     {
    32.      "match": {
    33.       "region": "us-east-1",
    34.       "service": "web",
    35.       "version": "v10"
    36.      }
    37.     }
    38.    ],
    39.    "type": "TrafficRoute"
    40.   }
    41.  ]
    42. }

    Delete Traffic Route

    Request: DELETE /meshes/{mesh}/traffic-routes/{name}

    Response: 200 OK

    Example:

    1. curl -XDELETE http://localhost:5681/meshes/mesh-1/traffic-routes/web-to-backend

    Get Traffic Trace

    Request: GET /meshes/{mesh}/traffic-traces/{name}

    Response: 200 OK with Traffic Trace entity

    Example:

    1. curl http://localhost:5681/meshes/mesh-1/traffic-traces/tt-1
    1. {
    2.  "type": "TrafficTrace",
    3.  "mesh": "mesh-1",
    4.  "name": "tt-1",
    5.  "conf": {
    6.   "backend": "my-zipkin"
    7.  },
    8.  "selectors": [
    9.   {
    10.    "match": {
    11.     "service": "*"
    12.    }
    13.   }
    14.  ]
    15. }

    Create/Update Traffic Trace

    Request: PUT /meshes/{mesh}/traffic-traces/{name} with Traffic Trace entity in body

    Response: 201 Created when the resource is created and 200 OK when it is updated

    Example:

    1. curl -XPUT http://localhost:5681/meshes/mesh-1/traffic-traces/tt-1 --data @traffictrace.json -H'content-type: application/json'
    1. {
    2.  "type": "TrafficTrace",
    3.  "mesh": "mesh-1",
    4.  "name": "tt-1",
    5.  "conf": {
    6.   "backend": "my-zipkin"
    7.  },
    8.  "selectors": [
    9.   {
    10.    "match": {
    11.     "service": "*"
    12.    }
    13.   }
    14.  ]
    15. }

    Request: GET /meshes/{mesh}/traffic-traces

    Response: 200 OK with body of Traffic Trace entities

    Example:

      Delete Traffic Trace

      Request: DELETE /meshes/{mesh}/traffic-traces/{name}

      Response: 200 OK

      The kumactl CLI under the hood makes HTTP requests to this API.