How-tos

Where Are My Resources? (Part 1)

Share this post:

Using the IBM Cloud command line to find resources

We all love leveraging cloud environments, but dealing with multiple geographically dispersed microservices and service instances requires a robust and fast search engine that can help find resources quickly despite their nature (e.g., service instance, application, container) and their location.

Starting from build 0.6.7, the IBM Cloud command line has the capability to search across all your resources using Lucene query syntax, with a single instruction.

To use it, simply log in as usual in the IBM Cloud command line, select an account, and use ibmcloud resource search.

For example, imagine you would like to look for all your resources named “ABC”:

ibmcloud resource search ‘name:ABC’

The following table shows the resource attributes you can use in your search parameters:

Name of the attribute Description
name This is the user-provided name of the resource
region the geographical location where the resource has been provisioned. For example, you can use us-south, au-syd, eu-gb, eu-de
service_name the name of the service as it appear in the Name column of the output of bx catalog service-marketplace
family the cloud provider to which your resource belongs. For example you can specify cloud_foundry, containers or resource_controller
organization_id the Cloud Foundry organization GUID
space_id the Cloud Foundry space GUID
doc.resource_group_id the ID of the resource group
type the resource type. Examples of possible values are: k8-cluster, cf-service-instance, cf-user-provided-service-instance, cf-organization, cf-service-binding, cf-space, cf-application, resource-instance, resource-alias, resource-binding, resource-group
creation_date The date on which the resource has been created
modification_date The last modification date of the resource

 

Below, you can see some search examples:

  • All resources named MyResource:
    ibmcloud resource search ‘name:MyResource’
  • All cloud foundry applications named MyResource :
    ibmcloud resource search ‘name:my* AND type:cf-application’
  • All service instances of Message Hub:
    ibmcloud resource search ‘service_name:messagehub’
  • All resources in either the cloud foundry organization a07181ca-f917-4ee6-af22-b2c0c2a2d5d7 or in the resource group c900d9671b235c00461c5e311a8aeced in region us-south:
    ibmcloud resource search (organization_id:a07181ca-f917-4ee6-af22-b2c0c2a2d5d7 OR doc.resource_group_id:c900d9671b235c00461c5e311a8aeced) AND ‘region:us-south’
  • All resources created between May 16th 2018 and May 20th 2018:
    ibmcloud resource search “creation_date:[2018-05-16T00:00:00Z TO 2018-05-20T00:00:00Z]”

To learn more about the IBM Cloud command line, see the linked documentation.

To learn about more ways to search for IBM Cloud resources, please see the second article in this series: “Where Are My Resources? (Part 2)

STSM, Atlas - Global Search and Tagging

More How-tos stories
September 20, 2018

Deploying to IBM Cloud Private 2.1.0.3 with IBM Cloud Developer Tools CLI

IBM Cloud Developer Tools CLI version 2.1.4 adds deployment support for IBM Cloud Private 2.1.0.3. This version of IBM Cloud Private uses a more secure Helm for Kubernetes deployments and simplifies the cluster configuration for the client compared to prior IBM Cloud Private releases.

Continue reading

September 19, 2018

Tutorial: Apply End-to-End Security to Cloud Applications

A new tutorial will show you how to use IBM Cloud services to secure your cloud application. Capture and review security-related events, encrypt storage, integrate authentication, and more.

Continue reading

September 18, 2018

How To Convert CSV Objects to Parquet in Cloud Object Storage

If you're looking to lower storage costs by compressing your data and get better query performance when querying the data in Cloud Object Storage, you may want to click to learn how to convert CSV objects to Parquet.

Continue reading