Opções de Personalização da Console do OCI

A tabela abaixo mostra as preferências que aproveitam o recurso oferecido pelo Oracle Cloud Infrastructure para gerenciar as preferências padrão da tenancy:

Tópicos:

Permitir que os Usuários Gerenciem a Personalização da Console do OCI na Tenancy: Para poder executar todas as operações nas preferências padrão da tenancy, certifique-se de fornecer permissões aos grupos de usuários e usuários com as instruções de política do IAM recomendadas.
Configurar Personalização da Console do OCI Usando a API REST: Para configurar as preferências usando a API REST para padrões globais de tenant ou padrões do usuário

Onde	O Que	Namespace	Tipo de Esquema	Tecla	Descrição
Página Detalhes do Serviço e Homepage padrão	Página inicial	`homepage`	`string`	`default_dashboard`	A seleção da página inicial é salva para uso futuro.
Log Explorer e Painéis de Controle	Fuso horário	`explorer`	`string`	`last_timezone`	A última configuração de fuso horário usada no seletor de horário é salva no Log Explorer e nos Painéis de Controle.
Log Explorer	Campo Fixado	`explorer`	`json`	`pinned_fields`	Depois de adicionar campos à seção Fixado, você poderá acessá-los posteriormente quando retornar ao Log Explorer.
Log Explorer	Outros campos ordenados	`explorer`	`string`	`other_field_ordering`	A ordem de classificação que você define nos campos na seção Outros é salva para referência futura.
Log Explorer	Campos de exibição Tabela e Registros	`explorer`	`json`	`table_display_fields`	Se você selecionar Lembrar campos de exibição, os campos de exibição selecionados (incluindo o campo de exibição principal na visualização de registros) serão salvos para uso futuro nas visualizações Tabela ou Registros.
Definir Escopo do Filtro	Compartimento do grupo de logs	`explorer`	`string`	`default_loggroup_compartment`	Seu último compartimento de grupo de logs usado no filtro de escopo é salvo para várias visitas e usos.
Definir Escopo do Filtro	Definição de Log	`explorer`	`string`	`last_logset`	Se você usar o recurso de particionamento de log e especificar um conjunto de logs no filtro de escopo, o último conjunto de logs usado será lembrado. Isso não se aplica ao uso do valor do conjunto de logs `*` curinga.
Definir Escopo do Filtro	Campos de log	`explorer`	`json`	`scope_field_filters`	A lista de campos incluídos no filtro de escopo para o Log Explorer e widgets do painel de controle é salva para uso futuro. Os campos podem ser adicionados ou removidos dos filtros de escopo no Log Explorer usando o menu Ações ao lado de cada campo.

Exemplo de json para a chave table_display_fields:

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

No exemplo anterior:

primary: (String) O nome para exibição do campo a ser mostrado como o campo para exibição principal (aplica-se somente a Registros)
fields: (Array<String>) Um array de nomes de campos de exibição que devem ser mostrados como campos de exibição

Exemplo de json para a chave scope_field_filters:

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

No exemplo anterior:

fields: (Array<FieldId>) Um objeto fieldId
fieldDName: (String) O nome para exibição do campo a ser incluído como um campo de filtro de escopo
visible: (Booliano) Se o campo identificado deve ser mostrado como um filtro de escopo ou não.
A propriedade visível do objeto fieldId geralmente só deve ser usada para o campo Entidade e definida como false. O campo Entidade é incluído como um filtro de escopo por padrão. Se ele tiver que ser removido e não usar um filtro de escopo, será necessária uma entrada para ele com a propriedade visible definida como false.

Permitir que os Usuários Gerenciem a Personalização da Console do OCI na Tenancy

As seguintes permissões devem ser fornecidas ao grupo de usuários para executar todas as operações nas preferências padrão na tenancy, como read, create, update e delete:

A seguinte instrução de política pode ser usada pelos administradores para definir os padrões de toda a tenancy para os usuários:

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

Configurar Personalização da Console do OCI Usando a API REST

A personalização acima é armazenada para os usuários automaticamente. Se você quiser configurá-lo usando a API REST para padrões globais de tenant ou padrões de usuário, consulte abaixo:

Observação

Se você executar uma operação PUT ou POST nas preferências padrão usando a API REST, limite o tamanho do payload JSON para menos de 10 KB.

Criar Preferências

Configure o OCI CURL para usar as APIs REST de personalização. Para definir preferências no nível da tenancy, certifique-se de que o usuário tenha a permissão tenancy-preferences no CURL do OCI.

Formato do 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

Crie o arquivo JSON no mesmo diretório que oci-curl.sh. Formato do 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>"
}

Nos formatos acima de comando CURL e payload JSON:

your_profile: Obtenha o valor do seu perfil clicando no ícone Perfil no canto superior direito da console do OCI.
my_preference.json: Substitua esse valor pelo nome do seu arquivo de payload JSON.
região: Especifique a região, por exemplo, us-phoenix-1.
your_namespace: Seu namespace de personalização. Consulte os valores da tabela acima.
preference_key: A chave da preferência que você deseja especificar. Consulte os valores da tabela acima.
preference_value: O valor da preferência.
preference_value_type: O tipo de esquema do valor de preferência fornecido. Consulte os valores da tabela acima.
compartment_OCID: O OCID do compartimento no qual a preferência deve ser armazenada.
preference_level: Especifique TENANCY ou USER.

Atualizar Preferências

Use o método PUT para enviar o OCID da preferência na API REST para atualizar uma preferência existente.

Formato do 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

Crie o arquivo JSON no mesmo diretório que oci-curl.sh. Formato do payload JSON my_preference.json:

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

Nos formatos acima de comando CURL e payload JSON:

your_profile: Obtenha o valor do seu perfil clicando no ícone Perfil no canto superior direito da console do OCI.
my_preference.json: Substitua esse valor pelo nome do seu arquivo de payload JSON.
região: Especifique a região, por exemplo, us-phoenix-1.
preference_value: O valor da preferência.
preference_OCID: O OCID da preferência que deve ser atualizada.
compartment_OCID: O OCID do compartimento no qual a preferência deve ser armazenada.
preference_level: Especifique TENANCY ou USER.

Os outros detalhes da preferência são recuperados usando o OCID da preferência que você especifica na chamada PUT.

Observação

Para remover um campo de campos fixos padrão, defina o valor pin como false em vez de true.

Exemplo de Comando CURL e Payload JSON: Criar Preferência de Conjunto de Logs

Exemplo 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

Exemplo de payload JSON logset.json:

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

Exemplo de Comando CURL e Payload JSON: Criar Preferência de Campos Fixados

Exemplo 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

Exemplo de 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"
}

Exemplo de Comando CURL e Payload JSON: Atualizar Preferência de Campos Fixados

Exemplo 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

Exemplo de 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"
}

Documentação do Oracle Cloud Infrastructure

Opções de Personalização da Console do OCI

Permitir que os Usuários Gerenciem a Personalização da Console do OCI na Tenancy

Configurar Personalização da Console do OCI Usando a API REST