Manage Parallelstore instances

Parallelstore allows you to list all instances, retrieve specific instances, and delete specific instances.

Parallelstore instances cannot be updated after they've been created.

List instances

To list all the instances in a project:

Google Cloud console

  1. Go to the Parallelstore page in the Google Cloud console.

    Go to Parallelstore

    Your project's instances are listed.

gcloud CLI 

gcloud beta parallelstore instances list --location=LOCATION

Replace LOCATION with a specific zone to list all instances in that location. To view projects in all locations, enter - as the value. For example:

gcloud beta parallelstore instances list --location=-

REST

To list instances using the REST API, send a request to the following endpoint:

GET https://parallelstore.googleapis.com/v1beta/projects/PROJECT_ID/locations/ZONE/instances
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Where the following values must be specified:

  • PROJECT_ID is your Google Cloud project ID.

  • ZONE is the zone for which to list all instances. To list instances from all zones, use - as the value.

Retrieve an instance

To retrieve an instance's details:

Google Cloud console

  1. Go to the Parallelstore page in the Google Cloud console.

    Go to Parallelstore

  2. Click the instance name to view details about a specific instance.

gcloud CLI 

gcloud beta parallelstore instances describe INSTANCE_NAME --location=LOCATION

REST

To retrieve details about a particular instance using the REST API, send a request to the following endpoint:

GET https://parallelstore.googleapis.com/v1beta/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Where the following values must be specified:

  • PROJECT_ID is your Google Cloud project ID.

  • ZONE must be a valid Google Cloud zone that is supported by Parallelstore. See Supported locations for a full list.

  • INSTANCE_NAME is the name of the Parallelstore instance to return.

Delete an instance

To delete an instance:

Google Cloud console

  1. Go to the Parallelstore page in the Google Cloud console.

    Go to Parallelstore

  2. Select the checkbox next to the instance to delete.

  3. Click Delete. Confirm the deletion by entering the instance name in the Confirm field and clicking Delete again.

gcloud CLI 

gcloud beta parallelstore instances delete INSTANCE_NAME --location=LOCATION

You are prompted to confirm deletion. Type Y or press enter to continue.

REST

To create an instance using the REST API, send a request to the following endpoint:

DELETE https://parallelstore.googleapis.com/v1beta/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Where the following values must be specified:

  • PROJECT_ID is your Google Cloud project ID.

  • ZONE must be a valid Google Cloud zone that is supported by Parallelstore. See Supported locations for a full list.

  • INSTANCE_NAME is the name of the Parallelstore instance to delete.

Delete requests are long-running requests, and return an operation ID that can be queried for operation status. See the operations.get reference for details.