EnableInternetAccess--消息队列 Kafka版-火山引擎

文档中心

导航

消息队列 Kafka版

EnableInternetAccess

最近更新时间：2022.10.18 16:24:27首次发布时间：2022.04.24 15:56:37

调用 EnableInternetAccess 接口开启公网访问权限。

使用说明

创建实例后，可以通过此接口开启公网访问，并为实例绑定公网IP。开启公网访问后，消息队列 Kafka版为实例提供公网接入点，用于客户端通过公网访问 Kafka 实例。Kafka 实例公网访问方式要求 SSL 认证，目前支持客户端对服务端证书的单向认证，数据加密传输，相较于普通公网访问方式具备更高的安全性。

说明

客户端通过公网访问 Kafka 服务时，需要使用 SASL_SSL 接入点连接实例，并配置证书与鉴权信息，否则访问时会报错 Kafka 鉴权失败。配置方式请参考使用 SASL_SSL 接入点连接实例。

此接口的 API Version 为 2022-05-01。
此接口的调用频率限制为 20 次/s，超出频率限制会报错 “AccountFlowLimitExceeded”。

请求参数

参数	参数类型	是否必选	示例值	说明
InstanceId	String	必选	kafka-****	实例 ID。
EipIds	List	可选	["eip-xxxxx"]	弹性网卡 ID，即 EIP ID。

响应参数

null

示例

请求示例

POST https://kafka.volcengineapi.com/?Action=EnableInternetAccess&Version=2022-05-01 HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: kafka.volcengineapi.com
X-Date: 20210328T100802Z
Authorization: HMAC-SHA256 Credential=AK********/20210328/cn-beijing/kafka/request, SignedHeaders=x-date, Signature=********

{
  "InstanceId": "kafka-****",
  "EipIds": [
    ""
  ]
}

响应示例

{
  "ResponseMetadata": {
    "RequestId": "****************",
    "Action": "EnableInternetAccess",
    "Version": "2022-05-01",
    "Service": "kafka",
    "Region": "cn-beijing"
  },
  "Result": null
}