Recupero e creazione di un elenco dei gruppi POSIX

Questo documento spiega come recuperare ed elencare i gruppi POSIX.

Anteprima

Questo prodotto è soggetto ai "Termini delle offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Nota: devi utilizzare la versione beta dell'API Cloud Identity Groups per recuperare ed elencare i gruppi POSIX.

Recupero dei membri dei gruppi POSIX

Puoi recuperare le informazioni sul gruppo utilizzando il nome del gruppo Google, il nome del gruppo POSIX, l'ID gruppo POSIX o l'indirizzo email.

Recupero di un gruppo POSIX per nome del gruppo

L'esempio seguente mostra come recuperare un gruppo POSIX utilizzando il nome del gruppo:

REST

Per recuperare un gruppo POSIX in base al nome, chiama il metodo groups.get() con il nome della risorsa del gruppo.

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

Sostituisci quanto segue:

• GROUP_RESOURCE_NAME: il nome della risorsa del gruppo Google. Per trovare il nome della risorsa di un gruppo, esegui il comando gcloud identity groups describe

Python

L'esempio seguente mostra come recuperare un gruppo POSIX per nome utilizzando la libreria client Python:

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

Recupero di un gruppo POSIX in base al nome del gruppo POSIX

L'esempio seguente mostra come recuperare le informazioni sul gruppo per il nome del gruppo POSIX:

REST

Per cercare un gruppo POSIX in base al nome del gruppo POSIX, chiama il metodo groups.search() con la seguente stringa di query:

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

Sostituisci POSIX_NAME con il nome che vuoi assegnare al gruppo POSIX.

Di seguito è riportata una richiesta GET che utilizza la query:

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"

Sostituisci quanto segue:

• CUSTOMER_ID: l'ID cliente della tua organizzazione. Per trovare l'ID cliente, esegui il comando gcloud organizations list
• POSIX_NAME: il nome che vuoi assegnare al gruppo POSIX
• VIEW: FULL o BASIC

Python

L'esempio seguente mostra come recuperare un gruppo POSIX in base al nome del gruppo POSIX utilizzando la libreria client Python:

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

Recupero di un gruppo POSIX in base all'ID gruppo POSIX

L'esempio seguente mostra come recuperare le informazioni sul gruppo utilizzando l'ID gruppo:

REST

Per cercare un gruppo POSIX in base all'ID, chiama il metodo groups.search() con la seguente stringa di query:

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

Sostituisci quanto segue:

• CUSTOMER_ID: l'ID cliente della tua organizzazione. Per trovare l'ID cliente, esegui il comando gcloud organizations list
• GROUP_ID: l'ID gruppo (GID) che vuoi assegnare al gruppo POSIX

Di seguito è riportata una richiesta GET che utilizza la query:

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"

Sostituisci quanto segue:

• CUSTOMER_ID: l'ID cliente della tua organizzazione. Per trovare l'ID cliente, esegui il comando gcloud organizations list
• GROUP_ID: l'ID gruppo (GID) che vuoi assegnare al gruppo POSIX
• VIEW: FULL o BASIC

Python

L'esempio seguente mostra come recuperare un gruppo POSIX in base all'ID gruppo utilizzando la libreria client Python:

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

Recupero di un gruppo POSIX via email

Il seguente esempio mostra come recuperare le informazioni del gruppo utilizzando l'email del gruppo:

gcloud

Utilizza il comando gcloud beta identity groups describe per elencare tutti i gruppi POSIX di un'organizzazione:

gcloud beta identity groups describe EMAIL_ADDRESS

Sostituisci EMAIL_ADDRESS con l'indirizzo email del gruppo oggetto della ricerca.

REST

Per recuperare un gruppo POSIX via email:

1. Chiama il metodo groups.lookup() con l'indirizzo email del gruppo:

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

   Prendi nota del nome della risorsa del gruppo restituito.

2. Chiama il metodo groups.get() con il nome della risorsa del gruppo:

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

Python

L'esempio seguente mostra come recuperare un gruppo POSIX via email utilizzando la libreria client Python:

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

Elenco dei gruppi POSIX

I seguenti esempi mostrano come elencare tutti i gruppi POSIX della tua organizzazione:

gcloud

Utilizza il comando gcloud identity groups search per elencare tutti i gruppi POSIX di un'organizzazione:

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

Sostituisci ORGANIZATION con l'ID organizzazione del gruppo oggetto della ricerca.

REST

Per cercare tutti i gruppi POSIX, chiama il metodo groups.search() con la seguente stringa di query:

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

Sostituisci CUSTOMER_ID con l'ID cliente della tua organizzazione. Per trovare l'ID cliente, esegui il comando gcloud organizations list.

Di seguito è riportata una richiesta GET che utilizza la query:

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

Sostituisci quanto segue:

• CUSTOMER_ID: l'ID cliente della tua organizzazione. Per trovare l'ID cliente, esegui il comando gcloud organizations list
• GROUP_ID: l'ID gruppo (GID) che vuoi assegnare al gruppo POSIX
• VIEW: FULL o BASIC

Python

L'esempio seguente mostra una funzione helper per cercare gruppi POSIX utilizzando la libreria client Python:

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