tencent cloud

Smart Media Hosting

문서Smart Media HostingBusiness Level API DocumentTenant Space Operation APIListing Tenant Space

Listing Tenant Space

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-01-07 14:45:20

Description

List tenant space information.
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 permissions, see Generate Access Token Interface.

Request

Request Example

GET /api/v1/space/{LibraryId}/list?access_token={AccessToken}&marker={Marker}&limit={Limit}

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
Yes
Marker
Used for sequential listing with pagination identification, i.e., the nextMarker field returned from the previous request.
String
No
Limit
Used for sequential listing with pagination, the tenant space quantity limit defaults to 1000, range [1,1000].
String
No

Request Body

This request does not have a request body.

Response

Response code

Successful retrieval, returns HTTP 200 OK.

Response Body

{
    "list":[
      {
      "spaceId": "space04fzo07fdq61b",
      "userId": "",
      "creationTime": "2020-10-16T02:31:50.000Z"
      },
      {
      "spaceId": "space3p5klbgcwndnt",
      "userId": "",
      "creationTime": "2020-10-16T02:31:50.000Z"
      }
    ],
    "marker": "eyJmb3JtYXQiOjIsInRhYmх1X21kIjoхLCJzсGFjZV9pZCI6IiJ9",
    "nextMarker":"eyJmb3JtYXQiOjIsInRhYmх1X21kIjoхLCJzсGFjZV9pZCI6IiJ9"
}
Response body field description:
Response
Description
Type
List
Record tenant space information
List
marker
Identification for paginated listing
String
nextMarker
Identification for sequential page listing. If no more, this field does not exist.
String
The List contains the following parameters:
Node Name (Keyword)
Description
Type
spaceId
Tenant Space ID
String
userId
Creator User ID
String
creationTime
Tenant space creation time, a date and time string in ISO 8601 format, such as 2020-10-14T10:17:57.953Z
String
Note:
The List is displayed only when nextMarker in the response body is empty.

Error Codes

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

이전 주제: Creating a Tenant Space다음 주제: Number of Files Statistics

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백