Облачное управление файлами для Excel – эффективное и безопасное решение для хранения и интеллектуальной организации файлов Excel

Aspose.Cells Cloud предоставляет комплексный набор вспомогательных функций для работы с файлами, хранящимися в облачном хранилище Aspose.Cells Cloud или любом стороннем облачном хранилище по вашему выбору. Для получения помощи по настройке стороннего хранилища обратитесь к разделу Тем справки Aspose Cloud UI.

Aspose.Cells Cloud предоставляет широкий спектр API для работы с файлами, папками и хранилищами.

Примечание: Все вызовы API должны использовать HTTPS. Подробности о получении токена JWT см. в Руководстве по аутентификации.

Необходимые условия: Для использования этих API необходима действующая учетная запись Aspose Cloud, полученный токен доступа JWT и настроенное место хранения (либо облачное хранилище Aspose Cloud, либо подключенное стороннее хранилище).

Последнее обновление: 2024‑12‑01

Как загрузить файл

Информация об API загрузки файла

PUT https://api.aspose.cloud/v3.0/cells/storage/file/{path}

Параметры запроса перечислены ниже:

Имя параметра	Тип	Местоположение	Описание
path	string	path	Путь загружаемого файла, включая имя файла и расширение (например, `/folder1/Report.xlsx`).
file	file	formData	Загружаемый файл.
storageName	string	query	Имя используемого хранилища.

HTTP-ответы

Код	Описание
200	Файл успешно загружен.
400	Неверный запрос — отсутствуют или недопустимы параметры.
401	Неавторизованный доступ — недействительный или отсутствующий JWT-токен.
404	Хранилище не найдено.
500	Внутренняя ошибка сервера.

Спецификация OpenAPI определяет общедоступный программный интерфейс, позволяющий выполнять REST-взаимодействия непосредственно из веб-браузера.

Пример загрузки файла

Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. В следующем примере показано, как загрузить файл с помощью cURL.

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/storage/file/MyFolder/Report.xlsx" \
  -X PUT \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -F "File=@Report.xlsx"

Ответ

{
  "Uploaded": [
    "MyFolder/Report.xlsx"
  ],
  "Errors": []
}

Примечание: Максимальный размер файла для загрузки — 100 МБ. Могут действовать ограничения частоты запросов.

Как скачать файл

Информация об API скачивания файла

GET https://api.aspose.cloud/v3.0/cells/storage/file/{path}

Параметры запроса перечислены ниже:

Имя параметра	Тип	Местоположение	Описание
path	string	path	Путь к файлу (например, `/folder/Report.xlsx`).
storageName	string	query	Имя используемого хранилища.
versionId	string	query	Идентификатор версии файла для скачивания (необязательно).

HTTP-ответы

Код	Описание
200	Файл скачан; возвращается бинарный поток.
400	Неверный запрос — недопустимые параметры.
401	Неавторизованный доступ — отсутствует или недействителен JWT.
404	Файл не найден.
500	Внутренняя ошибка сервера.

Пример скачивания файла

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/storage/file/MyFolder/Report.xlsx" \
  -X GET \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Ответ

{
  "Stream": "<бинарные данные>"
}

Примечание: Ответ содержит бинарный поток файла. При использовании cURL сохраните вывод в файл с помощью параметра -o filename.xlsx.

Как удалить файл

Информация об API удаления файла

DELETE https://api.aspose.cloud/v3.0/cells/storage/file/{path}

Параметры запроса перечислены ниже:

Имя параметра	Тип	Местоположение	Описание
path	string	path	Путь к файлу (например, `/folder/Report.xlsx`).
storageName	string	query	Имя используемого хранилища.
versionId	string	query	Идентификатор удаляемой версии файла (необязательно).

HTTP-ответы

Код	Описание
200	Файл успешно удален.
400	Неверный запрос — отсутствуют или недопустимы параметры.
401	Неавторизованный доступ — недействительный JWT-токен.
404	Файл не найден.
500	Внутренняя ошибка сервера.

Пример удаления файла

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/storage/file/MyFolder/OldReport.xlsx" \
  -X DELETE \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Ответ

{
  "Code": 200,
  "Status": "OK"
}

Примечание: Удаление файла является необратимым; убедитесь, что у вас есть резервная копия при необходимости.

Как скопировать файл

Информация об API копирования файла

PUT https://api.aspose.cloud/v3.0/cells/storage/file/copy/{srcPath}

Параметры запроса перечислены ниже:

Имя параметра	Тип	Местоположение	Описание
srcPath	string	path	Путь исходного файла (например, `/folder/Source.xlsx`).
destPath	string	query	Путь целевого файла (например, `/folder/Destination.xlsx`).
srcStorageName	string	query	Имя исходного хранилища (необязательно).
destStorageName	string	query	Имя целевого хранилища (необязательно).
versionId	string	query	Идентификатор версии файла для копирования (необязательно).

HTTP-ответы

Код	Описание
200	Файл успешно скопирован.
400	Неверный запрос — недопустимые параметры.
401	Неавторизованный доступ — отсутствует или недействителен JWT.
404	Исходный файл не найден.
500	Внутренняя ошибка сервера.

Пример копирования файла

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/storage/file/copy/MyFolder/Report.xlsx?destPath=MyFolder/ReportCopy.xlsx" \
  -X PUT \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Ответ

{
  "Code": 200,
  "Status": "OK"
}

Примечание: Операция копирования не удаляет исходный файл.

Как переместить файл

Информация об API перемещения файла

PUT https://api.aspose.cloud/v3.0/cells/storage/file/move/{srcPath}

Параметры запроса перечислены ниже:

Имя параметра	Тип	Местоположение	Описание
srcPath	string	path	Путь исходного файла (например, `/folder/Source.xlsx`).
destPath	string	query	Путь целевого файла (например, `/folder/Destination.xlsx`).
srcStorageName	string	query	Имя исходного хранилища (необязательно).
destStorageName	string	query	Имя целевого хранилища (необязательно).
versionId	string	query	Идентификатор версии файла для перемещения (необязательно).

HTTP-ответы

Код	Описание
200	Файл успешно перемещен.
400	Неверный запрос — недопустимые параметры.
401	Неавторизованный доступ — отсутствует или недействителен JWT.
404	Исходный файл не найден.
500	Внутренняя ошибка сервера.

Пример перемещения файла

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/storage/file/move/MyFolder/Report.xlsx?destPath=MyFolder/ReportMoved.xlsx" \
  -X PUT \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Ответ

{
  "Code": 200,
  "Status": "OK"
}

Примечание: При перемещении файла сохраняется история его версий.

Как создать папку

Информация об API создания папки

PUT https://api.aspose.cloud/v3.0/cells/storage/folder/{path}

Параметры запроса перечислены ниже:

Имя параметра	Тип	Местоположение	Описание
path	string	path	Путь создаваемой папки (например, `folder1/folder2/`).
storageName	string	query	Имя используемого хранилища.

HTTP-ответы

Код	Описание
200	Папка успешно создана.
400	Неверный запрос — недопустимый путь или параметры.
401	Неавторизованный доступ — отсутствует или недействителен JWT.
500	Внутренняя ошибка сервера.

Пример создания папки

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/storage/folder/newfolder" \
  -X PUT \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Ответ

{
  "Uploaded": [
    "newfolder"
  ],
  "Errors": []
}

Примечание: Пути к папкам чувствительны к регистру.

Как получить список файлов в папке

Информация об API получения файлов

GET https://api.aspose.cloud/v3.0/cells/storage/folder/{path}

Параметры запроса перечислены ниже:

Имя параметра	Тип	Местоположение	Описание
path	string	path	Путь к папке (например, `/folder`).
storageName	string	query	Имя используемого хранилища.

HTTP-ответы

Код	Описание
200	Возвращен список файлов и подпапок.
400	Неверный запрос — недопустимый путь.
401	Неавторизованный доступ — отсутствует или недействителен JWT.
404	Папка не найдена.
500	Внутренняя ошибка сервера.

Пример получения списка файлов

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/storage/folder/desfolder" \
  -X GET \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Ответ

{
  "Value": [
    {
      "Name": "Report.xlsx",
      "IsFolder": false,
      "ModifiedDate": "2021-12-08T12:38:45.739Z",
      "Size": 102400,
      "Path": "/desfolder/Report.xlsx"
    }
  ]
}

Примечание: Ответ содержит как файлы, так и подпапки, расположенные по указанному пути.

Как удалить папку

Информация об API удаления папки

DELETE https://api.aspose.cloud/v3.0/cells/storage/folder/{path}

Параметры запроса перечислены ниже:

Имя параметра	Тип	Местоположение	Описание
path	string	path	Путь к папке (например, `/folder`).
storageName	string	query	Имя используемого хранилища.
recursive	boolean	query	Установите значение `true`, чтобы удалить папку рекурсивно.

HTTP-ответы

Код	Описание
200	Папка успешно удалена.
400	Неверный запрос — недопустимые параметры.
401	Неавторизованный доступ — отсутствует или недействителен JWT.
404	Папка не найдена.
500	Внутренняя ошибка сервера.

Пример удаления папки

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/storage/folder/desfolder" \
  -X DELETE \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Ответ

{
  "Code": 200,
  "Status": "OK"
}

Примечание: Удаление папки с параметром recursive=true приводит к безвозвратному удалению её содержимого.

Как скопировать папку

Информация об API копирования папки

PUT https://api.aspose.cloud/v3.0/cells/storage/folder/copy/{srcPath}

Параметры запроса перечислены ниже:

Имя параметра	Тип	Местоположение	Описание
srcPath	string	path	Путь исходной папки (например, `/src`).
destPath	string	query	Путь целевой папки (например, `/dst`).
srcStorageName	string	query	Имя исходного хранилища (необязательно).
destStorageName	string	query	Имя целевого хранилища (необязательно).

HTTP-ответы

Код	Описание
200	Папка успешно скопирована.
400	Неверный запрос — недопустимые параметры.
401	Неавторизованный доступ — отсутствует или недействителен JWT.
404	Исходная папка не найдена.
500	Внутренняя ошибка сервера.

Пример копирования папки

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/storage/folder/copy/srcfolder?destPath=desfolder" \
  -X PUT \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Ответ

{
  "Code": 200,
  "Status": "OK"
}

Примечание: Операция копирования создаёт новую папку с тем же содержимым, что и исходная.

Как переместить папку

Информация об API перемещения папки

PUT https://api.aspose.cloud/v3.0/cells/storage/folder/move/{srcPath}

Параметры запроса перечислены ниже:

Имя параметра	Тип	Местоположение	Описание
srcPath	string	path	Путь исходной папки (например, `/folder`).
destPath	string	query	Путь целевой папки (например, `/dst`).
srcStorageName	string	query	Имя исходного хранилища (необязательно).
destStorageName	string	query	Имя целевого хранилища (необязательно).

HTTP-ответы

Код	Описание
200	Папка успешно перемещена.
400	Неверный запрос — недопустимые параметры.
401	Неавторизованный доступ — отсутствует или недействителен JWT.
404	Исходная папка не найдена.
500	Внутренняя ошибка сервера.

Пример перемещения папки

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/storage/folder/move/desfolder?destPath=destfolder" \
  -X PUT \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

{
  "Code": 200,
  "Status": "OK"
}

Примечание: При перемещении папки сохраняется её внутренняя структура и версии файлов.

Как проверить наличие хранилища

Информация об API проверки наличия хранилища

GET https://api.aspose.cloud/v3.0/cells/storage/{storageName}/exist

Параметры запроса перечислены ниже:

Имя параметра	Тип	Местоположение	Описание
storageName	string	path	Имя проверяемого хранилища.

HTTP-ответы

Код	Описание
200	Возвращена информация о наличии хранилища (`true` или `false`).
401	Неавторизованный доступ — отсутствует или недействителен JWT.
404	Хранилище не найдено.
500	Внутренняя ошибка сервера.

Пример проверки наличия хранилища

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/storage/MyStorage/exist" \
  -X GET \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Ответ

{
  "Exists": true
}

Как проверить наличие файла или папки

Информация об API проверки наличия объекта

GET https://api.aspose.cloud/v3.0/cells/storage/exist/{path}

Параметры запроса перечислены ниже:

Имя параметра	Тип	Местоположение	Описание
path	string	path	Путь к файлу или папке (например, `/file.xlsx` или `/folder`).
storageName	string	query	Имя проверяемого хранилища.
versionId	string	query	Идентификатор версии файла (необязательно).

HTTP-ответы

Код	Описание
200	Возвращена информация о наличии объекта.
401	Неавторизованный доступ — отсутствует или недействителен JWT.
404	Файл или папка не найдены.
500	Внутренняя ошибка сервера.

Пример проверки наличия объекта

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/storage/exist/Book1.xlsx" \
  -X GET \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Ответ

{
  "Exists": true,
  "IsFolder": false
}

Как получить информацию об использовании диска

Информация об API получения использования диска

GET https://api.aspose.cloud/v3.0/cells/storage/disc

Параметры запроса перечислены ниже:

Имя параметра	Тип	Местоположение	Описание
storageName	string	query	Имя хранилища для запроса.

HTTP-ответы

Код	Описание
200	Возвращена информация об использовании диска.
401	Неавторизованный доступ — отсутствует или недействителен JWT.
500	Внутренняя ошибка сервера.

Пример получения информации об использовании диска

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/storage/disc?storageName=MyStorage" \
  -X GET \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Ответ

{
  "UsedSize": 12345678,
  "TotalSize": 987654321
}

Как получить список версий файла

Информация об API получения версий файла

GET https://api.aspose.cloud/v3.0/cells/storage/version/{path}

Параметры запроса перечислены ниже:

Имя параметра	Тип	Местоположение	Описание
path	string	path	Путь к файлу (например, `/file.xlsx`).
storageName	string	query	Имя хранилища для запроса.

HTTP-ответы

Код	Описание
200	Возвращён список версий файла.
401	Неавторизованный доступ — отсутствует или недействителен JWT.
404	Файл не найден.
500	Внутренняя ошибка сервера.

Пример получения версий файла

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/storage/version/Report.xlsx?storageName=MyStorage" \
  -X GET \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

{
  "Value": [
    {
      "Name": "Report.xlsx",
      "IsFolder": false,
      "ModifiedDate": "2021-12-08T18:57:46.128Z",
      "Size": 102400,
      "Path": "/Report.xlsx",
      "VersionId": "1",
      "IsLatest": true
    }
  ]
}

Руководство разработчика Aspose.Cells Cloud 3.0