新增蜜罐探针信息。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| yundun-sas:CreateHoneypotProbe | create |
|
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ControlNodeId | string | 是 | 管理节点 ID。 说明
您可以调用 ListHoneypotNode 接口获取该值
| a882e590-b87b-45a6-87b9-d0a3e5a0**** |
| ProbeType | string | 是 | 探针类型。取值：
| host_probe |
| DisplayName | string | 是 | 探针名称。 | testHoneyPotProbe |
| ProbeVersion | string | 否 | 探针版本。 | 0.0.0 |
| Uuid | string | 否 | 实例 UUID。 说明
ProbeType 为host_probe时该值不能为空。
| e4af3620-6895-4e2f-a641-a9d8fb53**** |
| BusinessGroupId | string | 否 | 业务分组 。 | 2022011817324588686 |
| HoneypotBindList | array<object> | 否 | 配置服务集合。 | |
| HoneypotBindList | object | 否 | 配置服务详情。 | |
| BindPortList | array<object> | 否 | 监听端口列表。 | |
| BindPortList | object | 否 | 监听端口详情。 | |
| TargetPort | integer | 否 | 目标端口。 说明
HoneypotId 不为空时该值不能为空。
| 80 |
| StartPort | integer | 否 | 开始端口。 | 80 |
| EndPort | integer | 否 | 结束端口。 | 90 |
| Fixed | boolean | 否 | 是否固定端口。取值：
| 0 |
| BindPort | boolean | 否 | 是否绑定端口。取值：
| true |
| HoneypotId | string | 否 | 蜜罐 ID。 说明
您可以调用 ListHoneypot 接口获取该值。
| 1a5eda2d40f92ac87d6b63e1a5ad4b76fe0d4110c4a3e2fa85438a29ae55**** |
| Ping | boolean | 否 | ping 扫描检测。取值：
| true |
| Arp | boolean | 否 | ARP 欺骗检测。
| true |
| VpcId | string | 否 | 专有网络的 ID。 说明
ProbeType 为vpc_black_hole_probe时该值不能为空。 您可以调用 DescribeVpcHoneyPotList 接口获取该值。
| vpc-zm0asrkpv1q8gnk7mn4dn |
| ProxyIp | string | 否 | 代理 IP。 | 192.168.XX.XX |
返回参数
示例
正常返回示例
JSON格式
{
"Success": true,
"Code": "200",
"Message": "successful",
"RequestId": "B7A839E8-70AE-591D-8D9E-C5419A2240DB",
"HttpStatusCode": 200,
"HoneypotProbe": {
"ProbeId": "b69e9aa8-2ea8-4c5a-836a-c1fbacff****"
}
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | AgentNotOnline | The agent not online. | 客户端不在线不支持操作，请保持客户端在线后再进行操作。 |
| 400 | IllegalParam | Illegal param | 无效参数 |
| 400 | NodeNotExist | The control node does not exist. | 管理节点不存在，请选择正确的管理节点。 |
| 400 | BindPortAlreadyExist | The specified service port already exists. | 需要绑定的端口已存在，请重新指定正确的端口。 |
| 400 | MachineNotExist | The machine does not exist. | 所操作的机器不存在，请确认后重新操作。 |
| 400 | ProbeAlreadyCreate | The probe has been created. | 该探针已被创建，请重新选择。 |
| 400 | ProbeNameAlreadyExists | The probe name already exists. | 探针名称已存在，请重新输入未使用的探针名称。 |
| 403 | NoPermission | caller has no permission | 当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。 |
| 500 | ServerError | ServerError | 服务故障，请稍后重试！ |
访问错误中心查看更多错误码。