tencent cloud

Cloud Infinite

Querying Dataset-Bucket Binding Relationships

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

Feature Description

Query the binding relationship between a dataset and a specified Cloud Object Storage (COS) Bucket.

Authorization Description

When using a sub-account, add the ci:DescribeDatasetBinding permission to the action of the authorization policy. For all operation 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 /datasetbinding?datasetname=test&uri=cos%3A%2F%2Fexample-1250000000 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 Parameters

Parameter Name
Description
Type
Required
datasetname
Dataset name, unique within the same account. You can query it through the console or API.
String
Yes
uri
Resource identifier field. Indicates the resource for which the binding relationship with the dataset needs to be queried. Currently, only COS Buckets are supported. Field rule: cos://<BucketName>, where BucketName indicates the COS Bucket name. Example (URL Encode required): cos%3A%2F%2Fexample-1250000000.
String
Yes

Request body

The request body of this request is empty.

Response

Response Headers

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

Response Body

{
"Binding": {
"CreateTime": "2023-12-26 17:28:33.617269703 +0800 CST",
"DatasetName": "test",
"State": "Running",
"StockState": "Indexing",
"URI": "cos://examplebucket2-1250000000",
"UpdateTime": "2023-12-26 17:28:33.617269858 +0800 CST"
},
"RequestId": "NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****"
}
The specific data content of the response body is as follows:
Parameter Name
Type
Description
Binding
Container
Information about the binding relationship between the dataset and COS buckets
RequestId
String
Request ID.
Binding 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.
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.
URI
String
Resource identifier field. Indicates the resource for which the binding relationship with the dataset needs to be queried. Currently, only COS Buckets are supported. Field rule: cos://<BucketName>, where BucketName indicates the COS Bucket name. Example: cos://examplebucket-1250000000.
UpdateTime
String
The 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 binding relationship modification time is the same as the timestamp of the binding relationship creation time.


도움말 및 지원

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

피드백