フォルダの共有リンクを更新します。
更新された共有リンクが追加されているフォルダのBase版の表示を返します。
権限の組み合わせが正しくない場合に返されます。
Authorization
ヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。
更新を完了するための権限がユーザーに不足している場合に返されます。
フォルダが見つからない場合、またはユーザーにフォルダへのアクセス権限が与えられていない場合に返されます。
folder_id
が認識されていない形式で指定されている場合に返されます。
If-Match
ヘッダーがフォルダの現在のetag
値と一致しない場合はエラーを返します。これは、フォルダが前回リクエストされたときから変更されていることを示します。
予期しないクライアントエラー。
curl -i -X PUT "https://api.box.com/2.0/folders/32423234?fields=shared_link" \
-H "authorization: Bearer <ACCESS_TOKEN>" \
-d '{
"shared_link": {
"access": "open",
"password": "mypassword",
"unshared_at": "2012-12-12T10:53:43-08:00",
"permissions": {
"can_download": false
}
}
}'
await client.sharedLinksFolders.updateSharedLinkOnFolder(
folder.id,
{
sharedLink: {
access:
'collaborators' as UpdateSharedLinkOnFolderRequestBodySharedLinkAccessField,
} satisfies UpdateSharedLinkOnFolderRequestBodySharedLinkField,
} satisfies UpdateSharedLinkOnFolderRequestBody,
{ fields: 'shared_link' } satisfies UpdateSharedLinkOnFolderQueryParams,
);
client.shared_links_folders.update_shared_link_on_folder(
folder.id,
"shared_link",
shared_link=UpdateSharedLinkOnFolderSharedLink(
access=UpdateSharedLinkOnFolderSharedLinkAccessField.COLLABORATORS
),
)
await client.SharedLinksFolders.UpdateSharedLinkOnFolderAsync(folderId: folder.Id, requestBody: new UpdateSharedLinkOnFolderRequestBody() { SharedLink = new UpdateSharedLinkOnFolderRequestBodySharedLinkField() { Access = UpdateSharedLinkOnFolderRequestBodySharedLinkAccessField.Collaborators } }, queryParams: new UpdateSharedLinkOnFolderQueryParams(fields: "shared_link"));
BoxFolder folder = new BoxFolder(api, "id");
BoxSharedLinkRequest sharedLinkRequest = new BoxSharedLinkRequest()
.access(OPEN)
.permissions(true, true);
BoxSharedLink sharedLink = folder.createSharedLink(sharedLinkRequest);
{
"etag": "1",
"id": "12345",
"shared_link": {
"access": "open",
"download_count": 0,
"download_url": "https://app.box.com/shared/static/kwio6b4ovt1264rnfbyqo1.pdf",
"effective_access": "open",
"effective_permission": "can_download",
"is_password_enabled": false,
"permissions": {
"can_download": true,
"can_edit": false,
"can_preview": true
},
"preview_count": 0,
"unshared_at": "2020-09-21T10:34:41-07:00",
"url": "https://app.box.com/s/kwio6b4ovt1264rnfbyqo1",
"vanity_name": null,
"vanity_url": null
},
"type": "folder"
}