POSIX-Gruppen abrufen und auflisten

Achtung: POSIX-Gruppen sind eingestellt. Seit dem 26. September 2024 können Sie keine neuen POSIX-Gruppen mehr erstellen. Weitere Informationen finden Sie unter Einstellung von POSIX-Gruppen.

In diesem Dokument wird beschrieben, wie POSIX-Gruppen abgerufen und aufgelistet werden.

Vorschau

Für dieses Produkt gelten die „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Hinweis: Zum Abrufen und Auflisten von POSIX-Gruppen Sie müssen Sie die Betaversion von Cloud Identity Groups API nutzen.

Mitglieder von POSIX-Gruppen abrufen

Sie können Gruppeninformationen mithilfe des Google-Gruppennamens, des POSIX-Gruppennamens, der POSIX-Gruppen-ID oder der E-Mail-Adresse abrufen.

POSIX-Gruppen nach Gruppennamen abrufen

Das folgende Beispiel zeigt, wie Sie eine POSIX-Gruppe mithilfe des Gruppennamens abrufen:

REST

Rufen Sie die Methode groups.get() mit dem Ressourcennamen der Gruppe auf, um eine POSIX-Gruppe nach Namen abzurufen.

GET "https://cloudidentity.googleapis.com/v1beta1/groups/GROUP_RESOURCE_NAME"

Dabei gilt:

• GROUP_RESOURCE_NAME: Ressourcenname der Google-Gruppe. Führen Sie den Befehl gcloud identity groups describe aus, um den Ressourcennamen einer Gruppe zu ermitteln.

Python

Das folgende Beispiel zeigt, wie eine POSIX-Gruppe anhand der Python-Clientbibliothek nach Name abgerufen wird:

def get_posix_group_by_name(name):
  service = build_service()
  response = service.groups().get(name=name).execute()
  return response

POSIX-Gruppen nach POSIX-Gruppennamen abrufen

Das folgende Beispiel zeigt, wie Gruppeninformationen anhand des POSIX-Gruppennamens abgerufen werden:

REST

Rufen Sie die Methode groups.search() mit dem folgenden Abfragestring auf, um nach einer POSIX-Gruppe nach POSIX-Gruppennamen zu suchen:

query=parent=='customers/CUSTOMER_ID' && 'cloudidentity.googleapis.com/groups.posix' in labels && posix_groups.exists(pg, pg.name=='POSIX_NAME')

Ersetzen Sie POSIX_NAME durch den Namen, den Sie der POSIX-Gruppe zuweisen möchten.

Das folgende Beispiel zeigt eine GET-Anfrage mit der Abfrage:

GET "https://cloudidentity.googleapis.com/v1beta1/groups:search?query=parent=='customers/CUSTOMER_ID'%26%26'cloudidentity.googleapis.com/groups.posix'%20in%20labels%26%26posix_groups.exists(pg,pg.name=='POSIX_GROUP_NAME')&view=VIEW"

Dabei gilt:

• CUSTOMER_ID: Kundennummer für Ihre Organisation. Führen Sie den Befehl gcloud organizations list aus, um die Kundennummer zu ermitteln.
• POSIX_NAME: Name, den Sie der POSIX-Gruppe zuweisen möchten
• VIEW: entweder FULL oder BASIC

Python

Das folgende Beispiel zeigt, wie eine POSIX-Gruppe nach POSIX-Gruppennamen mithilfe der Python-Clientbibliothek abgerufen wird:

def get_posix_group_by_posix_name((service, customer_id, posix_group_name, page_size, view):
  # Set the label to search for a POSIX group
  searchQuery = ("&query=parent=='customers/{customer_id}' "
         "&& 'cloudidentity.googleapis.com/groups.posix' in labels "
         "&& posix_groups.exists(pg, pg.name=='{posix_group_name}')"
         "?pageSize={page_size}&view={view}".format(
             customer_id=customer_id, posix_group_name=posix_group_name,
             page_size=page_size, view=view))
  try:
    searchGroupsRequest = service.groups().search()
    searchGroupsRequest.uri += searchQuery
    response = searchGroupsRequest.execute()
    print response
  except Exception as e:
    print e

POSIX-Gruppe nach POSIX-Gruppen-ID abrufen

Das folgende Beispiel zeigt, wie Gruppeninformationen mithilfe der Gruppen-ID abgerufen werden:

REST

Rufen Sie die Methode groups.search() mit dem folgenden Abfragestring auf, um nach einer POSIX-Gruppe nach ID zu suchen:

query=parent=='customers/CUSTOMER_ID' && 'cloudidentity.googleapis.com/groups.posix' in labels && posix_groups.exists(pg, pg.gid==GIDu)

Dabei gilt:

• CUSTOMER_ID: Kundennummer für Ihre Organisation. Führen Sie den Befehl gcloud organizations list aus, um die Kundennummer zu ermitteln.
• GROUP_ID: Gruppen-ID (GID), die Sie der POSIX-Gruppe zuweisen möchten

Das folgende Beispiel zeigt eine GET-Anfrage mit der Abfrage:

GET "https://cloudidentity.googleapis.com/v1beta1/groups:search?query=parent=='customers/CUSTOMER_ID'%26%26'cloudidentity.googleapis.com/groups.posix'%20in%20labels%26%26posix_groups.exists(pg,pg.gid==GROUP_IDu)&view=VIEW"

Dabei gilt:

• CUSTOMER_ID: Kundennummer für Ihre Organisation. Führen Sie den Befehl gcloud organizations list aus, um die Kundennummer zu ermitteln.
• GROUP_ID: Gruppen-ID (GID), die Sie der POSIX-Gruppe zuweisen möchten
• VIEW: entweder FULL oder BASIC

Python

Das folgende Beispiel zeigt, wie eine POSIX-Gruppe nach Gruppen-ID mithilfe der Python-Clientbibliothek abgerufen wird:

def get_posix_group_by_gid(service, customer_id, posix_group_id, page_size, view):
  # Set the label to search for a POSIX group
  searchQuery = ("&query=parent=='customers/{customer_id}' "
         "&& 'cloudidentity.googleapis.com/groups.posix' in labels "
         "&& posix_groups.exists(pg, pg.gid=={posix_group_id}u)"
         "?pageSize={page_size}&view={view}".format(
             customer_id=customer_id, posix_group_id=posix_group_id,
             page_size=page_size, view=view))
  try:
    searchGroupsRequest = service.groups().search()
    searchGroupsRequest.uri += searchQuery
    response = searchGroupsRequest.execute()
    print response
  except Exception as e:
    print e

POSIX-Gruppe per E-Mail abrufen

Das folgende Beispiel zeigt, wie Gruppeninformationen mithilfe der Gruppen-E-Mail-Adresse abgerufen werden:

gcloud

Verwenden Sie den Befehl gcloud beta identity groups describe, um alle POSIX-Gruppen in einer Organisation aufzulisten:

gcloud beta identity groups describe EMAIL_ADDRESS

Ersetzen Sie EMAIL_ADDRESS durch die E-Mail-Adresse der zu durchsuchenden Gruppe.

REST

So rufen Sie eine POSIX-Gruppe per E-Mail ab:

1. Rufen Sie die Methode groups.lookup() mit der Gruppen-E-Mail-Adresse auf:

   GET "https://cloudidentity.googleapis.com/v1beta1/groups:lookup?groupKey.id=EMAIL_ADDRESS"
   

   Notieren Sie sich den Ressourcennamen der zurückgegebenen Gruppe.

2. Rufen Sie die Methode groups.get() mit dem Ressourcennamen der Gruppe auf:

   GET "https://cloudidentity.googleapis.com/v1beta1/groups/GROUP_RESOURCE_NAME"
   

Python

Das folgende Beispiel zeigt, wie eine POSIX-Gruppe per E-Mail mithilfe der Python-Clientbibliothek abgerufen wird:

def get_posix_group_by_email(email):
  service = build_service()

  # First we use the email to get the groups name calling lookup()
  lookup_group_name_request = service.groups().lookup()
  param = "&groupKey.id=" + email
  lookup_group_name_request.uri += param
  lookup_group_name_response = lookup_group_name_request.execute()
  name = lookup_group_name_response.get("name")

  # Then we can call get() by passing in the group's name
  response = service.groups().get(name=name).execute()
  return response

POSIX-Gruppen auflisten

In den folgenden Beispielen wird gezeigt, wie Sie alle POSIX-Gruppen in Ihrer Organisation auflisten können:

gcloud

Verwenden Sie den Befehl gcloud identity groups search, um alle POSIX-Gruppen in einer Organisation aufzulisten:

gcloud identity groups search \
    --labels=cloudidentity.googleapis.com/groups.posix \
    --organization=ORGANIZATION

Ersetzen Sie ORGANIZATION durch die Organisations-ID der zu durchsuchenden Gruppe.

REST

Wenn Sie nach allen POSIX-Gruppen suchen möchten, rufen Sie die Methode groups.search() mit dem folgenden Abfragestring auf:

query=parent=='customers/CUSTOMER_ID' && 'cloudidentity.googleapis.com/groups.posix' in labels

Ersetzen Sie CUSTOMER_ID durch die Kundennummer für Ihre Organisation. Führen Sie den Befehl gcloud organizations list aus, um die Kundennummer zu ermitteln.

Das folgende Beispiel zeigt eine GET-Anfrage mit der Abfrage:

GET "https://cloudidentity.googleapis.com/v1beta1/groups:search?query=parent=='customers/CUSTOMER_ID'%26%26'cloudidentity.googleapis.com/groups.posix'%20in%20labels&view=VIEW"

Dabei gilt:

• CUSTOMER_ID: Kundennummer für Ihre Organisation. Führen Sie den Befehl gcloud organizations list aus, um die Kundennummer zu ermitteln.
• GROUP_ID: Gruppen-ID (GID), die Sie der POSIX-Gruppe zuweisen möchten
• VIEW: entweder FULL oder BASIC

Python

Im folgenden Beispiel wird eine Hilfsfunktion zur Suche nach POSIX-Gruppen mithilfe der Python-Clientbibliothek gezeigt:

def search_posix_groups(service, customer_id, page_size, view):
  # Set the label to search for all POSIX groups
  searchQuery = ("&query=parent=='customers/{customer_id}' "
         "&& 'cloudidentity.googleapis.com/groups.posix' in labels "
         "?pageSize={page_size}&view={view}".format(
             customer_id=customer_id, page_size=page_size, view=view))
  try:
    searchGroupsRequest = service.groups().search()
    searchGroupsRequest.uri += searchQuery
    response = searchGroupsRequest.execute()
    print response
  except Exception as e:
    print e