Avant de commencer

• Vérifiez que vous disposez d'un compte Paiement à la carte ou Abonnement. Pour plus d'informations, voir Affichage de votre type de compte.
• Assurez-vous de disposer du rôle Administrateur sur le service de gestion des catalogues pour pouvoir effectuer cette tâche.

Avant de commencer

• Vérifiez que vous disposez d'un compte Paiement à la carte ou Abonnement. Pour plus d'informations, voir Affichage de votre type de compte.
• Assurez-vous de disposer du rôle Administrateur sur le service de gestion des catalogues pour pouvoir effectuer cette tâche.

Avant de commencer

• Vérifiez que vous disposez d'un compte Paiement à la carte ou Abonnement. Pour plus d'informations, voir Affichage de votre type de compte.

• Assurez-vous de disposer du rôle Administrateur sur le service de gestion des catalogues pour pouvoir effectuer cette tâche.

• Exécutez la commande ci-dessous pour installer le plug-in de gestion des catalogues :

  ibmcloud plugin install catalogs-management
  

Avant de commencer

• Vérifiez que vous disposez d'un compte Paiement à la carte ou Abonnement. Pour plus d'informations, voir Affichage de votre type de compte.

• Assurez-vous de disposer du rôle Administrateur sur le service de gestion des catalogues pour pouvoir effectuer cette tâche.

• Pour personnaliser des catalogues à l'aide de Terraform, vérifiez que vous avez effectué les opérations suivantes:

  • Installez l'interface de ligne de commande Terraform et configurez le plug-in IBM Cloud Provider pour Terraform. Pour plus d'informations, voir le tutoriel Initiation à Terraform sur IBM Cloud®. Ce plug-in résume les API IBM Cloud utilisées pour effectuer cette tâche.
  • Créez un fichier de configuration Terraform pour définir des ressources à l'aide de la langue de configuration HashiCorp. Pour plus d'informations, voir la documentation de Terraform.

Création d'un catalogue privé avec tous les produits inclus à l'aide de la console

Pour créer un catalogue incluant tous les produits du catalogue IBM Cloud, procédez comme suit :

1. Accédez à Gérer > Catalogues, dans la console IBM Cloud, puis cliquez sur Créer un catalogue.
2. Sélectionnez le type de catalogue Produit (par défaut).
3. Entrez un nom et une description.
4. Vérifiez que l'option Tous les produits est sélectionnée, puis cliquez sur Créer. La disponibilité est basée sur les filtres définis au niveau du compte sur la page Paramètres.
5. Confirmez que le catalogue inclut tous les produits en cliquant sur le nom de catalogue > Gérer les filtres. Ensuite, vérifiez que Inclure tous les produits dans le catalogue IBM Cloud est sélectionné à l'Etape 1 : Sélectionnez pour inclure tous les produits dans le catalogue IBM Cloud ou les en exclure tous.

Création d'un catalogue privé avec certains produits inclus à l'aide de la console

Pour créer un catalogue incluant un ensemble spécifique de produits du catalogue IBM Cloud, procédez comme suit :

1. Accédez à Gérer > Catalogues, dans la console IBM Cloud, puis cliquez sur Créer un catalogue.
2. Sélectionnez le type de catalogue Produit (par défaut).
3. Entrez un nom et une description.
4. Cliquez sur Créer.
5. Cliquez sur le nom de catalogue > Gérer les filtres.
6. Sélectionnez Exclure tous les produits du catalogue IBM Cloud dans Étape 1: Sélectionnez cette option pour inclure ou exclure tous les produits du catalogue IBM Cloud.
7. Ignorer l'Etape 2 et cliquer sur Ajouter à l'Etape 3 : Ajoutez des exceptions aux règles.
8. Vérifiez que Inclure est sélectionné comme condition, puis sélectionnez individuellement les produits auxquels vous voulez que les utilisateurs puissent accéder. Dans le cas de notre exemple de projet, vous sélectionnez watsonx Assistant, Speech to Text et Text to Speech.

Définition de la visibilité du catalogue IBM Cloud à l'aide de la console

Maintenant que vous avez créé vos catalogues privés, procédez comme suit pour désactiver la visibilité du catalogue public pour tous les utilisateurs de votre compte.

1. Cliquez sur Catalogues dans l'élément de navigation.

2. Cliquez sur Paramètres.

3. Définissez le catalogue IBM Cloud sur Off.

   Si vous désactivez la visibilité du catalogue IBM Cloud, la page « Highlights » sera également masquée. Cette page vous aide à trouver les meilleurs résultats dans différentes catégories de produits.

4. Vérifiez que vos filtres et paramètres sont correctement appliqués en accédant au catalogue public et en développant le commutateur de catalogue. Seuls les catalogues privés de votre compte doivent figurer dans la liste.

Vous pouvez à tout moment mettre à jour les produits à inclure ou à exclure en mettant à jour les paramètres de votre catalogue privé.

Autorisation d'accès à des catalogues privés à l'aide de la console

Pour autoriser des utilisateurs à travailler avec les produits de vos catalogues privés, affectez-leur le rôle Afficheur sur le service de gestion des catalogues.

Suppression d'un catalogue privé à l'aide de la console

Si vous supprimez un catalogue privé, tous les produits qu'il contient sont également supprimés. Suivez les étapes suivantes pour supprimer un catalogue privé :

1. Allez dans Gérer > Catalogues, dans la console IBM Cloud, et cliquez sur Catalogues privés.
2. Cliquez sur l'icône Actions pour le catalogue que vous voulez supprimer, et sélectionnez Supprimer.

Vous pouvez restaurer un catalogue privé dans les 7 jours suivant sa suppression.

Création d'un catalogue privé avec tous les produits inclus à l'aide de l'interface de ligne de commande

Pour créer un catalogue incluant tous les produits du catalogue IBM Cloud, procédez comme suit :

1. Ciblez un groupe de ressources pour créer un catalogue. Vous pouvez exécuter la commande ibmcloud resource groups, puis la commande ibmcloud target -g "resource group".

2. Utilisez la commande ci-après pour créer un catalogue privé dans votre compte.

   ibmcloud catalog create --name CATALOG [--catalog-description "DESCRIPTION"]
   

Tous les produits du catalogue IBM Cloud sont visibles par défaut lorsque vous créez un nouveau catalogue privé. Pour plus d'informations, reportez-vous à l'interface de ligne de commande de gestion du catalogue.

Création d'un catalogue privé avec certains produits inclus à l'aide de l'interface de ligne de commande

Pour créer un catalogue incluant un ensemble spécifique de produits du catalogue IBM Cloud, procédez comme suit :

1. Ciblez un groupe de ressources pour créer un catalogue. Vous pouvez exécuter la commande ibmcloud resource groups, puis la commande ibmcloud target -g "resource group".
2. Créez un catalogue privé dans votre compte à l'aide de la commande ci-après.

   ibmcloud catalog create --name CATALOG [--catalog-description "DESCRIPTION"]
   

3. Mettez à jour le filtre pour inclure ou exclure un ou plusieurs produits particuliers et les plans de tarification applicables. Veillez à spécifier votre catalogue, faute de quoi le niveau compte sera utilisé pour le filtre. Pour d'autres options de commande, reportez-vous à l'interface de ligne de commande de gestion du catalogue.

   ibmcloud catalog filter offering --offering PRODUCT-NAME
   

Définition de la visibilité du catalogue IBM Cloud à l'aide de l'interface de ligne de commande

Par défaut, le catalogue public IBM Cloud est visible par tous les utilisateurs du compte. Vous pouvez rendre les produits disponibles uniquement pour les utilisateurs de votre choix en désactivant la visibilité du catalogue IBM Cloud et en ajoutant les produits à vos catalogues privés. Utilisez la commande ci-après pour désactiver la visibilité du catalogue public pour tous les utilisateurs de votre compte.

ibmcloud catalog filter hide-ibm-public-catalog

Autorisation d'accès à des catalogues privés à l'aide de l'interface de ligne de commande

Pour autoriser des utilisateurs à travailler avec les produits de vos catalogues privés, affectez-leur le rôle Afficheur sur le service de gestion des catalogues.

Suppression d'un catalogue privé à l'aide de la CLI

Si vous supprimez un catalogue privé, tous les produits qu'il contient sont également supprimés. Exécutez la commande suivante pour supprimer un catalogue privé :

ibmcloud catalog delete --catalog CATALOG

Vous pouvez restaurer un catalogue privé dans les 7 jours suivant sa suppression.

Création d'un catalogue privé avec tous les produits inclus à l'aide de l'API

Pour créer un catalogue contenant tous les produits du catalogue IBM Cloud, appelez l'API de gestion du catalogue, comme illustré dans l'exemple de demande ci-après. Remplacez les variables par les valeurs de votre compte.

curl -X 'POST' \
'https://cm.globalcatalog.cloud.ibm.com/api/v1-beta/catalogs' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H "Authorization: ${IC_IAM_TOKEN}" \
-d '{"label": "testcurlcatalog", "short_description": "testing creating a catalog through curl"}'

ServiceCall<Catalog> createCatalog(CreateCatalogOptions createCatalogOptions)

Example request

String label = "{label}";
String shortDesc = "{shortDesc}";
CreateCatalogOptions createOptions = new CreateCatalogOptions.Builder().label(label).shortDescription(shortDesc).build();
Response<Catalog> response = service.createCatalog(createOptions).execute();
System.out.println(response.getResult());

createCatalog(params, [callback()])

Example request

label = "{label}";
shortDesc = "{shortDesc}";
response = await service.createCatalog({ 'label': label, 'shortDescription': shortDesc });
console.log(response);

create_catalog(self, id=None, rev=None, label=None, short_description=None, catalog_icon_url=None, tags=None, url=None, crn=None, offerings_url=None, features=None, disabled=None, created=None, updated=None, resource_group_id=None, owning_account=None, catalog_filters=None, syndication_settings=None, **kwargs)

Exapmle request

label = "{label}"
shortDesc = "{shortDesc}"
response = self.service.create_catalog(label=label, short_description=shortDesc)
print(response)

(catalogManagement *CatalogManagementV1) CreateCatalog(createCatalogOptions *CreateCatalogOptions) (result *Catalog, response *core.DetailedResponse, err error)

Example request

label := "{label}"
shortDesc := "{shortDesc}"
createOptions := service.NewCreateCatalogOptions()
createOptions.SetLabel(label)
createOptions.SetShortDescription(shortDesc)
_, response, _ := service.CreateCatalog(createOptions)
fmt.Println(response)

Tous les produits du catalogue public IBM Cloud sont visibles par défaut lorsque vous créez un nouveau catalogue privé. Pour plus d'informations, reportez-vous à l'API de gestion du catalogue.

Création d'un catalogue privé avec certains produits inclus à l'aide de l'API

Pour créer un catalogue contenant un ensemble spécifique de produits du catalogue IBM Cloud, appelez l'API de gestion du catalogue, comme illustré dans l'exemple de demande ci-après. Remplacez les variables par les valeurs de votre compte.

curl -X 'POST' \
'https://cm.globalcatalog.cloud.ibm.com/api/v1-beta/catalogs' \
-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" ] } } }}'

Veillez à exclure tous les produits du catalogue public en définissant le champ include_all avec une valeur booléenne de false pour chaque objet catalog_filters. Pour spécifier les produits que vous souhaitez inclure, vous pouvez filtrer par category_filters ou id_filters. Indiquez à filter_terms la propriété du produit ou l'identifiant du produit que vous souhaitez inclure. Dans cet exemple, AdvancedMobileAccess-d6aece47-d840-45b0-8ab9-ad15354deeea est un identifiant de produit.

Pour d'autres options de commande, reportez-vous à l'API de gestion du catalogue.

Définition de la visibilité du catalogue IBM Cloud à l'aide de l'API

Pour masquer le catalogue public dans un compte, vérifiez que la zone hide_IBM_cloud_catalog contient la valeur booléenne true. Vous pouvez également attribuer à la zone include_all la valeur booléenne false pour chaque objet account_filters. Seuls les catalogues privés que vous créez doivent alors apparaître dans votre compte.

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

Pour plus d'informations, reportez-vous à l'API de gestion du catalogue.

Autorisation d'accès à des catalogues privés à l'aide de l'API

Pour autoriser des utilisateurs à travailler avec les produits de vos catalogues privés, affectez-leur le rôle Afficheur sur le service de gestion des catalogues.

Suppression d'un catalogue privé à l'aide de l'API

Si vous supprimez un catalogue privé, tous les produits qu'il contient sont également supprimés. La commande suivante permet de supprimer un catalogue privé :

DELETE /catalogs/{catalog_identifier}

Pour plus d'informations, reportez-vous à l'API de gestion du catalogue.

Vous pouvez restaurer un catalogue privé dans les 7 jours suivant sa suppression.

Création d'un catalogue privé à l'aide de Terraform

Vous ne pouvez pas personnaliser le catalogue public et vos catalogues privés afin de proposer aux utilisateurs de votre compte des solutions spécifiques à l'aide de Terraform. Pour personnaliser le catalogue public et vos catalogues privés, suivez les procédures de l'interface utilisateur, de l'interface de ligne de commande ou de l'API.

Procédez comme suit pour créer un catalogue privé :

1. Créez un argument dans votre fichier main.tf. L'exemple ci-après crée un catalogue à l'aide de la ressource ibm_cm_catalog, label représentant un nom d'affichage permettant d'identifier le catalogue.

   resource "ibm_cm_catalog" "cm_catalog" {
   label = "label"
   short_description = "short_description"
   }
   

   Pour plus d'informations, voir les détails de la référence des arguments sur la page Terraform Catalog Management.

2. Une fois que vous avez terminé de générer votre fichier de configuration, initialisez l'interface de ligne de commande Terraform. Pour plus d'informations, voir Initialisation des répertoires de travail.

   terraform init
   

3. Mettez à disposition les ressources à partir du fichier main.tf. Pour plus d'informations, voir Mise à disposition d'une infrastructure avec Terraform.

   1. Exécutez terraform plan pour générer un plan d'exécution Terraform afin de prévisualiser les actions proposées.

      terraform plan
      

   2. Exécutez terraform apply pour créer les ressources définies dans le plan.

      terraform apply
      

Autorisation d'accès à des catalogues privés à l'aide de Terraform

Pour autoriser des utilisateurs à travailler avec les produits de vos catalogues privés, affectez-leur le rôle Afficheur sur le service de gestion des catalogues.