Method: projects.histories.list

Liệt kê lịch sử cho một dự án nhất định.

Lịch sử được sắp xếp theo thời gian sửa đổi theo thứ tự giảm dần. Khóa historyId sẽ được sử dụng để sắp xếp lịch sử với cùng thời gian sửa đổi.

Có thể trả về bất kỳ mã lỗi chuẩn nào sau đây:

  • PERMISSION_DENIED - nếu người dùng không được phép đọc dự án
  • INVALID_ARGUMENT - nếu yêu cầu không đúng định dạng
  • NOT_FOUND - nếu Lịch sử không tồn tại

Yêu cầu HTTP

GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories

URL sử dụng cú pháp Chuyển mã gRPC .

Tham số đường dẫn

Thông số
projectId

string

Id dự án.

Yêu cầu.

Tham số truy vấn

Thông số
pageToken

string

Mã thông báo tiếp tục để tiếp tục truy vấn ở mục tiếp theo.

Không bắt buộc.

pageSize

integer

Số lượng Lịch sử tối đa cần tìm nạp.

Giá trị mặc định: 20. Máy chủ sẽ sử dụng giá trị mặc định này nếu trường không được đặt hoặc có giá trị 0. Mọi giá trị lớn hơn 100 sẽ được coi là 100.

Không bắt buộc.

filterByName

string

Nếu được đặt, chỉ trả về lịch sử có tên đã cho.

Không bắt buộc.

Nội dung yêu cầu

Phần thân yêu cầu phải trống.

Nội dung phản hồi

Thông báo phản hồi cho HistoryService.List

Nếu thành công, nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn JSON
{
  "histories": [
    {
      object (History)
    }
  ],
  "nextPageToken": string
}
Lĩnh vực
histories[]

object ( History )

Lịch sử.

nextPageToken

string

Mã thông báo tiếp tục để tiếp tục truy vấn ở mục tiếp theo.

Sẽ chỉ được đặt nếu có nhiều lịch sử hơn để tìm nạp.

Mã thông báo có hiệu lực trong tối đa một giờ kể từ thời điểm yêu cầu danh sách đầu tiên. Ví dụ: nếu bạn thực hiện yêu cầu danh sách lúc 1 giờ chiều và sử dụng mã thông báo từ yêu cầu đầu tiên này 10 phút sau, mã thông báo từ phản hồi thứ hai này sẽ chỉ có hiệu lực trong 50 phút.

Phạm vi ủy quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform

Để biết thêm thông tin, hãy xem Tổng quan về xác thực .