Plug-in d'interface de ligne de commande de gestion des catalogues

L'interface de ligne de commande (CLI) pour la gestion des catalogues IBM Cloud® offre des possibilités supplémentaires pour travailler avec les produits du catalogue IBM Cloud et des catalogues privés de votre compte. Vous pouvez utiliser ce plug-in d'interface CLI pour gérer vos catalogues privés, intégrer des produits logiciels privés et gérer la visibilité des catalogues entre le catalogue public et vos catalogues privés.

Avant de commencer

  • Installez l'interface de ligne de commande IBM Cloud. Pour plus d'informations, voir Initiation à l'interface de ligne de commande IBM Cloud. Le préfixe pour l'exécution de commandes via l'interface CLI d'IBM Cloud est ibmcloud.
  • Avant d'exécuter les commandes de registre, connectez-vous à IBM Cloud en utilisant la commande ibmcloud login pour générer un jeton d'accès et authentifier votre session.

Installation du plug-in de gestion des catalogues

Pour installer le plug-in de gestion des catalogues, exécutez la commande suivante :

ibmcloud plugin install catalogs-management

Sur la ligne de commande, vous recevez une notification lorsque des mises à jour du plug-in de l'interface de ligne de commande ibmcloud et de l'interface de ligne de commande catalogs-management sont disponibles. Veillez à conservez votre interface de ligne de commande à jour afin de pouvoir utiliser l'ensemble des commandes et indicateurs disponibles.

Si vous souhaitez afficher la version actuelle de votre plug-in d'interface de ligne de commande catalogs-management, exécutez ibmcloud plugin list.

Pour préserver la confidentialité et la sécurité, n'indiquez pas d'informations personnelles dans les noms ou les descriptions des catalogues.

ibmcloud catalog account add-approbation-access

Exécutez la commande suivante pour ajouter un accès d'approbation à votre compte de catalogue.

ibmcloud catalog account add-approval-access [--account-ids IDS] [--object-kind KIND]

Options de commande

--object-kind VALEUR
Indiquez le type d'objet. Les options sont offering, vpe, proxy_source ou preset_configuration.
--account-ids VALEUR
Fournissez une liste d'identifiants de compte séparés par des virgules et préfixés par l'un des éléments suivants. -acct- pour les comptes ordinaires, -ent- pour les comptes d'entreprise et -entgrp- pour les groupes de comptes d'entreprise.

ibmcloud catalog account delete-approbation-access

Exécutez la commande suivante pour supprimer l'accès d'approbation à votre compte de catalogue.

ibmcloud catalog account delete-approval-access [--account-ids IDS] [--object-kind KIND]

Options de commande

--object-kind VALEUR
Indiquez le type d'objet. Les options sont offering, vpe, proxy_source ou preset_configuration.
--account-ids VALEUR
Fournissez une liste d'identifiants de compte séparés par des virgules et préfixés par l'un des éléments suivants. -acct- pour les comptes ordinaires, -ent- pour les comptes d'entreprise et -entgrp- pour les groupes de comptes d'entreprise.

ibmcloud catalog account get-approbation-list

Exécutez la commande suivante pour obtenir une liste d'approbation pour votre compte catalogue.

ibmcloud catalog account get-approval-list [--object-kind KIND]

Options de commande

--object-kind VALEUR
Indiquez le type d'objet. Les options sont offering, vpe, proxy_source ou preset_configuration.

ibmcloud catalog account get-approbation-list-source

Exécutez la commande suivante pour obtenir tous les comptes cible pointant vers une source.

ibmcloud catalog account get-approval-list-source [--approval-state STATE] [--enterprise-id ID] [--object-kind KIND]

Options de commande

--object-kind VALEUR
Indiquez le type d'objet. Les options sont offering, vpe, proxy_source ou preset_configuration.
--approval-state VALEUR
Indiquez l'état d'approbation. Les options sont approved, pending ou rejected.
--enterprise-id VALUE (optionnel)
Indiquez un ID d'entreprise ou de groupe de comptes d'entreprise pour afficher ou gérer les demandes de l'entreprise. Préfixez l'ID avec -ent- pour une entreprise et -entgrp pour un groupe de comptes.

ibmcloud catalog account set-approbation-state-source

Exécutez la commande suivante pour définir l'état d'approbation des comptes cibles qui pointent vers une source.

ibmcloud catalog account set-approval-state-source [--account-ids IDS] [--approval-state STATE] [--enterprise-id ID] [--object-kind KIND]

Options de commande

--object-kind VALEUR
Indiquez le type d'objet. Les options sont offering, vpe, proxy_source ou preset_configuration.
--approval-state VALEUR
Indiquez l'état d'approbation. Les options sont approved, pending ou rejected.
--account-ids VALEUR
Fournissez une liste d'ID de comptes séparés par des virgules et préfixés par l'un des éléments suivants : -acct- pour les comptes ordinaires, -ent- pour les comptes d'entreprise et -entgrp- pour les groupes de comptes d'entreprise.
--enterprise-id VALUE (optionnel)
Indiquez un ID d'entreprise ou de groupe de comptes d'entreprise pour afficher ou gérer les demandes de l'entreprise. Préfixez l'ID avec -ent- pour une entreprise et -entgrp pour un groupe de comptes.

ibmcloud catalog create

Cette commande permet de créer un nouveau catalogue privé dans votre compte. Un catalogue privé permet d'organiser un ensemble de produits, les produits privés que vous ajoutez ou des références à des produits du catalogue IBM Cloud. Un utilisateur doit avoir accès à votre catalogue privé via une règle d'accès IAM et au groupe de ressources contenant votre catalogue privé pour afficher et utiliser les produits.

Cibler un groupe de ressources pour créer un catalogue parce que le catalogue existe dans le contexte d'un groupe de ressources particulier. Pour obtenir la liste des groupes de ressources, vous pouvez exécuter la commande ibmcloud resource groups, puis la commande ibmcloud target -g "resource group".

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

Options de commande

--name CATALOG
Nom du catalogue.
--catalog-description DESCRIPTION (facultatif)
Brève description du nouveau catalogue.

Exemple

Créer un catalogue appelé dev-catalog avec la description 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

Exécutez la commande suivante pour extraire la liste des catalogues de ce compte spécifique.

ibmcloud catalog list [--output FORMAT]

Options de commande

--output FORMAT (facultatif)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple, --output json.

Sortie

La commande génère la sortie suivante :

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

Exécutez la commande suivante pour extraire les informations correspondant à un catalogue spécifique du compte.

ibmcloud catalog get --catalog CATALOG [--output FORMAT]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--output FORMAT (facultatif)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple, --output json.

Sortie

La commande génère la sortie suivante :

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

Exécutez la commande suivante pour supprimer un catalogue spécifique dans le compte.

ibmcloud catalog delete --catalog CATALOG

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.

ibmcloud catalog search

Exécutez la commande suivante pour rechercher des produits publiés dans le catalogue public, notamment des services et des logiciels.

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]

Options de commande

--type TYPE (facultatif)
Optionnel. La valeur par défaut est services. Les options valides sont services et software.
--catalog CATALOG (facultatif)
Rechercher les logiciels publiés par votre compte. Spécifier le nom ou l'ID du catalogue dans lequel rechercher.
--output FORMAT (facultatif)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et les seules options alternatives sont json et csv.
--kind KIND (facultatif)
L'indicateur n'est valable que pour les services de recherche. Fournissez une liste de types de produit séparés par des virgules.
--region REGION (facultatif)
L'indicateur n'est valable que pour les services de recherche. Fournissez une liste de régions séparées par des virgules. Exécutez ibmcloud cs regions pour renvoyer une liste valide.
--price PRICE (facultatif)
L'indicateur n'est valable que pour les services de recherche. Fournissez une liste de types de tarification séparés par des virgules.
--tag TAG (facultatif)
L'indicateur n'est valable que pour les services de recherche. Fournissez une liste d'étiquettes séparées par des virgules.
--global (facultatif)
L'indicateur n'est valable que pour les services de recherche. Utilisez-le pour opérer à l'échelle mondiale.
--sort-by TYPE (facultatif)
L'indicateur n'est valable que pour les services de recherche et sert à ordonner les résultats de la recherche. Les options disponibles sont name, displayname, kind, provider, created et updated.
--reverse (facultatif)
L'indicateur n'est valable que pour les services de recherche. Utilisez-le pour inverser l'ordre de tri.
--fields FIELDS (facultatif)
L'indicateur n'est valable que pour les services de recherche. Personnalisez la table. Par exemple, --fields name,kind,metadata.service.iam_compatible.

Sortie

La commande génère la sortie suivante :

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

Exécutez la commande suivante pour extraire les détails du filtre pour le compte ou un catalogue spécifique.

ibmcloud catalog filter get --catalog CATALOG [--output FORMAT]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--account-group ACCOUNT GROUP
Nom ou ID du groupe de comptes. Cette zone s'applique uniquement aux comptes d'entreprise.
--output FORMAT (facultatif)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple, --output json.

Sortie

La commande génère la sortie suivante :

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

Exécutez la commande suivante pour créer un filtre. Si un filtre existe, cette commande remplace le filtre en cours.

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]

Options de commande

--catalog CATALOG (facultatif)
Spécifier le nom ou l'ID du catalogue. Si cette option n'est pas spécifiée, le filtre est créé au niveau du compte.
--account-group ACCOUNT GROUP
Nom ou ID du groupe de comptes. Uniquement applicable aux comptes d'entreprise.
--hide-ibm-catalog (facultatif)
Par défaut, le catalogue est visible pour tous les utilisateurs de ce compte. En ajoutant cet indicateur, vous pouvez rendre les produits disponibles uniquement pour les utilisateurs de votre choix en désactivant la visibilité du catalogue IBM Cloud et en ajoutant les produits à vos catalogues privés.
--include-all BOOLEAN (facultatif)
La valeur par défaut est true si l'indicateur n'est pas fourni. Les valeurs valides sont true et false. Si la valeur est true, le filtre inclut par défaut la totalité du catalogue public et les filtres suivants sont exclus. Si la valeur est false, le filtre exclut la totalité du catalogue public, et les indicateurs suivants sont inclus. Pour plus d'informations, voir Gestion des paramètres de catalogue.

--offering-format FORMAT (facultatif)

--category CATEGORY (facultatif)
Indiquez la catégorie qui correspond le mieux à la façon dont les utilisateurs peuvent utiliser votre produit. Les catégories sont utilisées pour organiser les produits du catalogue selon qu'ils partagent des solutions, des fonctions ou une utilisation communes. Vous ne pouvez sélectionner qu'une seule catégorie. Exécutez la commande ibmcloud catalog offering category-options pour afficher toutes les options. La valeur par défaut est Developer tools.
--compliance TYPE (facultatif)
Indiquez une liste de catégories de conformité, séparées par des virgules, que vous souhaitez inclure ou exclure. Exécutez la commande ibmcloud catalog filter options pour afficher toutes les options.
--deployment-target TARGET (facultatif)
Indiquez une liste de cibles de déploiement, séparées par des virgules, que vous souhaitez inclure ou exclure. Exécutez la commande ibmcloud catalog filter options pour afficher toutes les options.
--exclude-list LIST (facultatif)
Spécifiez une liste d'ID ou de noms de produits séparés par des virgules à exclure du catalogue public filtré.
--include-list LIST (facultatif)
Spécifiez une liste d'ID ou de noms de produits séparés par des virgules à inclure du catalogue public filtré.
Indiquez une liste de formats de produit, séparés par des virgules, que vous souhaitez inclure ou exclure. Exécutez la commande ibmcloud catalog filter options pour afficher toutes les options.
--pricing-plan PLAN (options)
Indiquez une liste de plans de tarification, séparés par des virgules, que vous souhaitez inclure ou exclure. Exécutez la commande ibmcloud catalog filter options pour afficher toutes les options.
--provider PROVIDER (facultatif)
Indiquez une liste de fournisseurs, séparés par des virgules, que vous souhaitez inclure ou exclure. Exécutez la commande ibmcloud catalog filter options pour afficher toutes les options.
--release RELEASE (facultatif)
Indiquez une liste de catégories, séparées par des virgules, que vous souhaitez inclure ou exclure. Exécutez la commande ibmcloud catalog filter options pour afficher toutes les options.
--type TYPE (facultatif)
Indiquez une liste de types de logiciel, séparés par des virgules, que vous souhaitez inclure ou exclure. Exécutez la commande ibmcloud catalog filter options pour afficher toutes les options.

ibmcloud catalogue filtre supprimer

Exécutez la commande suivante pour supprimer un filtre appliqué. Ce filtre rétablit par défaut le niveau du compte, sauf si un catalogue est spécifié. Le filtre est donc réinitialisé pour inclure tous les produits dans le catalogue public.

ibmcloud catalog filter delete --catalog CATALOG

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--account-group ACCOUNT GROUP
Nom ou ID du groupe de comptes. Uniquement applicable aux comptes d'entreprise.

ibmcloud catalog filter offering

Mettez à jour le filtre pour inclure ou exclure un produit particulier et tous les plans de tarification applicables. Ce filtre rétablit par défaut le niveau du compte, sauf si un catalogue ou un groupe de comptes est spécifié.

ibmcloud catalog filter offering --offering PRODUCT-NAME

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--account-group ACCOUNT GROUP
Nom ou ID du groupe de comptes. Uniquement applicable aux comptes d'entreprise.
--plans-list PLANS LIST
Liste d'ID ou de noms de plan séparés par des virgules à inclure ou exclure.
--offering OFFERING
Nom ou ID du produit.
--include
La valeur par défaut est true si aucun indicateur n'est fourni. Les valeurs valides sont true et false. Si la valeur est true, le produit et les plans fournis sont visibles par les utilisateurs du compte. Si la valeur est false, le produit et les plans ne sont pas visibles par les utilisateurs du compte.

ibmcloud catalog filter hide-ibm-public-catalog

Par défaut, le catalogue IBM Cloud est visible par tous les utilisateurs du compte. Vous pouvez rendre les produits disponibles uniquement pour les utilisateurs de votre choix en désactivant la visibilité du catalogue IBM Cloud et en ajoutant les produits à vos catalogues privés.

ibmcloud catalog filter hide-ibm-public-catalog

ibmcloud catalog filter show-ibm-public-catalog

Par défaut, le catalogue IBM Cloud est visible par tous les utilisateurs du compte. Vous pouvez rendre les produits disponibles uniquement pour les utilisateurs de votre choix en désactivant la visibilité du catalogue IBM Cloud et en ajoutant les produits à vos catalogues privés.

ibmcloud catalog filter show-ibm-public-catalog

ibmcloud catalogue filtre options

Exécutez la commande suivante pour extraire les options de filtre pour chaque catégorie de filtre.

ibmcloud catalog filter options

Options de commande

--all
Inclut le secteur d'activité, le type de solution et le plan de tarification dans la liste des filtres.
--output FORMAT (facultatif)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple, --output json.

Sortie

La commande génère la sortie suivante :

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

Exécutez la commande suivante pour ajouter un produit à un catalogue privé dans le compte.

ibmcloud catalog offering create [--catalog CATALOG_NAME] [--zipurl URL] [--include-config] [--target-version VERSION] [--token TOKEN] [--vpc-body BODY]

Options de commande

--catalog CATALOG_NAME
Nom ou ID du catalogue.
- --zipurl URL (facultatif)
URL désignant le fichier .zip du produit.
--target-version VERSION
Indiquez la version du produit.
--include-config (facultatif)
Si cette option est spécifiée, toutes les valeurs de configuration sont incluses et disponibles lorsque vous ajoutez le produit.
--token TOKEN (optional)
Indiquez le jeton d'accès personnel pour un référentiel privé.
--vpc-body BODY (optionnel)
Fournissez les informations permettant d'importer une image de serveur virtuel pour VPC, y compris un nom, un libellé, un type d'installation, un type de cible, une version, un sha, des balises et des métadonnées.

Exemple d'image de serveur virtuel pour VPC #1

Importez une image de serveur virtuel pour VPC en tant qu'offre dans un catalogue avec l'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"}]
    }
}'

Exemple d'image de serveur virtuel pour VPC #2

Importez une image de serveur virtuel pour VPC en tant qu'offre dans un catalogue avec l'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

Exécutez la commande suivante pour obtenir les détails des produits de vos catalogues privés. Cette commande permet de filtrer en fonction de la version, du produit et du catalogue privé.

ibmcloud catalog offering list [--catalog CATALOG] [--offering OFFERING_NAME] [--version VERSION] [--output FORMAT]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--output FORMAT (facultatif)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON, par exemple, --output json.

Exemple

Répertoriez tous les produits du catalogue dev-catalog.

ibmcloud catalog offering list --catalog dev-catalog

Sortie

La commande génère la sortie suivante :

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

Exécutez la commande suivante pour obtenir les détails relatifs à un produit spécifique du catalogue.

ibmcloud catalog offering get --catalog CATALOG --offering OFFERING_NAME [--output FORMAT]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING_NAME
Nom ou ID du produit.
--output FORMAT (facultatif)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON, par exemple, --output json.

Sortie

La commande génère la sortie suivante :

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

Exécutez la commande suivante pour importer une nouvelle version d'un produit dans votre catalogue privé.

ibmcloud catalog offering import-version --catalog CATALOG --offering OFFERING_NAME [--zipurl URL] [--target-version APP_VERSION] [--include-config] [--vpc-body BODY]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING_NAME
: Nom ou ID du produit.
- --zipurl URL (facultatif)
Le site URL qui pointe vers le fichier.zip du produit.
--target-version APP_VERSION (facultatif)
Version d'application de l'élément "tgz" importé.
--include-config (facultatif)
Si cette option est indiquée, toutes les valeurs de configuration sont incluses et disponibles lorsque vous importez la nouvelle version.
--vpc-body BODY (optionnel)
Fournissez les informations permettant d'importer une image de serveur virtuel pour VPC, y compris un nom, un libellé, un type d'installation, un type de cible, une version, un sha, des balises et des métadonnées.

Image de serveur virtuel pour VPC Exemple

Importer une image de serveur virtuel pour VPC dans une offre existante avec dans un catalogue avec ID 51c9e0db-2911-45a6-adb0-ac5332d27cf2 et ID d'offre 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

Pour mettre à jour un produit dans votre catalogue privé, vous devez d'abord obtenir le produit, puis vous pouvez le mettre à jour.

Exécutez la commande offering get. Pour plus d'informations, voir l'offre de catalogue ibmcloud get.

ibmcloud catalog offering get -c <CATALOGID> -o <OFFERINGID> --output json

Exécutez la commande offering update.

ibmcloud catalog offering update -c <CATALOGID> -o <OFFERINGID> --updated-offering <UPDATED_OFFERING.json>

ibmcloud catalog offering version preinstall

Exécutez la commande suivante pour exécuter le script de préinstallation pour un produit spécifique.

ibmcloud catalog offering version preinstall --version-locator VERSION_NUMBER --cluster CLUSTER_ID --namespace NAME

Options de commande

--version-locator VERSION_NUMBER
Pour obtenir le releveur de coordonnées de version de ce produit, exécutez la commande ibmcloud catalog offering list et recherchez le produit et la version spécifiés que vous souhaitez utiliser.
--cluster CLUSTER_ID
Spécifiez l'ID de cluster dans lequel vous souhaitez installer le produit.
--namespace NAME
Indiquez l'espace de nom que vous souhaitez utiliser. Si vous en indiquez un nouveau, il est automatiquement créé lors de la préinstallation.

Exemple

Exécutez le script de préinstallation d'un produit avec un numéro de releveur de coordonnées de version b636d651-8489-4425-bd6a-f30af1603577.18aad484-c78b-4269-808b-52027621abd4 dans l'espace de nom bn5ebho206o7fg45f2e0 du cluster ayant l'ID 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

Exécutez la commande suivante pour obtenir le statut d'une préinstallation en cours.

ibmcloud catalog offering version preinstall-status --version-locator VERSION_NUMBER --cluster CLUSTER_ID --namespace NAME [--output FORMAT]

Options de commande

--version-locator VERSION_NUMBER
Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande ibmcloud catalog offering list et recherchez le produit et la version spécifiés que vous souhaitez utiliser.
--cluster CLUSTER_ID
Indiquez l'ID de cluster dans lequel la préinstallation a été exécutée.
--namespace NAME
Indiquez l'espace de nom utilisé pour la préinstallation.
--output FORMAT (facultatif)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON, par exemple, --output json.

ibmcloud catalog offering version validate

Exécutez la commande suivante pour valider une nouvelle version d'un produit dans votre catalogue privé. Il est nécessaire de valider les produits afin qu'ils puissent fonctionner comme cela a été prévu avant de pouvoir être publiés dans le compte pour que d'autres utilisateurs créent une instance à partir du catalogue privé.

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]

Options de commande

--version-locator VERSION_NUMBER
Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande ibmcloud catalog offering list et recherchez le produit et la version spécifiés que vous souhaitez utiliser.
--cluster CLUSTER_ID
Spécifiez l'ID de cluster dans lequel vous souhaitez installer le produit.
--namespace NAME
Indiquez l'espace de nom que vous souhaitez utiliser. Si vous en indiquez un nouveau, il est automatiquement créé lors de la préinstallation.
--timeout TIMEOUT
Indiquez, en secondes, le délai d'attente d'installation pour l'espace de travail Schematics. La valeur par défaut est 180.
--wait WAIT
Attendez et suivez la progression du travail de l'espace de travail Schematics. Si la valeur est true, l'installation attend. Si la valeur est false, le logiciel s'installe immédiatement. La valeur par défaut est true.
--override-values VALUES|FILENAME (facultatif)
Indiquez des configurations personnalisées pour l'installation. Vous pouvez spécifier cette valeur en ligne ou en utilisant un fichier JSON ou TXT. Par exemple, override-values values.json. Lors de la validation d'une image de serveur virtuel pour VPC, les zones suivantes doivent être fournies: vsi_instance_name, vsi_id, vpc_profile, subnet_id, vpc_id, subnet_zone, ssh_key_id, vpc_region
--workspace-tf-version VERSION (facultatif)
Indiquer une version terraform de l'espace de travail.
-- workspace-region REGION (facultatif)
Indiquer une région d'espace de travail.
--workspace-rg-id ID (facultatif)
Indiquez un ID groupe de ressources de l'espace de travail.
-- schematics-destroy (facultatif)
Indiquez ce drapeau pour supprimer les ressources de l'espace de travail après la validation et l'installation.
-- schematics-delete VALUE (facultatif)
Indiquez cet indicateur pour supprimer l'espace de travail Schematics après validation et installation.

Exemple de validation d'un produit utilisant un cluster

Validez un produit avec le releveur de coordonnées de version b636d651-8489-4425-bd6a-f30af1603577.18aad484-c78b-4269-808b-52027621abd4 dans un espace de nom bn5ebho206o7fg45f2e0 d'un cluster ayant l'ID test-namespace. Cette installation inclut des configurations personnalisées. Les valeurs sont donc fournies en utilisant un fichier 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

Remplacer le format exemple des valeurs dans le fichier values.json :

{
  "username": "provision-test-1",
  "password": "passw0rd"
}

Image de serveur virtuel pour VPC Exemple

Validez un produit avec le localisateur de version 51c9e0db-2911-45a6-adb0-ac5332d27cf2.ecebffdc-f1f8-4a85-965f-9cbe31920542 dans un VPC avec l'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

Exécutez la commande suivante pour obtenir le statut d'une validation en cours.

ibmcloud catalog offering version validate-status --version-locator VERSION_NUMBER [--output FORMAT]

Options de commande

--version-locator VERSION_NUMBER
Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande ibmcloud catalog offering list et recherchez le produit ou la version spécifié à utiliser.
--output FORMAT (facultatif)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON, par exemple, --output json.

ibmcloud catalog offering category-options

Exécutez la commande suivante pour extraire la liste des choix de catégorie.

ibmcloud catalog offering category-options [--output FORMAT]

Options de commande

--output FORMAT (facultatif)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON, par exemple, --output json.

Exemple

ibmcloud catalog offering category-options

Sortie

La commande génère la sortie suivante :

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

Exécutez la commande suivante pour ajouter une balise de catégorie à un produit. Vous pouvez indiquer le nom de la catégorie, que vous trouverez en exécutant la commande ibmcloud catalog offering category-options. Pour pouvoir être visibles dans le catalogue, les produits doivent être placés dans une catégorie. La valeur par défaut est Developer tools.

ibmcloud catalog offering category-options [--output FORMAT]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.
--category CATEGORY
Indiquez la catégorie qui correspond le mieux à la façon dont les utilisateurs peuvent utiliser votre produit. Les catégories sont utilisées pour organiser les produits du catalogue selon qu'ils partagent des solutions, des fonctions ou une utilisation communes. Vous ne pouvez sélectionner qu'une seule catégorie. Exécutez la commande ibmcloud catalog offering category-options pour afficher toutes les options. La valeur par défaut est Developer tools.

Exemple

ibmcloud catalog offering add-category --catalog dev-catalog --offering dev-offering --category dev_ops

catégories d'offre de catalogue ibmcloud

Exécutez la commande suivante pour extraire la catégorie d'une version de produit.

ibmcloud catalog offering version categories [--catalog CATALOG] [--offering OFFERING] [--output OUTPUT]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.
--output FORMAT (facultatif)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple, --output json.

Exemple

Extrayez la catégorie d'un produit appelé dev-offering et situé dans dev-catalog.

ibmcloud catalog offering version categories --catalog dev-catalog --offering dev-offering

ibmcloud catalog offering version get-claims

Exécutez la commande suivante pour extraire les informations de sécurité et de conformité réclamées par une version.

  ibmcloud catalog offering version get-claims [--output OUTPUT] [--version-locator LOCATOR]

Options de commande

--version-locator LOCATEUR
Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande ibmcloud catalog offering list et recherchez le produit ou la version spécifié à utiliser.
--output valeur (optionnelle)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON, par exemple, --output json.

ibmcloud catalog offering version update-claims

Exécutez la commande suivante pour mettre à jour les déclarations de sécurité et de conformité d'une version.

  ibmcloud catalog offering version update-claims [--claims CLAIMS] [--version-locator LOCATOR]

Options de commande

--claims RÉCLAMATIONS
Spécifiez les données de réclamation pour une version en tant qu'objet ou fichier JSON.
--version-locator LOCATEUR
Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande ibmcloud catalog offering list et recherchez le produit ou la version spécifié à utiliser.

ibmcloud catalog offering version scc-apply

Exécutez la commande suivante pour ajouter un examen Security and Compliance Center à votre version. Ajoutez des informations de sécurité et de conformité à votre version et validez votre version avant de pouvoir ajouter une analyse.

  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]

Options de commande

--instance-region RÉGION
La région de l'instance.
--scan SCAN
ID d'une analyse Security and Compliance Center.
--service-instance INSTANCE
Indiquez l'ID d'instance Security and Compliance Center.
--target-account-name NOM (facultatif)
Indiquez le nom du compte cible.
--target-api-key KEY (optionnel)
Indiquez une clé d'API si vous souhaitez utiliser un autre compte (compte cible) pour appliquer un examen à votre compte source. Pour plus d'informations, voir Configuration d'un compte cible.
--timeout TIMEOUT
Indiquez, en secondes, la durée pendant laquelle vous souhaitez attendre que l'analyse soit appliquée à la version avant le retour de la commande. La valeur par défaut est 600 (10 minutes).
--version-locator LOCATEUR
Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande ibmcloud catalog offering list et recherchez le produit ou la version spécifié à utiliser.
--wait WAIT
Attendez et suivez la progression d'une application d'examen. La valeur par défaut est true si l'indicateur n'est pas fourni. Si true, la commande suit la progression de l'application d'analyse. Si la valeur est false, la commande est renvoyée immédiatement.

ibmcloud catalog offering version scc-apply-status

Exécutez la commande suivante pour afficher le statut d'une application d'analyse Security and Compliance Center sur votre version.

  ibmcloud catalog offering version scc-apply-status [--scan SCAN] [--version-locator LOCATOR]

Options de commande

--scan SCAN
ID d'une analyse Security and Compliance Center.
--version-locator LOCATEUR
Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande ibmcloud catalog offering list et recherchez le produit ou la version spécifié à utiliser.

ibmcloud catalog offering version get-scans

Exécutez la commande suivante pour extraire les analyses Security and Compliance Center ajoutées à votre version.

  ibmcloud catalog offering version get-scans [--instance-region REGION] [--output OUTPUT] [--profiles PROFILES] [--service-instance INSTANCE] [--target-account-name NAME] [--target-api-key KEY]

Options de commande

--instance-region RÉGION
Indiquer la région de l'instance.
--output OUTPUT (optionnel)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple, --output json.
--profiles PROFILS
Fournissez une liste séparée par des virgules de noms de profil avec des versions, par exemple, "IBM Cloud for Financial Services::1.2.0".
--service-instance INSTANCE
Indiquez l'ID d'instance Security and Compliance Center.
--target-account-name NOM (facultatif)
Indiquez le nom du compte cible.
--target-api-key KEY (optionnel)
Indiquez une clé d'API si vous souhaitez utiliser un autre compte (compte cible) pour appliquer un examen à votre compte source. Pour plus d'informations, voir Configuration d'un compte cible.

ibmcloud catalog offering get-scan-results

Exécutez la commande suivante pour générer un rapport sur les résultats de l'analyse du Code Risk Analyzer et du Security and Compliance Center votre version. Pour générer un rapport complet, vous devez exécuter les analyses du Code Risk Analyzer et du Security and Compliance Center

ibmcloud catalog offering get-scan-results [--version-locator LOCATOR]

Options de commande

--version-locator LOCATEUR
Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande ibmcloud catalog offering list et recherchez le produit ou la version spécifié à utiliser.

ibmcloud catalog offering version create-draft

Exécutez la commande suivante pour créer un brouillon d'une version existante. Cette commande est utile lorsque vous voulez modifier une version existante que vous souhaitez publier sans créer de nouvelle version. Pour certaines modifications, comme le changement de fichier source, vous devez valider le produit à nouveau.

ibmcloud catalog offering version create-draft --version-locator VERSION_NUMBER [--output FORMAT]

Options de commande

--version-locator VERSION_NUMBER
Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande ibmcloud catalog offering list et recherchez le produit ou la version spécifié à utiliser.
--output FORMAT (facultatif)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple, --output json.

ibmcloud catalog offering version delete-version

Exécutez la commande suivante pour supprimer une version d'un produit.

ibmcloud catalog offering version delete-version --version-locator VERSION_NUMBER [--output FORMAT]

Options de commande

--version-locator VERSION_NUMBER
Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande ibmcloud catalog offering list et recherchez le produit ou la version spécifié à utiliser.
--output FORMAT (facultatif)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple, --output json.

ibmcloud catalog offering version deprecate-version

Exécutez la commande suivante pour déprécier dans le catalogue IBM Cloud une version de produit précédemment publiée.

ibmcloud catalog offering version deprecate-version --version-locator VERSION_NUMBER

Options de commande

--version-locator VERSION_NUMBER
Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande ibmcloud catalog offering list et recherchez le produit ou la version spécifié à utiliser.

ibmcloud catalog offering version refresh-version

Exécutez la commande suivante pour créer une modification dans le fichier source d'une version préliminaire. Cette commande est utile pour la mise à jour d'une version existante.

ibmcloud catalog offering version refresh-version --version-locator VERSION_NUMBER --zipurl URL [--include-config]

Options de commande

--version-locator VERSION_NUMBER
Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande ibmcloud catalog offering list et recherchez le produit ou la version spécifié à utiliser.
--zipurl URL
Le site URL qui pointe vers le fichier compressé du produit.
--include-config (facultatif)
Si cette option est spécifiée, toutes les valeurs de configuration sont incluses et disponibles lorsque vous ajoutez le produit.

ibmcloud catalog offering version merge-draft

Exécutez la commande suivante pour fusionner une version brouillon d'un produit.

ibmcloud catalog offering version merge-draft --version-locator VERSION_NUMBER

Options de commande

--version-locator VERSION_NUMBER
Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande ibmcloud catalog offering list et recherchez le produit ou la version spécifié à utiliser.

ibmcloud catalog offering enable-sharing

Exécutez la commande suivante pour permettre le partage de votre produit.

ibmcloud catalog offering enable-sharing --catalog CATALOG --offering OFFERING

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.

ibmcloud catalog offering ready

Exécutez la commande suivante pour marquer votre produit comme prêt pour partage ou publication.

ibmcloud catalog offering ready --version-locator VERSION_NUMBER

Options de commande

--version-locator VERSION_NUMBER
Pour obtenir le releveur de coordonnées de version du produit, exécutez la commande ibmcloud catalog offering list et recherchez le produit ou la version spécifié à utiliser.

ibmcloud catalog offering delete

Exécutez la commande suivante pour supprimer un produit de votre catalogue privé. Vous ne pouvez pas supprimer un produit publié dans le catalogue IBM Cloud. Pour déprécier un produit publié dans le catalogue IBM Cloud, voir ibmcloud catalog offering deprecate-offering.

ibmcloud catalog offering delete --catalog CATALOG --offering OFFERING

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.

ibmcloud catalog offering publish account

Exécutez la commande suivante pour publier un produit de votre catalogue privé sur un compte. Une fois le produit publié, les utilisateurs du compte ont accès au catalogue privé. Le groupe de ressources qui le contient peut créer une instance et commencer à l'utiliser.

ibmcloud catalog offering publish account [--catalog CATALOG][--offering OFFERING]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.

ibmcloud catalog offering publish allowlist

Exécutez la commande suivante pour publier un produit de votre catalogue privé sur un ensemble de comptes figurant dans une liste autorisée. Une fois le produit publié, les utilisateurs des comptes autorisés peuvent créer une instance et commencer à l'utiliser.

ibmcloud catalog offering publish allowlist [--catalog CATALOG][--offering OFFERING][--account-ids ACCOUNT-IDS]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.
--account-ids ACCOUNT-IDS
Les ID de compte.

ibmcloud catalog offering publish enterprise

Exécutez la commande suivante pour publier un produit dans une entreprise. Une fois le produit publié, les utilisateurs de l'entreprise peuvent créer une instance du produit.

ibmcloud catalog offering publish enterprise [--catalog CATALOG][--offering OFFERING]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.

ibmcloud catalog offering suspend-offering

Exécutez la commande suivante pour suspendre un produit du catalogue. Vous pouvez le suspendre pour une courte période sans le supprimer définitivement ni le déprécier. La suspension d'un produit peut s'avérer utile, par exemple lorsque vous identifiez dans votre produit un bogue ou une vulnérabilité devant être examiné avant de permettre à davantage d'utilisateurs de l'installer.

ibmcloud catalog offering suspend-offering [--catalog CATALOG][--offering OFFERING]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.

ibmcloud catalog offering version suspend-version

Exécutez la commande suivante pour suspendre une version d'un produit du catalogue. Vous pouvez suspendre la version pendant une courte période sans la supprimer définitivement ni la déprécier.

ibmcloud catalog offering version suspend-version [--version-locator VERSION_NUMBER]

Options de commande

--version-locator VERSION_NUMBER
Pour obtenir le releveur de coordonnées de version pour cette offre, exécutez ibmcloud catalog offering list et recherchez la version que vous souhaitez utiliser.

ibmcloud catalog offering workspaces

Exécutez la commande suivante pour obtenir les espaces de travail Schematics pour une version de produit.

ibmcloud catalog offering workspaces [--version-locator VERSION_NUMBER] [output FORMAT]

Options de commande

--version-locator VERSION_NUMBER
Pour obtenir le releveur de coordonnées de version pour cette offre, exécutez ibmcloud catalog offering list et recherchez la version spécifiée que vous souhaitez utiliser.
--output FORMAT (facultatif)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Par exemple, --output json.

ibmcloud catalog install

Exécutez la commande suivante pour installer une version de logiciel à partir du catalogue 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]

Options de commande

--version-locator VERSION_NUMBER
Pour obtenir le releveur de coordonnées de version pour cette offre, exécutez ibmcloud catalog offering list et recherchez la version que vous souhaitez utiliser.
--cluster CLUSTER_ID
Spécifier le nom ou l'ID du cluster.
--namespace NAME
Indiquez l'espace de nom que vous souhaitez utiliser.
--override-values VALUES
Indiquez des configurations personnalisées pour l'installation. Vous pouvez spécifier cette valeur en ligne ou en utilisant un fichier JSON ou TXT. Par exemple, override-values values.json.
--timeout TIMEOUT
Indiquez, en secondes, le délai d'attente d'installation pour l'espace de travail Schematics. La valeur par défaut est 180.
--wait WAIT
Attendez et suivez la progression du travail de l'espace de travail Schematics. Si la valeur est true, l'installation attend. Si la valeur est false, le logiciel s'installe immédiatement. La valeur par défaut est true.
--workspace-name NAME (facultatif)
Fournissez un nom d'espace de travail. La valeur par défaut est OfferingName-Date.
--workspace-tags TAGS (facultatif)
Fournissez une liste d'étiquettes séparées par des virgules.
--workspace-tf-version VERSION (facultatif)
Indiquer une version terraform de l'espace de travail.
-- workspace-region REGION (facultatif)
Indiquer une région d'espace de travail.
--workspace-rg-id ID (facultatif)
Indiquez un ID groupe de ressources de l'espace de travail.
-- schematics-delete VALUE (facultatif)
Indiquez cet indicateur pour supprimer l'espace de travail Schematics après validation et installation.

Exemple

Installez la version 1 du logiciel en utilisant cluster A, namespace install, et les valeurs de remplacement JSON values.json.

ibmcloud catalog install [--version-locator 1] [--cluster A] [--namespace install] [--override-values values.json]

Remplacer le format exemple des valeurs dans le fichier values.json :

{
  "username": "install-test-1",
  "password": "passw0rd"
}

tarification du catalogue ibmcloud

Exécutez la commande suivante pour obtenir des informations de tarification pour les offres de catalogue.

ibmcloud catalog pricing [-r, --region REGION] [-k, --kind KIND] [-p, --price PRICE] [--tag TAG] [--country COUNTRY] [--global] [--iam] [--json] [--csv] [-f, --file FILENAME]

Options de commande

-r --region (facultatif)
Filtrer par zone géographique.
-k, --kind (facultatif)
Filtrer par type de ressource. Actuellement, service (par défaut), iaas, runtime, template, et geography sont pris en charge
-p, --price (facultatif)
Filtrer par prix. Actuellement, les sites free, paygo et subscription sont pris en charge
-t, --tag (facultatif)
Filtrer par étiquette. Cet indicateur est répétable et produit un OU logique de toutes les étiquettes spécifiées.
--co, --country (facultatif)
Filtrer par pays. La sortie vers CSV ou JSON peut utiliser la valeur ALL pour obtenir les valeurs pour tous les pays.
--json (facultatif)
Produire une réponse JSON.
--csv (optionnel)
Produit un fichier CSV.
-f --file (facultatif)
Spécifiez un nom de fichier pour la sortie csv.
--global (facultatif)
Opérer dans une portée globale.
--iam (facultatif)
Filtrer par offres compatibles avec IAM.

Exemple

Obtenez des informations de tarification pour Virtual Server for VPC pour un compte de type Paiement à la carte.

ibmcloud catalog pricing is.instance [--price paygo]

ibmcloud catalog private-endpoint regions

Exécutez la commande suivante pour obtenir la liste des régions qui prennent en charge les points d'extrémité privés pour un service donné.

ibmcloud catalog private-endpoint regions [--service ID]

Options de commande

--service
Fournir l'ID ou le nom programmatique du service pour voir ses régions qui supportent le point de terminaison privé

ibmcloud catalog private-endpoint services

Exécutez la commande suivante pour récupérer la liste des services qui prennent en charge les points d'extrémité privés pour une région donnée.

ibmcloud catalog private-endpoint services [--region REGION]

Options de commande

--region ou -r
Indiquez la RÉGION pour connaître les services qui prennent en charge les points d'extrémité privés dans cette région

Utilitaire de catalogue ibmcloud create-product-from-workspace

Exécutez la commande suivante pour créer une vignette d'architecture déployable à partir d'un espace de travailSchematics créé directement à partir du référentiel Git. L'architecture déployable crée un projet afin que vous puissiez continuer à développer et à maintenir l'architecture déployable avec la future version.

La commande requiert une variable d'environnement GIT_TOKEN pour s'authentifier auprès de votre référentiel source afin qu'un manifeste de catalogue puisse être ajouté. La commande est envoyée à une nouvelle branche dans le référentiel Git qui se trouve dans l'espace de travail Schematics et crée une édition utilisée pour l'intégration.

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]

Options de commande

--api-key ou --ak API KEY
Fournir une clé API utilisée pour lier le catalogue et le projet. Exclusif avec '--trusted-profile-id'.
--catalog-label CATALOGUE LABEL (optionnel)
Indiquez le libellé d'un catalogue existant dans lequel effectuer l'importation ou le nom d'un nouveau catalogue à créer. La valeur par défaut est "Migrated DAs".
--offering-label ÉTIQUETTE DE L'OFFRE (facultatif)
Indiquez le libellé d'une offre existante dans laquelle effectuer l'importation ou le nom d'une nouvelle offre à créer. La valeur par défaut est "Migrated <workspace_name>". L'étiquette remplace l'étiquette de l'offre existante si l'espace de travail est créé à partir d'une offre de catalogue.
--project-name NOM (facultatif)
Fournir un nom de projet lié au catalogue embarqué. Si le projet n'existe pas, il est créé. Le nom par défaut est "Dev Migration Project".
--project-resource-group (facultatif)
Fournir un groupe de ressources pour le projet créé. Le groupe de ressources par défaut est "Default".
--target-version VERSION (optionnel)
Indiquez la version cible de l'offre migrée. La valeur par défaut est '1.0.0'.
--trusted-profile-id ou --tpi TRUSTED PROFILE ID
Fournir un identifiant de profil de confiance utilisé pour lier le catalogue et le projet. Exclusivité mutuelle avec '--api-key'.
--variation-label VARIATION LABEL (optionnel)
Indiquez un libellé de variante pour la version à intégrer. La valeur par défaut est "Standard". Le libellé remplace le libellé de version existant si l'espace de travail est créé à partir d'une offre de catalogue.
--workspace-id ID DE L'ESPACE DE TRAVAIL
Indiquez un ID d'espace de travail Schematics. Pour obtenir l'ID de l'espace de travail, vous devez créer l'espace de travail Schematics. Pour plus d'informations, voir ibmcloud schematics workspace new.

ibmcloud catalog utility netrc

Exécutez la commande suivante pour créer un fichier .netrc, générer le nom de machine dans votre fichier .netrc ou mettre à jour les données d'identification dans votre fichier .netrc. Un fichier .netrc stocke les informations de connexion requises pour utiliser des modules Terraform depuis le catalogue IBM Cloud.

En exécutant cette commande, vous configurez un fichier .netrc pour le nom de machine cm.globalcatalog.cloud.ibm.com avec iamtoken comme nom d'utilisateur et votre jeton IAM comme mot de passe.

Vous avez besoin de la version 1.2.7 ou supérieure du plug-in de l'interface CLI de gestion de catalogues pour exécuter la commande .netrc.

ibmcloud catalog utility netrc

ibmcloud catalog utility update-module-references

Exécutez la commande suivante pour rechercher dans le catalogue des mises à jour pour les modules Terraform de votre répertoire de travail et mettre à jour l'attribut source vers la version la plus récente. Le fichier README.md est également mis à jour.

ibmcloud catalog utility update-module-references

ibmcloud catalog offering unpublish account

Exécutez la commande suivante pour annuler la publication d'un produit dans votre compte. Une fois la publication du produit annulée, les utilisateurs de votre compte ne peuvent plus créer d'instance du produit.

ibmcloud catalog offering unpublish account [--catalog CATALOG][--offering OFFERING]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.

ibmcloud catalog offering unpublish allowlist

Exécutez la commande suivante pour retirer des ID de compte de la liste autorisée du produit. Les comptes retirés de la liste autorisée ne peuvent pas créer d'instance du produit.

ibmcloud catalog offering unpublish allowlist [--catalog CATALOG][--offering OFFERING][--account-ids ACCOUNT-IDS]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.
--account-ids ACCOUNT-IDS
Les ID de compte.

ibmcloud catalog offering unpublish enterprise

Exécutez la commande suivante pour annuler la publication d'un produit dans une entreprise. Une fois la publication du produit annulée, l'entreprise ne peut plus créer d'instance du produit.

ibmcloud catalog offering unpublish enterprise [--catalog CATALOG][--offering OFFERING]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.

ibmcloud catalog offering unpublish ibm

Exécutez la commande suivante pour dépublier un produit à partir de IBM. Une fois le produit dépublié, les employés de IBM ne peuvent plus créer d'instance du produit.

ibmcloud catalog offering unpublish ibm [--catalog CATALOG][--offering OFFERING]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.

ibmcloud catalogue offre publier ibm

Exécutez la commande suivante pour publier une offre qui est déjà disponible dans votre compte à tous les utilisateurs de IBM. Cette partie du processus de publication crée une tuile dans les catalogues de préparation et de production qui n'est visible que par les utilisateurs de IBM. En publiant une offre sur IBM ers, vous pouvez tester l'offre en production avant de la mettre à la disposition de tous les utilisateurs dans le catalogue IBM Cloud.

ibmcloud catalog offering publish ibm [--catalog CATALOG][--offering OFFERING]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.

ibmcloud catalog offering publish public

Exécutez la commande suivante pour publier votre offre privée dans le catalogue IBM Cloud afin que tous les utilisateurs puissent la voir et l'utiliser. Pour accéder à cette étape dans le processus de publication, vous devez tout d'abord publier l'offre dans votre compte à destination de tous les collaborateurs IBM afin de terminer le processus de test. Une fois le test terminé, vous pouvez exécuter cette commande.

Cette option requiert une approbation. Une fois l'approbation obtenue, votre carreau est disponible pour tous les clients de IBM Cloud.

ibmcloud catalog offering publish public [--catalog CATALOG][--offering OFFERING]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.

ibmcloud catalog offering deprecate-offering

Exécutez la commande suivante pour déprécier une version d'offre précédemment publiée dans le catalogue IBM Cloud.

ibmcloud catalog offering deprecate-offering [--catalog CATALOG][--offering OFFERING]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.

ibmcloud catalog offering restore-offering

Exécutez la commande suivante pour restaurer un produit précédemment déprécié dans le catalogue IBM Cloud. Une fois que vous avez validé une version de votre produit, vous pouvez le restaurer à l'état publié dans lequel il était avant d'être déprécié.

ibmcloud catalog offering restore-offering [--catalog CATALOG][--offering OFFERING]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.

ibmcloud catalog offering version restore-version

Exécutez la commande suivante pour restaurer dans le catalogue IBM Cloud une version obsolète d'un produit. Le fait de le restaurer place la version dans un état de brouillon. Après l'avoir validée, vous pouvez restaurer la version d'origine à son état publié avant sa dépréciation.

ibmcloud catalog offering version restore-version [--catalog CATALOG][--offering OFFERING] [--include-config]

Options de commande

--catalog CATALOG
Nom ou ID du catalogue.
--offering OFFERING
Nom ou ID du produit.
--include-config (facultatif)
Si cette option est spécifiée, toutes les valeurs de configuration sont incluses et disponibles lorsque vous ajoutez le produit.

ibmcloud catalog object create vpe

Exécutez la commande suivante pour ajouter un objet à un catalogue privé dans le compte.

ibmcloud catalog object create vpe [--catalog CATALOG] [--crn CRN] [endpoint-type TYPE] [--fqdn FQDN] [--name NAME] [--region REGION]

Options de commande

--catalog CATALOG
Spécifier le nom ou l'ID du catalogue.
--crn CRN
Indiquez le nom de la ressource cloud (CRN).
--endpoint-type TYPE
Indiquez le type de noeud final VPE.
--fqdn FQDN
Fournir une liste de noms de domaine entièrement qualifiés, séparés par des virgules.
--name NAME
Indiquez le nom de l'objet.
--region REGION
Indiquez la région pour le noeud final VPE.

Suppression de l'objet de catalogue ibmcloud

Exécutez la commande suivante pour supprimer l'objet.

ibmcloud catalog object delete [--catalog CATALOG] [--name NAME]

Options de commande

--catalog CATALOG
Spécifier le nom ou l'ID du catalogue.
--name NAME
Indiquer le nom de l'objet.

ibmcloud catalog object update vpe

Exécutez la commande suivante pour mettre à jour l'objet.

ibmcloud catalog object update vpe [--catalog CATALOG] [--name NAME] [--crn CRN] [--endpoint-type TYPE] [--fqdn FQDN] [--region REGION]

Options de commande

--catalog CATALOG
Spécifier le nom ou l'ID du catalogue.
--name NAME
Indiquez le nom de l'objet.
--crn CRN (facultatif)
Indiquez le nom de la ressource cloud (CRN).
--endpoint-type TYPE (facultatif)
Indiquez le type de noeud final VPE.
--fqdn FQDN (optionnel)
Fournir une liste de noms de domaine entièrement qualifiés, séparés par des virgules.
--region REGION (facultatif)
Indiquez la région pour le noeud final VPE.

Obtention de l'objet de catalogue ibmcloud

Exécutez la commande suivante pour extraire des informations pour un objet particulier.

ibmcloud catalog object get [--catalog CATALOG] [--name NAME] [--output OUTPUT]

Options de commande

--catalog CATALOG
Spécifier le nom ou l'ID du catalogue.
--name NAME
Indiquer le nom de l'objet.
--output OUTPUT (optionnel)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Exemple: --output json

Liste d'objets de catalogue ibmcloud

Exécutez la commande suivante pour extraire une liste d'objets d'un catalogue.

ibmcloud catalog object list [--catalog CATALOG] [--output OUTPUT]

Options de commande

--catalog CATALOG
Spécifier le nom ou l'ID du catalogue.
--output OUTPUT (optionnel)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Exemple: --output json

recherche d'objet de catalogue ibmcloud

Exécutez la commande suivante pour rechercher des objets à l'aide de la syntaxe de requête Lucene.

ibmcloud catalog object search [--query QUERY] [--output OUTPUT]

Options de commande

--query REQUÊTE
Indiquez la chaîne de requête Lucene.
--output OUTPUT (optionnel)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Exemple: --output json

Objet de catalogue ibmcloud prêt

Exécutez la commande suivante pour marquer votre objet comme étant prêt à être partagé ou publié.

ibmcloud catalog object ready [--catalog CATALOG] [--name NAME]

Options de commande

--catalog CATALOG
Spécifier le nom ou l'ID du catalogue.
--name NAME
Indiquez le nom de l'objet.

objet du catalogue ibmcloud enable-sharing

Exécutez la commande suivante pour activer le partage d'un objet géré Partner Center. Activez le partage avant de pouvoir partager un objet avec un compte ou une liste d'accès.

ibmcloud catalog object enable-sharing [--catalog CATALOG] [--name NAME]

Options de commande

--catalog CATALOG
Spécifier le nom ou l'ID du catalogue.
--name NAME
Indiquez le nom de l'objet.

Publication de l'objet de catalogue ibmcloud

Exécutez la commande suivante pour publier l'objet dans une liste d'accès, dans votre compte IBM employés ou dans le catalogue IBM Cloud pour tous les utilisateurs.

ibmcloud catalog object publish COMMAND [--catalog CATALOG] [--name NAME]

Options de commande

Commande
Indiquez où vous souhaitez publier l'objet. Les valeurs valides sont accesslist, account, ibm ou public.
--catalog CATALOG
Spécifier le nom ou l'ID du catalogue.
--name NAME
Indiquer le nom de l'objet.

Exemple

Publiez un objet appelé dev-object qui se trouve dans le catalogue dev-catalog pour les employés de IBM.

ibmcloud catalog object publish ibm --catalog dev-catalog --name dev-object

ibmcloud catalog object access-list add

Exécutez la commande suivante pour ajouter des ID de compte à la liste d'accès d'un objet.

ibmcloud catalog object access-list add [--account-id ID] [--catalog CATALOG] [--name NAME]

Options de commande

--account-id ID
Fournir une liste d'identifiants de comptes séparés par des virgules.
--catalog CATALOG
Spécifier le nom ou l'ID du catalogue.
--name NAME
Indiquez le nom de l'objet.

ibmcloud catalog object access-list get

Exécutez la commande suivante pour extraire des informations relatives à une liste d'accès particulière pour un objet.

ibmcloud catalog object access-list get [--catalog CATALOG] [--name NAME] [--output OUTPUT]

Options de commande

--catalog CATALOG
Spécifier le nom ou l'ID du catalogue.
--name NAME
Indiquez le nom de l'objet.
--output OUTPUT (optionnel)
Spécifie le format de sortie. La valeur par défaut est compatible avec le terminal et la seule alternative supportée est JSON. Exemple: --output json

ibmcloud catalog object access-list rm

Exécutez la commande suivante pour supprimer les identifiants de compte de la liste d'accès de l'objet.

ibmcloud catalog object access-list rm [--account-id ID] [--catalog CATALOG] [--name NAME]

Options de commande

--account-id ID
Fournir une liste d'identifiants de comptes séparés par des virgules.
--catalog CATALOG
Spécifier le nom ou l'ID du catalogue.
--name NAME
Indiquez le nom de l'objet.