View VM cluster information

This page describes how to view information for a VM Cluster using Google Cloud.

After you create a VM Cluster, you can view details about your VM Cluster in the cluster details page in Google Cloud.

To create a cluster, see Create clusters. To modify an existing cluster, see Manage clusters.

Before you begin

View cluster information

Console

  1. Go to the Exadata Database Service page.

    Go to Exadata Database Service

  2. Select the Exadata VM Clusters tab.

    You can view a list of all your VM Clusters and their following details:

    • VM Cluster name
    • VM Cluster ID
    • Exadata Infrastructure ID
    • Status
    • VM count
    • Location
    • Number of OCPUs
    • Memory (GB)
    • Exadata storage (TB)
    • Date and time of creation

  3. To view more information about a VM Cluster, click its name.

    On the Exadata VM Cluster details page, you can view the following additional details:

    Details Description
    Cluster details
    • Cluster name
    • Display name
    • Infrastructure ID
    • Region (Availability zone)
    • Grid infrastructure version
    • License type
    • Timezone
    Resource allocation
    • Enabled CPUs
    • Local storage
    • Storage for local backups
    • Storage for Exadata sparse snapshots
    Network
    • Associated VPC network
    • Client subnet
    • Backup subnet
    • Hostname
    • Scan listener port
    Diagnostic collection
    • Diagnostic events enabled or not
    • Health monitoring enabled or not
    • Incident logs and trace collection enabled or not
    Virtual machines
    • Name
    • Status
    • OCPUs
    • Memory
    • Available local storage
    • DB server

gcloud

Use the gcloud oracle-database cloud-vm-clusters describe command to view cluster information for your VM Cluster.

gcloud oracle-database cloud-vm-clusters describe CLUSTER_ID
--location=REGION_ID

Replace the following:

  • CLUSTER_ID: the identifier for the cluster that you want to view information for.
  • REGION_ID: the region for the cluster that you want to view information for.

C#

using Google.Cloud.OracleDatabase.V1;
using System.Threading.Tasks;

public sealed partial class GeneratedOracleDatabaseClientSnippets
{
    /// <summary>Snippet for GetCloudVmClusterAsync</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public async Task GetCloudVmClusterAsync()
    {
        // Create client
        OracleDatabaseClient oracleDatabaseClient = await OracleDatabaseClient.CreateAsync();
        // Initialize request argument(s)
        string name = "projects/[PROJECT]/locations/[LOCATION]/cloudVmClusters/[CLOUD_VM_CLUSTER]";
        // Make the request
        CloudVmCluster response = await oracleDatabaseClient.GetCloudVmClusterAsync(name);
    }
}

Go


package main

import (
	"context"

	oracledatabase "cloud.google.com/go/oracledatabase/apiv1"
	oracledatabasepb "cloud.google.com/go/oracledatabase/apiv1/oracledatabasepb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := oracledatabase.NewRESTClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &oracledatabasepb.GetCloudVmClusterRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/oracledatabase/apiv1/oracledatabasepb#GetCloudVmClusterRequest.
	}
	resp, err := c.GetCloudVmCluster(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

Java

import com.google.api.core.ApiFuture;
import com.google.cloud.oracledatabase.v1.CloudVmCluster;
import com.google.cloud.oracledatabase.v1.CloudVmClusterName;
import com.google.cloud.oracledatabase.v1.GetCloudVmClusterRequest;
import com.google.cloud.oracledatabase.v1.OracleDatabaseClient;

public class AsyncGetCloudVmCluster {

  public static void main(String[] args) throws Exception {
    asyncGetCloudVmCluster();
  }

  public static void asyncGetCloudVmCluster() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (OracleDatabaseClient oracleDatabaseClient = OracleDatabaseClient.create()) {
      GetCloudVmClusterRequest request =
          GetCloudVmClusterRequest.newBuilder()
              .setName(
                  CloudVmClusterName.of("[PROJECT]", "[LOCATION]", "[CLOUD_VM_CLUSTER]").toString())
              .build();
      ApiFuture<CloudVmCluster> future =
          oracleDatabaseClient.getCloudVmClusterCallable().futureCall(request);
      // Do something.
      CloudVmCluster response = future.get();
    }
  }
}

Node.js

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The name of the Cloud VM Cluster in the following format:
 *  projects/{project}/locations/{location}/cloudVmClusters/{cloud_vm_cluster}.
 */
// const name = 'abc123'

// Imports the Oracledatabase library
const {OracleDatabaseClient} = require('@google-cloud/oracledatabase').v1;

// Instantiates a client
const oracledatabaseClient = new OracleDatabaseClient();

async function callGetCloudVmCluster() {
  // Construct request
  const request = {
    name,
  };

  // Run request
  const response = await oracledatabaseClient.getCloudVmCluster(request);
  console.log(response);
}

callGetCloudVmCluster();

PHP

use Google\ApiCore\ApiException;
use Google\Cloud\OracleDatabase\V1\Client\OracleDatabaseClient;
use Google\Cloud\OracleDatabase\V1\CloudVmCluster;
use Google\Cloud\OracleDatabase\V1\GetCloudVmClusterRequest;

/**
 * Gets details of a single VM Cluster.
 *
 * @param string $formattedName The name of the Cloud VM Cluster in the following format:
 *                              projects/{project}/locations/{location}/cloudVmClusters/{cloud_vm_cluster}. Please see
 *                              {@see OracleDatabaseClient::cloudVmClusterName()} for help formatting this field.
 */
function get_cloud_vm_cluster_sample(string $formattedName): void
{
    // Create a client.
    $oracleDatabaseClient = new OracleDatabaseClient();

    // Prepare the request message.
    $request = (new GetCloudVmClusterRequest())
        ->setName($formattedName);

    // Call the API and handle any network failures.
    try {
        /** @var CloudVmCluster $response */
        $response = $oracleDatabaseClient->getCloudVmCluster($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = OracleDatabaseClient::cloudVmClusterName(
        '[PROJECT]',
        '[LOCATION]',
        '[CLOUD_VM_CLUSTER]'
    );

    get_cloud_vm_cluster_sample($formattedName);
}

Python

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import oracledatabase_v1


def sample_get_cloud_vm_cluster():
    # Create a client
    client = oracledatabase_v1.OracleDatabaseClient()

    # Initialize request argument(s)
    request = oracledatabase_v1.GetCloudVmClusterRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_cloud_vm_cluster(request=request)

    # Handle the response
    print(response)

Ruby

require "google/cloud/oracle_database/v1"

##
# Snippet for the get_cloud_vm_cluster call in the OracleDatabase service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client#get_cloud_vm_cluster.
#
def get_cloud_vm_cluster
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::OracleDatabase::V1::GetCloudVmClusterRequest.new

  # Call the get_cloud_vm_cluster method.
  result = client.get_cloud_vm_cluster request

  # The returned object is of type Google::Cloud::OracleDatabase::V1::CloudVmCluster.
  p result
end

What's next