コンテンツにスキップ
ホーム / キット / ファイル
FilesFILES

すべてのファイルはURL

ローカルストレージと60以上のクラウドプロバイダーへの単一HTTPインターフェース — Google Drive、S3、Dropboxなど。一度マウントすれば、永続アクセスが可能です。

hoody-files · ユニバーサルストレージアクセス

# Google Drive

$ curl /api/v1/files/Work/report.pdf \

?backend=backend_drive_abc

# Amazon S3

$ curl /api/v1/files/backups/data.zip \

?backend=backend_s3_xyz

# Dropbox

$ curl /api/v1/files/Photos/vacation.jpg \

?backend=backend_dropbox_123

# 同じURLパターン

HTTP/1.1 200 OK

Content-Type: application/pdf

Content-Length: 524288

# 異なるストレージ

HTTP/1.1 200 OK

Content-Type: application/zip

ETag: "a3f2bc..."

同じURLパターン。異なるストレージ。複雑さなし。

ホーム / キット / ファイル / バックエンド
60以上のプロバイダー

あらゆるストレージを即座に接続

Google Drive、S3、Dropboxをはじめ60以上のプロバイダーをマウントできます。バックエンドごとに1回認証するだけで、単一のHTTPインターフェースからすべてにアクセスできます。

Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
ホーム / キット / ファイル / プロトコル
ファイルプロトコル

あらゆるストレージプロトコルに対応

FTP、SFTP、SMB、WebDAV、HTTP、HDFS — お使いのインフラが既に利用しているプロトコルでネットワークストレージをマウントできます。

FTPポート21
SFTPポート22
SMBポート445
WebDAVNextcloud / SharePoint
HTTPWebファイルサーバー
HDFSHadoopクラスター
ホーム / キット / ファイル / 機能
機能

ファイルホスティング以上の機能

ストリーム、ハッシュ、プレビュー、ZIP圧縮、ジャーナル、画像処理 — すべてのバックエンドに対応した単一HTTPインターフェースで利用できます。

読み取りとストリーミング

ローカルストレージまたはマウント済みクラウドバックエンドから、HTTPでファイルをストリーミングします。HTML、JSON、プレーンテキスト形式のレスポンスをサポートします。

GET /api/v1/files/[path]

SHA256整合性チェック

ファイル全体をダウンロードせずにSHA256またはMD5ハッシュを計算します。本番環境へのデプロイ、バックアップの検証、コンプライアンス対応に不可欠です。

GET /api/v1/files/[path]?hash

アーカイブプレビュー

アーカイブを展開せずに.tar.gzや.zipの内容を確認できます。エントリ、サイズ、パスを即座に一覧表示します。

GET /[path]?preview

ディレクトリの.zipダウンロード

任意のディレクトリをオンデマンドで.zipアーカイブとしてダウンロードできます。ローカルストレージとリモートクラウドバックエンドの両方に対応しています。

GET /[path]?zip

ファイルジャーナル&履歴

すべての変更はコンテンツアドレス可能なBLOBスナップショットとして記録されます。過去の任意のリビジョンやタイムスタンプでファイルを読み取り、バージョン間の差分も確認できます。

GET /api/v1/files/[path]?history

画像処理

JPEG、PNG、WebP、GIF、BMPのリサイズ、フォーマット変換、ブラー、グレースケール処理をオンザフライで実行 — あらゆるストレージバックエンドから対応します。

GET /[image]?thumbnail&width=400
ホーム / キット / ファイル / API
APIリファレンス

21エンドポイント。1つのインターフェース。

読み取り、書き込み、バックエンド管理、ジャーナル監視 — すべてをプレーンHTTPとして公開します。SDKは不要です。

読み取りとダウンロード

[count, plural, =1 [# endpoint] other [# endpoints]]'

curl .../api/v1/files/Work/report.pdf?backend=backend_drive

GET
/api/v1/files/[path]ファイルコンテンツを読み取りまたはダウンロード
GET
/[path]HTML/JSON/シンプル形式の代替エンドポイント
HEAD
/api/v1/files/[path]ダウンロードなしでメタデータを取得
GET
/api/v1/files/[path]?hashファイルのSHA256ハッシュを取得
GET
/[path]?previewアーカイブの内容をプレビュー(tar.gz、zip)
GET
/[path]?zipディレクトリを.zipアーカイブとしてダウンロード

書き込みと変更

[count, plural, =1 [# endpoint] other [# endpoints]]'

POST .../api/v1/files/copy/[path]?copy_to=/backup/

PUT
/[path]サーバーストレージにファイルをアップロード
POST
/api/v1/files/[path]ファイル操作: mkdir、展開、移動、コピー
POST
/api/v1/files/copy/[path]ファイルまたはディレクトリを新しい場所にコピー
POST
/api/v1/files/move/[path]ファイルを新しいパスに移動または名前変更
DELETE
/[path]ファイルまたはディレクトリを削除
GET
/[directory]?qクエリに一致するファイルを検索

バックエンド管理

[count, plural, =1 [# endpoint] other [# endpoints]]'

POST .../api/v1/backends/drive → [id: "backend_drive_abc"]

POST
/api/v1/backends/[type]ストレージバックエンドをマウント
GET
/api/v1/backendsマウント済みバックエンドをすべて一覧表示
GET
/api/v1/backends/[id]バックエンドの詳細を取得
GET
/api/v1/backends/[id]/testバックエンド接続をテスト
DELETE
/api/v1/backends/[id]バックエンドを切断

システム&ジャーナル

[count, plural, =1 [# endpoint] other [# endpoints]]'

GET .../api/v1/journal?path=src/&op=write

GET
/__hoody-files__/healthサービスのヘルスステータス
GET
/api/v1/downloadsアクティブなダウンロードを一覧表示
GET
/api/v1/extractionsアクティブな展開を一覧表示
GET
/api/v1/journalファイル変更ジャーナルをクエリ
ホーム / キット / ファイル / バックエンドマトリクス
バックエンドタイプ

あらゆるバックエンドカテゴリー

4種類のストレージ、1つのHTTPインターフェース。任意の組み合わせをマウントして、同じURLパターンからすべてにアクセスできます。

カテゴリー
プロバイダー
マウントタイプ
認証方式
クラウドストレージ
Google Drive、Dropbox、OneDrive、Boxを含む31プロバイダー
仮想ファイルシステム
OAuth / APIキー
オブジェクトストレージ
S3、Azure Blob、GCS、B2、Cloudflare R2、25以上のS3互換
バケットパス
IAM / アクセスキー
ファイルプロトコル
FTP、SFTP、SMB、WebDAV、HTTP、HDFS
ネットワークパス
パスワード / キー / 匿名
スペシャル
Cache、Chunker、Combine、Crypt、Compress
レイヤード
ラップされたバックエンドから継承
ホーム / キット / ファイル / スタート

すべてのファイルはURL

60以上のプロバイダーにわたるファイルの読み取り、ハッシュ計算、管理を1つのHTTPインターフェースで始めましょう。FilesはすべてのHoodyコンテナに付属しています。

ドキュメントを読む