获取块存储资源列表

获取块存储资源列表

Path Parameters

subscription_name string required

订阅

resource_group_name string required

资源组

zone string required

可用区

Query Parameters

filter string

过滤

order_by string

排序结果

page_size int32

返回当前页的最大条目数

page_token string

从上一个List请求返回的next_page_token值(如果有的话)

Responses

• 200
• default

---

OK

application/json

Schema

Example (from schema)

---

Schema

disks object[]
块存储资源列表
Array [
id string required
块存储资源 id
name string required
块存储资源名称
display_name string
Possible values: <= 63 characters
块存储资源别名
description string
块存储资源描述
uid string required
块存储资源的uuid
resource_type string
Default value: storage.abs.v1.disk
块存储资源的资源类型
creator_id string
创建DiskStorage resource的用户id
owner_id string
拥有DiskStorage resource的用户id
tenant_id string
租户id
zone string required
可用区
state enum
Possible values: [CREATING, UPDATING, ACTIVE, DELETING, DELETED, FAILED, EXPIREDOWNGRADING, EXPIREDOWNGRADED, RENEWUPGRADING, EXPIRESTOPPING, EXPIRESTOPPED, RENEWSTARTING, DOWNGRADING, DOWNGRADE, RESTORING, ATTACHING, INUSE, DETACHING, DETACHFAILED, ATTACHFAILED, DELETEDFAILED, RESIZING, RESIZEFAILED, ARREARSTOPPING, ARREARSTOPPED, RECHARGESTARTING, RESIZECANCELING]
Default value: ACTIVE
块存储资源状态
sku_id string
最小库存单元id
tags object
块存储资源的标签
property name* string
properties object
块存储资源属性
resources object
资源规格属性
billing_items object
计费项
capacity int32
创建块存储资源容量
capacity_unit enum
Possible values: [EB, PB, TB, GB, MB]
Default value: GB
创建块存储资源容量单位
disk_type enum
Possible values: [CLOUDEFFICIENCY, CLOUDSSD]
Default value: CLOUDSSD
资源包存储类型
system_disk boolean
Default value: false
是否是系统盘
ecs_lifecycle boolean
Default value: false
是否随ecs实例释放
snapshot_id string
根据指定的快照id进行盘的创建
image_id string
根据指定的镜像id进行盘的创建
order_info object
订单信息
billing_cycle_number int32
Default value: 1
购买时长
auto_renew boolean
Default value: false
自动续费
currency_code string
Default value: CNY
货币代码
payment_channel enum
Possible values: [PC_UNSPECIFIED, PC_BALANCE, PC_CREDIT, PC_FROZENACCOUNT, PC_REMIT_OFFLINE, PC_ALIPAY, PC_UNIONPAY, PC_REMIT_ONLINE, PC_CONTRACT]
Default value: PC_BALANCE
支付方式
note string
订单备注
order_type enum
Possible values: [OT_UNSPECIFIED, OT_ORIGINAL, OT_RENEW, OT_UPGRADED, OT_DOWNGRADED, OT_CONTRACT, OT_UNSUBSCRIBE, OT_RESIZE, OT_MUTATIO, OT_CONTRACT_RENEW]
Default value: OT_ORIGINAL
订单类型
order_id string
订单id
start_time date-time
订单生效日期
payment_model enum
Possible values: [PM_UNSPECIFIED, PM_PREPAID, PM_POSTPAID]
Default value: PM_PREPAID
付费类型
billing_model enum
Possible values: [BM_UNSPECIFIED, BM_USAGE, BM_MONTHLY, BM_YEARLY]
Default value: BM_MONTHLY
计费类型
original_id string
合同包ID
end_time date-time
订单结束时间
auto_convert_postpaid boolean
预付费自动转后付费
deleted boolean
是否删除块存储资源
create_time date-time
创建块存储资源资源的时间
update_time date-time
上一次更新DiskStorage resource的时间
]
next_page_token string

下一页的token

total_size int32

块存储资源总数

{
  "disks": [
    {
      "id": "string",
      "name": "string",
      "display_name": "string",
      "description": "string",
      "uid": "string",
      "resource_type": "storage.abs.v1.disk",
      "creator_id": "string",
      "owner_id": "string",
      "tenant_id": "string",
      "zone": "string",
      "state": "ACTIVE",
      "sku_id": "string",
      "tags": {},
      "properties": {
        "resources": {
          "billing_items": {
            "capacity": 0,
            "capacity_unit": "GB"
          },
          "disk_type": "CLOUDSSD",
          "system_disk": false,
          "ecs_lifecycle": false,
          "snapshot_id": "string",
          "image_id": "string"
        }
      },
      "order_info": {
        "billing_cycle_number": 1,
        "auto_renew": false,
        "currency_code": "CNY",
        "payment_channel": "PC_BALANCE",
        "note": "string",
        "order_type": "OT_ORIGINAL",
        "order_id": "string",
        "start_time": "2025-06-25T02:32:24.211Z",
        "payment_model": "PM_PREPAID",
        "billing_model": "BM_MONTHLY",
        "original_id": "string",
        "end_time": "2025-06-25T02:32:24.211Z",
        "auto_convert_postpaid": true
      },
      "deleted": true,
      "create_time": "2025-06-25T02:32:24.211Z",
      "update_time": "2025-06-25T02:32:24.211Z"
    }
  ],
  "next_page_token": "string",
  "total_size": 0
}

Default error response

application/json

Schema

Example (from schema)

---

Schema

code int32

The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

message string

A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.

details object[]
A list of messages that carry the error details. There is a common set of message types for APIs to use.
Array [
@type string
The type of the serialized message.
]

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

GET /storage/abs/v1/subscriptions/:subscription_name/resourceGroups/:resource_group_name/zones/:zone/disks

Authorization

name: bearerAuthtype: httpscheme: bearer

Request

Base URL

https://management.sensecoreapi.cn

Bearer Token

subscription_name — path required

resource_group_name — path required

zone — path required

filter — query

order_by — query

page_size — query

page_token — query

curl / cURL

curl -L -X GET 'https://management.sensecoreapi.cn/storage/abs/v1/subscriptions/:subscription_name/resourceGroups/:resource_group_name/zones/:zone/disks' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

python / requests

curl -L -X GET 'https://management.sensecoreapi.cn/storage/abs/v1/subscriptions/:subscription_name/resourceGroups/:resource_group_name/zones/:zone/disks' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

go / native

curl -L -X GET 'https://management.sensecoreapi.cn/storage/abs/v1/subscriptions/:subscription_name/resourceGroups/:resource_group_name/zones/:zone/disks' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

nodejs / axios

curl -L -X GET 'https://management.sensecoreapi.cn/storage/abs/v1/subscriptions/:subscription_name/resourceGroups/:resource_group_name/zones/:zone/disks' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

ruby / Net::HTTP

curl -L -X GET 'https://management.sensecoreapi.cn/storage/abs/v1/subscriptions/:subscription_name/resourceGroups/:resource_group_name/zones/:zone/disks' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

csharp / RestSharp

curl -L -X GET 'https://management.sensecoreapi.cn/storage/abs/v1/subscriptions/:subscription_name/resourceGroups/:resource_group_name/zones/:zone/disks' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

php / cURL

curl -L -X GET 'https://management.sensecoreapi.cn/storage/abs/v1/subscriptions/:subscription_name/resourceGroups/:resource_group_name/zones/:zone/disks' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

java / OkHttp

curl -L -X GET 'https://management.sensecoreapi.cn/storage/abs/v1/subscriptions/:subscription_name/resourceGroups/:resource_group_name/zones/:zone/disks' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

powershell / RestMethod

curl -L -X GET 'https://management.sensecoreapi.cn/storage/abs/v1/subscriptions/:subscription_name/resourceGroups/:resource_group_name/zones/:zone/disks' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'