文档首页 > > API参考> API说明> 终端节点服务功能> 创建终端节点服务

创建终端节点服务

分享
更新时间: 2019/09/11 10:22

功能介绍

创建终端节点服务,允许其他用户创建终端节点连接您创建的终端节点服务,使用您所提供的服务。

说明:

该接口为异步接口,调用成功会返回200状态码,说明请求已正常下发。通常创建终端节点服务需要1~2分钟,可以通过查询终端节点服务详情查看创建结果。

URI

POST /v1/{project_id}/vpc-endpoint-services

参数说明如 表1所示。
表1 参数说明

参数

是否必选

描述

project_id

项目ID,获取方法请参见获取项目ID

请求消息

  • 参数说明
    表2 请求参数

    名称

    是否必选

    参数类型

    描述

    port_id

    String

    标识终端节点服务后端资源的ID,格式为通用唯一识别码(Universally Unique Identifier,下文简称UUID)。

    取值为:

    • LB类型:增强型负载均衡器内网IP对应的端口ID。详细内容请参考《弹性负载均衡API参考》中的“查询负载均衡详情”,详见响应消息中的“vip_port_id”字段。
    • VM类型:弹性云服务器IP地址对应的网卡ID。详细内容请参考《弹性云服务器API参考》中的“云服务器网卡配置虚拟IP地址”,详见响应消息中的“port_id”字段。
    • VIP类型:虚拟资源所在物理服务器对应的网卡ID。
    说明:
    • 创建终端节点服务时,VPC的子网网段不能与198.19.128.0/20重叠。
    • VPC路由表中自定义路由的目的地址不能与198.19.128.0/20重叠

    vip_port_id

    String

    虚拟IP的网卡ID。

    vpc_id

    String

    终端节点服务对应后端资源所在的VPC的ID。详细内容请参考《虚拟私有云API参考》中的“查询VPC”,详见响应消息中的“id”字段。

    approval_enabled

    Boolean

    是否需要审批。

    • false:不需要审批,创建的终端节点连接直接为accepted状态。
    • true:需要审批,创建的终端节点连接为pendingAcceptance状态,需要终端节点服务所属用户审核后方可使用。

    默认为true,需要审批。

    service_type

    String

    终端节点服务类型。仅支持将用户私有服务创建为interface类型的终端节点服务。

    终端节点服务类型包括“网关(gataway)型”和“接口(interface)型”:
    • gataway:由运维人员配置。用户无需创建,可直接使用。
    • interface:包括运维人员配置的云服务和用户自己创建的私有服务。其中,运维人员配置的云服务无需创建,用户可直接使用。

    您可以通过查询公共终端节点服务列表查看由运维人员配置的,所有用户可见且可连接的终端节点服务。

    server_type

    String

    资源类型。

    • VM:云服务器,适用于作为服务器使用。
    • VIP:虚拟IP,适用于作为虚拟资源的物理服务器使用。
    • LB:增强型负载均衡,适用于高访问量业务和对可靠性和容灾性要求较高的业务。

    ports

    Array of objects

    服务开放的端口映射列表,详细内容请参见表3

    同一个终端节点服务下,不允许重复的端口映射。若多个终端节点服务共用一个port_id,则终端节点服务之间的所有端口映射的server_port和protocol的组合不能重复,单次最多添加200个。

    表3 Port要素说明

    属性

    是否必选

    参数类型

    描述

    client_port

    Integer

    终端节点访问的端口。

    终端节点提供给用户,作为访问终端节点服务的端口,范围1-65535。。

    server_port

    Integer

    终端节点服务的端口。

    终端节点服务绑定了后端资源,作为提供服务的端口,范围1-65535。

    protocol

    String

    端口映射协议,支持TCP/UDP,默认为TCP。

  • 请求样例
    POST https://{endpoint}/v1/{project_id}/vpc-endpoint-services
    {
       "port_id":"4189d3c2-8882-4871-a3c2-d380272eed88",
       "vpc_id":"4189d3c2-8882-4871-a3c2-d380272eed80",
       "approval_enabled":false,
       "service_type":"interface",
       "server_type":"VM",
       "ports":
      [
        {
          "client_port":"8080",
          "server_port":"80",
          "protocol":"TCP"
        },
        {
          "client_port":"8081",
          "server_port":"80",
          "protocol":"TCP"
        }
      ]
    }

响应消息

  • 参数说明
    表4 响应参数

    参数

    参数类型

    描述

    id

    String

    终端节点服务的ID,唯一标识。

    port_id

    String

    标识终端节点服务后端资源的ID,格式为通用唯一识别码(Universally Unique Identifier,下文简称UUID)。取值为:

    • LB类型:增强型负载均衡器内网IP对应的端口ID。
    • VM类型:弹性云服务器IP地址对应的网卡ID。
    • VIP类型:虚拟资源所在物理服务器对应的网卡ID。

    vip_port_id

    String

    虚拟IP的网卡ID。

    service_name

    String

    终端节点服务的名称。

    service_type

    String

    终端节点服务类型。

    终端节点服务类型包括“网关(gataway)型”和“接口(interface)型”:
    • gataway:由运维人员配置。用户无需创建,可直接使用。
    • interface:包括运维人员配置的云服务和用户自己创建的私有服务。其中,运维人员配置的云服务无需创建,用户可直接使用。

    您可以通过查询公共终端节点服务列表查看由运维人员配置的,所有用户可见且可连接的终端节点服务。

    server_type

    String

    资源类型。

    • VM:云服务器。
    • VIP:虚拟IP。
    • LB:增强负载均衡型。

    vpc_id

    String

    终端节点服务对应后端资源所在的VPC的ID。

    approval_enabled

    Boolean

    是否需要审批。

    • false:不需要审批,创建的终端节点连接直接为accepted状态。
    • true:需要审批,创建的终端节点连接为pendingAcceptance状态,需要终端节点服务所属用户审核后方可使用。

    status

    String

    终端节点服务的状态。

    • creating:创建中
    • available:可连接
    • failed:失败

    created_at

    String

    终端节点服务的创建时间。

    采用UTC时间格式,格式为:YYYY-MM-DDTHH:MM:SSZ

    updated_at

    String

    终端节点服务的更新时间。

    采用UTC时间格式,格式为:YYYY-MM-DDTHH:MM:SSZ

    project_id

    String

    项目ID,获取方法请参见获取项目ID

    ports

    Array of objects

    服务开放的端口映射列表,详细内容请参见表5

    同一个终端节点服务下,不允许重复的端口映射。若多个终端节点服务共用一个port_id,则终端节点服务之间的所有端口映射的server_port和protocol的组合不能重复。

    表5 Port要素说明

    属性

    参数类型

    描述

    client_port

    Integer

    终端节点访问的端口。

    终端节点提供给用户,作为访问终端节点服务的端口,范围1-65535。。

    server_port

    Integer

    终端节点服务的端口。

    终端节点服务绑定了后端资源,作为提供服务的端口,范围1-65535。

    protocol

    String

    端口映射协议,支持TCP/UDP,默认为TCP。

  • 响应样例
    {
        "id":"4189d3c2-8882-4871-a3c2-d380272eed83",
        "marker_id":"4478426387921896789412",
        "port_id":"4189d3c2-8882-4871-a3c2-d380272eed88",
        "vpc_id":"4189d3c2-8882-4871-a3c2-d380272eed80`",
        "status":"available",
        "approval_enabled":false,
        "service_name":"test123",
        "service_type":"interface",
        "server_type":"VM",
        "project_id":"6e9dfd51d1124e8d8498dce894923a0d",
        "created_at":"2018-01-30T07:42:01.174",
        "ports":
                  [
                    {
                        "client_port":"8080",
                        "server_port":"80",
                        "protocol":"TCP"
                    },
                    {
                        "client_port":"8081",
                        "server_port":"80",
                        "protocol":"TCP"
                    }
                  ]
    }

状态码

状态码请参见状态码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区