diff --git a/java-cloudcommerceconsumerprocurement/README.md b/java-cloudcommerceconsumerprocurement/README.md index dbbbc609aae8..9cd587797602 100644 --- a/java-cloudcommerceconsumerprocurement/README.md +++ b/java-cloudcommerceconsumerprocurement/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-cloudcommerceconsumerprocurement.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-cloudcommerceconsumerprocurement/0.28.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-cloudcommerceconsumerprocurement/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-cloudcommerceconsumerprocurement/google-cloud-cloudcommerceconsumerprocurement/src/main/java/com/google/cloud/commerce/consumer/procurement/v1/ConsumerProcurementServiceClient.java b/java-cloudcommerceconsumerprocurement/google-cloud-cloudcommerceconsumerprocurement/src/main/java/com/google/cloud/commerce/consumer/procurement/v1/ConsumerProcurementServiceClient.java index df9fb68c5cd3..9b1263d461c8 100644 --- a/java-cloudcommerceconsumerprocurement/google-cloud-cloudcommerceconsumerprocurement/src/main/java/com/google/cloud/commerce/consumer/procurement/v1/ConsumerProcurementServiceClient.java +++ b/java-cloudcommerceconsumerprocurement/google-cloud-cloudcommerceconsumerprocurement/src/main/java/com/google/cloud/commerce/consumer/procurement/v1/ConsumerProcurementServiceClient.java @@ -67,19 +67,67 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
Method | + *Description | + *Method Variants | + *
---|---|---|
PlaceOrder | + *Creates a new [Order][google.cloud.commerce.consumer.procurement.v1.Order]. + * This API only supports GCP spend-based committed use discounts specified by GCP documentation. + * The returned long-running operation is in-progress until the backend completes the creation of the resource. Once completed, the order is in [OrderState.ORDER_STATE_ACTIVE][google.cloud.commerce.consumer.procurement.v1.OrderState.ORDER_STATE_ACTIVE]. In case of failure, the order resource will be removed. |
+ *
+ * Request object method variants only take one parameter, a request object, which must be constructed before the call. + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. + *
|
+ *
GetOrder | + *Returns the requested [Order][google.cloud.commerce.consumer.procurement.v1.Order] resource. |
+ *
+ * Request object method variants only take one parameter, a request object, which must be constructed before the call. + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. + *
|
+ *
ListOrders | + *Lists [Order][google.cloud.commerce.consumer.procurement.v1.Order] resources that the user has access to, within the scope of the parent resource. |
+ *
+ * Request object method variants only take one parameter, a request object, which must be constructed before the call. + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. + *
|
+ *
See the individual methods for example code. * diff --git a/java-cloudcommerceconsumerprocurement/google-cloud-cloudcommerceconsumerprocurement/src/main/java/com/google/cloud/commerce/consumer/procurement/v1/stub/ConsumerProcurementServiceStubSettings.java b/java-cloudcommerceconsumerprocurement/google-cloud-cloudcommerceconsumerprocurement/src/main/java/com/google/cloud/commerce/consumer/procurement/v1/stub/ConsumerProcurementServiceStubSettings.java index 6f43e8c781cb..5f47b2f317ca 100644 --- a/java-cloudcommerceconsumerprocurement/google-cloud-cloudcommerceconsumerprocurement/src/main/java/com/google/cloud/commerce/consumer/procurement/v1/stub/ConsumerProcurementServiceStubSettings.java +++ b/java-cloudcommerceconsumerprocurement/google-cloud-cloudcommerceconsumerprocurement/src/main/java/com/google/cloud/commerce/consumer/procurement/v1/stub/ConsumerProcurementServiceStubSettings.java @@ -207,6 +207,12 @@ public ConsumerProcurementServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "cloudcommerceconsumerprocurement"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-cloudcommerceconsumerprocurement/google-cloud-cloudcommerceconsumerprocurement/src/main/java/com/google/cloud/commerce/consumer/procurement/v1alpha1/ConsumerProcurementServiceClient.java b/java-cloudcommerceconsumerprocurement/google-cloud-cloudcommerceconsumerprocurement/src/main/java/com/google/cloud/commerce/consumer/procurement/v1alpha1/ConsumerProcurementServiceClient.java index 60e29a3e726c..7356b439125b 100644 --- a/java-cloudcommerceconsumerprocurement/google-cloud-cloudcommerceconsumerprocurement/src/main/java/com/google/cloud/commerce/consumer/procurement/v1alpha1/ConsumerProcurementServiceClient.java +++ b/java-cloudcommerceconsumerprocurement/google-cloud-cloudcommerceconsumerprocurement/src/main/java/com/google/cloud/commerce/consumer/procurement/v1alpha1/ConsumerProcurementServiceClient.java @@ -67,19 +67,67 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
Method | + *Description | + *Method Variants | + *
---|---|---|
PlaceOrder | + *Creates a new [Order][google.cloud.commerce.consumer.procurement.v1alpha1.Order]. + * This API only supports GCP spend-based committed use discounts specified by GCP documentation. + * The returned long-running operation is in-progress until the backend completes the creation of the resource. Once completed, the order is in [OrderState.ORDER_STATE_ACTIVE][google.cloud.commerce.consumer.procurement.v1alpha1.OrderState.ORDER_STATE_ACTIVE]. In case of failure, the order resource will be removed. |
+ *
+ * Request object method variants only take one parameter, a request object, which must be constructed before the call. + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. + *
|
+ *
GetOrder | + *Returns the requested [Order][google.cloud.commerce.consumer.procurement.v1alpha1.Order] resource. |
+ *
+ * Request object method variants only take one parameter, a request object, which must be constructed before the call. + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. + *
|
+ *
ListOrders | + *Lists [Order][google.cloud.commerce.consumer.procurement.v1alpha1.Order] resources that the user has access to, within the scope of the parent resource. |
+ *
+ * Request object method variants only take one parameter, a request object, which must be constructed before the call. + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. + *
|
+ *
See the individual methods for example code.
*
diff --git a/java-cloudcommerceconsumerprocurement/google-cloud-cloudcommerceconsumerprocurement/src/main/java/com/google/cloud/commerce/consumer/procurement/v1alpha1/stub/ConsumerProcurementServiceStubSettings.java b/java-cloudcommerceconsumerprocurement/google-cloud-cloudcommerceconsumerprocurement/src/main/java/com/google/cloud/commerce/consumer/procurement/v1alpha1/stub/ConsumerProcurementServiceStubSettings.java
index 37eadee5d4ee..28b2cdea71e9 100644
--- a/java-cloudcommerceconsumerprocurement/google-cloud-cloudcommerceconsumerprocurement/src/main/java/com/google/cloud/commerce/consumer/procurement/v1alpha1/stub/ConsumerProcurementServiceStubSettings.java
+++ b/java-cloudcommerceconsumerprocurement/google-cloud-cloudcommerceconsumerprocurement/src/main/java/com/google/cloud/commerce/consumer/procurement/v1alpha1/stub/ConsumerProcurementServiceStubSettings.java
@@ -208,6 +208,12 @@ public ConsumerProcurementServiceStub createStub() throws IOException {
"Transport not supported: %s", getTransportChannelProvider().getTransportName()));
}
+ /** Returns the default service name. */
+ @Override
+ public String getServiceName() {
+ return "cloudcommerceconsumerprocurement";
+ }
+
/** Returns a builder for the default ExecutorProvider for this service. */
public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() {
return InstantiatingExecutorProvider.newBuilder();
diff --git a/java-cloudquotas/README.md b/java-cloudquotas/README.md
index 8f5f80f6422a..acd2a9adba20 100644
--- a/java-cloudquotas/README.md
+++ b/java-cloudquotas/README.md
@@ -23,7 +23,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
Note: close() needs to be called on the CloudQuotasClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
Method | + *Description | + *Method Variants | + *
---|---|---|
ListQuotaInfos | + *Lists QuotaInfos of all quotas for a given project, folder or organization. |
+ *
+ * Request object method variants only take one parameter, a request object, which must be constructed before the call. + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. + *
|
+ *
GetQuotaInfo | + *Retrieve the QuotaInfo of a quota for a project, folder or organization. |
+ *
+ * Request object method variants only take one parameter, a request object, which must be constructed before the call. + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. + *
|
+ *
ListQuotaPreferences | + *Lists QuotaPreferences in a given project, folder or organization. |
+ *
+ * Request object method variants only take one parameter, a request object, which must be constructed before the call. + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. + *
|
+ *
GetQuotaPreference | + *Gets details of a single QuotaPreference. |
+ *
+ * Request object method variants only take one parameter, a request object, which must be constructed before the call. + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. + *
|
+ *
CreateQuotaPreference | + *Creates a new QuotaPreference that declares the desired value for a quota. |
+ *
+ * Request object method variants only take one parameter, a request object, which must be constructed before the call. + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. + *
|
+ *
UpdateQuotaPreference | + *Updates the parameters of a single QuotaPreference. It can updates the config in any states, not just the ones pending approval. |
+ *
+ * Request object method variants only take one parameter, a request object, which must be constructed before the call. + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. + *
|
+ *
See the individual methods for example code. * diff --git a/java-cloudquotas/google-cloud-cloudquotas/src/main/java/com/google/api/cloudquotas/v1/stub/CloudQuotasStubSettings.java b/java-cloudquotas/google-cloud-cloudquotas/src/main/java/com/google/api/cloudquotas/v1/stub/CloudQuotasStubSettings.java index 3bc84277a266..55137b67df82 100644 --- a/java-cloudquotas/google-cloud-cloudquotas/src/main/java/com/google/api/cloudquotas/v1/stub/CloudQuotasStubSettings.java +++ b/java-cloudquotas/google-cloud-cloudquotas/src/main/java/com/google/api/cloudquotas/v1/stub/CloudQuotasStubSettings.java @@ -296,6 +296,12 @@ public CloudQuotasStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "cloudquotas"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-cloudquotas/google-cloud-cloudquotas/src/test/java/com/google/api/cloudquotas/v1/CloudQuotasClientHttpJsonTest.java b/java-cloudquotas/google-cloud-cloudquotas/src/test/java/com/google/api/cloudquotas/v1/CloudQuotasClientHttpJsonTest.java index c508d8a30c94..5267c55afc0c 100644 --- a/java-cloudquotas/google-cloud-cloudquotas/src/test/java/com/google/api/cloudquotas/v1/CloudQuotasClientHttpJsonTest.java +++ b/java-cloudquotas/google-cloud-cloudquotas/src/test/java/com/google/api/cloudquotas/v1/CloudQuotasClientHttpJsonTest.java @@ -427,6 +427,7 @@ public void getQuotaPreferenceTest() throws Exception { .setQuotaId("quotaId664373683") .setReconciling(true) .setJustification("justification1864993522") + .setContactEmail("contactEmail1253690204") .build(); mockService.addResponse(expectedResponse); @@ -487,6 +488,7 @@ public void getQuotaPreferenceTest2() throws Exception { .setQuotaId("quotaId664373683") .setReconciling(true) .setJustification("justification1864993522") + .setContactEmail("contactEmail1253690204") .build(); mockService.addResponse(expectedResponse); @@ -545,6 +547,7 @@ public void createQuotaPreferenceTest() throws Exception { .setQuotaId("quotaId664373683") .setReconciling(true) .setJustification("justification1864993522") + .setContactEmail("contactEmail1253690204") .build(); mockService.addResponse(expectedResponse); @@ -603,6 +606,7 @@ public void createQuotaPreferenceTest2() throws Exception { .setQuotaId("quotaId664373683") .setReconciling(true) .setJustification("justification1864993522") + .setContactEmail("contactEmail1253690204") .build(); mockService.addResponse(expectedResponse); @@ -661,6 +665,7 @@ public void createQuotaPreferenceTest3() throws Exception { .setQuotaId("quotaId664373683") .setReconciling(true) .setJustification("justification1864993522") + .setContactEmail("contactEmail1253690204") .build(); mockService.addResponse(expectedResponse); @@ -722,6 +727,7 @@ public void createQuotaPreferenceTest4() throws Exception { .setQuotaId("quotaId664373683") .setReconciling(true) .setJustification("justification1864993522") + .setContactEmail("contactEmail1253690204") .build(); mockService.addResponse(expectedResponse); @@ -783,6 +789,7 @@ public void updateQuotaPreferenceTest() throws Exception { .setQuotaId("quotaId664373683") .setReconciling(true) .setJustification("justification1864993522") + .setContactEmail("contactEmail1253690204") .build(); mockService.addResponse(expectedResponse); @@ -801,6 +808,7 @@ public void updateQuotaPreferenceTest() throws Exception { .setQuotaId("quotaId664373683") .setReconciling(true) .setJustification("justification1864993522") + .setContactEmail("contactEmail1253690204") .build(); FieldMask updateMask = FieldMask.newBuilder().build(); @@ -845,6 +853,7 @@ public void updateQuotaPreferenceExceptionTest() throws Exception { .setQuotaId("quotaId664373683") .setReconciling(true) .setJustification("justification1864993522") + .setContactEmail("contactEmail1253690204") .build(); FieldMask updateMask = FieldMask.newBuilder().build(); client.updateQuotaPreference(quotaPreference, updateMask); diff --git a/java-cloudquotas/google-cloud-cloudquotas/src/test/java/com/google/api/cloudquotas/v1/CloudQuotasClientTest.java b/java-cloudquotas/google-cloud-cloudquotas/src/test/java/com/google/api/cloudquotas/v1/CloudQuotasClientTest.java index 3c735659a963..be94e24a8ac8 100644 --- a/java-cloudquotas/google-cloud-cloudquotas/src/test/java/com/google/api/cloudquotas/v1/CloudQuotasClientTest.java +++ b/java-cloudquotas/google-cloud-cloudquotas/src/test/java/com/google/api/cloudquotas/v1/CloudQuotasClientTest.java @@ -394,6 +394,7 @@ public void getQuotaPreferenceTest() throws Exception { .setQuotaId("quotaId664373683") .setReconciling(true) .setJustification("justification1864993522") + .setContactEmail("contactEmail1253690204") .build(); mockCloudQuotas.addResponse(expectedResponse); @@ -448,6 +449,7 @@ public void getQuotaPreferenceTest2() throws Exception { .setQuotaId("quotaId664373683") .setReconciling(true) .setJustification("justification1864993522") + .setContactEmail("contactEmail1253690204") .build(); mockCloudQuotas.addResponse(expectedResponse); @@ -498,6 +500,7 @@ public void createQuotaPreferenceTest() throws Exception { .setQuotaId("quotaId664373683") .setReconciling(true) .setJustification("justification1864993522") + .setContactEmail("contactEmail1253690204") .build(); mockCloudQuotas.addResponse(expectedResponse); @@ -552,6 +555,7 @@ public void createQuotaPreferenceTest2() throws Exception { .setQuotaId("quotaId664373683") .setReconciling(true) .setJustification("justification1864993522") + .setContactEmail("contactEmail1253690204") .build(); mockCloudQuotas.addResponse(expectedResponse); @@ -606,6 +610,7 @@ public void createQuotaPreferenceTest3() throws Exception { .setQuotaId("quotaId664373683") .setReconciling(true) .setJustification("justification1864993522") + .setContactEmail("contactEmail1253690204") .build(); mockCloudQuotas.addResponse(expectedResponse); @@ -664,6 +669,7 @@ public void createQuotaPreferenceTest4() throws Exception { .setQuotaId("quotaId664373683") .setReconciling(true) .setJustification("justification1864993522") + .setContactEmail("contactEmail1253690204") .build(); mockCloudQuotas.addResponse(expectedResponse); @@ -722,6 +728,7 @@ public void updateQuotaPreferenceTest() throws Exception { .setQuotaId("quotaId664373683") .setReconciling(true) .setJustification("justification1864993522") + .setContactEmail("contactEmail1253690204") .build(); mockCloudQuotas.addResponse(expectedResponse); diff --git a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/CloudquotasProto.java b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/CloudquotasProto.java index fd11bca1c1c5..1d7d92836c6c 100644 --- a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/CloudquotasProto.java +++ b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/CloudquotasProto.java @@ -164,23 +164,23 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "ganizations/*/locations/*/quotaPreferenc" + "es/*}:\020quota_preference\032N\312A\032cloudquotas." + "googleapis.com\322A.https://www.googleapis." - + "com/auth/cloud-platformB\346\004\n\035com.google.a" - + "pi.cloudquotas.v1B\020CloudquotasProtoP\001ZDg" - + "oogle.golang.org/genproto/googleapis/api" - + "/cloudquotas/v1;cloudquotas\252\002\033Google.Clo" - + "ud.CloudQuotas.V1\312\002\033Google\\Cloud\\CloudQu" - + "otas\\V1\352\002\036Google::Cloud::CloudQuotas::V1" - + "\352A\340\001\n\"cloudquotas.googleapis.com/Service" - + "\022:projects/{project}/locations/{location" - + "}/services/{service}\0228folders/{folder}/l" - + "ocations/{location}/services/{service}\022D" - + "organizations/{organization}/locations/{" - + "location}/services/{service}\352A\250\001\n#cloudq" - + "uotas.googleapis.com/Location\022\'projects/" - + "{project}/locations/{location}\022%folders/" - + "{folder}/locations/{location}\0221organizat" - + "ions/{organization}/locations/{location}" - + "b\006proto3" + + "com/auth/cloud-platformB\343\004\n\035com.google.a" + + "pi.cloudquotas.v1B\020CloudquotasProtoP\001ZAc" + + "loud.google.com/go/cloudquotas/apiv1/clo" + + "udquotaspb;cloudquotaspb\252\002\033Google.Cloud." + + "CloudQuotas.V1\312\002\033Google\\Cloud\\CloudQuota" + + "s\\V1\352\002\036Google::Cloud::CloudQuotas::V1\352A\340" + + "\001\n\"cloudquotas.googleapis.com/Service\022:p" + + "rojects/{project}/locations/{location}/s" + + "ervices/{service}\0228folders/{folder}/loca" + + "tions/{location}/services/{service}\022Dorg" + + "anizations/{organization}/locations/{loc" + + "ation}/services/{service}\352A\250\001\n#cloudquot" + + "as.googleapis.com/Location\022\'projects/{pr" + + "oject}/locations/{location}\022%folders/{fo" + + "lder}/locations/{location}\0221organization" + + "s/{organization}/locations/{location}b\006p" + + "roto3" }; descriptor = com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom( diff --git a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaConfig.java b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaConfig.java index 114d0a6dddf9..d623420aa4b4 100644 --- a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaConfig.java +++ b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaConfig.java @@ -366,10 +366,10 @@ public com.google.protobuf.Int64ValueOrBuilder getGrantedValueOrBuilder() { * * *
- * Output only. The trace id that the GCP uses to provision the requested - * quota. This trace id may be used by the client to contact Cloud support to - * track the state of a quota preference request. The trace id is only - * produced for increase requests and is unique for each request. The + * Output only. The trace id that the Google Cloud uses to provision the + * requested quota. This trace id may be used by the client to contact Cloud + * support to track the state of a quota preference request. The trace id is + * only produced for increase requests and is unique for each request. The * quota decrease requests do not have a trace id. ** @@ -393,10 +393,10 @@ public java.lang.String getTraceId() { * * *
- * Output only. The trace id that the GCP uses to provision the requested - * quota. This trace id may be used by the client to contact Cloud support to - * track the state of a quota preference request. The trace id is only - * produced for increase requests and is unique for each request. The + * Output only. The trace id that the Google Cloud uses to provision the + * requested quota. This trace id may be used by the client to contact Cloud + * support to track the state of a quota preference request. The trace id is + * only produced for increase requests and is unique for each request. The * quota decrease requests do not have a trace id. ** @@ -1434,10 +1434,10 @@ public com.google.protobuf.Int64ValueOrBuilder getGrantedValueOrBuilder() { * * *
- * Output only. The trace id that the GCP uses to provision the requested - * quota. This trace id may be used by the client to contact Cloud support to - * track the state of a quota preference request. The trace id is only - * produced for increase requests and is unique for each request. The + * Output only. The trace id that the Google Cloud uses to provision the + * requested quota. This trace id may be used by the client to contact Cloud + * support to track the state of a quota preference request. The trace id is + * only produced for increase requests and is unique for each request. The * quota decrease requests do not have a trace id. ** @@ -1460,10 +1460,10 @@ public java.lang.String getTraceId() { * * *
- * Output only. The trace id that the GCP uses to provision the requested - * quota. This trace id may be used by the client to contact Cloud support to - * track the state of a quota preference request. The trace id is only - * produced for increase requests and is unique for each request. The + * Output only. The trace id that the Google Cloud uses to provision the + * requested quota. This trace id may be used by the client to contact Cloud + * support to track the state of a quota preference request. The trace id is + * only produced for increase requests and is unique for each request. The * quota decrease requests do not have a trace id. ** @@ -1486,10 +1486,10 @@ public com.google.protobuf.ByteString getTraceIdBytes() { * * *
- * Output only. The trace id that the GCP uses to provision the requested - * quota. This trace id may be used by the client to contact Cloud support to - * track the state of a quota preference request. The trace id is only - * produced for increase requests and is unique for each request. The + * Output only. The trace id that the Google Cloud uses to provision the + * requested quota. This trace id may be used by the client to contact Cloud + * support to track the state of a quota preference request. The trace id is + * only produced for increase requests and is unique for each request. The * quota decrease requests do not have a trace id. ** @@ -1511,10 +1511,10 @@ public Builder setTraceId(java.lang.String value) { * * *
- * Output only. The trace id that the GCP uses to provision the requested - * quota. This trace id may be used by the client to contact Cloud support to - * track the state of a quota preference request. The trace id is only - * produced for increase requests and is unique for each request. The + * Output only. The trace id that the Google Cloud uses to provision the + * requested quota. This trace id may be used by the client to contact Cloud + * support to track the state of a quota preference request. The trace id is + * only produced for increase requests and is unique for each request. The * quota decrease requests do not have a trace id. ** @@ -1532,10 +1532,10 @@ public Builder clearTraceId() { * * *
- * Output only. The trace id that the GCP uses to provision the requested - * quota. This trace id may be used by the client to contact Cloud support to - * track the state of a quota preference request. The trace id is only - * produced for increase requests and is unique for each request. The + * Output only. The trace id that the Google Cloud uses to provision the + * requested quota. This trace id may be used by the client to contact Cloud + * support to track the state of a quota preference request. The trace id is + * only produced for increase requests and is unique for each request. The * quota decrease requests do not have a trace id. ** diff --git a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaConfigOrBuilder.java b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaConfigOrBuilder.java index 7c624820cb58..deeccff05be3 100644 --- a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaConfigOrBuilder.java +++ b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaConfigOrBuilder.java @@ -107,10 +107,10 @@ public interface QuotaConfigOrBuilder * * *
- * Output only. The trace id that the GCP uses to provision the requested - * quota. This trace id may be used by the client to contact Cloud support to - * track the state of a quota preference request. The trace id is only - * produced for increase requests and is unique for each request. The + * Output only. The trace id that the Google Cloud uses to provision the + * requested quota. This trace id may be used by the client to contact Cloud + * support to track the state of a quota preference request. The trace id is + * only produced for increase requests and is unique for each request. The * quota decrease requests do not have a trace id. ** @@ -123,10 +123,10 @@ public interface QuotaConfigOrBuilder * * *
- * Output only. The trace id that the GCP uses to provision the requested - * quota. This trace id may be used by the client to contact Cloud support to - * track the state of a quota preference request. The trace id is only - * produced for increase requests and is unique for each request. The + * Output only. The trace id that the Google Cloud uses to provision the + * requested quota. This trace id may be used by the client to contact Cloud + * support to track the state of a quota preference request. The trace id is + * only produced for increase requests and is unique for each request. The * quota decrease requests do not have a trace id. ** diff --git a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaIncreaseEligibility.java b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaIncreaseEligibility.java index d33d7675e113..0be24f589951 100644 --- a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaIncreaseEligibility.java +++ b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaIncreaseEligibility.java @@ -87,12 +87,12 @@ public enum IneligibilityReason implements com.google.protobuf.ProtocolMessageEn * * *
- * The container is not linked with a billing account. + * The container is not linked with a valid billing account. ** - *
NO_BILLING_ACCOUNT = 2;
+ * NO_VALID_BILLING_ACCOUNT = 1;
*/
- NO_BILLING_ACCOUNT(2),
+ NO_VALID_BILLING_ACCOUNT(1),
/**
*
*
@@ -100,9 +100,9 @@ public enum IneligibilityReason implements com.google.protobuf.ProtocolMessageEn
* Other reasons.
*
*
- * OTHER = 3;
+ * OTHER = 2;
*/
- OTHER(3),
+ OTHER(2),
UNRECOGNIZED(-1),
;
@@ -120,12 +120,12 @@ public enum IneligibilityReason implements com.google.protobuf.ProtocolMessageEn
*
*
* - * The container is not linked with a billing account. + * The container is not linked with a valid billing account. ** - *
NO_BILLING_ACCOUNT = 2;
+ * NO_VALID_BILLING_ACCOUNT = 1;
*/
- public static final int NO_BILLING_ACCOUNT_VALUE = 2;
+ public static final int NO_VALID_BILLING_ACCOUNT_VALUE = 1;
/**
*
*
@@ -133,9 +133,9 @@ public enum IneligibilityReason implements com.google.protobuf.ProtocolMessageEn
* Other reasons.
*
*
- * OTHER = 3;
+ * OTHER = 2;
*/
- public static final int OTHER_VALUE = 3;
+ public static final int OTHER_VALUE = 2;
public final int getNumber() {
if (this == UNRECOGNIZED) {
@@ -163,9 +163,9 @@ public static IneligibilityReason forNumber(int value) {
switch (value) {
case 0:
return INELIGIBILITY_REASON_UNSPECIFIED;
+ case 1:
+ return NO_VALID_BILLING_ACCOUNT;
case 2:
- return NO_BILLING_ACCOUNT;
- case 3:
return OTHER;
default:
return null;
diff --git a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaInfo.java b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaInfo.java
index 7bc0970d561f..2678df6d14ac 100644
--- a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaInfo.java
+++ b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaInfo.java
@@ -500,7 +500,7 @@ public boolean getIsPrecise() {
* * The reset time interval for the quota. Refresh interval applies to rate * quota only. - * Example: “minute” for per minute, “day” for per day, or “10 seconds” for + * Example: "minute" for per minute, "day" for per day, or "10 seconds" for * every 10 seconds. ** @@ -526,7 +526,7 @@ public java.lang.String getRefreshInterval() { *
* The reset time interval for the quota. Refresh interval applies to rate * quota only. - * Example: “minute” for per minute, “day” for per day, or “10 seconds” for + * Example: "minute" for per minute, "day" for per day, or "10 seconds" for * every 10 seconds. ** @@ -758,7 +758,7 @@ public com.google.protobuf.ByteString getQuotaDisplayNameBytes() { * * *
- * The unit in which the metric value is reported, e.g., “MByte”. + * The unit in which the metric value is reported, e.g., "MByte". ** *
string metric_unit = 11;
@@ -781,7 +781,7 @@ public java.lang.String getMetricUnit() {
*
*
* - * The unit in which the metric value is reported, e.g., “MByte”. + * The unit in which the metric value is reported, e.g., "MByte". ** *
string metric_unit = 11;
@@ -2329,7 +2329,7 @@ public Builder clearIsPrecise() {
* * The reset time interval for the quota. Refresh interval applies to rate * quota only. - * Example: “minute” for per minute, “day” for per day, or “10 seconds” for + * Example: "minute" for per minute, "day" for per day, or "10 seconds" for * every 10 seconds. ** @@ -2354,7 +2354,7 @@ public java.lang.String getRefreshInterval() { *
* The reset time interval for the quota. Refresh interval applies to rate * quota only. - * Example: “minute” for per minute, “day” for per day, or “10 seconds” for + * Example: "minute" for per minute, "day" for per day, or "10 seconds" for * every 10 seconds. ** @@ -2379,7 +2379,7 @@ public com.google.protobuf.ByteString getRefreshIntervalBytes() { *
* The reset time interval for the quota. Refresh interval applies to rate * quota only. - * Example: “minute” for per minute, “day” for per day, or “10 seconds” for + * Example: "minute" for per minute, "day" for per day, or "10 seconds" for * every 10 seconds. ** @@ -2403,7 +2403,7 @@ public Builder setRefreshInterval(java.lang.String value) { *
* The reset time interval for the quota. Refresh interval applies to rate * quota only. - * Example: “minute” for per minute, “day” for per day, or “10 seconds” for + * Example: "minute" for per minute, "day" for per day, or "10 seconds" for * every 10 seconds. ** @@ -2423,7 +2423,7 @@ public Builder clearRefreshInterval() { *
* The reset time interval for the quota. Refresh interval applies to rate * quota only. - * Example: “minute” for per minute, “day” for per day, or “10 seconds” for + * Example: "minute" for per minute, "day" for per day, or "10 seconds" for * every 10 seconds. ** @@ -2926,7 +2926,7 @@ public Builder setQuotaDisplayNameBytes(com.google.protobuf.ByteString value) { * * *
- * The unit in which the metric value is reported, e.g., “MByte”. + * The unit in which the metric value is reported, e.g., "MByte". ** *
string metric_unit = 11;
@@ -2948,7 +2948,7 @@ public java.lang.String getMetricUnit() {
*
*
* - * The unit in which the metric value is reported, e.g., “MByte”. + * The unit in which the metric value is reported, e.g., "MByte". ** *
string metric_unit = 11;
@@ -2970,7 +2970,7 @@ public com.google.protobuf.ByteString getMetricUnitBytes() {
*
*
* - * The unit in which the metric value is reported, e.g., “MByte”. + * The unit in which the metric value is reported, e.g., "MByte". ** *
string metric_unit = 11;
@@ -2991,7 +2991,7 @@ public Builder setMetricUnit(java.lang.String value) {
*
*
* - * The unit in which the metric value is reported, e.g., “MByte”. + * The unit in which the metric value is reported, e.g., "MByte". ** *
string metric_unit = 11;
@@ -3008,7 +3008,7 @@ public Builder clearMetricUnit() {
*
*
* - * The unit in which the metric value is reported, e.g., “MByte”. + * The unit in which the metric value is reported, e.g., "MByte". ** *
string metric_unit = 11;
diff --git a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaInfoOrBuilder.java b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaInfoOrBuilder.java
index 803ba50321e8..b97afaa93292 100644
--- a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaInfoOrBuilder.java
+++ b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaInfoOrBuilder.java
@@ -157,7 +157,7 @@ public interface QuotaInfoOrBuilder
* * The reset time interval for the quota. Refresh interval applies to rate * quota only. - * Example: “minute” for per minute, “day” for per day, or “10 seconds” for + * Example: "minute" for per minute, "day" for per day, or "10 seconds" for * every 10 seconds. ** @@ -172,7 +172,7 @@ public interface QuotaInfoOrBuilder *
* The reset time interval for the quota. Refresh interval applies to rate * quota only. - * Example: “minute” for per minute, “day” for per day, or “10 seconds” for + * Example: "minute" for per minute, "day" for per day, or "10 seconds" for * every 10 seconds. ** @@ -312,7 +312,7 @@ public interface QuotaInfoOrBuilder * * *
- * The unit in which the metric value is reported, e.g., “MByte”. + * The unit in which the metric value is reported, e.g., "MByte". ** *
string metric_unit = 11;
@@ -324,7 +324,7 @@ public interface QuotaInfoOrBuilder
*
*
* - * The unit in which the metric value is reported, e.g., “MByte”. + * The unit in which the metric value is reported, e.g., "MByte". ** *
string metric_unit = 11;
diff --git a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaPreference.java b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaPreference.java
index 2e4099d974bb..bedd5479aa51 100644
--- a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaPreference.java
+++ b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaPreference.java
@@ -45,6 +45,7 @@ private QuotaPreference() {
service_ = "";
quotaId_ = "";
justification_ = "";
+ contactEmail_ = "";
}
@java.lang.Override
@@ -169,7 +170,7 @@ public int getDimensionsCount() {
*
* * The dimensions that this quota preference applies to. The key of the map - * entry is the name of a dimension, such as "region", "zone", “network_id”, + * entry is the name of a dimension, such as "region", "zone", "network_id", * and the value of the map entry is the dimension value. * * If a dimension is missing from the map of dimensions, the quota preference @@ -204,7 +205,7 @@ public java.util.MapgetDimensions() { * * * The dimensions that this quota preference applies to. The key of the map - * entry is the name of a dimension, such as "region", "zone", “network_id”, + * entry is the name of a dimension, such as "region", "zone", "network_id", * and the value of the map entry is the dimension value. * * If a dimension is missing from the map of dimensions, the quota preference @@ -230,7 +231,7 @@ public java.util.MapgetDimensionsMap() { * * * The dimensions that this quota preference applies to. The key of the map - * entry is the name of a dimension, such as "region", "zone", “network_id”, + * entry is the name of a dimension, such as "region", "zone", "network_id", * and the value of the map entry is the dimension value. * * If a dimension is missing from the map of dimensions, the quota preference @@ -263,7 +264,7 @@ public java.util.MapgetDimensionsMap() { * * * The dimensions that this quota preference applies to. The key of the map - * entry is the name of a dimension, such as "region", "zone", “network_id”, + * entry is the name of a dimension, such as "region", "zone", "network_id", * and the value of the map entry is the dimension value. * * If a dimension is missing from the map of dimensions, the quota preference @@ -613,7 +614,8 @@ public com.google.protobuf.ByteString getQuotaIdBytes() { * * *- * Output only. Is the quota preference pending GCP approval and fulfillment. + * Output only. Is the quota preference pending Google Cloud approval and + * fulfillment. ** *bool reconciling = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -676,6 +678,73 @@ public com.google.protobuf.ByteString getJustificationBytes() { } } + public static final int CONTACT_EMAIL_FIELD_NUMBER = 12; + + @SuppressWarnings("serial") + private volatile java.lang.Object contactEmail_ = ""; + /** + * + * + *+ * Required. Input only. An email address that can be used for quota related + * communication between the Google Cloud and the user in case the Google + * Cloud needs further information to make a decision on whether the user + * preferred quota can be granted. + * + * The Google account for the email address must have quota update permission + * for the project, folder or organization this quota preference is for. + *+ * + *+ * string contact_email = 12 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = REQUIRED]; + *
+ * + * @return The contactEmail. + */ + @java.lang.Override + public java.lang.String getContactEmail() { + java.lang.Object ref = contactEmail_; + if (ref instanceof java.lang.String) { + return (java.lang.String) ref; + } else { + com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref; + java.lang.String s = bs.toStringUtf8(); + contactEmail_ = s; + return s; + } + } + /** + * + * + *+ * Required. Input only. An email address that can be used for quota related + * communication between the Google Cloud and the user in case the Google + * Cloud needs further information to make a decision on whether the user + * preferred quota can be granted. + * + * The Google account for the email address must have quota update permission + * for the project, folder or organization this quota preference is for. + *+ * + *+ * string contact_email = 12 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = REQUIRED]; + *
+ * + * @return The bytes for contactEmail. + */ + @java.lang.Override + public com.google.protobuf.ByteString getContactEmailBytes() { + java.lang.Object ref = contactEmail_; + if (ref instanceof java.lang.String) { + com.google.protobuf.ByteString b = + com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref); + contactEmail_ = b; + return b; + } else { + return (com.google.protobuf.ByteString) ref; + } + } + private byte memoizedIsInitialized = -1; @java.lang.Override @@ -719,6 +788,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(justification_)) { com.google.protobuf.GeneratedMessageV3.writeString(output, 11, justification_); } + if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(contactEmail_)) { + com.google.protobuf.GeneratedMessageV3.writeString(output, 12, contactEmail_); + } getUnknownFields().writeTo(output); } @@ -765,6 +837,9 @@ public int getSerializedSize() { if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(justification_)) { size += com.google.protobuf.GeneratedMessageV3.computeStringSize(11, justification_); } + if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(contactEmail_)) { + size += com.google.protobuf.GeneratedMessageV3.computeStringSize(12, contactEmail_); + } size += getUnknownFields().getSerializedSize(); memoizedSize = size; return size; @@ -800,6 +875,7 @@ public boolean equals(final java.lang.Object obj) { if (!getQuotaId().equals(other.getQuotaId())) return false; if (getReconciling() != other.getReconciling()) return false; if (!getJustification().equals(other.getJustification())) return false; + if (!getContactEmail().equals(other.getContactEmail())) return false; if (!getUnknownFields().equals(other.getUnknownFields())) return false; return true; } @@ -839,6 +915,8 @@ public int hashCode() { hash = (53 * hash) + com.google.protobuf.Internal.hashBoolean(getReconciling()); hash = (37 * hash) + JUSTIFICATION_FIELD_NUMBER; hash = (53 * hash) + getJustification().hashCode(); + hash = (37 * hash) + CONTACT_EMAIL_FIELD_NUMBER; + hash = (53 * hash) + getContactEmail().hashCode(); hash = (29 * hash) + getUnknownFields().hashCode(); memoizedHashCode = hash; return hash; @@ -1022,6 +1100,7 @@ public Builder clear() { quotaId_ = ""; reconciling_ = false; justification_ = ""; + contactEmail_ = ""; return this; } @@ -1090,6 +1169,9 @@ private void buildPartial0(com.google.api.cloudquotas.v1.QuotaPreference result) if (((from_bitField0_ & 0x00000200) != 0)) { result.justification_ = justification_; } + if (((from_bitField0_ & 0x00000400) != 0)) { + result.contactEmail_ = contactEmail_; + } } @java.lang.Override @@ -1176,6 +1258,11 @@ public Builder mergeFrom(com.google.api.cloudquotas.v1.QuotaPreference other) { bitField0_ |= 0x00000200; onChanged(); } + if (!other.getContactEmail().isEmpty()) { + contactEmail_ = other.contactEmail_; + bitField0_ |= 0x00000400; + onChanged(); + } this.mergeUnknownFields(other.getUnknownFields()); onChanged(); return this; @@ -1268,6 +1355,12 @@ public Builder mergeFrom( bitField0_ |= 0x00000200; break; } // case 90 + case 98: + { + contactEmail_ = input.readStringRequireUtf8(); + bitField0_ |= 0x00000400; + break; + } // case 98 default: { if (!super.parseUnknownField(input, extensionRegistry, tag)) { @@ -1446,7 +1539,7 @@ public int getDimensionsCount() { * ** The dimensions that this quota preference applies to. The key of the map - * entry is the name of a dimension, such as "region", "zone", “network_id”, + * entry is the name of a dimension, such as "region", "zone", "network_id", * and the value of the map entry is the dimension value. * * If a dimension is missing from the map of dimensions, the quota preference @@ -1481,7 +1574,7 @@ public java.util.MapgetDimensions() { * * * The dimensions that this quota preference applies to. The key of the map - * entry is the name of a dimension, such as "region", "zone", “network_id”, + * entry is the name of a dimension, such as "region", "zone", "network_id", * and the value of the map entry is the dimension value. * * If a dimension is missing from the map of dimensions, the quota preference @@ -1507,7 +1600,7 @@ public java.util.MapgetDimensionsMap() { * * * The dimensions that this quota preference applies to. The key of the map - * entry is the name of a dimension, such as "region", "zone", “network_id”, + * entry is the name of a dimension, such as "region", "zone", "network_id", * and the value of the map entry is the dimension value. * * If a dimension is missing from the map of dimensions, the quota preference @@ -1540,7 +1633,7 @@ public java.util.MapgetDimensionsMap() { * * * The dimensions that this quota preference applies to. The key of the map - * entry is the name of a dimension, such as "region", "zone", “network_id”, + * entry is the name of a dimension, such as "region", "zone", "network_id", * and the value of the map entry is the dimension value. * * If a dimension is missing from the map of dimensions, the quota preference @@ -1579,7 +1672,7 @@ public Builder clearDimensions() { * ** The dimensions that this quota preference applies to. The key of the map - * entry is the name of a dimension, such as "region", "zone", “network_id”, + * entry is the name of a dimension, such as "region", "zone", "network_id", * and the value of the map entry is the dimension value. * * If a dimension is missing from the map of dimensions, the quota preference @@ -1614,7 +1707,7 @@ public java.util.MapgetMutableDimensions() * * * The dimensions that this quota preference applies to. The key of the map - * entry is the name of a dimension, such as "region", "zone", “network_id”, + * entry is the name of a dimension, such as "region", "zone", "network_id", * and the value of the map entry is the dimension value. * * If a dimension is missing from the map of dimensions, the quota preference @@ -1647,7 +1740,7 @@ public Builder putDimensions(java.lang.String key, java.lang.String value) { * ** The dimensions that this quota preference applies to. The key of the map - * entry is the name of a dimension, such as "region", "zone", “network_id”, + * entry is the name of a dimension, such as "region", "zone", "network_id", * and the value of the map entry is the dimension value. * * If a dimension is missing from the map of dimensions, the quota preference @@ -2617,7 +2710,8 @@ public Builder setQuotaIdBytes(com.google.protobuf.ByteString value) { * * *- * Output only. Is the quota preference pending GCP approval and fulfillment. + * Output only. Is the quota preference pending Google Cloud approval and + * fulfillment. ** *bool reconciling = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -2632,7 +2726,8 @@ public boolean getReconciling() { * * *- * Output only. Is the quota preference pending GCP approval and fulfillment. + * Output only. Is the quota preference pending Google Cloud approval and + * fulfillment. ** *bool reconciling = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -2651,7 +2746,8 @@ public Builder setReconciling(boolean value) { * * *- * Output only. Is the quota preference pending GCP approval and fulfillment. + * Output only. Is the quota preference pending Google Cloud approval and + * fulfillment. ** *bool reconciling = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -2771,6 +2867,152 @@ public Builder setJustificationBytes(com.google.protobuf.ByteString value) { return this; } + private java.lang.Object contactEmail_ = ""; + /** + * + * + *+ * Required. Input only. An email address that can be used for quota related + * communication between the Google Cloud and the user in case the Google + * Cloud needs further information to make a decision on whether the user + * preferred quota can be granted. + * + * The Google account for the email address must have quota update permission + * for the project, folder or organization this quota preference is for. + *+ * + *+ * string contact_email = 12 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = REQUIRED]; + *
+ * + * @return The contactEmail. + */ + public java.lang.String getContactEmail() { + java.lang.Object ref = contactEmail_; + if (!(ref instanceof java.lang.String)) { + com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref; + java.lang.String s = bs.toStringUtf8(); + contactEmail_ = s; + return s; + } else { + return (java.lang.String) ref; + } + } + /** + * + * + *+ * Required. Input only. An email address that can be used for quota related + * communication between the Google Cloud and the user in case the Google + * Cloud needs further information to make a decision on whether the user + * preferred quota can be granted. + * + * The Google account for the email address must have quota update permission + * for the project, folder or organization this quota preference is for. + *+ * + *+ * string contact_email = 12 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = REQUIRED]; + *
+ * + * @return The bytes for contactEmail. + */ + public com.google.protobuf.ByteString getContactEmailBytes() { + java.lang.Object ref = contactEmail_; + if (ref instanceof String) { + com.google.protobuf.ByteString b = + com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref); + contactEmail_ = b; + return b; + } else { + return (com.google.protobuf.ByteString) ref; + } + } + /** + * + * + *+ * Required. Input only. An email address that can be used for quota related + * communication between the Google Cloud and the user in case the Google + * Cloud needs further information to make a decision on whether the user + * preferred quota can be granted. + * + * The Google account for the email address must have quota update permission + * for the project, folder or organization this quota preference is for. + *+ * + *+ * string contact_email = 12 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = REQUIRED]; + *
+ * + * @param value The contactEmail to set. + * @return This builder for chaining. + */ + public Builder setContactEmail(java.lang.String value) { + if (value == null) { + throw new NullPointerException(); + } + contactEmail_ = value; + bitField0_ |= 0x00000400; + onChanged(); + return this; + } + /** + * + * + *+ * Required. Input only. An email address that can be used for quota related + * communication between the Google Cloud and the user in case the Google + * Cloud needs further information to make a decision on whether the user + * preferred quota can be granted. + * + * The Google account for the email address must have quota update permission + * for the project, folder or organization this quota preference is for. + *+ * + *+ * string contact_email = 12 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = REQUIRED]; + *
+ * + * @return This builder for chaining. + */ + public Builder clearContactEmail() { + contactEmail_ = getDefaultInstance().getContactEmail(); + bitField0_ = (bitField0_ & ~0x00000400); + onChanged(); + return this; + } + /** + * + * + *+ * Required. Input only. An email address that can be used for quota related + * communication between the Google Cloud and the user in case the Google + * Cloud needs further information to make a decision on whether the user + * preferred quota can be granted. + * + * The Google account for the email address must have quota update permission + * for the project, folder or organization this quota preference is for. + *+ * + *+ * string contact_email = 12 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = REQUIRED]; + *
+ * + * @param value The bytes for contactEmail to set. + * @return This builder for chaining. + */ + public Builder setContactEmailBytes(com.google.protobuf.ByteString value) { + if (value == null) { + throw new NullPointerException(); + } + checkByteStringIsUtf8(value); + contactEmail_ = value; + bitField0_ |= 0x00000400; + onChanged(); + return this; + } + @java.lang.Override public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) { return super.setUnknownFields(unknownFields); diff --git a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaPreferenceOrBuilder.java b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaPreferenceOrBuilder.java index 9ab52b4a23b7..04d0fd8a7a31 100644 --- a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaPreferenceOrBuilder.java +++ b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaPreferenceOrBuilder.java @@ -61,7 +61,7 @@ public interface QuotaPreferenceOrBuilder * ** The dimensions that this quota preference applies to. The key of the map - * entry is the name of a dimension, such as "region", "zone", “network_id”, + * entry is the name of a dimension, such as "region", "zone", "network_id", * and the value of the map entry is the dimension value. * * If a dimension is missing from the map of dimensions, the quota preference @@ -84,7 +84,7 @@ public interface QuotaPreferenceOrBuilder * ** The dimensions that this quota preference applies to. The key of the map - * entry is the name of a dimension, such as "region", "zone", “network_id”, + * entry is the name of a dimension, such as "region", "zone", "network_id", * and the value of the map entry is the dimension value. * * If a dimension is missing from the map of dimensions, the quota preference @@ -110,7 +110,7 @@ public interface QuotaPreferenceOrBuilder * ** - ** The dimensions that this quota preference applies to. The key of the map - * entry is the name of a dimension, such as "region", "zone", “network_id”, + * entry is the name of a dimension, such as "region", "zone", "network_id", * and the value of the map entry is the dimension value. * * If a dimension is missing from the map of dimensions, the quota preference @@ -133,7 +133,7 @@ public interface QuotaPreferenceOrBuilder * ** - ** The dimensions that this quota preference applies to. The key of the map - * entry is the name of a dimension, such as "region", "zone", “network_id”, + * entry is the name of a dimension, such as "region", "zone", "network_id", * and the value of the map entry is the dimension value. * * If a dimension is missing from the map of dimensions, the quota preference @@ -160,7 +160,7 @@ java.lang.String getDimensionsOrDefault( * ** - ** The dimensions that this quota preference applies to. The key of the map - * entry is the name of a dimension, such as "region", "zone", “network_id”, + * entry is the name of a dimension, such as "region", "zone", "network_id", * and the value of the map entry is the dimension value. * * If a dimension is missing from the map of dimensions, the quota preference @@ -383,7 +383,8 @@ java.lang.String getDimensionsOrDefault( * * ** - *- * Output only. Is the quota preference pending GCP approval and fulfillment. + * Output only. Is the quota preference pending Google Cloud approval and + * fulfillment. ** *bool reconciling = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -416,4 +417,45 @@ java.lang.String getDimensionsOrDefault( * @return The bytes for justification. */ com.google.protobuf.ByteString getJustificationBytes(); + + /** + * + * + *+ * Required. Input only. An email address that can be used for quota related + * communication between the Google Cloud and the user in case the Google + * Cloud needs further information to make a decision on whether the user + * preferred quota can be granted. + * + * The Google account for the email address must have quota update permission + * for the project, folder or organization this quota preference is for. + *+ * + *+ * string contact_email = 12 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = REQUIRED]; + *
+ * + * @return The contactEmail. + */ + java.lang.String getContactEmail(); + /** + * + * + *+ * Required. Input only. An email address that can be used for quota related + * communication between the Google Cloud and the user in case the Google + * Cloud needs further information to make a decision on whether the user + * preferred quota can be granted. + * + * The Google account for the email address must have quota update permission + * for the project, folder or organization this quota preference is for. + *+ * + *+ * string contact_email = 12 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = REQUIRED]; + *
+ * + * @return The bytes for contactEmail. + */ + com.google.protobuf.ByteString getContactEmailBytes(); } diff --git a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaSafetyCheck.java b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaSafetyCheck.java index 74144f682dfb..72a4d5897edd 100644 --- a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaSafetyCheck.java +++ b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/QuotaSafetyCheck.java @@ -46,9 +46,9 @@ public enum QuotaSafetyCheck implements com.google.protobuf.ProtocolMessageEnum * limit to be lower than the consumer's quota usage. *LIMIT_DECREASE_BELOW_USAGE = 1;
+ *QUOTA_DECREASE_BELOW_USAGE = 1;
*/ - LIMIT_DECREASE_BELOW_USAGE(1), + QUOTA_DECREASE_BELOW_USAGE(1), /** * * @@ -57,9 +57,9 @@ public enum QuotaSafetyCheck implements com.google.protobuf.ProtocolMessageEnum * limit to decrease by more than 10 percent. *LIMIT_DECREASE_PERCENTAGE_TOO_HIGH = 2;
+ *QUOTA_DECREASE_PERCENTAGE_TOO_HIGH = 2;
*/ - LIMIT_DECREASE_PERCENTAGE_TOO_HIGH(2), + QUOTA_DECREASE_PERCENTAGE_TOO_HIGH(2), UNRECOGNIZED(-1), ; @@ -81,9 +81,9 @@ public enum QuotaSafetyCheck implements com.google.protobuf.ProtocolMessageEnum * limit to be lower than the consumer's quota usage. *LIMIT_DECREASE_BELOW_USAGE = 1;
+ *QUOTA_DECREASE_BELOW_USAGE = 1;
*/ - public static final int LIMIT_DECREASE_BELOW_USAGE_VALUE = 1; + public static final int QUOTA_DECREASE_BELOW_USAGE_VALUE = 1; /** * * @@ -92,9 +92,9 @@ public enum QuotaSafetyCheck implements com.google.protobuf.ProtocolMessageEnum * limit to decrease by more than 10 percent. *LIMIT_DECREASE_PERCENTAGE_TOO_HIGH = 2;
+ *QUOTA_DECREASE_PERCENTAGE_TOO_HIGH = 2;
*/ - public static final int LIMIT_DECREASE_PERCENTAGE_TOO_HIGH_VALUE = 2; + public static final int QUOTA_DECREASE_PERCENTAGE_TOO_HIGH_VALUE = 2; public final int getNumber() { if (this == UNRECOGNIZED) { @@ -123,9 +123,9 @@ public static QuotaSafetyCheck forNumber(int value) { case 0: return QUOTA_SAFETY_CHECK_UNSPECIFIED; case 1: - return LIMIT_DECREASE_BELOW_USAGE; + return QUOTA_DECREASE_BELOW_USAGE; case 2: - return LIMIT_DECREASE_PERCENTAGE_TOO_HIGH; + return QUOTA_DECREASE_PERCENTAGE_TOO_HIGH; default: return null; } diff --git a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/ResourcesProto.java b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/ResourcesProto.java index eab8648ad83e..dc76b1683aa8 100644 --- a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/ResourcesProto.java +++ b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/java/com/google/api/cloudquotas/v1/ResourcesProto.java @@ -100,58 +100,59 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "ervice}/quotaInfos/{quota_info}\022\\organiz" + "ations/{organization}/locations/{locatio" + "n}/services/{service}/quotaInfos/{quota_" - + "info}\"\366\001\n\030QuotaIncreaseEligibility\022\023\n\013is" + + "info}\"\374\001\n\030QuotaIncreaseEligibility\022\023\n\013is" + "_eligible\030\001 \001(\010\022e\n\024ineligibility_reason\030" + "\002 \001(\0162G.google.api.cloudquotas.v1.QuotaI" - + "ncreaseEligibility.IneligibilityReason\"^" + + "ncreaseEligibility.IneligibilityReason\"d" + "\n\023IneligibilityReason\022$\n INELIGIBILITY_R" - + "EASON_UNSPECIFIED\020\000\022\026\n\022NO_BILLING_ACCOUN" - + "T\020\002\022\t\n\005OTHER\020\003\"\353\005\n\017QuotaPreference\022\014\n\004na" - + "me\030\001 \001(\t\022N\n\ndimensions\030\002 \003(\0132:.google.ap" - + "i.cloudquotas.v1.QuotaPreference.Dimensi" - + "onsEntry\022B\n\014quota_config\030\003 \001(\0132&.google." - + "api.cloudquotas.v1.QuotaConfigB\004\342A\001\002\022\022\n\004" - + "etag\030\004 \001(\tB\004\342A\001\001\0225\n\013create_time\030\005 \001(\0132\032." - + "google.protobuf.TimestampB\004\342A\001\003\0225\n\013updat" - + "e_time\030\006 \001(\0132\032.google.protobuf.Timestamp" - + "B\004\342A\001\003\022\025\n\007service\030\007 \001(\tB\004\342A\001\002\022\026\n\010quota_i" - + "d\030\010 \001(\tB\004\342A\001\002\022\031\n\013reconciling\030\n \001(\010B\004\342A\001\003" - + "\022\025\n\rjustification\030\013 \001(\t\0321\n\017DimensionsEnt" - + "ry\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001:\237\002\352A\233" - + "\002\n*cloudquotas.googleapis.com/QuotaPrefe" - + "rence\022Kprojects/{project}/locations/{loc" - + "ation}/quotaPreferences/{quota_preferenc" - + "e}\022Ifolders/{folder}/locations/{location" - + "}/quotaPreferences/{quota_preference}\022Uo" - + "rganizations/{organization}/locations/{l" - + "ocation}/quotaPreferences/{quota_prefere" - + "nce}\"\261\003\n\013QuotaConfig\022\035\n\017preferred_value\030" - + "\001 \001(\003B\004\342A\001\002\022\032\n\014state_detail\030\002 \001(\tB\004\342A\001\003\022" - + "8\n\rgranted_value\030\003 \001(\0132\033.google.protobuf" - + ".Int64ValueB\004\342A\001\003\022\026\n\010trace_id\030\004 \001(\tB\004\342A\001" - + "\003\022L\n\013annotations\030\005 \003(\01327.google.api.clou" - + "dquotas.v1.QuotaConfig.AnnotationsEntry\022" - + "K\n\016request_origin\030\006 \001(\0162-.google.api.clo" - + "udquotas.v1.QuotaConfig.OriginB\004\342A\001\003\0322\n\020" - + "AnnotationsEntry\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002" - + " \001(\t:\0028\001\"F\n\006Origin\022\026\n\022ORIGIN_UNSPECIFIED" - + "\020\000\022\021\n\rCLOUD_CONSOLE\020\001\022\021\n\rAUTO_ADJUSTER\020\002" - + "\"\352\001\n\016DimensionsInfo\022M\n\ndimensions\030\001 \003(\0132" - + "9.google.api.cloudquotas.v1.DimensionsIn" - + "fo.DimensionsEntry\0228\n\007details\030\002 \001(\0132\'.go" - + "ogle.api.cloudquotas.v1.QuotaDetails\022\034\n\024" - + "applicable_locations\030\003 \003(\t\0321\n\017Dimensions" - + "Entry\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001\"\035\n" - + "\014QuotaDetails\022\r\n\005value\030\001 \001(\003*~\n\020QuotaSaf" - + "etyCheck\022\"\n\036QUOTA_SAFETY_CHECK_UNSPECIFI" - + "ED\020\000\022\036\n\032LIMIT_DECREASE_BELOW_USAGE\020\001\022&\n\"" - + "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH\020\002B\324\001\n" - + "\035com.google.api.cloudquotas.v1B\016Resource" - + "sProtoP\001ZDgoogle.golang.org/genproto/goo" - + "gleapis/api/cloudquotas/v1;cloudquotas\252\002" - + "\033Google.Cloud.CloudQuotas.V1\312\002\033Google\\Cl" - + "oud\\CloudQuotas\\V1\352\002\036Google::Cloud::Clou" - + "dQuotas::V1b\006proto3" + + "EASON_UNSPECIFIED\020\000\022\034\n\030NO_VALID_BILLING_" + + "ACCOUNT\020\001\022\t\n\005OTHER\020\002\"\211\006\n\017QuotaPreference" + + "\022\014\n\004name\030\001 \001(\t\022N\n\ndimensions\030\002 \003(\0132:.goo" + + "gle.api.cloudquotas.v1.QuotaPreference.D" + + "imensionsEntry\022B\n\014quota_config\030\003 \001(\0132&.g" + + "oogle.api.cloudquotas.v1.QuotaConfigB\004\342A" + + "\001\002\022\022\n\004etag\030\004 \001(\tB\004\342A\001\001\0225\n\013create_time\030\005 " + + "\001(\0132\032.google.protobuf.TimestampB\004\342A\001\003\0225\n" + + "\013update_time\030\006 \001(\0132\032.google.protobuf.Tim" + + "estampB\004\342A\001\003\022\025\n\007service\030\007 \001(\tB\004\342A\001\002\022\026\n\010q" + + "uota_id\030\010 \001(\tB\004\342A\001\002\022\031\n\013reconciling\030\n \001(\010" + + "B\004\342A\001\003\022\025\n\rjustification\030\013 \001(\t\022\034\n\rcontact" + + "_email\030\014 \001(\tB\005\342A\002\004\002\0321\n\017DimensionsEntry\022\013" + + "\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001:\237\002\352A\233\002\n*c" + + "loudquotas.googleapis.com/QuotaPreferenc" + + "e\022Kprojects/{project}/locations/{locatio" + + "n}/quotaPreferences/{quota_preference}\022I" + + "folders/{folder}/locations/{location}/qu" + + "otaPreferences/{quota_preference}\022Uorgan" + + "izations/{organization}/locations/{locat" + + "ion}/quotaPreferences/{quota_preference}" + + "\"\261\003\n\013QuotaConfig\022\035\n\017preferred_value\030\001 \001(" + + "\003B\004\342A\001\002\022\032\n\014state_detail\030\002 \001(\tB\004\342A\001\003\0228\n\rg" + + "ranted_value\030\003 \001(\0132\033.google.protobuf.Int" + + "64ValueB\004\342A\001\003\022\026\n\010trace_id\030\004 \001(\tB\004\342A\001\003\022L\n" + + "\013annotations\030\005 \003(\01327.google.api.cloudquo" + + "tas.v1.QuotaConfig.AnnotationsEntry\022K\n\016r" + + "equest_origin\030\006 \001(\0162-.google.api.cloudqu" + + "otas.v1.QuotaConfig.OriginB\004\342A\001\003\0322\n\020Anno" + + "tationsEntry\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t" + + ":\0028\001\"F\n\006Origin\022\026\n\022ORIGIN_UNSPECIFIED\020\000\022\021" + + "\n\rCLOUD_CONSOLE\020\001\022\021\n\rAUTO_ADJUSTER\020\002\"\352\001\n" + + "\016DimensionsInfo\022M\n\ndimensions\030\001 \003(\01329.go" + + "ogle.api.cloudquotas.v1.DimensionsInfo.D" + + "imensionsEntry\0228\n\007details\030\002 \001(\0132\'.google" + + ".api.cloudquotas.v1.QuotaDetails\022\034\n\024appl" + + "icable_locations\030\003 \003(\t\0321\n\017DimensionsEntr" + + "y\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001\"\035\n\014Quo" + + "taDetails\022\r\n\005value\030\001 \001(\003*~\n\020QuotaSafetyC" + + "heck\022\"\n\036QUOTA_SAFETY_CHECK_UNSPECIFIED\020\000" + + "\022\036\n\032QUOTA_DECREASE_BELOW_USAGE\020\001\022&\n\"QUOT" + + "A_DECREASE_PERCENTAGE_TOO_HIGH\020\002B\321\001\n\035com" + + ".google.api.cloudquotas.v1B\016ResourcesPro" + + "toP\001ZAcloud.google.com/go/cloudquotas/ap" + + "iv1/cloudquotaspb;cloudquotaspb\252\002\033Google" + + ".Cloud.CloudQuotas.V1\312\002\033Google\\Cloud\\Clo" + + "udQuotas\\V1\352\002\036Google::Cloud::CloudQuotas" + + "::V1b\006proto3" }; descriptor = com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom( @@ -209,6 +210,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "QuotaId", "Reconciling", "Justification", + "ContactEmail", }); internal_static_google_api_cloudquotas_v1_QuotaPreference_DimensionsEntry_descriptor = internal_static_google_api_cloudquotas_v1_QuotaPreference_descriptor diff --git a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/proto/google/api/cloudquotas/v1/cloudquotas.proto b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/proto/google/api/cloudquotas/v1/cloudquotas.proto index 6f29c79da7e4..2d35f2d095ca 100644 --- a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/proto/google/api/cloudquotas/v1/cloudquotas.proto +++ b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/proto/google/api/cloudquotas/v1/cloudquotas.proto @@ -24,7 +24,7 @@ import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; option csharp_namespace = "Google.Cloud.CloudQuotas.V1"; -option go_package = "google.golang.org/genproto/googleapis/api/cloudquotas/v1;cloudquotas"; +option go_package = "cloud.google.com/go/cloudquotas/apiv1/cloudquotaspb;cloudquotaspb"; option java_multiple_files = true; option java_outer_classname = "CloudquotasProto"; option java_package = "com.google.api.cloudquotas.v1"; diff --git a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/proto/google/api/cloudquotas/v1/resources.proto b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/proto/google/api/cloudquotas/v1/resources.proto index a3aae2a12e72..9c7ef471def6 100644 --- a/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/proto/google/api/cloudquotas/v1/resources.proto +++ b/java-cloudquotas/proto-google-cloud-cloudquotas-v1/src/main/proto/google/api/cloudquotas/v1/resources.proto @@ -22,7 +22,7 @@ import "google/protobuf/timestamp.proto"; import "google/protobuf/wrappers.proto"; option csharp_namespace = "Google.Cloud.CloudQuotas.V1"; -option go_package = "google.golang.org/genproto/googleapis/api/cloudquotas/v1;cloudquotas"; +option go_package = "cloud.google.com/go/cloudquotas/apiv1/cloudquotaspb;cloudquotaspb"; option java_multiple_files = true; option java_outer_classname = "ResourcesProto"; option java_package = "com.google.api.cloudquotas.v1"; @@ -36,11 +36,11 @@ enum QuotaSafetyCheck { // Validates that a quota mutation would not cause the consumer's effective // limit to be lower than the consumer's quota usage. - LIMIT_DECREASE_BELOW_USAGE = 1; + QUOTA_DECREASE_BELOW_USAGE = 1; // Validates that a quota mutation would not cause the consumer's effective // limit to decrease by more than 10 percent. - LIMIT_DECREASE_PERCENTAGE_TOO_HIGH = 2; + QUOTA_DECREASE_PERCENTAGE_TOO_HIGH = 2; } // QuotaInfo represents information about a particular quota for a given @@ -93,7 +93,7 @@ message QuotaInfo { // The reset time interval for the quota. Refresh interval applies to rate // quota only. - // Example: “minute” for per minute, “day” for per day, or “10 seconds” for + // Example: "minute" for per minute, "day" for per day, or "10 seconds" for // every 10 seconds. string refresh_interval = 6; @@ -109,7 +109,7 @@ message QuotaInfo { // The display name of the quota. string quota_display_name = 10; - // The unit in which the metric value is reported, e.g., “MByte”. + // The unit in which the metric value is reported, e.g., "MByte". string metric_unit = 11; // Whether it is eligible to request a higher quota value for this quota. @@ -146,11 +146,11 @@ message QuotaIncreaseEligibility { // Default value when is_eligible is true. INELIGIBILITY_REASON_UNSPECIFIED = 0; - // The container is not linked with a billing account. - NO_BILLING_ACCOUNT = 2; + // The container is not linked with a valid billing account. + NO_VALID_BILLING_ACCOUNT = 1; // Other reasons. - OTHER = 3; + OTHER = 2; } // Whether a higher quota value can be requested for the quota. @@ -181,7 +181,7 @@ message QuotaPreference { string name = 1; // The dimensions that this quota preference applies to. The key of the map - // entry is the name of a dimension, such as "region", "zone", “network_id”, + // entry is the name of a dimension, such as "region", "zone", "network_id", // and the value of the map entry is the dimension value. // // If a dimension is missing from the map of dimensions, the quota preference @@ -220,11 +220,24 @@ message QuotaPreference { // quota name is unique in the service. Example: `CpusPerProjectPerRegion` string quota_id = 8 [(google.api.field_behavior) = REQUIRED]; - // Output only. Is the quota preference pending GCP approval and fulfillment. + // Output only. Is the quota preference pending Google Cloud approval and + // fulfillment. bool reconciling = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; // The reason / justification for this quota preference. string justification = 11; + + // Required. Input only. An email address that can be used for quota related + // communication between the Google Cloud and the user in case the Google + // Cloud needs further information to make a decision on whether the user + // preferred quota can be granted. + // + // The Google account for the email address must have quota update permission + // for the project, folder or organization this quota preference is for. + string contact_email = 12 [ + (google.api.field_behavior) = INPUT_ONLY, + (google.api.field_behavior) = REQUIRED + ]; } // The preferred quota configuration. @@ -252,10 +265,10 @@ message QuotaConfig { google.protobuf.Int64Value granted_value = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. The trace id that the GCP uses to provision the requested - // quota. This trace id may be used by the client to contact Cloud support to - // track the state of a quota preference request. The trace id is only - // produced for increase requests and is unique for each request. The + // Output only. The trace id that the Google Cloud uses to provision the + // requested quota. This trace id may be used by the client to contact Cloud + // support to track the state of a quota preference request. The trace id is + // only produced for increase requests and is unique for each request. The // quota decrease requests do not have a trace id. string trace_id = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; diff --git a/java-cloudsupport/README.md b/java-cloudsupport/README.md index 071300822445..3850fbab9efc 100644 --- a/java-cloudsupport/README.md +++ b/java-cloudsupport/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-cloudsupport/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-cloudsupport.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-cloudsupport/0.14.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-cloudsupport/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-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/CaseAttachmentServiceClient.java b/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/CaseAttachmentServiceClient.java index a719f221d74c..44c887230130 100644 --- a/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/CaseAttachmentServiceClient.java +++ b/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/CaseAttachmentServiceClient.java @@ -58,19 +58,33 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + * + *ListAttachments + *+ * Retrieve all attachments associated with a support case.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listAttachments(ListAttachmentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listAttachments(CaseName parent) + *
- listAttachments(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.
+ *+ *
+ *- listAttachmentsPagedCallable() + *
- listAttachmentsCallable() + *
See the individual methods for example code. * diff --git a/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/CaseServiceClient.java b/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/CaseServiceClient.java index dd6ef5b9ec67..e58dcde0e59d 100644 --- a/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/CaseServiceClient.java +++ b/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/CaseServiceClient.java @@ -55,19 +55,151 @@ *
Note: close() needs to be called on the CaseServiceClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *GetCase + *+ * Retrieve the specified case.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getCase(GetCaseRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getCase(CaseName name) + *
- getCase(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.
+ *+ *
+ *- getCaseCallable() + *
+ * + *ListCases + *+ * Retrieve all cases under the specified parent. + *
Note: Listing cases under an Organization returns only the cases directly parented by that organization. To retrieve all cases under an organization, including cases parented by projects under that organization, use `cases.search`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listCases(ListCasesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listCases(OrganizationName parent) + *
- listCases(ProjectName parent) + *
- listCases(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.
+ *+ *
+ *- listCasesPagedCallable() + *
- listCasesCallable() + *
+ * + *SearchCases + *+ * Search cases using the specified query.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- searchCases(SearchCasesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- searchCasesPagedCallable() + *
- searchCasesCallable() + *
+ * + *CreateCase + *+ * Create a new case and associate it with the given Google Cloud Resource. The case object must have the following fields set: `display_name`, `description`, `classification`, and `priority`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createCase(CreateCaseRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createCase(OrganizationName parent, Case case_) + *
- createCase(ProjectName parent, Case case_) + *
- createCase(String parent, Case case_) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createCaseCallable() + *
+ * + *UpdateCase + *+ * Update the specified case. Only a subset of fields can be updated.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateCase(UpdateCaseRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateCase(Case case_, 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.
+ *+ *
+ *- updateCaseCallable() + *
+ * + *EscalateCase + *+ * Escalate a case. Escalating a case will initiate the Google Cloud Support escalation management process. + *
This operation is only available to certain Customer Care tiers. Go to https://cloud.google.com/support and look for 'Technical support escalations' in the feature list to find out which tiers are able to perform escalations.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- escalateCase(EscalateCaseRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- escalateCaseCallable() + *
+ * + *CloseCase + *+ * Close the specified case.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- closeCase(CloseCaseRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- closeCaseCallable() + *
+ * + * + *SearchCaseClassifications + *+ * Retrieve valid classifications to be used when creating a support case. The classications are hierarchical, with each classification containing all levels of the hierarchy, separated by " > ". For example "Technical Issue > Compute > Compute Engine".
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- searchCaseClassifications(SearchCaseClassificationsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- searchCaseClassificationsPagedCallable() + *
- searchCaseClassificationsCallable() + *
See the individual methods for example code. * diff --git a/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/CommentServiceClient.java b/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/CommentServiceClient.java index 0b34fafa6796..19049430d4bd 100644 --- a/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/CommentServiceClient.java +++ b/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/CommentServiceClient.java @@ -55,19 +55,52 @@ *
Note: close() needs to be called on the CommentServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListComments + *+ * Retrieve all Comments associated with the Case object.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listComments(ListCommentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listComments(CaseName parent) + *
- listComments(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.
+ *+ *
+ *- listCommentsPagedCallable() + *
- listCommentsCallable() + *
+ * + * + *CreateComment + *+ * Add a new comment to the specified Case. The comment object must have the following fields set: body.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createComment(CreateCommentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createComment(CaseName parent, Comment comment) + *
- createComment(String parent, Comment comment) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createCommentCallable() + *
See the individual methods for example code. * diff --git a/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/stub/CaseAttachmentServiceStubSettings.java b/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/stub/CaseAttachmentServiceStubSettings.java index c8a46f031f0c..22232b1a3594 100644 --- a/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/stub/CaseAttachmentServiceStubSettings.java +++ b/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/stub/CaseAttachmentServiceStubSettings.java @@ -183,6 +183,12 @@ public CaseAttachmentServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "cloudsupport"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/stub/CaseServiceStubSettings.java b/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/stub/CaseServiceStubSettings.java index 773b184dc852..7c27c2930ff5 100644 --- a/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/stub/CaseServiceStubSettings.java +++ b/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/stub/CaseServiceStubSettings.java @@ -368,6 +368,12 @@ public CaseServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "cloudsupport"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/stub/CommentServiceStubSettings.java b/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/stub/CommentServiceStubSettings.java index 3887b5ac7034..78345eee3ae6 100644 --- a/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/stub/CommentServiceStubSettings.java +++ b/java-cloudsupport/google-cloud-cloudsupport/src/main/java/com/google/cloud/support/v2/stub/CommentServiceStubSettings.java @@ -184,6 +184,12 @@ public CommentServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "cloudsupport"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/AcceleratorTypesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/AcceleratorTypesClient.java index c8e041a9004e..d64a9864bd68 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/AcceleratorTypesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/AcceleratorTypesClient.java @@ -60,19 +60,69 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of accelerator types.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListAcceleratorTypesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Get + *+ * Returns the specified accelerator type.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetAcceleratorTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String zone, String acceleratorType) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + * + *List + *+ * Retrieves a list of accelerator types that are available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListAcceleratorTypesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/AddressesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/AddressesClient.java index 24adaa89c46e..5e6f34083a9d 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/AddressesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/AddressesClient.java @@ -60,19 +60,145 @@ *
Note: close() needs to be called on the AddressesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of addresses.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListAddressesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified address resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteAddressRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String address) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified address resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetAddressRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String address) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates an address resource in the specified project by using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertAddressRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, Address addressResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of addresses contained within the specified region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListAddressesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Move + *+ * Moves the specified address resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- moveAsync(MoveAddressRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- moveAsync(String project, String region, String address, RegionAddressesMoveRequest regionAddressesMoveRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- moveOperationCallable() + *
- moveCallable() + *
+ * + * + *SetLabels + *+ * Sets the labels on an Address. To learn more about labels, read the Labeling Resources documentation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabelsAsync(SetLabelsAddressRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setLabelsAsync(String project, String region, String resource, RegionSetLabelsRequest regionSetLabelsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsOperationCallable() + *
- setLabelsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/AutoscalersClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/AutoscalersClient.java index 3a85863763f8..8ed362d133a7 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/AutoscalersClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/AutoscalersClient.java @@ -60,19 +60,145 @@ *
Note: close() needs to be called on the AutoscalersClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of autoscalers.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListAutoscalersRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified autoscaler.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteAutoscalerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String zone, String autoscaler) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified autoscaler resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetAutoscalerRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String zone, String autoscaler) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates an autoscaler in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertAutoscalerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String zone, Autoscaler autoscalerResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of autoscalers contained within the specified zone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListAutoscalersRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Updates an autoscaler in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchAutoscalerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String zone, Autoscaler autoscalerResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + * + *Update + *+ * Updates an autoscaler in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAsync(UpdateAutoscalerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAsync(String project, String zone, Autoscaler autoscalerResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateOperationCallable() + *
- updateCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/BackendBucketsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/BackendBucketsClient.java index 09ac2eede368..6008b2efdf2d 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/BackendBucketsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/BackendBucketsClient.java @@ -58,19 +58,237 @@ *
Note: close() needs to be called on the BackendBucketsClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AddSignedUrlKey + *+ * Adds a key for validating requests with signed URLs for this backend bucket.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addSignedUrlKeyAsync(AddSignedUrlKeyBackendBucketRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addSignedUrlKeyAsync(String project, String backendBucket, SignedUrlKey signedUrlKeyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addSignedUrlKeyOperationCallable() + *
- addSignedUrlKeyCallable() + *
+ * + *Delete + *+ * Deletes the specified BackendBucket resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteBackendBucketRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String backendBucket) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *DeleteSignedUrlKey + *+ * Deletes a key for validating requests with signed URLs for this backend bucket.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteSignedUrlKeyAsync(DeleteSignedUrlKeyBackendBucketRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteSignedUrlKeyAsync(String project, String backendBucket, String keyName) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteSignedUrlKeyOperationCallable() + *
- deleteSignedUrlKeyCallable() + *
+ * + *Get + *+ * Returns the specified BackendBucket resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetBackendBucketRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String backendBucket) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyBackendBucketRequest 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(String project, 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() + *
+ * + *Insert + *+ * Creates a BackendBucket resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertBackendBucketRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, BackendBucket backendBucketResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of BackendBucket resources available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListBackendBucketsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Updates the specified BackendBucket resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchBackendBucketRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String backendBucket, BackendBucket backendBucketResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *SetEdgeSecurityPolicy + *+ * Sets the edge security policy for the specified backend bucket.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setEdgeSecurityPolicyAsync(SetEdgeSecurityPolicyBackendBucketRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setEdgeSecurityPolicyAsync(String project, String backendBucket, SecurityPolicyReference securityPolicyReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setEdgeSecurityPolicyOperationCallable() + *
- setEdgeSecurityPolicyCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyBackendBucketRequest 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(String project, String resource, GlobalSetPolicyRequest globalSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsBackendBucketRequest 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(String project, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
+ * + * + *Update + *+ * Updates the specified BackendBucket resource with the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAsync(UpdateBackendBucketRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAsync(String project, String backendBucket, BackendBucket backendBucketResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateOperationCallable() + *
- updateCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/BackendServicesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/BackendServicesClient.java index d75ee5bbf314..df7d12a9fdb8 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/BackendServicesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/BackendServicesClient.java @@ -60,19 +60,312 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AddSignedUrlKey + *+ * Adds a key for validating requests with signed URLs for this backend service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addSignedUrlKeyAsync(AddSignedUrlKeyBackendServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addSignedUrlKeyAsync(String project, String backendService, SignedUrlKey signedUrlKeyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addSignedUrlKeyOperationCallable() + *
- addSignedUrlKeyCallable() + *
+ * + *AggregatedList + *+ * Retrieves the list of all BackendService resources, regional and global, available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListBackendServicesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified BackendService resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteBackendServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String backendService) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *DeleteSignedUrlKey + *+ * Deletes a key for validating requests with signed URLs for this backend service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteSignedUrlKeyAsync(DeleteSignedUrlKeyBackendServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteSignedUrlKeyAsync(String project, String backendService, String keyName) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteSignedUrlKeyOperationCallable() + *
- deleteSignedUrlKeyCallable() + *
+ * + *Get + *+ * Returns the specified BackendService resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetBackendServiceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String backendService) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetHealth + *+ * Gets the most recent health check results for this BackendService. Example request body: { "group": "/zones/us-east1-b/instanceGroups/lb-backend-example" }
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getHealth(GetHealthBackendServiceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getHealth(String project, String backendService, ResourceGroupReference resourceGroupReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getHealthCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyBackendServiceRequest 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(String project, 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() + *
+ * + *Insert + *+ * Creates a BackendService resource in the specified project using the data included in the request. For more information, see Backend services overview .
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertBackendServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, BackendService backendServiceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of BackendService resources available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListBackendServicesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *ListUsable + *+ * Retrieves an aggregated list of all usable backend services in the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listUsable(ListUsableBackendServicesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listUsable(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listUsablePagedCallable() + *
- listUsableCallable() + *
+ * + *Patch + *+ * Patches the specified BackendService resource with the data included in the request. For more information, see Backend services overview. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchBackendServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String backendService, BackendService backendServiceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *SetEdgeSecurityPolicy + *+ * Sets the edge security policy for the specified backend service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setEdgeSecurityPolicyAsync(SetEdgeSecurityPolicyBackendServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setEdgeSecurityPolicyAsync(String project, String backendService, SecurityPolicyReference securityPolicyReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setEdgeSecurityPolicyOperationCallable() + *
- setEdgeSecurityPolicyCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyBackendServiceRequest 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(String project, String resource, GlobalSetPolicyRequest globalSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *SetSecurityPolicy + *+ * Sets the Google Cloud Armor security policy for the specified backend service. For more information, see Google Cloud Armor Overview
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setSecurityPolicyAsync(SetSecurityPolicyBackendServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setSecurityPolicyAsync(String project, String backendService, SecurityPolicyReference securityPolicyReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setSecurityPolicyOperationCallable() + *
- setSecurityPolicyCallable() + *
+ * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsBackendServiceRequest 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(String project, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
+ * + * + *Update + *+ * Updates the specified BackendService resource with the data included in the request. For more information, see Backend services overview.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAsync(UpdateBackendServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAsync(String project, String backendService, BackendService backendServiceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateOperationCallable() + *
- updateCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/DiskTypesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/DiskTypesClient.java index df50303795e7..bbebc737b4d8 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/DiskTypesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/DiskTypesClient.java @@ -57,19 +57,69 @@ *
Note: close() needs to be called on the DiskTypesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of disk types.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListDiskTypesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Get + *+ * Returns the specified disk type.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetDiskTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String zone, String diskType) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + * + *List + *+ * Retrieves a list of disk types available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListDiskTypesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/DisksClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/DisksClient.java index a9851ed56a17..6ce7a8a1474d 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/DisksClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/DisksClient.java @@ -60,19 +60,351 @@ *
Note: close() needs to be called on the DisksClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AddResourcePolicies + *+ * Adds existing resource policies to a disk. You can only add one policy which will be applied to this disk for scheduling snapshot creation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addResourcePoliciesAsync(AddResourcePoliciesDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addResourcePoliciesAsync(String project, String zone, String disk, DisksAddResourcePoliciesRequest disksAddResourcePoliciesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addResourcePoliciesOperationCallable() + *
- addResourcePoliciesCallable() + *
+ * + *AggregatedList + *+ * Retrieves an aggregated list of persistent disks.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListDisksRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *BulkInsert + *+ * Bulk create a set of disks.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- bulkInsertAsync(BulkInsertDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- bulkInsertAsync(String project, String zone, BulkInsertDiskResource bulkInsertDiskResourceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- bulkInsertOperationCallable() + *
- bulkInsertCallable() + *
+ * + *CreateSnapshot + *+ * Creates a snapshot of a specified persistent disk. For regular snapshot creation, consider using snapshots.insert instead, as that method supports more features, such as creating snapshots in a project different from the source disk project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createSnapshotAsync(CreateSnapshotDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createSnapshotAsync(String project, String zone, String disk, Snapshot snapshotResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createSnapshotOperationCallable() + *
- createSnapshotCallable() + *
+ * + *Delete + *+ * Deletes the specified persistent disk. Deleting a disk removes its data permanently and is irreversible. However, deleting a disk does not delete any snapshots previously made from the disk. You must separately delete snapshots.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String zone, String disk) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified persistent disk.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetDiskRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String zone, String disk) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyDiskRequest 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(String project, String zone, 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() + *
+ * + *Insert + *+ * Creates a persistent disk in the specified project using the data in the request. You can create a disk from a source (sourceImage, sourceSnapshot, or sourceDisk) or create an empty 500 GB data disk by omitting all properties. You can also create a disk that is larger than the default size by specifying the sizeGb property.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String zone, Disk diskResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of persistent disks contained within the specified zone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListDisksRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *RemoveResourcePolicies + *+ * Removes resource policies from a disk.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeResourcePoliciesAsync(RemoveResourcePoliciesDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- removeResourcePoliciesAsync(String project, String zone, String disk, DisksRemoveResourcePoliciesRequest disksRemoveResourcePoliciesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeResourcePoliciesOperationCallable() + *
- removeResourcePoliciesCallable() + *
+ * + *Resize + *+ * Resizes the specified persistent disk. You can only increase the size of the disk.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- resizeAsync(ResizeDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- resizeAsync(String project, String zone, String disk, DisksResizeRequest disksResizeRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- resizeOperationCallable() + *
- resizeCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyDiskRequest 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(String project, String zone, String resource, ZoneSetPolicyRequest zoneSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *SetLabels + *+ * Sets the labels on a disk. To learn more about labels, read the Labeling Resources documentation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabelsAsync(SetLabelsDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setLabelsAsync(String project, String zone, String resource, ZoneSetLabelsRequest zoneSetLabelsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsOperationCallable() + *
- setLabelsCallable() + *
+ * + *StartAsyncReplication + *+ * Starts asynchronous replication. Must be invoked on the primary disk.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- startAsyncReplicationAsync(StartAsyncReplicationDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- startAsyncReplicationAsync(String project, String zone, String disk, DisksStartAsyncReplicationRequest disksStartAsyncReplicationRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- startAsyncReplicationOperationCallable() + *
- startAsyncReplicationCallable() + *
+ * + *StopAsyncReplication + *+ * Stops asynchronous replication. Can be invoked either on the primary or on the secondary disk.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- stopAsyncReplicationAsync(StopAsyncReplicationDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- stopAsyncReplicationAsync(String project, String zone, String disk) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- stopAsyncReplicationOperationCallable() + *
- stopAsyncReplicationCallable() + *
+ * + *StopGroupAsyncReplication + *+ * Stops asynchronous replication for a consistency group of disks. Can be invoked either in the primary or secondary scope.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- stopGroupAsyncReplicationAsync(StopGroupAsyncReplicationDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- stopGroupAsyncReplicationAsync(String project, String zone, DisksStopGroupAsyncReplicationResource disksStopGroupAsyncReplicationResourceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- stopGroupAsyncReplicationOperationCallable() + *
- stopGroupAsyncReplicationCallable() + *
+ * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsDiskRequest 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(String project, String zone, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
+ * + * + *Update + *+ * Updates the specified disk with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: user_license.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAsync(UpdateDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAsync(String project, String zone, String disk, Disk diskResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateOperationCallable() + *
- updateCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ExternalVpnGatewaysClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ExternalVpnGatewaysClient.java index 7f2f29692a81..d0f7c89e5b94 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ExternalVpnGatewaysClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ExternalVpnGatewaysClient.java @@ -59,19 +59,125 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified externalVpnGateway.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteExternalVpnGatewayRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String externalVpnGateway) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified externalVpnGateway. Get a list of available externalVpnGateways by making a list() request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetExternalVpnGatewayRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String externalVpnGateway) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a ExternalVpnGateway in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertExternalVpnGatewayRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, ExternalVpnGateway externalVpnGatewayResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of ExternalVpnGateway available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListExternalVpnGatewaysRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *SetLabels + *+ * Sets the labels on an ExternalVpnGateway. To learn more about labels, read the Labeling Resources documentation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabelsAsync(SetLabelsExternalVpnGatewayRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setLabelsAsync(String project, String resource, GlobalSetLabelsRequest globalSetLabelsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsOperationCallable() + *
- setLabelsCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsExternalVpnGatewayRequest 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(String project, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/FirewallPoliciesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/FirewallPoliciesClient.java index 06ecede5a2bc..3d962c261088 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/FirewallPoliciesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/FirewallPoliciesClient.java @@ -58,19 +58,348 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AddAssociation + *+ * Inserts an association for the specified firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addAssociationAsync(AddAssociationFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addAssociationAsync(String firewallPolicy, FirewallPolicyAssociation firewallPolicyAssociationResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addAssociationOperationCallable() + *
- addAssociationCallable() + *
+ * + *AddRule + *+ * Inserts a rule into a firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addRuleAsync(AddRuleFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addRuleAsync(String firewallPolicy, FirewallPolicyRule firewallPolicyRuleResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addRuleOperationCallable() + *
- addRuleCallable() + *
+ * + *CloneRules + *+ * Copies rules to the specified firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- cloneRulesAsync(CloneRulesFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- cloneRulesAsync(String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- cloneRulesOperationCallable() + *
- cloneRulesCallable() + *
+ * + *Delete + *+ * Deletes the specified policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(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.
+ *+ *
+ *- get(String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetAssociation + *+ * Gets an association with the specified name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getAssociation(GetAssociationFirewallPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getAssociation(String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getAssociationCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyFirewallPolicyRequest 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(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() + *
+ * + *GetRule + *+ * Gets a rule of the specified priority.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getRule(GetRuleFirewallPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getRule(String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getRuleCallable() + *
+ * + *Insert + *+ * Creates a new policy in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String parentId, FirewallPolicy firewallPolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Lists all the policies that have been configured for the specified folder or organization.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(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.
+ *+ *
+ *- list() + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *ListAssociations + *+ * Lists associations of a specified target, i.e., organization or folder.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listAssociations(ListAssociationsFirewallPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listAssociations() + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listAssociationsCallable() + *
+ * + *Move + *+ * Moves the specified firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- moveAsync(MoveFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- moveAsync(String firewallPolicy, String parentId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- moveOperationCallable() + *
- moveCallable() + *
+ * + *Patch + *+ * Patches the specified policy with the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String firewallPolicy, FirewallPolicy firewallPolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *PatchRule + *+ * Patches a rule of the specified priority.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchRuleAsync(PatchRuleFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchRuleAsync(String firewallPolicy, FirewallPolicyRule firewallPolicyRuleResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchRuleOperationCallable() + *
- patchRuleCallable() + *
+ * + *RemoveAssociation + *+ * Removes an association for the specified firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeAssociationAsync(RemoveAssociationFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- removeAssociationAsync(String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeAssociationOperationCallable() + *
- removeAssociationCallable() + *
+ * + *RemoveRule + *+ * Deletes a rule of the specified priority.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeRuleAsync(RemoveRuleFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- removeRuleAsync(String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeRuleOperationCallable() + *
- removeRuleCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyFirewallPolicyRequest 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(String resource, GlobalOrganizationSetPolicyRequest globalOrganizationSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsFirewallPolicyRequest 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(String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/FirewallsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/FirewallsClient.java index 18626d3b7c52..de74a782dd02 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/FirewallsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/FirewallsClient.java @@ -58,19 +58,126 @@ *
Note: close() needs to be called on the FirewallsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified firewall.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteFirewallRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String firewall) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified firewall.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetFirewallRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String firewall) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a firewall rule in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertFirewallRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, Firewall firewallResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of firewall rules available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListFirewallsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Updates the specified firewall rule with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchFirewallRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String firewall, Firewall firewallResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + * + *Update + *+ * Updates the specified firewall rule with the data included in the request. Note that all fields will be updated if using PUT, even fields that are not specified. To update individual fields, please use PATCH instead.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAsync(UpdateFirewallRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAsync(String project, String firewall, Firewall firewallResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateOperationCallable() + *
- updateCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ForwardingRulesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ForwardingRulesClient.java index 5d90fd876219..ddab9dba23ff 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ForwardingRulesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ForwardingRulesClient.java @@ -61,19 +61,164 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of forwarding rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListForwardingRulesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified ForwardingRule resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteForwardingRuleRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String forwardingRule) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified ForwardingRule resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetForwardingRuleRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String forwardingRule) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a ForwardingRule resource in the specified project and region using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertForwardingRuleRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, ForwardingRule forwardingRuleResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of ForwardingRule resources available to the specified project and region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListForwardingRulesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Updates the specified forwarding rule with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. Currently, you can only patch the network_tier field.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchForwardingRuleRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String forwardingRule, ForwardingRule forwardingRuleResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *SetLabels + *+ * Sets the labels on the specified resource. To learn more about labels, read the Labeling Resources documentation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabelsAsync(SetLabelsForwardingRuleRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setLabelsAsync(String project, String region, String resource, RegionSetLabelsRequest regionSetLabelsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsOperationCallable() + *
- setLabelsCallable() + *
+ * + * + *SetTarget + *+ * Changes target URL for forwarding rule. The new target should be of the same type as the old target.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setTargetAsync(SetTargetForwardingRuleRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setTargetAsync(String project, String region, String forwardingRule, TargetReference targetReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setTargetOperationCallable() + *
- setTargetCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalAddressesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalAddressesClient.java index b91e1004df83..f0eb6e8d6217 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalAddressesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalAddressesClient.java @@ -59,19 +59,126 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified address resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteGlobalAddressRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String address) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified address resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetGlobalAddressRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String address) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates an address resource in the specified project by using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertGlobalAddressRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, Address addressResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of global addresses.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListGlobalAddressesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Move + *+ * Moves the specified address resource from one project to another project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- moveAsync(MoveGlobalAddressRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- moveAsync(String project, String address, GlobalAddressesMoveRequest globalAddressesMoveRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- moveOperationCallable() + *
- moveCallable() + *
+ * + * + *SetLabels + *+ * Sets the labels on a GlobalAddress. To learn more about labels, read the Labeling Resources documentation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabelsAsync(SetLabelsGlobalAddressRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setLabelsAsync(String project, String resource, GlobalSetLabelsRequest globalSetLabelsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsOperationCallable() + *
- setLabelsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalForwardingRulesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalForwardingRulesClient.java index 246718b50c43..c5314202bc5d 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalForwardingRulesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalForwardingRulesClient.java @@ -60,19 +60,145 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified GlobalForwardingRule resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteGlobalForwardingRuleRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String forwardingRule) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified GlobalForwardingRule resource. Gets a list of available forwarding rules by making a list() request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetGlobalForwardingRuleRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String forwardingRule) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a GlobalForwardingRule resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertGlobalForwardingRuleRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, ForwardingRule forwardingRuleResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of GlobalForwardingRule resources available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListGlobalForwardingRulesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Updates the specified forwarding rule with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. Currently, you can only patch the network_tier field.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchGlobalForwardingRuleRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String forwardingRule, ForwardingRule forwardingRuleResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *SetLabels + *+ * Sets the labels on the specified resource. To learn more about labels, read the Labeling resources documentation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabelsAsync(SetLabelsGlobalForwardingRuleRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setLabelsAsync(String project, String resource, GlobalSetLabelsRequest globalSetLabelsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsOperationCallable() + *
- setLabelsCallable() + *
+ * + * + *SetTarget + *+ * Changes target URL for the GlobalForwardingRule resource. The new target should be of the same type as the old target.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setTargetAsync(SetTargetGlobalForwardingRuleRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setTargetAsync(String project, String forwardingRule, TargetReference targetReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setTargetOperationCallable() + *
- setTargetCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalNetworkEndpointGroupsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalNetworkEndpointGroupsClient.java index 137e8e4a51a9..4980b8ab77af 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalNetworkEndpointGroupsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalNetworkEndpointGroupsClient.java @@ -61,19 +61,145 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AttachNetworkEndpoints + *+ * Attach a network endpoint to the specified network endpoint group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- attachNetworkEndpointsAsync(AttachNetworkEndpointsGlobalNetworkEndpointGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- attachNetworkEndpointsAsync(String project, String networkEndpointGroup, GlobalNetworkEndpointGroupsAttachEndpointsRequest globalNetworkEndpointGroupsAttachEndpointsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- attachNetworkEndpointsOperationCallable() + *
- attachNetworkEndpointsCallable() + *
+ * + *Delete + *+ * Deletes the specified network endpoint group.Note that the NEG cannot be deleted if there are backend services referencing it.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteGlobalNetworkEndpointGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String networkEndpointGroup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *DetachNetworkEndpoints + *+ * Detach the network endpoint from the specified network endpoint group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- detachNetworkEndpointsAsync(DetachNetworkEndpointsGlobalNetworkEndpointGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- detachNetworkEndpointsAsync(String project, String networkEndpointGroup, GlobalNetworkEndpointGroupsDetachEndpointsRequest globalNetworkEndpointGroupsDetachEndpointsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- detachNetworkEndpointsOperationCallable() + *
- detachNetworkEndpointsCallable() + *
+ * + *Get + *+ * Returns the specified network endpoint group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetGlobalNetworkEndpointGroupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String networkEndpointGroup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a network endpoint group in the specified project using the parameters that are included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertGlobalNetworkEndpointGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, NetworkEndpointGroup networkEndpointGroupResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of network endpoint groups that are located in the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListGlobalNetworkEndpointGroupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + * + *ListNetworkEndpoints + *+ * Lists the network endpoints in the specified network endpoint group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listNetworkEndpoints(ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listNetworkEndpoints(String project, String networkEndpointGroup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listNetworkEndpointsPagedCallable() + *
- listNetworkEndpointsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalOperationsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalOperationsClient.java index cad0deccc695..37f57d39e322 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalOperationsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalOperationsClient.java @@ -57,19 +57,105 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of all operations.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListGlobalOperationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified Operations resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- delete(DeleteGlobalOperationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- delete(String project, String operation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteCallable() + *
+ * + *Get + *+ * Retrieves the specified Operations resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetGlobalOperationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String operation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *List + *+ * Retrieves a list of Operation resources contained within the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListGlobalOperationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + * + *Wait + *+ * Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- wait(WaitGlobalOperationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- wait(String project, String operation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- waitCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalOrganizationOperationsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalOrganizationOperationsClient.java index 32719a6aea85..d05df0f98824 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalOrganizationOperationsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalOrganizationOperationsClient.java @@ -57,19 +57,68 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified Operations resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- delete(DeleteGlobalOrganizationOperationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- delete(String operation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteCallable() + *
+ * + *Get + *+ * Retrieves the specified Operations resource. Gets a list of operations by making a `list()` request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetGlobalOrganizationOperationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String operation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + * + *List + *+ * Retrieves a list of Operation resources contained within the specified organization.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListGlobalOrganizationOperationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list() + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalPublicDelegatedPrefixesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalPublicDelegatedPrefixesClient.java index 828618d7643d..2b3a80e04879 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalPublicDelegatedPrefixesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/GlobalPublicDelegatedPrefixesClient.java @@ -61,19 +61,107 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified global PublicDelegatedPrefix.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteGlobalPublicDelegatedPrefixeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String publicDelegatedPrefix) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified global PublicDelegatedPrefix resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetGlobalPublicDelegatedPrefixeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String publicDelegatedPrefix) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a global PublicDelegatedPrefix in the specified project using the parameters that are included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertGlobalPublicDelegatedPrefixeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, PublicDelegatedPrefix publicDelegatedPrefixResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Lists the global PublicDelegatedPrefixes for a project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListGlobalPublicDelegatedPrefixesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + * + *Patch + *+ * Patches the specified global PublicDelegatedPrefix resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchGlobalPublicDelegatedPrefixeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String publicDelegatedPrefix, PublicDelegatedPrefix publicDelegatedPrefixResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HealthChecksClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HealthChecksClient.java index a1d06c2e18d5..bb94ad9d7a3b 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HealthChecksClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/HealthChecksClient.java @@ -59,19 +59,145 @@ *
Note: close() needs to be called on the HealthChecksClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves the list of all HealthCheck resources, regional and global, available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListHealthChecksRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified HealthCheck resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteHealthCheckRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String healthCheck) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified HealthCheck resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetHealthCheckRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String healthCheck) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a HealthCheck resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertHealthCheckRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, HealthCheck healthCheckResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of HealthCheck resources available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListHealthChecksRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Updates a HealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchHealthCheckRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String healthCheck, HealthCheck healthCheckResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + * + *Update + *+ * Updates a HealthCheck resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAsync(UpdateHealthCheckRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAsync(String project, String healthCheck, HealthCheck healthCheckResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateOperationCallable() + *
- updateCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ImageFamilyViewsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ImageFamilyViewsClient.java index cfcf89e9b943..0987c3ea2bcf 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ImageFamilyViewsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ImageFamilyViewsClient.java @@ -49,19 +49,31 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + * + *Get + *+ * Returns the latest image that is part of an image family, is not deprecated and is rolled out in the specified zone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetImageFamilyViewRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String zone, String family) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ImagesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ImagesClient.java index 1452c737f2c9..af2354f4620c 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ImagesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ImagesClient.java @@ -58,19 +58,217 @@ *
Note: close() needs to be called on the ImagesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified image.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteImageRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String image) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Deprecate + *+ * Sets the deprecation status of an image. If an empty request body is given, clears the deprecation status instead.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deprecateAsync(DeprecateImageRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deprecateAsync(String project, String image, DeprecationStatus deprecationStatusResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deprecateOperationCallable() + *
- deprecateCallable() + *
+ * + *Get + *+ * Returns the specified image.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetImageRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String image) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetFromFamily + *+ * Returns the latest image that is part of an image family and is not deprecated. For more information on image families, see Public image families documentation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getFromFamily(GetFromFamilyImageRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getFromFamily(String project, String family) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getFromFamilyCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyImageRequest 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(String project, 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() + *
+ * + *Insert + *+ * Creates an image in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertImageRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, Image imageResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of custom images available to the specified project. Custom images are images you create that belong to your project. This method does not get any images that belong to other projects, including publicly-available images, like Debian 8. If you want to get a list of publicly-available images, use this method to make a request to the respective image project, such as debian-cloud or windows-cloud.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListImagesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Patches the specified image with the data included in the request. Only the following fields can be modified: family, description, deprecation status.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchImageRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String image, Image imageResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyImageRequest 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(String project, String resource, GlobalSetPolicyRequest globalSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *SetLabels + *+ * Sets the labels on an image. To learn more about labels, read the Labeling Resources documentation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabelsAsync(SetLabelsImageRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setLabelsAsync(String project, String resource, GlobalSetLabelsRequest globalSetLabelsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsOperationCallable() + *
- setLabelsCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsImageRequest 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(String project, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstanceGroupManagersClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstanceGroupManagersClient.java index f353726c19ba..bd7765ae9d19 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstanceGroupManagersClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstanceGroupManagersClient.java @@ -63,19 +63,392 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AbandonInstances + *+ * Flags the specified instances to be removed from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- abandonInstancesAsync(AbandonInstancesInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- abandonInstancesAsync(String project, String zone, String instanceGroupManager, InstanceGroupManagersAbandonInstancesRequest instanceGroupManagersAbandonInstancesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- abandonInstancesOperationCallable() + *
- abandonInstancesCallable() + *
+ * + *AggregatedList + *+ * Retrieves the list of managed instance groups and groups them by zone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListInstanceGroupManagersRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *ApplyUpdatesToInstances + *+ * Applies changes to selected instances on the managed instance group. This method can be used to apply new overrides and/or new versions.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- applyUpdatesToInstancesAsync(ApplyUpdatesToInstancesInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- applyUpdatesToInstancesAsync(String project, String zone, String instanceGroupManager, InstanceGroupManagersApplyUpdatesRequest instanceGroupManagersApplyUpdatesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- applyUpdatesToInstancesOperationCallable() + *
- applyUpdatesToInstancesCallable() + *
+ * + *CreateInstances + *+ * Creates instances with per-instance configurations in this managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createInstancesAsync(CreateInstancesInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createInstancesAsync(String project, String zone, String instanceGroupManager, InstanceGroupManagersCreateInstancesRequest instanceGroupManagersCreateInstancesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createInstancesOperationCallable() + *
- createInstancesCallable() + *
+ * + *Delete + *+ * Deletes the specified managed instance group and all of the instances in that group. Note that the instance group must not belong to a backend service. Read Deleting an instance group for more information.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String zone, String instanceGroupManager) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *DeleteInstances + *+ * Flags the specified instances in the managed instance group for immediate deletion. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteInstancesAsync(DeleteInstancesInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteInstancesAsync(String project, String zone, String instanceGroupManager, InstanceGroupManagersDeleteInstancesRequest instanceGroupManagersDeleteInstancesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteInstancesOperationCallable() + *
- deleteInstancesCallable() + *
+ * + *DeletePerInstanceConfigs + *+ * Deletes selected per-instance configurations for the managed instance group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deletePerInstanceConfigsAsync(DeletePerInstanceConfigsInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deletePerInstanceConfigsAsync(String project, String zone, String instanceGroupManager, InstanceGroupManagersDeletePerInstanceConfigsReq instanceGroupManagersDeletePerInstanceConfigsReqResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deletePerInstanceConfigsOperationCallable() + *
- deletePerInstanceConfigsCallable() + *
+ * + *Get + *+ * Returns all of the details about the specified managed instance group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetInstanceGroupManagerRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String zone, String instanceGroupManager) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a managed instance group using the information that you specify in the request. After the group is created, instances in the group are created using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method. A managed instance group can have up to 1000 VM instances per group. Please contact Cloud Support if you need an increase in this limit.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String zone, InstanceGroupManager instanceGroupManagerResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of managed instance groups that are contained within the specified project and zone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListInstanceGroupManagersRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *ListErrors + *+ * Lists all errors thrown by actions on instances for a given managed instance group. The filter and orderBy query parameters are not supported.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listErrors(ListErrorsInstanceGroupManagersRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listErrors(String project, String zone, String instanceGroupManager) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listErrorsPagedCallable() + *
- listErrorsCallable() + *
+ * + *ListManagedInstances + *+ * Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action. The orderBy query parameter is not supported. The `pageToken` query parameter is supported only in the alpha and beta API and only if the group's `listManagedInstancesResults` field is set to `PAGINATED`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listManagedInstances(ListManagedInstancesInstanceGroupManagersRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listManagedInstances(String project, String zone, String instanceGroupManager) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listManagedInstancesPagedCallable() + *
- listManagedInstancesCallable() + *
+ * + *ListPerInstanceConfigs + *+ * Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listPerInstanceConfigs(ListPerInstanceConfigsInstanceGroupManagersRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listPerInstanceConfigs(String project, String zone, String instanceGroupManager) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPerInstanceConfigsPagedCallable() + *
- listPerInstanceConfigsCallable() + *
+ * + *Patch + *+ * Updates a managed instance group using the information that you specify in the request. This operation is marked as DONE when the group is patched even if the instances in the group are still in the process of being patched. You must separately verify the status of the individual instances with the listManagedInstances method. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. If you update your group to specify a new template or instance configuration, it's possible that your intended specification for each VM in the group is different from the current state of that VM. To learn how to apply an updated configuration to the VMs in a MIG, see Updating instances in a MIG.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String zone, String instanceGroupManager, InstanceGroupManager instanceGroupManagerResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *PatchPerInstanceConfigs + *+ * Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchPerInstanceConfigsAsync(PatchPerInstanceConfigsInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchPerInstanceConfigsAsync(String project, String zone, String instanceGroupManager, InstanceGroupManagersPatchPerInstanceConfigsReq instanceGroupManagersPatchPerInstanceConfigsReqResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchPerInstanceConfigsOperationCallable() + *
- patchPerInstanceConfigsCallable() + *
+ * + *RecreateInstances + *+ * Flags the specified VM instances in the managed instance group to be immediately recreated. Each instance is recreated using the group's current configuration. This operation is marked as DONE when the flag is set even if the instances have not yet been recreated. You must separately verify the status of each instance by checking its currentAction field; for more information, see Checking the status of managed instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- recreateInstancesAsync(RecreateInstancesInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- recreateInstancesAsync(String project, String zone, String instanceGroupManager, InstanceGroupManagersRecreateInstancesRequest instanceGroupManagersRecreateInstancesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- recreateInstancesOperationCallable() + *
- recreateInstancesCallable() + *
+ * + *Resize + *+ * Resizes the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method. When resizing down, the instance group arbitrarily chooses the order in which VMs are deleted. The group takes into account some VM attributes when making the selection including: + The status of the VM instance. + The health of the VM instance. + The instance template version the VM is based on. + For regional managed instance groups, the location of the VM instance. This list is subject to change. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- resizeAsync(ResizeInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- resizeAsync(String project, String zone, String instanceGroupManager, int size) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- resizeOperationCallable() + *
- resizeCallable() + *
+ * + *SetInstanceTemplate + *+ * Specifies the instance template to use when creating new instances in this group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setInstanceTemplateAsync(SetInstanceTemplateInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setInstanceTemplateAsync(String project, String zone, String instanceGroupManager, InstanceGroupManagersSetInstanceTemplateRequest instanceGroupManagersSetInstanceTemplateRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setInstanceTemplateOperationCallable() + *
- setInstanceTemplateCallable() + *
+ * + *SetTargetPools + *+ * Modifies the target pools to which all instances in this managed instance group are assigned. The target pools automatically apply to all of the instances in the managed instance group. This operation is marked DONE when you make the request even if the instances have not yet been added to their target pools. The change might take some time to apply to all of the instances in the group depending on the size of the group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setTargetPoolsAsync(SetTargetPoolsInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setTargetPoolsAsync(String project, String zone, String instanceGroupManager, InstanceGroupManagersSetTargetPoolsRequest instanceGroupManagersSetTargetPoolsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setTargetPoolsOperationCallable() + *
- setTargetPoolsCallable() + *
+ * + * + *UpdatePerInstanceConfigs + *+ * Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updatePerInstanceConfigsAsync(UpdatePerInstanceConfigsInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updatePerInstanceConfigsAsync(String project, String zone, String instanceGroupManager, InstanceGroupManagersUpdatePerInstanceConfigsReq instanceGroupManagersUpdatePerInstanceConfigsReqResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updatePerInstanceConfigsOperationCallable() + *
- updatePerInstanceConfigsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstanceGroupsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstanceGroupsClient.java index d2ed6f715dfd..ff8d0aa7a2e0 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstanceGroupsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstanceGroupsClient.java @@ -60,19 +60,183 @@ *
Note: close() needs to be called on the InstanceGroupsClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AddInstances + *+ * Adds a list of instances to the specified instance group. All of the instances in the instance group must be in the same network/subnetwork. Read Adding instances for more information.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addInstancesAsync(AddInstancesInstanceGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addInstancesAsync(String project, String zone, String instanceGroup, InstanceGroupsAddInstancesRequest instanceGroupsAddInstancesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addInstancesOperationCallable() + *
- addInstancesCallable() + *
+ * + *AggregatedList + *+ * Retrieves the list of instance groups and sorts them by zone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListInstanceGroupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified instance group. The instances in the group are not deleted. Note that instance group must not belong to a backend service. Read Deleting an instance group for more information.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteInstanceGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String zone, String instanceGroup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified zonal instance group. Get a list of available zonal instance groups by making a list() request. For managed instance groups, use the instanceGroupManagers or regionInstanceGroupManagers methods instead.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetInstanceGroupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String zone, String instanceGroup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates an instance group in the specified project using the parameters that are included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertInstanceGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String zone, InstanceGroup instanceGroupResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of zonal instance group resources contained within the specified zone. For managed instance groups, use the instanceGroupManagers or regionInstanceGroupManagers methods instead.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListInstanceGroupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *ListInstances + *+ * Lists the instances in the specified instance group. The orderBy query parameter is not supported. The filter query parameter is supported, but only for expressions that use `eq` (equal) or `ne` (not equal) operators.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listInstances(ListInstancesInstanceGroupsRequest 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(String project, String zone, String instanceGroup, InstanceGroupsListInstancesRequest instanceGroupsListInstancesRequestResource) + *
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() + *
+ * + *RemoveInstances + *+ * Removes one or more instances from the specified instance group, but does not delete those instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration before the VM instance is removed or deleted.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeInstancesAsync(RemoveInstancesInstanceGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- removeInstancesAsync(String project, String zone, String instanceGroup, InstanceGroupsRemoveInstancesRequest instanceGroupsRemoveInstancesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeInstancesOperationCallable() + *
- removeInstancesCallable() + *
+ * + * + *SetNamedPorts + *+ * Sets the named ports for the specified instance group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setNamedPortsAsync(SetNamedPortsInstanceGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setNamedPortsAsync(String project, String zone, String instanceGroup, InstanceGroupsSetNamedPortsRequest instanceGroupsSetNamedPortsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setNamedPortsOperationCallable() + *
- setNamedPortsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstanceTemplatesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstanceTemplatesClient.java index dd64ceea335e..0b66c492f4f6 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstanceTemplatesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstanceTemplatesClient.java @@ -60,19 +60,161 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves the list of all InstanceTemplates resources, regional and global, available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListInstanceTemplatesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified instance template. Deleting an instance template is permanent and cannot be undone. It is not possible to delete templates that are already in use by a managed instance group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteInstanceTemplateRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String instanceTemplate) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified instance template.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetInstanceTemplateRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String instanceTemplate) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyInstanceTemplateRequest 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(String project, 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() + *
+ * + *Insert + *+ * Creates an instance template in the specified project using the data that is included in the request. If you are creating a new template to update an existing instance group, your new instance template must use the same network or, if applicable, the same subnetwork as the original template.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertInstanceTemplateRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, InstanceTemplate instanceTemplateResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of instance templates that are contained within the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListInstanceTemplatesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyInstanceTemplateRequest 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(String project, String resource, GlobalSetPolicyRequest globalSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsInstanceTemplateRequest 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(String project, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstancesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstancesClient.java index 0dfa2cddf2bf..f98df551fba9 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstancesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InstancesClient.java @@ -60,19 +60,896 @@ *
Note: close() needs to be called on the InstancesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AddAccessConfig + *+ * Adds an access config to an instance's network interface.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addAccessConfigAsync(AddAccessConfigInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addAccessConfigAsync(String project, String zone, String instance, String networkInterface, AccessConfig accessConfigResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addAccessConfigOperationCallable() + *
- addAccessConfigCallable() + *
+ * + *AddResourcePolicies + *+ * Adds existing resource policies to an instance. You can only add one policy right now which will be applied to this instance for scheduling live migrations.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addResourcePoliciesAsync(AddResourcePoliciesInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addResourcePoliciesAsync(String project, String zone, String instance, InstancesAddResourcePoliciesRequest instancesAddResourcePoliciesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addResourcePoliciesOperationCallable() + *
- addResourcePoliciesCallable() + *
+ * + *AggregatedList + *+ * Retrieves an aggregated list of all of the instances in your project across all regions and zones. The performance of this method degrades when a filter is specified on a project that has a very large number of instances.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListInstancesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *AttachDisk + *+ * Attaches an existing Disk resource to an instance. You must first create the disk before you can attach it. It is not possible to create and attach a disk at the same time. For more information, read Adding a persistent disk to your instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- attachDiskAsync(AttachDiskInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- attachDiskAsync(String project, String zone, String instance, AttachedDisk attachedDiskResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- attachDiskOperationCallable() + *
- attachDiskCallable() + *
+ * + *BulkInsert + *+ * Creates multiple instances. Count specifies the number of instances to create. For more information, see About bulk creation of VMs.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- bulkInsertAsync(BulkInsertInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- bulkInsertAsync(String project, String zone, BulkInsertInstanceResource bulkInsertInstanceResourceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- bulkInsertOperationCallable() + *
- bulkInsertCallable() + *
+ * + *Delete + *+ * Deletes the specified Instance resource. For more information, see Deleting an instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String zone, String instance) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *DeleteAccessConfig + *+ * Deletes an access config from an instance's network interface.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAccessConfigAsync(DeleteAccessConfigInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAccessConfigAsync(String project, String zone, String instance, String accessConfig, String networkInterface) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteAccessConfigOperationCallable() + *
- deleteAccessConfigCallable() + *
+ * + *DetachDisk + *+ * Detaches a disk from an instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- detachDiskAsync(DetachDiskInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- detachDiskAsync(String project, String zone, String instance, String deviceName) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- detachDiskOperationCallable() + *
- detachDiskCallable() + *
+ * + *Get + *+ * Returns the specified Instance resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(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.
+ *+ *
+ *- get(String project, String zone, String instance) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetEffectiveFirewalls + *+ * Returns effective firewalls applied to an interface of the instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getEffectiveFirewalls(GetEffectiveFirewallsInstanceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getEffectiveFirewalls(String project, String zone, String instance, String networkInterface) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getEffectiveFirewallsCallable() + *
+ * + *GetGuestAttributes + *+ * Returns the specified guest attributes entry.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getGuestAttributes(GetGuestAttributesInstanceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getGuestAttributes(String project, String zone, String instance) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getGuestAttributesCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyInstanceRequest 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(String project, String zone, 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() + *
+ * + *GetScreenshot + *+ * Returns the screenshot from the specified instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getScreenshot(GetScreenshotInstanceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getScreenshot(String project, String zone, String instance) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getScreenshotCallable() + *
+ * + *GetSerialPortOutput + *+ * Returns the last 1 MB of serial port output from the specified instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getSerialPortOutput(GetSerialPortOutputInstanceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getSerialPortOutput(String project, String zone, String instance) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getSerialPortOutputCallable() + *
+ * + *GetShieldedInstanceIdentity + *+ * Returns the Shielded Instance Identity of an instance
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getShieldedInstanceIdentity(GetShieldedInstanceIdentityInstanceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getShieldedInstanceIdentity(String project, String zone, String instance) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getShieldedInstanceIdentityCallable() + *
+ * + *Insert + *+ * Creates an instance resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String zone, Instance instanceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of instances contained within the specified zone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(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.
+ *+ *
+ *- list(String project, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *ListReferrers + *+ * Retrieves a list of resources that refer to the VM instance specified in the request. For example, if the VM instance is part of a managed or unmanaged instance group, the referrers list includes the instance group. For more information, read Viewing referrers to VM instances.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listReferrers(ListReferrersInstancesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listReferrers(String project, String zone, String instance) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listReferrersPagedCallable() + *
- listReferrersCallable() + *
+ * + *RemoveResourcePolicies + *+ * Removes resource policies from an instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeResourcePoliciesAsync(RemoveResourcePoliciesInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- removeResourcePoliciesAsync(String project, String zone, String instance, InstancesRemoveResourcePoliciesRequest instancesRemoveResourcePoliciesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeResourcePoliciesOperationCallable() + *
- removeResourcePoliciesCallable() + *
+ * + *Reset + *+ * Performs a reset on the instance. This is a hard reset. The VM does not do a graceful shutdown. For more information, see Resetting an instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- resetAsync(ResetInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- resetAsync(String project, String zone, String instance) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- resetOperationCallable() + *
- resetCallable() + *
+ * + *Resume + *+ * Resumes an instance that was suspended using the instances().suspend method.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- resumeAsync(ResumeInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- resumeAsync(String project, String zone, String instance) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- resumeOperationCallable() + *
- resumeCallable() + *
+ * + *SendDiagnosticInterrupt + *+ * Sends diagnostic interrupt to the instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- sendDiagnosticInterrupt(SendDiagnosticInterruptInstanceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- sendDiagnosticInterrupt(String project, String zone, String instance) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- sendDiagnosticInterruptCallable() + *
+ * + *SetDeletionProtection + *+ * Sets deletion protection on the instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setDeletionProtectionAsync(SetDeletionProtectionInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setDeletionProtectionAsync(String project, String zone, 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.
+ *+ *
+ *- setDeletionProtectionOperationCallable() + *
- setDeletionProtectionCallable() + *
+ * + *SetDiskAutoDelete + *+ * Sets the auto-delete flag for a disk attached to an instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setDiskAutoDeleteAsync(SetDiskAutoDeleteInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setDiskAutoDeleteAsync(String project, String zone, String instance, boolean autoDelete, String deviceName) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setDiskAutoDeleteOperationCallable() + *
- setDiskAutoDeleteCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyInstanceRequest 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(String project, String zone, String resource, ZoneSetPolicyRequest zoneSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *SetLabels + *+ * Sets labels on an instance. To learn more about labels, read the Labeling Resources documentation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabelsAsync(SetLabelsInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setLabelsAsync(String project, String zone, String instance, InstancesSetLabelsRequest instancesSetLabelsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsOperationCallable() + *
- setLabelsCallable() + *
+ * + *SetMachineResources + *+ * Changes the number and/or type of accelerator for a stopped instance to the values specified in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setMachineResourcesAsync(SetMachineResourcesInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setMachineResourcesAsync(String project, String zone, String instance, InstancesSetMachineResourcesRequest instancesSetMachineResourcesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setMachineResourcesOperationCallable() + *
- setMachineResourcesCallable() + *
+ * + *SetMachineType + *+ * Changes the machine type for a stopped instance to the machine type specified in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setMachineTypeAsync(SetMachineTypeInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setMachineTypeAsync(String project, String zone, String instance, InstancesSetMachineTypeRequest instancesSetMachineTypeRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setMachineTypeOperationCallable() + *
- setMachineTypeCallable() + *
+ * + *SetMetadata + *+ * Sets metadata for the specified instance to the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setMetadataAsync(SetMetadataInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setMetadataAsync(String project, String zone, String instance, Metadata metadataResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setMetadataOperationCallable() + *
- setMetadataCallable() + *
+ * + *SetMinCpuPlatform + *+ * Changes the minimum CPU platform that this instance should use. This method can only be called on a stopped instance. For more information, read Specifying a Minimum CPU Platform.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setMinCpuPlatformAsync(SetMinCpuPlatformInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setMinCpuPlatformAsync(String project, String zone, String instance, InstancesSetMinCpuPlatformRequest instancesSetMinCpuPlatformRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setMinCpuPlatformOperationCallable() + *
- setMinCpuPlatformCallable() + *
+ * + *SetName + *+ * Sets name of an instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setNameAsync(SetNameInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setNameAsync(String project, String zone, String instance, InstancesSetNameRequest instancesSetNameRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setNameOperationCallable() + *
- setNameCallable() + *
+ * + *SetScheduling + *+ * Sets an instance's scheduling options. You can only call this method on a stopped instance, that is, a VM instance that is in a `TERMINATED` state. See Instance Life Cycle for more information on the possible instance states. For more information about setting scheduling options for a VM, see Set VM host maintenance policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setSchedulingAsync(SetSchedulingInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setSchedulingAsync(String project, String zone, String instance, Scheduling schedulingResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setSchedulingOperationCallable() + *
- setSchedulingCallable() + *
+ * + *SetSecurityPolicy + *+ * Sets the Google Cloud Armor security policy for the specified instance. For more information, see Google Cloud Armor Overview
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setSecurityPolicyAsync(SetSecurityPolicyInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setSecurityPolicyAsync(String project, String zone, String instance, InstancesSetSecurityPolicyRequest instancesSetSecurityPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setSecurityPolicyOperationCallable() + *
- setSecurityPolicyCallable() + *
+ * + *SetServiceAccount + *+ * Sets the service account on the instance. For more information, read Changing the service account and access scopes for an instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setServiceAccountAsync(SetServiceAccountInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setServiceAccountAsync(String project, String zone, String instance, InstancesSetServiceAccountRequest instancesSetServiceAccountRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setServiceAccountOperationCallable() + *
- setServiceAccountCallable() + *
+ * + *SetShieldedInstanceIntegrityPolicy + *+ * Sets the Shielded Instance integrity policy for an instance. You can only use this method on a running instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setShieldedInstanceIntegrityPolicyAsync(SetShieldedInstanceIntegrityPolicyInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setShieldedInstanceIntegrityPolicyAsync(String project, String zone, String instance, ShieldedInstanceIntegrityPolicy shieldedInstanceIntegrityPolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setShieldedInstanceIntegrityPolicyOperationCallable() + *
- setShieldedInstanceIntegrityPolicyCallable() + *
+ * + *SetTags + *+ * Sets network tags for the specified instance to the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setTagsAsync(SetTagsInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setTagsAsync(String project, String zone, String instance, Tags tagsResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setTagsOperationCallable() + *
- setTagsCallable() + *
+ * + *SimulateMaintenanceEvent + *+ * Simulates a host maintenance event on a VM. For more information, see Simulate a host maintenance event.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- simulateMaintenanceEventAsync(SimulateMaintenanceEventInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- simulateMaintenanceEventAsync(String project, String zone, String instance) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- simulateMaintenanceEventOperationCallable() + *
- simulateMaintenanceEventCallable() + *
+ * + *Start + *+ * Starts an instance that was stopped using the instances().stop method. For more information, see Restart an instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- startAsync(StartInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- startAsync(String project, String zone, String instance) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- startOperationCallable() + *
- startCallable() + *
+ * + *StartWithEncryptionKey + *+ * Starts an instance that was stopped using the instances().stop method. For more information, see Restart an instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- startWithEncryptionKeyAsync(StartWithEncryptionKeyInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- startWithEncryptionKeyAsync(String project, String zone, String instance, InstancesStartWithEncryptionKeyRequest instancesStartWithEncryptionKeyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- startWithEncryptionKeyOperationCallable() + *
- startWithEncryptionKeyCallable() + *
+ * + *Stop + *+ * Stops a running instance, shutting it down cleanly, and allows you to restart the instance at a later time. Stopped instances do not incur VM usage charges while they are stopped. However, resources that the VM is using, such as persistent disks and static IP addresses, will continue to be charged until they are deleted. For more information, see Stopping an instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- stopAsync(StopInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- stopAsync(String project, String zone, String instance) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- stopOperationCallable() + *
- stopCallable() + *
+ * + *Suspend + *+ * This method suspends a running instance, saving its state to persistent storage, and allows you to resume the instance at a later time. Suspended instances have no compute costs (cores or RAM), and incur only storage charges for the saved VM memory and localSSD data. Any charged resources the virtual machine was using, such as persistent disks and static IP addresses, will continue to be charged while the instance is suspended. For more information, see Suspending and resuming an instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- suspendAsync(SuspendInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- suspendAsync(String project, String zone, String instance) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- suspendOperationCallable() + *
- suspendCallable() + *
+ * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsInstanceRequest 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(String project, String zone, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
+ * + *Update + *+ * Updates an instance only if the necessary resources are available. This method can update only a specific set of instance properties. See Updating a running instance for a list of updatable instance properties.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAsync(UpdateInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAsync(String project, String zone, String instance, Instance instanceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateOperationCallable() + *
- updateCallable() + *
+ * + *UpdateAccessConfig + *+ * Updates the specified access config from an instance's network interface with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAccessConfigAsync(UpdateAccessConfigInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAccessConfigAsync(String project, String zone, String instance, String networkInterface, AccessConfig accessConfigResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateAccessConfigOperationCallable() + *
- updateAccessConfigCallable() + *
+ * + *UpdateDisplayDevice + *+ * Updates the Display config for a VM instance. You can only use this method on a stopped VM instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateDisplayDeviceAsync(UpdateDisplayDeviceInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateDisplayDeviceAsync(String project, String zone, String instance, DisplayDevice displayDeviceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateDisplayDeviceOperationCallable() + *
- updateDisplayDeviceCallable() + *
+ * + *UpdateNetworkInterface + *+ * Updates an instance's network interface. This method can only update an interface's alias IP range and attached network. See Modifying alias IP ranges for an existing instance for instructions on changing alias IP ranges. See Migrating a VM between networks for instructions on migrating an interface. This method follows PATCH semantics.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateNetworkInterfaceAsync(UpdateNetworkInterfaceInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateNetworkInterfaceAsync(String project, String zone, String instance, String networkInterface, NetworkInterface networkInterfaceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateNetworkInterfaceOperationCallable() + *
- updateNetworkInterfaceCallable() + *
+ * + * + *UpdateShieldedInstanceConfig + *+ * Updates the Shielded Instance config for an instance. You can only use this method on a stopped instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateShieldedInstanceConfigAsync(UpdateShieldedInstanceConfigInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateShieldedInstanceConfigAsync(String project, String zone, String instance, ShieldedInstanceConfig shieldedInstanceConfigResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateShieldedInstanceConfigOperationCallable() + *
- updateShieldedInstanceConfigCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InterconnectAttachmentsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InterconnectAttachmentsClient.java index 973daa9101eb..c5c7aae56691 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InterconnectAttachmentsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InterconnectAttachmentsClient.java @@ -63,19 +63,145 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of interconnect attachments.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListInterconnectAttachmentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified interconnect attachment.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteInterconnectAttachmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String interconnectAttachment) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified interconnect attachment.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetInterconnectAttachmentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String interconnectAttachment) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates an InterconnectAttachment in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertInterconnectAttachmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, InterconnectAttachment interconnectAttachmentResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of interconnect attachments contained within the specified region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListInterconnectAttachmentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Updates the specified interconnect attachment with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchInterconnectAttachmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String interconnectAttachment, InterconnectAttachment interconnectAttachmentResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + * + *SetLabels + *+ * Sets the labels on an InterconnectAttachment. To learn more about labels, read the Labeling Resources documentation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabelsAsync(SetLabelsInterconnectAttachmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setLabelsAsync(String project, String region, String resource, RegionSetLabelsRequest regionSetLabelsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsOperationCallable() + *
- setLabelsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InterconnectLocationsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InterconnectLocationsClient.java index ebcb9da8538c..d53fc0c4d628 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InterconnectLocationsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InterconnectLocationsClient.java @@ -58,19 +58,50 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Get + *+ * Returns the details for the specified interconnect location. Gets a list of available interconnect locations by making a list() request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetInterconnectLocationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String interconnectLocation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + * + *List + *+ * Retrieves the list of interconnect locations available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListInterconnectLocationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InterconnectRemoteLocationsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InterconnectRemoteLocationsClient.java index 47cb56dc3f98..3ae8d9df524f 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InterconnectRemoteLocationsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InterconnectRemoteLocationsClient.java @@ -58,19 +58,50 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Get + *+ * Returns the details for the specified interconnect remote location. Gets a list of available interconnect remote locations by making a list() request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetInterconnectRemoteLocationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String interconnectRemoteLocation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + * + *List + *+ * Retrieves the list of interconnect remote locations available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListInterconnectRemoteLocationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InterconnectsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InterconnectsClient.java index b222b577bab7..56981c23fd01 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InterconnectsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/InterconnectsClient.java @@ -58,19 +58,162 @@ *
Note: close() needs to be called on the InterconnectsClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified Interconnect.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteInterconnectRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String interconnect) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified Interconnect. Get a list of available Interconnects by making a list() request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetInterconnectRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String interconnect) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetDiagnostics + *+ * Returns the interconnectDiagnostics for the specified Interconnect. In the event of a global outage, do not use this API to make decisions about where to redirect your network traffic. Unlike a VLAN attachment, which is regional, a Cloud Interconnect connection is a global resource. A global outage can prevent this API from functioning properly.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getDiagnostics(GetDiagnosticsInterconnectRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getDiagnostics(String project, String interconnect) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getDiagnosticsCallable() + *
+ * + *GetMacsecConfig + *+ * Returns the interconnectMacsecConfig for the specified Interconnect.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getMacsecConfig(GetMacsecConfigInterconnectRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getMacsecConfig(String project, String interconnect) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getMacsecConfigCallable() + *
+ * + *Insert + *+ * Creates an Interconnect in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertInterconnectRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, Interconnect interconnectResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of Interconnects available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListInterconnectsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Updates the specified Interconnect with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchInterconnectRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String interconnect, Interconnect interconnectResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + * + *SetLabels + *+ * Sets the labels on an Interconnect. To learn more about labels, read the Labeling Resources documentation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabelsAsync(SetLabelsInterconnectRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setLabelsAsync(String project, String resource, GlobalSetLabelsRequest globalSetLabelsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsOperationCallable() + *
- setLabelsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/LicenseCodesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/LicenseCodesClient.java index 7ba99048409f..b362285181f3 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/LicenseCodesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/LicenseCodesClient.java @@ -47,19 +47,49 @@ *
Note: close() needs to be called on the LicenseCodesClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Get + *+ * Return a specified license code. License codes are mirrored across all projects that have permissions to read the License Code. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetLicenseCodeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String licenseCode) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsLicenseCodeRequest 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(String project, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/LicensesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/LicensesClient.java index c811cb781c4b..7f6cd16b3166 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/LicensesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/LicensesClient.java @@ -58,19 +58,142 @@ *
Note: close() needs to be called on the LicensesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified license. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteLicenseRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String license) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified License resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetLicenseRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String license) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyLicenseRequest 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(String project, 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() + *
+ * + *Insert + *+ * Create a License resource in the specified project. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertLicenseRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, License licenseResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of licenses available in the specified project. This method does not get any licenses that belong to other projects, including licenses attached to publicly-available images, like Debian 9. If you want to get a list of publicly-available licenses, use this method to make a request to the respective image project, such as debian-cloud or windows-cloud. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListLicensesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyLicenseRequest 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(String project, String resource, GlobalSetPolicyRequest globalSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsLicenseRequest 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(String project, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/MachineImagesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/MachineImagesClient.java index c00dfa14a33f..a05d1b848469 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/MachineImagesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/MachineImagesClient.java @@ -58,19 +58,142 @@ *
Note: close() needs to be called on the MachineImagesClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified machine image. Deleting a machine image is permanent and cannot be undone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteMachineImageRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String machineImage) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified machine image.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetMachineImageRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String machineImage) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyMachineImageRequest 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(String project, 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() + *
+ * + *Insert + *+ * Creates a machine image in the specified project using the data that is included in the request. If you are creating a new machine image to update an existing instance, your new machine image should use the same network or, if applicable, the same subnetwork as the original instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertMachineImageRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, MachineImage machineImageResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of machine images that are contained within the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListMachineImagesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyMachineImageRequest 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(String project, String resource, GlobalSetPolicyRequest globalSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsMachineImageRequest 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(String project, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/MachineTypesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/MachineTypesClient.java index 6a183cf2c206..e470f6e164f7 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/MachineTypesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/MachineTypesClient.java @@ -57,19 +57,69 @@ *
Note: close() needs to be called on the MachineTypesClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of machine types.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListMachineTypesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Get + *+ * Returns the specified machine type.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetMachineTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String zone, String machineType) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + * + *List + *+ * Retrieves a list of machine types available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListMachineTypesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworkAttachmentsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworkAttachmentsClient.java index 44ea116cbdb9..eec91635eda5 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworkAttachmentsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworkAttachmentsClient.java @@ -61,19 +61,180 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves the list of all NetworkAttachment resources, regional and global, available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListNetworkAttachmentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified NetworkAttachment in the given scope
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteNetworkAttachmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String networkAttachment) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified NetworkAttachment resource in the given scope.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetNetworkAttachmentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String networkAttachment) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyNetworkAttachmentRequest 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(String project, String region, 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() + *
+ * + *Insert + *+ * Creates a NetworkAttachment in the specified project in the given scope using the parameters that are included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertNetworkAttachmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, NetworkAttachment networkAttachmentResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Lists the NetworkAttachments for a project in the given scope.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListNetworkAttachmentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Patches the specified NetworkAttachment resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchNetworkAttachmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String networkAttachment, NetworkAttachment networkAttachmentResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyNetworkAttachmentRequest 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(String project, String region, String resource, RegionSetPolicyRequest regionSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsNetworkAttachmentRequest 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(String project, String region, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworkEdgeSecurityServicesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworkEdgeSecurityServicesClient.java index a385216438b7..c864f40e1b06 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworkEdgeSecurityServicesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworkEdgeSecurityServicesClient.java @@ -63,19 +63,107 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves the list of all NetworkEdgeSecurityService resources available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListNetworkEdgeSecurityServicesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteNetworkEdgeSecurityServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String networkEdgeSecurityService) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Gets a specified NetworkEdgeSecurityService.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetNetworkEdgeSecurityServiceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String networkEdgeSecurityService) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a new service in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertNetworkEdgeSecurityServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, NetworkEdgeSecurityService networkEdgeSecurityServiceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + * + *Patch + *+ * Patches the specified policy with the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchNetworkEdgeSecurityServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String networkEdgeSecurityService, NetworkEdgeSecurityService networkEdgeSecurityServiceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworkEndpointGroupsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworkEndpointGroupsClient.java index f501da132f18..b5ffee4c07bd 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworkEndpointGroupsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworkEndpointGroupsClient.java @@ -63,19 +63,182 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves the list of network endpoint groups and sorts them by zone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListNetworkEndpointGroupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *AttachNetworkEndpoints + *+ * Attach a list of network endpoints to the specified network endpoint group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- attachNetworkEndpointsAsync(AttachNetworkEndpointsNetworkEndpointGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- attachNetworkEndpointsAsync(String project, String zone, String networkEndpointGroup, NetworkEndpointGroupsAttachEndpointsRequest networkEndpointGroupsAttachEndpointsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- attachNetworkEndpointsOperationCallable() + *
- attachNetworkEndpointsCallable() + *
+ * + *Delete + *+ * Deletes the specified network endpoint group. The network endpoints in the NEG and the VM instances they belong to are not terminated when the NEG is deleted. Note that the NEG cannot be deleted if there are backend services referencing it.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteNetworkEndpointGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String zone, String networkEndpointGroup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *DetachNetworkEndpoints + *+ * Detach a list of network endpoints from the specified network endpoint group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- detachNetworkEndpointsAsync(DetachNetworkEndpointsNetworkEndpointGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- detachNetworkEndpointsAsync(String project, String zone, String networkEndpointGroup, NetworkEndpointGroupsDetachEndpointsRequest networkEndpointGroupsDetachEndpointsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- detachNetworkEndpointsOperationCallable() + *
- detachNetworkEndpointsCallable() + *
+ * + *Get + *+ * Returns the specified network endpoint group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetNetworkEndpointGroupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String zone, String networkEndpointGroup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a network endpoint group in the specified project using the parameters that are included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertNetworkEndpointGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String zone, NetworkEndpointGroup networkEndpointGroupResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of network endpoint groups that are located in the specified project and zone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListNetworkEndpointGroupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *ListNetworkEndpoints + *+ * Lists the network endpoints in the specified network endpoint group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listNetworkEndpoints(ListNetworkEndpointsNetworkEndpointGroupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listNetworkEndpoints(String project, String zone, String networkEndpointGroup, NetworkEndpointGroupsListEndpointsRequest networkEndpointGroupsListEndpointsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listNetworkEndpointsPagedCallable() + *
- listNetworkEndpointsCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsNetworkEndpointGroupRequest 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(String project, String zone, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworkFirewallPoliciesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworkFirewallPoliciesClient.java index 3e89240737ec..906421c30c4c 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworkFirewallPoliciesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworkFirewallPoliciesClient.java @@ -60,19 +60,311 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AddAssociation + *+ * Inserts an association for the specified firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addAssociationAsync(AddAssociationNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addAssociationAsync(String project, String firewallPolicy, FirewallPolicyAssociation firewallPolicyAssociationResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addAssociationOperationCallable() + *
- addAssociationCallable() + *
+ * + *AddRule + *+ * Inserts a rule into a firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addRuleAsync(AddRuleNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addRuleAsync(String project, String firewallPolicy, FirewallPolicyRule firewallPolicyRuleResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addRuleOperationCallable() + *
- addRuleCallable() + *
+ * + *CloneRules + *+ * Copies rules to the specified firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- cloneRulesAsync(CloneRulesNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- cloneRulesAsync(String project, String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- cloneRulesOperationCallable() + *
- cloneRulesCallable() + *
+ * + *Delete + *+ * Deletes the specified policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified network firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetNetworkFirewallPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetAssociation + *+ * Gets an association with the specified name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getAssociation(GetAssociationNetworkFirewallPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getAssociation(String project, String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getAssociationCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyNetworkFirewallPolicyRequest 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(String project, 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() + *
+ * + *GetRule + *+ * Gets a rule of the specified priority.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getRule(GetRuleNetworkFirewallPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getRule(String project, String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getRuleCallable() + *
+ * + *Insert + *+ * Creates a new policy in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, FirewallPolicy firewallPolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Lists all the policies that have been configured for the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListNetworkFirewallPoliciesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Patches the specified policy with the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String firewallPolicy, FirewallPolicy firewallPolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *PatchRule + *+ * Patches a rule of the specified priority.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchRuleAsync(PatchRuleNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchRuleAsync(String project, String firewallPolicy, FirewallPolicyRule firewallPolicyRuleResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchRuleOperationCallable() + *
- patchRuleCallable() + *
+ * + *RemoveAssociation + *+ * Removes an association for the specified firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeAssociationAsync(RemoveAssociationNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- removeAssociationAsync(String project, String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeAssociationOperationCallable() + *
- removeAssociationCallable() + *
+ * + *RemoveRule + *+ * Deletes a rule of the specified priority.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeRuleAsync(RemoveRuleNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- removeRuleAsync(String project, String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeRuleOperationCallable() + *
- removeRuleCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyNetworkFirewallPolicyRequest 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(String project, String resource, GlobalSetPolicyRequest globalSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsNetworkFirewallPolicyRequest 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(String project, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworksClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworksClient.java index 95d041f60961..3e3e2cb30105 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworksClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NetworksClient.java @@ -58,19 +58,220 @@ *
Note: close() needs to be called on the NetworksClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AddPeering + *+ * Adds a peering to the specified network.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addPeeringAsync(AddPeeringNetworkRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addPeeringAsync(String project, String network, NetworksAddPeeringRequest networksAddPeeringRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addPeeringOperationCallable() + *
- addPeeringCallable() + *
+ * + *Delete + *+ * Deletes the specified network.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteNetworkRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String network) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified network.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetNetworkRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String network) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetEffectiveFirewalls + *+ * Returns the effective firewalls on a given network.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getEffectiveFirewalls(GetEffectiveFirewallsNetworkRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getEffectiveFirewalls(String project, String network) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getEffectiveFirewallsCallable() + *
+ * + *Insert + *+ * Creates a network in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertNetworkRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, Network networkResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of networks available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListNetworksRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *ListPeeringRoutes + *+ * Lists the peering routes exchanged over peering connection.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listPeeringRoutes(ListPeeringRoutesNetworksRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listPeeringRoutes(String project, String network) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPeeringRoutesPagedCallable() + *
- listPeeringRoutesCallable() + *
+ * + *Patch + *+ * Patches the specified network with the data included in the request. Only the following fields can be modified: routingConfig.routingMode.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchNetworkRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String network, Network networkResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *RemovePeering + *+ * Removes a peering from the specified network.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removePeeringAsync(RemovePeeringNetworkRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- removePeeringAsync(String project, String network, NetworksRemovePeeringRequest networksRemovePeeringRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removePeeringOperationCallable() + *
- removePeeringCallable() + *
+ * + *SwitchToCustomMode + *+ * Switches the network mode from auto subnet mode to custom subnet mode.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- switchToCustomModeAsync(SwitchToCustomModeNetworkRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- switchToCustomModeAsync(String project, String network) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- switchToCustomModeOperationCallable() + *
- switchToCustomModeCallable() + *
+ * + * + *UpdatePeering + *+ * Updates the specified network peering with the data included in the request. You can only modify the NetworkPeering.export_custom_routes field and the NetworkPeering.import_custom_routes field.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updatePeeringAsync(UpdatePeeringNetworkRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updatePeeringAsync(String project, String network, NetworksUpdatePeeringRequest networksUpdatePeeringRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updatePeeringOperationCallable() + *
- updatePeeringCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NodeGroupsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NodeGroupsClient.java index 91c320b64fcd..b14956e8ccfa 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NodeGroupsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NodeGroupsClient.java @@ -60,19 +60,275 @@ *
Note: close() needs to be called on the NodeGroupsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AddNodes + *+ * Adds specified number of nodes to the node group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addNodesAsync(AddNodesNodeGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addNodesAsync(String project, String zone, String nodeGroup, NodeGroupsAddNodesRequest nodeGroupsAddNodesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addNodesOperationCallable() + *
- addNodesCallable() + *
+ * + *AggregatedList + *+ * Retrieves an aggregated list of node groups. Note: use nodeGroups.listNodes for more details about each group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListNodeGroupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified NodeGroup resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteNodeGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String zone, String nodeGroup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *DeleteNodes + *+ * Deletes specified nodes from the node group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteNodesAsync(DeleteNodesNodeGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteNodesAsync(String project, String zone, String nodeGroup, NodeGroupsDeleteNodesRequest nodeGroupsDeleteNodesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteNodesOperationCallable() + *
- deleteNodesCallable() + *
+ * + *Get + *+ * Returns the specified NodeGroup. Get a list of available NodeGroups by making a list() request. Note: the "nodes" field should not be used. Use nodeGroups.listNodes instead.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetNodeGroupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String zone, String nodeGroup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyNodeGroupRequest 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(String project, String zone, 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() + *
+ * + *Insert + *+ * Creates a NodeGroup resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertNodeGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String zone, int initialNodeCount, NodeGroup nodeGroupResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of node groups available to the specified project. Note: use nodeGroups.listNodes for more details about each group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListNodeGroupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *ListNodes + *+ * Lists nodes in the node group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listNodes(ListNodesNodeGroupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listNodes(String project, String zone, String nodeGroup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listNodesPagedCallable() + *
- listNodesCallable() + *
+ * + *Patch + *+ * Updates the specified node group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchNodeGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String zone, String nodeGroup, NodeGroup nodeGroupResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyNodeGroupRequest 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(String project, String zone, String resource, ZoneSetPolicyRequest zoneSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *SetNodeTemplate + *+ * Updates the node template of the node group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setNodeTemplateAsync(SetNodeTemplateNodeGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setNodeTemplateAsync(String project, String zone, String nodeGroup, NodeGroupsSetNodeTemplateRequest nodeGroupsSetNodeTemplateRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setNodeTemplateOperationCallable() + *
- setNodeTemplateCallable() + *
+ * + *SimulateMaintenanceEvent + *+ * Simulates maintenance event on specified nodes from the node group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- simulateMaintenanceEventAsync(SimulateMaintenanceEventNodeGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- simulateMaintenanceEventAsync(String project, String zone, String nodeGroup, NodeGroupsSimulateMaintenanceEventRequest nodeGroupsSimulateMaintenanceEventRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- simulateMaintenanceEventOperationCallable() + *
- simulateMaintenanceEventCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsNodeGroupRequest 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(String project, String zone, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NodeTemplatesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NodeTemplatesClient.java index b69c5b89d075..b7938bd9f764 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NodeTemplatesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NodeTemplatesClient.java @@ -60,19 +60,161 @@ *
Note: close() needs to be called on the NodeTemplatesClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of node templates.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListNodeTemplatesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified NodeTemplate resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteNodeTemplateRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String nodeTemplate) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified node template.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetNodeTemplateRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String nodeTemplate) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyNodeTemplateRequest 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(String project, String region, 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() + *
+ * + *Insert + *+ * Creates a NodeTemplate resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertNodeTemplateRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, NodeTemplate nodeTemplateResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of node templates available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListNodeTemplatesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyNodeTemplateRequest 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(String project, String region, String resource, RegionSetPolicyRequest regionSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsNodeTemplateRequest 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(String project, String region, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NodeTypesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NodeTypesClient.java index 3f5607cf225d..7af45fbb4b18 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NodeTypesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/NodeTypesClient.java @@ -57,19 +57,69 @@ *
Note: close() needs to be called on the NodeTypesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of node types.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListNodeTypesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Get + *+ * Returns the specified node type.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetNodeTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String zone, String nodeType) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + * + *List + *+ * Retrieves a list of node types available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListNodeTypesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/PacketMirroringsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/PacketMirroringsClient.java index fa846a8df2ff..a7b9d4a344b2 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/PacketMirroringsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/PacketMirroringsClient.java @@ -61,19 +61,144 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of packetMirrorings.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListPacketMirroringsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified PacketMirroring resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeletePacketMirroringRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String packetMirroring) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified PacketMirroring resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetPacketMirroringRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String packetMirroring) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a PacketMirroring resource in the specified project and region using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertPacketMirroringRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, PacketMirroring packetMirroringResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of PacketMirroring resources available to the specified project and region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListPacketMirroringsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Patches the specified PacketMirroring resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchPacketMirroringRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String packetMirroring, PacketMirroring packetMirroringResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsPacketMirroringRequest 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(String project, String region, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ProjectsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ProjectsClient.java index 41e15c83c488..0e1f503bbb1b 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ProjectsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ProjectsClient.java @@ -57,19 +57,258 @@ *
Note: close() needs to be called on the ProjectsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *DisableXpnHost + *+ * Disable this project as a shared VPC host project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- disableXpnHostAsync(DisableXpnHostProjectRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- disableXpnHostAsync(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- disableXpnHostOperationCallable() + *
- disableXpnHostCallable() + *
+ * + *DisableXpnResource + *+ * Disable a service resource (also known as service project) associated with this host project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- disableXpnResourceAsync(DisableXpnResourceProjectRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- disableXpnResourceAsync(String project, ProjectsDisableXpnResourceRequest projectsDisableXpnResourceRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- disableXpnResourceOperationCallable() + *
- disableXpnResourceCallable() + *
+ * + *EnableXpnHost + *+ * Enable this project as a shared VPC host project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- enableXpnHostAsync(EnableXpnHostProjectRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- enableXpnHostAsync(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- enableXpnHostOperationCallable() + *
- enableXpnHostCallable() + *
+ * + *EnableXpnResource + *+ * Enable service resource (a.k.a service project) for a host project, so that subnets in the host project can be used by instances in the service project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- enableXpnResourceAsync(EnableXpnResourceProjectRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- enableXpnResourceAsync(String project, ProjectsEnableXpnResourceRequest projectsEnableXpnResourceRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- enableXpnResourceOperationCallable() + *
- enableXpnResourceCallable() + *
+ * + *Get + *+ * Returns the specified Project resource. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(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.
+ *+ *
+ *- get(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetXpnHost + *+ * Gets the shared VPC host project that this project links to. May be empty if no link exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getXpnHost(GetXpnHostProjectRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getXpnHost(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getXpnHostCallable() + *
+ * + *GetXpnResources + *+ * Gets service resources (a.k.a service project) associated with this host project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getXpnResources(GetXpnResourcesProjectsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getXpnResources(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getXpnResourcesPagedCallable() + *
- getXpnResourcesCallable() + *
+ * + *ListXpnHosts + *+ * Lists all shared VPC host projects visible to the user in an organization.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listXpnHosts(ListXpnHostsProjectsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listXpnHosts(String project, ProjectsListXpnHostsRequest projectsListXpnHostsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listXpnHostsPagedCallable() + *
- listXpnHostsCallable() + *
+ * + *MoveDisk + *+ * Moves a persistent disk from one zone to another.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- moveDiskAsync(MoveDiskProjectRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- moveDiskAsync(String project, DiskMoveRequest diskMoveRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- moveDiskOperationCallable() + *
- moveDiskCallable() + *
+ * + *MoveInstance + *+ * Moves an instance and its attached persistent disks from one zone to another. *Note*: Moving VMs or disks by using this method might cause unexpected behavior. For more information, see the [known issue](/compute/docs/troubleshooting/known-issues#moving_vms_or_disks_using_the_moveinstance_api_or_the_causes_unexpected_behavior). [Deprecated] This method is deprecated. See [moving instance across zones](/compute/docs/instances/moving-instance-across-zones) instead.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- moveInstanceAsync(MoveInstanceProjectRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- moveInstanceAsync(String project, InstanceMoveRequest instanceMoveRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- moveInstanceOperationCallable() + *
- moveInstanceCallable() + *
+ * + *SetCommonInstanceMetadata + *+ * Sets metadata common to all instances within the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setCommonInstanceMetadataAsync(SetCommonInstanceMetadataProjectRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setCommonInstanceMetadataAsync(String project, Metadata metadataResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setCommonInstanceMetadataOperationCallable() + *
- setCommonInstanceMetadataCallable() + *
+ * + *SetDefaultNetworkTier + *+ * Sets the default network tier of the project. The default network tier is used when an address/forwardingRule/instance is created without specifying the network tier field.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setDefaultNetworkTierAsync(SetDefaultNetworkTierProjectRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setDefaultNetworkTierAsync(String project, ProjectsSetDefaultNetworkTierRequest projectsSetDefaultNetworkTierRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setDefaultNetworkTierOperationCallable() + *
- setDefaultNetworkTierCallable() + *
+ * + * + *SetUsageExportBucket + *+ * Enables the usage export feature and sets the usage export bucket where reports are stored. If you provide an empty request body using this method, the usage export feature will be disabled.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setUsageExportBucketAsync(SetUsageExportBucketProjectRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setUsageExportBucketAsync(String project, UsageExportLocation usageExportLocationResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setUsageExportBucketOperationCallable() + *
- setUsageExportBucketCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/PublicAdvertisedPrefixesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/PublicAdvertisedPrefixesClient.java index c0a2a0a2ba7b..30d0ff56e71e 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/PublicAdvertisedPrefixesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/PublicAdvertisedPrefixesClient.java @@ -61,19 +61,145 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Announce + *+ * Announces the specified PublicAdvertisedPrefix
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- announceAsync(AnnouncePublicAdvertisedPrefixeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- announceAsync(String project, String publicAdvertisedPrefix) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- announceOperationCallable() + *
- announceCallable() + *
+ * + *Delete + *+ * Deletes the specified PublicAdvertisedPrefix
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeletePublicAdvertisedPrefixeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String publicAdvertisedPrefix) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified PublicAdvertisedPrefix resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetPublicAdvertisedPrefixeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String publicAdvertisedPrefix) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a PublicAdvertisedPrefix in the specified project using the parameters that are included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertPublicAdvertisedPrefixeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, PublicAdvertisedPrefix publicAdvertisedPrefixResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Lists the PublicAdvertisedPrefixes for a project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListPublicAdvertisedPrefixesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Patches the specified Router resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchPublicAdvertisedPrefixeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String publicAdvertisedPrefix, PublicAdvertisedPrefix publicAdvertisedPrefixResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + * + *Withdraw + *+ * Withdraws the specified PublicAdvertisedPrefix
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- withdrawAsync(WithdrawPublicAdvertisedPrefixeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- withdrawAsync(String project, String publicAdvertisedPrefix) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- withdrawOperationCallable() + *
- withdrawCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/PublicDelegatedPrefixesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/PublicDelegatedPrefixesClient.java index 5fb5183f188d..0886a82b9d96 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/PublicDelegatedPrefixesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/PublicDelegatedPrefixesClient.java @@ -63,19 +63,164 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Lists all PublicDelegatedPrefix resources owned by the specific project across all scopes.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListPublicDelegatedPrefixesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Announce + *+ * Announces the specified PublicDelegatedPrefix in the given region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- announceAsync(AnnouncePublicDelegatedPrefixeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- announceAsync(String project, String region, String publicDelegatedPrefix) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- announceOperationCallable() + *
- announceCallable() + *
+ * + *Delete + *+ * Deletes the specified PublicDelegatedPrefix in the given region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeletePublicDelegatedPrefixeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String publicDelegatedPrefix) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified PublicDelegatedPrefix resource in the given region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetPublicDelegatedPrefixeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String publicDelegatedPrefix) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a PublicDelegatedPrefix in the specified project in the given region using the parameters that are included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertPublicDelegatedPrefixeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, PublicDelegatedPrefix publicDelegatedPrefixResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Lists the PublicDelegatedPrefixes for a project in the given region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListPublicDelegatedPrefixesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Patches the specified PublicDelegatedPrefix resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchPublicDelegatedPrefixeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String publicDelegatedPrefix, PublicDelegatedPrefix publicDelegatedPrefixResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + * + *Withdraw + *+ * Withdraws the specified PublicDelegatedPrefix in the given region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- withdrawAsync(WithdrawPublicDelegatedPrefixeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- withdrawAsync(String project, String region, String publicDelegatedPrefix) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- withdrawOperationCallable() + *
- withdrawCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionAutoscalersClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionAutoscalersClient.java index 737314a5417d..a9aa4975ffa1 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionAutoscalersClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionAutoscalersClient.java @@ -60,19 +60,126 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified autoscaler.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionAutoscalerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String autoscaler) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified autoscaler.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionAutoscalerRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String autoscaler) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates an autoscaler in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionAutoscalerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, Autoscaler autoscalerResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of autoscalers contained within the specified region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionAutoscalersRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Updates an autoscaler in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchRegionAutoscalerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, Autoscaler autoscalerResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + * + *Update + *+ * Updates an autoscaler in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAsync(UpdateRegionAutoscalerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAsync(String project, String region, Autoscaler autoscalerResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateOperationCallable() + *
- updateCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionBackendServicesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionBackendServicesClient.java index ddbea9fde2a3..2dabb8b3992a 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionBackendServicesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionBackendServicesClient.java @@ -61,19 +61,236 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified regional BackendService resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionBackendServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String backendService) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified regional BackendService resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionBackendServiceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String backendService) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetHealth + *+ * Gets the most recent health check results for this regional BackendService.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getHealth(GetHealthRegionBackendServiceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getHealth(String project, String region, String backendService, ResourceGroupReference resourceGroupReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getHealthCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyRegionBackendServiceRequest 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(String project, String region, 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() + *
+ * + *Insert + *+ * Creates a regional BackendService resource in the specified project using the data included in the request. For more information, see Backend services overview.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionBackendServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, BackendService backendServiceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of regional BackendService resources available to the specified project in the given region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionBackendServicesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *ListUsable + *+ * Retrieves an aggregated list of all usable backend services in the specified project in the given region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listUsable(ListUsableRegionBackendServicesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listUsable(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listUsablePagedCallable() + *
- listUsableCallable() + *
+ * + *Patch + *+ * Updates the specified regional BackendService resource with the data included in the request. For more information, see Understanding backend services This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchRegionBackendServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String backendService, BackendService backendServiceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyRegionBackendServiceRequest 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(String project, String region, String resource, RegionSetPolicyRequest regionSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *SetSecurityPolicy + *+ * Sets the Google Cloud Armor security policy for the specified backend service. For more information, see Google Cloud Armor Overview
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setSecurityPolicyAsync(SetSecurityPolicyRegionBackendServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setSecurityPolicyAsync(String project, String region, String backendService, SecurityPolicyReference securityPolicyReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setSecurityPolicyOperationCallable() + *
- setSecurityPolicyCallable() + *
+ * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsRegionBackendServiceRequest 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(String project, String region, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
+ * + * + *Update + *+ * Updates the specified regional BackendService resource with the data included in the request. For more information, see Backend services overview .
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAsync(UpdateRegionBackendServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAsync(String project, String region, String backendService, BackendService backendServiceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateOperationCallable() + *
- updateCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionCommitmentsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionCommitmentsClient.java index fdd91d143ded..51322348933f 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionCommitmentsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionCommitmentsClient.java @@ -61,19 +61,107 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of commitments by region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListRegionCommitmentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Get + *+ * Returns the specified commitment resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionCommitmentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String commitment) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a commitment in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionCommitmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, Commitment commitmentResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of commitments contained within the specified region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionCommitmentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + * + *Update + *+ * Updates the specified commitment with the data included in the request. Update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: auto_renew.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAsync(UpdateRegionCommitmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAsync(String project, String region, String commitment, Commitment commitmentResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateOperationCallable() + *
- updateCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionDiskTypesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionDiskTypesClient.java index 538ab7edf71b..cd5799b3396a 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionDiskTypesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionDiskTypesClient.java @@ -57,19 +57,50 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Get + *+ * Returns the specified regional disk type.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionDiskTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String diskType) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + * + *List + *+ * Retrieves a list of regional disk types available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionDiskTypesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionDisksClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionDisksClient.java index 3f58d54c1bb7..b954ed754283 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionDisksClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionDisksClient.java @@ -59,19 +59,332 @@ *
Note: close() needs to be called on the RegionDisksClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AddResourcePolicies + *+ * Adds existing resource policies to a regional disk. You can only add one policy which will be applied to this disk for scheduling snapshot creation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addResourcePoliciesAsync(AddResourcePoliciesRegionDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addResourcePoliciesAsync(String project, String region, String disk, RegionDisksAddResourcePoliciesRequest regionDisksAddResourcePoliciesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addResourcePoliciesOperationCallable() + *
- addResourcePoliciesCallable() + *
+ * + *BulkInsert + *+ * Bulk create a set of disks.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- bulkInsertAsync(BulkInsertRegionDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- bulkInsertAsync(String project, String region, BulkInsertDiskResource bulkInsertDiskResourceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- bulkInsertOperationCallable() + *
- bulkInsertCallable() + *
+ * + *CreateSnapshot + *+ * Creates a snapshot of a specified persistent disk. For regular snapshot creation, consider using snapshots.insert instead, as that method supports more features, such as creating snapshots in a project different from the source disk project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createSnapshotAsync(CreateSnapshotRegionDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createSnapshotAsync(String project, String region, String disk, Snapshot snapshotResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createSnapshotOperationCallable() + *
- createSnapshotCallable() + *
+ * + *Delete + *+ * Deletes the specified regional persistent disk. Deleting a regional disk removes all the replicas of its data permanently and is irreversible. However, deleting a disk does not delete any snapshots previously made from the disk. You must separately delete snapshots.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String disk) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns a specified regional persistent disk.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionDiskRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String disk) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyRegionDiskRequest 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(String project, String region, 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() + *
+ * + *Insert + *+ * Creates a persistent regional disk in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, Disk diskResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of persistent disks contained within the specified region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionDisksRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *RemoveResourcePolicies + *+ * Removes resource policies from a regional disk.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeResourcePoliciesAsync(RemoveResourcePoliciesRegionDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- removeResourcePoliciesAsync(String project, String region, String disk, RegionDisksRemoveResourcePoliciesRequest regionDisksRemoveResourcePoliciesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeResourcePoliciesOperationCallable() + *
- removeResourcePoliciesCallable() + *
+ * + *Resize + *+ * Resizes the specified regional persistent disk.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- resizeAsync(ResizeRegionDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- resizeAsync(String project, String region, String disk, RegionDisksResizeRequest regionDisksResizeRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- resizeOperationCallable() + *
- resizeCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyRegionDiskRequest 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(String project, String region, String resource, RegionSetPolicyRequest regionSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *SetLabels + *+ * Sets the labels on the target regional disk.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabelsAsync(SetLabelsRegionDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setLabelsAsync(String project, String region, String resource, RegionSetLabelsRequest regionSetLabelsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsOperationCallable() + *
- setLabelsCallable() + *
+ * + *StartAsyncReplication + *+ * Starts asynchronous replication. Must be invoked on the primary disk.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- startAsyncReplicationAsync(StartAsyncReplicationRegionDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- startAsyncReplicationAsync(String project, String region, String disk, RegionDisksStartAsyncReplicationRequest regionDisksStartAsyncReplicationRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- startAsyncReplicationOperationCallable() + *
- startAsyncReplicationCallable() + *
+ * + *StopAsyncReplication + *+ * Stops asynchronous replication. Can be invoked either on the primary or on the secondary disk.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- stopAsyncReplicationAsync(StopAsyncReplicationRegionDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- stopAsyncReplicationAsync(String project, String region, String disk) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- stopAsyncReplicationOperationCallable() + *
- stopAsyncReplicationCallable() + *
+ * + *StopGroupAsyncReplication + *+ * Stops asynchronous replication for a consistency group of disks. Can be invoked either in the primary or secondary scope.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- stopGroupAsyncReplicationAsync(StopGroupAsyncReplicationRegionDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- stopGroupAsyncReplicationAsync(String project, String region, DisksStopGroupAsyncReplicationResource disksStopGroupAsyncReplicationResourceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- stopGroupAsyncReplicationOperationCallable() + *
- stopGroupAsyncReplicationCallable() + *
+ * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsRegionDiskRequest 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(String project, String region, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
+ * + * + *Update + *+ * Update the specified disk with the data included in the request. Update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: user_license.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAsync(UpdateRegionDiskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAsync(String project, String region, String disk, Disk diskResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateOperationCallable() + *
- updateCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionHealthCheckServicesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionHealthCheckServicesClient.java index 90f1316813ac..27f474b29319 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionHealthCheckServicesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionHealthCheckServicesClient.java @@ -62,19 +62,107 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified regional HealthCheckService.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionHealthCheckServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String healthCheckService) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified regional HealthCheckService resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionHealthCheckServiceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String healthCheckService) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a regional HealthCheckService resource in the specified project and region using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionHealthCheckServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, HealthCheckService healthCheckServiceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Lists all the HealthCheckService resources that have been configured for the specified project in the given region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionHealthCheckServicesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + * + *Patch + *+ * Updates the specified regional HealthCheckService resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchRegionHealthCheckServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String healthCheckService, HealthCheckService healthCheckServiceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionHealthChecksClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionHealthChecksClient.java index 62515e726e7e..66b0e47d9abf 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionHealthChecksClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionHealthChecksClient.java @@ -60,19 +60,126 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified HealthCheck resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionHealthCheckRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String healthCheck) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified HealthCheck resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionHealthCheckRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String healthCheck) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a HealthCheck resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionHealthCheckRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, HealthCheck healthCheckResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of HealthCheck resources available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionHealthChecksRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Updates a HealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchRegionHealthCheckRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String healthCheck, HealthCheck healthCheckResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + * + *Update + *+ * Updates a HealthCheck resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAsync(UpdateRegionHealthCheckRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAsync(String project, String region, String healthCheck, HealthCheck healthCheckResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateOperationCallable() + *
- updateCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstanceGroupManagersClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstanceGroupManagersClient.java index 110cac43a4a9..efdb36b3cec3 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstanceGroupManagersClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstanceGroupManagersClient.java @@ -62,19 +62,373 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AbandonInstances + *+ * Flags the specified instances to be immediately removed from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- abandonInstancesAsync(AbandonInstancesRegionInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- abandonInstancesAsync(String project, String region, String instanceGroupManager, RegionInstanceGroupManagersAbandonInstancesRequest regionInstanceGroupManagersAbandonInstancesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- abandonInstancesOperationCallable() + *
- abandonInstancesCallable() + *
+ * + *ApplyUpdatesToInstances + *+ * Apply updates to selected instances the managed instance group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- applyUpdatesToInstancesAsync(ApplyUpdatesToInstancesRegionInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- applyUpdatesToInstancesAsync(String project, String region, String instanceGroupManager, RegionInstanceGroupManagersApplyUpdatesRequest regionInstanceGroupManagersApplyUpdatesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- applyUpdatesToInstancesOperationCallable() + *
- applyUpdatesToInstancesCallable() + *
+ * + *CreateInstances + *+ * Creates instances with per-instance configurations in this regional managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createInstancesAsync(CreateInstancesRegionInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createInstancesAsync(String project, String region, String instanceGroupManager, RegionInstanceGroupManagersCreateInstancesRequest regionInstanceGroupManagersCreateInstancesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createInstancesOperationCallable() + *
- createInstancesCallable() + *
+ * + *Delete + *+ * Deletes the specified managed instance group and all of the instances in that group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String instanceGroupManager) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *DeleteInstances + *+ * Flags the specified instances in the managed instance group to be immediately deleted. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. The deleteInstances operation is marked DONE if the deleteInstances request is successful. The underlying actions take additional time. You must separately verify the status of the deleting action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteInstancesAsync(DeleteInstancesRegionInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteInstancesAsync(String project, String region, String instanceGroupManager, RegionInstanceGroupManagersDeleteInstancesRequest regionInstanceGroupManagersDeleteInstancesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteInstancesOperationCallable() + *
- deleteInstancesCallable() + *
+ * + *DeletePerInstanceConfigs + *+ * Deletes selected per-instance configurations for the managed instance group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deletePerInstanceConfigsAsync(DeletePerInstanceConfigsRegionInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deletePerInstanceConfigsAsync(String project, String region, String instanceGroupManager, RegionInstanceGroupManagerDeleteInstanceConfigReq regionInstanceGroupManagerDeleteInstanceConfigReqResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deletePerInstanceConfigsOperationCallable() + *
- deletePerInstanceConfigsCallable() + *
+ * + *Get + *+ * Returns all of the details about the specified managed instance group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionInstanceGroupManagerRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String instanceGroupManager) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a managed instance group using the information that you specify in the request. After the group is created, instances in the group are created using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method. A regional managed instance group can contain up to 2000 instances.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, InstanceGroupManager instanceGroupManagerResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of managed instance groups that are contained within the specified region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionInstanceGroupManagersRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *ListErrors + *+ * Lists all errors thrown by actions on instances for a given regional managed instance group. The filter and orderBy query parameters are not supported.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listErrors(ListErrorsRegionInstanceGroupManagersRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listErrors(String project, String region, String instanceGroupManager) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listErrorsPagedCallable() + *
- listErrorsCallable() + *
+ * + *ListManagedInstances + *+ * Lists the instances in the managed instance group and instances that are scheduled to be created. The list includes any current actions that the group has scheduled for its instances. The orderBy query parameter is not supported. The `pageToken` query parameter is supported only in the alpha and beta API and only if the group's `listManagedInstancesResults` field is set to `PAGINATED`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listManagedInstances(ListManagedInstancesRegionInstanceGroupManagersRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listManagedInstances(String project, String region, String instanceGroupManager) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listManagedInstancesPagedCallable() + *
- listManagedInstancesCallable() + *
+ * + *ListPerInstanceConfigs + *+ * Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listPerInstanceConfigs(ListPerInstanceConfigsRegionInstanceGroupManagersRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listPerInstanceConfigs(String project, String region, String instanceGroupManager) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPerInstanceConfigsPagedCallable() + *
- listPerInstanceConfigsCallable() + *
+ * + *Patch + *+ * Updates a managed instance group using the information that you specify in the request. This operation is marked as DONE when the group is patched even if the instances in the group are still in the process of being patched. You must separately verify the status of the individual instances with the listmanagedinstances method. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. If you update your group to specify a new template or instance configuration, it's possible that your intended specification for each VM in the group is different from the current state of that VM. To learn how to apply an updated configuration to the VMs in a MIG, see Updating instances in a MIG.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchRegionInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String instanceGroupManager, InstanceGroupManager instanceGroupManagerResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *PatchPerInstanceConfigs + *+ * Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchPerInstanceConfigsAsync(PatchPerInstanceConfigsRegionInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchPerInstanceConfigsAsync(String project, String region, String instanceGroupManager, RegionInstanceGroupManagerPatchInstanceConfigReq regionInstanceGroupManagerPatchInstanceConfigReqResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchPerInstanceConfigsOperationCallable() + *
- patchPerInstanceConfigsCallable() + *
+ * + *RecreateInstances + *+ * Flags the specified VM instances in the managed instance group to be immediately recreated. Each instance is recreated using the group's current configuration. This operation is marked as DONE when the flag is set even if the instances have not yet been recreated. You must separately verify the status of each instance by checking its currentAction field; for more information, see Checking the status of managed instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- recreateInstancesAsync(RecreateInstancesRegionInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- recreateInstancesAsync(String project, String region, String instanceGroupManager, RegionInstanceGroupManagersRecreateRequest regionInstanceGroupManagersRecreateRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- recreateInstancesOperationCallable() + *
- recreateInstancesCallable() + *
+ * + *Resize + *+ * Changes the intended size of the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes one or more instances. The resize operation is marked DONE if the resize request is successful. The underlying actions take additional time. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- resizeAsync(ResizeRegionInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- resizeAsync(String project, String region, String instanceGroupManager, int size) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- resizeOperationCallable() + *
- resizeCallable() + *
+ * + *SetInstanceTemplate + *+ * Sets the instance template to use when creating new instances or recreating instances in this group. Existing instances are not affected.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setInstanceTemplateAsync(SetInstanceTemplateRegionInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setInstanceTemplateAsync(String project, String region, String instanceGroupManager, RegionInstanceGroupManagersSetTemplateRequest regionInstanceGroupManagersSetTemplateRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setInstanceTemplateOperationCallable() + *
- setInstanceTemplateCallable() + *
+ * + *SetTargetPools + *+ * Modifies the target pools to which all new instances in this group are assigned. Existing instances in the group are not affected.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setTargetPoolsAsync(SetTargetPoolsRegionInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setTargetPoolsAsync(String project, String region, String instanceGroupManager, RegionInstanceGroupManagersSetTargetPoolsRequest regionInstanceGroupManagersSetTargetPoolsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setTargetPoolsOperationCallable() + *
- setTargetPoolsCallable() + *
+ * + * + *UpdatePerInstanceConfigs + *+ * Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updatePerInstanceConfigsAsync(UpdatePerInstanceConfigsRegionInstanceGroupManagerRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updatePerInstanceConfigsAsync(String project, String region, String instanceGroupManager, RegionInstanceGroupManagerUpdateInstanceConfigReq regionInstanceGroupManagerUpdateInstanceConfigReqResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updatePerInstanceConfigsOperationCallable() + *
- updatePerInstanceConfigsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstanceGroupsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstanceGroupsClient.java index 10f86b05d84a..6b5cf10d2654 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstanceGroupsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstanceGroupsClient.java @@ -61,19 +61,88 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Get + *+ * Returns the specified instance group resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionInstanceGroupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String instanceGroup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *List + *+ * Retrieves the list of instance group resources contained within the specified region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionInstanceGroupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *ListInstances + *+ * Lists the instances in the specified instance group and displays information about the named ports. Depending on the specified options, this method can list all instances or only the instances that are running. The orderBy query parameter is not supported.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listInstances(ListInstancesRegionInstanceGroupsRequest 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(String project, String region, String instanceGroup, RegionInstanceGroupsListInstancesRequest regionInstanceGroupsListInstancesRequestResource) + *
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() + *
+ * + * + *SetNamedPorts + *+ * Sets the named ports for the specified regional instance group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setNamedPortsAsync(SetNamedPortsRegionInstanceGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setNamedPortsAsync(String project, String region, String instanceGroup, RegionInstanceGroupsSetNamedPortsRequest regionInstanceGroupsSetNamedPortsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setNamedPortsOperationCallable() + *
- setNamedPortsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstanceTemplatesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstanceTemplatesClient.java index 0ec985158e3e..8caba41ff53b 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstanceTemplatesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstanceTemplatesClient.java @@ -62,19 +62,88 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified instance template. Deleting an instance template is permanent and cannot be undone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionInstanceTemplateRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String instanceTemplate) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified instance template.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionInstanceTemplateRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String instanceTemplate) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates an instance template in the specified project and region using the global instance template whose URL is included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionInstanceTemplateRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, InstanceTemplate instanceTemplateResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + * + *List + *+ * Retrieves a list of instance templates that are contained within the specified project and region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionInstanceTemplatesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstancesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstancesClient.java index 49ed02923ed0..5257527f3fd4 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstancesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionInstancesClient.java @@ -56,19 +56,32 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + * + *BulkInsert + *+ * Creates multiple instances in a given region. Count specifies the number of instances to create.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- bulkInsertAsync(BulkInsertRegionInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- bulkInsertAsync(String project, String region, BulkInsertInstanceResource bulkInsertInstanceResourceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- bulkInsertOperationCallable() + *
- bulkInsertCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionNetworkEndpointGroupsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionNetworkEndpointGroupsClient.java index 4cc8dcb8b908..3f360690b07f 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionNetworkEndpointGroupsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionNetworkEndpointGroupsClient.java @@ -62,19 +62,145 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AttachNetworkEndpoints + *+ * Attach a list of network endpoints to the specified network endpoint group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- attachNetworkEndpointsAsync(AttachNetworkEndpointsRegionNetworkEndpointGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- attachNetworkEndpointsAsync(String project, String region, String networkEndpointGroup, RegionNetworkEndpointGroupsAttachEndpointsRequest regionNetworkEndpointGroupsAttachEndpointsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- attachNetworkEndpointsOperationCallable() + *
- attachNetworkEndpointsCallable() + *
+ * + *Delete + *+ * Deletes the specified network endpoint group. Note that the NEG cannot be deleted if it is configured as a backend of a backend service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionNetworkEndpointGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String networkEndpointGroup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *DetachNetworkEndpoints + *+ * Detach the network endpoint from the specified network endpoint group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- detachNetworkEndpointsAsync(DetachNetworkEndpointsRegionNetworkEndpointGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- detachNetworkEndpointsAsync(String project, String region, String networkEndpointGroup, RegionNetworkEndpointGroupsDetachEndpointsRequest regionNetworkEndpointGroupsDetachEndpointsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- detachNetworkEndpointsOperationCallable() + *
- detachNetworkEndpointsCallable() + *
+ * + *Get + *+ * Returns the specified network endpoint group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionNetworkEndpointGroupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String networkEndpointGroup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a network endpoint group in the specified project using the parameters that are included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionNetworkEndpointGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, NetworkEndpointGroup networkEndpointGroupResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of regional network endpoint groups available to the specified project in the given region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionNetworkEndpointGroupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + * + *ListNetworkEndpoints + *+ * Lists the network endpoints in the specified network endpoint group.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listNetworkEndpoints(ListNetworkEndpointsRegionNetworkEndpointGroupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listNetworkEndpoints(String project, String region, String networkEndpointGroup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listNetworkEndpointsPagedCallable() + *
- listNetworkEndpointsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionNetworkFirewallPoliciesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionNetworkFirewallPoliciesClient.java index cd6badea8071..db87db7021cf 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionNetworkFirewallPoliciesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionNetworkFirewallPoliciesClient.java @@ -62,19 +62,329 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AddAssociation + *+ * Inserts an association for the specified network firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addAssociationAsync(AddAssociationRegionNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addAssociationAsync(String project, String region, String firewallPolicy, FirewallPolicyAssociation firewallPolicyAssociationResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addAssociationOperationCallable() + *
- addAssociationCallable() + *
+ * + *AddRule + *+ * Inserts a rule into a network firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addRuleAsync(AddRuleRegionNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addRuleAsync(String project, String region, String firewallPolicy, FirewallPolicyRule firewallPolicyRuleResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addRuleOperationCallable() + *
- addRuleCallable() + *
+ * + *CloneRules + *+ * Copies rules to the specified network firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- cloneRulesAsync(CloneRulesRegionNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- cloneRulesAsync(String project, String region, String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- cloneRulesOperationCallable() + *
- cloneRulesCallable() + *
+ * + *Delete + *+ * Deletes the specified network firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified network firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionNetworkFirewallPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetAssociation + *+ * Gets an association with the specified name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getAssociation(GetAssociationRegionNetworkFirewallPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getAssociation(String project, String region, String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getAssociationCallable() + *
+ * + *GetEffectiveFirewalls + *+ * Returns the effective firewalls on a given network.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getEffectiveFirewalls(GetEffectiveFirewallsRegionNetworkFirewallPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getEffectiveFirewalls(String project, String region, String network) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getEffectiveFirewallsCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyRegionNetworkFirewallPolicyRequest 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(String project, String region, 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() + *
+ * + *GetRule + *+ * Gets a rule of the specified priority.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getRule(GetRuleRegionNetworkFirewallPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getRule(String project, String region, String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getRuleCallable() + *
+ * + *Insert + *+ * Creates a new network firewall policy in the specified project and region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, FirewallPolicy firewallPolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Lists all the network firewall policies that have been configured for the specified project in the given region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionNetworkFirewallPoliciesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Patches the specified network firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchRegionNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String firewallPolicy, FirewallPolicy firewallPolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *PatchRule + *+ * Patches a rule of the specified priority.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchRuleAsync(PatchRuleRegionNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchRuleAsync(String project, String region, String firewallPolicy, FirewallPolicyRule firewallPolicyRuleResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchRuleOperationCallable() + *
- patchRuleCallable() + *
+ * + *RemoveAssociation + *+ * Removes an association for the specified network firewall policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeAssociationAsync(RemoveAssociationRegionNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- removeAssociationAsync(String project, String region, String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeAssociationOperationCallable() + *
- removeAssociationCallable() + *
+ * + *RemoveRule + *+ * Deletes a rule of the specified priority.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeRuleAsync(RemoveRuleRegionNetworkFirewallPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- removeRuleAsync(String project, String region, String firewallPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeRuleOperationCallable() + *
- removeRuleCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyRegionNetworkFirewallPolicyRequest 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(String project, String region, String resource, RegionSetPolicyRequest regionSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsRegionNetworkFirewallPolicyRequest 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(String project, String region, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionNotificationEndpointsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionNotificationEndpointsClient.java index 9e5befa7c37e..17dac444ec31 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionNotificationEndpointsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionNotificationEndpointsClient.java @@ -62,19 +62,88 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified NotificationEndpoint in the given region
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionNotificationEndpointRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String notificationEndpoint) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified NotificationEndpoint resource in the given region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionNotificationEndpointRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String notificationEndpoint) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Create a NotificationEndpoint in the specified project in the given region using the parameters that are included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionNotificationEndpointRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, NotificationEndpoint notificationEndpointResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + * + *List + *+ * Lists the NotificationEndpoints for a project in the given region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionNotificationEndpointsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionOperationsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionOperationsClient.java index 2c9de4f37615..2610170aa85b 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionOperationsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionOperationsClient.java @@ -58,19 +58,86 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified region-specific Operations resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- delete(DeleteRegionOperationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- delete(String project, String region, String operation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteCallable() + *
+ * + *Get + *+ * Retrieves the specified region-specific Operations resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionOperationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String operation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *List + *+ * Retrieves a list of Operation resources contained within the specified region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionOperationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + * + *Wait + *+ * Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- wait(WaitRegionOperationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- wait(String project, String region, String operation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- waitCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionSecurityPoliciesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionSecurityPoliciesClient.java index be627e24a040..14d5e0170f70 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionSecurityPoliciesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionSecurityPoliciesClient.java @@ -61,19 +61,182 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AddRule + *+ * Inserts a rule into a security policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addRuleAsync(AddRuleRegionSecurityPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addRuleAsync(String project, String region, String securityPolicy, SecurityPolicyRule securityPolicyRuleResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addRuleOperationCallable() + *
- addRuleCallable() + *
+ * + *Delete + *+ * Deletes the specified policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionSecurityPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String securityPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * List all of the ordered rules present in a single specified policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionSecurityPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String securityPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetRule + *+ * Gets a rule at the specified priority.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getRule(GetRuleRegionSecurityPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getRule(String project, String region, String securityPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getRuleCallable() + *
+ * + *Insert + *+ * Creates a new policy in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionSecurityPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, SecurityPolicy securityPolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * List all the policies that have been configured for the specified project and region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionSecurityPoliciesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Patches the specified policy with the data included in the request. To clear fields in the policy, leave the fields empty and specify them in the updateMask. This cannot be used to be update the rules in the policy. Please use the per rule methods like addRule, patchRule, and removeRule instead.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchRegionSecurityPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String securityPolicy, SecurityPolicy securityPolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *PatchRule + *+ * Patches a rule at the specified priority. To clear fields in the rule, leave the fields empty and specify them in the updateMask.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchRuleAsync(PatchRuleRegionSecurityPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchRuleAsync(String project, String region, String securityPolicy, SecurityPolicyRule securityPolicyRuleResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchRuleOperationCallable() + *
- patchRuleCallable() + *
+ * + * + *RemoveRule + *+ * Deletes a rule at the specified priority.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeRuleAsync(RemoveRuleRegionSecurityPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- removeRuleAsync(String project, String region, String securityPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeRuleOperationCallable() + *
- removeRuleCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionSslCertificatesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionSslCertificatesClient.java index 020cd845a4a1..adea338f97b1 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionSslCertificatesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionSslCertificatesClient.java @@ -61,19 +61,88 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified SslCertificate resource in the region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionSslCertificateRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String sslCertificate) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified SslCertificate resource in the specified region. Get a list of available SSL certificates by making a list() request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionSslCertificateRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String sslCertificate) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a SslCertificate resource in the specified project and region using the data included in the request
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionSslCertificateRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, SslCertificate sslCertificateResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + * + *List + *+ * Retrieves the list of SslCertificate resources available to the specified project in the specified region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionSslCertificatesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionSslPoliciesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionSslPoliciesClient.java index 77fac165eb5a..51d7fcb4553f 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionSslPoliciesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionSslPoliciesClient.java @@ -60,19 +60,125 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified SSL policy. The SSL policy resource can be deleted only if it is not in use by any TargetHttpsProxy or TargetSslProxy resources.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionSslPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String sslPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Lists all of the ordered rules present in a single specified policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionSslPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String sslPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a new policy in the specified project and region using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionSslPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, SslPolicy sslPolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Lists all the SSL policies that have been configured for the specified project and region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionSslPoliciesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *ListAvailableFeatures + *+ * Lists all features that can be specified in the SSL policy when using custom profile.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listAvailableFeatures(ListAvailableFeaturesRegionSslPoliciesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listAvailableFeatures(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listAvailableFeaturesCallable() + *
+ * + * + *Patch + *+ * Patches the specified SSL policy with the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchRegionSslPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String sslPolicy, SslPolicy sslPolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionTargetHttpProxiesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionTargetHttpProxiesClient.java index 50f3f544688e..19c62bcf8c4c 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionTargetHttpProxiesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionTargetHttpProxiesClient.java @@ -62,19 +62,107 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified TargetHttpProxy resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionTargetHttpProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String targetHttpProxy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified TargetHttpProxy resource in the specified region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionTargetHttpProxyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String targetHttpProxy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a TargetHttpProxy resource in the specified project and region using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionTargetHttpProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, TargetHttpProxy targetHttpProxyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of TargetHttpProxy resources available to the specified project in the specified region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionTargetHttpProxiesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + * + *SetUrlMap + *+ * Changes the URL map for TargetHttpProxy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setUrlMapAsync(SetUrlMapRegionTargetHttpProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setUrlMapAsync(String project, String region, String targetHttpProxy, UrlMapReference urlMapReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setUrlMapOperationCallable() + *
- setUrlMapCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionTargetHttpsProxiesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionTargetHttpsProxiesClient.java index d7688f282ae8..feb9448e8a49 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionTargetHttpsProxiesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionTargetHttpsProxiesClient.java @@ -62,19 +62,145 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified TargetHttpsProxy resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionTargetHttpsProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String targetHttpsProxy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified TargetHttpsProxy resource in the specified region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionTargetHttpsProxyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String targetHttpsProxy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a TargetHttpsProxy resource in the specified project and region using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionTargetHttpsProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, TargetHttpsProxy targetHttpsProxyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of TargetHttpsProxy resources available to the specified project in the specified region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionTargetHttpsProxiesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Patches the specified regional TargetHttpsProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchRegionTargetHttpsProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String targetHttpsProxy, TargetHttpsProxy targetHttpsProxyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *SetSslCertificates + *+ * Replaces SslCertificates for TargetHttpsProxy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setSslCertificatesAsync(SetSslCertificatesRegionTargetHttpsProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setSslCertificatesAsync(String project, String region, String targetHttpsProxy, RegionTargetHttpsProxiesSetSslCertificatesRequest regionTargetHttpsProxiesSetSslCertificatesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setSslCertificatesOperationCallable() + *
- setSslCertificatesCallable() + *
+ * + * + *SetUrlMap + *+ * Changes the URL map for TargetHttpsProxy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setUrlMapAsync(SetUrlMapRegionTargetHttpsProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setUrlMapAsync(String project, String region, String targetHttpsProxy, UrlMapReference urlMapReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setUrlMapOperationCallable() + *
- setUrlMapCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionTargetTcpProxiesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionTargetTcpProxiesClient.java index bef975871faa..017b268f7476 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionTargetTcpProxiesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionTargetTcpProxiesClient.java @@ -61,19 +61,88 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified TargetTcpProxy resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionTargetTcpProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String targetTcpProxy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified TargetTcpProxy resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionTargetTcpProxyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String targetTcpProxy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a TargetTcpProxy resource in the specified project and region using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionTargetTcpProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, TargetTcpProxy targetTcpProxyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + * + *List + *+ * Retrieves a list of TargetTcpProxy resources available to the specified project in a given region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionTargetTcpProxiesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionUrlMapsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionUrlMapsClient.java index 41e0875bb06b..01f26e3a610d 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionUrlMapsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionUrlMapsClient.java @@ -59,19 +59,144 @@ *
Note: close() needs to be called on the RegionUrlMapsClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified UrlMap resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRegionUrlMapRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String urlMap) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified UrlMap resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionUrlMapRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String urlMap) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a UrlMap resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRegionUrlMapRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, UrlMap urlMapResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of UrlMap resources available to the specified project in the specified region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionUrlMapsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Patches the specified UrlMap resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchRegionUrlMapRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String urlMap, UrlMap urlMapResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *Update + *+ * Updates the specified UrlMap resource with the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAsync(UpdateRegionUrlMapRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAsync(String project, String region, String urlMap, UrlMap urlMapResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateOperationCallable() + *
- updateCallable() + *
+ * + * + *Validate + *+ * Runs static validation for the UrlMap. In particular, the tests of the provided UrlMap will be run. Calling this method does NOT create the UrlMap.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- validate(ValidateRegionUrlMapRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- validate(String project, String region, String urlMap, RegionUrlMapsValidateRequest regionUrlMapsValidateRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- validateCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionsClient.java index cfdd967f5565..959cd26c167b 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RegionsClient.java @@ -55,19 +55,50 @@ *
Note: close() needs to be called on the RegionsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Get + *+ * Returns the specified Region resource. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRegionRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + * + *List + *+ * Retrieves the list of region resources available to the specified project. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `items.quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRegionsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ReservationsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ReservationsClient.java index d03c819fc238..7341e0014e7a 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ReservationsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ReservationsClient.java @@ -60,19 +60,199 @@ *
Note: close() needs to be called on the ReservationsClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of reservations.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListReservationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified reservation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteReservationRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String zone, String reservation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Retrieves information about the specified reservation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetReservationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String zone, String reservation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyReservationRequest 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(String project, String zone, 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() + *
+ * + *Insert + *+ * Creates a new reservation. For more information, read Reserving zonal resources.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertReservationRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String zone, Reservation reservationResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * A list of all the reservations that have been configured for the specified project in specified zone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListReservationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Resize + *+ * Resizes the reservation (applicable to standalone reservations only). For more information, read Modifying reservations.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- resizeAsync(ResizeReservationRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- resizeAsync(String project, String zone, String reservation, ReservationsResizeRequest reservationsResizeRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- resizeOperationCallable() + *
- resizeCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyReservationRequest 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(String project, String zone, String resource, ZoneSetPolicyRequest zoneSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsReservationRequest 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(String project, String zone, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
+ * + * + *Update + *+ * Update share settings of the reservation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAsync(UpdateReservationRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAsync(String project, String zone, String reservation, Reservation reservationResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateOperationCallable() + *
- updateCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ResourcePoliciesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ResourcePoliciesClient.java index c3cb7e8afca4..73963d3f8da0 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ResourcePoliciesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ResourcePoliciesClient.java @@ -61,19 +61,180 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of resource policies.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListResourcePoliciesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified resource policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteResourcePolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String resourcePolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Retrieves all information of the specified resource policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetResourcePolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String resourcePolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyResourcePolicyRequest 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(String project, String region, 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() + *
+ * + *Insert + *+ * Creates a new resource policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertResourcePolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, ResourcePolicy resourcePolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * A list all the resource policies that have been configured for the specified project in specified region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListResourcePoliciesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Modify the specified resource policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchResourcePolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String resourcePolicy, ResourcePolicy resourcePolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyResourcePolicyRequest 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(String project, String region, String resource, RegionSetPolicyRequest regionSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsResourcePolicyRequest 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(String project, String region, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RoutersClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RoutersClient.java index e22b3a09fb92..9afd1ce11b5c 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RoutersClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RoutersClient.java @@ -60,19 +60,218 @@ *
Note: close() needs to be called on the RoutersClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of routers.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListRoutersRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified Router resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRouterRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String router) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified Router resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRouterRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String router) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetNatIpInfo + *+ * Retrieves runtime NAT IP information.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getNatIpInfo(GetNatIpInfoRouterRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getNatIpInfo(String project, String region, String router) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getNatIpInfoCallable() + *
+ * + *GetNatMappingInfo + *+ * Retrieves runtime Nat mapping information of VM endpoints.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getNatMappingInfo(GetNatMappingInfoRoutersRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getNatMappingInfo(String project, String region, String router) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getNatMappingInfoPagedCallable() + *
- getNatMappingInfoCallable() + *
+ * + *GetRouterStatus + *+ * Retrieves runtime information of the specified router.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getRouterStatus(GetRouterStatusRouterRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getRouterStatus(String project, String region, String router) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getRouterStatusCallable() + *
+ * + *Insert + *+ * Creates a Router resource in the specified project and region using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRouterRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, Router routerResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of Router resources available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRoutersRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Patches the specified Router resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchRouterRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String router, Router routerResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *Preview + *+ * Preview fields auto-generated during router create and update operations. Calling this method does NOT create or update the router.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- preview(PreviewRouterRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- preview(String project, String region, String router, Router routerResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- previewCallable() + *
+ * + * + *Update + *+ * Updates the specified Router resource with the data included in the request. This method conforms to PUT semantics, which requests that the state of the target resource be created or replaced with the state defined by the representation enclosed in the request message payload.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAsync(UpdateRouterRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAsync(String project, String region, String router, Router routerResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateOperationCallable() + *
- updateCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RoutesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RoutesClient.java index 2c5246bd4783..3d89b164a7ce 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RoutesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/RoutesClient.java @@ -58,19 +58,88 @@ *
Note: close() needs to be called on the RoutesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified Route resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteRouteRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String route) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified Route resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetRouteRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String route) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a Route resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertRouteRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, Route routeResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + * + *List + *+ * Retrieves the list of Route resources available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListRoutesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SecurityPoliciesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SecurityPoliciesClient.java index d64a7dcc543d..43823e59d7df 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SecurityPoliciesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SecurityPoliciesClient.java @@ -60,19 +60,238 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AddRule + *+ * Inserts a rule into a security policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addRuleAsync(AddRuleSecurityPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addRuleAsync(String project, String securityPolicy, SecurityPolicyRule securityPolicyRuleResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addRuleOperationCallable() + *
- addRuleCallable() + *
+ * + *AggregatedList + *+ * Retrieves the list of all SecurityPolicy resources, regional and global, available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListSecurityPoliciesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteSecurityPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String securityPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * List all of the ordered rules present in a single specified policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetSecurityPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String securityPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetRule + *+ * Gets a rule at the specified priority.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getRule(GetRuleSecurityPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getRule(String project, String securityPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getRuleCallable() + *
+ * + *Insert + *+ * Creates a new policy in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertSecurityPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, SecurityPolicy securityPolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * List all the policies that have been configured for the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListSecurityPoliciesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *ListPreconfiguredExpressionSets + *+ * Gets the current list of preconfigured Web Application Firewall (WAF) expressions.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listPreconfiguredExpressionSets(ListPreconfiguredExpressionSetsSecurityPoliciesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listPreconfiguredExpressionSets(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPreconfiguredExpressionSetsCallable() + *
+ * + *Patch + *+ * Patches the specified policy with the data included in the request. To clear fields in the policy, leave the fields empty and specify them in the updateMask. This cannot be used to be update the rules in the policy. Please use the per rule methods like addRule, patchRule, and removeRule instead.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchSecurityPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String securityPolicy, SecurityPolicy securityPolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *PatchRule + *+ * Patches a rule at the specified priority. To clear fields in the rule, leave the fields empty and specify them in the updateMask.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchRuleAsync(PatchRuleSecurityPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchRuleAsync(String project, String securityPolicy, SecurityPolicyRule securityPolicyRuleResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchRuleOperationCallable() + *
- patchRuleCallable() + *
+ * + *RemoveRule + *+ * Deletes a rule at the specified priority.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeRuleAsync(RemoveRuleSecurityPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- removeRuleAsync(String project, String securityPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeRuleOperationCallable() + *
- removeRuleCallable() + *
+ * + * + *SetLabels + *+ * Sets the labels on a security policy. To learn more about labels, read the Labeling Resources documentation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabelsAsync(SetLabelsSecurityPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setLabelsAsync(String project, String resource, GlobalSetLabelsRequest globalSetLabelsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsOperationCallable() + *
- setLabelsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ServiceAttachmentsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ServiceAttachmentsClient.java index ba845465d2cc..f10107fd84a5 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ServiceAttachmentsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ServiceAttachmentsClient.java @@ -61,19 +61,180 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves the list of all ServiceAttachment resources, regional and global, available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListServiceAttachmentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified ServiceAttachment in the given scope
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteServiceAttachmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String serviceAttachment) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified ServiceAttachment resource in the given scope.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetServiceAttachmentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String serviceAttachment) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicyServiceAttachmentRequest 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(String project, String region, 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() + *
+ * + *Insert + *+ * Creates a ServiceAttachment in the specified project in the given scope using the parameters that are included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertServiceAttachmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, ServiceAttachment serviceAttachmentResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Lists the ServiceAttachments for a project in the given scope.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListServiceAttachmentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Patches the specified ServiceAttachment resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchServiceAttachmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String serviceAttachment, ServiceAttachment serviceAttachmentResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicyServiceAttachmentRequest 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(String project, String region, String resource, RegionSetPolicyRequest regionSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsServiceAttachmentRequest 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(String project, String region, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SnapshotSettingsServiceClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SnapshotSettingsServiceClient.java index b0b25dae7545..fbc27cfb7738 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SnapshotSettingsServiceClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SnapshotSettingsServiceClient.java @@ -51,19 +51,50 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Get + *+ * Get snapshot settings.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetSnapshotSettingRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + * + *Patch + *+ * Patch snapshot settings.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchSnapshotSettingRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, SnapshotSettings snapshotSettingsResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SnapshotsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SnapshotsClient.java index 3a2b0aa964f9..1295632de5ac 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SnapshotsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SnapshotsClient.java @@ -58,19 +58,161 @@ *
Note: close() needs to be called on the SnapshotsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified Snapshot resource. Keep in mind that deleting a single snapshot might not necessarily delete all the data on that snapshot. If any data on the snapshot that is marked for deletion is needed for subsequent snapshots, the data will be moved to the next corresponding snapshot. For more information, see Deleting snapshots.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteSnapshotRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String snapshot) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified Snapshot resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetSnapshotRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String snapshot) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicySnapshotRequest 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(String project, 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() + *
+ * + *Insert + *+ * Creates a snapshot in the specified project using the data included in the request. For regular snapshot creation, consider using this method instead of disks.createSnapshot, as this method supports more features, such as creating snapshots in a project different from the source disk project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertSnapshotRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, Snapshot snapshotResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of Snapshot resources contained within the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListSnapshotsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicySnapshotRequest 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(String project, String resource, GlobalSetPolicyRequest globalSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *SetLabels + *+ * Sets the labels on a snapshot. To learn more about labels, read the Labeling Resources documentation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabelsAsync(SetLabelsSnapshotRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setLabelsAsync(String project, String resource, GlobalSetLabelsRequest globalSetLabelsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsOperationCallable() + *
- setLabelsCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsSnapshotRequest 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(String project, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SslCertificatesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SslCertificatesClient.java index ea506d8cdda1..9bb2eedf91e3 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SslCertificatesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SslCertificatesClient.java @@ -60,19 +60,107 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves the list of all SslCertificate resources, regional and global, available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListSslCertificatesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified SslCertificate resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteSslCertificateRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String sslCertificate) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified SslCertificate resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetSslCertificateRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String sslCertificate) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a SslCertificate resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertSslCertificateRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, SslCertificate sslCertificateResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + * + *List + *+ * Retrieves the list of SslCertificate resources available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListSslCertificatesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SslPoliciesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SslPoliciesClient.java index db6e3df93d6b..ca0906311149 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SslPoliciesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SslPoliciesClient.java @@ -59,19 +59,144 @@ *
Note: close() needs to be called on the SslPoliciesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves the list of all SslPolicy resources, regional and global, available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListSslPoliciesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified SSL policy. The SSL policy resource can be deleted only if it is not in use by any TargetHttpsProxy or TargetSslProxy resources.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteSslPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String sslPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Lists all of the ordered rules present in a single specified policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetSslPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String sslPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Returns the specified SSL policy resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertSslPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, SslPolicy sslPolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Lists all the SSL policies that have been configured for the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListSslPoliciesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *ListAvailableFeatures + *+ * Lists all features that can be specified in the SSL policy when using custom profile.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listAvailableFeatures(ListAvailableFeaturesSslPoliciesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listAvailableFeatures(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listAvailableFeaturesCallable() + *
+ * + * + *Patch + *+ * Patches the specified SSL policy with the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchSslPolicyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String sslPolicy, SslPolicy sslPolicyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SubnetworksClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SubnetworksClient.java index 7e1786f7dbca..afeae8a0d62e 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SubnetworksClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/SubnetworksClient.java @@ -60,19 +60,237 @@ *
Note: close() needs to be called on the SubnetworksClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of subnetworks.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListSubnetworksRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified subnetwork.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteSubnetworkRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String subnetwork) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *ExpandIpCidrRange + *+ * Expands the IP CIDR range of the subnetwork to a specified value.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- expandIpCidrRangeAsync(ExpandIpCidrRangeSubnetworkRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- expandIpCidrRangeAsync(String project, String region, String subnetwork, SubnetworksExpandIpCidrRangeRequest subnetworksExpandIpCidrRangeRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- expandIpCidrRangeOperationCallable() + *
- expandIpCidrRangeCallable() + *
+ * + *Get + *+ * Returns the specified subnetwork.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetSubnetworkRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String subnetwork) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIamPolicy(GetIamPolicySubnetworkRequest 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(String project, String region, 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() + *
+ * + *Insert + *+ * Creates a subnetwork in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertSubnetworkRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, Subnetwork subnetworkResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of subnetworks available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListSubnetworksRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *ListUsable + *+ * Retrieves an aggregated list of all usable subnetworks in the project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listUsable(ListUsableSubnetworksRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listUsable(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listUsablePagedCallable() + *
- listUsableCallable() + *
+ * + *Patch + *+ * Patches the specified subnetwork with the data included in the request. Only certain fields can be updated with a patch request as indicated in the field descriptions. You must specify the current fingerprint of the subnetwork resource being patched.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchSubnetworkRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String region, String subnetwork, Subnetwork subnetworkResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setIamPolicy(SetIamPolicySubnetworkRequest 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(String project, String region, String resource, RegionSetPolicyRequest regionSetPolicyRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *SetPrivateIpGoogleAccess + *+ * Set whether VMs in this subnet can access Google services without assigning external IP addresses through Private Google Access.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setPrivateIpGoogleAccessAsync(SetPrivateIpGoogleAccessSubnetworkRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setPrivateIpGoogleAccessAsync(String project, String region, String subnetwork, SubnetworksSetPrivateIpGoogleAccessRequest subnetworksSetPrivateIpGoogleAccessRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setPrivateIpGoogleAccessOperationCallable() + *
- setPrivateIpGoogleAccessCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsSubnetworkRequest 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(String project, String region, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetGrpcProxiesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetGrpcProxiesClient.java index 6ffebb25bc18..ad36f7dad4a3 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetGrpcProxiesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetGrpcProxiesClient.java @@ -59,19 +59,107 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified TargetGrpcProxy in the given scope
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteTargetGrpcProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String targetGrpcProxy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified TargetGrpcProxy resource in the given scope.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetTargetGrpcProxyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String targetGrpcProxy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a TargetGrpcProxy in the specified project in the given scope using the parameters that are included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertTargetGrpcProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, TargetGrpcProxy targetGrpcProxyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Lists the TargetGrpcProxies for a project in the given scope.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListTargetGrpcProxiesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + * + *Patch + *+ * Patches the specified TargetGrpcProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchTargetGrpcProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String targetGrpcProxy, TargetGrpcProxy targetGrpcProxyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetHttpProxiesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetHttpProxiesClient.java index f9c3842e937e..ad1ca1566788 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetHttpProxiesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetHttpProxiesClient.java @@ -60,19 +60,145 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves the list of all TargetHttpProxy resources, regional and global, available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListTargetHttpProxiesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified TargetHttpProxy resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteTargetHttpProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String targetHttpProxy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified TargetHttpProxy resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetTargetHttpProxyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String targetHttpProxy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a TargetHttpProxy resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertTargetHttpProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, TargetHttpProxy targetHttpProxyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of TargetHttpProxy resources available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListTargetHttpProxiesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Patches the specified TargetHttpProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchTargetHttpProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String targetHttpProxy, TargetHttpProxy targetHttpProxyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + * + *SetUrlMap + *+ * Changes the URL map for TargetHttpProxy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setUrlMapAsync(SetUrlMapTargetHttpProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setUrlMapAsync(String project, String targetHttpProxy, UrlMapReference urlMapReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setUrlMapOperationCallable() + *
- setUrlMapCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetHttpsProxiesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetHttpsProxiesClient.java index a9052669aaaf..95d3f3795040 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetHttpsProxiesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetHttpsProxiesClient.java @@ -60,19 +60,221 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves the list of all TargetHttpsProxy resources, regional and global, available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListTargetHttpsProxiesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified TargetHttpsProxy resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteTargetHttpsProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String targetHttpsProxy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified TargetHttpsProxy resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetTargetHttpsProxyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String targetHttpsProxy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a TargetHttpsProxy resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertTargetHttpsProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, TargetHttpsProxy targetHttpsProxyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of TargetHttpsProxy resources available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListTargetHttpsProxiesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Patches the specified TargetHttpsProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchTargetHttpsProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String targetHttpsProxy, TargetHttpsProxy targetHttpsProxyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *SetCertificateMap + *+ * Changes the Certificate Map for TargetHttpsProxy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setCertificateMapAsync(SetCertificateMapTargetHttpsProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setCertificateMapAsync(String project, String targetHttpsProxy, TargetHttpsProxiesSetCertificateMapRequest targetHttpsProxiesSetCertificateMapRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setCertificateMapOperationCallable() + *
- setCertificateMapCallable() + *
+ * + *SetQuicOverride + *+ * Sets the QUIC override policy for TargetHttpsProxy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setQuicOverrideAsync(SetQuicOverrideTargetHttpsProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setQuicOverrideAsync(String project, String targetHttpsProxy, TargetHttpsProxiesSetQuicOverrideRequest targetHttpsProxiesSetQuicOverrideRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setQuicOverrideOperationCallable() + *
- setQuicOverrideCallable() + *
+ * + *SetSslCertificates + *+ * Replaces SslCertificates for TargetHttpsProxy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setSslCertificatesAsync(SetSslCertificatesTargetHttpsProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setSslCertificatesAsync(String project, String targetHttpsProxy, TargetHttpsProxiesSetSslCertificatesRequest targetHttpsProxiesSetSslCertificatesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setSslCertificatesOperationCallable() + *
- setSslCertificatesCallable() + *
+ * + *SetSslPolicy + *+ * Sets the SSL policy for TargetHttpsProxy. The SSL policy specifies the server-side support for SSL features. This affects connections between clients and the HTTPS proxy load balancer. They do not affect the connection between the load balancer and the backends.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setSslPolicyAsync(SetSslPolicyTargetHttpsProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setSslPolicyAsync(String project, String targetHttpsProxy, SslPolicyReference sslPolicyReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setSslPolicyOperationCallable() + *
- setSslPolicyCallable() + *
+ * + * + *SetUrlMap + *+ * Changes the URL map for TargetHttpsProxy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setUrlMapAsync(SetUrlMapTargetHttpsProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setUrlMapAsync(String project, String targetHttpsProxy, UrlMapReference urlMapReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setUrlMapOperationCallable() + *
- setUrlMapCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetInstancesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetInstancesClient.java index 2d51f609c06f..e5432df348ad 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetInstancesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetInstancesClient.java @@ -61,19 +61,126 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of target instances.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListTargetInstancesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified TargetInstance resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteTargetInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String zone, String targetInstance) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified TargetInstance resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetTargetInstanceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String zone, String targetInstance) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a TargetInstance resource in the specified project and zone using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertTargetInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String zone, TargetInstance targetInstanceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of TargetInstance resources available to the specified project and zone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListTargetInstancesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + * + *SetSecurityPolicy + *+ * Sets the Google Cloud Armor security policy for the specified target instance. For more information, see Google Cloud Armor Overview
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setSecurityPolicyAsync(SetSecurityPolicyTargetInstanceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setSecurityPolicyAsync(String project, String zone, String targetInstance, SecurityPolicyReference securityPolicyReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setSecurityPolicyOperationCallable() + *
- setSecurityPolicyCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetPoolsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetPoolsClient.java index 373b5b562f5d..0bee2763346c 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetPoolsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetPoolsClient.java @@ -60,19 +60,239 @@ *
Note: close() needs to be called on the TargetPoolsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AddHealthCheck + *+ * Adds health check URLs to a target pool.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addHealthCheckAsync(AddHealthCheckTargetPoolRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addHealthCheckAsync(String project, String region, String targetPool, TargetPoolsAddHealthCheckRequest targetPoolsAddHealthCheckRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addHealthCheckOperationCallable() + *
- addHealthCheckCallable() + *
+ * + *AddInstance + *+ * Adds an instance to a target pool.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addInstanceAsync(AddInstanceTargetPoolRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- addInstanceAsync(String project, String region, String targetPool, TargetPoolsAddInstanceRequest targetPoolsAddInstanceRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- addInstanceOperationCallable() + *
- addInstanceCallable() + *
+ * + *AggregatedList + *+ * Retrieves an aggregated list of target pools.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListTargetPoolsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified target pool.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteTargetPoolRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String targetPool) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified target pool.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetTargetPoolRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String targetPool) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetHealth + *+ * Gets the most recent health check results for each IP for the instance that is referenced by the given target pool.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getHealth(GetHealthTargetPoolRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getHealth(String project, String region, String targetPool, InstanceReference instanceReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getHealthCallable() + *
+ * + *Insert + *+ * Creates a target pool in the specified project and region using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertTargetPoolRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, TargetPool targetPoolResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of target pools available to the specified project and region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListTargetPoolsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *RemoveHealthCheck + *+ * Removes health check URL from a target pool.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeHealthCheckAsync(RemoveHealthCheckTargetPoolRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- removeHealthCheckAsync(String project, String region, String targetPool, TargetPoolsRemoveHealthCheckRequest targetPoolsRemoveHealthCheckRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeHealthCheckOperationCallable() + *
- removeHealthCheckCallable() + *
+ * + *RemoveInstance + *+ * Removes instance URL from a target pool.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeInstanceAsync(RemoveInstanceTargetPoolRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- removeInstanceAsync(String project, String region, String targetPool, TargetPoolsRemoveInstanceRequest targetPoolsRemoveInstanceRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeInstanceOperationCallable() + *
- removeInstanceCallable() + *
+ * + *SetBackup + *+ * Changes a backup target pool's configurations.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setBackupAsync(SetBackupTargetPoolRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setBackupAsync(String project, String region, String targetPool, TargetReference targetReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setBackupOperationCallable() + *
- setBackupCallable() + *
+ * + * + *SetSecurityPolicy + *+ * Sets the Google Cloud Armor security policy for the specified target pool. For more information, see Google Cloud Armor Overview
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setSecurityPolicyAsync(SetSecurityPolicyTargetPoolRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setSecurityPolicyAsync(String project, String region, String targetPool, SecurityPolicyReference securityPolicyReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setSecurityPolicyOperationCallable() + *
- setSecurityPolicyCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetSslProxiesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetSslProxiesClient.java index 116054fb368a..75f9f8680a5d 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetSslProxiesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetSslProxiesClient.java @@ -59,19 +59,183 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified TargetSslProxy resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteTargetSslProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String targetSslProxy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified TargetSslProxy resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetTargetSslProxyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String targetSslProxy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a TargetSslProxy resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertTargetSslProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, TargetSslProxy targetSslProxyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of TargetSslProxy resources available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListTargetSslProxiesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *SetBackendService + *+ * Changes the BackendService for TargetSslProxy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setBackendServiceAsync(SetBackendServiceTargetSslProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setBackendServiceAsync(String project, String targetSslProxy, TargetSslProxiesSetBackendServiceRequest targetSslProxiesSetBackendServiceRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setBackendServiceOperationCallable() + *
- setBackendServiceCallable() + *
+ * + *SetCertificateMap + *+ * Changes the Certificate Map for TargetSslProxy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setCertificateMapAsync(SetCertificateMapTargetSslProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setCertificateMapAsync(String project, String targetSslProxy, TargetSslProxiesSetCertificateMapRequest targetSslProxiesSetCertificateMapRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setCertificateMapOperationCallable() + *
- setCertificateMapCallable() + *
+ * + *SetProxyHeader + *+ * Changes the ProxyHeaderType for TargetSslProxy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setProxyHeaderAsync(SetProxyHeaderTargetSslProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setProxyHeaderAsync(String project, String targetSslProxy, TargetSslProxiesSetProxyHeaderRequest targetSslProxiesSetProxyHeaderRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setProxyHeaderOperationCallable() + *
- setProxyHeaderCallable() + *
+ * + *SetSslCertificates + *+ * Changes SslCertificates for TargetSslProxy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setSslCertificatesAsync(SetSslCertificatesTargetSslProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setSslCertificatesAsync(String project, String targetSslProxy, TargetSslProxiesSetSslCertificatesRequest targetSslProxiesSetSslCertificatesRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setSslCertificatesOperationCallable() + *
- setSslCertificatesCallable() + *
+ * + * + *SetSslPolicy + *+ * Sets the SSL policy for TargetSslProxy. The SSL policy specifies the server-side support for SSL features. This affects connections between clients and the SSL proxy load balancer. They do not affect the connection between the load balancer and the backends.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setSslPolicyAsync(SetSslPolicyTargetSslProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setSslPolicyAsync(String project, String targetSslProxy, SslPolicyReference sslPolicyReferenceResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setSslPolicyOperationCallable() + *
- setSslPolicyCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetTcpProxiesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetTcpProxiesClient.java index 0e2b41d02477..0f0c8eb8b4d1 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetTcpProxiesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetTcpProxiesClient.java @@ -60,19 +60,145 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves the list of all TargetTcpProxy resources, regional and global, available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListTargetTcpProxiesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified TargetTcpProxy resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteTargetTcpProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String targetTcpProxy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified TargetTcpProxy resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetTargetTcpProxyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String targetTcpProxy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a TargetTcpProxy resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertTargetTcpProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, TargetTcpProxy targetTcpProxyResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves the list of TargetTcpProxy resources available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListTargetTcpProxiesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *SetBackendService + *+ * Changes the BackendService for TargetTcpProxy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setBackendServiceAsync(SetBackendServiceTargetTcpProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setBackendServiceAsync(String project, String targetTcpProxy, TargetTcpProxiesSetBackendServiceRequest targetTcpProxiesSetBackendServiceRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setBackendServiceOperationCallable() + *
- setBackendServiceCallable() + *
+ * + * + *SetProxyHeader + *+ * Changes the ProxyHeaderType for TargetTcpProxy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setProxyHeaderAsync(SetProxyHeaderTargetTcpProxyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setProxyHeaderAsync(String project, String targetTcpProxy, TargetTcpProxiesSetProxyHeaderRequest targetTcpProxiesSetProxyHeaderRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setProxyHeaderOperationCallable() + *
- setProxyHeaderCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetVpnGatewaysClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetVpnGatewaysClient.java index 3641777ff5b6..35f78cc42f18 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetVpnGatewaysClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/TargetVpnGatewaysClient.java @@ -61,19 +61,126 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of target VPN gateways.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListTargetVpnGatewaysRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified target VPN gateway.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteTargetVpnGatewayRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String targetVpnGateway) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified target VPN gateway.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetTargetVpnGatewayRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String targetVpnGateway) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a target VPN gateway in the specified project and region using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertTargetVpnGatewayRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, TargetVpnGateway targetVpnGatewayResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of target VPN gateways available to the specified project and region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListTargetVpnGatewaysRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + * + *SetLabels + *+ * Sets the labels on a TargetVpnGateway. To learn more about labels, read the Labeling Resources documentation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabelsAsync(SetLabelsTargetVpnGatewayRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setLabelsAsync(String project, String region, String resource, RegionSetLabelsRequest regionSetLabelsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsOperationCallable() + *
- setLabelsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/UrlMapsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/UrlMapsClient.java index 0f16e261ed9b..17431c0f8c19 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/UrlMapsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/UrlMapsClient.java @@ -59,19 +59,182 @@ *
Note: close() needs to be called on the UrlMapsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves the list of all UrlMap resources, regional and global, available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListUrlMapsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified UrlMap resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteUrlMapRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String urlMap) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified UrlMap resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetUrlMapRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String urlMap) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a UrlMap resource in the specified project using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertUrlMapRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, UrlMap urlMapResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *InvalidateCache + *+ * Initiates a cache invalidation operation, invalidating the specified path, scoped to the specified UrlMap. For more information, see [Invalidating cached content](/cdn/docs/invalidating-cached-content).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- invalidateCacheAsync(InvalidateCacheUrlMapRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- invalidateCacheAsync(String project, String urlMap, CacheInvalidationRule cacheInvalidationRuleResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- invalidateCacheOperationCallable() + *
- invalidateCacheCallable() + *
+ * + *List + *+ * Retrieves the list of UrlMap resources available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListUrlMapsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *Patch + *+ * Patches the specified UrlMap resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- patchAsync(PatchUrlMapRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- patchAsync(String project, String urlMap, UrlMap urlMapResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- patchOperationCallable() + *
- patchCallable() + *
+ * + *Update + *+ * Updates the specified UrlMap resource with the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAsync(UpdateUrlMapRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAsync(String project, String urlMap, UrlMap urlMapResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateOperationCallable() + *
- updateCallable() + *
+ * + * + *Validate + *+ * Runs static validation for the UrlMap. In particular, the tests of the provided UrlMap will be run. Calling this method does NOT create the UrlMap.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- validate(ValidateUrlMapRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- validate(String project, String urlMap, UrlMapsValidateRequest urlMapsValidateRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- validateCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/VpnGatewaysClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/VpnGatewaysClient.java index 6e29388a31fc..1703c93ad3ec 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/VpnGatewaysClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/VpnGatewaysClient.java @@ -60,19 +60,162 @@ *
Note: close() needs to be called on the VpnGatewaysClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of VPN gateways.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListVpnGatewaysRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified VPN gateway.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteVpnGatewayRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String vpnGateway) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified VPN gateway.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetVpnGatewayRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String vpnGateway) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *GetStatus + *+ * Returns the status for the specified VPN gateway.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getStatus(GetStatusVpnGatewayRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getStatus(String project, String region, String vpnGateway) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getStatusCallable() + *
+ * + *Insert + *+ * Creates a VPN gateway in the specified project and region using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertVpnGatewayRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, VpnGateway vpnGatewayResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of VPN gateways available to the specified project and region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListVpnGatewaysRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + *SetLabels + *+ * Sets the labels on a VpnGateway. To learn more about labels, read the Labeling Resources documentation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabelsAsync(SetLabelsVpnGatewayRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setLabelsAsync(String project, String region, String resource, RegionSetLabelsRequest regionSetLabelsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsOperationCallable() + *
- setLabelsCallable() + *
+ * + * + *TestIamPermissions + *+ * Returns permissions that a caller has on the specified resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- testIamPermissions(TestIamPermissionsVpnGatewayRequest 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(String project, String region, String resource, TestPermissionsRequest testPermissionsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/VpnTunnelsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/VpnTunnelsClient.java index 5ce6bfcd24dc..7ba5e87e604a 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/VpnTunnelsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/VpnTunnelsClient.java @@ -60,19 +60,126 @@ *
Note: close() needs to be called on the VpnTunnelsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *AggregatedList + *+ * Retrieves an aggregated list of VPN tunnels.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedList(AggregatedListVpnTunnelsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- aggregatedList(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListPagedCallable() + *
- aggregatedListCallable() + *
+ * + *Delete + *+ * Deletes the specified VpnTunnel resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAsync(DeleteVpnTunnelRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAsync(String project, String region, String vpnTunnel) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteOperationCallable() + *
- deleteCallable() + *
+ * + *Get + *+ * Returns the specified VpnTunnel resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetVpnTunnelRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String region, String vpnTunnel) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *Insert + *+ * Creates a VpnTunnel resource in the specified project and region using the data included in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- insertAsync(InsertVpnTunnelRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- insertAsync(String project, String region, VpnTunnel vpnTunnelResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- insertOperationCallable() + *
- insertCallable() + *
+ * + *List + *+ * Retrieves a list of VpnTunnel resources contained in the specified project and region.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListVpnTunnelsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String region) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + * + *SetLabels + *+ * Sets the labels on a VpnTunnel. To learn more about labels, read the Labeling Resources documentation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabelsAsync(SetLabelsVpnTunnelRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- setLabelsAsync(String project, String region, String resource, RegionSetLabelsRequest regionSetLabelsRequestResource) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsOperationCallable() + *
- setLabelsCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ZoneOperationsClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ZoneOperationsClient.java index 43ae9ab99528..7c228b586d43 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ZoneOperationsClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ZoneOperationsClient.java @@ -56,19 +56,86 @@ *
Note: close() needs to be called on the ZoneOperationsClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Delete + *+ * Deletes the specified zone-specific Operations resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- delete(DeleteZoneOperationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- delete(String project, String zone, String operation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteCallable() + *
+ * + *Get + *+ * Retrieves the specified zone-specific Operations resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetZoneOperationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String zone, String operation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + *List + *+ * Retrieves a list of Operation resources contained within the specified zone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListZoneOperationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
+ * + * + *Wait + *+ * Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method waits for no more than the 2 minutes and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- wait(WaitZoneOperationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- wait(String project, String zone, String operation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- waitCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ZonesClient.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ZonesClient.java index 4af58c57e31e..02e8effb69a2 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ZonesClient.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/ZonesClient.java @@ -55,19 +55,50 @@ *
Note: close() needs to be called on the ZonesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *Get + *+ * Returns the specified Zone resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- get(GetZoneRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- get(String project, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getCallable() + *
+ * + * + *List + *+ * Retrieves the list of Zone resources available to the specified project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- list(ListZonesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- list(String project) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listPagedCallable() + *
- listCallable() + *
See the individual methods for example code. * diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/AcceleratorTypesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/AcceleratorTypesStubSettings.java index f594a4c0b787..c21e12968cf5 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/AcceleratorTypesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/AcceleratorTypesStubSettings.java @@ -281,6 +281,12 @@ public AcceleratorTypesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/AddressesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/AddressesStubSettings.java index 36e387ee8d19..1d5368c00aba 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/AddressesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/AddressesStubSettings.java @@ -325,6 +325,12 @@ public AddressesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/AutoscalersStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/AutoscalersStubSettings.java index a0891cd712c9..037178e91b54 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/AutoscalersStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/AutoscalersStubSettings.java @@ -333,6 +333,12 @@ public AutoscalersStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/BackendBucketsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/BackendBucketsStubSettings.java index d100debe6d3f..d400314068da 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/BackendBucketsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/BackendBucketsStubSettings.java @@ -323,6 +323,12 @@ public BackendBucketsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/BackendServicesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/BackendServicesStubSettings.java index 8fb685586021..86dee6d5174f 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/BackendServicesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/BackendServicesStubSettings.java @@ -524,6 +524,12 @@ public BackendServicesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/DiskTypesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/DiskTypesStubSettings.java index a089724c0750..394c6232cccd 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/DiskTypesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/DiskTypesStubSettings.java @@ -262,6 +262,12 @@ public DiskTypesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/DisksStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/DisksStubSettings.java index f9f7bdd6ae40..f541d9051d19 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/DisksStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/DisksStubSettings.java @@ -466,6 +466,12 @@ public DisksStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ExternalVpnGatewaysStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ExternalVpnGatewaysStubSettings.java index b7098f08f66d..2ecd19597a52 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ExternalVpnGatewaysStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ExternalVpnGatewaysStubSettings.java @@ -249,6 +249,12 @@ public ExternalVpnGatewaysStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/FirewallPoliciesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/FirewallPoliciesStubSettings.java index dff2bfbec343..dff6feb483a7 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/FirewallPoliciesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/FirewallPoliciesStubSettings.java @@ -399,6 +399,12 @@ public FirewallPoliciesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/FirewallsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/FirewallsStubSettings.java index cab2b4e015e8..7f999bae4441 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/FirewallsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/FirewallsStubSettings.java @@ -240,6 +240,12 @@ public FirewallsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ForwardingRulesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ForwardingRulesStubSettings.java index be62e9bd9cb5..0a0292f3291a 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ForwardingRulesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ForwardingRulesStubSettings.java @@ -357,6 +357,12 @@ public ForwardingRulesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalAddressesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalAddressesStubSettings.java index 2bdb257cd956..7fd98becd097 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalAddressesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalAddressesStubSettings.java @@ -245,6 +245,12 @@ public GlobalAddressesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalForwardingRulesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalForwardingRulesStubSettings.java index b5b8087dbdf5..4d78feb64aa0 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalForwardingRulesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalForwardingRulesStubSettings.java @@ -271,6 +271,12 @@ public GlobalForwardingRulesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalNetworkEndpointGroupsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalNetworkEndpointGroupsStubSettings.java index 375c41885be8..3ec4dac8d853 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalNetworkEndpointGroupsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalNetworkEndpointGroupsStubSettings.java @@ -375,6 +375,12 @@ public GlobalNetworkEndpointGroupsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalOperationsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalOperationsStubSettings.java index df6977ff4b3d..cda8e1d94478 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalOperationsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalOperationsStubSettings.java @@ -294,6 +294,12 @@ public GlobalOperationsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalOrganizationOperationsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalOrganizationOperationsStubSettings.java index 74f8e085bfe0..97f95c1a8c07 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalOrganizationOperationsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalOrganizationOperationsStubSettings.java @@ -202,6 +202,12 @@ public GlobalOrganizationOperationsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalPublicDelegatedPrefixesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalPublicDelegatedPrefixesStubSettings.java index e2f5f108b1ac..a9ecb24121f9 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalPublicDelegatedPrefixesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/GlobalPublicDelegatedPrefixesStubSettings.java @@ -259,6 +259,12 @@ public GlobalPublicDelegatedPrefixesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/HealthChecksStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/HealthChecksStubSettings.java index 5e29755cbebe..f118b94d8201 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/HealthChecksStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/HealthChecksStubSettings.java @@ -340,6 +340,12 @@ public HealthChecksStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ImageFamilyViewsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ImageFamilyViewsStubSettings.java index a07304cae95f..7ec60fae3634 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ImageFamilyViewsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ImageFamilyViewsStubSettings.java @@ -107,6 +107,12 @@ public ImageFamilyViewsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ImagesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ImagesStubSettings.java index 520ecf434542..20c06c782061 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ImagesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ImagesStubSettings.java @@ -281,6 +281,12 @@ public ImagesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InstanceGroupManagersStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InstanceGroupManagersStubSettings.java index c06e5c519e3e..9978417bc2ca 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InstanceGroupManagersStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InstanceGroupManagersStubSettings.java @@ -831,6 +831,12 @@ public InstanceGroupManagersStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InstanceGroupsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InstanceGroupsStubSettings.java index 67c00b39cbc5..c6cdd7ab15b6 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InstanceGroupsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InstanceGroupsStubSettings.java @@ -450,6 +450,12 @@ public InstanceGroupsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InstanceTemplatesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InstanceTemplatesStubSettings.java index 9378ae42fb14..3a98560916e6 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InstanceTemplatesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InstanceTemplatesStubSettings.java @@ -343,6 +343,12 @@ public InstanceTemplatesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InstancesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InstancesStubSettings.java index c96026dc0a8f..21d021f2b1b8 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InstancesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InstancesStubSettings.java @@ -973,6 +973,12 @@ public InstancesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InterconnectAttachmentsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InterconnectAttachmentsStubSettings.java index 88631fbd808a..3685e22887ac 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InterconnectAttachmentsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InterconnectAttachmentsStubSettings.java @@ -361,6 +361,12 @@ public InterconnectAttachmentsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InterconnectLocationsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InterconnectLocationsStubSettings.java index 9a1cd3604af7..d174e7d9c306 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InterconnectLocationsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InterconnectLocationsStubSettings.java @@ -195,6 +195,12 @@ public InterconnectLocationsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InterconnectRemoteLocationsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InterconnectRemoteLocationsStubSettings.java index 681262399422..26fbe030c54d 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InterconnectRemoteLocationsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InterconnectRemoteLocationsStubSettings.java @@ -205,6 +205,12 @@ public InterconnectRemoteLocationsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InterconnectsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InterconnectsStubSettings.java index 5f1012b33465..2b057eabe602 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InterconnectsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/InterconnectsStubSettings.java @@ -267,6 +267,12 @@ public InterconnectsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/LicenseCodesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/LicenseCodesStubSettings.java index 002f60b7a09c..836ebd4f1b77 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/LicenseCodesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/LicenseCodesStubSettings.java @@ -117,6 +117,12 @@ public LicenseCodesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/LicensesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/LicensesStubSettings.java index 8a86bc8343b6..e88e7b7ced1f 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/LicensesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/LicensesStubSettings.java @@ -237,6 +237,12 @@ public LicensesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/MachineImagesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/MachineImagesStubSettings.java index ea31988759ae..aab7eb9488e5 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/MachineImagesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/MachineImagesStubSettings.java @@ -240,6 +240,12 @@ public MachineImagesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/MachineTypesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/MachineTypesStubSettings.java index 6b1f1bae849b..9e47c9c29654 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/MachineTypesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/MachineTypesStubSettings.java @@ -270,6 +270,12 @@ public MachineTypesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworkAttachmentsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworkAttachmentsStubSettings.java index 33c0263f5b7a..d2b092215e11 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworkAttachmentsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworkAttachmentsStubSettings.java @@ -360,6 +360,12 @@ public NetworkAttachmentsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworkEdgeSecurityServicesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworkEdgeSecurityServicesStubSettings.java index 770a2a259648..cf84af0bd91b 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworkEdgeSecurityServicesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworkEdgeSecurityServicesStubSettings.java @@ -268,6 +268,12 @@ public NetworkEdgeSecurityServicesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworkEndpointGroupsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworkEndpointGroupsStubSettings.java index e4af33259cd7..87ec2adcc6e8 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworkEndpointGroupsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworkEndpointGroupsStubSettings.java @@ -472,6 +472,12 @@ public NetworkEndpointGroupsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworkFirewallPoliciesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworkFirewallPoliciesStubSettings.java index c96877af73dc..9901ffe164d3 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworkFirewallPoliciesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworkFirewallPoliciesStubSettings.java @@ -390,6 +390,12 @@ public NetworkFirewallPoliciesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworksStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworksStubSettings.java index 5fdd4990082b..a02aadaca570 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworksStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NetworksStubSettings.java @@ -388,6 +388,12 @@ public NetworksStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NodeGroupsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NodeGroupsStubSettings.java index 2c8cc3de1954..d1c35246749f 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NodeGroupsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NodeGroupsStubSettings.java @@ -474,6 +474,12 @@ public NodeGroupsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NodeTemplatesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NodeTemplatesStubSettings.java index cbb39cb14fc3..53c7e353623d 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NodeTemplatesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NodeTemplatesStubSettings.java @@ -335,6 +335,12 @@ public NodeTemplatesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NodeTypesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NodeTypesStubSettings.java index 793e92f0eb73..bf2ff1a69754 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NodeTypesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/NodeTypesStubSettings.java @@ -262,6 +262,12 @@ public NodeTypesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/PacketMirroringsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/PacketMirroringsStubSettings.java index 844f2e8c8502..810ceb605f81 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/PacketMirroringsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/PacketMirroringsStubSettings.java @@ -340,6 +340,12 @@ public PacketMirroringsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ProjectsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ProjectsStubSettings.java index c2b47449ba96..8dbead7dcd45 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ProjectsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ProjectsStubSettings.java @@ -415,6 +415,12 @@ public ProjectsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/PublicAdvertisedPrefixesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/PublicAdvertisedPrefixesStubSettings.java index 79db1c7cc333..29024cca1206 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/PublicAdvertisedPrefixesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/PublicAdvertisedPrefixesStubSettings.java @@ -283,6 +283,12 @@ public PublicAdvertisedPrefixesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/PublicDelegatedPrefixesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/PublicDelegatedPrefixesStubSettings.java index 266bcbfbf221..58bcd4d0737a 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/PublicDelegatedPrefixesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/PublicDelegatedPrefixesStubSettings.java @@ -377,6 +377,12 @@ public PublicDelegatedPrefixesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionAutoscalersStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionAutoscalersStubSettings.java index 3928a924dbb5..fc3f08ee48ba 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionAutoscalersStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionAutoscalersStubSettings.java @@ -251,6 +251,12 @@ public RegionAutoscalersStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionBackendServicesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionBackendServicesStubSettings.java index c4818ed3ba7a..e9eb8c71c333 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionBackendServicesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionBackendServicesStubSettings.java @@ -391,6 +391,12 @@ public RegionBackendServicesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionCommitmentsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionCommitmentsStubSettings.java index 4ee9f45b3a8d..5ed9c1cd7c88 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionCommitmentsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionCommitmentsStubSettings.java @@ -313,6 +313,12 @@ public RegionCommitmentsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionDiskTypesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionDiskTypesStubSettings.java index e3448ba271fe..edccefb784e2 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionDiskTypesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionDiskTypesStubSettings.java @@ -181,6 +181,12 @@ public RegionDiskTypesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionDisksStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionDisksStubSettings.java index a44debb33067..57d9beaefab9 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionDisksStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionDisksStubSettings.java @@ -398,6 +398,12 @@ public RegionDisksStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionHealthCheckServicesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionHealthCheckServicesStubSettings.java index f58ebe72964e..840e213efe34 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionHealthCheckServicesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionHealthCheckServicesStubSettings.java @@ -245,6 +245,12 @@ public RegionHealthCheckServicesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionHealthChecksStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionHealthChecksStubSettings.java index 394e44ce51ca..dc784c67c791 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionHealthChecksStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionHealthChecksStubSettings.java @@ -249,6 +249,12 @@ public RegionHealthChecksStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionInstanceGroupManagersStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionInstanceGroupManagersStubSettings.java index e7953b39536c..7f6c6afc9018 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionInstanceGroupManagersStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionInstanceGroupManagersStubSettings.java @@ -757,6 +757,12 @@ public RegionInstanceGroupManagersStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionInstanceGroupsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionInstanceGroupsStubSettings.java index b217208bd849..4a4de11152d7 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionInstanceGroupsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionInstanceGroupsStubSettings.java @@ -306,6 +306,12 @@ public RegionInstanceGroupsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionInstanceTemplatesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionInstanceTemplatesStubSettings.java index 3ab4bbdc9feb..05068f7769bb 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionInstanceTemplatesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionInstanceTemplatesStubSettings.java @@ -226,6 +226,12 @@ public RegionInstanceTemplatesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionInstancesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionInstancesStubSettings.java index 960bbc752fbc..deb153bd8c36 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionInstancesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionInstancesStubSettings.java @@ -118,6 +118,12 @@ public RegionInstancesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionNetworkEndpointGroupsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionNetworkEndpointGroupsStubSettings.java index 150ca998e05d..ae51f6316206 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionNetworkEndpointGroupsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionNetworkEndpointGroupsStubSettings.java @@ -375,6 +375,12 @@ public RegionNetworkEndpointGroupsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionNetworkFirewallPoliciesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionNetworkFirewallPoliciesStubSettings.java index c41263aa1f63..edc5d8df3e87 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionNetworkFirewallPoliciesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionNetworkFirewallPoliciesStubSettings.java @@ -423,6 +423,12 @@ public RegionNetworkFirewallPoliciesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionNotificationEndpointsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionNotificationEndpointsStubSettings.java index d61cf85bd31f..63ad3c44c925 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionNotificationEndpointsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionNotificationEndpointsStubSettings.java @@ -238,6 +238,12 @@ public RegionNotificationEndpointsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionOperationsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionOperationsStubSettings.java index 4988f747bce5..a3bf9cb85968 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionOperationsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionOperationsStubSettings.java @@ -199,6 +199,12 @@ public RegionOperationsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionSecurityPoliciesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionSecurityPoliciesStubSettings.java index a2b71ad070e7..da2981aab8aa 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionSecurityPoliciesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionSecurityPoliciesStubSettings.java @@ -296,6 +296,12 @@ public RegionSecurityPoliciesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionSslCertificatesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionSslCertificatesStubSettings.java index 6cd67dc76533..3e49dd644ed0 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionSslCertificatesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionSslCertificatesStubSettings.java @@ -224,6 +224,12 @@ public RegionSslCertificatesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionSslPoliciesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionSslPoliciesStubSettings.java index 960397345d4c..ebd534fd320f 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionSslPoliciesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionSslPoliciesStubSettings.java @@ -245,6 +245,12 @@ public RegionSslPoliciesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionTargetHttpProxiesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionTargetHttpProxiesStubSettings.java index 6812fcfee4be..a4a5b6d824ea 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionTargetHttpProxiesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionTargetHttpProxiesStubSettings.java @@ -241,6 +241,12 @@ public RegionTargetHttpProxiesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionTargetHttpsProxiesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionTargetHttpsProxiesStubSettings.java index 5b96c51ade88..7d32031a728a 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionTargetHttpsProxiesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionTargetHttpsProxiesStubSettings.java @@ -276,6 +276,12 @@ public RegionTargetHttpsProxiesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionTargetTcpProxiesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionTargetTcpProxiesStubSettings.java index 1777fe253d69..98e8bd635602 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionTargetTcpProxiesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionTargetTcpProxiesStubSettings.java @@ -224,6 +224,12 @@ public RegionTargetTcpProxiesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionUrlMapsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionUrlMapsStubSettings.java index 71850850bfcc..af86c7a52d68 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionUrlMapsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionUrlMapsStubSettings.java @@ -253,6 +253,12 @@ public RegionUrlMapsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionsStubSettings.java index f5b06670a2f0..f0eb9f2255a0 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RegionsStubSettings.java @@ -174,6 +174,12 @@ public RegionsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ReservationsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ReservationsStubSettings.java index 959847d9bf03..f53896dd7bb1 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ReservationsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ReservationsStubSettings.java @@ -359,6 +359,12 @@ public ReservationsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ResourcePoliciesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ResourcePoliciesStubSettings.java index 65eca67ebb5f..f790971b866a 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ResourcePoliciesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ResourcePoliciesStubSettings.java @@ -355,6 +355,12 @@ public ResourcePoliciesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RoutersStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RoutersStubSettings.java index 1fe7386025ae..61cea8cc471c 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RoutersStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RoutersStubSettings.java @@ -435,6 +435,12 @@ public RoutersStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RoutesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RoutesStubSettings.java index 827b81c6bdc2..5f13e349508d 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RoutesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/RoutesStubSettings.java @@ -205,6 +205,12 @@ public RoutesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SecurityPoliciesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SecurityPoliciesStubSettings.java index db3b26d7bc75..d5f53ba6537e 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SecurityPoliciesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SecurityPoliciesStubSettings.java @@ -412,6 +412,12 @@ public SecurityPoliciesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ServiceAttachmentsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ServiceAttachmentsStubSettings.java index d1bcbfdad7f7..a274712cbc64 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ServiceAttachmentsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ServiceAttachmentsStubSettings.java @@ -360,6 +360,12 @@ public ServiceAttachmentsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SnapshotSettingsServiceStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SnapshotSettingsServiceStubSettings.java index 91c84f211ee5..89fb3f579dfa 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SnapshotSettingsServiceStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SnapshotSettingsServiceStubSettings.java @@ -128,6 +128,12 @@ public SnapshotSettingsServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SnapshotsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SnapshotsStubSettings.java index 91cd6ee20185..6ba352c7b0f8 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SnapshotsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SnapshotsStubSettings.java @@ -250,6 +250,12 @@ public SnapshotsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SslCertificatesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SslCertificatesStubSettings.java index 85e367710287..6e16e0df2985 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SslCertificatesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SslCertificatesStubSettings.java @@ -312,6 +312,12 @@ public SslCertificatesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SslPoliciesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SslPoliciesStubSettings.java index eee96a36bc5d..4f64e3b7603d 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SslPoliciesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SslPoliciesStubSettings.java @@ -330,6 +330,12 @@ public SslPoliciesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SubnetworksStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SubnetworksStubSettings.java index 0bf20d5da669..b7e39862a937 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SubnetworksStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/SubnetworksStubSettings.java @@ -459,6 +459,12 @@ public SubnetworksStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetGrpcProxiesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetGrpcProxiesStubSettings.java index 41349c7a4413..761be6ce16bf 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetGrpcProxiesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetGrpcProxiesStubSettings.java @@ -236,6 +236,12 @@ public TargetGrpcProxiesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetHttpProxiesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetHttpProxiesStubSettings.java index 7961fbd45b36..e130eee5ac23 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetHttpProxiesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetHttpProxiesStubSettings.java @@ -346,6 +346,12 @@ public TargetHttpProxiesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetHttpsProxiesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetHttpsProxiesStubSettings.java index bafcae0f2302..e91258101f58 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetHttpsProxiesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetHttpsProxiesStubSettings.java @@ -416,6 +416,12 @@ public TargetHttpsProxiesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetInstancesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetInstancesStubSettings.java index f46372f3d7ff..1e4e20620885 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetInstancesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetInstancesStubSettings.java @@ -329,6 +329,12 @@ public TargetInstancesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetPoolsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetPoolsStubSettings.java index 7c59614d85f2..f8e5942ce7d4 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetPoolsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetPoolsStubSettings.java @@ -409,6 +409,12 @@ public TargetPoolsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetSslProxiesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetSslProxiesStubSettings.java index 185da5b11161..b2c0655734b1 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetSslProxiesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetSslProxiesStubSettings.java @@ -304,6 +304,12 @@ public TargetSslProxiesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetTcpProxiesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetTcpProxiesStubSettings.java index 157dca061998..e70d0473f4e5 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetTcpProxiesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetTcpProxiesStubSettings.java @@ -349,6 +349,12 @@ public TargetTcpProxiesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetVpnGatewaysStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetVpnGatewaysStubSettings.java index 949996c3e988..e075851ed269 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetVpnGatewaysStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/TargetVpnGatewaysStubSettings.java @@ -332,6 +332,12 @@ public TargetVpnGatewaysStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/UrlMapsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/UrlMapsStubSettings.java index fcc4367acd68..9cc3569c5c17 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/UrlMapsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/UrlMapsStubSettings.java @@ -342,6 +342,12 @@ public UrlMapsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/VpnGatewaysStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/VpnGatewaysStubSettings.java index 6aee449cfd0c..07fdb0a6e734 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/VpnGatewaysStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/VpnGatewaysStubSettings.java @@ -338,6 +338,12 @@ public VpnGatewaysStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/VpnTunnelsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/VpnTunnelsStubSettings.java index 9eec290acc64..11f573c43ea2 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/VpnTunnelsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/VpnTunnelsStubSettings.java @@ -314,6 +314,12 @@ public VpnTunnelsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ZoneOperationsStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ZoneOperationsStubSettings.java index 0da5474dd95c..d5749609dbef 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ZoneOperationsStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ZoneOperationsStubSettings.java @@ -197,6 +197,12 @@ public ZoneOperationsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ZonesStubSettings.java b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ZonesStubSettings.java index 3f5bc92fc40a..014c98c6eaa5 100644 --- a/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ZonesStubSettings.java +++ b/java-compute/google-cloud-compute/src/main/java/com/google/cloud/compute/v1/stub/ZonesStubSettings.java @@ -171,6 +171,12 @@ public ZonesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "compute"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-confidentialcomputing/README.md b/java-confidentialcomputing/README.md index f696a0a34b07..56ea6ee67b5c 100644 --- a/java-confidentialcomputing/README.md +++ b/java-confidentialcomputing/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-confidentialcomputing/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-confidentialcomputing.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-confidentialcomputing/0.16.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-confidentialcomputing/0.18.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-confidentialcomputing/google-cloud-confidentialcomputing/src/main/java/com/google/cloud/confidentialcomputing/v1/ConfidentialComputingClient.java b/java-confidentialcomputing/google-cloud-confidentialcomputing/src/main/java/com/google/cloud/confidentialcomputing/v1/ConfidentialComputingClient.java index b717776fd8d9..49bf1fd4ae0d 100644 --- a/java-confidentialcomputing/google-cloud-confidentialcomputing/src/main/java/com/google/cloud/confidentialcomputing/v1/ConfidentialComputingClient.java +++ b/java-confidentialcomputing/google-cloud-confidentialcomputing/src/main/java/com/google/cloud/confidentialcomputing/v1/ConfidentialComputingClient.java @@ -61,19 +61,75 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateChallenge + *+ * Creates a new Challenge in a given project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createChallenge(CreateChallengeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createChallenge(LocationName parent, Challenge challenge) + *
- createChallenge(String parent, Challenge challenge) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createChallengeCallable() + *
+ * + *VerifyAttestation + *+ * Verifies the provided attestation info, returning a signed OIDC token.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- verifyAttestation(VerifyAttestationRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- verifyAttestationCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-confidentialcomputing/google-cloud-confidentialcomputing/src/main/java/com/google/cloud/confidentialcomputing/v1/stub/ConfidentialComputingStubSettings.java b/java-confidentialcomputing/google-cloud-confidentialcomputing/src/main/java/com/google/cloud/confidentialcomputing/v1/stub/ConfidentialComputingStubSettings.java index 6f64f4b1d624..169e37b8be2f 100644 --- a/java-confidentialcomputing/google-cloud-confidentialcomputing/src/main/java/com/google/cloud/confidentialcomputing/v1/stub/ConfidentialComputingStubSettings.java +++ b/java-confidentialcomputing/google-cloud-confidentialcomputing/src/main/java/com/google/cloud/confidentialcomputing/v1/stub/ConfidentialComputingStubSettings.java @@ -205,6 +205,12 @@ public ConfidentialComputingStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "confidentialcomputing"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-confidentialcomputing/google-cloud-confidentialcomputing/src/main/java/com/google/cloud/confidentialcomputing/v1alpha1/ConfidentialComputingClient.java b/java-confidentialcomputing/google-cloud-confidentialcomputing/src/main/java/com/google/cloud/confidentialcomputing/v1alpha1/ConfidentialComputingClient.java index 88799118334b..b2984525531c 100644 --- a/java-confidentialcomputing/google-cloud-confidentialcomputing/src/main/java/com/google/cloud/confidentialcomputing/v1alpha1/ConfidentialComputingClient.java +++ b/java-confidentialcomputing/google-cloud-confidentialcomputing/src/main/java/com/google/cloud/confidentialcomputing/v1alpha1/ConfidentialComputingClient.java @@ -62,19 +62,75 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateChallenge + *+ * Creates a new Challenge in a given project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createChallenge(CreateChallengeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createChallenge(LocationName parent, Challenge challenge) + *
- createChallenge(String parent, Challenge challenge) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createChallengeCallable() + *
+ * + *VerifyAttestation + *+ * Verifies the provided attestation info, returning a signed OIDC token.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- verifyAttestation(VerifyAttestationRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- verifyAttestationCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-confidentialcomputing/google-cloud-confidentialcomputing/src/main/java/com/google/cloud/confidentialcomputing/v1alpha1/stub/ConfidentialComputingStubSettings.java b/java-confidentialcomputing/google-cloud-confidentialcomputing/src/main/java/com/google/cloud/confidentialcomputing/v1alpha1/stub/ConfidentialComputingStubSettings.java index 1c217475c351..59e7fd50e1b8 100644 --- a/java-confidentialcomputing/google-cloud-confidentialcomputing/src/main/java/com/google/cloud/confidentialcomputing/v1alpha1/stub/ConfidentialComputingStubSettings.java +++ b/java-confidentialcomputing/google-cloud-confidentialcomputing/src/main/java/com/google/cloud/confidentialcomputing/v1alpha1/stub/ConfidentialComputingStubSettings.java @@ -206,6 +206,12 @@ public ConfidentialComputingStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "confidentialcomputing"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-contact-center-insights/README.md b/java-contact-center-insights/README.md index 7d680c9bece1..f9e7f8e75bb9 100644 --- a/java-contact-center-insights/README.md +++ b/java-contact-center-insights/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-contact-center-insights.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-contact-center-insights/2.30.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-contact-center-insights/2.32.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-contact-center-insights/google-cloud-contact-center-insights/src/main/java/com/google/cloud/contactcenterinsights/v1/ContactCenterInsightsClient.java b/java-contact-center-insights/google-cloud-contact-center-insights/src/main/java/com/google/cloud/contactcenterinsights/v1/ContactCenterInsightsClient.java index 08f884e0501c..bb209c690e75 100644 --- a/java-contact-center-insights/google-cloud-contact-center-insights/src/main/java/com/google/cloud/contactcenterinsights/v1/ContactCenterInsightsClient.java +++ b/java-contact-center-insights/google-cloud-contact-center-insights/src/main/java/com/google/cloud/contactcenterinsights/v1/ContactCenterInsightsClient.java @@ -66,19 +66,757 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateConversation + *+ * Creates a conversation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createConversation(CreateConversationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createConversation(LocationName parent, Conversation conversation, String conversationId) + *
- createConversation(String parent, Conversation conversation, String conversationId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createConversationCallable() + *
+ * + *UploadConversation + *+ * Create a longrunning conversation upload operation. This method differs from CreateConversation by allowing audio transcription and optional DLP redaction.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- uploadConversationAsync(UploadConversationRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- uploadConversationOperationCallable() + *
- uploadConversationCallable() + *
+ * + *UpdateConversation + *+ * Updates a conversation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateConversation(UpdateConversationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateConversation(Conversation conversation, 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.
+ *+ *
+ *- updateConversationCallable() + *
+ * + *GetConversation + *+ * Gets a conversation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getConversation(GetConversationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getConversation(ConversationName name) + *
- getConversation(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.
+ *+ *
+ *- getConversationCallable() + *
+ * + *ListConversations + *+ * Lists conversations.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listConversations(ListConversationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listConversations(LocationName parent) + *
- listConversations(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.
+ *+ *
+ *- listConversationsPagedCallable() + *
- listConversationsCallable() + *
+ * + *DeleteConversation + *+ * Deletes a conversation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteConversation(DeleteConversationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteConversation(ConversationName name) + *
- deleteConversation(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.
+ *+ *
+ *- deleteConversationCallable() + *
+ * + *CreateAnalysis + *+ * Creates an analysis. The long running operation is done when the analysis has completed.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createAnalysisAsync(CreateAnalysisRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createAnalysisAsync(ConversationName parent, Analysis analysis) + *
- createAnalysisAsync(String parent, Analysis analysis) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createAnalysisOperationCallable() + *
- createAnalysisCallable() + *
+ * + *GetAnalysis + *+ * Gets an analysis.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getAnalysis(GetAnalysisRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getAnalysis(AnalysisName name) + *
- getAnalysis(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.
+ *+ *
+ *- getAnalysisCallable() + *
+ * + *ListAnalyses + *+ * Lists analyses.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listAnalyses(ListAnalysesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listAnalyses(ConversationName parent) + *
- listAnalyses(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.
+ *+ *
+ *- listAnalysesPagedCallable() + *
- listAnalysesCallable() + *
+ * + *DeleteAnalysis + *+ * Deletes an analysis.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAnalysis(DeleteAnalysisRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteAnalysis(AnalysisName name) + *
- deleteAnalysis(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.
+ *+ *
+ *- deleteAnalysisCallable() + *
+ * + *BulkAnalyzeConversations + *+ * Analyzes multiple conversations in a single request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- bulkAnalyzeConversationsAsync(BulkAnalyzeConversationsRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- bulkAnalyzeConversationsAsync(LocationName parent, String filter, float analysisPercentage) + *
- bulkAnalyzeConversationsAsync(String parent, String filter, float analysisPercentage) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- bulkAnalyzeConversationsOperationCallable() + *
- bulkAnalyzeConversationsCallable() + *
+ * + *BulkDeleteConversations + *+ * Deletes multiple conversations in a single request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- bulkDeleteConversationsAsync(BulkDeleteConversationsRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- bulkDeleteConversationsAsync(LocationName parent, String filter) + *
- bulkDeleteConversationsAsync(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.
+ *+ *
+ *- bulkDeleteConversationsOperationCallable() + *
- bulkDeleteConversationsCallable() + *
+ * + *IngestConversations + *+ * Imports conversations and processes them according to the user's configuration.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- ingestConversationsAsync(IngestConversationsRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- ingestConversationsAsync(LocationName parent) + *
- ingestConversationsAsync(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.
+ *+ *
+ *- ingestConversationsOperationCallable() + *
- ingestConversationsCallable() + *
+ * + *ExportInsightsData + *+ * Export insights data to a destination defined in the request body.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- exportInsightsDataAsync(ExportInsightsDataRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- exportInsightsDataAsync(LocationName parent) + *
- exportInsightsDataAsync(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.
+ *+ *
+ *- exportInsightsDataOperationCallable() + *
- exportInsightsDataCallable() + *
+ * + *CreateIssueModel + *+ * Creates an issue model.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createIssueModelAsync(CreateIssueModelRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createIssueModelAsync(LocationName parent, IssueModel issueModel) + *
- createIssueModelAsync(String parent, IssueModel issueModel) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createIssueModelOperationCallable() + *
- createIssueModelCallable() + *
+ * + *UpdateIssueModel + *+ * Updates an issue model.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateIssueModel(UpdateIssueModelRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateIssueModel(IssueModel issueModel, 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.
+ *+ *
+ *- updateIssueModelCallable() + *
+ * + *GetIssueModel + *+ * Gets an issue model.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIssueModel(GetIssueModelRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getIssueModel(IssueModelName name) + *
- getIssueModel(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.
+ *+ *
+ *- getIssueModelCallable() + *
+ * + *ListIssueModels + *+ * Lists issue models.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listIssueModels(ListIssueModelsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listIssueModels(LocationName parent) + *
- listIssueModels(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.
+ *+ *
+ *- listIssueModelsCallable() + *
+ * + *DeleteIssueModel + *+ * Deletes an issue model.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteIssueModelAsync(DeleteIssueModelRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteIssueModelAsync(IssueModelName name) + *
- deleteIssueModelAsync(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.
+ *+ *
+ *- deleteIssueModelOperationCallable() + *
- deleteIssueModelCallable() + *
+ * + *DeployIssueModel + *+ * Deploys an issue model. Returns an error if a model is already deployed. An issue model can only be used in analysis after it has been deployed.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deployIssueModelAsync(DeployIssueModelRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deployIssueModelAsync(IssueModelName name) + *
- deployIssueModelAsync(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.
+ *+ *
+ *- deployIssueModelOperationCallable() + *
- deployIssueModelCallable() + *
+ * + *UndeployIssueModel + *+ * Undeploys an issue model. An issue model can not be used in analysis after it has been undeployed.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- undeployIssueModelAsync(UndeployIssueModelRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- undeployIssueModelAsync(IssueModelName name) + *
- undeployIssueModelAsync(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.
+ *+ *
+ *- undeployIssueModelOperationCallable() + *
- undeployIssueModelCallable() + *
+ * + *GetIssue + *+ * Gets an issue.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIssue(GetIssueRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getIssue(IssueName name) + *
- getIssue(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.
+ *+ *
+ *- getIssueCallable() + *
+ * + *ListIssues + *+ * Lists issues.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listIssues(ListIssuesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listIssues(IssueModelName parent) + *
- listIssues(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.
+ *+ *
+ *- listIssuesCallable() + *
+ * + *UpdateIssue + *+ * Updates an issue.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateIssue(UpdateIssueRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateIssue(Issue issue, 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.
+ *+ *
+ *- updateIssueCallable() + *
+ * + *DeleteIssue + *+ * Deletes an issue.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteIssue(DeleteIssueRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteIssue(IssueName name) + *
- deleteIssue(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.
+ *+ *
+ *- deleteIssueCallable() + *
+ * + *CalculateIssueModelStats + *+ * Gets an issue model's statistics.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- calculateIssueModelStats(CalculateIssueModelStatsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- calculateIssueModelStats(IssueModelName issueModel) + *
- calculateIssueModelStats(String issueModel) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- calculateIssueModelStatsCallable() + *
+ * + *CreatePhraseMatcher + *+ * Creates a phrase matcher.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createPhraseMatcher(CreatePhraseMatcherRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createPhraseMatcher(LocationName parent, PhraseMatcher phraseMatcher) + *
- createPhraseMatcher(String parent, PhraseMatcher phraseMatcher) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createPhraseMatcherCallable() + *
+ * + *GetPhraseMatcher + *+ * Gets a phrase matcher.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getPhraseMatcher(GetPhraseMatcherRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getPhraseMatcher(PhraseMatcherName name) + *
- getPhraseMatcher(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.
+ *+ *
+ *- getPhraseMatcherCallable() + *
+ * + *ListPhraseMatchers + *+ * Lists phrase matchers.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listPhraseMatchers(ListPhraseMatchersRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listPhraseMatchers(LocationName parent) + *
- listPhraseMatchers(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.
+ *+ *
+ *- listPhraseMatchersPagedCallable() + *
- listPhraseMatchersCallable() + *
+ * + *DeletePhraseMatcher + *+ * Deletes a phrase matcher.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deletePhraseMatcher(DeletePhraseMatcherRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deletePhraseMatcher(PhraseMatcherName name) + *
- deletePhraseMatcher(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.
+ *+ *
+ *- deletePhraseMatcherCallable() + *
+ * + *UpdatePhraseMatcher + *+ * Updates a phrase matcher.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updatePhraseMatcher(UpdatePhraseMatcherRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updatePhraseMatcher(PhraseMatcher phraseMatcher, 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.
+ *+ *
+ *- updatePhraseMatcherCallable() + *
+ * + *CalculateStats + *+ * Gets conversation statistics.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- calculateStats(CalculateStatsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- calculateStats(LocationName location) + *
- calculateStats(String location) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- calculateStatsCallable() + *
+ * + *GetSettings + *+ * Gets project-level settings.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getSettings(GetSettingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getSettings(SettingsName name) + *
- getSettings(String name) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getSettingsCallable() + *
+ * + *UpdateSettings + *+ * Updates project-level settings.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateSettings(UpdateSettingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateSettings(Settings settings, FieldMask updateMask) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateSettingsCallable() + *
+ * + *CreateView + *+ * Creates a view.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createView(CreateViewRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createView(LocationName parent, View view) + *
- createView(String parent, View view) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createViewCallable() + *
+ * + *GetView + *+ * Gets a view.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getView(GetViewRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getView(ViewName name) + *
- getView(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.
+ *+ *
+ *- getViewCallable() + *
+ * + *ListViews + *+ * Lists views.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listViews(ListViewsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listViews(LocationName parent) + *
- listViews(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.
+ *+ *
+ *- listViewsPagedCallable() + *
- listViewsCallable() + *
+ * + *UpdateView + *+ * Updates a view.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateView(UpdateViewRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateView(View view, 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.
+ *+ *
+ *- updateViewCallable() + *
+ * + * + *DeleteView + *+ * Deletes a view.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteView(DeleteViewRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteView(ViewName name) + *
- deleteView(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.
+ *+ *
+ *- deleteViewCallable() + *
See the individual methods for example code. * diff --git a/java-contact-center-insights/google-cloud-contact-center-insights/src/main/java/com/google/cloud/contactcenterinsights/v1/stub/ContactCenterInsightsStubSettings.java b/java-contact-center-insights/google-cloud-contact-center-insights/src/main/java/com/google/cloud/contactcenterinsights/v1/stub/ContactCenterInsightsStubSettings.java index a5cd6863b077..4c1b4f18a367 100644 --- a/java-contact-center-insights/google-cloud-contact-center-insights/src/main/java/com/google/cloud/contactcenterinsights/v1/stub/ContactCenterInsightsStubSettings.java +++ b/java-contact-center-insights/google-cloud-contact-center-insights/src/main/java/com/google/cloud/contactcenterinsights/v1/stub/ContactCenterInsightsStubSettings.java @@ -787,6 +787,12 @@ public ContactCenterInsightsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "contactcenterinsights"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-container/google-cloud-container/src/main/java/com/google/cloud/container/v1/ClusterManagerClient.java b/java-container/google-cloud-container/src/main/java/com/google/cloud/container/v1/ClusterManagerClient.java index abce479d1ccd..f90e9c7ee91d 100644 --- a/java-container/google-cloud-container/src/main/java/com/google/cloud/container/v1/ClusterManagerClient.java +++ b/java-container/google-cloud-container/src/main/java/com/google/cloud/container/v1/ClusterManagerClient.java @@ -104,19 +104,614 @@ *
Note: close() needs to be called on the ClusterManagerClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListClusters + *+ * Lists all clusters owned by a project in either the specified zone or all zones.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(String parent) + *
- listClusters(String projectId, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listClustersCallable() + *
+ * + *GetCluster + *+ * Gets the details of a specific cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(String name) + *
- getCluster(String projectId, String zone, 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.
+ *+ *
+ *- getClusterCallable() + *
+ * + *CreateCluster + *+ * Creates a cluster, consisting of the specified number and type of Google Compute Engine instances. + *
By default, the cluster is created in the project's [default network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks). + *
One firewall is added for the cluster. After cluster creation, the Kubelet creates routes for each node to allow the containers on that node to communicate with all other instances in the cluster. + *
Finally, an entry is added to the project's global metadata indicating which CIDR range the cluster is using.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createCluster(CreateClusterRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createCluster(String parent, Cluster cluster) + *
- createCluster(String projectId, String zone, Cluster cluster) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createClusterCallable() + *
+ * + *UpdateCluster + *+ * Updates the settings of a specific cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateCluster(UpdateClusterRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateCluster(String name, ClusterUpdate update) + *
- updateCluster(String projectId, String zone, String clusterId, ClusterUpdate update) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateClusterCallable() + *
+ * + *UpdateNodePool + *+ * Updates the version and/or image type for the specified node pool.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateNodePool(UpdateNodePoolRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateNodePoolCallable() + *
+ * + *SetNodePoolAutoscaling + *+ * Sets the autoscaling settings for the specified node pool.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setNodePoolAutoscaling(SetNodePoolAutoscalingRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setNodePoolAutoscalingCallable() + *
+ * + *SetLoggingService + *+ * Sets the logging service for a specific cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLoggingService(SetLoggingServiceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setLoggingService(String name, String loggingService) + *
- setLoggingService(String projectId, String zone, String clusterId, String loggingService) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLoggingServiceCallable() + *
+ * + *SetMonitoringService + *+ * Sets the monitoring service for a specific cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setMonitoringService(SetMonitoringServiceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setMonitoringService(String name, String monitoringService) + *
- setMonitoringService(String projectId, String zone, String clusterId, String monitoringService) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setMonitoringServiceCallable() + *
+ * + *SetAddonsConfig + *+ * Sets the addons for a specific cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setAddonsConfig(SetAddonsConfigRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setAddonsConfig(String name, AddonsConfig addonsConfig) + *
- setAddonsConfig(String projectId, String zone, String clusterId, AddonsConfig addonsConfig) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setAddonsConfigCallable() + *
+ * + *SetLocations + *+ * Sets the locations for a specific cluster. Deprecated. Use [projects.locations.clusters.update](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters/update) instead.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLocations(SetLocationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setLocations(String name, List
locations) + * - setLocations(String projectId, String zone, String clusterId, List
locations) + * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLocationsCallable() + *
+ * + *UpdateMaster + *+ * Updates the master for a specific cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateMaster(UpdateMasterRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateMaster(String name, String masterVersion) + *
- updateMaster(String projectId, String zone, String clusterId, String masterVersion) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateMasterCallable() + *
+ * + *SetMasterAuth + *+ * Sets master auth materials. Currently supports changing the admin password or a specific cluster, either via password generation or explicitly setting the password.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setMasterAuth(SetMasterAuthRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setMasterAuthCallable() + *
+ * + *DeleteCluster + *+ * Deletes the cluster, including the Kubernetes endpoint and all worker nodes. + *
Firewalls and routes that were configured during cluster creation are also deleted. + *
Other Google Compute Engine resources that might be in use by the cluster, such as load balancer resources, are not deleted if they weren't present when the cluster was initially created.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteCluster(DeleteClusterRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteCluster(String name) + *
- deleteCluster(String projectId, String zone, 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.
+ *+ *
+ *- deleteClusterCallable() + *
+ * + *ListOperations + *+ * Lists all operations in a project in a specific zone or all zones.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listOperations(ListOperationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listOperations(String projectId, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listOperationsCallable() + *
+ * + *GetOperation + *+ * Gets the specified operation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getOperation(GetOperationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getOperation(String name) + *
- getOperation(String projectId, String zone, String operationId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getOperationCallable() + *
+ * + *CancelOperation + *+ * Cancels the specified operation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- cancelOperation(CancelOperationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- cancelOperation(String name) + *
- cancelOperation(String projectId, String zone, String operationId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- cancelOperationCallable() + *
+ * + *GetServerConfig + *+ * Returns configuration info about the Google Kubernetes Engine service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getServerConfig(GetServerConfigRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getServerConfig(String name) + *
- getServerConfig(String projectId, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getServerConfigCallable() + *
+ * + *GetJSONWebKeys + *+ * Gets the public component of the cluster signing keys in JSON Web Key format. This API is not yet intended for general use, and is not available for all clusters.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getJSONWebKeys(GetJSONWebKeysRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getJSONWebKeysCallable() + *
+ * + *ListNodePools + *+ * Lists the node pools for a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listNodePools(ListNodePoolsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listNodePools(String parent) + *
- listNodePools(String projectId, String zone, 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.
+ *+ *
+ *- listNodePoolsCallable() + *
+ * + *GetNodePool + *+ * Retrieves the requested node pool.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getNodePool(GetNodePoolRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getNodePool(String name) + *
- getNodePool(String projectId, String zone, String clusterId, String nodePoolId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getNodePoolCallable() + *
+ * + *CreateNodePool + *+ * Creates a node pool for a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createNodePool(CreateNodePoolRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createNodePool(String parent, NodePool nodePool) + *
- createNodePool(String projectId, String zone, String clusterId, NodePool nodePool) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createNodePoolCallable() + *
+ * + *DeleteNodePool + *+ * Deletes a node pool from a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteNodePool(DeleteNodePoolRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteNodePool(String name) + *
- deleteNodePool(String projectId, String zone, String clusterId, String nodePoolId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteNodePoolCallable() + *
+ * + *CompleteNodePoolUpgrade + *+ * CompleteNodePoolUpgrade will signal an on-going node pool upgrade to complete.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- completeNodePoolUpgrade(CompleteNodePoolUpgradeRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- completeNodePoolUpgradeCallable() + *
+ * + *RollbackNodePoolUpgrade + *+ * Rolls back a previously Aborted or Failed NodePool upgrade. This makes no changes if the last upgrade successfully completed.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- rollbackNodePoolUpgrade(RollbackNodePoolUpgradeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- rollbackNodePoolUpgrade(String name) + *
- rollbackNodePoolUpgrade(String projectId, String zone, String clusterId, String nodePoolId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- rollbackNodePoolUpgradeCallable() + *
+ * + *SetNodePoolManagement + *+ * Sets the NodeManagement options for a node pool.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setNodePoolManagement(SetNodePoolManagementRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setNodePoolManagementCallable() + *
+ * + *SetLabels + *+ * Sets labels on a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabels(SetLabelsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsCallable() + *
+ * + *SetLegacyAbac + *+ * Enables or disables the ABAC authorization mechanism on a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLegacyAbac(SetLegacyAbacRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setLegacyAbac(String name, boolean enabled) + *
- setLegacyAbac(String projectId, String zone, String clusterId, boolean enabled) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLegacyAbacCallable() + *
+ * + *StartIPRotation + *+ * Starts master IP rotation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- startIPRotation(StartIPRotationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- startIPRotation(String name) + *
- startIPRotation(String projectId, String zone, 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.
+ *+ *
+ *- startIPRotationCallable() + *
+ * + *CompleteIPRotation + *+ * Completes master IP rotation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- completeIPRotation(CompleteIPRotationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- completeIPRotation(String name) + *
- completeIPRotation(String projectId, String zone, 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.
+ *+ *
+ *- completeIPRotationCallable() + *
+ * + *SetNodePoolSize + *+ * Sets the size for a specific node pool. The new size will be used for all replicas, including future replicas created by modifying [NodePool.locations][google.container.v1.NodePool.locations].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setNodePoolSize(SetNodePoolSizeRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setNodePoolSizeCallable() + *
+ * + *SetNetworkPolicy + *+ * Enables or disables Network Policy for a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setNetworkPolicy(SetNetworkPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setNetworkPolicy(String name, NetworkPolicy networkPolicy) + *
- setNetworkPolicy(String projectId, String zone, String clusterId, NetworkPolicy networkPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setNetworkPolicyCallable() + *
+ * + *SetMaintenancePolicy + *+ * Sets the maintenance policy for a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setMaintenancePolicy(SetMaintenancePolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setMaintenancePolicy(String name, MaintenancePolicy maintenancePolicy) + *
- setMaintenancePolicy(String projectId, String zone, String clusterId, MaintenancePolicy maintenancePolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setMaintenancePolicyCallable() + *
+ * + *ListUsableSubnetworks + *+ * Lists subnetworks that are usable for creating clusters in a project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listUsableSubnetworks(ListUsableSubnetworksRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listUsableSubnetworksPagedCallable() + *
- listUsableSubnetworksCallable() + *
+ * + * + *CheckAutopilotCompatibility + *+ * Checks the cluster compatibility with Autopilot mode, and returns a list of compatibility issues.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- checkAutopilotCompatibility(CheckAutopilotCompatibilityRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- checkAutopilotCompatibilityCallable() + *
See the individual methods for example code. * diff --git a/java-container/google-cloud-container/src/main/java/com/google/cloud/container/v1/stub/ClusterManagerStubSettings.java b/java-container/google-cloud-container/src/main/java/com/google/cloud/container/v1/stub/ClusterManagerStubSettings.java index 081952e00fed..1e7e40fe1306 100644 --- a/java-container/google-cloud-container/src/main/java/com/google/cloud/container/v1/stub/ClusterManagerStubSettings.java +++ b/java-container/google-cloud-container/src/main/java/com/google/cloud/container/v1/stub/ClusterManagerStubSettings.java @@ -448,6 +448,12 @@ public ClusterManagerStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "container"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-container/google-cloud-container/src/main/java/com/google/cloud/container/v1beta1/ClusterManagerClient.java b/java-container/google-cloud-container/src/main/java/com/google/cloud/container/v1beta1/ClusterManagerClient.java index 50ad55f90ee3..edc935dbcc64 100644 --- a/java-container/google-cloud-container/src/main/java/com/google/cloud/container/v1beta1/ClusterManagerClient.java +++ b/java-container/google-cloud-container/src/main/java/com/google/cloud/container/v1beta1/ClusterManagerClient.java @@ -110,19 +110,621 @@ *
Note: close() needs to be called on the ClusterManagerClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListClusters + *+ * Lists all clusters owned by a project in either the specified zone or all zones.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(String projectId, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listClustersCallable() + *
+ * + *GetCluster + *+ * Gets the details for a specific cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(String projectId, String zone, 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.
+ *+ *
+ *- getClusterCallable() + *
+ * + *CreateCluster + *+ * Creates a cluster, consisting of the specified number and type of Google Compute Engine instances. + *
By default, the cluster is created in the project's [default network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks). + *
One firewall is added for the cluster. After cluster creation, the Kubelet creates routes for each node to allow the containers on that node to communicate with all other instances in the cluster. + *
Finally, an entry is added to the project's global metadata indicating which CIDR range the cluster is using.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createCluster(CreateClusterRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createCluster(String projectId, String zone, Cluster cluster) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createClusterCallable() + *
+ * + *UpdateCluster + *+ * Updates the settings for a specific cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateCluster(UpdateClusterRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateCluster(String projectId, String zone, String clusterId, ClusterUpdate update) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateClusterCallable() + *
+ * + *UpdateNodePool + *+ * Updates the version and/or image type of a specific node pool.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateNodePool(UpdateNodePoolRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateNodePoolCallable() + *
+ * + *SetNodePoolAutoscaling + *+ * Sets the autoscaling settings of a specific node pool.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setNodePoolAutoscaling(SetNodePoolAutoscalingRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setNodePoolAutoscalingCallable() + *
+ * + *SetLoggingService + *+ * Sets the logging service for a specific cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLoggingService(SetLoggingServiceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setLoggingService(String projectId, String zone, String clusterId, String loggingService) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLoggingServiceCallable() + *
+ * + *SetMonitoringService + *+ * Sets the monitoring service for a specific cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setMonitoringService(SetMonitoringServiceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setMonitoringService(String projectId, String zone, String clusterId, String monitoringService) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setMonitoringServiceCallable() + *
+ * + *SetAddonsConfig + *+ * Sets the addons for a specific cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setAddonsConfig(SetAddonsConfigRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setAddonsConfig(String projectId, String zone, String clusterId, AddonsConfig addonsConfig) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setAddonsConfigCallable() + *
+ * + *SetLocations + *+ * Sets the locations for a specific cluster. Deprecated. Use [projects.locations.clusters.update](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters/update) instead.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLocations(SetLocationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setLocations(String projectId, String zone, String clusterId, List
locations) + * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLocationsCallable() + *
+ * + *UpdateMaster + *+ * Updates the master for a specific cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateMaster(UpdateMasterRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateMaster(String projectId, String zone, String clusterId, String masterVersion) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateMasterCallable() + *
+ * + *SetMasterAuth + *+ * Sets master auth materials. Currently supports changing the admin password or a specific cluster, either via password generation or explicitly setting the password.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setMasterAuth(SetMasterAuthRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setMasterAuthCallable() + *
+ * + *DeleteCluster + *+ * Deletes the cluster, including the Kubernetes endpoint and all worker nodes. + *
Firewalls and routes that were configured during cluster creation are also deleted. + *
Other Google Compute Engine resources that might be in use by the cluster, such as load balancer resources, are not deleted if they weren't present when the cluster was initially created.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteCluster(DeleteClusterRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteCluster(String projectId, String zone, 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.
+ *+ *
+ *- deleteClusterCallable() + *
+ * + *ListOperations + *+ * Lists all operations in a project in the specified zone or all zones.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listOperations(ListOperationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listOperations(String projectId, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listOperationsCallable() + *
+ * + *GetOperation + *+ * Gets the specified operation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getOperation(GetOperationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getOperation(String projectId, String zone, String operationId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getOperationCallable() + *
+ * + *CancelOperation + *+ * Cancels the specified operation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- cancelOperation(CancelOperationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- cancelOperation(String projectId, String zone, String operationId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- cancelOperationCallable() + *
+ * + *GetServerConfig + *+ * Returns configuration info about the Google Kubernetes Engine service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getServerConfig(GetServerConfigRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getServerConfig(String projectId, String zone) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getServerConfigCallable() + *
+ * + *GetJSONWebKeys + *+ * Gets the public component of the cluster signing keys in JSON Web Key format. This API is not yet intended for general use, and is not available for all clusters.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getJSONWebKeys(GetJSONWebKeysRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getJSONWebKeysCallable() + *
+ * + *ListNodePools + *+ * Lists the node pools for a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listNodePools(ListNodePoolsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listNodePools(String projectId, String zone, 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.
+ *+ *
+ *- listNodePoolsCallable() + *
+ * + *GetNodePool + *+ * Retrieves the requested node pool.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getNodePool(GetNodePoolRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getNodePool(String projectId, String zone, String clusterId, String nodePoolId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getNodePoolCallable() + *
+ * + *CreateNodePool + *+ * Creates a node pool for a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createNodePool(CreateNodePoolRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createNodePool(String projectId, String zone, String clusterId, NodePool nodePool) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createNodePoolCallable() + *
+ * + *DeleteNodePool + *+ * Deletes a node pool from a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteNodePool(DeleteNodePoolRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteNodePool(String projectId, String zone, String clusterId, String nodePoolId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteNodePoolCallable() + *
+ * + *CompleteNodePoolUpgrade + *+ * CompleteNodePoolUpgrade will signal an on-going node pool upgrade to complete.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- completeNodePoolUpgrade(CompleteNodePoolUpgradeRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- completeNodePoolUpgradeCallable() + *
+ * + *RollbackNodePoolUpgrade + *+ * Rolls back a previously Aborted or Failed NodePool upgrade. This makes no changes if the last upgrade successfully completed.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- rollbackNodePoolUpgrade(RollbackNodePoolUpgradeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- rollbackNodePoolUpgrade(String projectId, String zone, String clusterId, String nodePoolId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- rollbackNodePoolUpgradeCallable() + *
+ * + *SetNodePoolManagement + *+ * Sets the NodeManagement options for a node pool.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setNodePoolManagement(SetNodePoolManagementRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setNodePoolManagement(String projectId, String zone, String clusterId, String nodePoolId, NodeManagement management) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setNodePoolManagementCallable() + *
+ * + *SetLabels + *+ * Sets labels on a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLabels(SetLabelsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setLabels(String projectId, String zone, String clusterId, Map
resourceLabels, String labelFingerprint) + * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLabelsCallable() + *
+ * + *SetLegacyAbac + *+ * Enables or disables the ABAC authorization mechanism on a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setLegacyAbac(SetLegacyAbacRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setLegacyAbac(String projectId, String zone, String clusterId, boolean enabled) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setLegacyAbacCallable() + *
+ * + *StartIPRotation + *+ * Starts master IP rotation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- startIPRotation(StartIPRotationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- startIPRotation(String projectId, String zone, 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.
+ *+ *
+ *- startIPRotationCallable() + *
+ * + *CompleteIPRotation + *+ * Completes master IP rotation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- completeIPRotation(CompleteIPRotationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- completeIPRotation(String projectId, String zone, 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.
+ *+ *
+ *- completeIPRotationCallable() + *
+ * + *SetNodePoolSize + *+ * SetNodePoolSizeRequest sets the size of a node pool. The new size will be used for all replicas, including future replicas created by modifying [NodePool.locations][google.container.v1beta1.NodePool.locations].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setNodePoolSize(SetNodePoolSizeRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setNodePoolSizeCallable() + *
+ * + *SetNetworkPolicy + *+ * Enables or disables Network Policy for a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setNetworkPolicy(SetNetworkPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setNetworkPolicy(String projectId, String zone, String clusterId, NetworkPolicy networkPolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setNetworkPolicyCallable() + *
+ * + *SetMaintenancePolicy + *+ * Sets the maintenance policy for a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setMaintenancePolicy(SetMaintenancePolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setMaintenancePolicy(String projectId, String zone, String clusterId, MaintenancePolicy maintenancePolicy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setMaintenancePolicyCallable() + *
+ * + *ListUsableSubnetworks + *+ * Lists subnetworks that can be used for creating clusters in a project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listUsableSubnetworks(ListUsableSubnetworksRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listUsableSubnetworks(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.
+ *+ *
+ *- listUsableSubnetworksPagedCallable() + *
- listUsableSubnetworksCallable() + *
+ * + *CheckAutopilotCompatibility + *+ * Checks the cluster compatibility with Autopilot mode, and returns a list of compatibility issues.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- checkAutopilotCompatibility(CheckAutopilotCompatibilityRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- checkAutopilotCompatibilityCallable() + *
+ * + * + *ListLocations + *+ * Fetches locations that offer Google Kubernetes Engine.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listLocations(ListLocationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listLocations(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.
+ *+ *
+ *- listLocationsCallable() + *
See the individual methods for example code. * diff --git a/java-container/google-cloud-container/src/main/java/com/google/cloud/container/v1beta1/stub/ClusterManagerStubSettings.java b/java-container/google-cloud-container/src/main/java/com/google/cloud/container/v1beta1/stub/ClusterManagerStubSettings.java index 8aab6cdfc97c..5184800a2282 100644 --- a/java-container/google-cloud-container/src/main/java/com/google/cloud/container/v1beta1/stub/ClusterManagerStubSettings.java +++ b/java-container/google-cloud-container/src/main/java/com/google/cloud/container/v1beta1/stub/ClusterManagerStubSettings.java @@ -458,6 +458,12 @@ public ClusterManagerStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "container"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-containeranalysis/README.md b/java-containeranalysis/README.md index ca9d23865ec0..9ca1071d8690 100644 --- a/java-containeranalysis/README.md +++ b/java-containeranalysis/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-containeranalysis.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-containeranalysis/2.31.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-containeranalysis/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-containeranalysis/google-cloud-containeranalysis/src/main/java/com/google/cloud/devtools/containeranalysis/v1/ContainerAnalysisClient.java b/java-containeranalysis/google-cloud-containeranalysis/src/main/java/com/google/cloud/devtools/containeranalysis/v1/ContainerAnalysisClient.java index 942d281c0334..af4eb3fc01cb 100644 --- a/java-containeranalysis/google-cloud-containeranalysis/src/main/java/com/google/cloud/devtools/containeranalysis/v1/ContainerAnalysisClient.java +++ b/java-containeranalysis/google-cloud-containeranalysis/src/main/java/com/google/cloud/devtools/containeranalysis/v1/ContainerAnalysisClient.java @@ -87,19 +87,92 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified note or occurrence. Requires `containeranalysis.notes.setIamPolicy` or `containeranalysis.occurrences.setIamPolicy` permission if the resource is a note or an occurrence, respectively. + *
The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for occurrences.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a note or an occurrence resource. Requires `containeranalysis.notes.setIamPolicy` or `containeranalysis.occurrences.setIamPolicy` permission if the resource is a note or occurrence, respectively. + *
The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for occurrences.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getIamPolicyCallable() + *
+ * + *TestIamPermissions + *+ * Returns the permissions that a caller has on the specified note or occurrence. Requires list permission on the project (for example, `containeranalysis.notes.list`). + *
The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for occurrences.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
+ * + * + *GetVulnerabilityOccurrencesSummary + *+ * Gets a summary of the number and severity of occurrences.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getVulnerabilityOccurrencesSummary(GetVulnerabilityOccurrencesSummaryRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getVulnerabilityOccurrencesSummary(ProjectName parent, String filter) + *
- getVulnerabilityOccurrencesSummary(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.
+ *+ *
+ *- getVulnerabilityOccurrencesSummaryCallable() + *
See the individual methods for example code. * diff --git a/java-containeranalysis/google-cloud-containeranalysis/src/main/java/com/google/cloud/devtools/containeranalysis/v1/stub/ContainerAnalysisStubSettings.java b/java-containeranalysis/google-cloud-containeranalysis/src/main/java/com/google/cloud/devtools/containeranalysis/v1/stub/ContainerAnalysisStubSettings.java index 6d61779efe92..cecad0b9b845 100644 --- a/java-containeranalysis/google-cloud-containeranalysis/src/main/java/com/google/cloud/devtools/containeranalysis/v1/stub/ContainerAnalysisStubSettings.java +++ b/java-containeranalysis/google-cloud-containeranalysis/src/main/java/com/google/cloud/devtools/containeranalysis/v1/stub/ContainerAnalysisStubSettings.java @@ -142,6 +142,12 @@ public ContainerAnalysisStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "containeranalysis"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-contentwarehouse/README.md b/java-contentwarehouse/README.md index 53b0ea2396ed..8b5b2fc90fcb 100644 --- a/java-contentwarehouse/README.md +++ b/java-contentwarehouse/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-contentwarehouse.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-contentwarehouse/0.26.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-contentwarehouse/0.28.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-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/DocumentLinkServiceClient.java b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/DocumentLinkServiceClient.java index 46e1deb69eef..da8ab9edc034 100644 --- a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/DocumentLinkServiceClient.java +++ b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/DocumentLinkServiceClient.java @@ -58,19 +58,90 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListLinkedTargets + *+ * Return all target document-links from the document.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listLinkedTargets(ListLinkedTargetsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listLinkedTargets(DocumentName parent) + *
- listLinkedTargets(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.
+ *+ *
+ *- listLinkedTargetsCallable() + *
+ * + *ListLinkedSources + *+ * Return all source document-links from the document.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listLinkedSources(ListLinkedSourcesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listLinkedSources(DocumentName parent) + *
- listLinkedSources(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.
+ *+ *
+ *- listLinkedSourcesPagedCallable() + *
- listLinkedSourcesCallable() + *
+ * + *CreateDocumentLink + *+ * Create a link between a source document and a target document.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createDocumentLink(CreateDocumentLinkRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createDocumentLink(DocumentName parent, DocumentLink documentLink) + *
- createDocumentLink(String parent, DocumentLink documentLink) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createDocumentLinkCallable() + *
+ * + * + *DeleteDocumentLink + *+ * Remove the link between the source and target documents.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteDocumentLink(DeleteDocumentLinkRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteDocumentLink(DocumentLinkName name) + *
- deleteDocumentLink(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.
+ *+ *
+ *- deleteDocumentLinkCallable() + *
See the individual methods for example code. * diff --git a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/DocumentSchemaServiceClient.java b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/DocumentSchemaServiceClient.java index 422ca7b5338c..401a2c403b27 100644 --- a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/DocumentSchemaServiceClient.java +++ b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/DocumentSchemaServiceClient.java @@ -59,19 +59,109 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateDocumentSchema + *+ * Creates a document schema.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createDocumentSchema(CreateDocumentSchemaRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createDocumentSchema(LocationName parent, DocumentSchema documentSchema) + *
- createDocumentSchema(String parent, DocumentSchema documentSchema) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createDocumentSchemaCallable() + *
+ * + *UpdateDocumentSchema + *+ * Updates a Document Schema. Returns INVALID_ARGUMENT if the name of the Document Schema is non-empty and does not equal the existing name. Supports only appending new properties, adding new ENUM possible values, and updating the [EnumTypeOptions.validation_check_disabled][google.cloud.contentwarehouse.v1.EnumTypeOptions.validation_check_disabled] flag for ENUM possible values. Updating existing properties will result into INVALID_ARGUMENT.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateDocumentSchema(UpdateDocumentSchemaRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateDocumentSchema(DocumentSchemaName name, DocumentSchema documentSchema) + *
- updateDocumentSchema(String name, DocumentSchema documentSchema) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateDocumentSchemaCallable() + *
+ * + *GetDocumentSchema + *+ * Gets a document schema. Returns NOT_FOUND if the document schema does not exist.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getDocumentSchema(GetDocumentSchemaRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getDocumentSchema(DocumentSchemaName name) + *
- getDocumentSchema(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.
+ *+ *
+ *- getDocumentSchemaCallable() + *
+ * + *DeleteDocumentSchema + *+ * Deletes a document schema. Returns NOT_FOUND if the document schema does not exist. Returns BAD_REQUEST if the document schema has documents depending on it.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteDocumentSchema(DeleteDocumentSchemaRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteDocumentSchema(DocumentSchemaName name) + *
- deleteDocumentSchema(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.
+ *+ *
+ *- deleteDocumentSchemaCallable() + *
+ * + * + *ListDocumentSchemas + *+ * Lists document schemas.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listDocumentSchemas(ListDocumentSchemasRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listDocumentSchemas(LocationName parent) + *
- listDocumentSchemas(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.
+ *+ *
+ *- listDocumentSchemasPagedCallable() + *
- listDocumentSchemasCallable() + *
See the individual methods for example code. * diff --git a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/DocumentServiceClient.java b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/DocumentServiceClient.java index 3f26b48f832f..5dae9bb96434 100644 --- a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/DocumentServiceClient.java +++ b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/DocumentServiceClient.java @@ -58,19 +58,164 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateDocument + *+ * Creates a document.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createDocument(CreateDocumentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createDocument(LocationName parent, Document document) + *
- createDocument(String parent, Document document) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createDocumentCallable() + *
+ * + *GetDocument + *+ * Gets a document. Returns NOT_FOUND if the document does not exist.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getDocument(GetDocumentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getDocument(DocumentName name) + *
- getDocument(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.
+ *+ *
+ *- getDocumentCallable() + *
+ * + *UpdateDocument + *+ * Updates a document. Returns INVALID_ARGUMENT if the name of the document is non-empty and does not equal the existing name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateDocument(UpdateDocumentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateDocument(DocumentName name, Document document) + *
- updateDocument(String name, Document document) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateDocumentCallable() + *
+ * + *DeleteDocument + *+ * Deletes a document. Returns NOT_FOUND if the document does not exist.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteDocument(DeleteDocumentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteDocument(DocumentName name) + *
- deleteDocument(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.
+ *+ *
+ *- deleteDocumentCallable() + *
+ * + *SearchDocuments + *+ * Searches for documents using provided [SearchDocumentsRequest][google.cloud.contentwarehouse.v1.SearchDocumentsRequest]. This call only returns documents that the caller has permission to search against.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- searchDocuments(SearchDocumentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- searchDocuments(LocationName parent) + *
- searchDocuments(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.
+ *+ *
+ *- searchDocumentsPagedCallable() + *
- searchDocumentsCallable() + *
+ * + *LockDocument + *+ * Lock the document so the document cannot be updated by other users.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- lockDocument(LockDocumentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- lockDocument(DocumentName name) + *
- lockDocument(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.
+ *+ *
+ *- lockDocumentCallable() + *
+ * + *FetchAcl + *+ * Gets the access control policy for a resource. Returns NOT_FOUND error if the resource does not exist. Returns an empty policy if the resource exists but does not have a policy set.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- fetchAcl(FetchAclRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- fetchAcl(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.
+ *+ *
+ *- fetchAclCallable() + *
+ * + * + *SetAcl + *+ * Sets the access control policy for a resource. Replaces any existing policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setAcl(SetAclRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setAcl(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.
+ *+ *
+ *- setAclCallable() + *
See the individual methods for example code. * diff --git a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/PipelineServiceClient.java b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/PipelineServiceClient.java index b1c5264a95df..ae64844c87ee 100644 --- a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/PipelineServiceClient.java +++ b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/PipelineServiceClient.java @@ -52,19 +52,33 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + * + *RunPipeline + *+ * Run a predefined pipeline.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- runPipelineAsync(RunPipelineRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- runPipelineAsync(LocationName name) + *
- runPipelineAsync(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.
+ *+ *
+ *- runPipelineOperationCallable() + *
- runPipelineCallable() + *
See the individual methods for example code. * diff --git a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/RuleSetServiceClient.java b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/RuleSetServiceClient.java index 789142d15e2f..a6ca0fff9478 100644 --- a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/RuleSetServiceClient.java +++ b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/RuleSetServiceClient.java @@ -56,19 +56,109 @@ *
Note: close() needs to be called on the RuleSetServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateRuleSet + *+ * Creates a ruleset.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createRuleSet(CreateRuleSetRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createRuleSet(LocationName parent, RuleSet ruleSet) + *
- createRuleSet(String parent, RuleSet ruleSet) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createRuleSetCallable() + *
+ * + *GetRuleSet + *+ * Gets a ruleset. Returns NOT_FOUND if the ruleset does not exist.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getRuleSet(GetRuleSetRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getRuleSet(RuleSetName name) + *
- getRuleSet(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.
+ *+ *
+ *- getRuleSetCallable() + *
+ * + *UpdateRuleSet + *+ * Updates a ruleset. Returns INVALID_ARGUMENT if the name of the ruleset is non-empty and does not equal the existing name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateRuleSet(UpdateRuleSetRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateRuleSet(RuleSetName name, RuleSet ruleSet) + *
- updateRuleSet(String name, RuleSet ruleSet) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateRuleSetCallable() + *
+ * + *DeleteRuleSet + *+ * Deletes a ruleset. Returns NOT_FOUND if the document does not exist.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteRuleSet(DeleteRuleSetRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteRuleSet(RuleSetName name) + *
- deleteRuleSet(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.
+ *+ *
+ *- deleteRuleSetCallable() + *
+ * + * + *ListRuleSets + *+ * Lists rulesets.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listRuleSets(ListRuleSetsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listRuleSets(LocationName parent) + *
- listRuleSets(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.
+ *+ *
+ *- listRuleSetsPagedCallable() + *
- listRuleSetsCallable() + *
See the individual methods for example code. * diff --git a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/SynonymSetServiceClient.java b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/SynonymSetServiceClient.java index 65d0c611e2d3..2db409ca3755 100644 --- a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/SynonymSetServiceClient.java +++ b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/SynonymSetServiceClient.java @@ -57,19 +57,109 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateSynonymSet + *+ * Creates a SynonymSet for a single context. Throws an ALREADY_EXISTS exception if a synonymset already exists for the context.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createSynonymSet(CreateSynonymSetRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createSynonymSet(LocationName parent, SynonymSet synonymSet) + *
- createSynonymSet(String parent, SynonymSet synonymSet) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createSynonymSetCallable() + *
+ * + *GetSynonymSet + *+ * Gets a SynonymSet for a particular context. Throws a NOT_FOUND exception if the Synonymset does not exist
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getSynonymSet(GetSynonymSetRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getSynonymSet(SynonymSetName name) + *
- getSynonymSet(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.
+ *+ *
+ *- getSynonymSetCallable() + *
+ * + *UpdateSynonymSet + *+ * Remove the existing SynonymSet for the context and replaces it with a new one. Throws a NOT_FOUND exception if the SynonymSet is not found.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateSynonymSet(UpdateSynonymSetRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateSynonymSet(SynonymSetName name, SynonymSet synonymSet) + *
- updateSynonymSet(String name, SynonymSet synonymSet) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateSynonymSetCallable() + *
+ * + *DeleteSynonymSet + *+ * Deletes a SynonymSet for a given context. Throws a NOT_FOUND exception if the SynonymSet is not found.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteSynonymSet(DeleteSynonymSetRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteSynonymSet(SynonymSetName name) + *
- deleteSynonymSet(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.
+ *+ *
+ *- deleteSynonymSetCallable() + *
+ * + * + *ListSynonymSets + *+ * Returns all SynonymSets (for all contexts) for the specified location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listSynonymSets(ListSynonymSetsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listSynonymSets(LocationName parent) + *
- listSynonymSets(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.
+ *+ *
+ *- listSynonymSetsPagedCallable() + *
- listSynonymSetsCallable() + *
See the individual methods for example code. * diff --git a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/DocumentLinkServiceStubSettings.java b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/DocumentLinkServiceStubSettings.java index 8b62248483b7..7b7b727a3a48 100644 --- a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/DocumentLinkServiceStubSettings.java +++ b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/DocumentLinkServiceStubSettings.java @@ -214,6 +214,12 @@ public DocumentLinkServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "contentwarehouse"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/DocumentSchemaServiceStubSettings.java b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/DocumentSchemaServiceStubSettings.java index b1af2d442530..b660921c05da 100644 --- a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/DocumentSchemaServiceStubSettings.java +++ b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/DocumentSchemaServiceStubSettings.java @@ -223,6 +223,12 @@ public DocumentSchemaServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "contentwarehouse"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/DocumentServiceStubSettings.java b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/DocumentServiceStubSettings.java index bcac708b0e86..fe23085e05a2 100644 --- a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/DocumentServiceStubSettings.java +++ b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/DocumentServiceStubSettings.java @@ -247,6 +247,12 @@ public DocumentServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "contentwarehouse"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/PipelineServiceStubSettings.java b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/PipelineServiceStubSettings.java index f0ad8309f1a5..3586e22fcc3e 100644 --- a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/PipelineServiceStubSettings.java +++ b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/PipelineServiceStubSettings.java @@ -126,6 +126,12 @@ public PipelineServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "contentwarehouse"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/RuleSetServiceStubSettings.java b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/RuleSetServiceStubSettings.java index 32800f205d73..5cdc1813105b 100644 --- a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/RuleSetServiceStubSettings.java +++ b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/RuleSetServiceStubSettings.java @@ -207,6 +207,12 @@ public RuleSetServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "contentwarehouse"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/SynonymSetServiceStubSettings.java b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/SynonymSetServiceStubSettings.java index 5aba653fe9e6..6962d155516b 100644 --- a/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/SynonymSetServiceStubSettings.java +++ b/java-contentwarehouse/google-cloud-contentwarehouse/src/main/java/com/google/cloud/contentwarehouse/v1/stub/SynonymSetServiceStubSettings.java @@ -212,6 +212,12 @@ public SynonymSetServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "contentwarehouse"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-data-fusion/README.md b/java-data-fusion/README.md index 0115e16ff61a..da8ba6aecc71 100644 --- a/java-data-fusion/README.md +++ b/java-data-fusion/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-data-fusion.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-data-fusion/1.30.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-data-fusion/1.32.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-data-fusion/google-cloud-data-fusion/src/main/java/com/google/cloud/datafusion/v1/DataFusionClient.java b/java-data-fusion/google-cloud-data-fusion/src/main/java/com/google/cloud/datafusion/v1/DataFusionClient.java index 0e11f8f25d90..4c94937e9684 100644 --- a/java-data-fusion/google-cloud-data-fusion/src/main/java/com/google/cloud/datafusion/v1/DataFusionClient.java +++ b/java-data-fusion/google-cloud-data-fusion/src/main/java/com/google/cloud/datafusion/v1/DataFusionClient.java @@ -65,19 +65,136 @@ *
Note: close() needs to be called on the DataFusionClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListAvailableVersions + *+ * Lists possible versions for Data Fusion instances in the specified project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listAvailableVersions(ListAvailableVersionsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listAvailableVersions(LocationName parent) + *
- listAvailableVersions(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.
+ *+ *
+ *- listAvailableVersionsPagedCallable() + *
- listAvailableVersionsCallable() + *
+ * + *ListInstances + *+ * Lists Data Fusion instances in the specified project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listInstances(ListInstancesRequest request) + *
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() + *
+ * + *GetInstance + *+ * Gets details of a single Data Fusion instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getInstance(GetInstanceRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getInstanceCallable() + *
+ * + *CreateInstance + *+ * Creates a new Data Fusion instance in the specified project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
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() + *
+ * + *DeleteInstance + *+ * Deletes a single Date Fusion instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
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() + *
+ * + *UpdateInstance + *+ * Updates a single Data Fusion instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(Instance instance, 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.
+ *+ *
+ *- updateInstanceOperationCallable() + *
- updateInstanceCallable() + *
+ * + * + *RestartInstance + *+ * Restart a single Data Fusion instance. At the end of an operation instance is fully restarted.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- restartInstanceAsync(RestartInstanceRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- restartInstanceOperationCallable() + *
- restartInstanceCallable() + *
See the individual methods for example code. * diff --git a/java-data-fusion/google-cloud-data-fusion/src/main/java/com/google/cloud/datafusion/v1/stub/DataFusionStubSettings.java b/java-data-fusion/google-cloud-data-fusion/src/main/java/com/google/cloud/datafusion/v1/stub/DataFusionStubSettings.java index ed2aadf61bb1..81be807133d7 100644 --- a/java-data-fusion/google-cloud-data-fusion/src/main/java/com/google/cloud/datafusion/v1/stub/DataFusionStubSettings.java +++ b/java-data-fusion/google-cloud-data-fusion/src/main/java/com/google/cloud/datafusion/v1/stub/DataFusionStubSettings.java @@ -331,6 +331,12 @@ public DataFusionStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "datafusion"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-data-fusion/google-cloud-data-fusion/src/main/java/com/google/cloud/datafusion/v1beta1/DataFusionClient.java b/java-data-fusion/google-cloud-data-fusion/src/main/java/com/google/cloud/datafusion/v1beta1/DataFusionClient.java index c1ce39f972a6..1bb65afec57d 100644 --- a/java-data-fusion/google-cloud-data-fusion/src/main/java/com/google/cloud/datafusion/v1beta1/DataFusionClient.java +++ b/java-data-fusion/google-cloud-data-fusion/src/main/java/com/google/cloud/datafusion/v1beta1/DataFusionClient.java @@ -65,19 +65,243 @@ *
Note: close() needs to be called on the DataFusionClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListAvailableVersions + *+ * Lists possible versions for Data Fusion instances in the specified project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listAvailableVersions(ListAvailableVersionsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listAvailableVersions(LocationName parent) + *
- listAvailableVersions(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.
+ *+ *
+ *- listAvailableVersionsPagedCallable() + *
- listAvailableVersionsCallable() + *
+ * + *ListInstances + *+ * Lists Data Fusion instances in the specified project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listInstances(ListInstancesRequest request) + *
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() + *
+ * + *GetInstance + *+ * Gets details of a single Data Fusion instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getInstance(GetInstanceRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getInstanceCallable() + *
+ * + *CreateInstance + *+ * Creates a new Data Fusion instance in the specified project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
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() + *
+ * + *DeleteInstance + *+ * Deletes a single Data Fusion instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
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() + *
+ * + *UpdateInstance + *+ * Updates a single Data Fusion instance.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(Instance instance, 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.
+ *+ *
+ *- updateInstanceOperationCallable() + *
- updateInstanceCallable() + *
+ * + *RestartInstance + *+ * Restart a single Data Fusion instance. At the end of an operation instance is fully restarted.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- restartInstanceAsync(RestartInstanceRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- restartInstanceOperationCallable() + *
- restartInstanceCallable() + *
+ * + *UpgradeInstance + *+ * Upgrade a single Data Fusion instance. At the end of an operation instance is fully upgraded.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- upgradeInstanceAsync(UpgradeInstanceRequest request) + *
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() + *
+ * + *RemoveIamPolicy + *+ * Remove IAM policy that is currently set on the given resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeIamPolicy(RemoveIamPolicyRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeIamPolicyCallable() + *
+ * + *ListNamespaces + *+ * List namespaces in a given instance
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listNamespaces(ListNamespacesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listNamespaces(InstanceName parent) + *
- listNamespaces(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.
+ *+ *
+ *- listNamespacesPagedCallable() + *
- listNamespacesCallable() + *
+ * + *AddDnsPeering + *+ * Add DNS peering on the given resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- addDnsPeering(AddDnsPeeringRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- addDnsPeering(InstanceName parent) + *
- addDnsPeering(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.
+ *+ *
+ *- addDnsPeeringCallable() + *
+ * + *RemoveDnsPeering + *+ * Remove DNS peering on the given resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeDnsPeering(RemoveDnsPeeringRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- removeDnsPeering(InstanceName parent) + *
- removeDnsPeering(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.
+ *+ *
+ *- removeDnsPeeringCallable() + *
+ * + * + *ListDnsPeerings + *+ * List DNS peering for a given resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listDnsPeerings(ListDnsPeeringsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listDnsPeerings(InstanceName parent) + *
- listDnsPeerings(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.
+ *+ *
+ *- listDnsPeeringsPagedCallable() + *
- listDnsPeeringsCallable() + *
See the individual methods for example code. * diff --git a/java-data-fusion/google-cloud-data-fusion/src/main/java/com/google/cloud/datafusion/v1beta1/stub/DataFusionStubSettings.java b/java-data-fusion/google-cloud-data-fusion/src/main/java/com/google/cloud/datafusion/v1beta1/stub/DataFusionStubSettings.java index 73b1b60c70ca..9c58790a7e4c 100644 --- a/java-data-fusion/google-cloud-data-fusion/src/main/java/com/google/cloud/datafusion/v1beta1/stub/DataFusionStubSettings.java +++ b/java-data-fusion/google-cloud-data-fusion/src/main/java/com/google/cloud/datafusion/v1beta1/stub/DataFusionStubSettings.java @@ -514,6 +514,12 @@ public DataFusionStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "datafusion"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataflow/README.md b/java-dataflow/README.md index 288be12489dd..6bb2c4c53781 100644 --- a/java-dataflow/README.md +++ b/java-dataflow/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-dataflow.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-dataflow/0.34.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-dataflow/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-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/FlexTemplatesServiceClient.java b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/FlexTemplatesServiceClient.java index a850c41e1923..eb161b412a0e 100644 --- a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/FlexTemplatesServiceClient.java +++ b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/FlexTemplatesServiceClient.java @@ -55,19 +55,27 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + * + *LaunchFlexTemplate + *+ * Launch a job with a FlexTemplate.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- launchFlexTemplate(LaunchFlexTemplateRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- launchFlexTemplateCallable() + *
See the individual methods for example code. * diff --git a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/JobsV1Beta3Client.java b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/JobsV1Beta3Client.java index a47bf1ce389f..2b17750ffee7 100644 --- a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/JobsV1Beta3Client.java +++ b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/JobsV1Beta3Client.java @@ -63,19 +63,117 @@ *
Note: close() needs to be called on the JobsV1Beta3Client object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateJob + *+ * Creates a Cloud Dataflow job. + *
To create a job, we recommend using `projects.locations.jobs.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.create` is not recommended, as your job will always start in `us-central1`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createJob(CreateJobRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createJobCallable() + *
+ * + *GetJob + *+ * Gets the state of the specified Cloud Dataflow job. + *
To get the state of a job, we recommend using `projects.locations.jobs.get` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.get` is not recommended, as you can only get the state of jobs that are running in `us-central1`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getJob(GetJobRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getJobCallable() + *
+ * + *UpdateJob + *+ * Updates the state of an existing Cloud Dataflow job. + *
To update the state of an existing job, we recommend using `projects.locations.jobs.update` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.update` is not recommended, as you can only update the state of jobs that are running in `us-central1`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateJob(UpdateJobRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateJobCallable() + *
+ * + *ListJobs + *+ * List the jobs of a project. + *
To list the jobs of a project in a region, we recommend using `projects.locations.jobs.list` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). To list the all jobs across all regions, use `projects.jobs.aggregated`. Using `projects.jobs.list` is not recommended, as you can only get the list of jobs that are running in `us-central1`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listJobs(ListJobsRequest request) + *
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() + *
+ * + *AggregatedListJobs + *+ * List the jobs of a project across all regions.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- aggregatedListJobs(ListJobsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- aggregatedListJobsPagedCallable() + *
- aggregatedListJobsCallable() + *
+ * + *CheckActiveJobs + *+ * Check for existence of active jobs in the given project across all regions.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- checkActiveJobs(CheckActiveJobsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- checkActiveJobsCallable() + *
+ * + * + *SnapshotJob + *+ * Snapshot the state of a streaming job.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- snapshotJob(SnapshotJobRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- snapshotJobCallable() + *
See the individual methods for example code. * diff --git a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/MessagesV1Beta3Client.java b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/MessagesV1Beta3Client.java index c6e3f8fce7e1..bd114718e64b 100644 --- a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/MessagesV1Beta3Client.java +++ b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/MessagesV1Beta3Client.java @@ -69,19 +69,29 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + * + *ListJobMessages + *+ * Request the job status. + *
To request the status of a job, we recommend using `projects.locations.jobs.messages.list` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.messages.list` is not recommended, as you can only request the status of jobs that are running in `us-central1`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listJobMessages(ListJobMessagesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listJobMessagesPagedCallable() + *
- listJobMessagesCallable() + *
See the individual methods for example code. * diff --git a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/MetricsV1Beta3Client.java b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/MetricsV1Beta3Client.java index 20d93e1a9510..28ca90fb4a15 100644 --- a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/MetricsV1Beta3Client.java +++ b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/MetricsV1Beta3Client.java @@ -61,19 +61,60 @@ *
Note: close() needs to be called on the MetricsV1Beta3Client object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *GetJobMetrics + *+ * Request the job status. + *
To request the status of a job, we recommend using `projects.locations.jobs.getMetrics` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.getMetrics` is not recommended, as you can only request the status of jobs that are running in `us-central1`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getJobMetrics(GetJobMetricsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getJobMetricsCallable() + *
+ * + *GetJobExecutionDetails + *+ * Request detailed information about the execution status of the job. + *
EXPERIMENTAL. This API is subject to change or removal without notice.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getJobExecutionDetails(GetJobExecutionDetailsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getJobExecutionDetailsPagedCallable() + *
- getJobExecutionDetailsCallable() + *
+ * + * + *GetStageExecutionDetails + *+ * Request detailed information about the execution status of a stage of the job. + *
EXPERIMENTAL. This API is subject to change or removal without notice.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getStageExecutionDetails(GetStageExecutionDetailsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getStageExecutionDetailsPagedCallable() + *
- getStageExecutionDetailsCallable() + *
See the individual methods for example code. * diff --git a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/SnapshotsV1Beta3Client.java b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/SnapshotsV1Beta3Client.java index afdbe854bbcb..90b798c1b833 100644 --- a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/SnapshotsV1Beta3Client.java +++ b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/SnapshotsV1Beta3Client.java @@ -53,19 +53,55 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *GetSnapshot + *+ * Gets information about a snapshot.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getSnapshot(GetSnapshotRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getSnapshotCallable() + *
+ * + *DeleteSnapshot + *+ * Deletes a snapshot.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteSnapshot(DeleteSnapshotRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteSnapshotCallable() + *
+ * + * + *ListSnapshots + *+ * Lists snapshots.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listSnapshots(ListSnapshotsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listSnapshotsCallable() + *
See the individual methods for example code. * diff --git a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/TemplatesServiceClient.java b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/TemplatesServiceClient.java index 89dc7b24e74b..90c89fbeba52 100644 --- a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/TemplatesServiceClient.java +++ b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/TemplatesServiceClient.java @@ -55,19 +55,55 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateJobFromTemplate + *+ * Creates a Cloud Dataflow job from a template.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createJobFromTemplate(CreateJobFromTemplateRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createJobFromTemplateCallable() + *
+ * + *LaunchTemplate + *+ * Launch a template.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- launchTemplate(LaunchTemplateRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- launchTemplateCallable() + *
+ * + * + *GetTemplate + *+ * Get the template associated with a template.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getTemplate(GetTemplateRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getTemplateCallable() + *
See the individual methods for example code. * diff --git a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/FlexTemplatesServiceStubSettings.java b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/FlexTemplatesServiceStubSettings.java index 1e8728d53d5e..e23bee21f845 100644 --- a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/FlexTemplatesServiceStubSettings.java +++ b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/FlexTemplatesServiceStubSettings.java @@ -120,6 +120,12 @@ public FlexTemplatesServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/JobsV1Beta3StubSettings.java b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/JobsV1Beta3StubSettings.java index 6f570a253b40..ec691a7625f0 100644 --- a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/JobsV1Beta3StubSettings.java +++ b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/JobsV1Beta3StubSettings.java @@ -284,6 +284,12 @@ public JobsV1Beta3Stub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/MessagesV1Beta3StubSettings.java b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/MessagesV1Beta3StubSettings.java index f025023bf565..7fcf791ce8e0 100644 --- a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/MessagesV1Beta3StubSettings.java +++ b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/MessagesV1Beta3StubSettings.java @@ -187,6 +187,12 @@ public MessagesV1Beta3Stub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/MetricsV1Beta3StubSettings.java b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/MetricsV1Beta3StubSettings.java index cb9b7e55854f..7a4b39905c7c 100644 --- a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/MetricsV1Beta3StubSettings.java +++ b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/MetricsV1Beta3StubSettings.java @@ -287,6 +287,12 @@ public MetricsV1Beta3Stub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/SnapshotsV1Beta3StubSettings.java b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/SnapshotsV1Beta3StubSettings.java index 6a9e701cc44c..b0a3ffbf80e9 100644 --- a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/SnapshotsV1Beta3StubSettings.java +++ b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/SnapshotsV1Beta3StubSettings.java @@ -135,6 +135,12 @@ public SnapshotsV1Beta3Stub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/TemplatesServiceStubSettings.java b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/TemplatesServiceStubSettings.java index 2bfed0e89d46..0c865fedb9f8 100644 --- a/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/TemplatesServiceStubSettings.java +++ b/java-dataflow/google-cloud-dataflow/src/main/java/com/google/dataflow/v1beta3/stub/TemplatesServiceStubSettings.java @@ -134,6 +134,12 @@ public TemplatesServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataform/README.md b/java-dataform/README.md index 077237bb60ee..30fb72505ac4 100644 --- a/java-dataform/README.md +++ b/java-dataform/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-dataform.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-dataform/0.29.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-dataform/0.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-dataform/google-cloud-dataform/src/main/java/com/google/cloud/dataform/v1alpha2/DataformClient.java b/java-dataform/google-cloud-dataform/src/main/java/com/google/cloud/dataform/v1alpha2/DataformClient.java index 280501153501..c8dcbeb2359b 100644 --- a/java-dataform/google-cloud-dataform/src/main/java/com/google/cloud/dataform/v1alpha2/DataformClient.java +++ b/java-dataform/google-cloud-dataform/src/main/java/com/google/cloud/dataform/v1alpha2/DataformClient.java @@ -67,19 +67,676 @@ *
Note: close() needs to be called on the DataformClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListRepositories + *+ * Lists Repositories in a given project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
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() + *
+ * + *GetRepository + *+ * Fetches a single Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getRepositoryCallable() + *
+ * + *CreateRepository + *+ * Creates a new Repository in a given project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createRepository(CreateRepositoryRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createRepository(LocationName parent, Repository repository, String repositoryId) + *
- createRepository(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.
+ *+ *
+ *- createRepositoryCallable() + *
+ * + *UpdateRepository + *+ * Updates a single Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateRepository(UpdateRepositoryRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateRepository(Repository repository, 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.
+ *+ *
+ *- updateRepositoryCallable() + *
+ * + *DeleteRepository + *+ * Deletes a single Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteRepository(DeleteRepositoryRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteRepository(RepositoryName name) + *
- deleteRepository(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.
+ *+ *
+ *- deleteRepositoryCallable() + *
+ * + *FetchRemoteBranches + *+ * Fetches a Repository's remote branches.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- fetchRemoteBranches(FetchRemoteBranchesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- fetchRemoteBranchesCallable() + *
+ * + *ListWorkspaces + *+ * Lists Workspaces in a given Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listWorkspaces(ListWorkspacesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listWorkspaces(RepositoryName parent) + *
- listWorkspaces(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.
+ *+ *
+ *- listWorkspacesPagedCallable() + *
- listWorkspacesCallable() + *
+ * + *GetWorkspace + *+ * Fetches a single Workspace.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getWorkspace(GetWorkspaceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getWorkspace(WorkspaceName name) + *
- getWorkspace(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.
+ *+ *
+ *- getWorkspaceCallable() + *
+ * + *CreateWorkspace + *+ * Creates a new Workspace in a given Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createWorkspace(CreateWorkspaceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createWorkspace(RepositoryName parent, Workspace workspace, String workspaceId) + *
- createWorkspace(String parent, Workspace workspace, String workspaceId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createWorkspaceCallable() + *
+ * + *DeleteWorkspace + *+ * Deletes a single Workspace.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteWorkspace(DeleteWorkspaceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteWorkspace(WorkspaceName name) + *
- deleteWorkspace(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.
+ *+ *
+ *- deleteWorkspaceCallable() + *
+ * + *InstallNpmPackages + *+ * Installs dependency NPM packages (inside a Workspace).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- installNpmPackages(InstallNpmPackagesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- installNpmPackagesCallable() + *
+ * + *PullGitCommits + *+ * Pulls Git commits from the Repository's remote into a Workspace.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- pullGitCommits(PullGitCommitsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- pullGitCommitsCallable() + *
+ * + *PushGitCommits + *+ * Pushes Git commits from a Workspace to the Repository's remote.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- pushGitCommits(PushGitCommitsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- pushGitCommitsCallable() + *
+ * + *FetchFileGitStatuses + *+ * Fetches Git statuses for the files in a Workspace.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- fetchFileGitStatuses(FetchFileGitStatusesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- fetchFileGitStatusesCallable() + *
+ * + *FetchGitAheadBehind + *+ * Fetches Git ahead/behind against a remote branch.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- fetchGitAheadBehind(FetchGitAheadBehindRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- fetchGitAheadBehindCallable() + *
+ * + *CommitWorkspaceChanges + *+ * Applies a Git commit for uncommitted files in a Workspace.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- commitWorkspaceChanges(CommitWorkspaceChangesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- commitWorkspaceChangesCallable() + *
+ * + *ResetWorkspaceChanges + *+ * Performs a Git reset for uncommitted files in a Workspace.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- resetWorkspaceChanges(ResetWorkspaceChangesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- resetWorkspaceChangesCallable() + *
+ * + *FetchFileDiff + *+ * Fetches Git diff for an uncommitted file in a Workspace.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- fetchFileDiff(FetchFileDiffRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- fetchFileDiffCallable() + *
+ * + *QueryDirectoryContents + *+ * Returns the contents of a given Workspace directory.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- queryDirectoryContents(QueryDirectoryContentsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- queryDirectoryContentsPagedCallable() + *
- queryDirectoryContentsCallable() + *
+ * + *MakeDirectory + *+ * Creates a directory inside a Workspace.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- makeDirectory(MakeDirectoryRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- makeDirectoryCallable() + *
+ * + *RemoveDirectory + *+ * Deletes a directory (inside a Workspace) and all of its contents.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeDirectory(RemoveDirectoryRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeDirectoryCallable() + *
+ * + *MoveDirectory + *+ * Moves a directory (inside a Workspace), and all of its contents, to a new location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- moveDirectory(MoveDirectoryRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- moveDirectoryCallable() + *
+ * + *ReadFile + *+ * Returns the contents of a file (inside a Workspace).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- readFile(ReadFileRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- readFileCallable() + *
+ * + *RemoveFile + *+ * Deletes a file (inside a Workspace).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeFile(RemoveFileRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeFileCallable() + *
+ * + *MoveFile + *+ * Moves a file (inside a Workspace) to a new location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- moveFile(MoveFileRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- moveFileCallable() + *
+ * + *WriteFile + *+ * Writes to a file (inside a Workspace).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- writeFile(WriteFileRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- writeFileCallable() + *
+ * + *ListCompilationResults + *+ * Lists CompilationResults in a given Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listCompilationResults(ListCompilationResultsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listCompilationResults(RepositoryName parent) + *
- listCompilationResults(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.
+ *+ *
+ *- listCompilationResultsPagedCallable() + *
- listCompilationResultsCallable() + *
+ * + *GetCompilationResult + *+ * Fetches a single CompilationResult.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getCompilationResult(GetCompilationResultRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getCompilationResult(CompilationResultName name) + *
- getCompilationResult(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.
+ *+ *
+ *- getCompilationResultCallable() + *
+ * + *CreateCompilationResult + *+ * Creates a new CompilationResult in a given project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createCompilationResult(CreateCompilationResultRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createCompilationResult(RepositoryName parent, CompilationResult compilationResult) + *
- createCompilationResult(String parent, CompilationResult compilationResult) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createCompilationResultCallable() + *
+ * + *QueryCompilationResultActions + *+ * Returns CompilationResultActions in a given CompilationResult.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- queryCompilationResultActions(QueryCompilationResultActionsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- queryCompilationResultActionsPagedCallable() + *
- queryCompilationResultActionsCallable() + *
+ * + *ListWorkflowInvocations + *+ * Lists WorkflowInvocations in a given Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listWorkflowInvocations(ListWorkflowInvocationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listWorkflowInvocations(RepositoryName parent) + *
- listWorkflowInvocations(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.
+ *+ *
+ *- listWorkflowInvocationsPagedCallable() + *
- listWorkflowInvocationsCallable() + *
+ * + *GetWorkflowInvocation + *+ * Fetches a single WorkflowInvocation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getWorkflowInvocation(GetWorkflowInvocationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getWorkflowInvocation(WorkflowInvocationName name) + *
- getWorkflowInvocation(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.
+ *+ *
+ *- getWorkflowInvocationCallable() + *
+ * + *CreateWorkflowInvocation + *+ * Creates a new WorkflowInvocation in a given Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createWorkflowInvocation(CreateWorkflowInvocationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createWorkflowInvocation(RepositoryName parent, WorkflowInvocation workflowInvocation) + *
- createWorkflowInvocation(String parent, WorkflowInvocation workflowInvocation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createWorkflowInvocationCallable() + *
+ * + *DeleteWorkflowInvocation + *+ * Deletes a single WorkflowInvocation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteWorkflowInvocation(DeleteWorkflowInvocationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteWorkflowInvocation(WorkflowInvocationName name) + *
- deleteWorkflowInvocation(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.
+ *+ *
+ *- deleteWorkflowInvocationCallable() + *
+ * + *CancelWorkflowInvocation + *+ * Requests cancellation of a running WorkflowInvocation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- cancelWorkflowInvocation(CancelWorkflowInvocationRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- cancelWorkflowInvocationCallable() + *
+ * + *QueryWorkflowInvocationActions + *+ * Returns WorkflowInvocationActions in a given WorkflowInvocation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- queryWorkflowInvocationActions(QueryWorkflowInvocationActionsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- queryWorkflowInvocationActionsPagedCallable() + *
- queryWorkflowInvocationActionsCallable() + *
+ * + *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) + *
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() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getIamPolicyCallable() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-dataform/google-cloud-dataform/src/main/java/com/google/cloud/dataform/v1alpha2/stub/DataformStubSettings.java b/java-dataform/google-cloud-dataform/src/main/java/com/google/cloud/dataform/v1alpha2/stub/DataformStubSettings.java index ad5604997499..5a1b70c29904 100644 --- a/java-dataform/google-cloud-dataform/src/main/java/com/google/cloud/dataform/v1alpha2/stub/DataformStubSettings.java +++ b/java-dataform/google-cloud-dataform/src/main/java/com/google/cloud/dataform/v1alpha2/stub/DataformStubSettings.java @@ -1055,6 +1055,12 @@ public DataformStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataform"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataform/google-cloud-dataform/src/main/java/com/google/cloud/dataform/v1beta1/DataformClient.java b/java-dataform/google-cloud-dataform/src/main/java/com/google/cloud/dataform/v1beta1/DataformClient.java index 23849fddadbe..0f71352e9be3 100644 --- a/java-dataform/google-cloud-dataform/src/main/java/com/google/cloud/dataform/v1beta1/DataformClient.java +++ b/java-dataform/google-cloud-dataform/src/main/java/com/google/cloud/dataform/v1beta1/DataformClient.java @@ -67,19 +67,938 @@ *
Note: close() needs to be called on the DataformClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListRepositories + *+ * Lists Repositories in a given project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
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() + *
+ * + *GetRepository + *+ * Fetches a single Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getRepositoryCallable() + *
+ * + *CreateRepository + *+ * Creates a new Repository in a given project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createRepository(CreateRepositoryRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createRepository(LocationName parent, Repository repository, String repositoryId) + *
- createRepository(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.
+ *+ *
+ *- createRepositoryCallable() + *
+ * + *UpdateRepository + *+ * Updates a single Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateRepository(UpdateRepositoryRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateRepository(Repository repository, 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.
+ *+ *
+ *- updateRepositoryCallable() + *
+ * + *DeleteRepository + *+ * Deletes a single Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteRepository(DeleteRepositoryRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteRepository(RepositoryName name) + *
- deleteRepository(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.
+ *+ *
+ *- deleteRepositoryCallable() + *
+ * + *CommitRepositoryChanges + *+ * Applies a Git commit to a Repository. The Repository must not have a value for `git_remote_settings.url`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- commitRepositoryChanges(CommitRepositoryChangesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- commitRepositoryChangesCallable() + *
+ * + *ReadRepositoryFile + *+ * Returns the contents of a file (inside a Repository). The Repository must not have a value for `git_remote_settings.url`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- readRepositoryFile(ReadRepositoryFileRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- readRepositoryFileCallable() + *
+ * + *QueryRepositoryDirectoryContents + *+ * Returns the contents of a given Repository directory. The Repository must not have a value for `git_remote_settings.url`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- queryRepositoryDirectoryContents(QueryRepositoryDirectoryContentsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- queryRepositoryDirectoryContentsPagedCallable() + *
- queryRepositoryDirectoryContentsCallable() + *
+ * + *FetchRepositoryHistory + *+ * Fetches a Repository's history of commits. The Repository must not have a value for `git_remote_settings.url`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- fetchRepositoryHistory(FetchRepositoryHistoryRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- fetchRepositoryHistoryPagedCallable() + *
- fetchRepositoryHistoryCallable() + *
+ * + *ComputeRepositoryAccessTokenStatus + *+ * Computes a Repository's Git access token status.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- computeRepositoryAccessTokenStatus(ComputeRepositoryAccessTokenStatusRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- computeRepositoryAccessTokenStatusCallable() + *
+ * + *FetchRemoteBranches + *+ * Fetches a Repository's remote branches.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- fetchRemoteBranches(FetchRemoteBranchesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- fetchRemoteBranchesCallable() + *
+ * + *ListWorkspaces + *+ * Lists Workspaces in a given Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listWorkspaces(ListWorkspacesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listWorkspaces(RepositoryName parent) + *
- listWorkspaces(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.
+ *+ *
+ *- listWorkspacesPagedCallable() + *
- listWorkspacesCallable() + *
+ * + *GetWorkspace + *+ * Fetches a single Workspace.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getWorkspace(GetWorkspaceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getWorkspace(WorkspaceName name) + *
- getWorkspace(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.
+ *+ *
+ *- getWorkspaceCallable() + *
+ * + *CreateWorkspace + *+ * Creates a new Workspace in a given Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createWorkspace(CreateWorkspaceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createWorkspace(RepositoryName parent, Workspace workspace, String workspaceId) + *
- createWorkspace(String parent, Workspace workspace, String workspaceId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createWorkspaceCallable() + *
+ * + *DeleteWorkspace + *+ * Deletes a single Workspace.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteWorkspace(DeleteWorkspaceRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteWorkspace(WorkspaceName name) + *
- deleteWorkspace(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.
+ *+ *
+ *- deleteWorkspaceCallable() + *
+ * + *InstallNpmPackages + *+ * Installs dependency NPM packages (inside a Workspace).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- installNpmPackages(InstallNpmPackagesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- installNpmPackagesCallable() + *
+ * + *PullGitCommits + *+ * Pulls Git commits from the Repository's remote into a Workspace.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- pullGitCommits(PullGitCommitsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- pullGitCommitsCallable() + *
+ * + *PushGitCommits + *+ * Pushes Git commits from a Workspace to the Repository's remote.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- pushGitCommits(PushGitCommitsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- pushGitCommitsCallable() + *
+ * + *FetchFileGitStatuses + *+ * Fetches Git statuses for the files in a Workspace.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- fetchFileGitStatuses(FetchFileGitStatusesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- fetchFileGitStatusesCallable() + *
+ * + *FetchGitAheadBehind + *+ * Fetches Git ahead/behind against a remote branch.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- fetchGitAheadBehind(FetchGitAheadBehindRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- fetchGitAheadBehindCallable() + *
+ * + *CommitWorkspaceChanges + *+ * Applies a Git commit for uncommitted files in a Workspace.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- commitWorkspaceChanges(CommitWorkspaceChangesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- commitWorkspaceChangesCallable() + *
+ * + *ResetWorkspaceChanges + *+ * Performs a Git reset for uncommitted files in a Workspace.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- resetWorkspaceChanges(ResetWorkspaceChangesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- resetWorkspaceChangesCallable() + *
+ * + *FetchFileDiff + *+ * Fetches Git diff for an uncommitted file in a Workspace.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- fetchFileDiff(FetchFileDiffRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- fetchFileDiffCallable() + *
+ * + *QueryDirectoryContents + *+ * Returns the contents of a given Workspace directory.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- queryDirectoryContents(QueryDirectoryContentsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- queryDirectoryContentsPagedCallable() + *
- queryDirectoryContentsCallable() + *
+ * + *MakeDirectory + *+ * Creates a directory inside a Workspace.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- makeDirectory(MakeDirectoryRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- makeDirectoryCallable() + *
+ * + *RemoveDirectory + *+ * Deletes a directory (inside a Workspace) and all of its contents.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeDirectory(RemoveDirectoryRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeDirectoryCallable() + *
+ * + *MoveDirectory + *+ * Moves a directory (inside a Workspace), and all of its contents, to a new location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- moveDirectory(MoveDirectoryRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- moveDirectoryCallable() + *
+ * + *ReadFile + *+ * Returns the contents of a file (inside a Workspace).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- readFile(ReadFileRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- readFileCallable() + *
+ * + *RemoveFile + *+ * Deletes a file (inside a Workspace).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeFile(RemoveFileRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeFileCallable() + *
+ * + *MoveFile + *+ * Moves a file (inside a Workspace) to a new location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- moveFile(MoveFileRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- moveFileCallable() + *
+ * + *WriteFile + *+ * Writes to a file (inside a Workspace).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- writeFile(WriteFileRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- writeFileCallable() + *
+ * + *ListReleaseConfigs + *+ * Lists ReleaseConfigs in a given Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listReleaseConfigs(ListReleaseConfigsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listReleaseConfigs(RepositoryName parent) + *
- listReleaseConfigs(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.
+ *+ *
+ *- listReleaseConfigsPagedCallable() + *
- listReleaseConfigsCallable() + *
+ * + *GetReleaseConfig + *+ * Fetches a single ReleaseConfig.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getReleaseConfig(GetReleaseConfigRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getReleaseConfig(ReleaseConfigName name) + *
- getReleaseConfig(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.
+ *+ *
+ *- getReleaseConfigCallable() + *
+ * + *CreateReleaseConfig + *+ * Creates a new ReleaseConfig in a given Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createReleaseConfig(CreateReleaseConfigRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createReleaseConfig(RepositoryName parent, ReleaseConfig releaseConfig, String releaseConfigId) + *
- createReleaseConfig(String parent, ReleaseConfig releaseConfig, String releaseConfigId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createReleaseConfigCallable() + *
+ * + *UpdateReleaseConfig + *+ * Updates a single ReleaseConfig.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateReleaseConfig(UpdateReleaseConfigRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateReleaseConfig(ReleaseConfig releaseConfig, 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.
+ *+ *
+ *- updateReleaseConfigCallable() + *
+ * + *DeleteReleaseConfig + *+ * Deletes a single ReleaseConfig.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteReleaseConfig(DeleteReleaseConfigRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteReleaseConfig(ReleaseConfigName name) + *
- deleteReleaseConfig(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.
+ *+ *
+ *- deleteReleaseConfigCallable() + *
+ * + *ListCompilationResults + *+ * Lists CompilationResults in a given Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listCompilationResults(ListCompilationResultsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listCompilationResults(RepositoryName parent) + *
- listCompilationResults(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.
+ *+ *
+ *- listCompilationResultsPagedCallable() + *
- listCompilationResultsCallable() + *
+ * + *GetCompilationResult + *+ * Fetches a single CompilationResult.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getCompilationResult(GetCompilationResultRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getCompilationResult(CompilationResultName name) + *
- getCompilationResult(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.
+ *+ *
+ *- getCompilationResultCallable() + *
+ * + *CreateCompilationResult + *+ * Creates a new CompilationResult in a given project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createCompilationResult(CreateCompilationResultRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createCompilationResult(RepositoryName parent, CompilationResult compilationResult) + *
- createCompilationResult(String parent, CompilationResult compilationResult) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createCompilationResultCallable() + *
+ * + *QueryCompilationResultActions + *+ * Returns CompilationResultActions in a given CompilationResult.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- queryCompilationResultActions(QueryCompilationResultActionsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- queryCompilationResultActionsPagedCallable() + *
- queryCompilationResultActionsCallable() + *
+ * + *ListWorkflowConfigs + *+ * Lists WorkflowConfigs in a given Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listWorkflowConfigs(ListWorkflowConfigsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listWorkflowConfigs(RepositoryName parent) + *
- listWorkflowConfigs(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.
+ *+ *
+ *- listWorkflowConfigsPagedCallable() + *
- listWorkflowConfigsCallable() + *
+ * + *GetWorkflowConfig + *+ * Fetches a single WorkflowConfig.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getWorkflowConfig(GetWorkflowConfigRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getWorkflowConfig(WorkflowConfigName name) + *
- getWorkflowConfig(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.
+ *+ *
+ *- getWorkflowConfigCallable() + *
+ * + *CreateWorkflowConfig + *+ * Creates a new WorkflowConfig in a given Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createWorkflowConfig(CreateWorkflowConfigRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createWorkflowConfig(RepositoryName parent, WorkflowConfig workflowConfig, String workflowConfigId) + *
- createWorkflowConfig(String parent, WorkflowConfig workflowConfig, String workflowConfigId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createWorkflowConfigCallable() + *
+ * + *UpdateWorkflowConfig + *+ * Updates a single WorkflowConfig.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateWorkflowConfig(UpdateWorkflowConfigRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateWorkflowConfig(WorkflowConfig workflowConfig, 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.
+ *+ *
+ *- updateWorkflowConfigCallable() + *
+ * + *DeleteWorkflowConfig + *+ * Deletes a single WorkflowConfig.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteWorkflowConfig(DeleteWorkflowConfigRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteWorkflowConfig(WorkflowConfigName name) + *
- deleteWorkflowConfig(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.
+ *+ *
+ *- deleteWorkflowConfigCallable() + *
+ * + *ListWorkflowInvocations + *+ * Lists WorkflowInvocations in a given Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listWorkflowInvocations(ListWorkflowInvocationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listWorkflowInvocations(RepositoryName parent) + *
- listWorkflowInvocations(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.
+ *+ *
+ *- listWorkflowInvocationsPagedCallable() + *
- listWorkflowInvocationsCallable() + *
+ * + *GetWorkflowInvocation + *+ * Fetches a single WorkflowInvocation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getWorkflowInvocation(GetWorkflowInvocationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getWorkflowInvocation(WorkflowInvocationName name) + *
- getWorkflowInvocation(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.
+ *+ *
+ *- getWorkflowInvocationCallable() + *
+ * + *CreateWorkflowInvocation + *+ * Creates a new WorkflowInvocation in a given Repository.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createWorkflowInvocation(CreateWorkflowInvocationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createWorkflowInvocation(RepositoryName parent, WorkflowInvocation workflowInvocation) + *
- createWorkflowInvocation(String parent, WorkflowInvocation workflowInvocation) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createWorkflowInvocationCallable() + *
+ * + *DeleteWorkflowInvocation + *+ * Deletes a single WorkflowInvocation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteWorkflowInvocation(DeleteWorkflowInvocationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteWorkflowInvocation(WorkflowInvocationName name) + *
- deleteWorkflowInvocation(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.
+ *+ *
+ *- deleteWorkflowInvocationCallable() + *
+ * + *CancelWorkflowInvocation + *+ * Requests cancellation of a running WorkflowInvocation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- cancelWorkflowInvocation(CancelWorkflowInvocationRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- cancelWorkflowInvocationCallable() + *
+ * + *QueryWorkflowInvocationActions + *+ * Returns WorkflowInvocationActions in a given WorkflowInvocation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- queryWorkflowInvocationActions(QueryWorkflowInvocationActionsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- queryWorkflowInvocationActionsPagedCallable() + *
- queryWorkflowInvocationActionsCallable() + *
+ * + *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) + *
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() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getIamPolicyCallable() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-dataform/google-cloud-dataform/src/main/java/com/google/cloud/dataform/v1beta1/stub/DataformStubSettings.java b/java-dataform/google-cloud-dataform/src/main/java/com/google/cloud/dataform/v1beta1/stub/DataformStubSettings.java index 06a61dae74da..c18399352c33 100644 --- a/java-dataform/google-cloud-dataform/src/main/java/com/google/cloud/dataform/v1beta1/stub/DataformStubSettings.java +++ b/java-dataform/google-cloud-dataform/src/main/java/com/google/cloud/dataform/v1beta1/stub/DataformStubSettings.java @@ -1481,6 +1481,12 @@ public DataformStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataform"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-datalabeling/README.md b/java-datalabeling/README.md index c9cdd2532825..78f76280db04 100644 --- a/java-datalabeling/README.md +++ b/java-datalabeling/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-datalabeling.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-datalabeling/0.150.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-datalabeling/0.152.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-datalabeling/google-cloud-datalabeling/src/main/java/com/google/cloud/datalabeling/v1beta1/DataLabelingServiceClient.java b/java-datalabeling/google-cloud-datalabeling/src/main/java/com/google/cloud/datalabeling/v1beta1/DataLabelingServiceClient.java index 1ef7d4820d14..4adc86c49e04 100644 --- a/java-datalabeling/google-cloud-datalabeling/src/main/java/com/google/cloud/datalabeling/v1beta1/DataLabelingServiceClient.java +++ b/java-datalabeling/google-cloud-datalabeling/src/main/java/com/google/cloud/datalabeling/v1beta1/DataLabelingServiceClient.java @@ -63,19 +63,671 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateDataset + *+ * Creates dataset. If success return a Dataset resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createDataset(CreateDatasetRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createDataset(ProjectName parent, Dataset dataset) + *
- createDataset(String parent, Dataset dataset) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createDatasetCallable() + *
+ * + *GetDataset + *+ * Gets dataset by resource name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getDataset(GetDatasetRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getDataset(DatasetName name) + *
- getDataset(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.
+ *+ *
+ *- getDatasetCallable() + *
+ * + *ListDatasets + *+ * Lists datasets under a project. Pagination is supported.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listDatasets(ListDatasetsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listDatasets(ProjectName parent, String filter) + *
- listDatasets(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.
+ *+ *
+ *- listDatasetsPagedCallable() + *
- listDatasetsCallable() + *
+ * + *DeleteDataset + *+ * Deletes a dataset by resource name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteDataset(DeleteDatasetRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteDataset(DatasetName name) + *
- deleteDataset(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.
+ *+ *
+ *- deleteDatasetCallable() + *
+ * + *ImportData + *+ * Imports data into dataset based on source locations defined in request. It can be called multiple times for the same dataset. Each dataset can only have one long running operation running on it. For example, no labeling task (also long running operation) can be started while importing is still ongoing. Vice versa.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- importDataAsync(ImportDataRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- importDataAsync(DatasetName name, InputConfig inputConfig) + *
- importDataAsync(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.
+ *+ *
+ *- importDataOperationCallable() + *
- importDataCallable() + *
+ * + *ExportData + *+ * Exports data and annotations from dataset.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- exportDataAsync(ExportDataRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- exportDataAsync(DatasetName name, AnnotatedDatasetName annotatedDataset, String filter, OutputConfig outputConfig) + *
- exportDataAsync(DatasetName name, String annotatedDataset, String filter, OutputConfig outputConfig) + *
- exportDataAsync(String name, AnnotatedDatasetName annotatedDataset, String filter, OutputConfig outputConfig) + *
- exportDataAsync(String name, String annotatedDataset, String filter, 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.
+ *+ *
+ *- exportDataOperationCallable() + *
- exportDataCallable() + *
+ * + *GetDataItem + *+ * Gets a data item in a dataset by resource name. This API can be called after data are imported into dataset.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getDataItem(GetDataItemRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getDataItem(DataItemName name) + *
- getDataItem(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.
+ *+ *
+ *- getDataItemCallable() + *
+ * + *ListDataItems + *+ * Lists data items in a dataset. This API can be called after data are imported into dataset. Pagination is supported.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listDataItems(ListDataItemsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listDataItems(DatasetName parent, String filter) + *
- listDataItems(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.
+ *+ *
+ *- listDataItemsPagedCallable() + *
- listDataItemsCallable() + *
+ * + *GetAnnotatedDataset + *+ * Gets an annotated dataset by resource name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getAnnotatedDataset(GetAnnotatedDatasetRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getAnnotatedDataset(AnnotatedDatasetName name) + *
- getAnnotatedDataset(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.
+ *+ *
+ *- getAnnotatedDatasetCallable() + *
+ * + *ListAnnotatedDatasets + *+ * Lists annotated datasets for a dataset. Pagination is supported.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listAnnotatedDatasets(ListAnnotatedDatasetsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listAnnotatedDatasets(DatasetName parent, String filter) + *
- listAnnotatedDatasets(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.
+ *+ *
+ *- listAnnotatedDatasetsPagedCallable() + *
- listAnnotatedDatasetsCallable() + *
+ * + *DeleteAnnotatedDataset + *+ * Deletes an annotated dataset by resource name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAnnotatedDataset(DeleteAnnotatedDatasetRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteAnnotatedDatasetCallable() + *
+ * + *LabelImage + *+ * Starts a labeling task for image. The type of image labeling task is configured by feature in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- labelImageAsync(LabelImageRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- labelImageAsync(DatasetName parent, HumanAnnotationConfig basicConfig, LabelImageRequest.Feature feature) + *
- labelImageAsync(String parent, HumanAnnotationConfig basicConfig, LabelImageRequest.Feature feature) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- labelImageOperationCallable() + *
- labelImageCallable() + *
+ * + *LabelVideo + *+ * Starts a labeling task for video. The type of video labeling task is configured by feature in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- labelVideoAsync(LabelVideoRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- labelVideoAsync(DatasetName parent, HumanAnnotationConfig basicConfig, LabelVideoRequest.Feature feature) + *
- labelVideoAsync(String parent, HumanAnnotationConfig basicConfig, LabelVideoRequest.Feature feature) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- labelVideoOperationCallable() + *
- labelVideoCallable() + *
+ * + *LabelText + *+ * Starts a labeling task for text. The type of text labeling task is configured by feature in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- labelTextAsync(LabelTextRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- labelTextAsync(DatasetName parent, HumanAnnotationConfig basicConfig, LabelTextRequest.Feature feature) + *
- labelTextAsync(String parent, HumanAnnotationConfig basicConfig, LabelTextRequest.Feature feature) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- labelTextOperationCallable() + *
- labelTextCallable() + *
+ * + *GetExample + *+ * Gets an example by resource name, including both data and annotation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getExample(GetExampleRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getExample(ExampleName name, String filter) + *
- getExample(String name, 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.
+ *+ *
+ *- getExampleCallable() + *
+ * + *ListExamples + *+ * Lists examples in an annotated dataset. Pagination is supported.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listExamples(ListExamplesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listExamples(AnnotatedDatasetName parent, String filter) + *
- listExamples(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.
+ *+ *
+ *- listExamplesPagedCallable() + *
- listExamplesCallable() + *
+ * + *CreateAnnotationSpecSet + *+ * Creates an annotation spec set by providing a set of labels.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createAnnotationSpecSet(CreateAnnotationSpecSetRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createAnnotationSpecSet(ProjectName parent, AnnotationSpecSet annotationSpecSet) + *
- createAnnotationSpecSet(String parent, AnnotationSpecSet annotationSpecSet) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createAnnotationSpecSetCallable() + *
+ * + *GetAnnotationSpecSet + *+ * Gets an annotation spec set by resource name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getAnnotationSpecSet(GetAnnotationSpecSetRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getAnnotationSpecSet(AnnotationSpecSetName name) + *
- getAnnotationSpecSet(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.
+ *+ *
+ *- getAnnotationSpecSetCallable() + *
+ * + *ListAnnotationSpecSets + *+ * Lists annotation spec sets for a project. Pagination is supported.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listAnnotationSpecSets(ListAnnotationSpecSetsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listAnnotationSpecSets(ProjectName parent, String filter) + *
- listAnnotationSpecSets(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.
+ *+ *
+ *- listAnnotationSpecSetsPagedCallable() + *
- listAnnotationSpecSetsCallable() + *
+ * + *DeleteAnnotationSpecSet + *+ * Deletes an annotation spec set by resource name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAnnotationSpecSet(DeleteAnnotationSpecSetRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteAnnotationSpecSet(AnnotationSpecSetName name) + *
- deleteAnnotationSpecSet(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.
+ *+ *
+ *- deleteAnnotationSpecSetCallable() + *
+ * + *CreateInstruction + *+ * Creates an instruction for how data should be labeled.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createInstructionAsync(CreateInstructionRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createInstructionAsync(ProjectName parent, Instruction instruction) + *
- createInstructionAsync(String parent, Instruction instruction) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createInstructionOperationCallable() + *
- createInstructionCallable() + *
+ * + *GetInstruction + *+ * Gets an instruction by resource name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getInstruction(GetInstructionRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getInstruction(InstructionName name) + *
- getInstruction(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.
+ *+ *
+ *- getInstructionCallable() + *
+ * + *ListInstructions + *+ * Lists instructions for a project. Pagination is supported.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listInstructions(ListInstructionsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listInstructions(ProjectName parent, String filter) + *
- listInstructions(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.
+ *+ *
+ *- listInstructionsPagedCallable() + *
- listInstructionsCallable() + *
+ * + *DeleteInstruction + *+ * Deletes an instruction object by resource name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteInstruction(DeleteInstructionRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteInstruction(InstructionName name) + *
- deleteInstruction(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.
+ *+ *
+ *- deleteInstructionCallable() + *
+ * + *GetEvaluation + *+ * Gets an evaluation by resource name (to search, use [projects.evaluations.search][google.cloud.datalabeling.v1beta1.DataLabelingService.SearchEvaluations]).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getEvaluation(GetEvaluationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getEvaluation(EvaluationName name) + *
- getEvaluation(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.
+ *+ *
+ *- getEvaluationCallable() + *
+ * + *SearchEvaluations + *+ * Searches [evaluations][google.cloud.datalabeling.v1beta1.Evaluation] within a project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- searchEvaluations(SearchEvaluationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- searchEvaluations(EvaluationName parent, String filter) + *
- searchEvaluations(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.
+ *+ *
+ *- searchEvaluationsPagedCallable() + *
- searchEvaluationsCallable() + *
+ * + *SearchExampleComparisons + *+ * Searches example comparisons from an evaluation. The return format is a list of example comparisons that show ground truth and prediction(s) for a single input. Search by providing an evaluation ID.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- searchExampleComparisons(SearchExampleComparisonsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- searchExampleComparisons(EvaluationName parent) + *
- searchExampleComparisons(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.
+ *+ *
+ *- searchExampleComparisonsPagedCallable() + *
- searchExampleComparisonsCallable() + *
+ * + *CreateEvaluationJob + *+ * Creates an evaluation job.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createEvaluationJob(CreateEvaluationJobRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createEvaluationJob(ProjectName parent, EvaluationJob job) + *
- createEvaluationJob(String parent, EvaluationJob job) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createEvaluationJobCallable() + *
+ * + *UpdateEvaluationJob + *+ * Updates an evaluation job. You can only update certain fields of the job's [EvaluationJobConfig][google.cloud.datalabeling.v1beta1.EvaluationJobConfig]: `humanAnnotationConfig.instruction`, `exampleCount`, and `exampleSamplePercentage`. + *
If you want to change any other aspect of the evaluation job, you must delete the job and create a new one.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateEvaluationJob(UpdateEvaluationJobRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateEvaluationJob(EvaluationJob evaluationJob, 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.
+ *+ *
+ *- updateEvaluationJobCallable() + *
+ * + *GetEvaluationJob + *+ * Gets an evaluation job by resource name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getEvaluationJob(GetEvaluationJobRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getEvaluationJob(EvaluationJobName name) + *
- getEvaluationJob(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.
+ *+ *
+ *- getEvaluationJobCallable() + *
+ * + *PauseEvaluationJob + *+ * Pauses an evaluation job. Pausing an evaluation job that is already in a `PAUSED` state is a no-op.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- pauseEvaluationJob(PauseEvaluationJobRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- pauseEvaluationJob(EvaluationJobName name) + *
- pauseEvaluationJob(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.
+ *+ *
+ *- pauseEvaluationJobCallable() + *
+ * + *ResumeEvaluationJob + *+ * Resumes a paused evaluation job. A deleted evaluation job can't be resumed. Resuming a running or scheduled evaluation job is a no-op.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- resumeEvaluationJob(ResumeEvaluationJobRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- resumeEvaluationJob(EvaluationJobName name) + *
- resumeEvaluationJob(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.
+ *+ *
+ *- resumeEvaluationJobCallable() + *
+ * + *DeleteEvaluationJob + *+ * Stops and deletes an evaluation job.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteEvaluationJob(DeleteEvaluationJobRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteEvaluationJob(EvaluationJobName name) + *
- deleteEvaluationJob(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.
+ *+ *
+ *- deleteEvaluationJobCallable() + *
+ * + * + *ListEvaluationJobs + *+ * Lists all evaluation jobs within a project with possible filters. Pagination is supported.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listEvaluationJobs(ListEvaluationJobsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listEvaluationJobs(ProjectName parent, String filter) + *
- listEvaluationJobs(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.
+ *+ *
+ *- listEvaluationJobsPagedCallable() + *
- listEvaluationJobsCallable() + *
See the individual methods for example code. * diff --git a/java-datalabeling/google-cloud-datalabeling/src/main/java/com/google/cloud/datalabeling/v1beta1/stub/DataLabelingServiceStubSettings.java b/java-datalabeling/google-cloud-datalabeling/src/main/java/com/google/cloud/datalabeling/v1beta1/stub/DataLabelingServiceStubSettings.java index 221bbff767b9..a09031f5cb74 100644 --- a/java-datalabeling/google-cloud-datalabeling/src/main/java/com/google/cloud/datalabeling/v1beta1/stub/DataLabelingServiceStubSettings.java +++ b/java-datalabeling/google-cloud-datalabeling/src/main/java/com/google/cloud/datalabeling/v1beta1/stub/DataLabelingServiceStubSettings.java @@ -1043,6 +1043,12 @@ public DataLabelingServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "datalabeling"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-datalineage/README.md b/java-datalineage/README.md index ee85cf938d73..e818e1d94385 100644 --- a/java-datalineage/README.md +++ b/java-datalineage/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-datalineage/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-datalineage.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-datalineage/0.22.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-datalineage/0.24.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-datalineage/google-cloud-datalineage/src/main/java/com/google/cloud/datacatalog/lineage/v1/LineageClient.java b/java-datalineage/google-cloud-datalineage/src/main/java/com/google/cloud/datacatalog/lineage/v1/LineageClient.java index 2e785a4f22d6..ea0bb3569236 100644 --- a/java-datalineage/google-cloud-datalineage/src/main/java/com/google/cloud/datacatalog/lineage/v1/LineageClient.java +++ b/java-datalineage/google-cloud-datalineage/src/main/java/com/google/cloud/datacatalog/lineage/v1/LineageClient.java @@ -67,19 +67,333 @@ *
Note: close() needs to be called on the LineageClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ProcessOpenLineageRunEvent + *+ * Creates new lineage events together with their parents: process and run. Updates the process and run if they already exist. Mapped from Open Lineage specification: https://github.com/OpenLineage/OpenLineage/blob/main/spec/OpenLineage.json.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- processOpenLineageRunEvent(ProcessOpenLineageRunEventRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- processOpenLineageRunEvent(String parent, Struct openLineage) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- processOpenLineageRunEventCallable() + *
+ * + *CreateProcess + *+ * Creates a new process.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createProcess(CreateProcessRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createProcess(LocationName parent, Process process) + *
- createProcess(String parent, Process process) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createProcessCallable() + *
+ * + *UpdateProcess + *+ * Updates a process.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateProcess(UpdateProcessRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateProcess(Process process, 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.
+ *+ *
+ *- updateProcessCallable() + *
+ * + *GetProcess + *+ * Gets the details of the specified process.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getProcess(GetProcessRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getProcess(ProcessName name) + *
- getProcess(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.
+ *+ *
+ *- getProcessCallable() + *
+ * + *ListProcesses + *+ * List processes in the given project and location. List order is descending by insertion time.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listProcesses(ListProcessesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listProcesses(LocationName parent) + *
- listProcesses(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.
+ *+ *
+ *- listProcessesPagedCallable() + *
- listProcessesCallable() + *
+ * + *DeleteProcess + *+ * Deletes the process with the specified name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteProcessAsync(DeleteProcessRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteProcessAsync(ProcessName name) + *
- deleteProcessAsync(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.
+ *+ *
+ *- deleteProcessOperationCallable() + *
- deleteProcessCallable() + *
+ * + *CreateRun + *+ * Creates a new run.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createRun(CreateRunRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createRun(ProcessName parent, Run run) + *
- createRun(String parent, Run run) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createRunCallable() + *
+ * + *UpdateRun + *+ * Updates a run.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateRun(UpdateRunRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateRun(Run run, 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.
+ *+ *
+ *- updateRunCallable() + *
+ * + *GetRun + *+ * Gets the details of the specified run.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getRun(GetRunRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getRun(RunName name) + *
- getRun(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.
+ *+ *
+ *- getRunCallable() + *
+ * + *ListRuns + *+ * Lists runs in the given project and location. List order is descending by `start_time`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listRuns(ListRunsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listRuns(ProcessName parent) + *
- listRuns(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.
+ *+ *
+ *- listRunsPagedCallable() + *
- listRunsCallable() + *
+ * + *DeleteRun + *+ * Deletes the run with the specified name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteRunAsync(DeleteRunRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteRunAsync(RunName name) + *
- deleteRunAsync(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.
+ *+ *
+ *- deleteRunOperationCallable() + *
- deleteRunCallable() + *
+ * + *CreateLineageEvent + *+ * Creates a new lineage event.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createLineageEvent(CreateLineageEventRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createLineageEvent(RunName parent, LineageEvent lineageEvent) + *
- createLineageEvent(String parent, LineageEvent lineageEvent) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createLineageEventCallable() + *
+ * + *GetLineageEvent + *+ * Gets details of a specified lineage event.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getLineageEvent(GetLineageEventRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getLineageEvent(LineageEventName name) + *
- getLineageEvent(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.
+ *+ *
+ *- getLineageEventCallable() + *
+ * + *ListLineageEvents + *+ * Lists lineage events in the given project and location. The list order is not defined.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listLineageEvents(ListLineageEventsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listLineageEvents(RunName parent) + *
- listLineageEvents(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.
+ *+ *
+ *- listLineageEventsPagedCallable() + *
- listLineageEventsCallable() + *
+ * + *DeleteLineageEvent + *+ * Deletes the lineage event with the specified name.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteLineageEvent(DeleteLineageEventRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteLineageEvent(LineageEventName name) + *
- deleteLineageEvent(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.
+ *+ *
+ *- deleteLineageEventCallable() + *
+ * + *SearchLinks + *+ * Retrieve a list of links connected to a specific asset. Links represent the data flow between **source** (upstream) and **target** (downstream) assets in transformation pipelines. Links are stored in the same project as the Lineage Events that create them. + *
You can retrieve links in every project where you have the `datalineage.events.get` permission. The project provided in the URL is used for Billing and Quota.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- searchLinks(SearchLinksRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- searchLinksPagedCallable() + *
- searchLinksCallable() + *
+ * + * + *BatchSearchLinkProcesses + *+ * Retrieve information about LineageProcesses associated with specific links. LineageProcesses are transformation pipelines that result in data flowing from **source** to **target** assets. Links between assets represent this operation. + *
If you have specific link names, you can use this method to verify which LineageProcesses contribute to creating those links. See the [SearchLinks][google.cloud.datacatalog.lineage.v1.Lineage.SearchLinks] method for more information on how to retrieve link name. + *
You can retrieve the LineageProcess information in every project where you have the `datalineage.events.get` permission. The project provided in the URL is used for Billing and Quota.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- batchSearchLinkProcesses(BatchSearchLinkProcessesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- batchSearchLinkProcessesPagedCallable() + *
- batchSearchLinkProcessesCallable() + *
See the individual methods for example code. * diff --git a/java-datalineage/google-cloud-datalineage/src/main/java/com/google/cloud/datacatalog/lineage/v1/stub/LineageStubSettings.java b/java-datalineage/google-cloud-datalineage/src/main/java/com/google/cloud/datacatalog/lineage/v1/stub/LineageStubSettings.java index e10275d291c1..a15fab56f027 100644 --- a/java-datalineage/google-cloud-datalineage/src/main/java/com/google/cloud/datacatalog/lineage/v1/stub/LineageStubSettings.java +++ b/java-datalineage/google-cloud-datalineage/src/main/java/com/google/cloud/datacatalog/lineage/v1/stub/LineageStubSettings.java @@ -582,6 +582,12 @@ public LineageStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "datalineage"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/ContentServiceClient.java b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/ContentServiceClient.java index 8897e29b59f0..9dbc0319a2e6 100644 --- a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/ContentServiceClient.java +++ b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/ContentServiceClient.java @@ -67,19 +67,188 @@ *
Note: close() needs to be called on the ContentServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateContent + *+ * Create a content.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createContent(CreateContentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createContent(LakeName parent, Content content) + *
- createContent(String parent, Content content) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createContentCallable() + *
+ * + *UpdateContent + *+ * Update a content. Only supports full resource update.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateContent(UpdateContentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateContent(Content content, 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.
+ *+ *
+ *- updateContentCallable() + *
+ * + *DeleteContent + *+ * Delete a content.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteContent(DeleteContentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteContent(ContentName name) + *
- deleteContent(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.
+ *+ *
+ *- deleteContentCallable() + *
+ * + *GetContent + *+ * Get a content resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getContent(GetContentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getContent(ContentName name) + *
- getContent(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.
+ *+ *
+ *- getContentCallable() + *
+ * + *GetIamPolicy + *+ * Gets the access control policy for a contentitem resource. A `NOT_FOUND` error is returned if the resource does not exist. An empty policy is returned if the resource exists but does not have a policy set on it. + *
Caller must have Google IAM `dataplex.content.getIamPolicy` permission on the resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getIamPolicyCallable() + *
+ * + *SetIamPolicy + *+ * Sets the access control policy on the specified contentitem resource. Replaces any existing policy. + *
Caller must have Google IAM `dataplex.content.setIamPolicy` permission on the resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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() + *
+ * + *TestIamPermissions + *+ * Returns the caller's permissions on a resource. If the resource does not exist, an empty set of permissions is returned (a `NOT_FOUND` error is not returned). + *
A caller is not required to have Google IAM permission to make this request. + *
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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
+ * + *ListContent + *+ * List content.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listContent(ListContentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listContent(LakeName parent) + *
- listContent(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.
+ *+ *
+ *- listContentPagedCallable() + *
- listContentCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/DataScanServiceClient.java b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/DataScanServiceClient.java index fd329faea4ec..bfc7bdc26d71 100644 --- a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/DataScanServiceClient.java +++ b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/DataScanServiceClient.java @@ -68,19 +68,198 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateDataScan + *+ * Creates a DataScan resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createDataScanAsync(CreateDataScanRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createDataScanAsync(LocationName parent, DataScan dataScan, String dataScanId) + *
- createDataScanAsync(String parent, DataScan dataScan, String dataScanId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createDataScanOperationCallable() + *
- createDataScanCallable() + *
+ * + *UpdateDataScan + *+ * Updates a DataScan resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateDataScanAsync(UpdateDataScanRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateDataScanAsync(DataScan dataScan, 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.
+ *+ *
+ *- updateDataScanOperationCallable() + *
- updateDataScanCallable() + *
+ * + *DeleteDataScan + *+ * Deletes a DataScan resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteDataScanAsync(DeleteDataScanRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteDataScanAsync(DataScanName name) + *
- deleteDataScanAsync(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.
+ *+ *
+ *- deleteDataScanOperationCallable() + *
- deleteDataScanCallable() + *
+ * + *GetDataScan + *+ * Gets a DataScan resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getDataScan(GetDataScanRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getDataScan(DataScanName name) + *
- getDataScan(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.
+ *+ *
+ *- getDataScanCallable() + *
+ * + *ListDataScans + *+ * Lists DataScans.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listDataScans(ListDataScansRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listDataScans(LocationName parent) + *
- listDataScans(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.
+ *+ *
+ *- listDataScansPagedCallable() + *
- listDataScansCallable() + *
+ * + *RunDataScan + *+ * Runs an on-demand execution of a DataScan
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- runDataScan(RunDataScanRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- runDataScan(DataScanName name) + *
- runDataScan(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.
+ *+ *
+ *- runDataScanCallable() + *
+ * + *GetDataScanJob + *+ * Gets a DataScanJob resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getDataScanJob(GetDataScanJobRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getDataScanJob(DataScanJobName name) + *
- getDataScanJob(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.
+ *+ *
+ *- getDataScanJobCallable() + *
+ * + *ListDataScanJobs + *+ * Lists DataScanJobs under the given DataScan.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listDataScanJobs(ListDataScanJobsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listDataScanJobs(DataScanName parent) + *
- listDataScanJobs(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.
+ *+ *
+ *- listDataScanJobsPagedCallable() + *
- listDataScanJobsCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/DataTaxonomyServiceClient.java b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/DataTaxonomyServiceClient.java index 3a547a44ec3b..2bf88a499a1d 100644 --- a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/DataTaxonomyServiceClient.java +++ b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/DataTaxonomyServiceClient.java @@ -67,19 +67,336 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateDataTaxonomy + *+ * Create a DataTaxonomy resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createDataTaxonomyAsync(CreateDataTaxonomyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createDataTaxonomyAsync(LocationName parent, DataTaxonomy dataTaxonomy, String dataTaxonomyId) + *
- createDataTaxonomyAsync(String parent, DataTaxonomy dataTaxonomy, String dataTaxonomyId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createDataTaxonomyOperationCallable() + *
- createDataTaxonomyCallable() + *
+ * + *UpdateDataTaxonomy + *+ * Updates a DataTaxonomy resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateDataTaxonomyAsync(UpdateDataTaxonomyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateDataTaxonomyAsync(DataTaxonomy dataTaxonomy, 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.
+ *+ *
+ *- updateDataTaxonomyOperationCallable() + *
- updateDataTaxonomyCallable() + *
+ * + *DeleteDataTaxonomy + *+ * Deletes a DataTaxonomy resource. All attributes within the DataTaxonomy must be deleted before the DataTaxonomy can be deleted.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteDataTaxonomyAsync(DeleteDataTaxonomyRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteDataTaxonomyAsync(DataTaxonomyName name) + *
- deleteDataTaxonomyAsync(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.
+ *+ *
+ *- deleteDataTaxonomyOperationCallable() + *
- deleteDataTaxonomyCallable() + *
+ * + *ListDataTaxonomies + *+ * Lists DataTaxonomy resources in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listDataTaxonomies(ListDataTaxonomiesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listDataTaxonomies(LocationName parent) + *
- listDataTaxonomies(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.
+ *+ *
+ *- listDataTaxonomiesPagedCallable() + *
- listDataTaxonomiesCallable() + *
+ * + *GetDataTaxonomy + *+ * Retrieves a DataTaxonomy resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getDataTaxonomy(GetDataTaxonomyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getDataTaxonomy(DataTaxonomyName name) + *
- getDataTaxonomy(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.
+ *+ *
+ *- getDataTaxonomyCallable() + *
+ * + *CreateDataAttributeBinding + *+ * Create a DataAttributeBinding resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createDataAttributeBindingAsync(CreateDataAttributeBindingRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createDataAttributeBindingAsync(LocationName parent, DataAttributeBinding dataAttributeBinding, String dataAttributeBindingId) + *
- createDataAttributeBindingAsync(String parent, DataAttributeBinding dataAttributeBinding, String dataAttributeBindingId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createDataAttributeBindingOperationCallable() + *
- createDataAttributeBindingCallable() + *
+ * + *UpdateDataAttributeBinding + *+ * Updates a DataAttributeBinding resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateDataAttributeBindingAsync(UpdateDataAttributeBindingRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateDataAttributeBindingAsync(DataAttributeBinding dataAttributeBinding, 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.
+ *+ *
+ *- updateDataAttributeBindingOperationCallable() + *
- updateDataAttributeBindingCallable() + *
+ * + *DeleteDataAttributeBinding + *+ * Deletes a DataAttributeBinding resource. All attributes within the DataAttributeBinding must be deleted before the DataAttributeBinding can be deleted.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteDataAttributeBindingAsync(DeleteDataAttributeBindingRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteDataAttributeBindingAsync(DataAttributeBindingName name) + *
- deleteDataAttributeBindingAsync(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.
+ *+ *
+ *- deleteDataAttributeBindingOperationCallable() + *
- deleteDataAttributeBindingCallable() + *
+ * + *ListDataAttributeBindings + *+ * Lists DataAttributeBinding resources in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listDataAttributeBindings(ListDataAttributeBindingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listDataAttributeBindings(LocationName parent) + *
- listDataAttributeBindings(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.
+ *+ *
+ *- listDataAttributeBindingsPagedCallable() + *
- listDataAttributeBindingsCallable() + *
+ * + *GetDataAttributeBinding + *+ * Retrieves a DataAttributeBinding resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getDataAttributeBinding(GetDataAttributeBindingRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getDataAttributeBinding(DataAttributeBindingName name) + *
- getDataAttributeBinding(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.
+ *+ *
+ *- getDataAttributeBindingCallable() + *
+ * + *CreateDataAttribute + *+ * Create a DataAttribute resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createDataAttributeAsync(CreateDataAttributeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createDataAttributeAsync(DataTaxonomyName parent, DataAttribute dataAttribute, String dataAttributeId) + *
- createDataAttributeAsync(String parent, DataAttribute dataAttribute, String dataAttributeId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createDataAttributeOperationCallable() + *
- createDataAttributeCallable() + *
+ * + *UpdateDataAttribute + *+ * Updates a DataAttribute resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateDataAttributeAsync(UpdateDataAttributeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateDataAttributeAsync(DataAttribute dataAttribute, 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.
+ *+ *
+ *- updateDataAttributeOperationCallable() + *
- updateDataAttributeCallable() + *
+ * + *DeleteDataAttribute + *+ * Deletes a Data Attribute resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteDataAttributeAsync(DeleteDataAttributeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteDataAttributeAsync(DataAttributeName name) + *
- deleteDataAttributeAsync(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.
+ *+ *
+ *- deleteDataAttributeOperationCallable() + *
- deleteDataAttributeCallable() + *
+ * + *ListDataAttributes + *+ * Lists Data Attribute resources in a DataTaxonomy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listDataAttributes(ListDataAttributesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listDataAttributes(DataTaxonomyName parent) + *
- listDataAttributes(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.
+ *+ *
+ *- listDataAttributesPagedCallable() + *
- listDataAttributesCallable() + *
+ * + *GetDataAttribute + *+ * Retrieves a Data Attribute resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getDataAttribute(GetDataAttributeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getDataAttribute(DataAttributeName name) + *
- getDataAttribute(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.
+ *+ *
+ *- getDataAttributeCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/DataplexServiceClient.java b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/DataplexServiceClient.java index eaf59238a6d6..5d527559c9f4 100644 --- a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/DataplexServiceClient.java +++ b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/DataplexServiceClient.java @@ -69,19 +69,689 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateLake + *+ * Creates a lake resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createLakeAsync(CreateLakeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createLakeAsync(LocationName parent, Lake lake, String lakeId) + *
- createLakeAsync(String parent, Lake lake, String lakeId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createLakeOperationCallable() + *
- createLakeCallable() + *
+ * + *UpdateLake + *+ * Updates a lake resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateLakeAsync(UpdateLakeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateLakeAsync(Lake lake, 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.
+ *+ *
+ *- updateLakeOperationCallable() + *
- updateLakeCallable() + *
+ * + *DeleteLake + *+ * Deletes a lake resource. All zones within the lake must be deleted before the lake can be deleted.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteLakeAsync(DeleteLakeRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteLakeAsync(LakeName name) + *
- deleteLakeAsync(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.
+ *+ *
+ *- deleteLakeOperationCallable() + *
- deleteLakeCallable() + *
+ * + *ListLakes + *+ * Lists lake resources in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listLakes(ListLakesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listLakes(LocationName parent) + *
- listLakes(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.
+ *+ *
+ *- listLakesPagedCallable() + *
- listLakesCallable() + *
+ * + *GetLake + *+ * Retrieves a lake resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getLake(GetLakeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getLake(LakeName name) + *
- getLake(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.
+ *+ *
+ *- getLakeCallable() + *
+ * + *ListLakeActions + *+ * Lists action resources in a lake.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listLakeActions(ListLakeActionsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listLakeActions(LakeName parent) + *
- listLakeActions(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.
+ *+ *
+ *- listLakeActionsPagedCallable() + *
- listLakeActionsCallable() + *
+ * + *CreateZone + *+ * Creates a zone resource within a lake.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createZoneAsync(CreateZoneRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createZoneAsync(LakeName parent, Zone zone, String zoneId) + *
- createZoneAsync(String parent, Zone zone, String zoneId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createZoneOperationCallable() + *
- createZoneCallable() + *
+ * + *UpdateZone + *+ * Updates a zone resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateZoneAsync(UpdateZoneRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateZoneAsync(Zone zone, 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.
+ *+ *
+ *- updateZoneOperationCallable() + *
- updateZoneCallable() + *
+ * + *DeleteZone + *+ * Deletes a zone resource. All assets within a zone must be deleted before the zone can be deleted.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteZoneAsync(DeleteZoneRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteZoneAsync(ZoneName name) + *
- deleteZoneAsync(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.
+ *+ *
+ *- deleteZoneOperationCallable() + *
- deleteZoneCallable() + *
+ * + *ListZones + *+ * Lists zone resources in a lake.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listZones(ListZonesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listZones(LakeName parent) + *
- listZones(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.
+ *+ *
+ *- listZonesPagedCallable() + *
- listZonesCallable() + *
+ * + *GetZone + *+ * Retrieves a zone resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getZone(GetZoneRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getZone(ZoneName name) + *
- getZone(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.
+ *+ *
+ *- getZoneCallable() + *
+ * + *ListZoneActions + *+ * Lists action resources in a zone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listZoneActions(ListZoneActionsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listZoneActions(ZoneName parent) + *
- listZoneActions(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.
+ *+ *
+ *- listZoneActionsPagedCallable() + *
- listZoneActionsCallable() + *
+ * + *CreateAsset + *+ * Creates an asset resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createAssetAsync(CreateAssetRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createAssetAsync(ZoneName parent, Asset asset, String assetId) + *
- createAssetAsync(String parent, Asset asset, String assetId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createAssetOperationCallable() + *
- createAssetCallable() + *
+ * + *UpdateAsset + *+ * Updates an asset resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAssetAsync(UpdateAssetRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateAssetAsync(Asset asset, 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.
+ *+ *
+ *- updateAssetOperationCallable() + *
- updateAssetCallable() + *
+ * + *DeleteAsset + *+ * Deletes an asset resource. The referenced storage resource is detached (default) or deleted based on the associated Lifecycle policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAssetAsync(DeleteAssetRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteAssetAsync(AssetName name) + *
- deleteAssetAsync(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.
+ *+ *
+ *- deleteAssetOperationCallable() + *
- deleteAssetCallable() + *
+ * + *ListAssets + *+ * Lists asset resources in a zone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(ZoneName 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() + *
+ * + *GetAsset + *+ * Retrieves an asset resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getAsset(GetAssetRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getAsset(AssetName name) + *
- getAsset(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.
+ *+ *
+ *- getAssetCallable() + *
+ * + *ListAssetActions + *+ * Lists action resources in an asset.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listAssetActions(ListAssetActionsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listAssetActions(AssetName parent) + *
- listAssetActions(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.
+ *+ *
+ *- listAssetActionsPagedCallable() + *
- listAssetActionsCallable() + *
+ * + *CreateTask + *+ * Creates a task resource within a lake.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createTaskAsync(CreateTaskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createTaskAsync(LakeName parent, Task task, String taskId) + *
- createTaskAsync(String parent, Task task, String taskId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createTaskOperationCallable() + *
- createTaskCallable() + *
+ * + *UpdateTask + *+ * Update the task resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateTaskAsync(UpdateTaskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateTaskAsync(Task task, 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.
+ *+ *
+ *- updateTaskOperationCallable() + *
- updateTaskCallable() + *
+ * + *DeleteTask + *+ * Delete the task resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteTaskAsync(DeleteTaskRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteTaskAsync(TaskName name) + *
- deleteTaskAsync(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.
+ *+ *
+ *- deleteTaskOperationCallable() + *
- deleteTaskCallable() + *
+ * + *ListTasks + *+ * Lists tasks under the given lake.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(LakeName 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() + *
+ * + *GetTask + *+ * Get task resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getTaskCallable() + *
+ * + *ListJobs + *+ * Lists Jobs under the given task.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(TaskName 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() + *
+ * + *RunTask + *+ * Run an on demand execution of a Task.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- runTask(RunTaskRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- runTask(TaskName name) + *
- runTask(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.
+ *+ *
+ *- runTaskCallable() + *
+ * + *GetJob + *+ * Get job resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getJobCallable() + *
+ * + *CancelJob + *+ * Cancel jobs running for the task resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- cancelJob(CancelJobRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- cancelJob(JobName name) + *
- cancelJob(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.
+ *+ *
+ *- cancelJobCallable() + *
+ * + *CreateEnvironment + *+ * Create an environment resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createEnvironmentAsync(CreateEnvironmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createEnvironmentAsync(LakeName parent, Environment environment, String environmentId) + *
- createEnvironmentAsync(String parent, Environment environment, String environmentId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createEnvironmentOperationCallable() + *
- createEnvironmentCallable() + *
+ * + *UpdateEnvironment + *+ * Update the environment resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateEnvironmentAsync(UpdateEnvironmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateEnvironmentAsync(Environment environment, 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.
+ *+ *
+ *- updateEnvironmentOperationCallable() + *
- updateEnvironmentCallable() + *
+ * + *DeleteEnvironment + *+ * Delete the environment resource. All the child resources must have been deleted before environment deletion can be initiated.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteEnvironmentAsync(DeleteEnvironmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteEnvironmentAsync(EnvironmentName name) + *
- deleteEnvironmentAsync(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.
+ *+ *
+ *- deleteEnvironmentOperationCallable() + *
- deleteEnvironmentCallable() + *
+ * + *ListEnvironments + *+ * Lists environments under the given lake.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listEnvironments(ListEnvironmentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listEnvironments(LakeName parent) + *
- listEnvironments(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.
+ *+ *
+ *- listEnvironmentsPagedCallable() + *
- listEnvironmentsCallable() + *
+ * + *GetEnvironment + *+ * Get environment resource.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getEnvironment(GetEnvironmentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getEnvironment(EnvironmentName name) + *
- getEnvironment(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.
+ *+ *
+ *- getEnvironmentCallable() + *
+ * + *ListSessions + *+ * Lists session resources in an environment.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listSessions(ListSessionsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listSessions(EnvironmentName parent) + *
- listSessions(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.
+ *+ *
+ *- listSessionsPagedCallable() + *
- listSessionsCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/MetadataServiceClient.java b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/MetadataServiceClient.java index d5b65f6b8705..44d36d3c2bf1 100644 --- a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/MetadataServiceClient.java +++ b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/MetadataServiceClient.java @@ -62,19 +62,210 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateEntity + *+ * Create a metadata entity.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createEntity(CreateEntityRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createEntity(ZoneName parent, Entity entity) + *
- createEntity(String parent, Entity entity) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createEntityCallable() + *
+ * + *UpdateEntity + *+ * Update a metadata entity. Only supports full resource update.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateEntity(UpdateEntityRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateEntityCallable() + *
+ * + *DeleteEntity + *+ * Delete a metadata entity.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteEntity(DeleteEntityRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteEntity(EntityName name) + *
- deleteEntity(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.
+ *+ *
+ *- deleteEntityCallable() + *
+ * + *GetEntity + *+ * Get a metadata entity.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getEntity(GetEntityRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getEntity(EntityName name) + *
- getEntity(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.
+ *+ *
+ *- getEntityCallable() + *
+ * + *ListEntities + *+ * List metadata entities in a zone.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listEntities(ListEntitiesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listEntities(ZoneName parent) + *
- listEntities(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.
+ *+ *
+ *- listEntitiesPagedCallable() + *
- listEntitiesCallable() + *
+ * + *CreatePartition + *+ * Create a metadata partition.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createPartition(CreatePartitionRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createPartition(EntityName parent, Partition partition) + *
- createPartition(String parent, Partition partition) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createPartitionCallable() + *
+ * + *DeletePartition + *+ * Delete a metadata partition.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deletePartition(DeletePartitionRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deletePartition(PartitionName name) + *
- deletePartition(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.
+ *+ *
+ *- deletePartitionCallable() + *
+ * + *GetPartition + *+ * Get a metadata partition of an entity.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getPartition(GetPartitionRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getPartition(PartitionName name) + *
- getPartition(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.
+ *+ *
+ *- getPartitionCallable() + *
+ * + *ListPartitions + *+ * List metadata partitions of an entity.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listPartitions(ListPartitionsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listPartitions(EntityName parent) + *
- listPartitions(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.
+ *+ *
+ *- listPartitionsPagedCallable() + *
- listPartitionsCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/ContentServiceStubSettings.java b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/ContentServiceStubSettings.java index 4d9b274e8569..72041febc9d4 100644 --- a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/ContentServiceStubSettings.java +++ b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/ContentServiceStubSettings.java @@ -303,6 +303,12 @@ public ContentServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataplex"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/DataScanServiceStubSettings.java b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/DataScanServiceStubSettings.java index 3d5a93aef10d..6a2831e75b26 100644 --- a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/DataScanServiceStubSettings.java +++ b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/DataScanServiceStubSettings.java @@ -397,6 +397,12 @@ public DataScanServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataplex"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/DataTaxonomyServiceStubSettings.java b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/DataTaxonomyServiceStubSettings.java index 4f802858e870..7bf31ef19402 100644 --- a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/DataTaxonomyServiceStubSettings.java +++ b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/DataTaxonomyServiceStubSettings.java @@ -606,6 +606,12 @@ public DataTaxonomyServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataplex"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/DataplexServiceStubSettings.java b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/DataplexServiceStubSettings.java index 6d6fc7788bf8..3cad6efede26 100644 --- a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/DataplexServiceStubSettings.java +++ b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/DataplexServiceStubSettings.java @@ -1139,6 +1139,12 @@ public DataplexServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataplex"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/MetadataServiceStubSettings.java b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/MetadataServiceStubSettings.java index 7d8329d2a6a8..ab9bd8ddbe2f 100644 --- a/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/MetadataServiceStubSettings.java +++ b/java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/MetadataServiceStubSettings.java @@ -368,6 +368,12 @@ public MetadataServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataplex"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataproc-metastore/README.md b/java-dataproc-metastore/README.md index 9f8801c8f310..079cfb940bc2 100644 --- a/java-dataproc-metastore/README.md +++ b/java-dataproc-metastore/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-dataproc-metastore.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-dataproc-metastore/2.31.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-dataproc-metastore/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-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1/DataprocMetastoreClient.java b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1/DataprocMetastoreClient.java index 37f81003643e..4d0a3488abfa 100644 --- a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1/DataprocMetastoreClient.java +++ b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1/DataprocMetastoreClient.java @@ -87,19 +87,423 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListServices + *+ * Lists services in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
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() + *
+ * + *GetService + *+ * Gets the details of a single service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getServiceCallable() + *
+ * + *CreateService + *+ * Creates a metastore service in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
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() + *
+ * + *UpdateService + *+ * Updates the parameters of a single service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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, 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.
+ *+ *
+ *- updateServiceOperationCallable() + *
- updateServiceCallable() + *
+ * + *DeleteService + *+ * Deletes a single service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
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() + *
+ * + *ListMetadataImports + *+ * Lists imports in a service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listMetadataImports(ListMetadataImportsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listMetadataImports(ServiceName parent) + *
- listMetadataImports(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.
+ *+ *
+ *- listMetadataImportsPagedCallable() + *
- listMetadataImportsCallable() + *
+ * + *GetMetadataImport + *+ * Gets details of a single import.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getMetadataImport(GetMetadataImportRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getMetadataImport(MetadataImportName name) + *
- getMetadataImport(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.
+ *+ *
+ *- getMetadataImportCallable() + *
+ * + *CreateMetadataImport + *+ * Creates a new MetadataImport in a given project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createMetadataImportAsync(CreateMetadataImportRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createMetadataImportAsync(ServiceName parent, MetadataImport metadataImport, String metadataImportId) + *
- createMetadataImportAsync(String parent, MetadataImport metadataImport, String metadataImportId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createMetadataImportOperationCallable() + *
- createMetadataImportCallable() + *
+ * + *UpdateMetadataImport + *+ * Updates a single import. Only the description field of MetadataImport is supported to be updated.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateMetadataImportAsync(UpdateMetadataImportRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateMetadataImportAsync(MetadataImport metadataImport, 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.
+ *+ *
+ *- updateMetadataImportOperationCallable() + *
- updateMetadataImportCallable() + *
+ * + *ExportMetadata + *+ * Exports metadata from a service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- exportMetadataAsync(ExportMetadataRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- exportMetadataOperationCallable() + *
- exportMetadataCallable() + *
+ * + *RestoreService + *+ * Restores a service from a backup.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- restoreServiceAsync(RestoreServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- restoreServiceAsync(ServiceName service, BackupName backup) + *
- restoreServiceAsync(ServiceName service, String backup) + *
- restoreServiceAsync(String service, BackupName backup) + *
- restoreServiceAsync(String service, String backup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- restoreServiceOperationCallable() + *
- restoreServiceCallable() + *
+ * + *ListBackups + *+ * Lists backups in a service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listBackups(ListBackupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listBackups(ServiceName parent) + *
- listBackups(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.
+ *+ *
+ *- listBackupsPagedCallable() + *
- listBackupsCallable() + *
+ * + *GetBackup + *+ * Gets details of a single backup.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getBackup(GetBackupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getBackup(BackupName name) + *
- getBackup(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.
+ *+ *
+ *- getBackupCallable() + *
+ * + *CreateBackup + *+ * Creates a new backup in a given project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createBackupAsync(CreateBackupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createBackupAsync(ServiceName parent, Backup backup, String backupId) + *
- createBackupAsync(String parent, Backup backup, String backupId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createBackupOperationCallable() + *
- createBackupCallable() + *
+ * + *DeleteBackup + *+ * Deletes a single backup.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteBackupAsync(DeleteBackupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteBackupAsync(BackupName name) + *
- deleteBackupAsync(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.
+ *+ *
+ *- deleteBackupOperationCallable() + *
- deleteBackupCallable() + *
+ * + *QueryMetadata + *+ * Query DPMS metadata.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- queryMetadataAsync(QueryMetadataRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- queryMetadataOperationCallable() + *
- queryMetadataCallable() + *
+ * + *MoveTableToDatabase + *+ * Move a table to another database.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- moveTableToDatabaseAsync(MoveTableToDatabaseRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- moveTableToDatabaseOperationCallable() + *
- moveTableToDatabaseCallable() + *
+ * + *AlterMetadataResourceLocation + *+ * Alter metadata resource location. The metadata resource can be a database, table, or partition. This functionality only updates the parent directory for the respective metadata resource and does not transfer any existing data to the new location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- alterMetadataResourceLocationAsync(AlterMetadataResourceLocationRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- alterMetadataResourceLocationOperationCallable() + *
- alterMetadataResourceLocationCallable() + *
+ * + *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) + *
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() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getIamPolicyCallable() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1/DataprocMetastoreFederationClient.java b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1/DataprocMetastoreFederationClient.java index 7f0f1831376b..b98d63c87006 100644 --- a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1/DataprocMetastoreFederationClient.java +++ b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1/DataprocMetastoreFederationClient.java @@ -85,19 +85,184 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListFederations + *+ * Lists federations in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listFederations(ListFederationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listFederations(LocationName parent) + *
- listFederations(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.
+ *+ *
+ *- listFederationsPagedCallable() + *
- listFederationsCallable() + *
+ * + *GetFederation + *+ * Gets the details of a single federation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getFederation(GetFederationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getFederation(FederationName name) + *
- getFederation(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.
+ *+ *
+ *- getFederationCallable() + *
+ * + *CreateFederation + *+ * Creates a metastore federation in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createFederationAsync(CreateFederationRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createFederationAsync(LocationName parent, Federation federation, String federationId) + *
- createFederationAsync(String parent, Federation federation, String federationId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createFederationOperationCallable() + *
- createFederationCallable() + *
+ * + *UpdateFederation + *+ * Updates the fields of a federation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateFederationAsync(UpdateFederationRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateFederationAsync(Federation federation, 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.
+ *+ *
+ *- updateFederationOperationCallable() + *
- updateFederationCallable() + *
+ * + *DeleteFederation + *+ * Deletes a single federation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteFederationAsync(DeleteFederationRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteFederationAsync(FederationName name) + *
- deleteFederationAsync(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.
+ *+ *
+ *- deleteFederationOperationCallable() + *
- deleteFederationCallable() + *
+ * + *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) + *
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() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getIamPolicyCallable() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1/stub/DataprocMetastoreFederationStubSettings.java b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1/stub/DataprocMetastoreFederationStubSettings.java index 944dec3c869d..2e20af410fc0 100644 --- a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1/stub/DataprocMetastoreFederationStubSettings.java +++ b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1/stub/DataprocMetastoreFederationStubSettings.java @@ -340,6 +340,12 @@ public DataprocMetastoreFederationStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "metastore"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1/stub/DataprocMetastoreStubSettings.java b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1/stub/DataprocMetastoreStubSettings.java index 4a61203c9a4d..24ede25dbcf2 100644 --- a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1/stub/DataprocMetastoreStubSettings.java +++ b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1/stub/DataprocMetastoreStubSettings.java @@ -646,6 +646,12 @@ public DataprocMetastoreStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "metastore"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1alpha/DataprocMetastoreClient.java b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1alpha/DataprocMetastoreClient.java index 5c682b5bcead..6adb84111f08 100644 --- a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1alpha/DataprocMetastoreClient.java +++ b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1alpha/DataprocMetastoreClient.java @@ -87,19 +87,437 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListServices + *+ * Lists services in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
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() + *
+ * + *GetService + *+ * Gets the details of a single service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getServiceCallable() + *
+ * + *CreateService + *+ * Creates a metastore service in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
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() + *
+ * + *UpdateService + *+ * Updates the parameters of a single service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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, 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.
+ *+ *
+ *- updateServiceOperationCallable() + *
- updateServiceCallable() + *
+ * + *DeleteService + *+ * Deletes a single service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
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() + *
+ * + *ListMetadataImports + *+ * Lists imports in a service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listMetadataImports(ListMetadataImportsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listMetadataImports(ServiceName parent) + *
- listMetadataImports(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.
+ *+ *
+ *- listMetadataImportsPagedCallable() + *
- listMetadataImportsCallable() + *
+ * + *GetMetadataImport + *+ * Gets details of a single import.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getMetadataImport(GetMetadataImportRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getMetadataImport(MetadataImportName name) + *
- getMetadataImport(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.
+ *+ *
+ *- getMetadataImportCallable() + *
+ * + *CreateMetadataImport + *+ * Creates a new MetadataImport in a given project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createMetadataImportAsync(CreateMetadataImportRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createMetadataImportAsync(ServiceName parent, MetadataImport metadataImport, String metadataImportId) + *
- createMetadataImportAsync(String parent, MetadataImport metadataImport, String metadataImportId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createMetadataImportOperationCallable() + *
- createMetadataImportCallable() + *
+ * + *UpdateMetadataImport + *+ * Updates a single import. Only the description field of MetadataImport is supported to be updated.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateMetadataImportAsync(UpdateMetadataImportRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateMetadataImportAsync(MetadataImport metadataImport, 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.
+ *+ *
+ *- updateMetadataImportOperationCallable() + *
- updateMetadataImportCallable() + *
+ * + *ExportMetadata + *+ * Exports metadata from a service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- exportMetadataAsync(ExportMetadataRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- exportMetadataOperationCallable() + *
- exportMetadataCallable() + *
+ * + *RestoreService + *+ * Restores a service from a backup.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- restoreServiceAsync(RestoreServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- restoreServiceAsync(ServiceName service, BackupName backup) + *
- restoreServiceAsync(ServiceName service, String backup) + *
- restoreServiceAsync(String service, BackupName backup) + *
- restoreServiceAsync(String service, String backup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- restoreServiceOperationCallable() + *
- restoreServiceCallable() + *
+ * + *ListBackups + *+ * Lists backups in a service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listBackups(ListBackupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listBackups(ServiceName parent) + *
- listBackups(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.
+ *+ *
+ *- listBackupsPagedCallable() + *
- listBackupsCallable() + *
+ * + *GetBackup + *+ * Gets details of a single backup.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getBackup(GetBackupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getBackup(BackupName name) + *
- getBackup(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.
+ *+ *
+ *- getBackupCallable() + *
+ * + *CreateBackup + *+ * Creates a new backup in a given project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createBackupAsync(CreateBackupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createBackupAsync(ServiceName parent, Backup backup, String backupId) + *
- createBackupAsync(String parent, Backup backup, String backupId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createBackupOperationCallable() + *
- createBackupCallable() + *
+ * + *DeleteBackup + *+ * Deletes a single backup.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteBackupAsync(DeleteBackupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteBackupAsync(BackupName name) + *
- deleteBackupAsync(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.
+ *+ *
+ *- deleteBackupOperationCallable() + *
- deleteBackupCallable() + *
+ * + *RemoveIamPolicy + *+ * Removes the attached IAM policies for a resource
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeIamPolicy(RemoveIamPolicyRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeIamPolicyCallable() + *
+ * + *QueryMetadata + *+ * Query DPMS metadata.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- queryMetadataAsync(QueryMetadataRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- queryMetadataOperationCallable() + *
- queryMetadataCallable() + *
+ * + *MoveTableToDatabase + *+ * Move a table to another database.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- moveTableToDatabaseAsync(MoveTableToDatabaseRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- moveTableToDatabaseOperationCallable() + *
- moveTableToDatabaseCallable() + *
+ * + *AlterMetadataResourceLocation + *+ * Alter metadata resource location. The metadata resource can be a database, table, or partition. This functionality only updates the parent directory for the respective metadata resource and does not transfer any existing data to the new location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- alterMetadataResourceLocationAsync(AlterMetadataResourceLocationRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- alterMetadataResourceLocationOperationCallable() + *
- alterMetadataResourceLocationCallable() + *
+ * + *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) + *
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() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getIamPolicyCallable() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1alpha/DataprocMetastoreFederationClient.java b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1alpha/DataprocMetastoreFederationClient.java index a1f4ec54d51a..f706cf82734c 100644 --- a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1alpha/DataprocMetastoreFederationClient.java +++ b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1alpha/DataprocMetastoreFederationClient.java @@ -85,19 +85,184 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListFederations + *+ * Lists federations in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listFederations(ListFederationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listFederations(LocationName parent) + *
- listFederations(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.
+ *+ *
+ *- listFederationsPagedCallable() + *
- listFederationsCallable() + *
+ * + *GetFederation + *+ * Gets the details of a single federation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getFederation(GetFederationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getFederation(FederationName name) + *
- getFederation(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.
+ *+ *
+ *- getFederationCallable() + *
+ * + *CreateFederation + *+ * Creates a metastore federation in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createFederationAsync(CreateFederationRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createFederationAsync(LocationName parent, Federation federation, String federationId) + *
- createFederationAsync(String parent, Federation federation, String federationId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createFederationOperationCallable() + *
- createFederationCallable() + *
+ * + *UpdateFederation + *+ * Updates the fields of a federation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateFederationAsync(UpdateFederationRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateFederationAsync(Federation federation, 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.
+ *+ *
+ *- updateFederationOperationCallable() + *
- updateFederationCallable() + *
+ * + *DeleteFederation + *+ * Deletes a single federation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteFederationAsync(DeleteFederationRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteFederationAsync(FederationName name) + *
- deleteFederationAsync(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.
+ *+ *
+ *- deleteFederationOperationCallable() + *
- deleteFederationCallable() + *
+ * + *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) + *
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() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getIamPolicyCallable() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1alpha/stub/DataprocMetastoreFederationStubSettings.java b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1alpha/stub/DataprocMetastoreFederationStubSettings.java index 7cea0d7b4d77..948029690f48 100644 --- a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1alpha/stub/DataprocMetastoreFederationStubSettings.java +++ b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1alpha/stub/DataprocMetastoreFederationStubSettings.java @@ -341,6 +341,12 @@ public DataprocMetastoreFederationStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "metastore"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1alpha/stub/DataprocMetastoreStubSettings.java b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1alpha/stub/DataprocMetastoreStubSettings.java index 10090fddde3a..6fb370435db9 100644 --- a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1alpha/stub/DataprocMetastoreStubSettings.java +++ b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1alpha/stub/DataprocMetastoreStubSettings.java @@ -657,6 +657,12 @@ public DataprocMetastoreStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "metastore"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1beta/DataprocMetastoreClient.java b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1beta/DataprocMetastoreClient.java index 7301bee95e89..caff78e6cf39 100644 --- a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1beta/DataprocMetastoreClient.java +++ b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1beta/DataprocMetastoreClient.java @@ -87,19 +87,437 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListServices + *+ * Lists services in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
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() + *
+ * + *GetService + *+ * Gets the details of a single service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getServiceCallable() + *
+ * + *CreateService + *+ * Creates a metastore service in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
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() + *
+ * + *UpdateService + *+ * Updates the parameters of a single service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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, 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.
+ *+ *
+ *- updateServiceOperationCallable() + *
- updateServiceCallable() + *
+ * + *DeleteService + *+ * Deletes a single service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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) + *
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() + *
+ * + *ListMetadataImports + *+ * Lists imports in a service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listMetadataImports(ListMetadataImportsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listMetadataImports(ServiceName parent) + *
- listMetadataImports(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.
+ *+ *
+ *- listMetadataImportsPagedCallable() + *
- listMetadataImportsCallable() + *
+ * + *GetMetadataImport + *+ * Gets details of a single import.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getMetadataImport(GetMetadataImportRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getMetadataImport(MetadataImportName name) + *
- getMetadataImport(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.
+ *+ *
+ *- getMetadataImportCallable() + *
+ * + *CreateMetadataImport + *+ * Creates a new MetadataImport in a given project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createMetadataImportAsync(CreateMetadataImportRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createMetadataImportAsync(ServiceName parent, MetadataImport metadataImport, String metadataImportId) + *
- createMetadataImportAsync(String parent, MetadataImport metadataImport, String metadataImportId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createMetadataImportOperationCallable() + *
- createMetadataImportCallable() + *
+ * + *UpdateMetadataImport + *+ * Updates a single import. Only the description field of MetadataImport is supported to be updated.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateMetadataImportAsync(UpdateMetadataImportRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateMetadataImportAsync(MetadataImport metadataImport, 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.
+ *+ *
+ *- updateMetadataImportOperationCallable() + *
- updateMetadataImportCallable() + *
+ * + *ExportMetadata + *+ * Exports metadata from a service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- exportMetadataAsync(ExportMetadataRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- exportMetadataOperationCallable() + *
- exportMetadataCallable() + *
+ * + *RestoreService + *+ * Restores a service from a backup.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- restoreServiceAsync(RestoreServiceRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- restoreServiceAsync(ServiceName service, BackupName backup) + *
- restoreServiceAsync(ServiceName service, String backup) + *
- restoreServiceAsync(String service, BackupName backup) + *
- restoreServiceAsync(String service, String backup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- restoreServiceOperationCallable() + *
- restoreServiceCallable() + *
+ * + *ListBackups + *+ * Lists backups in a service.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listBackups(ListBackupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listBackups(ServiceName parent) + *
- listBackups(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.
+ *+ *
+ *- listBackupsPagedCallable() + *
- listBackupsCallable() + *
+ * + *GetBackup + *+ * Gets details of a single backup.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getBackup(GetBackupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getBackup(BackupName name) + *
- getBackup(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.
+ *+ *
+ *- getBackupCallable() + *
+ * + *CreateBackup + *+ * Creates a new backup in a given project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createBackupAsync(CreateBackupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createBackupAsync(ServiceName parent, Backup backup, String backupId) + *
- createBackupAsync(String parent, Backup backup, String backupId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createBackupOperationCallable() + *
- createBackupCallable() + *
+ * + *DeleteBackup + *+ * Deletes a single backup.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteBackupAsync(DeleteBackupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteBackupAsync(BackupName name) + *
- deleteBackupAsync(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.
+ *+ *
+ *- deleteBackupOperationCallable() + *
- deleteBackupCallable() + *
+ * + *RemoveIamPolicy + *+ * Removes the attached IAM policies for a resource
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- removeIamPolicy(RemoveIamPolicyRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- removeIamPolicyCallable() + *
+ * + *QueryMetadata + *+ * Query DPMS metadata.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- queryMetadataAsync(QueryMetadataRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- queryMetadataOperationCallable() + *
- queryMetadataCallable() + *
+ * + *MoveTableToDatabase + *+ * Move a table to another database.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- moveTableToDatabaseAsync(MoveTableToDatabaseRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- moveTableToDatabaseOperationCallable() + *
- moveTableToDatabaseCallable() + *
+ * + *AlterMetadataResourceLocation + *+ * Alter metadata resource location. The metadata resource can be a database, table, or partition. This functionality only updates the parent directory for the respective metadata resource and does not transfer any existing data to the new location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- alterMetadataResourceLocationAsync(AlterMetadataResourceLocationRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- alterMetadataResourceLocationOperationCallable() + *
- alterMetadataResourceLocationCallable() + *
+ * + *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) + *
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() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getIamPolicyCallable() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1beta/DataprocMetastoreFederationClient.java b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1beta/DataprocMetastoreFederationClient.java index d0d281e19a39..4736a2271213 100644 --- a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1beta/DataprocMetastoreFederationClient.java +++ b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1beta/DataprocMetastoreFederationClient.java @@ -85,19 +85,184 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListFederations + *+ * Lists federations in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listFederations(ListFederationsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listFederations(LocationName parent) + *
- listFederations(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.
+ *+ *
+ *- listFederationsPagedCallable() + *
- listFederationsCallable() + *
+ * + *GetFederation + *+ * Gets the details of a single federation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getFederation(GetFederationRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getFederation(FederationName name) + *
- getFederation(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.
+ *+ *
+ *- getFederationCallable() + *
+ * + *CreateFederation + *+ * Creates a metastore federation in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createFederationAsync(CreateFederationRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createFederationAsync(LocationName parent, Federation federation, String federationId) + *
- createFederationAsync(String parent, Federation federation, String federationId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createFederationOperationCallable() + *
- createFederationCallable() + *
+ * + *UpdateFederation + *+ * Updates the fields of a federation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateFederationAsync(UpdateFederationRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateFederationAsync(Federation federation, 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.
+ *+ *
+ *- updateFederationOperationCallable() + *
- updateFederationCallable() + *
+ * + *DeleteFederation + *+ * Deletes a single federation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteFederationAsync(DeleteFederationRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteFederationAsync(FederationName name) + *
- deleteFederationAsync(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.
+ *+ *
+ *- deleteFederationOperationCallable() + *
- deleteFederationCallable() + *
+ * + *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) + *
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() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getIamPolicyCallable() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1beta/stub/DataprocMetastoreFederationStubSettings.java b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1beta/stub/DataprocMetastoreFederationStubSettings.java index 9c007a505a4f..fdbe6728b39f 100644 --- a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1beta/stub/DataprocMetastoreFederationStubSettings.java +++ b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1beta/stub/DataprocMetastoreFederationStubSettings.java @@ -341,6 +341,12 @@ public DataprocMetastoreFederationStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "metastore"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1beta/stub/DataprocMetastoreStubSettings.java b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1beta/stub/DataprocMetastoreStubSettings.java index 1a5a2fad5434..dfae7bc836bd 100644 --- a/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1beta/stub/DataprocMetastoreStubSettings.java +++ b/java-dataproc-metastore/google-cloud-dataproc-metastore/src/main/java/com/google/cloud/metastore/v1beta/stub/DataprocMetastoreStubSettings.java @@ -657,6 +657,12 @@ public DataprocMetastoreStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "metastore"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataproc/README.md b/java-dataproc/README.md index bb6cd127c0a9..c7274682932b 100644 --- a/java-dataproc/README.md +++ b/java-dataproc/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-dataproc.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-dataproc/4.27.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-dataproc/4.29.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-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/AutoscalingPolicyServiceClient.java b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/AutoscalingPolicyServiceClient.java index e56b685642a8..090eb3bc4165 100644 --- a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/AutoscalingPolicyServiceClient.java +++ b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/AutoscalingPolicyServiceClient.java @@ -64,19 +64,155 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateAutoscalingPolicy + *+ * Creates new autoscaling policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createAutoscalingPolicy(CreateAutoscalingPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createAutoscalingPolicy(LocationName parent, AutoscalingPolicy policy) + *
- createAutoscalingPolicy(RegionName parent, AutoscalingPolicy policy) + *
- createAutoscalingPolicy(String parent, AutoscalingPolicy policy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createAutoscalingPolicyCallable() + *
+ * + *UpdateAutoscalingPolicy + *+ * Updates (replaces) autoscaling policy. + *
Disabled check for update_mask, because all updates will be full replacements.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAutoscalingPolicy(UpdateAutoscalingPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateAutoscalingPolicy(AutoscalingPolicy policy) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateAutoscalingPolicyCallable() + *
+ * + *GetAutoscalingPolicy + *+ * Retrieves autoscaling policy.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getAutoscalingPolicy(GetAutoscalingPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getAutoscalingPolicy(AutoscalingPolicyName name) + *
- getAutoscalingPolicy(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.
+ *+ *
+ *- getAutoscalingPolicyCallable() + *
+ * + *ListAutoscalingPolicies + *+ * Lists autoscaling policies in the project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listAutoscalingPolicies(ListAutoscalingPoliciesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listAutoscalingPolicies(LocationName parent) + *
- listAutoscalingPolicies(RegionName parent) + *
- listAutoscalingPolicies(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.
+ *+ *
+ *- listAutoscalingPoliciesPagedCallable() + *
- listAutoscalingPoliciesCallable() + *
+ * + *DeleteAutoscalingPolicy + *+ * Deletes an autoscaling policy. It is an error to delete an autoscaling policy that is in use by one or more clusters.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAutoscalingPolicy(DeleteAutoscalingPolicyRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteAutoscalingPolicy(AutoscalingPolicyName name) + *
- deleteAutoscalingPolicy(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.
+ *+ *
+ *- deleteAutoscalingPolicyCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getIamPolicyCallable() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/BatchControllerClient.java b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/BatchControllerClient.java index e015edbca1bd..2cfae2d25f27 100644 --- a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/BatchControllerClient.java +++ b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/BatchControllerClient.java @@ -66,19 +66,135 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateBatch + *+ * Creates a batch workload that executes asynchronously.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createBatchAsync(CreateBatchRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createBatchAsync(LocationName parent, Batch batch, String batchId) + *
- createBatchAsync(String parent, Batch batch, String batchId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createBatchOperationCallable() + *
- createBatchCallable() + *
+ * + *GetBatch + *+ * Gets the batch workload resource representation.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getBatch(GetBatchRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getBatch(BatchName name) + *
- getBatch(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.
+ *+ *
+ *- getBatchCallable() + *
+ * + *ListBatches + *+ * Lists batch workloads.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listBatches(ListBatchesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listBatches(LocationName parent) + *
- listBatches(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.
+ *+ *
+ *- listBatchesPagedCallable() + *
- listBatchesCallable() + *
+ * + *DeleteBatch + *+ * Deletes the batch workload resource. If the batch is not in terminal state, the delete fails and the response returns `FAILED_PRECONDITION`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteBatch(DeleteBatchRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteBatch(BatchName name) + *
- deleteBatch(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.
+ *+ *
+ *- deleteBatchCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getIamPolicyCallable() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/ClusterControllerClient.java b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/ClusterControllerClient.java index b01e91611e88..3ee4bf1cb7a8 100644 --- a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/ClusterControllerClient.java +++ b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/ClusterControllerClient.java @@ -70,19 +70,201 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateCluster + *+ * Creates a cluster in a project. The returned [Operation.metadata][google.longrunning.Operation.metadata] will be [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(String projectId, String region, Cluster cluster) + *
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() + *
+ * + *UpdateCluster + *+ * Updates a cluster in a project. The returned [Operation.metadata][google.longrunning.Operation.metadata] will be [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata). The cluster must be in a [`RUNNING`][google.cloud.dataproc.v1.ClusterStatus.State] state or an error is returned.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(String projectId, String region, String clusterName, 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() + *
+ * + *StopCluster + *+ * Stops a cluster in a project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- stopClusterAsync(StopClusterRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- stopClusterOperationCallable() + *
- stopClusterCallable() + *
+ * + *StartCluster + *+ * Starts a cluster in a project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- startClusterAsync(StartClusterRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- startClusterOperationCallable() + *
- startClusterCallable() + *
+ * + *DeleteCluster + *+ * Deletes a cluster in a project. The returned [Operation.metadata][google.longrunning.Operation.metadata] will be [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(String projectId, String region, String clusterName) + *
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() + *
+ * + *GetCluster + *+ * Gets the resource representation for a cluster in a project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(String projectId, String region, String clusterName) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getClusterCallable() + *
+ * + *ListClusters + *+ * Lists all regions/{region}/clusters in a project alphabetically.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(String projectId, String region) + *
- listClusters(String projectId, String region, 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.
+ *+ *
+ *- listClustersPagedCallable() + *
- listClustersCallable() + *
+ * + *DiagnoseCluster + *+ * Gets cluster diagnostic information. The returned [Operation.metadata][google.longrunning.Operation.metadata] will be [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata). After the operation completes, [Operation.response][google.longrunning.Operation.response] contains [DiagnoseClusterResults](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#diagnoseclusterresults).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- diagnoseClusterAsync(DiagnoseClusterRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- diagnoseClusterAsync(String projectId, String region, String clusterName) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- diagnoseClusterOperationCallable() + *
- diagnoseClusterCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getIamPolicyCallable() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/JobControllerClient.java b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/JobControllerClient.java index a83eac827d1f..d1bc79fcb5a9 100644 --- a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/JobControllerClient.java +++ b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/JobControllerClient.java @@ -67,19 +67,182 @@ *
Note: close() needs to be called on the JobControllerClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *SubmitJob + *+ * Submits a job to a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- submitJob(SubmitJobRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- submitJob(String projectId, String region, 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.
+ *+ *
+ *- submitJobCallable() + *
+ * + *SubmitJobAsOperation + *+ * Submits job to a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- submitJobAsOperationAsync(SubmitJobRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- submitJobAsOperationAsync(String projectId, String region, 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.
+ *+ *
+ *- submitJobAsOperationOperationCallable() + *
- submitJobAsOperationCallable() + *
+ * + *GetJob + *+ * Gets the resource representation for a job in a project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(String projectId, String region, 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.
+ *+ *
+ *- getJobCallable() + *
+ * + *ListJobs + *+ * Lists regions/{region}/jobs in a project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(String projectId, String region) + *
- listJobs(String projectId, String region, 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.
+ *+ *
+ *- listJobsPagedCallable() + *
- listJobsCallable() + *
+ * + *UpdateJob + *+ * Updates a job in a project.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateJob(UpdateJobRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateJobCallable() + *
+ * + *CancelJob + *+ * Starts a job cancellation request. To access the job resource after cancellation, call [regions/{region}/jobs.list](https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.jobs/list) or [regions/{region}/jobs.get](https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.jobs/get).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- cancelJob(CancelJobRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- cancelJob(String projectId, String region, 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.
+ *+ *
+ *- cancelJobCallable() + *
+ * + *DeleteJob + *+ * Deletes the job from the project. If the job is active, the delete fails, and the response returns `FAILED_PRECONDITION`.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- 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(String projectId, String region, 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.
+ *+ *
+ *- deleteJobCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getIamPolicyCallable() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/NodeGroupControllerClient.java b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/NodeGroupControllerClient.java index a026258560e7..fd3bb8368727 100644 --- a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/NodeGroupControllerClient.java +++ b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/NodeGroupControllerClient.java @@ -58,19 +58,115 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateNodeGroup + *+ * Creates a node group in a cluster. The returned [Operation.metadata][google.longrunning.Operation.metadata] is [NodeGroupOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#nodegroupoperationmetadata).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createNodeGroupAsync(CreateNodeGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createNodeGroupAsync(ClusterRegionName parent, NodeGroup nodeGroup, String nodeGroupId) + *
- createNodeGroupAsync(String parent, NodeGroup nodeGroup, String nodeGroupId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createNodeGroupOperationCallable() + *
- createNodeGroupCallable() + *
+ * + *ResizeNodeGroup + *+ * Resizes a node group in a cluster. The returned [Operation.metadata][google.longrunning.Operation.metadata] is [NodeGroupOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#nodegroupoperationmetadata).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- resizeNodeGroupAsync(ResizeNodeGroupRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- resizeNodeGroupAsync(String name, int size) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- resizeNodeGroupOperationCallable() + *
- resizeNodeGroupCallable() + *
+ * + *GetNodeGroup + *+ * Gets the resource representation for a node group in a cluster.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getNodeGroup(GetNodeGroupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getNodeGroup(NodeGroupName name) + *
- getNodeGroup(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.
+ *+ *
+ *- getNodeGroupCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getIamPolicyCallable() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/WorkflowTemplateServiceClient.java b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/WorkflowTemplateServiceClient.java index 3d64adb8bccc..0a66ea8ef4fe 100644 --- a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/WorkflowTemplateServiceClient.java +++ b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/WorkflowTemplateServiceClient.java @@ -70,19 +70,207 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateWorkflowTemplate + *+ * Creates new workflow template.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createWorkflowTemplate(CreateWorkflowTemplateRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createWorkflowTemplate(LocationName parent, WorkflowTemplate template) + *
- createWorkflowTemplate(RegionName parent, WorkflowTemplate template) + *
- createWorkflowTemplate(String parent, WorkflowTemplate template) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createWorkflowTemplateCallable() + *
+ * + *GetWorkflowTemplate + *+ * Retrieves the latest workflow template. + *
Can retrieve previously instantiated template by specifying optional version parameter.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getWorkflowTemplate(GetWorkflowTemplateRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getWorkflowTemplate(WorkflowTemplateName name) + *
- getWorkflowTemplate(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.
+ *+ *
+ *- getWorkflowTemplateCallable() + *
+ * + *InstantiateWorkflowTemplate + *+ * Instantiates a template and begins execution. + *
The returned Operation can be used to track execution of workflow by polling [operations.get][google.longrunning.Operations.GetOperation]. The Operation will complete when entire workflow is finished. + *
The running workflow can be aborted via [operations.cancel][google.longrunning.Operations.CancelOperation]. This will cause any inflight jobs to be cancelled and workflow-owned clusters to be deleted. + *
The [Operation.metadata][google.longrunning.Operation.metadata] will be [WorkflowMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#workflowmetadata). Also see [Using WorkflowMetadata](https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata). + *
On successful completion, [Operation.response][google.longrunning.Operation.response] will be [Empty][google.protobuf.Empty].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- instantiateWorkflowTemplateAsync(InstantiateWorkflowTemplateRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- instantiateWorkflowTemplateAsync(WorkflowTemplateName name) + *
- instantiateWorkflowTemplateAsync(String name) + *
- instantiateWorkflowTemplateAsync(WorkflowTemplateName name, Map
parameters) + * - instantiateWorkflowTemplateAsync(String name, Map
parameters) + * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- instantiateWorkflowTemplateOperationCallable() + *
- instantiateWorkflowTemplateCallable() + *
+ * + *InstantiateInlineWorkflowTemplate + *+ * Instantiates a template and begins execution. + *
This method is equivalent to executing the sequence [CreateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.CreateWorkflowTemplate], [InstantiateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.InstantiateWorkflowTemplate], [DeleteWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.DeleteWorkflowTemplate]. + *
The returned Operation can be used to track execution of workflow by polling [operations.get][google.longrunning.Operations.GetOperation]. The Operation will complete when entire workflow is finished. + *
The running workflow can be aborted via [operations.cancel][google.longrunning.Operations.CancelOperation]. This will cause any inflight jobs to be cancelled and workflow-owned clusters to be deleted. + *
The [Operation.metadata][google.longrunning.Operation.metadata] will be [WorkflowMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#workflowmetadata). Also see [Using WorkflowMetadata](https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata). + *
On successful completion, [Operation.response][google.longrunning.Operation.response] will be [Empty][google.protobuf.Empty].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- instantiateInlineWorkflowTemplateAsync(InstantiateInlineWorkflowTemplateRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- instantiateInlineWorkflowTemplateAsync(LocationName parent, WorkflowTemplate template) + *
- instantiateInlineWorkflowTemplateAsync(RegionName parent, WorkflowTemplate template) + *
- instantiateInlineWorkflowTemplateAsync(String parent, WorkflowTemplate template) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- instantiateInlineWorkflowTemplateOperationCallable() + *
- instantiateInlineWorkflowTemplateCallable() + *
+ * + *UpdateWorkflowTemplate + *+ * Updates (replaces) workflow template. The updated template must contain version that matches the current server version.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateWorkflowTemplate(UpdateWorkflowTemplateRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateWorkflowTemplate(WorkflowTemplate template) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateWorkflowTemplateCallable() + *
+ * + *ListWorkflowTemplates + *+ * Lists workflows that match the specified filter in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listWorkflowTemplates(ListWorkflowTemplatesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listWorkflowTemplates(LocationName parent) + *
- listWorkflowTemplates(RegionName parent) + *
- listWorkflowTemplates(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.
+ *+ *
+ *- listWorkflowTemplatesPagedCallable() + *
- listWorkflowTemplatesCallable() + *
+ * + *DeleteWorkflowTemplate + *+ * Deletes a workflow template. It does not cancel in-progress workflows.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteWorkflowTemplate(DeleteWorkflowTemplateRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteWorkflowTemplate(WorkflowTemplateName name) + *
- deleteWorkflowTemplate(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.
+ *+ *
+ *- deleteWorkflowTemplateCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setIamPolicyCallable() + *
+ * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getIamPolicyCallable() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- testIamPermissionsCallable() + *
See the individual methods for example code. * diff --git a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/AutoscalingPolicyServiceStubSettings.java b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/AutoscalingPolicyServiceStubSettings.java index 69a754b15192..7d82cd29a11e 100644 --- a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/AutoscalingPolicyServiceStubSettings.java +++ b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/AutoscalingPolicyServiceStubSettings.java @@ -265,6 +265,12 @@ public AutoscalingPolicyServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataproc"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/BatchControllerStubSettings.java b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/BatchControllerStubSettings.java index 37f735d21584..47ef2dde7ad0 100644 --- a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/BatchControllerStubSettings.java +++ b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/BatchControllerStubSettings.java @@ -237,6 +237,12 @@ public BatchControllerStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataproc"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/ClusterControllerStubSettings.java b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/ClusterControllerStubSettings.java index 5ba58740dc93..83eb42308989 100644 --- a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/ClusterControllerStubSettings.java +++ b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/ClusterControllerStubSettings.java @@ -310,6 +310,12 @@ public ClusterControllerStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataproc"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/JobControllerStubSettings.java b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/JobControllerStubSettings.java index d1994c5cedfd..ac57122e7e86 100644 --- a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/JobControllerStubSettings.java +++ b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/JobControllerStubSettings.java @@ -256,6 +256,12 @@ public JobControllerStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataproc"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/NodeGroupControllerStubSettings.java b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/NodeGroupControllerStubSettings.java index 809983c584c9..424addab9a4d 100644 --- a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/NodeGroupControllerStubSettings.java +++ b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/NodeGroupControllerStubSettings.java @@ -173,6 +173,12 @@ public NodeGroupControllerStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataproc"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/WorkflowTemplateServiceStubSettings.java b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/WorkflowTemplateServiceStubSettings.java index d6bf366dca8e..6f681fb13a03 100644 --- a/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/WorkflowTemplateServiceStubSettings.java +++ b/java-dataproc/google-cloud-dataproc/src/main/java/com/google/cloud/dataproc/v1/stub/WorkflowTemplateServiceStubSettings.java @@ -298,6 +298,12 @@ public WorkflowTemplateServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dataproc"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-datastream/README.md b/java-datastream/README.md index ab23b6289b13..48eebd6b522c 100644 --- a/java-datastream/README.md +++ b/java-datastream/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-datastream.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-datastream/1.29.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-datastream/1.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-datastream/google-cloud-datastream/src/main/java/com/google/cloud/datastream/v1/DatastreamClient.java b/java-datastream/google-cloud-datastream/src/main/java/com/google/cloud/datastream/v1/DatastreamClient.java index b23dfbaf9346..44c4c7c1fbb2 100644 --- a/java-datastream/google-cloud-datastream/src/main/java/com/google/cloud/datastream/v1/DatastreamClient.java +++ b/java-datastream/google-cloud-datastream/src/main/java/com/google/cloud/datastream/v1/DatastreamClient.java @@ -66,19 +66,521 @@ *
Note: close() needs to be called on the DatastreamClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListConnectionProfiles + *+ * Use this method to list connection profiles created in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listConnectionProfiles(ListConnectionProfilesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listConnectionProfiles(LocationName parent) + *
- listConnectionProfiles(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.
+ *+ *
+ *- listConnectionProfilesPagedCallable() + *
- listConnectionProfilesCallable() + *
+ * + *GetConnectionProfile + *+ * Use this method to get details about a connection profile.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getConnectionProfile(GetConnectionProfileRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getConnectionProfile(ConnectionProfileName name) + *
- getConnectionProfile(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.
+ *+ *
+ *- getConnectionProfileCallable() + *
+ * + *CreateConnectionProfile + *+ * Use this method to create a connection profile in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createConnectionProfileAsync(CreateConnectionProfileRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createConnectionProfileAsync(LocationName parent, ConnectionProfile connectionProfile, String connectionProfileId) + *
- createConnectionProfileAsync(String parent, ConnectionProfile connectionProfile, String connectionProfileId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createConnectionProfileOperationCallable() + *
- createConnectionProfileCallable() + *
+ * + *UpdateConnectionProfile + *+ * Use this method to update the parameters of a connection profile.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateConnectionProfileAsync(UpdateConnectionProfileRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateConnectionProfileAsync(ConnectionProfile connectionProfile, 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.
+ *+ *
+ *- updateConnectionProfileOperationCallable() + *
- updateConnectionProfileCallable() + *
+ * + *DeleteConnectionProfile + *+ * Use this method to delete a connection profile.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteConnectionProfileAsync(DeleteConnectionProfileRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteConnectionProfileAsync(ConnectionProfileName name) + *
- deleteConnectionProfileAsync(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.
+ *+ *
+ *- deleteConnectionProfileOperationCallable() + *
- deleteConnectionProfileCallable() + *
+ * + *DiscoverConnectionProfile + *+ * Use this method to discover a connection profile. The discover API call exposes the data objects and metadata belonging to the profile. Typically, a request returns children data objects of a parent data object that's optionally supplied in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- discoverConnectionProfile(DiscoverConnectionProfileRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- discoverConnectionProfileCallable() + *
+ * + *ListStreams + *+ * Use this method to list streams in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listStreams(ListStreamsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listStreams(LocationName parent) + *
- listStreams(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.
+ *+ *
+ *- listStreamsPagedCallable() + *
- listStreamsCallable() + *
+ * + *GetStream + *+ * Use this method to get details about a stream.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getStream(GetStreamRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getStream(StreamName name) + *
- getStream(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.
+ *+ *
+ *- getStreamCallable() + *
+ * + *CreateStream + *+ * Use this method to create a stream.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createStreamAsync(CreateStreamRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createStreamAsync(LocationName parent, Stream stream, String streamId) + *
- createStreamAsync(String parent, Stream stream, String streamId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createStreamOperationCallable() + *
- createStreamCallable() + *
+ * + *UpdateStream + *+ * Use this method to update the configuration of a stream.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateStreamAsync(UpdateStreamRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateStreamAsync(Stream stream, 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.
+ *+ *
+ *- updateStreamOperationCallable() + *
- updateStreamCallable() + *
+ * + *DeleteStream + *+ * Use this method to delete a stream.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteStreamAsync(DeleteStreamRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteStreamAsync(StreamName name) + *
- deleteStreamAsync(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.
+ *+ *
+ *- deleteStreamOperationCallable() + *
- deleteStreamCallable() + *
+ * + *GetStreamObject + *+ * Use this method to get details about a stream object.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getStreamObject(GetStreamObjectRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getStreamObject(StreamObjectName name) + *
- getStreamObject(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.
+ *+ *
+ *- getStreamObjectCallable() + *
+ * + *LookupStreamObject + *+ * Use this method to look up a stream object by its source object identifier.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- lookupStreamObject(LookupStreamObjectRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- lookupStreamObjectCallable() + *
+ * + *ListStreamObjects + *+ * Use this method to list the objects of a specific stream.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listStreamObjects(ListStreamObjectsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listStreamObjects(StreamName parent) + *
- listStreamObjects(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.
+ *+ *
+ *- listStreamObjectsPagedCallable() + *
- listStreamObjectsCallable() + *
+ * + *StartBackfillJob + *+ * Use this method to start a backfill job for the specified stream object.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- startBackfillJob(StartBackfillJobRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- startBackfillJob(StreamObjectName object) + *
- startBackfillJob(String object) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- startBackfillJobCallable() + *
+ * + *StopBackfillJob + *+ * Use this method to stop a backfill job for the specified stream object.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- stopBackfillJob(StopBackfillJobRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- stopBackfillJob(StreamObjectName object) + *
- stopBackfillJob(String object) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- stopBackfillJobCallable() + *
+ * + *FetchStaticIps + *+ * The FetchStaticIps API call exposes the static IP addresses used by Datastream.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- fetchStaticIps(FetchStaticIpsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- fetchStaticIps(LocationName name) + *
- fetchStaticIps(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.
+ *+ *
+ *- fetchStaticIpsPagedCallable() + *
- fetchStaticIpsCallable() + *
+ * + *CreatePrivateConnection + *+ * Use this method to create a private connectivity configuration.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createPrivateConnectionAsync(CreatePrivateConnectionRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createPrivateConnectionAsync(LocationName parent, PrivateConnection privateConnection, String privateConnectionId) + *
- createPrivateConnectionAsync(String parent, PrivateConnection privateConnection, String privateConnectionId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createPrivateConnectionOperationCallable() + *
- createPrivateConnectionCallable() + *
+ * + *GetPrivateConnection + *+ * Use this method to get details about a private connectivity configuration.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getPrivateConnection(GetPrivateConnectionRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getPrivateConnection(PrivateConnectionName name) + *
- getPrivateConnection(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.
+ *+ *
+ *- getPrivateConnectionCallable() + *
+ * + *ListPrivateConnections + *+ * Use this method to list private connectivity configurations in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listPrivateConnections(ListPrivateConnectionsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listPrivateConnections(LocationName parent) + *
- listPrivateConnections(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.
+ *+ *
+ *- listPrivateConnectionsPagedCallable() + *
- listPrivateConnectionsCallable() + *
+ * + *DeletePrivateConnection + *+ * Use this method to delete a private connectivity configuration.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deletePrivateConnectionAsync(DeletePrivateConnectionRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deletePrivateConnectionAsync(PrivateConnectionName name) + *
- deletePrivateConnectionAsync(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.
+ *+ *
+ *- deletePrivateConnectionOperationCallable() + *
- deletePrivateConnectionCallable() + *
+ * + *CreateRoute + *+ * Use this method to create a route for a private connectivity configuration in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createRouteAsync(CreateRouteRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createRouteAsync(PrivateConnectionName parent, Route route, String routeId) + *
- createRouteAsync(String parent, Route route, String routeId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createRouteOperationCallable() + *
- createRouteCallable() + *
+ * + *GetRoute + *+ * Use this method to get details about a route.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getRoute(GetRouteRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getRoute(RouteName name) + *
- getRoute(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.
+ *+ *
+ *- getRouteCallable() + *
+ * + *ListRoutes + *+ * Use this method to list routes created for a private connectivity configuration in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listRoutes(ListRoutesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listRoutes(PrivateConnectionName parent) + *
- listRoutes(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.
+ *+ *
+ *- listRoutesPagedCallable() + *
- listRoutesCallable() + *
+ * + *DeleteRoute + *+ * Use this method to delete a route.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteRouteAsync(DeleteRouteRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteRouteAsync(RouteName name) + *
- deleteRouteAsync(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.
+ *+ *
+ *- deleteRouteOperationCallable() + *
- deleteRouteCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-datastream/google-cloud-datastream/src/main/java/com/google/cloud/datastream/v1/stub/DatastreamStubSettings.java b/java-datastream/google-cloud-datastream/src/main/java/com/google/cloud/datastream/v1/stub/DatastreamStubSettings.java index 31ee9a21a3f9..cc74cd7156dd 100644 --- a/java-datastream/google-cloud-datastream/src/main/java/com/google/cloud/datastream/v1/stub/DatastreamStubSettings.java +++ b/java-datastream/google-cloud-datastream/src/main/java/com/google/cloud/datastream/v1/stub/DatastreamStubSettings.java @@ -879,6 +879,12 @@ public DatastreamStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "datastream"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-datastream/google-cloud-datastream/src/main/java/com/google/cloud/datastream/v1alpha1/DatastreamClient.java b/java-datastream/google-cloud-datastream/src/main/java/com/google/cloud/datastream/v1alpha1/DatastreamClient.java index e22d9863ff3d..612340938cbf 100644 --- a/java-datastream/google-cloud-datastream/src/main/java/com/google/cloud/datastream/v1alpha1/DatastreamClient.java +++ b/java-datastream/google-cloud-datastream/src/main/java/com/google/cloud/datastream/v1alpha1/DatastreamClient.java @@ -62,19 +62,416 @@ *
Note: close() needs to be called on the DatastreamClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListConnectionProfiles + *+ * Use this method to list connection profiles created in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listConnectionProfiles(ListConnectionProfilesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listConnectionProfiles(LocationName parent) + *
- listConnectionProfiles(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.
+ *+ *
+ *- listConnectionProfilesPagedCallable() + *
- listConnectionProfilesCallable() + *
+ * + *GetConnectionProfile + *+ * Use this method to get details about a connection profile.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getConnectionProfile(GetConnectionProfileRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getConnectionProfile(ConnectionProfileName name) + *
- getConnectionProfile(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.
+ *+ *
+ *- getConnectionProfileCallable() + *
+ * + *CreateConnectionProfile + *+ * Use this method to create a connection profile in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createConnectionProfileAsync(CreateConnectionProfileRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createConnectionProfileAsync(LocationName parent, ConnectionProfile connectionProfile, String connectionProfileId) + *
- createConnectionProfileAsync(String parent, ConnectionProfile connectionProfile, String connectionProfileId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createConnectionProfileOperationCallable() + *
- createConnectionProfileCallable() + *
+ * + *UpdateConnectionProfile + *+ * Use this method to update the parameters of a connection profile.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateConnectionProfileAsync(UpdateConnectionProfileRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateConnectionProfileAsync(ConnectionProfile connectionProfile, 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.
+ *+ *
+ *- updateConnectionProfileOperationCallable() + *
- updateConnectionProfileCallable() + *
+ * + *DeleteConnectionProfile + *+ * Use this method to delete a connection profile..
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteConnectionProfileAsync(DeleteConnectionProfileRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteConnectionProfileAsync(ConnectionProfileName name) + *
- deleteConnectionProfileAsync(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.
+ *+ *
+ *- deleteConnectionProfileOperationCallable() + *
- deleteConnectionProfileCallable() + *
+ * + *DiscoverConnectionProfile + *+ * Use this method to discover a connection profile. The discover API call exposes the data objects and metadata belonging to the profile. Typically, a request returns children data objects under a parent data object that's optionally supplied in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- discoverConnectionProfile(DiscoverConnectionProfileRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- discoverConnectionProfileCallable() + *
+ * + *ListStreams + *+ * Use this method to list streams in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listStreams(ListStreamsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listStreams(LocationName parent) + *
- listStreams(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.
+ *+ *
+ *- listStreamsPagedCallable() + *
- listStreamsCallable() + *
+ * + *GetStream + *+ * Use this method to get details about a stream.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getStream(GetStreamRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getStream(StreamName name) + *
- getStream(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.
+ *+ *
+ *- getStreamCallable() + *
+ * + *CreateStream + *+ * Use this method to create a stream.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createStreamAsync(CreateStreamRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createStreamAsync(LocationName parent, Stream stream, String streamId) + *
- createStreamAsync(String parent, Stream stream, String streamId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createStreamOperationCallable() + *
- createStreamCallable() + *
+ * + *UpdateStream + *+ * Use this method to update the configuration of a stream.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateStreamAsync(UpdateStreamRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateStreamAsync(Stream stream, 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.
+ *+ *
+ *- updateStreamOperationCallable() + *
- updateStreamCallable() + *
+ * + *DeleteStream + *+ * Use this method to delete a stream.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteStreamAsync(DeleteStreamRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteStreamAsync(StreamName name) + *
- deleteStreamAsync(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.
+ *+ *
+ *- deleteStreamOperationCallable() + *
- deleteStreamCallable() + *
+ * + *FetchErrors + *+ * Use this method to fetch any errors associated with a stream.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- fetchErrorsAsync(FetchErrorsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- fetchErrorsOperationCallable() + *
- fetchErrorsCallable() + *
+ * + *FetchStaticIps + *+ * The FetchStaticIps API call exposes the static ips used by Datastream. Typically, a request returns children data objects under a parent data object that's optionally supplied in the request.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- fetchStaticIps(FetchStaticIpsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- fetchStaticIps(LocationName name) + *
- fetchStaticIps(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.
+ *+ *
+ *- fetchStaticIpsPagedCallable() + *
- fetchStaticIpsCallable() + *
+ * + *CreatePrivateConnection + *+ * Use this method to create a private connectivity configuration.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createPrivateConnectionAsync(CreatePrivateConnectionRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createPrivateConnectionAsync(LocationName parent, PrivateConnection privateConnection, String privateConnectionId) + *
- createPrivateConnectionAsync(String parent, PrivateConnection privateConnection, String privateConnectionId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createPrivateConnectionOperationCallable() + *
- createPrivateConnectionCallable() + *
+ * + *GetPrivateConnection + *+ * Use this method to get details about a private connectivity configuration.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getPrivateConnection(GetPrivateConnectionRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getPrivateConnection(PrivateConnectionName name) + *
- getPrivateConnection(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.
+ *+ *
+ *- getPrivateConnectionCallable() + *
+ * + *ListPrivateConnections + *+ * Use this method to list private connectivity configurations in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listPrivateConnections(ListPrivateConnectionsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listPrivateConnections(LocationName parent) + *
- listPrivateConnections(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.
+ *+ *
+ *- listPrivateConnectionsPagedCallable() + *
- listPrivateConnectionsCallable() + *
+ * + *DeletePrivateConnection + *+ * Use this method to delete a private connectivity configuration.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deletePrivateConnectionAsync(DeletePrivateConnectionRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deletePrivateConnectionAsync(PrivateConnectionName name) + *
- deletePrivateConnectionAsync(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.
+ *+ *
+ *- deletePrivateConnectionOperationCallable() + *
- deletePrivateConnectionCallable() + *
+ * + *CreateRoute + *+ * Use this method to create a route for a private connectivity in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createRouteAsync(CreateRouteRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createRouteAsync(PrivateConnectionName parent, Route route, String routeId) + *
- createRouteAsync(String parent, Route route, String routeId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createRouteOperationCallable() + *
- createRouteCallable() + *
+ * + *GetRoute + *+ * Use this method to get details about a route.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getRoute(GetRouteRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getRoute(RouteName name) + *
- getRoute(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.
+ *+ *
+ *- getRouteCallable() + *
+ * + *ListRoutes + *+ * Use this method to list routes created for a private connectivity in a project and location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listRoutes(ListRoutesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listRoutes(PrivateConnectionName parent) + *
- listRoutes(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.
+ *+ *
+ *- listRoutesPagedCallable() + *
- listRoutesCallable() + *
+ * + * + *DeleteRoute + *+ * Use this method to delete a route.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteRouteAsync(DeleteRouteRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- deleteRouteAsync(RouteName name) + *
- deleteRouteAsync(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.
+ *+ *
+ *- deleteRouteOperationCallable() + *
- deleteRouteCallable() + *
See the individual methods for example code. * diff --git a/java-datastream/google-cloud-datastream/src/main/java/com/google/cloud/datastream/v1alpha1/stub/DatastreamStubSettings.java b/java-datastream/google-cloud-datastream/src/main/java/com/google/cloud/datastream/v1alpha1/stub/DatastreamStubSettings.java index 8b9d95dc1bbc..00236f78b7ab 100644 --- a/java-datastream/google-cloud-datastream/src/main/java/com/google/cloud/datastream/v1alpha1/stub/DatastreamStubSettings.java +++ b/java-datastream/google-cloud-datastream/src/main/java/com/google/cloud/datastream/v1alpha1/stub/DatastreamStubSettings.java @@ -713,6 +713,12 @@ public DatastreamStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "datastream"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-debugger-client/README.md b/java-debugger-client/README.md index dc92345a2991..9dac42200850 100644 --- a/java-debugger-client/README.md +++ b/java-debugger-client/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-debugger-client.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-debugger-client/1.30.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-debugger-client/1.32.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-debugger-client/google-cloud-debugger-client/src/main/java/com/google/cloud/debugger/v2/Controller2Client.java b/java-debugger-client/google-cloud-debugger-client/src/main/java/com/google/cloud/debugger/v2/Controller2Client.java index 3cb4bcec31c3..b56d1f9c4c07 100644 --- a/java-debugger-client/google-cloud-debugger-client/src/main/java/com/google/cloud/debugger/v2/Controller2Client.java +++ b/java-debugger-client/google-cloud-debugger-client/src/main/java/com/google/cloud/debugger/v2/Controller2Client.java @@ -70,19 +70,72 @@ *
Note: close() needs to be called on the Controller2Client object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *RegisterDebuggee + *+ * Registers the debuggee with the controller service. + *
All agents attached to the same application must call this method with exactly the same request content to get back the same stable `debuggee_id`. Agents should call this method again whenever `google.rpc.Code.NOT_FOUND` is returned from any controller method. + *
This protocol allows the controller service to disable debuggees, recover from data loss, or change the `debuggee_id` format. Agents must handle `debuggee_id` value changing upon re-registration.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- registerDebuggee(RegisterDebuggeeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- registerDebuggee(Debuggee debuggee) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- registerDebuggeeCallable() + *
+ * + *ListActiveBreakpoints + *+ * Returns the list of all active breakpoints for the debuggee. + *
The breakpoint specification (`location`, `condition`, and `expressions` fields) is semantically immutable, although the field values may change. For example, an agent may update the location line number to reflect the actual line where the breakpoint was set, but this doesn't change the breakpoint semantics. + *
This means that an agent does not need to check if a breakpoint has changed when it encounters the same breakpoint on a successive call. Moreover, an agent should remember the breakpoints that are completed until the controller removes them from the active list to avoid setting those breakpoints again.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listActiveBreakpoints(ListActiveBreakpointsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listActiveBreakpoints(String debuggeeId) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listActiveBreakpointsCallable() + *
+ * + * + *UpdateActiveBreakpoint + *+ * Updates the breakpoint state or mutable fields. The entire Breakpoint message must be sent back to the controller service. + *
Updates to active breakpoint fields are only allowed if the new value does not change the breakpoint specification. Updates to the `location`, `condition` and `expressions` fields should not alter the breakpoint semantics. These may only make changes such as canonicalizing a value or snapping the location to the correct line of code.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateActiveBreakpoint(UpdateActiveBreakpointRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateActiveBreakpoint(String debuggeeId, Breakpoint breakpoint) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- updateActiveBreakpointCallable() + *
See the individual methods for example code. * diff --git a/java-debugger-client/google-cloud-debugger-client/src/main/java/com/google/cloud/debugger/v2/Debugger2Client.java b/java-debugger-client/google-cloud-debugger-client/src/main/java/com/google/cloud/debugger/v2/Debugger2Client.java index 64d7b7099463..4932c9ef0909 100644 --- a/java-debugger-client/google-cloud-debugger-client/src/main/java/com/google/cloud/debugger/v2/Debugger2Client.java +++ b/java-debugger-client/google-cloud-debugger-client/src/main/java/com/google/cloud/debugger/v2/Debugger2Client.java @@ -70,19 +70,103 @@ *
Note: close() needs to be called on the Debugger2Client object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *SetBreakpoint + *+ * Sets the breakpoint to the debuggee.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- setBreakpoint(SetBreakpointRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- setBreakpoint(String debuggeeId, Breakpoint breakpoint, String clientVersion) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- setBreakpointCallable() + *
+ * + *GetBreakpoint + *+ * Gets breakpoint information.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getBreakpoint(GetBreakpointRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getBreakpoint(String debuggeeId, String breakpointId, String clientVersion) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getBreakpointCallable() + *
+ * + *DeleteBreakpoint + *+ * Deletes the breakpoint from the debuggee.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteBreakpoint(DeleteBreakpointRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteBreakpoint(String debuggeeId, String breakpointId, String clientVersion) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deleteBreakpointCallable() + *
+ * + *ListBreakpoints + *+ * Lists all breakpoints for the debuggee.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listBreakpoints(ListBreakpointsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listBreakpoints(String debuggeeId, String clientVersion) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listBreakpointsCallable() + *
+ * + * + *ListDebuggees + *+ * Lists all the debuggees that the user has access to.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listDebuggees(ListDebuggeesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listDebuggees(String project, String clientVersion) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- listDebuggeesCallable() + *
See the individual methods for example code. * diff --git a/java-debugger-client/google-cloud-debugger-client/src/main/java/com/google/cloud/debugger/v2/stub/Controller2StubSettings.java b/java-debugger-client/google-cloud-debugger-client/src/main/java/com/google/cloud/debugger/v2/stub/Controller2StubSettings.java index 3be785cb2570..0c78efbc797c 100644 --- a/java-debugger-client/google-cloud-debugger-client/src/main/java/com/google/cloud/debugger/v2/stub/Controller2StubSettings.java +++ b/java-debugger-client/google-cloud-debugger-client/src/main/java/com/google/cloud/debugger/v2/stub/Controller2StubSettings.java @@ -136,6 +136,12 @@ public Controller2Stub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "clouddebugger"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-debugger-client/google-cloud-debugger-client/src/main/java/com/google/cloud/debugger/v2/stub/Debugger2StubSettings.java b/java-debugger-client/google-cloud-debugger-client/src/main/java/com/google/cloud/debugger/v2/stub/Debugger2StubSettings.java index 403b1aa5ca4a..15409698a495 100644 --- a/java-debugger-client/google-cloud-debugger-client/src/main/java/com/google/cloud/debugger/v2/stub/Debugger2StubSettings.java +++ b/java-debugger-client/google-cloud-debugger-client/src/main/java/com/google/cloud/debugger/v2/stub/Debugger2StubSettings.java @@ -150,6 +150,12 @@ public Debugger2Stub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "clouddebugger"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/README.md b/java-dialogflow-cx/README.md index 1238e83efed7..0091315b6710 100644 --- a/java-dialogflow-cx/README.md +++ b/java-dialogflow-cx/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-dialogflow-cx.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-dialogflow-cx/0.42.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-dialogflow-cx/0.43.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-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/AgentsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/AgentsClient.java index d87d69f31efb..26a16715c334 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/AgentsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/AgentsClient.java @@ -66,19 +66,245 @@ *
Note: close() needs to be called on the AgentsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListAgents + *+ * Returns the list of all agents in the specified location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listAgents(ListAgentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listAgents(LocationName parent) + *
- listAgents(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.
+ *+ *
+ *- listAgentsPagedCallable() + *
- listAgentsCallable() + *
+ * + *GetAgent + *+ * Retrieves the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getAgent(GetAgentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getAgent(AgentName name) + *
- getAgent(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.
+ *+ *
+ *- getAgentCallable() + *
+ * + *CreateAgent + *+ * Creates an agent in the specified location. + *
Note: You should always train flows prior to sending them queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createAgent(CreateAgentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createAgent(LocationName parent, Agent agent) + *
- createAgent(String parent, Agent agent) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createAgentCallable() + *
+ * + *UpdateAgent + *+ * Updates the specified agent. + *
Note: You should always train flows prior to sending them queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAgent(UpdateAgentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateAgent(Agent agent, 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.
+ *+ *
+ *- updateAgentCallable() + *
+ * + *DeleteAgent + *+ * Deletes the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAgent(DeleteAgentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteAgent(AgentName name) + *
- deleteAgent(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.
+ *+ *
+ *- deleteAgentCallable() + *
+ * + *ExportAgent + *+ * Exports the specified agent to a binary file. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`: [ExportAgentResponse][google.cloud.dialogflow.cx.v3.ExportAgentResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- exportAgentAsync(ExportAgentRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- exportAgentOperationCallable() + *
- exportAgentCallable() + *
+ * + *RestoreAgent + *+ * Restores the specified agent from a binary file. + *
Replaces the current agent with a new one. Note that all existing resources in agent (e.g. intents, entity types, flows) will be removed. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [Empty message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty) + *
Note: You should always train flows prior to sending them queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- restoreAgentAsync(RestoreAgentRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- restoreAgentOperationCallable() + *
- restoreAgentCallable() + *
+ * + *ValidateAgent + *+ * Validates the specified agent and creates or updates validation results. The agent in draft version is validated. Please call this API after the training is completed to get the complete validation results.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- validateAgent(ValidateAgentRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- validateAgentCallable() + *
+ * + *GetAgentValidationResult + *+ * Gets the latest agent validation result. Agent validation is performed when ValidateAgent is called.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getAgentValidationResult(GetAgentValidationResultRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getAgentValidationResult(AgentValidationResultName name) + *
- getAgentValidationResult(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.
+ *+ *
+ *- getAgentValidationResultCallable() + *
+ * + *GetGenerativeSettings + *+ * Gets the generative settings for the agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getGenerativeSettings(GetGenerativeSettingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getGenerativeSettings(AgentGenerativeSettingsName name, String languageCode) + *
- getGenerativeSettings(String name, String languageCode) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getGenerativeSettingsCallable() + *
+ * + *UpdateGenerativeSettings + *+ * Updates the generative settings for the agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateGenerativeSettings(UpdateGenerativeSettingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateGenerativeSettings(GenerativeSettings generativeSettings, 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.
+ *+ *
+ *- updateGenerativeSettingsCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/ChangelogsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/ChangelogsClient.java index d888d1518a94..75f314ee0a7e 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/ChangelogsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/ChangelogsClient.java @@ -58,19 +58,81 @@ *
Note: close() needs to be called on the ChangelogsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListChangelogs + *+ * Returns the list of Changelogs.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listChangelogs(ListChangelogsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listChangelogs(AgentName parent) + *
- listChangelogs(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.
+ *+ *
+ *- listChangelogsPagedCallable() + *
- listChangelogsCallable() + *
+ * + *GetChangelog + *+ * Retrieves the specified Changelog.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getChangelog(GetChangelogRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getChangelog(ChangelogName name) + *
- getChangelog(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.
+ *+ *
+ *- getChangelogCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/DeploymentsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/DeploymentsClient.java index a6ec9dde740e..728d948fb558 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/DeploymentsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/DeploymentsClient.java @@ -60,19 +60,81 @@ *
Note: close() needs to be called on the DeploymentsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListDeployments + *+ * Returns the list of all deployments in the specified [Environment][google.cloud.dialogflow.cx.v3.Environment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listDeployments(ListDeploymentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listDeployments(EnvironmentName parent) + *
- listDeployments(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.
+ *+ *
+ *- listDeploymentsPagedCallable() + *
- listDeploymentsCallable() + *
+ * + *GetDeployment + *+ * Retrieves the specified [Deployment][google.cloud.dialogflow.cx.v3.Deployment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getDeployment(GetDeploymentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getDeployment(DeploymentName name) + *
- getDeployment(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.
+ *+ *
+ *- getDeploymentCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/EntityTypesClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/EntityTypesClient.java index c8c70522fad0..95bd034c91d5 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/EntityTypesClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/EntityTypesClient.java @@ -62,19 +62,140 @@ *
Note: close() needs to be called on the EntityTypesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *GetEntityType + *+ * Retrieves the specified entity type.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getEntityType(GetEntityTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getEntityType(EntityTypeName name) + *
- getEntityType(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.
+ *+ *
+ *- getEntityTypeCallable() + *
+ * + *CreateEntityType + *+ * Creates an entity type in the specified agent. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createEntityType(CreateEntityTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createEntityType(AgentName parent, EntityType entityType) + *
- createEntityType(String parent, EntityType entityType) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createEntityTypeCallable() + *
+ * + *UpdateEntityType + *+ * Updates the specified entity type. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateEntityType(UpdateEntityTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateEntityType(EntityType entityType, 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.
+ *+ *
+ *- updateEntityTypeCallable() + *
+ * + *DeleteEntityType + *+ * Deletes the specified entity type. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteEntityType(DeleteEntityTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteEntityType(EntityTypeName name) + *
- deleteEntityType(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.
+ *+ *
+ *- deleteEntityTypeCallable() + *
+ * + *ListEntityTypes + *+ * Returns the list of all entity types in the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listEntityTypes(ListEntityTypesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listEntityTypes(AgentName parent) + *
- listEntityTypes(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.
+ *+ *
+ *- listEntityTypesPagedCallable() + *
- listEntityTypesCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/EnvironmentsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/EnvironmentsClient.java index a246c411c75f..d66afc427f7b 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/EnvironmentsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/EnvironmentsClient.java @@ -68,19 +68,217 @@ *
Note: close() needs to be called on the EnvironmentsClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListEnvironments + *+ * Returns the list of all environments in the specified [Agent][google.cloud.dialogflow.cx.v3.Agent].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listEnvironments(ListEnvironmentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listEnvironments(AgentName parent) + *
- listEnvironments(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.
+ *+ *
+ *- listEnvironmentsPagedCallable() + *
- listEnvironmentsCallable() + *
+ * + *GetEnvironment + *+ * Retrieves the specified [Environment][google.cloud.dialogflow.cx.v3.Environment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getEnvironment(GetEnvironmentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getEnvironment(EnvironmentName name) + *
- getEnvironment(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.
+ *+ *
+ *- getEnvironmentCallable() + *
+ * + *CreateEnvironment + *+ * Creates an [Environment][google.cloud.dialogflow.cx.v3.Environment] in the specified [Agent][google.cloud.dialogflow.cx.v3.Agent]. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`: [Environment][google.cloud.dialogflow.cx.v3.Environment]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createEnvironmentAsync(CreateEnvironmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createEnvironmentAsync(AgentName parent, Environment environment) + *
- createEnvironmentAsync(String parent, Environment environment) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createEnvironmentOperationCallable() + *
- createEnvironmentCallable() + *
+ * + *UpdateEnvironment + *+ * Updates the specified [Environment][google.cloud.dialogflow.cx.v3.Environment]. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`: [Environment][google.cloud.dialogflow.cx.v3.Environment]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateEnvironmentAsync(UpdateEnvironmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateEnvironmentAsync(Environment environment, 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.
+ *+ *
+ *- updateEnvironmentOperationCallable() + *
- updateEnvironmentCallable() + *
+ * + *DeleteEnvironment + *+ * Deletes the specified [Environment][google.cloud.dialogflow.cx.v3.Environment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteEnvironment(DeleteEnvironmentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteEnvironment(EnvironmentName name) + *
- deleteEnvironment(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.
+ *+ *
+ *- deleteEnvironmentCallable() + *
+ * + *LookupEnvironmentHistory + *+ * Looks up the history of the specified [Environment][google.cloud.dialogflow.cx.v3.Environment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- lookupEnvironmentHistory(LookupEnvironmentHistoryRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- lookupEnvironmentHistory(EnvironmentName name) + *
- lookupEnvironmentHistory(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.
+ *+ *
+ *- lookupEnvironmentHistoryPagedCallable() + *
- lookupEnvironmentHistoryCallable() + *
+ * + *RunContinuousTest + *+ * Kicks off a continuous test under the specified [Environment][google.cloud.dialogflow.cx.v3.Environment]. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [RunContinuousTestMetadata][google.cloud.dialogflow.cx.v3.RunContinuousTestMetadata] - `response`: [RunContinuousTestResponse][google.cloud.dialogflow.cx.v3.RunContinuousTestResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- runContinuousTestAsync(RunContinuousTestRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- runContinuousTestOperationCallable() + *
- runContinuousTestCallable() + *
+ * + *ListContinuousTestResults + *+ * Fetches a list of continuous test results for a given environment.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listContinuousTestResults(ListContinuousTestResultsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listContinuousTestResults(EnvironmentName parent) + *
- listContinuousTestResults(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.
+ *+ *
+ *- listContinuousTestResultsPagedCallable() + *
- listContinuousTestResultsCallable() + *
+ * + *DeployFlow + *+ * Deploys a flow to the specified [Environment][google.cloud.dialogflow.cx.v3.Environment]. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [DeployFlowMetadata][google.cloud.dialogflow.cx.v3.DeployFlowMetadata] - `response`: [DeployFlowResponse][google.cloud.dialogflow.cx.v3.DeployFlowResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deployFlowAsync(DeployFlowRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deployFlowOperationCallable() + *
- deployFlowCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/ExperimentsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/ExperimentsClient.java index adafeb33d8fe..f5d7a25ecbdc 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/ExperimentsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/ExperimentsClient.java @@ -62,19 +62,175 @@ *
Note: close() needs to be called on the ExperimentsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListExperiments + *+ * Returns the list of all experiments in the specified [Environment][google.cloud.dialogflow.cx.v3.Environment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listExperiments(ListExperimentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listExperiments(EnvironmentName parent) + *
- listExperiments(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.
+ *+ *
+ *- listExperimentsPagedCallable() + *
- listExperimentsCallable() + *
+ * + *GetExperiment + *+ * Retrieves the specified [Experiment][google.cloud.dialogflow.cx.v3.Experiment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getExperiment(GetExperimentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getExperiment(ExperimentName name) + *
- getExperiment(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.
+ *+ *
+ *- getExperimentCallable() + *
+ * + *CreateExperiment + *+ * Creates an [Experiment][google.cloud.dialogflow.cx.v3.Experiment] in the specified [Environment][google.cloud.dialogflow.cx.v3.Environment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createExperiment(CreateExperimentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createExperiment(EnvironmentName parent, Experiment experiment) + *
- createExperiment(String parent, Experiment experiment) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createExperimentCallable() + *
+ * + *UpdateExperiment + *+ * Updates the specified [Experiment][google.cloud.dialogflow.cx.v3.Experiment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateExperiment(UpdateExperimentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateExperiment(Experiment experiment, 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.
+ *+ *
+ *- updateExperimentCallable() + *
+ * + *DeleteExperiment + *+ * Deletes the specified [Experiment][google.cloud.dialogflow.cx.v3.Experiment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteExperiment(DeleteExperimentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteExperiment(ExperimentName name) + *
- deleteExperiment(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.
+ *+ *
+ *- deleteExperimentCallable() + *
+ * + *StartExperiment + *+ * Starts the specified [Experiment][google.cloud.dialogflow.cx.v3.Experiment]. This rpc only changes the state of experiment from PENDING to RUNNING.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- startExperiment(StartExperimentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- startExperiment(ExperimentName name) + *
- startExperiment(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.
+ *+ *
+ *- startExperimentCallable() + *
+ * + *StopExperiment + *+ * Stops the specified [Experiment][google.cloud.dialogflow.cx.v3.Experiment]. This rpc only changes the state of experiment from RUNNING to DONE.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- stopExperiment(StopExperimentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- stopExperiment(ExperimentName name) + *
- stopExperiment(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.
+ *+ *
+ *- stopExperimentCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/FlowsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/FlowsClient.java index be2ebc6af765..85bc81e98448 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/FlowsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/FlowsClient.java @@ -67,19 +67,231 @@ *
Note: close() needs to be called on the FlowsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateFlow + *+ * Creates a flow in the specified agent. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createFlow(CreateFlowRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createFlow(AgentName parent, Flow flow) + *
- createFlow(String parent, Flow flow) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createFlowCallable() + *
+ * + *DeleteFlow + *+ * Deletes a specified flow.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteFlow(DeleteFlowRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteFlow(FlowName name) + *
- deleteFlow(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.
+ *+ *
+ *- deleteFlowCallable() + *
+ * + *ListFlows + *+ * Returns the list of all flows in the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listFlows(ListFlowsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listFlows(AgentName parent) + *
- listFlows(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.
+ *+ *
+ *- listFlowsPagedCallable() + *
- listFlowsCallable() + *
+ * + *GetFlow + *+ * Retrieves the specified flow.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getFlow(GetFlowRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getFlow(FlowName name) + *
- getFlow(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.
+ *+ *
+ *- getFlowCallable() + *
+ * + *UpdateFlow + *+ * Updates the specified flow. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateFlow(UpdateFlowRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateFlow(Flow flow, 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.
+ *+ *
+ *- updateFlowCallable() + *
+ * + *TrainFlow + *+ * Trains the specified flow. Note that only the flow in 'draft' environment is trained. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [Empty message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty) + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- trainFlowAsync(TrainFlowRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- trainFlowAsync(FlowName name) + *
- trainFlowAsync(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.
+ *+ *
+ *- trainFlowOperationCallable() + *
- trainFlowCallable() + *
+ * + *ValidateFlow + *+ * Validates the specified flow and creates or updates validation results. Please call this API after the training is completed to get the complete validation results.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- validateFlow(ValidateFlowRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- validateFlowCallable() + *
+ * + *GetFlowValidationResult + *+ * Gets the latest flow validation result. Flow validation is performed when ValidateFlow is called.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getFlowValidationResult(GetFlowValidationResultRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getFlowValidationResult(FlowValidationResultName name) + *
- getFlowValidationResult(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.
+ *+ *
+ *- getFlowValidationResultCallable() + *
+ * + *ImportFlow + *+ * Imports the specified flow to the specified agent from a binary file. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`: [ImportFlowResponse][google.cloud.dialogflow.cx.v3.ImportFlowResponse] + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- importFlowAsync(ImportFlowRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- importFlowOperationCallable() + *
- importFlowCallable() + *
+ * + *ExportFlow + *+ * Exports the specified flow to a binary file. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`: [ExportFlowResponse][google.cloud.dialogflow.cx.v3.ExportFlowResponse] + *
Note that resources (e.g. intents, entities, webhooks) that the flow references will also be exported.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- exportFlowAsync(ExportFlowRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- exportFlowOperationCallable() + *
- exportFlowCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/GeneratorsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/GeneratorsClient.java index 428583b6686b..6f09b5bc85f5 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/GeneratorsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/GeneratorsClient.java @@ -60,19 +60,137 @@ *
Note: close() needs to be called on the GeneratorsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListGenerators + *+ * Returns the list of all generators in the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listGenerators(ListGeneratorsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listGenerators(AgentName parent) + *
- listGenerators(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.
+ *+ *
+ *- listGeneratorsPagedCallable() + *
- listGeneratorsCallable() + *
+ * + *GetGenerator + *+ * Retrieves the specified generator.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getGenerator(GetGeneratorRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getGenerator(GeneratorName name) + *
- getGenerator(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.
+ *+ *
+ *- getGeneratorCallable() + *
+ * + *CreateGenerator + *+ * Creates a generator in the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createGenerator(CreateGeneratorRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createGenerator(AgentName parent, Generator generator) + *
- createGenerator(String parent, Generator generator) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createGeneratorCallable() + *
+ * + *UpdateGenerator + *+ * Update the specified generator.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateGenerator(UpdateGeneratorRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateGenerator(Generator generator, 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.
+ *+ *
+ *- updateGeneratorCallable() + *
+ * + *DeleteGenerator + *+ * Deletes the specified generators.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteGenerator(DeleteGeneratorRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteGenerator(GeneratorName name) + *
- deleteGenerator(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.
+ *+ *
+ *- deleteGeneratorCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/IntentsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/IntentsClient.java index 9bd8ddda9896..dd631a06c44e 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/IntentsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/IntentsClient.java @@ -65,19 +65,174 @@ *
Note: close() needs to be called on the IntentsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListIntents + *+ * Returns the list of all intents in the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listIntents(ListIntentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listIntents(AgentName parent) + *
- listIntents(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.
+ *+ *
+ *- listIntentsPagedCallable() + *
- listIntentsCallable() + *
+ * + *GetIntent + *+ * Retrieves the specified intent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIntent(GetIntentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getIntent(IntentName name) + *
- getIntent(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.
+ *+ *
+ *- getIntentCallable() + *
+ * + *CreateIntent + *+ * Creates an intent in the specified agent. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createIntent(CreateIntentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createIntent(AgentName parent, Intent intent) + *
- createIntent(String parent, Intent intent) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createIntentCallable() + *
+ * + *UpdateIntent + *+ * Updates the specified intent. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateIntent(UpdateIntentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateIntent(Intent intent, 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.
+ *+ *
+ *- updateIntentCallable() + *
+ * + *DeleteIntent + *+ * Deletes the specified intent. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteIntent(DeleteIntentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteIntent(IntentName name) + *
- deleteIntent(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.
+ *+ *
+ *- deleteIntentCallable() + *
+ * + *ImportIntents + *+ * Imports the specified intents into the agent. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [ImportIntentsMetadata][google.cloud.dialogflow.cx.v3.ImportIntentsMetadata] - `response`: [ImportIntentsResponse][google.cloud.dialogflow.cx.v3.ImportIntentsResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- importIntentsAsync(ImportIntentsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- importIntentsOperationCallable() + *
- importIntentsCallable() + *
+ * + *ExportIntents + *+ * Exports the selected intents. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [ExportIntentsMetadata][google.cloud.dialogflow.cx.v3.ExportIntentsMetadata] - `response`: [ExportIntentsResponse][google.cloud.dialogflow.cx.v3.ExportIntentsResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- exportIntentsAsync(ExportIntentsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- exportIntentsOperationCallable() + *
- exportIntentsCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/PagesClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/PagesClient.java index e7bb52d29de3..d39e131770c3 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/PagesClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/PagesClient.java @@ -60,19 +60,140 @@ *
Note: close() needs to be called on the PagesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListPages + *+ * Returns the list of all pages in the specified flow.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listPages(ListPagesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listPages(FlowName parent) + *
- listPages(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.
+ *+ *
+ *- listPagesPagedCallable() + *
- listPagesCallable() + *
+ * + *GetPage + *+ * Retrieves the specified page.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getPage(GetPageRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getPage(PageName name) + *
- getPage(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.
+ *+ *
+ *- getPageCallable() + *
+ * + *CreatePage + *+ * Creates a page in the specified flow. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createPage(CreatePageRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createPage(FlowName parent, Page page) + *
- createPage(String parent, Page page) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createPageCallable() + *
+ * + *UpdatePage + *+ * Updates the specified page. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updatePage(UpdatePageRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updatePage(Page page, 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.
+ *+ *
+ *- updatePageCallable() + *
+ * + *DeletePage + *+ * Deletes the specified page. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deletePage(DeletePageRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deletePage(PageName name) + *
- deletePage(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.
+ *+ *
+ *- deletePageCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/SecuritySettingsServiceClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/SecuritySettingsServiceClient.java index 326a3eac44ea..f8aa1be71976 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/SecuritySettingsServiceClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/SecuritySettingsServiceClient.java @@ -64,19 +64,137 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateSecuritySettings + *+ * Create security settings in the specified location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createSecuritySettings(CreateSecuritySettingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createSecuritySettings(LocationName parent, SecuritySettings securitySettings) + *
- createSecuritySettings(String parent, SecuritySettings securitySettings) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createSecuritySettingsCallable() + *
+ * + *GetSecuritySettings + *+ * Retrieves the specified [SecuritySettings][google.cloud.dialogflow.cx.v3.SecuritySettings]. The returned settings may be stale by up to 1 minute.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getSecuritySettings(GetSecuritySettingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getSecuritySettings(SecuritySettingsName name) + *
- getSecuritySettings(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.
+ *+ *
+ *- getSecuritySettingsCallable() + *
+ * + *UpdateSecuritySettings + *+ * Updates the specified [SecuritySettings][google.cloud.dialogflow.cx.v3.SecuritySettings].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateSecuritySettings(UpdateSecuritySettingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateSecuritySettings(SecuritySettings securitySettings, 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.
+ *+ *
+ *- updateSecuritySettingsCallable() + *
+ * + *ListSecuritySettings + *+ * Returns the list of all security settings in the specified location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listSecuritySettings(ListSecuritySettingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listSecuritySettings(LocationName parent) + *
- listSecuritySettings(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.
+ *+ *
+ *- listSecuritySettingsPagedCallable() + *
- listSecuritySettingsCallable() + *
+ * + *DeleteSecuritySettings + *+ * Deletes the specified [SecuritySettings][google.cloud.dialogflow.cx.v3.SecuritySettings].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteSecuritySettings(DeleteSecuritySettingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteSecuritySettings(SecuritySettingsName name) + *
- deleteSecuritySettings(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.
+ *+ *
+ *- deleteSecuritySettingsCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/SessionEntityTypesClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/SessionEntityTypesClient.java index 401291a4ecdd..e24c57673488 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/SessionEntityTypesClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/SessionEntityTypesClient.java @@ -64,19 +64,137 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListSessionEntityTypes + *+ * Returns the list of all session entity types in the specified session.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listSessionEntityTypes(ListSessionEntityTypesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listSessionEntityTypes(SessionName parent) + *
- listSessionEntityTypes(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.
+ *+ *
+ *- listSessionEntityTypesPagedCallable() + *
- listSessionEntityTypesCallable() + *
+ * + *GetSessionEntityType + *+ * Retrieves the specified session entity type.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getSessionEntityType(GetSessionEntityTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getSessionEntityType(SessionEntityTypeName name) + *
- getSessionEntityType(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.
+ *+ *
+ *- getSessionEntityTypeCallable() + *
+ * + *CreateSessionEntityType + *+ * Creates a session entity type.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createSessionEntityType(CreateSessionEntityTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createSessionEntityType(SessionName parent, SessionEntityType sessionEntityType) + *
- createSessionEntityType(String parent, SessionEntityType sessionEntityType) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createSessionEntityTypeCallable() + *
+ * + *UpdateSessionEntityType + *+ * Updates the specified session entity type.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateSessionEntityType(UpdateSessionEntityTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateSessionEntityType(SessionEntityType sessionEntityType, 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.
+ *+ *
+ *- updateSessionEntityTypeCallable() + *
+ * + *DeleteSessionEntityType + *+ * Deletes the specified session entity type.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteSessionEntityType(DeleteSessionEntityTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteSessionEntityType(SessionEntityTypeName name) + *
- deleteSessionEntityType(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.
+ *+ *
+ *- deleteSessionEntityTypeCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/SessionsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/SessionsClient.java index cc581037ac33..ff06787a45cd 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/SessionsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/SessionsClient.java @@ -70,19 +70,110 @@ *
Note: close() needs to be called on the SessionsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *DetectIntent + *+ * Processes a natural language query and returns structured, actionable data as a result. This method is not idempotent, because it may cause session entity types to be updated, which in turn might affect results of future queries. + *
Note: Always use agent versions for production traffic. See [Versions and environments](https://cloud.google.com/dialogflow/cx/docs/concept/version).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- detectIntent(DetectIntentRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- detectIntentCallable() + *
+ * + *StreamingDetectIntent + *+ * Processes a natural language query in audio format in a streaming fashion and returns structured, actionable data as a result. This method is only available via the gRPC API (not REST). + *
Note: Always use agent versions for production traffic. See [Versions and environments](https://cloud.google.com/dialogflow/cx/docs/concept/version).
+ * + *Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- streamingDetectIntentCallable() + *
+ * + *MatchIntent + *+ * Returns preliminary intent match results, doesn't change the session status.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- matchIntent(MatchIntentRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- matchIntentCallable() + *
+ * + *FulfillIntent + *+ * Fulfills a matched intent returned by [MatchIntent][google.cloud.dialogflow.cx.v3.Sessions.MatchIntent]. Must be called after [MatchIntent][google.cloud.dialogflow.cx.v3.Sessions.MatchIntent], with input from [MatchIntentResponse][google.cloud.dialogflow.cx.v3.MatchIntentResponse]. Otherwise, the behavior is undefined.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- fulfillIntent(FulfillIntentRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- fulfillIntentCallable() + *
+ * + *SubmitAnswerFeedback + *+ * Updates the feedback received from the user for a single turn of the bot response.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- submitAnswerFeedback(SubmitAnswerFeedbackRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- submitAnswerFeedbackCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/TestCasesClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/TestCasesClient.java index 26418eaaa704..0538fab27def 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/TestCasesClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/TestCasesClient.java @@ -66,19 +66,258 @@ *
Note: close() needs to be called on the TestCasesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListTestCases + *+ * Fetches a list of test cases for a given agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listTestCases(ListTestCasesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listTestCases(AgentName parent) + *
- listTestCases(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.
+ *+ *
+ *- listTestCasesPagedCallable() + *
- listTestCasesCallable() + *
+ * + *BatchDeleteTestCases + *+ * Batch deletes test cases.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- batchDeleteTestCases(BatchDeleteTestCasesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- batchDeleteTestCases(AgentName parent) + *
- batchDeleteTestCases(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.
+ *+ *
+ *- batchDeleteTestCasesCallable() + *
+ * + *GetTestCase + *+ * Gets a test case.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getTestCase(GetTestCaseRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getTestCase(TestCaseName name) + *
- getTestCase(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.
+ *+ *
+ *- getTestCaseCallable() + *
+ * + *CreateTestCase + *+ * Creates a test case for the given agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createTestCase(CreateTestCaseRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createTestCase(AgentName parent, TestCase testCase) + *
- createTestCase(String parent, TestCase testCase) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createTestCaseCallable() + *
+ * + *UpdateTestCase + *+ * Updates the specified test case.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateTestCase(UpdateTestCaseRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateTestCase(TestCase testCase, 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.
+ *+ *
+ *- updateTestCaseCallable() + *
+ * + *RunTestCase + *+ * Kicks off a test case run. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [RunTestCaseMetadata][google.cloud.dialogflow.cx.v3.RunTestCaseMetadata] - `response`: [RunTestCaseResponse][google.cloud.dialogflow.cx.v3.RunTestCaseResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- runTestCaseAsync(RunTestCaseRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- runTestCaseOperationCallable() + *
- runTestCaseCallable() + *
+ * + *BatchRunTestCases + *+ * Kicks off a batch run of test cases. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [BatchRunTestCasesMetadata][google.cloud.dialogflow.cx.v3.BatchRunTestCasesMetadata] - `response`: [BatchRunTestCasesResponse][google.cloud.dialogflow.cx.v3.BatchRunTestCasesResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- batchRunTestCasesAsync(BatchRunTestCasesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- batchRunTestCasesOperationCallable() + *
- batchRunTestCasesCallable() + *
+ * + *CalculateCoverage + *+ * Calculates the test coverage for an agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- calculateCoverage(CalculateCoverageRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- calculateCoverageCallable() + *
+ * + *ImportTestCases + *+ * Imports the test cases from a Cloud Storage bucket or a local file. It always creates new test cases and won't overwrite any existing ones. The provided ID in the imported test case is neglected. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [ImportTestCasesMetadata][google.cloud.dialogflow.cx.v3.ImportTestCasesMetadata] - `response`: [ImportTestCasesResponse][google.cloud.dialogflow.cx.v3.ImportTestCasesResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- importTestCasesAsync(ImportTestCasesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- importTestCasesOperationCallable() + *
- importTestCasesCallable() + *
+ * + *ExportTestCases + *+ * Exports the test cases under the agent to a Cloud Storage bucket or a local file. Filter can be applied to export a subset of test cases. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [ExportTestCasesMetadata][google.cloud.dialogflow.cx.v3.ExportTestCasesMetadata] - `response`: [ExportTestCasesResponse][google.cloud.dialogflow.cx.v3.ExportTestCasesResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- exportTestCasesAsync(ExportTestCasesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- exportTestCasesOperationCallable() + *
- exportTestCasesCallable() + *
+ * + *ListTestCaseResults + *+ * Fetches the list of run results for the given test case. A maximum of 100 results are kept for each test case.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listTestCaseResults(ListTestCaseResultsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listTestCaseResults(TestCaseName parent) + *
- listTestCaseResults(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.
+ *+ *
+ *- listTestCaseResultsPagedCallable() + *
- listTestCaseResultsCallable() + *
+ * + *GetTestCaseResult + *+ * Gets a test case result.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getTestCaseResult(GetTestCaseResultRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getTestCaseResult(TestCaseResultName name) + *
- getTestCaseResult(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.
+ *+ *
+ *- getTestCaseResultCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/TransitionRouteGroupsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/TransitionRouteGroupsClient.java index 01f36ca38fb0..fc75abdfb4e9 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/TransitionRouteGroupsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/TransitionRouteGroupsClient.java @@ -65,19 +65,142 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListTransitionRouteGroups + *+ * Returns the list of all transition route groups in the specified flow.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listTransitionRouteGroups(ListTransitionRouteGroupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listTransitionRouteGroups(AgentName parent) + *
- listTransitionRouteGroups(FlowName parent) + *
- listTransitionRouteGroups(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.
+ *+ *
+ *- listTransitionRouteGroupsPagedCallable() + *
- listTransitionRouteGroupsCallable() + *
+ * + *GetTransitionRouteGroup + *+ * Retrieves the specified [TransitionRouteGroup][google.cloud.dialogflow.cx.v3.TransitionRouteGroup].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getTransitionRouteGroup(GetTransitionRouteGroupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getTransitionRouteGroup(TransitionRouteGroupName name) + *
- getTransitionRouteGroup(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.
+ *+ *
+ *- getTransitionRouteGroupCallable() + *
+ * + *CreateTransitionRouteGroup + *+ * Creates an [TransitionRouteGroup][google.cloud.dialogflow.cx.v3.TransitionRouteGroup] in the specified flow. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createTransitionRouteGroup(CreateTransitionRouteGroupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createTransitionRouteGroup(AgentName parent, TransitionRouteGroup transitionRouteGroup) + *
- createTransitionRouteGroup(FlowName parent, TransitionRouteGroup transitionRouteGroup) + *
- createTransitionRouteGroup(String parent, TransitionRouteGroup transitionRouteGroup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createTransitionRouteGroupCallable() + *
+ * + *UpdateTransitionRouteGroup + *+ * Updates the specified [TransitionRouteGroup][google.cloud.dialogflow.cx.v3.TransitionRouteGroup]. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateTransitionRouteGroup(UpdateTransitionRouteGroupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateTransitionRouteGroup(TransitionRouteGroup transitionRouteGroup, 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.
+ *+ *
+ *- updateTransitionRouteGroupCallable() + *
+ * + *DeleteTransitionRouteGroup + *+ * Deletes the specified [TransitionRouteGroup][google.cloud.dialogflow.cx.v3.TransitionRouteGroup]. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteTransitionRouteGroup(DeleteTransitionRouteGroupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteTransitionRouteGroup(TransitionRouteGroupName name) + *
- deleteTransitionRouteGroup(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.
+ *+ *
+ *- deleteTransitionRouteGroupCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/VersionsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/VersionsClient.java index fe668185fce2..b98e02e6b598 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/VersionsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/VersionsClient.java @@ -67,19 +67,181 @@ *
Note: close() needs to be called on the VersionsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListVersions + *+ * Returns the list of all versions in the specified [Flow][google.cloud.dialogflow.cx.v3.Flow].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listVersions(ListVersionsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listVersions(FlowName parent) + *
- listVersions(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.
+ *+ *
+ *- listVersionsPagedCallable() + *
- listVersionsCallable() + *
+ * + *GetVersion + *+ * Retrieves the specified [Version][google.cloud.dialogflow.cx.v3.Version].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getVersion(GetVersionRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getVersion(VersionName name) + *
- getVersion(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.
+ *+ *
+ *- getVersionCallable() + *
+ * + *CreateVersion + *+ * Creates a [Version][google.cloud.dialogflow.cx.v3.Version] in the specified [Flow][google.cloud.dialogflow.cx.v3.Flow]. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [CreateVersionOperationMetadata][google.cloud.dialogflow.cx.v3.CreateVersionOperationMetadata] - `response`: [Version][google.cloud.dialogflow.cx.v3.Version]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createVersionAsync(CreateVersionRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createVersionAsync(FlowName parent, Version version) + *
- createVersionAsync(String parent, Version version) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createVersionOperationCallable() + *
- createVersionCallable() + *
+ * + *UpdateVersion + *+ * Updates the specified [Version][google.cloud.dialogflow.cx.v3.Version].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateVersion(UpdateVersionRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateVersion(Version version, 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.
+ *+ *
+ *- updateVersionCallable() + *
+ * + *DeleteVersion + *+ * Deletes the specified [Version][google.cloud.dialogflow.cx.v3.Version].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteVersion(DeleteVersionRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteVersion(VersionName name) + *
- deleteVersion(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.
+ *+ *
+ *- deleteVersionCallable() + *
+ * + *LoadVersion + *+ * Loads resources in the specified version to the draft flow. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [Empty message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- loadVersionAsync(LoadVersionRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- loadVersionAsync(VersionName name) + *
- loadVersionAsync(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.
+ *+ *
+ *- loadVersionOperationCallable() + *
- loadVersionCallable() + *
+ * + *CompareVersions + *+ * Compares the specified base version with target version.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- compareVersions(CompareVersionsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- compareVersions(VersionName baseVersion) + *
- compareVersions(String baseVersion) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- compareVersionsCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/WebhooksClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/WebhooksClient.java index 964462c4bef6..691d638626a1 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/WebhooksClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/WebhooksClient.java @@ -60,19 +60,137 @@ *
Note: close() needs to be called on the WebhooksClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListWebhooks + *+ * Returns the list of all webhooks in the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listWebhooks(ListWebhooksRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listWebhooks(AgentName parent) + *
- listWebhooks(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.
+ *+ *
+ *- listWebhooksPagedCallable() + *
- listWebhooksCallable() + *
+ * + *GetWebhook + *+ * Retrieves the specified webhook.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getWebhook(GetWebhookRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getWebhook(WebhookName name) + *
- getWebhook(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.
+ *+ *
+ *- getWebhookCallable() + *
+ * + *CreateWebhook + *+ * Creates a webhook in the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createWebhook(CreateWebhookRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createWebhook(AgentName parent, Webhook webhook) + *
- createWebhook(String parent, Webhook webhook) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createWebhookCallable() + *
+ * + *UpdateWebhook + *+ * Updates the specified webhook.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateWebhook(UpdateWebhookRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateWebhook(Webhook webhook, 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.
+ *+ *
+ *- updateWebhookCallable() + *
+ * + *DeleteWebhook + *+ * Deletes the specified webhook.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteWebhook(DeleteWebhookRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteWebhook(WebhookName name) + *
- deleteWebhook(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.
+ *+ *
+ *- deleteWebhookCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/AgentsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/AgentsStubSettings.java index cd7d569325c7..be3a22e87926 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/AgentsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/AgentsStubSettings.java @@ -353,6 +353,12 @@ public AgentsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/ChangelogsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/ChangelogsStubSettings.java index c7642e5e8b20..bdbf71483e17 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/ChangelogsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/ChangelogsStubSettings.java @@ -261,6 +261,12 @@ public ChangelogsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/DeploymentsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/DeploymentsStubSettings.java index 4d50aee891a1..a17a5a00d115 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/DeploymentsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/DeploymentsStubSettings.java @@ -264,6 +264,12 @@ public DeploymentsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/EntityTypesStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/EntityTypesStubSettings.java index a2f762c9cab2..6ae3ab16869e 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/EntityTypesStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/EntityTypesStubSettings.java @@ -286,6 +286,12 @@ public EntityTypesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/EnvironmentsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/EnvironmentsStubSettings.java index 02aceab31c82..d3518e689831 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/EnvironmentsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/EnvironmentsStubSettings.java @@ -529,6 +529,12 @@ public EnvironmentsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/ExperimentsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/ExperimentsStubSettings.java index 5917bea5575d..9b58aa42f120 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/ExperimentsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/ExperimentsStubSettings.java @@ -300,6 +300,12 @@ public ExperimentsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/FlowsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/FlowsStubSettings.java index 0f233de4800d..b7ad8c05d0c6 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/FlowsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/FlowsStubSettings.java @@ -348,6 +348,12 @@ public FlowsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/GeneratorsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/GeneratorsStubSettings.java index f9941b516b38..fd1406c512d1 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/GeneratorsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/GeneratorsStubSettings.java @@ -283,6 +283,12 @@ public GeneratorsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/IntentsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/IntentsStubSettings.java index ab4c80ae1432..facad7d8d767 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/IntentsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/IntentsStubSettings.java @@ -321,6 +321,12 @@ public IntentsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/PagesStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/PagesStubSettings.java index f893f5ee6bff..b706debdc7ad 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/PagesStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/PagesStubSettings.java @@ -280,6 +280,12 @@ public PagesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/SecuritySettingsServiceStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/SecuritySettingsServiceStubSettings.java index d48c13e87bbd..0b7f0727b541 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/SecuritySettingsServiceStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/SecuritySettingsServiceStubSettings.java @@ -308,6 +308,12 @@ public SecuritySettingsServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/SessionEntityTypesStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/SessionEntityTypesStubSettings.java index ef6256263ce1..da972fff3219 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/SessionEntityTypesStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/SessionEntityTypesStubSettings.java @@ -313,6 +313,12 @@ public SessionEntityTypesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/SessionsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/SessionsStubSettings.java index 37e6bf3d9968..01b14d79af95 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/SessionsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/SessionsStubSettings.java @@ -232,6 +232,12 @@ public SessionsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/TestCasesStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/TestCasesStubSettings.java index 23bb798b6e39..3778c889efd4 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/TestCasesStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/TestCasesStubSettings.java @@ -453,6 +453,12 @@ public TestCasesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/TransitionRouteGroupsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/TransitionRouteGroupsStubSettings.java index 6063e5090846..bc7d5fa79bf5 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/TransitionRouteGroupsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/TransitionRouteGroupsStubSettings.java @@ -319,6 +319,12 @@ public TransitionRouteGroupsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/VersionsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/VersionsStubSettings.java index 304778114e2d..42d0e391e70b 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/VersionsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/VersionsStubSettings.java @@ -320,6 +320,12 @@ public VersionsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/WebhooksStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/WebhooksStubSettings.java index 662536a88792..e6a50ea6e9d1 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/WebhooksStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/stub/WebhooksStubSettings.java @@ -281,6 +281,12 @@ public WebhooksStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/AgentsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/AgentsClient.java index 40ca72dae1c3..ee6640563a5a 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/AgentsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/AgentsClient.java @@ -66,19 +66,245 @@ *
Note: close() needs to be called on the AgentsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListAgents + *+ * Returns the list of all agents in the specified location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listAgents(ListAgentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listAgents(LocationName parent) + *
- listAgents(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.
+ *+ *
+ *- listAgentsPagedCallable() + *
- listAgentsCallable() + *
+ * + *GetAgent + *+ * Retrieves the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getAgent(GetAgentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getAgent(AgentName name) + *
- getAgent(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.
+ *+ *
+ *- getAgentCallable() + *
+ * + *CreateAgent + *+ * Creates an agent in the specified location. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createAgent(CreateAgentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createAgent(LocationName parent, Agent agent) + *
- createAgent(String parent, Agent agent) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createAgentCallable() + *
+ * + *UpdateAgent + *+ * Updates the specified agent. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateAgent(UpdateAgentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateAgent(Agent agent, 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.
+ *+ *
+ *- updateAgentCallable() + *
+ * + *DeleteAgent + *+ * Deletes the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteAgent(DeleteAgentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteAgent(AgentName name) + *
- deleteAgent(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.
+ *+ *
+ *- deleteAgentCallable() + *
+ * + *ExportAgent + *+ * Exports the specified agent to a binary file. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`: [ExportAgentResponse][google.cloud.dialogflow.cx.v3beta1.ExportAgentResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- exportAgentAsync(ExportAgentRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- exportAgentOperationCallable() + *
- exportAgentCallable() + *
+ * + *RestoreAgent + *+ * Restores the specified agent from a binary file. + *
Replaces the current agent with a new one. Note that all existing resources in agent (e.g. intents, entity types, flows) will be removed. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [Empty message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty) + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- restoreAgentAsync(RestoreAgentRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- restoreAgentOperationCallable() + *
- restoreAgentCallable() + *
+ * + *ValidateAgent + *+ * Validates the specified agent and creates or updates validation results. The agent in draft version is validated. Please call this API after the training is completed to get the complete validation results.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- validateAgent(ValidateAgentRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- validateAgentCallable() + *
+ * + *GetAgentValidationResult + *+ * Gets the latest agent validation result. Agent validation is performed when ValidateAgent is called.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getAgentValidationResult(GetAgentValidationResultRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getAgentValidationResult(AgentValidationResultName name) + *
- getAgentValidationResult(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.
+ *+ *
+ *- getAgentValidationResultCallable() + *
+ * + *GetGenerativeSettings + *+ * Gets the generative settings for the agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getGenerativeSettings(GetGenerativeSettingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getGenerativeSettings(AgentGenerativeSettingsName name, String languageCode) + *
- getGenerativeSettings(String name, String languageCode) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getGenerativeSettingsCallable() + *
+ * + *UpdateGenerativeSettings + *+ * Updates the generative settings for the agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateGenerativeSettings(UpdateGenerativeSettingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateGenerativeSettings(GenerativeSettings generativeSettings, 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.
+ *+ *
+ *- updateGenerativeSettingsCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/ChangelogsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/ChangelogsClient.java index e4f82fdb75b4..f60504634408 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/ChangelogsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/ChangelogsClient.java @@ -60,19 +60,81 @@ *
Note: close() needs to be called on the ChangelogsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListChangelogs + *+ * Returns the list of Changelogs.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listChangelogs(ListChangelogsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listChangelogs(AgentName parent) + *
- listChangelogs(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.
+ *+ *
+ *- listChangelogsPagedCallable() + *
- listChangelogsCallable() + *
+ * + *GetChangelog + *+ * Retrieves the specified Changelog.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getChangelog(GetChangelogRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getChangelog(ChangelogName name) + *
- getChangelog(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.
+ *+ *
+ *- getChangelogCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/DeploymentsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/DeploymentsClient.java index e2b5e64c7b4e..a6ed46f3692b 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/DeploymentsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/DeploymentsClient.java @@ -61,19 +61,81 @@ *
Note: close() needs to be called on the DeploymentsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListDeployments + *+ * Returns the list of all deployments in the specified [Environment][google.cloud.dialogflow.cx.v3beta1.Environment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listDeployments(ListDeploymentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listDeployments(EnvironmentName parent) + *
- listDeployments(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.
+ *+ *
+ *- listDeploymentsPagedCallable() + *
- listDeploymentsCallable() + *
+ * + *GetDeployment + *+ * Retrieves the specified [Deployment][google.cloud.dialogflow.cx.v3beta1.Deployment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getDeployment(GetDeploymentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getDeployment(DeploymentName name) + *
- getDeployment(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.
+ *+ *
+ *- getDeploymentCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/EntityTypesClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/EntityTypesClient.java index 1a932fd2cb57..2617ca2b6faf 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/EntityTypesClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/EntityTypesClient.java @@ -63,19 +63,139 @@ *
Note: close() needs to be called on the EntityTypesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *GetEntityType + *+ * Retrieves the specified entity type.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getEntityType(GetEntityTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getEntityType(EntityTypeName name) + *
- getEntityType(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.
+ *+ *
+ *- getEntityTypeCallable() + *
+ * + *CreateEntityType + *+ * Creates an entity type in the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createEntityType(CreateEntityTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createEntityType(AgentName parent, EntityType entityType) + *
- createEntityType(String parent, EntityType entityType) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createEntityTypeCallable() + *
+ * + *UpdateEntityType + *+ * Updates the specified entity type. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateEntityType(UpdateEntityTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateEntityType(EntityType entityType, 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.
+ *+ *
+ *- updateEntityTypeCallable() + *
+ * + *DeleteEntityType + *+ * Deletes the specified entity type. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteEntityType(DeleteEntityTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteEntityType(EntityTypeName name) + *
- deleteEntityType(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.
+ *+ *
+ *- deleteEntityTypeCallable() + *
+ * + *ListEntityTypes + *+ * Returns the list of all entity types in the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listEntityTypes(ListEntityTypesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listEntityTypes(AgentName parent) + *
- listEntityTypes(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.
+ *+ *
+ *- listEntityTypesPagedCallable() + *
- listEntityTypesCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/EnvironmentsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/EnvironmentsClient.java index c653520978f0..bc724aa96804 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/EnvironmentsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/EnvironmentsClient.java @@ -68,19 +68,217 @@ *
Note: close() needs to be called on the EnvironmentsClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListEnvironments + *+ * Returns the list of all environments in the specified [Agent][google.cloud.dialogflow.cx.v3beta1.Agent].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listEnvironments(ListEnvironmentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listEnvironments(AgentName parent) + *
- listEnvironments(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.
+ *+ *
+ *- listEnvironmentsPagedCallable() + *
- listEnvironmentsCallable() + *
+ * + *GetEnvironment + *+ * Retrieves the specified [Environment][google.cloud.dialogflow.cx.v3beta1.Environment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getEnvironment(GetEnvironmentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getEnvironment(EnvironmentName name) + *
- getEnvironment(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.
+ *+ *
+ *- getEnvironmentCallable() + *
+ * + *CreateEnvironment + *+ * Creates an [Environment][google.cloud.dialogflow.cx.v3beta1.Environment] in the specified [Agent][google.cloud.dialogflow.cx.v3beta1.Agent]. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`: [Environment][google.cloud.dialogflow.cx.v3beta1.Environment]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createEnvironmentAsync(CreateEnvironmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createEnvironmentAsync(AgentName parent, Environment environment) + *
- createEnvironmentAsync(String parent, Environment environment) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createEnvironmentOperationCallable() + *
- createEnvironmentCallable() + *
+ * + *UpdateEnvironment + *+ * Updates the specified [Environment][google.cloud.dialogflow.cx.v3beta1.Environment]. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`: [Environment][google.cloud.dialogflow.cx.v3beta1.Environment]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateEnvironmentAsync(UpdateEnvironmentRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- updateEnvironmentAsync(Environment environment, 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.
+ *+ *
+ *- updateEnvironmentOperationCallable() + *
- updateEnvironmentCallable() + *
+ * + *DeleteEnvironment + *+ * Deletes the specified [Environment][google.cloud.dialogflow.cx.v3beta1.Environment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteEnvironment(DeleteEnvironmentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteEnvironment(EnvironmentName name) + *
- deleteEnvironment(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.
+ *+ *
+ *- deleteEnvironmentCallable() + *
+ * + *LookupEnvironmentHistory + *+ * Looks up the history of the specified [Environment][google.cloud.dialogflow.cx.v3beta1.Environment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- lookupEnvironmentHistory(LookupEnvironmentHistoryRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- lookupEnvironmentHistory(EnvironmentName name) + *
- lookupEnvironmentHistory(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.
+ *+ *
+ *- lookupEnvironmentHistoryPagedCallable() + *
- lookupEnvironmentHistoryCallable() + *
+ * + *RunContinuousTest + *+ * Kicks off a continuous test under the specified [Environment][google.cloud.dialogflow.cx.v3beta1.Environment]. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [RunContinuousTestMetadata][google.cloud.dialogflow.cx.v3beta1.RunContinuousTestMetadata] - `response`: [RunContinuousTestResponse][google.cloud.dialogflow.cx.v3beta1.RunContinuousTestResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- runContinuousTestAsync(RunContinuousTestRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- runContinuousTestOperationCallable() + *
- runContinuousTestCallable() + *
+ * + *ListContinuousTestResults + *+ * Fetches a list of continuous test results for a given environment.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listContinuousTestResults(ListContinuousTestResultsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listContinuousTestResults(EnvironmentName parent) + *
- listContinuousTestResults(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.
+ *+ *
+ *- listContinuousTestResultsPagedCallable() + *
- listContinuousTestResultsCallable() + *
+ * + *DeployFlow + *+ * Deploys a flow to the specified [Environment][google.cloud.dialogflow.cx.v3beta1.Environment]. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [DeployFlowMetadata][google.cloud.dialogflow.cx.v3beta1.DeployFlowMetadata] - `response`: [DeployFlowResponse][google.cloud.dialogflow.cx.v3beta1.DeployFlowResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deployFlowAsync(DeployFlowRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- deployFlowOperationCallable() + *
- deployFlowCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/ExperimentsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/ExperimentsClient.java index 444a63438160..aeb7a6e60485 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/ExperimentsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/ExperimentsClient.java @@ -63,19 +63,175 @@ *
Note: close() needs to be called on the ExperimentsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListExperiments + *+ * Returns the list of all experiments in the specified [Environment][google.cloud.dialogflow.cx.v3beta1.Environment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listExperiments(ListExperimentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listExperiments(EnvironmentName parent) + *
- listExperiments(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.
+ *+ *
+ *- listExperimentsPagedCallable() + *
- listExperimentsCallable() + *
+ * + *GetExperiment + *+ * Retrieves the specified [Experiment][google.cloud.dialogflow.cx.v3beta1.Experiment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getExperiment(GetExperimentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getExperiment(ExperimentName name) + *
- getExperiment(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.
+ *+ *
+ *- getExperimentCallable() + *
+ * + *CreateExperiment + *+ * Creates an [Experiment][google.cloud.dialogflow.cx.v3beta1.Experiment] in the specified [Environment][google.cloud.dialogflow.cx.v3beta1.Environment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createExperiment(CreateExperimentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createExperiment(EnvironmentName parent, Experiment experiment) + *
- createExperiment(String parent, Experiment experiment) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createExperimentCallable() + *
+ * + *UpdateExperiment + *+ * Updates the specified [Experiment][google.cloud.dialogflow.cx.v3beta1.Experiment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateExperiment(UpdateExperimentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateExperiment(Experiment experiment, 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.
+ *+ *
+ *- updateExperimentCallable() + *
+ * + *DeleteExperiment + *+ * Deletes the specified [Experiment][google.cloud.dialogflow.cx.v3beta1.Experiment].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteExperiment(DeleteExperimentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteExperiment(ExperimentName name) + *
- deleteExperiment(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.
+ *+ *
+ *- deleteExperimentCallable() + *
+ * + *StartExperiment + *+ * Starts the specified [Experiment][google.cloud.dialogflow.cx.v3beta1.Experiment]. This rpc only changes the state of experiment from PENDING to RUNNING.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- startExperiment(StartExperimentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- startExperiment(ExperimentName name) + *
- startExperiment(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.
+ *+ *
+ *- startExperimentCallable() + *
+ * + *StopExperiment + *+ * Stops the specified [Experiment][google.cloud.dialogflow.cx.v3beta1.Experiment]. This rpc only changes the state of experiment from RUNNING to DONE.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- stopExperiment(StopExperimentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- stopExperiment(ExperimentName name) + *
- stopExperiment(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.
+ *+ *
+ *- stopExperimentCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/FlowsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/FlowsClient.java index 2bbb81fa1697..4f935160ea0e 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/FlowsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/FlowsClient.java @@ -67,19 +67,231 @@ *
Note: close() needs to be called on the FlowsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateFlow + *+ * Creates a flow in the specified agent. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createFlow(CreateFlowRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createFlow(AgentName parent, Flow flow) + *
- createFlow(String parent, Flow flow) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createFlowCallable() + *
+ * + *DeleteFlow + *+ * Deletes a specified flow.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteFlow(DeleteFlowRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteFlow(FlowName name) + *
- deleteFlow(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.
+ *+ *
+ *- deleteFlowCallable() + *
+ * + *ListFlows + *+ * Returns the list of all flows in the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listFlows(ListFlowsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listFlows(AgentName parent) + *
- listFlows(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.
+ *+ *
+ *- listFlowsPagedCallable() + *
- listFlowsCallable() + *
+ * + *GetFlow + *+ * Retrieves the specified flow.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getFlow(GetFlowRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getFlow(FlowName name) + *
- getFlow(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.
+ *+ *
+ *- getFlowCallable() + *
+ * + *UpdateFlow + *+ * Updates the specified flow. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateFlow(UpdateFlowRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateFlow(Flow flow, 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.
+ *+ *
+ *- updateFlowCallable() + *
+ * + *TrainFlow + *+ * Trains the specified flow. Note that only the flow in 'draft' environment is trained. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [Empty message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty) + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- trainFlowAsync(TrainFlowRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- trainFlowAsync(FlowName name) + *
- trainFlowAsync(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.
+ *+ *
+ *- trainFlowOperationCallable() + *
- trainFlowCallable() + *
+ * + *ValidateFlow + *+ * Validates the specified flow and creates or updates validation results. Please call this API after the training is completed to get the complete validation results.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- validateFlow(ValidateFlowRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- validateFlowCallable() + *
+ * + *GetFlowValidationResult + *+ * Gets the latest flow validation result. Flow validation is performed when ValidateFlow is called.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getFlowValidationResult(GetFlowValidationResultRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getFlowValidationResult(FlowValidationResultName name) + *
- getFlowValidationResult(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.
+ *+ *
+ *- getFlowValidationResultCallable() + *
+ * + *ImportFlow + *+ * Imports the specified flow to the specified agent from a binary file. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`: [ImportFlowResponse][google.cloud.dialogflow.cx.v3beta1.ImportFlowResponse] + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- importFlowAsync(ImportFlowRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- importFlowOperationCallable() + *
- importFlowCallable() + *
+ * + *ExportFlow + *+ * Exports the specified flow to a binary file. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`: [ExportFlowResponse][google.cloud.dialogflow.cx.v3beta1.ExportFlowResponse] + *
Note that resources (e.g. intents, entities, webhooks) that the flow references will also be exported.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- exportFlowAsync(ExportFlowRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- exportFlowOperationCallable() + *
- exportFlowCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/GeneratorsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/GeneratorsClient.java index 72061ab4a881..fbca5fec810f 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/GeneratorsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/GeneratorsClient.java @@ -62,19 +62,137 @@ *
Note: close() needs to be called on the GeneratorsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListGenerators + *+ * Returns the list of all generators in the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listGenerators(ListGeneratorsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listGenerators(AgentName parent) + *
- listGenerators(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.
+ *+ *
+ *- listGeneratorsPagedCallable() + *
- listGeneratorsCallable() + *
+ * + *GetGenerator + *+ * Retrieves the specified generator.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getGenerator(GetGeneratorRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getGenerator(GeneratorName name) + *
- getGenerator(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.
+ *+ *
+ *- getGeneratorCallable() + *
+ * + *CreateGenerator + *+ * Creates a generator in the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createGenerator(CreateGeneratorRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createGenerator(AgentName parent, Generator generator) + *
- createGenerator(String parent, Generator generator) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createGeneratorCallable() + *
+ * + *UpdateGenerator + *+ * Update the specified generator.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateGenerator(UpdateGeneratorRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateGenerator(Generator generator, 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.
+ *+ *
+ *- updateGeneratorCallable() + *
+ * + *DeleteGenerator + *+ * Deletes the specified generators.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteGenerator(DeleteGeneratorRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteGenerator(GeneratorName name) + *
- deleteGenerator(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.
+ *+ *
+ *- deleteGeneratorCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/IntentsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/IntentsClient.java index 8377502957b4..7693bab98a91 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/IntentsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/IntentsClient.java @@ -65,19 +65,174 @@ *
Note: close() needs to be called on the IntentsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListIntents + *+ * Returns the list of all intents in the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listIntents(ListIntentsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listIntents(AgentName parent) + *
- listIntents(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.
+ *+ *
+ *- listIntentsPagedCallable() + *
- listIntentsCallable() + *
+ * + *GetIntent + *+ * Retrieves the specified intent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getIntent(GetIntentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getIntent(IntentName name) + *
- getIntent(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.
+ *+ *
+ *- getIntentCallable() + *
+ * + *CreateIntent + *+ * Creates an intent in the specified agent. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createIntent(CreateIntentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createIntent(AgentName parent, Intent intent) + *
- createIntent(String parent, Intent intent) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createIntentCallable() + *
+ * + *UpdateIntent + *+ * Updates the specified intent. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateIntent(UpdateIntentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateIntent(Intent intent, 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.
+ *+ *
+ *- updateIntentCallable() + *
+ * + *DeleteIntent + *+ * Deletes the specified intent. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteIntent(DeleteIntentRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteIntent(IntentName name) + *
- deleteIntent(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.
+ *+ *
+ *- deleteIntentCallable() + *
+ * + *ImportIntents + *+ * Imports the specified intents into the agent. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [ImportIntentsMetadata][google.cloud.dialogflow.cx.v3beta1.ImportIntentsMetadata] - `response`: [ImportIntentsResponse][google.cloud.dialogflow.cx.v3beta1.ImportIntentsResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- importIntentsAsync(ImportIntentsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- importIntentsOperationCallable() + *
- importIntentsCallable() + *
+ * + *ExportIntents + *+ * Exports the selected intents. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [ExportIntentsMetadata][google.cloud.dialogflow.cx.v3beta1.ExportIntentsMetadata] - `response`: [ExportIntentsResponse][google.cloud.dialogflow.cx.v3beta1.ExportIntentsResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- exportIntentsAsync(ExportIntentsRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- exportIntentsOperationCallable() + *
- exportIntentsCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/PagesClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/PagesClient.java index 221b1bf74549..7f8354c91dfa 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/PagesClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/PagesClient.java @@ -61,19 +61,137 @@ *
Note: close() needs to be called on the PagesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListPages + *+ * Returns the list of all pages in the specified flow.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listPages(ListPagesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listPages(FlowName parent) + *
- listPages(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.
+ *+ *
+ *- listPagesPagedCallable() + *
- listPagesCallable() + *
+ * + *GetPage + *+ * Retrieves the specified page.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getPage(GetPageRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getPage(PageName name) + *
- getPage(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.
+ *+ *
+ *- getPageCallable() + *
+ * + *CreatePage + *+ * Creates a page in the specified flow.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createPage(CreatePageRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createPage(FlowName parent, Page page) + *
- createPage(String parent, Page page) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createPageCallable() + *
+ * + *UpdatePage + *+ * Updates the specified page.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updatePage(UpdatePageRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updatePage(Page page, 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.
+ *+ *
+ *- updatePageCallable() + *
+ * + *DeletePage + *+ * Deletes the specified page.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deletePage(DeletePageRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deletePage(PageName name) + *
- deletePage(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.
+ *+ *
+ *- deletePageCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/SecuritySettingsServiceClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/SecuritySettingsServiceClient.java index 1735b6973db4..f26f49c66930 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/SecuritySettingsServiceClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/SecuritySettingsServiceClient.java @@ -65,19 +65,137 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *CreateSecuritySettings + *+ * Create security settings in the specified location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createSecuritySettings(CreateSecuritySettingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createSecuritySettings(LocationName parent, SecuritySettings securitySettings) + *
- createSecuritySettings(String parent, SecuritySettings securitySettings) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createSecuritySettingsCallable() + *
+ * + *GetSecuritySettings + *+ * Retrieves the specified [SecuritySettings][google.cloud.dialogflow.cx.v3beta1.SecuritySettings]. The returned settings may be stale by up to 1 minute.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getSecuritySettings(GetSecuritySettingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getSecuritySettings(SecuritySettingsName name) + *
- getSecuritySettings(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.
+ *+ *
+ *- getSecuritySettingsCallable() + *
+ * + *UpdateSecuritySettings + *+ * Updates the specified [SecuritySettings][google.cloud.dialogflow.cx.v3beta1.SecuritySettings].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateSecuritySettings(UpdateSecuritySettingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateSecuritySettings(SecuritySettings securitySettings, 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.
+ *+ *
+ *- updateSecuritySettingsCallable() + *
+ * + *ListSecuritySettings + *+ * Returns the list of all security settings in the specified location.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listSecuritySettings(ListSecuritySettingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listSecuritySettings(LocationName parent) + *
- listSecuritySettings(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.
+ *+ *
+ *- listSecuritySettingsPagedCallable() + *
- listSecuritySettingsCallable() + *
+ * + *DeleteSecuritySettings + *+ * Deletes the specified [SecuritySettings][google.cloud.dialogflow.cx.v3beta1.SecuritySettings].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteSecuritySettings(DeleteSecuritySettingsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteSecuritySettings(SecuritySettingsName name) + *
- deleteSecuritySettings(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.
+ *+ *
+ *- deleteSecuritySettingsCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/SessionEntityTypesClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/SessionEntityTypesClient.java index ac17b0644e3b..2ca48972248d 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/SessionEntityTypesClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/SessionEntityTypesClient.java @@ -65,19 +65,137 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListSessionEntityTypes + *+ * Returns the list of all session entity types in the specified session.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listSessionEntityTypes(ListSessionEntityTypesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listSessionEntityTypes(SessionName parent) + *
- listSessionEntityTypes(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.
+ *+ *
+ *- listSessionEntityTypesPagedCallable() + *
- listSessionEntityTypesCallable() + *
+ * + *GetSessionEntityType + *+ * Retrieves the specified session entity type.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getSessionEntityType(GetSessionEntityTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getSessionEntityType(SessionEntityTypeName name) + *
- getSessionEntityType(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.
+ *+ *
+ *- getSessionEntityTypeCallable() + *
+ * + *CreateSessionEntityType + *+ * Creates a session entity type.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createSessionEntityType(CreateSessionEntityTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createSessionEntityType(SessionName parent, SessionEntityType sessionEntityType) + *
- createSessionEntityType(String parent, SessionEntityType sessionEntityType) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createSessionEntityTypeCallable() + *
+ * + *UpdateSessionEntityType + *+ * Updates the specified session entity type.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateSessionEntityType(UpdateSessionEntityTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateSessionEntityType(SessionEntityType sessionEntityType, 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.
+ *+ *
+ *- updateSessionEntityTypeCallable() + *
+ * + *DeleteSessionEntityType + *+ * Deletes the specified session entity type.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteSessionEntityType(DeleteSessionEntityTypeRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteSessionEntityType(SessionEntityTypeName name) + *
- deleteSessionEntityType(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.
+ *+ *
+ *- deleteSessionEntityTypeCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/SessionsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/SessionsClient.java index 748a249f79de..f69ce5a4eade 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/SessionsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/SessionsClient.java @@ -71,19 +71,110 @@ *
Note: close() needs to be called on the SessionsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *DetectIntent + *+ * Processes a natural language query and returns structured, actionable data as a result. This method is not idempotent, because it may cause session entity types to be updated, which in turn might affect results of future queries. + *
Note: Always use agent versions for production traffic. See [Versions and environments](https://cloud.google.com/dialogflow/cx/docs/concept/version).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- detectIntent(DetectIntentRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- detectIntentCallable() + *
+ * + *StreamingDetectIntent + *+ * Processes a natural language query in audio format in a streaming fashion and returns structured, actionable data as a result. This method is only available via the gRPC API (not REST). + *
Note: Always use agent versions for production traffic. See [Versions and environments](https://cloud.google.com/dialogflow/cx/docs/concept/version).
+ * + *Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- streamingDetectIntentCallable() + *
+ * + *MatchIntent + *+ * Returns preliminary intent match results, doesn't change the session status.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- matchIntent(MatchIntentRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- matchIntentCallable() + *
+ * + *FulfillIntent + *+ * Fulfills a matched intent returned by [MatchIntent][google.cloud.dialogflow.cx.v3beta1.Sessions.MatchIntent]. Must be called after [MatchIntent][google.cloud.dialogflow.cx.v3beta1.Sessions.MatchIntent], with input from [MatchIntentResponse][google.cloud.dialogflow.cx.v3beta1.MatchIntentResponse]. Otherwise, the behavior is undefined.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- fulfillIntent(FulfillIntentRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- fulfillIntentCallable() + *
+ * + *SubmitAnswerFeedback + *+ * Updates the feedback received from the user for a single turn of the bot response.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- submitAnswerFeedback(SubmitAnswerFeedbackRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- submitAnswerFeedbackCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/TestCasesClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/TestCasesClient.java index 92a049cad425..bdc5c52025dc 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/TestCasesClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/TestCasesClient.java @@ -67,19 +67,258 @@ *
Note: close() needs to be called on the TestCasesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListTestCases + *+ * Fetches a list of test cases for a given agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listTestCases(ListTestCasesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listTestCases(AgentName parent) + *
- listTestCases(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.
+ *+ *
+ *- listTestCasesPagedCallable() + *
- listTestCasesCallable() + *
+ * + *BatchDeleteTestCases + *+ * Batch deletes test cases.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- batchDeleteTestCases(BatchDeleteTestCasesRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- batchDeleteTestCases(AgentName parent) + *
- batchDeleteTestCases(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.
+ *+ *
+ *- batchDeleteTestCasesCallable() + *
+ * + *GetTestCase + *+ * Gets a test case.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getTestCase(GetTestCaseRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getTestCase(TestCaseName name) + *
- getTestCase(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.
+ *+ *
+ *- getTestCaseCallable() + *
+ * + *CreateTestCase + *+ * Creates a test case for the given agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createTestCase(CreateTestCaseRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createTestCase(AgentName parent, TestCase testCase) + *
- createTestCase(String parent, TestCase testCase) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createTestCaseCallable() + *
+ * + *UpdateTestCase + *+ * Updates the specified test case.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateTestCase(UpdateTestCaseRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateTestCase(TestCase testCase, 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.
+ *+ *
+ *- updateTestCaseCallable() + *
+ * + *RunTestCase + *+ * Kicks off a test case run. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [RunTestCaseMetadata][google.cloud.dialogflow.cx.v3beta1.RunTestCaseMetadata] - `response`: [RunTestCaseResponse][google.cloud.dialogflow.cx.v3beta1.RunTestCaseResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- runTestCaseAsync(RunTestCaseRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- runTestCaseOperationCallable() + *
- runTestCaseCallable() + *
+ * + *BatchRunTestCases + *+ * Kicks off a batch run of test cases. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [BatchRunTestCasesMetadata][google.cloud.dialogflow.cx.v3beta1.BatchRunTestCasesMetadata] - `response`: [BatchRunTestCasesResponse][google.cloud.dialogflow.cx.v3beta1.BatchRunTestCasesResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- batchRunTestCasesAsync(BatchRunTestCasesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- batchRunTestCasesOperationCallable() + *
- batchRunTestCasesCallable() + *
+ * + *CalculateCoverage + *+ * Calculates the test coverage for an agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- calculateCoverage(CalculateCoverageRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- calculateCoverageCallable() + *
+ * + *ImportTestCases + *+ * Imports the test cases from a Cloud Storage bucket or a local file. It always creates new test cases and won't overwrite any existing ones. The provided ID in the imported test case is neglected. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [ImportTestCasesMetadata][google.cloud.dialogflow.cx.v3beta1.ImportTestCasesMetadata] - `response`: [ImportTestCasesResponse][google.cloud.dialogflow.cx.v3beta1.ImportTestCasesResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- importTestCasesAsync(ImportTestCasesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- importTestCasesOperationCallable() + *
- importTestCasesCallable() + *
+ * + *ExportTestCases + *+ * Exports the test cases under the agent to a Cloud Storage bucket or a local file. Filter can be applied to export a subset of test cases. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [ExportTestCasesMetadata][google.cloud.dialogflow.cx.v3beta1.ExportTestCasesMetadata] - `response`: [ExportTestCasesResponse][google.cloud.dialogflow.cx.v3beta1.ExportTestCasesResponse]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- exportTestCasesAsync(ExportTestCasesRequest request) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- exportTestCasesOperationCallable() + *
- exportTestCasesCallable() + *
+ * + *ListTestCaseResults + *+ * Fetches the list of run results for the given test case. A maximum of 100 results are kept for each test case.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listTestCaseResults(ListTestCaseResultsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listTestCaseResults(TestCaseName parent) + *
- listTestCaseResults(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.
+ *+ *
+ *- listTestCaseResultsPagedCallable() + *
- listTestCaseResultsCallable() + *
+ * + *GetTestCaseResult + *+ * Gets a test case result.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getTestCaseResult(GetTestCaseResultRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getTestCaseResult(TestCaseResultName name) + *
- getTestCaseResult(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.
+ *+ *
+ *- getTestCaseResultCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/TransitionRouteGroupsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/TransitionRouteGroupsClient.java index 1a391cfa9cfa..8d28d0d0af47 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/TransitionRouteGroupsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/TransitionRouteGroupsClient.java @@ -66,19 +66,142 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListTransitionRouteGroups + *+ * Returns the list of all transition route groups in the specified flow.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listTransitionRouteGroups(ListTransitionRouteGroupsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listTransitionRouteGroups(AgentName parent) + *
- listTransitionRouteGroups(FlowName parent) + *
- listTransitionRouteGroups(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.
+ *+ *
+ *- listTransitionRouteGroupsPagedCallable() + *
- listTransitionRouteGroupsCallable() + *
+ * + *GetTransitionRouteGroup + *+ * Retrieves the specified [TransitionRouteGroup][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroup].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getTransitionRouteGroup(GetTransitionRouteGroupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getTransitionRouteGroup(TransitionRouteGroupName name) + *
- getTransitionRouteGroup(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.
+ *+ *
+ *- getTransitionRouteGroupCallable() + *
+ * + *CreateTransitionRouteGroup + *+ * Creates an [TransitionRouteGroup][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroup] in the specified flow. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createTransitionRouteGroup(CreateTransitionRouteGroupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createTransitionRouteGroup(AgentName parent, TransitionRouteGroup transitionRouteGroup) + *
- createTransitionRouteGroup(FlowName parent, TransitionRouteGroup transitionRouteGroup) + *
- createTransitionRouteGroup(String parent, TransitionRouteGroup transitionRouteGroup) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createTransitionRouteGroupCallable() + *
+ * + *UpdateTransitionRouteGroup + *+ * Updates the specified [TransitionRouteGroup][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroup]. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateTransitionRouteGroup(UpdateTransitionRouteGroupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateTransitionRouteGroup(TransitionRouteGroup transitionRouteGroup, 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.
+ *+ *
+ *- updateTransitionRouteGroupCallable() + *
+ * + *DeleteTransitionRouteGroup + *+ * Deletes the specified [TransitionRouteGroup][google.cloud.dialogflow.cx.v3beta1.TransitionRouteGroup]. + *
Note: You should always train a flow prior to sending it queries. See the [training documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteTransitionRouteGroup(DeleteTransitionRouteGroupRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteTransitionRouteGroup(TransitionRouteGroupName name) + *
- deleteTransitionRouteGroup(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.
+ *+ *
+ *- deleteTransitionRouteGroupCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/VersionsClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/VersionsClient.java index c9b7ae1e7068..4619e8f13f81 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/VersionsClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/VersionsClient.java @@ -67,19 +67,181 @@ *
Note: close() needs to be called on the VersionsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListVersions + *+ * Returns the list of all versions in the specified [Flow][google.cloud.dialogflow.cx.v3beta1.Flow].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listVersions(ListVersionsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listVersions(FlowName parent) + *
- listVersions(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.
+ *+ *
+ *- listVersionsPagedCallable() + *
- listVersionsCallable() + *
+ * + *GetVersion + *+ * Retrieves the specified [Version][google.cloud.dialogflow.cx.v3beta1.Version].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getVersion(GetVersionRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getVersion(VersionName name) + *
- getVersion(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.
+ *+ *
+ *- getVersionCallable() + *
+ * + *CreateVersion + *+ * Creates a [Version][google.cloud.dialogflow.cx.v3beta1.Version] in the specified [Flow][google.cloud.dialogflow.cx.v3beta1.Flow]. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: [CreateVersionOperationMetadata][google.cloud.dialogflow.cx.v3beta1.CreateVersionOperationMetadata] - `response`: [Version][google.cloud.dialogflow.cx.v3beta1.Version]
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createVersionAsync(CreateVersionRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- createVersionAsync(FlowName parent, Version version) + *
- createVersionAsync(String parent, Version version) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createVersionOperationCallable() + *
- createVersionCallable() + *
+ * + *UpdateVersion + *+ * Updates the specified [Version][google.cloud.dialogflow.cx.v3beta1.Version].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateVersion(UpdateVersionRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateVersion(Version version, 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.
+ *+ *
+ *- updateVersionCallable() + *
+ * + *DeleteVersion + *+ * Deletes the specified [Version][google.cloud.dialogflow.cx.v3beta1.Version].
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteVersion(DeleteVersionRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteVersion(VersionName name) + *
- deleteVersion(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.
+ *+ *
+ *- deleteVersionCallable() + *
+ * + *LoadVersion + *+ * Loads resources in the specified version to the draft flow. + *
This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: + *
- `metadata`: An empty [Struct message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [Empty message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- loadVersionAsync(LoadVersionRequest request) + *
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
+ *+ *
+ *- loadVersionAsync(VersionName name) + *
- loadVersionAsync(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.
+ *+ *
+ *- loadVersionOperationCallable() + *
- loadVersionCallable() + *
+ * + *CompareVersions + *+ * Compares the specified base version with target version.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- compareVersions(CompareVersionsRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- compareVersions(VersionName baseVersion) + *
- compareVersions(String baseVersion) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- compareVersionsCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/WebhooksClient.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/WebhooksClient.java index 379b2a1fcbf8..f0987bde7409 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/WebhooksClient.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/WebhooksClient.java @@ -61,19 +61,137 @@ *
Note: close() needs to be called on the WebhooksClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *
The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *
- *
+ *- A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
- A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
- A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
* *+ * Method + *Description + *Method Variants + *+ * + *ListWebhooks + *+ * Returns the list of all webhooks in the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- listWebhooks(ListWebhooksRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- listWebhooks(AgentName parent) + *
- listWebhooks(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.
+ *+ *
+ *- listWebhooksPagedCallable() + *
- listWebhooksCallable() + *
+ * + *GetWebhook + *+ * Retrieves the specified webhook.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- getWebhook(GetWebhookRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- getWebhook(WebhookName name) + *
- getWebhook(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.
+ *+ *
+ *- getWebhookCallable() + *
+ * + *CreateWebhook + *+ * Creates a webhook in the specified agent.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- createWebhook(CreateWebhookRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- createWebhook(AgentName parent, Webhook webhook) + *
- createWebhook(String parent, Webhook webhook) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- createWebhookCallable() + *
+ * + *UpdateWebhook + *+ * Updates the specified webhook.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- updateWebhook(UpdateWebhookRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- updateWebhook(Webhook webhook, 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.
+ *+ *
+ *- updateWebhookCallable() + *
+ * + *DeleteWebhook + *+ * Deletes the specified webhook.
+ * + *Request object method variants only take one parameter, a request object, which must be constructed before the call.
+ *+ *
+ *- deleteWebhook(DeleteWebhookRequest request) + *
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
+ *+ *
+ *- deleteWebhook(WebhookName name) + *
- deleteWebhook(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.
+ *+ *
+ *- deleteWebhookCallable() + *
+ * + *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) + *
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() + *
+ * + * + *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) + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
+ *+ *
+ *- getLocationCallable() + *
See the individual methods for example code. * diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/AgentsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/AgentsStubSettings.java index b32d8e60fa9b..d445fa1f8123 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/AgentsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/AgentsStubSettings.java @@ -354,6 +354,12 @@ public AgentsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/ChangelogsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/ChangelogsStubSettings.java index 086fa4193de8..c1b09e6916a3 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/ChangelogsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/ChangelogsStubSettings.java @@ -262,6 +262,12 @@ public ChangelogsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/DeploymentsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/DeploymentsStubSettings.java index 2c142c01ee51..7949c01a62e6 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/DeploymentsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/DeploymentsStubSettings.java @@ -265,6 +265,12 @@ public DeploymentsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/EntityTypesStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/EntityTypesStubSettings.java index 66bed7081dec..d1faf58eaa11 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/EntityTypesStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/EntityTypesStubSettings.java @@ -287,6 +287,12 @@ public EntityTypesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/EnvironmentsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/EnvironmentsStubSettings.java index b4020cb56f08..60bdb26aa71e 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/EnvironmentsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/EnvironmentsStubSettings.java @@ -530,6 +530,12 @@ public EnvironmentsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/ExperimentsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/ExperimentsStubSettings.java index 5a52d5049ad5..fe289778aa06 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/ExperimentsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/ExperimentsStubSettings.java @@ -301,6 +301,12 @@ public ExperimentsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/FlowsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/FlowsStubSettings.java index 4610880d8987..ed8976cb01aa 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/FlowsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/FlowsStubSettings.java @@ -349,6 +349,12 @@ public FlowsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/GeneratorsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/GeneratorsStubSettings.java index a1cc48a4290a..b18127685e0e 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/GeneratorsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/GeneratorsStubSettings.java @@ -284,6 +284,12 @@ public GeneratorsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/IntentsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/IntentsStubSettings.java index 2aa19fa47ff9..881d56ae9cd8 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/IntentsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/IntentsStubSettings.java @@ -322,6 +322,12 @@ public IntentsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/PagesStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/PagesStubSettings.java index 77f846bb7fca..af09843db2bb 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/PagesStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/PagesStubSettings.java @@ -281,6 +281,12 @@ public PagesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/SecuritySettingsServiceStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/SecuritySettingsServiceStubSettings.java index a1940003c5f1..028e497cdd84 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/SecuritySettingsServiceStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/SecuritySettingsServiceStubSettings.java @@ -309,6 +309,12 @@ public SecuritySettingsServiceStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/SessionEntityTypesStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/SessionEntityTypesStubSettings.java index f1caf1c2aee7..72cd65663da0 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/SessionEntityTypesStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/SessionEntityTypesStubSettings.java @@ -314,6 +314,12 @@ public SessionEntityTypesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/SessionsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/SessionsStubSettings.java index 898c9a2afb9d..2d613673fa6e 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/SessionsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/SessionsStubSettings.java @@ -233,6 +233,12 @@ public SessionsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/TestCasesStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/TestCasesStubSettings.java index 4b1f7df2307a..5babe3b115af 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/TestCasesStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/TestCasesStubSettings.java @@ -454,6 +454,12 @@ public TestCasesStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/TransitionRouteGroupsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/TransitionRouteGroupsStubSettings.java index bb2704dfe0d4..b4c250c198ac 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/TransitionRouteGroupsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/TransitionRouteGroupsStubSettings.java @@ -320,6 +320,12 @@ public TransitionRouteGroupsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/VersionsStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/VersionsStubSettings.java index d174c23ce60b..01a779ea85a2 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/VersionsStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/VersionsStubSettings.java @@ -321,6 +321,12 @@ public VersionsStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/WebhooksStubSettings.java b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/WebhooksStubSettings.java index eb5754a9d33a..ab4f84daaa5e 100644 --- a/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/WebhooksStubSettings.java +++ b/java-dialogflow-cx/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/stub/WebhooksStubSettings.java @@ -282,6 +282,12 @@ public WebhooksStub createStub() throws IOException { "Transport not supported: %s", getTransportChannelProvider().getTransportName())); } + /** Returns the default service name. */ + @Override + public String getServiceName() { + return "dialogflow"; + } + /** Returns a builder for the default ExecutorProvider for this service. */ public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() { return InstantiatingExecutorProvider.newBuilder(); diff --git a/versions.txt b/versions.txt index a56fc1dda0a1..a9d99c13b1b9 100644 --- a/versions.txt +++ b/versions.txt @@ -712,4 +712,4 @@ proto-google-cloud-edgenetwork-v1:0.0.0:0.0.1-SNAPSHOT grpc-google-cloud-edgenetwork-v1:0.0.0:0.0.1-SNAPSHOT google-cloud-cloudquotas:0.0.0:0.0.1-SNAPSHOT proto-google-cloud-cloudquotas-v1:0.0.0:0.0.1-SNAPSHOT -grpc-google-cloud-cloudquotas-v1:0.0.0:0.0.1-SNAPSHOT \ No newline at end of file +grpc-google-cloud-cloudquotas-v1:0.0.0:0.0.1-SNAPSHOT