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 loginpara 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_sourceoupreset_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_sourceoupreset_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_sourceoupreset_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_sourceoupreset_configuration.. - --approval-state VALOR
- Forneça o estado de aprovação As opções são
approved,pendingourejected.. - --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-entgrppara 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_sourceoupreset_configuration.. - --approval-state VALOR
- Forneça o estado de aprovação As opções são
approved,pendingourejected.. - --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-entgrppara 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ãoservicesesoftware. - --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
jsonecsv. - --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 regionspara 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,createdeupdated. - --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
trueefalse. 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-optionspara 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 optionspara 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 optionspara 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 optionspara 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 optionspara 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 optionspara 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 optionspara 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 optionspara 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
trueefalse. 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 search
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 search [--catalog CATALOG] [--offering OFFERING_NAME] [--version VERSION] [--output FORMAT]
Opções de comando
- --catalog CATALOG (opcional)
- O nome ou ID do catálogo.
- --offering OFFERING (opcional)
- O nome ou o ID do produto.
- --version VERSION (opcional)
- O nome ou ID da versã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.
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 Current State Version Locator
dev-catalog
|__dev-offering
| |__Kubernetes
| |__1.0.0 Validated b636d651-8489-4425-bd6a-f30af1603577.17ac792e-a603-4f1a-a1b6-48e90a46940c
|__dev-offering-2.0
| |__Kubernetes
| |__1.0.0 Published to account b636d651-8489-4425-bd6a-f30af1603577.decdb0e1-46d2-401a-b482-80f9d6855f98
ibmcloud catalog offering get
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 liste 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 liste 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 liste 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 forfalse, 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 liste 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-optionspara 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 liste 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 liste 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 liste 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. Sefalse, 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 liste 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 liste 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 liste 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 liste 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 liste 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 liste 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 liste localize o produto ou a versão especificados que você deseja usar.
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 liste 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 liste 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 liste 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 liste 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 forfalse, 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,templateegeography - -p, --price (opcional)
- Filtrar pelo preço. Atualmente, há suporte para
free,paygoesubscription - -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
ALLpara 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.
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,ibmoupublic. - --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.