メインコンテンツまでスキップ

Generic File Storageでのファイルの管理

BitriseのGENERIC FILE STORAGEセクションでは、プロジェクトファイルのアップロード、削除、更新、一覧表示ができます。

エンドポイント機能アプリのチームで必要なロール
POST/apps/{app-slug}/generic-project-files汎用プロジェクトファイルを作成するOwnerまたはAdmin
POST/apps/{app-slug}/generic-project-files/{generic-project-file-slug}/uploadedアップロード処理を確認するOwnerまたはAdmin
PATCH/apps/{app-slug}/generic-project-files/{generic-project-file-slug}アップロード済みのプロジェクトファイルを更新するOwnerまたはAdmin
GET/apps/{app-slug}/generic-project-filesアップロード済みのプロジェクトファイルの一覧を取得するOwnerまたはAdmin
GET/apps/{app-slug}/generic-project-files/{generic-project-file-slug}特定のプロジェクトファイルのデータを取得するOwnerまたはAdmin
DELETE/apps/{app-slug}/generic-project-files/{generic-project-file-slug}アップロード済みのプロジェクトファイルを削除するOwnerまたはAdmin

Generic File Storageへのファイルの作成とアップロードClick to copy link​

必要なロール

BitriseのAPIを使用してGeneric File Storage内のファイルを管理するには、アプリのチームでadminまたはownerのロールを持っている必要があります。

ユーザーロールの完全な一覧とロールのチートシートについては、Bitrise CIのロールと権限をご確認ください。

アプリケーションに新しいファイルを追加し、GENERIC FILE STORAGEに保存できます。該当するAPIエンドポイントを呼び出すと、新しい一時的な署名付きアップロードURLが作成され、これを使用してファイルをGENERIC FILE STORAGEにアップロードします。(この署名付きURLには有効期限があり、10分後に失効するのでご注意ください。)

以下の手順が必要です。

  1. generic-project-filesエンドポイントのPOSTメソッドを呼び出します。

    この呼び出しにより、後で必要になるファイルスラッグを含む一時的な署名付きアップロードURLが作成されます。必須パラメータは次のとおりです。

    • slug: Bitriseアプリのアプリスラッグです。Bitriseでアプリを開き、メインページのURLからコピーするか、GET /appsエンドポイントを呼び出して一覧からアプリを見つけることで取得できます。
    • upload_file_name: 拡張子を含むファイル名です。例:MyFile.txt。ファイルはコマンドを実行するフォルダと同じ場所に置いてください。
    • upload_file_size: バイト単位のファイルサイズです。macOSでは、stat -f%z <filename>コマンドを実行するとファイルサイズを取得できます。
    • user_env_key: ユーザー環境変数キーには任意の名前を指定できます。
  2. 署名付きアップロードURLを使用して、ファイルをAWSにアップロードします。

  3. 署名付きアップロードURLを含むレスポンスのスラッグを使用して、generic-project-files/GENERIC-PROJECT-FILES-SLUG/uploadedエンドポイントのPOSTメソッドでファイルのアップロードを確認します。

    これによりprocessedフラグがtrueに設定され、ファイルがBitriseで利用可能になります。このフラグは、その後変更できません。

ファイルの作成とアップロード

一時的な署名付きアップロードURLの作成:

curl -X POST "https://api.bitrise.io/v0.1/apps/<APP-SLUG>/generic-project-files" -H "accept: application/json" -H "Authorization: <ACCESS-TOKEN>" -H "Content-Type: application/json" -d "{ \"upload_file_name\": \"Test_File.md\", \"upload_file_size\": 4865, \"user_env_key\": \"Test_File\"}"

レスポンス:

{
"data": {
"upload_file_name": "Test_File.md",
"upload_file_size": 4865,
"slug": "<GENERIC-PROJECT-FILE-SLUG>",
"processed": false,
"is_expose": true,
"is_protected": false,
"upload_url": "https://concrete-userfiles-production.s3.us-west-2.amazonaws.com/project_file_storage_documents/uploads/24043/original/Test-File?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAIV2YZWMVCNWNR2HA%2F20190402%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20190402T125827Z&X-Amz-Expires=600&X-Amz-SignedHeaders=content-length%3Bhost&X-Amz-Signature=e1557901d5a07b1b3578d9ffdf84a9b0188b742bfff9c8175a3e87f12c7e2c4e",
"user_env_key": "Test_File",
"exposed_meta_datastore": null
}
}

ファイルをAWSにアップロードする:

curl -T Test_File.md "<UPLOAD_URL>"

ファイルアップロードの確認:

curl -X POST -H 'Authorization: <ACCESS-TOKEN>' 'https://api.bitrise.io/v0.1/apps/<APP-SLUG>/generic-project-files/<GENERIC-PROJECT-FILES-SLUG>/uploaded'

レスポンス:

{
"data": {
"upload_file_name": "Test_File.md",
"upload_file_size": 4865,
"slug": "<GENERIC-PROJECT-FILE-SLUG>",
"processed": true,
"is_expose": true,
"is_protected": false,
"user_env_key": "Test_File",
"exposed_meta_datastore": null
}
}

特定のファイルのデータを取得するClick to copy link​

必要なロール

BitriseのAPIを使用してGeneric File Storage内のファイルを管理するには、アプリのチームでadminまたはownerのロールを持っている必要があります。

ユーザーロールの完全な一覧とロールのチートシートについては、Bitrise CIのロールと権限をご確認ください。

generic-project-filesエンドポイントのGETメソッドを使用して、Generic File Storageから特定のファイルのデータを取得します。返されるデータには、ファイル名、サイズ、ダウンロードURL、現在のステータスなどが含まれます。

必須パラメータは次のとおりです。

  • アプリスラッグ
  • 汎用プロジェクトファイルのスラッグ
ファイルを取得する

リクエスト:

curl -X GET -H 'Authorization: <ACCESS-TOKEN>' 'https://api.bitrise.io/v0.1/apps/<APP-SLUG>/generic-project-files/<GENERIC-PROJECT-FILE-SLUG>'

レスポンス:

{
"data": {
"upload_file_name": "Test_File.md",
"upload_file_size": 4865,
"slug": "01D7F228E7N8Q8WQJKJM8FV3XM",
"processed": true,
"is_expose": true,
"is_protected": false,
"download_url": "https://concrete-userfiles-production.s3.us-west-2.amazonaws.com/project_file_storage_documents/uploads/24043/original/Test-File?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAIV2YZWMVCNWNR2HA%2F20190402%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20190402T132712Z&X-Amz-Expires=600&X-Amz-SignedHeaders=host&X-Amz-Signature=241be52184b63867262360743931c546c166a99719787ce417e3be11bc12bbed",
"user_env_key": "Test_File",
"exposed_meta_datastore": null
}
}
download_urlの利用可否

download_urlは、ファイルのis_protected属性がfalseの場合にのみ生成される点にご注意ください。

プロジェクトのアップロード済みファイルを一覧表示するClick to copy link​

必要なロール

BitriseのAPIを使用してGeneric File Storage内のファイルを管理するには、アプリのチームでadminまたはownerのロールを持っている必要があります。

ユーザーロールの完全な一覧とロールのチートシートについては、Bitrise CIのロールと権限をご確認ください。

GETメソッドを使用して、Generic File Storageにアップロードされたプロジェクトファイルの一覧を取得します。ファイルの最大数は50件である点にご注意ください。

必須パラメータは次のとおりです。

  • アプリスラッグ

オプションパラメータは次のとおりです。

  • next: レスポンス内の最初のファイルのスラッグ(文字列)
  • limit: 1ページあたりの最大要素数(整数)
アプリを一覧表示する

リクエスト:

curl -X GET -H 'Authorization: <ACCESS-TOKEN>' 'https://api.bitrise.io/v0.1/apps/<APP-SLUG>/generic-project-files'

レスポンス:

{
"data": [
{
"upload_file_name": "Test_File.md",
"upload_file_size": 4865,
"slug": "01D7F228E7N8Q8WQJKJM8FV3XM",
"processed": true,
"is_expose": true,
"is_protected": false,
"user_env_key": "Test_File",
"exposed_meta_datastore": null
}
],
"paging": {
"total_item_count": 2,
"page_item_limit": 50
}
}

ご覧のとおり、このレスポンス例には特定のプロジェクトに紐づくファイルの一覧が表示されます。

Generic File Storageからファイルを削除するClick to copy link​

DELETEメソッドを使用して、Generic File Storageからアップロード済みのファイルを削除できます。

必要なロール

BitriseのAPIを使用してGeneric File Storage内のファイルを管理するには、アプリのチームでadminまたはownerのロールを持っている必要があります。

ユーザーロールの完全な一覧とロールのチートシートについては、Bitrise CIのロールと権限をご確認ください。

必須パラメータは次のとおりです。

  • アプリスラッグ
  • 汎用プロジェクトファイルのスラッグ
curl -X DELETE -H "Authorization:<ACCESS-TOKEN>" "https://api.bitrise.io/v0.1/apps/<APP-SLUG>/generic-project-files/<GENERIC-PROJECT-FILES-SLUG>"