- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek gövdesi
- Yanıt gövdesi
- Yetkilendirme kapsamları
- Deneyin
Belirli bir Projenin geçmişlerini listeler.
Geçmişler, değişiklik zamanına göre azalan düzende sıralanır. historyId anahtarı, geçmişi aynı değiştirme zamanıyla sıralamak için kullanılır.
Aşağıdaki standart hata kodlarından herhangi birini döndürebilir:
- PERMISSION_DENIED - kullanıcının projeyi okuma yetkisi yoksa
- GEÇERSİZ_BİLGİ - istek hatalı biçimlendirilmişse
- NOT_FOUND: Geçmiş mevcut değilse
HTTP isteği
GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
projectId |
Proje kimliği. Zorunlu. |
Sorgu parametreleri
Parametreler | |
---|---|
pageToken |
Sorguyu bir sonraki öğede devam ettirmek için bir devam jetonu. İsteğe bağlı. |
pageSize |
Getirilecek maksimum geçmiş sayısı. Varsayılan değer: 20. Alan ayarlanmamışsa veya değeri 0 ise sunucu, bu varsayılanı kullanır. 100'den büyük değerler 100 olarak kabul edilir. İsteğe bağlı. |
filterByName |
Ayarlanırsa yalnızca verilen ada sahip geçmişleri döndürür. İsteğe bağlı. |
İstek içeriği
İsteğin gövdesi boş olmalıdır.
Yanıt gövdesi
HistoryService.List için yanıt mesajı
Başarılı olursa yanıt gövdesi aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"histories": [
{
object ( |
Alanlar | |
---|---|
histories[] |
Geçmişler. |
nextPageToken |
Sorguyu bir sonraki öğede devam ettirmek için bir devam jetonu. Yalnızca getirilecek daha fazla geçmiş varsa ayarlanır. Jetonlar, ilk liste isteği yapıldıktan sonra bir saate kadar geçerlidir. Örneğin, saat 13:00'te bir liste isteği oluşturursanız ve 10 dakika sonra bu ilk istekten jetonu kullanırsanız bu ikinci yanıttaki jeton yalnızca 50 dakika boyunca geçerli olur. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/cloud-platform
Daha fazla bilgi için Kimlik Doğrulamaya Genel Bakış başlıklı makaleye bakın.