Updated on 2025-09-08 GMT+08:00

Querying Details about a File

Function

Query details about a file.

Calling Method

For details, see Calling APIs.

URI

GET /devreposerver/v5/files/info

Table 1 Query Parameters

Parameter

Mandatory

Type

Description

file_name

Yes

String

Definition:

File name.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

status

String

Definition:

Request status.

Value range:

success: The request is successful.

error: The request fails.

trace_id

String

Definition:

Request ID, which uniquely identifies the current request.

Value range:

A string of digits and hyphens (-).

result

RepoFileDOV5 object

Definition:

File information.

Value range:

N/A

Table 3 RepoFileDOV5

Parameter

Type

Description

id

String

Definition:

ID.

Value range:

N/A

file_id

String

Definition:

File ID.

Value range:

N/A

repo_name

String

Definition:

Repository ID.

Value range:

N/A

project_name

String

Definition:

Project name.

Value range:

N/A

parent_id

String

Definition:

Parent directory ID.

Value range:

N/A

name

String

Definition:

File name.

Value range:

N/A

file_name

String

Definition:

File name.

Value range:

N/A

type

String

Definition:

File type. folder indicates a directory, and file indicates a file.

Value range:

N/A

category

String

Definition:

Release package status. test indicates a test package, and prod indicates a release package.

Value range:

N/A

extension

String

Definition:

File name extension.

Value range:

N/A

path

String

Definition:

File path.

Value range:

N/A

full_path

String

Definition:

File path (including the project).

Value range:

N/A

size

Long

Definition:

File size (in bytes).

Value range:

N/A

md5

String

Definition:

MD5.

Value range:

N/A

sha256

String

Definition:

SHA-256.

Value range:

N/A

download_url

String

Definition:

Download address.

Value range:

N/A

download_url_with_id

String

Definition:

Download address with an ID.

Value range:

N/A

web_url

String

Definition:

web_url.

Value range:

N/A

version_enable

Boolean

Definition:

version_enable.

Value range:

N/A

migrated_state

Integer

Definition:

migrated_state.

Value range:

N/A

upload_id

String

Definition:

upload_id.

Value range:

N/A

Example Requests

Query details about a file.

https://{URL}/devreposerver/v5/files/info?file_name=f132b62084774001b84c294c0eef27f2/tool_version.json

Example Responses

Status code: 200

OK

{
  "status" : "success",
  "trace_id" : "290e1f8beed846c6ae3ea11c8dc30ed9",
  "result" : {
    "status" : "active",
    "region" : "xx-xxxxx-7",
    "id" : "a3770843d8594b0a9b3a1131a613689a",
    "name" : "tool_version.json",
    "type" : "file",
    "category" : "test",
    "extension" : "json",
    "path" : "/",
    "size" : 157,
    "md5" : "c25d932898e4b63d1447d9c37b957513",
    "sha256" : "bd992ba958893fa9aabdf63fecbfdaf91583959b9c383054c5a5f66c9b109887",
    "domain_id" : "09d2ca2f5080d5b60f51c00ae5bad0a0",
    "created_time" : "2025-05-13 16:55:53",
    "modified_time" : "2025-05-13 16:55:53",
    "created_user_id" : "09d2ca2ffd00d3c21ff8c00a4dd1e080",
    "created_user_name" : "devcloud_devcloud_y00226182_05",
    "modified_user_id" : "09d2ca2ffd00d3c21ff8c00a4dd1e080",
    "modified_user_name" : "devcloud_devcloud_y00226182_05",
    "build_version" : "latest",
    "repo_url" : "",
    "project_id" : "f132b62084774001b84c294c0eef27f2",
    "file_id" : "3fe9d7a21bf04df2b0159ae958b6f9ad",
    "repo_name" : "xx-xxxxx-7_f132b62084774001b84c294c0eef27f2_generic_0",
    "parent_id" : "0",
    "download_url" : "DevRepoServer/v1/files/download?filename=f132b62084774001b84c294c0eef27f2/tool_version.json",
    "download_url_with_id" : "DevRepoServer/v1/files/download?file_id=a3770843d8594b0a9b3a1131a613689a",
    "web_url" : "releaseman/project/f132b62084774001b84c294c0eef27f2/private/general?parentId=0",
    "version_enable" : false,
    "migrated_state" : 3,
    "repo_same_trash_file_name" : "trash_3fe9d7a21bf04df2b0159ae958b6f9ad_tool_version.json",
    "repo_file_path" : "/tool_version.json"
  }
}

Status Codes

Status Code

Description

200

OK

Error Codes

See Error Codes.