> ## Documentation Index > Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt > Use this file to discover all available pages before exploring further. # Menerapkan file > Panggil API ini untuk menerapkan (commit) file di DingTalk Docs. Pelajari metode panggilan API, parameter permintaan, dan struktur respons untuk mengunggah file ke penyimpanan organisasi. Panggil API ini untuk menerapkan (commit) file. ## Deskripsi panggilan API Langkah-langkah panggilan API adalah sebagai berikut: Langkah 1: Panggil API [Memperoleh informasi unggahan file](/id/open/development/obtain-file-upload-informations) untuk memperoleh informasi yang diperlukan untuk mengunggah file. Langkah 2: Unggah file menggunakan metode OSS header sign request. Lihat contoh berikut: Java ```java theme={"theme":{"light":"github-light","dark":"github-dark"}} import java.io.*; import java.net.HttpURLConnection; import java.net.URL; public void test(){ // Ambil URL dari respons API String resourceUrl = "resourceUrls yang diperoleh dari API pada langkah 1"; // Ambil headers dari respons API Map headers = headers yang diperoleh dari API pada langkah 1; URL url = new URL(resourceUrl); HttpURLConnection connection = (HttpURLConnection)url.openConnection(); if (headers != null) { for (Map.Entry entry : headers.entrySet()) { connection.setRequestProperty(entry.getKey(), entry.getValue()); } } connection.setDoOutput(true); connection.setRequestMethod("PUT"); connection.setUseCaches(false); connection.setReadTimeout(10000); connection.setConnectTimeout(10000); connection.connect(); OutputStream out = connection.getOutputStream(); InputStream is = new FileInputStream(new File("/Users/xxxxx/Desktop/test_file.xls")); byte[] b =new byte[1024]; int temp; while ((temp=is.read(b))!=-1){ out.write(b,0,temp); } out.flush(); out.close(); int responseCode = connection.getResponseCode(); connection.disconnect(); if (responseCode == 200) { System.out.println("Upload succeeded"); } else { System.out.println("Upload failed"); } } ``` Python ```python theme={"theme":{"light":"github-light","dark":"github-dark"}} #!/usr/bin/env python import requests url = '' headers = result = requests.put(url, data=open('', 'rb'), headers=headers) print(result) ``` C# ```java theme={"theme":{"light":"github-light","dark":"github-dark"}} public static string HttpRequest(string url, string filePath, Dictionary headers) { FileStream fileStream = new FileStream(filePath, FileMode.Open, FileAccess.Read, FileShare.Read); BinaryReader reader = new BinaryReader(fileStream); reader.BaseStream.Seek(0, SeekOrigin.Begin); byte[] datas = reader.ReadBytes((int)reader.BaseStream.Length); HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url); request.Method = "PUT"; request.Timeout = 150000; foreach (var header in headers) { request.Headers.Add($"{header.Key}", $"{header.Value}"); } Stream requestStream = null; string responseStr = null; try { if (datas != null) { request.ContentLength = datas.Length; requestStream = request.GetRequestStream(); requestStream.Write(datas, 0, datas.Length); requestStream.Close(); } else { request.ContentLength = 0; } HttpWebResponse response = request.GetResponse() as HttpWebResponse; responseStr = response.Headers.GetValues("x-oss-request-id")[0]; } catch (Exception ex) { Console.WriteLine("error"); } finally { request = null; requestStream = null; } return responseStr; } ``` PHP ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} $url = $result->body->headerSignatureInfo->resourceUrls[0]; $headersSource = $result->body->headerSignatureInfo->headers; foreach ($headersSource as $key => $value) { $headers[] = $key . ': ' . $value; } // Anda harus secara eksplisit menetapkan Content-Type menjadi kosong $headers['Content-Type'] = ''; $file = '/Users/dengxian.ldx/Desktop/test.txt'; $ch = curl_init(); curl_setopt_array($ch, array( CURLOPT_URL => $url, CURLOPT_RETURNTRANSFER => true, CURLOPT_HEADER => true, CURLOPT_TIMEOUT => 100, CURLOPT_CONNECTTIMEOUT => 100, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_PUT => true, CURLOPT_HTTPHEADER => $headers, CURLOPT_SSL_VERIFYPEER => false, CURLOPT_SSL_VERIFYHOST => false, )); curl_setopt($ch, CURLOPT_INFILE, fopen($file , 'rb')); curl_setopt($ch, CURLOPT_INFILESIZE, filesize($file) ); curl_setopt($ch, CURLOPT_UPLOAD, true); $response = curl_exec($ch); curl_close($ch); echo $response .PHP_EOL; ``` Node.js ```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}} const fs = require('fs'); const request = require('request-promise'); url = ; header = ; // Catatan: Anda harus secara eksplisit menetapkan content-type menjadi kosong headers['content-type']=''; var options = { method: 'PUT', url: url, headers: headers }; fs.createReadStream('/Users/dengxian.ldx/temp/test/a.txt').pipe(request(options)).then(body =>{ console.log(body); }).catch(err => { console.log(err); }); ``` Langkah 3: Panggil API ini untuk menerapkan (commit) file dan menyelesaikan unggahan. ### Catatan * Ketika tipe ruang penyimpanan adalah USER, semua pengguna dengan izin pada ruang tersebut memiliki hak operasi. Karyawan lain harus memanggil API [Menambahkan izin](/id/open/development/add-permissions-file) untuk memberikan otorisasi. * Ketika tipe ruang penyimpanan adalah APP, setiap operator harus memanggil API [Menambahkan izin](/id/open/development/add-permissions-file) untuk memberikan otorisasi. ## Permintaan ### Informasi dasar | Bidang | Nilai | | --------------------------- | ----------------------------------------------------------------------------- | | URL HTTP | `https://api.dingtalk.io/v2.0/storage/spaces/files/{parentDentryUuid}/commit` | | Metode HTTP | POST | | Tipe aplikasi yang didukung | appType-Aplikasi internal　appType-Aplikasi perusahaan pihak ketiga | | Persyaratan izin | permission-Storage.File.Write-Izin tulis file penyimpanan organisasi | ### Header permintaan | Nama | Tipe | Wajib | Deskripsi | | --------------------------- | ------ | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | x-acs-dingtalk-access-token | String | Ya | Kredensial akses untuk memanggil API ini. Peroleh sebagai berikut: - Untuk aplikasi internal, panggil API [Memperoleh access token aplikasi internal](/id/open/development/obtain-the-access-token-of-an-internal-app#). - Untuk aplikasi perusahaan pihak ketiga, panggil API [Memperoleh access token perusahaan yang diotorisasi dari aplikasi pihak ketiga](https://open.dingtalk.com/document/development/obtain-the-access-token-of-the-authorized-enterprise-1#). | ### Parameter jalur | Nama | Tipe | Wajib | Deskripsi | | ---------------- | ------ | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | parentDentryUuid | String | Ya | dentryUuid dari node induk. Panggil API [Pencarian File](/id/open/development/search-for-files#) atau [Memperoleh informasi dentryUuid](/id/open/development/api-getuuidbydentryid#) untuk memperoleh bidang `dentryUuid` dari respons. Untuk direktori root ruang, teruskan dentryUuid dari direktori root ruang. | ### Parameter kueri | Nama | Tipe | Wajib | Deskripsi | | ------- | ------ | ----- | ------------------------------------------------------------------------------------------------------------------------ | | unionId | String | Ya | unionId pengguna. Panggil API [Mengkueri detail pengguna](/id/open/development/query-user-details#) untuk memperolehnya. | ### Isi permintaan | Nama | Tipe | Wajib | Deskripsi | | | ------------------ | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | | uploadKey | String | Ya | Pengenal unik dari file yang akan ditambahkan. Panggil API [Memperoleh informasi unggahan file](/id/open/development/obtain-file-upload-informations#) untuk memperoleh nilai parameter uploadKey. | | | name | String | Ya | Nama file, termasuk ekstensinya. Aturan penamaan:- Tidak boleh ada spasi di awal atau akhir; jika tidak, akan dipangkas secara otomatis. - Tidak boleh ada karakter khusus, termasuk tab, `*`, `"`, `<`, `>`, \` | `. - Tidak boleh diakhiri dengan `.\`. | | option | Object | Tidak | Parameter opsional. | | | size | Long | Tidak | Ukuran file default, dalam byte. Jika bidang ini tidak kosong, sistem penyimpanan organisasi memverifikasi apakah ukuran file sebenarnya sesuai dengan nilai ini. Ketidaksesuaian menyebabkan error. | | | conflictStrategy | String | Tidak | Strategi konflik nama file. - **AUTO\_RENAME**: Ganti nama secara otomatis. Default. - **OVERWRITE**: Timpa. - **RETURN\_DENTRY\_IF\_EXISTS**: Kembalikan file yang ada. - **RETURN\_ERROR\_IF\_EXISTS**: Kembalikan error jika file sudah ada. | | | appProperties | Array | Tidak | Daftar properti aplikasi dari file saat ini. Maksimum: 3. | | | name | String | Ya | Nama properti. Nama properti harus unik dalam aplikasi saat ini. Properti dengan nama yang sama pada aplikasi berbeda tidak saling memengaruhi. | | | value | String | Ya | Nilai properti. | | | visibility | String | Ya | Visibilitas properti. - **PUBLIC**: Terlihat oleh semua aplikasi. - **PRIVATE**: Hanya terlihat oleh aplikasi saat ini. | | | convertToOnlineDoc | Boolean | Tidak | Apakah akan mengonversi menjadi dokumen online. - **false** (default): Tidak. - **true**: Ya. | | ### Contoh permintaan HTTP ```http theme={"theme":{"light":"github-light","dark":"github-dark"}} POST /v2.0/storage/spaces/files/uuid/commit?unionId=union_id HTTP/1.1 Host:api.dingtalk.io x-acs-dingtalk-access-token:xxxxx Content-Type:application/json { "uploadKey" : "upload_key", "name" : "dentry_name", "option" : { "size" : 512, "conflictStrategy" : "AUTO_RENAME", "appProperties" : [ { "name" : "property_name", "value" : "property_value", "visibility" : "PRIVATE" } ], "convertToOnlineDoc" : false } } ``` Java ```java theme={"theme":{"light":"github-light","dark":"github-dark"}} // This file is auto-generated, don't edit it. Thanks. package com.aliyun.sample; import com.aliyun.tea.*; public class Sample { /** * Initialize the account Client with a Token * @return Client * @throws Exception */ public static com.aliyun.dingtalkstorage_2_0.Client createClient() throws Exception { com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config(); config.protocol = "https"; config.regionId = "central"; return new com.aliyun.dingtalkstorage_2_0.Client(config); } public static void main(String[] args_) throws Exception { java.util.List args = java.util.Arrays.asList(args_); com.aliyun.dingtalkstorage_2_0.Client client = Sample.createClient(); com.aliyun.dingtalkstorage_2_0.models.CommitFileHeaders commitFileHeaders = new com.aliyun.dingtalkstorage_2_0.models.CommitFileHeaders(); commitFileHeaders.xAcsDingtalkAccessToken = ""; com.aliyun.dingtalkstorage_2_0.models.CommitFileRequest.CommitFileRequestOptionAppProperties optionAppProperties0 = new com.aliyun.dingtalkstorage_2_0.models.CommitFileRequest.CommitFileRequestOptionAppProperties() .setName("property_name") .setValue("property_value") .setVisibility("PRIVATE"); com.aliyun.dingtalkstorage_2_0.models.CommitFileRequest.CommitFileRequestOption option = new com.aliyun.dingtalkstorage_2_0.models.CommitFileRequest.CommitFileRequestOption() .setSize(512L) .setConflictStrategy("AUTO_RENAME") .setAppProperties(java.util.Arrays.asList( optionAppProperties0 )) .setConvertToOnlineDoc(false); com.aliyun.dingtalkstorage_2_0.models.CommitFileRequest commitFileRequest = new com.aliyun.dingtalkstorage_2_0.models.CommitFileRequest() .setUnionId("union_id") .setUploadKey("upload_key") .setName("dentry_name") .setOption(option); try { client.commitFileWithOptions("uuid", commitFileRequest, commitFileHeaders, new com.aliyun.teautil.models.RuntimeOptions()); } catch (TeaException err) { if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) { // err berisi properti code dan message untuk membantu developer menemukan masalah } } catch (Exception _err) { TeaException err = new TeaException(_err.getMessage(), _err); if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) { // err berisi properti code dan message untuk membantu developer menemukan masalah } } } } ``` Python ```python theme={"theme":{"light":"github-light","dark":"github-dark"}} # -*- coding: utf-8 -*- # This file is auto-generated, don't edit it. Thanks. import sys from typing import List from alibabacloud_dingtalk.storage_2_0.client import Client as dingtalkstorage_2_0Client from alibabacloud_tea_openapi import models as open_api_models from alibabacloud_dingtalk.storage_2_0 import models as dingtalkstorage__2__0_models from alibabacloud_tea_util import models as util_models from alibabacloud_tea_util.client import Client as UtilClient class Sample: def __init__(self): pass @staticmethod def create_client() -> dingtalkstorage_2_0Client: """ Initialize the account Client with a Token @return: Client @throws Exception """ config = open_api_models.Config() config.protocol = 'https' config.region_id = 'central' return dingtalkstorage_2_0Client(config) @staticmethod def main( args: List[str], ) -> None: client = Sample.create_client() commit_file_headers = dingtalkstorage__2__0_models.CommitFileHeaders() commit_file_headers.x_acs_dingtalk_access_token = '' option_app_properties_0 = dingtalkstorage__2__0_models.CommitFileRequestOptionAppProperties( name='property_name', value='property_value', visibility='PRIVATE' ) option = dingtalkstorage__2__0_models.CommitFileRequestOption( size=512, conflict_strategy='AUTO_RENAME', app_properties=[ option_app_properties_0 ], convert_to_online_doc=False ) commit_file_request = dingtalkstorage__2__0_models.CommitFileRequest( union_id='union_id', upload_key='upload_key', name='dentry_name', option=option ) try: client.commit_file_with_options('uuid', commit_file_request, commit_file_headers, util_models.RuntimeOptions()) except Exception as err: if not UtilClient.empty(err.code) and not UtilClient.empty(err.message): # err berisi properti code dan message untuk membantu developer menemukan masalah pass @staticmethod async def main_async( args: List[str], ) -> None: client = Sample.create_client() commit_file_headers = dingtalkstorage__2__0_models.CommitFileHeaders() commit_file_headers.x_acs_dingtalk_access_token = '' option_app_properties_0 = dingtalkstorage__2__0_models.CommitFileRequestOptionAppProperties( name='property_name', value='property_value', visibility='PRIVATE' ) option = dingtalkstorage__2__0_models.CommitFileRequestOption( size=512, conflict_strategy='AUTO_RENAME', app_properties=[ option_app_properties_0 ], convert_to_online_doc=False ) commit_file_request = dingtalkstorage__2__0_models.CommitFileRequest( union_id='union_id', upload_key='upload_key', name='dentry_name', option=option ) try: await client.commit_file_with_options_async('uuid', commit_file_request, commit_file_headers, util_models.RuntimeOptions()) except Exception as err: if not UtilClient.empty(err.code) and not UtilClient.empty(err.message): # err berisi properti code dan message untuk membantu developer menemukan masalah pass if __name__ == '__main__': Sample.main(sys.argv[1:]) ``` PHP ```java theme={"theme":{"light":"github-light","dark":"github-dark"}} protocol = "https"; $config->regionId = "central"; return new Dingtalk($config); } /** * @param string[] $args * @return void */ public static function main($args){ $client = self::createClient(); $commitFileHeaders = new CommitFileHeaders([]); $commitFileHeaders->xAcsDingtalkAccessToken = ""; $optionAppProperties0 = new appProperties([ "name" => "property_name", "value" => "property_value", "visibility" => "PRIVATE" ]); $option = new option([ "size" => 512, "conflictStrategy" => "AUTO_RENAME", "appProperties" => [ $optionAppProperties0 ], "convertToOnlineDoc" => false ]); $commitFileRequest = new CommitFileRequest([ "unionId" => "union_id", "uploadKey" => "upload_key", "name" => "dentry_name", "option" => $option ]); try { $client->commitFileWithOptions("uuid", $commitFileRequest, $commitFileHeaders, new RuntimeOptions([])); } catch (Exception $err) { if (!($err instanceof TeaError)) { $err = new TeaError([], $err->getMessage(), $err->getCode(), $err); } if (!Utils::empty_($err->code) && !Utils::empty_($err->message)) { // err berisi properti code dan message untuk membantu developer menemukan masalah } } } } $path = __DIR__ . \DIRECTORY_SEPARATOR . '..' . \DIRECTORY_SEPARATOR . 'vendor' . \DIRECTORY_SEPARATOR . 'autoload.php'; if (file_exists($path)) { require_once $path; } Sample::main(array_slice($argv, 1)); ``` Go ```go theme={"theme":{"light":"github-light","dark":"github-dark"}} // This file is auto-generated, don't edit it. Thanks. package main import ( "os" util "github.com/alibabacloud-go/tea-utils/v2/service" dingtalkstorage_2_0 "github.com/alibabacloud-go/dingtalk/storage_2_0" openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client" "github.com/alibabacloud-go/tea/tea" ) /** * Initialize the account Client with a Token * @return Client * @throws Exception */ func CreateClient () (_result *dingtalkstorage_2_0.Client, _err error) { config := &openapi.Config{} config.Protocol = tea.String("https") config.RegionId = tea.String("central") _result = &dingtalkstorage_2_0.Client{} _result, _err = dingtalkstorage_2_0.NewClient(config) return _result, _err } func _main (args []*string) (_err error) { client, _err := CreateClient() if _err != nil { return _err } commitFileHeaders := &dingtalkstorage_2_0.CommitFileHeaders{} commitFileHeaders.XAcsDingtalkAccessToken = tea.String("") optionAppProperties0 := &dingtalkstorage_2_0.CommitFileRequestOptionAppProperties{ Name: tea.String("property_name"), Value: tea.String("property_value"), Visibility: tea.String("PRIVATE"), } option := &dingtalkstorage_2_0.CommitFileRequestOption{ Size: tea.Int64(512), ConflictStrategy: tea.String("AUTO_RENAME"), AppProperties: []*dingtalkstorage_2_0.CommitFileRequestOptionAppProperties{optionAppProperties0}, ConvertToOnlineDoc: tea.Bool(false), } commitFileRequest := &dingtalkstorage_2_0.CommitFileRequest{ UnionId: tea.String("union_id"), UploadKey: tea.String("upload_key"), Name: tea.String("dentry_name"), Option: option, } tryErr := func()(_e error) { defer func() { if r := tea.Recover(recover()); r != nil { _e = r } }() _, _err = client.CommitFileWithOptions(tea.String("uuid"), commitFileRequest, commitFileHeaders, &util.RuntimeOptions{}) if _err != nil { return _err } return nil }() if tryErr != nil { var err = &tea.SDKError{} if _t, ok := tryErr.(*tea.SDKError); ok { err = _t } else { err.Message = tea.String(tryErr.Error()) } if !tea.BoolValue(util.Empty(err.Code)) && !tea.BoolValue(util.Empty(err.Message)) { // err berisi properti code dan message untuk membantu developer menemukan masalah } } return _err } func main() { err := _main(tea.StringSlice(os.Args[1:])) if err != nil { panic(err) } } ``` Node.js ```python theme={"theme":{"light":"github-light","dark":"github-dark"}} // This file is auto-generated, don't edit it import Util, * as $Util from '@alicloud/tea-util'; import dingtalkstorage_2_0, * as $dingtalkstorage_2_0 from '@alicloud/dingtalk/storage_2_0'; import OpenApi, * as $OpenApi from '@alicloud/openapi-client'; import * as $tea from '@alicloud/tea-typescript'; export default class Client { /** * Initialize the account Client with a Token * @return Client * @throws Exception */ static createClient(): dingtalkstorage_2_0 { let config = new $OpenApi.Config({ }); config.protocol = "https"; config.regionId = "central"; return new dingtalkstorage_2_0(config); } static async main(args: string[]): Promise { let client = Client.createClient(); let commitFileHeaders = new $dingtalkstorage_2_0.CommitFileHeaders({ }); commitFileHeaders.xAcsDingtalkAccessToken = ""; let optionAppProperties0 = new $dingtalkstorage_2_0.CommitFileRequestOptionAppProperties({ name: "property_name", value: "property_value", visibility: "PRIVATE", }); let option = new $dingtalkstorage_2_0.CommitFileRequestOption({ size: 512, conflictStrategy: "AUTO_RENAME", appProperties: [ optionAppProperties0 ], convertToOnlineDoc: false, }); let commitFileRequest = new $dingtalkstorage_2_0.CommitFileRequest({ unionId: "union_id", uploadKey: "upload_key", name: "dentry_name", option: option, }); try { await client.commitFileWithOptions("uuid", commitFileRequest, commitFileHeaders, new $Util.RuntimeOptions({ })); } catch (err) { if (!Util.empty(err.code) && !Util.empty(err.message)) { // err berisi properti code dan message untuk membantu developer menemukan masalah } } } } Client.main(process.argv.slice(2)); ``` C# ```java theme={"theme":{"light":"github-light","dark":"github-dark"}} // This file is auto-generated, don't edit it. Thanks. using System; using System.Collections; using System.Collections.Generic; using System.IO; using System.Threading.Tasks; using Tea; using Tea.Utils; namespace AlibabaCloud.SDK.Sample { public class Sample { /** * Initialize the account Client with a Token * @return Client * @throws Exception */ public static AlibabaCloud.SDK.Dingtalkstorage_2_0.Client CreateClient() { AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config(); config.Protocol = "https"; config.RegionId = "central"; return new AlibabaCloud.SDK.Dingtalkstorage_2_0.Client(config); } public static void Main(string[] args) { AlibabaCloud.SDK.Dingtalkstorage_2_0.Client client = CreateClient(); AlibabaCloud.SDK.Dingtalkstorage_2_0.Models.CommitFileHeaders commitFileHeaders = new AlibabaCloud.SDK.Dingtalkstorage_2_0.Models.CommitFileHeaders(); commitFileHeaders.XAcsDingtalkAccessToken = ""; AlibabaCloud.SDK.Dingtalkstorage_2_0.Models.CommitFileRequest.CommitFileRequestOption.CommitFileRequestOptionAppProperties optionAppProperties0 = new AlibabaCloud.SDK.Dingtalkstorage_2_0.Models.CommitFileRequest.CommitFileRequestOption.CommitFileRequestOptionAppProperties { Name = "property_name", Value = "property_value", Visibility = "PRIVATE", }; AlibabaCloud.SDK.Dingtalkstorage_2_0.Models.CommitFileRequest.CommitFileRequestOption option = new AlibabaCloud.SDK.Dingtalkstorage_2_0.Models.CommitFileRequest.CommitFileRequestOption { Size = 512, ConflictStrategy = "AUTO_RENAME", AppProperties = new List { optionAppProperties0 }, ConvertToOnlineDoc = false, }; AlibabaCloud.SDK.Dingtalkstorage_2_0.Models.CommitFileRequest commitFileRequest = new AlibabaCloud.SDK.Dingtalkstorage_2_0.Models.CommitFileRequest { UnionId = "union_id", UploadKey = "upload_key", Name = "dentry_name", Option = option, }; try { client.CommitFileWithOptions("uuid", commitFileRequest, commitFileHeaders, new AlibabaCloud.TeaUtil.Models.RuntimeOptions()); } catch (TeaException err) { if (!AlibabaCloud.TeaUtil.Common.Empty(err.Code) && !AlibabaCloud.TeaUtil.Common.Empty(err.Message)) { // err berisi properti code dan message untuk membantu developer menemukan masalah } } catch (Exception _err) { TeaException err = new TeaException(new Dictionary { { "message", _err.Message } }); if (!AlibabaCloud.TeaUtil.Common.Empty(err.Code) && !AlibabaCloud.TeaUtil.Common.Empty(err.Message)) { // err berisi properti code dan message untuk membantu developer menemukan masalah } } } } } ``` ## Respons ### Isi respons | Nama | Tipe | Deskripsi | | ------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | dentry | Object | Informasi file. | | id | String | ID file. | | spaceId | String | ID ruang tempat file berada. | | parentId | String | ID direktori induk. Untuk direktori root, nilai ini adalah 0. Nilai kosong berarti direktori root tidak memiliki parentId. | | type | String | Tipe, berupa directory atau file. Nilai enum: - **FILE**: File. - **FOLDER**: Folder. | | name | String | Nama file. | | size | Long | Ukuran file, dalam byte. | | path | String | Jalur file dalam ruang. | | version | Long | Versi. | | status | String | Status: - **NORMAL**: Normal. - **DELETED**: Dihapus. - **EXPIRED**: Kedaluwarsa. | | extension | String | Ekstensi file. | | creatorId | String | unionId pembuat. | | modifierId | String | unionId pemodifikasi. | | createTime | String | Waktu pembuatan dalam format ISO 8601, contoh, 2022-07-29T14:55Z. | | modifiedTime | String | Waktu modifikasi dalam format ISO 8601, contoh, 2022-07-29T14:55Z. | | properties | Object | Properti file. | | readOnly | Boolean | Apakah file bersifat hanya baca. - **true**: Ya. - **false**: Tidak. | | appProperties | `Map` | Properti pada aplikasi tertentu. Key adalah ownerId ruang, dan value adalah daftar properti. | | | Array | Daftar properti. | | name | String | Nama properti. | | value | String | Nilai properti. | | visibility | String | Visibilitas properti. - **PUBLIC**: Terlihat oleh semua aplikasi. - **PRIVATE**: Hanya terlihat oleh aplikasi saat ini. | | uuid | String | Pengenal unik uuid. Bidang ini tidak berubah saat file dipindahkan. | | partitionType | String | Partisi penyimpanan: - **PUBLIC\_OSS\_PARTITION**: Partisi penyimpanan OSS cloud publik. - **MINI\_OSS\_PARTITION**: Partisi penyimpanan MiniOSS khusus. | | storageDriver | String | Tipe driver. Nilai enum: - **DINGTALK**: Driver penyimpanan terpadu DingTalk. - **ALIDOC**: Driver penyimpanan DingTalk Docs. - **SHANJI**: Driver penyimpanan Shanji. - **UNKNOWN**: Driver tidak diketahui. | | thumbnail | Object | Informasi thumbnail. | | width | Integer | Lebar thumbnail. | | height | Integer | Tinggi thumbnail. | | url | String | URL thumbnail. | | category | String | Kategori. Nilai enum: - **IMAGE**: Gambar. - **VIDEO**: Video. - **AUDIO**: Audio. - **ARCHIVE**: Arsip. - **SHORTCUT**: Pintasan. - **DOCUMENT**: Dokumen. - **ALI\_DOC**: DingTalk Docs. - **OTHER**: Lainnya. | ### Contoh isi respons ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} HTTP/1.1 200 OK Content-Type:application/json { "dentry" : { "id" : "dentry_id", "spaceId" : "space_id", "parentId" : "parent_id", "type" : "FILE", "name" : "dentry_name", "size" : 512, "path" : "dentry_path", "version" : 1, "status" : "NORMAL", "extension" : "txt", "creatorId" : "creator_id", "modifierId" : "modifier_id", "createTime" : "2022-01-01T10:00:00Z", "modifiedTime" : "2022-01-01T10:00:00Z", "properties" : { "readOnly" : true }, "appProperties" : [ { "name" : "property_name", "value" : "property_value", "visibility" : "PRIVATE" } ], "uuid" : "uuid", "partitionType" : "PUBLIC_OSS_PARTITION", "storageDriver" : "DINGTALK", "thumbnail" : { "width" : 64, "height" : 64, "url" : "url" }, "category" : "DOCUMENT" } } ``` ### Kode error Jika error dikembalikan saat Anda memanggil API ini, temukan solusinya berdasarkan pesan error di dokumen [Kode error global](/id/open/development/server-api-error-codes-1). | HttpCode | Kode error | Pesan error | Deskripsi | | -------- | --------------------------- | ------------- | --------------------------------------------------- | | 400 | operationConcurrentControl | %s | Kontrol konkurensi. | | 400 | paramError | %s | Error parameter. | | 400 | paramError.parentDentryUuid | %s | Error parameter - parentDentryUuid. | | 400 | paramError.uploadKey | %s | Error parameter - uploadKey. | | 400 | paramError.name | %s | Error parameter - name. | | 400 | paramError.conflictStrategy | %s | Error parameter - conflictStrategy. | | 400 | spaceQuotaInsufficient | %s | Kuota ruang tidak mencukupi. | | 400 | sceneQuotaInsufficient | %s | Kuota skenario tidak mencukupi. | | 400 | appQuotaInsufficient | %s | Kuota aplikasi tidak mencukupi. | | 400 | orgQuotaInsufficient | %s | Kuota organisasi tidak mencukupi. | | 400 | dentryNameIllegal | %s | Nama file tidak valid. | | 400 | dentryStoreError | %s | Error penyimpanan file. | | 400 | dentryNameConflict | %s | Konflik nama file. | | 400 | dentryFormatNotSupport | %s | Format file tidak didukung. | | 403 | permissionDenied | %s | Pengguna tidak memiliki izin untuk mengunggah file. | | 404 | spaceNotExist | %s | Ruang tidak ada. | | 500 | systemError | %s | Error sistem. | | 500 | unknownError | Unknown Error | Error tidak diketahui. | | 503 | operationTimeout | %s | Permintaan melebihi batas waktu. |