コンソールを使用して IBM Cloud カタログの表示を更新する

デフォルトでは、アカウント内のユーザーはパブリック・カタログ内のすべての製品にアクセスできます。 パブリックIBM Cloudカタログの可視性をオフにした場合、アカウント内のプライベートカタログへのアクセスをユーザーに与えない限り、ユーザーはコンソールを使用して製品のインスタンスを作成できません。 ユーザーに見える商品を更新するには、'IBM Cloudコンソールの'管理'カタログ'設定 > このアカウントで'IBM Cloudカタログの可視性を設定するにアクセスしてください。

この設定はIBM®モジュールレジストリとコミュニティレジストリの可視性も制御します。 詳しくは、オープンソースの提供 を参照。

一部の製品は、カタログの可視性設定の影響を受けません。 ユーザーは、API または CLI を使用して、これらの製品のインスタンスを作成できます。 詳細については、既知の問題と制限 を参照。

コンソールを使用して、すべてのユーザーによる製品へのアクセスを管理する

フィルターを使用すると、パブリック・カタログの製品のうち、アカウント内のすべてのユーザーに提供する製品を管理することができます。 例えば、サード・パーティー製品に対するアクセスを制限したりできます。 また、特定のタイプのソフトウェアをユーザーに使用させたりすることもできます。 ご使用のアカウントが IBM Cloud エンタープライズの親アカウントである場合は、設定したフィルターが、子であるすべてのアカウント・グループとアカウントにも適用されます。 詳しくは、 エンタープライズ用の IBM Cloud カタログのカスタマイズ を参照してください。

1. IBM Cloud コンソールで管理 > カタログ > 設定 に移動します。
2. パブリック・カタログの可視性が オン (On) になっていることを確認します。
3. 「提供される製品」セクションで、 IBM Cloud カタログのすべての製品を除外する を選択します。
4. 1 つ以上のフィルターを設定して、提供する製品をカテゴリー別にカスタマイズします。
5. (オプション) 前の手順で設定したフィルター・ルールに例外を追加します。
6. プレビュー 表を使用して選択内容を確認し、 更新 をクリックします。

コンソールでの特定のユーザーを対象とする製品へのアクセスの管理

選択したユーザーのみが使用できるパブリック・カタログ内の製品をきめ細かく制御するためには、プライベート・カタログ・レベルでフィルターを設定します。

1. IBM Cloud コンソールで、管理 > カタログ、プライベート・カタログ に移動します。

2. リストからカタログを選択し、詳細ページに移動します。

   そのページの IBM Cloud カタログ内の製品 表に、アカウント・レベルで提供される製品のリストが表示されます。 この可視性は、アカウントの所有者または管理者が設定したフィルターによって決まります。 アカウント・レベルのフィルターは、アカウント内のすべてのプライベート・カタログに適用されます。

3. フィルターの管理 をクリックします。

4. プライベート・カタログのすべての製品を含めるか、除外するかを選択します。

5. 1 つ以上のフィルターを設定して、提供する製品をカテゴリー別にカスタマイズします。

6. (オプション) 前の手順で設定したフィルター・ルールに例外を追加します。

7. 更新 をクリックします。

8. 「設定」ページに移動し、パブリック・カタログの可視性をオフにします。

9. プライベート・カタログの製品にユーザーがアクセスして使用できるようにするために、対象ユーザーに、カタログ管理サービスに対するビューアーの役割を割り当てます。

プライベート・カタログ・レベルでフィルタリングを利用する方法を示す詳しい例については、プライベート・カタログのカスタマイズを参照してください。

CLI を使用した IBM Cloud カタログの可視性の更新

デフォルトでは、アカウント内のユーザーは IBM Cloud パブリック・カタログ内のすべての製品にアクセスできます。 IBM Cloud カタログの可視性をオフにしてから、対象の製品をプライベート・カタログに追加することで、選択したユーザーのみに製品を表示できます。

この設定はIBM®モジュールレジストリとコミュニティレジストリの可視性も制御します。 詳しくは、オープンソースの提供 を参照。

以下のコマンドを使用して、アカウント内のすべてのユーザーに対してパブリック・カタログの可視性をオフにします。

ibmcloud catalog filter hide-ibm-public-catalog

CLI を使用したすべてのユーザーを対象とする製品アクセスの管理

フィルターを使用すると、パブリック・カタログの製品のうち、アカウント内のすべてのユーザーに提供する製品を管理することができます。 例えば、サード・パーティー製品に対するアクセスを制限したりできます。 また、特定のタイプのソフトウェアをユーザーに使用させたりすることもできます。 ご使用のアカウントが IBM Cloud エンタープライズの親アカウントである場合は、設定したフィルターが、子であるすべてのアカウント・グループとアカウントにも適用されます。 詳しくは、 エンタープライズ用の IBM Cloud カタログのカスタマイズ を参照してください。

1. 新しいフィルターを作成します。

   ibmcloud catalog filter create [--catalog CATALOG] [--category CATEGORY] [--compliance COMPLIANCE] [--deployment-target TARGET] [--exclude-list LIST] [--include-all ALL] [--include-list LIST] [--offering-format FORMAT] [--pricing-plan PLAN] [--provider PROVIDER] [--release RELEASE] [--type TYPE]
   

   --catalog CATALOG コマンドを指定しない場合、アカウント・レベルでフィルターが作成されます。

2. コマンド・オプション --account-group ACCOUNT GROUP を指定して、アカウント・グループをターゲットに設定します。

3. 特定の製品 (複数可) を含めるかまたは除外するようにフィルターを更新します。 コマンド・オプションについては、カタログ管理 CLI ガイダンスを参照するか、ibmcloud catalog filter options コマンドを実行して各フィルター・カテゴリーのフィルター・オプションを取得してください。

CLI を使用した特定のユーザーを対象とする製品アクセスの管理

選択したユーザーのみが使用できるパブリック・カタログ内の製品をきめ細かく制御するためには、プライベート・カタログ・レベルでフィルターを設定します。

1. 新しいフィルターを作成します。

   ibmcloud catalog filter create [--catalog CATALOG] [--category CATEGORY] [--compliance COMPLIANCE] [--deployment-target TARGET] [--exclude-list LIST] [--include-all ALL] [--include-list LIST] [--offering-format FORMAT] [--pricing-plan PLAN] [--provider PROVIDER] [--release RELEASE] [--type TYPE]
   

   必ず --catalog CATALOG コマンド・オプションを指定してください。 --catalog CATALOG を指定しない場合、アカウント・レベルでフィルターが作成されます。

2. コマンド・オプション --account-group ACCOUNT GROUP を指定して、アカウント・グループをターゲットに設定します。

3. 特定の製品 (複数可) を含めるかまたは除外するようにフィルターを更新します。 コマンド・オプションについては、カタログ管理 CLI ガイダンスを参照するか、ibmcloud catalog filter options コマンドを実行して各フィルター・カテゴリーのフィルター・オプションを取得してください。

API を使用した IBM Cloud カタログの可視性の更新

デフォルトでは、アカウント内のユーザーは IBM Cloud パブリック・カタログ内のすべての製品にアクセスできます。 IBM Cloud カタログの可視性をオフにしてから、対象の製品をプライベート・カタログに追加することで、選択したユーザーのみに製品を表示できます。

この設定はIBM®モジュールレジストリとコミュニティレジストリの可視性も制御します。 詳しくは、オープンソースの提供 を参照。

以下のコマンドを使用して、アカウント内のすべてのユーザーに対してパブリック・カタログの可視性をオフにします。

curl -X "PUT" "https://cm.globalcatalog.cloud.ibm.com/api/v1-beta/catalogaccount"
-H "accept: */*"
-H "Authorization: {iam-bearer-token}"
-d '{"id":"string","hide_IBM_cloud_catalog":true,"account_filters":{"include_all":true,"category_filters":{"additionalProp1":{"include":true,"filter":{"filter_terms":["string"]}},"additionalProp2":{"include":true,"filter":{"filter_terms":["string"]}},"additionalProp3":{"include":true,"filter":{"filter_terms":["string"]}}},"id_filters":{"include":{"filter_terms":["string"]},"exclude":{"filter_terms":["string"]}}}}'

このアカウント内のパブリック・カタログを非表示にするには、hide_IBM_cloud_catalog フィールドにブール値 true を指定してください。 あるいは、include_all オブジェクトごとに、false フィールドにブール値 account_filters を指定して、すべてのパブリック・カタログを除外することもできます。 詳細は カタログ管理APIを参照。

API を使用したすべてのユーザーを対象とする製品アクセスの管理

フィルターを使用すると、パブリック・カタログの製品のうち、アカウント内のすべてのユーザーに提供する製品を管理することができます。 例えば、サード・パーティー製品に対するアクセスを制限したりできます。 また、特定のタイプのソフトウェアをユーザーに使用させたりすることもできます。 ご使用のアカウントが IBM Cloud エンタープライズの親アカウントである場合は、設定したフィルターが、子であるすべてのアカウント・グループとアカウントにも適用されます。 詳しくは、 エンタープライズ用の IBM Cloud カタログのカスタマイズ を参照してください。

curl -X "PUT" "https://cm.globalcatalog.cloud.ibm.com/api/v1-beta/catalogaccount"
-H "accept: */*"
-H "Authorization: {iam-bearer-token}"
-d '{"id":"string","hide_IBM_cloud_catalog":true,"account_filters":{"include_all":true,"category_filters":{"additionalProp1":{"include":true,"filter":{"filter_terms":["string"]}},"additionalProp2":{"include":true,"filter":{"filter_terms":["string"]}},"additionalProp3":{"include":true,"filter":{"filter_terms":["string"]}}},"id_filters":{"include":{"filter_terms":["string"]},"exclude":{"filter_terms":["string"]}}}}'

{accountFilters} のオプションは、include_all、category_filters、および id_filters です。 詳細は カタログ管理APIを参照。

API を使用した特定のユーザーを対象とする製品アクセスの管理

選択したユーザーのみが使用できるパブリック・カタログ内の製品をきめ細かく制御するためには、プライベート・カタログ・レベルでフィルターを設定します。 次の例では、 AdvancedMobileAccess-d6aece47-d840-45b0-8ab9-ad15354deeea が製品IDである場合、フィルタ id_filters を適用します。

curl -X 'PUT' \
'https://cm.globalcatalog.cloud.ibm.com/api/v1-beta/catalogs/<catalog-id>'
 -H 'accept: application/json' \
 -H 'Content-Type: application/json' \
 -H "Authorization: ${IC_IAM_TOKEN}" \
 -d '{"label": "testcurlcatalog4", "short_description": "testing creating a catalog through curl", "catalog_filters": { "include_all": false, "id_filters": { "include": { "filter_terms": [ "AdvancedMobileAccess-d6aece47-d840-45b0-8ab9-ad15354deeea" ] } } }}'

詳しくは、 カタログ管理 API を参照してください。

コンソールを使用して変更を表示する

1. IBM Cloud® コンソールで、コンソール・メニュー・バーから管理 > カタログに移動します。
2. 監査ログを選択します。
3. 表に表示するスコープをフィルタリングします。

デフォルトでは、監査ログ表の中のイベントはそれぞれ 1 つ 1 つの変更を表しており、変更を行ったユーザーの E メール、変更のタイプ、変更の説明、変更が行われた日付が示されます。

CLI を使用した変更内容の表示

このアクションは、コンソール、API、または SDK でのみ実行できます。 手順を確認するには、UI または API の指示に移動してください。

API を使用した変更内容の表示

以下のサンプル要求に示すように、Catalog Management API を呼び出すことによって、プライベート・カタログに加えられた変更内容を表示できます。

curl -X "GET" \
"https://cm.globalcatalog.cloud.ibm.com/api/v1-beta/catalogs/{catalog-id}/audit"
-H "accept: application/json"
-H "Authorization: {iam-bearer-token}"

デフォルトでは、監査ログ表の中のイベントはそれぞれ 1 つ 1 つの変更を表しており、変更を行ったユーザーの E メール、変更のタイプ、変更の説明、変更が行われた日付が示されます。