tencent cloud

Cloud Object Storage

DokumentasiCloud Object StorageAgent BucketAPI DocumentationIntelligent Agent Bucket Enhancement APIGet Space Quota

Get Space Quota

Download
Mode fokus
Ukuran font
Terakhir diperbarui: 2026-07-29 17:20:16
Diterjemahkan oleh AI

Overview

Query the storage quota of a specified Space. The SpaceId is extracted from the URL path and must be a single-level directory name.

Request

Request Syntax

GET /{spaceId}/?space-quota HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Authorization: Auth String

Note:
SpaceId: It corresponds to the first-level directory of an ObjectKey. To create the corresponding SpaceId, you must first upload an empty first-level directory object using the PUT Object API.
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com. Here, <BucketName-APPID> is the bucket name with the APPID suffix, for example, smhxxxxxxxxxxxxx-1250000000. <Region> is the available region. For details, see Product Overview.
Authorization: Auth String (For details, see Request Signature).

Request Parameters

This API has no request parameters.

Request Body

This API has no request body.

Response

Response Headers

This API only returns common response headers. For details, see Common Response Headers.

Response Body

The request is successful, returning application/xml data that contains the Quota information of the Space.
<SpaceQuota>
    <QuotaId>12345</QuotaId>
    <Capacity>102400</Capacity>
</SpaceQuota>
The detailed node descriptions are as follows:
Node Name (Keyword)
Parent Node
Description
Type
SpaceQuota
None
Contains all information for the Get Space Quota result.
Container
The content of the Container node SpaceQuota:
Node Name (Keyword)
Parent Node
Description
Type
QuotaId
SpaceQuota
The unique identifier of a quota
string
Capacity
SpaceQuota
Quota capacity, in bytes
number

Examples

Request

GET /test-space/?space-quota HTTP/1.1
Host: smhxxx-1250000000.cos.ap-chengdu.myqcloud.com
Authorization: q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1566302375;1566309575&q-key-time=1566302375;1566309575&q-header-list=content-length;content-md5;content-type;date;host&q-url-param-list=delete&q-signature=****************************************


Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 118
Date: Tue, 20 Aug 2019 11:59:35 GMT
x-cos-request-id: NWQ1YmUwYTdfM2FiMDJhMDlfYzczN18zMGM1****

<SpaceQuota>
    <QuotaId>1</QuotaId>
    <Capacity>102400</Capacity>
</SpaceQuota>
Topik sebelumnya: Put Space QuotaTopik selanjutnya: Put Space Extension

Bantuan dan Dukungan

Apakah halaman ini membantu?

masukan