Skip to main content

disk_pools

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

Overview

Namedisk_pools
TypeResource
Idazure.storage_pool.disk_pools

Fields

NameDatatypeDescription
additional_capabilitiestextfield from the properties object
availability_zonestextfield from the properties object
diskPoolNametextfield from the properties object
diskstextfield from the properties object
locationtextThe geo-location where the resource lives.
managed_bytextfield from the properties object
managed_by_extendedtextfield from the properties object
provisioning_statetextfield from the properties object
resourceGroupNametextfield from the properties object
skutextSku for ARM resource
statustextfield from the properties object
subnet_idtextfield from the properties object
subscriptionIdtextfield from the properties object
system_datatextfield from the properties object
tagstextResource tags.

Methods

NameAccessible byRequired ParamsDescription
getSELECTdiskPoolName, resourceGroupName, subscriptionIdGet a Disk pool.
list_by_resource_groupSELECTresourceGroupName, subscriptionIdGets a list of DiskPools in a resource group.
list_by_subscriptionSELECTsubscriptionIdGets a list of Disk Pools in a subscription
create_or_updateINSERTdiskPoolName, resourceGroupName, subscriptionId, data__location, data__properties, data__skuCreate or Update Disk pool. This create or update operation can take 15 minutes to complete. This is expected service behavior.
deleteDELETEdiskPoolName, resourceGroupName, subscriptionIdDelete a Disk pool; attached disks are not affected. This delete operation can take 10 minutes to complete. This is expected service behavior.
updateUPDATEdiskPoolName, resourceGroupName, subscriptionId, data__propertiesUpdate a Disk pool.
deallocateEXECdiskPoolName, resourceGroupName, subscriptionIdShuts down the Disk Pool and releases the compute resources. You are not billed for the compute resources that this Disk Pool uses. This operation can take 10 minutes to complete. This is expected service behavior.
startEXECdiskPoolName, resourceGroupName, subscriptionIdThe operation to start a Disk Pool. This start operation can take 10 minutes to complete. This is expected service behavior.
upgradeEXECdiskPoolName, resourceGroupName, subscriptionIdUpgrade replaces the underlying virtual machine hosts one at a time. This operation can take 10-15 minutes to complete. This is expected service behavior.

SELECT examples

Gets a list of Disk Pools in a subscription

SELECT
additional_capabilities,
availability_zones,
diskPoolName,
disks,
location,
managed_by,
managed_by_extended,
provisioning_state,
resourceGroupName,
sku,
status,
subnet_id,
subscriptionId,
system_data,
tags
FROM azure.storage_pool.vw_disk_pools
WHERE subscriptionId = '{{ subscriptionId }}';

INSERT example

Use the following StackQL query and manifest file to create a new disk_pools resource.

/*+ create */
INSERT INTO azure.storage_pool.disk_pools (
diskPoolName,
resourceGroupName,
subscriptionId,
data__location,
data__properties,
data__sku,
sku,
properties,
tags,
location,
managedBy,
managedByExtended
)
SELECT
'{{ diskPoolName }}',
'{{ resourceGroupName }}',
'{{ subscriptionId }}',
'{{ data__location }}',
'{{ data__properties }}',
'{{ data__sku }}',
'{{ sku }}',
'{{ properties }}',
'{{ tags }}',
'{{ location }}',
'{{ managedBy }}',
'{{ managedByExtended }}'
;

UPDATE example

Updates a disk_pools resource.

/*+ update */
UPDATE azure.storage_pool.disk_pools
SET
managedBy = '{{ managedBy }}',
managedByExtended = '{{ managedByExtended }}',
properties = '{{ properties }}',
sku = '{{ sku }}',
tags = '{{ tags }}'
WHERE
diskPoolName = '{{ diskPoolName }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND subscriptionId = '{{ subscriptionId }}'
AND data__properties = '{{ data__properties }}';

DELETE example

Deletes the specified disk_pools resource.

/*+ delete */
DELETE FROM azure.storage_pool.disk_pools
WHERE diskPoolName = '{{ diskPoolName }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND subscriptionId = '{{ subscriptionId }}';