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

Class SecurityCenterSettingsServiceClient

  • All Implemented Interfaces:
    com.google.api.gax.core.BackgroundResource, AutoCloseable
    @BetaApi
@Generated("by gapic-generator-java")
public class SecurityCenterSettingsServiceClient
extends Object
implements com.google.api.gax.core.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().

    The surface of this class includes several types of Java methods for each of the API's methods:

    1. A "flattened" method. With this type of method, the fields of the request type have been converted into function parameters. It may be the case that not all fields are available as parameters, and not every API method will have a flattened method entry point.
    2. A "request object" method. This type of method only takes one parameter, a request object, which must be constructed before the call. Not every API method will have a request object method.
    3. A "callable" method. This type of method takes no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    See the individual methods for example code.

    Many parameters require resource names to be formatted in a particular way. To assist with these names, this class includes a format method for each type of name, and additionally a parse method to extract the individual identifiers contained within names that are returned.

    This class can be customized by passing in a custom instance of 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 Detail

      • 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

    • Method Detail

      • 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:
        com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • getServiceAccountCallable

        public final com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • getSettingsCallable

        public final com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • updateSettingsCallable

        public final com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • resetSettingsCallable

        public final com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • batchGetSettingsCallable

        public final com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • calculateEffectiveSettingsCallable

        public final com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • batchCalculateEffectiveSettingsCallable

        public final com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • getComponentSettingsCallable

        public final com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • updateComponentSettingsCallable

        public final com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • resetComponentSettingsCallable

        public final com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • calculateEffectiveComponentSettingsCallable

        public final com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • listDetectorsPagedCallable

        public final com.google.api.gax.rpc.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 com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.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:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • listComponentsPagedCallable

        public final com.google.api.gax.rpc.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 com.google.api.gax.rpc.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;
     }
   }
 }

      • shutdown

        public void shutdown()
        Specified by:
        shutdown in interface com.google.api.gax.core.BackgroundResource

      • isShutdown

        public boolean isShutdown()
        Specified by:
        isShutdown in interface com.google.api.gax.core.BackgroundResource

      • isTerminated

        public boolean isTerminated()
        Specified by:
        isTerminated in interface com.google.api.gax.core.BackgroundResource

      • shutdownNow

        public void shutdownNow()
        Specified by:
        shutdownNow in interface com.google.api.gax.core.BackgroundResource