diff --git a/README.md b/README.md index 53290efe..b06825f6 100644 --- a/README.md +++ b/README.md @@ -26,12 +26,13 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file + com.google.cloud google-cloud-billingbudgets - + ``` [//]: # ({x-version-update-start:google-cloud-billingbudgets:released}) @@ -44,6 +45,7 @@ If you are using Maven without BOM, add this to your dependencies: google-cloud-billingbudgets 0.2.2 + ``` If you are using Gradle, add this to your dependencies diff --git a/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetServiceClient.java b/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetServiceClient.java index d2d27be7..21e46018 100644 --- a/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetServiceClient.java +++ b/google-cloud-billingbudgets/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetServiceClient.java @@ -215,6 +215,9 @@ public final UnaryCallable createBudgetCallable() { /** * Updates a budget and returns the updated budget. * + *

WARNING: There are some fields exposed on the Google Cloud Console that aren’t available on + * this API. Budget fields that are not exposed in this API will not be changed by this method. + * *

Sample code: * *


@@ -238,6 +241,9 @@ public final Budget updateBudget(UpdateBudgetRequest request) {
   /**
    * Updates a budget and returns the updated budget.
    *
+   * 

WARNING: There are some fields exposed on the Google Cloud Console that aren’t available on + * this API. Budget fields that are not exposed in this API will not be changed by this method. + * *

Sample code: * *


@@ -260,6 +266,10 @@ public final UnaryCallable updateBudgetCallable() {
   /**
    * Returns a budget.
    *
+   * 

WARNING: There are some fields exposed on the Google Cloud Console that aren’t available on + * this API. When reading from the API, you will not see these fields in the return value, though + * they may have been set in the Cloud Console. + * *

Sample code: * *


@@ -283,6 +293,10 @@ public final Budget getBudget(GetBudgetRequest request) {
   /**
    * Returns a budget.
    *
+   * 

WARNING: There are some fields exposed on the Google Cloud Console that aren’t available on + * this API. When reading from the API, you will not see these fields in the return value, though + * they may have been set in the Cloud Console. + * *

Sample code: * *


@@ -305,6 +319,10 @@ public final UnaryCallable getBudgetCallable() {
   /**
    * Returns a list of budgets for a billing account.
    *
+   * 

WARNING: There are some fields exposed on the Google Cloud Console that aren’t available on + * this API. When reading from the API, you will not see these fields in the return value, though + * they may have been set in the Cloud Console. + * *

Sample code: * *


@@ -330,6 +348,10 @@ public final ListBudgetsPagedResponse listBudgets(ListBudgetsRequest request) {
   /**
    * Returns a list of budgets for a billing account.
    *
+   * 

WARNING: There are some fields exposed on the Google Cloud Console that aren’t available on + * this API. When reading from the API, you will not see these fields in the return value, though + * they may have been set in the Cloud Console. + * *

Sample code: * *


@@ -355,6 +377,10 @@ public final ListBudgetsPagedResponse listBudgets(ListBudgetsRequest request) {
   /**
    * Returns a list of budgets for a billing account.
    *
+   * 

WARNING: There are some fields exposed on the Google Cloud Console that aren’t available on + * this API. When reading from the API, you will not see these fields in the return value, though + * they may have been set in the Cloud Console. + * *

Sample code: * *


diff --git a/grpc-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetServiceGrpc.java b/grpc-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetServiceGrpc.java
index 08e7f3a4..3f3da958 100644
--- a/grpc-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetServiceGrpc.java
+++ b/grpc-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetServiceGrpc.java
@@ -372,6 +372,9 @@ public void createBudget(
      *
      * 
      * Updates a budget and returns the updated budget.
+     * WARNING: There are some fields exposed on the Google Cloud Console that
+     * aren’t available on this API. Budget fields that are not exposed in
+     * this API will not be changed by this method.
      * 
*/ public void updateBudget( @@ -386,6 +389,10 @@ public void updateBudget( * *
      * Returns a budget.
+     * WARNING: There are some fields exposed on the Google Cloud Console that
+     * aren’t available on this API. When reading from the API, you will not
+     * see these fields in the return value, though they may have been set
+     * in the Cloud Console.
      * 
*/ public void getBudget( @@ -400,6 +407,10 @@ public void getBudget( * *
      * Returns a list of budgets for a billing account.
+     * WARNING: There are some fields exposed on the Google Cloud Console that
+     * aren’t available on this API. When reading from the API, you will not
+     * see these fields in the return value, though they may have been set
+     * in the Cloud Console.
      * 
*/ public void listBudgets( @@ -508,6 +519,9 @@ public void createBudget( * *
      * Updates a budget and returns the updated budget.
+     * WARNING: There are some fields exposed on the Google Cloud Console that
+     * aren’t available on this API. Budget fields that are not exposed in
+     * this API will not be changed by this method.
      * 
*/ public void updateBudget( @@ -525,6 +539,10 @@ public void updateBudget( * *
      * Returns a budget.
+     * WARNING: There are some fields exposed on the Google Cloud Console that
+     * aren’t available on this API. When reading from the API, you will not
+     * see these fields in the return value, though they may have been set
+     * in the Cloud Console.
      * 
*/ public void getBudget( @@ -542,6 +560,10 @@ public void getBudget( * *
      * Returns a list of budgets for a billing account.
+     * WARNING: There are some fields exposed on the Google Cloud Console that
+     * aren’t available on this API. When reading from the API, you will not
+     * see these fields in the return value, though they may have been set
+     * in the Cloud Console.
      * 
*/ public void listBudgets( @@ -615,6 +637,9 @@ public com.google.cloud.billing.budgets.v1beta1.Budget createBudget( * *
      * Updates a budget and returns the updated budget.
+     * WARNING: There are some fields exposed on the Google Cloud Console that
+     * aren’t available on this API. Budget fields that are not exposed in
+     * this API will not be changed by this method.
      * 
*/ public com.google.cloud.billing.budgets.v1beta1.Budget updateBudget( @@ -628,6 +653,10 @@ public com.google.cloud.billing.budgets.v1beta1.Budget updateBudget( * *
      * Returns a budget.
+     * WARNING: There are some fields exposed on the Google Cloud Console that
+     * aren’t available on this API. When reading from the API, you will not
+     * see these fields in the return value, though they may have been set
+     * in the Cloud Console.
      * 
*/ public com.google.cloud.billing.budgets.v1beta1.Budget getBudget( @@ -640,6 +669,10 @@ public com.google.cloud.billing.budgets.v1beta1.Budget getBudget( * *
      * Returns a list of budgets for a billing account.
+     * WARNING: There are some fields exposed on the Google Cloud Console that
+     * aren’t available on this API. When reading from the API, you will not
+     * see these fields in the return value, though they may have been set
+     * in the Cloud Console.
      * 
*/ public com.google.cloud.billing.budgets.v1beta1.ListBudgetsResponse listBudgets( @@ -707,6 +740,9 @@ protected BudgetServiceFutureStub build( * *
      * Updates a budget and returns the updated budget.
+     * WARNING: There are some fields exposed on the Google Cloud Console that
+     * aren’t available on this API. Budget fields that are not exposed in
+     * this API will not be changed by this method.
      * 
*/ public com.google.common.util.concurrent.ListenableFuture< @@ -721,6 +757,10 @@ protected BudgetServiceFutureStub build( * *
      * Returns a budget.
+     * WARNING: There are some fields exposed on the Google Cloud Console that
+     * aren’t available on this API. When reading from the API, you will not
+     * see these fields in the return value, though they may have been set
+     * in the Cloud Console.
      * 
*/ public com.google.common.util.concurrent.ListenableFuture< @@ -735,6 +775,10 @@ protected BudgetServiceFutureStub build( * *
      * Returns a list of budgets for a billing account.
+     * WARNING: There are some fields exposed on the Google Cloud Console that
+     * aren’t available on this API. When reading from the API, you will not
+     * see these fields in the return value, though they may have been set
+     * in the Cloud Console.
      * 
*/ public com.google.common.util.concurrent.ListenableFuture< diff --git a/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/Budget.java b/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/Budget.java index 45628087..378b7b02 100644 --- a/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/Budget.java +++ b/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/Budget.java @@ -411,12 +411,12 @@ public com.google.cloud.billing.budgets.v1beta1.BudgetAmountOrBuilder getAmountO * * *
-   * Required. Rules that trigger alerts (notifications of thresholds
+   * Optional. Rules that trigger alerts (notifications of thresholds
    * being crossed) when spend exceeds the specified percentages of the budget.
    * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public java.util.List @@ -427,12 +427,12 @@ public com.google.cloud.billing.budgets.v1beta1.BudgetAmountOrBuilder getAmountO * * *
-   * Required. Rules that trigger alerts (notifications of thresholds
+   * Optional. Rules that trigger alerts (notifications of thresholds
    * being crossed) when spend exceeds the specified percentages of the budget.
    * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public java.util.List @@ -443,12 +443,12 @@ public com.google.cloud.billing.budgets.v1beta1.BudgetAmountOrBuilder getAmountO * * *
-   * Required. Rules that trigger alerts (notifications of thresholds
+   * Optional. Rules that trigger alerts (notifications of thresholds
    * being crossed) when spend exceeds the specified percentages of the budget.
    * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public int getThresholdRulesCount() { @@ -458,12 +458,12 @@ public int getThresholdRulesCount() { * * *
-   * Required. Rules that trigger alerts (notifications of thresholds
+   * Optional. Rules that trigger alerts (notifications of thresholds
    * being crossed) when spend exceeds the specified percentages of the budget.
    * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public com.google.cloud.billing.budgets.v1beta1.ThresholdRule getThresholdRules(int index) { @@ -473,12 +473,12 @@ public com.google.cloud.billing.budgets.v1beta1.ThresholdRule getThresholdRules( * * *
-   * Required. Rules that trigger alerts (notifications of thresholds
+   * Optional. Rules that trigger alerts (notifications of thresholds
    * being crossed) when spend exceeds the specified percentages of the budget.
    * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public com.google.cloud.billing.budgets.v1beta1.ThresholdRuleOrBuilder getThresholdRulesOrBuilder( @@ -1753,12 +1753,12 @@ private void ensureThresholdRulesIsMutable() { * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public java.util.List @@ -1773,12 +1773,12 @@ private void ensureThresholdRulesIsMutable() { * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public int getThresholdRulesCount() { @@ -1792,12 +1792,12 @@ public int getThresholdRulesCount() { * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public com.google.cloud.billing.budgets.v1beta1.ThresholdRule getThresholdRules(int index) { @@ -1811,12 +1811,12 @@ public com.google.cloud.billing.budgets.v1beta1.ThresholdRule getThresholdRules( * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public Builder setThresholdRules( @@ -1837,12 +1837,12 @@ public Builder setThresholdRules( * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public Builder setThresholdRules( @@ -1860,12 +1860,12 @@ public Builder setThresholdRules( * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public Builder addThresholdRules(com.google.cloud.billing.budgets.v1beta1.ThresholdRule value) { @@ -1885,12 +1885,12 @@ public Builder addThresholdRules(com.google.cloud.billing.budgets.v1beta1.Thresh * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public Builder addThresholdRules( @@ -1911,12 +1911,12 @@ public Builder addThresholdRules( * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public Builder addThresholdRules( @@ -1934,12 +1934,12 @@ public Builder addThresholdRules( * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public Builder addThresholdRules( @@ -1957,12 +1957,12 @@ public Builder addThresholdRules( * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public Builder addAllThresholdRules( @@ -1981,12 +1981,12 @@ public Builder addAllThresholdRules( * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public Builder clearThresholdRules() { @@ -2003,12 +2003,12 @@ public Builder clearThresholdRules() { * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public Builder removeThresholdRules(int index) { @@ -2025,12 +2025,12 @@ public Builder removeThresholdRules(int index) { * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public com.google.cloud.billing.budgets.v1beta1.ThresholdRule.Builder getThresholdRulesBuilder( @@ -2041,12 +2041,12 @@ public com.google.cloud.billing.budgets.v1beta1.ThresholdRule.Builder getThresho * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public com.google.cloud.billing.budgets.v1beta1.ThresholdRuleOrBuilder @@ -2061,12 +2061,12 @@ public com.google.cloud.billing.budgets.v1beta1.ThresholdRule.Builder getThresho * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public java.util.List @@ -2081,12 +2081,12 @@ public com.google.cloud.billing.budgets.v1beta1.ThresholdRule.Builder getThresho * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public com.google.cloud.billing.budgets.v1beta1.ThresholdRule.Builder @@ -2098,12 +2098,12 @@ public com.google.cloud.billing.budgets.v1beta1.ThresholdRule.Builder getThresho * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public com.google.cloud.billing.budgets.v1beta1.ThresholdRule.Builder addThresholdRulesBuilder( @@ -2116,12 +2116,12 @@ public com.google.cloud.billing.budgets.v1beta1.ThresholdRule.Builder addThresho * * *
-     * Required. Rules that trigger alerts (notifications of thresholds
+     * Optional. Rules that trigger alerts (notifications of thresholds
      * being crossed) when spend exceeds the specified percentages of the budget.
      * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ public java.util.List diff --git a/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetModel.java b/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetModel.java index 25ff1088..b47653d5 100644 --- a/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetModel.java +++ b/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetModel.java @@ -71,7 +71,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "(\01322.google.cloud.billing.budgets.v1beta" + "1.BudgetAmountB\003\340A\002\022Q\n\017threshold_rules\030\005" + " \003(\01323.google.cloud.billing.budgets.v1be" - + "ta1.ThresholdRuleB\003\340A\002\022S\n\020all_updates_ru" + + "ta1.ThresholdRuleB\003\340A\001\022S\n\020all_updates_ru" + "le\030\006 \001(\01324.google.cloud.billing.budgets." + "v1beta1.AllUpdatesRuleB\003\340A\001\022\021\n\004etag\030\007 \001(" + "\tB\003\340A\001:]\352AZ\n$billingbudgets.googleapis.c" diff --git a/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetOrBuilder.java b/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetOrBuilder.java index 46a8402d..020b93c0 100644 --- a/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetOrBuilder.java +++ b/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetOrBuilder.java @@ -168,12 +168,12 @@ public interface BudgetOrBuilder * * *
-   * Required. Rules that trigger alerts (notifications of thresholds
+   * Optional. Rules that trigger alerts (notifications of thresholds
    * being crossed) when spend exceeds the specified percentages of the budget.
    * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ java.util.List getThresholdRulesList(); @@ -181,12 +181,12 @@ public interface BudgetOrBuilder * * *
-   * Required. Rules that trigger alerts (notifications of thresholds
+   * Optional. Rules that trigger alerts (notifications of thresholds
    * being crossed) when spend exceeds the specified percentages of the budget.
    * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ com.google.cloud.billing.budgets.v1beta1.ThresholdRule getThresholdRules(int index); @@ -194,12 +194,12 @@ public interface BudgetOrBuilder * * *
-   * Required. Rules that trigger alerts (notifications of thresholds
+   * Optional. Rules that trigger alerts (notifications of thresholds
    * being crossed) when spend exceeds the specified percentages of the budget.
    * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ int getThresholdRulesCount(); @@ -207,12 +207,12 @@ public interface BudgetOrBuilder * * *
-   * Required. Rules that trigger alerts (notifications of thresholds
+   * Optional. Rules that trigger alerts (notifications of thresholds
    * being crossed) when spend exceeds the specified percentages of the budget.
    * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ java.util.List @@ -221,12 +221,12 @@ public interface BudgetOrBuilder * * *
-   * Required. Rules that trigger alerts (notifications of thresholds
+   * Optional. Rules that trigger alerts (notifications of thresholds
    * being crossed) when spend exceeds the specified percentages of the budget.
    * 
* * - * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = REQUIRED]; + * repeated .google.cloud.billing.budgets.v1beta1.ThresholdRule threshold_rules = 5 [(.google.api.field_behavior) = OPTIONAL]; * */ com.google.cloud.billing.budgets.v1beta1.ThresholdRuleOrBuilder getThresholdRulesOrBuilder( diff --git a/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/Filter.java b/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/Filter.java index 3feb8be4..c79b7a0b 100644 --- a/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/Filter.java +++ b/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/Filter.java @@ -291,7 +291,7 @@ private CreditTypesTreatment(int value) { * * *
-   * Optional. A set of projects of the form `projects/{project_id}`,
+   * Optional. A set of projects of the form `projects/{project}`,
    * specifying that usage from only this set of projects should be
    * included in the budget. If omitted, the report will include all usage for
    * the billing account, regardless of which project the usage occurred on.
@@ -309,7 +309,7 @@ public com.google.protobuf.ProtocolStringList getProjectsList() {
    *
    *
    * 
-   * Optional. A set of projects of the form `projects/{project_id}`,
+   * Optional. A set of projects of the form `projects/{project}`,
    * specifying that usage from only this set of projects should be
    * included in the budget. If omitted, the report will include all usage for
    * the billing account, regardless of which project the usage occurred on.
@@ -327,7 +327,7 @@ public int getProjectsCount() {
    *
    *
    * 
-   * Optional. A set of projects of the form `projects/{project_id}`,
+   * Optional. A set of projects of the form `projects/{project}`,
    * specifying that usage from only this set of projects should be
    * included in the budget. If omitted, the report will include all usage for
    * the billing account, regardless of which project the usage occurred on.
@@ -346,7 +346,7 @@ public java.lang.String getProjects(int index) {
    *
    *
    * 
-   * Optional. A set of projects of the form `projects/{project_id}`,
+   * Optional. A set of projects of the form `projects/{project}`,
    * specifying that usage from only this set of projects should be
    * included in the budget. If omitted, the report will include all usage for
    * the billing account, regardless of which project the usage occurred on.
@@ -889,7 +889,7 @@ private void ensureProjectsIsMutable() {
      *
      *
      * 
-     * Optional. A set of projects of the form `projects/{project_id}`,
+     * Optional. A set of projects of the form `projects/{project}`,
      * specifying that usage from only this set of projects should be
      * included in the budget. If omitted, the report will include all usage for
      * the billing account, regardless of which project the usage occurred on.
@@ -907,7 +907,7 @@ public com.google.protobuf.ProtocolStringList getProjectsList() {
      *
      *
      * 
-     * Optional. A set of projects of the form `projects/{project_id}`,
+     * Optional. A set of projects of the form `projects/{project}`,
      * specifying that usage from only this set of projects should be
      * included in the budget. If omitted, the report will include all usage for
      * the billing account, regardless of which project the usage occurred on.
@@ -925,7 +925,7 @@ public int getProjectsCount() {
      *
      *
      * 
-     * Optional. A set of projects of the form `projects/{project_id}`,
+     * Optional. A set of projects of the form `projects/{project}`,
      * specifying that usage from only this set of projects should be
      * included in the budget. If omitted, the report will include all usage for
      * the billing account, regardless of which project the usage occurred on.
@@ -944,7 +944,7 @@ public java.lang.String getProjects(int index) {
      *
      *
      * 
-     * Optional. A set of projects of the form `projects/{project_id}`,
+     * Optional. A set of projects of the form `projects/{project}`,
      * specifying that usage from only this set of projects should be
      * included in the budget. If omitted, the report will include all usage for
      * the billing account, regardless of which project the usage occurred on.
@@ -963,7 +963,7 @@ public com.google.protobuf.ByteString getProjectsBytes(int index) {
      *
      *
      * 
-     * Optional. A set of projects of the form `projects/{project_id}`,
+     * Optional. A set of projects of the form `projects/{project}`,
      * specifying that usage from only this set of projects should be
      * included in the budget. If omitted, the report will include all usage for
      * the billing account, regardless of which project the usage occurred on.
@@ -989,7 +989,7 @@ public Builder setProjects(int index, java.lang.String value) {
      *
      *
      * 
-     * Optional. A set of projects of the form `projects/{project_id}`,
+     * Optional. A set of projects of the form `projects/{project}`,
      * specifying that usage from only this set of projects should be
      * included in the budget. If omitted, the report will include all usage for
      * the billing account, regardless of which project the usage occurred on.
@@ -1014,7 +1014,7 @@ public Builder addProjects(java.lang.String value) {
      *
      *
      * 
-     * Optional. A set of projects of the form `projects/{project_id}`,
+     * Optional. A set of projects of the form `projects/{project}`,
      * specifying that usage from only this set of projects should be
      * included in the budget. If omitted, the report will include all usage for
      * the billing account, regardless of which project the usage occurred on.
@@ -1036,7 +1036,7 @@ public Builder addAllProjects(java.lang.Iterable values) {
      *
      *
      * 
-     * Optional. A set of projects of the form `projects/{project_id}`,
+     * Optional. A set of projects of the form `projects/{project}`,
      * specifying that usage from only this set of projects should be
      * included in the budget. If omitted, the report will include all usage for
      * the billing account, regardless of which project the usage occurred on.
@@ -1057,7 +1057,7 @@ public Builder clearProjects() {
      *
      *
      * 
-     * Optional. A set of projects of the form `projects/{project_id}`,
+     * Optional. A set of projects of the form `projects/{project}`,
      * specifying that usage from only this set of projects should be
      * included in the budget. If omitted, the report will include all usage for
      * the billing account, regardless of which project the usage occurred on.
diff --git a/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/FilterOrBuilder.java b/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/FilterOrBuilder.java
index a8c2e79c..8a026020 100644
--- a/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/FilterOrBuilder.java
+++ b/proto-google-cloud-billingbudgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/FilterOrBuilder.java
@@ -27,7 +27,7 @@ public interface FilterOrBuilder
    *
    *
    * 
-   * Optional. A set of projects of the form `projects/{project_id}`,
+   * Optional. A set of projects of the form `projects/{project}`,
    * specifying that usage from only this set of projects should be
    * included in the budget. If omitted, the report will include all usage for
    * the billing account, regardless of which project the usage occurred on.
@@ -43,7 +43,7 @@ public interface FilterOrBuilder
    *
    *
    * 
-   * Optional. A set of projects of the form `projects/{project_id}`,
+   * Optional. A set of projects of the form `projects/{project}`,
    * specifying that usage from only this set of projects should be
    * included in the budget. If omitted, the report will include all usage for
    * the billing account, regardless of which project the usage occurred on.
@@ -59,7 +59,7 @@ public interface FilterOrBuilder
    *
    *
    * 
-   * Optional. A set of projects of the form `projects/{project_id}`,
+   * Optional. A set of projects of the form `projects/{project}`,
    * specifying that usage from only this set of projects should be
    * included in the budget. If omitted, the report will include all usage for
    * the billing account, regardless of which project the usage occurred on.
@@ -76,7 +76,7 @@ public interface FilterOrBuilder
    *
    *
    * 
-   * Optional. A set of projects of the form `projects/{project_id}`,
+   * Optional. A set of projects of the form `projects/{project}`,
    * specifying that usage from only this set of projects should be
    * included in the budget. If omitted, the report will include all usage for
    * the billing account, regardless of which project the usage occurred on.
diff --git a/proto-google-cloud-billingbudgets-v1beta1/src/main/proto/google/cloud/billing/budgets/v1beta1/budget_model.proto b/proto-google-cloud-billingbudgets-v1beta1/src/main/proto/google/cloud/billing/budgets/v1beta1/budget_model.proto
index 89e96bea..d25cf332 100644
--- a/proto-google-cloud-billingbudgets-v1beta1/src/main/proto/google/cloud/billing/budgets/v1beta1/budget_model.proto
+++ b/proto-google-cloud-billingbudgets-v1beta1/src/main/proto/google/cloud/billing/budgets/v1beta1/budget_model.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -52,9 +51,9 @@ message Budget {
   // Required. Budgeted amount.
   BudgetAmount amount = 4 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. Rules that trigger alerts (notifications of thresholds
+  // Optional. Rules that trigger alerts (notifications of thresholds
   // being crossed) when spend exceeds the specified percentages of the budget.
-  repeated ThresholdRule threshold_rules = 5 [(google.api.field_behavior) = REQUIRED];
+  repeated ThresholdRule threshold_rules = 5 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Rules to apply to all updates to the actual spend, regardless
   // of the thresholds set in `threshold_rules`.
@@ -160,7 +159,7 @@ message Filter {
     EXCLUDE_ALL_CREDITS = 2;
   }
 
-  // Optional. A set of projects of the form `projects/{project_id}`,
+  // Optional. A set of projects of the form `projects/{project}`,
   // specifying that usage from only this set of projects should be
   // included in the budget. If omitted, the report will include all usage for
   // the billing account, regardless of which project the usage occurred on.
diff --git a/proto-google-cloud-billingbudgets-v1beta1/src/main/proto/google/cloud/billing/budgets/v1beta1/budget_service.proto b/proto-google-cloud-billingbudgets-v1beta1/src/main/proto/google/cloud/billing/budgets/v1beta1/budget_service.proto
index d5e0f4bc..ab2b0714 100644
--- a/proto-google-cloud-billingbudgets-v1beta1/src/main/proto/google/cloud/billing/budgets/v1beta1/budget_service.proto
+++ b/proto-google-cloud-billingbudgets-v1beta1/src/main/proto/google/cloud/billing/budgets/v1beta1/budget_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -46,6 +45,10 @@ service BudgetService {
   }
 
   // Updates a budget and returns the updated budget.
+  //
+  // WARNING: There are some fields exposed on the Google Cloud Console that
+  // aren’t available on this API. Budget fields that are not exposed in
+  // this API will not be changed by this method.
   rpc UpdateBudget(UpdateBudgetRequest) returns (Budget) {
     option (google.api.http) = {
       patch: "/v1beta1/{budget.name=billingAccounts/*/budgets/*}"
@@ -54,6 +57,11 @@ service BudgetService {
   }
 
   // Returns a budget.
+  //
+  // WARNING: There are some fields exposed on the Google Cloud Console that
+  // aren’t available on this API. When reading from the API, you will not
+  // see these fields in the return value, though they may have been set
+  // in the Cloud Console.
   rpc GetBudget(GetBudgetRequest) returns (Budget) {
     option (google.api.http) = {
       get: "/v1beta1/{name=billingAccounts/*/budgets/*}"
@@ -61,6 +69,11 @@ service BudgetService {
   }
 
   // Returns a list of budgets for a billing account.
+  //
+  // WARNING: There are some fields exposed on the Google Cloud Console that
+  // aren’t available on this API. When reading from the API, you will not
+  // see these fields in the return value, though they may have been set
+  // in the Cloud Console.
   rpc ListBudgets(ListBudgetsRequest) returns (ListBudgetsResponse) {
     option (google.api.http) = {
       get: "/v1beta1/{parent=billingAccounts/*}/budgets"
diff --git a/synth.metadata b/synth.metadata
index 191f366f..72ed4701 100644
--- a/synth.metadata
+++ b/synth.metadata
@@ -1,5 +1,5 @@
 {
-  "updateTime": "2020-03-17T18:27:37.992686Z",
+  "updateTime": "2020-03-19T09:05:39.285586Z",
   "sources": [
     {
       "generator": {
@@ -12,16 +12,16 @@
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "64ab9744073de81fec1b3a6a931befc8a90edf90",
-        "internalRef": "301373760",
-        "log": "64ab9744073de81fec1b3a6a931befc8a90edf90\nFix: Introduce location-based organization/folder/billing-account resources\nChore: Update copyright years\n\nPiperOrigin-RevId: 301373760\n\n23d5f09e670ebb0c1b36214acf78704e2ecfc2ac\nUpdate field_behavior annotations in V1 and V2.\n\nPiperOrigin-RevId: 301337970\n\nb2cf37e7fd62383a811aa4d54d013ecae638851d\nData Catalog V1 API\n\nPiperOrigin-RevId: 301282503\n\n1976b9981e2900c8172b7d34b4220bdb18c5db42\nCloud DLP api update. Adds missing fields to Finding and adds support for hybrid jobs.\n\nPiperOrigin-RevId: 301205325\n\nae78682c05e864d71223ce22532219813b0245ac\nfix: several sample code blocks in comments are now properly indented for markdown\n\nPiperOrigin-RevId: 301185150\n\ndcd171d04bda5b67db13049320f97eca3ace3731\nPublish Media Translation API V1Beta1\n\nPiperOrigin-RevId: 301180096\n\nff1713453b0fbc5a7544a1ef6828c26ad21a370e\nAdd protos and BUILD rules for v1 API.\n\nPiperOrigin-RevId: 301179394\n\n8386761d09819b665b6a6e1e6d6ff884bc8ff781\nfeat: chromeos/modlab publish protos and config for Chrome OS Moblab API.\n\nPiperOrigin-RevId: 300843960\n\n"
+        "sha": "275fbcce2c900278d487c33293a3c7e1fbcd3a34",
+        "internalRef": "301661567",
+        "log": "275fbcce2c900278d487c33293a3c7e1fbcd3a34\nfeat: pubsub/v1 add an experimental filter field to Subscription\n\nPiperOrigin-RevId: 301661567\n\nf2b18cec51d27c999ad30011dba17f3965677e9c\nFix: UpdateBackupRequest.backup is a resource, not a resource reference - remove annotation.\n\nPiperOrigin-RevId: 301636171\n\n800384063ac93a0cac3a510d41726fa4b2cd4a83\nCloud Billing Budget API v1beta1\nModified api documentation to include warnings about the new filter field.\n\nPiperOrigin-RevId: 301634389\n\n0cc6c146b660db21f04056c3d58a4b752ee445e3\nCloud Billing Budget API v1alpha1\nModified api documentation to include warnings about the new filter field.\n\nPiperOrigin-RevId: 301630018\n\nff2ea00f69065585c3ac0993c8b582af3b6fc215\nFix: Add resource definition for a parent of InspectTemplate which was otherwise missing.\n\nPiperOrigin-RevId: 301623052\n\n55fa441c9daf03173910760191646399338f2b7c\nAdd proto definition for AccessLevel, AccessPolicy, and ServicePerimeter.\n\nPiperOrigin-RevId: 301620844\n\ne7b10591c5408a67cf14ffafa267556f3290e262\nCloud Bigtable Managed Backup service and message proto files.\n\nPiperOrigin-RevId: 301585144\n\nd8e226f702f8ddf92915128c9f4693b63fb8685d\nfeat: Add time-to-live in a queue for builds\n\nPiperOrigin-RevId: 301579876\n\n430375af011f8c7a5174884f0d0e539c6ffa7675\ndocs: add missing closing backtick\n\nPiperOrigin-RevId: 301538851\n\n0e9f1f60ded9ad1c2e725e37719112f5b487ab65\nbazel: Use latest release of gax_java\n\nPiperOrigin-RevId: 301480457\n\n5058c1c96d0ece7f5301a154cf5a07b2ad03a571\nUpdate GAPIC v2 with batching parameters for Logging API\n\nPiperOrigin-RevId: 301443847\n\n"
       }
     },
     {
-      "template": {
-        "name": "java_library",
-        "origin": "synthtool.gcp",
-        "version": "2020.2.4"
+      "git": {
+        "name": "synthtool",
+        "remote": "https://github.com/googleapis/synthtool.git",
+        "sha": "bcad3e01b69851ad682a87f8202003a1683ad73a"
       }
     }
   ],