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
February 13, 2019

Simplify and Automate Deployments Using GitOps with IBM Multicloud Manager 3.1.2

Use Argo CD, a GitOps continuous delivery tool for Kubernetes, and IBM Multicloud Manager to achieve declarative and automated deployment of applications to multiple Kubernetes clusters.

Continue reading

February 11, 2019

Solving Business Problems with Splunk on IBM Cloud Kubernetes Service

In this tutorial, we will install Splunk Connect for Kubernetes into an existing Splunk instance. Splunk Connect for Kubernetes provides a way to import and search your Kubernetes logging, object, and metrics data in Splunk.

Continue reading

February 8, 2019

A How-To for Migrating Redis to IBM Cloud Databases for Redis

If you’re moving your data over to IBM Cloud Databases for Redis, you’ll need to take some steps to successfully migrate all of your data. We’ve got you covered. In this post, we’ll show you a quick way to start migrating your data across to Databases for Redis, whether your database is on-premise or in the cloud.

Continue reading