All Products
Search
Document Center

Drive and Photo Service:SearchFile

Last Updated:Mar 05, 2026

Mencari file.

Deskripsi operasi

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

POST /v2/file/search HTTP/1.1

Parameter permintaan

Parameter

Type

Required

Description

Example

body

object

No

drive_id

string

No

ID drive.

1

query

string

Yes

Kondisi pencarian. Pencarian fuzzy berdasarkan nama file atau nama direktori didukung. Nilai parameter ini dapat mencapai panjang maksimum 4.096 karakter.

name="123"

order_by

string

No

Bidang yang digunakan untuk mengurutkan entri yang dikembalikan. Nilai default: created_at. Nilai yang valid: * created_at: mengurutkan entri berdasarkan waktu pembuatan. * updated_at: mengurutkan entri berdasarkan waktu pembaruan. * size: mengurutkan entri berdasarkan ukuran file. * name: mengurutkan entri berdasarkan nama file. Urutan pengurutan entri yang dikembalikan. Nilai yang valid: * ASC: urutan menaik * DESC: urutan menurun Anda harus menentukan parameter ini dalam format <field> <asc>. Pisahkan beberapa bidang dengan koma (,). Bidang yang disebut lebih awal memiliki prioritas lebih tinggi daripada bidang berikutnya. Contoh: * Jika Anda ingin mengurutkan entri berdasarkan nama file secara menaik, atur parameter ini menjadi "name ASC". * Jika Anda ingin mengurutkan entri berdasarkan waktu pembuatan secara menurun, atur parameter ini menjadi "created_at DESC". * Jika Anda ingin mengurutkan entri berdasarkan waktu pembuatan secara menurun dan mengurutkan entri berdasarkan nama file secara menaik jika waktu pembuatannya sama, atur parameter ini menjadi "created_at DESC,name ASC".

name ASC

limit

integer

No

Jumlah maksimum entri yang dikembalikan. Nilai yang valid: 1 hingga 100. Jumlah entri yang dikembalikan harus kurang dari atau sama dengan nilai parameter ini.

50

marker

string

No

Nama entri tempat daftar dimulai. Entri yang namanya secara alfabetis berada setelah nilai parameter ini akan dikembalikan. Jika Anda tidak menentukan parameter ini, semua entri akan dikembalikan.\ Parameter ini secara default kosong.

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

return_total_count

boolean

No

Menentukan apakah jumlah total file yang ditemukan dikembalikan.

true

recursive

boolean

No

Menentukan apakah pencarian rekursif dilakukan pada folder yang ditentukan dengan mengatur parent_file_id dalam parameter query.

true

thumbnail_processes

object

No

Konfigurasi thumbnail. Maksimal lima thumbnail dapat dikembalikan sekaligus. Nilainya berisi pasangan kunci-nilai. Anda dapat menyesuaikan kuncinya. URL thumbnail dikembalikan berdasarkan kunci tersebut.

ImageProcess

No

Aturan yang digunakan untuk menghasilkan thumbnail gambar, video, dan dokumen.

fields

string

No

Bidang yang digunakan untuk mengembalikan informasi tambahan tentang file. Nilai yang valid: * dir_size: mengembalikan statistik setiap subfolder dalam respons. * id_path: mengembalikan nilai id_path setiap subjek anak dalam respons. * name_path: mengembalikan nilai name_path setiap subjek anak dalam respons. Anda dapat menentukan beberapa bidang dengan memisahkannya menggunakan koma (,). Contoh: "id_path,name_path,dir_size".

id_path,name_path

Elemen respons

Element

Type

Description

Example

object

Skema Respons

items

array

Daftar informasi file.

File

Informasi file

next_marker

string

Identitas sumber daya awal pada halaman berikutnya. Nilai ini kosong pada halaman terakhir.

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

total_count

integer

Jumlah total file yang sesuai dengan pencarian.

1022

Contoh

Respons sukses

JSONformat

{
  "items": [
    {
      "domain_id": "",
      "drive_id": "",
      "file_id": "",
      "name": "",
      "type": "",
      "content_type": "",
      "created_at": "",
      "updated_at": "",
      "description": "",
      "trashed_at": "",
      "file_extension": "",
      "mime_type": "",
      "mime_extension": "",
      "hidden": true,
      "size": 0,
      "starred": true,
      "status": "",
      "user_meta": "",
      "labels": [
        ""
      ],
      "upload_id": "",
      "parent_file_id": "",
      "crc64_hash": "",
      "content_hash": "",
      "content_hash_name": "",
      "download_url": "",
      "thumbnail": "",
      "category": "",
      "local_created_at": "",
      "local_modified_at": "",
      "revision_id": "",
      "investigation_info": {
        "status": 0,
        "suggestion": ""
      },
      "thumbnail_urls": {
        "key": ""
      },
      "image_media_metadata": {
        "time": "2006-01-02T15:04:05.000Z07:00",
        "width": 1920,
        "height": 1080,
        "location": "30.185453,120.218522",
        "country": "中国",
        "province": "浙江省",
        "city": "杭州市",
        "district": "滨江区",
        "township": "西兴街道",
        "address_line": "浙江省杭州市滨江区西兴街道江陵路",
        "image_tags": [
          {
            "confidence": 0.98,
            "parent_name": "运动",
            "name": "篮球",
            "tag_level": 3,
            "source": "一起打篮球",
            "centric_score": 0.877
          }
        ],
        "faces": "[{\"FaceId\":\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\",\"GroupId\":\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\",\"FaceConfidence\":0.999,\"Age\":13,\"AgeConfidence\":4,\"Gender\":\"female\",\"GenderConfidence\":1,\"Emotion\":\"none\",\"EmotionConfidence\":0.672,\"FaceAttributes\":{\"Mask\":\"none\",\"MaskConfidence\":0.894,\"Beard\":\"none\",\"BeardConfidence\":0.997,\"Glasses\":\"none\",\"GlassesConfidence\":0.999,\"Mouth\":\"close\",\"MouthConfidence\":0.937,\"Hat\":\"none\",\"HatConfidence\":0.998,\"HeadPose\":{\"Pitch\":10.684,\"Roll\":-10.707,\"Yaw\":-20.094},\"FaceBoundary\":{\"Width\":457,\"Height\":687,\"Top\":1324,\"Left\":1356}}}]",
        "faces_thumbnail": [
          {
            "face_id": "a9a66a86-73dd-4c95-8b79-1d8a49db5226",
            "face_group_id": "Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0",
            "face_thumbnail": "https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2"
          }
        ],
        "exif": "{\"Compression\":{\"value\":\"6\"},\"DateTime\":{\"value\":\"2020:08:19 17:11:11\"}}",
        "image_quality": {
          "overall_score": 0.736
        }
      },
      "ex_fields_info": {
        "key": ""
      },
      "content_uri": "",
      "streams_info": {
        "key": {
          "crc64_hash": "",
          "size": 0,
          "content_hash": "",
          "content_hash_name": "",
          "download_url": "",
          "url": "",
          "thumbnail": ""
        }
      },
      "user_tags": {
        "key": ""
      },
      "revision_version": 0,
      "video_media_metadata": {
        "time": "2006-01-02T15:04:05.000Z07:00",
        "width": 1920,
        "height": 1080,
        "location": "30.185453,120.218522",
        "country": "中国",
        "province": "浙江省",
        "city": "杭州市",
        "district": "滨江区",
        "township": "西兴街道",
        "address_line": "浙江省杭州市滨江区西兴街道江陵路",
        "video_media_video_stream": [
          {
            "duration": "22.88",
            "bitrate": "108420",
            "code_name": "h264",
            "frame_count": "90"
          }
        ],
        "video_media_audio_stream": [
          {
            "duration": "7704.573000",
            "bit_rate": "129280",
            "code_name": "aac"
          }
        ]
      },
      "punish_flag": 0,
      "id_path": "",
      "name_path": "",
      "creator_type": "",
      "creator_id": "",
      "creator_name": "",
      "last_modifier_type": "",
      "last_modifier_id": "",
      "last_modifier_name": "",
      "dir_size_info": {
        "dir_count": 0,
        "file_count": 0
      },
      "trashed": true,
      "action_list": [
        ""
      ],
      "location": "",
      "semantic_result": {
        "semantic_similarity": 0.879,
        "document_contents": [
          {
            "element_contents": [
              {
                "type": "text",
                "content": "文本片段",
                "url": "http://aliyun.com",
                "time_range": [
                  0
                ]
              }
            ]
          }
        ],
        "scene_contents": [
          {
            "time_range": [
              0
            ],
            "key_frames": [
              {
                "frame_time": 1000,
                "thumbnail_url": "http://aliyun.com"
              }
            ],
            "thumbnail_url": "http://aliyun.com"
          }
        ]
      },
      "sync_flag": true,
      "sync_device_flag": true,
      "origin_parent_file_id": "",
      "url": "",
      "custom_field_1": "",
      "custom_field_2": "",
      "auto_delete_left_sec": 0
    }
  ],
  "next_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg",
  "total_count": 1022
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.