diff --git a/java-publicca/README.md b/java-publicca/README.md index af223cdfd40b..2cc2bae3d532 100644 --- a/java-publicca/README.md +++ b/java-publicca/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-publicca.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-publicca/0.29.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-publicca/0.30.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-publicca/google-cloud-publicca/src/main/java/com/google/cloud/security/publicca/v1beta1/PublicCertificateAuthorityServiceClient.java b/java-publicca/google-cloud-publicca/src/main/java/com/google/cloud/security/publicca/v1beta1/PublicCertificateAuthorityServiceClient.java index 89953bb30c87..a7476a04fe12 100644 --- a/java-publicca/google-cloud-publicca/src/main/java/com/google/cloud/security/publicca/v1beta1/PublicCertificateAuthorityServiceClient.java +++ b/java-publicca/google-cloud-publicca/src/main/java/com/google/cloud/security/publicca/v1beta1/PublicCertificateAuthorityServiceClient.java @@ -55,30 +55,31 @@ * automatically calls close(). * * + * * * * * + * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
CreateExternalAccountKey

CreateExternalAccountKey

Creates a new [ExternalAccountKey][google.cloud.security.publicca.v1beta1.ExternalAccountKey] bound to the project.

*

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

*
    - *
  • createExternalAccountKey(CreateExternalAccountKeyRequest request) + *
  • createExternalAccountKey(CreateExternalAccountKeyRequest request) *

*

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

*
    - *
  • createExternalAccountKey(LocationName parent, ExternalAccountKey externalAccountKey) - *
  • createExternalAccountKey(String parent, ExternalAccountKey externalAccountKey) + *
  • createExternalAccountKey(LocationName parent, ExternalAccountKey externalAccountKey) + *

  • createExternalAccountKey(String parent, ExternalAccountKey externalAccountKey) *

*

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

*
    - *
  • createExternalAccountKeyCallable() + *
  • createExternalAccountKeyCallable() *

*
* *

See the individual methods for example code. diff --git a/java-publicca/google-cloud-publicca/src/main/java/com/google/cloud/security/publicca/v1beta1/stub/PublicCertificateAuthorityServiceStubSettings.java b/java-publicca/google-cloud-publicca/src/main/java/com/google/cloud/security/publicca/v1beta1/stub/PublicCertificateAuthorityServiceStubSettings.java index bce24e51f033..77a9b6a13f13 100644 --- a/java-publicca/google-cloud-publicca/src/main/java/com/google/cloud/security/publicca/v1beta1/stub/PublicCertificateAuthorityServiceStubSettings.java +++ b/java-publicca/google-cloud-publicca/src/main/java/com/google/cloud/security/publicca/v1beta1/stub/PublicCertificateAuthorityServiceStubSettings.java @@ -117,6 +117,15 @@ public PublicCertificateAuthorityServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -286,7 +295,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -299,7 +307,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -336,6 +343,15 @@ public Builder applyToAllUnaryMethods( return createExternalAccountKeySettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public PublicCertificateAuthorityServiceStubSettings build() throws IOException { return new PublicCertificateAuthorityServiceStubSettings(this); diff --git a/java-rapidmigrationassessment/README.md b/java-rapidmigrationassessment/README.md index 44ba5bf7c49b..ab3b384ef727 100644 --- a/java-rapidmigrationassessment/README.md +++ b/java-rapidmigrationassessment/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-rapidmigrationassessment/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-rapidmigrationassessment.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-rapidmigrationassessment/0.15.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-rapidmigrationassessment/0.16.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-rapidmigrationassessment/google-cloud-rapidmigrationassessment/src/main/java/com/google/cloud/rapidmigrationassessment/v1/RapidMigrationAssessmentClient.java b/java-rapidmigrationassessment/google-cloud-rapidmigrationassessment/src/main/java/com/google/cloud/rapidmigrationassessment/v1/RapidMigrationAssessmentClient.java index 78bb67fef5b6..4276e664c241 100644 --- a/java-rapidmigrationassessment/google-cloud-rapidmigrationassessment/src/main/java/com/google/cloud/rapidmigrationassessment/v1/RapidMigrationAssessmentClient.java +++ b/java-rapidmigrationassessment/google-cloud-rapidmigrationassessment/src/main/java/com/google/cloud/rapidmigrationassessment/v1/RapidMigrationAssessmentClient.java @@ -67,237 +67,238 @@ * calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
CreateCollector

CreateCollector

Create a Collector to manage the on-prem appliance which collects information about Customer assets.

*

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

*
    - *
  • createCollectorAsync(CreateCollectorRequest request) + *
  • createCollectorAsync(CreateCollectorRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createCollectorAsync(LocationName parent, Collector collector, String collectorId) - *
  • createCollectorAsync(String parent, Collector collector, String collectorId) + *
  • createCollectorAsync(LocationName parent, Collector collector, String collectorId) + *

  • createCollectorAsync(String parent, Collector collector, String collectorId) *

*

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

*
    - *
  • createCollectorOperationCallable() - *
  • createCollectorCallable() + *
  • createCollectorOperationCallable() + *

  • createCollectorCallable() *

*
CreateAnnotation

CreateAnnotation

Creates an Annotation

*

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

*
    - *
  • createAnnotationAsync(CreateAnnotationRequest request) + *
  • createAnnotationAsync(CreateAnnotationRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createAnnotationAsync(LocationName parent, Annotation annotation) - *
  • createAnnotationAsync(String parent, Annotation annotation) + *
  • createAnnotationAsync(LocationName parent, Annotation annotation) + *

  • createAnnotationAsync(String parent, Annotation annotation) *

*

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

*
    - *
  • createAnnotationOperationCallable() - *
  • createAnnotationCallable() + *
  • createAnnotationOperationCallable() + *

  • createAnnotationCallable() *

*
GetAnnotation

GetAnnotation

Gets details of a single Annotation.

*

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

*
    - *
  • getAnnotation(GetAnnotationRequest request) + *
  • getAnnotation(GetAnnotationRequest request) *

*

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

*
    - *
  • getAnnotation(AnnotationName name) - *
  • getAnnotation(String name) + *
  • getAnnotation(AnnotationName name) + *

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

*
    - *
  • getAnnotationCallable() + *
  • getAnnotationCallable() *

*
ListCollectors

ListCollectors

Lists Collectors in a given project and location.

*

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

*
    - *
  • listCollectors(ListCollectorsRequest request) + *
  • listCollectors(ListCollectorsRequest request) *

*

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

*
    - *
  • listCollectors(LocationName parent) - *
  • listCollectors(String parent) + *
  • listCollectors(LocationName parent) + *

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

*
    - *
  • listCollectorsPagedCallable() - *
  • listCollectorsCallable() + *
  • listCollectorsPagedCallable() + *

  • listCollectorsCallable() *

*
GetCollector

GetCollector

Gets details of a single Collector.

*

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

*
    - *
  • getCollector(GetCollectorRequest request) + *
  • getCollector(GetCollectorRequest request) *

*

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

*
    - *
  • getCollector(CollectorName name) - *
  • getCollector(String name) + *
  • getCollector(CollectorName name) + *

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

*
    - *
  • getCollectorCallable() + *
  • getCollectorCallable() *

*
UpdateCollector

UpdateCollector

Updates the parameters of a single Collector.

*

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

*
    - *
  • updateCollectorAsync(UpdateCollectorRequest request) + *
  • updateCollectorAsync(UpdateCollectorRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateCollectorAsync(Collector collector, FieldMask updateMask) + *
  • updateCollectorAsync(Collector collector, 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.

*
    - *
  • updateCollectorOperationCallable() - *
  • updateCollectorCallable() + *
  • updateCollectorOperationCallable() + *

  • updateCollectorCallable() *

*
DeleteCollector

DeleteCollector

Deletes a single Collector - changes state of collector to "Deleting". Background jobs does final deletion thorugh producer api.

*

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

*
    - *
  • deleteCollectorAsync(DeleteCollectorRequest request) + *
  • deleteCollectorAsync(DeleteCollectorRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteCollectorAsync(CollectorName name) - *
  • deleteCollectorAsync(String name) + *
  • deleteCollectorAsync(CollectorName name) + *

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

*
    - *
  • deleteCollectorOperationCallable() - *
  • deleteCollectorCallable() + *
  • deleteCollectorOperationCallable() + *

  • deleteCollectorCallable() *

*
ResumeCollector

ResumeCollector

Resumes the given collector.

*

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

*
    - *
  • resumeCollectorAsync(ResumeCollectorRequest request) + *
  • resumeCollectorAsync(ResumeCollectorRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • resumeCollectorAsync(CollectorName name) - *
  • resumeCollectorAsync(String name) + *
  • resumeCollectorAsync(CollectorName name) + *

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

*
    - *
  • resumeCollectorOperationCallable() - *
  • resumeCollectorCallable() + *
  • resumeCollectorOperationCallable() + *

  • resumeCollectorCallable() *

*
RegisterCollector

RegisterCollector

Registers the given collector.

*

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

*
    - *
  • registerCollectorAsync(RegisterCollectorRequest request) + *
  • registerCollectorAsync(RegisterCollectorRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • registerCollectorAsync(CollectorName name) - *
  • registerCollectorAsync(String name) + *
  • registerCollectorAsync(CollectorName name) + *

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

*
    - *
  • registerCollectorOperationCallable() - *
  • registerCollectorCallable() + *
  • registerCollectorOperationCallable() + *

  • registerCollectorCallable() *

*
PauseCollector

PauseCollector

Pauses the given collector.

*

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

*
    - *
  • pauseCollectorAsync(PauseCollectorRequest request) + *
  • pauseCollectorAsync(PauseCollectorRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • pauseCollectorAsync(CollectorName name) - *
  • pauseCollectorAsync(String name) + *
  • pauseCollectorAsync(CollectorName name) + *

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

*
    - *
  • pauseCollectorOperationCallable() - *
  • pauseCollectorCallable() + *
  • pauseCollectorOperationCallable() + *

  • pauseCollectorCallable() *

*
ListLocations

ListLocations

Lists information about the supported locations for this service.

*

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

*
    - *
  • listLocations(ListLocationsRequest request) + *
  • listLocations(ListLocationsRequest request) *

*

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

*
    - *
  • listLocationsPagedCallable() - *
  • listLocationsCallable() + *
  • listLocationsPagedCallable() + *

  • listLocationsCallable() *

*
GetLocation

GetLocation

Gets information about a location.

*

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

*
    - *
  • getLocation(GetLocationRequest request) + *
  • getLocation(GetLocationRequest request) *

*

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

*
    - *
  • getLocationCallable() + *
  • getLocationCallable() *

*
* *

See the individual methods for example code. diff --git a/java-rapidmigrationassessment/google-cloud-rapidmigrationassessment/src/main/java/com/google/cloud/rapidmigrationassessment/v1/stub/RapidMigrationAssessmentStubSettings.java b/java-rapidmigrationassessment/google-cloud-rapidmigrationassessment/src/main/java/com/google/cloud/rapidmigrationassessment/v1/stub/RapidMigrationAssessmentStubSettings.java index 40ec81babc72..12009df098e4 100644 --- a/java-rapidmigrationassessment/google-cloud-rapidmigrationassessment/src/main/java/com/google/cloud/rapidmigrationassessment/v1/stub/RapidMigrationAssessmentStubSettings.java +++ b/java-rapidmigrationassessment/google-cloud-rapidmigrationassessment/src/main/java/com/google/cloud/rapidmigrationassessment/v1/stub/RapidMigrationAssessmentStubSettings.java @@ -381,6 +381,15 @@ public RapidMigrationAssessmentStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -681,7 +690,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -694,7 +702,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -1070,6 +1077,15 @@ public UnaryCallSettings.Builder getLocationSettin return getLocationSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public RapidMigrationAssessmentStubSettings build() throws IOException { return new RapidMigrationAssessmentStubSettings(this); diff --git a/java-recaptchaenterprise/google-cloud-recaptchaenterprise/src/main/java/com/google/cloud/recaptchaenterprise/v1/RecaptchaEnterpriseServiceClient.java b/java-recaptchaenterprise/google-cloud-recaptchaenterprise/src/main/java/com/google/cloud/recaptchaenterprise/v1/RecaptchaEnterpriseServiceClient.java index c10ac8219d78..25ade428b63e 100644 --- a/java-recaptchaenterprise/google-cloud-recaptchaenterprise/src/main/java/com/google/cloud/recaptchaenterprise/v1/RecaptchaEnterpriseServiceClient.java +++ b/java-recaptchaenterprise/google-cloud-recaptchaenterprise/src/main/java/com/google/cloud/recaptchaenterprise/v1/RecaptchaEnterpriseServiceClient.java @@ -98,351 +98,352 @@ * calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
CreateAssessment

CreateAssessment

Creates an Assessment of the likelihood an event is legitimate.

*

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

*
    - *
  • createAssessment(CreateAssessmentRequest request) + *
  • createAssessment(CreateAssessmentRequest request) *

*

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

*
    - *
  • createAssessment(ProjectName parent, Assessment assessment) - *
  • createAssessment(String parent, Assessment assessment) + *
  • createAssessment(ProjectName parent, Assessment assessment) + *

  • createAssessment(String parent, Assessment assessment) *

*

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

*
    - *
  • createAssessmentCallable() + *
  • createAssessmentCallable() *

*
AnnotateAssessment

AnnotateAssessment

Annotates a previously created Assessment to provide additional information on whether the event turned out to be authentic or fraudulent.

*

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

*
    - *
  • annotateAssessment(AnnotateAssessmentRequest request) + *
  • annotateAssessment(AnnotateAssessmentRequest request) *

*

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

*
    - *
  • annotateAssessment(AssessmentName name, AnnotateAssessmentRequest.Annotation annotation) - *
  • annotateAssessment(String name, AnnotateAssessmentRequest.Annotation annotation) + *
  • annotateAssessment(AssessmentName name, AnnotateAssessmentRequest.Annotation annotation) + *

  • annotateAssessment(String name, AnnotateAssessmentRequest.Annotation annotation) *

*

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

*
    - *
  • annotateAssessmentCallable() + *
  • annotateAssessmentCallable() *

*
CreateKey

CreateKey

Creates a new reCAPTCHA Enterprise key.

*

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

*
    - *
  • createKey(CreateKeyRequest request) + *
  • createKey(CreateKeyRequest request) *

*

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

*
    - *
  • createKey(ProjectName parent, Key key) - *
  • createKey(String parent, Key key) + *
  • createKey(ProjectName parent, Key key) + *

  • createKey(String parent, Key key) *

*

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

*
    - *
  • createKeyCallable() + *
  • createKeyCallable() *

*
ListKeys

ListKeys

Returns the list of all keys that belong to a project.

*

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

*
    - *
  • listKeys(ListKeysRequest request) + *
  • listKeys(ListKeysRequest request) *

*

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

*
    - *
  • listKeys(ProjectName parent) - *
  • listKeys(String parent) + *
  • listKeys(ProjectName parent) + *

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

*
    - *
  • listKeysPagedCallable() - *
  • listKeysCallable() + *
  • listKeysPagedCallable() + *

  • listKeysCallable() *

*
RetrieveLegacySecretKey

RetrieveLegacySecretKey

Returns the secret key related to the specified public key. You must use the legacy secret key only in a 3rd party integration with legacy reCAPTCHA.

*

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

*
    - *
  • retrieveLegacySecretKey(RetrieveLegacySecretKeyRequest request) + *
  • retrieveLegacySecretKey(RetrieveLegacySecretKeyRequest request) *

*

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

*
    - *
  • retrieveLegacySecretKey(KeyName key) - *
  • retrieveLegacySecretKey(String key) + *
  • retrieveLegacySecretKey(KeyName key) + *

  • retrieveLegacySecretKey(String key) *

*

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

*
    - *
  • retrieveLegacySecretKeyCallable() + *
  • retrieveLegacySecretKeyCallable() *

*
GetKey

GetKey

Returns the specified key.

*

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

*
    - *
  • getKey(GetKeyRequest request) + *
  • getKey(GetKeyRequest request) *

*

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

*
    - *
  • getKey(KeyName name) - *
  • getKey(String name) + *
  • getKey(KeyName name) + *

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

*
    - *
  • getKeyCallable() + *
  • getKeyCallable() *

*
UpdateKey

UpdateKey

Updates the specified key.

*

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

*
    - *
  • updateKey(UpdateKeyRequest request) + *
  • updateKey(UpdateKeyRequest request) *

*

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

*
    - *
  • updateKey(Key key, FieldMask updateMask) + *
  • updateKey(Key key, 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.

*
    - *
  • updateKeyCallable() + *
  • updateKeyCallable() *

*
DeleteKey

DeleteKey

Deletes the specified key.

*

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

*
    - *
  • deleteKey(DeleteKeyRequest request) + *
  • deleteKey(DeleteKeyRequest request) *

*

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

*
    - *
  • deleteKey(KeyName name) - *
  • deleteKey(String name) + *
  • deleteKey(KeyName name) + *

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

*
    - *
  • deleteKeyCallable() + *
  • deleteKeyCallable() *

*
MigrateKey

MigrateKey

Migrates an existing key from reCAPTCHA to reCAPTCHA Enterprise. Once a key is migrated, it can be used from either product. SiteVerify requests are billed as CreateAssessment calls. You must be authenticated as one of the current owners of the reCAPTCHA Key, and your user must have the reCAPTCHA Enterprise Admin IAM role in the destination project.

*

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

*
    - *
  • migrateKey(MigrateKeyRequest request) + *
  • migrateKey(MigrateKeyRequest request) *

*

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

*
    - *
  • migrateKeyCallable() + *
  • migrateKeyCallable() *

*
GetMetrics

GetMetrics

Get some aggregated metrics for a Key. This data can be used to build dashboards.

*

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

*
    - *
  • getMetrics(GetMetricsRequest request) + *
  • getMetrics(GetMetricsRequest request) *

*

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

*
    - *
  • getMetrics(MetricsName name) - *
  • getMetrics(String name) + *
  • getMetrics(MetricsName name) + *

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

*
    - *
  • getMetricsCallable() + *
  • getMetricsCallable() *

*
CreateFirewallPolicy

CreateFirewallPolicy

Creates a new FirewallPolicy, specifying conditions at which reCAPTCHA Enterprise actions can be executed. A project may have a maximum of 1000 policies.

*

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

*
    - *
  • createFirewallPolicy(CreateFirewallPolicyRequest request) + *
  • createFirewallPolicy(CreateFirewallPolicyRequest request) *

*

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

*
    - *
  • createFirewallPolicy(ProjectName parent, FirewallPolicy firewallPolicy) - *
  • createFirewallPolicy(String parent, FirewallPolicy firewallPolicy) + *
  • createFirewallPolicy(ProjectName parent, FirewallPolicy firewallPolicy) + *

  • createFirewallPolicy(String parent, FirewallPolicy firewallPolicy) *

*

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

*
    - *
  • createFirewallPolicyCallable() + *
  • createFirewallPolicyCallable() *

*
ListFirewallPolicies

ListFirewallPolicies

Returns the list of all firewall policies that belong to a project.

*

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

*
    - *
  • listFirewallPolicies(ListFirewallPoliciesRequest request) + *
  • listFirewallPolicies(ListFirewallPoliciesRequest request) *

*

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

*
    - *
  • listFirewallPolicies(ProjectName parent) - *
  • listFirewallPolicies(String parent) + *
  • listFirewallPolicies(ProjectName parent) + *

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

*
    - *
  • listFirewallPoliciesPagedCallable() - *
  • listFirewallPoliciesCallable() + *
  • listFirewallPoliciesPagedCallable() + *

  • listFirewallPoliciesCallable() *

*
GetFirewallPolicy

GetFirewallPolicy

Returns the specified firewall policy.

*

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

*
    - *
  • getFirewallPolicy(GetFirewallPolicyRequest request) + *
  • getFirewallPolicy(GetFirewallPolicyRequest request) *

*

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

*
    - *
  • getFirewallPolicy(FirewallPolicyName name) - *
  • getFirewallPolicy(String name) + *
  • getFirewallPolicy(FirewallPolicyName name) + *

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

*
    - *
  • getFirewallPolicyCallable() + *
  • getFirewallPolicyCallable() *

*
UpdateFirewallPolicy

UpdateFirewallPolicy

Updates the specified firewall policy.

*

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

*
    - *
  • updateFirewallPolicy(UpdateFirewallPolicyRequest request) + *
  • updateFirewallPolicy(UpdateFirewallPolicyRequest request) *

*

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

*
    - *
  • updateFirewallPolicy(FirewallPolicy firewallPolicy, FieldMask updateMask) + *
  • updateFirewallPolicy(FirewallPolicy firewallPolicy, 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.

*
    - *
  • updateFirewallPolicyCallable() + *
  • updateFirewallPolicyCallable() *

*
DeleteFirewallPolicy

DeleteFirewallPolicy

Deletes the specified firewall policy.

*

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

*
    - *
  • deleteFirewallPolicy(DeleteFirewallPolicyRequest request) + *
  • deleteFirewallPolicy(DeleteFirewallPolicyRequest request) *

*

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

*
    - *
  • deleteFirewallPolicy(FirewallPolicyName name) - *
  • deleteFirewallPolicy(String name) + *
  • deleteFirewallPolicy(FirewallPolicyName name) + *

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

*
    - *
  • deleteFirewallPolicyCallable() + *
  • deleteFirewallPolicyCallable() *

*
ListRelatedAccountGroups

ListRelatedAccountGroups

List groups of related accounts.

*

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

*
    - *
  • listRelatedAccountGroups(ListRelatedAccountGroupsRequest request) + *
  • listRelatedAccountGroups(ListRelatedAccountGroupsRequest request) *

*

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

*
    - *
  • listRelatedAccountGroups(ProjectName parent) - *
  • listRelatedAccountGroups(String parent) + *
  • listRelatedAccountGroups(ProjectName parent) + *

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

*
    - *
  • listRelatedAccountGroupsPagedCallable() - *
  • listRelatedAccountGroupsCallable() + *
  • listRelatedAccountGroupsPagedCallable() + *

  • listRelatedAccountGroupsCallable() *

*
ListRelatedAccountGroupMemberships

ListRelatedAccountGroupMemberships

Get memberships in a group of related accounts.

*

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

*
    - *
  • listRelatedAccountGroupMemberships(ListRelatedAccountGroupMembershipsRequest request) + *
  • listRelatedAccountGroupMemberships(ListRelatedAccountGroupMembershipsRequest request) *

*

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

*
    - *
  • listRelatedAccountGroupMemberships(RelatedAccountGroupName parent) - *
  • listRelatedAccountGroupMemberships(String parent) + *
  • listRelatedAccountGroupMemberships(RelatedAccountGroupName parent) + *

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

*
    - *
  • listRelatedAccountGroupMembershipsPagedCallable() - *
  • listRelatedAccountGroupMembershipsCallable() + *
  • listRelatedAccountGroupMembershipsPagedCallable() + *

  • listRelatedAccountGroupMembershipsCallable() *

*
SearchRelatedAccountGroupMemberships

SearchRelatedAccountGroupMemberships

Search group memberships related to a given account.

*

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

*
    - *
  • searchRelatedAccountGroupMemberships(SearchRelatedAccountGroupMembershipsRequest request) + *
  • searchRelatedAccountGroupMemberships(SearchRelatedAccountGroupMembershipsRequest request) *

*

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

*
    - *
  • searchRelatedAccountGroupMemberships(RelatedAccountGroupName project, ByteString hashedAccountId) - *
  • searchRelatedAccountGroupMemberships(String project, ByteString hashedAccountId) + *
  • searchRelatedAccountGroupMemberships(RelatedAccountGroupName project, ByteString hashedAccountId) + *

  • searchRelatedAccountGroupMemberships(String project, ByteString hashedAccountId) *

*

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

*
    - *
  • searchRelatedAccountGroupMembershipsPagedCallable() - *
  • searchRelatedAccountGroupMembershipsCallable() + *
  • searchRelatedAccountGroupMembershipsPagedCallable() + *

  • searchRelatedAccountGroupMembershipsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-recaptchaenterprise/google-cloud-recaptchaenterprise/src/main/java/com/google/cloud/recaptchaenterprise/v1/stub/RecaptchaEnterpriseServiceStubSettings.java b/java-recaptchaenterprise/google-cloud-recaptchaenterprise/src/main/java/com/google/cloud/recaptchaenterprise/v1/stub/RecaptchaEnterpriseServiceStubSettings.java index 3b635b6d1c91..6c6f4e259365 100644 --- a/java-recaptchaenterprise/google-cloud-recaptchaenterprise/src/main/java/com/google/cloud/recaptchaenterprise/v1/stub/RecaptchaEnterpriseServiceStubSettings.java +++ b/java-recaptchaenterprise/google-cloud-recaptchaenterprise/src/main/java/com/google/cloud/recaptchaenterprise/v1/stub/RecaptchaEnterpriseServiceStubSettings.java @@ -651,6 +651,15 @@ public RecaptchaEnterpriseServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -926,7 +935,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -1161,6 +1169,15 @@ public UnaryCallSettings.Builder getMetricsSettings( return searchRelatedAccountGroupMembershipsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public RecaptchaEnterpriseServiceStubSettings build() throws IOException { return new RecaptchaEnterpriseServiceStubSettings(this); diff --git a/java-recaptchaenterprise/google-cloud-recaptchaenterprise/src/main/java/com/google/cloud/recaptchaenterprise/v1beta1/RecaptchaEnterpriseServiceV1Beta1Client.java b/java-recaptchaenterprise/google-cloud-recaptchaenterprise/src/main/java/com/google/cloud/recaptchaenterprise/v1beta1/RecaptchaEnterpriseServiceV1Beta1Client.java index 671a25d18b27..8f5957a0d3c1 100644 --- a/java-recaptchaenterprise/google-cloud-recaptchaenterprise/src/main/java/com/google/cloud/recaptchaenterprise/v1beta1/RecaptchaEnterpriseServiceV1Beta1Client.java +++ b/java-recaptchaenterprise/google-cloud-recaptchaenterprise/src/main/java/com/google/cloud/recaptchaenterprise/v1beta1/RecaptchaEnterpriseServiceV1Beta1Client.java @@ -58,49 +58,50 @@ * automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
CreateAssessment

CreateAssessment

Creates an Assessment of the likelihood an event is legitimate.

*

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

*
    - *
  • createAssessment(CreateAssessmentRequest request) + *
  • createAssessment(CreateAssessmentRequest request) *

*

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

*
    - *
  • createAssessment(ProjectName parent, Assessment assessment) - *
  • createAssessment(String parent, Assessment assessment) + *
  • createAssessment(ProjectName parent, Assessment assessment) + *

  • createAssessment(String parent, Assessment assessment) *

*

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

*
    - *
  • createAssessmentCallable() + *
  • createAssessmentCallable() *

*
AnnotateAssessment

AnnotateAssessment

Annotates a previously created Assessment to provide additional information on whether the event turned out to be authentic or fradulent.

*

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

*
    - *
  • annotateAssessment(AnnotateAssessmentRequest request) + *
  • annotateAssessment(AnnotateAssessmentRequest request) *

*

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

*
    - *
  • annotateAssessment(AssessmentName name, AnnotateAssessmentRequest.Annotation annotation) - *
  • annotateAssessment(String name, AnnotateAssessmentRequest.Annotation annotation) + *
  • annotateAssessment(AssessmentName name, AnnotateAssessmentRequest.Annotation annotation) + *

  • annotateAssessment(String name, AnnotateAssessmentRequest.Annotation annotation) *

*

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

*
    - *
  • annotateAssessmentCallable() + *
  • annotateAssessmentCallable() *

*
* *

See the individual methods for example code. diff --git a/java-recaptchaenterprise/google-cloud-recaptchaenterprise/src/main/java/com/google/cloud/recaptchaenterprise/v1beta1/stub/RecaptchaEnterpriseServiceV1Beta1StubSettings.java b/java-recaptchaenterprise/google-cloud-recaptchaenterprise/src/main/java/com/google/cloud/recaptchaenterprise/v1beta1/stub/RecaptchaEnterpriseServiceV1Beta1StubSettings.java index 9887f034cb90..08dd8806e0ce 100644 --- a/java-recaptchaenterprise/google-cloud-recaptchaenterprise/src/main/java/com/google/cloud/recaptchaenterprise/v1beta1/stub/RecaptchaEnterpriseServiceV1Beta1StubSettings.java +++ b/java-recaptchaenterprise/google-cloud-recaptchaenterprise/src/main/java/com/google/cloud/recaptchaenterprise/v1beta1/stub/RecaptchaEnterpriseServiceV1Beta1StubSettings.java @@ -126,6 +126,15 @@ public RecaptchaEnterpriseServiceV1Beta1Stub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -298,7 +307,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -311,7 +319,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -359,6 +366,15 @@ public Builder applyToAllUnaryMethods( return annotateAssessmentSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public RecaptchaEnterpriseServiceV1Beta1StubSettings build() throws IOException { return new RecaptchaEnterpriseServiceV1Beta1StubSettings(this); diff --git a/java-recommendations-ai/README.md b/java-recommendations-ai/README.md index 982059cddb5e..ddd6b601bb77 100644 --- a/java-recommendations-ai/README.md +++ b/java-recommendations-ai/README.md @@ -202,7 +202,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-recommendations-ai.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-recommendations-ai/0.39.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-recommendations-ai/0.40.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/CatalogServiceClient.java b/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/CatalogServiceClient.java index 2e23e053d512..fd76113fc30b 100644 --- a/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/CatalogServiceClient.java +++ b/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/CatalogServiceClient.java @@ -63,125 +63,126 @@ * as threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
CreateCatalogItem

CreateCatalogItem

Creates a catalog item.

*

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

*
    - *
  • createCatalogItem(CreateCatalogItemRequest request) + *
  • createCatalogItem(CreateCatalogItemRequest request) *

*

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

*
    - *
  • createCatalogItem(CatalogName parent, CatalogItem catalogItem) - *
  • createCatalogItem(String parent, CatalogItem catalogItem) + *
  • createCatalogItem(CatalogName parent, CatalogItem catalogItem) + *

  • createCatalogItem(String parent, CatalogItem catalogItem) *

*

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

*
    - *
  • createCatalogItemCallable() + *
  • createCatalogItemCallable() *

*
GetCatalogItem

GetCatalogItem

Gets a specific catalog item.

*

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

*
    - *
  • getCatalogItem(GetCatalogItemRequest request) + *
  • getCatalogItem(GetCatalogItemRequest request) *

*

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

*
    - *
  • getCatalogItem(CatalogItemPathName name) - *
  • getCatalogItem(String name) + *
  • getCatalogItem(CatalogItemPathName name) + *

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

*
    - *
  • getCatalogItemCallable() + *
  • getCatalogItemCallable() *

*
ListCatalogItems

ListCatalogItems

Gets a list of catalog items.

*

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

*
    - *
  • listCatalogItems(ListCatalogItemsRequest request) + *
  • listCatalogItems(ListCatalogItemsRequest request) *

*

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

*
    - *
  • listCatalogItems(CatalogName parent, String filter) - *
  • listCatalogItems(String parent, String filter) + *
  • listCatalogItems(CatalogName parent, String filter) + *

  • listCatalogItems(String parent, String filter) *

*

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

*
    - *
  • listCatalogItemsPagedCallable() - *
  • listCatalogItemsCallable() + *
  • listCatalogItemsPagedCallable() + *

  • listCatalogItemsCallable() *

*
UpdateCatalogItem

UpdateCatalogItem

Updates a catalog item. Partial updating is supported. Non-existing items will be created.

*

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

*
    - *
  • updateCatalogItem(UpdateCatalogItemRequest request) + *
  • updateCatalogItem(UpdateCatalogItemRequest request) *

*

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

*
    - *
  • updateCatalogItem(CatalogItemPathName name, CatalogItem catalogItem, FieldMask updateMask) - *
  • updateCatalogItem(String name, CatalogItem catalogItem, FieldMask updateMask) + *
  • updateCatalogItem(CatalogItemPathName name, CatalogItem catalogItem, FieldMask updateMask) + *

  • updateCatalogItem(String name, CatalogItem catalogItem, 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.

*
    - *
  • updateCatalogItemCallable() + *
  • updateCatalogItemCallable() *

*
DeleteCatalogItem

DeleteCatalogItem

Deletes a catalog item.

*

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

*
    - *
  • deleteCatalogItem(DeleteCatalogItemRequest request) + *
  • deleteCatalogItem(DeleteCatalogItemRequest request) *

*

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

*
    - *
  • deleteCatalogItem(CatalogItemPathName name) - *
  • deleteCatalogItem(String name) + *
  • deleteCatalogItem(CatalogItemPathName name) + *

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

*
    - *
  • deleteCatalogItemCallable() + *
  • deleteCatalogItemCallable() *

*
ImportCatalogItems

ImportCatalogItems

Bulk import of multiple catalog items. Request processing may be synchronous. No partial updating supported. Non-existing items will be created. *

Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully updated.

*

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

*
    - *
  • importCatalogItemsAsync(CatalogName parent, String requestId, InputConfig inputConfig, ImportErrorsConfig errorsConfig) - *
  • importCatalogItemsAsync(String parent, String requestId, InputConfig inputConfig, ImportErrorsConfig errorsConfig) - *
  • importCatalogItemsAsync(ImportCatalogItemsRequest request) + *
  • importCatalogItemsAsync(CatalogName parent, String requestId, InputConfig inputConfig, ImportErrorsConfig errorsConfig) + *

  • importCatalogItemsAsync(String parent, String requestId, InputConfig inputConfig, ImportErrorsConfig errorsConfig) + *

  • importCatalogItemsAsync(ImportCatalogItemsRequest request) *

*

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

*
    - *
  • importCatalogItemsOperationCallable() - *
  • importCatalogItemsCallable() + *
  • importCatalogItemsOperationCallable() + *

  • importCatalogItemsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/PredictionApiKeyRegistryClient.java b/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/PredictionApiKeyRegistryClient.java index 1639d9641a38..46400ccc0e17 100644 --- a/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/PredictionApiKeyRegistryClient.java +++ b/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/PredictionApiKeyRegistryClient.java @@ -67,69 +67,70 @@ * calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
CreatePredictionApiKeyRegistration

CreatePredictionApiKeyRegistration

Register an API key for use with predict method.

*

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

*
    - *
  • createPredictionApiKeyRegistration(CreatePredictionApiKeyRegistrationRequest request) + *
  • createPredictionApiKeyRegistration(CreatePredictionApiKeyRegistrationRequest request) *

*

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

*
    - *
  • createPredictionApiKeyRegistration(EventStoreName parent, PredictionApiKeyRegistration predictionApiKeyRegistration) - *
  • createPredictionApiKeyRegistration(String parent, PredictionApiKeyRegistration predictionApiKeyRegistration) + *
  • createPredictionApiKeyRegistration(EventStoreName parent, PredictionApiKeyRegistration predictionApiKeyRegistration) + *

  • createPredictionApiKeyRegistration(String parent, PredictionApiKeyRegistration predictionApiKeyRegistration) *

*

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

*
    - *
  • createPredictionApiKeyRegistrationCallable() + *
  • createPredictionApiKeyRegistrationCallable() *

*
ListPredictionApiKeyRegistrations

ListPredictionApiKeyRegistrations

List the registered apiKeys for use with predict method.

*

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

*
    - *
  • listPredictionApiKeyRegistrations(ListPredictionApiKeyRegistrationsRequest request) + *
  • listPredictionApiKeyRegistrations(ListPredictionApiKeyRegistrationsRequest request) *

*

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

*
    - *
  • listPredictionApiKeyRegistrations(EventStoreName parent) - *
  • listPredictionApiKeyRegistrations(String parent) + *
  • listPredictionApiKeyRegistrations(EventStoreName parent) + *

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

*
    - *
  • listPredictionApiKeyRegistrationsPagedCallable() - *
  • listPredictionApiKeyRegistrationsCallable() + *
  • listPredictionApiKeyRegistrationsPagedCallable() + *

  • listPredictionApiKeyRegistrationsCallable() *

*
DeletePredictionApiKeyRegistration

DeletePredictionApiKeyRegistration

Unregister an apiKey from using for predict method.

*

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

*
    - *
  • deletePredictionApiKeyRegistration(DeletePredictionApiKeyRegistrationRequest request) + *
  • deletePredictionApiKeyRegistration(DeletePredictionApiKeyRegistrationRequest request) *

*

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

*
    - *
  • deletePredictionApiKeyRegistration(PredictionApiKeyRegistrationName name) - *
  • deletePredictionApiKeyRegistration(String name) + *
  • deletePredictionApiKeyRegistration(PredictionApiKeyRegistrationName name) + *

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

*
    - *
  • deletePredictionApiKeyRegistrationCallable() + *
  • deletePredictionApiKeyRegistrationCallable() *

*
* *

See the individual methods for example code. diff --git a/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/PredictionServiceClient.java b/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/PredictionServiceClient.java index 975fe01f79b8..3c9831f79fb3 100644 --- a/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/PredictionServiceClient.java +++ b/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/PredictionServiceClient.java @@ -64,31 +64,32 @@ * close(). * * + * * * * * + * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
Predict

Predict

Makes a recommendation prediction. If using API Key based authentication, the API Key must be registered using the [PredictionApiKeyRegistry][google.cloud.recommendationengine.v1beta1.PredictionApiKeyRegistry] service. [Learn more](/recommendations-ai/docs/setting-up#register-key).

*

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

*
    - *
  • predict(PredictRequest request) + *
  • predict(PredictRequest request) *

*

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

*
    - *
  • predict(PlacementName name, UserEvent userEvent) - *
  • predict(String name, UserEvent userEvent) + *
  • predict(PlacementName name, UserEvent userEvent) + *

  • predict(String name, UserEvent userEvent) *

*

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

*
    - *
  • predictPagedCallable() - *
  • predictCallable() + *
  • predictPagedCallable() + *

  • predictCallable() *

*
* *

See the individual methods for example code. diff --git a/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/UserEventServiceClient.java b/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/UserEventServiceClient.java index 865e69268cf9..6f820fc5e2aa 100644 --- a/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/UserEventServiceClient.java +++ b/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/UserEventServiceClient.java @@ -64,108 +64,109 @@ * close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
WriteUserEvent

WriteUserEvent

Writes a single user event.

*

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

*
    - *
  • writeUserEvent(WriteUserEventRequest request) + *
  • writeUserEvent(WriteUserEventRequest request) *

*

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

*
    - *
  • writeUserEvent(EventStoreName parent, UserEvent userEvent) - *
  • writeUserEvent(String parent, UserEvent userEvent) + *
  • writeUserEvent(EventStoreName parent, UserEvent userEvent) + *

  • writeUserEvent(String parent, UserEvent userEvent) *

*

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

*
    - *
  • writeUserEventCallable() + *
  • writeUserEventCallable() *

*
CollectUserEvent

CollectUserEvent

Writes a single user event from the browser. This uses a GET request to due to browser restriction of POST-ing to a 3rd party domain. *

This method is used only by the Recommendations AI JavaScript pixel. Users should not call this method directly.

*

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

*
    - *
  • collectUserEvent(CollectUserEventRequest request) + *
  • collectUserEvent(CollectUserEventRequest request) *

*

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

*
    - *
  • collectUserEvent(EventStoreName parent, String userEvent, String uri, long ets) - *
  • collectUserEvent(String parent, String userEvent, String uri, long ets) + *
  • collectUserEvent(EventStoreName parent, String userEvent, String uri, long ets) + *

  • collectUserEvent(String parent, String userEvent, String uri, long ets) *

*

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

*
    - *
  • collectUserEventCallable() + *
  • collectUserEventCallable() *

*
ListUserEvents

ListUserEvents

Gets a list of user events within a time range, with potential filtering.

*

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

*
    - *
  • listUserEvents(ListUserEventsRequest request) + *
  • listUserEvents(ListUserEventsRequest request) *

*

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

*
    - *
  • listUserEvents(EventStoreName parent, String filter) - *
  • listUserEvents(String parent, String filter) + *
  • listUserEvents(EventStoreName parent, String filter) + *

  • listUserEvents(String parent, String filter) *

*

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

*
    - *
  • listUserEventsPagedCallable() - *
  • listUserEventsCallable() + *
  • listUserEventsPagedCallable() + *

  • listUserEventsCallable() *

*
PurgeUserEvents

PurgeUserEvents

Deletes permanently all user events specified by the filter provided. Depending on the number of events specified by the filter, this operation could take hours or days to complete. To test a filter, use the list command first.

*

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

*
    - *
  • purgeUserEventsAsync(PurgeUserEventsRequest request) + *
  • purgeUserEventsAsync(PurgeUserEventsRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • purgeUserEventsAsync(EventStoreName parent, String filter, boolean force) - *
  • purgeUserEventsAsync(String parent, String filter, boolean force) + *
  • purgeUserEventsAsync(EventStoreName parent, String filter, boolean force) + *

  • purgeUserEventsAsync(String parent, String filter, boolean force) *

*

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

*
    - *
  • purgeUserEventsOperationCallable() - *
  • purgeUserEventsCallable() + *
  • purgeUserEventsOperationCallable() + *

  • purgeUserEventsCallable() *

*
ImportUserEvents

ImportUserEvents

Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. *

Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata.

*

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

*
    - *
  • importUserEventsAsync(EventStoreName parent, String requestId, InputConfig inputConfig, ImportErrorsConfig errorsConfig) - *
  • importUserEventsAsync(String parent, String requestId, InputConfig inputConfig, ImportErrorsConfig errorsConfig) - *
  • importUserEventsAsync(ImportUserEventsRequest request) + *
  • importUserEventsAsync(EventStoreName parent, String requestId, InputConfig inputConfig, ImportErrorsConfig errorsConfig) + *

  • importUserEventsAsync(String parent, String requestId, InputConfig inputConfig, ImportErrorsConfig errorsConfig) + *

  • importUserEventsAsync(ImportUserEventsRequest request) *

*

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

*
    - *
  • importUserEventsOperationCallable() - *
  • importUserEventsCallable() + *
  • importUserEventsOperationCallable() + *

  • importUserEventsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/stub/CatalogServiceStubSettings.java b/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/stub/CatalogServiceStubSettings.java index 6df890c8fa54..17302f0fb25e 100644 --- a/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/stub/CatalogServiceStubSettings.java +++ b/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/stub/CatalogServiceStubSettings.java @@ -239,6 +239,15 @@ public CatalogServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -451,7 +460,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -464,7 +472,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -589,6 +596,15 @@ public UnaryCallSettings.Builder deleteCatalogI return importCatalogItemsOperationSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public CatalogServiceStubSettings build() throws IOException { return new CatalogServiceStubSettings(this); diff --git a/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/stub/PredictionApiKeyRegistryStubSettings.java b/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/stub/PredictionApiKeyRegistryStubSettings.java index c6112e76d9e3..0fec87fbca89 100644 --- a/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/stub/PredictionApiKeyRegistryStubSettings.java +++ b/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/stub/PredictionApiKeyRegistryStubSettings.java @@ -235,6 +235,15 @@ public PredictionApiKeyRegistryStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -429,7 +438,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -442,7 +450,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -509,6 +516,15 @@ public Builder applyToAllUnaryMethods( return deletePredictionApiKeyRegistrationSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public PredictionApiKeyRegistryStubSettings build() throws IOException { return new PredictionApiKeyRegistryStubSettings(this); diff --git a/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/stub/PredictionServiceStubSettings.java b/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/stub/PredictionServiceStubSettings.java index 64e682250047..88531da5f0b5 100644 --- a/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/stub/PredictionServiceStubSettings.java +++ b/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/stub/PredictionServiceStubSettings.java @@ -181,6 +181,15 @@ public PredictionServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -347,7 +356,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -360,7 +368,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -397,6 +404,15 @@ public Builder applyToAllUnaryMethods( return predictSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public PredictionServiceStubSettings build() throws IOException { return new PredictionServiceStubSettings(this); diff --git a/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/stub/UserEventServiceStubSettings.java b/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/stub/UserEventServiceStubSettings.java index 40950c775089..bffc4ef8676d 100644 --- a/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/stub/UserEventServiceStubSettings.java +++ b/java-recommendations-ai/google-cloud-recommendations-ai/src/main/java/com/google/cloud/recommendationengine/v1beta1/stub/UserEventServiceStubSettings.java @@ -238,6 +238,15 @@ public UserEventServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -447,7 +456,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -460,7 +468,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -605,6 +612,15 @@ public UnaryCallSettings.Builder purgeUserEve return importUserEventsOperationSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public UserEventServiceStubSettings build() throws IOException { return new UserEventServiceStubSettings(this); diff --git a/java-recommender/README.md b/java-recommender/README.md index 07c8c3964782..be53dd20812d 100644 --- a/java-recommender/README.md +++ b/java-recommender/README.md @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-recommender.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-recommender/2.34.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-recommender/2.35.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-recommender/google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1/RecommenderClient.java b/java-recommender/google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1/RecommenderClient.java index ef99467e9141..1274c80b63b9 100644 --- a/java-recommender/google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1/RecommenderClient.java +++ b/java-recommender/google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1/RecommenderClient.java @@ -62,264 +62,265 @@ * threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
ListInsights

ListInsights

Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.

*

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

*
    - *
  • listInsights(ListInsightsRequest request) + *
  • listInsights(ListInsightsRequest request) *

*

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

*
    - *
  • listInsights(InsightTypeName parent) - *
  • listInsights(String parent) + *
  • listInsights(InsightTypeName parent) + *

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

*
    - *
  • listInsightsPagedCallable() - *
  • listInsightsCallable() + *
  • listInsightsPagedCallable() + *

  • listInsightsCallable() *

*
GetInsight

GetInsight

Gets the requested insight. Requires the recommender.*.get IAM permission for the specified insight type.

*

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

*
    - *
  • getInsight(GetInsightRequest request) + *
  • getInsight(GetInsightRequest request) *

*

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

*
    - *
  • getInsight(InsightName name) - *
  • getInsight(String name) + *
  • getInsight(InsightName name) + *

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

*
    - *
  • getInsightCallable() + *
  • getInsightCallable() *

*
MarkInsightAccepted

MarkInsightAccepted

Marks the Insight State as Accepted. Users can use this method to indicate to the Recommender API that they have applied some action based on the insight. This stops the insight content from being updated. *

MarkInsightAccepted can be applied to insights in ACTIVE state. Requires the recommender.*.update IAM permission for the specified insight.

*

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

*
    - *
  • markInsightAccepted(MarkInsightAcceptedRequest request) + *
  • markInsightAccepted(MarkInsightAcceptedRequest request) *

*

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

*
    - *
  • markInsightAccepted(InsightName name, Map stateMetadata, String etag) - *
  • markInsightAccepted(String name, Map stateMetadata, String etag) + *
  • markInsightAccepted(InsightName name, Map<String, String> stateMetadata, String etag) + *

  • markInsightAccepted(String name, Map<String, String> stateMetadata, String etag) *

*

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

*
    - *
  • markInsightAcceptedCallable() + *
  • markInsightAcceptedCallable() *

*
ListRecommendations

ListRecommendations

Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.

*

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

*
    - *
  • listRecommendations(ListRecommendationsRequest request) + *
  • listRecommendations(ListRecommendationsRequest request) *

*

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

*
    - *
  • listRecommendations(RecommenderName parent) - *
  • listRecommendations(String parent) - *
  • listRecommendations(RecommenderName parent, String filter) - *
  • listRecommendations(String parent, String filter) + *
  • listRecommendations(RecommenderName parent) + *

  • listRecommendations(String parent) + *

  • listRecommendations(RecommenderName parent, String filter) + *

  • listRecommendations(String parent, String filter) *

*

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

*
    - *
  • listRecommendationsPagedCallable() - *
  • listRecommendationsCallable() + *
  • listRecommendationsPagedCallable() + *

  • listRecommendationsCallable() *

*
GetRecommendation

GetRecommendation

Gets the requested recommendation. Requires the recommender.*.get IAM permission for the specified recommender.

*

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

*
    - *
  • getRecommendation(GetRecommendationRequest request) + *
  • getRecommendation(GetRecommendationRequest request) *

*

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

*
    - *
  • getRecommendation(RecommendationName name) - *
  • getRecommendation(String name) + *
  • getRecommendation(RecommendationName name) + *

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

*
    - *
  • getRecommendationCallable() + *
  • getRecommendationCallable() *

*
MarkRecommendationDismissed

MarkRecommendationDismissed

Mark the Recommendation State as Dismissed. Users can use this method to indicate to the Recommender API that an ACTIVE recommendation has to be marked back as DISMISSED. *

MarkRecommendationDismissed can be applied to recommendations in ACTIVE state. *

Requires the recommender.*.update IAM permission for the specified recommender.

*

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

*
    - *
  • markRecommendationDismissed(MarkRecommendationDismissedRequest request) + *
  • markRecommendationDismissed(MarkRecommendationDismissedRequest request) *

*

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

*
    - *
  • markRecommendationDismissedCallable() + *
  • markRecommendationDismissedCallable() *

*
MarkRecommendationClaimed

MarkRecommendationClaimed

Marks the Recommendation State as Claimed. Users can use this method to indicate to the Recommender API that they are starting to apply the recommendation themselves. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. *

MarkRecommendationClaimed can be applied to recommendations in CLAIMED, SUCCEEDED, FAILED, or ACTIVE state. *

Requires the recommender.*.update IAM permission for the specified recommender.

*

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

*
    - *
  • markRecommendationClaimed(MarkRecommendationClaimedRequest request) + *
  • markRecommendationClaimed(MarkRecommendationClaimedRequest request) *

*

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

*
    - *
  • markRecommendationClaimed(RecommendationName name, Map stateMetadata, String etag) - *
  • markRecommendationClaimed(String name, Map stateMetadata, String etag) + *
  • markRecommendationClaimed(RecommendationName name, Map<String, String> stateMetadata, String etag) + *

  • markRecommendationClaimed(String name, Map<String, String> stateMetadata, String etag) *

*

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

*
    - *
  • markRecommendationClaimedCallable() + *
  • markRecommendationClaimedCallable() *

*
MarkRecommendationSucceeded

MarkRecommendationSucceeded

Marks the Recommendation State as Succeeded. Users can use this method to indicate to the Recommender API that they have applied the recommendation themselves, and the operation was successful. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. *

MarkRecommendationSucceeded can be applied to recommendations in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. *

Requires the recommender.*.update IAM permission for the specified recommender.

*

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

*
    - *
  • markRecommendationSucceeded(MarkRecommendationSucceededRequest request) + *
  • markRecommendationSucceeded(MarkRecommendationSucceededRequest request) *

*

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

*
    - *
  • markRecommendationSucceeded(RecommendationName name, Map stateMetadata, String etag) - *
  • markRecommendationSucceeded(String name, Map stateMetadata, String etag) + *
  • markRecommendationSucceeded(RecommendationName name, Map<String, String> stateMetadata, String etag) + *

  • markRecommendationSucceeded(String name, Map<String, String> stateMetadata, String etag) *

*

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

*
    - *
  • markRecommendationSucceededCallable() + *
  • markRecommendationSucceededCallable() *

*
MarkRecommendationFailed

MarkRecommendationFailed

Marks the Recommendation State as Failed. Users can use this method to indicate to the Recommender API that they have applied the recommendation themselves, and the operation failed. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. *

MarkRecommendationFailed can be applied to recommendations in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. *

Requires the recommender.*.update IAM permission for the specified recommender.

*

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

*
    - *
  • markRecommendationFailed(MarkRecommendationFailedRequest request) + *
  • markRecommendationFailed(MarkRecommendationFailedRequest request) *

*

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

*
    - *
  • markRecommendationFailed(RecommendationName name, Map stateMetadata, String etag) - *
  • markRecommendationFailed(String name, Map stateMetadata, String etag) + *
  • markRecommendationFailed(RecommendationName name, Map<String, String> stateMetadata, String etag) + *

  • markRecommendationFailed(String name, Map<String, String> stateMetadata, String etag) *

*

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

*
    - *
  • markRecommendationFailedCallable() + *
  • markRecommendationFailedCallable() *

*
GetRecommenderConfig

GetRecommenderConfig

Gets the requested Recommender Config. There is only one instance of the config for each Recommender.

*

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

*
    - *
  • getRecommenderConfig(GetRecommenderConfigRequest request) + *
  • getRecommenderConfig(GetRecommenderConfigRequest request) *

*

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

*
    - *
  • getRecommenderConfig(RecommenderConfigName name) - *
  • getRecommenderConfig(String name) + *
  • getRecommenderConfig(RecommenderConfigName name) + *

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

*
    - *
  • getRecommenderConfigCallable() + *
  • getRecommenderConfigCallable() *

*
UpdateRecommenderConfig

UpdateRecommenderConfig

Updates a Recommender Config. This will create a new revision of the config.

*

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

*
    - *
  • updateRecommenderConfig(UpdateRecommenderConfigRequest request) + *
  • updateRecommenderConfig(UpdateRecommenderConfigRequest request) *

*

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

*
    - *
  • updateRecommenderConfig(RecommenderConfig recommenderConfig, FieldMask updateMask) + *
  • updateRecommenderConfig(RecommenderConfig recommenderConfig, 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.

*
    - *
  • updateRecommenderConfigCallable() + *
  • updateRecommenderConfigCallable() *

*
GetInsightTypeConfig

GetInsightTypeConfig

Gets the requested InsightTypeConfig. There is only one instance of the config for each InsightType.

*

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

*
    - *
  • getInsightTypeConfig(GetInsightTypeConfigRequest request) + *
  • getInsightTypeConfig(GetInsightTypeConfigRequest request) *

*

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

*
    - *
  • getInsightTypeConfig(InsightTypeConfigName name) - *
  • getInsightTypeConfig(String name) + *
  • getInsightTypeConfig(InsightTypeConfigName name) + *

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

*
    - *
  • getInsightTypeConfigCallable() + *
  • getInsightTypeConfigCallable() *

*
UpdateInsightTypeConfig

UpdateInsightTypeConfig

Updates an InsightTypeConfig change. This will create a new revision of the config.

*

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

*
    - *
  • updateInsightTypeConfig(UpdateInsightTypeConfigRequest request) + *
  • updateInsightTypeConfig(UpdateInsightTypeConfigRequest request) *

*

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

*
    - *
  • updateInsightTypeConfig(InsightTypeConfig insightTypeConfig, FieldMask updateMask) + *
  • updateInsightTypeConfig(InsightTypeConfig insightTypeConfig, 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.

*
    - *
  • updateInsightTypeConfigCallable() + *
  • updateInsightTypeConfigCallable() *

*
* *

See the individual methods for example code. diff --git a/java-recommender/google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1/stub/RecommenderStubSettings.java b/java-recommender/google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1/stub/RecommenderStubSettings.java index d7cc5e82db0d..717debe4af3b 100644 --- a/java-recommender/google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1/stub/RecommenderStubSettings.java +++ b/java-recommender/google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1/stub/RecommenderStubSettings.java @@ -348,6 +348,15 @@ public RecommenderStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -621,7 +630,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -634,7 +642,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -806,6 +813,15 @@ public UnaryCallSettings.Builder getInsightSettings( return updateInsightTypeConfigSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public RecommenderStubSettings build() throws IOException { return new RecommenderStubSettings(this); diff --git a/java-recommender/google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1beta1/RecommenderClient.java b/java-recommender/google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1beta1/RecommenderClient.java index a4a6588e1651..a1e4962efd7c 100644 --- a/java-recommender/google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1beta1/RecommenderClient.java +++ b/java-recommender/google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1beta1/RecommenderClient.java @@ -63,276 +63,277 @@ * threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
ListInsights

ListInsights

Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.

*

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

*
    - *
  • listInsights(ListInsightsRequest request) + *
  • listInsights(ListInsightsRequest request) *

*

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

*
    - *
  • listInsights(InsightTypeName parent) - *
  • listInsights(String parent) + *
  • listInsights(InsightTypeName parent) + *

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

*
    - *
  • listInsightsPagedCallable() - *
  • listInsightsCallable() + *
  • listInsightsPagedCallable() + *

  • listInsightsCallable() *

*
GetInsight

GetInsight

Gets the requested insight. Requires the recommender.*.get IAM permission for the specified insight type.

*

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

*
    - *
  • getInsight(GetInsightRequest request) + *
  • getInsight(GetInsightRequest request) *

*

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

*
    - *
  • getInsight(InsightName name) - *
  • getInsight(String name) + *
  • getInsight(InsightName name) + *

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

*
    - *
  • getInsightCallable() + *
  • getInsightCallable() *

*
MarkInsightAccepted

MarkInsightAccepted

Marks the Insight State as Accepted. Users can use this method to indicate to the Recommender API that they have applied some action based on the insight. This stops the insight content from being updated. *

MarkInsightAccepted can be applied to insights in ACTIVE state. Requires the recommender.*.update IAM permission for the specified insight.

*

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

*
    - *
  • markInsightAccepted(MarkInsightAcceptedRequest request) + *
  • markInsightAccepted(MarkInsightAcceptedRequest request) *

*

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

*
    - *
  • markInsightAccepted(InsightName name, Map stateMetadata, String etag) - *
  • markInsightAccepted(String name, Map stateMetadata, String etag) + *
  • markInsightAccepted(InsightName name, Map<String, String> stateMetadata, String etag) + *

  • markInsightAccepted(String name, Map<String, String> stateMetadata, String etag) *

*

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

*
    - *
  • markInsightAcceptedCallable() + *
  • markInsightAcceptedCallable() *

*
ListRecommendations

ListRecommendations

Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.

*

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

*
    - *
  • listRecommendations(ListRecommendationsRequest request) + *
  • listRecommendations(ListRecommendationsRequest request) *

*

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

*
    - *
  • listRecommendations(RecommenderName parent, String filter) - *
  • listRecommendations(String parent, String filter) + *
  • listRecommendations(RecommenderName parent, String filter) + *

  • listRecommendations(String parent, String filter) *

*

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

*
    - *
  • listRecommendationsPagedCallable() - *
  • listRecommendationsCallable() + *
  • listRecommendationsPagedCallable() + *

  • listRecommendationsCallable() *

*
GetRecommendation

GetRecommendation

Gets the requested recommendation. Requires the recommender.*.get IAM permission for the specified recommender.

*

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

*
    - *
  • getRecommendation(GetRecommendationRequest request) + *
  • getRecommendation(GetRecommendationRequest request) *

*

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

*
    - *
  • getRecommendation(RecommendationName name) - *
  • getRecommendation(String name) + *
  • getRecommendation(RecommendationName name) + *

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

*
    - *
  • getRecommendationCallable() + *
  • getRecommendationCallable() *

*
MarkRecommendationClaimed

MarkRecommendationClaimed

Marks the Recommendation State as Claimed. Users can use this method to indicate to the Recommender API that they are starting to apply the recommendation themselves. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. *

MarkRecommendationClaimed can be applied to recommendations in CLAIMED or ACTIVE state. *

Requires the recommender.*.update IAM permission for the specified recommender.

*

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

*
    - *
  • markRecommendationClaimed(MarkRecommendationClaimedRequest request) + *
  • markRecommendationClaimed(MarkRecommendationClaimedRequest request) *

*

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

*
    - *
  • markRecommendationClaimed(RecommendationName name, Map stateMetadata, String etag) - *
  • markRecommendationClaimed(String name, Map stateMetadata, String etag) + *
  • markRecommendationClaimed(RecommendationName name, Map<String, String> stateMetadata, String etag) + *

  • markRecommendationClaimed(String name, Map<String, String> stateMetadata, String etag) *

*

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

*
    - *
  • markRecommendationClaimedCallable() + *
  • markRecommendationClaimedCallable() *

*
MarkRecommendationSucceeded

MarkRecommendationSucceeded

Marks the Recommendation State as Succeeded. Users can use this method to indicate to the Recommender API that they have applied the recommendation themselves, and the operation was successful. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. *

MarkRecommendationSucceeded can be applied to recommendations in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. *

Requires the recommender.*.update IAM permission for the specified recommender.

*

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

*
    - *
  • markRecommendationSucceeded(MarkRecommendationSucceededRequest request) + *
  • markRecommendationSucceeded(MarkRecommendationSucceededRequest request) *

*

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

*
    - *
  • markRecommendationSucceeded(RecommendationName name, Map stateMetadata, String etag) - *
  • markRecommendationSucceeded(String name, Map stateMetadata, String etag) + *
  • markRecommendationSucceeded(RecommendationName name, Map<String, String> stateMetadata, String etag) + *

  • markRecommendationSucceeded(String name, Map<String, String> stateMetadata, String etag) *

*

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

*
    - *
  • markRecommendationSucceededCallable() + *
  • markRecommendationSucceededCallable() *

*
MarkRecommendationFailed

MarkRecommendationFailed

Marks the Recommendation State as Failed. Users can use this method to indicate to the Recommender API that they have applied the recommendation themselves, and the operation failed. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. *

MarkRecommendationFailed can be applied to recommendations in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. *

Requires the recommender.*.update IAM permission for the specified recommender.

*

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

*
    - *
  • markRecommendationFailed(MarkRecommendationFailedRequest request) + *
  • markRecommendationFailed(MarkRecommendationFailedRequest request) *

*

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

*
    - *
  • markRecommendationFailed(RecommendationName name, Map stateMetadata, String etag) - *
  • markRecommendationFailed(String name, Map stateMetadata, String etag) + *
  • markRecommendationFailed(RecommendationName name, Map<String, String> stateMetadata, String etag) + *

  • markRecommendationFailed(String name, Map<String, String> stateMetadata, String etag) *

*

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

*
    - *
  • markRecommendationFailedCallable() + *
  • markRecommendationFailedCallable() *

*
GetRecommenderConfig

GetRecommenderConfig

Gets the requested Recommender Config. There is only one instance of the config for each Recommender.

*

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

*
    - *
  • getRecommenderConfig(GetRecommenderConfigRequest request) + *
  • getRecommenderConfig(GetRecommenderConfigRequest request) *

*

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

*
    - *
  • getRecommenderConfig(RecommenderConfigName name) - *
  • getRecommenderConfig(String name) + *
  • getRecommenderConfig(RecommenderConfigName name) + *

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

*
    - *
  • getRecommenderConfigCallable() + *
  • getRecommenderConfigCallable() *

*
UpdateRecommenderConfig

UpdateRecommenderConfig

Updates a Recommender Config. This will create a new revision of the config.

*

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

*
    - *
  • updateRecommenderConfig(UpdateRecommenderConfigRequest request) + *
  • updateRecommenderConfig(UpdateRecommenderConfigRequest request) *

*

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

*
    - *
  • updateRecommenderConfig(RecommenderConfig recommenderConfig, FieldMask updateMask) + *
  • updateRecommenderConfig(RecommenderConfig recommenderConfig, 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.

*
    - *
  • updateRecommenderConfigCallable() + *
  • updateRecommenderConfigCallable() *

*
GetInsightTypeConfig

GetInsightTypeConfig

Gets the requested InsightTypeConfig. There is only one instance of the config for each InsightType.

*

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

*
    - *
  • getInsightTypeConfig(GetInsightTypeConfigRequest request) + *
  • getInsightTypeConfig(GetInsightTypeConfigRequest request) *

*

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

*
    - *
  • getInsightTypeConfig(InsightTypeConfigName name) - *
  • getInsightTypeConfig(String name) + *
  • getInsightTypeConfig(InsightTypeConfigName name) + *

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

*
    - *
  • getInsightTypeConfigCallable() + *
  • getInsightTypeConfigCallable() *

*
UpdateInsightTypeConfig

UpdateInsightTypeConfig

Updates an InsightTypeConfig change. This will create a new revision of the config.

*

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

*
    - *
  • updateInsightTypeConfig(UpdateInsightTypeConfigRequest request) + *
  • updateInsightTypeConfig(UpdateInsightTypeConfigRequest request) *

*

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

*
    - *
  • updateInsightTypeConfig(InsightTypeConfig insightTypeConfig, FieldMask updateMask) + *
  • updateInsightTypeConfig(InsightTypeConfig insightTypeConfig, 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.

*
    - *
  • updateInsightTypeConfigCallable() + *
  • updateInsightTypeConfigCallable() *

*
ListRecommenders

ListRecommenders

Lists all available Recommenders. No IAM permissions are required.

*

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

*
    - *
  • listRecommenders(ListRecommendersRequest request) + *
  • listRecommenders(ListRecommendersRequest request) *

*

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

*
    - *
  • listRecommendersPagedCallable() - *
  • listRecommendersCallable() + *
  • listRecommendersPagedCallable() + *

  • listRecommendersCallable() *

*
ListInsightTypes

ListInsightTypes

Lists available InsightTypes. No IAM permissions are required.

*

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

*
    - *
  • listInsightTypes(ListInsightTypesRequest request) + *
  • listInsightTypes(ListInsightTypesRequest request) *

*

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

*
    - *
  • listInsightTypesPagedCallable() - *
  • listInsightTypesCallable() + *
  • listInsightTypesPagedCallable() + *

  • listInsightTypesCallable() *

*
* *

See the individual methods for example code. diff --git a/java-recommender/google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1beta1/stub/RecommenderStubSettings.java b/java-recommender/google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1beta1/stub/RecommenderStubSettings.java index 89552481dab2..254e457d8bd7 100644 --- a/java-recommender/google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1beta1/stub/RecommenderStubSettings.java +++ b/java-recommender/google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1beta1/stub/RecommenderStubSettings.java @@ -486,6 +486,15 @@ public RecommenderStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -766,7 +775,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -779,7 +787,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -964,6 +971,15 @@ public UnaryCallSettings.Builder getInsightSettings( return listInsightTypesSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public RecommenderStubSettings build() throws IOException { return new RecommenderStubSettings(this); diff --git a/java-redis-cluster/README.md b/java-redis-cluster/README.md index 898f9baabe5c..718cdb5107c1 100644 --- a/java-redis-cluster/README.md +++ b/java-redis-cluster/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-redis-cluster/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-redis-cluster.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-redis-cluster/0.4.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-redis-cluster/0.5.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-redis-cluster/google-cloud-redis-cluster/src/main/java/com/google/cloud/redis/cluster/v1/CloudRedisClusterClient.java b/java-redis-cluster/google-cloud-redis-cluster/src/main/java/com/google/cloud/redis/cluster/v1/CloudRedisClusterClient.java index 6b24e9f93888..c34e86353a73 100644 --- a/java-redis-cluster/google-cloud-redis-cluster/src/main/java/com/google/cloud/redis/cluster/v1/CloudRedisClusterClient.java +++ b/java-redis-cluster/google-cloud-redis-cluster/src/main/java/com/google/cloud/redis/cluster/v1/CloudRedisClusterClient.java @@ -96,12 +96,14 @@ * close(). * * + * * * * * + * * - * + * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
ListClusters

ListClusters

Lists all Redis clusters owned by a project in either the specified location (region) or all locations. *

The location should have the following format: *

    @@ -111,130 +113,129 @@ *
*

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

*
    - *
  • listClusters(ListClustersRequest request) + *
  • listClusters(ListClustersRequest request) *

*

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

*
    - *
  • listClusters(LocationName parent) - *
  • listClusters(String parent) + *
  • listClusters(LocationName parent) + *

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

*
    - *
  • listClustersPagedCallable() - *
  • listClustersCallable() + *
  • listClustersPagedCallable() + *

  • listClustersCallable() *

*
GetCluster

GetCluster

Gets the details of a specific Redis cluster.

*

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

*
    - *
  • getCluster(GetClusterRequest request) + *
  • getCluster(GetClusterRequest request) *

*

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

*
    - *
  • getCluster(ClusterName name) - *
  • getCluster(String name) + *
  • getCluster(ClusterName name) + *

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

*
    - *
  • getClusterCallable() + *
  • getClusterCallable() *

*
UpdateCluster

UpdateCluster

Updates the metadata and configuration of a specific Redis cluster. *

Completed longrunning.Operation will contain the new cluster object in the response field. The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.

*

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

*
    - *
  • updateClusterAsync(UpdateClusterRequest request) + *
  • updateClusterAsync(UpdateClusterRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateClusterAsync(Cluster cluster, FieldMask updateMask) + *
  • updateClusterAsync(Cluster cluster, 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.

*
    - *
  • updateClusterOperationCallable() - *
  • updateClusterCallable() + *
  • updateClusterOperationCallable() + *

  • updateClusterCallable() *

*
DeleteCluster

DeleteCluster

Deletes a specific Redis cluster. Cluster stops serving and data is deleted.

*

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

*
    - *
  • deleteClusterAsync(DeleteClusterRequest request) + *
  • deleteClusterAsync(DeleteClusterRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteClusterAsync(ClusterName name) - *
  • deleteClusterAsync(String name) + *
  • deleteClusterAsync(ClusterName name) + *

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

*
    - *
  • deleteClusterOperationCallable() - *
  • deleteClusterCallable() + *
  • deleteClusterOperationCallable() + *

  • deleteClusterCallable() *

*
CreateCluster

CreateCluster

Creates a Redis cluster based on the specified properties. The creation is executed asynchronously and callers may check the returned operation to track its progress. Once the operation is completed the Redis cluster will be fully functional. The completed longrunning.Operation will contain the new cluster object in the response field. *

The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.

*

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

*
    - *
  • createClusterAsync(CreateClusterRequest request) + *
  • createClusterAsync(CreateClusterRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createClusterAsync(LocationName parent, Cluster cluster, String clusterId) - *
  • createClusterAsync(String parent, Cluster cluster, String clusterId) + *
  • createClusterAsync(LocationName parent, Cluster cluster, String clusterId) + *

  • createClusterAsync(String parent, Cluster cluster, String clusterId) *

*

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

*
    - *
  • createClusterOperationCallable() - *
  • createClusterCallable() + *
  • createClusterOperationCallable() + *

  • createClusterCallable() *

*
ListLocations

ListLocations

Lists information about the supported locations for this service.

*

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

*
    - *
  • listLocations(ListLocationsRequest request) + *
  • listLocations(ListLocationsRequest request) *

*

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

*
    - *
  • listLocationsPagedCallable() - *
  • listLocationsCallable() + *
  • listLocationsPagedCallable() + *

  • listLocationsCallable() *

*
GetLocation

GetLocation

Gets information about a location.

*

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

*
    - *
  • getLocation(GetLocationRequest request) + *
  • getLocation(GetLocationRequest request) *

*

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

*
    - *
  • getLocationCallable() + *
  • getLocationCallable() *

*
* *

See the individual methods for example code. diff --git a/java-redis-cluster/google-cloud-redis-cluster/src/main/java/com/google/cloud/redis/cluster/v1/stub/CloudRedisClusterStubSettings.java b/java-redis-cluster/google-cloud-redis-cluster/src/main/java/com/google/cloud/redis/cluster/v1/stub/CloudRedisClusterStubSettings.java index 02508cb6a558..1dce850f6adb 100644 --- a/java-redis-cluster/google-cloud-redis-cluster/src/main/java/com/google/cloud/redis/cluster/v1/stub/CloudRedisClusterStubSettings.java +++ b/java-redis-cluster/google-cloud-redis-cluster/src/main/java/com/google/cloud/redis/cluster/v1/stub/CloudRedisClusterStubSettings.java @@ -309,6 +309,15 @@ public CloudRedisClusterStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -528,7 +537,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -541,7 +549,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -734,6 +741,15 @@ public UnaryCallSettings.Builder getLocationSettin return getLocationSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public CloudRedisClusterStubSettings build() throws IOException { return new CloudRedisClusterStubSettings(this); diff --git a/java-redis-cluster/google-cloud-redis-cluster/src/main/java/com/google/cloud/redis/cluster/v1beta1/CloudRedisClusterClient.java b/java-redis-cluster/google-cloud-redis-cluster/src/main/java/com/google/cloud/redis/cluster/v1beta1/CloudRedisClusterClient.java index 2b1de0db7fca..d3d5d0fdf714 100644 --- a/java-redis-cluster/google-cloud-redis-cluster/src/main/java/com/google/cloud/redis/cluster/v1beta1/CloudRedisClusterClient.java +++ b/java-redis-cluster/google-cloud-redis-cluster/src/main/java/com/google/cloud/redis/cluster/v1beta1/CloudRedisClusterClient.java @@ -96,12 +96,14 @@ * close(). * * + * * * * * + * * - * + * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
ListClusters

ListClusters

Lists all Redis clusters owned by a project in either the specified location (region) or all locations. *

The location should have the following format: *

    @@ -111,130 +113,129 @@ *
*

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

*
    - *
  • listClusters(ListClustersRequest request) + *
  • listClusters(ListClustersRequest request) *

*

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

*
    - *
  • listClusters(LocationName parent) - *
  • listClusters(String parent) + *
  • listClusters(LocationName parent) + *

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

*
    - *
  • listClustersPagedCallable() - *
  • listClustersCallable() + *
  • listClustersPagedCallable() + *

  • listClustersCallable() *

*
GetCluster

GetCluster

Gets the details of a specific Redis cluster.

*

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

*
    - *
  • getCluster(GetClusterRequest request) + *
  • getCluster(GetClusterRequest request) *

*

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

*
    - *
  • getCluster(ClusterName name) - *
  • getCluster(String name) + *
  • getCluster(ClusterName name) + *

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

*
    - *
  • getClusterCallable() + *
  • getClusterCallable() *

*
UpdateCluster

UpdateCluster

Updates the metadata and configuration of a specific Redis cluster. *

Completed longrunning.Operation will contain the new cluster object in the response field. The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.

*

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

*
    - *
  • updateClusterAsync(UpdateClusterRequest request) + *
  • updateClusterAsync(UpdateClusterRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateClusterAsync(Cluster cluster, FieldMask updateMask) + *
  • updateClusterAsync(Cluster cluster, 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.

*
    - *
  • updateClusterOperationCallable() - *
  • updateClusterCallable() + *
  • updateClusterOperationCallable() + *

  • updateClusterCallable() *

*
DeleteCluster

DeleteCluster

Deletes a specific Redis cluster. Cluster stops serving and data is deleted.

*

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

*
    - *
  • deleteClusterAsync(DeleteClusterRequest request) + *
  • deleteClusterAsync(DeleteClusterRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteClusterAsync(ClusterName name) - *
  • deleteClusterAsync(String name) + *
  • deleteClusterAsync(ClusterName name) + *

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

*
    - *
  • deleteClusterOperationCallable() - *
  • deleteClusterCallable() + *
  • deleteClusterOperationCallable() + *

  • deleteClusterCallable() *

*
CreateCluster

CreateCluster

Creates a Redis cluster based on the specified properties. The creation is executed asynchronously and callers may check the returned operation to track its progress. Once the operation is completed the Redis cluster will be fully functional. The completed longrunning.Operation will contain the new cluster object in the response field. *

The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.

*

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

*
    - *
  • createClusterAsync(CreateClusterRequest request) + *
  • createClusterAsync(CreateClusterRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createClusterAsync(LocationName parent, Cluster cluster, String clusterId) - *
  • createClusterAsync(String parent, Cluster cluster, String clusterId) + *
  • createClusterAsync(LocationName parent, Cluster cluster, String clusterId) + *

  • createClusterAsync(String parent, Cluster cluster, String clusterId) *

*

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

*
    - *
  • createClusterOperationCallable() - *
  • createClusterCallable() + *
  • createClusterOperationCallable() + *

  • createClusterCallable() *

*
ListLocations

ListLocations

Lists information about the supported locations for this service.

*

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

*
    - *
  • listLocations(ListLocationsRequest request) + *
  • listLocations(ListLocationsRequest request) *

*

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

*
    - *
  • listLocationsPagedCallable() - *
  • listLocationsCallable() + *
  • listLocationsPagedCallable() + *

  • listLocationsCallable() *

*
GetLocation

GetLocation

Gets information about a location.

*

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

*
    - *
  • getLocation(GetLocationRequest request) + *
  • getLocation(GetLocationRequest request) *

*

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

*
    - *
  • getLocationCallable() + *
  • getLocationCallable() *

*
* *

See the individual methods for example code. diff --git a/java-redis-cluster/google-cloud-redis-cluster/src/main/java/com/google/cloud/redis/cluster/v1beta1/stub/CloudRedisClusterStubSettings.java b/java-redis-cluster/google-cloud-redis-cluster/src/main/java/com/google/cloud/redis/cluster/v1beta1/stub/CloudRedisClusterStubSettings.java index e0a11ddac07f..eac9ef3df2c8 100644 --- a/java-redis-cluster/google-cloud-redis-cluster/src/main/java/com/google/cloud/redis/cluster/v1beta1/stub/CloudRedisClusterStubSettings.java +++ b/java-redis-cluster/google-cloud-redis-cluster/src/main/java/com/google/cloud/redis/cluster/v1beta1/stub/CloudRedisClusterStubSettings.java @@ -310,6 +310,15 @@ public CloudRedisClusterStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -529,7 +538,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -542,7 +550,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -735,6 +742,15 @@ public UnaryCallSettings.Builder getLocationSettin return getLocationSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public CloudRedisClusterStubSettings build() throws IOException { return new CloudRedisClusterStubSettings(this); diff --git a/java-redis/README.md b/java-redis/README.md index cf8a6e21563d..a33d2d9d3834 100644 --- a/java-redis/README.md +++ b/java-redis/README.md @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-redis.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-redis/2.35.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-redis/2.36.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-redis/google-cloud-redis/src/main/java/com/google/cloud/redis/v1/CloudRedisClient.java b/java-redis/google-cloud-redis/src/main/java/com/google/cloud/redis/v1/CloudRedisClient.java index ff76cc260c50..24460358cc85 100644 --- a/java-redis/google-cloud-redis/src/main/java/com/google/cloud/redis/v1/CloudRedisClient.java +++ b/java-redis/google-cloud-redis/src/main/java/com/google/cloud/redis/v1/CloudRedisClient.java @@ -86,12 +86,14 @@ * threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * - * + * * * * * - * + * * * * * - * + * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
ListInstances

ListInstances

Lists all Redis instances owned by a project in either the specified location (region) or all locations. *

The location should have the following format: *

    @@ -101,60 +103,60 @@ *
*

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

*
    - *
  • listInstances(ListInstancesRequest request) + *
  • listInstances(ListInstancesRequest request) *

*

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

*
    - *
  • listInstances(LocationName parent) - *
  • listInstances(String parent) + *
  • listInstances(LocationName parent) + *

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

*
    - *
  • listInstancesPagedCallable() - *
  • listInstancesCallable() + *
  • listInstancesPagedCallable() + *

  • listInstancesCallable() *

*
GetInstance

GetInstance

Gets the details of a specific Redis instance.

*

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

*
    - *
  • getInstance(GetInstanceRequest request) + *
  • getInstance(GetInstanceRequest request) *

*

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

*
    - *
  • getInstance(InstanceName name) - *
  • getInstance(String name) + *
  • getInstance(InstanceName name) + *

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

*
    - *
  • getInstanceCallable() + *
  • getInstanceCallable() *

*
GetInstanceAuthString

GetInstanceAuthString

Gets the AUTH string for a Redis instance. If AUTH is not enabled for the instance the response will be empty. This information is not included in the details returned to GetInstance.

*

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

*
    - *
  • getInstanceAuthString(GetInstanceAuthStringRequest request) + *
  • getInstanceAuthString(GetInstanceAuthStringRequest request) *

*

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

*
    - *
  • getInstanceAuthString(InstanceName name) - *
  • getInstanceAuthString(String name) + *
  • getInstanceAuthString(InstanceName name) + *

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

*
    - *
  • getInstanceAuthStringCallable() + *
  • getInstanceAuthStringCallable() *

*
CreateInstance

CreateInstance

Creates a Redis instance based on the specified tier and memory size. *

By default, the instance is accessible from the project's [default network](https://cloud.google.com/vpc/docs/vpc). *

The creation is executed asynchronously and callers may check the returned operation to track its progress. Once the operation is completed the Redis instance will be fully functional. Completed longrunning.Operation will contain the new instance object in the response field. @@ -162,192 +164,191 @@ *

*

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

*
    - *
  • createInstanceAsync(CreateInstanceRequest request) + *
  • createInstanceAsync(CreateInstanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createInstanceAsync(LocationName parent, String instanceId, Instance instance) - *
  • createInstanceAsync(String parent, String instanceId, Instance instance) + *
  • createInstanceAsync(LocationName parent, String instanceId, Instance instance) + *

  • createInstanceAsync(String parent, String instanceId, Instance instance) *

*

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

*
    - *
  • createInstanceOperationCallable() - *
  • createInstanceCallable() + *
  • createInstanceOperationCallable() + *

  • createInstanceCallable() *

*
UpdateInstance

UpdateInstance

Updates the metadata and configuration of a specific Redis instance. *

Completed longrunning.Operation will contain the new instance object in the response field. The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.

*

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

*
    - *
  • updateInstanceAsync(UpdateInstanceRequest request) + *
  • updateInstanceAsync(UpdateInstanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateInstanceAsync(FieldMask updateMask, Instance instance) + *
  • updateInstanceAsync(FieldMask updateMask, Instance instance) *

*

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

*
    - *
  • updateInstanceOperationCallable() - *
  • updateInstanceCallable() + *
  • updateInstanceOperationCallable() + *

  • updateInstanceCallable() *

*
UpgradeInstance

UpgradeInstance

Upgrades Redis instance to the newer Redis version specified in the request.

*

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

*
    - *
  • upgradeInstanceAsync(UpgradeInstanceRequest request) + *
  • upgradeInstanceAsync(UpgradeInstanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • upgradeInstanceAsync(InstanceName name, String redisVersion) - *
  • upgradeInstanceAsync(String name, String redisVersion) + *
  • upgradeInstanceAsync(InstanceName name, String redisVersion) + *

  • upgradeInstanceAsync(String name, String redisVersion) *

*

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

*
    - *
  • upgradeInstanceOperationCallable() - *
  • upgradeInstanceCallable() + *
  • upgradeInstanceOperationCallable() + *

  • upgradeInstanceCallable() *

*
ImportInstance

ImportInstance

Import a Redis RDB snapshot file from Cloud Storage into a Redis instance. *

Redis may stop serving during this operation. Instance state will be IMPORTING for entire operation. When complete, the instance will contain only data from the imported file. *

The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.

*

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

*
    - *
  • importInstanceAsync(ImportInstanceRequest request) + *
  • importInstanceAsync(ImportInstanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • importInstanceAsync(String name, InputConfig inputConfig) + *
  • importInstanceAsync(String name, InputConfig inputConfig) *

*

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

*
    - *
  • importInstanceOperationCallable() - *
  • importInstanceCallable() + *
  • importInstanceOperationCallable() + *

  • importInstanceCallable() *

*
ExportInstance

ExportInstance

Export Redis instance data into a Redis RDB format file in Cloud Storage. *

Redis will continue serving during this operation. *

The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.

*

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

*
    - *
  • exportInstanceAsync(ExportInstanceRequest request) + *
  • exportInstanceAsync(ExportInstanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • exportInstanceAsync(String name, OutputConfig outputConfig) + *
  • exportInstanceAsync(String name, OutputConfig outputConfig) *

*

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

*
    - *
  • exportInstanceOperationCallable() - *
  • exportInstanceCallable() + *
  • exportInstanceOperationCallable() + *

  • exportInstanceCallable() *

*
FailoverInstance

FailoverInstance

Initiates a failover of the primary node to current replica node for a specific STANDARD tier Cloud Memorystore for Redis instance.

*

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

*
    - *
  • failoverInstanceAsync(FailoverInstanceRequest request) + *
  • failoverInstanceAsync(FailoverInstanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • failoverInstanceAsync(InstanceName name, FailoverInstanceRequest.DataProtectionMode dataProtectionMode) - *
  • failoverInstanceAsync(String name, FailoverInstanceRequest.DataProtectionMode dataProtectionMode) + *
  • failoverInstanceAsync(InstanceName name, FailoverInstanceRequest.DataProtectionMode dataProtectionMode) + *

  • failoverInstanceAsync(String name, FailoverInstanceRequest.DataProtectionMode dataProtectionMode) *

*

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

*
    - *
  • failoverInstanceOperationCallable() - *
  • failoverInstanceCallable() + *
  • failoverInstanceOperationCallable() + *

  • failoverInstanceCallable() *

*
DeleteInstance

DeleteInstance

Deletes a specific Redis instance. Instance stops serving and data is deleted.

*

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

*
    - *
  • deleteInstanceAsync(DeleteInstanceRequest request) + *
  • deleteInstanceAsync(DeleteInstanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteInstanceAsync(InstanceName name) - *
  • deleteInstanceAsync(String name) + *
  • deleteInstanceAsync(InstanceName name) + *

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

*
    - *
  • deleteInstanceOperationCallable() - *
  • deleteInstanceCallable() + *
  • deleteInstanceOperationCallable() + *

  • deleteInstanceCallable() *

*
RescheduleMaintenance

RescheduleMaintenance

Reschedule maintenance for a given instance in a given project and location.

*

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

*
    - *
  • rescheduleMaintenanceAsync(RescheduleMaintenanceRequest request) + *
  • rescheduleMaintenanceAsync(RescheduleMaintenanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • rescheduleMaintenanceAsync(InstanceName name, RescheduleMaintenanceRequest.RescheduleType rescheduleType, Timestamp scheduleTime) - *
  • rescheduleMaintenanceAsync(String name, RescheduleMaintenanceRequest.RescheduleType rescheduleType, Timestamp scheduleTime) + *
  • rescheduleMaintenanceAsync(InstanceName name, RescheduleMaintenanceRequest.RescheduleType rescheduleType, Timestamp scheduleTime) + *

  • rescheduleMaintenanceAsync(String name, RescheduleMaintenanceRequest.RescheduleType rescheduleType, Timestamp scheduleTime) *

*

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

*
    - *
  • rescheduleMaintenanceOperationCallable() - *
  • rescheduleMaintenanceCallable() + *
  • rescheduleMaintenanceOperationCallable() + *

  • rescheduleMaintenanceCallable() *

*
ListLocations

ListLocations

Lists information about the supported locations for this service.

*

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

*
    - *
  • listLocations(ListLocationsRequest request) + *
  • listLocations(ListLocationsRequest request) *

*

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

*
    - *
  • listLocationsPagedCallable() - *
  • listLocationsCallable() + *
  • listLocationsPagedCallable() + *

  • listLocationsCallable() *

*
GetLocation

GetLocation

Gets information about a location.

*

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

*
    - *
  • getLocation(GetLocationRequest request) + *
  • getLocation(GetLocationRequest request) *

*

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

*
    - *
  • getLocationCallable() + *
  • getLocationCallable() *

*
* *

See the individual methods for example code. diff --git a/java-redis/google-cloud-redis/src/main/java/com/google/cloud/redis/v1/stub/CloudRedisStubSettings.java b/java-redis/google-cloud-redis/src/main/java/com/google/cloud/redis/v1/stub/CloudRedisStubSettings.java index e0db7dcaf660..da76dc442aec 100644 --- a/java-redis/google-cloud-redis/src/main/java/com/google/cloud/redis/v1/stub/CloudRedisStubSettings.java +++ b/java-redis/google-cloud-redis/src/main/java/com/google/cloud/redis/v1/stub/CloudRedisStubSettings.java @@ -395,6 +395,15 @@ public CloudRedisStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -688,7 +697,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -701,7 +709,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -1120,6 +1127,15 @@ public UnaryCallSettings.Builder getLocationSettin return getLocationSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public CloudRedisStubSettings build() throws IOException { return new CloudRedisStubSettings(this); diff --git a/java-redis/google-cloud-redis/src/main/java/com/google/cloud/redis/v1beta1/CloudRedisClient.java b/java-redis/google-cloud-redis/src/main/java/com/google/cloud/redis/v1beta1/CloudRedisClient.java index 1edf9f312927..867d149642c2 100644 --- a/java-redis/google-cloud-redis/src/main/java/com/google/cloud/redis/v1beta1/CloudRedisClient.java +++ b/java-redis/google-cloud-redis/src/main/java/com/google/cloud/redis/v1beta1/CloudRedisClient.java @@ -83,12 +83,14 @@ * threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * - * + * * * * * - * + * * * * * - * + * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
ListInstances

ListInstances

Lists all Redis instances owned by a project in either the specified location (region) or all locations. *

The location should have the following format: *

    @@ -98,60 +100,60 @@ *
*

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

*
    - *
  • listInstances(ListInstancesRequest request) + *
  • listInstances(ListInstancesRequest request) *

*

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

*
    - *
  • listInstances(LocationName parent) - *
  • listInstances(String parent) + *
  • listInstances(LocationName parent) + *

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

*
    - *
  • listInstancesPagedCallable() - *
  • listInstancesCallable() + *
  • listInstancesPagedCallable() + *

  • listInstancesCallable() *

*
GetInstance

GetInstance

Gets the details of a specific Redis instance.

*

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

*
    - *
  • getInstance(GetInstanceRequest request) + *
  • getInstance(GetInstanceRequest request) *

*

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

*
    - *
  • getInstance(InstanceName name) - *
  • getInstance(String name) + *
  • getInstance(InstanceName name) + *

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

*
    - *
  • getInstanceCallable() + *
  • getInstanceCallable() *

*
GetInstanceAuthString

GetInstanceAuthString

Gets the AUTH string for a Redis instance. If AUTH is not enabled for the instance the response will be empty. This information is not included in the details returned to GetInstance.

*

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

*
    - *
  • getInstanceAuthString(GetInstanceAuthStringRequest request) + *
  • getInstanceAuthString(GetInstanceAuthStringRequest request) *

*

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

*
    - *
  • getInstanceAuthString(InstanceName name) - *
  • getInstanceAuthString(String name) + *
  • getInstanceAuthString(InstanceName name) + *

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

*
    - *
  • getInstanceAuthStringCallable() + *
  • getInstanceAuthStringCallable() *

*
CreateInstance

CreateInstance

Creates a Redis instance based on the specified tier and memory size. *

By default, the instance is accessible from the project's [default network](https://cloud.google.com/vpc/docs/vpc). *

The creation is executed asynchronously and callers may check the returned operation to track its progress. Once the operation is completed the Redis instance will be fully functional. The completed longrunning.Operation will contain the new instance object in the response field. @@ -159,163 +161,162 @@ *

*

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

*
    - *
  • createInstanceAsync(CreateInstanceRequest request) + *
  • createInstanceAsync(CreateInstanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createInstanceAsync(LocationName parent, String instanceId, Instance instance) - *
  • createInstanceAsync(String parent, String instanceId, Instance instance) + *
  • createInstanceAsync(LocationName parent, String instanceId, Instance instance) + *

  • createInstanceAsync(String parent, String instanceId, Instance instance) *

*

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

*
    - *
  • createInstanceOperationCallable() - *
  • createInstanceCallable() + *
  • createInstanceOperationCallable() + *

  • createInstanceCallable() *

*
UpdateInstance

UpdateInstance

Updates the metadata and configuration of a specific Redis instance. *

Completed longrunning.Operation will contain the new instance object in the response field. The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.

*

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

*
    - *
  • updateInstanceAsync(UpdateInstanceRequest request) + *
  • updateInstanceAsync(UpdateInstanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateInstanceAsync(FieldMask updateMask, Instance instance) + *
  • updateInstanceAsync(FieldMask updateMask, Instance instance) *

*

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

*
    - *
  • updateInstanceOperationCallable() - *
  • updateInstanceCallable() + *
  • updateInstanceOperationCallable() + *

  • updateInstanceCallable() *

*
UpgradeInstance

UpgradeInstance

Upgrades Redis instance to the newer Redis version specified in the request.

*

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

*
    - *
  • upgradeInstanceAsync(UpgradeInstanceRequest request) + *
  • upgradeInstanceAsync(UpgradeInstanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • upgradeInstanceAsync(InstanceName name, String redisVersion) - *
  • upgradeInstanceAsync(String name, String redisVersion) + *
  • upgradeInstanceAsync(InstanceName name, String redisVersion) + *

  • upgradeInstanceAsync(String name, String redisVersion) *

*

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

*
    - *
  • upgradeInstanceOperationCallable() - *
  • upgradeInstanceCallable() + *
  • upgradeInstanceOperationCallable() + *

  • upgradeInstanceCallable() *

*
ImportInstance

ImportInstance

Import a Redis RDB snapshot file from Cloud Storage into a Redis instance. *

Redis may stop serving during this operation. Instance state will be IMPORTING for entire operation. When complete, the instance will contain only data from the imported file. *

The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.

*

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

*
    - *
  • importInstanceAsync(ImportInstanceRequest request) + *
  • importInstanceAsync(ImportInstanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • importInstanceAsync(String name, InputConfig inputConfig) + *
  • importInstanceAsync(String name, InputConfig inputConfig) *

*

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

*
    - *
  • importInstanceOperationCallable() - *
  • importInstanceCallable() + *
  • importInstanceOperationCallable() + *

  • importInstanceCallable() *

*
ExportInstance

ExportInstance

Export Redis instance data into a Redis RDB format file in Cloud Storage. *

Redis will continue serving during this operation. *

The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.

*

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

*
    - *
  • exportInstanceAsync(ExportInstanceRequest request) + *
  • exportInstanceAsync(ExportInstanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • exportInstanceAsync(String name, OutputConfig outputConfig) + *
  • exportInstanceAsync(String name, OutputConfig outputConfig) *

*

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

*
    - *
  • exportInstanceOperationCallable() - *
  • exportInstanceCallable() + *
  • exportInstanceOperationCallable() + *

  • exportInstanceCallable() *

*
FailoverInstance

FailoverInstance

Initiates a failover of the primary node to current replica node for a specific STANDARD tier Cloud Memorystore for Redis instance.

*

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

*
    - *
  • failoverInstanceAsync(FailoverInstanceRequest request) + *
  • failoverInstanceAsync(FailoverInstanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • failoverInstanceAsync(InstanceName name, FailoverInstanceRequest.DataProtectionMode dataProtectionMode) - *
  • failoverInstanceAsync(String name, FailoverInstanceRequest.DataProtectionMode dataProtectionMode) + *
  • failoverInstanceAsync(InstanceName name, FailoverInstanceRequest.DataProtectionMode dataProtectionMode) + *

  • failoverInstanceAsync(String name, FailoverInstanceRequest.DataProtectionMode dataProtectionMode) *

*

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

*
    - *
  • failoverInstanceOperationCallable() - *
  • failoverInstanceCallable() + *
  • failoverInstanceOperationCallable() + *

  • failoverInstanceCallable() *

*
DeleteInstance

DeleteInstance

Deletes a specific Redis instance. Instance stops serving and data is deleted.

*

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

*
    - *
  • deleteInstanceAsync(DeleteInstanceRequest request) + *
  • deleteInstanceAsync(DeleteInstanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteInstanceAsync(InstanceName name) - *
  • deleteInstanceAsync(String name) + *
  • deleteInstanceAsync(InstanceName name) + *

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

*
    - *
  • deleteInstanceOperationCallable() - *
  • deleteInstanceCallable() + *
  • deleteInstanceOperationCallable() + *

  • deleteInstanceCallable() *

*
RescheduleMaintenance

RescheduleMaintenance

Reschedule maintenance for a given instance in a given project and location.

*

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

*
    - *
  • rescheduleMaintenanceAsync(RescheduleMaintenanceRequest request) + *
  • rescheduleMaintenanceAsync(RescheduleMaintenanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • rescheduleMaintenanceAsync(InstanceName name, RescheduleMaintenanceRequest.RescheduleType rescheduleType, Timestamp scheduleTime) - *
  • rescheduleMaintenanceAsync(String name, RescheduleMaintenanceRequest.RescheduleType rescheduleType, Timestamp scheduleTime) + *
  • rescheduleMaintenanceAsync(InstanceName name, RescheduleMaintenanceRequest.RescheduleType rescheduleType, Timestamp scheduleTime) + *

  • rescheduleMaintenanceAsync(String name, RescheduleMaintenanceRequest.RescheduleType rescheduleType, Timestamp scheduleTime) *

*

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

*
    - *
  • rescheduleMaintenanceOperationCallable() - *
  • rescheduleMaintenanceCallable() + *
  • rescheduleMaintenanceOperationCallable() + *

  • rescheduleMaintenanceCallable() *

*
* *

See the individual methods for example code. diff --git a/java-redis/google-cloud-redis/src/main/java/com/google/cloud/redis/v1beta1/stub/CloudRedisStubSettings.java b/java-redis/google-cloud-redis/src/main/java/com/google/cloud/redis/v1beta1/stub/CloudRedisStubSettings.java index be52b543dd33..41af6f4a481f 100644 --- a/java-redis/google-cloud-redis/src/main/java/com/google/cloud/redis/v1beta1/stub/CloudRedisStubSettings.java +++ b/java-redis/google-cloud-redis/src/main/java/com/google/cloud/redis/v1beta1/stub/CloudRedisStubSettings.java @@ -323,6 +323,15 @@ public CloudRedisStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -600,7 +609,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -613,7 +621,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -1002,6 +1009,15 @@ public UnaryCallSettings.Builder deleteInstanc return rescheduleMaintenanceOperationSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public CloudRedisStubSettings build() throws IOException { return new CloudRedisStubSettings(this); diff --git a/java-resource-settings/README.md b/java-resource-settings/README.md index b24d6474b9be..2147c05ea272 100644 --- a/java-resource-settings/README.md +++ b/java-resource-settings/README.md @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-resource-settings.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-resource-settings/1.32.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-resource-settings/1.33.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-resource-settings/google-cloud-resource-settings/src/main/java/com/google/cloud/resourcesettings/v1/ResourceSettingsServiceClient.java b/java-resource-settings/google-cloud-resource-settings/src/main/java/com/google/cloud/resourcesettings/v1/ResourceSettingsServiceClient.java index de623f15f976..29b18e52950b 100644 --- a/java-resource-settings/google-cloud-resource-settings/src/main/java/com/google/cloud/resourcesettings/v1/ResourceSettingsServiceClient.java +++ b/java-resource-settings/google-cloud-resource-settings/src/main/java/com/google/cloud/resourcesettings/v1/ResourceSettingsServiceClient.java @@ -69,52 +69,54 @@ * calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * - * *
Methods
MethodDescriptionMethod Variants
ListSettings

ListSettings

Lists all the settings that are available on the Cloud resource `parent`.

*

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

*
    - *
  • listSettings(ListSettingsRequest request) + *
  • listSettings(ListSettingsRequest request) *

*

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

*
    - *
  • listSettings(ResourceName parent) - *
  • listSettings(String parent) + *
  • listSettings(ResourceName parent) + *

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

*
    - *
  • listSettingsPagedCallable() - *
  • listSettingsCallable() + *
  • listSettingsPagedCallable() + *

  • listSettingsCallable() *

*
GetSetting

GetSetting

Gets a setting. *

Returns a `google.rpc.Status` with `google.rpc.Code.NOT_FOUND` if the setting does not exist.

*

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

*
    - *
  • getSetting(GetSettingRequest request) + *
  • getSetting(GetSettingRequest request) *

*

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

*
    - *
  • getSetting(SettingName name) - *
  • getSetting(String name) + *
  • getSetting(SettingName name) + *

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

*
    - *
  • getSettingCallable() + *
  • getSettingCallable() *

*
UpdateSetting

UpdateSetting

Updates a setting. *

Returns a `google.rpc.Status` with `google.rpc.Code.NOT_FOUND` if the setting does not exist. Returns a `google.rpc.Status` with `google.rpc.Code.FAILED_PRECONDITION` if the setting is flagged as read only. Returns a `google.rpc.Status` with `google.rpc.Code.ABORTED` if the etag supplied in the request does not match the persisted etag of the setting value. *

On success, the response will contain only `name`, `local_value` and `etag`. The `metadata` and `effective_value` cannot be updated through this API. @@ -122,15 +124,14 @@ *

*

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

*
    - *
  • updateSetting(UpdateSettingRequest request) + *
  • updateSetting(UpdateSettingRequest request) *

*

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

*
    - *
  • updateSettingCallable() + *
  • updateSettingCallable() *

*
* *

See the individual methods for example code. diff --git a/java-resource-settings/google-cloud-resource-settings/src/main/java/com/google/cloud/resourcesettings/v1/stub/ResourceSettingsServiceStubSettings.java b/java-resource-settings/google-cloud-resource-settings/src/main/java/com/google/cloud/resourcesettings/v1/stub/ResourceSettingsServiceStubSettings.java index 7dfe2b07677e..1343d2709ef7 100644 --- a/java-resource-settings/google-cloud-resource-settings/src/main/java/com/google/cloud/resourcesettings/v1/stub/ResourceSettingsServiceStubSettings.java +++ b/java-resource-settings/google-cloud-resource-settings/src/main/java/com/google/cloud/resourcesettings/v1/stub/ResourceSettingsServiceStubSettings.java @@ -194,6 +194,15 @@ public ResourceSettingsServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -372,7 +381,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -385,7 +393,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -443,6 +450,15 @@ public UnaryCallSettings.Builder updateSettingSet return updateSettingSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public ResourceSettingsServiceStubSettings build() throws IOException { return new ResourceSettingsServiceStubSettings(this); diff --git a/java-resourcemanager/README.md b/java-resourcemanager/README.md index 702a30300a65..7fede713c3db 100644 --- a/java-resourcemanager/README.md +++ b/java-resourcemanager/README.md @@ -336,7 +336,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-resourcemanager.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-resourcemanager/1.34.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-resourcemanager/1.35.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/FoldersClient.java b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/FoldersClient.java index a843107a7eee..c65a6d0014bb 100644 --- a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/FoldersClient.java +++ b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/FoldersClient.java @@ -68,71 +68,73 @@ * threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
GetFolder

GetFolder

Retrieves a folder identified by the supplied resource name. Valid folder resource names have the format `folders/{folder_id}` (for example, `folders/1234`). The caller must have `resourcemanager.folders.get` permission on the identified folder.

*

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

*
    - *
  • getFolder(GetFolderRequest request) + *
  • getFolder(GetFolderRequest request) *

*

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

*
    - *
  • getFolder(FolderName name) - *
  • getFolder(String name) + *
  • getFolder(FolderName name) + *

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

*
    - *
  • getFolderCallable() + *
  • getFolderCallable() *

*
ListFolders

ListFolders

Lists the folders that are direct descendants of supplied parent resource. `list()` provides a strongly consistent view of the folders underneath the specified parent resource. `list()` returns folders sorted based upon the (ascending) lexical ordering of their display_name. The caller must have `resourcemanager.folders.list` permission on the identified parent.

*

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

*
    - *
  • listFolders(ListFoldersRequest request) + *
  • listFolders(ListFoldersRequest request) *

*

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

*
    - *
  • listFolders(ResourceName parent) - *
  • listFolders(String parent) + *
  • listFolders(ResourceName parent) + *

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

*
    - *
  • listFoldersPagedCallable() - *
  • listFoldersCallable() + *
  • listFoldersPagedCallable() + *

  • listFoldersCallable() *

*
SearchFolders

SearchFolders

Search for folders that match specific filter criteria. `search()` provides an eventually consistent view of the folders a user has access to which meet the specified filter criteria. *

This will only return folders on which the caller has the permission `resourcemanager.folders.get`.

*

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

*
    - *
  • searchFolders(SearchFoldersRequest request) + *
  • searchFolders(SearchFoldersRequest request) *

*

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

*
    - *
  • searchFolders(String query) + *
  • searchFolders(String query) *

*

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

*
    - *
  • searchFoldersPagedCallable() - *
  • searchFoldersCallable() + *
  • searchFoldersPagedCallable() + *

  • searchFoldersCallable() *

*
CreateFolder

CreateFolder

Creates a folder in the resource hierarchy. Returns an `Operation` which can be used to track the progress of the folder creation workflow. Upon success, the `Operation.response` field will be populated with the created Folder. *

In order to succeed, the addition of this new folder must not violate the folder naming, height, or fanout constraints. *

+ The folder's `display_name` must be distinct from all other folders that share its parent. + The addition of the folder must not cause the active folder hierarchy to exceed a height of 10. Note, the full active + deleted folder hierarchy is allowed to reach a height of 20; this provides additional headroom when moving folders that contain deleted folders. + The addition of the folder must not cause the total number of folders under its parent to exceed 300. @@ -141,161 +143,160 @@ *

*

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

*
    - *
  • createFolderAsync(CreateFolderRequest request) + *
  • createFolderAsync(CreateFolderRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createFolderAsync(Folder folder) + *
  • createFolderAsync(Folder folder) *

*

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

*
    - *
  • createFolderOperationCallable() - *
  • createFolderCallable() + *
  • createFolderOperationCallable() + *

  • createFolderCallable() *

*
UpdateFolder

UpdateFolder

Updates a folder, changing its `display_name`. Changes to the folder `display_name` will be rejected if they violate either the `display_name` formatting rules or the naming constraints described in the [CreateFolder][google.cloud.resourcemanager.v3.Folders.CreateFolder] documentation. *

The folder's `display_name` must start and end with a letter or digit, may contain letters, digits, spaces, hyphens and underscores and can be between 3 and 30 characters. This is captured by the regular expression: `[\\\\p{L}\\\\p{N}][\\\\p{L}\\\\p{N}_- ]{1,28}[\\\\p{L}\\\\p{N}]`. The caller must have `resourcemanager.folders.update` permission on the identified folder. *

If the update fails due to the unique name constraint then a `PreconditionFailure` explaining this violation will be returned in the Status.details field.

*

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

*
    - *
  • updateFolderAsync(UpdateFolderRequest request) + *
  • updateFolderAsync(UpdateFolderRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateFolderAsync(Folder folder, FieldMask updateMask) + *
  • updateFolderAsync(Folder folder, 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.

*
    - *
  • updateFolderOperationCallable() - *
  • updateFolderCallable() + *
  • updateFolderOperationCallable() + *

  • updateFolderCallable() *

*
MoveFolder

MoveFolder

Moves a folder under a new resource parent. Returns an `Operation` which can be used to track the progress of the folder move workflow. Upon success, the `Operation.response` field will be populated with the moved folder. Upon failure, a `FolderOperationError` categorizing the failure cause will be returned - if the failure occurs synchronously then the `FolderOperationError` will be returned in the `Status.details` field. If it occurs asynchronously, then the FolderOperation will be returned in the `Operation.error` field. In addition, the `Operation.metadata` field will be populated with a `FolderOperation` message as an aid to stateless clients. Folder moves will be rejected if they violate either the naming, height, or fanout constraints described in the [CreateFolder][google.cloud.resourcemanager.v3.Folders.CreateFolder] documentation. The caller must have `resourcemanager.folders.move` permission on the folder's current and proposed new parent.

*

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

*
    - *
  • moveFolderAsync(MoveFolderRequest request) + *
  • moveFolderAsync(MoveFolderRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • moveFolderAsync(FolderName name, ResourceName destinationParent) - *
  • moveFolderAsync(FolderName name, String destinationParent) - *
  • moveFolderAsync(String name, ResourceName destinationParent) - *
  • moveFolderAsync(String name, String destinationParent) + *
  • moveFolderAsync(FolderName name, ResourceName destinationParent) + *

  • moveFolderAsync(FolderName name, String destinationParent) + *

  • moveFolderAsync(String name, ResourceName destinationParent) + *

  • moveFolderAsync(String name, String destinationParent) *

*

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

*
    - *
  • moveFolderOperationCallable() - *
  • moveFolderCallable() + *
  • moveFolderOperationCallable() + *

  • moveFolderCallable() *

*
DeleteFolder

DeleteFolder

Requests deletion of a folder. The folder is moved into the [DELETE_REQUESTED][google.cloud.resourcemanager.v3.Folder.State.DELETE_REQUESTED] state immediately, and is deleted approximately 30 days later. This method may only be called on an empty folder, where a folder is empty if it doesn't contain any folders or projects in the [ACTIVE][google.cloud.resourcemanager.v3.Folder.State.ACTIVE] state. If called on a folder in [DELETE_REQUESTED][google.cloud.resourcemanager.v3.Folder.State.DELETE_REQUESTED] state the operation will result in a no-op success. The caller must have `resourcemanager.folders.delete` permission on the identified folder.

*

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

*
    - *
  • deleteFolderAsync(DeleteFolderRequest request) + *
  • deleteFolderAsync(DeleteFolderRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteFolderAsync(FolderName name) - *
  • deleteFolderAsync(String name) + *
  • deleteFolderAsync(FolderName name) + *

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

*
    - *
  • deleteFolderOperationCallable() - *
  • deleteFolderCallable() + *
  • deleteFolderOperationCallable() + *

  • deleteFolderCallable() *

*
UndeleteFolder

UndeleteFolder

Cancels the deletion request for a folder. This method may be called on a folder in any state. If the folder is in the [ACTIVE][google.cloud.resourcemanager.v3.Folder.State.ACTIVE] state the result will be a no-op success. In order to succeed, the folder's parent must be in the [ACTIVE][google.cloud.resourcemanager.v3.Folder.State.ACTIVE] state. In addition, reintroducing the folder into the tree must not violate folder naming, height, and fanout constraints described in the [CreateFolder][google.cloud.resourcemanager.v3.Folders.CreateFolder] documentation. The caller must have `resourcemanager.folders.undelete` permission on the identified folder.

*

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

*
    - *
  • undeleteFolderAsync(UndeleteFolderRequest request) + *
  • undeleteFolderAsync(UndeleteFolderRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • undeleteFolderAsync(FolderName name) - *
  • undeleteFolderAsync(String name) + *
  • undeleteFolderAsync(FolderName name) + *

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

*
    - *
  • undeleteFolderOperationCallable() - *
  • undeleteFolderCallable() + *
  • undeleteFolderOperationCallable() + *

  • undeleteFolderCallable() *

*
GetIamPolicy

GetIamPolicy

Gets the access control policy for a folder. The returned policy may be empty if no such policy or resource exists. The `resource` field should be the folder's resource name, for example: "folders/1234". The caller must have `resourcemanager.folders.getIamPolicy` permission on the identified folder.

*

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

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *
  • getIamPolicy(GetIamPolicyRequest request) *

*

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

*
    - *
  • getIamPolicy(ResourceName resource) - *
  • getIamPolicy(String resource) + *
  • getIamPolicy(ResourceName resource) + *

  • getIamPolicy(String resource) *

*

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

*
    - *
  • getIamPolicyCallable() + *
  • getIamPolicyCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the access control policy on a folder, replacing any existing policy. The `resource` field should be the folder's resource name, for example: "folders/1234". The caller must have `resourcemanager.folders.setIamPolicy` permission on the identified folder.

*

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

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *
  • setIamPolicy(SetIamPolicyRequest request) *

*

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

*
    - *
  • setIamPolicy(ResourceName resource, Policy policy) - *
  • setIamPolicy(String resource, Policy policy) + *
  • setIamPolicy(ResourceName resource, Policy policy) + *

  • setIamPolicy(String resource, Policy policy) *

*

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

*
    - *
  • setIamPolicyCallable() + *
  • setIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns permissions that a caller has on the specified folder. The `resource` field should be the folder's resource name, for example: "folders/1234". *

There are no permissions required for making this API call.

*

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

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *
  • testIamPermissions(TestIamPermissionsRequest request) *

*

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

*
    - *
  • testIamPermissions(ResourceName resource, List permissions) - *
  • testIamPermissions(String resource, List permissions) + *
  • testIamPermissions(ResourceName resource, List<String> permissions) + *

  • testIamPermissions(String resource, List<String> permissions) *

*

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

*
    - *
  • testIamPermissionsCallable() + *
  • testIamPermissionsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/OrganizationsClient.java b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/OrganizationsClient.java index 09a2f5752a1e..bfcbbde83851 100644 --- a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/OrganizationsClient.java +++ b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/OrganizationsClient.java @@ -61,110 +61,111 @@ * as threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
GetOrganization

GetOrganization

Fetches an organization resource identified by the specified resource name.

*

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

*
    - *
  • getOrganization(GetOrganizationRequest request) + *
  • getOrganization(GetOrganizationRequest request) *

*

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

*
    - *
  • getOrganization(OrganizationName name) - *
  • getOrganization(String name) + *
  • getOrganization(OrganizationName name) + *

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

*
    - *
  • getOrganizationCallable() + *
  • getOrganizationCallable() *

*
SearchOrganizations

SearchOrganizations

Searches organization resources that are visible to the user and satisfy the specified filter. This method returns organizations in an unspecified order. New organizations do not necessarily appear at the end of the results, and may take a small amount of time to appear. *

Search will only return organizations on which the user has the permission `resourcemanager.organizations.get`

*

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

*
    - *
  • searchOrganizations(SearchOrganizationsRequest request) + *
  • searchOrganizations(SearchOrganizationsRequest request) *

*

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

*
    - *
  • searchOrganizations(String query) + *
  • searchOrganizations(String query) *

*

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

*
    - *
  • searchOrganizationsPagedCallable() - *
  • searchOrganizationsCallable() + *
  • searchOrganizationsPagedCallable() + *

  • searchOrganizationsCallable() *

*
GetIamPolicy

GetIamPolicy

Gets the access control policy for an organization resource. The policy may be empty if no such policy or resource exists. The `resource` field should be the organization's resource name, for example: "organizations/123". *

Authorization requires the IAM permission `resourcemanager.organizations.getIamPolicy` on the specified organization.

*

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

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *
  • getIamPolicy(GetIamPolicyRequest request) *

*

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

*
    - *
  • getIamPolicy(ResourceName resource) - *
  • getIamPolicy(String resource) + *
  • getIamPolicy(ResourceName resource) + *

  • getIamPolicy(String resource) *

*

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

*
    - *
  • getIamPolicyCallable() + *
  • getIamPolicyCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the access control policy on an organization resource. Replaces any existing policy. The `resource` field should be the organization's resource name, for example: "organizations/123". *

Authorization requires the IAM permission `resourcemanager.organizations.setIamPolicy` on the specified organization.

*

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

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *
  • setIamPolicy(SetIamPolicyRequest request) *

*

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

*
    - *
  • setIamPolicy(ResourceName resource) - *
  • setIamPolicy(String resource) + *
  • setIamPolicy(ResourceName resource) + *

  • setIamPolicy(String resource) *

*

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

*
    - *
  • setIamPolicyCallable() + *
  • setIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns the permissions that a caller has on the specified organization. The `resource` field should be the organization's resource name, for example: "organizations/123". *

There are no permissions required for making this API call.

*

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

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *
  • testIamPermissions(TestIamPermissionsRequest request) *

*

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

*
    - *
  • testIamPermissions(ResourceName resource, List permissions) - *
  • testIamPermissions(String resource, List permissions) + *
  • testIamPermissions(ResourceName resource, List<String> permissions) + *

  • testIamPermissions(String resource, List<String> permissions) *

*

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

*
    - *
  • testIamPermissionsCallable() + *
  • testIamPermissionsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/ProjectsClient.java b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/ProjectsClient.java index 1fea16e05a3d..03077f9516e3 100644 --- a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/ProjectsClient.java +++ b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/ProjectsClient.java @@ -67,112 +67,114 @@ * threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * + * * * * - * + * * * * * - * + * * * * * - * + * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
GetProject

GetProject

Retrieves the project identified by the specified `name` (for example, `projects/415104041262`). *

The caller must have `resourcemanager.projects.get` permission for this project.

*

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

*
    - *
  • getProject(GetProjectRequest request) + *
  • getProject(GetProjectRequest request) *

*

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

*
    - *
  • getProject(ProjectName name) - *
  • getProject(String name) + *
  • getProject(ProjectName name) + *

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

*
    - *
  • getProjectCallable() + *
  • getProjectCallable() *

*
ListProjects

ListProjects

Lists projects that are direct children of the specified folder or organization resource. `list()` provides a strongly consistent view of the projects underneath the specified parent resource. `list()` returns projects sorted based upon the (ascending) lexical ordering of their `display_name`. The caller must have `resourcemanager.projects.list` permission on the identified parent.

*

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

*
    - *
  • listProjects(ListProjectsRequest request) + *
  • listProjects(ListProjectsRequest request) *

*

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

*
    - *
  • listProjects(ResourceName parent) - *
  • listProjects(String parent) + *
  • listProjects(ResourceName parent) + *

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

*
    - *
  • listProjectsPagedCallable() - *
  • listProjectsCallable() + *
  • listProjectsPagedCallable() + *

  • listProjectsCallable() *

*
SearchProjects

SearchProjects

Search for projects that the caller has both `resourcemanager.projects.get` permission on, and also satisfy the specified query. *

This method returns projects in an unspecified order. *

This method is eventually consistent with project mutations; this means that a newly created project may not appear in the results or recent updates to an existing project may not be reflected in the results. To retrieve the latest state of a project, use the [GetProject][google.cloud.resourcemanager.v3.Projects.GetProject] method.

*

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

*
    - *
  • searchProjects(SearchProjectsRequest request) + *
  • searchProjects(SearchProjectsRequest request) *

*

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

*
    - *
  • searchProjects(String query) + *
  • searchProjects(String query) *

*

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

*
    - *
  • searchProjectsPagedCallable() - *
  • searchProjectsCallable() + *
  • searchProjectsPagedCallable() + *

  • searchProjectsCallable() *

*
CreateProject

CreateProject

Request that a new project be created. The result is an `Operation` which can be used to track the creation process. This process usually takes a few seconds, but can sometimes take much longer. The tracking `Operation` is automatically deleted after a few hours, so there is no need to call `DeleteOperation`.

*

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

*
    - *
  • createProjectAsync(CreateProjectRequest request) + *
  • createProjectAsync(CreateProjectRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createProjectAsync(Project project) + *
  • createProjectAsync(Project project) *

*

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

*
    - *
  • createProjectOperationCallable() - *
  • createProjectCallable() + *
  • createProjectOperationCallable() + *

  • createProjectCallable() *

*
UpdateProject

UpdateProject

Updates the `display_name` and labels of the project identified by the specified `name` (for example, `projects/415104041262`). Deleting all labels requires an update mask for labels field. *

The caller must have `resourcemanager.projects.update` permission for this project.

*

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

*
    - *
  • updateProjectAsync(UpdateProjectRequest request) + *
  • updateProjectAsync(UpdateProjectRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateProjectAsync(Project project, FieldMask updateMask) + *
  • updateProjectAsync(Project project, 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.

*
    - *
  • updateProjectOperationCallable() - *
  • updateProjectCallable() + *
  • updateProjectOperationCallable() + *

  • updateProjectCallable() *

*
MoveProject

MoveProject

Move a project to another place in your resource hierarchy, under a new resource parent. *

Returns an operation which can be used to track the process of the project move workflow. Upon success, the `Operation.response` field will be populated with the moved project. *

The caller must have `resourcemanager.projects.move` permission on the project, on the project's current and proposed new parent. @@ -180,24 +182,24 @@ *

*

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

*
    - *
  • moveProjectAsync(MoveProjectRequest request) + *
  • moveProjectAsync(MoveProjectRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • moveProjectAsync(ProjectName name, ResourceName destinationParent) - *
  • moveProjectAsync(ProjectName name, String destinationParent) - *
  • moveProjectAsync(String name, ResourceName destinationParent) - *
  • moveProjectAsync(String name, String destinationParent) + *
  • moveProjectAsync(ProjectName name, ResourceName destinationParent) + *

  • moveProjectAsync(ProjectName name, String destinationParent) + *

  • moveProjectAsync(String name, ResourceName destinationParent) + *

  • moveProjectAsync(String name, String destinationParent) *

*

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

*
    - *
  • moveProjectOperationCallable() - *
  • moveProjectCallable() + *
  • moveProjectOperationCallable() + *

  • moveProjectCallable() *

*
DeleteProject

DeleteProject

Marks the project identified by the specified `name` (for example, `projects/415104041262`) for deletion. *

This method will only affect the project if it has a lifecycle state of [ACTIVE][google.cloud.resourcemanager.v3.Project.State.ACTIVE]. *

This method changes the Project's lifecycle state from [ACTIVE][google.cloud.resourcemanager.v3.Project.State.ACTIVE] to [DELETE_REQUESTED][google.cloud.resourcemanager.v3.Project.State.DELETE_REQUESTED]. The deletion starts at an unspecified time, at which point the Project is no longer accessible. @@ -208,62 +210,62 @@ *

*

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

*
    - *
  • deleteProjectAsync(DeleteProjectRequest request) + *
  • deleteProjectAsync(DeleteProjectRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteProjectAsync(ProjectName name) - *
  • deleteProjectAsync(String name) + *
  • deleteProjectAsync(ProjectName name) + *

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

*
    - *
  • deleteProjectOperationCallable() - *
  • deleteProjectCallable() + *
  • deleteProjectOperationCallable() + *

  • deleteProjectCallable() *

*
UndeleteProject

UndeleteProject

Restores the project identified by the specified `name` (for example, `projects/415104041262`). You can only use this method for a project that has a lifecycle state of [DELETE_REQUESTED] [Projects.State.DELETE_REQUESTED]. After deletion starts, the project cannot be restored. *

The caller must have `resourcemanager.projects.undelete` permission for this project.

*

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

*
    - *
  • undeleteProjectAsync(UndeleteProjectRequest request) + *
  • undeleteProjectAsync(UndeleteProjectRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • undeleteProjectAsync(ProjectName name) - *
  • undeleteProjectAsync(String name) + *
  • undeleteProjectAsync(ProjectName name) + *

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

*
    - *
  • undeleteProjectOperationCallable() - *
  • undeleteProjectCallable() + *
  • undeleteProjectOperationCallable() + *

  • undeleteProjectCallable() *

*
GetIamPolicy

GetIamPolicy

Returns the IAM access control policy for the specified project, in the format `projects/{ProjectIdOrNumber}` e.g. projects/123. Permission is denied if the policy or the resource do not exist.

*

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

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *
  • getIamPolicy(GetIamPolicyRequest request) *

*

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

*
    - *
  • getIamPolicy(ResourceName resource) - *
  • getIamPolicy(String resource) + *
  • getIamPolicy(ResourceName resource) + *

  • getIamPolicy(String resource) *

*

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

*
    - *
  • getIamPolicyCallable() + *
  • getIamPolicyCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the IAM access control policy for the specified project, in the format `projects/{ProjectIdOrNumber}` e.g. projects/123. *

CAUTION: This method will replace the existing policy, and cannot be used to append additional IAM settings. *

Note: Removing service accounts from policies or changing their roles can render services completely inoperable. It is important to understand how the service account is being used before removing or updating its roles. @@ -277,39 +279,38 @@ *

*

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

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *
  • setIamPolicy(SetIamPolicyRequest request) *

*

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

*
    - *
  • setIamPolicy(ResourceName resource, Policy policy) - *
  • setIamPolicy(String resource, Policy policy) + *
  • setIamPolicy(ResourceName resource, Policy policy) + *

  • setIamPolicy(String resource, Policy policy) *

*

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

*
    - *
  • setIamPolicyCallable() + *
  • setIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns permissions that a caller has on the specified project, in the format `projects/{ProjectIdOrNumber}` e.g. projects/123..

*

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

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *
  • testIamPermissions(TestIamPermissionsRequest request) *

*

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

*
    - *
  • testIamPermissions(ResourceName resource, List permissions) - *
  • testIamPermissions(String resource, List permissions) + *
  • testIamPermissions(ResourceName resource, List<String> permissions) + *

  • testIamPermissions(String resource, List<String> permissions) *

*

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

*
    - *
  • testIamPermissionsCallable() + *
  • testIamPermissionsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/TagBindingsClient.java b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/TagBindingsClient.java index 7c97327ee418..179e72c32ae7 100644 --- a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/TagBindingsClient.java +++ b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/TagBindingsClient.java @@ -65,90 +65,91 @@ * threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
ListTagBindings

ListTagBindings

Lists the TagBindings for the given Google Cloud resource, as specified with `parent`. *

NOTE: The `parent` field is expected to be a full resource name: https://cloud.google.com/apis/design/resource_names#full_resource_name

*

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

*
    - *
  • listTagBindings(ListTagBindingsRequest request) + *
  • listTagBindings(ListTagBindingsRequest request) *

*

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

*
    - *
  • listTagBindings(ResourceName parent) - *
  • listTagBindings(String parent) + *
  • listTagBindings(ResourceName parent) + *

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

*
    - *
  • listTagBindingsPagedCallable() - *
  • listTagBindingsCallable() + *
  • listTagBindingsPagedCallable() + *

  • listTagBindingsCallable() *

*
CreateTagBinding

CreateTagBinding

Creates a TagBinding between a TagValue and a Google Cloud resource.

*

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

*
    - *
  • createTagBindingAsync(CreateTagBindingRequest request) + *
  • createTagBindingAsync(CreateTagBindingRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createTagBindingAsync(TagBinding tagBinding) + *
  • createTagBindingAsync(TagBinding tagBinding) *

*

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

*
    - *
  • createTagBindingOperationCallable() - *
  • createTagBindingCallable() + *
  • createTagBindingOperationCallable() + *

  • createTagBindingCallable() *

*
DeleteTagBinding

DeleteTagBinding

Deletes a TagBinding.

*

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

*
    - *
  • deleteTagBindingAsync(DeleteTagBindingRequest request) + *
  • deleteTagBindingAsync(DeleteTagBindingRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteTagBindingAsync(TagBindingName name) - *
  • deleteTagBindingAsync(String name) + *
  • deleteTagBindingAsync(TagBindingName name) + *

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

*
    - *
  • deleteTagBindingOperationCallable() - *
  • deleteTagBindingCallable() + *
  • deleteTagBindingOperationCallable() + *

  • deleteTagBindingCallable() *

*
ListEffectiveTags

ListEffectiveTags

Return a list of effective tags for the given Google Cloud resource, as specified in `parent`.

*

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

*
    - *
  • listEffectiveTags(ListEffectiveTagsRequest request) + *
  • listEffectiveTags(ListEffectiveTagsRequest request) *

*

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

*
    - *
  • listEffectiveTags(String parent) + *
  • listEffectiveTags(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.

*
    - *
  • listEffectiveTagsPagedCallable() - *
  • listEffectiveTagsCallable() + *
  • listEffectiveTagsPagedCallable() + *

  • listEffectiveTagsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/TagHoldsClient.java b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/TagHoldsClient.java index fd7dc167fb3c..85bb4a7f6b78 100644 --- a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/TagHoldsClient.java +++ b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/TagHoldsClient.java @@ -65,71 +65,72 @@ * threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
CreateTagHold

CreateTagHold

Creates a TagHold. Returns ALREADY_EXISTS if a TagHold with the same resource and origin exists under the same TagValue.

*

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

*
    - *
  • createTagHoldAsync(CreateTagHoldRequest request) + *
  • createTagHoldAsync(CreateTagHoldRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createTagHoldAsync(TagValueName parent, TagHold tagHold) - *
  • createTagHoldAsync(String parent, TagHold tagHold) + *
  • createTagHoldAsync(TagValueName parent, TagHold tagHold) + *

  • createTagHoldAsync(String parent, TagHold tagHold) *

*

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

*
    - *
  • createTagHoldOperationCallable() - *
  • createTagHoldCallable() + *
  • createTagHoldOperationCallable() + *

  • createTagHoldCallable() *

*
DeleteTagHold

DeleteTagHold

Deletes a TagHold.

*

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

*
    - *
  • deleteTagHoldAsync(DeleteTagHoldRequest request) + *
  • deleteTagHoldAsync(DeleteTagHoldRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteTagHoldAsync(TagHoldName name) - *
  • deleteTagHoldAsync(String name) + *
  • deleteTagHoldAsync(TagHoldName name) + *

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

*
    - *
  • deleteTagHoldOperationCallable() - *
  • deleteTagHoldCallable() + *
  • deleteTagHoldOperationCallable() + *

  • deleteTagHoldCallable() *

*
ListTagHolds

ListTagHolds

Lists TagHolds under a TagValue.

*

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

*
    - *
  • listTagHolds(ListTagHoldsRequest request) + *
  • listTagHolds(ListTagHoldsRequest request) *

*

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

*
    - *
  • listTagHolds(TagValueName parent) - *
  • listTagHolds(String parent) + *
  • listTagHolds(TagValueName parent) + *

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

*
    - *
  • listTagHoldsPagedCallable() - *
  • listTagHoldsCallable() + *
  • listTagHoldsPagedCallable() + *

  • listTagHoldsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/TagKeysClient.java b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/TagKeysClient.java index c2656fa7fffb..376fdba8cd26 100644 --- a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/TagKeysClient.java +++ b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/TagKeysClient.java @@ -67,185 +67,186 @@ * threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
ListTagKeys

ListTagKeys

Lists all TagKeys for a parent resource.

*

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

*
    - *
  • listTagKeys(ListTagKeysRequest request) + *
  • listTagKeys(ListTagKeysRequest request) *

*

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

*
    - *
  • listTagKeys(ResourceName parent) - *
  • listTagKeys(String parent) + *
  • listTagKeys(ResourceName parent) + *

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

*
    - *
  • listTagKeysPagedCallable() - *
  • listTagKeysCallable() + *
  • listTagKeysPagedCallable() + *

  • listTagKeysCallable() *

*
GetTagKey

GetTagKey

Retrieves a TagKey. This method will return `PERMISSION_DENIED` if the key does not exist or the user does not have permission to view it.

*

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

*
    - *
  • getTagKey(GetTagKeyRequest request) + *
  • getTagKey(GetTagKeyRequest request) *

*

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

*
    - *
  • getTagKey(TagKeyName name) - *
  • getTagKey(String name) + *
  • getTagKey(TagKeyName name) + *

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

*
    - *
  • getTagKeyCallable() + *
  • getTagKeyCallable() *

*
GetNamespacedTagKey

GetNamespacedTagKey

Retrieves a TagKey by its namespaced name. This method will return `PERMISSION_DENIED` if the key does not exist or the user does not have permission to view it.

*

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

*
    - *
  • getNamespacedTagKey(GetNamespacedTagKeyRequest request) + *
  • getNamespacedTagKey(GetNamespacedTagKeyRequest request) *

*

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

*
    - *
  • getNamespacedTagKey(TagKeyName name) - *
  • getNamespacedTagKey(String name) + *
  • getNamespacedTagKey(TagKeyName name) + *

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

*
    - *
  • getNamespacedTagKeyCallable() + *
  • getNamespacedTagKeyCallable() *

*
CreateTagKey

CreateTagKey

Creates a new TagKey. If another request with the same parameters is sent while the original request is in process, the second request will receive an error. A maximum of 1000 TagKeys can exist under a parent at any given time.

*

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

*
    - *
  • createTagKeyAsync(CreateTagKeyRequest request) + *
  • createTagKeyAsync(CreateTagKeyRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createTagKeyAsync(TagKey tagKey) + *
  • createTagKeyAsync(TagKey tagKey) *

*

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

*
    - *
  • createTagKeyOperationCallable() - *
  • createTagKeyCallable() + *
  • createTagKeyOperationCallable() + *

  • createTagKeyCallable() *

*
UpdateTagKey

UpdateTagKey

Updates the attributes of the TagKey resource.

*

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

*
    - *
  • updateTagKeyAsync(UpdateTagKeyRequest request) + *
  • updateTagKeyAsync(UpdateTagKeyRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateTagKeyAsync(TagKey tagKey, FieldMask updateMask) + *
  • updateTagKeyAsync(TagKey tagKey, 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.

*
    - *
  • updateTagKeyOperationCallable() - *
  • updateTagKeyCallable() + *
  • updateTagKeyOperationCallable() + *

  • updateTagKeyCallable() *

*
DeleteTagKey

DeleteTagKey

Deletes a TagKey. The TagKey cannot be deleted if it has any child TagValues.

*

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

*
    - *
  • deleteTagKeyAsync(DeleteTagKeyRequest request) + *
  • deleteTagKeyAsync(DeleteTagKeyRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteTagKeyAsync(TagKeyName name) - *
  • deleteTagKeyAsync(String name) + *
  • deleteTagKeyAsync(TagKeyName name) + *

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

*
    - *
  • deleteTagKeyOperationCallable() - *
  • deleteTagKeyCallable() + *
  • deleteTagKeyOperationCallable() + *

  • deleteTagKeyCallable() *

*
GetIamPolicy

GetIamPolicy

Gets the access control policy for a TagKey. The returned policy may be empty if no such policy or resource exists. The `resource` field should be the TagKey's resource name. For example, "tagKeys/1234". The caller must have `cloudresourcemanager.googleapis.com/tagKeys.getIamPolicy` permission on the specified TagKey.

*

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

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *
  • getIamPolicy(GetIamPolicyRequest request) *

*

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

*
    - *
  • getIamPolicy(ResourceName resource) - *
  • getIamPolicy(String resource) + *
  • getIamPolicy(ResourceName resource) + *

  • getIamPolicy(String resource) *

*

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

*
    - *
  • getIamPolicyCallable() + *
  • getIamPolicyCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the access control policy on a TagKey, replacing any existing policy. The `resource` field should be the TagKey's resource name. For example, "tagKeys/1234". The caller must have `resourcemanager.tagKeys.setIamPolicy` permission on the identified tagValue.

*

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

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *
  • setIamPolicy(SetIamPolicyRequest request) *

*

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

*
    - *
  • setIamPolicy(ResourceName resource, Policy policy) - *
  • setIamPolicy(String resource, Policy policy) + *
  • setIamPolicy(ResourceName resource, Policy policy) + *

  • setIamPolicy(String resource, Policy policy) *

*

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

*
    - *
  • setIamPolicyCallable() + *
  • setIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns permissions that a caller has on the specified TagKey. The `resource` field should be the TagKey's resource name. For example, "tagKeys/1234". *

There are no permissions required for making this API call.

*

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

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *
  • testIamPermissions(TestIamPermissionsRequest request) *

*

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

*
    - *
  • testIamPermissions(ResourceName resource, List permissions) - *
  • testIamPermissions(String resource, List permissions) + *
  • testIamPermissions(ResourceName resource, List<String> permissions) + *

  • testIamPermissions(String resource, List<String> permissions) *

*

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

*
    - *
  • testIamPermissionsCallable() + *
  • testIamPermissionsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/TagValuesClient.java b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/TagValuesClient.java index 6ac8bdaca3e0..e13c3086c91d 100644 --- a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/TagValuesClient.java +++ b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/TagValuesClient.java @@ -67,185 +67,186 @@ * threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
ListTagValues

ListTagValues

Lists all TagValues for a specific TagKey.

*

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

*
    - *
  • listTagValues(ListTagValuesRequest request) + *
  • listTagValues(ListTagValuesRequest request) *

*

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

*
    - *
  • listTagValues(ResourceName parent) - *
  • listTagValues(String parent) + *
  • listTagValues(ResourceName parent) + *

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

*
    - *
  • listTagValuesPagedCallable() - *
  • listTagValuesCallable() + *
  • listTagValuesPagedCallable() + *

  • listTagValuesCallable() *

*
GetTagValue

GetTagValue

Retrieves a TagValue. This method will return `PERMISSION_DENIED` if the value does not exist or the user does not have permission to view it.

*

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

*
    - *
  • getTagValue(GetTagValueRequest request) + *
  • getTagValue(GetTagValueRequest request) *

*

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

*
    - *
  • getTagValue(TagValueName name) - *
  • getTagValue(String name) + *
  • getTagValue(TagValueName name) + *

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

*
    - *
  • getTagValueCallable() + *
  • getTagValueCallable() *

*
GetNamespacedTagValue

GetNamespacedTagValue

Retrieves a TagValue by its namespaced name. This method will return `PERMISSION_DENIED` if the value does not exist or the user does not have permission to view it.

*

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

*
    - *
  • getNamespacedTagValue(GetNamespacedTagValueRequest request) + *
  • getNamespacedTagValue(GetNamespacedTagValueRequest request) *

*

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

*
    - *
  • getNamespacedTagValue(TagValueName name) - *
  • getNamespacedTagValue(String name) + *
  • getNamespacedTagValue(TagValueName name) + *

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

*
    - *
  • getNamespacedTagValueCallable() + *
  • getNamespacedTagValueCallable() *

*
CreateTagValue

CreateTagValue

Creates a TagValue as a child of the specified TagKey. If a another request with the same parameters is sent while the original request is in process the second request will receive an error. A maximum of 1000 TagValues can exist under a TagKey at any given time.

*

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

*
    - *
  • createTagValueAsync(CreateTagValueRequest request) + *
  • createTagValueAsync(CreateTagValueRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createTagValueAsync(TagValue tagValue) + *
  • createTagValueAsync(TagValue tagValue) *

*

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

*
    - *
  • createTagValueOperationCallable() - *
  • createTagValueCallable() + *
  • createTagValueOperationCallable() + *

  • createTagValueCallable() *

*
UpdateTagValue

UpdateTagValue

Updates the attributes of the TagValue resource.

*

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

*
    - *
  • updateTagValueAsync(UpdateTagValueRequest request) + *
  • updateTagValueAsync(UpdateTagValueRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateTagValueAsync(TagValue tagValue, FieldMask updateMask) + *
  • updateTagValueAsync(TagValue tagValue, 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.

*
    - *
  • updateTagValueOperationCallable() - *
  • updateTagValueCallable() + *
  • updateTagValueOperationCallable() + *

  • updateTagValueCallable() *

*
DeleteTagValue

DeleteTagValue

Deletes a TagValue. The TagValue cannot have any bindings when it is deleted.

*

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

*
    - *
  • deleteTagValueAsync(DeleteTagValueRequest request) + *
  • deleteTagValueAsync(DeleteTagValueRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteTagValueAsync(TagValueName name) - *
  • deleteTagValueAsync(String name) + *
  • deleteTagValueAsync(TagValueName name) + *

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

*
    - *
  • deleteTagValueOperationCallable() - *
  • deleteTagValueCallable() + *
  • deleteTagValueOperationCallable() + *

  • deleteTagValueCallable() *

*
GetIamPolicy

GetIamPolicy

Gets the access control policy for a TagValue. The returned policy may be empty if no such policy or resource exists. The `resource` field should be the TagValue's resource name. For example: `tagValues/1234`. The caller must have the `cloudresourcemanager.googleapis.com/tagValues.getIamPolicy` permission on the identified TagValue to get the access control policy.

*

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

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *
  • getIamPolicy(GetIamPolicyRequest request) *

*

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

*
    - *
  • getIamPolicy(ResourceName resource) - *
  • getIamPolicy(String resource) + *
  • getIamPolicy(ResourceName resource) + *

  • getIamPolicy(String resource) *

*

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

*
    - *
  • getIamPolicyCallable() + *
  • getIamPolicyCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the access control policy on a TagValue, replacing any existing policy. The `resource` field should be the TagValue's resource name. For example: `tagValues/1234`. The caller must have `resourcemanager.tagValues.setIamPolicy` permission on the identified tagValue.

*

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

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *
  • setIamPolicy(SetIamPolicyRequest request) *

*

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

*
    - *
  • setIamPolicy(ResourceName resource, Policy policy) - *
  • setIamPolicy(String resource, Policy policy) + *
  • setIamPolicy(ResourceName resource, Policy policy) + *

  • setIamPolicy(String resource, Policy policy) *

*

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

*
    - *
  • setIamPolicyCallable() + *
  • setIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns permissions that a caller has on the specified TagValue. The `resource` field should be the TagValue's resource name. For example: `tagValues/1234`. *

There are no permissions required for making this API call.

*

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

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *
  • testIamPermissions(TestIamPermissionsRequest request) *

*

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

*
    - *
  • testIamPermissions(ResourceName resource, List permissions) - *
  • testIamPermissions(String resource, List permissions) + *
  • testIamPermissions(ResourceName resource, List<String> permissions) + *

  • testIamPermissions(String resource, List<String> permissions) *

*

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

*
    - *
  • testIamPermissionsCallable() + *
  • testIamPermissionsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/FoldersStubSettings.java b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/FoldersStubSettings.java index 48cd82a68720..2d120d1c7e02 100644 --- a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/FoldersStubSettings.java +++ b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/FoldersStubSettings.java @@ -361,6 +361,15 @@ public FoldersStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -629,7 +638,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -642,7 +650,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -942,6 +949,15 @@ public UnaryCallSettings.Builder setIamPolicySettin return testIamPermissionsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public FoldersStubSettings build() throws IOException { return new FoldersStubSettings(this); diff --git a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/OrganizationsStubSettings.java b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/OrganizationsStubSettings.java index 7d3a974f3e44..0881efa5b0b0 100644 --- a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/OrganizationsStubSettings.java +++ b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/OrganizationsStubSettings.java @@ -222,6 +222,15 @@ public OrganizationsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -431,7 +440,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -444,7 +452,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -526,6 +533,15 @@ public UnaryCallSettings.Builder setIamPolicySettin return testIamPermissionsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public OrganizationsStubSettings build() throws IOException { return new OrganizationsStubSettings(this); diff --git a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/ProjectsStubSettings.java b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/ProjectsStubSettings.java index 4d566761e0a7..c07f9d46c672 100644 --- a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/ProjectsStubSettings.java +++ b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/ProjectsStubSettings.java @@ -364,6 +364,15 @@ public ProjectsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -635,7 +644,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -648,7 +656,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -948,6 +955,15 @@ public UnaryCallSettings.Builder setIamPolicySettin return testIamPermissionsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public ProjectsStubSettings build() throws IOException { return new ProjectsStubSettings(this); diff --git a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/TagBindingsStubSettings.java b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/TagBindingsStubSettings.java index ca5ebbb7f0f0..f3a158ec1bb4 100644 --- a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/TagBindingsStubSettings.java +++ b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/TagBindingsStubSettings.java @@ -298,6 +298,15 @@ public TagBindingsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -512,7 +521,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -525,7 +533,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -662,6 +669,15 @@ public Builder applyToAllUnaryMethods( return listEffectiveTagsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public TagBindingsStubSettings build() throws IOException { return new TagBindingsStubSettings(this); diff --git a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/TagHoldsStubSettings.java b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/TagHoldsStubSettings.java index 6e56151f347d..59d5556bbfde 100644 --- a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/TagHoldsStubSettings.java +++ b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/TagHoldsStubSettings.java @@ -218,6 +218,15 @@ public TagHoldsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -391,7 +400,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -404,7 +412,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -526,6 +533,15 @@ public UnaryCallSettings.Builder deleteTagHoldS return listTagHoldsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public TagHoldsStubSettings build() throws IOException { return new TagHoldsStubSettings(this); diff --git a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/TagKeysStubSettings.java b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/TagKeysStubSettings.java index 37b9feead882..96255c6b03c3 100644 --- a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/TagKeysStubSettings.java +++ b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/TagKeysStubSettings.java @@ -271,6 +271,15 @@ public TagKeysStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -514,7 +523,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -527,7 +535,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -743,6 +750,15 @@ public UnaryCallSettings.Builder setIamPolicySettin return testIamPermissionsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public TagKeysStubSettings build() throws IOException { return new TagKeysStubSettings(this); diff --git a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/TagValuesStubSettings.java b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/TagValuesStubSettings.java index b9aaed673894..c08a0887ac86 100644 --- a/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/TagValuesStubSettings.java +++ b/java-resourcemanager/google-cloud-resourcemanager/src/main/java/com/google/cloud/resourcemanager/v3/stub/TagValuesStubSettings.java @@ -273,6 +273,15 @@ public TagValuesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -522,7 +531,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -535,7 +543,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -751,6 +758,15 @@ public UnaryCallSettings.Builder setIamPolicySettin return testIamPermissionsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public TagValuesStubSettings build() throws IOException { return new TagValuesStubSettings(this); diff --git a/java-run/README.md b/java-run/README.md index bf12be2adcea..20c58c44d801 100644 --- a/java-run/README.md +++ b/java-run/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-run.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-run/0.32.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-run/0.33.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/ExecutionsClient.java b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/ExecutionsClient.java index 5750c98c55ac..039ee75dc4ef 100644 --- a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/ExecutionsClient.java +++ b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/ExecutionsClient.java @@ -60,90 +60,91 @@ * threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
GetExecution

GetExecution

Gets information about an Execution.

*

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

*
    - *
  • getExecution(GetExecutionRequest request) + *
  • getExecution(GetExecutionRequest request) *

*

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

*
    - *
  • getExecution(ExecutionName name) - *
  • getExecution(String name) + *
  • getExecution(ExecutionName name) + *

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

*
    - *
  • getExecutionCallable() + *
  • getExecutionCallable() *

*
ListExecutions

ListExecutions

Lists Executions from a Job.

*

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

*
    - *
  • listExecutions(ListExecutionsRequest request) + *
  • listExecutions(ListExecutionsRequest request) *

*

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

*
    - *
  • listExecutions(JobName parent) - *
  • listExecutions(String parent) + *
  • listExecutions(JobName parent) + *

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

*
    - *
  • listExecutionsPagedCallable() - *
  • listExecutionsCallable() + *
  • listExecutionsPagedCallable() + *

  • listExecutionsCallable() *

*
DeleteExecution

DeleteExecution

Deletes an Execution.

*

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

*
    - *
  • deleteExecutionAsync(DeleteExecutionRequest request) + *
  • deleteExecutionAsync(DeleteExecutionRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteExecutionAsync(ExecutionName name) - *
  • deleteExecutionAsync(String name) + *
  • deleteExecutionAsync(ExecutionName name) + *

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

*
    - *
  • deleteExecutionOperationCallable() - *
  • deleteExecutionCallable() + *
  • deleteExecutionOperationCallable() + *

  • deleteExecutionCallable() *

*
CancelExecution

CancelExecution

Cancels an Execution.

*

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

*
    - *
  • cancelExecutionAsync(CancelExecutionRequest request) + *
  • cancelExecutionAsync(CancelExecutionRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • cancelExecutionAsync(ExecutionName name) - *
  • cancelExecutionAsync(String name) + *
  • cancelExecutionAsync(ExecutionName name) + *

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

*
    - *
  • cancelExecutionOperationCallable() - *
  • cancelExecutionCallable() + *
  • cancelExecutionOperationCallable() + *

  • cancelExecutionCallable() *

*
* *

See the individual methods for example code. diff --git a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/JobsClient.java b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/JobsClient.java index e3276753f5b4..b31e3bc3fe24 100644 --- a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/JobsClient.java +++ b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/JobsClient.java @@ -65,172 +65,173 @@ * threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
CreateJob

CreateJob

Creates a Job.

*

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

*
    - *
  • createJobAsync(CreateJobRequest request) + *
  • createJobAsync(CreateJobRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createJobAsync(LocationName parent, Job job, String jobId) - *
  • createJobAsync(String parent, Job job, String jobId) + *
  • createJobAsync(LocationName parent, Job job, String jobId) + *

  • createJobAsync(String parent, Job job, String jobId) *

*

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

*
    - *
  • createJobOperationCallable() - *
  • createJobCallable() + *
  • createJobOperationCallable() + *

  • createJobCallable() *

*
GetJob

GetJob

Gets information about a Job.

*

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

*
    - *
  • getJob(GetJobRequest request) + *
  • getJob(GetJobRequest request) *

*

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

*
    - *
  • getJob(JobName name) - *
  • getJob(String name) + *
  • getJob(JobName name) + *

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

*
    - *
  • getJobCallable() + *
  • getJobCallable() *

*
ListJobs

ListJobs

Lists Jobs.

*

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

*
    - *
  • listJobs(ListJobsRequest request) + *
  • listJobs(ListJobsRequest request) *

*

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

*
    - *
  • listJobs(LocationName parent) - *
  • listJobs(String parent) + *
  • listJobs(LocationName parent) + *

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

*
    - *
  • listJobsPagedCallable() - *
  • listJobsCallable() + *
  • listJobsPagedCallable() + *

  • listJobsCallable() *

*
UpdateJob

UpdateJob

Updates a Job.

*

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

*
    - *
  • updateJobAsync(UpdateJobRequest request) + *
  • updateJobAsync(UpdateJobRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateJobAsync(Job job) + *
  • updateJobAsync(Job job) *

*

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

*
    - *
  • updateJobOperationCallable() - *
  • updateJobCallable() + *
  • updateJobOperationCallable() + *

  • updateJobCallable() *

*
DeleteJob

DeleteJob

Deletes a Job.

*

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

*
    - *
  • deleteJobAsync(DeleteJobRequest request) + *
  • deleteJobAsync(DeleteJobRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteJobAsync(JobName name) - *
  • deleteJobAsync(String name) + *
  • deleteJobAsync(JobName name) + *

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

*
    - *
  • deleteJobOperationCallable() - *
  • deleteJobCallable() + *
  • deleteJobOperationCallable() + *

  • deleteJobCallable() *

*
RunJob

RunJob

Triggers creation of a new Execution of this Job.

*

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

*
    - *
  • runJobAsync(RunJobRequest request) + *
  • runJobAsync(RunJobRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • runJobAsync(JobName name) - *
  • runJobAsync(String name) + *
  • runJobAsync(JobName name) + *

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

*
    - *
  • runJobOperationCallable() - *
  • runJobCallable() + *
  • runJobOperationCallable() + *

  • runJobCallable() *

*
GetIamPolicy

GetIamPolicy

Gets the IAM Access Control policy currently in effect for the given Job. This result does not include any inherited policies.

*

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

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *
  • getIamPolicy(GetIamPolicyRequest request) *

*

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

*
    - *
  • getIamPolicyCallable() + *
  • getIamPolicyCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the IAM Access control policy for the specified Job. Overwrites any existing policy.

*

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

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *
  • setIamPolicy(SetIamPolicyRequest request) *

*

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

*
    - *
  • setIamPolicyCallable() + *
  • setIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns permissions that a caller has on the specified Project. *

There are no permissions required for making this API call.

*

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

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *
  • testIamPermissions(TestIamPermissionsRequest request) *

*

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

*
    - *
  • testIamPermissionsCallable() + *
  • testIamPermissionsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/RevisionsClient.java b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/RevisionsClient.java index 66a51fd65a1f..e986075d5f56 100644 --- a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/RevisionsClient.java +++ b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/RevisionsClient.java @@ -60,70 +60,71 @@ * threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
GetRevision

GetRevision

Gets information about a Revision.

*

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

*
    - *
  • getRevision(GetRevisionRequest request) + *
  • getRevision(GetRevisionRequest request) *

*

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

*
    - *
  • getRevision(RevisionName name) - *
  • getRevision(String name) + *
  • getRevision(RevisionName name) + *

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

*
    - *
  • getRevisionCallable() + *
  • getRevisionCallable() *

*
ListRevisions

ListRevisions

Lists Revisions from a given Service, or from a given location.

*

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

*
    - *
  • listRevisions(ListRevisionsRequest request) + *
  • listRevisions(ListRevisionsRequest request) *

*

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

*
    - *
  • listRevisions(ServiceName parent) - *
  • listRevisions(String parent) + *
  • listRevisions(ServiceName parent) + *

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

*
    - *
  • listRevisionsPagedCallable() - *
  • listRevisionsCallable() + *
  • listRevisionsPagedCallable() + *

  • listRevisionsCallable() *

*
DeleteRevision

DeleteRevision

Deletes a Revision.

*

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

*
    - *
  • deleteRevisionAsync(DeleteRevisionRequest request) + *
  • deleteRevisionAsync(DeleteRevisionRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteRevisionAsync(RevisionName name) - *
  • deleteRevisionAsync(String name) + *
  • deleteRevisionAsync(RevisionName name) + *

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

*
    - *
  • deleteRevisionOperationCallable() - *
  • deleteRevisionCallable() + *
  • deleteRevisionOperationCallable() + *

  • deleteRevisionCallable() *

*
* *

See the individual methods for example code. diff --git a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/ServicesClient.java b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/ServicesClient.java index b7dbf3ea53c0..8e7088c4a95e 100644 --- a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/ServicesClient.java +++ b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/ServicesClient.java @@ -65,152 +65,153 @@ * threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
CreateService

CreateService

Creates a new Service in a given project and location.

*

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

*
    - *
  • createServiceAsync(CreateServiceRequest request) + *
  • createServiceAsync(CreateServiceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createServiceAsync(LocationName parent, Service service, String serviceId) - *
  • createServiceAsync(String parent, Service service, String serviceId) + *
  • createServiceAsync(LocationName parent, Service service, String serviceId) + *

  • createServiceAsync(String parent, Service service, String serviceId) *

*

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

*
    - *
  • createServiceOperationCallable() - *
  • createServiceCallable() + *
  • createServiceOperationCallable() + *

  • createServiceCallable() *

*
GetService

GetService

Gets information about a Service.

*

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

*
    - *
  • getService(GetServiceRequest request) + *
  • getService(GetServiceRequest request) *

*

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

*
    - *
  • getService(ServiceName name) - *
  • getService(String name) + *
  • getService(ServiceName name) + *

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

*
    - *
  • getServiceCallable() + *
  • getServiceCallable() *

*
ListServices

ListServices

Lists Services.

*

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

*
    - *
  • listServices(ListServicesRequest request) + *
  • listServices(ListServicesRequest request) *

*

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

*
    - *
  • listServices(LocationName parent) - *
  • listServices(String parent) + *
  • listServices(LocationName parent) + *

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

*
    - *
  • listServicesPagedCallable() - *
  • listServicesCallable() + *
  • listServicesPagedCallable() + *

  • listServicesCallable() *

*
UpdateService

UpdateService

Updates a Service.

*

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

*
    - *
  • updateServiceAsync(UpdateServiceRequest request) + *
  • updateServiceAsync(UpdateServiceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateServiceAsync(Service service) + *
  • updateServiceAsync(Service service) *

*

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

*
    - *
  • updateServiceOperationCallable() - *
  • updateServiceCallable() + *
  • updateServiceOperationCallable() + *

  • updateServiceCallable() *

*
DeleteService

DeleteService

Deletes a Service. This will cause the Service to stop serving traffic and will delete all revisions.

*

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

*
    - *
  • deleteServiceAsync(DeleteServiceRequest request) + *
  • deleteServiceAsync(DeleteServiceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteServiceAsync(ServiceName name) - *
  • deleteServiceAsync(String name) + *
  • deleteServiceAsync(ServiceName name) + *

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

*
    - *
  • deleteServiceOperationCallable() - *
  • deleteServiceCallable() + *
  • deleteServiceOperationCallable() + *

  • deleteServiceCallable() *

*
GetIamPolicy

GetIamPolicy

Gets the IAM Access Control policy currently in effect for the given Cloud Run Service. This result does not include any inherited policies.

*

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

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *
  • getIamPolicy(GetIamPolicyRequest request) *

*

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

*
    - *
  • getIamPolicyCallable() + *
  • getIamPolicyCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the IAM Access control policy for the specified Service. Overwrites any existing policy.

*

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

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *
  • setIamPolicy(SetIamPolicyRequest request) *

*

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

*
    - *
  • setIamPolicyCallable() + *
  • setIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns permissions that a caller has on the specified Project. *

There are no permissions required for making this API call.

*

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

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *
  • testIamPermissions(TestIamPermissionsRequest request) *

*

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

*
    - *
  • testIamPermissionsCallable() + *
  • testIamPermissionsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/TasksClient.java b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/TasksClient.java index 5b709f9602d9..10ac51ccbfc5 100644 --- a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/TasksClient.java +++ b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/TasksClient.java @@ -55,50 +55,51 @@ * threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
GetTask

GetTask

Gets information about a Task.

*

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

*
    - *
  • getTask(GetTaskRequest request) + *
  • getTask(GetTaskRequest request) *

*

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

*
    - *
  • getTask(TaskName name) - *
  • getTask(String name) + *
  • getTask(TaskName name) + *

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

*
    - *
  • getTaskCallable() + *
  • getTaskCallable() *

*
ListTasks

ListTasks

Lists Tasks from an Execution of a Job.

*

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

*
    - *
  • listTasks(ListTasksRequest request) + *
  • listTasks(ListTasksRequest request) *

*

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

*
    - *
  • listTasks(ExecutionName parent) - *
  • listTasks(String parent) + *
  • listTasks(ExecutionName parent) + *

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

*
    - *
  • listTasksPagedCallable() - *
  • listTasksCallable() + *
  • listTasksPagedCallable() + *

  • listTasksCallable() *

*
* *

See the individual methods for example code. diff --git a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/ExecutionsStubSettings.java b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/ExecutionsStubSettings.java index 732c6bd8f919..3221e2258331 100644 --- a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/ExecutionsStubSettings.java +++ b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/ExecutionsStubSettings.java @@ -220,6 +220,15 @@ public ExecutionsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -406,7 +415,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -419,7 +427,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -551,6 +558,15 @@ public UnaryCallSettings.Builder cancelExecut return cancelExecutionOperationSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public ExecutionsStubSettings build() throws IOException { return new ExecutionsStubSettings(this); diff --git a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/JobsStubSettings.java b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/JobsStubSettings.java index 4c2ec642f213..c549e5812714 100644 --- a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/JobsStubSettings.java +++ b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/JobsStubSettings.java @@ -264,6 +264,15 @@ public JobsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -487,7 +496,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -500,7 +508,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -733,6 +740,15 @@ public UnaryCallSettings.Builder setIamPolicySettin return testIamPermissionsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public JobsStubSettings build() throws IOException { return new JobsStubSettings(this); diff --git a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/RevisionsStubSettings.java b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/RevisionsStubSettings.java index 09fd32abdb3c..4c4d5867583b 100644 --- a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/RevisionsStubSettings.java +++ b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/RevisionsStubSettings.java @@ -203,6 +203,15 @@ public RevisionsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -371,7 +380,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -384,7 +392,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -474,6 +481,15 @@ public UnaryCallSettings.Builder deleteRevisio return deleteRevisionOperationSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public RevisionsStubSettings build() throws IOException { return new RevisionsStubSettings(this); diff --git a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/ServicesStubSettings.java b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/ServicesStubSettings.java index 5af6b0022a04..ebb601ba56a9 100644 --- a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/ServicesStubSettings.java +++ b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/ServicesStubSettings.java @@ -258,6 +258,15 @@ public ServicesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -504,7 +513,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -517,7 +525,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -722,6 +729,15 @@ public UnaryCallSettings.Builder setIamPolicySettin return testIamPermissionsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public ServicesStubSettings build() throws IOException { return new ServicesStubSettings(this); diff --git a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/TasksStubSettings.java b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/TasksStubSettings.java index faa53e06dcc3..7e4c5c0e2b25 100644 --- a/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/TasksStubSettings.java +++ b/java-run/google-cloud-run/src/main/java/com/google/cloud/run/v2/stub/TasksStubSettings.java @@ -181,6 +181,15 @@ public TasksStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -337,7 +346,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -350,7 +358,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -397,6 +404,15 @@ public UnaryCallSettings.Builder getTaskSettings() { return listTasksSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public TasksStubSettings build() throws IOException { return new TasksStubSettings(this); diff --git a/java-scheduler/README.md b/java-scheduler/README.md index d87b635599ee..5432d2b9eed6 100644 --- a/java-scheduler/README.md +++ b/java-scheduler/README.md @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-scheduler.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-scheduler/2.32.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-scheduler/2.33.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-scheduler/google-cloud-scheduler/src/main/java/com/google/cloud/scheduler/v1/CloudSchedulerClient.java b/java-scheduler/google-cloud-scheduler/src/main/java/com/google/cloud/scheduler/v1/CloudSchedulerClient.java index 46fc9e51e77f..87c94441251c 100644 --- a/java-scheduler/google-cloud-scheduler/src/main/java/com/google/cloud/scheduler/v1/CloudSchedulerClient.java +++ b/java-scheduler/google-cloud-scheduler/src/main/java/com/google/cloud/scheduler/v1/CloudSchedulerClient.java @@ -62,197 +62,198 @@ * as threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
ListJobs

ListJobs

Lists jobs.

*

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

*
    - *
  • listJobs(ListJobsRequest request) + *
  • listJobs(ListJobsRequest request) *

*

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

*
    - *
  • listJobs(LocationName parent) - *
  • listJobs(String parent) + *
  • listJobs(LocationName parent) + *

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

*
    - *
  • listJobsPagedCallable() - *
  • listJobsCallable() + *
  • listJobsPagedCallable() + *

  • listJobsCallable() *

*
GetJob

GetJob

Gets a job.

*

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

*
    - *
  • getJob(GetJobRequest request) + *
  • getJob(GetJobRequest request) *

*

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

*
    - *
  • getJob(JobName name) - *
  • getJob(String name) + *
  • getJob(JobName name) + *

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

*
    - *
  • getJobCallable() + *
  • getJobCallable() *

*
CreateJob

CreateJob

Creates a job.

*

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

*
    - *
  • createJob(CreateJobRequest request) + *
  • createJob(CreateJobRequest request) *

*

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

*
    - *
  • createJob(LocationName parent, Job job) - *
  • createJob(String parent, Job job) + *
  • createJob(LocationName parent, Job job) + *

  • createJob(String parent, Job job) *

*

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

*
    - *
  • createJobCallable() + *
  • createJobCallable() *

*
UpdateJob

UpdateJob

Updates a job. *

If successful, the updated [Job][google.cloud.scheduler.v1.Job] is returned. If the job does not exist, `NOT_FOUND` is returned. *

If UpdateJob does not successfully return, it is possible for the job to be in an [Job.State.UPDATE_FAILED][google.cloud.scheduler.v1.Job.State.UPDATE_FAILED] state. A job in this state may not be executed. If this happens, retry the UpdateJob request until a successful response is received.

*

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

*
    - *
  • updateJob(UpdateJobRequest request) + *
  • updateJob(UpdateJobRequest request) *

*

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

*
    - *
  • updateJob(Job job, FieldMask updateMask) + *
  • updateJob(Job job, 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.

*
    - *
  • updateJobCallable() + *
  • updateJobCallable() *

*
DeleteJob

DeleteJob

Deletes a job.

*

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

*
    - *
  • deleteJob(DeleteJobRequest request) + *
  • deleteJob(DeleteJobRequest request) *

*

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

*
    - *
  • deleteJob(JobName name) - *
  • deleteJob(String name) + *
  • deleteJob(JobName name) + *

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

*
    - *
  • deleteJobCallable() + *
  • deleteJobCallable() *

*
PauseJob

PauseJob

Pauses a job. *

If a job is paused then the system will stop executing the job until it is re-enabled via [ResumeJob][google.cloud.scheduler.v1.CloudScheduler.ResumeJob]. The state of the job is stored in [state][google.cloud.scheduler.v1.Job.state]; if paused it will be set to [Job.State.PAUSED][google.cloud.scheduler.v1.Job.State.PAUSED]. A job must be in [Job.State.ENABLED][google.cloud.scheduler.v1.Job.State.ENABLED] to be paused.

*

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

*
    - *
  • pauseJob(PauseJobRequest request) + *
  • pauseJob(PauseJobRequest request) *

*

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

*
    - *
  • pauseJob(JobName name) - *
  • pauseJob(String name) + *
  • pauseJob(JobName name) + *

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

*
    - *
  • pauseJobCallable() + *
  • pauseJobCallable() *

*
ResumeJob

ResumeJob

Resume a job. *

This method reenables a job after it has been [Job.State.PAUSED][google.cloud.scheduler.v1.Job.State.PAUSED]. The state of a job is stored in [Job.state][google.cloud.scheduler.v1.Job.state]; after calling this method it will be set to [Job.State.ENABLED][google.cloud.scheduler.v1.Job.State.ENABLED]. A job must be in [Job.State.PAUSED][google.cloud.scheduler.v1.Job.State.PAUSED] to be resumed.

*

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

*
    - *
  • resumeJob(ResumeJobRequest request) + *
  • resumeJob(ResumeJobRequest request) *

*

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

*
    - *
  • resumeJob(JobName name) - *
  • resumeJob(String name) + *
  • resumeJob(JobName name) + *

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

*
    - *
  • resumeJobCallable() + *
  • resumeJobCallable() *

*
RunJob

RunJob

Forces a job to run now. *

When this method is called, Cloud Scheduler will dispatch the job, even if the job is already running.

*

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

*
    - *
  • runJob(RunJobRequest request) + *
  • runJob(RunJobRequest request) *

*

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

*
    - *
  • runJob(JobName name) - *
  • runJob(String name) + *
  • runJob(JobName name) + *

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

*
    - *
  • runJobCallable() + *
  • runJobCallable() *

*
ListLocations

ListLocations

Lists information about the supported locations for this service.

*

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

*
    - *
  • listLocations(ListLocationsRequest request) + *
  • listLocations(ListLocationsRequest request) *

*

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

*
    - *
  • listLocationsPagedCallable() - *
  • listLocationsCallable() + *
  • listLocationsPagedCallable() + *

  • listLocationsCallable() *

*
GetLocation

GetLocation

Gets information about a location.

*

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

*
    - *
  • getLocation(GetLocationRequest request) + *
  • getLocation(GetLocationRequest request) *

*

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

*
    - *
  • getLocationCallable() + *
  • getLocationCallable() *

*
* *

See the individual methods for example code. diff --git a/java-scheduler/google-cloud-scheduler/src/main/java/com/google/cloud/scheduler/v1/stub/CloudSchedulerStubSettings.java b/java-scheduler/google-cloud-scheduler/src/main/java/com/google/cloud/scheduler/v1/stub/CloudSchedulerStubSettings.java index 984d3174280b..3454695d1778 100644 --- a/java-scheduler/google-cloud-scheduler/src/main/java/com/google/cloud/scheduler/v1/stub/CloudSchedulerStubSettings.java +++ b/java-scheduler/google-cloud-scheduler/src/main/java/com/google/cloud/scheduler/v1/stub/CloudSchedulerStubSettings.java @@ -299,6 +299,15 @@ public CloudSchedulerStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -537,7 +546,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -550,7 +558,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -679,6 +686,15 @@ public UnaryCallSettings.Builder getLocationSettin return getLocationSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public CloudSchedulerStubSettings build() throws IOException { return new CloudSchedulerStubSettings(this); diff --git a/java-scheduler/google-cloud-scheduler/src/main/java/com/google/cloud/scheduler/v1beta1/CloudSchedulerClient.java b/java-scheduler/google-cloud-scheduler/src/main/java/com/google/cloud/scheduler/v1beta1/CloudSchedulerClient.java index 1ebff4cf3f56..71241958f1fe 100644 --- a/java-scheduler/google-cloud-scheduler/src/main/java/com/google/cloud/scheduler/v1beta1/CloudSchedulerClient.java +++ b/java-scheduler/google-cloud-scheduler/src/main/java/com/google/cloud/scheduler/v1beta1/CloudSchedulerClient.java @@ -63,197 +63,198 @@ * as threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
ListJobs

ListJobs

Lists jobs.

*

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

*
    - *
  • listJobs(ListJobsRequest request) + *
  • listJobs(ListJobsRequest request) *

*

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

*
    - *
  • listJobs(LocationName parent) - *
  • listJobs(String parent) + *
  • listJobs(LocationName parent) + *

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

*
    - *
  • listJobsPagedCallable() - *
  • listJobsCallable() + *
  • listJobsPagedCallable() + *

  • listJobsCallable() *

*
GetJob

GetJob

Gets a job.

*

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

*
    - *
  • getJob(GetJobRequest request) + *
  • getJob(GetJobRequest request) *

*

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

*
    - *
  • getJob(JobName name) - *
  • getJob(String name) + *
  • getJob(JobName name) + *

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

*
    - *
  • getJobCallable() + *
  • getJobCallable() *

*
CreateJob

CreateJob

Creates a job.

*

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

*
    - *
  • createJob(CreateJobRequest request) + *
  • createJob(CreateJobRequest request) *

*

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

*
    - *
  • createJob(LocationName parent, Job job) - *
  • createJob(String parent, Job job) + *
  • createJob(LocationName parent, Job job) + *

  • createJob(String parent, Job job) *

*

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

*
    - *
  • createJobCallable() + *
  • createJobCallable() *

*
UpdateJob

UpdateJob

Updates a job. *

If successful, the updated [Job][google.cloud.scheduler.v1beta1.Job] is returned. If the job does not exist, `NOT_FOUND` is returned. *

If UpdateJob does not successfully return, it is possible for the job to be in an [Job.State.UPDATE_FAILED][google.cloud.scheduler.v1beta1.Job.State.UPDATE_FAILED] state. A job in this state may not be executed. If this happens, retry the UpdateJob request until a successful response is received.

*

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

*
    - *
  • updateJob(UpdateJobRequest request) + *
  • updateJob(UpdateJobRequest request) *

*

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

*
    - *
  • updateJob(Job job, FieldMask updateMask) + *
  • updateJob(Job job, 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.

*
    - *
  • updateJobCallable() + *
  • updateJobCallable() *

*
DeleteJob

DeleteJob

Deletes a job.

*

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

*
    - *
  • deleteJob(DeleteJobRequest request) + *
  • deleteJob(DeleteJobRequest request) *

*

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

*
    - *
  • deleteJob(JobName name) - *
  • deleteJob(String name) + *
  • deleteJob(JobName name) + *

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

*
    - *
  • deleteJobCallable() + *
  • deleteJobCallable() *

*
PauseJob

PauseJob

Pauses a job. *

If a job is paused then the system will stop executing the job until it is re-enabled via [ResumeJob][google.cloud.scheduler.v1beta1.CloudScheduler.ResumeJob]. The state of the job is stored in [state][google.cloud.scheduler.v1beta1.Job.state]; if paused it will be set to [Job.State.PAUSED][google.cloud.scheduler.v1beta1.Job.State.PAUSED]. A job must be in [Job.State.ENABLED][google.cloud.scheduler.v1beta1.Job.State.ENABLED] to be paused.

*

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

*
    - *
  • pauseJob(PauseJobRequest request) + *
  • pauseJob(PauseJobRequest request) *

*

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

*
    - *
  • pauseJob(JobName name) - *
  • pauseJob(String name) + *
  • pauseJob(JobName name) + *

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

*
    - *
  • pauseJobCallable() + *
  • pauseJobCallable() *

*
ResumeJob

ResumeJob

Resume a job. *

This method reenables a job after it has been [Job.State.PAUSED][google.cloud.scheduler.v1beta1.Job.State.PAUSED]. The state of a job is stored in [Job.state][google.cloud.scheduler.v1beta1.Job.state]; after calling this method it will be set to [Job.State.ENABLED][google.cloud.scheduler.v1beta1.Job.State.ENABLED]. A job must be in [Job.State.PAUSED][google.cloud.scheduler.v1beta1.Job.State.PAUSED] to be resumed.

*

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

*
    - *
  • resumeJob(ResumeJobRequest request) + *
  • resumeJob(ResumeJobRequest request) *

*

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

*
    - *
  • resumeJob(JobName name) - *
  • resumeJob(String name) + *
  • resumeJob(JobName name) + *

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

*
    - *
  • resumeJobCallable() + *
  • resumeJobCallable() *

*
RunJob

RunJob

Forces a job to run now. *

When this method is called, Cloud Scheduler will dispatch the job, even if the job is already running.

*

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

*
    - *
  • runJob(RunJobRequest request) + *
  • runJob(RunJobRequest request) *

*

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

*
    - *
  • runJob(JobName name) - *
  • runJob(String name) + *
  • runJob(JobName name) + *

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

*
    - *
  • runJobCallable() + *
  • runJobCallable() *

*
ListLocations

ListLocations

Lists information about the supported locations for this service.

*

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

*
    - *
  • listLocations(ListLocationsRequest request) + *
  • listLocations(ListLocationsRequest request) *

*

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

*
    - *
  • listLocationsPagedCallable() - *
  • listLocationsCallable() + *
  • listLocationsPagedCallable() + *

  • listLocationsCallable() *

*
GetLocation

GetLocation

Gets information about a location.

*

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

*
    - *
  • getLocation(GetLocationRequest request) + *
  • getLocation(GetLocationRequest request) *

*

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

*
    - *
  • getLocationCallable() + *
  • getLocationCallable() *

*
* *

See the individual methods for example code. diff --git a/java-scheduler/google-cloud-scheduler/src/main/java/com/google/cloud/scheduler/v1beta1/stub/CloudSchedulerStubSettings.java b/java-scheduler/google-cloud-scheduler/src/main/java/com/google/cloud/scheduler/v1beta1/stub/CloudSchedulerStubSettings.java index a07f6a233053..823d9af27c20 100644 --- a/java-scheduler/google-cloud-scheduler/src/main/java/com/google/cloud/scheduler/v1beta1/stub/CloudSchedulerStubSettings.java +++ b/java-scheduler/google-cloud-scheduler/src/main/java/com/google/cloud/scheduler/v1beta1/stub/CloudSchedulerStubSettings.java @@ -300,6 +300,15 @@ public CloudSchedulerStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -538,7 +547,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -551,7 +559,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -680,6 +687,15 @@ public UnaryCallSettings.Builder getLocationSettin return getLocationSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public CloudSchedulerStubSettings build() throws IOException { return new CloudSchedulerStubSettings(this); diff --git a/java-secretmanager/README.md b/java-secretmanager/README.md index e3c19c84eda2..322fe1e20e33 100644 --- a/java-secretmanager/README.md +++ b/java-secretmanager/README.md @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-secretmanager.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-secretmanager/2.32.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-secretmanager/2.33.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-secretmanager/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/SecretManagerServiceClient.java b/java-secretmanager/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/SecretManagerServiceClient.java index e5e6f2eb4156..9ebe37dfb95d 100644 --- a/java-secretmanager/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/SecretManagerServiceClient.java +++ b/java-secretmanager/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/SecretManagerServiceClient.java @@ -74,289 +74,290 @@ * calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
ListSecrets

ListSecrets

Lists [Secrets][google.cloud.secretmanager.v1.Secret].

*

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

*
    - *
  • listSecrets(ListSecretsRequest request) + *
  • listSecrets(ListSecretsRequest request) *

*

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

*
    - *
  • listSecrets(ProjectName parent) - *
  • listSecrets(String parent) + *
  • listSecrets(ProjectName parent) + *

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

*
    - *
  • listSecretsPagedCallable() - *
  • listSecretsCallable() + *
  • listSecretsPagedCallable() + *

  • listSecretsCallable() *

*
CreateSecret

CreateSecret

Creates a new [Secret][google.cloud.secretmanager.v1.Secret] containing no [SecretVersions][google.cloud.secretmanager.v1.SecretVersion].

*

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

*
    - *
  • createSecret(CreateSecretRequest request) + *
  • createSecret(CreateSecretRequest request) *

*

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

*
    - *
  • createSecret(ProjectName parent, String secretId, Secret secret) - *
  • createSecret(String parent, String secretId, Secret secret) + *
  • createSecret(ProjectName parent, String secretId, Secret secret) + *

  • createSecret(String parent, String secretId, Secret secret) *

*

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

*
    - *
  • createSecretCallable() + *
  • createSecretCallable() *

*
AddSecretVersion

AddSecretVersion

Creates a new [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] containing secret data and attaches it to an existing [Secret][google.cloud.secretmanager.v1.Secret].

*

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

*
    - *
  • addSecretVersion(AddSecretVersionRequest request) + *
  • addSecretVersion(AddSecretVersionRequest request) *

*

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

*
    - *
  • addSecretVersion(SecretName parent, SecretPayload payload) - *
  • addSecretVersion(String parent, SecretPayload payload) + *
  • addSecretVersion(SecretName parent, SecretPayload payload) + *

  • addSecretVersion(String parent, SecretPayload payload) *

*

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

*
    - *
  • addSecretVersionCallable() + *
  • addSecretVersionCallable() *

*
GetSecret

GetSecret

Gets metadata for a given [Secret][google.cloud.secretmanager.v1.Secret].

*

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

*
    - *
  • getSecret(GetSecretRequest request) + *
  • getSecret(GetSecretRequest request) *

*

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

*
    - *
  • getSecret(SecretName name) - *
  • getSecret(String name) + *
  • getSecret(SecretName name) + *

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

*
    - *
  • getSecretCallable() + *
  • getSecretCallable() *

*
UpdateSecret

UpdateSecret

Updates metadata of an existing [Secret][google.cloud.secretmanager.v1.Secret].

*

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

*
    - *
  • updateSecret(UpdateSecretRequest request) + *
  • updateSecret(UpdateSecretRequest request) *

*

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

*
    - *
  • updateSecret(Secret secret, FieldMask updateMask) + *
  • updateSecret(Secret secret, 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.

*
    - *
  • updateSecretCallable() + *
  • updateSecretCallable() *

*
DeleteSecret

DeleteSecret

Deletes a [Secret][google.cloud.secretmanager.v1.Secret].

*

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

*
    - *
  • deleteSecret(DeleteSecretRequest request) + *
  • deleteSecret(DeleteSecretRequest request) *

*

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

*
    - *
  • deleteSecret(SecretName name) - *
  • deleteSecret(String name) + *
  • deleteSecret(SecretName name) + *

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

*
    - *
  • deleteSecretCallable() + *
  • deleteSecretCallable() *

*
ListSecretVersions

ListSecretVersions

Lists [SecretVersions][google.cloud.secretmanager.v1.SecretVersion]. This call does not return secret data.

*

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

*
    - *
  • listSecretVersions(ListSecretVersionsRequest request) + *
  • listSecretVersions(ListSecretVersionsRequest request) *

*

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

*
    - *
  • listSecretVersions(SecretName parent) - *
  • listSecretVersions(String parent) + *
  • listSecretVersions(SecretName parent) + *

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

*
    - *
  • listSecretVersionsPagedCallable() - *
  • listSecretVersionsCallable() + *
  • listSecretVersionsPagedCallable() + *

  • listSecretVersionsCallable() *

*
GetSecretVersion

GetSecretVersion

Gets metadata for a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]. *

`projects/*/secrets/*/versions/latest` is an alias to the most recently created [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].

*

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

*
    - *
  • getSecretVersion(GetSecretVersionRequest request) + *
  • getSecretVersion(GetSecretVersionRequest request) *

*

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

*
    - *
  • getSecretVersion(SecretVersionName name) - *
  • getSecretVersion(String name) + *
  • getSecretVersion(SecretVersionName name) + *

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

*
    - *
  • getSecretVersionCallable() + *
  • getSecretVersionCallable() *

*
AccessSecretVersion

AccessSecretVersion

Accesses a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]. This call returns the secret data. *

`projects/*/secrets/*/versions/latest` is an alias to the most recently created [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].

*

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

*
    - *
  • accessSecretVersion(AccessSecretVersionRequest request) + *
  • accessSecretVersion(AccessSecretVersionRequest request) *

*

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

*
    - *
  • accessSecretVersion(SecretVersionName name) - *
  • accessSecretVersion(String name) + *
  • accessSecretVersion(SecretVersionName name) + *

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

*
    - *
  • accessSecretVersionCallable() + *
  • accessSecretVersionCallable() *

*
DisableSecretVersion

DisableSecretVersion

Disables a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]. *

Sets the [state][google.cloud.secretmanager.v1.SecretVersion.state] of the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to [DISABLED][google.cloud.secretmanager.v1.SecretVersion.State.DISABLED].

*

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

*
    - *
  • disableSecretVersion(DisableSecretVersionRequest request) + *
  • disableSecretVersion(DisableSecretVersionRequest request) *

*

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

*
    - *
  • disableSecretVersion(SecretVersionName name) - *
  • disableSecretVersion(String name) + *
  • disableSecretVersion(SecretVersionName name) + *

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

*
    - *
  • disableSecretVersionCallable() + *
  • disableSecretVersionCallable() *

*
EnableSecretVersion

EnableSecretVersion

Enables a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]. *

Sets the [state][google.cloud.secretmanager.v1.SecretVersion.state] of the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to [ENABLED][google.cloud.secretmanager.v1.SecretVersion.State.ENABLED].

*

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

*
    - *
  • enableSecretVersion(EnableSecretVersionRequest request) + *
  • enableSecretVersion(EnableSecretVersionRequest request) *

*

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

*
    - *
  • enableSecretVersion(SecretVersionName name) - *
  • enableSecretVersion(String name) + *
  • enableSecretVersion(SecretVersionName name) + *

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

*
    - *
  • enableSecretVersionCallable() + *
  • enableSecretVersionCallable() *

*
DestroySecretVersion

DestroySecretVersion

Destroys a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]. *

Sets the [state][google.cloud.secretmanager.v1.SecretVersion.state] of the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to [DESTROYED][google.cloud.secretmanager.v1.SecretVersion.State.DESTROYED] and irrevocably destroys the secret data.

*

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

*
    - *
  • destroySecretVersion(DestroySecretVersionRequest request) + *
  • destroySecretVersion(DestroySecretVersionRequest request) *

*

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

*
    - *
  • destroySecretVersion(SecretVersionName name) - *
  • destroySecretVersion(String name) + *
  • destroySecretVersion(SecretVersionName name) + *

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

*
    - *
  • destroySecretVersionCallable() + *
  • destroySecretVersionCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the access control policy on the specified secret. Replaces any existing policy. *

Permissions on [SecretVersions][google.cloud.secretmanager.v1.SecretVersion] are enforced according to the policy set on the associated [Secret][google.cloud.secretmanager.v1.Secret].

*

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

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *
  • setIamPolicy(SetIamPolicyRequest request) *

*

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

*
    - *
  • setIamPolicyCallable() + *
  • setIamPolicyCallable() *

*
GetIamPolicy

GetIamPolicy

Gets the access control policy for a secret. Returns empty policy if the secret exists and does not have a policy set.

*

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

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *
  • getIamPolicy(GetIamPolicyRequest request) *

*

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

*
    - *
  • getIamPolicyCallable() + *
  • getIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns permissions that a caller has for the specified secret. If the secret does not exist, this call returns an empty set of permissions, not a NOT_FOUND error. *

Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.

*

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

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *
  • testIamPermissions(TestIamPermissionsRequest request) *

*

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

*
    - *
  • testIamPermissionsCallable() + *
  • testIamPermissionsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-secretmanager/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/stub/SecretManagerServiceStubSettings.java b/java-secretmanager/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/stub/SecretManagerServiceStubSettings.java index 7158c557a735..0a436db182a6 100644 --- a/java-secretmanager/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/stub/SecretManagerServiceStubSettings.java +++ b/java-secretmanager/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/stub/SecretManagerServiceStubSettings.java @@ -358,6 +358,15 @@ public SecretManagerServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -631,7 +640,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -644,7 +652,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -831,6 +838,15 @@ public UnaryCallSettings.Builder getIamPolicySettin return testIamPermissionsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public SecretManagerServiceStubSettings build() throws IOException { return new SecretManagerServiceStubSettings(this); diff --git a/java-securesourcemanager/README.md b/java-securesourcemanager/README.md index 2384e09c5015..103c4b4d0b57 100644 --- a/java-securesourcemanager/README.md +++ b/java-securesourcemanager/README.md @@ -202,7 +202,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-securesourcemanager/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-securesourcemanager.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-securesourcemanager/0.2.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-securesourcemanager/0.3.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-securesourcemanager/google-cloud-securesourcemanager/src/main/java/com/google/cloud/securesourcemanager/v1/SecureSourceManagerClient.java b/java-securesourcemanager/google-cloud-securesourcemanager/src/main/java/com/google/cloud/securesourcemanager/v1/SecureSourceManagerClient.java index ce4e1bc76f1b..a5394f52c157 100644 --- a/java-securesourcemanager/google-cloud-securesourcemanager/src/main/java/com/google/cloud/securesourcemanager/v1/SecureSourceManagerClient.java +++ b/java-securesourcemanager/google-cloud-securesourcemanager/src/main/java/com/google/cloud/securesourcemanager/v1/SecureSourceManagerClient.java @@ -91,303 +91,304 @@ * close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
ListInstances

ListInstances

Lists Instances in a given project and location.

*

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

*
    - *
  • listInstances(ListInstancesRequest request) + *
  • listInstances(ListInstancesRequest request) *

*

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

*
    - *
  • listInstances(LocationName parent) - *
  • listInstances(String parent) + *
  • listInstances(LocationName parent) + *

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

*
    - *
  • listInstancesPagedCallable() - *
  • listInstancesCallable() + *
  • listInstancesPagedCallable() + *

  • listInstancesCallable() *

*
GetInstance

GetInstance

Gets details of a single instance.

*

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

*
    - *
  • getInstance(GetInstanceRequest request) + *
  • getInstance(GetInstanceRequest request) *

*

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

*
    - *
  • getInstance(InstanceName name) - *
  • getInstance(String name) + *
  • getInstance(InstanceName name) + *

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

*
    - *
  • getInstanceCallable() + *
  • getInstanceCallable() *

*
CreateInstance

CreateInstance

Creates a new instance in a given project and location.

*

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

*
    - *
  • createInstanceAsync(CreateInstanceRequest request) + *
  • createInstanceAsync(CreateInstanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createInstanceAsync(LocationName parent, Instance instance, String instanceId) - *
  • createInstanceAsync(String parent, Instance instance, String instanceId) + *
  • createInstanceAsync(LocationName parent, Instance instance, String instanceId) + *

  • createInstanceAsync(String parent, Instance instance, String instanceId) *

*

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

*
    - *
  • createInstanceOperationCallable() - *
  • createInstanceCallable() + *
  • createInstanceOperationCallable() + *

  • createInstanceCallable() *

*
DeleteInstance

DeleteInstance

Deletes a single instance.

*

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

*
    - *
  • deleteInstanceAsync(DeleteInstanceRequest request) + *
  • deleteInstanceAsync(DeleteInstanceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteInstanceAsync(InstanceName name) - *
  • deleteInstanceAsync(String name) + *
  • deleteInstanceAsync(InstanceName name) + *

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

*
    - *
  • deleteInstanceOperationCallable() - *
  • deleteInstanceCallable() + *
  • deleteInstanceOperationCallable() + *

  • deleteInstanceCallable() *

*
ListRepositories

ListRepositories

Lists Repositories in a given project and location. *

**Host: Data Plane**

*

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

*
    - *
  • listRepositories(ListRepositoriesRequest request) + *
  • listRepositories(ListRepositoriesRequest request) *

*

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

*
    - *
  • listRepositories(LocationName parent) - *
  • listRepositories(String parent) + *
  • listRepositories(LocationName parent) + *

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

*
    - *
  • listRepositoriesPagedCallable() - *
  • listRepositoriesCallable() + *
  • listRepositoriesPagedCallable() + *

  • listRepositoriesCallable() *

*
GetRepository

GetRepository

Gets metadata of a repository. *

**Host: Data Plane**

*

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

*
    - *
  • getRepository(GetRepositoryRequest request) + *
  • getRepository(GetRepositoryRequest request) *

*

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

*
    - *
  • getRepository(RepositoryName name) - *
  • getRepository(String name) + *
  • getRepository(RepositoryName name) + *

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

*
    - *
  • getRepositoryCallable() + *
  • getRepositoryCallable() *

*
CreateRepository

CreateRepository

Creates a new repository in a given project and location. *

**Host: Data Plane**

*

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

*
    - *
  • createRepositoryAsync(CreateRepositoryRequest request) + *
  • createRepositoryAsync(CreateRepositoryRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createRepositoryAsync(LocationName parent, Repository repository, String repositoryId) - *
  • createRepositoryAsync(String parent, Repository repository, String repositoryId) + *
  • createRepositoryAsync(LocationName parent, Repository repository, String repositoryId) + *

  • createRepositoryAsync(String parent, Repository repository, String repositoryId) *

*

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

*
    - *
  • createRepositoryOperationCallable() - *
  • createRepositoryCallable() + *
  • createRepositoryOperationCallable() + *

  • createRepositoryCallable() *

*
DeleteRepository

DeleteRepository

Deletes a Repository. *

**Host: Data Plane**

*

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

*
    - *
  • deleteRepositoryAsync(DeleteRepositoryRequest request) + *
  • deleteRepositoryAsync(DeleteRepositoryRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteRepositoryAsync(RepositoryName name) - *
  • deleteRepositoryAsync(String name) + *
  • deleteRepositoryAsync(RepositoryName name) + *

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

*
    - *
  • deleteRepositoryOperationCallable() - *
  • deleteRepositoryCallable() + *
  • deleteRepositoryOperationCallable() + *

  • deleteRepositoryCallable() *

*
GetIamPolicyRepo

GetIamPolicyRepo

Get IAM policy for a repository.

*

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

*
    - *
  • getIamPolicyRepo(GetIamPolicyRequest request) + *
  • getIamPolicyRepo(GetIamPolicyRequest request) *

*

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

*
    - *
  • getIamPolicyRepo(ResourceName resource) - *
  • getIamPolicyRepo(String resource) + *
  • getIamPolicyRepo(ResourceName resource) + *

  • getIamPolicyRepo(String resource) *

*

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

*
    - *
  • getIamPolicyRepoCallable() + *
  • getIamPolicyRepoCallable() *

*
SetIamPolicyRepo

SetIamPolicyRepo

Set IAM policy on a repository.

*

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

*
    - *
  • setIamPolicyRepo(SetIamPolicyRequest request) + *
  • setIamPolicyRepo(SetIamPolicyRequest request) *

*

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

*
    - *
  • setIamPolicyRepo(ResourceName resource) - *
  • setIamPolicyRepo(String resource) + *
  • setIamPolicyRepo(ResourceName resource) + *

  • setIamPolicyRepo(String resource) *

*

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

*
    - *
  • setIamPolicyRepoCallable() + *
  • setIamPolicyRepoCallable() *

*
TestIamPermissionsRepo

TestIamPermissionsRepo

Test IAM permissions on a repository. IAM permission checks are not required on this method.

*

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

*
    - *
  • testIamPermissionsRepo(TestIamPermissionsRequest request) + *
  • testIamPermissionsRepo(TestIamPermissionsRequest request) *

*

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

*
    - *
  • testIamPermissionsRepo(ResourceName resource) - *
  • testIamPermissionsRepo(String resource) + *
  • testIamPermissionsRepo(ResourceName resource) + *

  • testIamPermissionsRepo(String resource) *

*

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

*
    - *
  • testIamPermissionsRepoCallable() + *
  • testIamPermissionsRepoCallable() *

*
ListLocations

ListLocations

Lists information about the supported locations for this service.

*

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

*
    - *
  • listLocations(ListLocationsRequest request) + *
  • listLocations(ListLocationsRequest request) *

*

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

*
    - *
  • listLocationsPagedCallable() - *
  • listLocationsCallable() + *
  • listLocationsPagedCallable() + *

  • listLocationsCallable() *

*
GetLocation

GetLocation

Gets information about a location.

*

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

*
    - *
  • getLocation(GetLocationRequest request) + *
  • getLocation(GetLocationRequest request) *

*

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

*
    - *
  • getLocationCallable() + *
  • getLocationCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the access control policy on the specified resource. Replacesany existing policy. *

Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.

*

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

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *
  • setIamPolicy(SetIamPolicyRequest request) *

*

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

*
    - *
  • setIamPolicyCallable() + *
  • setIamPolicyCallable() *

*
GetIamPolicy

GetIamPolicy

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

*

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

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *
  • getIamPolicy(GetIamPolicyRequest request) *

*

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

*
    - *
  • getIamPolicyCallable() + *
  • getIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a `NOT_FOUND` error. *

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

*

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

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *
  • testIamPermissions(TestIamPermissionsRequest request) *

*

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

*
    - *
  • testIamPermissionsCallable() + *
  • testIamPermissionsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-securesourcemanager/google-cloud-securesourcemanager/src/main/java/com/google/cloud/securesourcemanager/v1/stub/SecureSourceManagerStubSettings.java b/java-securesourcemanager/google-cloud-securesourcemanager/src/main/java/com/google/cloud/securesourcemanager/v1/stub/SecureSourceManagerStubSettings.java index 63e7184ad13f..4c04cf38762f 100644 --- a/java-securesourcemanager/google-cloud-securesourcemanager/src/main/java/com/google/cloud/securesourcemanager/v1/stub/SecureSourceManagerStubSettings.java +++ b/java-securesourcemanager/google-cloud-securesourcemanager/src/main/java/com/google/cloud/securesourcemanager/v1/stub/SecureSourceManagerStubSettings.java @@ -450,6 +450,15 @@ public SecureSourceManagerStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -742,7 +751,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -755,7 +763,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -1079,6 +1086,15 @@ public UnaryCallSettings.Builder getIamPolicySettin return testIamPermissionsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public SecureSourceManagerStubSettings build() throws IOException { return new SecureSourceManagerStubSettings(this); diff --git a/java-security-private-ca/README.md b/java-security-private-ca/README.md index 1b3ef05e8623..450842d1414e 100644 --- a/java-security-private-ca/README.md +++ b/java-security-private-ca/README.md @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-security-private-ca.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-security-private-ca/2.34.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-security-private-ca/2.35.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-security-private-ca/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1/CertificateAuthorityServiceClient.java b/java-security-private-ca/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1/CertificateAuthorityServiceClient.java index ee3be35c1470..0532d334b5f2 100644 --- a/java-security-private-ca/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1/CertificateAuthorityServiceClient.java +++ b/java-security-private-ca/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1/CertificateAuthorityServiceClient.java @@ -78,649 +78,650 @@ * calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
CreateCertificate

CreateCertificate

Create a new [Certificate][google.cloud.security.privateca.v1.Certificate] in a given Project, Location from a particular [CaPool][google.cloud.security.privateca.v1.CaPool].

*

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

*
    - *
  • createCertificate(CreateCertificateRequest request) + *
  • createCertificate(CreateCertificateRequest request) *

*

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

*
    - *
  • createCertificate(CaPoolName parent, Certificate certificate, String certificateId) - *
  • createCertificate(String parent, Certificate certificate, String certificateId) + *
  • createCertificate(CaPoolName parent, Certificate certificate, String certificateId) + *

  • createCertificate(String parent, Certificate certificate, String certificateId) *

*

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

*
    - *
  • createCertificateCallable() + *
  • createCertificateCallable() *

*
GetCertificate

GetCertificate

Returns a [Certificate][google.cloud.security.privateca.v1.Certificate].

*

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

*
    - *
  • getCertificate(GetCertificateRequest request) + *
  • getCertificate(GetCertificateRequest request) *

*

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

*
    - *
  • getCertificate(CertificateName name) - *
  • getCertificate(String name) + *
  • getCertificate(CertificateName name) + *

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

*
    - *
  • getCertificateCallable() + *
  • getCertificateCallable() *

*
ListCertificates

ListCertificates

Lists [Certificates][google.cloud.security.privateca.v1.Certificate].

*

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

*
    - *
  • listCertificates(ListCertificatesRequest request) + *
  • listCertificates(ListCertificatesRequest request) *

*

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

*
    - *
  • listCertificates(CaPoolName parent) - *
  • listCertificates(String parent) + *
  • listCertificates(CaPoolName parent) + *

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

*
    - *
  • listCertificatesPagedCallable() - *
  • listCertificatesCallable() + *
  • listCertificatesPagedCallable() + *

  • listCertificatesCallable() *

*
RevokeCertificate

RevokeCertificate

Revoke a [Certificate][google.cloud.security.privateca.v1.Certificate].

*

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

*
    - *
  • revokeCertificate(RevokeCertificateRequest request) + *
  • revokeCertificate(RevokeCertificateRequest request) *

*

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

*
    - *
  • revokeCertificate(CertificateName name) - *
  • revokeCertificate(String name) + *
  • revokeCertificate(CertificateName name) + *

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

*
    - *
  • revokeCertificateCallable() + *
  • revokeCertificateCallable() *

*
UpdateCertificate

UpdateCertificate

Update a [Certificate][google.cloud.security.privateca.v1.Certificate]. Currently, the only field you can update is the [labels][google.cloud.security.privateca.v1.Certificate.labels] field.

*

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

*
    - *
  • updateCertificate(UpdateCertificateRequest request) + *
  • updateCertificate(UpdateCertificateRequest request) *

*

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

*
    - *
  • updateCertificate(Certificate certificate, FieldMask updateMask) + *
  • updateCertificate(Certificate certificate, 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.

*
    - *
  • updateCertificateCallable() + *
  • updateCertificateCallable() *

*
ActivateCertificateAuthority

ActivateCertificateAuthority

Activate a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] that is in state [AWAITING_USER_ACTIVATION][google.cloud.security.privateca.v1.CertificateAuthority.State.AWAITING_USER_ACTIVATION] and is of type [SUBORDINATE][google.cloud.security.privateca.v1.CertificateAuthority.Type.SUBORDINATE]. After the parent Certificate Authority signs a certificate signing request from [FetchCertificateAuthorityCsr][google.cloud.security.privateca.v1.CertificateAuthorityService.FetchCertificateAuthorityCsr], this method can complete the activation process.

*

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

*
    - *
  • activateCertificateAuthorityAsync(ActivateCertificateAuthorityRequest request) + *
  • activateCertificateAuthorityAsync(ActivateCertificateAuthorityRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • activateCertificateAuthorityAsync(CertificateAuthorityName name) - *
  • activateCertificateAuthorityAsync(String name) + *
  • activateCertificateAuthorityAsync(CertificateAuthorityName name) + *

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

*
    - *
  • activateCertificateAuthorityOperationCallable() - *
  • activateCertificateAuthorityCallable() + *
  • activateCertificateAuthorityOperationCallable() + *

  • activateCertificateAuthorityCallable() *

*
CreateCertificateAuthority

CreateCertificateAuthority

Create a new [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] in a given Project and Location.

*

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

*
    - *
  • createCertificateAuthorityAsync(CreateCertificateAuthorityRequest request) + *
  • createCertificateAuthorityAsync(CreateCertificateAuthorityRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createCertificateAuthorityAsync(CaPoolName parent, CertificateAuthority certificateAuthority, String certificateAuthorityId) - *
  • createCertificateAuthorityAsync(String parent, CertificateAuthority certificateAuthority, String certificateAuthorityId) + *
  • createCertificateAuthorityAsync(CaPoolName parent, CertificateAuthority certificateAuthority, String certificateAuthorityId) + *

  • createCertificateAuthorityAsync(String parent, CertificateAuthority certificateAuthority, String certificateAuthorityId) *

*

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

*
    - *
  • createCertificateAuthorityOperationCallable() - *
  • createCertificateAuthorityCallable() + *
  • createCertificateAuthorityOperationCallable() + *

  • createCertificateAuthorityCallable() *

*
DisableCertificateAuthority

DisableCertificateAuthority

Disable a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority].

*

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

*
    - *
  • disableCertificateAuthorityAsync(DisableCertificateAuthorityRequest request) + *
  • disableCertificateAuthorityAsync(DisableCertificateAuthorityRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • disableCertificateAuthorityAsync(CertificateAuthorityName name) - *
  • disableCertificateAuthorityAsync(String name) + *
  • disableCertificateAuthorityAsync(CertificateAuthorityName name) + *

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

*
    - *
  • disableCertificateAuthorityOperationCallable() - *
  • disableCertificateAuthorityCallable() + *
  • disableCertificateAuthorityOperationCallable() + *

  • disableCertificateAuthorityCallable() *

*
EnableCertificateAuthority

EnableCertificateAuthority

Enable a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority].

*

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

*
    - *
  • enableCertificateAuthorityAsync(EnableCertificateAuthorityRequest request) + *
  • enableCertificateAuthorityAsync(EnableCertificateAuthorityRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • enableCertificateAuthorityAsync(CertificateAuthorityName name) - *
  • enableCertificateAuthorityAsync(String name) + *
  • enableCertificateAuthorityAsync(CertificateAuthorityName name) + *

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

*
    - *
  • enableCertificateAuthorityOperationCallable() - *
  • enableCertificateAuthorityCallable() + *
  • enableCertificateAuthorityOperationCallable() + *

  • enableCertificateAuthorityCallable() *

*
FetchCertificateAuthorityCsr

FetchCertificateAuthorityCsr

Fetch a certificate signing request (CSR) from a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] that is in state [AWAITING_USER_ACTIVATION][google.cloud.security.privateca.v1.CertificateAuthority.State.AWAITING_USER_ACTIVATION] and is of type [SUBORDINATE][google.cloud.security.privateca.v1.CertificateAuthority.Type.SUBORDINATE]. The CSR must then be signed by the desired parent Certificate Authority, which could be another [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] resource, or could be an on-prem certificate authority. See also [ActivateCertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthorityService.ActivateCertificateAuthority].

*

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

*
    - *
  • fetchCertificateAuthorityCsr(FetchCertificateAuthorityCsrRequest request) + *
  • fetchCertificateAuthorityCsr(FetchCertificateAuthorityCsrRequest request) *

*

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

*
    - *
  • fetchCertificateAuthorityCsr(CertificateAuthorityName name) - *
  • fetchCertificateAuthorityCsr(String name) + *
  • fetchCertificateAuthorityCsr(CertificateAuthorityName name) + *

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

*
    - *
  • fetchCertificateAuthorityCsrCallable() + *
  • fetchCertificateAuthorityCsrCallable() *

*
GetCertificateAuthority

GetCertificateAuthority

Returns a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority].

*

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

*
    - *
  • getCertificateAuthority(GetCertificateAuthorityRequest request) + *
  • getCertificateAuthority(GetCertificateAuthorityRequest request) *

*

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

*
    - *
  • getCertificateAuthority(CertificateAuthorityName name) - *
  • getCertificateAuthority(String name) + *
  • getCertificateAuthority(CertificateAuthorityName name) + *

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

*
    - *
  • getCertificateAuthorityCallable() + *
  • getCertificateAuthorityCallable() *

*
ListCertificateAuthorities

ListCertificateAuthorities

Lists [CertificateAuthorities][google.cloud.security.privateca.v1.CertificateAuthority].

*

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

*
    - *
  • listCertificateAuthorities(ListCertificateAuthoritiesRequest request) + *
  • listCertificateAuthorities(ListCertificateAuthoritiesRequest request) *

*

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

*
    - *
  • listCertificateAuthorities(CaPoolName parent) - *
  • listCertificateAuthorities(String parent) + *
  • listCertificateAuthorities(CaPoolName parent) + *

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

*
    - *
  • listCertificateAuthoritiesPagedCallable() - *
  • listCertificateAuthoritiesCallable() + *
  • listCertificateAuthoritiesPagedCallable() + *

  • listCertificateAuthoritiesCallable() *

*
UndeleteCertificateAuthority

UndeleteCertificateAuthority

Undelete a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] that has been deleted.

*

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

*
    - *
  • undeleteCertificateAuthorityAsync(UndeleteCertificateAuthorityRequest request) + *
  • undeleteCertificateAuthorityAsync(UndeleteCertificateAuthorityRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • undeleteCertificateAuthorityAsync(CertificateAuthorityName name) - *
  • undeleteCertificateAuthorityAsync(String name) + *
  • undeleteCertificateAuthorityAsync(CertificateAuthorityName name) + *

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

*
    - *
  • undeleteCertificateAuthorityOperationCallable() - *
  • undeleteCertificateAuthorityCallable() + *
  • undeleteCertificateAuthorityOperationCallable() + *

  • undeleteCertificateAuthorityCallable() *

*
DeleteCertificateAuthority

DeleteCertificateAuthority

Delete a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority].

*

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

*
    - *
  • deleteCertificateAuthorityAsync(DeleteCertificateAuthorityRequest request) + *
  • deleteCertificateAuthorityAsync(DeleteCertificateAuthorityRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteCertificateAuthorityAsync(CertificateAuthorityName name) - *
  • deleteCertificateAuthorityAsync(String name) + *
  • deleteCertificateAuthorityAsync(CertificateAuthorityName name) + *

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

*
    - *
  • deleteCertificateAuthorityOperationCallable() - *
  • deleteCertificateAuthorityCallable() + *
  • deleteCertificateAuthorityOperationCallable() + *

  • deleteCertificateAuthorityCallable() *

*
UpdateCertificateAuthority

UpdateCertificateAuthority

Update a [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority].

*

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

*
    - *
  • updateCertificateAuthorityAsync(UpdateCertificateAuthorityRequest request) + *
  • updateCertificateAuthorityAsync(UpdateCertificateAuthorityRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateCertificateAuthorityAsync(CertificateAuthority certificateAuthority, FieldMask updateMask) + *
  • updateCertificateAuthorityAsync(CertificateAuthority certificateAuthority, 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.

*
    - *
  • updateCertificateAuthorityOperationCallable() - *
  • updateCertificateAuthorityCallable() + *
  • updateCertificateAuthorityOperationCallable() + *

  • updateCertificateAuthorityCallable() *

*
CreateCaPool

CreateCaPool

Create a [CaPool][google.cloud.security.privateca.v1.CaPool].

*

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

*
    - *
  • createCaPoolAsync(CreateCaPoolRequest request) + *
  • createCaPoolAsync(CreateCaPoolRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createCaPoolAsync(LocationName parent, CaPool caPool, String caPoolId) - *
  • createCaPoolAsync(String parent, CaPool caPool, String caPoolId) + *
  • createCaPoolAsync(LocationName parent, CaPool caPool, String caPoolId) + *

  • createCaPoolAsync(String parent, CaPool caPool, String caPoolId) *

*

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

*
    - *
  • createCaPoolOperationCallable() - *
  • createCaPoolCallable() + *
  • createCaPoolOperationCallable() + *

  • createCaPoolCallable() *

*
UpdateCaPool

UpdateCaPool

Update a [CaPool][google.cloud.security.privateca.v1.CaPool].

*

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

*
    - *
  • updateCaPoolAsync(UpdateCaPoolRequest request) + *
  • updateCaPoolAsync(UpdateCaPoolRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateCaPoolAsync(CaPool caPool, FieldMask updateMask) + *
  • updateCaPoolAsync(CaPool caPool, 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.

*
    - *
  • updateCaPoolOperationCallable() - *
  • updateCaPoolCallable() + *
  • updateCaPoolOperationCallable() + *

  • updateCaPoolCallable() *

*
GetCaPool

GetCaPool

Returns a [CaPool][google.cloud.security.privateca.v1.CaPool].

*

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

*
    - *
  • getCaPool(GetCaPoolRequest request) + *
  • getCaPool(GetCaPoolRequest request) *

*

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

*
    - *
  • getCaPool(CaPoolName name) - *
  • getCaPool(String name) + *
  • getCaPool(CaPoolName name) + *

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

*
    - *
  • getCaPoolCallable() + *
  • getCaPoolCallable() *

*
ListCaPools

ListCaPools

Lists [CaPools][google.cloud.security.privateca.v1.CaPool].

*

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

*
    - *
  • listCaPools(ListCaPoolsRequest request) + *
  • listCaPools(ListCaPoolsRequest request) *

*

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

*
    - *
  • listCaPools(LocationName parent) - *
  • listCaPools(String parent) + *
  • listCaPools(LocationName parent) + *

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

*
    - *
  • listCaPoolsPagedCallable() - *
  • listCaPoolsCallable() + *
  • listCaPoolsPagedCallable() + *

  • listCaPoolsCallable() *

*
DeleteCaPool

DeleteCaPool

Delete a [CaPool][google.cloud.security.privateca.v1.CaPool].

*

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

*
    - *
  • deleteCaPoolAsync(DeleteCaPoolRequest request) + *
  • deleteCaPoolAsync(DeleteCaPoolRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteCaPoolAsync(CaPoolName name) - *
  • deleteCaPoolAsync(String name) + *
  • deleteCaPoolAsync(CaPoolName name) + *

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

*
    - *
  • deleteCaPoolOperationCallable() - *
  • deleteCaPoolCallable() + *
  • deleteCaPoolOperationCallable() + *

  • deleteCaPoolCallable() *

*
FetchCaCerts

FetchCaCerts

FetchCaCerts returns the current trust anchor for the [CaPool][google.cloud.security.privateca.v1.CaPool]. This will include CA certificate chains for all ACTIVE [CertificateAuthority][google.cloud.security.privateca.v1.CertificateAuthority] resources in the [CaPool][google.cloud.security.privateca.v1.CaPool].

*

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

*
    - *
  • fetchCaCerts(FetchCaCertsRequest request) + *
  • fetchCaCerts(FetchCaCertsRequest request) *

*

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

*
    - *
  • fetchCaCerts(CaPoolName caPool) - *
  • fetchCaCerts(String caPool) + *
  • fetchCaCerts(CaPoolName caPool) + *

  • fetchCaCerts(String caPool) *

*

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

*
    - *
  • fetchCaCertsCallable() + *
  • fetchCaCertsCallable() *

*
GetCertificateRevocationList

GetCertificateRevocationList

Returns a [CertificateRevocationList][google.cloud.security.privateca.v1.CertificateRevocationList].

*

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

*
    - *
  • getCertificateRevocationList(GetCertificateRevocationListRequest request) + *
  • getCertificateRevocationList(GetCertificateRevocationListRequest request) *

*

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

*
    - *
  • getCertificateRevocationList(CertificateRevocationListName name) - *
  • getCertificateRevocationList(String name) + *
  • getCertificateRevocationList(CertificateRevocationListName name) + *

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

*
    - *
  • getCertificateRevocationListCallable() + *
  • getCertificateRevocationListCallable() *

*
ListCertificateRevocationLists

ListCertificateRevocationLists

Lists [CertificateRevocationLists][google.cloud.security.privateca.v1.CertificateRevocationList].

*

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

*
    - *
  • listCertificateRevocationLists(ListCertificateRevocationListsRequest request) + *
  • listCertificateRevocationLists(ListCertificateRevocationListsRequest request) *

*

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

*
    - *
  • listCertificateRevocationLists(CertificateAuthorityName parent) - *
  • listCertificateRevocationLists(String parent) + *
  • listCertificateRevocationLists(CertificateAuthorityName parent) + *

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

*
    - *
  • listCertificateRevocationListsPagedCallable() - *
  • listCertificateRevocationListsCallable() + *
  • listCertificateRevocationListsPagedCallable() + *

  • listCertificateRevocationListsCallable() *

*
UpdateCertificateRevocationList

UpdateCertificateRevocationList

Update a [CertificateRevocationList][google.cloud.security.privateca.v1.CertificateRevocationList].

*

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

*
    - *
  • updateCertificateRevocationListAsync(UpdateCertificateRevocationListRequest request) + *
  • updateCertificateRevocationListAsync(UpdateCertificateRevocationListRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateCertificateRevocationListAsync(CertificateRevocationList certificateRevocationList, FieldMask updateMask) + *
  • updateCertificateRevocationListAsync(CertificateRevocationList certificateRevocationList, 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.

*
    - *
  • updateCertificateRevocationListOperationCallable() - *
  • updateCertificateRevocationListCallable() + *
  • updateCertificateRevocationListOperationCallable() + *

  • updateCertificateRevocationListCallable() *

*
CreateCertificateTemplate

CreateCertificateTemplate

Create a new [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate] in a given Project and Location.

*

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

*
    - *
  • createCertificateTemplateAsync(CreateCertificateTemplateRequest request) + *
  • createCertificateTemplateAsync(CreateCertificateTemplateRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createCertificateTemplateAsync(LocationName parent, CertificateTemplate certificateTemplate, String certificateTemplateId) - *
  • createCertificateTemplateAsync(String parent, CertificateTemplate certificateTemplate, String certificateTemplateId) + *
  • createCertificateTemplateAsync(LocationName parent, CertificateTemplate certificateTemplate, String certificateTemplateId) + *

  • createCertificateTemplateAsync(String parent, CertificateTemplate certificateTemplate, String certificateTemplateId) *

*

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

*
    - *
  • createCertificateTemplateOperationCallable() - *
  • createCertificateTemplateCallable() + *
  • createCertificateTemplateOperationCallable() + *

  • createCertificateTemplateCallable() *

*
DeleteCertificateTemplate

DeleteCertificateTemplate

DeleteCertificateTemplate deletes a [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate].

*

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

*
    - *
  • deleteCertificateTemplateAsync(DeleteCertificateTemplateRequest request) + *
  • deleteCertificateTemplateAsync(DeleteCertificateTemplateRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteCertificateTemplateAsync(CertificateTemplateName name) - *
  • deleteCertificateTemplateAsync(String name) + *
  • deleteCertificateTemplateAsync(CertificateTemplateName name) + *

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

*
    - *
  • deleteCertificateTemplateOperationCallable() - *
  • deleteCertificateTemplateCallable() + *
  • deleteCertificateTemplateOperationCallable() + *

  • deleteCertificateTemplateCallable() *

*
GetCertificateTemplate

GetCertificateTemplate

Returns a [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate].

*

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

*
    - *
  • getCertificateTemplate(GetCertificateTemplateRequest request) + *
  • getCertificateTemplate(GetCertificateTemplateRequest request) *

*

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

*
    - *
  • getCertificateTemplate(CertificateTemplateName name) - *
  • getCertificateTemplate(String name) + *
  • getCertificateTemplate(CertificateTemplateName name) + *

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

*
    - *
  • getCertificateTemplateCallable() + *
  • getCertificateTemplateCallable() *

*
ListCertificateTemplates

ListCertificateTemplates

Lists [CertificateTemplates][google.cloud.security.privateca.v1.CertificateTemplate].

*

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

*
    - *
  • listCertificateTemplates(ListCertificateTemplatesRequest request) + *
  • listCertificateTemplates(ListCertificateTemplatesRequest request) *

*

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

*
    - *
  • listCertificateTemplates(LocationName parent) - *
  • listCertificateTemplates(String parent) + *
  • listCertificateTemplates(LocationName parent) + *

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

*
    - *
  • listCertificateTemplatesPagedCallable() - *
  • listCertificateTemplatesCallable() + *
  • listCertificateTemplatesPagedCallable() + *

  • listCertificateTemplatesCallable() *

*
UpdateCertificateTemplate

UpdateCertificateTemplate

Update a [CertificateTemplate][google.cloud.security.privateca.v1.CertificateTemplate].

*

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

*
    - *
  • updateCertificateTemplateAsync(UpdateCertificateTemplateRequest request) + *
  • updateCertificateTemplateAsync(UpdateCertificateTemplateRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateCertificateTemplateAsync(CertificateTemplate certificateTemplate, FieldMask updateMask) + *
  • updateCertificateTemplateAsync(CertificateTemplate certificateTemplate, 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.

*
    - *
  • updateCertificateTemplateOperationCallable() - *
  • updateCertificateTemplateCallable() + *
  • updateCertificateTemplateOperationCallable() + *

  • updateCertificateTemplateCallable() *

*
ListLocations

ListLocations

Lists information about the supported locations for this service.

*

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

*
    - *
  • listLocations(ListLocationsRequest request) + *
  • listLocations(ListLocationsRequest request) *

*

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

*
    - *
  • listLocationsPagedCallable() - *
  • listLocationsCallable() + *
  • listLocationsPagedCallable() + *

  • listLocationsCallable() *

*
GetLocation

GetLocation

Gets information about a location.

*

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

*
    - *
  • getLocation(GetLocationRequest request) + *
  • getLocation(GetLocationRequest request) *

*

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

*
    - *
  • getLocationCallable() + *
  • getLocationCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the access control policy on the specified resource. Replacesany existing policy. *

Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.

*

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

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *
  • setIamPolicy(SetIamPolicyRequest request) *

*

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

*
    - *
  • setIamPolicyCallable() + *
  • setIamPolicyCallable() *

*
GetIamPolicy

GetIamPolicy

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

*

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

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *
  • getIamPolicy(GetIamPolicyRequest request) *

*

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

*
    - *
  • getIamPolicyCallable() + *
  • getIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a `NOT_FOUND` error. *

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

*

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

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *
  • testIamPermissions(TestIamPermissionsRequest request) *

*

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

*
    - *
  • testIamPermissionsCallable() + *
  • testIamPermissionsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-security-private-ca/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1/stub/CertificateAuthorityServiceStubSettings.java b/java-security-private-ca/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1/stub/CertificateAuthorityServiceStubSettings.java index ba79672e5a0a..1ec4e2ca8bb6 100644 --- a/java-security-private-ca/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1/stub/CertificateAuthorityServiceStubSettings.java +++ b/java-security-private-ca/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1/stub/CertificateAuthorityServiceStubSettings.java @@ -977,6 +977,15 @@ public CertificateAuthorityServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -1511,7 +1520,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -1524,7 +1532,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -2399,6 +2406,15 @@ public UnaryCallSettings.Builder getIamPolicySettin return testIamPermissionsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public CertificateAuthorityServiceStubSettings build() throws IOException { return new CertificateAuthorityServiceStubSettings(this); diff --git a/java-security-private-ca/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1beta1/CertificateAuthorityServiceClient.java b/java-security-private-ca/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1beta1/CertificateAuthorityServiceClient.java index ab59d5dea8de..dabfccbf78af 100644 --- a/java-security-private-ca/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1beta1/CertificateAuthorityServiceClient.java +++ b/java-security-private-ca/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1beta1/CertificateAuthorityServiceClient.java @@ -69,400 +69,401 @@ * calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
CreateCertificate

CreateCertificate

Create a new [Certificate][google.cloud.security.privateca.v1beta1.Certificate] in a given Project, Location from a particular [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority].

*

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

*
    - *
  • createCertificate(CreateCertificateRequest request) + *
  • createCertificate(CreateCertificateRequest request) *

*

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

*
    - *
  • createCertificate(CertificateAuthorityName parent, Certificate certificate, String certificateId) - *
  • createCertificate(String parent, Certificate certificate, String certificateId) + *
  • createCertificate(CertificateAuthorityName parent, Certificate certificate, String certificateId) + *

  • createCertificate(String parent, Certificate certificate, String certificateId) *

*

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

*
    - *
  • createCertificateCallable() + *
  • createCertificateCallable() *

*
GetCertificate

GetCertificate

Returns a [Certificate][google.cloud.security.privateca.v1beta1.Certificate].

*

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

*
    - *
  • getCertificate(GetCertificateRequest request) + *
  • getCertificate(GetCertificateRequest request) *

*

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

*
    - *
  • getCertificate(CertificateName name) - *
  • getCertificate(String name) + *
  • getCertificate(CertificateName name) + *

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

*
    - *
  • getCertificateCallable() + *
  • getCertificateCallable() *

*
ListCertificates

ListCertificates

Lists [Certificates][google.cloud.security.privateca.v1beta1.Certificate].

*

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

*
    - *
  • listCertificates(ListCertificatesRequest request) + *
  • listCertificates(ListCertificatesRequest request) *

*

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

*
    - *
  • listCertificates(CertificateAuthorityName parent) - *
  • listCertificates(String parent) + *
  • listCertificates(CertificateAuthorityName parent) + *

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

*
    - *
  • listCertificatesPagedCallable() - *
  • listCertificatesCallable() + *
  • listCertificatesPagedCallable() + *

  • listCertificatesCallable() *

*
RevokeCertificate

RevokeCertificate

Revoke a [Certificate][google.cloud.security.privateca.v1beta1.Certificate].

*

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

*
    - *
  • revokeCertificate(RevokeCertificateRequest request) + *
  • revokeCertificate(RevokeCertificateRequest request) *

*

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

*
    - *
  • revokeCertificate(CertificateName name) - *
  • revokeCertificate(String name) + *
  • revokeCertificate(CertificateName name) + *

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

*
    - *
  • revokeCertificateCallable() + *
  • revokeCertificateCallable() *

*
UpdateCertificate

UpdateCertificate

Update a [Certificate][google.cloud.security.privateca.v1beta1.Certificate]. Currently, the only field you can update is the [labels][google.cloud.security.privateca.v1beta1.Certificate.labels] field.

*

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

*
    - *
  • updateCertificate(UpdateCertificateRequest request) + *
  • updateCertificate(UpdateCertificateRequest request) *

*

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

*
    - *
  • updateCertificate(Certificate certificate, FieldMask updateMask) + *
  • updateCertificate(Certificate certificate, 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.

*
    - *
  • updateCertificateCallable() + *
  • updateCertificateCallable() *

*
ActivateCertificateAuthority

ActivateCertificateAuthority

Activate a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] that is in state [PENDING_ACTIVATION][google.cloud.security.privateca.v1beta1.CertificateAuthority.State.PENDING_ACTIVATION] and is of type [SUBORDINATE][google.cloud.security.privateca.v1beta1.CertificateAuthority.Type.SUBORDINATE]. After the parent Certificate Authority signs a certificate signing request from [FetchCertificateAuthorityCsr][google.cloud.security.privateca.v1beta1.CertificateAuthorityService.FetchCertificateAuthorityCsr], this method can complete the activation process.

*

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

*
    - *
  • activateCertificateAuthorityAsync(ActivateCertificateAuthorityRequest request) + *
  • activateCertificateAuthorityAsync(ActivateCertificateAuthorityRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • activateCertificateAuthorityAsync(CertificateAuthorityName name) - *
  • activateCertificateAuthorityAsync(String name) + *
  • activateCertificateAuthorityAsync(CertificateAuthorityName name) + *

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

*
    - *
  • activateCertificateAuthorityOperationCallable() - *
  • activateCertificateAuthorityCallable() + *
  • activateCertificateAuthorityOperationCallable() + *

  • activateCertificateAuthorityCallable() *

*
CreateCertificateAuthority

CreateCertificateAuthority

Create a new [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] in a given Project and Location.

*

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

*
    - *
  • createCertificateAuthorityAsync(CreateCertificateAuthorityRequest request) + *
  • createCertificateAuthorityAsync(CreateCertificateAuthorityRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createCertificateAuthorityAsync(LocationName parent, CertificateAuthority certificateAuthority, String certificateAuthorityId) - *
  • createCertificateAuthorityAsync(String parent, CertificateAuthority certificateAuthority, String certificateAuthorityId) + *
  • createCertificateAuthorityAsync(LocationName parent, CertificateAuthority certificateAuthority, String certificateAuthorityId) + *

  • createCertificateAuthorityAsync(String parent, CertificateAuthority certificateAuthority, String certificateAuthorityId) *

*

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

*
    - *
  • createCertificateAuthorityOperationCallable() - *
  • createCertificateAuthorityCallable() + *
  • createCertificateAuthorityOperationCallable() + *

  • createCertificateAuthorityCallable() *

*
DisableCertificateAuthority

DisableCertificateAuthority

Disable a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority].

*

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

*
    - *
  • disableCertificateAuthorityAsync(DisableCertificateAuthorityRequest request) + *
  • disableCertificateAuthorityAsync(DisableCertificateAuthorityRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • disableCertificateAuthorityAsync(CertificateAuthorityName name) - *
  • disableCertificateAuthorityAsync(String name) + *
  • disableCertificateAuthorityAsync(CertificateAuthorityName name) + *

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

*
    - *
  • disableCertificateAuthorityOperationCallable() - *
  • disableCertificateAuthorityCallable() + *
  • disableCertificateAuthorityOperationCallable() + *

  • disableCertificateAuthorityCallable() *

*
EnableCertificateAuthority

EnableCertificateAuthority

Enable a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority].

*

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

*
    - *
  • enableCertificateAuthorityAsync(EnableCertificateAuthorityRequest request) + *
  • enableCertificateAuthorityAsync(EnableCertificateAuthorityRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • enableCertificateAuthorityAsync(CertificateAuthorityName name) - *
  • enableCertificateAuthorityAsync(String name) + *
  • enableCertificateAuthorityAsync(CertificateAuthorityName name) + *

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

*
    - *
  • enableCertificateAuthorityOperationCallable() - *
  • enableCertificateAuthorityCallable() + *
  • enableCertificateAuthorityOperationCallable() + *

  • enableCertificateAuthorityCallable() *

*
FetchCertificateAuthorityCsr

FetchCertificateAuthorityCsr

Fetch a certificate signing request (CSR) from a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] that is in state [PENDING_ACTIVATION][google.cloud.security.privateca.v1beta1.CertificateAuthority.State.PENDING_ACTIVATION] and is of type [SUBORDINATE][google.cloud.security.privateca.v1beta1.CertificateAuthority.Type.SUBORDINATE]. The CSR must then be signed by the desired parent Certificate Authority, which could be another [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] resource, or could be an on-prem certificate authority. See also [ActivateCertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthorityService.ActivateCertificateAuthority].

*

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

*
    - *
  • fetchCertificateAuthorityCsr(FetchCertificateAuthorityCsrRequest request) + *
  • fetchCertificateAuthorityCsr(FetchCertificateAuthorityCsrRequest request) *

*

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

*
    - *
  • fetchCertificateAuthorityCsr(CertificateAuthorityName name) - *
  • fetchCertificateAuthorityCsr(String name) + *
  • fetchCertificateAuthorityCsr(CertificateAuthorityName name) + *

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

*
    - *
  • fetchCertificateAuthorityCsrCallable() + *
  • fetchCertificateAuthorityCsrCallable() *

*
GetCertificateAuthority

GetCertificateAuthority

Returns a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority].

*

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

*
    - *
  • getCertificateAuthority(GetCertificateAuthorityRequest request) + *
  • getCertificateAuthority(GetCertificateAuthorityRequest request) *

*

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

*
    - *
  • getCertificateAuthority(CertificateAuthorityName name) - *
  • getCertificateAuthority(String name) + *
  • getCertificateAuthority(CertificateAuthorityName name) + *

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

*
    - *
  • getCertificateAuthorityCallable() + *
  • getCertificateAuthorityCallable() *

*
ListCertificateAuthorities

ListCertificateAuthorities

Lists [CertificateAuthorities][google.cloud.security.privateca.v1beta1.CertificateAuthority].

*

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

*
    - *
  • listCertificateAuthorities(ListCertificateAuthoritiesRequest request) + *
  • listCertificateAuthorities(ListCertificateAuthoritiesRequest request) *

*

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

*
    - *
  • listCertificateAuthorities(LocationName parent) - *
  • listCertificateAuthorities(String parent) + *
  • listCertificateAuthorities(LocationName parent) + *

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

*
    - *
  • listCertificateAuthoritiesPagedCallable() - *
  • listCertificateAuthoritiesCallable() + *
  • listCertificateAuthoritiesPagedCallable() + *

  • listCertificateAuthoritiesCallable() *

*
RestoreCertificateAuthority

RestoreCertificateAuthority

Restore a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] that is scheduled for deletion.

*

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

*
    - *
  • restoreCertificateAuthorityAsync(RestoreCertificateAuthorityRequest request) + *
  • restoreCertificateAuthorityAsync(RestoreCertificateAuthorityRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • restoreCertificateAuthorityAsync(CertificateAuthorityName name) - *
  • restoreCertificateAuthorityAsync(String name) + *
  • restoreCertificateAuthorityAsync(CertificateAuthorityName name) + *

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

*
    - *
  • restoreCertificateAuthorityOperationCallable() - *
  • restoreCertificateAuthorityCallable() + *
  • restoreCertificateAuthorityOperationCallable() + *

  • restoreCertificateAuthorityCallable() *

*
ScheduleDeleteCertificateAuthority

ScheduleDeleteCertificateAuthority

Schedule a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority] for deletion.

*

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

*
    - *
  • scheduleDeleteCertificateAuthorityAsync(ScheduleDeleteCertificateAuthorityRequest request) + *
  • scheduleDeleteCertificateAuthorityAsync(ScheduleDeleteCertificateAuthorityRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • scheduleDeleteCertificateAuthorityAsync(CertificateAuthorityName name) - *
  • scheduleDeleteCertificateAuthorityAsync(String name) + *
  • scheduleDeleteCertificateAuthorityAsync(CertificateAuthorityName name) + *

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

*
    - *
  • scheduleDeleteCertificateAuthorityOperationCallable() - *
  • scheduleDeleteCertificateAuthorityCallable() + *
  • scheduleDeleteCertificateAuthorityOperationCallable() + *

  • scheduleDeleteCertificateAuthorityCallable() *

*
UpdateCertificateAuthority

UpdateCertificateAuthority

Update a [CertificateAuthority][google.cloud.security.privateca.v1beta1.CertificateAuthority].

*

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

*
    - *
  • updateCertificateAuthorityAsync(UpdateCertificateAuthorityRequest request) + *
  • updateCertificateAuthorityAsync(UpdateCertificateAuthorityRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateCertificateAuthorityAsync(CertificateAuthority certificateAuthority, FieldMask updateMask) + *
  • updateCertificateAuthorityAsync(CertificateAuthority certificateAuthority, 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.

*
    - *
  • updateCertificateAuthorityOperationCallable() - *
  • updateCertificateAuthorityCallable() + *
  • updateCertificateAuthorityOperationCallable() + *

  • updateCertificateAuthorityCallable() *

*
GetCertificateRevocationList

GetCertificateRevocationList

Returns a [CertificateRevocationList][google.cloud.security.privateca.v1beta1.CertificateRevocationList].

*

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

*
    - *
  • getCertificateRevocationList(GetCertificateRevocationListRequest request) + *
  • getCertificateRevocationList(GetCertificateRevocationListRequest request) *

*

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

*
    - *
  • getCertificateRevocationList(CertificateRevocationListName name) - *
  • getCertificateRevocationList(String name) + *
  • getCertificateRevocationList(CertificateRevocationListName name) + *

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

*
    - *
  • getCertificateRevocationListCallable() + *
  • getCertificateRevocationListCallable() *

*
ListCertificateRevocationLists

ListCertificateRevocationLists

Lists [CertificateRevocationLists][google.cloud.security.privateca.v1beta1.CertificateRevocationList].

*

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

*
    - *
  • listCertificateRevocationLists(ListCertificateRevocationListsRequest request) + *
  • listCertificateRevocationLists(ListCertificateRevocationListsRequest request) *

*

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

*
    - *
  • listCertificateRevocationLists(CertificateAuthorityName parent) - *
  • listCertificateRevocationLists(String parent) + *
  • listCertificateRevocationLists(CertificateAuthorityName parent) + *

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

*
    - *
  • listCertificateRevocationListsPagedCallable() - *
  • listCertificateRevocationListsCallable() + *
  • listCertificateRevocationListsPagedCallable() + *

  • listCertificateRevocationListsCallable() *

*
UpdateCertificateRevocationList

UpdateCertificateRevocationList

Update a [CertificateRevocationList][google.cloud.security.privateca.v1beta1.CertificateRevocationList].

*

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

*
    - *
  • updateCertificateRevocationListAsync(UpdateCertificateRevocationListRequest request) + *
  • updateCertificateRevocationListAsync(UpdateCertificateRevocationListRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • updateCertificateRevocationListAsync(CertificateRevocationList certificateRevocationList, FieldMask updateMask) + *
  • updateCertificateRevocationListAsync(CertificateRevocationList certificateRevocationList, 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.

*
    - *
  • updateCertificateRevocationListOperationCallable() - *
  • updateCertificateRevocationListCallable() + *
  • updateCertificateRevocationListOperationCallable() + *

  • updateCertificateRevocationListCallable() *

*
GetReusableConfig

GetReusableConfig

Returns a [ReusableConfig][google.cloud.security.privateca.v1beta1.ReusableConfig].

*

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

*
    - *
  • getReusableConfig(GetReusableConfigRequest request) + *
  • getReusableConfig(GetReusableConfigRequest request) *

*

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

*
    - *
  • getReusableConfig(ReusableConfigName name) - *
  • getReusableConfig(String name) + *
  • getReusableConfig(ReusableConfigName name) + *

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

*
    - *
  • getReusableConfigCallable() + *
  • getReusableConfigCallable() *

*
ListReusableConfigs

ListReusableConfigs

Lists [ReusableConfigs][google.cloud.security.privateca.v1beta1.ReusableConfig].

*

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

*
    - *
  • listReusableConfigs(ListReusableConfigsRequest request) + *
  • listReusableConfigs(ListReusableConfigsRequest request) *

*

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

*
    - *
  • listReusableConfigs(LocationName parent) - *
  • listReusableConfigs(String parent) + *
  • listReusableConfigs(LocationName parent) + *

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

*
    - *
  • listReusableConfigsPagedCallable() - *
  • listReusableConfigsCallable() + *
  • listReusableConfigsPagedCallable() + *

  • listReusableConfigsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-security-private-ca/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1beta1/stub/CertificateAuthorityServiceStubSettings.java b/java-security-private-ca/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1beta1/stub/CertificateAuthorityServiceStubSettings.java index 125313ba3219..cae5abc068f5 100644 --- a/java-security-private-ca/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1beta1/stub/CertificateAuthorityServiceStubSettings.java +++ b/java-security-private-ca/google-cloud-security-private-ca/src/main/java/com/google/cloud/security/privateca/v1beta1/stub/CertificateAuthorityServiceStubSettings.java @@ -681,6 +681,15 @@ public CertificateAuthorityServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -1084,7 +1093,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -1097,7 +1105,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -1630,6 +1637,15 @@ public UnaryCallSettings.Builder getCertific return listReusableConfigsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public CertificateAuthorityServiceStubSettings build() throws IOException { return new CertificateAuthorityServiceStubSettings(this); diff --git a/java-securitycenter-settings/README.md b/java-securitycenter-settings/README.md index bc8aa704eeb6..4c6a3236d110 100644 --- a/java-securitycenter-settings/README.md +++ b/java-securitycenter-settings/README.md @@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-preview-yellow [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-securitycenter-settings.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-securitycenter-settings/0.35.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-securitycenter-settings/0.36.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-securitycenter-settings/google-cloud-securitycenter-settings/src/main/java/com/google/cloud/securitycenter/settings/v1beta1/SecurityCenterSettingsServiceClient.java b/java-securitycenter-settings/google-cloud-securitycenter-settings/src/main/java/com/google/cloud/securitycenter/settings/v1beta1/SecurityCenterSettingsServiceClient.java index 5ba9ae6995f0..79e6d7a0e438 100644 --- a/java-securitycenter-settings/google-cloud-securitycenter-settings/src/main/java/com/google/cloud/securitycenter/settings/v1beta1/SecurityCenterSettingsServiceClient.java +++ b/java-securitycenter-settings/google-cloud-securitycenter-settings/src/main/java/com/google/cloud/securitycenter/settings/v1beta1/SecurityCenterSettingsServiceClient.java @@ -64,240 +64,241 @@ * calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
GetServiceAccount

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) + *
  • 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) + *
  • 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() + *
  • getServiceAccountCallable() *

*
GetSettings

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) + *
  • 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) + *
  • 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() + *
  • getSettingsCallable() *

*
UpdateSettings

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) + *
  • 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) + *
  • 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() + *
  • updateSettingsCallable() *

*
ResetSettings

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) + *
  • 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() + *
  • resetSettingsCallable() *

*
BatchGetSettings

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) + *
  • 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() + *
  • batchGetSettingsCallable() *

*
CalculateEffectiveSettings

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) + *
  • 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) + *
  • 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() + *
  • calculateEffectiveSettingsCallable() *

*
BatchCalculateEffectiveSettings

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) + *
  • 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() + *
  • batchCalculateEffectiveSettingsCallable() *

*
GetComponentSettings

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) + *
  • 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) + *
  • 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() + *
  • getComponentSettingsCallable() *

*
UpdateComponentSettings

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) + *
  • 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) + *
  • 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() + *
  • updateComponentSettingsCallable() *

*
ResetComponentSettings

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) + *
  • 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() + *
  • resetComponentSettingsCallable() *

*
CalculateEffectiveComponentSettings

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) + *
  • 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) + *
  • 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() + *
  • calculateEffectiveComponentSettingsCallable() *

*
ListDetectors

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) + *
  • 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) + *
  • 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() + *
  • listDetectorsPagedCallable() + *

  • listDetectorsCallable() *

*
ListComponents

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) + *
  • 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) + *
  • 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() + *
  • listComponentsPagedCallable() + *

  • listComponentsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-securitycenter-settings/google-cloud-securitycenter-settings/src/main/java/com/google/cloud/securitycenter/settings/v1beta1/stub/SecurityCenterSettingsServiceStubSettings.java b/java-securitycenter-settings/google-cloud-securitycenter-settings/src/main/java/com/google/cloud/securitycenter/settings/v1beta1/stub/SecurityCenterSettingsServiceStubSettings.java index f6f634076ba3..690460d6d35f 100644 --- a/java-securitycenter-settings/google-cloud-securitycenter-settings/src/main/java/com/google/cloud/securitycenter/settings/v1beta1/stub/SecurityCenterSettingsServiceStubSettings.java +++ b/java-securitycenter-settings/google-cloud-securitycenter-settings/src/main/java/com/google/cloud/securitycenter/settings/v1beta1/stub/SecurityCenterSettingsServiceStubSettings.java @@ -339,6 +339,15 @@ public SecurityCenterSettingsServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -573,7 +582,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -744,6 +752,15 @@ public UnaryCallSettings.Builder resetSettingsSetti return listComponentsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public SecurityCenterSettingsServiceStubSettings build() throws IOException { return new SecurityCenterSettingsServiceStubSettings(this); diff --git a/java-securitycenter/README.md b/java-securitycenter/README.md index 516f853903d3..066f41585e43 100644 --- a/java-securitycenter/README.md +++ b/java-securitycenter/README.md @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-securitycenter.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-securitycenter/2.40.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-securitycenter/2.41.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1/SecurityCenterClient.java b/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1/SecurityCenterClient.java index 564fef6ed2c7..a89ea9f9e3ba 100644 --- a/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1/SecurityCenterClient.java +++ b/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1/SecurityCenterClient.java @@ -74,880 +74,881 @@ * as threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
BulkMuteFindings

BulkMuteFindings

Kicks off an LRO to bulk mute findings for a parent based on a filter. The parent can be either an organization, folder or project. The findings matched by the filter will be muted after the LRO is done.

*

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

*
    - *
  • bulkMuteFindingsAsync(BulkMuteFindingsRequest request) + *
  • bulkMuteFindingsAsync(BulkMuteFindingsRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • bulkMuteFindingsAsync(ResourceName parent) - *
  • bulkMuteFindingsAsync(String parent) + *
  • bulkMuteFindingsAsync(ResourceName parent) + *

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

*
    - *
  • bulkMuteFindingsOperationCallable() - *
  • bulkMuteFindingsCallable() + *
  • bulkMuteFindingsOperationCallable() + *

  • bulkMuteFindingsCallable() *

*
CreateSecurityHealthAnalyticsCustomModule

CreateSecurityHealthAnalyticsCustomModule

Creates a resident SecurityHealthAnalyticsCustomModule at the scope of the given CRM parent, and also creates inherited SecurityHealthAnalyticsCustomModules for all CRM descendants of the given parent. These modules are enabled by default.

*

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

*
    - *
  • createSecurityHealthAnalyticsCustomModule(CreateSecurityHealthAnalyticsCustomModuleRequest request) + *
  • createSecurityHealthAnalyticsCustomModule(CreateSecurityHealthAnalyticsCustomModuleRequest request) *

*

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

*
    - *
  • createSecurityHealthAnalyticsCustomModule(SecurityHealthAnalyticsSettingsName parent, SecurityHealthAnalyticsCustomModule securityHealthAnalyticsCustomModule) - *
  • createSecurityHealthAnalyticsCustomModule(String parent, SecurityHealthAnalyticsCustomModule securityHealthAnalyticsCustomModule) + *
  • createSecurityHealthAnalyticsCustomModule(SecurityHealthAnalyticsSettingsName parent, SecurityHealthAnalyticsCustomModule securityHealthAnalyticsCustomModule) + *

  • createSecurityHealthAnalyticsCustomModule(String parent, SecurityHealthAnalyticsCustomModule securityHealthAnalyticsCustomModule) *

*

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

*
    - *
  • createSecurityHealthAnalyticsCustomModuleCallable() + *
  • createSecurityHealthAnalyticsCustomModuleCallable() *

*
CreateSource

CreateSource

Creates a source.

*

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

*
    - *
  • createSource(CreateSourceRequest request) + *
  • createSource(CreateSourceRequest request) *

*

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

*
    - *
  • createSource(OrganizationName parent, Source source) - *
  • createSource(String parent, Source source) + *
  • createSource(OrganizationName parent, Source source) + *

  • createSource(String parent, Source source) *

*

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

*
    - *
  • createSourceCallable() + *
  • createSourceCallable() *

*
CreateFinding

CreateFinding

Creates a finding. The corresponding source must exist for finding creation to succeed.

*

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

*
    - *
  • createFinding(CreateFindingRequest request) + *
  • createFinding(CreateFindingRequest request) *

*

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

*
    - *
  • createFinding(SourceName parent, String findingId, Finding finding) - *
  • createFinding(String parent, String findingId, Finding finding) + *
  • createFinding(SourceName parent, String findingId, Finding finding) + *

  • createFinding(String parent, String findingId, Finding finding) *

*

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

*
    - *
  • createFindingCallable() + *
  • createFindingCallable() *

*
CreateMuteConfig

CreateMuteConfig

Creates a mute config.

*

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

*
    - *
  • createMuteConfig(CreateMuteConfigRequest request) + *
  • createMuteConfig(CreateMuteConfigRequest request) *

*

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

*
    - *
  • createMuteConfig(FolderName parent, MuteConfig muteConfig) - *
  • createMuteConfig(OrganizationName parent, MuteConfig muteConfig) - *
  • createMuteConfig(ProjectName parent, MuteConfig muteConfig) - *
  • createMuteConfig(String parent, MuteConfig muteConfig) - *
  • createMuteConfig(FolderName parent, MuteConfig muteConfig, String muteConfigId) - *
  • createMuteConfig(OrganizationName parent, MuteConfig muteConfig, String muteConfigId) - *
  • createMuteConfig(ProjectName parent, MuteConfig muteConfig, String muteConfigId) - *
  • createMuteConfig(String parent, MuteConfig muteConfig, String muteConfigId) + *
  • createMuteConfig(FolderName parent, MuteConfig muteConfig) + *

  • createMuteConfig(OrganizationName parent, MuteConfig muteConfig) + *

  • createMuteConfig(ProjectName parent, MuteConfig muteConfig) + *

  • createMuteConfig(String parent, MuteConfig muteConfig) + *

  • createMuteConfig(FolderName parent, MuteConfig muteConfig, String muteConfigId) + *

  • createMuteConfig(OrganizationName parent, MuteConfig muteConfig, String muteConfigId) + *

  • createMuteConfig(ProjectName parent, MuteConfig muteConfig, String muteConfigId) + *

  • createMuteConfig(String parent, MuteConfig muteConfig, String muteConfigId) *

*

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

*
    - *
  • createMuteConfigCallable() + *
  • createMuteConfigCallable() *

*
CreateNotificationConfig

CreateNotificationConfig

Creates a notification config.

*

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

*
    - *
  • createNotificationConfig(CreateNotificationConfigRequest request) + *
  • createNotificationConfig(CreateNotificationConfigRequest request) *

*

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

*
    - *
  • createNotificationConfig(FolderName parent, NotificationConfig notificationConfig) - *
  • createNotificationConfig(OrganizationName parent, NotificationConfig notificationConfig) - *
  • createNotificationConfig(ProjectName parent, NotificationConfig notificationConfig) - *
  • createNotificationConfig(String parent, NotificationConfig notificationConfig) - *
  • createNotificationConfig(FolderName parent, String configId, NotificationConfig notificationConfig) - *
  • createNotificationConfig(OrganizationName parent, String configId, NotificationConfig notificationConfig) - *
  • createNotificationConfig(ProjectName parent, String configId, NotificationConfig notificationConfig) - *
  • createNotificationConfig(String parent, String configId, NotificationConfig notificationConfig) + *
  • createNotificationConfig(FolderName parent, NotificationConfig notificationConfig) + *

  • createNotificationConfig(OrganizationName parent, NotificationConfig notificationConfig) + *

  • createNotificationConfig(ProjectName parent, NotificationConfig notificationConfig) + *

  • createNotificationConfig(String parent, NotificationConfig notificationConfig) + *

  • createNotificationConfig(FolderName parent, String configId, NotificationConfig notificationConfig) + *

  • createNotificationConfig(OrganizationName parent, String configId, NotificationConfig notificationConfig) + *

  • createNotificationConfig(ProjectName parent, String configId, NotificationConfig notificationConfig) + *

  • createNotificationConfig(String parent, String configId, NotificationConfig notificationConfig) *

*

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

*
    - *
  • createNotificationConfigCallable() + *
  • createNotificationConfigCallable() *

*
DeleteMuteConfig

DeleteMuteConfig

Deletes an existing mute config.

*

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

*
    - *
  • deleteMuteConfig(DeleteMuteConfigRequest request) + *
  • deleteMuteConfig(DeleteMuteConfigRequest request) *

*

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

*
    - *
  • deleteMuteConfig(MuteConfigName name) - *
  • deleteMuteConfig(String name) + *
  • deleteMuteConfig(MuteConfigName name) + *

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

*
    - *
  • deleteMuteConfigCallable() + *
  • deleteMuteConfigCallable() *

*
DeleteNotificationConfig

DeleteNotificationConfig

Deletes a notification config.

*

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

*
    - *
  • deleteNotificationConfig(DeleteNotificationConfigRequest request) + *
  • deleteNotificationConfig(DeleteNotificationConfigRequest request) *

*

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

*
    - *
  • deleteNotificationConfig(NotificationConfigName name) - *
  • deleteNotificationConfig(String name) + *
  • deleteNotificationConfig(NotificationConfigName name) + *

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

*
    - *
  • deleteNotificationConfigCallable() + *
  • deleteNotificationConfigCallable() *

*
DeleteSecurityHealthAnalyticsCustomModule

DeleteSecurityHealthAnalyticsCustomModule

Deletes the specified SecurityHealthAnalyticsCustomModule and all of its descendants in the CRM hierarchy. This method is only supported for resident custom modules.

*

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

*
    - *
  • deleteSecurityHealthAnalyticsCustomModule(DeleteSecurityHealthAnalyticsCustomModuleRequest request) + *
  • deleteSecurityHealthAnalyticsCustomModule(DeleteSecurityHealthAnalyticsCustomModuleRequest request) *

*

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

*
    - *
  • deleteSecurityHealthAnalyticsCustomModule(SecurityHealthAnalyticsCustomModuleName name) - *
  • deleteSecurityHealthAnalyticsCustomModule(String name) + *
  • deleteSecurityHealthAnalyticsCustomModule(SecurityHealthAnalyticsCustomModuleName name) + *

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

*
    - *
  • deleteSecurityHealthAnalyticsCustomModuleCallable() + *
  • deleteSecurityHealthAnalyticsCustomModuleCallable() *

*
GetBigQueryExport

GetBigQueryExport

Gets a BigQuery export.

*

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

*
    - *
  • getBigQueryExport(GetBigQueryExportRequest request) + *
  • getBigQueryExport(GetBigQueryExportRequest request) *

*

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

*
    - *
  • getBigQueryExport(BigQueryExportName name) - *
  • getBigQueryExport(String name) + *
  • getBigQueryExport(BigQueryExportName name) + *

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

*
    - *
  • getBigQueryExportCallable() + *
  • getBigQueryExportCallable() *

*
GetIamPolicy

GetIamPolicy

Gets the access control policy on the specified Source.

*

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

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *
  • getIamPolicy(GetIamPolicyRequest request) *

*

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

*
    - *
  • getIamPolicy(ResourceName resource) - *
  • getIamPolicy(String resource) + *
  • getIamPolicy(ResourceName resource) + *

  • getIamPolicy(String resource) *

*

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

*
    - *
  • getIamPolicyCallable() + *
  • getIamPolicyCallable() *

*
GetMuteConfig

GetMuteConfig

Gets a mute config.

*

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

*
    - *
  • getMuteConfig(GetMuteConfigRequest request) + *
  • getMuteConfig(GetMuteConfigRequest request) *

*

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

*
    - *
  • getMuteConfig(MuteConfigName name) - *
  • getMuteConfig(String name) + *
  • getMuteConfig(MuteConfigName name) + *

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

*
    - *
  • getMuteConfigCallable() + *
  • getMuteConfigCallable() *

*
GetNotificationConfig

GetNotificationConfig

Gets a notification config.

*

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

*
    - *
  • getNotificationConfig(GetNotificationConfigRequest request) + *
  • getNotificationConfig(GetNotificationConfigRequest request) *

*

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

*
    - *
  • getNotificationConfig(NotificationConfigName name) - *
  • getNotificationConfig(String name) + *
  • getNotificationConfig(NotificationConfigName name) + *

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

*
    - *
  • getNotificationConfigCallable() + *
  • getNotificationConfigCallable() *

*
GetOrganizationSettings

GetOrganizationSettings

Gets the settings for an organization.

*

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

*
    - *
  • getOrganizationSettings(GetOrganizationSettingsRequest request) + *
  • getOrganizationSettings(GetOrganizationSettingsRequest request) *

*

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

*
    - *
  • getOrganizationSettings(OrganizationSettingsName name) - *
  • getOrganizationSettings(String name) + *
  • getOrganizationSettings(OrganizationSettingsName name) + *

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

*
    - *
  • getOrganizationSettingsCallable() + *
  • getOrganizationSettingsCallable() *

*
GetEffectiveSecurityHealthAnalyticsCustomModule

GetEffectiveSecurityHealthAnalyticsCustomModule

Retrieves an EffectiveSecurityHealthAnalyticsCustomModule.

*

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

*
    - *
  • getEffectiveSecurityHealthAnalyticsCustomModule(GetEffectiveSecurityHealthAnalyticsCustomModuleRequest request) + *
  • getEffectiveSecurityHealthAnalyticsCustomModule(GetEffectiveSecurityHealthAnalyticsCustomModuleRequest request) *

*

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

*
    - *
  • getEffectiveSecurityHealthAnalyticsCustomModule(EffectiveSecurityHealthAnalyticsCustomModuleName name) - *
  • getEffectiveSecurityHealthAnalyticsCustomModule(String name) + *
  • getEffectiveSecurityHealthAnalyticsCustomModule(EffectiveSecurityHealthAnalyticsCustomModuleName name) + *

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

*
    - *
  • getEffectiveSecurityHealthAnalyticsCustomModuleCallable() + *
  • getEffectiveSecurityHealthAnalyticsCustomModuleCallable() *

*
GetSecurityHealthAnalyticsCustomModule

GetSecurityHealthAnalyticsCustomModule

Retrieves a SecurityHealthAnalyticsCustomModule.

*

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

*
    - *
  • getSecurityHealthAnalyticsCustomModule(GetSecurityHealthAnalyticsCustomModuleRequest request) + *
  • getSecurityHealthAnalyticsCustomModule(GetSecurityHealthAnalyticsCustomModuleRequest request) *

*

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

*
    - *
  • getSecurityHealthAnalyticsCustomModule(SecurityHealthAnalyticsCustomModuleName name) - *
  • getSecurityHealthAnalyticsCustomModule(String name) + *
  • getSecurityHealthAnalyticsCustomModule(SecurityHealthAnalyticsCustomModuleName name) + *

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

*
    - *
  • getSecurityHealthAnalyticsCustomModuleCallable() + *
  • getSecurityHealthAnalyticsCustomModuleCallable() *

*
GetSource

GetSource

Gets a source.

*

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

*
    - *
  • getSource(GetSourceRequest request) + *
  • getSource(GetSourceRequest request) *

*

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

*
    - *
  • getSource(SourceName name) - *
  • getSource(String name) + *
  • getSource(SourceName name) + *

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

*
    - *
  • getSourceCallable() + *
  • getSourceCallable() *

*
GroupAssets

GroupAssets

Filters an organization's assets and groups them by their specified properties.

*

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

*
    - *
  • groupAssets(GroupAssetsRequest request) + *
  • groupAssets(GroupAssetsRequest request) *

*

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

*
    - *
  • groupAssetsPagedCallable() - *
  • groupAssetsCallable() + *
  • groupAssetsPagedCallable() + *

  • groupAssetsCallable() *

*
GroupFindings

GroupFindings

Filters an organization or source's findings and groups them by their specified properties. *

To group across all sources provide a `-` as the source id. Example: /v1/organizations/{organization_id}/sources/-/findings, /v1/folders/{folder_id}/sources/-/findings, /v1/projects/{project_id}/sources/-/findings

*

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

*
    - *
  • groupFindings(GroupFindingsRequest request) + *
  • groupFindings(GroupFindingsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • groupFindings(SourceName parent, String groupBy) - *
  • groupFindings(String parent, String groupBy) + *
  • groupFindings(SourceName parent, String groupBy) + *

  • groupFindings(String parent, String groupBy) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • groupFindingsPagedCallable() - *
  • groupFindingsCallable() + *
  • groupFindingsPagedCallable() + *

  • groupFindingsCallable() *

*
ListAssets

ListAssets

Lists an organization's assets.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listAssets(ListAssetsRequest request) + *
  • listAssets(ListAssetsRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • listAssetsPagedCallable() - *
  • listAssetsCallable() + *
  • listAssetsPagedCallable() + *

  • listAssetsCallable() *

*
ListDescendantSecurityHealthAnalyticsCustomModules

ListDescendantSecurityHealthAnalyticsCustomModules

Returns a list of all resident SecurityHealthAnalyticsCustomModules under the given CRM parent and all of the parent’s CRM descendants.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listDescendantSecurityHealthAnalyticsCustomModules(ListDescendantSecurityHealthAnalyticsCustomModulesRequest request) + *
  • listDescendantSecurityHealthAnalyticsCustomModules(ListDescendantSecurityHealthAnalyticsCustomModulesRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listDescendantSecurityHealthAnalyticsCustomModules(SecurityHealthAnalyticsSettingsName parent) - *
  • listDescendantSecurityHealthAnalyticsCustomModules(String parent) + *
  • listDescendantSecurityHealthAnalyticsCustomModules(SecurityHealthAnalyticsSettingsName parent) + *

  • listDescendantSecurityHealthAnalyticsCustomModules(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.

*
    - *
  • listDescendantSecurityHealthAnalyticsCustomModulesPagedCallable() - *
  • listDescendantSecurityHealthAnalyticsCustomModulesCallable() + *
  • listDescendantSecurityHealthAnalyticsCustomModulesPagedCallable() + *

  • listDescendantSecurityHealthAnalyticsCustomModulesCallable() *

*
ListFindings

ListFindings

Lists an organization or source's findings. *

To list across all sources provide a `-` as the source id. Example: /v1/organizations/{organization_id}/sources/-/findings

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listFindings(ListFindingsRequest request) + *
  • listFindings(ListFindingsRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • listFindingsPagedCallable() - *
  • listFindingsCallable() + *
  • listFindingsPagedCallable() + *

  • listFindingsCallable() *

*
ListMuteConfigs

ListMuteConfigs

Lists mute configs.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listMuteConfigs(ListMuteConfigsRequest request) + *
  • listMuteConfigs(ListMuteConfigsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listMuteConfigs(FolderName parent) - *
  • listMuteConfigs(OrganizationName parent) - *
  • listMuteConfigs(ProjectName parent) - *
  • listMuteConfigs(String parent) + *
  • listMuteConfigs(FolderName parent) + *

  • listMuteConfigs(OrganizationName parent) + *

  • listMuteConfigs(ProjectName parent) + *

  • listMuteConfigs(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.

*
    - *
  • listMuteConfigsPagedCallable() - *
  • listMuteConfigsCallable() + *
  • listMuteConfigsPagedCallable() + *

  • listMuteConfigsCallable() *

*
ListNotificationConfigs

ListNotificationConfigs

Lists notification configs.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listNotificationConfigs(ListNotificationConfigsRequest request) + *
  • listNotificationConfigs(ListNotificationConfigsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listNotificationConfigs(FolderName parent) - *
  • listNotificationConfigs(OrganizationName parent) - *
  • listNotificationConfigs(ProjectName parent) - *
  • listNotificationConfigs(String parent) + *
  • listNotificationConfigs(FolderName parent) + *

  • listNotificationConfigs(OrganizationName parent) + *

  • listNotificationConfigs(ProjectName parent) + *

  • listNotificationConfigs(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.

*
    - *
  • listNotificationConfigsPagedCallable() - *
  • listNotificationConfigsCallable() + *
  • listNotificationConfigsPagedCallable() + *

  • listNotificationConfigsCallable() *

*
ListEffectiveSecurityHealthAnalyticsCustomModules

ListEffectiveSecurityHealthAnalyticsCustomModules

Returns a list of all EffectiveSecurityHealthAnalyticsCustomModules for the given parent. This includes resident modules defined at the scope of the parent, and inherited modules, inherited from CRM ancestors.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listEffectiveSecurityHealthAnalyticsCustomModules(ListEffectiveSecurityHealthAnalyticsCustomModulesRequest request) + *
  • listEffectiveSecurityHealthAnalyticsCustomModules(ListEffectiveSecurityHealthAnalyticsCustomModulesRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listEffectiveSecurityHealthAnalyticsCustomModules(SecurityHealthAnalyticsSettingsName parent) - *
  • listEffectiveSecurityHealthAnalyticsCustomModules(String parent) + *
  • listEffectiveSecurityHealthAnalyticsCustomModules(SecurityHealthAnalyticsSettingsName parent) + *

  • listEffectiveSecurityHealthAnalyticsCustomModules(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.

*
    - *
  • listEffectiveSecurityHealthAnalyticsCustomModulesPagedCallable() - *
  • listEffectiveSecurityHealthAnalyticsCustomModulesCallable() + *
  • listEffectiveSecurityHealthAnalyticsCustomModulesPagedCallable() + *

  • listEffectiveSecurityHealthAnalyticsCustomModulesCallable() *

*
ListSecurityHealthAnalyticsCustomModules

ListSecurityHealthAnalyticsCustomModules

Returns a list of all SecurityHealthAnalyticsCustomModules for the given parent. This includes resident modules defined at the scope of the parent, and inherited modules, inherited from CRM ancestors.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listSecurityHealthAnalyticsCustomModules(ListSecurityHealthAnalyticsCustomModulesRequest request) + *
  • listSecurityHealthAnalyticsCustomModules(ListSecurityHealthAnalyticsCustomModulesRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listSecurityHealthAnalyticsCustomModules(SecurityHealthAnalyticsSettingsName parent) - *
  • listSecurityHealthAnalyticsCustomModules(String parent) + *
  • listSecurityHealthAnalyticsCustomModules(SecurityHealthAnalyticsSettingsName parent) + *

  • listSecurityHealthAnalyticsCustomModules(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.

*
    - *
  • listSecurityHealthAnalyticsCustomModulesPagedCallable() - *
  • listSecurityHealthAnalyticsCustomModulesCallable() + *
  • listSecurityHealthAnalyticsCustomModulesPagedCallable() + *

  • listSecurityHealthAnalyticsCustomModulesCallable() *

*
ListSources

ListSources

Lists all sources belonging to an organization.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listSources(ListSourcesRequest request) + *
  • listSources(ListSourcesRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listSources(FolderName parent) - *
  • listSources(OrganizationName parent) - *
  • listSources(ProjectName parent) - *
  • listSources(String parent) + *
  • listSources(FolderName parent) + *

  • listSources(OrganizationName parent) + *

  • listSources(ProjectName parent) + *

  • listSources(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.

*
    - *
  • listSourcesPagedCallable() - *
  • listSourcesCallable() + *
  • listSourcesPagedCallable() + *

  • listSourcesCallable() *

*
RunAssetDiscovery

RunAssetDiscovery

Runs asset discovery. The discovery is tracked with a long-running operation. *

This API can only be called with limited frequency for an organization. If it is called too frequently the caller will receive a TOO_MANY_REQUESTS error.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • runAssetDiscoveryAsync(RunAssetDiscoveryRequest request) + *
  • runAssetDiscoveryAsync(RunAssetDiscoveryRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • runAssetDiscoveryAsync(OrganizationName parent) - *
  • runAssetDiscoveryAsync(String parent) + *
  • runAssetDiscoveryAsync(OrganizationName parent) + *

  • runAssetDiscoveryAsync(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.

*
    - *
  • runAssetDiscoveryOperationCallable() - *
  • runAssetDiscoveryCallable() + *
  • runAssetDiscoveryOperationCallable() + *

  • runAssetDiscoveryCallable() *

*
SetFindingState

SetFindingState

Updates the state of a finding.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • setFindingState(SetFindingStateRequest request) + *
  • setFindingState(SetFindingStateRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • setFindingState(FindingName name, Finding.State state, Timestamp startTime) - *
  • setFindingState(String name, Finding.State state, Timestamp startTime) + *
  • setFindingState(FindingName name, Finding.State state, Timestamp startTime) + *

  • setFindingState(String name, Finding.State state, Timestamp startTime) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • setFindingStateCallable() + *
  • setFindingStateCallable() *

*
SetMute

SetMute

Updates the mute state of a finding.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • setMute(SetMuteRequest request) + *
  • setMute(SetMuteRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • setMute(FindingName name, Finding.Mute mute) - *
  • setMute(String name, Finding.Mute mute) + *
  • setMute(FindingName name, Finding.Mute mute) + *

  • setMute(String name, Finding.Mute mute) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • setMuteCallable() + *
  • setMuteCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the access control policy on the specified Source.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *
  • setIamPolicy(SetIamPolicyRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • setIamPolicy(ResourceName resource, Policy policy) - *
  • setIamPolicy(String resource, Policy policy) + *
  • setIamPolicy(ResourceName resource, Policy policy) + *

  • setIamPolicy(String resource, Policy policy) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • setIamPolicyCallable() + *
  • setIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns the permissions that a caller has on the specified source.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *
  • testIamPermissions(TestIamPermissionsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • testIamPermissions(ResourceName resource, List permissions) - *
  • testIamPermissions(String resource, List permissions) + *
  • testIamPermissions(ResourceName resource, List<String> permissions) + *

  • testIamPermissions(String resource, List<String> permissions) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • testIamPermissionsCallable() + *
  • testIamPermissionsCallable() *

*
SimulateSecurityHealthAnalyticsCustomModule

SimulateSecurityHealthAnalyticsCustomModule

Simulates a given SecurityHealthAnalyticsCustomModule and Resource.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • simulateSecurityHealthAnalyticsCustomModule(SimulateSecurityHealthAnalyticsCustomModuleRequest request) + *
  • simulateSecurityHealthAnalyticsCustomModule(SimulateSecurityHealthAnalyticsCustomModuleRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • simulateSecurityHealthAnalyticsCustomModule(String parent, CustomConfig customConfig, SimulateSecurityHealthAnalyticsCustomModuleRequest.SimulatedResource resource) + *
  • simulateSecurityHealthAnalyticsCustomModule(String parent, CustomConfig customConfig, SimulateSecurityHealthAnalyticsCustomModuleRequest.SimulatedResource resource) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • simulateSecurityHealthAnalyticsCustomModuleCallable() + *
  • simulateSecurityHealthAnalyticsCustomModuleCallable() *

*
UpdateExternalSystem

UpdateExternalSystem

Updates external system. This is for a given finding.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateExternalSystem(UpdateExternalSystemRequest request) + *
  • updateExternalSystem(UpdateExternalSystemRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateExternalSystem(ExternalSystem externalSystem, FieldMask updateMask) + *
  • updateExternalSystem(ExternalSystem externalSystem, 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.

*
    - *
  • updateExternalSystemCallable() + *
  • updateExternalSystemCallable() *

*
UpdateFinding

UpdateFinding

Creates or updates a finding. The corresponding source must exist for a finding creation to succeed.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateFinding(UpdateFindingRequest request) + *
  • updateFinding(UpdateFindingRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateFinding(Finding finding) + *
  • updateFinding(Finding finding) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • updateFindingCallable() + *
  • updateFindingCallable() *

*
UpdateMuteConfig

UpdateMuteConfig

Updates a mute config.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateMuteConfig(UpdateMuteConfigRequest request) + *
  • updateMuteConfig(UpdateMuteConfigRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateMuteConfig(MuteConfig muteConfig, FieldMask updateMask) + *
  • updateMuteConfig(MuteConfig muteConfig, 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.

*
    - *
  • updateMuteConfigCallable() + *
  • updateMuteConfigCallable() *

*
UpdateNotificationConfig

UpdateNotificationConfig

Updates a notification config. The following update fields are allowed: description, pubsub_topic, streaming_config.filter

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateNotificationConfig(UpdateNotificationConfigRequest request) + *
  • updateNotificationConfig(UpdateNotificationConfigRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateNotificationConfig(NotificationConfig notificationConfig) - *
  • updateNotificationConfig(NotificationConfig notificationConfig, FieldMask updateMask) + *
  • updateNotificationConfig(NotificationConfig notificationConfig) + *

  • updateNotificationConfig(NotificationConfig notificationConfig, 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.

*
    - *
  • updateNotificationConfigCallable() + *
  • updateNotificationConfigCallable() *

*
UpdateOrganizationSettings

UpdateOrganizationSettings

Updates an organization's settings.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateOrganizationSettings(UpdateOrganizationSettingsRequest request) + *
  • updateOrganizationSettings(UpdateOrganizationSettingsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateOrganizationSettings(OrganizationSettings organizationSettings) + *
  • updateOrganizationSettings(OrganizationSettings organizationSettings) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • updateOrganizationSettingsCallable() + *
  • updateOrganizationSettingsCallable() *

*
UpdateSecurityHealthAnalyticsCustomModule

UpdateSecurityHealthAnalyticsCustomModule

Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of "inherited"). Updating the display name and custom config of a module is supported on resident modules only.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateSecurityHealthAnalyticsCustomModule(UpdateSecurityHealthAnalyticsCustomModuleRequest request) + *
  • updateSecurityHealthAnalyticsCustomModule(UpdateSecurityHealthAnalyticsCustomModuleRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateSecurityHealthAnalyticsCustomModule(SecurityHealthAnalyticsCustomModule securityHealthAnalyticsCustomModule, FieldMask updateMask) + *
  • updateSecurityHealthAnalyticsCustomModule(SecurityHealthAnalyticsCustomModule securityHealthAnalyticsCustomModule, 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.

*
    - *
  • updateSecurityHealthAnalyticsCustomModuleCallable() + *
  • updateSecurityHealthAnalyticsCustomModuleCallable() *

*
UpdateSource

UpdateSource

Updates a source.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateSource(UpdateSourceRequest request) + *
  • updateSource(UpdateSourceRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateSource(Source source) + *
  • updateSource(Source source) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • updateSourceCallable() + *
  • updateSourceCallable() *

*
UpdateSecurityMarks

UpdateSecurityMarks

Updates security marks.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateSecurityMarks(UpdateSecurityMarksRequest request) + *
  • updateSecurityMarks(UpdateSecurityMarksRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateSecurityMarks(SecurityMarks securityMarks) + *
  • updateSecurityMarks(SecurityMarks securityMarks) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • updateSecurityMarksCallable() + *
  • updateSecurityMarksCallable() *

*
CreateBigQueryExport

CreateBigQueryExport

Creates a BigQuery export.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • createBigQueryExport(CreateBigQueryExportRequest request) + *
  • createBigQueryExport(CreateBigQueryExportRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • createBigQueryExport(FolderName parent, BigQueryExport bigQueryExport, String bigQueryExportId) - *
  • createBigQueryExport(OrganizationName parent, BigQueryExport bigQueryExport, String bigQueryExportId) - *
  • createBigQueryExport(ProjectName parent, BigQueryExport bigQueryExport, String bigQueryExportId) - *
  • createBigQueryExport(String parent, BigQueryExport bigQueryExport, String bigQueryExportId) + *
  • createBigQueryExport(FolderName parent, BigQueryExport bigQueryExport, String bigQueryExportId) + *

  • createBigQueryExport(OrganizationName parent, BigQueryExport bigQueryExport, String bigQueryExportId) + *

  • createBigQueryExport(ProjectName parent, BigQueryExport bigQueryExport, String bigQueryExportId) + *

  • createBigQueryExport(String parent, BigQueryExport bigQueryExport, String bigQueryExportId) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • createBigQueryExportCallable() + *
  • createBigQueryExportCallable() *

*
DeleteBigQueryExport

DeleteBigQueryExport

Deletes an existing BigQuery export.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • deleteBigQueryExport(DeleteBigQueryExportRequest request) + *
  • deleteBigQueryExport(DeleteBigQueryExportRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • deleteBigQueryExport(BigQueryExportName name) - *
  • deleteBigQueryExport(String name) + *
  • deleteBigQueryExport(BigQueryExportName name) + *

  • deleteBigQueryExport(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.

*
    - *
  • deleteBigQueryExportCallable() + *
  • deleteBigQueryExportCallable() *

*
UpdateBigQueryExport

UpdateBigQueryExport

Updates a BigQuery export.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateBigQueryExport(UpdateBigQueryExportRequest request) + *
  • updateBigQueryExport(UpdateBigQueryExportRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateBigQueryExport(BigQueryExport bigQueryExport, FieldMask updateMask) + *
  • updateBigQueryExport(BigQueryExport bigQueryExport, 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.

*
    - *
  • updateBigQueryExportCallable() + *
  • updateBigQueryExportCallable() *

*
ListBigQueryExports

ListBigQueryExports

Lists BigQuery exports. Note that when requesting BigQuery exports at a given level all exports under that level are also returned e.g. if requesting BigQuery exports under a folder, then all BigQuery exports immediately under the folder plus the ones created under the projects within the folder are returned.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listBigQueryExports(ListBigQueryExportsRequest request) + *
  • listBigQueryExports(ListBigQueryExportsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listBigQueryExports(FolderName parent) - *
  • listBigQueryExports(OrganizationName parent) - *
  • listBigQueryExports(ProjectName parent) - *
  • listBigQueryExports(String parent) + *
  • listBigQueryExports(FolderName parent) + *

  • listBigQueryExports(OrganizationName parent) + *

  • listBigQueryExports(ProjectName parent) + *

  • listBigQueryExports(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.

*
    - *
  • listBigQueryExportsPagedCallable() - *
  • listBigQueryExportsCallable() + *
  • listBigQueryExportsPagedCallable() + *

  • listBigQueryExportsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1/stub/SecurityCenterStubSettings.java b/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1/stub/SecurityCenterStubSettings.java index 3a432ab06389..582399f268ea 100644 --- a/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1/stub/SecurityCenterStubSettings.java +++ b/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1/stub/SecurityCenterStubSettings.java @@ -1355,6 +1355,15 @@ public SecurityCenterStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -1934,7 +1943,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -1947,7 +1955,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -2591,6 +2598,15 @@ public UnaryCallSettings.Builder updateSourceSettin return listBigQueryExportsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public SecurityCenterStubSettings build() throws IOException { return new SecurityCenterStubSettings(this); diff --git a/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1beta1/SecurityCenterClient.java b/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1beta1/SecurityCenterClient.java index a1bb2e3bbfbe..0cb4856b4d1a 100644 --- a/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1beta1/SecurityCenterClient.java +++ b/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1beta1/SecurityCenterClient.java @@ -69,343 +69,344 @@ * as threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
CreateSource

CreateSource

Creates a source.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • createSource(CreateSourceRequest request) + *
  • createSource(CreateSourceRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • createSource(OrganizationName parent, Source source) - *
  • createSource(String parent, Source source) + *
  • createSource(OrganizationName parent, Source source) + *

  • createSource(String parent, Source source) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • createSourceCallable() + *
  • createSourceCallable() *

*
CreateFinding

CreateFinding

Creates a finding. The corresponding source must exist for finding creation to succeed.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • createFinding(CreateFindingRequest request) + *
  • createFinding(CreateFindingRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • createFinding(SourceName parent, String findingId, Finding finding) - *
  • createFinding(String parent, String findingId, Finding finding) + *
  • createFinding(SourceName parent, String findingId, Finding finding) + *

  • createFinding(String parent, String findingId, Finding finding) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • createFindingCallable() + *
  • createFindingCallable() *

*
GetIamPolicy

GetIamPolicy

Gets the access control policy on the specified Source.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *
  • getIamPolicy(GetIamPolicyRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getIamPolicy(ResourceName resource) - *
  • getIamPolicy(String resource) + *
  • getIamPolicy(ResourceName resource) + *

  • getIamPolicy(String resource) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • getIamPolicyCallable() + *
  • getIamPolicyCallable() *

*
GetOrganizationSettings

GetOrganizationSettings

Gets the settings for an organization.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getOrganizationSettings(GetOrganizationSettingsRequest request) + *
  • getOrganizationSettings(GetOrganizationSettingsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getOrganizationSettings(OrganizationSettingsName name) - *
  • getOrganizationSettings(String name) + *
  • getOrganizationSettings(OrganizationSettingsName name) + *

  • getOrganizationSettings(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.

*
    - *
  • getOrganizationSettingsCallable() + *
  • getOrganizationSettingsCallable() *

*
GetSource

GetSource

Gets a source.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getSource(GetSourceRequest request) + *
  • getSource(GetSourceRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getSource(SourceName name) - *
  • getSource(String name) + *
  • getSource(SourceName name) + *

  • getSource(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.

*
    - *
  • getSourceCallable() + *
  • getSourceCallable() *

*
GroupAssets

GroupAssets

Filters an organization's assets and groups them by their specified properties.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • groupAssets(GroupAssetsRequest request) + *
  • groupAssets(GroupAssetsRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • groupAssetsPagedCallable() - *
  • groupAssetsCallable() + *
  • groupAssetsPagedCallable() + *

  • groupAssetsCallable() *

*
GroupFindings

GroupFindings

Filters an organization or source's findings and groups them by their specified properties. *

To group across all sources provide a `-` as the source id. Example: /v1beta1/organizations/{organization_id}/sources/-/findings

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • groupFindings(GroupFindingsRequest request) + *
  • groupFindings(GroupFindingsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • groupFindings(SourceName parent, String groupBy) - *
  • groupFindings(String parent, String groupBy) + *
  • groupFindings(SourceName parent, String groupBy) + *

  • groupFindings(String parent, String groupBy) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • groupFindingsPagedCallable() - *
  • groupFindingsCallable() + *
  • groupFindingsPagedCallable() + *

  • groupFindingsCallable() *

*
ListAssets

ListAssets

Lists an organization's assets.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listAssets(ListAssetsRequest request) + *
  • listAssets(ListAssetsRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • listAssetsPagedCallable() - *
  • listAssetsCallable() + *
  • listAssetsPagedCallable() + *

  • listAssetsCallable() *

*
ListFindings

ListFindings

Lists an organization or source's findings. *

To list across all sources provide a `-` as the source id. Example: /v1beta1/organizations/{organization_id}/sources/-/findings

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listFindings(ListFindingsRequest request) + *
  • listFindings(ListFindingsRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • listFindingsPagedCallable() - *
  • listFindingsCallable() + *
  • listFindingsPagedCallable() + *

  • listFindingsCallable() *

*
ListSources

ListSources

Lists all sources belonging to an organization.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listSources(ListSourcesRequest request) + *
  • listSources(ListSourcesRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listSources(OrganizationName parent) - *
  • listSources(String parent) + *
  • listSources(OrganizationName parent) + *

  • listSources(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.

*
    - *
  • listSourcesPagedCallable() - *
  • listSourcesCallable() + *
  • listSourcesPagedCallable() + *

  • listSourcesCallable() *

*
RunAssetDiscovery

RunAssetDiscovery

Runs asset discovery. The discovery is tracked with a long-running operation. *

This API can only be called with limited frequency for an organization. If it is called too frequently the caller will receive a TOO_MANY_REQUESTS error.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • runAssetDiscoveryAsync(RunAssetDiscoveryRequest request) + *
  • runAssetDiscoveryAsync(RunAssetDiscoveryRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • runAssetDiscoveryAsync(OrganizationName parent) - *
  • runAssetDiscoveryAsync(String parent) + *
  • runAssetDiscoveryAsync(OrganizationName parent) + *

  • runAssetDiscoveryAsync(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.

*
    - *
  • runAssetDiscoveryOperationCallable() - *
  • runAssetDiscoveryCallable() + *
  • runAssetDiscoveryOperationCallable() + *

  • runAssetDiscoveryCallable() *

*
SetFindingState

SetFindingState

Updates the state of a finding.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • setFindingState(SetFindingStateRequest request) + *
  • setFindingState(SetFindingStateRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • setFindingState(FindingName name, Finding.State state, Timestamp startTime) - *
  • setFindingState(String name, Finding.State state, Timestamp startTime) + *
  • setFindingState(FindingName name, Finding.State state, Timestamp startTime) + *

  • setFindingState(String name, Finding.State state, Timestamp startTime) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • setFindingStateCallable() + *
  • setFindingStateCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the access control policy on the specified Source.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *
  • setIamPolicy(SetIamPolicyRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • setIamPolicy(ResourceName resource, Policy policy) - *
  • setIamPolicy(String resource, Policy policy) + *
  • setIamPolicy(ResourceName resource, Policy policy) + *

  • setIamPolicy(String resource, Policy policy) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • setIamPolicyCallable() + *
  • setIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns the permissions that a caller has on the specified source.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *
  • testIamPermissions(TestIamPermissionsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • testIamPermissions(ResourceName resource, List permissions) - *
  • testIamPermissions(String resource, List permissions) + *
  • testIamPermissions(ResourceName resource, List<String> permissions) + *

  • testIamPermissions(String resource, List<String> permissions) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • testIamPermissionsCallable() + *
  • testIamPermissionsCallable() *

*
UpdateFinding

UpdateFinding

Creates or updates a finding. The corresponding source must exist for a finding creation to succeed.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateFinding(UpdateFindingRequest request) + *
  • updateFinding(UpdateFindingRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateFinding(Finding finding) + *
  • updateFinding(Finding finding) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • updateFindingCallable() + *
  • updateFindingCallable() *

*
UpdateOrganizationSettings

UpdateOrganizationSettings

Updates an organization's settings.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateOrganizationSettings(UpdateOrganizationSettingsRequest request) + *
  • updateOrganizationSettings(UpdateOrganizationSettingsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateOrganizationSettings(OrganizationSettings organizationSettings) + *
  • updateOrganizationSettings(OrganizationSettings organizationSettings) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • updateOrganizationSettingsCallable() + *
  • updateOrganizationSettingsCallable() *

*
UpdateSource

UpdateSource

Updates a source.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateSource(UpdateSourceRequest request) + *
  • updateSource(UpdateSourceRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateSource(Source source) + *
  • updateSource(Source source) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • updateSourceCallable() + *
  • updateSourceCallable() *

*
UpdateSecurityMarks

UpdateSecurityMarks

Updates security marks.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateSecurityMarks(UpdateSecurityMarksRequest request) + *
  • updateSecurityMarks(UpdateSecurityMarksRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateSecurityMarks(SecurityMarks securityMarks) + *
  • updateSecurityMarks(SecurityMarks securityMarks) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • updateSecurityMarksCallable() + *
  • updateSecurityMarksCallable() *

*
* *

See the individual methods for example code. diff --git a/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1beta1/stub/SecurityCenterStubSettings.java b/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1beta1/stub/SecurityCenterStubSettings.java index c2d5bd3b5f26..2c431b6e43ba 100644 --- a/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1beta1/stub/SecurityCenterStubSettings.java +++ b/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1beta1/stub/SecurityCenterStubSettings.java @@ -560,6 +560,15 @@ public SecurityCenterStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -888,7 +897,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -901,7 +909,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -1153,6 +1160,15 @@ public UnaryCallSettings.Builder updateSourceSettin return updateSecurityMarksSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public SecurityCenterStubSettings build() throws IOException { return new SecurityCenterStubSettings(this); diff --git a/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1p1beta1/SecurityCenterClient.java b/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1p1beta1/SecurityCenterClient.java index 0f53707053ac..bc86d4b90748 100644 --- a/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1p1beta1/SecurityCenterClient.java +++ b/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1p1beta1/SecurityCenterClient.java @@ -70,460 +70,461 @@ * as threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
CreateSource

CreateSource

Creates a source.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • createSource(CreateSourceRequest request) + *
  • createSource(CreateSourceRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • createSource(OrganizationName parent, Source source) - *
  • createSource(String parent, Source source) + *
  • createSource(OrganizationName parent, Source source) + *

  • createSource(String parent, Source source) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • createSourceCallable() + *
  • createSourceCallable() *

*
CreateFinding

CreateFinding

Creates a finding. The corresponding source must exist for finding creation to succeed.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • createFinding(CreateFindingRequest request) + *
  • createFinding(CreateFindingRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • createFinding(SourceName parent, Finding finding, String findingId) - *
  • createFinding(SourceName parent, String findingId, Finding finding) - *
  • createFinding(String parent, Finding finding, String findingId) - *
  • createFinding(String parent, String findingId, Finding finding) + *
  • createFinding(SourceName parent, Finding finding, String findingId) + *

  • createFinding(SourceName parent, String findingId, Finding finding) + *

  • createFinding(String parent, Finding finding, String findingId) + *

  • createFinding(String parent, String findingId, Finding finding) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • createFindingCallable() + *
  • createFindingCallable() *

*
CreateNotificationConfig

CreateNotificationConfig

Creates a notification config.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • createNotificationConfig(CreateNotificationConfigRequest request) + *
  • createNotificationConfig(CreateNotificationConfigRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • createNotificationConfig(OrganizationName parent, NotificationConfig notificationConfig) - *
  • createNotificationConfig(String parent, NotificationConfig notificationConfig) - *
  • createNotificationConfig(OrganizationName parent, String configId, NotificationConfig notificationConfig) - *
  • createNotificationConfig(String parent, String configId, NotificationConfig notificationConfig) + *
  • createNotificationConfig(OrganizationName parent, NotificationConfig notificationConfig) + *

  • createNotificationConfig(String parent, NotificationConfig notificationConfig) + *

  • createNotificationConfig(OrganizationName parent, String configId, NotificationConfig notificationConfig) + *

  • createNotificationConfig(String parent, String configId, NotificationConfig notificationConfig) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • createNotificationConfigCallable() + *
  • createNotificationConfigCallable() *

*
DeleteNotificationConfig

DeleteNotificationConfig

Deletes a notification config.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • deleteNotificationConfig(DeleteNotificationConfigRequest request) + *
  • deleteNotificationConfig(DeleteNotificationConfigRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • deleteNotificationConfig(NotificationConfigName name) - *
  • deleteNotificationConfig(String name) + *
  • deleteNotificationConfig(NotificationConfigName name) + *

  • deleteNotificationConfig(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.

*
    - *
  • deleteNotificationConfigCallable() + *
  • deleteNotificationConfigCallable() *

*
GetIamPolicy

GetIamPolicy

Gets the access control policy on the specified Source.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *
  • getIamPolicy(GetIamPolicyRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getIamPolicy(ResourceName resource) - *
  • getIamPolicy(String resource) + *
  • getIamPolicy(ResourceName resource) + *

  • getIamPolicy(String resource) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • getIamPolicyCallable() + *
  • getIamPolicyCallable() *

*
GetNotificationConfig

GetNotificationConfig

Gets a notification config.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getNotificationConfig(GetNotificationConfigRequest request) + *
  • getNotificationConfig(GetNotificationConfigRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getNotificationConfig(NotificationConfigName name) - *
  • getNotificationConfig(String name) + *
  • getNotificationConfig(NotificationConfigName name) + *

  • getNotificationConfig(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.

*
    - *
  • getNotificationConfigCallable() + *
  • getNotificationConfigCallable() *

*
GetOrganizationSettings

GetOrganizationSettings

Gets the settings for an organization.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getOrganizationSettings(GetOrganizationSettingsRequest request) + *
  • getOrganizationSettings(GetOrganizationSettingsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getOrganizationSettings(OrganizationSettingsName name) - *
  • getOrganizationSettings(String name) + *
  • getOrganizationSettings(OrganizationSettingsName name) + *

  • getOrganizationSettings(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.

*
    - *
  • getOrganizationSettingsCallable() + *
  • getOrganizationSettingsCallable() *

*
GetSource

GetSource

Gets a source.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getSource(GetSourceRequest request) + *
  • getSource(GetSourceRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getSource(SourceName name) - *
  • getSource(String name) + *
  • getSource(SourceName name) + *

  • getSource(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.

*
    - *
  • getSourceCallable() + *
  • getSourceCallable() *

*
GroupAssets

GroupAssets

Filters an organization's assets and groups them by their specified properties.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • groupAssets(GroupAssetsRequest request) + *
  • groupAssets(GroupAssetsRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • groupAssetsPagedCallable() - *
  • groupAssetsCallable() + *
  • groupAssetsPagedCallable() + *

  • groupAssetsCallable() *

*
GroupFindings

GroupFindings

Filters an organization or source's findings and groups them by their specified properties. *

To group across all sources provide a `-` as the source id. Example: /v1/organizations/{organization_id}/sources/-/findings, /v1/folders/{folder_id}/sources/-/findings, /v1/projects/{project_id}/sources/-/findings

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • groupFindings(GroupFindingsRequest request) + *
  • groupFindings(GroupFindingsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • groupFindings(SourceName parent, String groupBy) - *
  • groupFindings(String parent, String groupBy) + *
  • groupFindings(SourceName parent, String groupBy) + *

  • groupFindings(String parent, String groupBy) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • groupFindingsPagedCallable() - *
  • groupFindingsCallable() + *
  • groupFindingsPagedCallable() + *

  • groupFindingsCallable() *

*
ListAssets

ListAssets

Lists an organization's assets.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listAssets(ListAssetsRequest request) + *
  • listAssets(ListAssetsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listAssets(FolderName parent) - *
  • listAssets(OrganizationName parent) - *
  • listAssets(ProjectName parent) - *
  • listAssets(String parent) + *
  • listAssets(FolderName parent) + *

  • listAssets(OrganizationName parent) + *

  • listAssets(ProjectName parent) + *

  • listAssets(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.

*
    - *
  • listAssetsPagedCallable() - *
  • listAssetsCallable() + *
  • listAssetsPagedCallable() + *

  • listAssetsCallable() *

*
ListFindings

ListFindings

Lists an organization or source's findings. *

To list across all sources provide a `-` as the source id. Example: /v1p1beta1/organizations/{organization_id}/sources/-/findings

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listFindings(ListFindingsRequest request) + *
  • listFindings(ListFindingsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listFindings(SourceName parent) - *
  • listFindings(String parent) + *
  • listFindings(SourceName parent) + *

  • listFindings(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.

*
    - *
  • listFindingsPagedCallable() - *
  • listFindingsCallable() + *
  • listFindingsPagedCallable() + *

  • listFindingsCallable() *

*
ListNotificationConfigs

ListNotificationConfigs

Lists notification configs.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listNotificationConfigs(ListNotificationConfigsRequest request) + *
  • listNotificationConfigs(ListNotificationConfigsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listNotificationConfigs(OrganizationName parent) - *
  • listNotificationConfigs(String parent) + *
  • listNotificationConfigs(OrganizationName parent) + *

  • listNotificationConfigs(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.

*
    - *
  • listNotificationConfigsPagedCallable() - *
  • listNotificationConfigsCallable() + *
  • listNotificationConfigsPagedCallable() + *

  • listNotificationConfigsCallable() *

*
ListSources

ListSources

Lists all sources belonging to an organization.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listSources(ListSourcesRequest request) + *
  • listSources(ListSourcesRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listSources(FolderName parent) - *
  • listSources(OrganizationName parent) - *
  • listSources(ProjectName parent) - *
  • listSources(String parent) + *
  • listSources(FolderName parent) + *

  • listSources(OrganizationName parent) + *

  • listSources(ProjectName parent) + *

  • listSources(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.

*
    - *
  • listSourcesPagedCallable() - *
  • listSourcesCallable() + *
  • listSourcesPagedCallable() + *

  • listSourcesCallable() *

*
RunAssetDiscovery

RunAssetDiscovery

Runs asset discovery. The discovery is tracked with a long-running operation. *

This API can only be called with limited frequency for an organization. If it is called too frequently the caller will receive a TOO_MANY_REQUESTS error.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • runAssetDiscoveryAsync(RunAssetDiscoveryRequest request) + *
  • runAssetDiscoveryAsync(RunAssetDiscoveryRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • runAssetDiscoveryAsync(OrganizationName parent) - *
  • runAssetDiscoveryAsync(String parent) + *
  • runAssetDiscoveryAsync(OrganizationName parent) + *

  • runAssetDiscoveryAsync(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.

*
    - *
  • runAssetDiscoveryOperationCallable() - *
  • runAssetDiscoveryCallable() + *
  • runAssetDiscoveryOperationCallable() + *

  • runAssetDiscoveryCallable() *

*
SetFindingState

SetFindingState

Updates the state of a finding.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • setFindingState(SetFindingStateRequest request) + *
  • setFindingState(SetFindingStateRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • setFindingState(FindingName name, Finding.State state, Timestamp startTime) - *
  • setFindingState(String name, Finding.State state, Timestamp startTime) + *
  • setFindingState(FindingName name, Finding.State state, Timestamp startTime) + *

  • setFindingState(String name, Finding.State state, Timestamp startTime) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • setFindingStateCallable() + *
  • setFindingStateCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the access control policy on the specified Source.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *
  • setIamPolicy(SetIamPolicyRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • setIamPolicy(ResourceName resource, Policy policy) - *
  • setIamPolicy(String resource, Policy policy) + *
  • setIamPolicy(ResourceName resource, Policy policy) + *

  • setIamPolicy(String resource, Policy policy) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • setIamPolicyCallable() + *
  • setIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns the permissions that a caller has on the specified source.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *
  • testIamPermissions(TestIamPermissionsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • testIamPermissions(ResourceName resource, List permissions) - *
  • testIamPermissions(String resource, List permissions) + *
  • testIamPermissions(ResourceName resource, List<String> permissions) + *

  • testIamPermissions(String resource, List<String> permissions) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • testIamPermissionsCallable() + *
  • testIamPermissionsCallable() *

*
UpdateFinding

UpdateFinding

Creates or updates a finding. The corresponding source must exist for a finding creation to succeed.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateFinding(UpdateFindingRequest request) + *
  • updateFinding(UpdateFindingRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateFinding(Finding finding) - *
  • updateFinding(Finding finding, FieldMask updateMask) + *
  • updateFinding(Finding finding) + *

  • updateFinding(Finding finding, 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.

*
    - *
  • updateFindingCallable() + *
  • updateFindingCallable() *

*
UpdateNotificationConfig

UpdateNotificationConfig

Updates a notification config. The following update fields are allowed: description, pubsub_topic, streaming_config.filter

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateNotificationConfig(UpdateNotificationConfigRequest request) + *
  • updateNotificationConfig(UpdateNotificationConfigRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateNotificationConfig(NotificationConfig notificationConfig) - *
  • updateNotificationConfig(NotificationConfig notificationConfig, FieldMask updateMask) + *
  • updateNotificationConfig(NotificationConfig notificationConfig) + *

  • updateNotificationConfig(NotificationConfig notificationConfig, 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.

*
    - *
  • updateNotificationConfigCallable() + *
  • updateNotificationConfigCallable() *

*
UpdateOrganizationSettings

UpdateOrganizationSettings

Updates an organization's settings.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateOrganizationSettings(UpdateOrganizationSettingsRequest request) + *
  • updateOrganizationSettings(UpdateOrganizationSettingsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateOrganizationSettings(OrganizationSettings organizationSettings) + *
  • updateOrganizationSettings(OrganizationSettings organizationSettings) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • updateOrganizationSettingsCallable() + *
  • updateOrganizationSettingsCallable() *

*
UpdateSource

UpdateSource

Updates a source.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateSource(UpdateSourceRequest request) + *
  • updateSource(UpdateSourceRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateSource(Source source) - *
  • updateSource(Source source, FieldMask updateMask) + *
  • updateSource(Source source) + *

  • updateSource(Source source, 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.

*
    - *
  • updateSourceCallable() + *
  • updateSourceCallable() *

*
UpdateSecurityMarks

UpdateSecurityMarks

Updates security marks.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateSecurityMarks(UpdateSecurityMarksRequest request) + *
  • updateSecurityMarks(UpdateSecurityMarksRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateSecurityMarks(SecurityMarks securityMarks) - *
  • updateSecurityMarks(SecurityMarks securityMarks, FieldMask updateMask) + *
  • updateSecurityMarks(SecurityMarks securityMarks) + *

  • updateSecurityMarks(SecurityMarks securityMarks, 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.

*
    - *
  • updateSecurityMarksCallable() + *
  • updateSecurityMarksCallable() *

*
* *

See the individual methods for example code. diff --git a/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1p1beta1/stub/SecurityCenterStubSettings.java b/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1p1beta1/stub/SecurityCenterStubSettings.java index ae082464bc24..caef399c58aa 100644 --- a/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1p1beta1/stub/SecurityCenterStubSettings.java +++ b/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1p1beta1/stub/SecurityCenterStubSettings.java @@ -696,6 +696,15 @@ public SecurityCenterStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -1064,7 +1073,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -1077,7 +1085,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -1388,6 +1395,15 @@ public UnaryCallSettings.Builder updateSourceSettin return updateSecurityMarksSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public SecurityCenterStubSettings build() throws IOException { return new SecurityCenterStubSettings(this); diff --git a/java-securitycentermanagement/google-cloud-securitycentermanagement/src/main/java/com/google/cloud/securitycentermanagement/v1/SecurityCenterManagementClient.java b/java-securitycentermanagement/google-cloud-securitycentermanagement/src/main/java/com/google/cloud/securitycentermanagement/v1/SecurityCenterManagementClient.java index ddf2a3094059..1e68b3efaaef 100644 --- a/java-securitycentermanagement/google-cloud-securitycentermanagement/src/main/java/com/google/cloud/securitycentermanagement/v1/SecurityCenterManagementClient.java +++ b/java-securitycentermanagement/google-cloud-securitycentermanagement/src/main/java/com/google/cloud/securitycentermanagement/v1/SecurityCenterManagementClient.java @@ -67,396 +67,397 @@ * calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
ListEffectiveSecurityHealthAnalyticsCustomModules

ListEffectiveSecurityHealthAnalyticsCustomModules

Returns a list of all EffectiveSecurityHealthAnalyticsCustomModules for the given parent. This includes resident modules defined at the scope of the parent, and inherited modules, inherited from CRM ancestors (no descendants).

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listEffectiveSecurityHealthAnalyticsCustomModules(ListEffectiveSecurityHealthAnalyticsCustomModulesRequest request) + *
  • listEffectiveSecurityHealthAnalyticsCustomModules(ListEffectiveSecurityHealthAnalyticsCustomModulesRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listEffectiveSecurityHealthAnalyticsCustomModules(FolderLocationName parent) - *
  • listEffectiveSecurityHealthAnalyticsCustomModules(LocationName parent) - *
  • listEffectiveSecurityHealthAnalyticsCustomModules(OrganizationLocationName parent) - *
  • listEffectiveSecurityHealthAnalyticsCustomModules(String parent) + *
  • listEffectiveSecurityHealthAnalyticsCustomModules(FolderLocationName parent) + *

  • listEffectiveSecurityHealthAnalyticsCustomModules(LocationName parent) + *

  • listEffectiveSecurityHealthAnalyticsCustomModules(OrganizationLocationName parent) + *

  • listEffectiveSecurityHealthAnalyticsCustomModules(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.

*
    - *
  • listEffectiveSecurityHealthAnalyticsCustomModulesPagedCallable() - *
  • listEffectiveSecurityHealthAnalyticsCustomModulesCallable() + *
  • listEffectiveSecurityHealthAnalyticsCustomModulesPagedCallable() + *

  • listEffectiveSecurityHealthAnalyticsCustomModulesCallable() *

*
GetEffectiveSecurityHealthAnalyticsCustomModule

GetEffectiveSecurityHealthAnalyticsCustomModule

Gets details of a single EffectiveSecurityHealthAnalyticsCustomModule.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getEffectiveSecurityHealthAnalyticsCustomModule(GetEffectiveSecurityHealthAnalyticsCustomModuleRequest request) + *
  • getEffectiveSecurityHealthAnalyticsCustomModule(GetEffectiveSecurityHealthAnalyticsCustomModuleRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getEffectiveSecurityHealthAnalyticsCustomModule(EffectiveSecurityHealthAnalyticsCustomModuleName name) - *
  • getEffectiveSecurityHealthAnalyticsCustomModule(String name) + *
  • getEffectiveSecurityHealthAnalyticsCustomModule(EffectiveSecurityHealthAnalyticsCustomModuleName name) + *

  • getEffectiveSecurityHealthAnalyticsCustomModule(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.

*
    - *
  • getEffectiveSecurityHealthAnalyticsCustomModuleCallable() + *
  • getEffectiveSecurityHealthAnalyticsCustomModuleCallable() *

*
ListSecurityHealthAnalyticsCustomModules

ListSecurityHealthAnalyticsCustomModules

Returns a list of all SecurityHealthAnalyticsCustomModules for the given parent. This includes resident modules defined at the scope of the parent, and inherited modules, inherited from CRM ancestors (no descendants).

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listSecurityHealthAnalyticsCustomModules(ListSecurityHealthAnalyticsCustomModulesRequest request) + *
  • listSecurityHealthAnalyticsCustomModules(ListSecurityHealthAnalyticsCustomModulesRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listSecurityHealthAnalyticsCustomModules(FolderLocationName parent) - *
  • listSecurityHealthAnalyticsCustomModules(LocationName parent) - *
  • listSecurityHealthAnalyticsCustomModules(OrganizationLocationName parent) - *
  • listSecurityHealthAnalyticsCustomModules(String parent) + *
  • listSecurityHealthAnalyticsCustomModules(FolderLocationName parent) + *

  • listSecurityHealthAnalyticsCustomModules(LocationName parent) + *

  • listSecurityHealthAnalyticsCustomModules(OrganizationLocationName parent) + *

  • listSecurityHealthAnalyticsCustomModules(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.

*
    - *
  • listSecurityHealthAnalyticsCustomModulesPagedCallable() - *
  • listSecurityHealthAnalyticsCustomModulesCallable() + *
  • listSecurityHealthAnalyticsCustomModulesPagedCallable() + *

  • listSecurityHealthAnalyticsCustomModulesCallable() *

*
ListDescendantSecurityHealthAnalyticsCustomModules

ListDescendantSecurityHealthAnalyticsCustomModules

Returns a list of all resident SecurityHealthAnalyticsCustomModules under the given CRM parent and all of the parent’s CRM descendants.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listDescendantSecurityHealthAnalyticsCustomModules(ListDescendantSecurityHealthAnalyticsCustomModulesRequest request) + *
  • listDescendantSecurityHealthAnalyticsCustomModules(ListDescendantSecurityHealthAnalyticsCustomModulesRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listDescendantSecurityHealthAnalyticsCustomModules(FolderLocationName parent) - *
  • listDescendantSecurityHealthAnalyticsCustomModules(LocationName parent) - *
  • listDescendantSecurityHealthAnalyticsCustomModules(OrganizationLocationName parent) - *
  • listDescendantSecurityHealthAnalyticsCustomModules(String parent) + *
  • listDescendantSecurityHealthAnalyticsCustomModules(FolderLocationName parent) + *

  • listDescendantSecurityHealthAnalyticsCustomModules(LocationName parent) + *

  • listDescendantSecurityHealthAnalyticsCustomModules(OrganizationLocationName parent) + *

  • listDescendantSecurityHealthAnalyticsCustomModules(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.

*
    - *
  • listDescendantSecurityHealthAnalyticsCustomModulesPagedCallable() - *
  • listDescendantSecurityHealthAnalyticsCustomModulesCallable() + *
  • listDescendantSecurityHealthAnalyticsCustomModulesPagedCallable() + *

  • listDescendantSecurityHealthAnalyticsCustomModulesCallable() *

*
GetSecurityHealthAnalyticsCustomModule

GetSecurityHealthAnalyticsCustomModule

Retrieves a SecurityHealthAnalyticsCustomModule.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getSecurityHealthAnalyticsCustomModule(GetSecurityHealthAnalyticsCustomModuleRequest request) + *
  • getSecurityHealthAnalyticsCustomModule(GetSecurityHealthAnalyticsCustomModuleRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getSecurityHealthAnalyticsCustomModule(SecurityHealthAnalyticsCustomModuleName name) - *
  • getSecurityHealthAnalyticsCustomModule(String name) + *
  • getSecurityHealthAnalyticsCustomModule(SecurityHealthAnalyticsCustomModuleName name) + *

  • getSecurityHealthAnalyticsCustomModule(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.

*
    - *
  • getSecurityHealthAnalyticsCustomModuleCallable() + *
  • getSecurityHealthAnalyticsCustomModuleCallable() *

*
CreateSecurityHealthAnalyticsCustomModule

CreateSecurityHealthAnalyticsCustomModule

Creates a resident SecurityHealthAnalyticsCustomModule at the scope of the given CRM parent, and also creates inherited SecurityHealthAnalyticsCustomModules for all CRM descendants of the given parent. These modules are enabled by default.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • createSecurityHealthAnalyticsCustomModule(CreateSecurityHealthAnalyticsCustomModuleRequest request) + *
  • createSecurityHealthAnalyticsCustomModule(CreateSecurityHealthAnalyticsCustomModuleRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • createSecurityHealthAnalyticsCustomModule(FolderLocationName parent, SecurityHealthAnalyticsCustomModule securityHealthAnalyticsCustomModule) - *
  • createSecurityHealthAnalyticsCustomModule(LocationName parent, SecurityHealthAnalyticsCustomModule securityHealthAnalyticsCustomModule) - *
  • createSecurityHealthAnalyticsCustomModule(OrganizationLocationName parent, SecurityHealthAnalyticsCustomModule securityHealthAnalyticsCustomModule) - *
  • createSecurityHealthAnalyticsCustomModule(String parent, SecurityHealthAnalyticsCustomModule securityHealthAnalyticsCustomModule) + *
  • createSecurityHealthAnalyticsCustomModule(FolderLocationName parent, SecurityHealthAnalyticsCustomModule securityHealthAnalyticsCustomModule) + *

  • createSecurityHealthAnalyticsCustomModule(LocationName parent, SecurityHealthAnalyticsCustomModule securityHealthAnalyticsCustomModule) + *

  • createSecurityHealthAnalyticsCustomModule(OrganizationLocationName parent, SecurityHealthAnalyticsCustomModule securityHealthAnalyticsCustomModule) + *

  • createSecurityHealthAnalyticsCustomModule(String parent, SecurityHealthAnalyticsCustomModule securityHealthAnalyticsCustomModule) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • createSecurityHealthAnalyticsCustomModuleCallable() + *
  • createSecurityHealthAnalyticsCustomModuleCallable() *

*
UpdateSecurityHealthAnalyticsCustomModule

UpdateSecurityHealthAnalyticsCustomModule

Updates the SecurityHealthAnalyticsCustomModule under the given name based on the given update mask. Updating the enablement state is supported on both resident and inherited modules (though resident modules cannot have an enablement state of "inherited"). Updating the display name and custom config of a module is supported on resident modules only.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateSecurityHealthAnalyticsCustomModule(UpdateSecurityHealthAnalyticsCustomModuleRequest request) + *
  • updateSecurityHealthAnalyticsCustomModule(UpdateSecurityHealthAnalyticsCustomModuleRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateSecurityHealthAnalyticsCustomModule(SecurityHealthAnalyticsCustomModule securityHealthAnalyticsCustomModule, FieldMask updateMask) + *
  • updateSecurityHealthAnalyticsCustomModule(SecurityHealthAnalyticsCustomModule securityHealthAnalyticsCustomModule, 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.

*
    - *
  • updateSecurityHealthAnalyticsCustomModuleCallable() + *
  • updateSecurityHealthAnalyticsCustomModuleCallable() *

*
DeleteSecurityHealthAnalyticsCustomModule

DeleteSecurityHealthAnalyticsCustomModule

Deletes the specified SecurityHealthAnalyticsCustomModule and all of its descendants in the CRM hierarchy. This method is only supported for resident custom modules.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • deleteSecurityHealthAnalyticsCustomModule(DeleteSecurityHealthAnalyticsCustomModuleRequest request) + *
  • deleteSecurityHealthAnalyticsCustomModule(DeleteSecurityHealthAnalyticsCustomModuleRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • deleteSecurityHealthAnalyticsCustomModule(SecurityHealthAnalyticsCustomModuleName name) - *
  • deleteSecurityHealthAnalyticsCustomModule(String name) + *
  • deleteSecurityHealthAnalyticsCustomModule(SecurityHealthAnalyticsCustomModuleName name) + *

  • deleteSecurityHealthAnalyticsCustomModule(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.

*
    - *
  • deleteSecurityHealthAnalyticsCustomModuleCallable() + *
  • deleteSecurityHealthAnalyticsCustomModuleCallable() *

*
SimulateSecurityHealthAnalyticsCustomModule

SimulateSecurityHealthAnalyticsCustomModule

Simulates a given SecurityHealthAnalyticsCustomModule and Resource.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • simulateSecurityHealthAnalyticsCustomModule(SimulateSecurityHealthAnalyticsCustomModuleRequest request) + *
  • simulateSecurityHealthAnalyticsCustomModule(SimulateSecurityHealthAnalyticsCustomModuleRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • simulateSecurityHealthAnalyticsCustomModule(String parent, CustomConfig customConfig, SimulateSecurityHealthAnalyticsCustomModuleRequest.SimulatedResource resource) + *
  • simulateSecurityHealthAnalyticsCustomModule(String parent, CustomConfig customConfig, SimulateSecurityHealthAnalyticsCustomModuleRequest.SimulatedResource resource) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • simulateSecurityHealthAnalyticsCustomModuleCallable() + *
  • simulateSecurityHealthAnalyticsCustomModuleCallable() *

*
ListEffectiveEventThreatDetectionCustomModules

ListEffectiveEventThreatDetectionCustomModules

Lists all effective Event Threat Detection custom modules for the given parent. This includes resident modules defined at the scope of the parent along with modules inherited from its ancestors.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listEffectiveEventThreatDetectionCustomModules(ListEffectiveEventThreatDetectionCustomModulesRequest request) + *
  • listEffectiveEventThreatDetectionCustomModules(ListEffectiveEventThreatDetectionCustomModulesRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listEffectiveEventThreatDetectionCustomModules(FolderLocationName parent) - *
  • listEffectiveEventThreatDetectionCustomModules(LocationName parent) - *
  • listEffectiveEventThreatDetectionCustomModules(OrganizationLocationName parent) - *
  • listEffectiveEventThreatDetectionCustomModules(String parent) + *
  • listEffectiveEventThreatDetectionCustomModules(FolderLocationName parent) + *

  • listEffectiveEventThreatDetectionCustomModules(LocationName parent) + *

  • listEffectiveEventThreatDetectionCustomModules(OrganizationLocationName parent) + *

  • listEffectiveEventThreatDetectionCustomModules(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.

*
    - *
  • listEffectiveEventThreatDetectionCustomModulesPagedCallable() - *
  • listEffectiveEventThreatDetectionCustomModulesCallable() + *
  • listEffectiveEventThreatDetectionCustomModulesPagedCallable() + *

  • listEffectiveEventThreatDetectionCustomModulesCallable() *

*
GetEffectiveEventThreatDetectionCustomModule

GetEffectiveEventThreatDetectionCustomModule

Gets an effective ETD custom module. Retrieves the effective module at the given level. The difference between an EffectiveCustomModule and a CustomModule is that the fields for an EffectiveCustomModule are computed from ancestors if needed. For example, the enablement_state for a CustomModule can be either ENABLED, DISABLED, or INHERITED. Where as the enablement_state for an EffectiveCustomModule is always computed to ENABLED or DISABLED (the effective enablement_state).

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getEffectiveEventThreatDetectionCustomModule(GetEffectiveEventThreatDetectionCustomModuleRequest request) + *
  • getEffectiveEventThreatDetectionCustomModule(GetEffectiveEventThreatDetectionCustomModuleRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getEffectiveEventThreatDetectionCustomModule(EffectiveEventThreatDetectionCustomModuleName name) - *
  • getEffectiveEventThreatDetectionCustomModule(String name) + *
  • getEffectiveEventThreatDetectionCustomModule(EffectiveEventThreatDetectionCustomModuleName name) + *

  • getEffectiveEventThreatDetectionCustomModule(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.

*
    - *
  • getEffectiveEventThreatDetectionCustomModuleCallable() + *
  • getEffectiveEventThreatDetectionCustomModuleCallable() *

*
ListEventThreatDetectionCustomModules

ListEventThreatDetectionCustomModules

Lists all Event Threat Detection custom modules for the given Resource Manager parent. This includes resident modules defined at the scope of the parent along with modules inherited from ancestors.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listEventThreatDetectionCustomModules(ListEventThreatDetectionCustomModulesRequest request) + *
  • listEventThreatDetectionCustomModules(ListEventThreatDetectionCustomModulesRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listEventThreatDetectionCustomModules(FolderLocationName parent) - *
  • listEventThreatDetectionCustomModules(LocationName parent) - *
  • listEventThreatDetectionCustomModules(OrganizationLocationName parent) - *
  • listEventThreatDetectionCustomModules(String parent) + *
  • listEventThreatDetectionCustomModules(FolderLocationName parent) + *

  • listEventThreatDetectionCustomModules(LocationName parent) + *

  • listEventThreatDetectionCustomModules(OrganizationLocationName parent) + *

  • listEventThreatDetectionCustomModules(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.

*
    - *
  • listEventThreatDetectionCustomModulesPagedCallable() - *
  • listEventThreatDetectionCustomModulesCallable() + *
  • listEventThreatDetectionCustomModulesPagedCallable() + *

  • listEventThreatDetectionCustomModulesCallable() *

*
ListDescendantEventThreatDetectionCustomModules

ListDescendantEventThreatDetectionCustomModules

Lists all resident Event Threat Detection custom modules under the given Resource Manager parent and its descendants.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listDescendantEventThreatDetectionCustomModules(ListDescendantEventThreatDetectionCustomModulesRequest request) + *
  • listDescendantEventThreatDetectionCustomModules(ListDescendantEventThreatDetectionCustomModulesRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listDescendantEventThreatDetectionCustomModules(FolderLocationName parent) - *
  • listDescendantEventThreatDetectionCustomModules(LocationName parent) - *
  • listDescendantEventThreatDetectionCustomModules(OrganizationLocationName parent) - *
  • listDescendantEventThreatDetectionCustomModules(String parent) + *
  • listDescendantEventThreatDetectionCustomModules(FolderLocationName parent) + *

  • listDescendantEventThreatDetectionCustomModules(LocationName parent) + *

  • listDescendantEventThreatDetectionCustomModules(OrganizationLocationName parent) + *

  • listDescendantEventThreatDetectionCustomModules(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.

*
    - *
  • listDescendantEventThreatDetectionCustomModulesPagedCallable() - *
  • listDescendantEventThreatDetectionCustomModulesCallable() + *
  • listDescendantEventThreatDetectionCustomModulesPagedCallable() + *

  • listDescendantEventThreatDetectionCustomModulesCallable() *

*
GetEventThreatDetectionCustomModule

GetEventThreatDetectionCustomModule

Gets an Event Threat Detection custom module.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getEventThreatDetectionCustomModule(GetEventThreatDetectionCustomModuleRequest request) + *
  • getEventThreatDetectionCustomModule(GetEventThreatDetectionCustomModuleRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getEventThreatDetectionCustomModule(EventThreatDetectionCustomModuleName name) - *
  • getEventThreatDetectionCustomModule(String name) + *
  • getEventThreatDetectionCustomModule(EventThreatDetectionCustomModuleName name) + *

  • getEventThreatDetectionCustomModule(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.

*
    - *
  • getEventThreatDetectionCustomModuleCallable() + *
  • getEventThreatDetectionCustomModuleCallable() *

*
CreateEventThreatDetectionCustomModule

CreateEventThreatDetectionCustomModule

Creates a resident Event Threat Detection custom module at the scope of the given Resource Manager parent, and also creates inherited custom modules for all descendants of the given parent. These modules are enabled by default.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • createEventThreatDetectionCustomModule(CreateEventThreatDetectionCustomModuleRequest request) + *
  • createEventThreatDetectionCustomModule(CreateEventThreatDetectionCustomModuleRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • createEventThreatDetectionCustomModule(FolderLocationName parent, EventThreatDetectionCustomModule eventThreatDetectionCustomModule) - *
  • createEventThreatDetectionCustomModule(LocationName parent, EventThreatDetectionCustomModule eventThreatDetectionCustomModule) - *
  • createEventThreatDetectionCustomModule(OrganizationLocationName parent, EventThreatDetectionCustomModule eventThreatDetectionCustomModule) - *
  • createEventThreatDetectionCustomModule(String parent, EventThreatDetectionCustomModule eventThreatDetectionCustomModule) + *
  • createEventThreatDetectionCustomModule(FolderLocationName parent, EventThreatDetectionCustomModule eventThreatDetectionCustomModule) + *

  • createEventThreatDetectionCustomModule(LocationName parent, EventThreatDetectionCustomModule eventThreatDetectionCustomModule) + *

  • createEventThreatDetectionCustomModule(OrganizationLocationName parent, EventThreatDetectionCustomModule eventThreatDetectionCustomModule) + *

  • createEventThreatDetectionCustomModule(String parent, EventThreatDetectionCustomModule eventThreatDetectionCustomModule) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • createEventThreatDetectionCustomModuleCallable() + *
  • createEventThreatDetectionCustomModuleCallable() *

*
UpdateEventThreatDetectionCustomModule

UpdateEventThreatDetectionCustomModule

Updates the Event Threat Detection custom module with the given name based on the given update mask. Updating the enablement state is supported for both resident and inherited modules (though resident modules cannot have an enablement state of "inherited"). Updating the display name or configuration of a module is supported for resident modules only. The type of a module cannot be changed.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • updateEventThreatDetectionCustomModule(UpdateEventThreatDetectionCustomModuleRequest request) + *
  • updateEventThreatDetectionCustomModule(UpdateEventThreatDetectionCustomModuleRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • updateEventThreatDetectionCustomModule(EventThreatDetectionCustomModule eventThreatDetectionCustomModule, FieldMask updateMask) + *
  • updateEventThreatDetectionCustomModule(EventThreatDetectionCustomModule eventThreatDetectionCustomModule, 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.

*
    - *
  • updateEventThreatDetectionCustomModuleCallable() + *
  • updateEventThreatDetectionCustomModuleCallable() *

*
DeleteEventThreatDetectionCustomModule

DeleteEventThreatDetectionCustomModule

Deletes the specified Event Threat Detection custom module and all of its descendants in the Resource Manager hierarchy. This method is only supported for resident custom modules.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • deleteEventThreatDetectionCustomModule(DeleteEventThreatDetectionCustomModuleRequest request) + *
  • deleteEventThreatDetectionCustomModule(DeleteEventThreatDetectionCustomModuleRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • deleteEventThreatDetectionCustomModule(EventThreatDetectionCustomModuleName name) - *
  • deleteEventThreatDetectionCustomModule(String name) + *
  • deleteEventThreatDetectionCustomModule(EventThreatDetectionCustomModuleName name) + *

  • deleteEventThreatDetectionCustomModule(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.

*
    - *
  • deleteEventThreatDetectionCustomModuleCallable() + *
  • deleteEventThreatDetectionCustomModuleCallable() *

*
ValidateEventThreatDetectionCustomModule

ValidateEventThreatDetectionCustomModule

Validates the given Event Threat Detection custom module.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • validateEventThreatDetectionCustomModule(ValidateEventThreatDetectionCustomModuleRequest request) + *
  • validateEventThreatDetectionCustomModule(ValidateEventThreatDetectionCustomModuleRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • validateEventThreatDetectionCustomModuleCallable() + *
  • validateEventThreatDetectionCustomModuleCallable() *

*
ListLocations

ListLocations

Lists information about the supported locations for this service.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listLocations(ListLocationsRequest request) + *
  • listLocations(ListLocationsRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • listLocationsPagedCallable() - *
  • listLocationsCallable() + *
  • listLocationsPagedCallable() + *

  • listLocationsCallable() *

*
GetLocation

GetLocation

Gets information about a location.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getLocation(GetLocationRequest request) + *
  • getLocation(GetLocationRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • getLocationCallable() + *
  • getLocationCallable() *

*
* *

See the individual methods for example code. diff --git a/java-securitycentermanagement/google-cloud-securitycentermanagement/src/main/java/com/google/cloud/securitycentermanagement/v1/stub/SecurityCenterManagementStubSettings.java b/java-securitycentermanagement/google-cloud-securitycentermanagement/src/main/java/com/google/cloud/securitycentermanagement/v1/stub/SecurityCenterManagementStubSettings.java index 7379ee827fec..6e3881070950 100644 --- a/java-securitycentermanagement/google-cloud-securitycentermanagement/src/main/java/com/google/cloud/securitycentermanagement/v1/stub/SecurityCenterManagementStubSettings.java +++ b/java-securitycentermanagement/google-cloud-securitycentermanagement/src/main/java/com/google/cloud/securitycentermanagement/v1/stub/SecurityCenterManagementStubSettings.java @@ -991,6 +991,15 @@ public SecurityCenterManagementStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -1395,7 +1404,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -1408,7 +1416,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -1738,6 +1745,15 @@ public UnaryCallSettings.Builder getLocationSettin return getLocationSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public SecurityCenterManagementStubSettings build() throws IOException { return new SecurityCenterManagementStubSettings(this); diff --git a/java-service-control/README.md b/java-service-control/README.md index c8fd3223805d..8806d6a85ab9 100644 --- a/java-service-control/README.md +++ b/java-service-control/README.md @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-service-control.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-service-control/1.32.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-service-control/1.33.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v1/QuotaControllerClient.java b/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v1/QuotaControllerClient.java index 714bd8b1a492..393123f6867e 100644 --- a/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v1/QuotaControllerClient.java +++ b/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v1/QuotaControllerClient.java @@ -56,27 +56,28 @@ * close(). * * + * * * * * + * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
AllocateQuota

AllocateQuota

Attempts to allocate quota for the specified consumer. It should be called before the operation is executed. *

This method requires the `servicemanagement.services.quota` permission on the specified service. For more information, see [Cloud IAM](https://cloud.google.com/iam). *

**NOTE:** The client **must** fail-open on server errors `INTERNAL`, `UNKNOWN`, `DEADLINE_EXCEEDED`, and `UNAVAILABLE`. To ensure system reliability, the server may inject these errors to prohibit any hard dependency on the quota functionality.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • allocateQuota(AllocateQuotaRequest request) + *
  • allocateQuota(AllocateQuotaRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • allocateQuotaCallable() + *
  • allocateQuotaCallable() *

*
* *

See the individual methods for example code. diff --git a/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v1/ServiceControllerClient.java b/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v1/ServiceControllerClient.java index a24842268da1..2d8c1f15a27d 100644 --- a/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v1/ServiceControllerClient.java +++ b/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v1/ServiceControllerClient.java @@ -56,12 +56,14 @@ * close(). * * + * * * * * + * * - * + * * * * - * + * * * - * *
Methods
MethodDescriptionMethod Variants
Check

Check

Checks whether an operation on a service should be allowed to proceed based on the configuration of the service and related policies. It must be called before the operation is executed. *

If feasible, the client should cache the check results and reuse them for 60 seconds. In case of any server errors, the client should rely on the cached results for much longer time to avoid outage. WARNING: There is general 60s delay for the configuration and policy propagation, therefore callers MUST NOT depend on the `Check` method having the latest policy information. *

NOTE: the [CheckRequest][google.api.servicecontrol.v1.CheckRequest] has the size limit (wire-format byte size) of 1MB. @@ -69,16 +71,16 @@ *

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • check(CheckRequest request) + *
  • check(CheckRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • checkCallable() + *
  • checkCallable() *

*
Report

Report

Reports operation results to Google Service Control, such as logs and metrics. It should be called after an operation is completed. *

If feasible, the client should aggregate reporting data for up to 5 seconds to reduce API traffic. Limiting aggregation to 5 seconds is to reduce data loss during client crashes. Clients should carefully choose the aggregation time window to avoid data loss risk more than 0.01% for business and compliance reasons. *

NOTE: the [ReportRequest][google.api.servicecontrol.v1.ReportRequest] has the size limit (wire-format byte size) of 1MB. @@ -86,15 +88,14 @@ *

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • report(ReportRequest request) + *
  • report(ReportRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • reportCallable() + *
  • reportCallable() *

*
* *

See the individual methods for example code. diff --git a/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v1/stub/QuotaControllerStubSettings.java b/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v1/stub/QuotaControllerStubSettings.java index de777693121e..fced22a2c7b6 100644 --- a/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v1/stub/QuotaControllerStubSettings.java +++ b/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v1/stub/QuotaControllerStubSettings.java @@ -115,6 +115,15 @@ public QuotaControllerStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -268,7 +277,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -281,7 +289,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -318,6 +325,15 @@ public Builder applyToAllUnaryMethods( return allocateQuotaSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public QuotaControllerStubSettings build() throws IOException { return new QuotaControllerStubSettings(this); diff --git a/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v1/stub/ServiceControllerStubSettings.java b/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v1/stub/ServiceControllerStubSettings.java index 13b2ba02c0e4..6a9bb6f12393 100644 --- a/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v1/stub/ServiceControllerStubSettings.java +++ b/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v1/stub/ServiceControllerStubSettings.java @@ -124,6 +124,15 @@ public ServiceControllerStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -301,7 +310,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -314,7 +322,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -360,6 +367,15 @@ public UnaryCallSettings.Builder reportSettings() return reportSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public ServiceControllerStubSettings build() throws IOException { return new ServiceControllerStubSettings(this); diff --git a/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v2/ServiceControllerClient.java b/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v2/ServiceControllerClient.java index f442841a6b74..4cf5d6b42aa6 100644 --- a/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v2/ServiceControllerClient.java +++ b/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v2/ServiceControllerClient.java @@ -61,12 +61,14 @@ * close(). * * + * * * * * + * * - * + * * * * - * + * * * - * *
Methods
MethodDescriptionMethod Variants
Check

Check

Private Preview. This feature is only available for approved services. *

This method provides admission control for services that are integrated with [Service Infrastructure](https://cloud.google.com/service-infrastructure). It checks whether an operation should be allowed based on the service configuration and relevant policies. It must be called before the operation is executed. For more information, see [Admission Control](https://cloud.google.com/service-infrastructure/docs/admission-control). *

NOTE: The admission control has an expected policy propagation delay of 60s. The caller **must** not depend on the most recent policy changes. @@ -75,16 +77,16 @@ *

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • check(CheckRequest request) + *
  • check(CheckRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • checkCallable() + *
  • checkCallable() *

*
Report

Report

Private Preview. This feature is only available for approved services. *

This method provides telemetry reporting for services that are integrated with [Service Infrastructure](https://cloud.google.com/service-infrastructure). It reports a list of operations that have occurred on a service. It must be called after the operations have been executed. For more information, see [Telemetry Reporting](https://cloud.google.com/service-infrastructure/docs/telemetry-reporting). *

NOTE: The telemetry reporting has a hard limit of 1000 operations and 1MB per Report call. It is recommended to have no more than 100 operations per call. @@ -92,15 +94,14 @@ *

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • report(ReportRequest request) + *
  • report(ReportRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • reportCallable() + *
  • reportCallable() *

*
* *

See the individual methods for example code. diff --git a/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v2/stub/ServiceControllerStubSettings.java b/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v2/stub/ServiceControllerStubSettings.java index 01454776ee53..ad5592f85579 100644 --- a/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v2/stub/ServiceControllerStubSettings.java +++ b/java-service-control/google-cloud-service-control/src/main/java/com/google/api/servicecontrol/v2/stub/ServiceControllerStubSettings.java @@ -124,6 +124,15 @@ public ServiceControllerStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -294,7 +303,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -307,7 +315,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -353,6 +360,15 @@ public UnaryCallSettings.Builder reportSettings() return reportSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public ServiceControllerStubSettings build() throws IOException { return new ServiceControllerStubSettings(this); diff --git a/java-service-management/README.md b/java-service-management/README.md index d490b33cd1e2..0cfbeece6c3d 100644 --- a/java-service-management/README.md +++ b/java-service-management/README.md @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-service-management.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-service-management/3.30.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-service-management/3.31.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-service-management/google-cloud-service-management/src/main/java/com/google/cloud/api/servicemanagement/v1/ServiceManagerClient.java b/java-service-management/google-cloud-service-management/src/main/java/com/google/cloud/api/servicemanagement/v1/ServiceManagerClient.java index 5c2ba6aa5596..f1134480f08c 100644 --- a/java-service-management/google-cloud-service-management/src/main/java/com/google/cloud/api/servicemanagement/v1/ServiceManagerClient.java +++ b/java-service-management/google-cloud-service-management/src/main/java/com/google/cloud/api/servicemanagement/v1/ServiceManagerClient.java @@ -92,50 +92,52 @@ * as threads. In the example above, try-with-resources is used, which automatically calls close(). * * + * * * * * + * * - * + * * * * * - * + * * * * * - * + * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * * * - * *
Methods
MethodDescriptionMethod Variants
ListServices

ListServices

Lists managed services. *

Returns all public services. For authenticated users, also returns all services the calling user has "servicemanagement.services.get" permission for.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listServices(ListServicesRequest request) + *
  • listServices(ListServicesRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listServices(String producerProjectId, String consumerId) + *
  • listServices(String producerProjectId, String consumerId) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • listServicesPagedCallable() - *
  • listServicesCallable() + *
  • listServicesPagedCallable() + *

  • listServicesCallable() *

*
GetService

GetService

Gets a managed service. Authentication is required unless the service is public.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getService(GetServiceRequest request) + *
  • getService(GetServiceRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getService(String serviceName) + *
  • getService(String serviceName) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • getServiceCallable() + *
  • getServiceCallable() *

*
CreateService

CreateService

Creates a new managed service. *

A managed service is immutable, and is subject to mandatory 30-day data retention. You cannot move a service or recreate it within 30 days after deletion. *

One producer project can own no more than 500 services. For security and reliability purposes, a production service should be hosted in a dedicated producer project. @@ -143,175 +145,175 @@ *

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • createServiceAsync(CreateServiceRequest request) + *
  • createServiceAsync(CreateServiceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createServiceAsync(ManagedService service) + *
  • createServiceAsync(ManagedService service) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • createServiceOperationCallable() - *
  • createServiceCallable() + *
  • createServiceOperationCallable() + *

  • createServiceCallable() *

*
DeleteService

DeleteService

Deletes a managed service. This method will change the service to the `Soft-Delete` state for 30 days. Within this period, service producers may call [UndeleteService][google.api.servicemanagement.v1.ServiceManager.UndeleteService] to restore the service. After 30 days, the service will be permanently deleted. *

Operation<response: google.protobuf.Empty>

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • deleteServiceAsync(DeleteServiceRequest request) + *
  • deleteServiceAsync(DeleteServiceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • deleteServiceAsync(String serviceName) + *
  • deleteServiceAsync(String serviceName) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • deleteServiceOperationCallable() - *
  • deleteServiceCallable() + *
  • deleteServiceOperationCallable() + *

  • deleteServiceCallable() *

*
UndeleteService

UndeleteService

Revives a previously deleted managed service. The method restores the service using the configuration at the time the service was deleted. The target service must exist and must have been deleted within the last 30 days. *

Operation<response: UndeleteServiceResponse>

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • undeleteServiceAsync(UndeleteServiceRequest request) + *
  • undeleteServiceAsync(UndeleteServiceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • undeleteServiceAsync(String serviceName) + *
  • undeleteServiceAsync(String serviceName) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • undeleteServiceOperationCallable() - *
  • undeleteServiceCallable() + *
  • undeleteServiceOperationCallable() + *

  • undeleteServiceCallable() *

*
ListServiceConfigs

ListServiceConfigs

Lists the history of the service configuration for a managed service, from the newest to the oldest.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listServiceConfigs(ListServiceConfigsRequest request) + *
  • listServiceConfigs(ListServiceConfigsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listServiceConfigs(String serviceName) + *
  • listServiceConfigs(String serviceName) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • listServiceConfigsPagedCallable() - *
  • listServiceConfigsCallable() + *
  • listServiceConfigsPagedCallable() + *

  • listServiceConfigsCallable() *

*
GetServiceConfig

GetServiceConfig

Gets a service configuration (version) for a managed service.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getServiceConfig(GetServiceConfigRequest request) + *
  • getServiceConfig(GetServiceConfigRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getServiceConfig(String serviceName, String configId, GetServiceConfigRequest.ConfigView view) + *
  • getServiceConfig(String serviceName, String configId, GetServiceConfigRequest.ConfigView view) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • getServiceConfigCallable() + *
  • getServiceConfigCallable() *

*
CreateServiceConfig

CreateServiceConfig

Creates a new service configuration (version) for a managed service. This method only stores the service configuration. To roll out the service configuration to backend systems please call [CreateServiceRollout][google.api.servicemanagement.v1.ServiceManager.CreateServiceRollout]. *

Only the 100 most recent service configurations and ones referenced by existing rollouts are kept for each service. The rest will be deleted eventually.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • createServiceConfig(CreateServiceConfigRequest request) + *
  • createServiceConfig(CreateServiceConfigRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • createServiceConfig(String serviceName, Service serviceConfig) + *
  • createServiceConfig(String serviceName, Service serviceConfig) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • createServiceConfigCallable() + *
  • createServiceConfigCallable() *

*
SubmitConfigSource

SubmitConfigSource

Creates a new service configuration (version) for a managed service based on user-supplied configuration source files (for example: OpenAPI Specification). This method stores the source configurations as well as the generated service configuration. To rollout the service configuration to other services, please call [CreateServiceRollout][google.api.servicemanagement.v1.ServiceManager.CreateServiceRollout]. *

Only the 100 most recent configuration sources and ones referenced by existing service configurtions are kept for each service. The rest will be deleted eventually. *

Operation<response: SubmitConfigSourceResponse>

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • submitConfigSourceAsync(SubmitConfigSourceRequest request) + *
  • submitConfigSourceAsync(SubmitConfigSourceRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • submitConfigSourceAsync(String serviceName, ConfigSource configSource, boolean validateOnly) + *
  • submitConfigSourceAsync(String serviceName, ConfigSource configSource, boolean validateOnly) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • submitConfigSourceOperationCallable() - *
  • submitConfigSourceCallable() + *
  • submitConfigSourceOperationCallable() + *

  • submitConfigSourceCallable() *

*
ListServiceRollouts

ListServiceRollouts

Lists the history of the service configuration rollouts for a managed service, from the newest to the oldest.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • listServiceRollouts(ListServiceRolloutsRequest request) + *
  • listServiceRollouts(ListServiceRolloutsRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • listServiceRollouts(String serviceName, String filter) + *
  • listServiceRollouts(String serviceName, String filter) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • listServiceRolloutsPagedCallable() - *
  • listServiceRolloutsCallable() + *
  • listServiceRolloutsPagedCallable() + *

  • listServiceRolloutsCallable() *

*
GetServiceRollout

GetServiceRollout

Gets a service configuration [rollout][google.api.servicemanagement.v1.Rollout].

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getServiceRollout(GetServiceRolloutRequest request) + *
  • getServiceRollout(GetServiceRolloutRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • getServiceRollout(String serviceName, String rolloutId) + *
  • getServiceRollout(String serviceName, String rolloutId) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • getServiceRolloutCallable() + *
  • getServiceRolloutCallable() *

*
CreateServiceRollout

CreateServiceRollout

Creates a new service configuration rollout. Based on rollout, the Google Service Management will roll out the service configurations to different backend services. For example, the logging configuration will be pushed to Google Cloud Logging. *

Please note that any previous pending and running Rollouts and associated Operations will be automatically cancelled so that the latest Rollout will not be blocked by previous Rollouts. *

Only the 100 most recent (in any state) and the last 10 successful (if not already part of the set of 100 most recent) rollouts are kept for each service. The rest will be deleted eventually. @@ -319,83 +321,82 @@ *

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • createServiceRolloutAsync(CreateServiceRolloutRequest request) + *
  • createServiceRolloutAsync(CreateServiceRolloutRequest request) *

*

Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

*
    - *
  • createServiceRolloutAsync(String serviceName, Rollout rollout) + *
  • createServiceRolloutAsync(String serviceName, Rollout rollout) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • createServiceRolloutOperationCallable() - *
  • createServiceRolloutCallable() + *
  • createServiceRolloutOperationCallable() + *

  • createServiceRolloutCallable() *

*
GenerateConfigReport

GenerateConfigReport

Generates and returns a report (errors, warnings and changes from existing configurations) associated with GenerateConfigReportRequest.new_value *

If GenerateConfigReportRequest.old_value is specified, GenerateConfigReportRequest will contain a single ChangeReport based on the comparison between GenerateConfigReportRequest.new_value and GenerateConfigReportRequest.old_value. If GenerateConfigReportRequest.old_value is not specified, this method will compare GenerateConfigReportRequest.new_value with the last pushed service configuration.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • generateConfigReport(GenerateConfigReportRequest request) + *
  • generateConfigReport(GenerateConfigReportRequest request) *

*

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

*
    - *
  • generateConfigReport(Any newConfig, Any oldConfig) + *
  • generateConfigReport(Any newConfig, Any oldConfig) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • generateConfigReportCallable() + *
  • generateConfigReportCallable() *

*
SetIamPolicy

SetIamPolicy

Sets the access control policy on the specified resource. Replacesany existing policy. *

Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • setIamPolicy(SetIamPolicyRequest request) + *
  • setIamPolicy(SetIamPolicyRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • setIamPolicyCallable() + *
  • setIamPolicyCallable() *

*
GetIamPolicy

GetIamPolicy

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • getIamPolicy(GetIamPolicyRequest request) + *
  • getIamPolicy(GetIamPolicyRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • getIamPolicyCallable() + *
  • getIamPolicyCallable() *

*
TestIamPermissions

TestIamPermissions

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a `NOT_FOUND` error. *

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

*

Request object method variants only take one parameter, a request object, which must be constructed before the call.

*
    - *
  • testIamPermissions(TestIamPermissionsRequest request) + *
  • testIamPermissions(TestIamPermissionsRequest request) *

*

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

*
    - *
  • testIamPermissionsCallable() + *
  • testIamPermissionsCallable() *

*
* *

See the individual methods for example code. diff --git a/java-service-management/google-cloud-service-management/src/main/java/com/google/cloud/api/servicemanagement/v1/stub/ServiceManagerStubSettings.java b/java-service-management/google-cloud-service-management/src/main/java/com/google/cloud/api/servicemanagement/v1/stub/ServiceManagerStubSettings.java index 01118a0cb709..912bb98f7abd 100644 --- a/java-service-management/google-cloud-service-management/src/main/java/com/google/cloud/api/servicemanagement/v1/stub/ServiceManagerStubSettings.java +++ b/java-service-management/google-cloud-service-management/src/main/java/com/google/cloud/api/servicemanagement/v1/stub/ServiceManagerStubSettings.java @@ -485,6 +485,15 @@ public ServiceManagerStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + /** Returns the default service name. */ @Override public String getServiceName() { @@ -787,7 +796,6 @@ private static Builder createDefault() { builder.setTransportChannelProvider(defaultTransportChannelProvider()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -800,7 +808,6 @@ private static Builder createHttpJsonDefault() { builder.setTransportChannelProvider(defaultHttpJsonTransportProviderBuilder().build()); builder.setCredentialsProvider(defaultCredentialsProviderBuilder().build()); builder.setInternalHeaderProvider(defaultHttpJsonApiClientHeaderProviderBuilder().build()); - builder.setEndpoint(getDefaultEndpoint()); builder.setMtlsEndpoint(getDefaultMtlsEndpoint()); builder.setSwitchToMtlsEndpointAllowed(true); @@ -1163,6 +1170,15 @@ public UnaryCallSettings.Builder getIamPolicySettin return testIamPermissionsSettings; } + /** Returns the endpoint set by the user or the the service's default endpoint. */ + @Override + public String getEndpoint() { + if (super.getEndpoint() != null) { + return super.getEndpoint(); + } + return getDefaultEndpoint(); + } + @Override public ServiceManagerStubSettings build() throws IOException { return new ServiceManagerStubSettings(this);