CreateAgentlessScanTask - 创建无代理检测任务

Updated at:

创建无代理检测任务。

调试

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

调试

授权信息

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

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-sas:CreateAgentlessScanTask

create

*全部资源

*

无 无

请求参数

名称

类型

必填

描述

示例值

TargetType

integer

是

目标类型。取值:

  • 1:主机检测-通过快照检测

  • 2:主机检测-通过镜像检测

  • 3:用户快照检测

  • 2:用户自定义镜像检测

2

UuidList

array

否

指定待检测的资产 UUID。

说明

您可以调用 DescribeCloudCenterInstances 接口获取服务器的 UUID。

string

否

指定待检测的资产 UUID。

66a9c708-d4a4-4feb-aa00-61006556****

AutoDeleteDays

integer

否

镜像保留时间,单位为天。此参数仅对主机检测生效,用户快照检测和用户自定义镜像检测场景不生效。

1

ScanDataDisk

boolean

否

是否检测数据盘。取值:

  • true:检测

  • false:不检测

true

ReleaseAfterScan

boolean

否

是否打开省钱模式。取值:

  • true:打开

  • false:关闭

true

AssetSelectionType

string

否

资产选择标识。

AGENTLESS_SCAN_ONCE_TASK_1720145******

RegionId

string

否

要查询的实例所在地域的 ID。取值:

  • cn-hangzhou(默认值):中国。

  • ap-southeast-1:全球(不含中国)。

cn-hangzhou

ClientToken

string

否

幂等 Key

66a9c708-d4a4-4fe

返回参数

名称

类型

描述

示例值

object

RequestId

string

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

E90DE229-9FC6-58F6-BF4B-03AD6179****

TaskId

string

任务 id

66561899963532d9db8a14124f46f3a0

示例

正常返回示例

JSON格式

{
  "RequestId": "E90DE229-9FC6-58F6-BF4B-03AD6179****",
  "TaskId": "66561899963532d9db8a14124f46f3a0"
}

错误码

HTTP status code

错误码

错误信息

描述

400 TaskIsProcessing Task Is Processing. 任务正在处理中。
500 ServerError ServerError 服务故障,请稍后重试!
403 NoPermission caller has no permission 当前操作未被授权,请联系主账号在RAM控制台进行授权后再执行操作。

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

变更历史

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