• 路由
    • 创建路由
    • 更新路由
    • 获取路由
    • 获取路由列表
    • 删除路由
  • 错误

    路由

    https://flynn.io/schema/router/route#

    属性 类型 描述
    id uuid string 唯一标示
    parent_ref uuid string 唯一标示
    type string http tcp
    service uuid string 唯一标示
    domain string 路由域名。仅适用于 HTTP 路由。
    tls_cert string 路由可选的 TLS 证书。仅用于 HTTP 路由。
    tls_key string 路由可选的 TLS 私钥。仅用于 HTTP 路由。
    path string 路由到这个服务的可选路径。仅用于 HTTP 路由,且不与 TLS 选项公用
    sticky boolean 路由是否使用粘性会话。仅用于 HTTP 路由。
    port integer TCP 端口上监听 TCP 路由。
    created_at date-time string 对象创建的时间戳
    updated_at date-time string 对象最新更新的时间戳

    创建路由

    实例:—————————————————请求—————————————————

    1. POST /routes HTTP/1.1
    2. Content-Type: application/json
    1. {
    2. "type": "http",
    3. "service": "foo-web",
    4. "created_at": "0001-01-01T00:00:00Z",
    5. "updated_at": "0001-01-01T00:00:00Z",
    6. "domain": "http://example.com"
    7. }

    —————————————————响应—————————————————

    1. Content-Type: application/json; charset=UTF-8
    1. {
    2. "type": "http",
    3. "id": "e8080915-1d48-4374-ac4f-c54a88bdd210",
    4. "service": "foo-web",
    5. "created_at": "2015-02-16T21:19:04.116018Z",
    6. "updated_at": "2015-02-16T21:19:04.116018Z",
    7. "domain": "http://example.com"
    8. }

    更新路由

    实例:—————————————————请求—————————————————

    1. PUT /routes/http/e8080915-1d48-4374-ac4f-c54a88bdd210 HTTP/1.1
    2. Content-Type: application/json
    1. {
    2. "type": "http",
    3. "id": "e8080915-1d48-4374-ac4f-c54a88bdd210",
    4. "service": "bar-web",
    5. "created_at": "0001-01-01T00:00:00Z",
    6. "updated_at": "0001-01-01T00:00:00Z",
    7. "domain": "http://example.com"
    8. }

    —————————————————响应—————————————————

    1. Content-Type: application/json; charset=UTF-8
    1. {
    2. "type": "http",
    3. "id": "e8080915-1d48-4374-ac4f-c54a88bdd210",
    4. "service": "bar-web",
    5. "created_at": "2015-02-16T21:19:04.116018Z",
    6. "updated_at": "2015-02-16T21:19:04.11883Z",
    7. "domain": "http://example.com"
    8. }

    获取路由

    实例:—————————————————请求—————————————————

    1. GET /routes/http/e8080915-1d48-4374-ac4f-c54a88bdd210 HTTP/1.1
    2. Content-Type: application/json

    —————————————————响应—————————————————

    1. Content-Type: application/json; charset=UTF-8
    1. {
    2. "type": "http",
    3. "id": "e8080915-1d48-4374-ac4f-c54a88bdd210",
    4. "service": "bar-web",
    5. "created_at": "2015-02-16T21:19:04.116018Z",
    6. "updated_at": "2015-02-16T21:19:04.11883Z",
    7. "domain": "http://example.com"
    8. }

    获取路由列表

    实例:—————————————————请求—————————————————

    1. GET /routes HTTP/1.1
    2. Content-Type: application/json

    —————————————————响应—————————————————

    1. Content-Type: application/json; charset=UTF-8
    1. [
    2. {
    3. "type": "http",
    4. "id": "e8080915-1d48-4374-ac4f-c54a88bdd210",
    5. "service": "bar-web",
    6. "created_at": "2015-02-16T21:19:04.116018Z",
    7. "updated_at": "2015-02-16T21:19:04.11883Z",
    8. "domain": "http://example.com"
    9. },
    10. {
    11. "type": "http",
    12. "id": "6391ee42-7db1-4387-95da-75cfee2e80e1",
    13. "parent_ref": "controller/apps/61c01ac5e89140d39410395cdfcf38fa",
    14. "service": "dashboard-web",
    15. "created_at": "2015-02-16T21:19:02.094033Z",
    16. "updated_at": "2015-02-16T21:19:02.094033Z",
    17. "domain": "dashboard.dev.localflynn.com",
    18. "tls_cert": "-----BEGIN CERTIFICATE-----\nMIIDOjCCAiSgAwIBAgIQLcnOaDV3iECxwsxhMPbvSTALBgkqhkiG9w0BAQswHTEO\nMAwGA1UEChMFRmx5bm4xCzAJBgNVBAsTAkNBMB4XDTE1MDIxNjIxMTkwMVoXDTIw\nMDIxNTIxMTkwMVowLTEOMAwGA1UEChMFRmx5bm4xGzAZBgNVBAMTEmRldi5sb2Nh\nbGZseW5uLmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMZc97RD\nC66GKEpKRmtCazziQl+M4M8P0OfWyN73IANpCiu6pbgdXuCVsQFjC/kLuWwINxp9\ntvXvjWk5UYyU5EX0ZMUu6uaN7DQ8tIUPV89lpFx1bIbH+vtx/KvhUtUc0eNT0leG\n2Jd6PgO468oFYAT8I+QPe3ngpbNvLWofZe59nOTYWvxBfHoE2kacFUCaTYC9fgjq\nnh6Pn9xcBM3pIJQ4m9kLjW6EPGQrEnFd/ryLo6a8UGh+OdGh/3LuTZBkch5zetbu\na5bL3MX0WEkDoRdRXOI7+nh8d0LIcvaZqD4kiN2YMmtU87J0N47pHu4YyoArwILA\nTrKN7+gjX8EvWwkCAwEAAaNqMGgwDgYDVR0PAQH/BAQDAgCgMBMGA1UdJQQMMAoG\nCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwMwYDVR0RBCwwKoISZGV2LmxvY2FsZmx5\nbm4uY29tghQqLmRldi5sb2NhbGZseW5uLmNvbTALBgkqhkiG9w0BAQsDggEBACtZ\ndCxpaBJXHlRHz8co8LReHeyCez1GKlqD1bCD1qYxToEZPuWmi39xTtdCG2ZOA7SO\nhVZbG4vT4Ra5ANXWtoYco71UZeNn/viJXfF5FxKH8u1rNAsTH8uLdi4PO4Shy4/d\n2DBueWG1E4BB6LKRfkxSxqEaFeLuV8Z+IEfPaibvEG8G2cvMtK9frCjSSn+iPDtC\neSWnOvgoWmI8GEj9tdFpxwVjDuzK1wcjxkOprjigMV1Oh19D4u+rnjsZKzFNpgfK\nI768GFsL0eA42rDjyN6Q20oZ++4AJPCN7dHBszRZM1G5bfQE9e6C5JIYgbMEBDLJ\nbNGj5eq9CKY9WAVz6bw=\n-----END CERTIFICATE-----\n",
    19. "tls_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEpAIBAAKCAQEAxlz3tEMLroYoSkpGa0JrPOJCX4zgzw/Q59bI3vcgA2kKK7ql\nuB1e4JWxAWML+Qu5bAg3Gn229e+NaTlRjJTkRfRkxS7q5o3sNDy0hQ9Xz2WkXHVs\nhsf6+3H8q+FS1RzR41PSV4bYl3o+A7jrygVgBPwj5A97eeCls28tah9l7n2c5Nha\n/EF8egTaRpwVQJpNgL1+COqeHo+f3FwEzekglDib2QuNboQ8ZCsScV3+vIujprxQ\naH450aH/cu5NkGRyHnN61u5rlsvcxfRYSQOhF1Fc4jv6eHx3Qshy9pmoPiSI3Zgy\na1TzsnQ3juke7hjKgCvAgsBOso3v6CNfwS9bCQIDAQABAoIBAEvPhh/Pq+xEe6uA\n3Y7qsH9xXbqU5epc+hNRBC4qtoJ3J5r015cZKoSc0SxdhVrmPzRpo12thDpUFnCL\npn4a/W866zRtLPt2bDq+pKNh7MZn6zwm6JZOYb6tnsq17+lg/VprU6197NNftcnI\nZ90q1rqw/qqPvDolQE7mg63WWCegD724BhVRBo8FUmcrn91uqt2plfCMnnzZPTbL\nB2Hk575ww+vjAysdihavJAeWtAVO7BpAFcQoDXjbFZXUxWaZbFd1r15PE55uJ/uh\nx0VdQ9GMGahF+yRyOqaKRnovEp0twKje0BgGFNwloU90VBL2HipuWvK0tM+pImCf\nX5rHcF0CgYEA09wbQZe7EIt2uWSyM5P0aMtrReWXHtSJaXUU5u4e1cF/J9KeeZfS\nMNXzIAcsJdZfF2jCyrQs5s+gE5d7yRWHl3L+qng18/yiLX9JXSVGtxiLIFdrFpqd\nGrgxMwyf8eGAUdFJnBE1nu4CKytVFTksMdHz0lZTDge1xyQ8zCvyqrMCgYEA77D+\n4dbX7GV8R1P6Lu7IAeACPuccHEPyGO0lrCiUZtrvzbyKa7nTI1ELeBCHzty4akGX\nR6lnWpUW0X0LZcsZAQzMfVYezwPwpgIJqtf529TEjEfvUsc9aYOPRvtoDtnSZ4dz\nz9ChbsRG5tt+Abipva80XqHYv+G4ZyKMNlOzcVMCgYB8/PX3lJSABkdcyNN5Kmif\nCqOW8QRe4/TNio1yUDlQ0n8590AXbEJNHWv6EUEycW5YWS3SeMmkwgkmhdA5qcH8\nz5L+7zylXP4w6U9W7I7zpj8uLWS4SS82fERKYcBa6zbRDi/nKx//S1tsLHxdsQUp\nvzuhc9w8AsBzZCWaLrNTkQKBgQC6hGry5rJDnH1nK+wFVX6CJwTYWhM/04ey6edk\n3ncMytXMrSixx3qLgud/2K01xgAjf0LvWt24WUfWYI3b+n1Mmd8OsVNsGE7Nf8xy\nC3q9HAaOevO64JvjXaLCw6Qn2kymj3sJffoBLe9WefrF8CL2Hj6MXTlDp6xNZU7i\nf6OlTQKBgQCYa/mTIT4NZuyoQitUIl8GyqeR3GHyaSfxCaPlynUG3iHdlr2NOfL1\nGlx5tGwcawJ1DUe/eKzA3Cj7IM+UcDTdIJM2t3dbQOPh/qEPY54NKTh5yHZ+qeuO\nrpSlpImSAUx46q7rnnm8KlEYKg6xVEwACHJFk55WxilDmee+/ZACag==\n-----END RSA PRIVATE KEY-----\n"
    20. },
    21. {
    22. "type": "http",
    23. "id": "4cf50c90-4f33-43a6-af4b-f1695fd17ee4",
    24. "parent_ref": "controller/apps/0fa0d7a91e634d58be2a758e9e109ee8",
    25. "service": "flynn-controller",
    26. "created_at": "2015-02-16T21:19:01.537271Z",
    27. "updated_at": "2015-02-16T21:19:01.537271Z",
    28. "domain": "controller.dev.localflynn.com",
    29. "tls_cert": "-----BEGIN CERTIFICATE-----\nMIIDOjCCAiSgAwIBAgIQLcnOaDV3iECxwsxhMPbvSTALBgkqhkiG9w0BAQswHTEO\nMAwGA1UEChMFRmx5bm4xCzAJBgNVBAsTAkNBMB4XDTE1MDIxNjIxMTkwMVoXDTIw\nMDIxNTIxMTkwMVowLTEOMAwGA1UEChMFRmx5bm4xGzAZBgNVBAMTEmRldi5sb2Nh\nbGZseW5uLmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMZc97RD\nC66GKEpKRmtCazziQl+M4M8P0OfWyN73IANpCiu6pbgdXuCVsQFjC/kLuWwINxp9\ntvXvjWk5UYyU5EX0ZMUu6uaN7DQ8tIUPV89lpFx1bIbH+vtx/KvhUtUc0eNT0leG\n2Jd6PgO468oFYAT8I+QPe3ngpbNvLWofZe59nOTYWvxBfHoE2kacFUCaTYC9fgjq\nnh6Pn9xcBM3pIJQ4m9kLjW6EPGQrEnFd/ryLo6a8UGh+OdGh/3LuTZBkch5zetbu\na5bL3MX0WEkDoRdRXOI7+nh8d0LIcvaZqD4kiN2YMmtU87J0N47pHu4YyoArwILA\nTrKN7+gjX8EvWwkCAwEAAaNqMGgwDgYDVR0PAQH/BAQDAgCgMBMGA1UdJQQMMAoG\nCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwMwYDVR0RBCwwKoISZGV2LmxvY2FsZmx5\nbm4uY29tghQqLmRldi5sb2NhbGZseW5uLmNvbTALBgkqhkiG9w0BAQsDggEBACtZ\ndCxpaBJXHlRHz8co8LReHeyCez1GKlqD1bCD1qYxToEZPuWmi39xTtdCG2ZOA7SO\nhVZbG4vT4Ra5ANXWtoYco71UZeNn/viJXfF5FxKH8u1rNAsTH8uLdi4PO4Shy4/d\n2DBueWG1E4BB6LKRfkxSxqEaFeLuV8Z+IEfPaibvEG8G2cvMtK9frCjSSn+iPDtC\neSWnOvgoWmI8GEj9tdFpxwVjDuzK1wcjxkOprjigMV1Oh19D4u+rnjsZKzFNpgfK\nI768GFsL0eA42rDjyN6Q20oZ++4AJPCN7dHBszRZM1G5bfQE9e6C5JIYgbMEBDLJ\nbNGj5eq9CKY9WAVz6bw=\n-----END CERTIFICATE-----\n",
    30. "tls_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEpAIBAAKCAQEAxlz3tEMLroYoSkpGa0JrPOJCX4zgzw/Q59bI3vcgA2kKK7ql\nuB1e4JWxAWML+Qu5bAg3Gn229e+NaTlRjJTkRfRkxS7q5o3sNDy0hQ9Xz2WkXHVs\nhsf6+3H8q+FS1RzR41PSV4bYl3o+A7jrygVgBPwj5A97eeCls28tah9l7n2c5Nha\n/EF8egTaRpwVQJpNgL1+COqeHo+f3FwEzekglDib2QuNboQ8ZCsScV3+vIujprxQ\naH450aH/cu5NkGRyHnN61u5rlsvcxfRYSQOhF1Fc4jv6eHx3Qshy9pmoPiSI3Zgy\na1TzsnQ3juke7hjKgCvAgsBOso3v6CNfwS9bCQIDAQABAoIBAEvPhh/Pq+xEe6uA\n3Y7qsH9xXbqU5epc+hNRBC4qtoJ3J5r015cZKoSc0SxdhVrmPzRpo12thDpUFnCL\npn4a/W866zRtLPt2bDq+pKNh7MZn6zwm6JZOYb6tnsq17+lg/VprU6197NNftcnI\nZ90q1rqw/qqPvDolQE7mg63WWCegD724BhVRBo8FUmcrn91uqt2plfCMnnzZPTbL\nB2Hk575ww+vjAysdihavJAeWtAVO7BpAFcQoDXjbFZXUxWaZbFd1r15PE55uJ/uh\nx0VdQ9GMGahF+yRyOqaKRnovEp0twKje0BgGFNwloU90VBL2HipuWvK0tM+pImCf\nX5rHcF0CgYEA09wbQZe7EIt2uWSyM5P0aMtrReWXHtSJaXUU5u4e1cF/J9KeeZfS\nMNXzIAcsJdZfF2jCyrQs5s+gE5d7yRWHl3L+qng18/yiLX9JXSVGtxiLIFdrFpqd\nGrgxMwyf8eGAUdFJnBE1nu4CKytVFTksMdHz0lZTDge1xyQ8zCvyqrMCgYEA77D+\n4dbX7GV8R1P6Lu7IAeACPuccHEPyGO0lrCiUZtrvzbyKa7nTI1ELeBCHzty4akGX\nR6lnWpUW0X0LZcsZAQzMfVYezwPwpgIJqtf529TEjEfvUsc9aYOPRvtoDtnSZ4dz\nz9ChbsRG5tt+Abipva80XqHYv+G4ZyKMNlOzcVMCgYB8/PX3lJSABkdcyNN5Kmif\nCqOW8QRe4/TNio1yUDlQ0n8590AXbEJNHWv6EUEycW5YWS3SeMmkwgkmhdA5qcH8\nz5L+7zylXP4w6U9W7I7zpj8uLWS4SS82fERKYcBa6zbRDi/nKx//S1tsLHxdsQUp\nvzuhc9w8AsBzZCWaLrNTkQKBgQC6hGry5rJDnH1nK+wFVX6CJwTYWhM/04ey6edk\n3ncMytXMrSixx3qLgud/2K01xgAjf0LvWt24WUfWYI3b+n1Mmd8OsVNsGE7Nf8xy\nC3q9HAaOevO64JvjXaLCw6Qn2kymj3sJffoBLe9WefrF8CL2Hj6MXTlDp6xNZU7i\nf6OlTQKBgQCYa/mTIT4NZuyoQitUIl8GyqeR3GHyaSfxCaPlynUG3iHdlr2NOfL1\nGlx5tGwcawJ1DUe/eKzA3Cj7IM+UcDTdIJM2t3dbQOPh/qEPY54NKTh5yHZ+qeuO\nrpSlpImSAUx46q7rnnm8KlEYKg6xVEwACHJFk55WxilDmee+/ZACag==\n-----END RSA PRIVATE KEY-----\n"
    31. },
    32. {
    33. "type": "tcp",
    34. "id": "733348c4-f2e0-490f-bd90-67c9551aa3a6",
    35. "parent_ref": "controller/apps/a1f78fa3a47243cea6a0b4a4e0b40beb",
    36. "service": "gitreceive",
    37. "created_at": "2015-02-16T21:19:01.521562Z",
    38. "updated_at": "2015-02-16T21:19:01.521562Z",
    39. "port": 2222
    40. }
    41. ]

    删除路由

    实例:—————————————————请求—————————————————

    1. DELETE /routes/http/e8080915-1d48-4374-ac4f-c54a88bdd210 HTTP/1.1
    2. Content-Type: application/json

    —————————————————响应—————————————————

    1. Content-Type: application/json; charset=UTF-8

    错误

    https://flynn.io/schema/router/error#

    属性 类型 描述
    code string 未发现、未发现对象、对象已存在、语法错误、校验错误、未知错误
    message string
    detail object

    原文: http://doc.oschina.net/flynn?t=54126