调用CreateHoneypot API创建蜜罐实例-云安全中心-阿里云-云安全中心(Security Center)-阿里云帮助中心

新增蜜罐实例。

接口说明

调用本接口创建蜜罐实例前，请先完成以下前置步骤：

若账号下尚无蜜罐管理节点，调用 CreateHoneypotNode 接口创建蜜罐管理节点。
调用 ListHoneypotNode 接口，获取蜜罐管理节点的 NodeId。
使用获取到的 NodeId，调用本接口（CreateHoneypot）创建蜜罐实例。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-sas:CreateHoneypot

create

*HoneyPot

acs:yundun-sas:{#regionId}:{#accountId}:honeypot/*

无

请求参数

名称	类型	必填	描述	示例值
HoneypotImageName	string	是	蜜罐镜像名称。说明您可以调用 ListAvailableHoneypot 接口返回的 HoneypotImageName 字段。	HoneyPotImageName
HoneypotName	string	是	蜜罐自定义名称。	ruoyi
NodeId	string	是	蜜罐管理节点 ID。说明调用 ListHoneypotNode 接口获取该值。	a882e590-b87b-45a6-87b9-d0a3e5a0****
HoneypotImageId	string	是	蜜罐镜像 ID。说明您可以调用 ListAvailableHoneypot 接口返回的 HoneypotImageId 字段。	sha256:ebc4c102ac407d53733c2373e8888a733ddce86f163ccbe7492ae1cbf26****
Meta	string	否	蜜罐自定义配置。JSON 格式。包含以下字段： trojan_git：Git 反制。取值： zip：Git 源码包 web：.git 目录泄漏 close：关闭 trojan_git_addr：Git 反制连接地址 trojan_git.zip：Git 反制木马包 burp：Burp 反制。取值： open：开启 close：关闭 portrait_option：溯源配置。取值： false：关闭 true：开启	{\"trojan_git\":\"close\",\"burp\":\"close\",\"portrait_option\":\"false\"}

返回参数

名称	类型	描述	示例值
	object	PlainResult
Data	object	蜜罐信息。
HoneypotId	string	蜜罐 ID。	9bf8cd373112263d4bc102fc5dba9d9f812ee05d4d35c487d330d52e937f****
HoneypotName	string	蜜罐自定义名称。	ruoyi
ControlNodeName	string	蜜罐管理节点名称。	managerNodename
HoneypotImageName	string	蜜罐镜像名称。	tcp_proxy
PresetId	string	蜜罐自定义参数 ID。	ddh3731641137fe4b72b245346a2721d4b6tdgg3731641137fe4b72b245346a2721***
State	array	蜜罐状态。
	string	蜜罐状态。取值： starting：开启 running：正常 exited：关闭 upgrade：更新中 deleting：正在删除中 resetting：重置中 created：完成创建 stopping：停止中	starting
HoneypotImageDisplayName	string	蜜罐镜像显示名称。	HoneyDisplayName
NodeId	string	管理节点唯一 ID。	a882e590-b87b-45a6-87b9-d0a3e5a0****
Success	boolean	是否调用成功。取值： true：调用成功。 false：调用失败。	true
Code	string	结果代码，200 表示成功，若为别的值则表示失败，调用方可根据此字段判断失败原因。	200
Message	string	错误码的详细信息。	successful
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	29874225-EAAC-5415-8501-32DD20FD29F6
HttpStatusCode	integer	HTTP 状态码。	200

示例

正常返回示例

JSON格式

{
  "Data": {
    "HoneypotId": "9bf8cd373112263d4bc102fc5dba9d9f812ee05d4d35c487d330d52e937f****",
    "HoneypotName": "ruoyi",
    "ControlNodeName": "managerNodename",
    "HoneypotImageName": "tcp_proxy",
    "PresetId": "ddh3731641137fe4b72b245346a2721d4b6tdgg3731641137fe4b72b245346a2721***",
    "State": [
      "starting"
    ],
    "HoneypotImageDisplayName": "HoneyDisplayName",
    "NodeId": "a882e590-b87b-45a6-87b9-d0a3e5a0****"
  },
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "RequestId": "29874225-EAAC-5415-8501-32DD20FD29F6",
  "HttpStatusCode": 200
}

错误码

HTTP status code	错误码	错误信息	描述
500	ServerError	ServerError	服务故障，请稍后重试！
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。