QueryGuidTaskList - 查询新手任务信息_云安全中心(Security Center)-阿里云帮助中心

云安全中心为完成任务的用户提供了增值服务授权数、日志分析存储容量等奖励。调用该接口可查询配置任务的完成情况和奖励信息。

调试

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

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
yundun-sas:QueryGuidTaskList	list	全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值

当前API无需请求参数

返回参数

名称	类型	描述	示例值
	object	请求返回参数。
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	7532B7EE-7CE7-5F4D-BF04-B12447D****
GuideTaskConfigList	array<object>	新手任务信息列表。
GuideTaskConfig	object	新手任务信息。
Status	integer	任务状态。取值： 0：已关闭 1：执行中 2：已完成	0
TaskTypeName	string	任务名称。取值： guid_task_security_score_promote_video：观看新手快速入门视频任务 guide_sub_task_config_defence_hbr：服务器防勒索配置任务 guide_sub_task_config_uni_defence_hbr：数据库防勒索配置任务 guid_task_log_analysis_config：日志分析任务 guide_sub_task_web_lock_config：防篡改任务 guide_sub_task_config_anti_crack：防暴力破解任务 guid_task_container_security_video：容器安全视频任务 guid_task_container_image_scan_config：容器镜像扫描任务 guid_task_k8s_log_analysis_config：Kubernetes 威胁检测任务 guid_task_container_network：容器可视化任务 guide_sub_task_config_add_collection：收藏控制台任务 guide_sub_task_vul_scan：漏洞扫描任务 guide_sub_task_virusKill：病毒查杀任务	guide_sub_task_config_add_collection
TaskId	integer	任务 ID。	t-000d8slfgx4p40kb64ad
RewardData	object	任务完成奖励信息。
Reward	string	奖励名称。取值： addTrialDay：奖励试用天数 addAntiRansomwareCapacity：奖励防勒索容量 addImageScanAuthCount：奖励镜像安全扫描授权数 addWebLockAuthCount：奖励网页防篡改授权数 addSlsCapacity：奖励日志分析存储空间	addAntiRansomwareCapacity
RewardConfig	string	奖励配置信息。该参数为 JSON 格式。说明其中 JSON 的 Key 为奖励内容，Value 为奖励值。Key 取值如下： webLockAuthCount：网页防篡改授权数 ransomwareCapacity：防勒索容量，单位 GB slsCapacity：日志分析容量，单位 GB days：使用天数 imageScanAuthCount：镜像扫描授权数 honeypotAuthCount：云蜜罐授权数	{"days":60,"ransomwareCapacity":10}
IsRewardTaked	string	领取状态。取值： 1：未领取 2：已领取	1
SecurityScore	integer	完成该任务可提升安全评分的分值。	80

示例

正常返回示例

JSON格式

{
  "RequestId": "7532B7EE-7CE7-5F4D-BF04-B12447D****",
  "GuideTaskConfigList": [
    {
      "Status": 0,
      "TaskTypeName": "guide_sub_task_config_add_collection",
      "TaskId": 0,
      "RewardData": {
        "Reward": "addAntiRansomwareCapacity",
        "RewardConfig": "{\"days\":60,\"ransomwareCapacity\":10}",
        "IsRewardTaked": "1"
      },
      "SecurityScore": 80
    }
  ]
}

错误码

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

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