Class OsConfigServiceClient

java.lang.Object
com.google.cloud.osconfig.v1beta.OsConfigServiceClient
All Implemented Interfaces:
BackgroundResource, AutoCloseable

@BetaApi @Generated("by gapic-generator-java") public class OsConfigServiceClient extends Object implements BackgroundResource
Service Description: OS Config API

The OS Config service is a server-side component that you can use to manage package installations and patch jobs for virtual machine instances.

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:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
   PatchJobs.ExecutePatchJobRequest request =
       PatchJobs.ExecutePatchJobRequest.newBuilder()
           .setParent("parent-995424086")
           .setDescription("description-1724546052")
           .setInstanceFilter(PatchJobs.PatchInstanceFilter.newBuilder().build())
           .setPatchConfig(PatchJobs.PatchConfig.newBuilder().build())
           .setDuration(Duration.newBuilder().build())
           .setDryRun(true)
           .setDisplayName("displayName1714148973")
           .setRollout(PatchJobs.PatchRollout.newBuilder().build())
           .build();
   PatchJobs.PatchJob response = osConfigServiceClient.executePatchJob(request);
 }
 

Note: close() needs to be called on the OsConfigServiceClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().

Methods
Method Description Method Variants

ExecutePatchJob

Patch VM instances by creating and running a patch job.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • executePatchJob(PatchJobs.ExecutePatchJobRequest request)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • executePatchJobCallable()

GetPatchJob

Get the patch job. This can be used to track the progress of an ongoing patch job or review the details of completed jobs.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • getPatchJob(PatchJobs.GetPatchJobRequest request)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • getPatchJobCallable()

CancelPatchJob

Cancel a patch job. The patch job must be active. Canceled patch jobs cannot be restarted.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • cancelPatchJob(PatchJobs.CancelPatchJobRequest request)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • cancelPatchJobCallable()

ListPatchJobs

Get a list of patch jobs.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • listPatchJobs(PatchJobs.ListPatchJobsRequest request)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • listPatchJobsPagedCallable()

  • listPatchJobsCallable()

ListPatchJobInstanceDetails

Get a list of instance details for a given patch job.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • listPatchJobInstanceDetails(PatchJobs.ListPatchJobInstanceDetailsRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • listPatchJobInstanceDetails(String parent)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • listPatchJobInstanceDetailsPagedCallable()

  • listPatchJobInstanceDetailsCallable()

CreatePatchDeployment

Create an OS Config patch deployment.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • createPatchDeployment(PatchDeployments.CreatePatchDeploymentRequest request)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • createPatchDeploymentCallable()

GetPatchDeployment

Get an OS Config patch deployment.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • getPatchDeployment(PatchDeployments.GetPatchDeploymentRequest request)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • getPatchDeploymentCallable()

ListPatchDeployments

Get a page of OS Config patch deployments.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • listPatchDeployments(PatchDeployments.ListPatchDeploymentsRequest request)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • listPatchDeploymentsPagedCallable()

  • listPatchDeploymentsCallable()

DeletePatchDeployment

Delete an OS Config patch deployment.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • deletePatchDeployment(PatchDeployments.DeletePatchDeploymentRequest request)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • deletePatchDeploymentCallable()

UpdatePatchDeployment

Update an OS Config patch deployment.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • updatePatchDeployment(PatchDeployments.UpdatePatchDeploymentRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • updatePatchDeployment(PatchDeployments.PatchDeployment patchDeployment, FieldMask updateMask)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • updatePatchDeploymentCallable()

PausePatchDeployment

Change state of patch deployment to "PAUSED". Patch deployment in paused state doesn't generate patch jobs.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • pausePatchDeployment(PatchDeployments.PausePatchDeploymentRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • pausePatchDeployment(PatchDeploymentName name)

  • pausePatchDeployment(String name)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • pausePatchDeploymentCallable()

ResumePatchDeployment

Change state of patch deployment back to "ACTIVE". Patch deployment in active state continues to generate patch jobs.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • resumePatchDeployment(PatchDeployments.ResumePatchDeploymentRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • resumePatchDeployment(PatchDeploymentName name)

  • resumePatchDeployment(String name)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • resumePatchDeploymentCallable()

CreateGuestPolicy

Create an OS Config guest policy.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • createGuestPolicy(GuestPolicies.CreateGuestPolicyRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • createGuestPolicy(ProjectName parent, GuestPolicies.GuestPolicy guestPolicy)

  • createGuestPolicy(String parent, GuestPolicies.GuestPolicy guestPolicy)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • createGuestPolicyCallable()

GetGuestPolicy

Get an OS Config guest policy.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • getGuestPolicy(GuestPolicies.GetGuestPolicyRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • getGuestPolicy(GuestPolicyName name)

  • getGuestPolicy(String name)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • getGuestPolicyCallable()

ListGuestPolicies

Get a page of OS Config guest policies.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • listGuestPolicies(GuestPolicies.ListGuestPoliciesRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • listGuestPolicies(ProjectName parent)

  • listGuestPolicies(String parent)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • listGuestPoliciesPagedCallable()

  • listGuestPoliciesCallable()

UpdateGuestPolicy

Update an OS Config guest policy.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • updateGuestPolicy(GuestPolicies.UpdateGuestPolicyRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • updateGuestPolicy(GuestPolicies.GuestPolicy guestPolicy, FieldMask updateMask)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • updateGuestPolicyCallable()

DeleteGuestPolicy

Delete an OS Config guest policy.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • deleteGuestPolicy(GuestPolicies.DeleteGuestPolicyRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • deleteGuestPolicy(GuestPolicyName name)

  • deleteGuestPolicy(String name)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • deleteGuestPolicyCallable()

LookupEffectiveGuestPolicy

Lookup the effective guest policy that applies to a VM instance. This lookup merges all policies that are assigned to the instance ancestry.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • lookupEffectiveGuestPolicy(GuestPolicies.LookupEffectiveGuestPolicyRequest request)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • lookupEffectiveGuestPolicyCallable()

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 OsConfigServiceSettings to create(). For example:

To customize credentials:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 OsConfigServiceSettings osConfigServiceSettings =
     OsConfigServiceSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 OsConfigServiceClient osConfigServiceClient =
     OsConfigServiceClient.create(osConfigServiceSettings);
 

To customize the endpoint:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 OsConfigServiceSettings osConfigServiceSettings =
     OsConfigServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
 OsConfigServiceClient osConfigServiceClient =
     OsConfigServiceClient.create(osConfigServiceSettings);
 

To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over the wire:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 OsConfigServiceSettings osConfigServiceSettings =
     OsConfigServiceSettings.newHttpJsonBuilder().build();
 OsConfigServiceClient osConfigServiceClient =
     OsConfigServiceClient.create(osConfigServiceSettings);
 

Please refer to the GitHub repository's samples for more quickstart code snippets.

  • Constructor Details

    • OsConfigServiceClient

      protected OsConfigServiceClient(OsConfigServiceSettings settings) throws IOException
      Constructs an instance of OsConfigServiceClient, 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
    • OsConfigServiceClient

      protected OsConfigServiceClient(OsConfigServiceStub stub)
  • Method Details

    • create

      public static final OsConfigServiceClient create() throws IOException
      Constructs an instance of OsConfigServiceClient with default settings.
      Throws:
      IOException
    • create

      public static final OsConfigServiceClient create(OsConfigServiceSettings settings) throws IOException
      Constructs an instance of OsConfigServiceClient, 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

      public static final OsConfigServiceClient create(OsConfigServiceStub stub)
      Constructs an instance of OsConfigServiceClient, using the given stub for making calls. This is for advanced usage - prefer using create(OsConfigServiceSettings).
    • getSettings

      public final OsConfigServiceSettings getSettings()
    • getStub

      public OsConfigServiceStub getStub()
    • executePatchJob

      public final PatchJobs.PatchJob executePatchJob(PatchJobs.ExecutePatchJobRequest request)
      Patch VM instances by creating and running a patch job.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchJobs.ExecutePatchJobRequest request =
             PatchJobs.ExecutePatchJobRequest.newBuilder()
                 .setParent("parent-995424086")
                 .setDescription("description-1724546052")
                 .setInstanceFilter(PatchJobs.PatchInstanceFilter.newBuilder().build())
                 .setPatchConfig(PatchJobs.PatchConfig.newBuilder().build())
                 .setDuration(Duration.newBuilder().build())
                 .setDryRun(true)
                 .setDisplayName("displayName1714148973")
                 .setRollout(PatchJobs.PatchRollout.newBuilder().build())
                 .build();
         PatchJobs.PatchJob response = osConfigServiceClient.executePatchJob(request);
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • executePatchJobCallable

      public final UnaryCallable<PatchJobs.ExecutePatchJobRequest,PatchJobs.PatchJob> executePatchJobCallable()
      Patch VM instances by creating and running a patch job.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchJobs.ExecutePatchJobRequest request =
             PatchJobs.ExecutePatchJobRequest.newBuilder()
                 .setParent("parent-995424086")
                 .setDescription("description-1724546052")
                 .setInstanceFilter(PatchJobs.PatchInstanceFilter.newBuilder().build())
                 .setPatchConfig(PatchJobs.PatchConfig.newBuilder().build())
                 .setDuration(Duration.newBuilder().build())
                 .setDryRun(true)
                 .setDisplayName("displayName1714148973")
                 .setRollout(PatchJobs.PatchRollout.newBuilder().build())
                 .build();
         ApiFuture<PatchJobs.PatchJob> future =
             osConfigServiceClient.executePatchJobCallable().futureCall(request);
         // Do something.
         PatchJobs.PatchJob response = future.get();
       }
       
    • getPatchJob

      public final PatchJobs.PatchJob getPatchJob(PatchJobs.GetPatchJobRequest request)
      Get the patch job. This can be used to track the progress of an ongoing patch job or review the details of completed jobs.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchJobs.GetPatchJobRequest request =
             PatchJobs.GetPatchJobRequest.newBuilder().setName("name3373707").build();
         PatchJobs.PatchJob response = osConfigServiceClient.getPatchJob(request);
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • getPatchJobCallable

      public final UnaryCallable<PatchJobs.GetPatchJobRequest,PatchJobs.PatchJob> getPatchJobCallable()
      Get the patch job. This can be used to track the progress of an ongoing patch job or review the details of completed jobs.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchJobs.GetPatchJobRequest request =
             PatchJobs.GetPatchJobRequest.newBuilder().setName("name3373707").build();
         ApiFuture<PatchJobs.PatchJob> future =
             osConfigServiceClient.getPatchJobCallable().futureCall(request);
         // Do something.
         PatchJobs.PatchJob response = future.get();
       }
       
    • cancelPatchJob

      public final PatchJobs.PatchJob cancelPatchJob(PatchJobs.CancelPatchJobRequest request)
      Cancel a patch job. The patch job must be active. Canceled patch jobs cannot be restarted.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchJobs.CancelPatchJobRequest request =
             PatchJobs.CancelPatchJobRequest.newBuilder().setName("name3373707").build();
         PatchJobs.PatchJob response = osConfigServiceClient.cancelPatchJob(request);
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • cancelPatchJobCallable

      public final UnaryCallable<PatchJobs.CancelPatchJobRequest,PatchJobs.PatchJob> cancelPatchJobCallable()
      Cancel a patch job. The patch job must be active. Canceled patch jobs cannot be restarted.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchJobs.CancelPatchJobRequest request =
             PatchJobs.CancelPatchJobRequest.newBuilder().setName("name3373707").build();
         ApiFuture<PatchJobs.PatchJob> future =
             osConfigServiceClient.cancelPatchJobCallable().futureCall(request);
         // Do something.
         PatchJobs.PatchJob response = future.get();
       }
       
    • listPatchJobs

      Get a list of patch jobs.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchJobs.ListPatchJobsRequest request =
             PatchJobs.ListPatchJobsRequest.newBuilder()
                 .setParent("parent-995424086")
                 .setPageSize(883849137)
                 .setPageToken("pageToken873572522")
                 .setFilter("filter-1274492040")
                 .build();
         for (PatchJobs.PatchJob element : osConfigServiceClient.listPatchJobs(request).iterateAll()) {
           // doThingsWith(element);
         }
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • listPatchJobsPagedCallable

      Get a list of patch jobs.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchJobs.ListPatchJobsRequest request =
             PatchJobs.ListPatchJobsRequest.newBuilder()
                 .setParent("parent-995424086")
                 .setPageSize(883849137)
                 .setPageToken("pageToken873572522")
                 .setFilter("filter-1274492040")
                 .build();
         ApiFuture<PatchJobs.PatchJob> future =
             osConfigServiceClient.listPatchJobsPagedCallable().futureCall(request);
         // Do something.
         for (PatchJobs.PatchJob element : future.get().iterateAll()) {
           // doThingsWith(element);
         }
       }
       
    • listPatchJobsCallable

      Get a list of patch jobs.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchJobs.ListPatchJobsRequest request =
             PatchJobs.ListPatchJobsRequest.newBuilder()
                 .setParent("parent-995424086")
                 .setPageSize(883849137)
                 .setPageToken("pageToken873572522")
                 .setFilter("filter-1274492040")
                 .build();
         while (true) {
           PatchJobs.ListPatchJobsResponse response =
               osConfigServiceClient.listPatchJobsCallable().call(request);
           for (PatchJobs.PatchJob element : response.getPatchJobsList()) {
             // doThingsWith(element);
           }
           String nextPageToken = response.getNextPageToken();
           if (!Strings.isNullOrEmpty(nextPageToken)) {
             request = request.toBuilder().setPageToken(nextPageToken).build();
           } else {
             break;
           }
         }
       }
       
    • listPatchJobInstanceDetails

      public final OsConfigServiceClient.ListPatchJobInstanceDetailsPagedResponse listPatchJobInstanceDetails(String parent)
      Get a list of instance details for a given patch job.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         String parent = "parent-995424086";
         for (PatchJobs.PatchJobInstanceDetails element :
             osConfigServiceClient.listPatchJobInstanceDetails(parent).iterateAll()) {
           // doThingsWith(element);
         }
       }
       
      Parameters:
      parent - Required. The parent for the instances are in the form of `projects/*/patchJobs/*`.
      Throws:
      ApiException - if the remote call fails
    • listPatchJobInstanceDetails

      Get a list of instance details for a given patch job.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchJobs.ListPatchJobInstanceDetailsRequest request =
             PatchJobs.ListPatchJobInstanceDetailsRequest.newBuilder()
                 .setParent("parent-995424086")
                 .setPageSize(883849137)
                 .setPageToken("pageToken873572522")
                 .setFilter("filter-1274492040")
                 .build();
         for (PatchJobs.PatchJobInstanceDetails element :
             osConfigServiceClient.listPatchJobInstanceDetails(request).iterateAll()) {
           // doThingsWith(element);
         }
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • listPatchJobInstanceDetailsPagedCallable

      Get a list of instance details for a given patch job.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchJobs.ListPatchJobInstanceDetailsRequest request =
             PatchJobs.ListPatchJobInstanceDetailsRequest.newBuilder()
                 .setParent("parent-995424086")
                 .setPageSize(883849137)
                 .setPageToken("pageToken873572522")
                 .setFilter("filter-1274492040")
                 .build();
         ApiFuture<PatchJobs.PatchJobInstanceDetails> future =
             osConfigServiceClient.listPatchJobInstanceDetailsPagedCallable().futureCall(request);
         // Do something.
         for (PatchJobs.PatchJobInstanceDetails element : future.get().iterateAll()) {
           // doThingsWith(element);
         }
       }
       
    • listPatchJobInstanceDetailsCallable

      Get a list of instance details for a given patch job.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchJobs.ListPatchJobInstanceDetailsRequest request =
             PatchJobs.ListPatchJobInstanceDetailsRequest.newBuilder()
                 .setParent("parent-995424086")
                 .setPageSize(883849137)
                 .setPageToken("pageToken873572522")
                 .setFilter("filter-1274492040")
                 .build();
         while (true) {
           PatchJobs.ListPatchJobInstanceDetailsResponse response =
               osConfigServiceClient.listPatchJobInstanceDetailsCallable().call(request);
           for (PatchJobs.PatchJobInstanceDetails element :
               response.getPatchJobInstanceDetailsList()) {
             // doThingsWith(element);
           }
           String nextPageToken = response.getNextPageToken();
           if (!Strings.isNullOrEmpty(nextPageToken)) {
             request = request.toBuilder().setPageToken(nextPageToken).build();
           } else {
             break;
           }
         }
       }
       
    • createPatchDeployment

      Create an OS Config patch deployment.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeployments.CreatePatchDeploymentRequest request =
             PatchDeployments.CreatePatchDeploymentRequest.newBuilder()
                 .setParent("parent-995424086")
                 .setPatchDeploymentId("patchDeploymentId-1180405976")
                 .setPatchDeployment(PatchDeployments.PatchDeployment.newBuilder().build())
                 .build();
         PatchDeployments.PatchDeployment response =
             osConfigServiceClient.createPatchDeployment(request);
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • createPatchDeploymentCallable

      Create an OS Config patch deployment.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeployments.CreatePatchDeploymentRequest request =
             PatchDeployments.CreatePatchDeploymentRequest.newBuilder()
                 .setParent("parent-995424086")
                 .setPatchDeploymentId("patchDeploymentId-1180405976")
                 .setPatchDeployment(PatchDeployments.PatchDeployment.newBuilder().build())
                 .build();
         ApiFuture<PatchDeployments.PatchDeployment> future =
             osConfigServiceClient.createPatchDeploymentCallable().futureCall(request);
         // Do something.
         PatchDeployments.PatchDeployment response = future.get();
       }
       
    • getPatchDeployment

      Get an OS Config patch deployment.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeployments.GetPatchDeploymentRequest request =
             PatchDeployments.GetPatchDeploymentRequest.newBuilder().setName("name3373707").build();
         PatchDeployments.PatchDeployment response = osConfigServiceClient.getPatchDeployment(request);
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • getPatchDeploymentCallable

      Get an OS Config patch deployment.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeployments.GetPatchDeploymentRequest request =
             PatchDeployments.GetPatchDeploymentRequest.newBuilder().setName("name3373707").build();
         ApiFuture<PatchDeployments.PatchDeployment> future =
             osConfigServiceClient.getPatchDeploymentCallable().futureCall(request);
         // Do something.
         PatchDeployments.PatchDeployment response = future.get();
       }
       
    • listPatchDeployments

      Get a page of OS Config patch deployments.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeployments.ListPatchDeploymentsRequest request =
             PatchDeployments.ListPatchDeploymentsRequest.newBuilder()
                 .setParent("parent-995424086")
                 .setPageSize(883849137)
                 .setPageToken("pageToken873572522")
                 .build();
         for (PatchDeployments.PatchDeployment element :
             osConfigServiceClient.listPatchDeployments(request).iterateAll()) {
           // doThingsWith(element);
         }
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • listPatchDeploymentsPagedCallable

      Get a page of OS Config patch deployments.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeployments.ListPatchDeploymentsRequest request =
             PatchDeployments.ListPatchDeploymentsRequest.newBuilder()
                 .setParent("parent-995424086")
                 .setPageSize(883849137)
                 .setPageToken("pageToken873572522")
                 .build();
         ApiFuture<PatchDeployments.PatchDeployment> future =
             osConfigServiceClient.listPatchDeploymentsPagedCallable().futureCall(request);
         // Do something.
         for (PatchDeployments.PatchDeployment element : future.get().iterateAll()) {
           // doThingsWith(element);
         }
       }
       
    • listPatchDeploymentsCallable

      Get a page of OS Config patch deployments.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeployments.ListPatchDeploymentsRequest request =
             PatchDeployments.ListPatchDeploymentsRequest.newBuilder()
                 .setParent("parent-995424086")
                 .setPageSize(883849137)
                 .setPageToken("pageToken873572522")
                 .build();
         while (true) {
           PatchDeployments.ListPatchDeploymentsResponse response =
               osConfigServiceClient.listPatchDeploymentsCallable().call(request);
           for (PatchDeployments.PatchDeployment element : response.getPatchDeploymentsList()) {
             // doThingsWith(element);
           }
           String nextPageToken = response.getNextPageToken();
           if (!Strings.isNullOrEmpty(nextPageToken)) {
             request = request.toBuilder().setPageToken(nextPageToken).build();
           } else {
             break;
           }
         }
       }
       
    • deletePatchDeployment

      public final void deletePatchDeployment(PatchDeployments.DeletePatchDeploymentRequest request)
      Delete an OS Config patch deployment.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeployments.DeletePatchDeploymentRequest request =
             PatchDeployments.DeletePatchDeploymentRequest.newBuilder().setName("name3373707").build();
         osConfigServiceClient.deletePatchDeployment(request);
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • deletePatchDeploymentCallable

      public final UnaryCallable<PatchDeployments.DeletePatchDeploymentRequest,com.google.protobuf.Empty> deletePatchDeploymentCallable()
      Delete an OS Config patch deployment.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeployments.DeletePatchDeploymentRequest request =
             PatchDeployments.DeletePatchDeploymentRequest.newBuilder().setName("name3373707").build();
         ApiFuture<Empty> future =
             osConfigServiceClient.deletePatchDeploymentCallable().futureCall(request);
         // Do something.
         future.get();
       }
       
    • updatePatchDeployment

      public final PatchDeployments.PatchDeployment updatePatchDeployment(PatchDeployments.PatchDeployment patchDeployment, com.google.protobuf.FieldMask updateMask)
      Update an OS Config patch deployment.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeployments.PatchDeployment patchDeployment =
             PatchDeployments.PatchDeployment.newBuilder().build();
         FieldMask updateMask = FieldMask.newBuilder().build();
         PatchDeployments.PatchDeployment response =
             osConfigServiceClient.updatePatchDeployment(patchDeployment, updateMask);
       }
       
      Parameters:
      patchDeployment - Required. The patch deployment to Update.
      updateMask - Optional. Field mask that controls which fields of the patch deployment should be updated.
      Throws:
      ApiException - if the remote call fails
    • updatePatchDeployment

      Update an OS Config patch deployment.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeployments.UpdatePatchDeploymentRequest request =
             PatchDeployments.UpdatePatchDeploymentRequest.newBuilder()
                 .setPatchDeployment(PatchDeployments.PatchDeployment.newBuilder().build())
                 .setUpdateMask(FieldMask.newBuilder().build())
                 .build();
         PatchDeployments.PatchDeployment response =
             osConfigServiceClient.updatePatchDeployment(request);
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • updatePatchDeploymentCallable

      Update an OS Config patch deployment.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeployments.UpdatePatchDeploymentRequest request =
             PatchDeployments.UpdatePatchDeploymentRequest.newBuilder()
                 .setPatchDeployment(PatchDeployments.PatchDeployment.newBuilder().build())
                 .setUpdateMask(FieldMask.newBuilder().build())
                 .build();
         ApiFuture<PatchDeployments.PatchDeployment> future =
             osConfigServiceClient.updatePatchDeploymentCallable().futureCall(request);
         // Do something.
         PatchDeployments.PatchDeployment response = future.get();
       }
       
    • pausePatchDeployment

      public final PatchDeployments.PatchDeployment pausePatchDeployment(PatchDeploymentName name)
      Change state of patch deployment to "PAUSED". Patch deployment in paused state doesn't generate patch jobs.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeploymentName name = PatchDeploymentName.of("[PROJECT]", "[PATCH_DEPLOYMENT]");
         PatchDeployments.PatchDeployment response = osConfigServiceClient.pausePatchDeployment(name);
       }
       
      Parameters:
      name - Required. The resource name of the patch deployment in the form `projects/*/patchDeployments/*`.
      Throws:
      ApiException - if the remote call fails
    • pausePatchDeployment

      public final PatchDeployments.PatchDeployment pausePatchDeployment(String name)
      Change state of patch deployment to "PAUSED". Patch deployment in paused state doesn't generate patch jobs.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         String name = PatchDeploymentName.of("[PROJECT]", "[PATCH_DEPLOYMENT]").toString();
         PatchDeployments.PatchDeployment response = osConfigServiceClient.pausePatchDeployment(name);
       }
       
      Parameters:
      name - Required. The resource name of the patch deployment in the form `projects/*/patchDeployments/*`.
      Throws:
      ApiException - if the remote call fails
    • pausePatchDeployment

      Change state of patch deployment to "PAUSED". Patch deployment in paused state doesn't generate patch jobs.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeployments.PausePatchDeploymentRequest request =
             PatchDeployments.PausePatchDeploymentRequest.newBuilder()
                 .setName(PatchDeploymentName.of("[PROJECT]", "[PATCH_DEPLOYMENT]").toString())
                 .build();
         PatchDeployments.PatchDeployment response =
             osConfigServiceClient.pausePatchDeployment(request);
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • pausePatchDeploymentCallable

      Change state of patch deployment to "PAUSED". Patch deployment in paused state doesn't generate patch jobs.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeployments.PausePatchDeploymentRequest request =
             PatchDeployments.PausePatchDeploymentRequest.newBuilder()
                 .setName(PatchDeploymentName.of("[PROJECT]", "[PATCH_DEPLOYMENT]").toString())
                 .build();
         ApiFuture<PatchDeployments.PatchDeployment> future =
             osConfigServiceClient.pausePatchDeploymentCallable().futureCall(request);
         // Do something.
         PatchDeployments.PatchDeployment response = future.get();
       }
       
    • resumePatchDeployment

      public final PatchDeployments.PatchDeployment resumePatchDeployment(PatchDeploymentName name)
      Change state of patch deployment back to "ACTIVE". Patch deployment in active state continues to generate patch jobs.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeploymentName name = PatchDeploymentName.of("[PROJECT]", "[PATCH_DEPLOYMENT]");
         PatchDeployments.PatchDeployment response = osConfigServiceClient.resumePatchDeployment(name);
       }
       
      Parameters:
      name - Required. The resource name of the patch deployment in the form `projects/*/patchDeployments/*`.
      Throws:
      ApiException - if the remote call fails
    • resumePatchDeployment

      public final PatchDeployments.PatchDeployment resumePatchDeployment(String name)
      Change state of patch deployment back to "ACTIVE". Patch deployment in active state continues to generate patch jobs.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         String name = PatchDeploymentName.of("[PROJECT]", "[PATCH_DEPLOYMENT]").toString();
         PatchDeployments.PatchDeployment response = osConfigServiceClient.resumePatchDeployment(name);
       }
       
      Parameters:
      name - Required. The resource name of the patch deployment in the form `projects/*/patchDeployments/*`.
      Throws:
      ApiException - if the remote call fails
    • resumePatchDeployment

      Change state of patch deployment back to "ACTIVE". Patch deployment in active state continues to generate patch jobs.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeployments.ResumePatchDeploymentRequest request =
             PatchDeployments.ResumePatchDeploymentRequest.newBuilder()
                 .setName(PatchDeploymentName.of("[PROJECT]", "[PATCH_DEPLOYMENT]").toString())
                 .build();
         PatchDeployments.PatchDeployment response =
             osConfigServiceClient.resumePatchDeployment(request);
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • resumePatchDeploymentCallable

      Change state of patch deployment back to "ACTIVE". Patch deployment in active state continues to generate patch jobs.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         PatchDeployments.ResumePatchDeploymentRequest request =
             PatchDeployments.ResumePatchDeploymentRequest.newBuilder()
                 .setName(PatchDeploymentName.of("[PROJECT]", "[PATCH_DEPLOYMENT]").toString())
                 .build();
         ApiFuture<PatchDeployments.PatchDeployment> future =
             osConfigServiceClient.resumePatchDeploymentCallable().futureCall(request);
         // Do something.
         PatchDeployments.PatchDeployment response = future.get();
       }
       
    • createGuestPolicy

      public final GuestPolicies.GuestPolicy createGuestPolicy(ProjectName parent, GuestPolicies.GuestPolicy guestPolicy)
      Create an OS Config guest policy.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         ProjectName parent = ProjectName.of("[PROJECT]");
         GuestPolicies.GuestPolicy guestPolicy = GuestPolicies.GuestPolicy.newBuilder().build();
         GuestPolicies.GuestPolicy response =
             osConfigServiceClient.createGuestPolicy(parent, guestPolicy);
       }
       
      Parameters:
      parent - Required. The resource name of the parent using one of the following forms: `projects/{project_number}`.
      guestPolicy - Required. The GuestPolicy to create.
      Throws:
      ApiException - if the remote call fails
    • createGuestPolicy

      public final GuestPolicies.GuestPolicy createGuestPolicy(String parent, GuestPolicies.GuestPolicy guestPolicy)
      Create an OS Config guest policy.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         String parent = ProjectName.of("[PROJECT]").toString();
         GuestPolicies.GuestPolicy guestPolicy = GuestPolicies.GuestPolicy.newBuilder().build();
         GuestPolicies.GuestPolicy response =
             osConfigServiceClient.createGuestPolicy(parent, guestPolicy);
       }
       
      Parameters:
      parent - Required. The resource name of the parent using one of the following forms: `projects/{project_number}`.
      guestPolicy - Required. The GuestPolicy to create.
      Throws:
      ApiException - if the remote call fails
    • createGuestPolicy

      public final GuestPolicies.GuestPolicy createGuestPolicy(GuestPolicies.CreateGuestPolicyRequest request)
      Create an OS Config guest policy.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         GuestPolicies.CreateGuestPolicyRequest request =
             GuestPolicies.CreateGuestPolicyRequest.newBuilder()
                 .setParent(ProjectName.of("[PROJECT]").toString())
                 .setGuestPolicyId("guestPolicyId1234592741")
                 .setGuestPolicy(GuestPolicies.GuestPolicy.newBuilder().build())
                 .build();
         GuestPolicies.GuestPolicy response = osConfigServiceClient.createGuestPolicy(request);
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • createGuestPolicyCallable

      Create an OS Config guest policy.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         GuestPolicies.CreateGuestPolicyRequest request =
             GuestPolicies.CreateGuestPolicyRequest.newBuilder()
                 .setParent(ProjectName.of("[PROJECT]").toString())
                 .setGuestPolicyId("guestPolicyId1234592741")
                 .setGuestPolicy(GuestPolicies.GuestPolicy.newBuilder().build())
                 .build();
         ApiFuture<GuestPolicies.GuestPolicy> future =
             osConfigServiceClient.createGuestPolicyCallable().futureCall(request);
         // Do something.
         GuestPolicies.GuestPolicy response = future.get();
       }
       
    • getGuestPolicy

      public final GuestPolicies.GuestPolicy getGuestPolicy(GuestPolicyName name)
      Get an OS Config guest policy.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         GuestPolicyName name = GuestPolicyName.of("[PROJECT]", "[GUEST_POLICY]");
         GuestPolicies.GuestPolicy response = osConfigServiceClient.getGuestPolicy(name);
       }
       
      Parameters:
      name - Required. The resource name of the guest policy using one of the following forms: `projects/{project_number}/guestPolicies/{guest_policy_id}`.
      Throws:
      ApiException - if the remote call fails
    • getGuestPolicy

      public final GuestPolicies.GuestPolicy getGuestPolicy(String name)
      Get an OS Config guest policy.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         String name = GuestPolicyName.of("[PROJECT]", "[GUEST_POLICY]").toString();
         GuestPolicies.GuestPolicy response = osConfigServiceClient.getGuestPolicy(name);
       }
       
      Parameters:
      name - Required. The resource name of the guest policy using one of the following forms: `projects/{project_number}/guestPolicies/{guest_policy_id}`.
      Throws:
      ApiException - if the remote call fails
    • getGuestPolicy

      public final GuestPolicies.GuestPolicy getGuestPolicy(GuestPolicies.GetGuestPolicyRequest request)
      Get an OS Config guest policy.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         GuestPolicies.GetGuestPolicyRequest request =
             GuestPolicies.GetGuestPolicyRequest.newBuilder()
                 .setName(GuestPolicyName.of("[PROJECT]", "[GUEST_POLICY]").toString())
                 .build();
         GuestPolicies.GuestPolicy response = osConfigServiceClient.getGuestPolicy(request);
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • getGuestPolicyCallable

      Get an OS Config guest policy.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         GuestPolicies.GetGuestPolicyRequest request =
             GuestPolicies.GetGuestPolicyRequest.newBuilder()
                 .setName(GuestPolicyName.of("[PROJECT]", "[GUEST_POLICY]").toString())
                 .build();
         ApiFuture<GuestPolicies.GuestPolicy> future =
             osConfigServiceClient.getGuestPolicyCallable().futureCall(request);
         // Do something.
         GuestPolicies.GuestPolicy response = future.get();
       }
       
    • listGuestPolicies

      public final OsConfigServiceClient.ListGuestPoliciesPagedResponse listGuestPolicies(ProjectName parent)
      Get a page of OS Config guest policies.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         ProjectName parent = ProjectName.of("[PROJECT]");
         for (GuestPolicies.GuestPolicy element :
             osConfigServiceClient.listGuestPolicies(parent).iterateAll()) {
           // doThingsWith(element);
         }
       }
       
      Parameters:
      parent - Required. The resource name of the parent using one of the following forms: `projects/{project_number}`.
      Throws:
      ApiException - if the remote call fails
    • listGuestPolicies

      public final OsConfigServiceClient.ListGuestPoliciesPagedResponse listGuestPolicies(String parent)
      Get a page of OS Config guest policies.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         String parent = ProjectName.of("[PROJECT]").toString();
         for (GuestPolicies.GuestPolicy element :
             osConfigServiceClient.listGuestPolicies(parent).iterateAll()) {
           // doThingsWith(element);
         }
       }
       
      Parameters:
      parent - Required. The resource name of the parent using one of the following forms: `projects/{project_number}`.
      Throws:
      ApiException - if the remote call fails
    • listGuestPolicies

      Get a page of OS Config guest policies.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         GuestPolicies.ListGuestPoliciesRequest request =
             GuestPolicies.ListGuestPoliciesRequest.newBuilder()
                 .setParent(ProjectName.of("[PROJECT]").toString())
                 .setPageSize(883849137)
                 .setPageToken("pageToken873572522")
                 .build();
         for (GuestPolicies.GuestPolicy element :
             osConfigServiceClient.listGuestPolicies(request).iterateAll()) {
           // doThingsWith(element);
         }
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • listGuestPoliciesPagedCallable

      Get a page of OS Config guest policies.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         GuestPolicies.ListGuestPoliciesRequest request =
             GuestPolicies.ListGuestPoliciesRequest.newBuilder()
                 .setParent(ProjectName.of("[PROJECT]").toString())
                 .setPageSize(883849137)
                 .setPageToken("pageToken873572522")
                 .build();
         ApiFuture<GuestPolicies.GuestPolicy> future =
             osConfigServiceClient.listGuestPoliciesPagedCallable().futureCall(request);
         // Do something.
         for (GuestPolicies.GuestPolicy element : future.get().iterateAll()) {
           // doThingsWith(element);
         }
       }
       
    • listGuestPoliciesCallable

      Get a page of OS Config guest policies.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         GuestPolicies.ListGuestPoliciesRequest request =
             GuestPolicies.ListGuestPoliciesRequest.newBuilder()
                 .setParent(ProjectName.of("[PROJECT]").toString())
                 .setPageSize(883849137)
                 .setPageToken("pageToken873572522")
                 .build();
         while (true) {
           GuestPolicies.ListGuestPoliciesResponse response =
               osConfigServiceClient.listGuestPoliciesCallable().call(request);
           for (GuestPolicies.GuestPolicy element : response.getGuestPoliciesList()) {
             // doThingsWith(element);
           }
           String nextPageToken = response.getNextPageToken();
           if (!Strings.isNullOrEmpty(nextPageToken)) {
             request = request.toBuilder().setPageToken(nextPageToken).build();
           } else {
             break;
           }
         }
       }
       
    • updateGuestPolicy

      public final GuestPolicies.GuestPolicy updateGuestPolicy(GuestPolicies.GuestPolicy guestPolicy, com.google.protobuf.FieldMask updateMask)
      Update an OS Config guest policy.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         GuestPolicies.GuestPolicy guestPolicy = GuestPolicies.GuestPolicy.newBuilder().build();
         FieldMask updateMask = FieldMask.newBuilder().build();
         GuestPolicies.GuestPolicy response =
             osConfigServiceClient.updateGuestPolicy(guestPolicy, updateMask);
       }
       
      Parameters:
      guestPolicy - Required. The updated GuestPolicy.
      updateMask - Field mask that controls which fields of the guest policy should be updated.
      Throws:
      ApiException - if the remote call fails
    • updateGuestPolicy

      public final GuestPolicies.GuestPolicy updateGuestPolicy(GuestPolicies.UpdateGuestPolicyRequest request)
      Update an OS Config guest policy.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         GuestPolicies.UpdateGuestPolicyRequest request =
             GuestPolicies.UpdateGuestPolicyRequest.newBuilder()
                 .setGuestPolicy(GuestPolicies.GuestPolicy.newBuilder().build())
                 .setUpdateMask(FieldMask.newBuilder().build())
                 .build();
         GuestPolicies.GuestPolicy response = osConfigServiceClient.updateGuestPolicy(request);
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • updateGuestPolicyCallable

      Update an OS Config guest policy.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         GuestPolicies.UpdateGuestPolicyRequest request =
             GuestPolicies.UpdateGuestPolicyRequest.newBuilder()
                 .setGuestPolicy(GuestPolicies.GuestPolicy.newBuilder().build())
                 .setUpdateMask(FieldMask.newBuilder().build())
                 .build();
         ApiFuture<GuestPolicies.GuestPolicy> future =
             osConfigServiceClient.updateGuestPolicyCallable().futureCall(request);
         // Do something.
         GuestPolicies.GuestPolicy response = future.get();
       }
       
    • deleteGuestPolicy

      public final void deleteGuestPolicy(GuestPolicyName name)
      Delete an OS Config guest policy.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         GuestPolicyName name = GuestPolicyName.of("[PROJECT]", "[GUEST_POLICY]");
         osConfigServiceClient.deleteGuestPolicy(name);
       }
       
      Parameters:
      name - Required. The resource name of the guest policy using one of the following forms: `projects/{project_number}/guestPolicies/{guest_policy_id}`.
      Throws:
      ApiException - if the remote call fails
    • deleteGuestPolicy

      public final void deleteGuestPolicy(String name)
      Delete an OS Config guest policy.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         String name = GuestPolicyName.of("[PROJECT]", "[GUEST_POLICY]").toString();
         osConfigServiceClient.deleteGuestPolicy(name);
       }
       
      Parameters:
      name - Required. The resource name of the guest policy using one of the following forms: `projects/{project_number}/guestPolicies/{guest_policy_id}`.
      Throws:
      ApiException - if the remote call fails
    • deleteGuestPolicy

      public final void deleteGuestPolicy(GuestPolicies.DeleteGuestPolicyRequest request)
      Delete an OS Config guest policy.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         GuestPolicies.DeleteGuestPolicyRequest request =
             GuestPolicies.DeleteGuestPolicyRequest.newBuilder()
                 .setName(GuestPolicyName.of("[PROJECT]", "[GUEST_POLICY]").toString())
                 .build();
         osConfigServiceClient.deleteGuestPolicy(request);
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • deleteGuestPolicyCallable

      public final UnaryCallable<GuestPolicies.DeleteGuestPolicyRequest,com.google.protobuf.Empty> deleteGuestPolicyCallable()
      Delete an OS Config guest policy.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         GuestPolicies.DeleteGuestPolicyRequest request =
             GuestPolicies.DeleteGuestPolicyRequest.newBuilder()
                 .setName(GuestPolicyName.of("[PROJECT]", "[GUEST_POLICY]").toString())
                 .build();
         ApiFuture<Empty> future =
             osConfigServiceClient.deleteGuestPolicyCallable().futureCall(request);
         // Do something.
         future.get();
       }
       
    • lookupEffectiveGuestPolicy

      Lookup the effective guest policy that applies to a VM instance. This lookup merges all policies that are assigned to the instance ancestry.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         GuestPolicies.LookupEffectiveGuestPolicyRequest request =
             GuestPolicies.LookupEffectiveGuestPolicyRequest.newBuilder()
                 .setInstance("instance555127957")
                 .setOsShortName("osShortName1253394339")
                 .setOsVersion("osVersion1812004436")
                 .setOsArchitecture("osArchitecture1339954519")
                 .build();
         GuestPolicies.EffectiveGuestPolicy response =
             osConfigServiceClient.lookupEffectiveGuestPolicy(request);
       }
       
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails
    • lookupEffectiveGuestPolicyCallable

      Lookup the effective guest policy that applies to a VM instance. This lookup merges all policies that are assigned to the instance ancestry.

      Sample code:

      
       // This snippet has been automatically generated and should be regarded as a code template only.
       // It will require modifications to work:
       // - It may require correct/in-range values for request initialization.
       // - It may require specifying regional endpoints when creating the service client as shown in
       // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
       try (OsConfigServiceClient osConfigServiceClient = OsConfigServiceClient.create()) {
         GuestPolicies.LookupEffectiveGuestPolicyRequest request =
             GuestPolicies.LookupEffectiveGuestPolicyRequest.newBuilder()
                 .setInstance("instance555127957")
                 .setOsShortName("osShortName1253394339")
                 .setOsVersion("osVersion1812004436")
                 .setOsArchitecture("osArchitecture1339954519")
                 .build();
         ApiFuture<GuestPolicies.EffectiveGuestPolicy> future =
             osConfigServiceClient.lookupEffectiveGuestPolicyCallable().futureCall(request);
         // Do something.
         GuestPolicies.EffectiveGuestPolicy response = future.get();
       }
       
    • close

      public final void close()
      Specified by:
      close in interface AutoCloseable
    • shutdown

      public void shutdown()
      Specified by:
      shutdown in interface BackgroundResource
    • isShutdown

      public boolean isShutdown()
      Specified by:
      isShutdown in interface BackgroundResource
    • isTerminated

      public boolean isTerminated()
      Specified by:
      isTerminated in interface BackgroundResource
    • shutdownNow

      public void shutdownNow()
      Specified by:
      shutdownNow in interface BackgroundResource
    • awaitTermination

      public boolean awaitTermination(long duration, TimeUnit unit) throws InterruptedException
      Specified by:
      awaitTermination in interface BackgroundResource
      Throws:
      InterruptedException