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

A tabela abaixo mostra as preferências que aproveitam a capacidade oferecida 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 de 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 de usuário

Onde	Qual	Namespace	Tipo de Esquema	Chave	Descrição
Página Detalhes do serviço e página inicial padrão	Home page	`homepage`	`string`	`default_dashboard`	Sua seleção da página inicial será salva para uso futuro.
Log Explorer e Painéis de Controle	Fuso horário	`explorer`	`string`	`last_timezone`	Sua última definiçã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 ordenando	`explorer`	`string`	`other_field_ordering`	A ordem de classificação definida nos campos da seção Outros é salva para referência futura.
Log Explorer	Campos de exibição de 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, seu ú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 do Log Explorer e dos 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 de exibição do campo a ser mostrado como o campo de exibição principal (aplica-se somente a Registros)
fields: (Array<String>) Um array de nomes de campos de exibição que deve ser mostrado como os 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 tiver que 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 precisar ser removido e não usar um filtro de escopo, uma entrada para ele será necessária 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 da tenancy, como leitura, criação, atualização e exclusão:

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

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

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

A personalização acima é armazenada para usuários automaticamente. Se você quiser configurá-la 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 a 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 do comando CURL e do 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 isso 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: OCID do compartimento no qual a preferência deve ser armazenada.
preference_level: Especifique TENANCY ou USER.

Preferências de atualização

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 do comando CURL e do 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 isso 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: OCID da preferência que deve ser atualizada.
compartment_OCID: 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