Plugin de la CLI de gestión de catálogos
La interfaz de comando (CLI) de gestión de catálogos de IBM Cloud® ofrece funciones adicionales para trabajar con los productos del catálogo de IBM Cloud y los catálogos privados de su cuenta. Puede utilizar este plug-in de CLI para gestionar sus catálogos privados, incorporar productos de software privados y gestionar la visibilidad del catálogo entre el catálogo público y sus catálogos privados.
Antes de empezar
- Instale la CLI de IBM Cloud. Para obtener más información, consulte Iniciación a la CLI de IBM Cloud. El prefijo para ejecutar mandatos mediante la CLI de IBM Cloud es
ibmcloud. - Antes de ejecutar mandatos de registro, inicie una sesión en IBM Cloud con el mandato
ibmcloud loginpara generar una señal de acceso y autenticar la sesión.
Instalación del plugin de gestión de catálogos
Para instalar el plugin de gestión de catálogos, ejecute el mandato siguiente:
ibmcloud plugin install catalogs-management
En la línea de mandatos, se le avisará cuando estén disponibles las actualizaciones en la CLI de ibmcloud y en el plugin de la CLI de catalogs-management. Asegúrese de mantener la CLI actualizada para que pueda utilizar
todos los mandatos y distintivos disponibles.
Si desea ver la versión actual del plugin de la CLI de catalogs-management, ejecute ibmcloud plugin list.
Para mantener la privacidad y la seguridad, no especifique información personal en los nombres o descripciones de catálogo.
ibmcloud catalog account add-approval-access
Ejecute el mandato siguiente para añadir acceso de aprobación a su cuenta de catálogo.
ibmcloud catalog account add-approval-access [--account-ids IDS] [--object-kind KIND]
Opciones de comando
- --object-kind VALOR
- Proporcione el tipo de objeto. Las opciones son
offering,vpe,proxy_sourceopreset_configuration. - --account-ids VALOR
- Proporcione una lista separada por comas de ID de cuenta precedidos de uno de los siguientes.
-acct-para cuentas normales,-ent-para cuentas de empresa y-entgrp-para grupos de cuentas de empresa.
ibmcloud catalog account delete-approval-access
Ejecute el mandato siguiente para suprimir el acceso de aprobación a su cuenta de catálogo.
ibmcloud catalog account delete-approval-access [--account-ids IDS] [--object-kind KIND]
Opciones de comando
- --object-kind VALOR
- Proporcione el tipo de objeto. Las opciones son
offering,vpe,proxy_sourceopreset_configuration. - --account-ids VALOR
- Proporcione una lista separada por comas de ID de cuenta precedidos de uno de los siguientes.
-acct-para cuentas normales,-ent-para cuentas de empresa y-entgrp-para grupos de cuentas de empresa.
ibmcloud catalog account get-approval-list
Ejecute el siguiente comando para obtener una lista de aprobación para su cuenta de catálogo.
ibmcloud catalog account get-approval-list [--object-kind KIND]
Opciones de comando
- --object-kind VALOR
- Proporcione el tipo de objeto. Las opciones son
offering,vpe,proxy_sourceopreset_configuration.
ibmcloud catalog account get-approval-list-source
Ejecute el mandato siguiente para obtener todas las cuentas de destino que apuntan a un origen.
ibmcloud catalog account get-approval-list-source [--approval-state STATE] [--enterprise-id ID] [--object-kind KIND]
Opciones de comando
- --object-kind VALOR
- Proporcione el tipo de objeto. Las opciones son
offering,vpe,proxy_sourceopreset_configuration. - --approval-state VALOR
- Proporcione el estado de aprobación. Las opciones son
approved,pendingorejected. - --enterprise-id VALOR (opcional)
- Proporcione un ID de grupo de cuentas de empresa o de empresa para ver o gestionar solicitudes para la empresa. Prefije el ID con
-ent-para una empresa y-entgrppara un grupo de cuentas.
ibmcloud catalog account set-approval-state-source
Ejecute el siguiente comando para establecer el estado de aprobación de las cuentas de destino que apuntan a un origen.
ibmcloud catalog account set-approval-state-source [--account-ids IDS] [--approval-state STATE] [--enterprise-id ID] [--object-kind KIND]
Opciones de comando
- --object-kind VALOR
- Proporcione el tipo de objeto. Las opciones son
offering,vpe,proxy_sourceopreset_configuration. - --approval-state VALOR
- Proporcione el estado de aprobación. Las opciones son
approved,pendingorejected. - --account-ids VALOR
- Proporcione una lista separada por comas de ID de cuenta precedidos de uno de los siguientes prefijos:
-acct-para cuentas normales,-ent-para cuentas de empresa y-entgrp-para grupos de cuentas de empresa. - --enterprise-id VALOR (opcional)
- Proporcione un ID de grupo de cuentas de empresa o de empresa para ver o gestionar solicitudes para la empresa. Prefije el ID con
-ent-para una empresa y-entgrppara un grupo de cuentas.
ibmcloud catalog create
Utilice este mandato para crear un catálogo privado nuevo en su cuenta. Se utiliza un catálogo privado para organizar un conjunto de productos, productos privados que añada o referencias a productos en el catálogo de IBM Cloud. Un usuario debe tener acceso a su catálogo privado a través de una política de acceso de IAM y al grupo de recursos que contiene el catálogo privado para poder ver y trabajar con los productos.
Dirígete a un grupo de recursos para crear un catálogo porque el catálogo existe en el contexto de un grupo de recursos concreto. Para obtener la lista de los grupos de recursos, puede ejecutar el mandato ibmcloud resource groups y luego el mandato ibmcloud target -g "resource group".
ibmcloud catalog create --name CATALOG [--catalog-description "DESCRIPTION"]
Opciones de comando
- --name CATALOG
- El nombre del catálogo.
- --catalog-description DESCRIPTION (opcional)
- La descripción abreviada del catálogo nuevo.
Ejemplo
Cree un catálogo denominado dev-catalog con la descripción a catalog for development and testing purpsoses.
ibmcloud catalog create --name dev-catalog --catalog-description "a catalog for development and testing purposes"
ibmcloud catalog list
Ejecute el mandato siguiente para recuperar la lista de catálogo en esta cuenta en particular.
ibmcloud catalog list [--output FORMAT]
Opciones de comando
- --output FORMAT (opcional)
- Especifica el formato de salida. Por defecto es compatible con terminal y la única alternativa soportada es JSON. Por ejemplo,
--output json.
Salida
El mandato devuelve el siguiente resultado:
Name ID Description Last Updated
dev-catalog 93f592fb-e09b-4a53-bbd9-92f6ab9e253b short-description 2019-11-21 21:28:28.347 +0000 UTC
ABDemoTestCatalog 7a246530-e191-45e2-87cc-07c8c7033d2b short-description 2019-08-19 17:43:48.59 +0000 UTC
ibmcloud catalog get
Ejecute el mandato siguiente para recuperar información sobre un catálogo en particular en la cuenta.
ibmcloud catalog get --catalog CATALOG [--output FORMAT]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --output FORMAT (opcional)
- Especifica el formato de salida. Por defecto es compatible con terminal y la única alternativa soportada es JSON. Por ejemplo,
--output json.
Salida
El mandato devuelve el siguiente resultado:
Name Current State Version Locator
dev-catalog
|__dev-offering
| |__Openshift
| |__1.0.0 Draft 480fb4e3-d7ba-4e9b-9d4c-42f0ab811040.fd8f91a3-8027-4919-ad6d-c5189a4a8ee
ibmcloud catalog delete
Ejecute el mandato siguiente para recuperar información para un catálogo en particular en la cuenta.
ibmcloud catalog delete --catalog CATALOG
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
ibmcloud catalog search
Ejecute el mandato siguiente para buscar las ofertas publicadas, incluidos servicios y software, en el catálogo público.
ibmcloud catalog search <QUERY> [--catalog CATALOG] [--type TYPE] [-r, --region REGION] [-k, --kind KIND] [--fields FIELDS] [-p, --price PRICE] [-t, --tag TAG] [--sort-by PROPERTY] [--col COLUMNS] [--reverse] [--output TYPE] [--global]
Opciones de comando
- --type TYPE (opcional)
- Opcional. El valor predeterminado es
services. Las opciones válidas sonservicesysoftware. - --catalog CATALOG (opcional)
- Busque el software publicado por su cuenta. Especifique el nombre o el ID del catálogo que se va a buscar.
- --output FORMAT (opcional)
- Especifica el formato de salida. Por defecto es compatible con terminales y las únicas opciones alternativas son
jsonycsv. - --kind KIND (opcional)
- Este indicador sólo es válido para los servicios de búsqueda. Especifique una lista de tipos de productos separados por comas.
- --region REGION (opcional)
- Este indicador sólo es válido para los servicios de búsqueda. Proporcione una lista de regiones separadas por comas. Ejecute
ibmcloud cs regionspara obtener una lista válida. - --price PRICE (opcional)
- Este indicador sólo es válido para los servicios de búsqueda. Proporcione una lista de tipos de precios separados por comas.
- --tag TAG (opcional)
- Este indicador sólo es válido para los servicios de búsqueda. Proporcione una lista de etiquetas separadas por comas.
- --global (opcional)
- Este indicador sólo es válido para los servicios de búsqueda. Utilícelo para operar en un ámbito global.
- --sort-by TYPE (opcional)
- Esta bandera sólo es válida para los servicios de búsqueda y se utiliza para ordenar el resultado de la búsqueda. Las opciones disponibles son
name,displayname,kind,provider,createdyupdated. - --reverse (opcional)
- Este indicador sólo es válido para los servicios de búsqueda. Utilícelo para invertir el orden de clasificación.
- --fields FIELDS (opcional)
- Este indicador sólo es válido para los servicios de búsqueda. Personalice la tabla; por ejemplo,
--fields name,kind,metadata.service.iam_compatible.
Salida
El mandato devuelve el siguiente resultado:
Name ID Category
2 Zone VPC f10d9ae9-ac94-4718-b24a-3994241ae2a4-global Networking
Apache Qml0bmFtaS1hcGFjaGU=-global Developer Tools
Apache Airflow Qml0bmFtaS1haXJmbG93-global Databases
Apache Airflow Qml0bmFtaS1haXJmbG93-global Developer Tools
ibmcloud catalog filter get
Ejecute el mandato siguiente para recuperar detalles de filtro para la cuenta o para un catálogo en particular.
ibmcloud catalog filter get --catalog CATALOG [--output FORMAT]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --account-group ACCOUNT GROUP
- El nombre o ID del grupo de cuentas. Este campo solo se aplica a las cuentas de empresa.
- --output FORMAT (opcional)
- Especifica el formato de salida. Por defecto es compatible con terminal y la única alternativa soportada es JSON. Por ejemplo,
--output json.
Salida
El mandato devuelve el siguiente resultado:
Account: The IBM Cloud catalog is visible to all users in this account.
Filter:
Including IBM Cloud catalog
Type Include Tags
Pricing plan false Free
Provider false Third Party
ibmcloud catalog filter create
Ejecute el mandato siguiente para crear un filtro nuevo. Si existe un filtro, este mandato altera temporalmente el filtro actual.
ibmcloud catalog filter create [--catalog CATALOG] [--category CATEGORY] [--compliance COMPLIANCE] [--deployment-target TARGET] [--exclude-list LIST] [--include-all ALL] [--include-list LIST] [--offering-format FORMAT] [--pricing-plan PLAN] [--provider PROVIDER] [--release RELEASE] [--type TYPE]
Opciones de comando
- --catalog CATALOG (opcional)
- Especifique el nombre o el ID del catálogo. Si no se especifica, el filtro se crea a nivel de cuenta.
- --account-group ACCOUNT GROUP
- El nombre o ID del grupo de cuentas. Esta opción solo se aplica a las cuentas de empresa.
- --hide-ibm-catalog (optional)
- De forma predeterminada, el catálogo resulta visible para todos los usuarios de esta cuenta. Si especifica este distintivo, puede hacer que los productos estén disponibles solamente para aquellos usuarios que elija desactivando la visibilidad del catálogo de IBM Cloud y añadiendo los productos a sus catálogos privados.
- --include-all BOOLEAN (opcional)
- Por defecto es true si no se proporciona la bandera. Los valores válidos son
trueyfalse. Si se especifica true, el filtro incluirá de forma predeterminada todo el catálogo público y se excluirán los filtros posteriores. Si se especifica false, el filtro excluirá todo el catálogo público y se incluirán los distintivos posteriores. Para obtener más información, consulte Gestión de valores del catálogo.
--offering-format FORMAT (opcional)
- --category CATEGORY (opcional)
- Proporcione la categoría que mejor se ajuste a cómo los usuarios pueden utilizar el producto. Las categorías se utilizan para organizar productos en el catálogo basados en funciones, uso o soluciones comunes. Sólo puede seleccionar una categoría.
Ejecute el mandato
ibmcloud catalog offering category-optionspara ver todas las opciones. El valor predeterminado esDeveloper tools. - --compliance TYPE (opcional)
- Proporcione una lista separada por comas de las categorías de conformidad que desea incluir o excluir. Ejecute el mandato
ibmcloud catalog filter optionspara ver todas las opciones. - --deployment-target TARGET (opcional)
- Proporcione una lista separada por comas de destinos de despliegue que desee incluir o excluir. Ejecute el mandato
ibmcloud catalog filter optionspara ver todas las opciones. - --exclude-list LIST (opcional)
- Proporcione una lista separada por comas de los ID o nombres de los productos que se tienen que excluir del catálogo público filtrado.
- --include-list LIST (opcional)
- Proporcione una lista separada por comas de los ID o nombres de los productos que se tienen que incluir en el catálogo público filtrado.
- Proporcione una lista separada por comas de formatos de producto que desee incluir o excluir. Ejecute el mandato
ibmcloud catalog filter optionspara ver todas las opciones. - --pricing-plan PLAN (opciones)
- Proporcione una lista separada por comas de planes de precios que desea incluir o excluir. Ejecute el mandato
ibmcloud catalog filter optionspara ver todas las opciones. - --provider PROVIDER (opcional)
- Proporcione una lista separada por comas de proveedores que desea incluir o excluir. Ejecute el mandato
ibmcloud catalog filter optionspara ver todas las opciones. - --release RELEASE (opcional)
- Proporcione una lista separada por comas de las categorías que desea incluir o excluir. Ejecute el mandato
ibmcloud catalog filter optionspara ver todas las opciones. - --type TYPE (opcional)
- Proporcione una lista separada por comas de tipos de software que desea incluir o excluir. Ejecute el mandato
ibmcloud catalog filter optionspara ver todas las opciones.
ibmcloud catalog filter delete
Ejecute el mandato siguiente para suprimir un filtro aplicado. De este modo se toman los valores predeterminados del filtro a nivel de cuenta a menos que se especifique el catálogo. Como resultado, el filtro se restablece para incluir todos los productos en el catálogo público.
ibmcloud catalog filter delete --catalog CATALOG
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --account-group ACCOUNT GROUP
- El nombre o ID del grupo de cuentas. Esta opción solo se aplica a las cuentas de empresa.
ibmcloud catalog filter offering
Actualizar el filtro para incluir o excluir un determinado producto y los planes de precios aplicables. De este modo se toman los valores predeterminados del filtro a nivel de cuenta a menos que se especifique el catálogo o grupo de cuentas.
ibmcloud catalog filter offering --offering PRODUCT-NAME
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --account-group ACCOUNT GROUP
- El nombre o ID del grupo de cuentas. Esta opción solo se aplica a las cuentas de empresa.
- --plans-list PLANS LIST
- Una lista separada por comas de los ID o nombres de planes que se van a incluir o a excluir.
- --offering OFFERING
- El nombre o el ID del producto.
- --include
- El valor predeterminado es true si no se especifica un distintivo. Los valores válidos son
trueyfalse. Si se especifica true, el producto y los planes proporcionados resultan visibles para los usuarios de la cuenta. Si se especifica false, el producto y los planes no resultan visibles para los usuarios de la cuenta.
ibmcloud catalog filter hide-ibm-public-catalog
De forma predeterminada, el catálogo de IBM Cloud resulta 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.
ibmcloud catalog filter hide-ibm-public-catalog
ibmcloud catalog filter show-ibm-public-catalog
De forma predeterminada, el catálogo de IBM Cloud resulta 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.
ibmcloud catalog filter show-ibm-public-catalog
ibmcloud catalog filter options
Ejecute el mandato siguiente para recuperar las opciones de filtrado para cada categoría de filtro.
ibmcloud catalog filter options
Opciones de comando
- --all
- Incluye el sector, el tipo de solución y el plan de precios en la lista de filtros.
- --output FORMAT (opcional)
- Especifica el formato de salida. Por defecto es compatible con terminal y la única alternativa soportada es JSON. Por ejemplo,
--output json.
Salida
El mandato devuelve el siguiente resultado:
Deployment target ID
IBM Cloud Kubernetes Service target_iks
IBM Cloud Schematics target_terraform
Red Hat OpenShift target_roks
VMware vCenter Server target_vcenter
Virtual private cloud target_vpc-x86
Power Systems Virtual Server target_power-iaas
Provider ID
Third party ibm_third_party
Community ibm_community
IBM ibm_created
Release ID
Beta ibm_beta
Deprecated ibm_deprecated
Works with ID
SAP Certified sap_certified
Quantum Technologies quantum_tech
Satellite Enabled satellite_enabled
HPC hpc
Support ID
Third party supported support_third_party
Community supported support_community
IBM supported support_ibm
Delivery method ID
Cloud Paks cloud_pak
Helm charts helm
Operators operator
OVA Images ova
Starter kits template
Terraform terraform
Server Images vsi_image
Blueprint blueprint
Toolchains toolchain
Compliance ID
EU Supported eu_access
Financial Services Validated fs_ready
HIPAA Enabled hipaa
IAM-enabled rc_compatible
Service Endpoint Supported service_endpoint_supported
Category ID Tags
Compute compute compute,compute_classic,content,openwhisk,runtime,virtualservers,compute_baremetal
Containers containers containers,clusters,registry
Networking network network,network_vpc,network_classic,network_edge,network_interconnectivity
Storage storage storage,storage_vpc,storage_classic,storage_datamovement
Converged infrastructure converged_infra converged_infra
Enterprise applications enterprise_app enterprise_app
AI / Machine Learning ai watson,ai
Analytics analytics data_analytics,business_analytics,analytics
Blockchain blockchain blockchain
Databases databases data_management,database
Developer tools devops dev_ops
Logging and monitoring logging_monitoring logging_monitoring
Migration migration_tools migration_tools
Integration integration integration,api
Internet of Things iot internet_of_things
Security security security
Mobile mobile mobile,web_and_app
ibmcloud catalog offering create
Ejecute el mandato siguiente para añadir un producto a un catálogo privado en la cuenta.
ibmcloud catalog offering create [--catalog CATALOG_NAME] [--zipurl URL] [--include-config] [--target-version VERSION] [--token TOKEN] [--vpc-body BODY]
Opciones de comando
- --catalog CATALOG_NAME
- El nombre o el ID del catálogo.
- - --zipurl URL (opcional)
- URL que apunta al archivo .zip del producto.
- --target-version VERSION
- Especifique la versión del producto.
- --include-config (opcional)
- Si se especifica, se incluirán todos los valores de configuración y estarán disponibles cuando añada el producto.
- --token TOKEN (opcional)
- Especifique la señal de acceso personal para un repositorio privado.
- --vpc-body BODY (opcional)
- Proporcione la información para importar una imagen de servidor virtual para VPC, incluyendo un nombre, etiqueta, tipo de instalación, tipo de destino, versión, sha, etiquetas y metadatos.
Ejemplo de imagen de servidor virtual para VPC #1
Importar una imagen de servidor virtual para VPC como una oferta a un catálogo con el ID 51c9e0db-2911-45a6-adb0-ac5332d27cf2.
ibmcloud catalog offering create --catalog 51c9e0db-2911-45a6-adb0-ac5332d27cf2 --vpc-body '{
"name": "virtual-server-image",
"label": "virtual server image",
"install_kind": "instance",
"target_kinds": ["vpc-x86"],
"version": "0.0.10",
"sha": "64245e5f3f1e9c4048b18db3abd1450d4b6f9e263ac1b33df6fc1ae96fcbdebb",
"tags": ["virtualservers"],
"metadata": {
"operating_system": {
"dedicated_host_only": false,
"vendor": "CentOS",
"name": "centos-7-amd64",
"href": "https://us-south-stage01.iaasdev.cloud.ibm.com/v1/operating_systems/centos-7-amd64",
"display_name": "CentOS 7.x - Minimal Install (amd64)",
"family": "CentOS",
"version": "7.x - Minimal Install",
"architecture": "amd64"
},
"minimum_provisioned_size": 100,
"file": {
"size": 1
},
"images": [{"id": "r134-14903434-faf0-4a66-b861-7b35198de393", "name": "virtual-server-image", "region": "us-south"}]
}
}'
Ejemplo de imagen de servidor virtual para VPC #2
Importar una imagen de servidor virtual para VPC como una oferta a un catálogo con el ID 2bdc3974-dfcf-4711-b298-cd238f7d3734.
ibmcloud catalog offering create --catalog 2bdc3974-dfcf-4711-b298-cd238f7d3734 --vpc-body '{
"name": "virtual-server-image-s390x",
"label": "virtual-server-image-s390x",
"install_kind": "instance",
"target_kinds": ["vpc-z"],
"version": "0.0.10",
"sha": "4739f1eaeeebc69ad5d48f9191fcc0d23960cb720bb16c67e915e5556c1da9b2",
"tags": ["virtualservers"],
"metadata": {
"operating_system": {
"dedicated_host_only": false,
"vendor": "SUSE Linux Enterprise Server",
"name": "sles-15-sp2-s390x-byol",
"href": "https://us-south-stage01.iaasdev.cloud.ibm.com/v1/operating_systems/sles-15-s390x",
"display_name": "Suse enterprise server(s390x)",
"family": "SUSE",
"version": "15-sp2",
"architecture": "s390x"
},
"minimum_provisioned_size": 100,
"file": {
"size": 1
},
"images": [{"id": "r134-f20e2e4e-3133-423c-afa2-365afa14c4dc", "name": "virtual-server-image-s390x", "region": "us-south"}]
}
ibmcloud catalog offering list
Ejecute el mandato siguiente para obtener información detallada sobre los productos de catálogos privados. Este mandato proporciona un filtro por catálogo privado, por producto y por versión.
ibmcloud catalog offering list [--catalog CATALOG] [--offering OFFERING_NAME] [--version VERSION] [--output FORMAT]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --output FORMAT (opcional)
- Especifica el formato de salida. El valor predeterminado es compatible con terminales y la única alternativa admitida es JSON, por ejemplo,
--output json.
Ejemplo
Obtener una lista de los productos contenidos en el catálogo dev-catalog.
ibmcloud catalog offering list --catalog dev-catalog
Salida
El mandato devuelve el siguiente resultado:
Name ID Current State Version Locator
Cloud Pak for Automation cb90274e-398b-4373-9b28-d6428d3302df
|__OpenShift
|__19.0.2 New 7b7e590f-259b-437b-b1f4-39e8615ed837.21d1d712-80ab-4318-9d05-73c6caaaee23
Cloud Pak for Data 8993c7b1-1794-4447-9275-db83faa08ee4
|__OpenShift
|__2.1.0.2 New 7b7e590f-259b-437b-b1f4-39e8615ed837.ab6ba56f-788d-4d6b-b880-a1001fca8451
harbor 927adb44-6784-4bec-a771-f639900f07f1
|__Kubernetes
|__1.9.1 New 7b7e590f-259b-437b-b1f4-39e8615ed837.e437b06c-273f-49de-8c44-f55e408abf78
IBM Starter Collection for Openshift fd1857f4-cf17-4e97-9443-b615bc71f6a0
|__OpenShift
|__0.0.1 New 7b7e590f-259b-437b-b1f4-39e8615ed837.72e0f636-9dc4-49ae-b3c2-7a5de90487b9
tf_cloudless_sleepy-2.0 c260a67a-1b25-49fc-9896-46e7e6212990
|__
|__1.0.0 New 7b7e590f-259b-437b-b1f4-39e8615ed837.965df91d-5760-4872-adf6-4019796c06b0
|__1.0.1 New 7b7e590f-259b-437b-b1f4-39e8615ed837.aff4cecb-4c9b-41ba-ae3d-71f4217dc0bc
ibmcloud catalog offering search
Ejecute el mandato siguiente para obtener información detallada sobre los productos de catálogos privados. Este mandato proporciona un filtro por catálogo privado, por producto y por versión.
ibmcloud catalog offering search [--catalog CATALOG] [--offering OFFERING_NAME] [--version VERSION] [--output FORMAT]
Opciones de comando
- --catalog CATALOG (opcional)
- El nombre o el ID del catálogo.
- --offering OFFERING (opcional)
- El nombre o el ID del producto.
- --version VERSION (opcional)
- El nombre o el ID de la versión.
- --output FORMAT (opcional)
- Especifica el formato de salida. El valor predeterminado es compatible con terminales y la única alternativa admitida es JSON, por ejemplo,
--output json.
Ejemplo
Obtener una lista de los productos contenidos en el catálogo dev-catalog.
ibmcloud catalog offering list --catalog dev-catalog
Salida
El mandato devuelve el siguiente resultado:
Name Current State Version Locator
dev-catalog
|__dev-offering
| |__Kubernetes
| |__1.0.0 Validated b636d651-8489-4425-bd6a-f30af1603577.17ac792e-a603-4f1a-a1b6-48e90a46940c
|__dev-offering-2.0
| |__Kubernetes
| |__1.0.0 Published to account b636d651-8489-4425-bd6a-f30af1603577.decdb0e1-46d2-401a-b482-80f9d6855f98
ibmcloud catalog offering get
Ejecute el mandato siguiente para obtener información detallada sobre un producto específico del catálogo.
ibmcloud catalog offering get --catalog CATALOG --offering OFFERING_NAME [--output FORMAT]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING_NAME
- El nombre o el ID del producto.
- --output FORMAT (opcional)
- Especifica el formato de salida. El valor predeterminado es compatible con terminales y la única alternativa admitida es JSON, por ejemplo,
--output json.
Salida
El mandato devuelve el siguiente resultado:
Name Current State Version Locator
dev-offering
|__
|__1.0.0 Draft 480fb4e3-d7ba-4e9b-9d4c-42f0ab811040.a92f5409-ebd9-413c-88ae-7ed311c1b793
ibmcloud catalog offering import-version
Ejecute el mandato siguiente para importar una versión nueva de un producto de su catálogo privado.
ibmcloud catalog offering import-version --catalog CATALOG --offering OFFERING_NAME [--zipurl URL] [--target-version APP_VERSION] [--include-config] [--vpc-body BODY]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING_NAME
- : El nombre o el ID del producto.
- - --zipurl URL (opcional)
- La dirección URL apunta al archivo.zip del producto.
- --target-version APP_VERSION (opcional)
- La versión de aplicación del valor "tgz" que se está importando.
- --include-config (opcional)
- Si se especifica, se incluirán todos los valores de configuración y estarán disponibles cuando importe la nueva versión.
- --vpc-body BODY (opcional)
- Proporcione la información para importar una imagen de servidor virtual para VPC, incluyendo un nombre, etiqueta, tipo de instalación, tipo de destino, versión, sha, etiquetas y metadatos.
Imagen de servidor virtual para VPC Ejemplo
Importe una imagen de servidor virtual para VPC a una oferta existente con a un catálogo con ID 51c9e0db-2911-45a6-adb0-ac5332d27cf2 e ID de oferta 97cdaf1b-62b2-48e2-8589-10b31023866d.
ibmcloud catalog offering import-version --catalog 51c9e0db-2911-45a6-adb0-ac5332d27cf2 --offering 97cdaf1b-62b2-48e2-8589-10b31023866d --vpc-body '{
"name": "virtual-server-image",
"label": "virtual server image",
"install_kind": "instance",
"target_kinds": ["vpc-x86"],
"version": "0.0.10",
"sha": "64245e5f3f1e9c4048b18db3abd1450d4b6f9e263ac1b33df6fc1ae96fcbdebb",
"tags": ["virtualservers"],
"metadata": {
"operating_system": {
"dedicated_host_only": false,
"vendor": "CentOS",
"name": "centos-7-amd64",
"href": "https://us-south-stage01.iaasdev.cloud.ibm.com/v1/operating_systems/centos-7-amd64",
"display_name": "CentOS 7.x - Minimal Install (amd64)",
"family": "CentOS",
"version": "7.x - Minimal Install",
"architecture": "amd64"
},
"minimum_provisioned_size": 100,
"file": {
"size": 1
},
"images": [{"id": "r134-14903434-faf0-4a66-b861-7b35198de393", "name": "virtual-server-image", "region": "us-south"}]
}
}''
ibmcloud catalog offering update
Para actualizar un producto de su catálogo privado, primero tiene que obtener el producto y después podrá actualizarlo.
Ejecute el mandato offering get. Para obtener más información, consulte la oferta del catálogo ibmcloud get.
ibmcloud catalog offering get -c <CATALOGID> -o <OFFERINGID> --output json
Ejecute el mandato offering update.
ibmcloud catalog offering update -c <CATALOGID> -o <OFFERINGID> --updated-offering <UPDATED_OFFERING.json>
ibmcloud catalog offering version preinstall
Ejecute el mandato siguiente para ejecutar el script previo a la instalación para un determinado producto.
ibmcloud catalog offering version preinstall --version-locator VERSION_NUMBER --cluster CLUSTER_ID --namespace NAME
Opciones de comando
- --version-locator VERSION_NUMBER
- Para obtener el localizador de versión de este producto, ejecute el mandato
ibmcloud catalog offering listy localice el producto especificado y la versión que quisiera utilizar. - --cluster CLUSTER_ID
- Especifique el ID del clúster donde desea instalar el producto.
- --namespace NAME
- Proporcione el espacio de nombres que desea utilizar. Puede especificar uno nuevo y se creará de forma automática como parte de las tareas previas a la instalación.
Ejemplo
Ejecute el script previo a la instalación para un producto con un número de localizador de versión de
b636d651-8489-4425-bd6a-f30af1603577.18aad484-c78b-4269-808b-52027621abd4 en el clúster con el ID bn5ebho206o7fg45f2e0 en el espacio de nombres denominado test-namespace.
ibmcloud catalog offering version preinstall --version-locator b636d651-8489-4425-bd6a-f30af1603577.18aad484-c78b-4269-808b-52027621abd4 --cluster bn5ebho206o7fg45f2e0 --namespace test-namespace
ibmcloud catalog offering version preinstall-status
Ejecute el mandato siguiente para obtener el estado de una preinstalación en curso.
ibmcloud catalog offering version preinstall-status --version-locator VERSION_NUMBER --cluster CLUSTER_ID --namespace NAME [--output FORMAT]
Opciones de comando
- --version-locator VERSION_NUMBER
- Para obtener el localizador de versión del producto, ejecute el mandato
ibmcloud catalog offering listy localice el producto especificado y la versión que quisiera utilizar. - --cluster CLUSTER_ID
- Proporcione el ID del clúster donde se ha ejecutado la preinstalación.
- --namespace NAME
- Proporcione le espacio de nombres utilizado para la preinstalación.
- --output FORMAT (opcional)
- Especifica el formato de salida. El valor predeterminado es compatible con terminales y la única alternativa admitida es JSON, por ejemplo,
--output json.
ibmcloud catalog offering version validate
Ejecute el mandato siguiente para validar una versión nueva de un producto de su catálogo privado. Los productos se deben validar para asegurarse de que funcionan como se esperaba antes de que se puedan publicar en la cuenta para que otros usuarios creen una instancia a partir del catálogo privado.
ibmcloud catalog offering version validate --version-locator VERSION_NUMBER --cluster CLUSTER_ID --namespace NAME [--timeout TIMEOUT] [--wait WAIT] [--override-values VALUES|FILENAME] [--workspace-tf-version VERSION] [--workspace-region REGION] [--workspace-rg-id ID][--schematics-destroy][--schematics-delete]
Opciones de comando
- --version-locator VERSION_NUMBER
- Para obtener el localizador de versión del producto, ejecute el mandato
ibmcloud catalog offering listy localice el producto especificado y la versión que desea utilizar. - --cluster CLUSTER_ID
- Especifique el ID del clúster donde desea instalar el producto.
- --namespace NAME
- Proporcione el espacio de nombres que desea utilizar. Puede especificar uno nuevo y se creará de forma automática como parte de las tareas previas a la instalación.
- -- timeout TIMEOUT
- Especifique en segundos cuánto tiempo el espacio de trabajo de Schematics espera a que se instale. El valor predeterminado es
180. - -- wait WAIT
- Espere y realice un seguimiento del progreso del trabajo del espacio de trabajo de Schematics. Si es
true, la instalación espera. Si esfalse, el software se instala inmediatamente. El valor predeterminado estrue. - --override-values VALUES|FILENAME (opcional)
- Proporcione una configuración personalizada para la instalación. Puede proporcionar este valor en línea o utilizando un archivo JSON o TXT. Por ejemplo,
override-values values.json. Al validar una imagen de servidor virtual para VPC, se deben proporcionar los campos siguientes: vsi_instance_name, vsi_id, vpc_profile, subnet_id, vpc_id, subnet_zone, ssh_key_id, vpc_region - --workspace-tf-version VERSION (opcional)
- Proporcione una versión de terraform de espacio de trabajo.
- --workspace-region REGION (opcional)
- Proporcione una región de espacio de trabajo.
- --workspace-rg-id ID (opcional)
- Proporcione un ID de grupo de recursos de espacio de trabajo.
- -- schematics-destroy (opcional)
- Indique esta opción para eliminar los recursos del espacio de trabajo tras la validación y la instalación.
- -- schematics-delete VALUE (opcional)
- Proporcione este distintivo para suprimir el espacio de trabajo de Schematics después de la validación y la instalación.
Ejemplo de validación de un producto que utiliza un clúster
Valide un producto con el localizador de versión b636d651-8489-4425-bd6a-f30af1603577.18aad484-c78b-4269-808b-52027621abd4 en un clúster con el ID bn5ebho206o7fg45f2e0 dentro de un espacio de nombres denominado test-namespace.
Esta instalación tiene configuraciones personalizadas, por lo que los valores se proporcionan utilizando un archivo values.json.
ibmcloud catalog offering version validate --version-locator b636d651-8489-4425-bd6a-f30af1603577.18aad484-c78b-4269-808b-52027621abd4 --cluster bn5ebho206o7fg45f2e0 --namespace test-namespace --override-values values.json
Sobrescriba el formato de ejemplo de valores del archivo values.json:
{
"username": "provision-test-1",
"password": "passw0rd"
}
Imagen de servidor virtual para VPC Ejemplo
Valide un producto con el localizador de versión 51c9e0db-2911-45a6-adb0-ac5332d27cf2.ecebffdc-f1f8-4a85-965f-9cbe31920542 en una VPC con el ID r134-476cbb67-a6c2-4957-9806-3fcbac3498be.
ibmcloud catalog offering version validate --version-locator 51c9e0db-2911-45a6-adb0-ac5332d27cf2.ecebffdc-f1f8-4a85-965f-9cbe31920542 --workspace-region=us-south --workspace-rg-id Default --override-values '{
"vsi_instance_name": "instance-name-1",
"vsi_id": "r134-14903434-faf0-4a66-b861-7b35198de393",
"vpc_profile": "bx2-2x8",
"subnet_id": "0716-d799c449-466c-4844-902c-a5d3f8948d7d",
"vpc_id": "r134-476cbb67-a6c2-4957-9806-3fcbac3498be",
"subnet_zone": "us-south-1",
"ssh_key_id": "r134-0c53e7f2-771f-4d0e-a19e-39f2e6e6949c",
"vpc_region": "us-south"
}
ibmcloud catalog offering version validate-status
Ejecute el mandato siguiente para obtener el estado de una validación en curso.
ibmcloud catalog offering version validate-status --version-locator VERSION_NUMBER [--output FORMAT]
Opciones de comando
- --version-locator VERSION_NUMBER
- Para obtener el localizador de versión del producto, ejecute el mandato
ibmcloud catalog offering listy localice el producto especificado o la versión que desea utilizar. - --output FORMAT (opcional)
- Especifica el formato de salida. El valor predeterminado es compatible con terminales y la única alternativa admitida es JSON, por ejemplo,
--output json.
ibmcloud catalog offering category-options
Ejecute el mandato siguiente para recuperar la lista de opciones de categoría.
ibmcloud catalog offering category-options [--output FORMAT]
Opciones de comando
- --output FORMAT (opcional)
- Especifica el formato de salida. El valor predeterminado es compatible con terminales y la única alternativa admitida es JSON, por ejemplo,
--output json.
Ejemplo
ibmcloud catalog offering category-options
Salida
El mandato devuelve el siguiente resultado:
Name Tags Description
VPC Infrastructure vpc Fully customizable, software-defined virtual network with superior isolation.
Compute compute,content,containers,openwhisk,vmware,runtime Build your virtual environments
Containers containers,clusters,registry Get started by creating a Kubernetes cluster, or manage your Docker images in the registry.
Networking network Order network.
Storage storage Order storage.
ibmcloud catalog offering add-category
Ejecute el mandato siguiente para añadir una etiqueta de categoría a un producto. Puede proporcionar el nombre de la categoría, que puede encontrar ejecutando el comando ibmcloud catalog offering category-options. Los productos
deben estar en una categoría para que estén visibles en la categoría. El valor predeterminado es Developer tools.
ibmcloud catalog offering category-options [--output FORMAT]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING
- El nombre o el ID del producto.
- --category CATEGORY
- Proporcione la categoría que mejor se ajuste a cómo los usuarios pueden utilizar el producto. Las categorías se utilizan para organizar productos en el catálogo basados en funciones, uso o soluciones comunes. Sólo puede seleccionar una categoría.
Ejecute el mandato
ibmcloud catalog offering category-optionspara ver todas las opciones. El valor predeterminado esDeveloper tools.
Ejemplo
ibmcloud catalog offering add-category --catalog dev-catalog --offering dev-offering --category dev_ops
categorías de oferta de catálogo de ibmcloud
Ejecute el mandato siguiente para recuperar la categoría de una versión de producto.
ibmcloud catalog offering version categories [--catalog CATALOG] [--offering OFFERING] [--output OUTPUT]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING
- El nombre o el ID del producto.
- --output FORMAT (opcional)
- Especifica el formato de salida. Por defecto es compatible con terminal y la única alternativa soportada es JSON. Por ejemplo,
--output json.
Ejemplo
Recupere la categoría de un producto que se denomina dev-offering y que se encuentra en dev-catalog.
ibmcloud catalog offering version categories --catalog dev-catalog --offering dev-offering
ibmcloud catalog offering version get-claims
Ejecute el mandato siguiente para recuperar la información de seguridad y conformidad que ha reclamado una versión.
ibmcloud catalog offering version get-claims [--output OUTPUT] [--version-locator LOCATOR]
Opciones de comando
- --version-locator LOCALIZADOR
- Para obtener el localizador de versión del producto, ejecute el mandato
ibmcloud catalog offering listy localice el producto especificado o la versión que desea utilizar. - --output (opcional)
- Especifica el formato de salida. El valor predeterminado es compatible con terminales y la única alternativa admitida es JSON, por ejemplo,
--output json.
catálogo ibmcloud que ofrece actualización de versión-reclamaciones
Ejecute el siguiente comando para actualizar las declaraciones de seguridad y conformidad de una versión.
ibmcloud catalog offering version update-claims [--claims CLAIMS] [--version-locator LOCATOR]
Opciones de comando
- --claims RECLAMACIONES
- Especifique los datos de reclamaciones para una versión como un objeto o archivo JSON.
- --version-locator LOCALIZADOR
- Para obtener el localizador de versión del producto, ejecute el mandato
ibmcloud catalog offering listy localice el producto especificado o la versión que desea utilizar.
catálogo ibmcloud versión scc-apply
Ejecute el mandato siguiente para añadir una exploración del Security and Compliance Center a su versión. Añada información de seguridad y cumplimiento a su versión y valide su versión antes de poder añadir una exploración.
ibmcloud catalog offering version scc-apply [--instance-region REGION] [--scan SCAN] [--service-instance INSTANCE] [--target-account-name NAME] [--target-api-key KEY] [--timeout TIMEOUT] [--version-locator LOCATOR] [--wait WAIT]
Opciones de comando
- --instance-region REGIÓN
- La región de la instancia.
- --scan ESCÁNER
- El ID de una exploración de Security and Compliance Center.
- --service-instance INSTANCIA
- Proporcione el ID de instancia de Security and Compliance Center.
- --target-account-name NAME (opcional)
- Indique el nombre de la cuenta de destino.
- --target-api-key KEY (opcional)
- Proporcione una clave de API si desea utilizar una cuenta alternativa (cuenta de destino) para aplicar una exploración a la cuenta de origen. Para obtener más información, consulte Configuración de una cuenta de destino.
- -- timeout TIMEOUT
- Especifique en segundos cuánto tiempo desea esperar a que se aplique la exploración a la versión antes de que se devuelva el mandato. El valor predeterminado es 600 (10 minutos).
- --version-locator LOCALIZADOR
- Para obtener el localizador de versión del producto, ejecute el mandato
ibmcloud catalog offering listy localice el producto especificado o la versión que desea utilizar. - -- wait WAIT
- Espere y realice un seguimiento del progreso de una aplicación de escaneo. Por defecto es true si no se proporciona la bandera. Si
true, el comando rastrea el progreso de la aplicación de escaneo. Si esfalse, el mandato devuelve inmediatamente.
ibmcloud catalog offering version scc-apply-status
Ejecute el mandato siguiente para ver el estado de una aplicación de escaneo del Security and Compliance Center en su versión.
ibmcloud catalog offering version scc-apply-status [--scan SCAN] [--version-locator LOCATOR]
Opciones de comando
- --scan ESCÁNER
- El ID de una exploración de Security and Compliance Center.
- --version-locator LOCALIZADOR
- Para obtener el localizador de versión del producto, ejecute el mandato
ibmcloud catalog offering listy localice el producto especificado o la versión que desea utilizar.
catálogo ibmcloud que ofrece la versión get-scans
Ejecute el mandato siguiente para recuperar las exploraciones del Security and Compliance Center que se han añadido a la versión.
ibmcloud catalog offering version get-scans [--instance-region REGION] [--output OUTPUT] [--profiles PROFILES] [--service-instance INSTANCE] [--target-account-name NAME] [--target-api-key KEY]
Opciones de comando
- --instance-region REGIÓN
- Indique la región de la instancia.
- --output SALIDA (opcional)
- Especifica el formato de salida. Por defecto es compatible con terminal y la única alternativa soportada es JSON. Por ejemplo,
--output json. - --profiles PERFILES
- Proporcione una lista separada por comas de nombres de perfil con versiones, por ejemplo,
"IBM Cloud for Financial Services::1.2.0". - --service-instance INSTANCIA
- Proporcione el ID de instancia de Security and Compliance Center.
- --target-account-name NAME (opcional)
- Indique el nombre de la cuenta de destino.
- --target-api-key KEY (opcional)
- Proporcione una clave de API si desea utilizar una cuenta alternativa (cuenta de destino) para aplicar una exploración a la cuenta de origen. Para obtener más información, consulte Configuración de una cuenta de destino.
catálogo ibmcloud que ofrece get-scan-results
Ejecute el siguiente comando para generar un informe de los resultados del análisis del Analizador de Riesgos de Código y del Security and Compliance Center su versión. Para generar un informe completo, debe ejecutar las exploraciones del Analizador de Riesgos de Código y Security and Compliance Center.
ibmcloud catalog offering get-scan-results [--version-locator LOCATOR]
Opciones de comando
- --version-locator LOCALIZADOR
- Para obtener el localizador de versión del producto, ejecute el mandato
ibmcloud catalog offering listy localice el producto especificado o la versión que desea utilizar.
ibmcloud catalog offering version create-draft
Ejecute el mandato siguiente para crear un borrador de una versión existente. Este mandato es útil para efectuar cambios en una versión existente que desee publicar sin introducir una versión nueva. Algunos cambios, como por ejemplo cambiar el archivo de origen, requieren que se vuelva a validar el producto.
ibmcloud catalog offering version create-draft --version-locator VERSION_NUMBER [--output FORMAT]
Opciones de comando
- --version-locator VERSION_NUMBER
- Para obtener el localizador de versión del producto, ejecute el mandato
ibmcloud catalog offering listy localice el producto especificado o la versión que desea utilizar. - --output FORMAT (opcional)
- Especifica el formato de salida. Por defecto es compatible con terminal y la única alternativa soportada es JSON. Por ejemplo,
--output json.
ibmcloud catalog offering version delete-version
Ejecute el mandato siguiente para suprimir una versión de un producto.
ibmcloud catalog offering version delete-version --version-locator VERSION_NUMBER [--output FORMAT]
Opciones de comando
- --version-locator VERSION_NUMBER
- Para obtener el localizador de versión del producto, ejecute el mandato
ibmcloud catalog offering listy localice el producto especificado o la versión que desea utilizar. - --output FORMAT (opcional)
- Especifica el formato de salida. Por defecto es compatible con terminal y la única alternativa soportada es JSON. Por ejemplo,
--output json.
ibmcloud catalog offering version deprecate-version
Ejecute el mandato siguiente para dejar en desuso una versión del producto publicada anteriormente del catálogo de IBM Cloud.
ibmcloud catalog offering version deprecate-version --version-locator VERSION_NUMBER
Opciones de comando
- --version-locator VERSION_NUMBER
- Para obtener el localizador de versión del producto, ejecute el mandato
ibmcloud catalog offering listy localice el producto especificado o la versión que desea utilizar.
ibmcloud catalog offering version refresh-version
Ejecute el siguiente comando para crear un cambio en el archivo fuente de una versión borrador. Este mandato resulta útil a la hora de actualizar una versión existente.
ibmcloud catalog offering version refresh-version --version-locator VERSION_NUMBER --zipurl URL [--include-config]
Opciones de comando
- --version-locator VERSION_NUMBER
- Para obtener el localizador de versión del producto, ejecute el mandato
ibmcloud catalog offering listy localice el producto especificado o la versión que desea utilizar. - --zipurl URL
- La dirección URL apunta al archivo comprimido del producto.
- --include-config (opcional)
- Si se especifica, se incluirán todos los valores de configuración y estarán disponibles cuando añada el producto.
ibmcloud catalog offering version merge-draft
Ejecute el mandato siguiente para fusionar una versión de borrador de un producto.
ibmcloud catalog offering version merge-draft --version-locator VERSION_NUMBER
Opciones de comando
- --version-locator VERSION_NUMBER
- Para obtener el localizador de versión del producto, ejecute el mandato
ibmcloud catalog offering listy localice el producto especificado o la versión que desea utilizar.
ibmcloud catalog offering ready
Ejecute el mandato siguiente para marcar el producto como listo para compartir o publicar.
ibmcloud catalog offering ready --version-locator VERSION_NUMBER
Opciones de comando
- --version-locator VERSION_NUMBER
- Para obtener el localizador de versión del producto, ejecute el mandato
ibmcloud catalog offering listy localice el producto especificado o la versión que desea utilizar.
ibmcloud catalog offering delete
Ejecute el mandato siguiente para suprimir un producto de su catálogo privado. No puede suprimir un producto que está publicado en el catálogo de IBM Cloud. Para dejar en desuso un producto publicado del catálogo de IBM Cloud, consulte ibmcloud catalog offering deprecate-offering.
ibmcloud catalog offering delete --catalog CATALOG --offering OFFERING
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING
- El nombre o el ID del producto.
ibmcloud catalog offering publish account
Ejecute el mandato siguiente para publicar un producto de su catálogo privado en una cuenta. Una vez publicado el producto, los usuarios de la cuenta que tienen acceso al catálogo privado. El grupo de recursos que lo contiene puede crear una instancia y empezar a utilizarla.
ibmcloud catalog offering publish account [--catalog CATALOG][--offering OFFERING]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING
- El nombre o el ID del producto.
ibmcloud catalog offering publish allowlist
Ejecute el mandato siguiente para publicar un producto de su catálogo privado en un conjunto de cuentas permitidas. Una vez publicado el producto, los usuarios de las cuentas permitidas pueden crear una instancia y empezar a utilizarla.
ibmcloud catalog offering publish allowlist [--catalog CATALOG][--offering OFFERING][--account-ids ACCOUNT-IDS]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING
- El nombre o el ID del producto.
- --account-ids ACCOUNT-IDS
- El IDS de cuenta.
ibmcloud catalog offering publish enterprise
Ejecute el mandato siguiente para publicar un producto en una empresa. Una vez publicado el producto, los usuarios de la empresa pueden crear una instancia del producto.
ibmcloud catalog offering publish enterprise [--catalog CATALOG][--offering OFFERING]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING
- El nombre o el ID del producto.
ibmcloud catalog offering suspend-offering
Ejecute el mandato siguiente para suspender un producto del catálogo. Puedes suspenderlo por un corto periodo de tiempo sin borrarlo ni dejarlo en desuso de forma permanente. La suspensión de un producto puede resultar útil si, por ejemplo, descubre en el producto un error o una vulnerabilidad que se deban investigar antes de que más clientes lo instalen.
ibmcloud catalog offering suspend-offering [--catalog CATALOG][--offering OFFERING]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING
- El nombre o el ID del producto.
ibmcloud catalog offering version suspend-version
Ejecute el mandato siguiente para suspender una versión de un producto del catálogo. Puede suspender la versión durante un breve periodo de tiempo sin suprimirla ni dejarla en desuso de forma permanente.
ibmcloud catalog offering version suspend-version [--version-locator VERSION_NUMBER]
Opciones de comando
- --version-locator VERSION_NUMBER
- Para obtener el localizador de versiones de esta oferta, ejecute el mandato
ibmcloud catalog offering listy localice la versión que desea utilizar.
ibmcloud catalog offering workspaces
Ejecute el mandato siguiente para obtener los espacios de trabajo de Schematics para una versión del producto.
ibmcloud catalog offering workspaces [--version-locator VERSION_NUMBER] [output FORMAT]
Opciones de comando
- --version-locator VERSION_NUMBER
- Para obtener el localizador de versiones de esta oferta, ejecute el mandato
ibmcloud catalog offering listy localice la versión especificada que desea utilizar. - --output FORMAT (opcional)
- Especifica el formato de salida. Por defecto es compatible con terminal y la única alternativa soportada es JSON. Por ejemplo,
--output json.
ibmcloud catalog install
Ejecute el mandato siguiente para instalar una versión de software del catálogo de IBM Cloud.
ibmcloud catalog install [--version-locator VERSION_NUMBER] [--cluster CLUSTER_ID] [--namespace NAME] [--override-values VALUES] [--timeout TIMEOUT] [--wait WAIT] [--workspace-name NAME] [--workspace-tags TAGS] [--workspace-tf-version VERSION] [--workspace-region REGION] [--workspace-rg-id ID] [schematics-delete VALUE]
Opciones de comando
- --version-locator VERSION_NUMBER
- Para obtener el localizador de versiones de esta oferta, ejecute el mandato
ibmcloud catalog offering listy localice la versión que desea utilizar. - --cluster CLUSTER_ID
- Especifique el ID o nombre de clúster.
- --namespace NAME
- Especifique el espacio de nombres que desea utilizar.
- -- override-values VALUES
- Proporcione una configuración personalizada para la instalación. Puede proporcionar este valor en línea o utilizando un archivo JSON o TXT. Por ejemplo,
override-values values.json. - -- timeout TIMEOUT
- Especifique en segundos cuánto tiempo espera el espacio de trabajo de Schematics antes de que se instale. El valor predeterminado es
180. - -- wait WAIT
- Espere y realice un seguimiento del progreso del trabajo del espacio de trabajo de Schematics. Si es
true, la instalación espera. Si esfalse, el software se instala inmediatamente. El valor predeterminado estrue. - --workspace-name NAME (opcional)
- Especifique un nombre de espacio de trabajo. El valor predeterminado es
OfferingName-Date. - --workspace-tags TAGS (opcional)
- Proporcione una lista de etiquetas separadas por comas.
- --workspace-tf-version VERSION (opcional)
- Proporcione una versión de terraform de espacio de trabajo.
- --workspace-region REGION (opcional)
- Proporcione una región de espacio de trabajo.
- --workspace-rg-id ID (opcional)
- Proporcione un ID de grupo de recursos de espacio de trabajo.
- -- schematics-delete VALUE (opcional)
- Proporcione este distintivo para suprimir el espacio de trabajo de Schematics después de la validación y la instalación.
Ejemplo
Instala la versión de software 1 utilizando cluster A, namespace install, y los valores de anulación JSON values.json.
ibmcloud catalog install [--version-locator 1] [--cluster A] [--namespace install] [--override-values values.json]
Sobrescriba el formato de ejemplo de valores del archivo values.json:
{
"username": "install-test-1",
"password": "passw0rd"
}
precios de catálogo de ibmcloud
Ejecute el mandato siguiente para obtener información de precios para las ofertas de catálogo.
ibmcloud catalog pricing [-r, --region REGION] [-k, --kind KIND] [-p, --price PRICE] [--tag TAG] [--country COUNTRY] [--global] [--iam] [--json] [--csv] [-f, --file FILENAME]
Opciones de comando
- -r, --region (opcional)
- Filtrar por zona geográfica.
- -k, --kind (opcional)
- Filtrar por tipo de recursos. Actualmente se admiten
service(por defecto),iaas,runtime,template, ygeography - -p, --price (opcional)
- Filtrar por precio. Actualmente se admiten
free,paygo, ysubscription - -t, --tag (opcional)
- Filtrar por etiqueta. Este distintivo es repetible y da como resultado un OR lógico de todas las etiquetas especificadas.
- --co, --country (opcional)
- Filtrar por país. La salida a CSV o JSON puede utilizar el valor
ALLpara obtener los valores de todos los países. - --json (opcional)
- Emite una respuesta JSON.
- --csv (opcional)
- Genera un archivo CSV.
- -f, --file (opcional)
- Especifique un nombre de archivo para la salida csv.
- --global (opcional)
- Operar en ámbito global.
- --iam (opcional)
- Filtrar por ofertas compatibles con Iam.
Ejemplo
Obtenga información de precios para Virtual Server for VPC para una cuenta de pago según uso.
ibmcloud catalog pricing is.instance [--price paygo]
catálogo ibmcloud regiones de punto final privado
Ejecute el siguiente comando para recuperar la lista de regiones que admiten puntos finales privados para un servicio especificado.
ibmcloud catalog private-endpoint regions [--service ID]
Opciones de comando
- --service
- Proporcione el ID o el nombre programático del servicio para ver sus regiones que admiten el punto final privado
catálogo ibmcloud servicios de punto final privado
Ejecute el siguiente comando para recuperar la lista de servicios que admiten puntos finales privados para una región especificada.
ibmcloud catalog private-endpoint services [--region REGION]
Opciones de comando
- --region o -r
- Indique la REGIÓN para ver qué servicios admiten terminales privados en esa región
programa de utilidad de catálogo ibmcloud create-product-from-workspace
Ejecute el mandato siguiente para crear un mosaico de arquitectura desplegable desde un espacio de trabajo deSchematics que se ha creado directamente desde el repositorio Git. La arquitectura desplegable crea un proyecto para que puedas seguir desarrollando y manteniendo la arquitectura desplegable con la versión futura.
El mandato requiere una variable de entorno GIT_TOKEN para autenticarse con el repositorio de origen para que se pueda añadir un manifiesto de catálogo. El mandato envía a una rama nueva en el repositorio Git que se encuentra en
el espacio de trabajo Schematics y crea un release que se utiliza para la incorporación.
ibmcloud catalog utility create-product-from-workspace [--workspace-id ID] [--api-key KEY] [--trusted-profile-id ID] [--catalog-label LABEL] [--offering-label LABEL] [--project-name NAME] [--project-resource-group GROUP] [--target-version VERSION] [--variation-label LABEL]
Opciones de comando
- --api-key o --ak API KEY
- Proporcione una clave API que se utiliza para vincular el catálogo y el proyecto. Mutuamente excluyente con '--trusted-profile-id'.
- --catalog-label ETIQUETA DE CATÁLOGO (opcional)
- Proporcione la etiqueta de un catálogo existente a importar o el nombre de un catálogo nuevo a crear. El valor predeterminado es "DA migrados".
- --offering-label ETIQUETA DE OFERTA (opcional)
- Proporcione la etiqueta de una oferta existente a la que importar o el nombre de una nueva oferta a crear. El valor predeterminado es "Espacio de trabajo migrado". La etiqueta sobrescribe la etiqueta de oferta existente si el espacio de trabajo se crea a partir de una oferta de catálogo.
- --project-name NOMBRE (opcional)
- Proporcione un nombre de proyecto vinculado al catálogo embarcado. Si el proyecto no existe, se crea. El nombre por defecto es "Proyecto de migración de desarrollo".
- --project-resource-group (opcional)
- Proporcionar un grupo de recursos para el proyecto que se crea. El grupo de recursos por defecto es "Por defecto".
- --target-version VERSION (opcional)
- Proporcione la versión de destino para la oferta migrada. El valor predeterminado es '1.0.0'.
- --trusted-profile-id o --tpi ID DE PERFIL CONFIABLE
- Proporcione un ID de perfil de confianza que se utilice para vincular el catálogo y el proyecto. Exclusivo mutuo con '--api-key'.
- --variation-label ETIQUETA DE VARIACIÓN (opcional)
- Proporcione una etiqueta de variación para la versión que se va a incorporar. El valor predeterminado es "Estándar". La etiqueta sobrescribe la etiqueta de versión existente si el espacio de trabajo se crea a partir de una oferta de catálogo.
- --workspace-id IDENTIFICACIÓN DEL ESPACIO DE TRABAJO
- Proporcione un ID de espacio de trabajo Schematics. Para obtener el ID de espacio de trabajo, debe crear el espacio de trabajo Schematics. Para obtener más información, consulte
ibmcloud schematics workspace new.
ibmcloud catalog utility netrc
Ejecute el mandato siguiente para crear un archivo .netrc, generar el nombre de la máquina en el archivo .netrc o actualizar la credencial en el archivo .netrc. Un archivo .netrc almacena la
información de inicio de sesión necesaria para utilizar los módulos Terraform del catálogo de IBM Cloud.
Ejecutando este comando, configuras un archivo .netrc para el nombre de máquina cm.globalcatalog.cloud.ibm.com con iamtoken como nombre de usuario y tu token IAM como contraseña.
Necesita la versión 1.2.7 o superior del plug-in de la CLI de gestión de catálogos para ejecutar el mandato .netrc.
ibmcloud catalog utility netrc
ibmcloud catalog utility update-module-references
Ejecute el mandato siguiente para comprobar los módulos Terraform del directorio de trabajo para obtener actualizaciones del catálogo y actualizar el atributo de origen a la última versión. El archivo README.md también se actualiza.
ibmcloud catalog utility update-module-references
ibmcloud catalog offering unpublish account
Ejecute el mandato siguiente para anular la publicación de un producto de la cuenta. Una vez que se ha anulado la publicación del producto, los usuarios de la cuenta no pueden crear una instancia del producto.
ibmcloud catalog offering unpublish account [--catalog CATALOG][--offering OFFERING]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING
- El nombre o el ID del producto.
ibmcloud catalog offering unpublish allowlist
Ejecute el mandato siguiente para eliminar los ID de la cuenta de la lista de productos permitidos. Las cuentas que se eliminan de la lista de elementos permitidos no pueden crear una instancia del producto.
ibmcloud catalog offering unpublish allowlist [--catalog CATALOG][--offering OFFERING][--account-ids ACCOUNT-IDS]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING
- El nombre o el ID del producto.
- --account-ids ACCOUNT-IDS
- El IDS de cuenta.
ibmcloud catalog offering unpublish enterprise
Ejecute el mandato siguiente para anular la publicación de un producto de una empresa. Una vez que se ha anulado la publicación del producto, la empresa no puede crear una instancia del producto.
ibmcloud catalog offering unpublish enterprise [--catalog CATALOG][--offering OFFERING]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING
- El nombre o el ID del producto.
ibmcloud catálogo oferta despublicar ibm
Ejecute el siguiente comando para despublicar un producto de IBM. Una vez despublicado el producto, los empleados de IBM no pueden crear una instancia del producto.
ibmcloud catalog offering unpublish ibm [--catalog CATALOG][--offering OFFERING]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING
- El nombre o el ID del producto.
catálogo ibmcloud oferta publicar ibm
Ejecute el siguiente comando para publicar una oferta que ya esté disponible en su cuenta a todos los usuarios de IBM. Esta parte del proceso de publicación crea un mosaico en los catálogos de preparación y producción que sólo es visible para los usuarios de IBM. Al publicar una oferta en IBM ers, puede probar la oferta en producción antes de ponerla a disposición de todos los usuarios en el catálogo IBM Cloud.
ibmcloud catalog offering publish ibm [--catalog CATALOG][--offering OFFERING]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING
- El nombre o el ID del producto.
ibmcloud catalog offering publish public
Ejecute el siguiente mandato para publicar su oferta privada en el catálogo de IBM Cloud para que todos los usuarios la puedan ver y utilizar. Para utilizar este paso en el proceso de publicación, primero debe publicar la oferta en su cuenta y para todos los empleados de IBM para completar el proceso de prueba. Una vez finalizada la prueba, puede ejecutar este mandato.
Esta opción requiere aprobación. Cuando se haya completado su aprobación, su azulejo estará disponible para todos los clientes de IBM Cloud.
ibmcloud catalog offering publish public [--catalog CATALOG][--offering OFFERING]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING
- El nombre o el ID del producto.
ibmcloud catalog offering deprecate-offering
Ejecute el siguiente mandato para dejar en desuso una versión de la oferta publicada anteriormente en el catálogo de IBM Cloud.
ibmcloud catalog offering deprecate-offering [--catalog CATALOG][--offering OFFERING]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING
- El nombre o el ID del producto.
ibmcloud catalog offering restore-offering
Ejecute el mandato siguiente para restaurar un producto en desuso anteriormente en el catálogo de IBM Cloud. Después de validar una versión del producto, puede restaurarla al estado publicado en el que estaba antes de que estuviera en desuso.
ibmcloud catalog offering restore-offering [--catalog CATALOG][--offering OFFERING]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING
- El nombre o el ID del producto.
ibmcloud catalog offering version restore-version
Ejecute el mandato siguiente para restaurar una versión previamente en desuso de un producto en el catálogo de IBM Cloud. Restaurarla coloca la versión en estado borrador. Después de validarla, puede restaurar la versión original al estado publicado en que estaba antes de estar en desuso.
ibmcloud catalog offering version restore-version [--catalog CATALOG][--offering OFFERING] [--include-config]
Opciones de comando
- --catalog CATALOG
- El nombre o el ID del catálogo.
- --offering OFFERING
- El nombre o el ID del producto.
- --include-config (opcional)
- Si se especifica, se incluirán todos los valores de configuración y estarán disponibles cuando añada el producto.
ibmcloud catalog object create vpe
Ejecute el siguiente comando para añadir un objeto a un catálogo privado de la cuenta.
ibmcloud catalog object create vpe [--catalog CATALOG] [--crn CRN] [endpoint-type TYPE] [--fqdn FQDN] [--name NAME] [--region REGION]
Opciones de comando
- --catalog CATALOG
- Especifique el nombre o el ID del catálogo.
- --crn CRN
- Indique el nombre del recurso en nube (CRN).
- --endpoint-type TIPO
- Especifique el tipo de punto final VPE.
- --fqdn FQDN
- Proporcione una lista separada por comas de nombres de dominio completos.
- --name NAME
- Especifique el nombre del objeto.
- --region REGION
- Especifique la región para el punto final de VPE.
ibmcloud catalog object delete
Ejecute el siguiente comando para eliminar el objeto.
ibmcloud catalog object delete [--catalog CATALOG] [--name NAME]
Opciones de comando
- --catalog CATALOG
- Especifique el nombre o el ID del catálogo.
- --name NAME
- Indique el nombre del objeto.
ibmcloud catalog object update vpe
Ejecute el siguiente comando para actualizar el objeto.
ibmcloud catalog object update vpe [--catalog CATALOG] [--name NAME] [--crn CRN] [--endpoint-type TYPE] [--fqdn FQDN] [--region REGION]
Opciones de comando
- --catalog CATALOG
- Especifique el nombre o el ID del catálogo.
- --name NAME
- Especifique el nombre del objeto.
- --crn CRN (opcional)
- Indique el nombre del recurso en nube (CRN).
- --endpoint-type TYPE (opcional)
- Especifique el tipo de punto final VPE.
- --fqdn FQDN (opcional)
- Proporcione una lista separada por comas de nombres de dominio completos.
- --region REGION (opcional)
- Especifique la región para el punto final de VPE.
ibmcloud catalog object get
Ejecute el mandato siguiente para recuperar información para un objeto determinado.
ibmcloud catalog object get [--catalog CATALOG] [--name NAME] [--output OUTPUT]
Opciones de comando
- --catalog CATALOG
- Especifique el nombre o el ID del catálogo.
- --name NAME
- Indique el nombre del objeto.
- --output SALIDA (opcional)
- Especifica el formato de salida. Por defecto es compatible con terminal y la única alternativa soportada es JSON. Por ejemplo,
--output json
lista de objetos del catálogo ibmcloud
Ejecute el mandato siguiente para recuperar una lista de objetos de un catálogo.
ibmcloud catalog object list [--catalog CATALOG] [--output OUTPUT]
Opciones de comando
- --catalog CATALOG
- Especifique el nombre o el ID del catálogo.
- --output SALIDA (opcional)
- Especifica el formato de salida. Por defecto es compatible con terminal y la única alternativa soportada es JSON. Por ejemplo,
--output json
búsqueda de objetos de catálogo ibmcloud
Ejecute el mandato siguiente para buscar objetos utilizando la sintaxis de consulta Lucene.
ibmcloud catalog object search [--query QUERY] [--output OUTPUT]
Opciones de comando
- --query CONSULTA
- Proporcione la serie de consulta Lucene.
- --output SALIDA (opcional)
- Especifica el formato de salida. Por defecto es compatible con terminal y la única alternativa soportada es JSON. Por ejemplo,
--output json
ibmcloud catalog object ready
Ejecute el siguiente comando para marcar su objeto como listo para compartir o publicar.
ibmcloud catalog object ready [--catalog CATALOG] [--name NAME]
Opciones de comando
- --catalog CATALOG
- Especifique el nombre o el ID del catálogo.
- --name NAME
- Especifique el nombre del objeto.
ibmcloud catalog object publish
Ejecute el mandato siguiente para publicar el objeto en una lista de acceso, su cuenta, IBM employees, o el catálogo IBM Cloud para que todos los usuarios lo vean y lo utilicen.
ibmcloud catalog object publish COMMAND [--catalog CATALOG] [--name NAME]
Opciones de comando
- Mandato
- Especifique dónde desea publicar el objeto. Los valores válidos son
accesslist,account,ibmopublic. - --catalog CATALOG
- Especifique el nombre o el ID del catálogo.
- --name NAME
- Indique el nombre del objeto.
Ejemplo
Publique un objeto denominado dev-object que esté en el catálogo dev-catalog en los empleados de IBM.
ibmcloud catalog object publish ibm --catalog dev-catalog --name dev-object
ibmcloud catalog object access-list add
Ejecute el mandato siguiente para añadir los ID de cuenta a la lista de acceso de un objeto.
ibmcloud catalog object access-list add [--account-id ID] [--catalog CATALOG] [--name NAME]
Opciones de comando
- --account-id ID
- Proporcione una lista de ID de cuenta separados por comas.
- --catalog CATALOG
- Especifique el nombre o el ID del catálogo.
- --name NAME
- Especifique el nombre del objeto.
ibmcloud catalog object access-list get
Ejecute el mandato siguiente para recuperar información para una lista de acceso determinada para un objeto.
ibmcloud catalog object access-list get [--catalog CATALOG] [--name NAME] [--output OUTPUT]
Opciones de comando
- --catalog CATALOG
- Especifique el nombre o el ID del catálogo.
- --name NAME
- Especifique el nombre del objeto.
- --output SALIDA (opcional)
- Especifica el formato de salida. Por defecto es compatible con terminal y la única alternativa soportada es JSON. Por ejemplo,
--output json
ibmcloud catalog object access-list rm
Ejecute el siguiente comando para eliminar los ID de cuenta de la lista de acceso del objeto.
ibmcloud catalog object access-list rm [--account-id ID] [--catalog CATALOG] [--name NAME]
Opciones de comando
- --account-id ID
- Proporcione una lista de ID de cuenta separados por comas.
- --catalog CATALOG
- Especifique el nombre o el ID del catálogo.
- --name NAME
- Especifique el nombre del objeto.