events リソース

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

Bitbucket Cloud v1 API は廃止予定です

Bitbucket Cloud REST API バージョン 1 は 2018 年 6 月 30 日に廃止予定です。すべての 1.0 API は、2019 年 4 月 29 日に、REST API から完全に削除されます。廃止についての告知をご確認ください。また、バージョン 2.0 の REST API ドキュメントをご確認ください。

概要

イベントを使用すると、公開リポジトリや、自身がアクセス権を持つ非公開リポジトリで発生したイベントを追跡できます。現在 Bitbucket では、非公開リポジトリからのイベントの表示はサポートされていません。このエンドポイントは認証が不要で、読み取り専用のリソースです。個々の events リソースには以下のフィールドが含まれます。

フィールド 説明
count アカウントに関連付けられたイベントの総数。
1 つの events 配列は個々の event 構造体の一覧を持ち、それぞれに次のフィールドが含まれます。
node イベントが commitの場合、このフィールドには changeset ノードが含まれます。それ以外の場合、このフィールドには null が含まれます。
description イベントが commit の場合、このフィールドには生コミットからのコミットが含まれます。それ以外の場合、このフィールドには null が含まれます。
repository イベントが特定のリポジトリ上にある場合、リポジトリ構造が含まれます。それ以外の場合、このフィールドには null が含まれます。
created_on イベントが発生した時間。イベントが commit の場合、これは生コミットの時間になります。
user ユーザー プロファイル構造が含まれます。
utc_created_on イベントの UTC 時間。
event イベント タイプ。

以下の表は、event フィールドで取りうる値の一覧です。イベントを一覧表示するときは、以下の値でもフィルタリングできます。

イベント ID 説明
pushed ユーザーによるチェンジセットのプッシュ。
commit ユーザーによるリポジトリへのコミット。
fork ユーザーによるリポジトリのフォーク。
mq ユーザーによるリポジトリのパッチ キューの作成。これは Mercurial リポジトリでのみ有効。
create ユーザーによるリポジトリの作成。
delete ユーザーによるリポジトリの削除。
report_issue 課題トラッカーでの新しい課題の作成。
issue_update ユーザーによる課題の更新。
issue_comment ユーザーによる課題コメントの更新。
wiki_updated ユーザーによる wiki ページの更新。
wiki_created ユーザーによる wiki ページの追加。
file_uploaded ユーザーによるファイルのアップロード (アイコンなど)。
strip ユーザーによるリポジトリのストリップ。
report_issue ユーザーによる課題の報告。
start_follow_repo ユーザーによるリポジトリのフォローの開始。
stop_follow_repo ユーザーによるリポジトリのフォローの停止。
start_follow_issue ユーザーによる課題のフォローの開始。
stop_follow_issue ユーザーによる課題のフォローの停止。
start_follow_user ユーザーによる課題のフォローの開始。
stop_follow_user ユーザーによるユーザーのフォローの停止。
pullrequest_created ユーザーによるプル リクエストの作成。
pullrequest_updated ユーザーによるプル リクエストの更新。
pullrequest_fulfilled ユーザーによるプル リクエストの承認。
pullrequest_rejected ユーザーによるプル リクエストの却下。
pullrequest_superseded ユーザーによるプル リクエストの破棄としてのマーク付け。
pullrequest_comment_created ユーザーによるプル リクエストのコメントの作成。
pullrequest_comment_updated ユーザーによるプル リクエストのコメントの更新。
pullrequest_comment_deleted ユーザーによるプル リクエストのコメントの削除。
cset_comment_updated ユーザーによるチェンジセット コメントの更新。
cset_comment_deleted ユーザーによるチェンジセット コメントの削除。
cset_comment_created ユーザーによるチェンジセット コメントの作成。
pullrequest_like ユーザーによるプル リクエストの承認。
pullrequest_unlike ユーザーによるプル リクエストの承認の取消。
cset_like ユーザーによるチェンジセットの承認。
cset_unlike ユーザーによるチェンジセットの承認の取消。
team_access_gained_admin ユーザーへのチーム アカウントの管理権限の付与。
team_access_gained_collab ユーザーへのチーム アカウントのコラボレーション権限の付与。
team_lost_access ユーザーのチーム アカウントへのアクセス権の喪失。
team_access_changed_admin ユーザーによるチームの管理権限の変更。
team_access_changed_collab ユーザーによるチームの共同作業者権限の変更。

イベント一覧の GET

指定した repo_slug に関連付けられたリポジトリのイベントの一覧を取得します。既定では、この呼び出しは上位 25 件のイベントを返します。次のパラメーターをこの呼び出しに指定できます。

パラメータ 必須かどうか 説明
accountname はい リポジトリを所有しているチームまたは個人アカウント。
repo_slug はい リポジトリ ID。
start いいえ 開始オフセットを指定する整数。既定では、この呼び出しは 0 から始まります。
limit いいえ 返却するイベントの数を示す整数。0 から 50 の間で値を指定できます。0 を指定した場合、システムは count を返しますが、イベント配列は空です。
type いいえ 返却するイベント タイプ。type パラメータを指定した場合、count にはアカウントに関連付けられたその type のイベントの総数が含まれます。
 GET https://api.bitbucket.org/1.0/repositories/{accountname}/{repo_slug}/events?limit=integer&start=integer&type=event
ここをクリックして展開...

たとえば、https:// bitbucket.org/api/1.0/repositories/buserbb/testpermchange/events?type=&limit=1&start=30 は以下を返します。

{
    "count": 35,
    "events": [
        {
            "node": "abdeaf1b2b4a",
            "description": "making some changes\n",
            "repository": {
                "scm": "git",
                "has_wiki": true,
                "last_updated": "2012-07-25 21:48:36",
                "creator": null,
                "created_on": "2012-06-21 18:36:31",
                "owner": "buserbb",
                "logo": "https://bitbucket-assetroot.s3.amazonaws.com/c/photos/2012/Jul/25/testpermchange-logo-3628656753-1_avatar.png",
                "email_mailinglist": "",
                "is_mq": false,
                "size": 2857,
                "read_only": false,
                "fork_of": null,
                "mq_of": null,
                "followers_count": 1,
                "state": "available",
                "utc_created_on": "2012-06-21 16:36:31+00:00",
                "website": "",
                "description": "",
                "has_issues": true,
                "is_fork": false,
                "slug": "testpermchange",
                "is_private": false,
                "name": "testpermchange",
                "language": "",
                "utc_last_updated": "2012-07-25 19:48:36+00:00",
                "email_writers": true,
                "no_public_forks": false,
                "resource_uri": "/1.0/repositories/buserbb/testpermchange"
            },
            "created_on": "2012-07-24 00:26:49",
            "user": null,
            "utc_created_on": "2012-07-23 22:26:49+00:00",
            "event": "commit"
        }
    ]
}
最終更新日 2018 年 6 月 14 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.