> ## 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. # Perbarui izin > Panggil API ini untuk memperbarui izin file bagi anggota di DingTalk berdasarkan uuid file, rootNodeId atau nodeId Knowledge Base, unionId operator, dan id peran. Panggil API ini untuk memperbarui izin file dari pengguna izin berdasarkan informasi seperti ID yang ditentukan (uuid file, rootNodeId Knowledge Base, atau nodeId node Knowledge Base), unionId operator, dan ID peran izin. ## Permintaan ### Informasi dasar | Bidang | Nilai | | ---------------------------- | ----------------------------------------------------------------------------------------------- | | URL HTTP | `https://api.dingtalk.io/v2.0/storage/spaces/dentries/{dentryUuid}/permissions` | | Metode HTTP | PUT | | Jenis aplikasi yang didukung | appType-Aplikasi internal | | Persyaratan izin | permission-Storage.Permission.Write-Izin tulis untuk informasi otorisasi penyimpanan organisasi | ### Header permintaan | Nama | Tipe | Wajib | Deskripsi | | --------------------------- | ------ | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | x-acs-dingtalk-access-token | String | Ya | Kredensial akses yang digunakan untuk memanggil API ini. Panggil API [Dapatkan access token aplikasi internal](/id/open/development/obtain-the-access-token-of-an-internal-app) untuk memperolehnya. | ### Parameter jalur | Nama | Tipe | Wajib | Deskripsi | | ---------- | ------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | dentryUuid | String | Ya | Uuid file. Panggil API [Pencarian File](/id/open/development/search-for-files) atau API [Dapatkan informasi dentryUuid](/id/open/development/api-getuuidbydentryid) untuk memperoleh bidang dentryUuid dari parameter respons. | ### Parameter kueri | Nama | Tipe | Wajib | Deskripsi | | ------- | ------ | ----- | ------------------------------------------------------------------------------------------------------------------- | | unionId | String | Ya | unionId pengguna. Panggil API [Kueri detail pengguna](/id/open/development/query-user-details) untuk memperolehnya. | ### Isi permintaan | Nama | Tipe | Wajib | Deskripsi | | -------- | ------ | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | roleId | String | Ya | ID peran. Nilai enum: - **OWNER**: Pemilik, dengan cakupan izin berikut: - PermissionPrivilegeEnum.INFO - PermissionPrivilegeEnum.LIST - PermissionPrivilegeEnum.PREVIEW - PermissionPrivilegeEnum.READ - PermissionPrivilegeEnum.WRITE - PermissionPrivilegeEnum.DOWNLOAD - PermissionPrivilegeEnum.ADD - PermissionPrivilegeEnum.DELETE - PermissionPrivilegeEnum.MODIFY - PermissionPrivilegeEnum.COPY - PermissionPrivilegeEnum.RENAME - PermissionPrivilegeEnum.READ\_PERMISSION - PermissionPrivilegeEnum.WRITE\_PERMISSION - PermissionPrivilegeEnum.ASSIGN - **MANAGER**: Manajer, dengan cakupan izin berikut: - PermissionPrivilegeEnum.INFO - PermissionPrivilegeEnum.LIST - PermissionPrivilegeEnum.PREVIEW - PermissionPrivilegeEnum.READ - PermissionPrivilegeEnum.WRITE - PermissionPrivilegeEnum.DOWNLOAD - PermissionPrivilegeEnum.ADD - PermissionPrivilegeEnum.DELETE - PermissionPrivilegeEnum.MODIFY - PermissionPrivilegeEnum.COPY - PermissionPrivilegeEnum.RENAME - PermissionPrivilegeEnum.READ\_PERMISSION - PermissionPrivilegeEnum.WRITE\_PERMISSION - **EDITOR**: Editor, dengan cakupan izin berikut: - PermissionPrivilegeEnum.INFO - PermissionPrivilegeEnum.LIST - PermissionPrivilegeEnum.PREVIEW - PermissionPrivilegeEnum.READ - PermissionPrivilegeEnum.WRITE - PermissionPrivilegeEnum.DOWNLOAD - PermissionPrivilegeEnum.ADD - **DOWNLOADER**: Penampil dan pengunduh, dengan cakupan izin berikut: - PermissionPrivilegeEnum.INFO - PermissionPrivilegeEnum.LIST - PermissionPrivilegeEnum.PREVIEW - PermissionPrivilegeEnum.READ - PermissionPrivilegeEnum.DOWNLOAD - **READER**: Hanya lihat, dengan cakupan izin berikut: - PermissionPrivilegeEnum.INFO - PermissionPrivilegeEnum.LIST - PermissionPrivilegeEnum.PREVIEW | | members | Array | Ya | Daftar pengguna izin. Ukuran maksimum adalah 30. | | type | String | Ya | Tipe pengguna izin. Nilai enum: - **ORG**: Organisasi - **DEPT**: Departemen - **TAG**: Tag kustom - **CONVERSATION**: Obrolan - **USER**: Pengguna | | id | String | Ya | ID pengguna izin: - Saat `type=ORG`, id adalah ID organisasi. - Saat `type=DEPT`, id adalah ID departemen. - Saat `type=TAG`, id adalah ID tag. - Saat `type=CONVERSATION`, id adalah ID obrolan. - Saat `type=USER`, id adalah ID karyawan. | | corpId | String | Tidak | Organisasi tempat izin ini berada. - Jika ID organisasi disediakan, izin akan otomatis dihapus saat anggota terkait keluar dari organisasi. - Saat memberType adalah dept, ID organisasi wajib diisi. | | option | Object | Tidak | Parameter opsional. | | duration | Long | Tidak | Periode validitas, dalam detik. - Saat ini, hanya Ruang dengan OwnerType APP yang mendukung izin sementara. - Nilai maksimum adalah 3600. | ### Contoh permintaan HTTP ```http theme={"theme":{"light":"github-light","dark":"github-dark"}} PUT /v2.0/storage/spaces/dentries/EpGBxxxx7R35y/permissions?unionId=tXguNxxxxURAiEiE HTTP/1.1 Host:api.dingtalk.io x-acs-dingtalk-access-token:access_token Content-Type:application/json { "roleId" : "MANAGER", "members" : [ { "type" : "USER", "id" : "01296106445126923197", "corpId" : "ding16b241fd05********288" } ], "option" : { "duration" : 3600 } } ``` Java ```java theme={"theme":{"light":"github-light","dark":"github-dark"}} package com.aliyun.sample; import com.aliyun.tea.*; public class Sample { /** * description : *

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 { com.aliyun.dingtalkstorage_2_0.Client client = Sample.createClient(); com.aliyun.dingtalkstorage_2_0.models.UpdatePermissionHeaders updatePermissionHeaders = new com.aliyun.dingtalkstorage_2_0.models.UpdatePermissionHeaders(); updatePermissionHeaders.xAcsDingtalkAccessToken = ""; com.aliyun.dingtalkstorage_2_0.models.UpdatePermissionRequest.UpdatePermissionRequestOption option = new com.aliyun.dingtalkstorage_2_0.models.UpdatePermissionRequest.UpdatePermissionRequestOption() .setDuration(3600L); com.aliyun.dingtalkstorage_2_0.models.UpdatePermissionRequest.UpdatePermissionRequestMembers members0 = new com.aliyun.dingtalkstorage_2_0.models.UpdatePermissionRequest.UpdatePermissionRequestMembers() .setType("USER") .setId("01296106445126923197") .setCorpId("ding16b241fd05********288"); com.aliyun.dingtalkstorage_2_0.models.UpdatePermissionRequest updatePermissionRequest = new com.aliyun.dingtalkstorage_2_0.models.UpdatePermissionRequest() .setUnionId("tXguNxxxxURAiEiE") .setRoleId("MANAGER") .setMembers(java.util.Arrays.asList( members0 )) .setOption(option); try { client.updatePermissionWithOptions("EpGBxxxx7R35y", updatePermissionRequest, updatePermissionHeaders, 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 Atribut code dan message, yang dapat membantu developer menemukan issue } } 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 Atribut code dan message, yang dapat membantu developer menemukan issue } } } } ``` Python ```python theme={"theme":{"light":"github-light","dark":"github-dark"}} # -*- coding: utf-8 -*- # File ini dibuat secara otomatis, jangan diedit. Terima kasih. import os import sys import json 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() update_permission_headers = dingtalkstorage__2__0_models.UpdatePermissionHeaders() update_permission_headers.x_acs_dingtalk_access_token = '' option = dingtalkstorage__2__0_models.UpdatePermissionRequestOption( duration=3600 ) members_0 = dingtalkstorage__2__0_models.UpdatePermissionRequestMembers( type='USER', id='01296106445126923197', corp_id='ding16b241fd05********288' ) update_permission_request = dingtalkstorage__2__0_models.UpdatePermissionRequest( union_id='tXguNxxxxURAiEiE', role_id='MANAGER', members=[ members_0 ], option=option ) try: client.update_permission_with_options('EpGBxxxx7R35y', update_permission_request, update_permission_headers, util_models.RuntimeOptions()) except Exception as err: if not UtilClient.empty(err.code) and not UtilClient.empty(err.message): # err berisi Atribut code dan message, yang dapat membantu developer menemukan issue pass @staticmethod async def main_async( args: List[str], ) -> None: client = Sample.create_client() update_permission_headers = dingtalkstorage__2__0_models.UpdatePermissionHeaders() update_permission_headers.x_acs_dingtalk_access_token = '' option = dingtalkstorage__2__0_models.UpdatePermissionRequestOption( duration=3600 ) members_0 = dingtalkstorage__2__0_models.UpdatePermissionRequestMembers( type='USER', id='01296106445126923197', corp_id='ding16b241fd05********288' ) update_permission_request = dingtalkstorage__2__0_models.UpdatePermissionRequest( union_id='tXguNxxxxURAiEiE', role_id='MANAGER', members=[ members_0 ], option=option ) try: await client.update_permission_with_options_async('EpGBxxxx7R35y', update_permission_request, update_permission_headers, util_models.RuntimeOptions()) except Exception as err: if not UtilClient.empty(err.code) and not UtilClient.empty(err.message): # err berisi Atribut code dan message, yang dapat membantu developer menemukan issue 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(); $updatePermissionHeaders = new UpdatePermissionHeaders([]); $updatePermissionHeaders->xAcsDingtalkAccessToken = ""; $option = new option([ "duration" => 3600 ]); $members0 = new members([ "type" => "USER", "id" => "01296106445126923197", "corpId" => "ding16b241fd05********288" ]); $updatePermissionRequest = new UpdatePermissionRequest([ "unionId" => "tXguNxxxxURAiEiE", "roleId" => "MANAGER", "members" => [ $members0 ], "option" => $option ]); try { $client->updatePermissionWithOptions("EpGBxxxx7R35y", $updatePermissionRequest, $updatePermissionHeaders, 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 Atribut code dan message, yang dapat membantu developer menemukan issue } } } } $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"}} package main import ( "encoding/json" "strings" "fmt" "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" ) // Description: // // 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 } updatePermissionHeaders := &dingtalkstorage_2_0.UpdatePermissionHeaders{} updatePermissionHeaders.XAcsDingtalkAccessToken = tea.String("") option := &dingtalkstorage_2_0.UpdatePermissionRequestOption{ Duration: tea.Int64(3600), } members0 := &dingtalkstorage_2_0.UpdatePermissionRequestMembers{ Type: tea.String("USER"), Id: tea.String("01296106445126923197"), CorpId: tea.String("ding16b241fd05********288"), } updatePermissionRequest := &dingtalkstorage_2_0.UpdatePermissionRequest{ UnionId: tea.String("tXguNxxxxURAiEiE"), RoleId: tea.String("MANAGER"), Members: []*dingtalkstorage_2_0.UpdatePermissionRequestMembers{members0}, Option: option, } tryErr := func()(_e error) { defer func() { if r := tea.Recover(recover()); r != nil { _e = r } }() _, _err = client.UpdatePermissionWithOptions(tea.String("EpGBxxxx7R35y"), updatePermissionRequest, updatePermissionHeaders, &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 Atribut code dan message, yang dapat membantu developer menemukan issue } } return _err } func main() { err := _main(tea.StringSlice(os.Args[1:])) if err != nil { panic(err) } } ``` Node.js ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} 'use strict'; // File ini dibuat secara otomatis, jangan diedit const Util = require('@alicloud/tea-util'); const dingtalkstorage_2_0 = require('@alicloud/dingtalk/storage_2_0'); const OpenApi = require('@alicloud/openapi-client'); const Tea = require('@alicloud/tea-typescript'); class Client { /** * Initialize the account Client with a Token * @return Client * @throws Exception */ static createClient() { let config = new OpenApi.Config({ }); config.protocol = 'https'; config.regionId = 'central'; return new dingtalkstorage_2_0.default(config); } static async main(args) { let client = Client.createClient(); let updatePermissionHeaders = new dingtalkstorage_2_0.UpdatePermissionHeaders({ }); updatePermissionHeaders.xAcsDingtalkAccessToken = ''; let option = new dingtalkstorage_2_0.UpdatePermissionRequestOption({ duration: 3600, }); let members0 = new dingtalkstorage_2_0.UpdatePermissionRequestMembers({ type: 'USER', id: '01296106445126923197', corpId: 'ding16b241fd05********288', }); let updatePermissionRequest = new dingtalkstorage_2_0.UpdatePermissionRequest({ unionId: 'tXguNxxxxURAiEiE', roleId: 'MANAGER', members: [ members0 ], option: option, }); try { await client.updatePermissionWithOptions('EpGBxxxx7R35y', updatePermissionRequest, updatePermissionHeaders, new Util.RuntimeOptions({ })); } catch (err) { if (!Util.default.empty(err.code) && !Util.default.empty(err.message)) { // err berisi Atribut code dan message, yang dapat membantu developer menemukan issue } } } } exports.Client = Client; Client.main(process.argv.slice(2)); ``` C# ```java theme={"theme":{"light":"github-light","dark":"github-dark"}} using Newtonsoft.Json; 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 { /// Description: /// /// Initialize the account Client with a Token /// /// /// /// Client /// /// /// Exception: /// 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.UpdatePermissionHeaders updatePermissionHeaders = new AlibabaCloud.SDK.Dingtalkstorage_2_0.Models.UpdatePermissionHeaders(); updatePermissionHeaders.XAcsDingtalkAccessToken = ""; AlibabaCloud.SDK.Dingtalkstorage_2_0.Models.UpdatePermissionRequest.UpdatePermissionRequestOption option = new AlibabaCloud.SDK.Dingtalkstorage_2_0.Models.UpdatePermissionRequest.UpdatePermissionRequestOption { Duration = 3600, }; AlibabaCloud.SDK.Dingtalkstorage_2_0.Models.UpdatePermissionRequest.UpdatePermissionRequestMembers members0 = new AlibabaCloud.SDK.Dingtalkstorage_2_0.Models.UpdatePermissionRequest.UpdatePermissionRequestMembers { Type = "USER", Id = "01296106445126923197", CorpId = "ding16b241fd05********288", }; AlibabaCloud.SDK.Dingtalkstorage_2_0.Models.UpdatePermissionRequest updatePermissionRequest = new AlibabaCloud.SDK.Dingtalkstorage_2_0.Models.UpdatePermissionRequest { UnionId = "tXguNxxxxURAiEiE", RoleId = "MANAGER", Members = new List { members0 }, Option = option, }; try { client.UpdatePermissionWithOptions("EpGBxxxx7R35y", updatePermissionRequest, updatePermissionHeaders, new AlibabaCloud.TeaUtil.Models.RuntimeOptions()); } catch (TeaException err) { if (!AlibabaCloud.TeaUtil.Common.Empty(err.Code) && !AlibabaCloud.TeaUtil.Common.Empty(err.Message)) { // err berisi Atribut code dan message, yang dapat membantu developer menemukan issue } } 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 Atribut code dan message, yang dapat membantu developer menemukan issue } } } } } ``` ## Respons ### Isi respons | Nama | Tipe | Deskripsi | | ------- | ------- | ------------------------ | | success | Boolean | Apakah operasi berhasil. | ### Contoh isi respons ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} HTTP/1.1 200 OK Content-Type:application/json { "success" : true } ``` ### Kode error Jika error dikembalikan saat Anda memanggil API ini, lihat dokumen [Kode error global](/id/open/development/server-api-error-codes-1) untuk menemukan solusi berdasarkan pesan error. | HttpCode | Kode error | Pesan error | Deskripsi | | -------- | ------------------------------- | ------------- | -------------------------------------------------- | | 400 | paramError | %s | Error parameter | | 400 | paramError.dentryUuid | %s | Error parameter - dentryUuid | | 400 | paramError.roleId | %s | Error parameter - roleId | | 400 | paramError.permissionMemberType | %s | Error parameter - permissionMemberType | | 403 | permissionDenied | %s | Pengguna tidak memiliki otorisasi yang diperlukan. | | 404 | spaceNotExist | %s | Ruang tidak ada. | | 404 | dentryNotExist | %s | File tidak ada. | | 500 | systemError | %s | Error sistem | | 500 | unknownError | Unknown Error | Error tidak dikenal | | 503 | operationTimeout | %s | Permintaan kehabisan waktu |