ListAppGroups - 获取应用列表

更新时间:
复制 MD 格式

获取OpenSearch应用列表。

接口说明

  • 支持按照 name、instanceId、type 进行过滤

  • 支持按照应用的创建时间排序

  • 支持分页参数

调试

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

调试

授权信息

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

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

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

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

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

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

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

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

操作

访问级别

资源类型

条件关键字

关联操作

opensearch:ListAppGroup

list

*AppGroup

acs:opensearch:{#regionId}:{#accountId}:app-groups/*

无 无

请求语法

GET /v4/openapi/app-groups HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

pageNumber

integer

否

页码,默认 pageNumber=1

1

pageSize

integer

否

每页返回数目,默认 pageSize=10

10

instanceId

string

否

实例 ID(精确匹配)

ops-cn-xxxx

name

string

否

应用名称

my_name

type

string

否

应用类型

  • standard 标准版

  • enhanced 新高级版

standard

sortBy

integer

否

排列顺序

  • 0:按创建时间降序排列

  • 1:按修改时间降序排列

默认 sortBy=0

0

resourceGroupId

string

否

资源 id

"110123123"

tags

array<object>

否

标签列表

object

否

key

string

否

标签键

foo

value

string

否

标签值

bar

返回参数

名称

类型

描述

示例值

object

响应体

{}

totalCount

integer

总条数

1

requestId

string

请求 ID

0A6EB64B-B4C8-CF02-810F-E660812972FF

result

object

应用信息

参考: AppGroup

{}

beaconAppCreated

integer

chargeType

string

付费类型

  • POSTPAY 后付费(按量付费)

  • PREPAY 预付费(包年包月)

POSTPAY

chargingWay

integer

计费类型

  • 1:计算资源

  • 2:qps

1

commodityCode

string

商品 CODE

opensearch

components

array<object>

object

code

string

value

string

created

integer

创建时间戳

1575442875

currentVersion

string

当前在线版本

110116134

description

string

应用描述

"xxx"

domain

string

domain

""

domainName

string

engineType

string

引擎类型

ha3

hasPendingQuotaReviewTask

integer

是否配额审批中

  • 0:正常

  • 1:配额审批中

0

id

string

应用 ID

110116134

inDebt

boolean

instanceId

string

实例 ID

"xxx"

lockMode

string

锁定状态

  • Unlock 正常

  • LockByExpiration 实例过期自动锁定

  • ManualLock 手动触发锁定

Unlock

name

string

应用名称

os_function_test_v1

produced

integer

是否生产完成

  • 0:生产中

  • 1:生产完成

1

quota

object

应用配额信息 参考: Quota

{}

computeResource

integer

计算资源(单位:LCU)

20

docSize

integer

存储容量(单位:GB)

1

spec

string

规格

  • opensearch.share.junior 入门型

  • opensearch.share.common 共享通用型

  • opensearch.share.compute 共享计算型

  • opensearch.share.storage 共享存储型

  • opensearch.private.common 独享通用型

  • opensearch.private.compute 独享计算型

  • opensearch.private.storage 独享存储型

opensearch.share.common

resourceGroupId

string

status

string

应用状态

  • producing 生产中

  • review_pending 生产审批中

  • config_pending 待配置

  • normal 正常

  • frozen 已冻结

normal

switchedTime

integer

在线版本切换时间戳

0

tags

array<object>

应用标签

object

标签。

key

string

标签键

foo

value

string

标签值

bar

type

string

应用类型

  • standard 标准版

  • enhanced 新高级版

enhanced

updated

integer

更新时间戳

1578916076

versions

array

string

zoneId

string

elasticLcu

integer

示例

正常返回示例

JSON格式

{
  "totalCount": 1,
  "requestId": "0A6EB64B-B4C8-CF02-810F-E660812972FF",
  "result": {
    "beaconAppCreated": 0,
    "chargeType": "POSTPAY",
    "chargingWay": 1,
    "commodityCode": "opensearch",
    "components": [
      {
        "code": "",
        "value": ""
      }
    ],
    "created": 1575442875,
    "currentVersion": "110116134",
    "description": "\"xxx\"",
    "domain": "\"\"",
    "domainName": "",
    "engineType": "ha3",
    "hasPendingQuotaReviewTask": 0,
    "id": "110116134",
    "inDebt": true,
    "instanceId": "\"xxx\"",
    "lockMode": "Unlock",
    "name": "os_function_test_v1",
    "produced": 1,
    "quota": {
      "computeResource": 20,
      "docSize": 1,
      "spec": "opensearch.share.common"
    },
    "resourceGroupId": "",
    "status": "normal",
    "switchedTime": 0,
    "tags": [
      {
        "key": "foo",
        "value": "bar"
      }
    ],
    "type": "enhanced",
    "updated": 1578916076,
    "versions": [
      ""
    ],
    "zoneId": "",
    "elasticLcu": 0
  }
}

错误码

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

变更历史

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