Documentazione dell'infrastruttura Oracle Cloud

Opzioni di personalizzazione per OCI Console

La tabella riportata di seguito mostra le preferenze che sfruttano la capacità offerta da Oracle Cloud Infrastructure di gestire le preferenze predefinite per la tenancy:

Argomenti:

Dove Cosa Spazio di nomi Tipo di schema Chiave Descrizione

Pagina Dettagli servizio e home page predefinita

Home page

homepage

string

default_dashboard

La selezione della home page viene salvata per uso futuro.

Explorer log e dashboard

Fuso orario

explorer

string

last_timezone

L'impostazione dell'ultimo fuso orario utilizzato nel selettore ora viene salvata in Esplora log e nei dashboard.

Log Explorer

Campo Pinnato

explorer

json

pinned_fields

Dopo aver aggiunto i campi alla sezione Pinnata, è possibile accedervi in un secondo momento quando si torna a Esplora log.

Log Explorer

Altri campi che ordinano

explorer

string

other_field_ordering

Il criterio di ordinamento impostato nei campi della sezione Altro viene salvato come riferimento futuro.

Log Explorer

Campi di visualizzazione Tabella e Record

explorer

json

table_display_fields

Se si seleziona Ricorda campi di visualizzazione, i campi di visualizzazione selezionati (incluso il campo di visualizzazione principale nella visualizzazione dei record) vengono salvati per un uso futuro nelle visualizzazioni Tabella o Record.

Filtro ambito

Compartimento gruppo di log

explorer

string

default_loggroup_compartment

L'ultimo compartimento del gruppo di log utilizzato nel filtro ambito viene salvato per più visite e utilizzi.

Filtro ambito

Set di log

explorer

string

last_logset

Se si utilizza la funzione di partizionamento log e si specifica un set di log nel filtro di ambito, viene ricordato l'ultimo set di log utilizzato. Ciò non si applica all'utilizzo del valore del set di log * con caratteri jolly.

Filtro ambito

Campi di log

explorer

json

scope_field_filters

L'elenco dei campi inclusi nel filtro di ambito per Log Explorer e i widget dashboard viene salvato per uso futuro.

È possibile aggiungere o rimuovere i campi dai filtri scope in Esplora log utilizzando il menu Azioni accanto a ciascun campo.

Esempio di json per la chiave table_display_fields: 

{
  "savePreferences":true,
  "primary":"Original Log Content”,
  "fields":[
        "Entity","Entity Type","Log Source","Host Name (Server)","Problem Priority","Label"]}

Nell'esempio precedente:

  • primary: (stringa) Il nome visualizzato del campo da visualizzare come campo di visualizzazione principale (valido solo per i record)
  • fields: (Array<String>) array di nomi di campo visualizzati che devono essere visualizzati come campi di visualizzazione

Esempio di json per la chiave scope_field_filters: 

{
  "fields":[
    {"fieldDName":"Severity"},
    {"fieldDName":"Log Source"},
    {"fieldDName":"Label"},
    {"fieldDName":"Action"},
    {"fieldDName":"Entity","visible":false}]}

Nell'esempio precedente:

  • fields: (Array<FieldId>) Un oggetto fieldId
  • fieldDName: (stringa) Il nome visualizzato del campo da includere come campo filtro scope
  • visible: (booleano) Se il campo identificato deve essere visualizzato come filtro di ambito o meno.

    La proprietà visibile dell'oggetto fieldId deve in genere essere utilizzata solo per il campo Entità e impostata su false. Per impostazione predefinita, il campo Entità è incluso come filtro di ambito. Se deve essere rimosso e non utilizzato un filtro di ambito, è necessaria una voce con la proprietà visibile impostata su false.

Consenti agli utenti di gestire la personalizzazione della console OCI nella tenancy

Per eseguire tutte le operazioni sulle preferenze predefinite nella tenancy, ad esempio read, create, update e delete, è necessario fornire le autorizzazioni riportate di seguito.

Gli amministratori possono utilizzare l'istruzione dei criteri seguente per impostare le impostazioni predefinite a livello di tenancy per gli utenti:

allow group <user_group_name> to manage tenancy-preferences in tenancy

Configurare la personalizzazione della console OCI mediante l'API REST

La personalizzazione di cui sopra viene memorizzata automaticamente per gli utenti. Se si desidera configurarlo utilizzando l'API REST per i valori predefiniti globali del tenant o i valori predefiniti utente, vedere di seguito:

Nota

Se si esegue un'operazione PUT o POST sulle preferenze predefinite utilizzando l'API REST, limitare la dimensione del payload JSON a meno di 10 KB.

Crea preferenze

Impostare OCI CURL per utilizzare le API REST di personalizzazione. Per impostare le preferenze a livello di tenancy, assicurarsi che l'utente disponga dell'autorizzazione preferenze-tenancy in OCI CURL.

Formato del comando curl: 

sh ~/oci-curl.sh --oci-config-file ~/.oci/config --oci-profile <your_profile> --data-binary @/<my_preference.json> -X POST 'https://personalization.<region>.oci.oraclecloud.com/20200715/preferences' -i

Creare il file JSON nella stessa directory di oci-curl.sh. Formato del payload JSON my_preference.json: 

{
    "serviceName" : "logginganalytics",
    "namespace" : "<your_namespace>",
    "key" : "<preference_key>",
    "value": "<preference_value>",
    "type": "<preference_value_type>",
    "compartmentId" : "<compartment_OCID>",
    "level" : "<preference_level>"
}

Nei formati precedenti del comando CURL e del payload JSON:

  • your_profile: ottenere il valore del profilo facendo clic sull'icona Profilo nell'angolo in alto a destra della console OCI.

  • my_preference.json: sostituire questo elemento con il nome del file di payload JSON.

  • regione: specificare l'area, ad esempio us-phoenix-1.

  • your_namespace: spazio di nomi per la personalizzazione. Fare riferimento ai valori della tabella precedente.

  • preference_key: la chiave per la preferenza che si desidera specificare. Fare riferimento ai valori della tabella precedente.

  • preference_value: il valore della preferenza.

  • preference_value_type: tipo di schema del valore di preferenza fornito. Fare riferimento ai valori della tabella precedente.

  • compartment_OCID: OCID del compartimento in cui deve essere memorizzata la preferenza.

  • preference_level: specificare TENANCY o USER.

Aggiorna preferenze

Utilizzare il metodo PUT per inviare l'OCID preferenza nell'API REST per aggiornare una preferenza esistente.

Formato del comando curl: 

sh ~/oci-curl.sh --oci-config-file ~/.oci/config --oci-profile <your_profile> --data-binary @/<my_preference.json> -X POST 'https://personalization.<region>.oci.oraclecloud.com/20200715/preferences/<preference_OCID>/<tenancy_OCID>' -i

Creare il file JSON nella stessa directory di oci-curl.sh. Formato del payload JSON my_preference.json: 

{
    "value": "<preference_value>",
    "level" : "<preference_level>"
}

Nei formati precedenti del comando CURL e del payload JSON:

  • your_profile: ottenere il valore del profilo facendo clic sull'icona Profilo nell'angolo in alto a destra della console OCI.

  • my_preference.json: sostituire questo elemento con il nome del file di payload JSON.

  • regione: specificare l'area, ad esempio us-phoenix-1.

  • preference_value: il valore della preferenza.

  • preference_OCID: OCID della preferenza che deve essere aggiornato.

  • compartment_OCID: OCID del compartimento in cui deve essere memorizzata la preferenza.

  • preference_level: specificare TENANCY o USER.

Gli altri dettagli della preferenza vengono recuperati utilizzando l'OCID della preferenza specificato nella chiamata PUT.

Nota

Per rimuovere un campo dai campi bloccati predefiniti, impostare il valore perno su false anziché su true.

Esempio di comando CURL e payload JSON: preferenza Crea set di log

Esempio di comando CURL: 

sh ~/oci-curl.sh --oci-config-file ~/.oci/config --oci-profile logan_profile --data-binary @/logset.json -X POST 'https://personalization.us-phoenix-1.oci.oraclecloud.com/20200715/preferences' -i

Esempio di payload JSON logset.json: 

{
   "serviceName": "logginganalytics",
   "namespace": "explorer",
   "key": "last_logset",  
   "value": "testlogset1",
   "type": "STRING",
   "compartmentId": "ocid1.compartment.oc1..aaa...",  
   "level": "TENANCY"
}

Esempio di comando CURL e payload JSON: preferenza Crea campi bloccati

Esempio di comando CURL: 

sh ~/oci-curl.sh --oci-config-file ~/.oci/config --oci-profile logan_profile --data-binary @/pinned_field_value.json -X POST 'https://personalization.us-ashburn-1.oci.oraclecloud.com/20200715/preferences' -i

Esempio di payload JSON pinned_field_value.json: 

{
  "serviceName": "logginganalytics",
  "namespace": "explorer", 
  "key": "pinned_fields",
  "value": "{\"fields\":[{\"pin\":true,\"iname\":\"acclvl\",\"dname\":\"Access Level\",\"dataType\":\"STRING\",\"tableEl\":true,\"facetEl\":true,\"summ\":true,\"group\":true},{\"pin\":true,\"iname\":\"zone\",\"dname\":\"Zone\",\"dataType\":\"STRING\",\"tableEl\":true,\"facetEl\":true,\"summ\":true,\"group\":true},{\"pin\":true,\"iname\":\"usrname\",\"dname\":\"User Name\",\"dataType\":\"STRING\",\"tableEl\":true,\"facetEl\":true,\"summ\":true,\"group\":true}]}", 
  "type": "JSON",
  "compartmentId": "ocid1.compartment.oc1..ccc...", 
  "level": "USER"
}

Esempio di comando CURL e payload JSON: preferenza Aggiorna campi bloccati

Esempio di comando CURL: 

sh ~/oci-curl.sh --oci-config-file ~/.oci/config --oci-profile logan_profile --data-binary @/pinned_field_value.json -X PUT 'https://personalization.us-phoenix-1.oci.oraclecloud.com/20200715/preferences/ocid1.personalizationpreference.oc1.phx.amaaaaaa...?compartmentId=ocid1.tenancy.oc1..aaaaaaaa...' -i

Esempio di payload JSON pinned_field_value.json: 

{
    "value":"{\"fields\":[{\"pin\":true,\"iname\":\"cipher\",\"dname\":\"Cipher\",\"dataType\":\"STRING\",\"tableEl\":true,\"facetEl\":true,\"summ\":true,\"group\":true},{\"pin\":true,\"iname\":\"actn\",\"dname\":\"Action\",\"dataType\":\"STRING\",\"tableEl\":true,\"facetEl\":true,\"summ\":true,\"group\":true}]}",
    "level":"USER"
}