ListDocs
Miàodú retrieves the list of documents.
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
Actionelement 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
Resourceelement of the policy. - For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the
Resourceelement of the policy.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the
-
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:ListDocs | list | *All Resource
| None | None |
Request parameters
Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| WorkspaceId | string | Yes | Alibaba Cloud Model Studio workspace ID. For more information, see How to Use Workspaces. | llm-2setzb9x4ewsd |
| DocName | string | No | Document name. | 企业2022年報 |
| DocType | string | No | Document type. | |
| Skip | integer | No | Skip n records for paging. | 10 |
| MaxResults | integer | No | Maximum number of results returned. | 20 |
| NextToken | string | No | Next page token. | 52a33dc83779f63641e16f5146cd7125 |
| Statuses | array | No | Document status list. | |
integer | No | Status value. | 0 | |
| CategoryId | string | No | Document folder. | default |
Response elements
Element | Type | Description | Example |
|---|---|---|---|
object | Response schema. | ||
| Code | string | Return code. | successful |
| Data | array<object> | List of returned data results. | |
object | Paging data. | ||
| CreateTime | integer | Creation time. | 2024-01-04 11:46:07 |
| DocId | string | Document ID. | 12345 |
| DocName | string | Document name. | 标题093 |
| DocType | string | Document type. | |
| Status | integer | Status. | 0 |
| StatusMessage | string | Status message. | 导入完成 |
| CategoryId | string | Document folder. | default |
| HttpStatusCode | integer | HTTP status code. | 200 |
| MaxResults | integer | Maximum number of results returned. | 10 |
| Message | string | Return message. | successful |
| NextToken | string | Next page token. | CAESGgoSChAKDGNvbXBsZXRlVGltZRABCgQiAggAGAAiQAoJANEQ4mYAAAAACjMDLgAAADFTNzMyZDMwMzAzMDM4NzA3MjZjN2E2NDYyNzUzODMxMzY3ODM0NmIzNTZkNjc= |
| RequestId | string | Request ID. | 1813ceee-7fe5-41b4-87e5-982a4d18cca5 |
| Success | boolean | Indicates whether the operation succeeded. | true |
| TotalCount | integer | Total number of records. | 70 |
Examples
Success response
JSON format
{
"Code": "successful",
"Data": [
{
"CreateTime": 0,
"DocId": "12345",
"DocName": "标题093",
"DocType": "pdf",
"Status": 0,
"StatusMessage": "导入完成",
"CategoryId": "default"
}
],
"HttpStatusCode": 200,
"MaxResults": 10,
"Message": "successful",
"NextToken": "CAESGgoSChAKDGNvbXBsZXRlVGltZRABCgQiAggAGAAiQAoJANEQ4mYAAAAACjMDLgAAADFTNzMyZDMwMzAzMDM4NzA3MjZjN2E2NDYyNzUzODMxMzY3ODM0NmIzNTZkNjc=",
"RequestId": "1813ceee-7fe5-41b4-87e5-982a4d18cca5",
"Success": true,
"TotalCount": 70
}
Error codes
HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 403 | NoPermission | You are not authorized to perform this action. | Please check the workspaceId assignment |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.