Vorbereitende Schritte

• Stellen Sie sicher, dass Sie ein nutzungsabhängiges Konto oder ein Abonnementkonto nutzen. Weitere Informationen finden Sie unter Kontotyp anzeigen.
• Stellen Sie sicher, dass Sie über die Administratorrolle für den Katalogverwaltungsservice verfügen, um diese Task abzuschließen.

Vorbereitende Schritte

• Stellen Sie sicher, dass Sie ein nutzungsabhängiges Konto oder ein Abonnementkonto nutzen. Weitere Informationen finden Sie unter Kontotyp anzeigen.
• Stellen Sie sicher, dass Sie über die Administratorrolle für den Katalogverwaltungsservice verfügen, um diese Task abzuschließen.

Vorbereitende Schritte

• Stellen Sie sicher, dass Sie ein nutzungsabhängiges Konto oder ein Abonnementkonto nutzen. Weitere Informationen finden Sie unter Kontotyp anzeigen.

• Stellen Sie sicher, dass Sie über die Administratorrolle für den Katalogverwaltungsservice verfügen, um diese Task abzuschließen.

• Führen Sie den folgenden Befehl aus, um das Plug-in für die Katalogverwaltung zu installieren:

  ibmcloud plugin install catalogs-management
  

Vorbereitende Schritte

• Stellen Sie sicher, dass Sie ein nutzungsabhängiges Konto oder ein Abonnementkonto nutzen. Weitere Informationen finden Sie unter Kontotyp anzeigen.

• Stellen Sie sicher, dass Sie über die Administratorrolle für den Katalogverwaltungsservice verfügen, um diese Task abzuschließen.

• Um Kataloge mithilfe von Terraform anzupassen, stellen Sie sicher, dass Sie Folgendes ausgeführt haben:

  • Installieren Sie die Terraform-CLI und konfigurieren Sie das Provider-Plug-in IBM Cloud für Terraform. Weitere Informationen finden Sie im Lernprogramm zur Einführung in Terraform auf IBM Cloud®. Das Plug-in abstrahiert die IBM Cloud APIs, die zur Erfüllung dieses Tasks verwendet werden.
  • Erstellen Sie eine Terraform-Konfigurationsdatei, um Ressourcen mithilfe der HashiCorp-Konfigurationssprache zu definieren. Weitere Informationen finden Sie in der Terraform-Dokumentation.

Privaten Katalog mit allen Produkten über die Konsole erstellen

Führen Sie die folgenden Schritte aus, um einen Katalog zu erstellen, der alle Produkte des IBM Cloud-Katalogs umfasst:

1. Gehen Sie in der IBM Cloud-Konsole auf Verwalten > Kataloge und klicken Sie auf Katalog erstellen.
2. Wählen Sie 'Produkt (Standardeinstellung)' als Katalogtyp aus.
3. Geben Sie einen Namen und eine Beschreibung ein.
4. Stellen Sie sicher, dass die Option Alle Produkte ausgewählt ist, und klicken Sie auf Erstellen. Die Verfügbarkeit basiert auf den Filtern, die auf der Seite "Einstellungen" auf Kontoebene festgelegt wurden.
5. Vergewissern Sie sich, dass der Katalog alle Produkte enthält, indem Sie auf den Katalognamen > Filter verwalten klicken. Stellen Sie dann sicher, dass Alle Produkte des IBM Cloud-Katalogs einbeziehen in Schritt 1: Alle Produkte im IBM Cloud-Katalog einbeziehen oder ausschließen ausgewählt ist.

Privaten Katalog mit ausgewählten Produkten über die Konsole erstellen

Führen Sie die folgenden Schritte aus, um einen Katalog zu erstellen, der eine bestimmte Gruppe von Produkte des IBM Cloud-Katalogs umfasst:

1. Gehen Sie in der IBM Cloud-Konsole auf Verwalten > Kataloge und klicken Sie auf Katalog erstellen.
2. Wählen Sie 'Produkt (Standardeinstellung)' als Katalogtyp aus.
3. Geben Sie einen Namen und eine Beschreibung ein.
4. Klicken Sie auf Erstellen.
5. Klicken Sie auf den Katalognamen > Filter verwalten.
6. Wählen Sie Alle Produkte des IBM Cloud-Katalogs ausschließen in Schritt 1: Alle Produkte des IBM Cloud-Katalogs einbeziehen oder ausschließen aus.
7. Überspringen Sie Schritt 2 und klicken Sie auf Hinzufügen in Schritt 3: Ausnahmen zu den Regeln hinzufügen.
8. Stellen Sie sicher, dass Einbeziehen als Bedingung ausgewählt ist, und wählen Sie dann die Produkte, für die die Benutzer Zugriffsberechtigungen erhalten sollen, einzeln aus. Im Falle des vorliegenden Beispielprojekts wählen Sie watsonx Assistant, Speech to Text und Text to Speech aus.

Anzeige des IBM Cloud-Katalogs über die Konsole festlegen

Nach der Erstellung Ihrer privaten Kataloge führen Sie nun die folgenden Schritte aus, um zu inaktivieren, dass der öffentliche Katalog für alle Benutzer in Ihrem Konto sichtbar ist.

1. Klicken Sie im Hauptlink auf Kataloge.

2. Klicken Sie auf Einstellungen.

3. Legen Sie für den IBM Cloud-Katalog die Einstellung Aus fest.

   Wenn Sie die Sichtbarkeit des Katalogs „ IBM Cloud “ deaktivieren, wird auch die Seite „Highlights“ ausgeblendet. Diese Seite hilft Ihnen, die besten Ergebnisse in verschiedenen Produktkategorien zu finden.

4. Stellen Sie sicher, dass die Filter und Einstellungen korrekt angewendet wurden, indem Sie den öffentlichen Katalog aufrufen und die Wechselschaltfläche erweitern. In der Liste dürfen nur die privaten Kataloge Ihres Kontos angezeigt werden.

Sie können jederzeit aktualisieren, welche Produkte ein- oder ausgeschlossen werden, indem Sie die Einstellungen in Ihrem privaten Katalog aktualisieren.

Zugriff auf private Kataloge über die Konsole autorisieren

Damit Benutzer für die Arbeit mit den Produkten in Ihren privaten Katalogen autorisiert sind, müssen Sie diesen die Rolle des Anzeigeberechtigten für den Katalogverwaltungsservice zuweisen.

Löschen eines privaten Katalogs über die Konsole

Wenn Sie einen privaten Katalog löschen, werden auch alle Produkte im Katalog gelöscht. Führen Sie die folgenden Schritte aus, um einen privaten Katalog zu löschen:

1. Gehen Sie in der Konsole IBM Cloud auf Verwalten > Kataloge und klicken Sie auf Private Kataloge.
2. Klicken Sie auf das Symbol Aktionen Aktionen für den Katalog, den Sie löschen möchten, und wählen Sie Löschen.

Sie können einen privaten Katalog innerhalb von 7 Tagen nach dem Löschen wiederherstellen.

Privaten Katalog mit allen Produkten über die Befehlszeilenschnittstelle (CLI) erstellen

Führen Sie die folgenden Schritte aus, um einen Katalog zu erstellen, der alle Produkte des IBM Cloud-Katalogs umfasst:

1. Legen Sie eine Ressourcengruppe als Ziel fest, um einen Katalog zu erstellen. Sie können den Befehl ibmcloud resource groups und dann den Befehl ibmcloud target -g "resource group" ausführen.

2. Verwenden Sie den folgenden Befehl, um einen neuen privaten Katalog in Ihrem Konto zu erstellen.

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

Alle Produkte des IBM Cloud Katalogs sind standardmäßig sichtbar, wenn Sie einen neuen privaten Katalog erstellen. Weitere Informationen finden Sie in CLI-Plug-in für Katalogverwaltung.

Privaten Katalog mit ausgewählten Produkten über die Befehlszeilenschnittstelle (CLI) erstellen

Führen Sie die folgenden Schritte aus, um einen Katalog zu erstellen, der eine bestimmte Gruppe von Produkte des IBM Cloud-Katalogs umfasst:

1. Legen Sie eine Ressourcengruppe als Ziel fest, um einen Katalog zu erstellen. Sie können den Befehl ibmcloud resource groups und dann den Befehl ibmcloud target -g "resource group" ausführen.
2. Erstellen Sie mit dem folgenden Befehl einen neuen privaten Katalog in Ihrem Konto.

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

3. Aktualisieren Sie den Filter, um ein bestimmtes Produkt bzw. bestimmte Produkte und alle anwendbaren Preisstrukturpläne ein- oder auszuschließen. Stellen Sie sicher, dass Sie Ihren Katalog angeben, sonst wird der Filter standardmäßig auf die Kontoebene angewendet. Weitere Befehlsoptionen finden Sie in CLI-Plug-in für Katalogverwaltung.

   ibmcloud catalog filter offering --offering PRODUCT-NAME
   

Anzeige des IBM Cloud-Katalogs über die Befehlszeilenschnittstelle (CLI) festlegen

Standardmäßig ist der öffentliche IBM Cloud-Katalog für alle Benutzer im Konto sichtbar. Sie können Produkte nur für ausgewählte Benutzer verfügbar machen, indem Sie ihre Sichtbarkeit im IBM Cloud-Katalog ausschalten und die Produkte in Ihren privaten Katalogen hinzufügen. Verwenden Sie den folgenden Befehl, um die Sichtbarkeit des öffentlichen Katalogs für alle Benutzer in Ihrem Konto auszuschalten.

ibmcloud catalog filter hide-ibm-public-catalog

Zugriff auf private Kataloge über die Befehlszeilenschnittstelle (CLI) autorisieren

Damit Benutzer für die Arbeit mit den Produkten in Ihren privaten Katalogen autorisiert sind, müssen Sie diesen die Rolle des Anzeigeberechtigten für den Katalogverwaltungsservice zuweisen.

Löschen eines privaten Katalogs mit Hilfe der CLI

Wenn Sie einen privaten Katalog löschen, werden auch alle Produkte im Katalog gelöscht. Führen Sie den folgenden Befehl aus, um einen privaten Katalog zu löschen:

ibmcloud catalog delete --catalog CATALOG

Sie können einen privaten Katalog innerhalb von 7 Tagen nach dem Löschen wiederherstellen.

Privaten Katalog mit allen Produkten über die Anwendungsprogrammierschnittstelle (API) erstellen

Wenn Sie einen Katalog erstellen möchten, der alle Produkte des IBM Cloud-Katalogs enthält, rufen Sie die Katalogverwaltungs-API wie in der folgenden Beispielanforderung gezeigt auf. Ersetzen Sie Variablen durch Werte aus Ihrem Konto.

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)

Alle Produkte des öffentlichen Katalogs IBM Cloud sind standardmäßig sichtbar, wenn Sie einen neuen privaten Katalog erstellen. Weitere Informationen finden Sie in Katalogverwaltungs-API.

Privaten Katalog mit ausgewählten Produkten über die Anwendungsprogrammierschnittstelle (API) erstellen

Wenn Sie einen Katalog erstellen möchten, der einen spezifischen Satz von Produkten des IBM Cloud-Katalogs enthält, rufen Sie die Katalogverwaltungs-API wie in der folgenden Beispielanforderung gezeigt auf. Ersetzen Sie Variablen durch Werte aus Ihrem Konto.

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

Vergewissern Sie sich, dass Sie alle öffentlichen Katalogprodukte ausschließen, indem Sie das Feld include_all für jedes catalog_filters Objekt auf den booleschen Wert false setzen. Um die Produkte zu spezifizieren, die Sie aufnehmen möchten, können Sie nach category_filters oder id_filters filtern. Geben Sie filter_terms die Produkteigenschaft oder Produkt-ID an, die Sie einbeziehen möchten. In diesem Beispiel ist AdvancedMobileAccess-d6aece47-d840-45b0-8ab9-ad15354deeea eine Produkt-ID.

Weitere Befehlsoptionen finden Sie in Katalogverwaltungs-API.

Anzeige des IBM Cloud-Katalogs über die Anwendungsprogrammierschnittstelle (API) festlegen

Wenn Sie den öffentlichen Katalog in einem Konto ausblenden möchten, stellen Sie sicher, das im Feld hide_IBM_cloud_catalog der boolesche Wert true angegeben ist. Alternativ können Sie im Feld include_all für das Objekt false den booleschen Wert account_filters angeben. Dann sollten nur die von Ihnen erstellten privaten Kataloge in Ihrem Konto angezeigt werden.

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

Weitere Informationen finden Sie in Katalogverwaltungs-API.

Zugriff auf private Kataloge über die Anwendungsprogrammierschnittstelle (API) autorisieren

Damit Benutzer für die Arbeit mit den Produkten in Ihren privaten Katalogen autorisiert sind, müssen Sie diesen die Rolle des Anzeigeberechtigten für den Katalogverwaltungsservice zuweisen.

Löschen eines privaten Katalogs mit Hilfe der API

Wenn Sie einen privaten Katalog löschen, werden auch alle Produkte im Katalog gelöscht. Verwenden Sie den folgenden Befehl, um einen privaten Katalog zu löschen:

DELETE /catalogs/{catalog_identifier}

Weitere Informationen finden Sie in Katalogverwaltungs-API.

Sie können einen privaten Katalog innerhalb von 7 Tagen nach dem Löschen wiederherstellen.

Erstellen eines privaten Katalogs mithilfe von Terraform

Sie können den öffentlichen Katalog und Ihre privaten Kataloge nicht anpassen, um bestimmte Lösungen für Benutzer in Ihrem Konto mithilfe von Terraform verfügbar zu machen. Um den öffentlichen Katalog und Ihre privaten Kataloge anzupassen, wechseln Sie zu den Benutzerschnittstellen-, CLI- oder API-Schritten.

Gehen Sie wie folgt vor, um einen privaten Katalog zu erstellen:

1. Erstellen Sie ein Argument in Ihrer Datei main.tf. Das folgende Beispiel erstellt einen Katalog mithilfe der Ressource ibm_cm_catalog, wobei label ein Anzeigename zur Identifizierung des Katalogs ist.

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

   Weitere Informationen finden Sie in der Argumentationsreferenz auf der Seite Terraform Catalog Management.

2. Nachdem Sie Ihre Konfigurationsdatei erstellt haben, initialisieren Sie die Terraform-CLI. Weitere Informationen finden Sie unter Arbeitsverzeichnisse initialisieren.

   terraform init
   

3. Stellen Sie die Ressourcen aus der Datei main.tf bereit. Weitere Informationen finden Sie unter Infrastruktur mit Terraform bereitstellen.

   1. Führen Sie terraform plan aus, um einen Terraform-Ausführungsplan für die Vorschau der vorgeschlagenen Aktionen zu generieren.

      terraform plan
      

   2. Führen Sie terraform apply aus, um die Ressourcen zu erstellen, die im Plan definiert sind.

      terraform apply
      

Autorisieren des Zugriffs auf private Kataloge mithilfe von Terraform

Damit Benutzer für die Arbeit mit den Produkten in Ihren privaten Katalogen autorisiert sind, müssen Sie diesen die Rolle des Anzeigeberechtigten für den Katalogverwaltungsservice zuweisen.