All Products
Search
Document Center

Drive and Photo Service:UpdateFile

Last Updated:Mar 23, 2026

Memperbarui metadata file. Operasi ini tidak mengubah konten file.

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

Parameter permintaan

Parameter

Type

Required

Description

Example

domain_id

string

Yes

body

object

No

Badan permintaan.

drive_id

string

Yes

ID drive.

1

file_id

string

Yes

ID file.

9520943DC264

name

string

No

Nama file. Harus berupa string yang dikodekan dalam UTF-8 dan panjangnya tidak boleh melebihi 1.024 byte.

a.jpg

description

string

No

Deskripsi file, dibatasi hingga 1.024 karakter.

VIP user

labels

array

No

Label yang diterapkan pada file. Anda dapat menambahkan hingga 100 label.

string

No

Sebuah label. Panjang maksimum adalah 128 karakter.

animal

check_name_mode

string

No

Kebijakan yang diterapkan ketika file dengan nama yang sama sudah ada. Nilai yang valid:

ignore: Mengizinkan pembuatan file dengan nama yang sama.

auto_rename: Jika file dengan nama yang sama sudah ada, sistem secara otomatis mengganti nama file baru tersebut. Secara default, timestamp ditambahkan ke nama file, contohnya xxx_20060102_150405.

refuse: Jika file dengan nama yang sama sudah ada, permintaan ditolak, dan detail file yang sudah ada dikembalikan.

Nilai default-nya adalah ignore.

Valid values:

  • refuse :

    refuse

  • auto_rename :

    auto_rename

  • ignore :

    ignore

ignore

local_modified_at

string

No

Waktu modifikasi file di mesin lokal. Timestamp ini harus dalam UTC dan diformat sebagai string ISO 8601: YYYY-MM-DDTHH:mm:ssZ.

2019-08-20T06:51:27.292Z

hidden

boolean

No

Menentukan apakah file disembunyikan.

true

starred

boolean

No

Menentukan apakah file diberi tanda bintang (starred).

true

Elemen respons

Element

Type

Description

Example

File

Informasi file.

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.