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
Go to the Parallelstore page in the Google Cloud console.
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
Go to the Parallelstore page in the Google Cloud console.
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
Go to the Parallelstore page in the Google Cloud console.
Select the checkbox next to the instance to delete.
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.