DiskClient (Google Cloud 0.119.0-alpha API)

java.lang.Object
- com.google.cloud.compute.v1.DiskClient

All Implemented Interfaces:

com.google.api.gax.core.BackgroundResource, AutoCloseable
```
@Generated(value="by gapic-generator")
 @BetaApi
public class DiskClient
extends Object
implements com.google.api.gax.core.BackgroundResource
```
Service Description: Creates and runs virtual machines on Google Cloud Platform.
This class provides the ability to make remote calls to the backing service through method calls that map to API methods. Sample code to get started:
```
 
 try (DiskClient diskClient = DiskClient.create()) {
   ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
   DisksAddResourcePoliciesRequest disksAddResourcePoliciesRequestResource = DisksAddResourcePoliciesRequest.newBuilder().build();
   Operation response = diskClient.addResourcePoliciesDisk(disk, disksAddResourcePoliciesRequestResource);
 }
 
 
```
Note: close() needs to be called on the diskClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().
The surface of this class includes several types of Java methods for each of the API's methods:
1. A "flattened" method. With this type of method, the fields of the request type have been converted into function parameters. It may be the case that not all fields are available as parameters, and not every API method will have a flattened method entry point.
2. A "request object" method. This type of method only takes one parameter, a request object, which must be constructed before the call. Not every API method will have a request object method.
3. A "callable" method. This type of method takes no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.
See the individual methods for example code.
Many parameters require resource names to be formatted in a particular way. To assist with these names, this class includes a format method for each type of name, and additionally a parse method to extract the individual identifiers contained within names that are returned.
This class can be customized by passing in a custom instance of DiskSettings to create(). For example:
To customize credentials:
```
 
 DiskSettings diskSettings =
     DiskSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 DiskClient diskClient =
     DiskClient.create(diskSettings);
 
 
```
To customize the endpoint:
```
 
 DiskSettings diskSettings =
     DiskSettings.newBuilder().setEndpoint(myEndpoint).build();
 DiskClient diskClient =
     DiskClient.create(diskSettings);
 
 
```

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`DiskClient.AggregatedListDisksFixedSizeCollection`
`static class`	`DiskClient.AggregatedListDisksPage`
`static class`	`DiskClient.AggregatedListDisksPagedResponse`
`static class`	`DiskClient.ListDisksFixedSizeCollection`
`static class`	`DiskClient.ListDisksPage`
`static class`	`DiskClient.ListDisksPagedResponse`

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`DiskClient(DiskSettings settings)` Constructs an instance of DiskClient, using the given settings.
`protected`	`DiskClient(DiskStub stub)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Operation`	`addResourcePoliciesDisk(AddResourcePoliciesDiskHttpRequest request)` Adds existing resource policies to a disk.
`Operation`	`addResourcePoliciesDisk(ProjectZoneDiskName disk, DisksAddResourcePoliciesRequest disksAddResourcePoliciesRequestResource)` Adds existing resource policies to a disk.
`Operation`	`addResourcePoliciesDisk(String disk, DisksAddResourcePoliciesRequest disksAddResourcePoliciesRequestResource)` Adds existing resource policies to a disk.
`com.google.api.gax.rpc.UnaryCallable<AddResourcePoliciesDiskHttpRequest,Operation>`	`addResourcePoliciesDiskCallable()` Adds existing resource policies to a disk.
`DiskClient.AggregatedListDisksPagedResponse`	`aggregatedListDisks(AggregatedListDisksHttpRequest request)` Retrieves an aggregated list of persistent disks.
`DiskClient.AggregatedListDisksPagedResponse`	`aggregatedListDisks(ProjectName project)` Retrieves an aggregated list of persistent disks.
`DiskClient.AggregatedListDisksPagedResponse`	`aggregatedListDisks(String project)` Retrieves an aggregated list of persistent disks.
`com.google.api.gax.rpc.UnaryCallable<AggregatedListDisksHttpRequest,DiskAggregatedList>`	`aggregatedListDisksCallable()` Retrieves an aggregated list of persistent disks.
`com.google.api.gax.rpc.UnaryCallable<AggregatedListDisksHttpRequest,DiskClient.AggregatedListDisksPagedResponse>`	`aggregatedListDisksPagedCallable()` Retrieves an aggregated list of persistent disks.
`boolean`	`awaitTermination(long duration, TimeUnit unit)`
`void`	`close()`
`static DiskClient`	`create()` Constructs an instance of DiskClient with default settings.
`static DiskClient`	`create(DiskSettings settings)` Constructs an instance of DiskClient, using the given settings.
`static DiskClient`	`create(DiskStub stub)` Constructs an instance of DiskClient, using the given stub for making calls.
`Operation`	`createSnapshotDisk(CreateSnapshotDiskHttpRequest request)` Creates a snapshot of a specified persistent disk.
`Operation`	`createSnapshotDisk(ProjectZoneDiskName disk, Boolean guestFlush, Snapshot snapshotResource)` Creates a snapshot of a specified persistent disk.
`Operation`	`createSnapshotDisk(String disk, Boolean guestFlush, Snapshot snapshotResource)` Creates a snapshot of a specified persistent disk.
`com.google.api.gax.rpc.UnaryCallable<CreateSnapshotDiskHttpRequest,Operation>`	`createSnapshotDiskCallable()` Creates a snapshot of a specified persistent disk.
`Operation`	`deleteDisk(DeleteDiskHttpRequest request)` Deletes the specified persistent disk.
`Operation`	`deleteDisk(ProjectZoneDiskName disk)` Deletes the specified persistent disk.
`Operation`	`deleteDisk(String disk)` Deletes the specified persistent disk.
`com.google.api.gax.rpc.UnaryCallable<DeleteDiskHttpRequest,Operation>`	`deleteDiskCallable()` Deletes the specified persistent disk.
`Disk`	`getDisk(GetDiskHttpRequest request)` Returns a specified persistent disk.
`Disk`	`getDisk(ProjectZoneDiskName disk)` Returns a specified persistent disk.
`Disk`	`getDisk(String disk)` Returns a specified persistent disk.
`com.google.api.gax.rpc.UnaryCallable<GetDiskHttpRequest,Disk>`	`getDiskCallable()` Returns a specified persistent disk.
`Policy`	`getIamPolicyDisk(GetIamPolicyDiskHttpRequest request)` Gets the access control policy for a resource.
`Policy`	`getIamPolicyDisk(ProjectZoneDiskResourceName resource)` Gets the access control policy for a resource.
`Policy`	`getIamPolicyDisk(String resource)` Gets the access control policy for a resource.
`com.google.api.gax.rpc.UnaryCallable<GetIamPolicyDiskHttpRequest,Policy>`	`getIamPolicyDiskCallable()` Gets the access control policy for a resource.
`DiskSettings`	`getSettings()`
`DiskStub`	`getStub()`
`Operation`	`insertDisk(InsertDiskHttpRequest request)` Creates a persistent disk in the specified project using the data in the request.
`Operation`	`insertDisk(ProjectZoneName zone, Disk diskResource)` Creates a persistent disk in the specified project using the data in the request.
`Operation`	`insertDisk(String zone, Disk diskResource)` Creates a persistent disk in the specified project using the data in the request.
`com.google.api.gax.rpc.UnaryCallable<InsertDiskHttpRequest,Operation>`	`insertDiskCallable()` Creates a persistent disk in the specified project using the data in the request.
`boolean`	`isShutdown()`
`boolean`	`isTerminated()`
`DiskClient.ListDisksPagedResponse`	`listDisks(ListDisksHttpRequest request)` Retrieves a list of persistent disks contained within the specified zone.
`DiskClient.ListDisksPagedResponse`	`listDisks(ProjectZoneName zone)` Retrieves a list of persistent disks contained within the specified zone.
`DiskClient.ListDisksPagedResponse`	`listDisks(String zone)` Retrieves a list of persistent disks contained within the specified zone.
`com.google.api.gax.rpc.UnaryCallable<ListDisksHttpRequest,DiskList>`	`listDisksCallable()` Retrieves a list of persistent disks contained within the specified zone.
`com.google.api.gax.rpc.UnaryCallable<ListDisksHttpRequest,DiskClient.ListDisksPagedResponse>`	`listDisksPagedCallable()` Retrieves a list of persistent disks contained within the specified zone.
`Operation`	`removeResourcePoliciesDisk(ProjectZoneDiskName disk, DisksRemoveResourcePoliciesRequest disksRemoveResourcePoliciesRequestResource)` Removes resource policies from a disk.
`Operation`	`removeResourcePoliciesDisk(RemoveResourcePoliciesDiskHttpRequest request)` Removes resource policies from a disk.
`Operation`	`removeResourcePoliciesDisk(String disk, DisksRemoveResourcePoliciesRequest disksRemoveResourcePoliciesRequestResource)` Removes resource policies from a disk.
`com.google.api.gax.rpc.UnaryCallable<RemoveResourcePoliciesDiskHttpRequest,Operation>`	`removeResourcePoliciesDiskCallable()` Removes resource policies from a disk.
`Operation`	`resizeDisk(ProjectZoneDiskName disk, DisksResizeRequest disksResizeRequestResource)` Resizes the specified persistent disk.
`Operation`	`resizeDisk(ResizeDiskHttpRequest request)` Resizes the specified persistent disk.
`Operation`	`resizeDisk(String disk, DisksResizeRequest disksResizeRequestResource)` Resizes the specified persistent disk.
`com.google.api.gax.rpc.UnaryCallable<ResizeDiskHttpRequest,Operation>`	`resizeDiskCallable()` Resizes the specified persistent disk.
`Policy`	`setIamPolicyDisk(ProjectZoneDiskResourceName resource, ZoneSetPolicyRequest zoneSetPolicyRequestResource)` Sets the access control policy on the specified resource.
`Policy`	`setIamPolicyDisk(SetIamPolicyDiskHttpRequest request)` Sets the access control policy on the specified resource.
`Policy`	`setIamPolicyDisk(String resource, ZoneSetPolicyRequest zoneSetPolicyRequestResource)` Sets the access control policy on the specified resource.
`com.google.api.gax.rpc.UnaryCallable<SetIamPolicyDiskHttpRequest,Policy>`	`setIamPolicyDiskCallable()` Sets the access control policy on the specified resource.
`Operation`	`setLabelsDisk(ProjectZoneDiskResourceName resource, ZoneSetLabelsRequest zoneSetLabelsRequestResource)` Sets the labels on a disk.
`Operation`	`setLabelsDisk(SetLabelsDiskHttpRequest request)` Sets the labels on a disk.
`Operation`	`setLabelsDisk(String resource, ZoneSetLabelsRequest zoneSetLabelsRequestResource)` Sets the labels on a disk.
`com.google.api.gax.rpc.UnaryCallable<SetLabelsDiskHttpRequest,Operation>`	`setLabelsDiskCallable()` Sets the labels on a disk.
`void`	`shutdown()`
`void`	`shutdownNow()`
`TestPermissionsResponse`	`testIamPermissionsDisk(ProjectZoneDiskResourceName resource, TestPermissionsRequest testPermissionsRequestResource)` Returns permissions that a caller has on the specified resource.
`TestPermissionsResponse`	`testIamPermissionsDisk(String resource, TestPermissionsRequest testPermissionsRequestResource)` Returns permissions that a caller has on the specified resource.
`TestPermissionsResponse`	`testIamPermissionsDisk(TestIamPermissionsDiskHttpRequest request)` Returns permissions that a caller has on the specified resource.
`com.google.api.gax.rpc.UnaryCallable<TestIamPermissionsDiskHttpRequest,TestPermissionsResponse>`	`testIamPermissionsDiskCallable()` Returns permissions that a caller has on the specified resource.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail
- DiskClient
```
protected DiskClient(DiskSettings settings)
              throws IOException
```
  Constructs an instance of DiskClient, using the given settings. This is protected so that it is easy to make a subclass, but otherwise, the static factory methods should be preferred.
  
  Throws:
  
  IOException
- DiskClient
```
@BetaApi(value="A restructuring of stub classes is planned, so this may break in the future")
protected DiskClient(DiskStub stub)
```

Method Detail

create

public static final DiskClient create()
                               throws IOException

Constructs an instance of DiskClient with default settings.

Throws:: IOException

create
```
public static final DiskClient create(DiskSettings settings)
                               throws IOException
```
Constructs an instance of DiskClient, using the given settings. The channels are created based on the settings passed in, or defaults for any settings that are not set.

Throws:

IOException

create

@BetaApi(value="A restructuring of stub classes is planned, so this may break in the future")
public static final DiskClient create(DiskStub stub)

Constructs an instance of DiskClient, using the given stub for making calls. This is for advanced usage - prefer to use DiskSettings}.

getSettings

public final DiskSettings getSettings()

getStub

@BetaApi(value="A restructuring of stub classes is planned, so this may break in the future")
public DiskStub getStub()

addResourcePoliciesDisk

@BetaApi
public final Operation addResourcePoliciesDisk(ProjectZoneDiskName disk,
                                                        DisksAddResourcePoliciesRequest disksAddResourcePoliciesRequestResource)

Adds existing resource policies to a disk. You can only add one policy which will be applied to this disk for scheduling snapshot creation.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
   DisksAddResourcePoliciesRequest disksAddResourcePoliciesRequestResource = DisksAddResourcePoliciesRequest.newBuilder().build();
   Operation response = diskClient.addResourcePoliciesDisk(disk, disksAddResourcePoliciesRequestResource);
 }

Parameters:: disk - The disk name for this request.; disksAddResourcePoliciesRequestResource -
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

addResourcePoliciesDisk

@BetaApi
public final Operation addResourcePoliciesDisk(String disk,
                                                        DisksAddResourcePoliciesRequest disksAddResourcePoliciesRequestResource)

Adds existing resource policies to a disk. You can only add one policy which will be applied to this disk for scheduling snapshot creation.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
   DisksAddResourcePoliciesRequest disksAddResourcePoliciesRequestResource = DisksAddResourcePoliciesRequest.newBuilder().build();
   Operation response = diskClient.addResourcePoliciesDisk(disk.toString(), disksAddResourcePoliciesRequestResource);
 }

Parameters:: disk - The disk name for this request.; disksAddResourcePoliciesRequestResource -
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

addResourcePoliciesDisk

@BetaApi
public final Operation addResourcePoliciesDisk(AddResourcePoliciesDiskHttpRequest request)

Adds existing resource policies to a disk. You can only add one policy which will be applied to this disk for scheduling snapshot creation.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   String formattedDisk = ProjectZoneDiskName.format("[PROJECT]", "[ZONE]", "[DISK]");
   DisksAddResourcePoliciesRequest disksAddResourcePoliciesRequestResource = DisksAddResourcePoliciesRequest.newBuilder().build();
   AddResourcePoliciesDiskHttpRequest request = AddResourcePoliciesDiskHttpRequest.newBuilder()
     .setDisk(formattedDisk)
     .setDisksAddResourcePoliciesRequestResource(disksAddResourcePoliciesRequestResource)
     .build();
   Operation response = diskClient.addResourcePoliciesDisk(request);
 }

Parameters:: request - The request object containing all of the parameters for the API call.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

addResourcePoliciesDiskCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<AddResourcePoliciesDiskHttpRequest,Operation> addResourcePoliciesDiskCallable()

Adds existing resource policies to a disk. You can only add one policy which will be applied to this disk for scheduling snapshot creation.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   String formattedDisk = ProjectZoneDiskName.format("[PROJECT]", "[ZONE]", "[DISK]");
   DisksAddResourcePoliciesRequest disksAddResourcePoliciesRequestResource = DisksAddResourcePoliciesRequest.newBuilder().build();
   AddResourcePoliciesDiskHttpRequest request = AddResourcePoliciesDiskHttpRequest.newBuilder()
     .setDisk(formattedDisk)
     .setDisksAddResourcePoliciesRequestResource(disksAddResourcePoliciesRequestResource)
     .build();
   ApiFuture<Operation> future = diskClient.addResourcePoliciesDiskCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }

aggregatedListDisks

@BetaApi
public final DiskClient.AggregatedListDisksPagedResponse aggregatedListDisks(ProjectName project)

Retrieves an aggregated list of persistent disks.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   ProjectName project = ProjectName.of("[PROJECT]");
   for (DisksScopedList element : diskClient.aggregatedListDisks(project).iterateAll()) {
     // doThingsWith(element);
   }
 }

Parameters:: project - Project ID for this request.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

aggregatedListDisks

@BetaApi
public final DiskClient.AggregatedListDisksPagedResponse aggregatedListDisks(String project)

Retrieves an aggregated list of persistent disks.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   ProjectName project = ProjectName.of("[PROJECT]");
   for (DisksScopedList element : diskClient.aggregatedListDisks(project.toString()).iterateAll()) {
     // doThingsWith(element);
   }
 }

Parameters:: project - Project ID for this request.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

aggregatedListDisks

@BetaApi
public final DiskClient.AggregatedListDisksPagedResponse aggregatedListDisks(AggregatedListDisksHttpRequest request)

Retrieves an aggregated list of persistent disks.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   String formattedProject = ProjectName.format("[PROJECT]");
   AggregatedListDisksHttpRequest request = AggregatedListDisksHttpRequest.newBuilder()
     .setProject(formattedProject)
     .build();
   for (DisksScopedList element : diskClient.aggregatedListDisks(request).iterateAll()) {
     // doThingsWith(element);
   }
 }

Parameters:: request - The request object containing all of the parameters for the API call.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

aggregatedListDisksPagedCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<AggregatedListDisksHttpRequest,DiskClient.AggregatedListDisksPagedResponse> aggregatedListDisksPagedCallable()

Retrieves an aggregated list of persistent disks.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   String formattedProject = ProjectName.format("[PROJECT]");
   AggregatedListDisksHttpRequest request = AggregatedListDisksHttpRequest.newBuilder()
     .setProject(formattedProject)
     .build();
   ApiFuture<AggregatedListDisksPagedResponse> future = diskClient.aggregatedListDisksPagedCallable().futureCall(request);
   // Do something
   for (DisksScopedList element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }

aggregatedListDisksCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<AggregatedListDisksHttpRequest,DiskAggregatedList> aggregatedListDisksCallable()

Retrieves an aggregated list of persistent disks.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   String formattedProject = ProjectName.format("[PROJECT]");
   AggregatedListDisksHttpRequest request = AggregatedListDisksHttpRequest.newBuilder()
     .setProject(formattedProject)
     .build();
   while (true) {
     DiskAggregatedList response = diskClient.aggregatedListDisksCallable().call(request);
     for (DisksScopedList element : response.getItemsMap()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }

createSnapshotDisk
```
@BetaApi
public final Operation createSnapshotDisk(ProjectZoneDiskName disk,
                                                   Boolean guestFlush,
                                                   Snapshot snapshotResource)
```
Creates a snapshot of a specified persistent disk.
Sample code:
```
 try (DiskClient diskClient = DiskClient.create()) {
   ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
   Boolean guestFlush = false;
   Snapshot snapshotResource = Snapshot.newBuilder().build();
   Operation response = diskClient.createSnapshotDisk(disk, guestFlush, snapshotResource);
 }
 
```
Parameters:

disk - Name of the persistent disk to snapshot.

guestFlush - [Input Only] Specifies to create an application consistent snapshot by informing the OS to prepare for the snapshot process. Currently only supported on Windows instances using the Volume Shadow Copy Service (VSS).

snapshotResource - Represents a Persistent Disk Snapshot resource.
You can use snapshots to back up data on a regular interval. For more information, read Creating persistent disk snapshots. (== resource_for beta.snapshots ==) (== resource_for v1.snapshots ==)

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

createSnapshotDisk
```
@BetaApi
public final Operation createSnapshotDisk(String disk,
                                                   Boolean guestFlush,
                                                   Snapshot snapshotResource)
```
Creates a snapshot of a specified persistent disk.
Sample code:
```
 try (DiskClient diskClient = DiskClient.create()) {
   ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
   Boolean guestFlush = false;
   Snapshot snapshotResource = Snapshot.newBuilder().build();
   Operation response = diskClient.createSnapshotDisk(disk.toString(), guestFlush, snapshotResource);
 }
 
```
Parameters:

disk - Name of the persistent disk to snapshot.

guestFlush - [Input Only] Specifies to create an application consistent snapshot by informing the OS to prepare for the snapshot process. Currently only supported on Windows instances using the Volume Shadow Copy Service (VSS).

snapshotResource - Represents a Persistent Disk Snapshot resource.
You can use snapshots to back up data on a regular interval. For more information, read Creating persistent disk snapshots. (== resource_for beta.snapshots ==) (== resource_for v1.snapshots ==)

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

createSnapshotDisk

@BetaApi
public final Operation createSnapshotDisk(CreateSnapshotDiskHttpRequest request)

Creates a snapshot of a specified persistent disk.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   String formattedDisk = ProjectZoneDiskName.format("[PROJECT]", "[ZONE]", "[DISK]");
   Boolean guestFlush = false;
   Snapshot snapshotResource = Snapshot.newBuilder().build();
   CreateSnapshotDiskHttpRequest request = CreateSnapshotDiskHttpRequest.newBuilder()
     .setDisk(formattedDisk)
     .setGuestFlush(guestFlush)
     .setSnapshotResource(snapshotResource)
     .build();
   Operation response = diskClient.createSnapshotDisk(request);
 }

Parameters:: request - The request object containing all of the parameters for the API call.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

createSnapshotDiskCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<CreateSnapshotDiskHttpRequest,Operation> createSnapshotDiskCallable()

Creates a snapshot of a specified persistent disk.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   String formattedDisk = ProjectZoneDiskName.format("[PROJECT]", "[ZONE]", "[DISK]");
   Boolean guestFlush = false;
   Snapshot snapshotResource = Snapshot.newBuilder().build();
   CreateSnapshotDiskHttpRequest request = CreateSnapshotDiskHttpRequest.newBuilder()
     .setDisk(formattedDisk)
     .setGuestFlush(guestFlush)
     .setSnapshotResource(snapshotResource)
     .build();
   ApiFuture<Operation> future = diskClient.createSnapshotDiskCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }

deleteDisk
```
@BetaApi
public final Operation deleteDisk(ProjectZoneDiskName disk)
```
Deletes the specified persistent disk. Deleting a disk removes its data permanently and is irreversible. However, deleting a disk does not delete any snapshots previously made from the disk. You must separately delete snapshots.
Sample code:
```
 try (DiskClient diskClient = DiskClient.create()) {
   ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
   Operation response = diskClient.deleteDisk(disk);
 }
 
```
Parameters:

disk - Name of the persistent disk to delete.

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

deleteDisk
```
@BetaApi
public final Operation deleteDisk(String disk)
```
Deletes the specified persistent disk. Deleting a disk removes its data permanently and is irreversible. However, deleting a disk does not delete any snapshots previously made from the disk. You must separately delete snapshots.
Sample code:
```
 try (DiskClient diskClient = DiskClient.create()) {
   ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
   Operation response = diskClient.deleteDisk(disk.toString());
 }
 
```
Parameters:

disk - Name of the persistent disk to delete.

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

deleteDisk
```
@BetaApi
public final Operation deleteDisk(DeleteDiskHttpRequest request)
```
Deletes the specified persistent disk. Deleting a disk removes its data permanently and is irreversible. However, deleting a disk does not delete any snapshots previously made from the disk. You must separately delete snapshots.
Sample code:
```
 try (DiskClient diskClient = DiskClient.create()) {
   String formattedDisk = ProjectZoneDiskName.format("[PROJECT]", "[ZONE]", "[DISK]");
   DeleteDiskHttpRequest request = DeleteDiskHttpRequest.newBuilder()
     .setDisk(formattedDisk)
     .build();
   Operation response = diskClient.deleteDisk(request);
 }
 
```
Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

deleteDiskCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<DeleteDiskHttpRequest,Operation> deleteDiskCallable()

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

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   String formattedDisk = ProjectZoneDiskName.format("[PROJECT]", "[ZONE]", "[DISK]");
   DeleteDiskHttpRequest request = DeleteDiskHttpRequest.newBuilder()
     .setDisk(formattedDisk)
     .build();
   ApiFuture<Operation> future = diskClient.deleteDiskCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }

getDisk

@BetaApi
public final Disk getDisk(ProjectZoneDiskName disk)

Returns a specified persistent disk. Gets a list of available persistent disks by making a list() request.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
   Disk response = diskClient.getDisk(disk);
 }

Parameters:: disk - Name of the persistent disk to return.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

getDisk

@BetaApi
public final Disk getDisk(String disk)

Returns a specified persistent disk. Gets a list of available persistent disks by making a list() request.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   ProjectZoneDiskName disk = ProjectZoneDiskName.of("[PROJECT]", "[ZONE]", "[DISK]");
   Disk response = diskClient.getDisk(disk.toString());
 }

Parameters:: disk - Name of the persistent disk to return.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

getDisk

@BetaApi
public final Disk getDisk(GetDiskHttpRequest request)

Returns a specified persistent disk. Gets a list of available persistent disks by making a list() request.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   String formattedDisk = ProjectZoneDiskName.format("[PROJECT]", "[ZONE]", "[DISK]");
   GetDiskHttpRequest request = GetDiskHttpRequest.newBuilder()
     .setDisk(formattedDisk)
     .build();
   Disk response = diskClient.getDisk(request);
 }

Parameters:: request - The request object containing all of the parameters for the API call.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

getDiskCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<GetDiskHttpRequest,Disk> getDiskCallable()

Returns a specified persistent disk. Gets a list of available persistent disks by making a list() request.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   String formattedDisk = ProjectZoneDiskName.format("[PROJECT]", "[ZONE]", "[DISK]");
   GetDiskHttpRequest request = GetDiskHttpRequest.newBuilder()
     .setDisk(formattedDisk)
     .build();
   ApiFuture<Disk> future = diskClient.getDiskCallable().futureCall(request);
   // Do something
   Disk response = future.get();
 }

getIamPolicyDisk

@BetaApi
public final Policy getIamPolicyDisk(ProjectZoneDiskResourceName resource)

Gets the access control policy for a resource. May be empty if no such policy or resource exists.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   ProjectZoneDiskResourceName resource = ProjectZoneDiskResourceName.of("[PROJECT]", "[ZONE]", "[RESOURCE]");
   Policy response = diskClient.getIamPolicyDisk(resource);
 }

Parameters:: resource - Name or id of the resource for this request.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

getIamPolicyDisk

@BetaApi
public final Policy getIamPolicyDisk(String resource)

Gets the access control policy for a resource. May be empty if no such policy or resource exists.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   ProjectZoneDiskResourceName resource = ProjectZoneDiskResourceName.of("[PROJECT]", "[ZONE]", "[RESOURCE]");
   Policy response = diskClient.getIamPolicyDisk(resource.toString());
 }

Parameters:: resource - Name or id of the resource for this request.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

getIamPolicyDisk

@BetaApi
public final Policy getIamPolicyDisk(GetIamPolicyDiskHttpRequest request)

Gets the access control policy for a resource. May be empty if no such policy or resource exists.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   String formattedResource = ProjectZoneDiskResourceName.format("[PROJECT]", "[ZONE]", "[RESOURCE]");
   GetIamPolicyDiskHttpRequest request = GetIamPolicyDiskHttpRequest.newBuilder()
     .setResource(formattedResource)
     .build();
   Policy response = diskClient.getIamPolicyDisk(request);
 }

Parameters:: request - The request object containing all of the parameters for the API call.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

getIamPolicyDiskCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<GetIamPolicyDiskHttpRequest,Policy> getIamPolicyDiskCallable()

Gets the access control policy for a resource. May be empty if no such policy or resource exists.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   String formattedResource = ProjectZoneDiskResourceName.format("[PROJECT]", "[ZONE]", "[RESOURCE]");
   GetIamPolicyDiskHttpRequest request = GetIamPolicyDiskHttpRequest.newBuilder()
     .setResource(formattedResource)
     .build();
   ApiFuture<Policy> future = diskClient.getIamPolicyDiskCallable().futureCall(request);
   // Do something
   Policy response = future.get();
 }

insertDisk
```
@BetaApi
public final Operation insertDisk(ProjectZoneName zone,
                                           Disk diskResource)
```
Creates a persistent disk in the specified project using the data in the request. You can create a disk with a sourceImage, a sourceSnapshot, or create an empty 500 GB data disk by omitting all properties. You can also create a disk that is larger than the default size by specifying the sizeGb property.
Sample code:
```
 try (DiskClient diskClient = DiskClient.create()) {
   ProjectZoneName zone = ProjectZoneName.of("[PROJECT]", "[ZONE]");
   Disk diskResource = Disk.newBuilder().build();
   Operation response = diskClient.insertDisk(zone, diskResource);
 }
 
```
Parameters:

zone - The name of the zone for this request.

diskResource - Represents a Persistent Disk resource.
Persistent disks are required for running your VM instances. Create both boot and non-boot (data) persistent disks. For more information, read Persistent Disks. For more storage options, read Storage options.
The disks resource represents a zonal persistent disk. For more information, read Zonal persistent disks.
The regionDisks resource represents a regional persistent disk. For more information, read Regional resources. (== resource_for beta.disks ==) (== resource_for v1.disks ==) (== resource_for v1.regionDisks ==) (== resource_for beta.regionDisks ==)

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

insertDisk
```
@BetaApi
public final Operation insertDisk(String zone,
                                           Disk diskResource)
```
Creates a persistent disk in the specified project using the data in the request. You can create a disk with a sourceImage, a sourceSnapshot, or create an empty 500 GB data disk by omitting all properties. You can also create a disk that is larger than the default size by specifying the sizeGb property.
Sample code:
```
 try (DiskClient diskClient = DiskClient.create()) {
   ProjectZoneName zone = ProjectZoneName.of("[PROJECT]", "[ZONE]");
   Disk diskResource = Disk.newBuilder().build();
   Operation response = diskClient.insertDisk(zone.toString(), diskResource);
 }
 
```
Parameters:

zone - The name of the zone for this request.

diskResource - Represents a Persistent Disk resource.
Persistent disks are required for running your VM instances. Create both boot and non-boot (data) persistent disks. For more information, read Persistent Disks. For more storage options, read Storage options.
The disks resource represents a zonal persistent disk. For more information, read Zonal persistent disks.
The regionDisks resource represents a regional persistent disk. For more information, read Regional resources. (== resource_for beta.disks ==) (== resource_for v1.disks ==) (== resource_for v1.regionDisks ==) (== resource_for beta.regionDisks ==)

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

insertDisk
```
@BetaApi
public final Operation insertDisk(InsertDiskHttpRequest request)
```
Creates a persistent disk in the specified project using the data in the request. You can create a disk with a sourceImage, a sourceSnapshot, or create an empty 500 GB data disk by omitting all properties. You can also create a disk that is larger than the default size by specifying the sizeGb property.
Sample code:
```
 try (DiskClient diskClient = DiskClient.create()) {
   String formattedZone = ProjectZoneName.format("[PROJECT]", "[ZONE]");
   Disk diskResource = Disk.newBuilder().build();
   InsertDiskHttpRequest request = InsertDiskHttpRequest.newBuilder()
     .setZone(formattedZone)
     .setDiskResource(diskResource)
     .build();
   Operation response = diskClient.insertDisk(request);
 }
 
```
Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

insertDiskCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<InsertDiskHttpRequest,Operation> insertDiskCallable()

Creates a persistent disk in the specified project using the data in the request. You can create a disk with a sourceImage, a sourceSnapshot, or create an empty 500 GB data disk by omitting all properties. You can also create a disk that is larger than the default size by specifying the sizeGb property.

Sample code:


 try (DiskClient diskClient = DiskClient.create()) {
   String formattedZone = ProjectZoneName.format("[PROJECT]", "[ZONE]");
   Disk diskResource = Disk.newBuilder().build();
   InsertDiskHttpRequest request = InsertDiskHttpRequest.newBuilder()
     .setZone(formattedZone)
     .setDiskResource(diskResource)
     .build();
   ApiFuture<Operation> future = diskClient.insertDiskCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }