Opciones de personalización de la consola de OCI

En la siguiente tabla se muestran las preferencias que aprovechan la capacidad que ofrece Oracle Cloud Infrastructure para gestionar las preferencias por defecto del arrendamiento:

Topics:

Permitir a los usuarios gestionar la personalización de la consola de OCI en el arrendamiento: para poder realizar todas las operaciones en las preferencias por defecto del arrendamiento, asegúrese de proporcionar permisos a los grupos de usuarios y usuarios con las sentencias de política de IAM recomendadas.
Configurar la personalización de la consola de OCI mediante la API de REST: para configurar las preferencias mediante la API de REST para los valores por defecto globales de inquilino o los valores por defecto de usuario

Dónde	Qué	Espacio de nombre	Tipo de Esquema	Clave	Descripción
Página Detalles de Servicio y Página Inicial por Defecto	Página inicial	`homepage`	`string`	`default_dashboard`	La selección de la página de inicio se guarda para uso futuro.
Log Explorer y paneles de control	Zona Horaria	`explorer`	`string`	`last_timezone`	La última configuración de zona horaria utilizada en el selector de tiempo se guarda en Log Explorer y Dashboards.
Explorador de logs	Campo Anclado	`explorer`	`json`	`pinned_fields`	Después de agregar campos a la sección Anclado, puede acceder a ellos más adelante cuando vuelva al explorador de logs.
Explorador de logs	Ordenación de campos Otros	`explorer`	`string`	`other_field_ordering`	El orden de clasificación que defina en los campos de la sección Otros se guarda para referencia futura.
Explorador de logs	Campos de visualización de Tabla y Registros	`explorer`	`json`	`table_display_fields`	Si selecciona Recordar campos de visualización, los campos de visualización seleccionados (incluido el campo de visualización principal en la visualización de registros) se guardan para su uso futuro en las visualizaciones Tabla o Registros.
Filtro de ámbito	Compartimento de grupo de logs	`explorer`	`string`	`default_loggroup_compartment`	El último compartimento de grupo de logs utilizado en el filtro de ámbito se guarda para varias visitas y usos.
Filtro de ámbito	Juego de logs	`explorer`	`string`	`last_logset`	Si utiliza la función de partición de log y especifica un juego de logs en el filtro de ámbito, se recuerda el último juego de logs utilizado. Esto no se aplica al uso del valor del juego de logs `*` comodín.
Filtro de ámbito	Campos de log	`explorer`	`json`	`scope_field_filters`	La lista de campos incluidos en el filtro de ámbito para el explorador de logs y los widgets del panel de control se guarda para uso futuro. Los campos se pueden agregar o eliminar de los filtros de ámbito en el explorador de logs mediante el menú Acciones situado junto a cada campo.

Ejemplo de json para la clave table_display_fields:

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

En el ejemplo anterior:

primary: (cadena) nombre mostrado del campo que se va a mostrar como campo mostrado principal (se aplica solo a Registros)
fields: (Array<String>) matriz de nombres de campos mostrados que se deben mostrar como campos mostrados

Ejemplo de json para la clave scope_field_filters:

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

En el ejemplo anterior:

fields: (matriz<FieldId>) un objeto fieldId
fieldDName: (cadena) nombre mostrado del campo que se va a incluir como campo de filtro de ámbito
visible: (Booleano) si el campo identificado se debe mostrar como filtro de ámbito o no.
La propiedad visible del objeto fieldId normalmente solo se debe utilizar para el campo Entidad y establecerse en false. El campo Entidad se incluye como filtro de ámbito de forma predeterminada. Si se debe eliminar y no se debe utilizar un filtro de ámbito, se requiere una entrada para él con la propiedad visible establecida en false.

Permitir a los usuarios gestionar la personalización de la consola de OCI en el arrendamiento

Se deben proporcionar los siguientes permisos al grupo de usuarios para realizar todas las operaciones en las preferencias por defecto del arrendamiento, como read, create, update y delete:

Los administradores pueden utilizar la siguiente sentencia de política para definir los valores por defecto de todo el arrendamiento para los usuarios:

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

Configuración de la personalización de la consola de OCI mediante la API de REST

La personalización anterior se almacena automáticamente para los usuarios. Si desea configurarlo mediante la API de REST para los valores por defecto globales de inquilino o los valores por defecto de usuario, consulte a continuación:

Nota

Si realiza una operación PUT o POST en las preferencias por defecto mediante la API de REST, limite el tamaño de la carga útil de JSON a menos de 10 KB.

Crear preferencias

Configure OCI CURL para utilizar las API de REST de personalización. Para definir preferencias de nivel de arrendamiento, asegúrese de que el usuario tenga el permiso tenancy-preferences en 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

Cree el archivo JSON en el mismo directorio que oci-curl.sh. Formato de la carga útil de 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>"
}

En los formatos anteriores del comando CURL y la carga útil de JSON:

your_profile: para obtener el valor de su perfil, haga clic en el icono Perfil en la esquina superior derecha de la consola de OCI.
my_preference.json: sustituya esto por el nombre del archivo de carga útil de JSON.
región: especifique la región, por ejemplo, us-phoenix-1.
your_namespace: espacio de nombres de personalización. Consulte los valores de la tabla anterior.
preference_key: clave de la preferencia que desea especificar. Consulte los valores de la tabla anterior.
preference_value: valor de la preferencia.
preference_value_type: tipo de esquema del valor de preferencia proporcionado. Consulte los valores de la tabla anterior.
compartment_OCID: OCID del compartimento en el que se debe almacenar la preferencia.
preference_level: especifique TENANCY o USER.

Actualizar Preferencias

Utilice el método PUT para enviar el OCID de preferencia en la API de REST para actualizar una preferencia existente.

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

Cree el archivo JSON en el mismo directorio que oci-curl.sh. Formato de la carga útil de JSON my_preference.json:

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

En los formatos anteriores del comando CURL y la carga útil de JSON:

your_profile: para obtener el valor de su perfil, haga clic en el icono Perfil en la esquina superior derecha de la consola de OCI.
my_preference.json: sustituya esto por el nombre del archivo de carga útil de JSON.
región: especifique la región, por ejemplo, us-phoenix-1.
preference_value: valor de la preferencia.
preference_OCID: OCID de la preferencia que se debe actualizar.
compartment_OCID: OCID del compartimento en el que se debe almacenar la preferencia.
preference_level: especifique TENANCY o USER.

Los demás detalles de la preferencia se recuperan utilizando el OCID de preferencia que especifique en la llamada PUT.

Nota

Para eliminar un campo de los campos con pin predeterminados, establezca el valor de pin en false en lugar de true.

Ejemplo de comando CURL y carga útil JSON: Crear preferencia de juego de logs

Ejemplo de 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

Carga útil de JSON de ejemplo logset.json:

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

Ejemplo de comando CURL y carga útil JSON: preferencia Create Pinned Fields

Ejemplo de 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

Carga útil de JSON de ejemplo 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"
}

Ejemplo de comando CURL y carga útil JSON: preferencia Update Pinned Fields

Ejemplo de 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

Carga útil de JSON de ejemplo 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"
}

Documentación de Oracle Cloud Infrastructure