ビルドアーティファクトの管理

概要

Bitrise APIを使用して、ビルドアーティファクトを一覧表示、取得、更新、および削除できます。

追加した場合 Deploy to bitrise.io ステップ あなたに ワークフロー、ビルドが実行されると、ビルドのビルドアーティファクトにアクセスできますアーティファクト bitrise.ioのタブ。

Artifact retention period

Artifacts older than 365 days are permanently deleted. We have an extended artifact retention period add-on: the extension period is negotiable at the time of purchase. For more information, contact us.

The extended retention period is only supported for the main workspace. For example, if a project is transferred into the workspace from another, its builds that are older than 365 days at the time of the transfer will not be retained.

BitriseAPIを使用して生成されたアーティファクトを管理することもできます。

200日間のビルド保持

に ビルド アプリのページには、過去200日間のビルドのみが表示されます。あなたがいる場合も同じ制限が適用されます特定のビルドを検索するページ上。この制限は、API呼び出しにも適用されます。 GET/apps/{app-slug}/builds エンドポイントおよび関連するエンドポイントは、過去200日間のビルドのみを返すことができます。

ただし、正確なビルドURLがわかっている場合は、200日より古いビルドを表示できます。古いビルドを表示する必要があるが、正確なビルドURLがわからない場合は、サポートチームにお問い合わせください。

正確なビルドURLがわかっている場合は、ビルドにアクセスできます。
あなたは使用することができます GET/apps/{app-slug}/archived-builds APIエンドポイント：アプリのアーカイブされたビルドの一覧表示。

表1 APIを使用したビルドアーティファクトの管理に関連するエンドポイント

終点	関数	アプリのチームで必要な役割
GET / apps / {app-slug} / builds / {build-slug} / artifacts	ビルドアーティファクトの一覧表示	どれでも
GET / apps / {app-slug} / builds / {build-slug} / artifacts / {artifact-slug}	特定のビルドアーティファクトのデータを取得する	どれでも
パッチ/アプリ/ {アプリ-スラッグ} / builds / {ビルド-スラッグ} /アーティファクト/ {アーティファクト-スラッグ}	ビルドアーティファクトの更新	所有者、管理者、または開発者
DELETE / apps / {app-slug} / builds / {build-slug} / artifacts / {artifact-slug}	ビルドアーティファクトの削除	所有者、管理者、または開発者

ビルドアーティファクトの一覧表示

必要な役割

APIを使用してビルドアーティファクトを一覧表示するには、アプリのチームにテスター/ QA、開発者、管理者、または所有者の役割が必要です。

ユーザーの役割と役割のチートシートの完全なリストについては、次を確認してください。アプリチームでのユーザーの役割。

ビルドアーティファクトエンドポイントを使用できるようにするには、最初にアプリのビルドに属するすべてのアーティファクトを一覧表示する必要があります。応答には、後で必要になるスラッグとともにすべてのアーティファクトが一覧表示されます。

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

アプリスラッグ
ナメクジを作る

ビルドアーティファクトスラグが必須パラメーターである他のビルドアーティファクトエンドポイントで、応答出力から生成されたビルドアーティファクトスラグを使用できます。

例1 アプリのアーティファクトを一覧表示する

リクエスト：

curl -X GET "https://api.bitrise.io/v0.1/apps/87a5991e180d91a9/builds/b234f959745082e0/artifacts" -H "accept: application/json" -H "Authorization: THE-ACCESS-TOKEN"

応答：

{
  "data": [
    {
      "title": "another_app-debug.apk",
      "artifact_type": "android-apk",
      "is_public_page_enabled": true,
      "slug": "92e0b6ecae87b832",
      "file_size_bytes": 1574799
    },
    {
      "title": "app-debug.apk",
      "artifact_type": "android-apk",
      "is_public_page_enabled": true,
      "slug": "54ae701761c4f956",
      "file_size_bytes": 1574793
    }
  ],
  "paging": {
    "total_item_count": 2,
    "page_item_limit": 50
  }
}

特定のビルドアーティファクトのデータを取得する

必要な役割

APIを使用して特定のビルドのアーティファクトデータを取得するには、アプリのチームにテスター/ QA、開発者、管理者、または所有者の役割が必要です。

ユーザーの役割と役割のチートシートの完全なリストについては、次を確認してください。アプリチームでのユーザーの役割。

アーティファクトエンドポイントを使用して、特定のビルドのアーティファクトの詳細データを取得できます。応答には、ファイル名、アーティファクトタイプ、ダウンロードURL、およびファイルサイズが表示されます。

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

アプリスラッグ
ナメクジを作る
アーティファクトスラッグ

例1 特定のアーティファクトのデータを取得する

リクエスト：

curl -X GET "https://api.bitrise.io/v0.1/apps/87a5991e180d91a9/builds/b234f959745082e0/artifacts/92e0b6ecae87b832" -H "accept: application/json" -H "Authorization: THE-ACCESS-TOKEN"

応答：

{
  "data": {
    "title": "another_app-debug.apk",
    "artifact_type": "android-apk",
    "expiring_download_url": "https://bitrise-prod-build-storage.s3.amazonaws.com/builds/b234f959745082e0/artifacts/7626902/another_app-debug.apk?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAIV2YZWMVCNWNR2HA%2F20190426%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20190426T131627Z&X-Amz-Expires=600&X-Amz-SignedHeaders=host&X-Amz-Signature=9f1af26787f34b5cf0cbc18b2372313607b1e3c0203a9ce7e42da884a6ddf70f",
    "is_public_page_enabled": true,
    "slug": "92e0b6ecae87b832",
    "public_install_page_url": "https://www.bitrise.io/artifact/7626902/p/8e5b2c62abe28fecef09b271de767920",
    "file_size_bytes": 1574799
  }
}

デフォルトでは、 is_public_page_enabled 入力はに設定されます true。このように public_install_page_url が利用可能になり、このURLを介してアーティファクトに関するいくつかの基本情報を表示できます。応答出力からダウンロードURLを使用してアーティファクトをダウンロードすることもできます。

アーティファクトのパブリックインストールページを無効にする

必要な役割

APIを使用してアーティファクトの公開インストールページを無効にするには、アプリのチームに開発者、管理者、または所有者の役割が必要です。

ユーザーの役割と役割のチートシートの完全なリストについては、次を確認してください。アプリチームでのユーザーの役割。

あなたは更新することができます is_public_page_enabled APKおよびIPAファイルのパラメータ。このパラメータの値はに設定されていることに注意してください true デフォルトでは、このエンドポイントでのみ無効にできます。

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

アプリスラッグ
ナメクジを作る
アーティファクトスラッグ

例1 APKファイルの公開インストールページを無効にする

リクエスト：

curl -X PATCH "https://api.bitrise.io/v0.1/apps/87a5991e180d91a9/builds/b234f959745082e0/artifacts/54ae701761c4f956" -H "accept: application/json" -H "Authorization: THE-ACCESS-TOKEN" -H "Content-Type: application/json" -d "{ \"is_public_page_enabled\": false}"

応答：

{
  "data": {
    "title": "app-debug.apk",
    "artifact_type": "android-apk",
    "expiring_download_url": "https://bitrise-prod-build-storage.s3.amazonaws.com/builds/b234f959745082e0/artifacts/7626904/app-debug.apk?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAIV2YZWMVCNWNR2HA%2F20190503%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20190503T082800Z&X-Amz-Expires=600&X-Amz-SignedHeaders=host&X-Amz-Signature=7251fcbc0574ffac60b3f1d4a8c398658e49f0b86fb3cfec1500bde125738abc",
    "is_public_page_enabled": false,
    "slug": "54ae701761c4f956",
    "public_install_page_url": "",
    "file_size_bytes": 1574793
  }
}

ビルドをチェックする場合 APPS & ARTIFACTS タブ、あなたはそれを見るでしょう Public install page トグルは無効です。

ビルドアーティファクトの削除

必要な役割

APIを使用してビルドアーティファクトを削除するには、アプリのチームに開発者、管理者、または所有者の役割が必要です。

ユーザーの役割と役割のチートシートの完全なリストについては、次を確認してください。アプリチームでのユーザーの役割。

アプリ固有のビルドアーティファクトを削除できます。

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

アプリスラッグ
ナメクジを作る
アーティファクトスラッグ

例1 APKファイルの削除

リクエスト：

curl -X DELETE "https://api.bitrise.io/v0.1/apps/87a5991e180d91a9/builds/b234f959745082e0/artifacts/54ae701761c4f956" -H "accept: application/json" -H "Authorization: THE-ACCESS-TOKEN"

応答：

{
  "data": {
    "title": "app-debug.apk",
    "artifact_type": "android-apk",
    "expiring_download_url": null,
    "is_public_page_enabled": true,
    "slug": "54ae701761c4f956",
    "public_install_page_url": "",
    "file_size_bytes": 1574793
  }
}

このセクションの内容:

参照:

ステップワークフロー

ビルドアーティファクトの管理

Artifact retention period

200日間のビルド保持

ビルドアーティファクトの一覧表示

必要な役割

特定のビルドアーティファクトのデータを取得する

必要な役割

アーティファクトのパブリックインストールページを無効にする

必要な役割

ビルドアーティファクトの削除

必要な役割

検索結果