# 创建端点 - CreateEndpoint
#### 功能介绍
创建一个端点
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IEF/doc?api=CreateEndpoint)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ief/ief_02_1003.html)。
#### URI
POST /v2/{project_id}/routemgr/endpoints
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述   |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID |
#### 请求参数
表2请求Header参数 
| 参数              | 是否必选 | 参数类型   | 描述                                                        |
|:---|:---|:---|:---|
| Content-Type    | 是    | String | 消息体的类型（格式），默认取值为"application/json"。                       |
| X-Auth-Token    | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
| ief-instance-id | 否    | String | 企业版实例ID，专业版实例为空值。                                         |
   
表3请求Body参数 
| 参数       | 是否必选 | 参数类型                                                       | 描述   |
|:---|:---|:---|:---|
| endpoint | 否    | [EndpointObj] object | 端点详情 |
   
 表4EndpointObj 
| 参数              | 是否必选 | 参数类型                 | 描述                                                                                                                                          |
|:---|:---|:---|:---|
| description     | 否    | String               | 端点描述，最大长度255，不允许\^\~#$%\&\*\<\>()\[\]{}'"\\                                                                                                 |
| ief_instance_id | 否    | String               | 企业版实例ID，如果为空则表示是专业版实例。                                                                                                                      |
| name            | 是    | String               | 端点名称，只允许中文字符、英文字符、数字、下划线、中划线，最大长度64 同一个账号中创建的端点名唯一                                                                                          |
| properties      | 是    | Map\<String,String\> | 端点的属性，端点需要对外展示的属性，示例： - dis: - servicebus: - apigw: {"domain_id":"user's domain id"} {"service_port":8080} {"domain_id":"user's domain id"} |
| type            | 是    | String               | 端点类型 枚举值： - dis - servicebus - apigw                                                                                                        |
   
#### 响应参数
**状态码：201**
表5响应Body参数 
| 参数       | 参数类型                                                                | 描述   |
|:---|:---|:---|
| endpoint | [EndpointObjResp] object | 端点详情 |
   
 表6EndpointObjResp 
| 参数              | 参数类型                 | 描述                                                                                                                                          |
|:---|:---|:---|
| created_at      | String               | 创建时间                                                                                                                                        |
| description     | String               | 端点描述，最大长度255，不允许\^\~#$%\&\*\<\>()\[\]{}'"\\                                                                                                 |
| id              | String               | 端点ID                                                                                                                                        |
| ief_instance_id | String               | 企业版实例ID，如果为空则表示是专业版实例。                                                                                                                      |
| is_shared       | Boolean              | 是否共享                                                                                                                                        |
| name            | String               | 端点名称，只允许中文字符、英文字符、数字、下划线、中划线，最大长度64 同一个账号中创建的端点名唯一                                                                                          |
| project_id      | String               | 项目ID                                                                                                                                        |
| properties      | Map\<String,Object\> | 端点的属性，端点需要对外展示的属性，示例： - dis: - servicebus: - apigw: {"domain_id":"user's domain id"} {"service_port":8080} {"domain_id":"user's domain id"} |
| type            | String               | 端点类型。枚举值： - dis - servicebus - apigw                                                                                                        |
| updated_at      | String               | 更新时间                                                                                                                                        |
   
**状态码：400**
表7响应Body参数 
| 参数         | 参数类型   | 描述     |
|:---|:---|:---|
| error_code | String | 错误码    |
| error_msg  | String | 错误描述信息 |
   
**状态码：401**
表8响应Body参数 
| 参数         | 参数类型   | 描述     |
|:---|:---|:---|
| error_code | String | 错误码    |
| error_msg  | String | 错误描述信息 |
   
**状态码：500**
表9响应Body参数 
| 参数         | 参数类型   | 描述     |
|:---|:---|:---|
| error_code | String | 错误码    |
| error_msg  | String | 错误描述信息 |
   
#### 请求示例
创建端点，端点类型为"DIS"。
```
{
  "endpoint" : {
    "name" : "dis_example",
    "type" : "dis",
    "properties" : {
      "domain_id" : "8fd3691d01f44badab03e28d81abd4ff"
    }
  }
}
```
#### 响应示例
**状态码：201**
创建成功
```
{
  "endpoint" : {
    "name" : "dis_example",
    "description" : "",
    "type" : "dis",
    "properties" : {
      "domain_id" : "8fd3691d01f44badab03e28d81abd4ff"
    },
    "ief_instance_id" : "",
    "is_shared" : false,
    "id" : "add32d8b-eed1-40a6-8538-5ac66d8e0681",
    "project_id" : "ed202955e111444e8ced21a1bd75fc59",
    "created_at" : "2022-09-07T11:02:26Z",
    "updated_at" : "2022-09-07T11:02:26Z"
  }
}
```
#### 状态码
| 状态码 | 描述   |
|:---|:---|
| 201 | 创建成功 |
| 400 | 错误响应 |
| 401 | 错误响应 |
| 500 | 错误响应 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ief/ErrorCode.html)。