调用DescribePropertySoftwareItem获取软件列表信息_云安全中心(Security Center)-阿里云帮助中心

获取所有软件列表信息。

调试

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

授权信息

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

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

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

请求参数

名称	类型	必填	描述	示例值
ForceFlush	boolean	否	是否强制刷新待查询数据。	true
Name	string	否	指定待查询的软件名称。	test
CurrentPage	integer	否	指定返回结果的当前页码。	1
PageSize	integer	否	指定列表每页显示数据条数。	10

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	3A85CFCF-05C8-451A-9E41-C0D5E96BA407
PageInfo	object	返回结果的页面显示信息。
CurrentPage	integer	返回结果中显示的当前页码。	1
PageSize	integer	返回结果中每页显示数据条数。	2
TotalCount	integer	返回数据的总条数。	5037
Count	integer	返回结果的当前页显示数据条数。	2
PropertyItems	array<object>	返回的软件列表。
PropertySoftwareItem	object
Name	string	返回的软件资产名称。	aaa_base
Count	integer	返回结果中软件资产对应的服务器数量。	23

示例

正常返回示例

JSON格式

{
  "RequestId": "3A85CFCF-05C8-451A-9E41-C0D5E96BA407",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 2,
    "TotalCount": 5037,
    "Count": 2
  },
  "PropertyItems": [
    {
      "Name": "aaa_base",
      "Count": 23
    }
  ]
}

错误码

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

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