Method: projects.profiles.list

Listet Profile auf, die bisher erfasst wurden und für die der Aufrufer eine Anzeigeberechtigung hat.

HTTP-Anfrage

GET https://cloudprofiler.googleapis.com/v2/{parent=projects/*}/profiles

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das übergeordnete Element, das Inhaber dieser Profilsammlung ist. Format: projects/{user_project_id} hat das Format projects/{project}.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • cloudprofiler.profiles.list

Suchparameter

Parameter
pageSize

integer

Optional. Die maximale Anzahl der Elemente, die zurückzugeben sind. Die Standardgröße für Seiten ist 1.000. Das Limit beträgt 1.000.

pageToken

string

Optional. Das Token, mit dem die Paginierung fortgesetzt und Profile von einer bestimmten Seite abgerufen werden kann. Beim Paginieren müssen alle anderen für profiles.list bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

ListProfileResponse enthält die Liste der gesammelten Profile für Bereitstellungen in Projekten, für die der Nutzer über Berechtigungen zum Ansehen verfügt.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung
{
  "profiles": [
    {
      object (Profile)
    }
  ],
  "nextPageToken": string,
  "skippedProfiles": integer
}
Felder
profiles[]

object (Profile)

Liste der Profile abgerufen.

nextPageToken

string

Token zum Abrufen der nächsten Ergebnisseite. Dieses Feld kann leer sein, wenn keine weiteren Profile zum Abrufen vorhanden sind.

skippedProfiles

integer

Anzahl der Profile, die auf der aktuellen Seite übersprungen wurden, weil sie nicht abgerufen werden konnten. Dieser sollte normalerweise null sein. Ein Wert ungleich null kann auf einen vorübergehenden Fehler hinweisen. Wenn die Zahl für Ihren Anwendungsfall zu hoch ist, kann der Aufruf wiederholt werden.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.