tencent cloud

Cloud Infinite

Querying the Binding Relationship List

다운로드
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-09-08 16:24:27
AI 번역

Feature Description

Query the list of binding relationships between datasets and COS buckets.

Authorization Description

When using a sub-account, add the ci:DescribeDatasetBindings permission to the action of the authorization policy. For all APIs supported by Cloud Infinite, see CI action.

Use Limits

Before using this API, confirm the relevant restrictions. For details, see Usage Limits.

Request

Request sample

GET /datasetbindings?datasetname=test&limit=100 HTTP/1.1
Host: <AppId>.ci.ap-jakarta.myqcloud.com
Date: <GMT Date>
Authorization: Auth String
Accept: application/json
Note:
Authorization: A request header that carries authentication information and is used to verify the legitimacy of the request. For details, see Request Signature.

Request header

This API only uses common request headers. For details, see Common Request Headers.

Request Parameter

The specific parameters are as follows:
Parameter Name
Description
Type
Required
datasetname
Dataset name, unique within the same account. You can query it through the console or API.
String
Yes
maxresults
Maximum number of binding relationships to return. Value range: 0-200. If this parameter is not set or is set to 0, the default value is 100.
Integer
No
nexttoken
When the total number of binding relationships exceeds the specified MaxResults, this token is used for pagination. Starting from NextToken, the binding relationship information list is returned in lexicographic order. Set this parameter to empty when calling this API for the first time.
String
No

Request body

This request has no request body.

Response

Response Headers

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

Response Body

{
"Bindings": [{
"CreateTime": "2023-12-25 19:18:19.809729971 +0800 CST",
"DatasetName": "test",
"State": "Running",
"URI": "cos://examplebucket1-1250000000",
"UpdateTime": "2023-12-25 19:18:19.809730114 +0800 CST"
}, {
"CreateTime": "2023-12-25 19:18:19.809729971 +0800 CST",
"DatasetName": "test",
"State": "Running",
"URI": "cos://examplebucket2-1250000000",
"UpdateTime": "2023-12-25 19:18:19.809730114 +0800 CST"
}],
"NextToken": "2:1250000000:test",
"RequestId": "NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****"
}
The specific data content of the response body is as follows:
Parameter Name
Type
Description
Bindings
Container Array
List of binding relationship information between datasets and COS buckets
NextToken
String
When the total number of binding relationships exceeds the specified MaxResults, this token is used for pagination. The next time binding relationship information is listed, use this value as NextToken to return the results that were not returned. This parameter has a value only when not all binding relationships are returned.
RequestId
String
Request ID.
Bindings node content:
Parameter Name
Type
Description
CreateTime
String
Timestamp of the creation time of the binding relationship between the dataset and the COS Bucket, in RFC3339Nano format
DatasetName
String
Data set name
State
String
Status of the binding relationship between the dataset and the COS Bucket. Valid values:
Running: The binding relationship is running.
URI
String
Resource identifier field. Indicates the resource to be bound with the dataset. Currently, only COS Buckets are supported. Field rule: cos://<BucketName>, where BucketName indicates the COS Bucket name. Example: cos://examplebucket-1250000000.
UpdateTime
String
Timestamp of the modification time of the binding relationship between the dataset and the COS Bucket, in RFC3339Nano format.
After a binding relationship is created, if it has not been paused or restarted, the timestamp of the modification time is the same as the timestamp of the creation time.
StockState
String
Status of the existing index corresponding to the currently bound Bucket. Valid values:
NoIndexing: Existing files are not indexed.
Indexing: Existing file indexes are being created.
Success: Existing file indexes have been created.


도움말 및 지원

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

피드백