deleteDisk method

Future<DeleteDiskResult> deleteDisk({
  1. required String diskName,
  2. bool? forceDeleteAddOns,
})

Deletes the specified block storage disk. The disk must be in the available state (not attached to a Lightsail instance). The delete disk operation supports tag-based access control via resource tags applied to the resource identified by disk name. For more information, see the Lightsail Dev Guide.

May throw ServiceException. May throw InvalidInputException. May throw NotFoundException. May throw OperationFailureException. May throw AccessDeniedException. May throw AccountSetupInProgressException. May throw UnauthenticatedException.

Parameter diskName : The unique name of the disk you want to delete (e.g., my-disk).

Parameter forceDeleteAddOns : A Boolean value to indicate whether to delete the enabled add-ons for the disk.

Implementation

Future<DeleteDiskResult> deleteDisk({
  required String diskName,
  bool? forceDeleteAddOns,
}) async {
  ArgumentError.checkNotNull(diskName, 'diskName');
  final headers = <String, String>{
    'Content-Type': 'application/x-amz-json-1.1',
    'X-Amz-Target': 'Lightsail_20161128.DeleteDisk'
  };
  final jsonResponse = await _protocol.send(
    method: 'POST',
    requestUri: '/',
    exceptionFnMap: _exceptionFns,
    // TODO queryParams
    headers: headers,
    payload: {
      'diskName': diskName,
      if (forceDeleteAddOns != null) 'forceDeleteAddOns': forceDeleteAddOns,
    },
  );

  return DeleteDiskResult.fromJson(jsonResponse.body);
}