文档首页/事件网格 EG/API参考/API/访问端点管理/创建访问端点 - CreateEndpoint
更新时间：2025-12-18 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建访问端点 - CreateEndpoint

功能介绍

创建访问端点。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v1/{project_id}/endpoints

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户资源空间ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

表3 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

endpoint名称，租户下唯一，由字母、数字、点、下划线和中划线组成，必须以字母或数字开头

vpc_id

是

String

访问端点所在的VPC的ID

subnet_id

是

String

访问端点所在的子网的ID

description

否

String

描述

响应参数

状态码：200

表4 响应Header参数

参数

参数类型

描述

X-Request-Id

String

This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname.

表5 响应Body参数

参数

参数类型

描述

id

String

访问端点ID

name

String

用户指定的访问端点名称

vpc_id

String

访问端点所在的VPC的ID

subnet_id

String

访问端点所在的子网的ID

domain

String

访问域名

description

String

描述

status

String

访问端点状态：

  • CREATED：已创建

  • CREATING：创建中

  • CREATE_FAILED：创建失败

  • DELETE_FAILED：删除失败

error_info

ErrorInfo object

错误信息

type

String

访问端点类型：

  • PRIVATE：私网访问端点

  • PUBLIC：公网访问端点

scalable

Boolean

是否可更新

created_time

String

创建UTC时间

updated_time

String

更新UTC时间

endpoints

Array of EndpointConnection objects

访问端点终端节点列表

表6 ErrorInfo

参数

参数类型

描述

error_code

String

错误码

error_detail

String

错误详情

error_msg

String

错误信息

表7 EndpointConnection

参数

参数类型

描述

endpoint_service_id

String

访问端点的服务ID

endpoint_service_name

String

访问端点的服务名称

marker_id

String

访问端点的终端节点的报文ID

id

String

访问端点的终端节点ID

ip

String

访问端点的终端节点IP

created_time

String

访问端点的终端节点创建时间

请求示例

创建访问端点

GET https://{eg_endpoint}/v1/{project_id}/endpoints

{
  "name" : "endpoint",
  "vpc_id" : "68bfbcc1-dff2-47e4-a9d4-332b9bc1b8de",
  "subnet_id" : "84758cf5-9c62-43ae-a778-3dbd8370c0a4",
  "description" : "string"
}

响应示例

状态码：200

成功

{
  "id" : "23709d68-54d5-423b-a6be-03302e893152",
  "name" : "endpoint",
  "vpc_id" : "68bfbcc1-dff2-47e4-a9d4-332b9bc1b8de",
  "subnet_id" : "84758cf5-9c62-43ae-a778-3dbd8370c0a4",
  "domain" : "events.cn-north-4.myhuaweicloud.com",
  "description" : "访问端点",
  "status" : "CREATED",
  "error_info" : { },
  "type" : "PRIVATE",
  "scalable" : false,
  "created_time" : "2021-12-09 09:00:00",
  "updated_time" : "2021-12-09 09:00:00",
  "endpoints" : [ { } ]
}

状态码

状态码

描述

200

成功

错误码

请参见错误码。

父主题：访问端点管理