特定のプロジェクトの履歴をリストします。
履歴は変更時刻の降順に並べられます。 HistoryId キーは、同じ変更時刻を持つ履歴を並べ替えるのに使用されます。
次の正規エラー コードのいずれかを返す場合があります。
- PERMISSION_DENIED - ユーザーがプロジェクトを読み取る権限を持たない場合
- INVALID_ARGUMENT - リクエストの形式が不正な場合
- NOT_FOUND - 履歴が存在しない場合
HTTPリクエスト
GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories
URL はgRPC トランスコーディング構文を使用します。
パスパラメータ
パラメーター | |
---|---|
projectId | プロジェクト ID。 必須。 |
クエリパラメータ
パラメーター | |
---|---|
pageToken | 次の項目でクエリを再開するための継続トークン。 オプション。 |
pageSize | 取得する履歴の最大数。 デフォルト値: 20。フィールドが設定されていないか、値が 0 の場合、サーバーはこのデフォルトを使用します。100 を超える値は 100 として扱われます。 オプション。 |
filterByName | 設定すると、指定された名前の履歴のみが返されます。 オプション。 |
リクエストボディ
リクエストの本文は空である必要があります。
レスポンスボディ
HistoryService.Listの応答メッセージ
成功した場合、応答本文には次の構造のデータが含まれます。
JSON表現 |
---|
{
"histories": [
{
object ( |
田畑 | |
---|---|
histories[] | 歴史。 |
nextPageToken | 次の項目でクエリを再開するための継続トークン。 取得する履歴がさらにある場合にのみ設定されます。 トークンは、最初のリスト要求の時点から最大 1 時間有効です。たとえば、午後 1 時にリスト リクエストを作成し、その 10 分後にこの最初のリクエストのトークンを使用した場合、この 2 番目のレスポンスのトークンは 50 分間のみ有効になります。 |
認可範囲
次の OAuth スコープが必要です。
-
https://www.googleapis.com/auth/cloud-platform
詳細については、 「認証の概要」を参照してください。