Method: projects.locations.agentGateways.list

Listet AgentGateways in einem bestimmten Projekt und an einem bestimmten Standort auf.

HTTP-Anfrage

GET https://networkservices.googleapis.com/v1/{parent=projects/*/locations/*}/agentGateways

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das Projekt und der Standort, aus dem die AgentGateways aufgelistet werden sollen, im Format projects/*/locations/*.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource parent:

  • iam.permissions.none

Suchparameter

Parameter
pageSize

integer

Optional. Maximale Anzahl der AgentGateways, die pro Aufruf zurückgegeben werden sollen
pageToken

string

Optional. Der von der letzten ListAgentGatewaysResponse zurückgegebene Wert. Gibt an, dass es sich um eine Fortsetzung eines vorherigen agentGateways.listAgentGatewaysv2-Aufrufs handelt und dass das System die nächste Datenseite zurückgeben soll.
returnPartialSuccess

boolean

Optional. Bei „true“ sind Teilantworten für multiregionale Anfragen für zusammengefasste Listen zulässig. Andernfalls schlägt die Anfrage für zusammengefasste Listen fehl, wenn einer der Standorte nicht verfügbar oder erreichbar ist.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort, die von der Methode „agentGateways.listAgentGatewaysv2“ zurückgegeben wird

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

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

object (AgentGateway)

Liste der AgentGateway-Ressourcen.
nextPageToken

string

Wenn es mehr Ergebnisse als die in der Antwort angegebenen gibt, ist nextPageToken enthalten. Um den nächsten Satz mit Ergebnissen anzuzeigen, rufen Sie diese Methode erneut auf und verwenden Sie den Wert von nextPageToken als pageToken.
unreachable[]

string

Nicht erreichbare Ressourcen. Wird ausgefüllt, wenn in der Anfrage versucht wird, alle Ressourcen an allen unterstützten Standorten aufzulisten, einige Standorte jedoch vorübergehend nicht verfügbar sind.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.