IBM Cloud Docs
Personalización del catálogo de IBM Cloud y catálogos privados para los usuarios de su cuenta

Personalización del catálogo de IBM Cloud y catálogos privados para los usuarios de su cuenta

Los catálogos privados ofrecen un modo de gestionar de forma centralizada el acceso a los productos del catálogo de IBM Cloud® y a sus propios catálogos. Puede personalizar el catálogo público y sus catálogos privados para poner a disposición de los usuarios soluciones específicas en su cuenta. De este modo, puede garantizar que sus catálogos resultan relevantes para su empresa.

Antes de empezar

Antes de empezar

Antes de empezar

Antes de empezar

  • Verifique que está utilizando una cuenta de Pago según uso o Suscripción. Consulte Visualización del tipo de cuenta para obtener más detalles.

  • Asegúrese de que tiene el rol de administrador en el servicio de gestión de catálogos para completar esta tarea.

  • Para personalizar catálogos utilizando Terraform, asegúrese de que ha completado lo siguiente:

    • Instale la CLI de Terraform y configure el plugin de proveedor de IBM Cloud para Terraform. Para obtener más información, consulte la guía de aprendizaje de Iniciación a Terraform en IBM Cloud®. El plug-in abstrae las API de IBM Cloud que se utilizan para completar esta tarea.
    • Cree un archivo de configuración de Terraform para definir recursos utilizando HashiCorp Configuration Language. Para obtener más información, consulte la documentación de Terraform.

Creación de un catálogo privado con todos los productos incluidos mediante la consola

Complete los pasos siguientes para crear un catálogo que incluya todos los productos del catálogo de IBM Cloud:

  1. Vaya a Gestionar > Catálogos, en la consola de IBM Cloud y pulse Crear un catálogo.
  2. Seleccione el tipo de catálogo Producto (predeterminado).
  3. Especifique un nombre y una descripción.
  4. Asegúrese de que se selecciona la opción Todos los productos y pulse Crear. La disponibilidad se basa en los filtros establecidos a nivel de cuenta en la página de Configuración.
  5. Confirme que el catálogo incluye todos los productos pulsando el nombre del catálogo > Gestionar filtros. Luego compruebe que Incluir todos los productos en el catálogo de IBM Cloud está seleccionado en el Paso 1: Seleccionar para incluir o excluir todos los productos del catálogo de IBM Cloud.

Creación de un catálogo privado con los productos seleccionados incluidos mediante la consola

Complete los pasos siguientes para crear un catálogo que incluya un conjunto específico de productos en el catálogo de IBM Cloud:

  1. Vaya a Gestionar > Catálogos, en la consola de IBM Cloud y pulse Crear un catálogo.
  2. Seleccione el tipo de catálogo Producto (predeterminado).
  3. Especifique un nombre y una descripción.
  4. Pulse Crear.
  5. Pulse el nombre del catálogo > Gestionar filtros.
  6. Seleccione Excluir todos los productos del catálogo de IBM Cloud en el Paso 1: Seleccionar para incluir o excluir todos los productos del catálogo de IBM Cloud.
  7. Omita el paso 2 y pulse Añadir en Paso 3: Añadir excepciones a las reglas.
  8. Asegúrese de que Incluir esté seleccionado como condición y seleccione individualmente los productos a los que desea que accedan los usuarios. En el caso de nuestro proyecto de ejemplo, seleccione watsonx Assistant, Speech to Text y Text to Speech.

Establecimiento de la visibilidad del catálogo de IBM Cloud utilizando la consola

Ahora que ha creado sus catálogos privados, siga los pasos siguientes para desactivar la visibilidad del catálogo público para todos los usuarios de la cuenta.

  1. Pulse Catálogos en el rastro de navegación.

  2. Pulse Valores.

  3. Establezca Catálogo de IBM Cloud en Desactivado.

    Si desactiva la visibilidad del catálogo IBM Cloud, la página de destacados también se ocultará. Esta página le ayuda a encontrar los mejores resultados en diferentes categorías de productos.

  4. Confirme que los filtros y valores se aplican correctamente; para ello vaya al catálogo público y amplíe el conmutador del catálogo. En la lista solo debería ver los catálogos privados de su cuenta.

Puede actualizar qué productos se incluyen o excluyen en cualquier momento actualizando los valores del catálogo privado.

Personalización de la marca del catálogo privado con un banner personalizado

Puede mejorar el aspecto de su catálogo privado para que coincida con su marca añadiendo una imagen personalizada al banner de su catálogo privado. Todos los usuarios a los que se les otorga acceso al catálogo privado pueden ver el banner personalizado cuando van al catálogo privado para buscar productos, en lugar del banner predeterminado de IBM Cloud. Para añadir una imagen de banner personalizada, siga estos pasos:

  1. Vaya a Gestionar > Catálogos y, a continuación, haga clic en Catálogos privados.

  2. Pulse el icono Menú de desbordamiento icono Acciones en la fila del catálogo privado para el que desea añadir un banner y, a continuación, pulse Editar.

  3. Añada una URL a su banner personalizado en el campo Banner del catálogo, o puede hacer clic en Cargar para añadir una imagen directamente.

    El tamaño máximo de imagen recomendado es de 944 x 260 píxeles.

  4. Pulse Actualizar.

  5. A continuación, vaya al catálogo y seleccione el catálogo privado en la lista para ver el aspecto actualizado del catálogo privado.

También puede personalizar el nombre de proveedor para los productos de catálogo privado que añada a los catálogos. De forma predeterminada, se muestran con Community como proveedor, que es un filtro en el catálogo, pero puede personalizar esto para que sea el nombre de su empresa u organización. Para obtener más información, consulte Proporcionar detalles de entrada de catálogo.

Autorización de acceso a catálogos privados mediante la consola

Para autorizar a los usuarios para que trabajen con los productos del catálogo privado, asígneles el rol de visor del servicio de gestión de catálogos.

Eliminar un catálogo privado mediante la consola

Si suprime un catálogo privado, también se suprimirán todos los productos del catálogo. Complete los siguientes pasos para eliminar un catálogo privado:

  1. Vaya a Administrar > Catálogos, en la consola de IBM Cloud, y haga clic en Catálogos privados.
  2. Haga clic en el icono Acciones Icono Acciones para el catálogo que desea eliminar y seleccione Eliminar.

Puede restaurar un catálogo privado en un plazo de 7 días después de suprimirlo.

Creación de un catálogo privado con todos los productos incluidos mediante la CLI

Complete los pasos siguientes para crear un catálogo que incluya todos los productos del catálogo de IBM Cloud:

  1. Apunte a un grupo de recursos para crear un catálogo. Puede ejecutar el mandato ibmcloud resource groups y, a continuación, el mandato ibmcloud target -g "resource group".

  2. Utilice el siguiente mandato para crear un nuevo catálogo privado en la cuenta.

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

Todos los productos del catálogo de IBM Cloud son visibles por defecto cuando se crea un nuevo catálogo privado. Consulte la CLI de gestión de catálogos para obtener más información.

Creación de un catálogo privado con los productos seleccionados incluidos mediante la CLI

Complete los pasos siguientes para crear un catálogo que incluya un conjunto específico de productos en el catálogo de IBM Cloud:

  1. Apunte a un grupo de recursos para crear un catálogo. Puede ejecutar el mandato ibmcloud resource groups y, a continuación, el mandato ibmcloud target -g "resource group".
  2. Cree un nuevo catálogo privado en su cuenta utilizando el mandato siguiente.
    ibmcloud catalog create --name CATALOG [--catalog-description "DESCRIPTION"]
    
  3. Actualice el filtro para incluir o excluir un producto o productos concretos y los planes de elaboración de precios aplicables. Asegúrese de especificar el catálogo, o el filtro será de forma predeterminada el nivel de cuenta. Consulte CLI de gestión de catálogos para obtener más opciones de mandatos.
    ibmcloud catalog filter offering --offering PRODUCT-NAME
    

Establecimiento de la visibilidad del catálogo de IBM Cloud utilizando la CLI

De forma predeterminada, el catálogo público de IBM Cloud es visible para todos los usuarios de la cuenta. Puede hacer que los productos estén disponibles solo para los usuarios que elija desactivando la visibilidad en el catálogo de IBM Cloud y añadiendo los productos a sus catálogos privados. Utilice el siguiente mandato para desactivar la visibilidad del catálogo público para todos los usuarios de la cuenta.

ibmcloud catalog filter hide-ibm-public-catalog

Autorización de acceso a catálogos privados mediante la CLI

Para autorizar a los usuarios para que trabajen con los productos del catálogo privado, asígneles el rol de visor del servicio de gestión de catálogos.

Eliminación de un catálogo privado mediante la CLI

Si suprime un catálogo privado, también se suprimirán todos los productos del catálogo. Ejecute el siguiente comando para eliminar un catálogo privado:

ibmcloud catalog delete --catalog CATALOG

Puede restaurar un catálogo privado en un plazo de 7 días después de suprimirlo.

Creación de un catálogo privado con todos los productos incluidos mediante la API

Para crear un catálogo que incluya todos los productos en el catálogo de IBM Cloud, llame a la API de gestión de catálogos tal como se muestra en la siguiente solicitud de ejemplo. Sustituya las variables por los valores de su cuenta.

curl -X 'POST' \
'https://dev-cm.globalcatalog.test.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)

Todos los productos del catálogo público de IBM Cloud son visibles por defecto cuando se crea un nuevo catálogo privado. Consulte la API de gestión de catálogos para obtener más información.

Creación de un catálogo privado con los productos seleccionados incluidos mediante la API

Para crear un catálogo que incluya un conjunto de productos específicos del catálogo de IBM Cloud, llame a la API de gestión de catálogos tal como se muestra en la siguiente solicitud de ejemplo. Sustituya las variables por los valores de su cuenta.

curl -X 'POST' \
'https://dev-cm.globalcatalog.test.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" ] } } }}'

Asegúrese de excluir todos los productos del catálogo público configurando el campo include_all con un valor booleano de false para cada objeto catalog_filters. Para especificar los productos que desea incluir, puede filtrar por category_filters o id_filters. Proporcione a filter_terms la propiedad del producto o el ID del producto que desea incluir. En este ejemplo, AdvancedMobileAccess-d6aece47-d840-45b0-8ab9-ad15354deeea es un identificador de producto.

Consulte la API de gestión de catálogos para obtener más opciones de mandatos.

Establecimiento de la visibilidad del catálogo de IBM Cloud utilizando la API

Para ocultar el catálogo público en una cuenta, asegúrese de que el campo hide_IBM_cloud_catalog tiene un valor booleano de true. Como alternativa, puede dar al campo include_all un valor booleano de false para cada objeto account_filters. A continuación, solo los catálogos privados que cree deberían visualizarse en su cuenta.

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

Consulte la API de gestión de catálogos para obtener más información.

Autorización de acceso a catálogos privados mediante la API

Para autorizar a los usuarios para que trabajen con los productos del catálogo privado, asígneles el rol de visor del servicio de gestión de catálogos.

Eliminar un catálogo privado mediante la API

Si suprime un catálogo privado, también se suprimirán todos los productos del catálogo. Utilice el siguiente comando para eliminar un catálogo privado:

DELETE /catalogs/{catalog_identifier}

Consulte la API de gestión de catálogos para obtener más información.

Puede restaurar un catálogo privado en un plazo de 7 días después de suprimirlo.

Creación de un catálogo privado utilizando Terraform

No puede personalizar el catálogo público y sus catálogos privados para poner a disposición de los usuarios en su cuenta soluciones específicas utilizando Terraform. Para personalizar el catálogo público y sus catálogos privados, cambie a los pasos de la IU, la CLI o la API.

Siga los pasos siguientes para crear un catálogo privado:

  1. Cree un argumento en el archivo main.tf. El ejemplo siguiente crea un catálogo utilizando el recurso ibm_cm_catalog, donde label es un nombre de visualización para identificar el catálogo.

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

    Para obtener más información, consulte los detalles de referencia de argumentos en la página de gestión de catálogos de Terraform.

  2. Después de terminar de crear el archivo de configuración, inicialice la CLI de Terraform. Para obtener más información, consulte Inicialización de directorios de trabajo.

    terraform init
    
  3. Suministre los recursos desde el archivo main.tf. Para obtener más información, consulte Infraestructura de suministro con Terraform.

    1. Ejecute terraform plan para generar un plan de ejecución de Terraform para obtener una vista previa de las acciones propuestas.

      terraform plan
      
    2. Ejecute terraform apply para crear los recursos definidos en el plan.

      terraform apply
      

Autorización de acceso a catálogos privados utilizando Terraform

Para autorizar a los usuarios para que trabajen con los productos del catálogo privado, asígneles el rol de visor del servicio de gestión de catálogos.