Plug-in da CLI de gerenciamento de catálogos

A interface de linha de comando (CLI) de gerenciamento de catálogos IBM Cloud® oferece recursos adicionais para trabalhar com produtos no catálogo IBM Cloud e nos catálogos privados de sua conta. É possível usar este plug-in da CLI para gerenciar seus catálogos privados, integrar produtos de software privado e gerenciar a visibilidade do catálogo entre o catálogo público e seus catálogos privados.

Antes de Iniciar

  • Instale a CLI do IBM Cloud. Para obter mais informações, consulte Introdução à CLI da IBM Cloud. O prefixo para executar comandos usando a CLI do IBM Cloud é ibmcloud.
  • Antes de executar os comandos de registro, efetue login no IBM Cloud com o comando ibmcloud login para gerar um token de acesso e autenticar a sua sessão.

Instalando o plug-in de gerenciamento de catálogos

Para instalar o plug-in de gerenciamento de catálogos, execute o comando a seguir:

ibmcloud plugin install catalogs-management

Na linha de comandos, você é notificado quando as atualizações para a CLI ibmcloud e o plug-in da CLI catalogs-management estão disponíveis. Assegure-se de manter a sua CLI atualizada para que seja possível usar todos os comandos e sinalizações disponíveis.

Se você desejar visualizar a versão atual de seu plug-in da CLI catalogs-management, execute ibmcloud plugin list.

Para manter a privacidade e segurança, não coloque informações pessoais em seus nomes de catálogo ou descrições de catálogo.

ibmcloud catalog account add-approval-access

Execute o comando a seguir para incluir o acesso de aprovação em sua conta do catálogo

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

Opções de comando

--object-kind VALOR
Forneça o tipo de objeto As opções são offering, vpe, proxy_source ou preset_configuration..
--account-ids VALOR
Forneça uma lista separada por vírgulas de IDs de contas prefixadas com uma das seguintes opções. -acct- para contas normais, -ent- para contas corporativas e -entgrp- para grupos de contas corporativas.

ibmcloud catalog account delete-approval-access

Execute o comando a seguir para excluir o acesso de aprovação para a sua conta do catálogo

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

Opções de comando

--object-kind VALOR
Forneça o tipo de objeto As opções são offering, vpe, proxy_source ou preset_configuration..
--account-ids VALOR
Forneça uma lista separada por vírgulas de IDs de contas prefixadas com uma das seguintes opções. -acct- para contas normais, -ent- para contas corporativas e -entgrp- para grupos de contas corporativas.

ibmcloud catalog account get-approval-list

Execute o seguinte comando para obter uma lista de aprovação para sua conta de catálogo.

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

Opções de comando

--object-kind VALOR
Forneça o tipo de objeto As opções são offering, vpe, proxy_source ou preset_configuration..

ibmcloud catalog account get-approval-list-source

Execute o comando a seguir para obter todas as contas de destino apontando para uma origem.

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

Opções de comando

--object-kind VALOR
Forneça o tipo de objeto As opções são offering, vpe, proxy_source ou preset_configuration..
--approval-state VALOR
Forneça o estado de aprovação As opções são approved, pending ou rejected..
--enterprise-id VALUE (opcional)
Forneça um ID do grupo de conta corporativo ou corporativo para visualizar ou gerenciar solicitações para a empresa. Prefixe o ID com -ent- para uma empresa e -entgrp para um grupo de contas.

ibmcloud catalog account set-approval-state-source

Execute o seguinte comando para definir o estado de aprovação das contas de destino que apontam para uma origem.

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

Opções de comando

--object-kind VALOR
Forneça o tipo de objeto As opções são offering, vpe, proxy_source ou preset_configuration..
--approval-state VALOR
Forneça o estado de aprovação As opções são approved, pending ou rejected..
--account-ids VALOR
Forneça uma lista separada por vírgulas de IDs de conta com um dos seguintes prefixos: -acct- para contas normais, -ent- para contas corporativas e -entgrp- para grupos de contas corporativas.
--enterprise-id VALUE (opcional)
Forneça um ID do grupo de conta corporativo ou corporativo para visualizar ou gerenciar solicitações para a empresa. Prefixe o ID com -ent- para uma empresa e -entgrp para um grupo de contas.

ibmcloud catalog create

Use esse comando para criar um novo catálogo privado em sua conta. Um catálogo privado é usado para organizar um conjunto de produtos privados que você inclui ou referências a produtos no catálogo da IBM Cloud. Um usuário deve ter acesso ao seu catálogo privado por meio de uma política de acesso do IAM e do grupo de recursos que contém o seu catálogo privado para visualizar e trabalhar com os produtos.

Direcione um grupo de recursos para criar um catálogo porque o catálogo existe no contexto de um grupo de recursos específico. Para obter a lista de grupos de recursos, é possível executar o comando ibmcloud resource groups e, em seguida, o comando ibmcloud target -g "resource group".

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

Opções de comando

--name CATALOG
O nome do catálogo.
--catalog-description DESCRIPTION (opcional)
Descrição simples para o novo catálogo.

Exemplo

Crie um catálogo chamado dev-catalog com a descrição 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

Execute o comando a seguir para recuperar a lista de catálogos nessa conta específica.

ibmcloud catalog list [--output FORMAT]

Opções de comando

--output FORMAT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa suportada é o JSON. Por exemplo, --output json.

Saída

O comando retorna a saída a seguir:

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

Execute o comando a seguir para recuperar as informações para um catálogo específico na conta.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--output FORMAT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa suportada é o JSON. Por exemplo, --output json.

Saída

O comando retorna a saída a seguir:

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

Execute o comando a seguir para excluir um catálogo específico na conta.

ibmcloud catalog delete --catalog CATALOG

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.

Ibmcloud de procura de catálogo

Execute o comando a seguir para procurar produtos publicados no catálogo público, incluindo serviços e software.

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]

Opções de comando

--type TYPE (opcional)
Opcional. O padrão é services. As opções válidas são services e software.
--catalog CATALOG (opcional)
Procure o software publicado por sua conta. Especifique o nome ou o ID do catálogo pelo qual procurar.
--output FORMAT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e as únicas opções alternativas são json e csv.
--kind KIND (opcional)
O sinalizador só é válido para serviços de pesquisa. Forneça uma lista separada por vírgula de tipos de produtos.
--region REGION (opcional)
O sinalizador só é válido para serviços de pesquisa. Forneça uma lista separada por vírgula de regiões. Execute ibmcloud cs regions para retornar uma lista válida.
--price PRICE (opcional)
O sinalizador só é válido para serviços de pesquisa. Forneça uma lista separada por vírgula de tipos de precificação.
--tag TAG (opcional)
O sinalizador só é válido para serviços de pesquisa. Forneça uma lista separada por vírgula de tags.
--global (opcional)
O sinalizador só é válido para serviços de pesquisa. Use-o para operar em um escopo global.
--sort-by TYPE (opcional)
O sinalizador só é válido para serviços de busca e é usado para ordenar o resultado da busca. As opções disponíveis são name, displayname, kind, provider, created e updated.
--reverse (opcional)
O sinalizador só é válido para serviços de pesquisa. Use-a para reverter a ordem de classificação.
--fields FIELDS (opcional)
O sinalizador só é válido para serviços de pesquisa. Customize a tabela, por exemplo, --fields name,kind,metadata.service.iam_compatible.

Saída

O comando retorna a saída a seguir:

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

Execute o comando a seguir para recuperar os detalhes do filtro para a conta ou para um catálogo específico.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--account-group ACCOUNT GROUP
O nome ou o ID do grupo de contas. Este campo se aplica somente às contas corporativas.
--output FORMAT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa suportada é o JSON. Por exemplo, --output json.

Saída

O comando retorna a saída a seguir:

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

Execute o comando a seguir para criar um novo filtro. Se existir um filtro, este comando substituirá o filtro atual.

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]

Opções de comando

--catalog CATALOG (opcional)
Especifique o nome ou o ID do catálogo. Se não especificado, o filtro será criado no nível de conta.
--account-group ACCOUNT GROUP
O nome ou o ID do grupo de contas. Essa opção é aplicável somente para contas corporativas.
--hide-ibm-catalog (opcional)
Por padrão, o catálogo é visível para todos os usuários nesta conta. Ao fornecer essa sinalização, é possível disponibilizar produtos somente para os usuários que você escolher desativando a visibilidade para o catálogo do IBM Cloud e incluindo os produtos em seus catálogos privados.
--include-all BOOLEAN (opcional)
O padrão é true se o sinalizador não for fornecido. Os valores válidos são true e false. Se configurado como true, o filtro será padronizado para incluir o catálogo público inteiro e os filtros subsequentes serão excluídos. Se configurado como false, o filtro excluirá o catálogo público inteiro e os filtros subsequentes serão incluídos. Para obter mais informações, consulte Gerenciando configurações do catálogo.

--offering-format FORMAT (opcional)

--category CATEGORY (opcional)
Forneça a categoria que melhor se encaixa como os usuários podem usar o seu produto. As categorias são usadas para organizar produtos no catálogo com base em soluções comuns, função ou uso. Você pode selecionar apenas uma categoria. Execute o comando ibmcloud catalog offering category-options para visualizar todas as opções. O padrão é Developer tools.
--compliance TYPE (opcional)
Forneça uma lista separada por vírgula de categorias de conformidade que você deseja incluir ou excluir. Execute o comando ibmcloud catalog filter options para visualizar todas as opções.
--deployment-target TARGET (opcional)
Forneça uma lista separada por vírgula de destinos de implementação que você deseja incluir ou excluir. Execute o comando ibmcloud catalog filter options para visualizar todas as opções.
--exclude-list LIST (opcional)
Forneça uma lista separada por vírgula de IDs ou nomes de produtos que devem ser excluídos no catálogo público filtrado.
--include-list LIST (opcional)
Forneça uma lista separada por vírgula de IDs ou nomes de produtos que devem ser incluídos no catálogo público filtrado.
Forneça uma lista separada por vírgula de formatos de produto que você deseja incluir ou excluir. Execute o comando ibmcloud catalog filter options para visualizar todas as opções.
--pricing-plan PLAN (opções)
Forneça uma lista separada por vírgula de planos de precificação que você deseja incluir ou excluir. Execute o comando ibmcloud catalog filter options para visualizar todas as opções.
--provider PROVIDER (opcional)
Forneça uma lista separada por vírgula de provedores que você deseja incluir ou excluir. Execute o comando ibmcloud catalog filter options para visualizar todas as opções.
--release RELEASE (opcional)
Forneça uma lista separada por vírgula de categorias que você deseja incluir ou excluir. Execute o comando ibmcloud catalog filter options para visualizar todas as opções.
--type TYPE (opcional)
Forneça uma lista separada por vírgula de tipos de software que você deseja incluir ou excluir. Execute o comando ibmcloud catalog filter options para visualizar todas as opções.

ibmcloud catalog filter delete

Execute o comando a seguir para excluir um filtro aplicado. Esse filtro é padronizado para o nível de conta, a menos que um catálogo seja especificado. Como resultado, o filtro é reconfigurado para incluir todos os produtos no catálogo público.

ibmcloud catalog filter delete --catalog CATALOG

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--account-group ACCOUNT GROUP
O nome ou o ID do grupo de contas. Essa opção é aplicável somente para contas corporativas.

ibmcloud catalog filter offering

Atualize o filtro para incluir ou excluir um produto específico e quaisquer planos de precificação aplicáveis. Esse filtro é padronizado para o nível de conta, a menos que um grupo de catálogos ou de contas seja especificado.

ibmcloud catalog filter offering --offering PRODUCT-NAME

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--account-group ACCOUNT GROUP
O nome ou o ID do grupo de contas. Essa opção é aplicável somente para contas corporativas.
--plans-list PLANS LIST
Uma lista separada por vírgula de IDs de plano ou nomes para incluir ou excluir.
--offering OFFERING
O nome ou o ID do produto.
--include
O valor padrão será true se uma sinalização não for fornecida. Os valores válidos são true e false. Se configurado como true, o produto e os planos fornecidos estarão visíveis para os usuários na conta. Se definido como falso, o produto e os planos não são visíveis para os usuários na conta.

ibmcloud catalog filter hide-ibm-public-catalog

Por padrão, o catálogo do IBM Cloud está visível para todos os usuários na conta. É possível disponibilizar produtos somente para os usuários que você escolher desativando a visibilidade para o catálogo do IBM Cloud e incluindo os produtos em seus catálogos privados.

ibmcloud catalog filter hide-ibm-public-catalog

ibmcloud catalog filter show-ibm-public-catalog

Por padrão, o catálogo do IBM Cloud está visível para todos os usuários na conta. É possível disponibilizar produtos somente para os usuários que você escolher desativando a visibilidade para o catálogo do IBM Cloud e incluindo os produtos em seus catálogos privados.

ibmcloud catalog filter show-ibm-public-catalog

ibmcloud catalog filter options

Execute o comando a seguir para recuperar as opções de filtro para cada categoria de filtro.

ibmcloud catalog filter options

Opções de comando

--all
Inclui a indústria, o tipo de solução e o plano de precificação na lista de filtros.
--output FORMAT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa suportada é o JSON. Por exemplo, --output json.

Saída

O comando retorna a saída a seguir:

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

Execute o comando a seguir para incluir um produto em um catálogo privado na conta.

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

Opções de comando

--catalog CATALOG_NAME
O nome ou ID do catálogo.
- URL --zipurl (opcional)
URL apontando para o arquivo .zip do produto.
--target-version VERSION
Especifique a versão do produto.
--include-config (opcional)
Se fornecido, todos os valores de configuração serão incluídos e estarão disponíveis quando você incluir o produto.
--token TOKEN (opcional)
Especifique o token de acesso pessoal para um repositório privado.
--vpc-body BODY (opcional)
Forneça as informações para importar uma imagem de servidor virtual para VPC, incluindo um nome, rótulo, tipo de instalação, tipo de destino, versão, sha, tags e metadados.

Imagem do servidor virtual para VPC Exemplo #1

Importe uma imagem de servidor virtual para VPC como uma oferta a um catálogo com 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"}]
    }
}'

Imagem do servidor virtual para VPC Exemplo #2

Importe uma imagem de servidor virtual para VPC como uma oferta a um catálogo com 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

Execute o comando a seguir para obter detalhes sobre os produtos em seus catálogos privados. Este comando fornece um filtro por catálogo privado, produto e versão.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--output FORMAT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa compatível é o JSON, por exemplo, --output json.

Exemplo

Liste todos os produtos que estão no catálogo dev-catalog.

ibmcloud catalog offering list --catalog dev-catalog

Saída

O comando retorna a saída a seguir:

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

Execute o comando a seguir para obter detalhes sobre um produto específico no catálogo.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING_NAME
O nome ou o ID do produto.
--output FORMAT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa compatível é o JSON, por exemplo, --output json.

Saída

O comando retorna a saída a seguir:

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

Execute o comando a seguir para importar uma nova versão de um produto em seu catálogo privado.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING_NAME
: O nome ou o ID do produto.
- URL --zipurl (opcional)
O endereço URL aponta para o arquivo.zip do produto.
--target-version APP_VERSION (opcional)
A versão do aplicativo do "tgz" que está sendo importada.
--include-config (opcional)
Se fornecido, todos os valores de configuração serão incluídos e estarão disponíveis quando você importar a nova versão.
--vpc-body BODY (opcional)
Forneça as informações para importar uma imagem de servidor virtual para VPC, incluindo um nome, rótulo, tipo de instalação, tipo de destino, versão, sha, tags e metadados.

Imagem de servidor virtual para exemplo de VPC

Importe uma imagem de servidor virtual para VPC para uma oferta existente em um catálogo com 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 atualizar um produto em seu catálogo particular, primeiro você precisa obter o produto e, em seguida, pode atualizá-lo.

Execute o comando offering get . Para obter mais informações, consulte o catálogo ibmcloud que oferece get.

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

Execute o comando offering update .

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

ibmcloud catalog offering version preinstall

Execute o comando a seguir para executar o script de pré-instalação para um produto específico.

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

Opções de comando

--version-locator VERSION_NUMBER
Para obter o localizador de versão para esse produto, execute o comando ibmcloud catalog offering list e localize o produto e a versão especificados que você deseja usar.
--cluster CLUSTER_ID
Forneça o ID do cluster no qual você deseja instalar o produto.
--namespace NAME
Forneça o namespace que você gostaria de usar. É possível especificar um novo que é automaticamente criado como parte da pré-instalação.

Exemplo

Execute o script de pré-instalação para um produto com um número localizador de versões de b636d651-8489-4425-bd6a-f30af1603577.18aad484-c78b-4269-808b-52027621abd4 no cluster com o ID bn5ebho206o7fg45f2e0 no namespace 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

Execute o comando a seguir para obter o status de uma pré-instalação em andamento.

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

Opções de comando

--version-locator VERSION_NUMBER
Para obter o localizador de versão do produto, execute o comando ibmcloud catalog offering list e localize o produto e a versão especificados que você gostaria de usar.
--cluster CLUSTER_ID
Forneça o ID do cluster no qual a pré-instalação foi executada.
--namespace NAME
Forneça o namespace usado para a pré-instalação.
--output FORMAT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa compatível é o JSON, por exemplo, --output json.

ibmcloud catalog offering version validate

Execute o comando a seguir para validar uma nova versão de um produto em seu catálogo privado. Os produtos devem ser validados para assegurar que eles funcionem conforme o esperado antes que possam ser publicados na conta para que outros usuários criem uma instância do 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]

Opções de comando

--version-locator VERSION_NUMBER
Para obter o localizador de versão do produto, execute o comando ibmcloud catalog offering list e localize o produto e a versão especificados que você gostaria de usar.
--cluster CLUSTER_ID
Forneça o ID do cluster no qual você deseja instalar o produto.
--namespace NAME
Forneça o namespace que você gostaria de usar. É possível especificar um novo que é automaticamente criado como parte da pré-instalação.
--timeout TIMEOUT
Especifique em segundos quanto tempo a área de trabalho do Schematics aguarda que ele seja instalado. O padrão é 180.
--wait WAIT
Aguarde e rastreie o progresso da tarefa da área de trabalho do Schematics. Se for true, a instalação espera. Se for false, o software será instalado imediatamente. O padrão é true.
--override-values VALUES|FILENAME (opcional)
Forneça qualquer configuração customizada para a instalação. É possível fornecer esse valor sequencial ou usando um arquivo JSON ou TXT. Por exemplo, override-values values.json. Ao validar uma imagem de servidor virtual para VPC, os seguintes campos devem ser fornecidos: vsi_instance_name, vsi_id, vpc_profile, subnet_id, vpc_id, subnet_zone, ssh_key_id, vpc_region
--workspace-tf-version VERSION (opcional)
Forneça uma versão do Terraform da área de trabalho.
--workspace-region REGION (opcional)
Forneça uma região de área de trabalho.
--workspace-rg-id ID (opcional)
Forneça um ID do grupo de recursos da área de trabalho.
--schematics-destroy (opcional)
Forneça esse sinalizador para excluir os recursos do espaço de trabalho após a validação e a instalação.
--schematics-delete VALUE (opcional)
Forneça essa sinalização para excluir a área de trabalho do Schematics após a validação e instalação.

Exemplo de validação de um produto que usa um cluster

Valide um produto com o localizador de versão b636d651-8489-4425-bd6a-f30af1603577.18aad484-c78b-4269-808b-52027621abd4 em um cluster com o ID bn5ebho206o7fg45f2e0 dentro de um namespace denominado test-namespace. Essa instalação tem configurações customizadas, portanto, os valores são fornecidos usando um arquivo 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

Substitua o formato de exemplo de valores do arquivo values.json:

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

Imagem de servidor virtual para exemplo de VPC

Valide um produto com o localizador de versão 51c9e0db-2911-45a6-adb0-ac5332d27cf2.ecebffdc-f1f8-4a85-965f-9cbe31920542 em um VPC com o 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

Execute o comando a seguir para obter o status de uma validação em andamento.

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

Opções de comando

--version-locator VERSION_NUMBER
Para obter o localizador de versão do produto, execute o comando ibmcloud catalog offering list e localize o produto ou a versão especificados que você deseja usar.
--output FORMAT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa compatível é o JSON, por exemplo, --output json.

ibmcloud catalog offering category-options

Execute o comando a seguir para recuperar a lista de opções de categoria.

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

Opções de comando

--output FORMAT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa compatível é o JSON, por exemplo, --output json.

Exemplo

ibmcloud catalog offering category-options

Saída

O comando retorna a saída a seguir:

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

Execute o comando a seguir para incluir uma tag de categoria em um produto. Você pode fornecer o nome da categoria, que pode ser encontrado executando o comando ibmcloud catalog offering category-options. Os produtos devem ser colocados em uma categoria para ficarem visíveis no catálogo. O padrão é Developer tools.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.
--category CATEGORY
Forneça a categoria que melhor se encaixa como os usuários podem usar o seu produto. As categorias são usadas para organizar produtos no catálogo com base em soluções comuns, função ou uso. Você pode selecionar apenas uma categoria. Execute o comando ibmcloud catalog offering category-options para visualizar todas as opções. O padrão é Developer tools.

Exemplo

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

Categorias de oferta de catálogo ibmcloud

Execute o seguinte comando para recuperar a categoria de uma versão do produto.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.
--output FORMAT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa suportada é o JSON. Por exemplo, --output json.

Exemplo

Recupere a categoria de um produto que é chamado dev-offering e localizado no dev-catalog.

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

catálogo ibmcloud oferecendo versão get-claims

Execute o comando a seguir para recuperar as informações de segurança e conformidade que uma versão solicitou.

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

Opções de comando

--version-locator LOCALIZADOR
Para obter o localizador de versão do produto, execute o comando ibmcloud catalog offering list e localize o produto ou a versão especificados que você deseja usar.
--output valor (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa compatível é o JSON, por exemplo, --output json.

ibmcloud catalog offering version update-claims

Execute o seguinte comando para atualizar as declarações de segurança e conformidade de uma versão.

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

Opções de comando

--claims RECLAMAÇÕES
Especifique os dados de solicitações para uma versão, como um objeto ou arquivo JSON.
--version-locator LOCALIZADOR
Para obter o localizador de versão do produto, execute o comando ibmcloud catalog offering list e localize o produto ou a versão especificados que você deseja usar.

ibmcloud catalog offering version scc-apply

Execute o comando a seguir para incluir uma varredura Security and Compliance Center em sua versão. Adicione informações de segurança e conformidade à sua versão e valide-a antes de poder adicionar uma varredura.

  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]

Opções de comando

--instance-region REGIÃO
A região da instância.
--scan SCAN
O ID de uma varredura do Security and Compliance Center.
--service-instance INSTÂNCIA
Forneça o ID da instância do Security and Compliance Center.
--target-account-name NAME (opcional)
Forneça o nome da conta de destino.
--target-api-key KEY (opcional)
Forneça uma chave de API se desejar usar uma conta alternativa (conta de destino) para aplicar uma varredura à sua conta de origem. Para obter mais informações, consulte Configurando uma conta de destino
--timeout TIMEOUT
Especifique em segundos quanto tempo você deseja aguardar até que a varredura seja aplicada à versão antes que o comando retorne. O valor padrão é 600 (10 minutos).
--version-locator LOCALIZADOR
Para obter o localizador de versão do produto, execute o comando ibmcloud catalog offering list e localize o produto ou a versão especificados que você deseja usar.
--wait WAIT
Aguardar e controlar o progresso de um aplicativo de varredura. O padrão é true se o sinalizador não for fornecido. Se true, o comando rastreia o progresso do aplicativo de varredura. Se false, o comando retorna imediatamente.

ibmcloud catalog offering version scc-apply-status

Execute o comando a seguir para ver o status de um aplicativo de varredura Security and Compliance Center para sua versão.

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

Opções de comando

--scan SCAN
O ID de uma varredura do Security and Compliance Center.
--version-locator LOCALIZADOR
Para obter o localizador de versão do produto, execute o comando ibmcloud catalog offering list e localize o produto ou a versão especificados que você deseja usar.

catálogo ibmcloud oferecendo versão get-scans

Execute o comando a seguir para recuperar as varreduras do Security and Compliance Center que são incluídas em sua versão:

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

Opções de comando

--instance-region REGIÃO
Forneça a região da instância.
--output OUTPUT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa suportada é o JSON. Por exemplo, --output json.
--profiles PERFIS
Forneça uma lista separada por vírgula de nomes de perfis com versões, por exemplo, "IBM Cloud for Financial Services::1.2.0".
--service-instance INSTÂNCIA
Forneça o ID da instância do Security and Compliance Center.
--target-account-name NAME (opcional)
Forneça o nome da conta de destino.
--target-api-key KEY (opcional)
Forneça uma chave de API se desejar usar uma conta alternativa (conta de destino) para aplicar uma varredura à sua conta de origem. Para obter mais informações, consulte Configurando uma conta de destino

oferta de catálogo ibmcloud get-scan-resulta

Execute o seguinte comando para gerar um relatório dos resultados da varredura do Code Risk Analyzer e do Security and Compliance Center sua versão. Para gerar um relatório completo, você deve executar as varreduras do Code Risk Analyzer e do Security and Compliance Center.

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

Opções de comando

--version-locator LOCALIZADOR
Para obter o localizador de versão do produto, execute o comando ibmcloud catalog offering list e localize o produto ou a versão especificados que você deseja usar.

ibmcloud catalog offering version create-draft

Execute o comando a seguir para criar um rascunho de uma versão existente. Esse comando é útil para mudar uma versão existente que você deseja publicar sem introduzir uma nova versão. Algumas mudanças, como mudar o arquivo de origem, requerem que você revalide o produto.

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

Opções de comando

--version-locator VERSION_NUMBER
Para obter o localizador de versão do produto, execute o comando ibmcloud catalog offering list e localize o produto ou a versão especificados que você deseja usar.
--output FORMAT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa suportada é o JSON. Por exemplo, --output json.

ibmcloud catalog offering version delete-version

Execute o comando a seguir para excluir uma versão de um produto.

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

Opções de comando

--version-locator VERSION_NUMBER
Para obter o localizador de versão do produto, execute o comando ibmcloud catalog offering list e localize o produto ou a versão especificados que você deseja usar.
--output FORMAT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa suportada é o JSON. Por exemplo, --output json.

ibmcloud catalog offering version deprecate-version

Execute o comando a seguir para descontinuar uma versão de produto publicada anteriormente do catálogo IBM Cloud.

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

Opções de comando

--version-locator VERSION_NUMBER
Para obter o localizador de versão do produto, execute o comando ibmcloud catalog offering list e localize o produto ou a versão especificados que você deseja usar.

ibmcloud catalog offering version refresh-version

Execute o seguinte comando para criar uma alteração no arquivo de origem de uma versão de rascunho. Este comando é útil para atualizar uma versão existente.

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

Opções de comando

--version-locator VERSION_NUMBER
Para obter o localizador de versão do produto, execute o comando ibmcloud catalog offering list e localize o produto ou a versão especificados que você deseja usar.
--zipurl URL
O endereço URL aponta para o arquivo compactado do produto.
--include-config (opcional)
Se fornecido, todos os valores de configuração serão incluídos e estarão disponíveis quando você incluir o produto.

ibmcloud catalog offering version merge-draft

Execute o comando a seguir para mesclar uma versão de rascunho de um produto.

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

Opções de comando

--version-locator VERSION_NUMBER
Para obter o localizador de versão do produto, execute o comando ibmcloud catalog offering list e localize o produto ou a versão especificados que você deseja usar.

ibmcloud catalog offering enable-sharing

Execute o comando a seguir para permitir que o seu produto seja compartilhado.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.

ibmcloud catalog offering ready

Execute o comando a seguir para marcar o seu produto como pronto para compartilhamento ou publicação.

ibmcloud catalog offering ready --version-locator VERSION_NUMBER

Opções de comando

--version-locator VERSION_NUMBER
Para obter o localizador de versão do produto, execute o comando ibmcloud catalog offering list e localize o produto ou a versão especificados que você deseja usar.

ibmcloud catalog offering delete

Execute o comando a seguir para excluir um produto do seu catálogo privado. Não é possível excluir um produto publicado no catálogo IBM Cloud. Para descontinuar um produto publicado do catálogo IBM Cloud, consulte ibmcloud catalog offering deprecate-offering.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.

ibmcloud catalog offering publish account

Execute o comando a seguir para publicar um produto de seu catálogo privado em uma conta. Depois que o produto é publicado, os usuários da conta têm acesso ao catálogo privado. O grupo de recursos que o contém pode criar uma instância e começar a usá-la.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.

ibmcloud catalog offering publish allowlist

Execute o comando a seguir para publicar um produto de seu catálogo privado em um conjunto de contas incluídas na lista de permissões. Depois que o produto for publicado, os usuários das contas listadas como permitidas poderão criar uma instância e começar a usá-la.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.
--account-ids ACCOUNT-IDS
O IDs de conta.

ibmcloud catalog offering publish enterprise

Execute o comando a seguir para publicar um produto em uma empresa. Depois que o produto é publicado, os usuários dentro da empresa podem criar uma instância do produto.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.

ibmcloud catalog offering suspend-offering

Execute o comando a seguir para suspender um produto do catálogo. É possível suspendê-lo por um curto tempo sem excluir permanentemente ou descontinuá-lo. Suspender um produto pode ser útil se, por exemplo, você descobrir um erro ou uma vulnerabilidade em seu produto que deve ser investigado antes que mais clientes o instalem.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.

ibmcloud catalog offering version suspend-version

Execute o comando a seguir para suspender uma versão de um produto do catálogo. É possível suspender a versão por um curto tempo sem excluí-la permanentemente ou descontinuá-la.

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

Opções de comando

--version-locator VERSION_NUMBER
Para obter o localizador de versão para esta oferta, execute ibmcloud catalog offering list e localize a versão que deseja usar.

ibmcloud catalog offering workspaces

Execute o comando a seguir para obter as áreas de trabalho do Schematics para uma versão de produto.

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

Opções de comando

--version-locator VERSION_NUMBER
Para obter o localizador de versão para esta oferta, execute ibmcloud catalog offering list e localize a versão especificada que deseja usar.
--output FORMAT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa suportada é o JSON. Por exemplo, --output json.

ibmcloud catalog install

Execute o comando a seguir para instalar uma versão do software a partir do catálogo 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]

Opções de comando

--version-locator VERSION_NUMBER
Para obter o localizador de versão para esta oferta, execute ibmcloud catalog offering list e localize a versão que deseja usar.
--cluster CLUSTER_ID
Especificar o nome ou o ID do cluster.
--namespace NAME
Especifique o namespace que você gostaria de usar.
--override-values VALUES
Forneça qualquer configuração customizada para a instalação. É possível fornecer esse valor sequencial ou usando um arquivo JSON ou TXT. Por exemplo, override-values values.json.
--timeout TIMEOUT
Especifique em segundos quanto tempo a área de trabalho do Schematics aguarda antes que ele seja instalado. O padrão é 180.
--wait WAIT
Aguarde e rastreie o progresso da tarefa da área de trabalho do Schematics. Se for true, a instalação espera. Se for false, o software será instalado imediatamente. O padrão é true.
--workspace-name NAME (opcional)
Forneça um nome de área de trabalho. O padrão é OfferingName-Date.
--workspace-tags TAGS (opcional)
Forneça uma lista separada por vírgula de tags.
--workspace-tf-version VERSION (opcional)
Forneça uma versão do Terraform da área de trabalho.
--workspace-region REGION (opcional)
Forneça uma região de área de trabalho.
--workspace-rg-id ID (opcional)
Forneça um ID do grupo de recursos da área de trabalho.
--schematics-delete VALUE (opcional)
Forneça essa sinalização para excluir a área de trabalho do Schematics após a validação e instalação.

Exemplo

Instale a versão do software 1 usando o cluster A, o namespace install e os valores de substituição JSON values.json.

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

Substitua o formato de exemplo de valores do arquivo values.json:

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

Precificação do catálogo ibmcloud

Execute o comando a seguir para obter informações de precificação para as 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]

Opções de comando

-r, --region (opcional)
Filtrar por geo.
-k, --kind (opcional)
Filtrar por meio do tipo de recursos. Atualmente, há suporte para service (padrão), iaas, runtime, template e geography
-p, --price (opcional)
Filtrar pelo preço. Atualmente, há suporte para free, paygo e subscription
-t, --tag (opcional)
Filtrar pela tag. Esta sinalização é replicável e resulta em um OR lógico de todas as sinalizações especificadas.
--co, --country (opcional)
Filtrar por um país. A saída para CSV ou JSON pode usar o valor ALL para obter valores para todos os países.
--json (opcional)
Emite uma resposta JSON.
--csv (opcional)
Emite um arquivo CSV.
-f, --file (opcional)
Especifique um nome de arquivo para a saída csv.
--global (opcional)
Operar em escopo global.
--iam (opcional)
Filtrar por ofertas compatíveis com o IAM.

Exemplo

Obtenha informações de precificação para o Virtual Server for VPC para uma conta pré-paga.

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

ibmcloud catalog regiões de ponto de extremidade privado

Execute o seguinte comando para recuperar a lista de regiões que oferecem suporte a pontos de extremidade privados para um serviço especificado.

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

Opções de comando

--service
Forneça a ID ou o nome programático do serviço para ver suas regiões que suportam o ponto de extremidade privado

serviços de ponto de extremidade privado do catálogo ibmcloud

Execute o seguinte comando para recuperar a lista de serviços que oferecem suporte a pontos de extremidade privados para uma região especificada.

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

Opções de comando

--region ou -r
Forneça a REGIÃO para ver quais serviços oferecem suporte a pontos de extremidade privados nessa região

Utilitário ibmcloud catalog create-product-from-workspace

Execute o comando a seguir para criar um ladrilho de arquitetura implementável por meio de uma área de trabalho Schematics que foi criada diretamente do repositório Git. A arquitetura implantável cria um projeto para que você possa continuar a desenvolver e manter a arquitetura implantável com a versão futura.

O comando requer uma variável de ambiente GIT_TOKEN para autenticar com seu repositório de origem para que um manifesto do catálogo possa ser incluído. O comando envia por push para uma nova ramificação no repositório Git localizado na área de trabalho Schematics e cria uma liberação que é usada para integração.

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]

Opções de comando

--api-key ou --ak API KEY
Forneça uma chave de API que é usada para vincular o catálogo e o projeto. Mutuamente exclusivo com '--trusted-profile-id'.
--catalog-label RÓTULO DE CATÁLOGO (opcional)
Forneça o rótulo de um catálogo existente para importar ou o nome de um novo catálogo para criar. O padrão é "Migrated DAs".
--offering-label RÓTULO DE OFERTA (opcional)
Forneça o rótulo de uma oferta existente para importar ou o nome de uma nova oferta para criar. O padrão é "Migrated <workspace_name>". O rótulo substitui o rótulo da oferta existente se o espaço de trabalho for criado a partir de uma oferta de catálogo.
--project-name NAME (opcional)
Forneça um nome de projeto que esteja vinculado ao catálogo integrado. Se o projeto não existir, ele será criado. O nome padrão é "Dev Migration Project" (Projeto de migração de desenvolvimento).
--project-resource-group (opcional)
Forneça um grupo de recursos para o projeto que está sendo criado. O grupo de recursos padrão é "Padrão".
--target-version VERSION (opcional)
Forneça a versão de destino para a oferta migrada O padrão é ' 1.0.0 '.
--trusted-profile-id ou --tpi ID DO PERFIL CONFIÁVEL
Forneça uma ID de perfil confiável que seja usada para vincular o catálogo e o projeto. Mutuamente exclusivo com '--api-key'.
--variation-label RÓTULO DE VARIAÇÃO (opcional)
Forneça um rótulo de variação para a versão a ser integrada O padrão é "Padrão". O rótulo sobrescreverá o rótulo da versão existente se a área de trabalho for criada a partir de uma oferta de catálogos
--workspace-id ID DO ESPAÇO DE TRABALHO
Forneça um ID da área de trabalho Schematics. Para obter o ID da área de trabalho, você deve criar a área de trabalho Schematics. Para obter mais informações, consulte ibmcloud schematics workspace new.

ibmcloud catalog utility netrc

Execute o comando a seguir para criar um arquivo .netrc, gere o nome da máquina em seu arquivo .netrc ou atualize a credencial em seu arquivo .netrc. Um arquivo .netrc armazena as informações de login necessárias para usar módulos Terraform por meio do catálogo IBM Cloud.

Ao executar esse comando, você configura um arquivo .netrc para o nome da máquina cm.globalcatalog.cloud.ibm.com com iamtoken como nome de usuário e seu token IAM como senha.

Você precisa da versão 1.2.7 ou superior do plug-in da CLI de gerenciamento de catálogos para executar o comando .netrc.

ibmcloud catalog utility netrc

ibmcloud catalog utility update-module-references

Execute o comando a seguir para verificar os módulos Terraform do seu diretório de trabalho quanto a atualizações do catálogo e atualize o atributo de origem para a versão mais recente. O README.md também é atualizado.

ibmcloud catalog utility update-module-references

ibmcloud catalog offering unpublish account

Execute o comando a seguir para cancelar a publicação de um produto da sua conta. Após o cancelamento da publicação do produto, os usuários em sua conta não podem criar uma instância do produto.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.

ibmcloud catalog offering unpublish allowlist

Execute o comando a seguir para remover os IDs de conta da lista de permissões do produto. As contas que são removidas da lista de permissões não podem criar uma instância do produto.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.
--account-ids ACCOUNT-IDS
O IDs de conta.

ibmcloud catalog offering unpublish enterprise

Execute o comando a seguir para cancelar a publicação de um produto de uma empresa. Após o cancelamento da publicação do produto, a empresa não pode criar uma instância do produto.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.

ibmcloud catálogo oferta unpublish ibm

Execute o seguinte comando para cancelar a publicação de um produto em IBM. Depois que o produto for despublicado, os funcionários do IBM não poderão criar uma instância do produto.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.

ibmcloud catálogo oferta publicar ibm

Execute o seguinte comando para publicar uma oferta que já está disponível em sua conta para todos os usuários do site IBM. Essa parte do processo de publicação cria um bloco nos catálogos de preparação e produção que é visível apenas para os usuários do site IBM. Ao publicar uma oferta para os usuários do site IBM, você pode testar a oferta em produção antes de disponibilizá-la para todos os usuários no catálogo IBM Cloud.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.

ibmcloud catalog offering publish public

Execute o comando a seguir para publicar a sua oferta privada no catálogo da IBM Cloud para que todos os usuários vejam e usem. Para chegar a essa etapa no processo de publicação e concluir o processo de teste, deve-se primeiro publicar a oferta para a conta e para todos os IBMistas. Depois que seu teste for concluído, será possível executar esse comando.

Essa opção requer aprovação. Quando a aprovação for concluída, o ladrilho estará disponível para todos os clientes do site IBM Cloud.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.

ibmcloud catalog offering deprecate-offering

Execute o comando a seguir para descontinuar uma versão de oferta publicada anteriormente no catálogo da IBM Cloud.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.

ibmcloud catalog offering restore-offering

Execute o comando a seguir para restaurar um produto descontinuado anteriormente no catálogo IBM Cloud. Depois de validar uma versão do seu produto, é possível restaurá-lo para o estado publicado em que ele estava antes de ser descontinuado.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.

ibmcloud catalog offering version restore-version

Execute o comando a seguir para restaurar uma versão descontinuada anteriormente de um produto no catálogo IBM Cloud. A restauração coloca a versão em um estado de rascunho. Após você validá-la, é possível restaurar a versão original para o estado publicado em que ela estava antes de ser descontinuada.

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

Opções de comando

--catalog CATALOG
O nome ou ID do catálogo.
--offering OFFERING
O nome ou o ID do produto.
--include-config (opcional)
Se fornecido, todos os valores de configuração serão incluídos e estarão disponíveis quando você incluir o produto.

ibmcloud catalog object create vpe

Execute o seguinte comando para adicionar um objeto a um catálogo privado na conta.

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

Opções de comando

--catalog CATALOG
Especifique o nome ou o ID do catálogo.
--crn CRN
Forneça o nome do recurso de nuvem (CRN).
--endpoint-type TIPO
Especifique o tipo de terminal VPE.
--fqdn FQDN
Forneça uma lista separada por vírgulas de nomes de domínio totalmente qualificados.
--name NAME
Especifique o nome do objeto.
--region REGION
Especifique a região do terminal VPE.

exclusão de objeto de catálogo do ibmcloud

Execute o seguinte comando para excluir o objeto.

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

Opções de comando

--catalog CATALOG
Especifique o nome ou o ID do catálogo.
--name NAME
Forneça o nome do objeto.

ibmcloud catalog object update vpe

Execute o seguinte comando para atualizar o objeto.

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

Opções de comando

--catalog CATALOG
Especifique o nome ou o ID do catálogo.
--name NAME
Especifique o nome do objeto.
--crn CRN (opcional)
Forneça o nome do recurso de nuvem (CRN).
--endpoint-type TYPE (opcional)
Especifique o tipo de terminal VPE.
--fqdn FQDN (opcional)
Forneça uma lista separada por vírgulas de nomes de domínio totalmente qualificados.
--region REGION (opcional)
Especifique a região do terminal VPE.

objeto do catálogo ibmcloud get

Execute o seguinte comando para recuperar informações para um objeto específico.

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

Opções de comando

--catalog CATALOG
Especifique o nome ou o ID do catálogo.
--name NAME
Forneça o nome do objeto.
--output OUTPUT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa suportada é o JSON. Por exemplo,--output json

Lista de objetos do catálogo ibmcloud

Execute o comando a seguir para recuperar uma lista de objetos em um catálogo

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

Opções de comando

--catalog CATALOG
Especifique o nome ou o ID do catálogo.
--output OUTPUT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa suportada é o JSON. Por exemplo,--output json

Procura de objeto do catálogo ibmcloud

Execute o comando a seguir para procurar objetos usando sintaxe de consulta Lucene.

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

Opções de comando

--query PESQUISA
Forneça a sequência de consulta do Lucene
--output OUTPUT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa suportada é o JSON. Por exemplo,--output json

ibmcloud catalog objeto pronto

Execute o seguinte comando para marcar seu objeto como pronto para ser compartilhado ou publicado.

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

Opções de comando

--catalog CATALOG
Especifique o nome ou o ID do catálogo.
--name NAME
Especifique o nome do objeto.

Compartilhamento de ativação do objeto ibmcloud catalog

Execute o comando a seguir para ativar o compartilhamento de um objeto gerenciado do Partner Center. Ative o compartilhamento antes de poder compartilhar um objeto com uma conta ou lista de acesso.

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

Opções de comando

--catalog CATALOG
Especifique o nome ou o ID do catálogo.
--name NAME
Especifique o nome do objeto.

ibmcloud catalog object publicar

Execute o comando a seguir para publicar o objeto em uma lista de acesso, sua conta, funcionários do IBM ou catálogo do IBM Cloud para que todos os usuários vejam e usem.

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

Opções de comando

Comando
Especifique onde você deseja publicar o objeto. Valores válidos são accesslist, account, ibm ou public.
--catalog CATALOG
Especifique o nome ou o ID do catálogo.
--name NAME
Forneça o nome do objeto.

Exemplo

Publique um objeto chamado dev-object que está no catálogo dev-catalog para funcionários do IBM.

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

Acesso ao objeto do catálogo ibmcloud-inclusão da lista de

Execute o comando a seguir para incluir IDs de conta na lista de acesso de um objeto

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

Opções de comando

--account-id ID
Forneça uma lista de IDs de conta separada por vírgulas.
--catalog CATALOG
Especifique o nome ou o ID do catálogo.
--name NAME
Especifique o nome do objeto.

ibmcloud catalog object access-list get

Execute o seguinte comando para recuperar informações para uma lista de acesso específica para um objeto.

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

Opções de comando

--catalog CATALOG
Especifique o nome ou o ID do catálogo.
--name NAME
Especifique o nome do objeto.
--output OUTPUT (opcional)
Especifica o formato de saída. O padrão é compatível com o terminal e a única alternativa suportada é o JSON. Por exemplo,--output json

ibmcloud catalog object access-list rm

Execute o seguinte comando para remover IDs de conta da lista de acesso do objeto.

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

Opções de comando

--account-id ID
Forneça uma lista de IDs de conta separada por vírgulas.
--catalog CATALOG
Especifique o nome ou o ID do catálogo.
--name NAME
Especifique o nome do objeto.