Opciones de personalización para 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 para el arrendamiento:

Temas:

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.
Configuración de 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 del inquilino o los valores por defecto del usuario

Dónde	Qué	Espacio de nombres	Tipo de Esquema	Clave	Descripción
Página Detalles del Servicio y Página Inicial por Defecto	Página inicial	`homepage`	`string`	`default_dashboard`	La selección de la página inicial 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 hora se guarda en el explorador de logs y en los paneles de control.
Explorador de logs	Campo Anclado	`explorer`	`json`	`pinned_fields`	Después de agregar campos a la sección Anclado, puede acceder a ellos en un momento posterior al volver al explorador de logs.
Explorador de logs	Orden de los 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	Los campos de visualización 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 de 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 recordará el último juego de logs utilizado. Esto no se aplica al uso del valor del juego de logs `*` con 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 de visualización principal (solo se aplica a registros)
fields: (Matriz<Cadena>) 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 debe mostrarse como filtro de ámbito o no.
La propiedad visible del objeto fieldId generalmente solo se debe utilizar para el campo Entity y se debe definir en false. El campo Entidad se incluye como filtro de ámbito de forma predeterminada. Si se debe eliminar y no 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 lectura, creación, actualización y supresión:

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 del inquilino o los valores por defecto del 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 tiene el permiso preferencias de arrendamiento 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 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 del perfil, haga clic en el icono Perfil en la esquina superior derecha de la consola de OCI.
my_preference.json: sustituya este valor por el nombre del archivo de carga útil JSON.
región: especifique la región (por ejemplo, us-phoenix-1).
your_namespace: su 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

Use 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 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 del perfil, haga clic en el icono Perfil en la esquina superior derecha de la consola de OCI.
my_preference.json: sustituya este valor por el nombre del archivo de carga útil 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 mediante el OCID de preferencia que especifique en la llamada PUT.

Nota

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

Ejemplo de carga útil de JSON y comando CURL: 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

Ejemplo de carga útil JSON logset.json:

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

Comando CURL y Ejemplo de Carga Útil JSON: Preferencia Crear Campos Anclados

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

Ejemplo de carga útil 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"
}

Ejemplo de carga útil de JSON y comando CURL: 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

Ejemplo de carga útil 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"
}

Documentación de Oracle Cloud Infrastructure

Opciones de personalización para la consola de OCI

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

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