Recupero e creazione di un elenco dei gruppi POSIX

Attenzione:i gruppi POSIX vengono ritirato. A partire dal 26 settembre 2024, non potrai più creare nuovi gruppi POSIX. Per ulteriori informazioni, vedi Ritiro 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 gruppi POSIX.

Recupero di membri dei gruppi POSIX in corso

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

Recupero di un gruppo POSIX per nome

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

REST

Per recuperare un gruppo POSIX per nome, richiama il metodo Metodo groups.get() con il nome 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 la Comando gcloud identity groups describe

Python

L'esempio seguente mostra come recuperare un gruppo POSIX per nome utilizzando la proprietà 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 Il nome del gruppo POSIX:

REST

Per cercare un gruppo POSIX in base al nome, 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. A trovare l'ID cliente ed eseguire Comando gcloud organizations list
• POSIX_NAME: il nome che vuoi assegnare alla Gruppo POSIX
• VIEW: FULL o BASIC

Python

L'esempio seguente mostra come recuperare un gruppo POSIX tramite il 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 del gruppo utilizzando l'ID gruppo:

REST

Per cercare un gruppo POSIX per 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. A trovare l'ID cliente ed eseguire Comando gcloud organizations list
• GROUP_ID: l'ID gruppo (GID) da 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) da assegnare al gruppo POSIX
• VIEW: FULL o BASIC

Python

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

L'esempio seguente mostra come recuperare le informazioni del gruppo utilizzando l'indirizzo 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 di 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 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 il metodo 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

Gli esempi riportati di seguito 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 dell'organizzazione per il gruppo cercato.

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. A trovare l'ID cliente ed eseguire Comando gcloud organizations list
• GROUP_ID: l'ID gruppo (GID) a cui vuoi assegnare il gruppo POSIX
• VIEW: FULL o BASIC

Python

L'esempio seguente mostra una funzione di supporto per la ricerca di 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