Method: projects.locations.serverTlsPolicies.list

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

HTTP-Anfrage

GET https://networksecurity.googleapis.com/v1/{parent=projects/*/locations/*}/serverTlsPolicies

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das Projekt und der Speicherort, aus dem die ServerTlsPolicies aufgelistet werden sollen, im Format projects/*/locations/{location}.

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

  • networksecurity.serverTlsPolicies.list

Suchparameter

Parameter
pageSize

integer

Maximale Anzahl der ServerTlsPolicies, die pro Aufruf zurückgegeben werden.

pageToken

string

Der vom letzten ListServerTlsPoliciesResponse zurückgegebene Wert gibt an, dass es sich um eine Fortsetzung eines vorherigen serverTlsPolicies.list-Aufrufs handelt und dass das System die nächste Datenseite zurückgeben soll.

returnPartialSuccess

boolean

Optional. Wenn Sie dieses Feld auf true festlegen, werden in der Anfrage die erreichbaren Ressourcen zurückgegeben und die Namen der nicht erreichbaren Ressourcen werden im Feld [ListServerTlsPoliciesResponse.unreachable] aufgeführt. Dieser Wert kann nur true sein, wenn zwischen Sammlungen gelesen wird, z.B. wenn parent auf "projects/example/locations/-" gesetzt ist.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort, die von der Methode „serverTlsPolicies.list“ zurückgegeben wird.

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

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

object (ServerTlsPolicy)

Liste der ServerTlsPolicy-Ressourcen.

nextPageToken

string

Wenn es mehr Ergebnisse als in dieser Antwort angezeigte gibt, wird nextPageToken eingefügt. Rufen Sie diese Methode noch einmal auf, um den nächsten Satz von Ergebnissen zu erhalten. Verwenden Sie dabei den Wert von nextPageToken als pageToken.

unreachable[]

string

Nicht erreichbare Ressourcen. Wird ausgefüllt, wenn in der Anfrage returnPartialSuccess aktiviert und die Daten aus mehreren Sammlungen gelesen werden, z.B. wenn versucht wird, alle Ressourcen an allen unterstützten Standorten aufzulisten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.