The content of this page has been automatically translated by AI. If you encounter any problems while reading, you can view the corresponding content in Chinese.
Help & Documentation>Cloud Object Storage>Agent Bucket>API Documentation>Intelligent Agent Bucket Enhancement API>Put Space Extension

Put Space Extension

Last updated: 2026-07-17 10:50:27

On this page:

Feature Description

Set the extended attributes of a specified Space. The SpaceId is extracted from the URL path and must be a single-level directory name.

Request

Request Syntax

PUT /{spaceId}/?space-extension HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Content-Type: application/xml
Content-Length: Content Length
Authorization: Auth String

[Request Body]
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

Submit application/xml request data containing the extended attribute information of the Space to be configured.
<SpaceExtension>
    <SpaceTag>personal</SpaceTag>
</SpaceExtension>
The detailed node descriptions are as follows:
Node Name (Keyword)
Parent Node
Description
Type
Required
SpaceExtension
None
All request information for the Put Space Extension operation.
Container
Yes
The content of the Container node SpaceExtension:
Node Name (Keyword)
Parent Node
Description
Type
Required
SpaceTag
SpaceExtension
A Space tag used to distinguish between Space types, such as personal Spaces and team Spaces.
string
Yes

Response

Response Headers

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

Response Body

The response body is empty.

Practical Case

Request

PUT /test-space/?space-extension HTTP/1.1
Host: smhxxx-1250000000.cos.ap-chengdu.myqcloud.com
Content-Type: application/xml
Content-Length: 64
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=****************************************

<SpaceExtension>
    <SpaceTag>personal</SpaceTag>
</SpaceExtension>

Response

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

中国站 - English