Method: projects.locations.dataAgents.list

Listet DataAgents in einem angegebenen Projekt und an einem angegebenen Standort auf.

HTTP-Anfrage

GET https://geminidataanalytics.googleapis.com/v1beta/{parent=projects/*/locations/*}/dataAgents

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Pflichtangabe. Übergeordneter Wert für ListDataAgentsRequest.

Abfrageparameter

Parameter
pageSize

integer

Optional. Der Server gibt möglicherweise weniger Elemente als angefordert zurück. Wenn kein Wert angegeben wurde, wählt der Server ein geeignetes Standardmodell aus.

pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen dataAgents.list-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für dataAgents.list bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Der Dienst gibt möglicherweise weniger als diesen Wert zurück.

filter

string

Optional. Filtert die Ergebnisse. Informationen zur Syntax finden Sie unter AIP-160.

orderBy

string

Optional. Nutzerspezifikation zur Sortierung der Ergebnisse.

showDeleted

boolean

Optional. Bei „true“ enthalten die Listenergebnisse auch vorläufig gelöschte KI-Datenagenten. Die Standardeinstellung ist „false“.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Nachricht für die Antwort auf die Auflistung von DataAgents.

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "dataAgents": [
    {
      object (DataAgent)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Felder
dataAgents[]

object (DataAgent)

Die Liste der DataAgents.

nextPageToken

string

Das Token für die nächste Seite oder leer, wenn keines vorhanden ist.

unreachable[]

string

Unsortierte Liste. Standorte, die nicht erreicht werden konnten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource parent:

  • geminidataanalytics.dataAgents.list

Weitere Informationen finden Sie in der IAM-Dokumentation.