Prima di iniziare

• Verifica che stai utilizzando un account Pagamento a consumo o Sottoscrizione. Per ulteriori dettagli, vedi Visualizzazione del tuo tipo di account.
• Assicurarsi di avere il ruolo di amministratore sul servizio di gestione catalogo per completare questa attività.

Prima di iniziare

• Verifica che stai utilizzando un account Pagamento a consumo o Sottoscrizione. Per ulteriori dettagli, vedi Visualizzazione del tuo tipo di account.
• Assicurarsi di avere il ruolo di amministratore sul servizio di gestione catalogo per completare questa attività.

Prima di iniziare

• Verifica che stai utilizzando un account Pagamento a consumo o Sottoscrizione. Per ulteriori dettagli, vedi Visualizzazione del tuo tipo di account.

• Assicurarsi di avere il ruolo di amministratore sul servizio di gestione catalogo per completare questa attività.

• Eseguire il seguente comando per installare il plug-in di gestione dei cataloghi:

  ibmcloud plugin install catalogs-management
  

Prima di iniziare

• Verifica che stai utilizzando un account Pagamento a consumo o Sottoscrizione. Per ulteriori dettagli, vedi Visualizzazione del tuo tipo di account.

• Assicurarsi di avere il ruolo di amministratore sul servizio di gestione catalogo per completare questa attività.

• Per personalizzare i cataloghi utilizzando Terraform, assicurati di aver completato quanto segue:

  • Installa la CLI Terraform e configurare il plug-in del provider IBM Cloud per Terraform. Per ulteriori informazioni, vedi l'esercitazione per Introduzione a Terraform su IBM Cloud®. Il plug-in astrae le API IBM Cloud utilizzate per completare questa attività.
  • Creare un file di configurazione Terraform per definire le risorse utilizzando il linguaggio di configurazione HashiCorp. Per ulteriori informazioni, vedi la documentazione Terraform.

Creazione di un catalogo privato con tutti i prodotti inclusi utilizzando la console

Completa la seguente procedura per creare un catalogo che includa tutti i prodotti nel catalogo IBM Cloud:

1. Vai a Gestisci > Cataloghi, nella console IBM Cloud e fai clic su Crea un catalogo.
2. Selezionare il tipo di catalogo Prodotto (predefinito).
3. Immetti un nome e una descrizione.
4. Assicurarsi che l'opzione Tutti i prodotti sia selezionata e fare clic su Crea. La disponibilità si basa sui filtri impostati a livello dell'account nella pagina Impostazioni.
5. Confermare che il catalogo include tutti i prodotti facendo clic sul nome del catalogo> Gestisci filtri. Controlla quindi che Include tutti i prodotti nel catalogo IBM Cloud sia selezionato in Passo 1: seleziona per includere o escludere tutti i prodotti nel catalogo IBM Cloud.

Creazione di un catalogo privato con prodotti selezionati inclusi utilizzando la console

Completa la seguente procedura per creare un catalogo che includa una serie specifica di prodotti nel catalogo IBM Cloud:

1. Vai a Gestisci > Cataloghi, nella console IBM Cloud e fai clic su Crea un catalogo.
2. Selezionare il tipo di catalogo Prodotto (predefinito).
3. Immetti un nome e una descrizione.
4. Fai clic su Crea.
5. Fare clic sul nome del catalogo> Gestisci filtri.
6. Seleziona Escludi tutti i prodotti nel catalogo IBM Cloud nel passo 1: seleziona per includere o escludere tutti i prodotti nel catalogo IBM Cloud.
7. Ignorare il passo 2 e fare clic su Aggiungi nel Passo 3: aggiungere eccezioni alle regole.
8. Assicurarsi che Includi sia selezionata come condizione, quindi selezionare singolarmente i prodotti a cui si desidera che gli utenti accedano. In caso di progetto di esempio, seleziona watsonx Assistant, Speech to Texte Text to Speech.

Impostazione della visibilità del catalogo IBM Cloud utilizzando la console

Ora che hai creato i tuoi cataloghi privati, completa la seguente procedura per disattivare la visibilità del catalogo pubblico per tutti gli utenti nel tuo account.

1. Fare clic su Cataloghi nel breadcrumb.

2. Fai clic su Settings.

3. Imposta il catalogo IBM Cloud su Off.

   Se disattivi la visibilità del catalogo IBM Cloud, anche la pagina Highlights verrà nascosta. Questa pagina ti aiuta a trovare i migliori risultati in diverse categorie di prodotti.

4. Confermare che i filtri e le impostazioni siano applicati correttamente andando al catalogo pubblico ed espandendo lo switcher del catalogo. Solo i cataloghi privati nel tuo account devono essere visualizzati nell'elenco.

È possibile aggiornare i prodotti inclusi o esclusi in qualsiasi momento aggiornando le impostazioni del catalogo privato.

Autorizzazione dell'accesso ai cataloghi privati utilizzando la console

Per autorizzare gli utenti a utilizzare i prodotti nei tuoi cataloghi privati, assegna loro il ruolo di visualizzatore sul servizio di gestione del catalogo.

Eliminazione di un catalogo privato utilizzando la console

Se si elimina un catalogo privato, vengono eliminati anche tutti i prodotti all'interno del catalogo. Per eliminare un catalogo privato, procedere come segue:

1. Vai a Manage > Catalogs, nella console IBM Cloud e fai clic su Private catalogs.
2. Fare clic sull'icona Azioni per il catalogo che si desidera cancellare e selezionare Elimina.

Puoi ripristinare un catalogo privato entro 7 giorni dalla sua eliminazione.

Creazione di un catalogo privato con tutti i prodotti inclusi utilizzando la CLI

Completa la seguente procedura per creare un catalogo che includa tutti i prodotti nel catalogo IBM Cloud:

1. Indirizzare un gruppo di risorse per creare un catalogo. È possibile eseguire il comando ibmcloud resource groups e quindi il comando ibmcloud target -g "resource group".

2. Utilizzare il seguente comando per creare un nuovo catalogo privato nel proprio account.

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

Tutti i prodotti del catalogo IBM Cloud sono visibili per impostazione predefinita quando crei un nuovo catalogo privato. Per ulteriori informazioni, vedi la CLI di gestione dei cataloghi.

Creazione di un catalogo privato con prodotti selezionati inclusi utilizzando la CLI

Completa la seguente procedura per creare un catalogo che includa una serie specifica di prodotti nel catalogo IBM Cloud:

1. Indirizzare un gruppo di risorse per creare un catalogo. È possibile eseguire il comando ibmcloud resource groups e quindi il comando ibmcloud target -g "resource group".
2. Crea un nuovo catalogo privato nel tuo account utilizzando il seguente comando.

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

3. Aggiornare il filtro per includere o escludere uno o più prodotti particolari e tutti i piani tariffari applicabili. Assicurarsi di specificare il catalogo, altrimenti il filtro verrà impostato sul livello di account predefinito. Vedi Catalogs management CLI per ulteriori opzioni di comando.

   ibmcloud catalog filter offering --offering PRODUCT-NAME
   

Impostazione della visibilità del catalogo IBM Cloud utilizzando la CLI

Per impostazione predefinita, il catalogo pubblico di IBM Cloud è visibile a tutti gli utenti dell'account. Puoi rendere i prodotti disponibili solo agli utenti che tu scegli disattivando la visibilità al catalogo IBM Cloud e aggiungendo i prodotti ai tuoi cataloghi privati. Utilizza il seguente comando per disattivare la visibilità del catalogo pubblico per tutti gli utenti nel tuo account.

ibmcloud catalog filter hide-ibm-public-catalog

Autorizzazione dell'accesso ai cataloghi privati utilizzando la CLI

Per autorizzare gli utenti a utilizzare i prodotti nei tuoi cataloghi privati, assegna loro il ruolo di visualizzatore sul servizio di gestione del catalogo.

Eliminazione di un catalogo privato tramite la CLI

Se si elimina un catalogo privato, vengono eliminati anche tutti i prodotti all'interno del catalogo. Eseguire il seguente comando per eliminare un catalogo privato:

ibmcloud catalog delete --catalog CATALOG

Puoi ripristinare un catalogo privato entro 7 giorni dalla sua eliminazione.

Creazione di un catalogo privato con tutti i prodotti inclusi utilizzando la API

Per creare un catalogo che includa tutti i prodotti nel catalogo IBM Cloud, richiama Catalog Management API come mostrato nella seguente richiesta di esempio. Sostituire le variabili con i valori del proprio account.

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)

Tutti iIBM Cloud i prodotti del catalogo pubblico sono visibili per impostazione predefinita quando si crea un nuovo catalogo privato. Per ulteriori informazioni, vedi Catalog Management API.

Creazione di un catalogo privato con prodotti selezionati inclusi utilizzando l'API

Per creare un catalogo che include una serie specifica di prodotti nel catalogo IBM Cloud, richiama l'API di gestione catalogo come mostrato nella seguente richiesta di esempio. Sostituire le variabili con i valori del proprio account.

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

Accertarsi di escludere tutti i prodotti del catalogo pubblico impostando il valore booleano del campo include_all su false per ogni oggetto catalog_filters. Per specificare i prodotti che si desidera includere, è possibile filtrare in base a category_filters o id_filters. Fornire a filter_terms la proprietà o l'ID prodotto che si desidera includere. In questo esempio AdvancedMobileAccess-d6aece47-d840-45b0-8ab9-ad15354deeea è un ID prodotto.

Vedi l'API di gestione del catalogo per ulteriori opzioni di comandi.

Impostazione della visibilità del Catalogo IBM Cloud utilizzando l'API

Per nascondere il catalogo pubblico in un account, assicurarsi che il valore booleano del campo hide_IBM_cloud_catalog sia true. In alternativa, è possibile assegnare al campo include_all un valore booleano false per ogni oggetto account_filters. Solo i cataloghi privati creati devono essere visualizzati nel tuo account.

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

Per ulteriori informazioni, vedi Catalog Management API.

Autorizzazione dell'accesso ai cataloghi privati utilizzando l'API

Per autorizzare gli utenti a utilizzare i prodotti nei tuoi cataloghi privati, assegna loro il ruolo di visualizzatore sul servizio di gestione del catalogo.

Eliminazione di un catalogo privato utilizzando l'API

Se si elimina un catalogo privato, vengono eliminati anche tutti i prodotti all'interno del catalogo. Usare il seguente comando per eliminare un catalogo privato:

DELETE /catalogs/{catalog_identifier}

Per ulteriori informazioni, vedi Catalog Management API.

Puoi ripristinare un catalogo privato entro 7 giorni dalla sua eliminazione.

Creazione di un catalogo privato utilizzando Terraform

Non puoi personalizzare il catalogo pubblico e i cataloghi privati per rendere disponibili soluzioni specifiche agli utenti nel tuo account utilizzando Terraform. Per personalizzare il catalogo pubblico e i tuoi cataloghi privati, passa ai passaggi UI, CLI o API.

Per creare un catalogo privato, procedere come segue:

1. Creare un argomento nel file main.tf. Il seguente esempio crea un catalogo utilizzando la risorsa ibm_cm_catalog, dove label è un nome di visualizzazione per identificare il catalogo.

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

   Per ulteriori informazioni, vedi i dettagli di riferimento dell'argomento nella pagina Terraform Catalog Management.

2. Dopo aver terminato la creazione del file di configurazione, inizializza la CLI Terraform. Per ulteriori informazioni, consultare la sezione Inizializzazione delle directory di lavoro.

   terraform init
   

3. Eseguire il provisioning delle risorse dal file main.tf. Per ulteriori informazioni, vedi Provisioning dell'infrastruttura con Terraform.

   1. Eseguire terraform plan per generare un piano di esecuzione Terraform per visualizzare in anteprima le azioni proposte.

      terraform plan
      

   2. Eseguire terraform apply per creare le risorse definite nel piano.

      terraform apply
      

Autorizzazione dell'accesso ai cataloghi privati utilizzando Terraform

Per autorizzare gli utenti a utilizzare i prodotti nei tuoi cataloghi privati, assegna loro il ruolo di visualizzatore sul servizio di gestione del catalogo.