tencent cloud

Smart Media Hosting

Product Introduction
Product Overview
Feature Description
Product Strengths
Use Cases
Basic Concept
Purchase Guide
Quick Start
Create Media Library
Initiate request
Service Level API Document
History
Introduction
API Category
Making API Requests
PaaS Service APIs
Official Cloud Disk APIs
Data Types
Error Codes
Business Level API Document
Introduction
Access Token Operation API
Tenant Space Operation API
File Operation API
Directory or Album Operation API
Recycle Bin Operation API
Quota Operation API
Query Task Operation API
Search Operation API
Historical Version Operations API
Directory and File Batch Operation API
Collection Operation API
Error Codes
SDK Documentation
Android SDK
iOS SDK
HarmonyOS SDK
FAQs
Enterprise Network Disk
Product Introduction
Purchase Guide
Quick Start
FAQs
Service Level Agreement
Glossary
DokumentasiSmart Media HostingBusiness Level API DocumentTenant Space Operation APIBatch Query and List Tenant Space Capacity Info

Batch Query and List Tenant Space Capacity Info

PDF
Mode fokus
Ukuran font
Terakhir diperbarui: 2026-01-07 14:45:21

Description

Used for batch query to list tenant space capacity info.
Note:
To list all Tenant Spaces, admin or space_admin permissions are required; otherwise, only the Tenant Spaces created by the user represented by the current access token will be listed. For details about permissions, see Generate Access Token API.

Request

Request Example

GET /api/v1/usage/`{LibraryId}`/`{SpaceIds}`?access_token=`{AccessToken}`&user_id=`{UserId}`

Request Parameter

Request parameters.
Description
Type
Required or Not
LibraryId
Media Library ID, obtained after creating a media library in the media hosting console. See create media library
String
Yes
AccessToken
Access token, see generate access token
String
For Public Read Media Library or tenant space, this parameter is not specified, otherwise you must specify this parameter.
UserId
User identity recognition is used to temporarily specify user identity when the access token has admin permission and the user identity recognition at the time of applying for the access token is empty. For details, see generate access token
String
No
SpaceIds
Space List, separated by commas, such as space1,space2
String
No

Request Body

This request does not have a request body.

Response

Response code

Successful retrieval, returning HTTP 200 OK.

Response Body

[
    {
        "spaceId": "space04fzo07fdq61b",
        "capacity": "10000",
        "availableSpace": "5000",
        "size": "1000"
    },
    {
        "spaceId": "space3p5klbgcwndnt",
        "capacity": "10000",
        "availableSpace": "5000",
        "size": "1000"
    }
]
Response body field description:
Node Name (Keyword)
Description
Type
spaceId
Tenant Space ID
String
capacity
Tenant space quota. If null, it is out of quota. Unit is in bytes (Byte).
String
availableSpace
Available capacity of tenant space. If null, it is out of quota. Unit is in bytes (Byte).
String
size
Storage quota occupied by uploaded files in tenant space. Unit is in bytes (Byte).
String

Error Codes

This request operation has no special error messages. For common error messages, see Error Codes.

Topik sebelumnya: Querying Media Library Capacity InformationTopik selanjutnya: Query Tenant Space Attributes

Bantuan dan Dukungan

Apakah halaman ini membantu?

masukan