- Bitriseドキュメントへようこそ！
- API
- ビルドアーティファクトの管理
ビルドアーティファクトの管理
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-buildsAPIエンドポイント： アプリのアーカイブされたビルドの一覧表示。
|
終点 |
関数 |
アプリのチームで必要な役割 |
|---|---|---|
|
ビルドアーティファクトの一覧表示 |
どれでも |
|
|
GET / apps / {app-slug} / builds / {build-slug} / artifacts / {artifact-slug} |
特定のビルドアーティファクトのデータを取得する |
どれでも |
|
パッチ/アプリ/ {アプリ-スラッグ} / builds / {ビルド-スラッグ} /アーティファクト/ {アーティファクト-スラッグ} |
ビルドアーティファクトの更新 |
所有者、管理者、または開発者 |
|
DELETE / apps / {app-slug} / builds / {build-slug} / artifacts / {artifact-slug} |
ビルドアーティファクトの削除 |
所有者、管理者、または開発者 |
ビルドアーティファクトの一覧表示
必要な役割
APIを使用してビルドアーティファクトを一覧表示するには、アプリのチームにテスター/ QA、開発者、管理者、または所有者の役割が必要です。
ユーザーの役割と役割のチートシートの完全なリストについては、次を確認してください。 プロジェクトチームのユーザーロール。
ビルドアーティファクトエンドポイントを使用できるようにするには、最初にアプリのビルドに属するすべてのアーティファクトを一覧表示する必要があります。応答には、後で必要になるスラッグとともにすべてのアーティファクトが一覧表示されます。
必要なパラメーターは次のとおりです。
-
アプリスラッグ
-
ナメクジを作る
ビルドアーティファクトスラグが必須パラメーターである他のビルドアーティファクトエンドポイントで、応答出力から生成されたビルドアーティファクトスラグを使用できます。
リクエスト：
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、およびファイルサイズが表示されます。
必要なパラメーターは次のとおりです。
-
アプリスラッグ
-
ナメクジを作る
-
アーティファクトスラッグ
リクエスト：
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 デフォルトでは、このエンドポイントでのみ無効にできます。
必要なパラメーターは次のとおりです。
-
アプリスラッグ
-
ナメクジを作る
-
アーティファクトスラッグ
リクエスト：
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を使用してビルドアーティファクトを削除するには、アプリのチームに開発者、管理者、または所有者の役割が必要です。
ユーザーの役割と役割のチートシートの完全なリストについては、次を確認してください。 プロジェクトチームのユーザーロール。
アプリ固有のビルドアーティファクトを削除できます。
必要なパラメーターは次のとおりです。
-
アプリスラッグ
-
ナメクジを作る
-
アーティファクトスラッグ
リクエスト：
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
}
}