- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi ủy quyền
- Thử nó!
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 | Id dự án. Yêu cầu. |
Tham số truy vấn
Thông số | |
---|---|
pageToken | 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 | 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 | 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 ( |
Lĩnh vực | |
---|---|
histories[] | Lịch sử. |
nextPageToken | 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 .