REST Resource: folders.approvalRequests

Risorsa: ApprovalRequest

Una richiesta per il cliente di approvare l'accesso a una risorsa.

Rappresentazione JSON 
{
  "name": string,
  "requestedResourceName": string,
  "requestedResourceProperties": {
    object (ResourceProperties)
  },
  "requestedReason": {
    object (AccessReason)
  },
  "requestedLocations": {
    object (AccessLocations)
  },
  "requestTime": string,
  "requestedExpiration": string,

  // Union field decision can be only one of the following:
  "approve": {
    object (ApproveDecision)
  },
  "dismiss": {
    object (DismissDecision)
  }
  // End of list of possible types for union field decision.
}
Campi
name

string

Il nome della risorsa della richiesta. Il formato è "{projects|folders|organizations}/{id}/approvalRequests/{approval_request}".
requestedResourceName

string

La risorsa per cui viene richiesta l'approvazione. Il formato del nome della risorsa è definito all'indirizzo https://cloud.google.com/apis/design/resource_names. Il nome della risorsa qui può essere un nome di risorsa "completo" (ad es. "//library.googleapis.com/shar/scaffale1/books/book2") o un nome di risorsa "relativo" (ad es. "scaffalature/scaffale1/books/libro2"), come descritto nella specifica del nome della risorsa.
requestedResourceProperties

object (ResourceProperties)

Proprietà relative alla risorsa rappresentata da requestedResourceName.
requestedReason

object (AccessReason)

La giustificazione per cui viene richiesta l'approvazione.
requestedLocations

object (AccessLocations)

Le località per cui è richiesta l'approvazione.
requestTime

string (Timestamp format)

L'ora in cui è stata richiesta l'approvazione.

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

string (Timestamp format)

La scadenza richiesta per l'approvazione. Se la richiesta viene approvata, l'accesso sarà concesso dal momento dell'approvazione fino alla scadenza.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
Campo di unione decision. La decisione attuale in merito alla richiesta di approvazione. decision può essere solo uno dei seguenti:
approve

object (ApproveDecision)

L'accesso è stato approvato.
dismiss

object (DismissDecision)

La richiesta è stata ignorata.

ResourceProperties

Le proprietà associate alla risorsa della richiesta.

Rappresentazione JSON 
{
  "excludesDescendants": boolean
}
Campi
excludesDescendants

boolean

Indica se un'approvazione escluderà i discendenti della risorsa richiesta.

AccessReason

Rappresentazione JSON 
{
  "type": enum (Type),
  "detail": string
}
Campi
type

enum (Type)

Motivazione per il tipo di accesso.
detail

string

Ulteriori dettagli su alcuni tipi di motivi. Vedi i commenti per ogni tipo qui sopra.

Tipo

Motivazione per il tipo di accesso.

Enum
TYPE_UNSPECIFIED Il valore predefinito per il protocollo non deve essere utilizzato.
CUSTOMER_INITIATED_SUPPORT

Il cliente ha presentato una richiesta o sollevato un problema che richiedeva all'entità di accedere ai dati del cliente. detail è nel modulo ("#####" è l'ID del problema):

  • "Rapporto di feedback: #####"
  • "Numero richiesta: #####"
  • "ID richiesta: #####"
  • "Riferimento E-PIN: #####"
  • "Google-#####"
  • "T-#####"
GOOGLE_INITIATED_SERVICE L'entità ha avuto accesso ai dati dei clienti per diagnosticare o risolvere un problema sospetto nei servizi. Spesso questo accesso viene utilizzato per confermare che i clienti non sono interessati da un sospetto problema di servizio o per risolvere un problema del sistema reversibile.
GOOGLE_INITIATED_REVIEW Google ha avviato un servizio per motivi legati a sicurezza, attività fraudolenta, abuso o conformità.
THIRD_PARTY_DATA_REQUEST Il preside è stato costretto ad accedere ai dati dei clienti per rispondere a una richiesta o a un procedimento legale di terze parti, inclusi procedimenti legali da parte dei clienti stessi.
GOOGLE_RESPONSE_TO_PRODUCTION_ALERT Il preside ha avuto accesso ai dati dei clienti per diagnosticare o risolvere un problema sospetto nei servizi o un'interruzione nota.

AccessLocations

Ufficio di casa e sede fisica del preside.

Rappresentazione JSON 
{
  "principalOfficeCountry": string,
  "principalPhysicalLocationCountry": string
}
Campi
principalOfficeCountry

string

La sede "home office" del preside. Un codice paese di due lettere (ISO 3166-1 alpha-2), ad esempio "US", "DE" o "GB" oppure un codice regione. In alcune situazioni limitate, i sistemi Google potrebbero fare riferimento a un codice regione anziché a un codice paese. Codici regione possibili:

  • ASI: Asia
  • EUR: Europa
  • OCE: Oceania
  • AFR: Africa
  • NAM: Nord America
  • SAM: Sud America
  • ANT: Antartide
  • QUALSIASI: qualsiasi località
principalPhysicalLocationCountry

string

Località fisica dell'entità al momento dell'accesso. Un codice paese di due lettere (ISO 3166-1 alpha-2), ad esempio "US", "DE" o "GB" oppure un codice regione. In alcune situazioni limitate, i sistemi Google potrebbero fare riferimento a un codice regione anziché a un codice paese. Codici regione possibili:

  • ASI: Asia
  • EUR: Europa
  • OCE: Oceania
  • AFR: Africa
  • NAM: Nord America
  • SAM: Sud America
  • ANT: Antartide
  • QUALSIASI: qualsiasi località

ApproveDecision

È stata presa una decisione di approvazione dell'accesso a una risorsa.

Rappresentazione JSON 
{
  "approveTime": string,
  "expireTime": string,
  "invalidateTime": string,
  "signatureInfo": {
    object (SignatureInfo)
  },
  "autoApproved": boolean
}
Campi
approveTime

string (Timestamp format)

L'ora in cui è stata concessa l'approvazione.

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

string (Timestamp format)

La data di scadenza dell'approvazione.

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

string (Timestamp format)

Se impostato, indica il timestamp in cui l'approvazione è stata invalidata.

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

object (SignatureInfo)

La firma della richiesta di approvazione e i dettagli su come è stata firmata.
autoApproved

boolean

True quando la richiesta è stata approvata automaticamente.

SignatureInfo

Informazioni sulla firma digitale della risorsa.

Rappresentazione JSON 
{
  "signature": string,

  // Union field verification_info can be only one of the following:
  "googlePublicKeyPem": string,
  "customerKmsKeyVersion": string
  // End of list of possible types for union field verification_info.
}
Campi
signature

string (bytes format)

La firma digitale.

Una stringa con codifica Base64.
Campo di unione verification_info. Modalità di verifica della firma. verification_info può essere solo uno dei seguenti:
googlePublicKeyPem

string

La chiave pubblica per la firma predefinita di Google, codificata in formato PEM. La firma è stata creata utilizzando una chiave privata che può essere verificata tramite questa chiave pubblica.
customerKmsKeyVersion

string

Il nome della risorsa CryptoKeyVersion del cliente utilizzato per la firma.

DismissDecision

Una decisione presa in considerazione per ignorare una richiesta di approvazione.

Rappresentazione JSON 
{
  "dismissTime": string,
  "implicit": boolean
}
Campi
dismissTime

string (Timestamp format)

L'ora in cui la richiesta di approvazione è stata ignorata.

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

boolean

Questo campo sarà true se l'approvazione è stata implicitamente ignorata a causa di una mancata azione da parte degli approvatori dell'approvazione dell'accesso (la richiesta non viene elaborata dagli approvatori prima del tempo di estrazione).

Metodi

approve

 Approva una richiesta e restituisce la richiesta di approvazione aggiornata.

dismiss

 Ignora una richiesta.

get

 Riceve una richiesta di approvazione.

invalidate

 Annulla una richiesta di approvazione esistente.

list

 Elenca le richieste di approvazione associate a un progetto, una cartella o un'organizzazione.