REST Resource: matters.holds

Risorsa: archiviazione a fini legali

Una sospensione. L'archiviazione a fini legali impedisce al servizio Google Workspace specificato di eliminare definitivamente i dati di account specifici o di tutti i membri di un'unità organizzativa.

Per utilizzare le risorse di Vault, l'account deve disporre dei privilegi Vault richiesti e dell'accesso alla pratica. Per accedere a una pratica, l'account deve aver creato la pratica, averla condivisa con l'account o disporre del privilegio Visualizzazione di tutte le pratiche.

Rappresentazione JSON 
{
  "holdId": string,
  "name": string,
  "updateTime": string,
  "accounts": [
    {
      object (HeldAccount)
    }
  ],
  "orgUnit": {
    object (HeldOrgUnit)
  },
  "corpus": enum (CorpusType),
  "query": {
    object (CorpusQuery)
  }
}
Campi
holdId

string

L'ID univoco immutabile della conservazione. Assegnato durante la creazione.
name

string

Il nome della conservazione.
updateTime

string (Timestamp format)

L'ultima volta che questa conservazione è stata modificata.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
accounts[]

object (HeldAccount)

Se impostata, il blocco si applica agli account specificati e l'unità organizzativa orgUnit deve essere vuota.
orgUnit

object (HeldOrgUnit)

Se impostata, il blocco si applica a tutti i membri dell'unità organizzativa e gli account devono essere vuoti. Questa proprietà è modificabile. Per le archiviazioni a fini legali di Gruppi, imposta gli account.
corpus

enum (CorpusType)

Il servizio su cui eseguire la ricerca.
query

object (CorpusQuery)

Opzioni specifiche per i servizi. Se impostato, la query CorpusQuery deve corrispondere a CorpusType.

HeldOrgUnit

L'unità organizzativa a cui è applicata l'archiviazione a fini legali. Questa struttura è immutabile.

Rappresentazione JSON 
{
  "orgUnitId": string,
  "holdTime": string
}
Campi
orgUnitId

string

L'ID immutabile dell'unità organizzativa, come fornito da SDK Admin.
holdTime

string (Timestamp format)

Quando è stata applicata l'archiviazione a fini legali all'unità organizzativa. Questa proprietà è immutabile.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

CorpusQuery

Opzioni specifiche del servizio per le archiviazioni a fini legali.

Rappresentazione JSON 
{

  // Union field corpus_query can be only one of the following:
  "driveQuery": {
    object (HeldDriveQuery)
  },
  "mailQuery": {
    object (HeldMailQuery)
  },
  "groupsQuery": {
    object (HeldGroupsQuery)
  },
  "hangoutsChatQuery": {
    object (HeldHangoutsChatQuery)
  },
  "voiceQuery": {
    object (HeldVoiceQuery)
  }
  // End of list of possible types for union field corpus_query.
}
Campi
Campo di unione corpus_query. Se impostato, deve corrispondere al tipo di servizio. corpus_query può essere solo uno dei seguenti:
driveQuery

object (HeldDriveQuery)

Opzioni specifiche per i servizi relativi ai blocchi di Drive. Se impostato, CorpusType deve essere Drive.
mailQuery

object (HeldMailQuery)

Opzioni specifiche del servizio per le archiviazioni a fini legali di Gmail. Se impostato, CorpusType deve essere MAIL.
groupsQuery

object (HeldGroupsQuery)

Opzioni specifiche del servizio per i blocchi di Gruppi. Se impostato, CorpusType deve essere GROUPS.
hangoutsChatQuery

object (HeldHangoutsChatQuery)

Opzioni specifiche del servizio per i blocchi di Chat. Se impostato, CorpusType deve essere HANGOUTS_CHAT.
voiceQuery

object (HeldVoiceQuery)

Opzioni specifiche per i servizi per le archiviazioni a fini legali di Voice. Se impostato, CorpusType deve essere VOICE.

HeldDriveQuery

Opzioni per i blocchi di Drive.

Rappresentazione JSON 
{
  "includeTeamDriveFiles": boolean,
  "includeSharedDriveFiles": boolean
}
Campi
includeTeamDriveFiles
(deprecated)

boolean

Per includere nel blocco i file dei Drive del team, impostalo su true.
includeSharedDriveFiles

boolean

Per includere nel blocco i file dei Drive condivisi, impostalo su true.

HeldMailQuery

Opzioni delle query per i blocchi di Gmail.

Rappresentazione JSON 
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
Campi
terms

string

Gli operatori di ricerca utilizzati per perfezionare i messaggi coperti dall'archiviazione a fini legali.
startTime

string (Timestamp format)

L'ora di inizio della query. Specifica in GMT. Il valore viene arrotondato alle 00:00 della data specificata.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

L'ora di fine della query. Specifica in GMT. Il valore viene arrotondato alle 00:00 della data specificata.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

HeldGroupsQuery

Opzioni di query per le archiviazioni a fini legali di gruppo.

Rappresentazione JSON 
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
Campi
terms

string

Gli operatori di ricerca utilizzati per perfezionare i messaggi coperti dall'archiviazione a fini legali.
startTime

string (Timestamp format)

L'ora di inizio della query. Specifica in GMT. Il valore viene arrotondato alle 00:00 della data specificata.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

L'ora di fine della query. Specifica in GMT. Il valore viene arrotondato alle 00:00 della data specificata.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

HeldHangoutsChatQuery

Opzioni per i blocchi di Chat.

Rappresentazione JSON 
{
  "includeRooms": boolean
}
Campi
includeRooms

boolean

Per includere i messaggi negli spazi di Chat di cui l'utente era membro, impostalo su true.

HeldVoiceQuery

Opzioni per i blocchi di Voice.

Rappresentazione JSON 
{
  "coveredData": [
    enum (VoiceCoveredData)
  ]
}
Campi
coveredData[]

enum (VoiceCoveredData)

Un elenco dei tipi di dati coperti dalla conservazione a fini legali. Il campo non può essere vuoto. L'ordine non è importante e i duplicati vengono ignorati.

Metodi

addHeldAccounts

 Aggiunge gli account a un blocco.

create

 Crea un blocco nella pratica specificata.

delete

 Rimuove l'archiviazione a fini legali specificata e rilascia gli account o l'unità organizzativa a cui è applicata.

get

 Consente di ottenere l'archiviazione a fini legali specificata.

list

 Elenca le archiviazioni a fini legali in una pratica.

removeHeldAccounts

 Rimuove gli account specificati da un blocco.

update

 Aggiorna l'ambito (unità organizzativa o account) e i parametri di query di un blocco.