创建目标连接
功能介绍
创建目标连接。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v1/{project_id}/connections
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
租户项目ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度:1 最大长度:16384 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
目标连接名称,租户下唯一,由字母、数字、点、下划线和中划线组成,必须以字母或数字开头,不能为default 最小长度:1 最大长度:128 |
description |
否 |
String |
目标连接描述 最大长度:255 |
vpc_id |
是 |
String |
待连接的VPC ID 最大长度:128 |
subnet_id |
是 |
String |
待连接的子网ID 最大长度:128 |
type |
否 |
String |
目标连接类型。目前支持webhook:http连接;kafka:华为云官方kafka实例 枚举值:
|
kafka_detail |
否 |
KafkaConnectionDetail object |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
instance_id |
是 |
String |
kafka实例id。 |
addr |
是 |
String |
kafka连接地址。 |
security_protocol |
否 |
String |
安全协议。 |
enable_sasl_ssl |
是 |
Boolean |
kafka实例是否开启了SASL_SSL。 缺省值:false |
user_name |
否 |
String |
kafka实例用户名。实例开启了SASL_SSL时必填 |
password |
否 |
String |
kafka实例密码。实例开启了SASL_SSL时必填 |
acks |
否 |
String |
收到Server端确认信号个数,表示producer需要收到多少个这样的确认信号,算消息发送成功。acks参数代表了数据备份的可用性。支持选项: acks=0:表示producer不需要等待任何确认收到的信息,副本将立即加到socket buffer并认为已经发送。没有任何保障可以保证此种情况下server已经成功接收数据,同时重试配置不会发生作用(因为客户端不知道是否失败)回馈的offset会总是设置为-1。 acks=1:这意味着至少要等待leader已经成功将数据写入本地log,但是并没有等待所有follower是否成功写入。如果follower没有成功备份数据,而此时leader又无法提供服务,则消息会丢失。 acks=all:这意味着leader需要等待ISR中所有备份都成功写入日志,只有任何一个备份存活,数据都不会丢失。min.insync.replicas指定必须确认写入才能被认为成功的副本的最小数量。 缺省值:1 枚举值:
|
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
X-Request-Id |
String |
This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname. |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
事件源ID |
name |
String |
目标连接名称,租户下唯一,由小写字母、数字、点、下划线和中划线组成,必须以字母或数字开头,不能为default |
description |
String |
目标连接描述 |
status |
String |
目标连接状态 枚举值:
|
error_info |
ErrorInfo object |
|
vpc_id |
String |
待连接的VPC ID |
subnet_id |
String |
待连接的子网ID |
agency |
String |
私网目标连接使用的用户委托名称 |
flavor |
flavor object |
规格 |
type |
String |
目标连接类型。目前支持webhook:http连接;kafka:华为云官方kafka实例 枚举值:
|
kafka_detail |
KafkaConnectionDetail object |
|
created_time |
String |
创建UTC时间 |
updated_time |
String |
更新UTC时间 |
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最小长度:1 最大长度:128 |
error_detail |
String |
错误详情 最小长度:1 最大长度:128 |
error_msg |
String |
错误信息 最小长度:1 最大长度:128 |
参数 |
参数类型 |
描述 |
---|---|---|
name |
String |
规格名称 |
concurrency_type |
String |
并发规格类型 枚举值:
|
concurrency |
Integer |
并发数 |
bandwidth_type |
String |
带宽类型 枚举值:
|
参数 |
参数类型 |
描述 |
---|---|---|
instance_id |
String |
kafka实例id。 |
addr |
String |
kafka连接地址。 |
security_protocol |
String |
安全协议。 |
enable_sasl_ssl |
Boolean |
kafka实例是否开启了SASL_SSL。 缺省值:false |
user_name |
String |
kafka实例用户名。实例开启了SASL_SSL时必填 |
password |
String |
kafka实例密码。实例开启了SASL_SSL时必填 |
acks |
String |
收到Server端确认信号个数,表示producer需要收到多少个这样的确认信号,算消息发送成功。acks参数代表了数据备份的可用性。支持选项: acks=0:表示producer不需要等待任何确认收到的信息,副本将立即加到socket buffer并认为已经发送。没有任何保障可以保证此种情况下server已经成功接收数据,同时重试配置不会发生作用(因为客户端不知道是否失败)回馈的offset会总是设置为-1。 acks=1:这意味着至少要等待leader已经成功将数据写入本地log,但是并没有等待所有follower是否成功写入。如果follower没有成功备份数据,而此时leader又无法提供服务,则消息会丢失。 acks=all:这意味着leader需要等待ISR中所有备份都成功写入日志,只有任何一个备份存活,数据都不会丢失。min.insync.replicas指定必须确认写入才能被认为成功的副本的最小数量。 缺省值:1 枚举值:
|
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最小长度:1 最大长度:128 |
error_msg |
String |
错误消息 最小长度:1 最大长度:512 |
error_details |
String |
具体错误消息 最小长度:1 最大长度:1024 |
request_id |
String |
请求处理ID 最小长度:1 最大长度:128 |
状态码: 401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最小长度:1 最大长度:128 |
error_msg |
String |
错误消息 最小长度:1 最大长度:512 |
error_details |
String |
具体错误消息 最小长度:1 最大长度:1024 |
request_id |
String |
请求处理ID 最小长度:1 最大长度:128 |
状态码: 403
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最小长度:1 最大长度:128 |
error_msg |
String |
错误消息 最小长度:1 最大长度:512 |
error_details |
String |
具体错误消息 最小长度:1 最大长度:1024 |
request_id |
String |
请求处理ID 最小长度:1 最大长度:128 |
状态码: 404
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最小长度:1 最大长度:128 |
error_msg |
String |
错误消息 最小长度:1 最大长度:512 |
error_details |
String |
具体错误消息 最小长度:1 最大长度:1024 |
request_id |
String |
请求处理ID 最小长度:1 最大长度:128 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最小长度:1 最大长度:128 |
error_msg |
String |
错误消息 最小长度:1 最大长度:512 |
error_details |
String |
具体错误消息 最小长度:1 最大长度:1024 |
request_id |
String |
请求处理ID 最小长度:1 最大长度:128 |
请求示例
无
响应示例
状态码: 400
{ "error_code" : "EG.00014000", "error_msg" : "Bad request" }
状态码: 401
{ "error_code" : "EG.00014010", "error_msg" : "Incorrect token or token resolution failed" }
状态码: 403
{ "error_code" : "EG.00014030", "error_msg" : "No permissions to request this method" }
状态码: 404
{ "error_code" : "EG.00014040", "error_msg" : "Not request resource found" }
状态码: 500
{ "error_code" : "EG.00015000", "error_msg" : "Internal Server Error" }
状态码
状态码 |
描述 |
---|---|
200 |
Demo Information |
400 |
非法请求 |
401 |
未授权 |
403 |
禁止访问 |
404 |
未找到资源 |
500 |
内部服务错误 |
错误码
请参见错误码。