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
November 14, 2018

PostgreSQL Tips: Template Databases

In this PostgreSQL Tip, we demystify PostgreSQL template databases and how and when you might use them. Template databases are really useful when you use the same database objects every time you create a new database.

Continue reading

November 9, 2018

Build Messaging Solutions with Apache Kafka or Event Streams for IBM Cloud: Part 3

One key aspect of a robust architecture is that it is built to smoothly handle system failures, outages, and configuration changes without violating the data loss and consistency requirements of the use case. To proactively build such solutions needs an understanding of the possible exceptions and risky scenarios and preparedness to manage them efficiently.

Continue reading

November 9, 2018

How to Set Up a Concourse CI/CD Pipeline

To hit the ground running for any project based on cloud-based applications, it is very important to set up the associated infrastructure for the development of microservices. Quick and high-speed development can be achieved if the team has a way to do Continuous Integration (CI) and Continuous Delivery (CD) of the application.

Continue reading