OCIコンソールのパーソナライズ・オプション

次の表に、テナンシのデフォルト・プリファレンスを管理するためにOracle Cloud Infrastructureで提供される機能を利用するプリファレンスを示します:

トピック:

テナンシでのOCIコンソール・パーソナライズの管理をユーザーに許可: テナンシのデフォルト・プリファレンスですべての操作を実行できるようにするには、推奨されるIAMポリシー・ステートメントをユーザー・グループおよびユーザーに権限を提供してください。
REST APIを使用したOCIコンソールのパーソナライズの構成: テナント・グローバル・デフォルトまたはユーザー・デフォルト用のREST APIを使用してプリファレンスを構成するには:

説明	内容	ネームスペース	スキーマ・タイプ	キー	説明
サービス詳細ページおよびデフォルトホームページ	ホーム・ページ	`homepage`	`string`	`default_dashboard`	ホームページの選択内容は、将来使用するために保存されます。
ログ・エクスプローラとダッシュボード	タイムゾーン	`explorer`	`string`	`last_timezone`	時間セレクタで最後に使用したタイムゾーン設定は、ログ・エクスプローラおよびダッシュボードに保存されます。
ログ・エクスプローラ	「固定」フィールド	`explorer`	`json`	`pinned_fields`	「固定」セクションにフィールドを追加した後、後でログ・エクスプローラに戻ったときにアクセスできます。
ログ・エクスプローラ	「その他」フィールドの順序	`explorer`	`string`	`other_field_ordering`	「その他」セクションのフィールドに設定したソート順は、今後参照できるように保存されます。
ログ・エクスプローラ	「表」および「レコード」の表示フィールド	`explorer`	`json`	`table_display_fields`	「表示フィールドの記憶」を選択すると、選択した表示フィールド(レコード・ビジュアライゼーションのプライマリ表示フィールドを含む)が、表ビジュアライゼーションまたはレコード・ビジュアライゼーションで将来使用できるように保存されます。
スコープ・フィルタ	ログ・グループ・コンパートメント	`explorer`	`string`	`default_loggroup_compartment`	スコープ・フィルタで最後に使用されたログ・グループ・コンパートメントは、複数の訪問および使用のために保存されます。
スコープ・フィルタ	ログ・セット	`explorer`	`string`	`last_logset`	ログ・パーティション化機能を使用して、スコープ・フィルタでログ・セットを指定すると、最後に使用したログ・セットが記憶されます。これは、ワイルドカードの`*`ログ・セット値の使用には適用されません。
スコープ・フィルタ	ログ・フィールド	`explorer`	`json`	`scope_field_filters`	ログ・エクスプローラおよびダッシュボード・ウィジェットのスコープ・フィルタに含まれるフィールドのリストは、将来使用するために保存されます。各フィールドの横にある「アクション」メニューを使用して、ログ・エクスプローラでスコープ・フィルタに対してフィールドを追加または削除できます。

table_display_fieldsキーのjsonの例:

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

前述の例:

primary: (文字列)プライマリ表示フィールドとして表示されるフィールドの表示名(レコードにのみ適用されます)
fields: (配列<String>)表示フィールドとして表示する必要がある表示フィールド名の配列

scope_field_filtersキーのjsonの例:

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

前述の例:

fields: (配列<FieldId>) fieldIdオブジェクト
fieldDName: (文字列)スコープ・フィルタ・フィールドとして含めるフィールドの表示名
visible: (ブール)識別されたフィールドをスコープ・フィルタとして表示するかどうか。
fieldIdオブジェクトのvisibleプロパティは、通常、Entityフィールドでのみ使用し、falseに設定する必要があります。「エンティティ」フィールドは、デフォルトでスコープ・フィルタとして含まれています。削除してスコープ・フィルタを使用しない場合は、visibleプロパティがfalseに設定されたエントリが必要です。

テナンシでのOCIコンソール・パーソナライズの管理をユーザーに許可

read、create、update、deleteなど、テナンシのデフォルト・プリファレンスに対するすべての操作を実行するには、次の権限をユーザー・グループに付与する必要があります:

管理者は、次のポリシー・ステートメントを使用して、ユーザーのテナンシ全体のデフォルトを設定できます。

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

REST APIを使用したOCIコンソールのパーソナライズの構成

上記のパーソナライズは、ユーザーに対して自動的に保存されます。テナント・グローバル・デフォルトまたはユーザー・デフォルト用のREST APIを使用して構成する場合は、次を参照してください:

ノート

REST APIを使用してデフォルト・プリファレンスでPUTまたはPOST操作を実行する場合は、JSONペイロードのサイズを10KB未満に制限します。

プリファレンスの作成

パーソナライズREST APIを使用するようにOCI CURLを設定します。テナンシ・レベルのプリファレンスを設定するには、ユーザーがOCI CURLでtenancy-preferences権限を持っていることを確認します。

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

oci-curl.shと同じディレクトリにJSONファイルを作成します。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>"
}

前述のCURLコマンドおよびJSONペイロードの形式:

your_profile: OCIコンソールの右上隅にある「プロファイル」アイコンをクリックして、プロファイルの値を取得します。
my_preference.json: これをJSONペイロード・ファイルの名前に置き換えます。
region: リージョン(たとえば、us-phoenix-1)を指定します。
your_namespace: パーソナライズ・ネームスペース。上の表の値を参照してください。
preference_key: 指定するプリファレンスのキー。上の表の値を参照してください。
preference_value: プリファレンスの値。
preference_value_type: 指定されたプリファレンス値のスキーマ・タイプ。上の表の値を参照してください。
compartment_OCID: プリファレンスを格納する必要があるコンパートメントのOCID。
preference_level: TENANCYまたはUSERを指定します。

プリファレンスを更新

REST APIでプリファレンスOCIDを送信して既存のプリファレンスを更新するには、PUTメソッドを使用します。

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

oci-curl.shと同じディレクトリにJSONファイルを作成します。JSONペイロードmy_preference.jsonの形式:

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

前述のCURLコマンドおよびJSONペイロードの形式:

your_profile: OCIコンソールの右上隅にある「プロファイル」アイコンをクリックして、プロファイルの値を取得します。
my_preference.json: これをJSONペイロード・ファイルの名前に置き換えます。
region: リージョン(たとえば、us-phoenix-1)を指定します。
preference_value: プリファレンスの値。
preference_OCID: 更新する必要があるプリファレンスのOCID。
compartment_OCID: プリファレンスを格納する必要があるコンパートメントのOCID。
preference_level: TENANCYまたはUSERを指定します。

プリファレンスのその他の詳細は、PUTコールで指定したプリファレンスOCIDを使用してリカバリされます。

ノート

デフォルトの固定フィールドからフィールドを削除するには、pin値をtrueではなくfalseに設定します。

CURLコマンドおよびJSONペイロードの例: ログ・セット・プリファレンスの作成

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

JSONペイロードlogset.jsonの例:

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

CURLコマンドおよびJSONペイロードの例: 「固定フィールドの作成」プリファレンス

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

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

CURLコマンドおよびJSONペイロードの例: 「固定フィールドの更新」プリファレンス

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

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

Oracle Cloud Infrastructureドキュメント

テナンシでのOCIコンソール・パーソナライズの管理をユーザーに許可

REST APIを使用したOCIコンソールのパーソナライズの構成