feat(cloudbilling): update the API

#### cloudbilling:v1beta The following keys were added: - resources.billingAccounts.resources.anomalies.methods.get.description - resources.billingAccounts.resources.anomalies.methods.get.flatPath - resources.billingAccounts.resources.anomalies.methods.get.httpMethod - resources.billingAccounts.resources.anomalies.methods.get.id - resources.billingAccounts.resources.anomalies.methods.get.parameterOrder - resources.billingAccounts.resources.anomalies.methods.get.parameters.name.description - resources.billingAccounts.resources.anomalies.methods.get.parameters.name.location - resources.billingAccounts.resources.anomalies.methods.get.parameters.name.pattern - resources.billingAccounts.resources.anomalies.methods.get.parameters.name.required - resources.billingAccounts.resources.anomalies.methods.get.parameters.name.type - resources.billingAccounts.resources.anomalies.methods.get.path - resources.billingAccounts.resources.anomalies.methods.get.response.$ref - resources.billingAccounts.resources.anomalies.methods.get.scopes - resources.billingAccounts.resources.anomalies.methods.list.description - resources.billingAccounts.resources.anomalies.methods.list.flatPath - resources.billingAccounts.resources.anomalies.methods.list.httpMethod - resources.billingAccounts.resources.anomalies.methods.list.id - resources.billingAccounts.resources.anomalies.methods.list.parameterOrder - resources.billingAccounts.resources.anomalies.methods.list.parameters.filter.description - resources.billingAccounts.resources.anomalies.methods.list.parameters.filter.location - resources.billingAccounts.resources.anomalies.methods.list.parameters.filter.type - resources.billingAccounts.resources.anomalies.methods.list.parameters.pageSize.description - resources.billingAccounts.resources.anomalies.methods.list.parameters.pageSize.format - resources.billingAccounts.resources.anomalies.methods.list.parameters.pageSize.location - resources.billingAccounts.resources.anomalies.methods.list.parameters.pageSize.type - resources.billingAccounts.resources.anomalies.methods.list.parameters.pageToken.description - resources.billingAccounts.resources.anomalies.methods.list.parameters.pageToken.location - resources.billingAccounts.resources.anomalies.methods.list.parameters.pageToken.type - resources.billingAccounts.resources.anomalies.methods.list.parameters.parent.description - resources.billingAccounts.resources.anomalies.methods.list.parameters.parent.location - resources.billingAccounts.resources.anomalies.methods.list.parameters.parent.pattern - resources.billingAccounts.resources.anomalies.methods.list.parameters.parent.required - resources.billingAccounts.resources.anomalies.methods.list.parameters.parent.type - resources.billingAccounts.resources.anomalies.methods.list.path - resources.billingAccounts.resources.anomalies.methods.list.response.$ref - resources.billingAccounts.resources.anomalies.methods.list.scopes - resources.projects.resources.anomalies.methods.get.description - resources.projects.resources.anomalies.methods.get.flatPath - resources.projects.resources.anomalies.methods.get.httpMethod - resources.projects.resources.anomalies.methods.get.id - resources.projects.resources.anomalies.methods.get.parameterOrder - resources.projects.resources.anomalies.methods.get.parameters.name.description - resources.projects.resources.anomalies.methods.get.parameters.name.location - resources.projects.resources.anomalies.methods.get.parameters.name.pattern - resources.projects.resources.anomalies.methods.get.parameters.name.required - resources.projects.resources.anomalies.methods.get.parameters.name.type - resources.projects.resources.anomalies.methods.get.path - resources.projects.resources.anomalies.methods.get.response.$ref - resources.projects.resources.anomalies.methods.get.scopes - resources.projects.resources.anomalies.methods.list.description - resources.projects.resources.anomalies.methods.list.flatPath - resources.projects.resources.anomalies.methods.list.httpMethod - resources.projects.resources.anomalies.methods.list.id - resources.projects.resources.anomalies.methods.list.parameterOrder - resources.projects.resources.anomalies.methods.list.parameters.filter.description - resources.projects.resources.anomalies.methods.list.parameters.filter.location - resources.projects.resources.anomalies.methods.list.parameters.filter.type - resources.projects.resources.anomalies.methods.list.parameters.pageSize.description - resources.projects.resources.anomalies.methods.list.parameters.pageSize.format - resources.projects.resources.anomalies.methods.list.parameters.pageSize.location - resources.projects.resources.anomalies.methods.list.parameters.pageSize.type - resources.projects.resources.anomalies.methods.list.parameters.pageToken.description - resources.projects.resources.anomalies.methods.list.parameters.pageToken.location - resources.projects.resources.anomalies.methods.list.parameters.pageToken.type - resources.projects.resources.anomalies.methods.list.parameters.parent.description - resources.projects.resources.anomalies.methods.list.parameters.parent.location - resources.projects.resources.anomalies.methods.list.parameters.parent.pattern - resources.projects.resources.anomalies.methods.list.parameters.parent.required - resources.projects.resources.anomalies.methods.list.parameters.parent.type - resources.projects.resources.anomalies.methods.list.path - resources.projects.resources.anomalies.methods.list.response.$ref - resources.projects.resources.anomalies.methods.list.scopes - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.description - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.id - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.detectionTime.description - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.detectionTime.format - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.detectionTime.type - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.deviation.$ref - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.deviation.description - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.name.description - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.name.type - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.resourceDisplayName.description - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.resourceDisplayName.type - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.rootCauses.description - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.rootCauses.items.$ref - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.rootCauses.type - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.scope.description - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.scope.enum - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.scope.enumDescriptions - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.scope.type - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.severity.description - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.severity.enum - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.severity.enumDescriptions - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.severity.type - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.updateTime.description - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.updateTime.format - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.updateTime.readOnly - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.properties.updateTime.type - schemas.GoogleCloudBillingAnomaliesV1betaAnomaly.type - schemas.GoogleCloudBillingAnomaliesV1betaAnomalyDeviation.description - schemas.GoogleCloudBillingAnomaliesV1betaAnomalyDeviation.id - schemas.GoogleCloudBillingAnomaliesV1betaAnomalyDeviation.properties.actualSpend.$ref - schemas.GoogleCloudBillingAnomaliesV1betaAnomalyDeviation.properties.actualSpend.description - schemas.GoogleCloudBillingAnomaliesV1betaAnomalyDeviation.properties.deviationAmount.$ref - schemas.GoogleCloudBillingAnomaliesV1betaAnomalyDeviation.properties.deviationAmount.description - schemas.GoogleCloudBillingAnomaliesV1betaAnomalyDeviation.properties.deviationPercentage.description - schemas.GoogleCloudBillingAnomaliesV1betaAnomalyDeviation.properties.deviationPercentage.format - schemas.GoogleCloudBillingAnomaliesV1betaAnomalyDeviation.properties.deviationPercentage.type - schemas.GoogleCloudBillingAnomaliesV1betaAnomalyDeviation.properties.expectedSpend.$ref - schemas.GoogleCloudBillingAnomaliesV1betaAnomalyDeviation.properties.expectedSpend.description - schemas.GoogleCloudBillingAnomaliesV1betaAnomalyDeviation.type - schemas.GoogleCloudBillingAnomaliesV1betaCause.description - schemas.GoogleCloudBillingAnomaliesV1betaCause.id - schemas.GoogleCloudBillingAnomaliesV1betaCause.properties.causeType.description - schemas.GoogleCloudBillingAnomaliesV1betaCause.properties.causeType.enum - schemas.GoogleCloudBillingAnomaliesV1betaCause.properties.causeType.enumDescriptions - schemas.GoogleCloudBillingAnomaliesV1betaCause.properties.causeType.type - schemas.GoogleCloudBillingAnomaliesV1betaCause.properties.deviation.$ref - schemas.GoogleCloudBillingAnomaliesV1betaCause.properties.deviation.description - schemas.GoogleCloudBillingAnomaliesV1betaCause.properties.displayName.description - schemas.GoogleCloudBillingAnomaliesV1betaCause.properties.displayName.type - schemas.GoogleCloudBillingAnomaliesV1betaCause.properties.resource.description - schemas.GoogleCloudBillingAnomaliesV1betaCause.properties.resource.type - schemas.GoogleCloudBillingAnomaliesV1betaCause.properties.subCauses.description - schemas.GoogleCloudBillingAnomaliesV1betaCause.properties.subCauses.items.$ref - schemas.GoogleCloudBillingAnomaliesV1betaCause.properties.subCauses.type - schemas.GoogleCloudBillingAnomaliesV1betaCause.type - schemas.GoogleCloudBillingAnomaliesV1betaListAnomaliesResponse.description - schemas.GoogleCloudBillingAnomaliesV1betaListAnomaliesResponse.id - schemas.GoogleCloudBillingAnomaliesV1betaListAnomaliesResponse.properties.anomalies.description - schemas.GoogleCloudBillingAnomaliesV1betaListAnomaliesResponse.properties.anomalies.items.$ref - schemas.GoogleCloudBillingAnomaliesV1betaListAnomaliesResponse.properties.anomalies.type - schemas.GoogleCloudBillingAnomaliesV1betaListAnomaliesResponse.properties.nextPageToken.description - schemas.GoogleCloudBillingAnomaliesV1betaListAnomaliesResponse.properties.nextPageToken.type - schemas.GoogleCloudBillingAnomaliesV1betaListAnomaliesResponse.type
googleapis · Mar 14, 2024 · b7cf2f0 · b7cf2f0
1 parent 131c12a
commit b7cf2f0
Show file tree

Hide file tree

Showing 2 changed files with 861 additions and 1 deletion.
diff --git a/discovery/cloudbilling-v1beta.json b/discovery/cloudbilling-v1beta.json
@@ -145,6 +145,80 @@
         }
       },
       "resources": {
+        "anomalies": {
+          "methods": {
+            "get": {
+              "description": "Gets an anomaly for a billing account or a project.",
+              "flatPath": "v1beta/billingAccounts/{billingAccountsId}/anomalies/{anomaliesId}",
+              "httpMethod": "GET",
+              "id": "cloudbilling.billingAccounts.anomalies.get",
+              "parameterOrder": [
+                "name"
+              ],
+              "parameters": {
+                "name": {
+                  "description": "Required. Format for project: projects/{project}/anomalies/{anomalies}. Format for billing account: billingAccounts/{billing_account}/anomalies/{anomalies}.",
+                  "location": "path",
+                  "pattern": "^billingAccounts/[^/]+/anomalies/[^/]+$",
+                  "required": true,
+                  "type": "string"
+                }
+              },
+              "path": "v1beta/{+name}",
+              "response": {
+                "$ref": "GoogleCloudBillingAnomaliesV1betaAnomaly"
+              },
+              "scopes": [
+                "https://www.googleapis.com/auth/cloud-billing",
+                "https://www.googleapis.com/auth/cloud-billing.readonly",
+                "https://www.googleapis.com/auth/cloud-platform"
+              ]
+            },
+            "list": {
+              "description": "Lists anomalies for a billing account or a project.",
+              "flatPath": "v1beta/billingAccounts/{billingAccountsId}/anomalies",
+              "httpMethod": "GET",
+              "id": "cloudbilling.billingAccounts.anomalies.list",
+              "parameterOrder": [
+                "parent"
+              ],
+              "parameters": {
+                "filter": {
+                  "description": "Optional. Options for how to filter the anomalies. Currently, only filter on `start_time` and `end_time` is supported. Only =, AND operators are supported. If start_time and/or end_time empty, we only retrieve the most recent 30 days' anomalies. Examples: - start_time = \"20231201\" AND end_time = \"20240120\" .",
+                  "location": "query",
+                  "type": "string"
+                },
+                "pageSize": {
+                  "description": "Optional. Maximum number of anomalies to return. Results may return fewer than this value. Default value is 50 and maximum value is 1000.",
+                  "format": "int32",
+                  "location": "query",
+                  "type": "integer"
+                },
+                "pageToken": {
+                  "description": "Optional. Page token received from a previous ListAnomalies call to retrieve the next page of results. If this field is empty, the first page is returned.",
+                  "location": "query",
+                  "type": "string"
+                },
+                "parent": {
+                  "description": "Required. The project to list Anomaly for the project. Format for project: projects/{project}. Format for billing account: billingAccounts/{billing_account}.",
+                  "location": "path",
+                  "pattern": "^billingAccounts/[^/]+$",
+                  "required": true,
+                  "type": "string"
+                }
+              },
+              "path": "v1beta/{+parent}/anomalies",
+              "response": {
+                "$ref": "GoogleCloudBillingAnomaliesV1betaListAnomaliesResponse"
+              },
+              "scopes": [
+                "https://www.googleapis.com/auth/cloud-billing",
+                "https://www.googleapis.com/auth/cloud-billing.readonly",
+                "https://www.googleapis.com/auth/cloud-platform"
+              ]
+            }
+          }
+        },
         "services": {
           "methods": {
             "get": {
@@ -515,6 +589,84 @@
         }
       }
     },
+    "projects": {
+      "resources": {
+        "anomalies": {
+          "methods": {
+            "get": {
+              "description": "Gets an anomaly for a billing account or a project.",
+              "flatPath": "v1beta/projects/{projectsId}/anomalies/{anomaliesId}",
+              "httpMethod": "GET",
+              "id": "cloudbilling.projects.anomalies.get",
+              "parameterOrder": [
+                "name"
+              ],
+              "parameters": {
+                "name": {
+                  "description": "Required. Format for project: projects/{project}/anomalies/{anomalies}. Format for billing account: billingAccounts/{billing_account}/anomalies/{anomalies}.",
+                  "location": "path",
+                  "pattern": "^projects/[^/]+/anomalies/[^/]+$",
+                  "required": true,
+                  "type": "string"
+                }
+              },
+              "path": "v1beta/{+name}",
+              "response": {
+                "$ref": "GoogleCloudBillingAnomaliesV1betaAnomaly"
+              },
+              "scopes": [
+                "https://www.googleapis.com/auth/cloud-billing",
+                "https://www.googleapis.com/auth/cloud-billing.readonly",
+                "https://www.googleapis.com/auth/cloud-platform"
+              ]
+            },
+            "list": {
+              "description": "Lists anomalies for a billing account or a project.",
+              "flatPath": "v1beta/projects/{projectsId}/anomalies",
+              "httpMethod": "GET",
+              "id": "cloudbilling.projects.anomalies.list",
+              "parameterOrder": [
+                "parent"
+              ],
+              "parameters": {
+                "filter": {
+                  "description": "Optional. Options for how to filter the anomalies. Currently, only filter on `start_time` and `end_time` is supported. Only =, AND operators are supported. If start_time and/or end_time empty, we only retrieve the most recent 30 days' anomalies. Examples: - start_time = \"20231201\" AND end_time = \"20240120\" .",
+                  "location": "query",
+                  "type": "string"
+                },
+                "pageSize": {
+                  "description": "Optional. Maximum number of anomalies to return. Results may return fewer than this value. Default value is 50 and maximum value is 1000.",
+                  "format": "int32",
+                  "location": "query",
+                  "type": "integer"
+                },
+                "pageToken": {
+                  "description": "Optional. Page token received from a previous ListAnomalies call to retrieve the next page of results. If this field is empty, the first page is returned.",
+                  "location": "query",
+                  "type": "string"
+                },
+                "parent": {
+                  "description": "Required. The project to list Anomaly for the project. Format for project: projects/{project}. Format for billing account: billingAccounts/{billing_account}.",
+                  "location": "path",
+                  "pattern": "^projects/[^/]+$",
+                  "required": true,
+                  "type": "string"
+                }
+              },
+              "path": "v1beta/{+parent}/anomalies",
+              "response": {
+                "$ref": "GoogleCloudBillingAnomaliesV1betaListAnomaliesResponse"
+              },
+              "scopes": [
+                "https://www.googleapis.com/auth/cloud-billing",
+                "https://www.googleapis.com/auth/cloud-billing.readonly",
+                "https://www.googleapis.com/auth/cloud-platform"
+              ]
+            }
+          }
+        }
+      }
+    },
     "skuGroups": {
       "methods": {
         "get": {
@@ -758,7 +910,7 @@
       }
     }
   },
-  "revision": "20231215",
+  "revision": "20240311",
   "rootUrl": "https://cloudbilling.googleapis.com/",
   "schemas": {
     "CacheFillRegions": {
@@ -1319,6 +1471,159 @@
       },
       "type": "object"
     },
+    "GoogleCloudBillingAnomaliesV1betaAnomaly": {
+      "description": "Encapsulates an anomaly.",
+      "id": "GoogleCloudBillingAnomaliesV1betaAnomaly",
+      "properties": {
+        "detectionTime": {
+          "description": "Time that the anomaly was detected. Will be set to 00:00 google time of the detected date.",
+          "format": "google-datetime",
+          "type": "string"
+        },
+        "deviation": {
+          "$ref": "GoogleCloudBillingAnomaliesV1betaAnomalyDeviation",
+          "description": "Deviation information of the anomaly."
+        },
+        "name": {
+          "description": "Identifier. Resource name for the anomaly.",
+          "type": "string"
+        },
+        "resourceDisplayName": {
+          "description": "The display name of the resource that the anomaly occurred in/belongs to.",
+          "type": "string"
+        },
+        "rootCauses": {
+          "description": "A list of causes which contribute to the anomaly.",
+          "items": {
+            "$ref": "GoogleCloudBillingAnomaliesV1betaCause"
+          },
+          "type": "array"
+        },
+        "scope": {
+          "description": "Indicate the scope of the anomaly.",
+          "enum": [
+            "SCOPE_UNSPECIFIED",
+            "SCOPE_BILLING_ACCOUNT",
+            "SCOPE_PROJECT"
+          ],
+          "enumDescriptions": [
+            "Default unspecified value.",
+            "Indicates the anomaly is for a billing account.",
+            "Indicates the anomaly is for a project."
+          ],
+          "type": "string"
+        },
+        "severity": {
+          "description": "Severity of the anomaly. Unspecified if severity is not met/assigned.",
+          "enum": [
+            "ANOMALY_SEVERITY_UNSPECIFIED",
+            "ANOMALY_SEVERITY_LOW",
+            "ANOMALY_SEVERITY_MEDIUM",
+            "ANOMALY_SEVERITY_HIGH"
+          ],
+          "enumDescriptions": [
+            "Default unspecified value.",
+            "Indicates the anomaly's severity is low.",
+            "Indicates the anomaly's severity is medium.",
+            "Indicates the anomaly's severity is high."
+          ],
+          "type": "string"
+        },
+        "updateTime": {
+          "description": "Output only. The most recent anomaly's last updated time.",
+          "format": "google-datetime",
+          "readOnly": true,
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "GoogleCloudBillingAnomaliesV1betaAnomalyDeviation": {
+      "description": "Encapsulates the deviation information.",
+      "id": "GoogleCloudBillingAnomaliesV1betaAnomalyDeviation",
+      "properties": {
+        "actualSpend": {
+          "$ref": "Money",
+          "description": "The actual spend for the anomaly."
+        },
+        "deviationAmount": {
+          "$ref": "Money",
+          "description": "The difference between the actual spend and expected spend's upper bound. Calculation formula: deviation_amount = actual_spend - expected_spend."
+        },
+        "deviationPercentage": {
+          "description": "The percentage of devition amount from expected spend's upper bound. Calculation formula: deviation_percentage = divation_amount / expected_spend * 100.",
+          "format": "double",
+          "type": "number"
+        },
+        "expectedSpend": {
+          "$ref": "Money",
+          "description": "The expected spend for the anomaly."
+        }
+      },
+      "type": "object"
+    },
+    "GoogleCloudBillingAnomaliesV1betaCause": {
+      "description": "Encapsulates the information of the reason which caused the anomaly.",
+      "id": "GoogleCloudBillingAnomaliesV1betaCause",
+      "properties": {
+        "causeType": {
+          "description": "The cause type.",
+          "enum": [
+            "CAUSE_TYPE_UNSPECIFIED",
+            "CAUSE_TYPE_PROJECT",
+            "CAUSE_TYPE_SERVICE",
+            "CAUSE_TYPE_SKU",
+            "CAUSE_TYPE_LOCATION"
+          ],
+          "enumDescriptions": [
+            "Default unspecified value.",
+            "Caused by a project.",
+            "Caused by a service.",
+            "Caused by a SKU.",
+            "Caused by a location."
+          ],
+          "type": "string"
+        },
+        "deviation": {
+          "$ref": "GoogleCloudBillingAnomaliesV1betaAnomalyDeviation",
+          "description": "The deviation information for the cause."
+        },
+        "displayName": {
+          "description": "The display name of the cause.",
+          "type": "string"
+        },
+        "resource": {
+          "description": "The resource name of the cause. project: projects/{project}. service: services/{service}. sku: services/{service}/skus/{sku}. location: locations/{location}.",
+          "type": "string"
+        },
+        "subCauses": {
+          "description": "The sub causes.",
+          "items": {
+            "$ref": "GoogleCloudBillingAnomaliesV1betaCause"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "GoogleCloudBillingAnomaliesV1betaListAnomaliesResponse": {
+      "description": "Response message for ListAnomalies.",
+      "id": "GoogleCloudBillingAnomaliesV1betaListAnomaliesResponse",
+      "properties": {
+        "anomalies": {
+          "description": "The returned anomalies.",
+          "items": {
+            "$ref": "GoogleCloudBillingAnomaliesV1betaAnomaly"
+          },
+          "type": "array"
+        },
+        "nextPageToken": {
+          "description": "Token that can be sent as `page_token` in the subsequent request to retrieve the next page. If this field is empty, there are no subsequent pages.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "GoogleCloudBillingBillingaccountpricesV1betaAggregationInfo": {
       "description": "Encapsulates the aggregation information such as aggregation level and interval for a billing account price.",
       "id": "GoogleCloudBillingBillingaccountpricesV1betaAggregationInfo",