Sie können die Richtlinie für die Identitäts- und Zugriffsverwaltung (Identity and Access Management, IAM) oder die Zugriffssteuerung für einen oder mehrere Konnektivitätstests festlegen oder abrufen. Darüber hinaus können Sie die Berechtigungen aufrufen, die ein Nutzer oder ein Dienstkonto für einen bestimmten Konnektivitätstest hat.
Dieses Dokument zeigt Beispiele für die Zugriffssteuerung, bei denen die Network Management API verwendet wird.
Informationen zum Ausführen dieser Schritte in der Google Cloud Console oder mithilfe von gcloud
-Befehlen finden Sie in den IAM-Anleitungen.
Informationen zu Richtlinienbindungen und ETags, die in den folgenden Befehlen aufgeführt sind, finden Sie in der API-Referenz für IAM-Richtlinien.
Informationen zu den IAM-Rollen und Berechtigungen, die zum Ausführen von Konnektivitätstests erforderlich sind, finden Sie unter Rollen und Berechtigungen.
Richtlinien für die Zugriffssteuerung festlegen
Mit diesem Verfahren wird die Zugriffssteuerungsrichtlinie für die angegebene Konnektivitätstests-Ressource festgelegt.
API
Legen Sie die Zugriffssteuerungsrichtlinie für einen USER
, eine ROLE
und eine TEST_ID
mithilfe der Methode networkmanagement.connectivitytests.setIamPolicy
fest.
Im folgenden Beispiel wird eine Richtlinie festgelegt, die die Rolle networkmanagement.admin
für mytest-1
an username@yourcompany.com
bindet.
POST https: //networkmanagement.googleapis.com/v1/{resource=projects/*/locations/global/connectivityTests/TEST_ID}:setIamPolicy { "version": "VERSION", "etag": "ETAG", "bindings": [{ "role": "ROLE", "members": [ "PRINCIPAL" ] }] }
Ersetzen Sie die folgenden Werte:
TEST_ID
: die ID des Objekts "Konnektivitätstests" (Test), das Sie ausführenVERSION
: gibt das Format der Richtlinie an. Gültige Werte sind0
,1
und3
. Bei jedem Vorgang, der sich auf bedingte Rollenbindungen auswirkt, muss die Version3
angegeben werden.ETAG
: wird für eine optimistische Gleichzeitigkeitserkennung verwendet, mit der verhindert werden kann, dass sich gleichzeitige Aktualisierungen einer Richtlinie gegenseitig überschreiben (ein ETag ist z. B.BwWbrqiZFRs=
).ROLE
: eine Rolle, die Hauptkonten zugewiesen ist (z. B.roles/networkmanagement.admin
)PRINCIPAL
: gibt die Identitäten an, die Zugriff auf eine Google Cloud-Ressource anfordern, z. B.user:username@yourcompany.com
. Eine Liste der Hauptkonten oder Mitgliedertypen finden Sie in der API-Referenz zu IAM-Richtlinien.
Zugriffssteuerungsrichtlinie abrufen
In diesem Verfahren wird die Zugriffssteuerungsrichtlinie für die angegebene Konnektivitätstests-Ressource abgerufen.
API
Legen Sie die Zugriffssteuerungsrichtlinie für ein PRINCIPAL
, eine ROLE
und eine TEST_ID
mithilfe der Methode networkmanagement.connectivitytests.getIamPolicy
fest.
Im folgenden Beispiel wird eine Richtlinie abgerufen, die die Rolle networkmanagement.admin
für mytest-1
an username@yourcompany.com
bindet.
GET https: //networkmanagement.googleapis.com/v1/{resource=projects/*/locations/global/connectivityTests/TEST_ID}:getIamPolicy { "version": "VERSION", "etag": "ETAG", "bindings": [{ "role": "ROLE", "members": [ "PRINCIPAL" ] }] }
Ersetzen Sie die folgenden Werte:
TEST_ID
: die ID des Objekts "Konnektivitätstests" (Test), das Sie ausführenVERSION
: gibt das Format der Richtlinie an. Gültige Werte sind0
,1
und3
. Bei jedem Vorgang, der sich auf bedingte Rollenbindungen auswirkt, muss die Version3
angegeben werden.ETAG
: wird für eine optimistische Gleichzeitigkeitserkennung verwendet, mit der verhindert werden kann, dass sich gleichzeitige Aktualisierungen einer Richtlinie gegenseitig überschreiben (ein ETag ist z. B.BwWbrqiZFRs=
).ROLE
: eine Rolle, die Hauptkonten zugewiesen wird (z. B.roles/networkmanagement.admin
)PRINCIPAL
: gibt die Identitäten an, die Zugriff auf eine Google Cloud-Ressource anfordern, z. B.user:username@yourcompany.com
. Eine Liste der Hauptkonten finden Sie in der API-Referenz zu IAM-Richtlinien.
Test IAM-Berechtigungen
Bei diesem Verfahren werden Berechtigungen zurückgegeben, die ein Nutzer oder Dienstkonto für eine Konnektivitätstests-Ressource hat.
API
Verwenden Sie die Methode networkmanagement.connectivitytests.testIamPermissions
, um die einer TEST_ID
zugewiesenen Berechtigungen zurückzugeben.
Im folgenden Beispiel wird geprüft, ob username@yourcompany.com
die Berechtigung networkmanagement.connectivitytests.get
für mytest-1
hat.
POST https://networkmanagement.googleapis.com/v1/{resource=projects/*/locations/global/connectivityTests/TEST_ID}:testIamPermissions { "permissions": [ "networkmanagement.connectivitytests.get" ] }
Ersetzen Sie TEST_ID
durch die ID des ausgeführten Konnektivitätstests-Objekts (Test).