ListDocs

Updated at:

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 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:ListDocs

list

*All Resource

*

NoneNone

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.

pdf

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.

pdf

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

403NoPermissionYou 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.