Package com.google.cloud.securitycenter.settings.v1beta1

Class SecurityCenterSettingsServiceClient

java.lang.Object
com.google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsServiceClient
All Implemented Interfaces:
BackgroundResource, AutoCloseable
@BetaApi @Generated("by gapic-generator-java") public class SecurityCenterSettingsServiceClient extends Object implements BackgroundResource
Service Description: ## API Overview

The SecurityCenterSettingsService is a sub-api of `securitycenter.googleapis.com`. The service provides methods to manage Security Center Settings, and Component Settings for GCP organizations, folders, projects, and clusters.

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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   ServiceAccountName name = ServiceAccountName.of("[ORGANIZATION]");
   ServiceAccount response = securityCenterSettingsServiceClient.getServiceAccount(name);
 }

Note: close() needs to be called on the SecurityCenterSettingsServiceClient 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

GetServiceAccount

Retrieves the organizations service account, if it exists, otherwise it creates the organization service account. This API is idempotent and will only create a service account once. On subsequent calls it will return the previously created service account. SHA, SCC and CTD Infra Automation will use this SA. This SA will not have any permissions when created. The UI will provision this via IAM or the user will using their own internal process. This API only creates SAs on the organization. Folders are not supported and projects will use per-project SAs associated with APIs enabled on a project. This API will be called by the UX onboarding workflow.

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

  • getServiceAccount(GetServiceAccountRequest request)

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

  • getServiceAccount(ServiceAccountName name)

  • getServiceAccount(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.

  • getServiceAccountCallable()

GetSettings

Gets the Settings.

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

  • getSettings(GetSettingsRequest request)

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

  • getSettings(SettingsName name)

  • getSettings(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.

  • getSettingsCallable()

UpdateSettings

Updates the Settings.

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

  • updateSettings(UpdateSettingsRequest request)

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

  • updateSettings(Settings settings, 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.

  • updateSettingsCallable()

ResetSettings

Reset the organization, folder or project's settings and return the settings of just that resource to the default.

Settings are present at the organization, folder, project, and cluster levels. Using Reset on a sub-organization level will remove that resource's override and result in the parent's settings being used (eg: if Reset on a cluster, project settings will be used).

Using Reset on organization will remove the override that was set and result in default settings being used.

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

  • resetSettings(ResetSettingsRequest request)

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

  • resetSettingsCallable()

BatchGetSettings

Gets a list of settings.

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

  • batchGetSettings(BatchGetSettingsRequest request)

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

  • batchGetSettingsCallable()

CalculateEffectiveSettings

CalculateEffectiveSettings looks up all of the Security Center Settings resources in the GCP resource hierarchy, and calculates the effective settings on that resource by applying the following rules: * Settings provided closer to the target resource take precedence over those further away (e.g. folder will override organization level settings). * Product defaults can be overridden at org, folder, project, and cluster levels. * Detectors will be filtered out if they belong to a billing tier the customer has not configured.

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

  • calculateEffectiveSettings(CalculateEffectiveSettingsRequest request)

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

  • calculateEffectiveSettings(SettingsName name)

  • calculateEffectiveSettings(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.

  • calculateEffectiveSettingsCallable()

BatchCalculateEffectiveSettings

Gets a list of effective settings.

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

  • batchCalculateEffectiveSettings(BatchCalculateEffectiveSettingsRequest request)

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

  • batchCalculateEffectiveSettingsCallable()

GetComponentSettings

Gets the Component Settings.

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

  • getComponentSettings(GetComponentSettingsRequest request)

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

  • getComponentSettings(ComponentSettingsName name)

  • getComponentSettings(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.

  • getComponentSettingsCallable()

UpdateComponentSettings

Updates the Component Settings.

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

  • updateComponentSettings(UpdateComponentSettingsRequest request)

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

  • updateComponentSettings(ComponentSettings componentSettings, 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.

  • updateComponentSettingsCallable()

ResetComponentSettings

Reset the organization, folder or project's component settings and return the settings to the default. Settings are present at the organization, folder and project levels. Using Reset for a folder or project will remove the override that was set and result in the organization-level settings being used.

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

  • resetComponentSettings(ResetComponentSettingsRequest request)

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

  • resetComponentSettingsCallable()

CalculateEffectiveComponentSettings

Gets the Effective Component Settings.

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

  • calculateEffectiveComponentSettings(CalculateEffectiveComponentSettingsRequest request)

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

  • calculateEffectiveComponentSettings(ComponentSettingsName name)

  • calculateEffectiveComponentSettings(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.

  • calculateEffectiveComponentSettingsCallable()

ListDetectors

Retrieves an unordered list of available detectors.

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

  • listDetectors(ListDetectorsRequest request)

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

  • listDetectors(OrganizationName parent)

  • listDetectors(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.

  • listDetectorsPagedCallable()

  • listDetectorsCallable()

ListComponents

Retrieves an unordered list of available SCC components.

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

  • listComponents(ListComponentsRequest request)

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

  • listComponents(OrganizationName parent)

  • listComponents(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.

  • listComponentsPagedCallable()

  • listComponentsCallable()

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 SecurityCenterSettingsServiceSettings 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
 SecurityCenterSettingsServiceSettings securityCenterSettingsServiceSettings =
     SecurityCenterSettingsServiceSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create(securityCenterSettingsServiceSettings);

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
 SecurityCenterSettingsServiceSettings securityCenterSettingsServiceSettings =
     SecurityCenterSettingsServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
 SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create(securityCenterSettingsServiceSettings);

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

  • Constructor Details

    • SecurityCenterSettingsServiceClient

      protected SecurityCenterSettingsServiceClient(SecurityCenterSettingsServiceSettings settings) throws IOException
      Constructs an instance of SecurityCenterSettingsServiceClient, 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

    • SecurityCenterSettingsServiceClient

      protected SecurityCenterSettingsServiceClient(SecurityCenterSettingsServiceStub stub)

  • Method Details

    • create

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

    • create

      public static final SecurityCenterSettingsServiceClient create(SecurityCenterSettingsServiceSettings settings) throws IOException
      Constructs an instance of SecurityCenterSettingsServiceClient, 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 SecurityCenterSettingsServiceClient create(SecurityCenterSettingsServiceStub stub)
      Constructs an instance of SecurityCenterSettingsServiceClient, using the given stub for making calls. This is for advanced usage - prefer using create(SecurityCenterSettingsServiceSettings).

    • getSettings

      public final SecurityCenterSettingsServiceSettings getSettings()

    • getStub

      public SecurityCenterSettingsServiceStub getStub()

    • getServiceAccount

      public final ServiceAccount getServiceAccount(ServiceAccountName name)
      Retrieves the organizations service account, if it exists, otherwise it creates the organization service account. This API is idempotent and will only create a service account once. On subsequent calls it will return the previously created service account. SHA, SCC and CTD Infra Automation will use this SA. This SA will not have any permissions when created. The UI will provision this via IAM or the user will using their own internal process. This API only creates SAs on the organization. Folders are not supported and projects will use per-project SAs associated with APIs enabled on a project. This API will be called by the UX onboarding workflow.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   ServiceAccountName name = ServiceAccountName.of("[ORGANIZATION]");
   ServiceAccount response = securityCenterSettingsServiceClient.getServiceAccount(name);
 }
      Parameters:
      name - Required. The relative resource name of the service account resource. Format: * `organizations/{organization}/serviceAccount`
      Throws:
      ApiException - if the remote call fails

    • getServiceAccount

      public final ServiceAccount getServiceAccount(String name)
      Retrieves the organizations service account, if it exists, otherwise it creates the organization service account. This API is idempotent and will only create a service account once. On subsequent calls it will return the previously created service account. SHA, SCC and CTD Infra Automation will use this SA. This SA will not have any permissions when created. The UI will provision this via IAM or the user will using their own internal process. This API only creates SAs on the organization. Folders are not supported and projects will use per-project SAs associated with APIs enabled on a project. This API will be called by the UX onboarding workflow.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   String name = ServiceAccountName.of("[ORGANIZATION]").toString();
   ServiceAccount response = securityCenterSettingsServiceClient.getServiceAccount(name);
 }
      Parameters:
      name - Required. The relative resource name of the service account resource. Format: * `organizations/{organization}/serviceAccount`
      Throws:
      ApiException - if the remote call fails

    • getServiceAccount

      public final ServiceAccount getServiceAccount(GetServiceAccountRequest request)
      Retrieves the organizations service account, if it exists, otherwise it creates the organization service account. This API is idempotent and will only create a service account once. On subsequent calls it will return the previously created service account. SHA, SCC and CTD Infra Automation will use this SA. This SA will not have any permissions when created. The UI will provision this via IAM or the user will using their own internal process. This API only creates SAs on the organization. Folders are not supported and projects will use per-project SAs associated with APIs enabled on a project. This API will be called by the UX onboarding workflow.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   GetServiceAccountRequest request =
       GetServiceAccountRequest.newBuilder()
           .setName(ServiceAccountName.of("[ORGANIZATION]").toString())
           .build();
   ServiceAccount response = securityCenterSettingsServiceClient.getServiceAccount(request);
 }
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails

    • getServiceAccountCallable

      public final UnaryCallable<GetServiceAccountRequest,ServiceAccount> getServiceAccountCallable()
      Retrieves the organizations service account, if it exists, otherwise it creates the organization service account. This API is idempotent and will only create a service account once. On subsequent calls it will return the previously created service account. SHA, SCC and CTD Infra Automation will use this SA. This SA will not have any permissions when created. The UI will provision this via IAM or the user will using their own internal process. This API only creates SAs on the organization. Folders are not supported and projects will use per-project SAs associated with APIs enabled on a project. This API will be called by the UX onboarding workflow.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   GetServiceAccountRequest request =
       GetServiceAccountRequest.newBuilder()
           .setName(ServiceAccountName.of("[ORGANIZATION]").toString())
           .build();
   ApiFuture<ServiceAccount> future =
       securityCenterSettingsServiceClient.getServiceAccountCallable().futureCall(request);
   // Do something.
   ServiceAccount response = future.get();
 }

    • getSettings

      public final Settings getSettings(SettingsName name)
      Gets the Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   SettingsName name = SettingsName.ofOrganizationName("[ORGANIZATION]");
   Settings response = securityCenterSettingsServiceClient.getSettings(name);
 }
      Parameters:
      name - Required. The name of the settings to retrieve. Formats: * `organizations/{organization}/settings` * `folders/{folder}/settings` * `projects/{project}/settings` * `projects/{project}/locations/{location}/clusters/{cluster}/settings` * `projects/{project}/regions/{region}/clusters/{cluster}/settings` * `projects/{project}/zones/{zone}/clusters/{cluster}/settings`
      Throws:
      ApiException - if the remote call fails

    • getSettings

      public final Settings getSettings(String name)
      Gets the Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   String name = SettingsName.ofOrganizationName("[ORGANIZATION]").toString();
   Settings response = securityCenterSettingsServiceClient.getSettings(name);
 }
      Parameters:
      name - Required. The name of the settings to retrieve. Formats: * `organizations/{organization}/settings` * `folders/{folder}/settings` * `projects/{project}/settings` * `projects/{project}/locations/{location}/clusters/{cluster}/settings` * `projects/{project}/regions/{region}/clusters/{cluster}/settings` * `projects/{project}/zones/{zone}/clusters/{cluster}/settings`
      Throws:
      ApiException - if the remote call fails

    • getSettings

      public final Settings getSettings(GetSettingsRequest request)
      Gets the Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   GetSettingsRequest request =
       GetSettingsRequest.newBuilder()
           .setName(SettingsName.ofOrganizationName("[ORGANIZATION]").toString())
           .build();
   Settings response = securityCenterSettingsServiceClient.getSettings(request);
 }
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails

    • getSettingsCallable

      public final UnaryCallable<GetSettingsRequest,Settings> getSettingsCallable()
      Gets the Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   GetSettingsRequest request =
       GetSettingsRequest.newBuilder()
           .setName(SettingsName.ofOrganizationName("[ORGANIZATION]").toString())
           .build();
   ApiFuture<Settings> future =
       securityCenterSettingsServiceClient.getSettingsCallable().futureCall(request);
   // Do something.
   Settings response = future.get();
 }

    • updateSettings

      public final Settings updateSettings(Settings settings, com.google.protobuf.FieldMask updateMask)
      Updates the Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   Settings settings = Settings.newBuilder().build();
   FieldMask updateMask = FieldMask.newBuilder().build();
   Settings response = securityCenterSettingsServiceClient.updateSettings(settings, updateMask);
 }
      Parameters:
      settings - Required. The settings to update.

      The settings' `name` field is used to identify the settings to be updated. Formats: * `organizations/{organization}/settings` * `folders/{folder}/settings` * `projects/{project}/settings` * `projects/{project}/locations/{location}/clusters/{cluster}/settings` * `projects/{project}/regions/{region}/clusters/{cluster}/settings` * `projects/{project}/zones/{zone}/clusters/{cluster}/settings`

      updateMask - The list of fields to be updated on the settings.
      Throws:
      ApiException - if the remote call fails

    • updateSettings

      public final Settings updateSettings(UpdateSettingsRequest request)
      Updates the Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   UpdateSettingsRequest request =
       UpdateSettingsRequest.newBuilder()
           .setSettings(Settings.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   Settings response = securityCenterSettingsServiceClient.updateSettings(request);
 }
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails

    • updateSettingsCallable

      public final UnaryCallable<UpdateSettingsRequest,Settings> updateSettingsCallable()
      Updates the Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   UpdateSettingsRequest request =
       UpdateSettingsRequest.newBuilder()
           .setSettings(Settings.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   ApiFuture<Settings> future =
       securityCenterSettingsServiceClient.updateSettingsCallable().futureCall(request);
   // Do something.
   Settings response = future.get();
 }

    • resetSettings

      public final void resetSettings(ResetSettingsRequest request)
      Reset the organization, folder or project's settings and return the settings of just that resource to the default.

      Settings are present at the organization, folder, project, and cluster levels. Using Reset on a sub-organization level will remove that resource's override and result in the parent's settings being used (eg: if Reset on a cluster, project settings will be used).

      Using Reset on organization will remove the override that was set and result in default settings being used.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   ResetSettingsRequest request =
       ResetSettingsRequest.newBuilder()
           .setName(SettingsName.ofOrganizationName("[ORGANIZATION]").toString())
           .setEtag("etag3123477")
           .build();
   securityCenterSettingsServiceClient.resetSettings(request);
 }
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails

    • resetSettingsCallable

      public final UnaryCallable<ResetSettingsRequest,com.google.protobuf.Empty> resetSettingsCallable()
      Reset the organization, folder or project's settings and return the settings of just that resource to the default.

      Settings are present at the organization, folder, project, and cluster levels. Using Reset on a sub-organization level will remove that resource's override and result in the parent's settings being used (eg: if Reset on a cluster, project settings will be used).

      Using Reset on organization will remove the override that was set and result in default settings being used.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   ResetSettingsRequest request =
       ResetSettingsRequest.newBuilder()
           .setName(SettingsName.ofOrganizationName("[ORGANIZATION]").toString())
           .setEtag("etag3123477")
           .build();
   ApiFuture<Empty> future =
       securityCenterSettingsServiceClient.resetSettingsCallable().futureCall(request);
   // Do something.
   future.get();
 }

    • batchGetSettings

      public final BatchGetSettingsResponse batchGetSettings(BatchGetSettingsRequest request)
      Gets a list of settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   BatchGetSettingsRequest request =
       BatchGetSettingsRequest.newBuilder()
           .setParent(OrganizationName.of("[ORGANIZATION]").toString())
           .addAllNames(new ArrayList<String>())
           .build();
   BatchGetSettingsResponse response =
       securityCenterSettingsServiceClient.batchGetSettings(request);
 }
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails

    • batchGetSettingsCallable

      public final UnaryCallable<BatchGetSettingsRequest,BatchGetSettingsResponse> batchGetSettingsCallable()
      Gets a list of settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   BatchGetSettingsRequest request =
       BatchGetSettingsRequest.newBuilder()
           .setParent(OrganizationName.of("[ORGANIZATION]").toString())
           .addAllNames(new ArrayList<String>())
           .build();
   ApiFuture<BatchGetSettingsResponse> future =
       securityCenterSettingsServiceClient.batchGetSettingsCallable().futureCall(request);
   // Do something.
   BatchGetSettingsResponse response = future.get();
 }

    • calculateEffectiveSettings

      public final Settings calculateEffectiveSettings(SettingsName name)
      CalculateEffectiveSettings looks up all of the Security Center Settings resources in the GCP resource hierarchy, and calculates the effective settings on that resource by applying the following rules: * Settings provided closer to the target resource take precedence over those further away (e.g. folder will override organization level settings). * Product defaults can be overridden at org, folder, project, and cluster levels. * Detectors will be filtered out if they belong to a billing tier the customer has not configured.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   SettingsName name = SettingsName.ofOrganizationName("[ORGANIZATION]");
   Settings response = securityCenterSettingsServiceClient.calculateEffectiveSettings(name);
 }
      Parameters:
      name - Required. The name of the effective settings to retrieve. Formats: * `organizations/{organization}/effectiveSettings` * `folders/{folder}/effectiveSettings` * `projects/{project}/effectiveSettings` * `projects/{project}/locations/{location}/clusters/{cluster}/effectiveSettings` * `projects/{project}/regions/{region}/clusters/{cluster}/effectiveSettings` * `projects/{project}/zones/{zone}/clusters/{cluster}/effectiveSettings`
      Throws:
      ApiException - if the remote call fails

    • calculateEffectiveSettings

      public final Settings calculateEffectiveSettings(String name)
      CalculateEffectiveSettings looks up all of the Security Center Settings resources in the GCP resource hierarchy, and calculates the effective settings on that resource by applying the following rules: * Settings provided closer to the target resource take precedence over those further away (e.g. folder will override organization level settings). * Product defaults can be overridden at org, folder, project, and cluster levels. * Detectors will be filtered out if they belong to a billing tier the customer has not configured.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   String name = SettingsName.ofOrganizationName("[ORGANIZATION]").toString();
   Settings response = securityCenterSettingsServiceClient.calculateEffectiveSettings(name);
 }
      Parameters:
      name - Required. The name of the effective settings to retrieve. Formats: * `organizations/{organization}/effectiveSettings` * `folders/{folder}/effectiveSettings` * `projects/{project}/effectiveSettings` * `projects/{project}/locations/{location}/clusters/{cluster}/effectiveSettings` * `projects/{project}/regions/{region}/clusters/{cluster}/effectiveSettings` * `projects/{project}/zones/{zone}/clusters/{cluster}/effectiveSettings`
      Throws:
      ApiException - if the remote call fails

    • calculateEffectiveSettings

      public final Settings calculateEffectiveSettings(CalculateEffectiveSettingsRequest request)
      CalculateEffectiveSettings looks up all of the Security Center Settings resources in the GCP resource hierarchy, and calculates the effective settings on that resource by applying the following rules: * Settings provided closer to the target resource take precedence over those further away (e.g. folder will override organization level settings). * Product defaults can be overridden at org, folder, project, and cluster levels. * Detectors will be filtered out if they belong to a billing tier the customer has not configured.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   CalculateEffectiveSettingsRequest request =
       CalculateEffectiveSettingsRequest.newBuilder()
           .setName(SettingsName.ofOrganizationName("[ORGANIZATION]").toString())
           .build();
   Settings response = securityCenterSettingsServiceClient.calculateEffectiveSettings(request);
 }
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails

    • calculateEffectiveSettingsCallable

      public final UnaryCallable<CalculateEffectiveSettingsRequest,Settings> calculateEffectiveSettingsCallable()
      CalculateEffectiveSettings looks up all of the Security Center Settings resources in the GCP resource hierarchy, and calculates the effective settings on that resource by applying the following rules: * Settings provided closer to the target resource take precedence over those further away (e.g. folder will override organization level settings). * Product defaults can be overridden at org, folder, project, and cluster levels. * Detectors will be filtered out if they belong to a billing tier the customer has not configured.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   CalculateEffectiveSettingsRequest request =
       CalculateEffectiveSettingsRequest.newBuilder()
           .setName(SettingsName.ofOrganizationName("[ORGANIZATION]").toString())
           .build();
   ApiFuture<Settings> future =
       securityCenterSettingsServiceClient
           .calculateEffectiveSettingsCallable()
           .futureCall(request);
   // Do something.
   Settings response = future.get();
 }

    • batchCalculateEffectiveSettings

      public final BatchCalculateEffectiveSettingsResponse batchCalculateEffectiveSettings(BatchCalculateEffectiveSettingsRequest request)
      Gets a list of effective settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   BatchCalculateEffectiveSettingsRequest request =
       BatchCalculateEffectiveSettingsRequest.newBuilder()
           .setParent(OrganizationName.of("[ORGANIZATION]").toString())
           .addAllRequests(new ArrayList<CalculateEffectiveSettingsRequest>())
           .build();
   BatchCalculateEffectiveSettingsResponse response =
       securityCenterSettingsServiceClient.batchCalculateEffectiveSettings(request);
 }
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails

    • batchCalculateEffectiveSettingsCallable

      public final UnaryCallable<BatchCalculateEffectiveSettingsRequest,BatchCalculateEffectiveSettingsResponse> batchCalculateEffectiveSettingsCallable()
      Gets a list of effective settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   BatchCalculateEffectiveSettingsRequest request =
       BatchCalculateEffectiveSettingsRequest.newBuilder()
           .setParent(OrganizationName.of("[ORGANIZATION]").toString())
           .addAllRequests(new ArrayList<CalculateEffectiveSettingsRequest>())
           .build();
   ApiFuture<BatchCalculateEffectiveSettingsResponse> future =
       securityCenterSettingsServiceClient
           .batchCalculateEffectiveSettingsCallable()
           .futureCall(request);
   // Do something.
   BatchCalculateEffectiveSettingsResponse response = future.get();
 }

    • getComponentSettings

      public final ComponentSettings getComponentSettings(ComponentSettingsName name)
      Gets the Component Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   ComponentSettingsName name =
       ComponentSettingsName.ofOrganizationComponentName("[ORGANIZATION]", "[COMPONENT]");
   ComponentSettings response = securityCenterSettingsServiceClient.getComponentSettings(name);
 }
      Parameters:
      name - Required. The component settings to retrieve.

      Formats: * `organizations/{organization}/components/{component}/settings` * `folders/{folder}/components/{component}/settings` * `projects/{project}/components/{component}/settings` * `projects/{project}/locations/{location}/clusters/{cluster}/components/{component}/settings` * `projects/{project}/regions/{region}/clusters/{cluster}/components/{component}/settings` * `projects/{project}/zones/{zone}/clusters/{cluster}/components/{component}/settings`

      Throws:
      ApiException - if the remote call fails

    • getComponentSettings

      public final ComponentSettings getComponentSettings(String name)
      Gets the Component Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   String name =
       ComponentSettingsName.ofOrganizationComponentName("[ORGANIZATION]", "[COMPONENT]")
           .toString();
   ComponentSettings response = securityCenterSettingsServiceClient.getComponentSettings(name);
 }
      Parameters:
      name - Required. The component settings to retrieve.

      Formats: * `organizations/{organization}/components/{component}/settings` * `folders/{folder}/components/{component}/settings` * `projects/{project}/components/{component}/settings` * `projects/{project}/locations/{location}/clusters/{cluster}/components/{component}/settings` * `projects/{project}/regions/{region}/clusters/{cluster}/components/{component}/settings` * `projects/{project}/zones/{zone}/clusters/{cluster}/components/{component}/settings`

      Throws:
      ApiException - if the remote call fails

    • getComponentSettings

      public final ComponentSettings getComponentSettings(GetComponentSettingsRequest request)
      Gets the Component Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   GetComponentSettingsRequest request =
       GetComponentSettingsRequest.newBuilder()
           .setName(
               ComponentSettingsName.ofOrganizationComponentName("[ORGANIZATION]", "[COMPONENT]")
                   .toString())
           .build();
   ComponentSettings response =
       securityCenterSettingsServiceClient.getComponentSettings(request);
 }
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails

    • getComponentSettingsCallable

      public final UnaryCallable<GetComponentSettingsRequest,ComponentSettings> getComponentSettingsCallable()
      Gets the Component Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   GetComponentSettingsRequest request =
       GetComponentSettingsRequest.newBuilder()
           .setName(
               ComponentSettingsName.ofOrganizationComponentName("[ORGANIZATION]", "[COMPONENT]")
                   .toString())
           .build();
   ApiFuture<ComponentSettings> future =
       securityCenterSettingsServiceClient.getComponentSettingsCallable().futureCall(request);
   // Do something.
   ComponentSettings response = future.get();
 }

    • updateComponentSettings

      public final ComponentSettings updateComponentSettings(ComponentSettings componentSettings, com.google.protobuf.FieldMask updateMask)
      Updates the Component Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   ComponentSettings componentSettings = ComponentSettings.newBuilder().build();
   FieldMask updateMask = FieldMask.newBuilder().build();
   ComponentSettings response =
       securityCenterSettingsServiceClient.updateComponentSettings(
           componentSettings, updateMask);
 }
      Parameters:
      componentSettings - Required. The component settings to update.

      The component settings' `name` field is used to identify the component settings to be updated. Formats: * `organizations/{organization}/components/{component}/settings` * `folders/{folder}/components/{component}/settings` * `projects/{project}/components/{component}/settings` * `projects/{project}/locations/{location}/clusters/{cluster}/components/{component}/settings` * `projects/{project}/regions/{region}/clusters/{cluster}/components/{component}/settings` * `projects/{project}/zones/{zone}/clusters/{cluster}/components/{component}/settings`

      updateMask - The list of fields to be updated on the component settings resource.
      Throws:
      ApiException - if the remote call fails

    • updateComponentSettings

      public final ComponentSettings updateComponentSettings(UpdateComponentSettingsRequest request)
      Updates the Component Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   UpdateComponentSettingsRequest request =
       UpdateComponentSettingsRequest.newBuilder()
           .setComponentSettings(ComponentSettings.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   ComponentSettings response =
       securityCenterSettingsServiceClient.updateComponentSettings(request);
 }
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails

    • updateComponentSettingsCallable

      public final UnaryCallable<UpdateComponentSettingsRequest,ComponentSettings> updateComponentSettingsCallable()
      Updates the Component Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   UpdateComponentSettingsRequest request =
       UpdateComponentSettingsRequest.newBuilder()
           .setComponentSettings(ComponentSettings.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   ApiFuture<ComponentSettings> future =
       securityCenterSettingsServiceClient.updateComponentSettingsCallable().futureCall(request);
   // Do something.
   ComponentSettings response = future.get();
 }

    • resetComponentSettings

      public final void resetComponentSettings(ResetComponentSettingsRequest request)
      Reset the organization, folder or project's component settings and return the settings to the default. Settings are present at the organization, folder and project levels. Using Reset for a folder or project will remove the override that was set and result in the organization-level settings being used.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   ResetComponentSettingsRequest request =
       ResetComponentSettingsRequest.newBuilder()
           .setName(
               ComponentSettingsName.ofOrganizationComponentName("[ORGANIZATION]", "[COMPONENT]")
                   .toString())
           .setEtag("etag3123477")
           .build();
   securityCenterSettingsServiceClient.resetComponentSettings(request);
 }
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails

    • resetComponentSettingsCallable

      public final UnaryCallable<ResetComponentSettingsRequest,com.google.protobuf.Empty> resetComponentSettingsCallable()
      Reset the organization, folder or project's component settings and return the settings to the default. Settings are present at the organization, folder and project levels. Using Reset for a folder or project will remove the override that was set and result in the organization-level settings being used.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   ResetComponentSettingsRequest request =
       ResetComponentSettingsRequest.newBuilder()
           .setName(
               ComponentSettingsName.ofOrganizationComponentName("[ORGANIZATION]", "[COMPONENT]")
                   .toString())
           .setEtag("etag3123477")
           .build();
   ApiFuture<Empty> future =
       securityCenterSettingsServiceClient.resetComponentSettingsCallable().futureCall(request);
   // Do something.
   future.get();
 }

    • calculateEffectiveComponentSettings

      public final ComponentSettings calculateEffectiveComponentSettings(ComponentSettingsName name)
      Gets the Effective Component Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   ComponentSettingsName name =
       ComponentSettingsName.ofOrganizationComponentName("[ORGANIZATION]", "[COMPONENT]");
   ComponentSettings response =
       securityCenterSettingsServiceClient.calculateEffectiveComponentSettings(name);
 }
      Parameters:
      name - Required. The effective component settings to retrieve.

      Formats: * `organizations/{organization}/components/{component}/settings` * `folders/{folder}/components/{component}/settings` * `projects/{project}/components/{component}/settings` * `projects/{project}/locations/{location}/clusters/{cluster}/components/{component}/settings` * `projects/{project}/regions/{region}/clusters/{cluster}/components/{component}/settings` * `projects/{project}/zones/{zone}/clusters/{cluster}/components/{component}/settings`

      Throws:
      ApiException - if the remote call fails

    • calculateEffectiveComponentSettings

      public final ComponentSettings calculateEffectiveComponentSettings(String name)
      Gets the Effective Component Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   String name =
       ComponentSettingsName.ofOrganizationComponentName("[ORGANIZATION]", "[COMPONENT]")
           .toString();
   ComponentSettings response =
       securityCenterSettingsServiceClient.calculateEffectiveComponentSettings(name);
 }
      Parameters:
      name - Required. The effective component settings to retrieve.

      Formats: * `organizations/{organization}/components/{component}/settings` * `folders/{folder}/components/{component}/settings` * `projects/{project}/components/{component}/settings` * `projects/{project}/locations/{location}/clusters/{cluster}/components/{component}/settings` * `projects/{project}/regions/{region}/clusters/{cluster}/components/{component}/settings` * `projects/{project}/zones/{zone}/clusters/{cluster}/components/{component}/settings`

      Throws:
      ApiException - if the remote call fails

    • calculateEffectiveComponentSettings

      public final ComponentSettings calculateEffectiveComponentSettings(CalculateEffectiveComponentSettingsRequest request)
      Gets the Effective Component Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   CalculateEffectiveComponentSettingsRequest request =
       CalculateEffectiveComponentSettingsRequest.newBuilder()
           .setName(
               ComponentSettingsName.ofOrganizationComponentName("[ORGANIZATION]", "[COMPONENT]")
                   .toString())
           .build();
   ComponentSettings response =
       securityCenterSettingsServiceClient.calculateEffectiveComponentSettings(request);
 }
      Parameters:
      request - The request object containing all of the parameters for the API call.
      Throws:
      ApiException - if the remote call fails

    • calculateEffectiveComponentSettingsCallable

      public final UnaryCallable<CalculateEffectiveComponentSettingsRequest,ComponentSettings> calculateEffectiveComponentSettingsCallable()
      Gets the Effective Component Settings.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   CalculateEffectiveComponentSettingsRequest request =
       CalculateEffectiveComponentSettingsRequest.newBuilder()
           .setName(
               ComponentSettingsName.ofOrganizationComponentName("[ORGANIZATION]", "[COMPONENT]")
                   .toString())
           .build();
   ApiFuture<ComponentSettings> future =
       securityCenterSettingsServiceClient
           .calculateEffectiveComponentSettingsCallable()
           .futureCall(request);
   // Do something.
   ComponentSettings response = future.get();
 }

    • listDetectors

      public final SecurityCenterSettingsServiceClient.ListDetectorsPagedResponse listDetectors(OrganizationName parent)
      Retrieves an unordered list of available detectors.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   OrganizationName parent = OrganizationName.of("[ORGANIZATION]");
   for (Detector element :
       securityCenterSettingsServiceClient.listDetectors(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
      Parameters:
      parent - Required. The parent, which owns this collection of detectors. Format: * `organizations/{organization}`
      Throws:
      ApiException - if the remote call fails

    • listDetectors

      public final SecurityCenterSettingsServiceClient.ListDetectorsPagedResponse listDetectors(String parent)
      Retrieves an unordered list of available detectors.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   String parent = OrganizationName.of("[ORGANIZATION]").toString();
   for (Detector element :
       securityCenterSettingsServiceClient.listDetectors(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
      Parameters:
      parent - Required. The parent, which owns this collection of detectors. Format: * `organizations/{organization}`
      Throws:
      ApiException - if the remote call fails

    • listDetectors

      public final SecurityCenterSettingsServiceClient.ListDetectorsPagedResponse listDetectors(ListDetectorsRequest request)
      Retrieves an unordered list of available detectors.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   ListDetectorsRequest request =
       ListDetectorsRequest.newBuilder()
           .setParent(OrganizationName.of("[ORGANIZATION]").toString())
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   for (Detector element :
       securityCenterSettingsServiceClient.listDetectors(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

    • listDetectorsPagedCallable

      public final UnaryCallable<ListDetectorsRequest,SecurityCenterSettingsServiceClient.ListDetectorsPagedResponse> listDetectorsPagedCallable()
      Retrieves an unordered list of available detectors.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   ListDetectorsRequest request =
       ListDetectorsRequest.newBuilder()
           .setParent(OrganizationName.of("[ORGANIZATION]").toString())
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   ApiFuture<Detector> future =
       securityCenterSettingsServiceClient.listDetectorsPagedCallable().futureCall(request);
   // Do something.
   for (Detector element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }

    • listDetectorsCallable

      public final UnaryCallable<ListDetectorsRequest,ListDetectorsResponse> listDetectorsCallable()
      Retrieves an unordered list of available detectors.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   ListDetectorsRequest request =
       ListDetectorsRequest.newBuilder()
           .setParent(OrganizationName.of("[ORGANIZATION]").toString())
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   while (true) {
     ListDetectorsResponse response =
         securityCenterSettingsServiceClient.listDetectorsCallable().call(request);
     for (Detector element : response.getDetectorsList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }

    • listComponents

      public final SecurityCenterSettingsServiceClient.ListComponentsPagedResponse listComponents(OrganizationName parent)
      Retrieves an unordered list of available SCC components.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   OrganizationName parent = OrganizationName.of("[ORGANIZATION]");
   for (String element :
       securityCenterSettingsServiceClient.listComponents(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
      Parameters:
      parent - Required. The parent, which owns this collection of components. Format: * `organizations/{organization}`
      Throws:
      ApiException - if the remote call fails

    • listComponents

      public final SecurityCenterSettingsServiceClient.ListComponentsPagedResponse listComponents(String parent)
      Retrieves an unordered list of available SCC components.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   String parent = OrganizationName.of("[ORGANIZATION]").toString();
   for (String element :
       securityCenterSettingsServiceClient.listComponents(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
      Parameters:
      parent - Required. The parent, which owns this collection of components. Format: * `organizations/{organization}`
      Throws:
      ApiException - if the remote call fails

    • listComponents

      public final SecurityCenterSettingsServiceClient.ListComponentsPagedResponse listComponents(ListComponentsRequest request)
      Retrieves an unordered list of available SCC components.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   ListComponentsRequest request =
       ListComponentsRequest.newBuilder()
           .setParent(OrganizationName.of("[ORGANIZATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   for (String element :
       securityCenterSettingsServiceClient.listComponents(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

    • listComponentsPagedCallable

      public final UnaryCallable<ListComponentsRequest,SecurityCenterSettingsServiceClient.ListComponentsPagedResponse> listComponentsPagedCallable()
      Retrieves an unordered list of available SCC components.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   ListComponentsRequest request =
       ListComponentsRequest.newBuilder()
           .setParent(OrganizationName.of("[ORGANIZATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   ApiFuture<String> future =
       securityCenterSettingsServiceClient.listComponentsPagedCallable().futureCall(request);
   // Do something.
   for (String element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }

    • listComponentsCallable

      public final UnaryCallable<ListComponentsRequest,ListComponentsResponse> listComponentsCallable()
      Retrieves an unordered list of available SCC components.

      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 (SecurityCenterSettingsServiceClient securityCenterSettingsServiceClient =
     SecurityCenterSettingsServiceClient.create()) {
   ListComponentsRequest request =
       ListComponentsRequest.newBuilder()
           .setParent(OrganizationName.of("[ORGANIZATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   while (true) {
     ListComponentsResponse response =
         securityCenterSettingsServiceClient.listComponentsCallable().call(request);
     for (String element : response.getComponentsList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }

    • 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