# 创建终端节点 - CreateEndpoint #### 功能介绍 创建终端节点。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-ga/ga_03_0000.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ga/ga_06_0000.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | ga:endpoint:create | Write | endpoint \* | - | - | - | | ga:endpoint:create | Write | - | - ga:RequestResourceType - ga:RequestResourceId - ga:RequestIpAddress - ga:RequestDomainName | - | - | #### URI POST /v1/endpoint-groups/{endpoint_group_id}/endpoints 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | endpoint_group_id | 是 | String | 终端节点组ID。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | endpoint | 是 | [CreateEndpointOption] object | 创建终端节点详细信息。 | 表4CreateEndpointOption | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | resource_id | 是 | String | 对应后端资源的ID，比如EIP的ID。 | | resource_type | 是 | String | 终端节点类型，取值范围: - EIP：本账号中的弹性公网IP - ECS：本账号中私网ECS实例 - ELB：本账号中私网ELB实例 - CUSTOM_IP：云外公网IP - CUSTOM_DOMAIN_NAME：云外公网域名 - CUSTOM_EIP：本Region的弹性公网IP | | weight | 否 | Integer | 终端节点权重。 | | ip_address | 是 | String | IP地址。 | #### 响应参数 **状态码：201** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | endpoint | [EndpointDetail] object | 终端节点实例。 | | request_id | String | 请求ID。 | 表6EndpointDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 终端节点ID。 | | resource_id | String | 对应后端资源ID。 | | endpoint_group_id | String | 终端节点组ID。 | | resource_type | String | 终端节点类型，取值范围: - EIP：本账号中的弹性公网IP - ECS：本账号中私网ECS实例 - ELB：本账号中私网ELB实例 - CUSTOM_IP：云外公网IP - CUSTOM_DOMAIN_NAME：云外公网域名 - CUSTOM_EIP：本Region的弹性公网IP | | status | String | 配置状态，取值： - ACTIVE：运行中 - PENDING：待定 - ERROR：错误 - DELETING：正在删除 | | weight | Integer | 终端节点权重。 | | health_state | String | 终端的健康状态，取值： - INITIAL：初始 - HEALTHY：正常 - UNHEALTHY：异常 - NO_MONITOR：未监控 | | created_at | String | 创建时间。 | | updated_at | String | 更新时间。 | | domain_id | String | 租户ID。 | | ip_address | String | IP地址。 | | frozen_info | [FrozenInfo] object | 云服务或资源实例冻结信息。 | 表7FrozenInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | status | Integer | 云服务或资源实例状态，取值： - 0：解冻/正常（云服务恢复正常）。 - 1：冻结（资源和数据会保留，但租户无法再正常使用云服务）。 - 2：删除/终止（资源和数据将清除）。 | | effect | Integer | 在冻结/解冻操作下，取值： - 1（默认值）：冻结可释放。 - 2：冻结不可释放。 - 3：冻结后不可续费。 | | scene | Array of strings | 更新云服务状态的业务场景列表，取值： - ARREAR（默认值）：欠费场景。为正常的运营业务场景，包括包周期资源到期、按需资源扣费失败。 - POLICE：公安冻结场景。 - ILLEGAL：违规冻结场景。 - VERIFY：客户未实名认证冻结场景。 - PARTNER：合作伙伴冻结（合作伙伴冻结子客户资源）。 | #### 请求示例 创建一个终端节点，类型为EIP，权重为10，IP地址为208.182.11.121。 ``` POST https://{ga_endpoint}/v1/endpoint-groups/3a9f50bb-f041-4eac-a117-82472d8a0007/endpoints { "endpoint" : { "resource_id" : "08155cd2-5897-49be-933f-eec757fd4010", "resource_type" : "EIP", "weight" : 10, "ip_address" : "208.182.11.121" } } ``` #### 响应示例 **状态码：201** 创建成功 ``` { "endpoint" : { "id" : "0aa23a52-1ac2-4a2d-8dfa-1e11cb26079d", "resource_id" : "08155cd2-5897-49be-933f-eec757fd4010", "endpoint_group_id" : "3a9f50bb-f041-4eac-a117-82472d8a0007", "resource_type" : "EIP", "status" : "ACTIVE", "weight" : 10, "health_state" : "HEALTHY", "created_at" : "2019-01-08T01:21:37.151Z", "updated_at" : "2019-01-08T01:21:37.151Z", "domain_id" : "99a3fff0d03c428eac3678da6a7d0f24", "ip_address" : "208.182.11.121", "frozen_info" : { "status" : 2, "effect" : 1, "scene" : [ "ARREAR", "POLICE" ] } }, "request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 201 | 创建成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ga/ErrorCode.html)。