storage_pools

Creates, updates, deletes, gets or lists a storage_pools resource.

Overview

Name	storage_pools
Type	Resource
Id	google.compute.storage_pools

Fields

The following fields are returned by SELECT queries:

get

Successful response

Name	Datatype	Description
id	string (uint64)	[Output Only] The unique identifier for the resource. This identifier is defined by the server.
name	string	Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. (pattern: a-z?)
capacityProvisioningType	string	Provisioning type of the byte capacity of the pool.
creationTimestamp	string	[Output Only] Creation timestamp in RFC3339 text format.
description	string	An optional description of this resource. Provide this property when you create the resource.
kind	string	[Output Only] Type of the resource. Always compute#storagePool for storage pools. (default: compute#storagePool)
labelFingerprint	string (byte)	A fingerprint for the labels being applied to this storage pool, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a storage pool.
labels	object	Labels to apply to this storage pool. These can be later modified by the setLabels method.
performanceProvisioningType	string	Provisioning type of the performance-related parameters of the pool, such as throughput and IOPS.
poolProvisionedCapacityGb	string (int64)	Size of the storage pool in GiB. For more information about the size limits, see https://cloud.google.com/compute/docs/disks/storage-pools.
poolProvisionedIops	string (int64)	Provisioned IOPS of the storage pool. Only relevant if the storage pool type is hyperdisk-balanced.
poolProvisionedThroughput	string (int64)	Provisioned throughput of the storage pool in MiB/s. Only relevant if the storage pool type is hyperdisk-balanced or hyperdisk-throughput.
resourceStatus	object	[Output Only] Status information for the storage pool resource. (id: StoragePoolResourceStatus)
selfLink	string	[Output Only] Server-defined fully-qualified URL for this resource.
selfLinkWithId	string	[Output Only] Server-defined URL for this resource's resource id.
state	string	[Output Only] The status of storage pool creation. - CREATING: Storage pool is provisioning. storagePool. - FAILED: Storage pool creation failed. - READY: Storage pool is ready for use. - DELETING: Storage pool is deleting.
status	object	[Output Only] Status information for the storage pool resource. (id: StoragePoolResourceStatus)
storagePoolType	string	Type of the storage pool.
zone	string	[Output Only] URL of the zone where the storage pool resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.

list

Successful response

Name	Datatype	Description
id	string	[Output Only] Unique identifier for the resource; defined by the server.
etag	string
items	array	A list of StoragePool resources.
kind	string	[Output Only] Type of resource. Always compute#storagePoolList for lists of storagePools. (default: compute#storagePoolList)
nextPageToken	string	[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
selfLink	string	[Output Only] Server-defined URL for this resource.
unreachables	array	[Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder
warning	object	[Output Only] Informational warning message.

aggregated_list

Successful response

Name	Datatype	Description
id	string (uint64)	[Output Only] The unique identifier for the resource. This identifier is defined by the server.
name	string	Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. (pattern: a-z?)
capacityProvisioningType	string	Provisioning type of the byte capacity of the pool.
creationTimestamp	string	[Output Only] Creation timestamp in RFC3339 text format.
description	string	An optional description of this resource. Provide this property when you create the resource.
kind	string	[Output Only] Type of the resource. Always compute#storagePool for storage pools. (default: compute#storagePool)
labelFingerprint	string (byte)	A fingerprint for the labels being applied to this storage pool, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a storage pool.
labels	object	Labels to apply to this storage pool. These can be later modified by the setLabels method.
performanceProvisioningType	string	Provisioning type of the performance-related parameters of the pool, such as throughput and IOPS.
poolProvisionedCapacityGb	string (int64)	Size of the storage pool in GiB. For more information about the size limits, see https://cloud.google.com/compute/docs/disks/storage-pools.
poolProvisionedIops	string (int64)	Provisioned IOPS of the storage pool. Only relevant if the storage pool type is hyperdisk-balanced.
poolProvisionedThroughput	string (int64)	Provisioned throughput of the storage pool in MiB/s. Only relevant if the storage pool type is hyperdisk-balanced or hyperdisk-throughput.
resourceStatus	object	[Output Only] Status information for the storage pool resource. (id: StoragePoolResourceStatus)
selfLink	string	[Output Only] Server-defined fully-qualified URL for this resource.
selfLinkWithId	string	[Output Only] Server-defined URL for this resource's resource id.
state	string	[Output Only] The status of storage pool creation. - CREATING: Storage pool is provisioning. storagePool. - FAILED: Storage pool creation failed. - READY: Storage pool is ready for use. - DELETING: Storage pool is deleting.
status	object	[Output Only] Status information for the storage pool resource. (id: StoragePoolResourceStatus)
storagePoolType	string	Type of the storage pool.
zone	string	[Output Only] URL of the zone where the storage pool resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	project, zone, storagePool		Returns a specified storage pool. Gets a list of available storage pools by making a list() request.
list	select	project, zone	filter, maxResults, orderBy, pageToken, returnPartialSuccess	Retrieves a list of storage pools contained within the specified zone.
aggregated_list	select	project	filter, includeAllScopes, maxResults, orderBy, pageToken, returnPartialSuccess, serviceProjectNumber	Retrieves an aggregated list of storage pools. To prevent failure, Google recommends that you set the returnPartialSuccess parameter to true.
insert	insert	project, zone	requestId	Creates a storage pool in the specified project using the data in the request.
update	update	project, zone, storagePool	requestId, updateMask	Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: pool_provisioned_capacity_gb, pool_provisioned_iops and pool_provisioned_throughput.
delete	delete	project, zone, storagePool	requestId	Deletes the specified storage pool. Deleting a storagePool removes its data permanently and is irreversible. However, deleting a storagePool does not delete any snapshots previously made from the storagePool. You must separately delete snapshots.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
project	string
storagePool	string
zone	string
filter	string
includeAllScopes	boolean
maxResults	integer (uint32)
orderBy	string
pageToken	string
requestId	string
returnPartialSuccess	boolean
serviceProjectNumber	string (int64)
updateMask	string (google-fieldmask)

SELECT examples

get

Returns a specified storage pool. Gets a list of available storage pools by making a list() request.

SELECT
id,
name,
capacityProvisioningType,
creationTimestamp,
description,
kind,
labelFingerprint,
labels,
performanceProvisioningType,
poolProvisionedCapacityGb,
poolProvisionedIops,
poolProvisionedThroughput,
resourceStatus,
selfLink,
selfLinkWithId,
state,
status,
storagePoolType,
zone
FROM google.compute.storage_pools
WHERE project = '{{ project }}' -- required
AND zone = '{{ zone }}' -- required
AND storagePool = '{{ storagePool }}' -- required;

list

Retrieves a list of storage pools contained within the specified zone.

SELECT
id,
etag,
items,
kind,
nextPageToken,
selfLink,
unreachables,
warning
FROM google.compute.storage_pools
WHERE project = '{{ project }}' -- required
AND zone = '{{ zone }}' -- required
AND filter = '{{ filter }}'
AND maxResults = '{{ maxResults }}'
AND orderBy = '{{ orderBy }}'
AND pageToken = '{{ pageToken }}'
AND returnPartialSuccess = '{{ returnPartialSuccess }}';

aggregated_list

Retrieves an aggregated list of storage pools. To prevent failure, Google recommends that you set the returnPartialSuccess parameter to true.

SELECT
id,
name,
capacityProvisioningType,
creationTimestamp,
description,
kind,
labelFingerprint,
labels,
performanceProvisioningType,
poolProvisionedCapacityGb,
poolProvisionedIops,
poolProvisionedThroughput,
resourceStatus,
selfLink,
selfLinkWithId,
state,
status,
storagePoolType,
zone
FROM google.compute.storage_pools
WHERE project = '{{ project }}' -- required
AND filter = '{{ filter }}'
AND includeAllScopes = '{{ includeAllScopes }}'
AND maxResults = '{{ maxResults }}'
AND orderBy = '{{ orderBy }}'
AND pageToken = '{{ pageToken }}'
AND returnPartialSuccess = '{{ returnPartialSuccess }}'
AND serviceProjectNumber = '{{ serviceProjectNumber }}';

INSERT examples

insert

Creates a storage pool in the specified project using the data in the request.

INSERT INTO google.compute.storage_pools (
data__kind,
data__id,
data__creationTimestamp,
data__name,
data__description,
data__poolProvisionedCapacityGb,
data__poolProvisionedIops,
data__poolProvisionedThroughput,
data__zone,
data__state,
data__selfLink,
data__selfLinkWithId,
data__labels,
data__labelFingerprint,
data__resourceStatus,
data__storagePoolType,
data__status,
data__capacityProvisioningType,
data__performanceProvisioningType,
project,
zone,
requestId
)
SELECT 
'{{ kind }}',
'{{ id }}',
'{{ creationTimestamp }}',
'{{ name }}',
'{{ description }}',
'{{ poolProvisionedCapacityGb }}',
'{{ poolProvisionedIops }}',
'{{ poolProvisionedThroughput }}',
'{{ zone }}',
'{{ state }}',
'{{ selfLink }}',
'{{ selfLinkWithId }}',
'{{ labels }}',
'{{ labelFingerprint }}',
'{{ resourceStatus }}',
'{{ storagePoolType }}',
'{{ status }}',
'{{ capacityProvisioningType }}',
'{{ performanceProvisioningType }}',
'{{ project }}',
'{{ zone }}',
'{{ requestId }}'
RETURNING
id,
name,
clientOperationId,
creationTimestamp,
description,
endTime,
error,
httpErrorMessage,
httpErrorStatusCode,
insertTime,
instancesBulkInsertOperationMetadata,
kind,
operationGroupId,
operationType,
progress,
region,
selfLink,
setCommonInstanceMetadataOperationMetadata,
startTime,
status,
statusMessage,
targetId,
targetLink,
user,
warnings,
zone
;

Manifest

# Description fields are for documentation purposes
- name: storage_pools
  props:
    - name: project
      value: string
      description: Required parameter for the storage_pools resource.
    - name: zone
      value: string
      description: Required parameter for the storage_pools resource.
    - name: kind
      value: string
      description: >
        [Output Only] Type of the resource. Always compute#storagePool for storage pools.
        
      default: compute#storagePool
    - name: id
      value: string
      description: >
        [Output Only] The unique identifier for the resource. This identifier is defined by the server.
        
    - name: creationTimestamp
      value: string
      description: >
        [Output Only] Creation timestamp in RFC3339 text format.
        
    - name: name
      value: string
      description: >
        Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
        
    - name: description
      value: string
      description: >
        An optional description of this resource. Provide this property when you create the resource.
        
    - name: poolProvisionedCapacityGb
      value: string
      description: >
        Size of the storage pool in GiB. For more information about the size limits, see https://cloud.google.com/compute/docs/disks/storage-pools.
        
    - name: poolProvisionedIops
      value: string
      description: >
        Provisioned IOPS of the storage pool. Only relevant if the storage pool type is hyperdisk-balanced.
        
    - name: poolProvisionedThroughput
      value: string
      description: >
        Provisioned throughput of the storage pool in MiB/s. Only relevant if the storage pool type is hyperdisk-balanced or hyperdisk-throughput.
        
    - name: zone
      value: string
      description: >
        [Output Only] URL of the zone where the storage pool resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
        
    - name: state
      value: string
      description: >
        [Output Only] The status of storage pool creation. - CREATING: Storage pool is provisioning. storagePool. - FAILED: Storage pool creation failed. - READY: Storage pool is ready for use. - DELETING: Storage pool is deleting. 
        
      valid_values: ['CREATING', 'DELETING', 'FAILED', 'READY']
    - name: selfLink
      value: string
      description: >
        [Output Only] Server-defined fully-qualified URL for this resource.
        
    - name: selfLinkWithId
      value: string
      description: >
        [Output Only] Server-defined URL for this resource's resource id.
        
    - name: labels
      value: object
      description: >
        Labels to apply to this storage pool. These can be later modified by the setLabels method.
        
    - name: labelFingerprint
      value: string
      description: >
        A fingerprint for the labels being applied to this storage pool, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a storage pool.
        
    - name: resourceStatus
      value: object
      description: >
        [Output Only] Status information for the storage pool resource.
        
    - name: storagePoolType
      value: string
      description: >
        Type of the storage pool.
        
    - name: status
      value: object
      description: >
        [Output Only] Status information for the storage pool resource.
        
    - name: capacityProvisioningType
      value: string
      description: >
        Provisioning type of the byte capacity of the pool.
        
      valid_values: ['ADVANCED', 'STANDARD', 'UNSPECIFIED']
    - name: performanceProvisioningType
      value: string
      description: >
        Provisioning type of the performance-related parameters of the pool, such as throughput and IOPS.
        
      valid_values: ['ADVANCED', 'STANDARD', 'UNSPECIFIED']
    - name: requestId
      value: string

UPDATE examples

update

Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: pool_provisioned_capacity_gb, pool_provisioned_iops and pool_provisioned_throughput.

UPDATE google.compute.storage_pools
SET 
data__kind = '{{ kind }}',
data__id = '{{ id }}',
data__creationTimestamp = '{{ creationTimestamp }}',
data__name = '{{ name }}',
data__description = '{{ description }}',
data__poolProvisionedCapacityGb = '{{ poolProvisionedCapacityGb }}',
data__poolProvisionedIops = '{{ poolProvisionedIops }}',
data__poolProvisionedThroughput = '{{ poolProvisionedThroughput }}',
data__zone = '{{ zone }}',
data__state = '{{ state }}',
data__selfLink = '{{ selfLink }}',
data__selfLinkWithId = '{{ selfLinkWithId }}',
data__labels = '{{ labels }}',
data__labelFingerprint = '{{ labelFingerprint }}',
data__resourceStatus = '{{ resourceStatus }}',
data__storagePoolType = '{{ storagePoolType }}',
data__status = '{{ status }}',
data__capacityProvisioningType = '{{ capacityProvisioningType }}',
data__performanceProvisioningType = '{{ performanceProvisioningType }}'
WHERE 
project = '{{ project }}' --required
AND zone = '{{ zone }}' --required
AND storagePool = '{{ storagePool }}' --required
AND requestId = '{{ requestId}}'
AND updateMask = '{{ updateMask}}'
RETURNING
id,
name,
clientOperationId,
creationTimestamp,
description,
endTime,
error,
httpErrorMessage,
httpErrorStatusCode,
insertTime,
instancesBulkInsertOperationMetadata,
kind,
operationGroupId,
operationType,
progress,
region,
selfLink,
setCommonInstanceMetadataOperationMetadata,
startTime,
status,
statusMessage,
targetId,
targetLink,
user,
warnings,
zone;

DELETE examples

delete

Deletes the specified storage pool. Deleting a storagePool removes its data permanently and is irreversible. However, deleting a storagePool does not delete any snapshots previously made from the storagePool. You must separately delete snapshots.

DELETE FROM google.compute.storage_pools
WHERE project = '{{ project }}' --required
AND zone = '{{ zone }}' --required
AND storagePool = '{{ storagePool }}' --required
AND requestId = '{{ requestId }}';