GetDataset

Updated at:

Data source management details.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

aimiaobi:GetDataset

get

*All Resource

*

NoneNone

Request syntax

POST  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

WorkspaceId

string

Yes

The unique ID of the Alibaba Cloud Model Studio workspace. For more information, see Obtain a workspace ID.

llm-xxx

DatasetName

string

No

The name of the dataset. The name must be globally unique.

businessDataset

DatasetId

integer

No

The ID of the dataset. You must specify either this parameter or `DatasetName`.

1

Response elements

Element

Type

Description

Example

object

The response.

Data

object

The business data.

DatasetId

integer

The ID of the dataset.

1

CreateUser

string

The user who created the dataset.

xxx

CreateTime

string

The time when the dataset was created.

2024-11-12 21:46:24

DatasetType

string

The type of the dataset.

CustomSemanticSearch

DatasetName

string

The name of the dataset.

xxx

DatasetConfig

object

The search configuration of the dataset.

SearchSourceConfigs

array<object>

Third-party search: API definition.

array<object>

Third-party search: API definition.

DemoQuery

string

A sample query keyword. This keyword is used to test whether the search source is available.

可以搜索到的关键词,用来验证是否可用

Size

integer

The default number of data entries for requests and responses.

10

SearchSourceRequestConfig

object

The API request configuration.

Url

string

The API URL.

api地址

Method

string

The request method.

请求方式

ConnectTimeout

integer

The connection timeout period.

30

SocketTimeout

integer

The read timeout period.

78

Headers

array<object>

The HTTP request headers.

object

The HTTP request headers.

Name

string

The name of the parameter.

参数名称

ValueType

string

The data type of the parameter value. Default value: string.

参数值数据类型:默认string

ValueFormat

string

This parameter is valid only when `ValueType` is set to `time`.

valueType = time 时有效

Value

string

The value of the parameter.

参数值

Params

array<object>

The request path parameters.

object

The request path parameters.

Name

string

The name of the parameter.

参数名称

ValueType

string

The data type of the parameter value. Default value: string.

参数值数据类型:默认string

ValueFormat

string

This parameter is valid only when `ValueType` is set to `time`.

valueType = time 时有效

Value

string

The value of the parameter.

参数值

PathParamsEnable

boolean

Specifies whether to enable path parameters.

true

Body

string

The request body.

请求body

SearchSourceResponseConfig

object

The API response configuration.

JqNodes

array<object>

The node configurations.

array<object>

The child node configurations.

Key

string

The key of the node.

节点key

Type

string

The data type of the node. Valid values: string, number, list, object, and base.

节点数据类型:string number list object base

Path

string

The path of the node.

节点路径

JqNodes

array<object>

The child node configurations.

array<object>

The child node configurations.

xx

Key

string

The key of the node.

title

Type

string

The data type of the node. Valid values: string, number, list, object, and base.

string

Path

string

The path of the node.

.title

JqNodes

array<object>

The child node configurations.

object

The child node configurations.

Key

string

The key of the node.

title

Type

string

The data type of the node. Valid values: string, number, list, object, and base.

string

Path

string

The path of the node.

.title

SearchSourceConfig

object

The configuration items for the dataset.

TagSearchEnable

string

Specifies whether to include tags in the search. Default value: true.

true

TagGenerateEnable

string

Specifies whether to include tags in the generation. Default value: true.

true

MetadataKeyValueSearchEnable

string

Specifies whether to include the key-value pairs of metadata in the search. Default value: true.

true

MetadataKeyValueGenerateEnable

string

Specifies whether to include the key-value pairs of metadata in the generation. Default value: true.

true

DatasetDescription

string

The display name of the dataset.

xxx

SearchDatasetEnable

integer

The switch that enables or disables search for the dataset.

1

DocumentHandleConfig

object

The document processing configuration.

DisableHandleMultimodalMedia

boolean

Specifies whether to disable the processing logic for multimedia files. Default value: false.

true

AccessLevel

string

private

RequestId

string

The unique ID of the request.

1813ceee-7fe5-41b4-87e5-982a4d18cca5

Success

boolean

Indicates whether the request was successful. A value of `true` indicates success. A value of `false` indicates failure.

true

Code

string

The status code.

NoData

Message

string

The error message returned if the request fails.

success

HttpStatusCode

integer

The HTTP status code.

200

Examples

Success response

JSON format

{
  "Data": {
    "DatasetId": 1,
    "CreateUser": "xxx",
    "CreateTime": "2024-11-12 21:46:24",
    "DatasetType": "CustomSemanticSearch",
    "DatasetName": "xxx",
    "DatasetConfig": {
      "SearchSourceConfigs": [
        {
          "DemoQuery": "可以搜索到的关键词,用来验证是否可用",
          "Size": 10,
          "SearchSourceRequestConfig": {
            "Url": "api地址",
            "Method": "请求方式",
            "ConnectTimeout": 30,
            "SocketTimeout": 78,
            "Headers": [
              {
                "Name": "参数名称",
                "ValueType": "参数值数据类型:默认string",
                "ValueFormat": "valueType = time 时有效",
                "Value": "参数值"
              }
            ],
            "Params": [
              {
                "Name": "参数名称",
                "ValueType": "参数值数据类型:默认string",
                "ValueFormat": "valueType = time 时有效",
                "Value": "参数值"
              }
            ],
            "PathParamsEnable": true,
            "Body": "请求body"
          },
          "SearchSourceResponseConfig": {
            "JqNodes": [
              {
                "Key": "节点key",
                "Type": "节点数据类型:string number list object base",
                "Path": "节点路径",
                "JqNodes": [
                  {
                    "Key": "title",
                    "Type": "string",
                    "Path": ".title",
                    "JqNodes": [
                      {
                        "Key": "title",
                        "Type": "string",
                        "Path": ".title"
                      }
                    ]
                  }
                ]
              }
            ]
          }
        }
      ],
      "SearchSourceConfig": {
        "TagSearchEnable": "true",
        "TagGenerateEnable": "true",
        "MetadataKeyValueSearchEnable": "true",
        "MetadataKeyValueGenerateEnable": "true"
      }
    },
    "DatasetDescription": "xxx",
    "SearchDatasetEnable": 1,
    "DocumentHandleConfig": {
      "DisableHandleMultimodalMedia": true
    },
    "AccessLevel": "private"
  },
  "RequestId": "1813ceee-7fe5-41b4-87e5-982a4d18cca5",
  "Success": true,
  "Code": "NoData",
  "Message": "success",
  "HttpStatusCode": 200
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.