Recupero e creazione di un elenco dei gruppi POSIX

Attenzione: i gruppi POSIX sono deprecati. A partire dal 26 settembre 2024, non potrai più creare nuovi gruppi POSIX. Per ulteriori informazioni, consulta Deprecazione dei gruppi POSIX.

Questo documento spiega come recuperare e creare un elenco dei 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 ulteriori informazioni, consulta le descrizioni della fase di lancio.

Nota: devi utilizzare la versione beta dell'API Cloud Identity Groups per recuperare e creare un elenco dei gruppi POSIX.

Recupero dei membri dei gruppi POSIX

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

Recupero di un gruppo POSIX in base al nome del gruppo

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

REST

Per recuperare un gruppo POSIX in base al nome, chiama il groups.get() metodo 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 gcloud identity groups describe comando

Python

L'esempio seguente mostra come recuperare un gruppo POSIX in base al 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

Il seguente esempio mostra come recuperare le informazioni sul gruppo utilizzando il nome del gruppo POSIX:

REST

Per cercare un gruppo POSIX in base al nome del gruppo POSIX, chiama il groups.search() metodo 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 gcloud organizations list comando
• 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 del gruppo POSIX

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

REST

Per cercare un gruppo POSIX in base all'ID, chiama il groups.search() metodo 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 gcloud organizations list comando
• 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 gcloud organizations list comando
• 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 del 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 in base all'indirizzo email

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

gcloud

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

gcloud beta identity groups describe EMAIL_ADDRESS

Sostituisci EMAIL_ADDRESS con l'indirizzo email del gruppo che stai cercando.

REST

Per recuperare un gruppo POSIX in base all'indirizzo email:

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

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

   Annota il nome della risorsa del gruppo restituito.

2. Chiama il groups.get() metodo 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 in base all'indirizzo 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

Creazione di un elenco dei gruppi POSIX

Gli esempi seguenti mostrano come creare un elenco di tutti i gruppi POSIX nella tua organizzazione:

gcloud

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

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

Sostituisci ORGANIZATION con l'ID organizzazione del gruppo che stai cercando.

REST

Per cercare tutti i gruppi POSIX, chiama il groups.search() metodo 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 gcloud organizations list comando.

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 gcloud organizations list comando
• 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 la ricerca dei 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