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
- 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.
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.
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.
-
Ejecute el mandato siguiente para instalar un plugin de gestión de catálogos:
ibmcloud plugin install catalogs-management
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:
- Vaya a Gestionar > Catálogos, en la consola de IBM Cloud y pulse Crear un catálogo.
- Seleccione el tipo de catálogo Producto (predeterminado).
- Especifique un nombre y una descripción.
- 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.
- 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:
- Vaya a Gestionar > Catálogos, en la consola de IBM Cloud y pulse Crear un catálogo.
- Seleccione el tipo de catálogo Producto (predeterminado).
- Especifique un nombre y una descripción.
- Pulse Crear.
- Pulse el nombre del catálogo > Gestionar filtros.
- 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.
- Omita el paso 2 y pulse Añadir en Paso 3: Añadir excepciones a las reglas.
- 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.
-
Pulse Catálogos en el rastro de navegación.
-
Pulse Valores.
-
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.
-
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.
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:
- Vaya a Administrar > Catálogos, en la consola de IBM Cloud, y haga clic en Catálogos privados.
- Haga clic en el icono
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:
-
Apunte a un grupo de recursos para crear un catálogo. Puede ejecutar el mandato
ibmcloud resource groups
y, a continuación, el mandatoibmcloud target -g "resource group"
. -
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:
- Apunte a un grupo de recursos para crear un catálogo. Puede ejecutar el mandato
ibmcloud resource groups
y, a continuación, el mandatoibmcloud target -g "resource group"
. - Cree un nuevo catálogo privado en su cuenta utilizando el mandato siguiente.
ibmcloud catalog create --name CATALOG [--catalog-description "DESCRIPTION"]
- 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:
-
Cree un argumento en el archivo
main.tf
. El ejemplo siguiente crea un catálogo utilizando el recursoibm_cm_catalog
, dondelabel
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.
-
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
-
Suministre los recursos desde el archivo
main.tf
. Para obtener más información, consulte Infraestructura de suministro con Terraform.-
Ejecute
terraform plan
para generar un plan de ejecución de Terraform para obtener una vista previa de las acciones propuestas.terraform plan
-
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.