Method: projects.locations.dataAgents.listAccessible

Listet KI-Datenagenten auf, auf die der Aufrufer in einem bestimmten Projekt und an einem bestimmten Standort zugreifen kann.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Übergeordneter Wert für „ListAccessibleDataAgentsRequest“.

Anfrageparameter

Parameter
pageSize

integer

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

pageToken

string

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

Beim Paginieren müssen alle anderen für dataAgents.listAccessible 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“.

creatorFilter

enum (CreatorFilter)

Optional. Filter für den Ersteller des KI-Agenten.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Nachricht für die Antwort auf die Auflistung der zugänglichen KI-Datenagenten.

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 zugänglichen KI-Datenagenten.

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.

CreatorFilter

Filter für den Ersteller des KI-Agenten.

Enums
CREATOR_FILTER_UNSPECIFIED Standardwert.
NONE Es wird kein erstellerspezifischer Filter angewendet. Alle KI-Agenten werden zurückgegeben.
CREATOR_ONLY Es werden nur KI-Agenten zurückgegeben, die vom Nutzer erstellt wurden, der die API aufruft.
NOT_CREATOR_ONLY Es werden nur KI-Agenten zurückgegeben, die nicht vom Nutzer erstellt wurden, der die API aufruft.