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 login para 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_source o preset_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_source o preset_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_source o preset_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_source o preset_configuration.
--approval-state VALOR
Proporcione el estado de aprobación. Las opciones son approved, pending o rejected.
--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 -entgrp para 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_source o preset_configuration.
--approval-state VALOR
Proporcione el estado de aprobación. Las opciones son approved, pending o rejected.
--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 -entgrp para 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 son services y software.
--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 json y csv.
--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 regions para 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, created y updated.
--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 true y false. 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-options para ver todas las opciones. El valor predeterminado es Developer 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 options para 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 options para 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 options para 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 options para 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 options para 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 options para 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 options para 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 true y false. 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 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 list y 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 list y 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 list y 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 es false, el software se instala inmediatamente. El valor predeterminado es true.
--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 list y 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-options para ver todas las opciones. El valor predeterminado es Developer 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 list y 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 list y 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 list y 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 es false, 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 list y 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 list y 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 list y 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 list y 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 list y 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 list y 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 list y localice el producto especificado o la versión que desea utilizar.

ibmcloud catalog offering enable-sharing

Ejecute el mandato siguiente para permitir que se comparta el producto.

ibmcloud catalog offering enable-sharing --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 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 list y 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 list y 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 list y 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 list y 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 es false, el software se instala inmediatamente. El valor predeterminado es true.
--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, y geography
-p, --price (opcional)
Filtrar por precio. Actualmente se admiten free, paygo, y subscription
-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 ALL para 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 enable-sharing

Ejecute el mandato siguiente para habilitar el uso compartido de un objeto gestionado de Partner Center. Active el uso compartido antes de poder compartir un objeto con una cuenta o lista de acceso.

ibmcloud catalog object enable-sharing [--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, ibm o public.
--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.