All Products
Search

This Product

    Drive and Photo Service:ListFile

    Document Center

    Drive and Photo Service:ListFile

    Last Updated:Mar 05, 2026

    Menampilkan daftar file dan folder yang berada langsung di bawah folder tertentu.

    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/list HTTP/1.1

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    body

    object

    No

    share_id

    string

    No

    ID share. Jika Anda ingin membagikan file, sertakan header `x-share-token` untuk autentikasi dalam permintaan dan tentukan share_id. Dalam kasus ini, `drive_id` tidak berlaku. Jika tidak, gunakan `AccessKey pair` atau `access token` untuk autentikasi dan tentukan `drive_id`. Anda harus menentukan salah satu dari `share_id` dan `drive_id`.

    7JQX1FswpQ8
    drive_id

    string

    No

    ID drive.

    1
    parent_file_id

    string

    Yes

    ID folder induk. Jika folder induk merupakan Direktori root, atur parameter ini ke root.

    root
    limit

    integer

    No

    Jumlah maksimum hasil 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 setelah mana 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 dibiarkan kosong.

    NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg
    status

    string

    No

    Status file yang akan dikembalikan. Nilai yang valid: available: hanya mengembalikan file normal. uploading: hanya mengembalikan file yang sedang diunggah. Secara default, hanya file dengan status available yang dikembalikan.

    Valid values:

    • available :
    • uploading :

    available
    order_by

    string

    No

    Bidang pengurutan. 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. Nilai default: created_at. Enumerasi: * updated_at: waktu pembaruan * size: ukuran file * name: nama file * created_at: waktu pembuatan

    Valid values:

    • updated_at :
    • size :
    • name :
    • created_at :

    updated_at
    order_direction

    string

    No

    Arah pengurutan. Nilai yang valid: ASC: urutan menaik DESC: urutan menurun Nilai default: ASC.

    Valid values:

    • ASC :
    • DESC :

    ASC
    category

    string

    No

    Kategori file. Nilai yang valid: app: paket instalasi zip: paket terkompresi image doc: dokumen video audio others Secara default, file dari semua kategori dikembalikan.

    Valid values:

    • app :
      app
    • zip :
      zip
    • image :
      image
    • doc :
      doc
    • video :
      video
    • audio :
      audio
    • others :
      others

    image
    type

    string

    No

    Tipe file. Nilai yang valid: file: hanya mengembalikan file. folder: hanya mengembalikan folder. Secara default, file dari semua tipe dikembalikan.

    Valid values:

    • file :
    • folder :

    file
    fields

    string

    No

    Bidang yang digunakan untuk mengembalikan informasi tambahan tentang subjek anak. Nilai yang valid: * url: mengembalikan URL Gambar mini file dalam tanggapan. * exif: mengembalikan data Exchangeable Image File Format (EXIF) file dalam tanggapan. * cropping_suggestion: mengembalikan saran pemotongan pada file dalam tanggapan. * characteristic_hash: mengembalikan nilai hash karakteristik file dalam tanggapan. * video_metadata: mengembalikan metadata file video, seperti Durasi video, bitrate, tinggi, dan lebar, dalam tanggapan. * video_preview_metadata: mengembalikan informasi Transkoding file video, seperti spesifikasi Transkoding untuk setiap definisi, dalam tanggapan. * investigation_info: mengembalikan informasi investigasi dalam tanggapan. * dir_size: mengembalikan statistik setiap subfolder dalam tanggapan. * user_tags: mengembalikan tag pengguna dari setiap subjek anak dalam tanggapan. Anda dapat menentukan beberapa bidang dengan memisahkannya menggunakan koma (,). Contoh: "url,dir_size,user_tags".

    url,dir_size,user_tags
    thumbnail_processes

    object

    No

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

    ImageProcess

    No

    Aturan yang digunakan untuk menghasilkan Gambar mini gambar, video, dan dokumen.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Tanggapan

    items

    array

    Daftar file.

    File

    Informasi file

    next_marker

    string

    Identifikasi resource awal untuk halaman berikutnya. Nilai ini kosong pada halaman terakhir.

    NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

    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"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.