From 857a51e47b42f642555ff5ade0e8a39c55059e6e Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 2 Jan 2024 01:32:32 +0000 Subject: [PATCH] feat(cloudbilling): update the API #### cloudbilling:v1beta The following keys were added: - resources.billingAccounts.resources.skus.resources.prices.methods.list.description - resources.billingAccounts.resources.skus.resources.prices.methods.list.flatPath - resources.billingAccounts.resources.skus.resources.prices.methods.list.httpMethod - resources.billingAccounts.resources.skus.resources.prices.methods.list.id - resources.billingAccounts.resources.skus.resources.prices.methods.list.parameterOrder - resources.billingAccounts.resources.skus.resources.prices.methods.list.parameters.currencyCode.description - resources.billingAccounts.resources.skus.resources.prices.methods.list.parameters.currencyCode.location - resources.billingAccounts.resources.skus.resources.prices.methods.list.parameters.currencyCode.type - resources.billingAccounts.resources.skus.resources.prices.methods.list.parameters.pageSize.description - resources.billingAccounts.resources.skus.resources.prices.methods.list.parameters.pageSize.format - resources.billingAccounts.resources.skus.resources.prices.methods.list.parameters.pageSize.location - resources.billingAccounts.resources.skus.resources.prices.methods.list.parameters.pageSize.type - resources.billingAccounts.resources.skus.resources.prices.methods.list.parameters.pageToken.description - resources.billingAccounts.resources.skus.resources.prices.methods.list.parameters.pageToken.location - resources.billingAccounts.resources.skus.resources.prices.methods.list.parameters.pageToken.type - resources.billingAccounts.resources.skus.resources.prices.methods.list.parameters.parent.description - resources.billingAccounts.resources.skus.resources.prices.methods.list.parameters.parent.location - resources.billingAccounts.resources.skus.resources.prices.methods.list.parameters.parent.pattern - resources.billingAccounts.resources.skus.resources.prices.methods.list.parameters.parent.required - resources.billingAccounts.resources.skus.resources.prices.methods.list.parameters.parent.type - resources.billingAccounts.resources.skus.resources.prices.methods.list.path - resources.billingAccounts.resources.skus.resources.prices.methods.list.response.$ref - resources.billingAccounts.resources.skus.resources.prices.methods.list.scopes - resources.skus.resources.prices.methods.list.description - resources.skus.resources.prices.methods.list.flatPath - resources.skus.resources.prices.methods.list.httpMethod - resources.skus.resources.prices.methods.list.id - resources.skus.resources.prices.methods.list.parameterOrder - resources.skus.resources.prices.methods.list.parameters.currencyCode.description - resources.skus.resources.prices.methods.list.parameters.currencyCode.location - resources.skus.resources.prices.methods.list.parameters.currencyCode.type - resources.skus.resources.prices.methods.list.parameters.pageSize.description - resources.skus.resources.prices.methods.list.parameters.pageSize.format - resources.skus.resources.prices.methods.list.parameters.pageSize.location - resources.skus.resources.prices.methods.list.parameters.pageSize.type - resources.skus.resources.prices.methods.list.parameters.pageToken.description - resources.skus.resources.prices.methods.list.parameters.pageToken.location - resources.skus.resources.prices.methods.list.parameters.pageToken.type - resources.skus.resources.prices.methods.list.parameters.parent.description - resources.skus.resources.prices.methods.list.parameters.parent.location - resources.skus.resources.prices.methods.list.parameters.parent.pattern - resources.skus.resources.prices.methods.list.parameters.parent.required - resources.skus.resources.prices.methods.list.parameters.parent.type - resources.skus.resources.prices.methods.list.path - resources.skus.resources.prices.methods.list.response.$ref - resources.skus.resources.prices.methods.list.scopes - schemas.GoogleCloudBillingBillingaccountpricesV1betaListBillingAccountPricesResponse.description - schemas.GoogleCloudBillingBillingaccountpricesV1betaListBillingAccountPricesResponse.id - schemas.GoogleCloudBillingBillingaccountpricesV1betaListBillingAccountPricesResponse.properties.billingAccountPrices.description - schemas.GoogleCloudBillingBillingaccountpricesV1betaListBillingAccountPricesResponse.properties.billingAccountPrices.items.$ref - schemas.GoogleCloudBillingBillingaccountpricesV1betaListBillingAccountPricesResponse.properties.billingAccountPrices.type - schemas.GoogleCloudBillingBillingaccountpricesV1betaListBillingAccountPricesResponse.properties.nextPageToken.description - schemas.GoogleCloudBillingBillingaccountpricesV1betaListBillingAccountPricesResponse.properties.nextPageToken.type - schemas.GoogleCloudBillingBillingaccountpricesV1betaListBillingAccountPricesResponse.type - schemas.GoogleCloudBillingPricesV1betaListPricesResponse.description - schemas.GoogleCloudBillingPricesV1betaListPricesResponse.id - schemas.GoogleCloudBillingPricesV1betaListPricesResponse.properties.nextPageToken.description - schemas.GoogleCloudBillingPricesV1betaListPricesResponse.properties.nextPageToken.type - schemas.GoogleCloudBillingPricesV1betaListPricesResponse.properties.prices.description - schemas.GoogleCloudBillingPricesV1betaListPricesResponse.properties.prices.items.$ref - schemas.GoogleCloudBillingPricesV1betaListPricesResponse.properties.prices.type - schemas.GoogleCloudBillingPricesV1betaListPricesResponse.type The following keys were changed: - schemas.CloudCdnEgressWorkload.description - schemas.CloudCdnEgressWorkload.properties.cacheEgressDestination.description - schemas.CloudCdnEgressWorkload.properties.cacheEgressRate.description - schemas.CloudInterconnectEgressWorkload.description - schemas.CloudInterconnectEgressWorkload.properties.egressRate.description - schemas.CloudInterconnectEgressWorkload.properties.interconnectConnectionLocation.description - schemas.CloudStorageEgressWorkload.description - schemas.CloudStorageEgressWorkload.properties.egressRate.description - schemas.CloudStorageWorkload.properties.dataRetrieval.description - schemas.CloudStorageWorkload.properties.dataStored.description - schemas.InterRegionEgress.description - schemas.InterRegionEgress.properties.destinationRegion.description - schemas.InterRegionEgress.properties.egressRate.description - schemas.InterRegionEgress.properties.sourceRegion.description - schemas.IntraRegionEgress.description - schemas.IntraRegionEgress.properties.egressRate.description - schemas.PremiumTierEgressWorkload.description - schemas.PremiumTierEgressWorkload.properties.egressRate.description - schemas.PremiumTierEgressWorkload.properties.sourceRegion.description - schemas.StandardTierEgressWorkload.description - schemas.StandardTierEgressWorkload.properties.egressRate.description - schemas.StandardTierEgressWorkload.properties.sourceRegion.description - schemas.VmToVmEgressWorkload.description - schemas.Workload.properties.cloudCdnEgressWorkload.description - schemas.Workload.properties.cloudInterconnectEgressWorkload.description - schemas.Workload.properties.cloudStorageEgressWorkload.description - schemas.Workload.properties.premiumTierEgressWorkload.description - schemas.Workload.properties.standardTierEgressWorkload.description - schemas.Workload.properties.vmToVmEgressWorkload.description #### cloudbilling:v1 The following keys were changed: - resources.billingAccounts.methods.create.parameters.parent.description - resources.billingAccounts.methods.list.parameters.filter.description - resources.billingAccounts.methods.list.parameters.parent.description - resources.billingAccounts.resources.subAccounts.methods.create.parameters.parent.description - resources.billingAccounts.resources.subAccounts.methods.list.parameters.filter.description - resources.billingAccounts.resources.subAccounts.methods.list.parameters.parent.description - resources.organizations.resources.billingAccounts.methods.create.parameters.parent.description - resources.organizations.resources.billingAccounts.methods.list.parameters.filter.description - resources.organizations.resources.billingAccounts.methods.list.parameters.parent.description - resources.organizations.resources.billingAccounts.methods.move.parameters.destinationParent.description - schemas.BillingAccount.properties.open.description - schemas.BillingAccount.properties.parent.description - schemas.Binding.properties.members.description - schemas.MoveBillingAccountRequest.properties.destinationParent.description --- discovery/cloudbilling-v1.json | 30 +-- discovery/cloudbilling-v1beta.json | 190 ++++++++++++++--- src/apis/cloudbilling/v1.ts | 28 +-- src/apis/cloudbilling/v1beta.ts | 332 ++++++++++++++++++++++++++--- 4 files changed, 492 insertions(+), 88 deletions(-) diff --git a/discovery/cloudbilling-v1.json b/discovery/cloudbilling-v1.json index 6cb5e4f28f..80fb796c02 100644 --- a/discovery/cloudbilling-v1.json +++ b/discovery/cloudbilling-v1.json @@ -121,7 +121,7 @@ "parameterOrder": [], "parameters": { "parent": { - "description": "Optional. The parent to create a billing account from. Format: - organizations/{organization_id} eg organizations/12345678 - billingAccounts/{billing_account_id} eg `billingAccounts/012345-567890-ABCDEF`", + "description": "Optional. The parent to create a billing account from. Format: - `organizations/{organization_id}`, for example, `organizations/12345678` - `billingAccounts/{billing_account_id}`, for example, `billingAccounts/012345-567890-ABCDEF`", "location": "query", "type": "string" } @@ -206,7 +206,7 @@ "parameterOrder": [], "parameters": { "filter": { - "description": "Options for how to filter the returned billing accounts. This only supports filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts) under a single provided parent billing account. (e.g. \"master_billing_account=billingAccounts/012345-678901-ABCDEF\"). Boolean algebra and other fields are not currently supported.", + "description": "Options for how to filter the returned billing accounts. This only supports filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts) under a single provided parent billing account. (for example, `master_billing_account=billingAccounts/012345-678901-ABCDEF`). Boolean algebra and other fields are not currently supported.", "location": "query", "type": "string" }, @@ -222,7 +222,7 @@ "type": "string" }, "parent": { - "description": "Optional. The parent resource to list billing accounts from. Format: - organizations/{organization_id} eg organizations/12345678 - billingAccounts/{billing_account_id} eg `billingAccounts/012345-567890-ABCDEF`", + "description": "Optional. The parent resource to list billing accounts from. Format: - `organizations/{organization_id}`, for example, `organizations/12345678` - `billingAccounts/{billing_account_id}`, for example, `billingAccounts/012345-567890-ABCDEF`", "location": "query", "type": "string" } @@ -416,7 +416,7 @@ ], "parameters": { "parent": { - "description": "Optional. The parent to create a billing account from. Format: - organizations/{organization_id} eg organizations/12345678 - billingAccounts/{billing_account_id} eg `billingAccounts/012345-567890-ABCDEF`", + "description": "Optional. The parent to create a billing account from. Format: - `organizations/{organization_id}`, for example, `organizations/12345678` - `billingAccounts/{billing_account_id}`, for example, `billingAccounts/012345-567890-ABCDEF`", "location": "path", "pattern": "^billingAccounts/[^/]+$", "required": true, @@ -445,7 +445,7 @@ ], "parameters": { "filter": { - "description": "Options for how to filter the returned billing accounts. This only supports filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts) under a single provided parent billing account. (e.g. \"master_billing_account=billingAccounts/012345-678901-ABCDEF\"). Boolean algebra and other fields are not currently supported.", + "description": "Options for how to filter the returned billing accounts. This only supports filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts) under a single provided parent billing account. (for example, `master_billing_account=billingAccounts/012345-678901-ABCDEF`). Boolean algebra and other fields are not currently supported.", "location": "query", "type": "string" }, @@ -461,7 +461,7 @@ "type": "string" }, "parent": { - "description": "Optional. The parent resource to list billing accounts from. Format: - organizations/{organization_id} eg organizations/12345678 - billingAccounts/{billing_account_id} eg `billingAccounts/012345-567890-ABCDEF`", + "description": "Optional. The parent resource to list billing accounts from. Format: - `organizations/{organization_id}`, for example, `organizations/12345678` - `billingAccounts/{billing_account_id}`, for example, `billingAccounts/012345-567890-ABCDEF`", "location": "path", "pattern": "^billingAccounts/[^/]+$", "required": true, @@ -496,7 +496,7 @@ ], "parameters": { "parent": { - "description": "Optional. The parent to create a billing account from. Format: - organizations/{organization_id} eg organizations/12345678 - billingAccounts/{billing_account_id} eg `billingAccounts/012345-567890-ABCDEF`", + "description": "Optional. The parent to create a billing account from. Format: - `organizations/{organization_id}`, for example, `organizations/12345678` - `billingAccounts/{billing_account_id}`, for example, `billingAccounts/012345-567890-ABCDEF`", "location": "path", "pattern": "^organizations/[^/]+$", "required": true, @@ -525,7 +525,7 @@ ], "parameters": { "filter": { - "description": "Options for how to filter the returned billing accounts. This only supports filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts) under a single provided parent billing account. (e.g. \"master_billing_account=billingAccounts/012345-678901-ABCDEF\"). Boolean algebra and other fields are not currently supported.", + "description": "Options for how to filter the returned billing accounts. This only supports filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts) under a single provided parent billing account. (for example, `master_billing_account=billingAccounts/012345-678901-ABCDEF`). Boolean algebra and other fields are not currently supported.", "location": "query", "type": "string" }, @@ -541,7 +541,7 @@ "type": "string" }, "parent": { - "description": "Optional. The parent resource to list billing accounts from. Format: - organizations/{organization_id} eg organizations/12345678 - billingAccounts/{billing_account_id} eg `billingAccounts/012345-567890-ABCDEF`", + "description": "Optional. The parent resource to list billing accounts from. Format: - `organizations/{organization_id}`, for example, `organizations/12345678` - `billingAccounts/{billing_account_id}`, for example, `billingAccounts/012345-567890-ABCDEF`", "location": "path", "pattern": "^organizations/[^/]+$", "required": true, @@ -569,7 +569,7 @@ ], "parameters": { "destinationParent": { - "description": "Required. The resource name of the Organization to reparent the billing account under. Must be of the form `organizations/{organization_id}`.", + "description": "Required. The resource name of the Organization to move the billing account under. Must be of the form `organizations/{organization_id}`.", "location": "path", "pattern": "^organizations/[^/]+$", "required": true, @@ -751,7 +751,7 @@ } } }, - "revision": "20231120", + "revision": "20231215", "rootUrl": "https://cloudbilling.googleapis.com/", "schemas": { "AggregationInfo": { @@ -858,12 +858,12 @@ "type": "string" }, "open": { - "description": "Output only. True if the billing account is open, and will therefore be charged for any usage on associated projects. False if the billing account is closed, and therefore projects associated with it will be unable to use paid services.", + "description": "Output only. True if the billing account is open, and will therefore be charged for any usage on associated projects. False if the billing account is closed, and therefore projects associated with it are unable to use paid services.", "readOnly": true, "type": "boolean" }, "parent": { - "description": "Output only. The billing account's parent resource identifier. Use the `MoveBillingAccount` method to update the account's parent resource if it is a organization. Format: - organizations/{organization_id}, for example: organizations/12345678 - billingAccounts/{billing_account_id}, for example: `billingAccounts/012345-567890-ABCDEF`", + "description": "Output only. The billing account's parent resource identifier. Use the `MoveBillingAccount` method to update the account's parent resource if it is a organization. Format: - `organizations/{organization_id}`, for example, `organizations/12345678` - `billingAccounts/{billing_account_id}`, for example, `billingAccounts/012345-567890-ABCDEF`", "readOnly": true, "type": "string" } @@ -879,7 +879,7 @@ "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." }, "members": { - "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding.", + "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.", "items": { "type": "string" }, @@ -1066,7 +1066,7 @@ "id": "MoveBillingAccountRequest", "properties": { "destinationParent": { - "description": "Required. The resource name of the Organization to reparent the billing account under. Must be of the form `organizations/{organization_id}`.", + "description": "Required. The resource name of the Organization to move the billing account under. Must be of the form `organizations/{organization_id}`.", "type": "string" } }, diff --git a/discovery/cloudbilling-v1beta.json b/discovery/cloudbilling-v1beta.json index cdb261949e..8dc15333b8 100644 --- a/discovery/cloudbilling-v1beta.json +++ b/discovery/cloudbilling-v1beta.json @@ -463,6 +463,53 @@ ] } } + }, + "prices": { + "methods": { + "list": { + "description": "Lists the latest prices for SKUs available to your Cloud Billing account.", + "flatPath": "v1beta/billingAccounts/{billingAccountsId}/skus/{skusId}/prices", + "httpMethod": "GET", + "id": "cloudbilling.billingAccounts.skus.prices.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "currencyCode": { + "description": "Optional. ISO-4217 currency code for the price. If not specified, currency of billing account will be used.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. Maximum number of billing account price to return. Results may return fewer than this value. Default value is 50 and maximum value is 5000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. Page token received from a previous ListBillingAccountPrices 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. To list all Billing Account SKUs, use `-` as the SKU ID. Format: `billingAccounts/{billing_account}/skus/-` Note: Specifying an actual SKU resource id will return a collection of one Billing Account Price.", + "location": "path", + "pattern": "^billingAccounts/[^/]+/skus/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+parent}/prices", + "response": { + "$ref": "GoogleCloudBillingBillingaccountpricesV1betaListBillingAccountPricesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-billing", + "https://www.googleapis.com/auth/cloud-billing.readonly", + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } } } } @@ -636,6 +683,53 @@ ] } } + }, + "prices": { + "methods": { + "list": { + "description": "Lists the latest prices for all SKUs.", + "flatPath": "v1beta/skus/{skusId}/prices", + "httpMethod": "GET", + "id": "cloudbilling.skus.prices.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "currencyCode": { + "description": "Optional. ISO-4217 currency code for the price. If not specified, USD will be used.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. Maximum number of prices to return. Results may return fewer than this value. Default value is 50 and maximum value is 5000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. Page token received from a previous ListPrices 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. To list the prices for all SKUs, use `-` as the SKU ID. Format: `skus/-` Specifying a specific SKU ID returns a collection with one Price object for the SKU.", + "location": "path", + "pattern": "^skus/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+parent}/prices", + "response": { + "$ref": "GoogleCloudBillingPricesV1betaListPricesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-billing", + "https://www.googleapis.com/auth/cloud-billing.readonly", + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } } } }, @@ -664,7 +758,7 @@ } } }, - "revision": "20231120", + "revision": "20231215", "rootUrl": "https://cloudbilling.googleapis.com/", "schemas": { "CacheFillRegions": { @@ -719,11 +813,11 @@ "type": "object" }, "CloudCdnEgressWorkload": { - "description": "Specifies usage for Cloud CDN egress.", + "description": "Specifies usage for Cloud CDN Data Transfer.", "id": "CloudCdnEgressWorkload", "properties": { "cacheEgressDestination": { - "description": "The destination for the cache egress charges.", + "description": "The destination for the cache data transfer.", "enum": [ "CACHE_EGRESS_DESTINATION_UNSPECIFIED", "CACHE_EGRESS_DESTINATION_ASIA_PACIFIC", @@ -748,7 +842,7 @@ }, "cacheEgressRate": { "$ref": "Usage", - "description": "Cache egress usage. The rate of data cache egressed in the destination. For example : units such as \"GiBy/s\" or \"TBy/mo\"." + "description": "Cache data transfer usage. The rate of data cache transferred to the destination. Use units such as GiBy/s or TiBy/mo, based on [The Unified Code for Units of Measure](https://ucum.org/ucum.html) standard." } }, "type": "object" @@ -787,15 +881,15 @@ "type": "object" }, "CloudInterconnectEgressWorkload": { - "description": "The interconnect egress only includes the Interconnect Egress. Please use the standard egress traffic interface to specify your standard egress usage.", + "description": "Includes the estimate for Interconnect Data Transfer only. To specify usage for data transfer between VMs and internet end-points, use the Standard Tier Internet Data Transfer interface.", "id": "CloudInterconnectEgressWorkload", "properties": { "egressRate": { "$ref": "Usage", - "description": "Data egress usage. This usage applies when you move or copy data from one Google Cloud service to another service. Expected units such as \"GiBy/s, By/s, etc.\"" + "description": "Outbound data transfer usage. This usage applies when you move or copy data from one Google Cloud service to another service. The units are GiBy/s, By/s, and so on, based on [The Unified Code for Units of Measure](https://ucum.org/ucum.html) standard." }, "interconnectConnectionLocation": { - "description": "Locations in the [Interconnect connection location table](https://cloud.google.com/vpc/network-pricing#interconnect-pricing). This is the interconnect egress charges.", + "description": "Locations in the [Interconnect connection location table](https://cloud.google.com/vpc/network-pricing#interconnect-pricing). These are the Interconnect Data Transfer charges.", "enum": [ "INTERCONNECT_CONNECTION_LOCATION_UNSPECIFIED", "INTERCONNECT_CONNECTION_LOCATION_ASIA", @@ -864,7 +958,7 @@ "type": "object" }, "CloudStorageEgressWorkload": { - "description": "Specification of a network type. Network egress within Google Cloud applies when you move or copy data from one Cloud Storage bucket to another or when another Google Cloud service accesses data in your Cloud Storage bucket.This includes the network egress within Google Cloud and the general network usage.", + "description": "Specification of a network type. Network data transfer within Google Cloud applies when you move or copy data from one Cloud Storage bucket to another or when another Google Cloud service accesses data in your Cloud Storage bucket.This includes the network data transfer within Google Cloud and the general network usage.", "id": "CloudStorageEgressWorkload", "properties": { "destinationContinent": { @@ -889,7 +983,7 @@ }, "egressRate": { "$ref": "Usage", - "description": "Egress usage rate. This usage applies when you move or copy data from one Cloud Storage bucket to another or when another Google Cloud service accesses data in your Cloud Storage bucket. Expected units such as \"GiBy/s, By/s, ...\"" + "description": "Data transfer usage rate. This usage applies when you move or copy data from one Cloud Storage bucket to another or when another Google Cloud service accesses data in your Cloud Storage bucket. The expected units are GiBy/s, By/s, and so on, based on [The Unified Code for Units of Measure](https://ucum.org/ucum.html) standard." }, "sourceContinent": { "description": "Where the data comes from.", @@ -920,11 +1014,11 @@ "properties": { "dataRetrieval": { "$ref": "Usage", - "description": "Data retrieval usage. A retrieval cost applies when data or metadata is read, copied, or rewritten . For example: units such as \"GiBy/s\" or \"By/s\"." + "description": "Data retrieval usage. A retrieval cost applies when data or metadata is read, copied, or rewritten . For example: units such as \"GiB/s\" or \"B/s\"." }, "dataStored": { "$ref": "Usage", - "description": "Data storage usage. The amount of data stored in buckets. For example: units such as \"GiBy/s\" or \"TBy/mo\"." + "description": "Data storage usage. The amount of data stored in buckets. For example: units such as GiBy/s or TiBy/mo, based on [The Unified Code for Units of Measure](https://ucum.org/ucum.html) standard." }, "dualRegion": { "$ref": "DualRegional", @@ -1342,6 +1436,24 @@ }, "type": "object" }, + "GoogleCloudBillingBillingaccountpricesV1betaListBillingAccountPricesResponse": { + "description": "Response message for ListBillingAccountPrices.", + "id": "GoogleCloudBillingBillingaccountpricesV1betaListBillingAccountPricesResponse", + "properties": { + "billingAccountPrices": { + "description": "The returned billing account prices.", + "items": { + "$ref": "GoogleCloudBillingBillingaccountpricesV1betaBillingAccountPrice" + }, + "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" + }, "GoogleCloudBillingBillingaccountpricesV1betaListPriceAsCeiling": { "description": "Encapsulates a contract feature that the list price (DefaultPrice) will be used for the price if the current list price drops lower than the custom fixed price. Available to new contracts after March 21, 2022. Applies to all fixed price SKUs in the contract, including FixedPrice, FixedDiscount, MigratedPrice, and MergedPrice.", "id": "GoogleCloudBillingBillingaccountpricesV1betaListPriceAsCeiling", @@ -1875,6 +1987,24 @@ }, "type": "object" }, + "GoogleCloudBillingPricesV1betaListPricesResponse": { + "description": "Response message for ListPrices.", + "id": "GoogleCloudBillingPricesV1betaListPricesResponse", + "properties": { + "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" + }, + "prices": { + "description": "The returned publicly listed prices.", + "items": { + "$ref": "GoogleCloudBillingPricesV1betaPrice" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudBillingPricesV1betaPrice": { "description": "Encapsulates the latest price for a SKU.", "id": "GoogleCloudBillingPricesV1betaPrice", @@ -2155,31 +2285,31 @@ "type": "object" }, "InterRegionEgress": { - "description": "Egress traffic between two regions.", + "description": "Data transfer between two regions.", "id": "InterRegionEgress", "properties": { "destinationRegion": { - "description": "Which [region](https://cloud.google.com/compute/docs/regions-zones) the egress data goes to.", + "description": "Which [region](https://cloud.google.com/compute/docs/regions-zones) the data is transferred to.", "type": "string" }, "egressRate": { "$ref": "Usage", - "description": "VM to VM egress usage. Expected units such as \"GiBy/s, By/s, etc.\"" + "description": "VM to VM data transfer usage. The expected units such are GiBy/s, By/s, and so on." }, "sourceRegion": { - "description": "Which [region](https://cloud.google.com/compute/docs/regions-zones) the egress data comes from.", + "description": "Which [region](https://cloud.google.com/compute/docs/regions-zones) the data is transferred from.", "type": "string" } }, "type": "object" }, "IntraRegionEgress": { - "description": "Egress traffic within the same region. When source region and destination region are in the same zone, using the internal IP addresses, there isn't any egress charge.", + "description": "Data transfer within the same region. When the source region and destination region are in the same zone, using internal IP addresses, there isn't any charge for data transfer.", "id": "IntraRegionEgress", "properties": { "egressRate": { "$ref": "Usage", - "description": "VM to VM egress usage. Expected units such as \"GiBy/s, By/s, etc.\"" + "description": "VM to VM data transfer usage. The expected are GiBy/s, By/s, and so on." } }, "type": "object" @@ -2274,7 +2404,7 @@ "type": "object" }, "PremiumTierEgressWorkload": { - "description": "Specify Premium Tier Internet egress networking.", + "description": "Specify a Premium Tier Internet Data Transfer networking workload.", "id": "PremiumTierEgressWorkload", "properties": { "destinationContinent": { @@ -2313,10 +2443,10 @@ }, "egressRate": { "$ref": "Usage", - "description": "Premium Tier egress usage. Expected units such as \"GiBy/s, By/s, etc.\"" + "description": "Premium Tier Data Transfer usage. The expected units are GiBy/s, By/s, and so on, based on [The Unified Code for Units of Measure](https://ucum.org/ucum.html) standard." }, "sourceRegion": { - "description": "Which [region](https://cloud.google.com/compute/docs/regions-zones) the egress data comes from.", + "description": "Which [region](https://cloud.google.com/compute/docs/regions-zones) the data comes from.", "type": "string" } }, @@ -2479,15 +2609,15 @@ "type": "object" }, "StandardTierEgressWorkload": { - "description": "Specify Standard Tier Internet egress networking.", + "description": "Specify Standard Tier Internet Data Transfer.", "id": "StandardTierEgressWorkload", "properties": { "egressRate": { "$ref": "Usage", - "description": "Standard tier egress usage. Expected units such as \"GiBy/s, By/s, etc.\"" + "description": "Standard Tier Data Transfer usage. The expected units are GiBy/s, By/s, and so on, based on the [The Unified Code for Units of Measure](https://ucum.org/ucum.html) standard." }, "sourceRegion": { - "description": "Which [region](https://cloud.google.com/compute/docs/regions-zones) the egress data comes from.", + "description": "Which [region](https://cloud.google.com/compute/docs/regions-zones) the data is transferred from.", "type": "string" } }, @@ -2627,7 +2757,7 @@ "type": "object" }, "VmToVmEgressWorkload": { - "description": "Specify VM to VM egress.", + "description": "Specify VM to VM data transfer.", "id": "VmToVmEgressWorkload", "properties": { "interRegionEgress": { @@ -2645,7 +2775,7 @@ "properties": { "cloudCdnEgressWorkload": { "$ref": "CloudCdnEgressWorkload", - "description": "Usage on Google Cloud CDN Egress." + "description": "Usage on Google Cloud CDN Data Transfer." }, "cloudCdnWorkload": { "$ref": "CloudCdnWorkload", @@ -2653,7 +2783,7 @@ }, "cloudInterconnectEgressWorkload": { "$ref": "CloudInterconnectEgressWorkload", - "description": "Usage on Google Cloud Interconnect Egress." + "description": "Usage on Google Cloud Interconnect Data Transfer." }, "cloudInterconnectWorkload": { "$ref": "CloudInterconnectWorkload", @@ -2661,7 +2791,7 @@ }, "cloudStorageEgressWorkload": { "$ref": "CloudStorageEgressWorkload", - "description": "Usage on a cloud storage egress." + "description": "Usage on Cloud Storage Data Transfer." }, "cloudStorageWorkload": { "$ref": "CloudStorageWorkload", @@ -2677,15 +2807,15 @@ }, "premiumTierEgressWorkload": { "$ref": "PremiumTierEgressWorkload", - "description": "Usage on Premium Tier Internet Egress." + "description": "Usage on Premium Tier Internet Data Transfer." }, "standardTierEgressWorkload": { "$ref": "StandardTierEgressWorkload", - "description": "Usage on Standard Tier Internet Egress." + "description": "Usage on Standard Tier Internet Data Transfer." }, "vmToVmEgressWorkload": { "$ref": "VmToVmEgressWorkload", - "description": "Usage on Vm to Vm Egress." + "description": "Usage on VM to VM Data Transfer." } }, "type": "object" diff --git a/src/apis/cloudbilling/v1.ts b/src/apis/cloudbilling/v1.ts index a886e6c0b0..95450e1bcc 100644 --- a/src/apis/cloudbilling/v1.ts +++ b/src/apis/cloudbilling/v1.ts @@ -184,11 +184,11 @@ export namespace cloudbilling_v1 { */ name?: string | null; /** - * Output only. True if the billing account is open, and will therefore be charged for any usage on associated projects. False if the billing account is closed, and therefore projects associated with it will be unable to use paid services. + * Output only. True if the billing account is open, and will therefore be charged for any usage on associated projects. False if the billing account is closed, and therefore projects associated with it are unable to use paid services. */ open?: boolean | null; /** - * Output only. The billing account's parent resource identifier. Use the `MoveBillingAccount` method to update the account's parent resource if it is a organization. Format: - organizations/{organization_id\}, for example: organizations/12345678 - billingAccounts/{billing_account_id\}, for example: `billingAccounts/012345-567890-ABCDEF` + * Output only. The billing account's parent resource identifier. Use the `MoveBillingAccount` method to update the account's parent resource if it is a organization. Format: - `organizations/{organization_id\}`, for example, `organizations/12345678` - `billingAccounts/{billing_account_id\}`, for example, `billingAccounts/012345-567890-ABCDEF` */ parent?: string | null; } @@ -201,7 +201,7 @@ export namespace cloudbilling_v1 { */ condition?: Schema$Expr; /** - * Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid\}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid\}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid\}.svc.id.goog[{namespace\}/{kubernetes-sa\}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid\}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain\}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `deleted:user:{emailid\}?uid={uniqueid\}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid\}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid\}?uid={uniqueid\}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid\}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid\}?uid={uniqueid\}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid\}` and the recovered group retains the role in the binding. + * Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid\}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid\}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid\}.svc.id.goog[{namespace\}/{kubernetes-sa\}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid\}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain\}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id\}/subject/{subject_attribute_value\}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id\}/group/{group_id\}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id\}/attribute.{attribute_name\}/{attribute_value\}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id\}/x`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number\}/locations/global/workloadIdentityPools/{pool_id\}/subject/{subject_attribute_value\}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number\}/locations/global/workloadIdentityPools/{pool_id\}/group/{group_id\}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number\}/locations/global/workloadIdentityPools/{pool_id\}/attribute.{attribute_name\}/{attribute_value\}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number\}/locations/global/workloadIdentityPools/{pool_id\}/x`: All identities in a workload identity pool. * `deleted:user:{emailid\}?uid={uniqueid\}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid\}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid\}?uid={uniqueid\}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid\}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid\}?uid={uniqueid\}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid\}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id\}/subject/{subject_attribute_value\}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`. */ members?: string[] | null; /** @@ -338,7 +338,7 @@ export namespace cloudbilling_v1 { */ export interface Schema$MoveBillingAccountRequest { /** - * Required. The resource name of the Organization to reparent the billing account under. Must be of the form `organizations/{organization_id\}`. + * Required. The resource name of the Organization to move the billing account under. Must be of the form `organizations/{organization_id\}`. */ destinationParent?: string | null; } @@ -1260,7 +1260,7 @@ export namespace cloudbilling_v1 { export interface Params$Resource$Billingaccounts$Create extends StandardParameters { /** - * Optional. The parent to create a billing account from. Format: - organizations/{organization_id\} eg organizations/12345678 - billingAccounts/{billing_account_id\} eg `billingAccounts/012345-567890-ABCDEF` + * Optional. The parent to create a billing account from. Format: - `organizations/{organization_id\}`, for example, `organizations/12345678` - `billingAccounts/{billing_account_id\}`, for example, `billingAccounts/012345-567890-ABCDEF` */ parent?: string; @@ -1290,7 +1290,7 @@ export namespace cloudbilling_v1 { export interface Params$Resource$Billingaccounts$List extends StandardParameters { /** - * Options for how to filter the returned billing accounts. This only supports filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts) under a single provided parent billing account. (e.g. "master_billing_account=billingAccounts/012345-678901-ABCDEF"). Boolean algebra and other fields are not currently supported. + * Options for how to filter the returned billing accounts. This only supports filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts) under a single provided parent billing account. (for example, `master_billing_account=billingAccounts/012345-678901-ABCDEF`). Boolean algebra and other fields are not currently supported. */ filter?: string; /** @@ -1302,7 +1302,7 @@ export namespace cloudbilling_v1 { */ pageToken?: string; /** - * Optional. The parent resource to list billing accounts from. Format: - organizations/{organization_id\} eg organizations/12345678 - billingAccounts/{billing_account_id\} eg `billingAccounts/012345-567890-ABCDEF` + * Optional. The parent resource to list billing accounts from. Format: - `organizations/{organization_id\}`, for example, `organizations/12345678` - `billingAccounts/{billing_account_id\}`, for example, `billingAccounts/012345-567890-ABCDEF` */ parent?: string; } @@ -1669,7 +1669,7 @@ export namespace cloudbilling_v1 { export interface Params$Resource$Billingaccounts$Subaccounts$Create extends StandardParameters { /** - * Optional. The parent to create a billing account from. Format: - organizations/{organization_id\} eg organizations/12345678 - billingAccounts/{billing_account_id\} eg `billingAccounts/012345-567890-ABCDEF` + * Optional. The parent to create a billing account from. Format: - `organizations/{organization_id\}`, for example, `organizations/12345678` - `billingAccounts/{billing_account_id\}`, for example, `billingAccounts/012345-567890-ABCDEF` */ parent?: string; @@ -1681,7 +1681,7 @@ export namespace cloudbilling_v1 { export interface Params$Resource$Billingaccounts$Subaccounts$List extends StandardParameters { /** - * Options for how to filter the returned billing accounts. This only supports filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts) under a single provided parent billing account. (e.g. "master_billing_account=billingAccounts/012345-678901-ABCDEF"). Boolean algebra and other fields are not currently supported. + * Options for how to filter the returned billing accounts. This only supports filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts) under a single provided parent billing account. (for example, `master_billing_account=billingAccounts/012345-678901-ABCDEF`). Boolean algebra and other fields are not currently supported. */ filter?: string; /** @@ -1693,7 +1693,7 @@ export namespace cloudbilling_v1 { */ pageToken?: string; /** - * Optional. The parent resource to list billing accounts from. Format: - organizations/{organization_id\} eg organizations/12345678 - billingAccounts/{billing_account_id\} eg `billingAccounts/012345-567890-ABCDEF` + * Optional. The parent resource to list billing accounts from. Format: - `organizations/{organization_id\}`, for example, `organizations/12345678` - `billingAccounts/{billing_account_id\}`, for example, `billingAccounts/012345-567890-ABCDEF` */ parent?: string; } @@ -1987,7 +1987,7 @@ export namespace cloudbilling_v1 { export interface Params$Resource$Organizations$Billingaccounts$Create extends StandardParameters { /** - * Optional. The parent to create a billing account from. Format: - organizations/{organization_id\} eg organizations/12345678 - billingAccounts/{billing_account_id\} eg `billingAccounts/012345-567890-ABCDEF` + * Optional. The parent to create a billing account from. Format: - `organizations/{organization_id\}`, for example, `organizations/12345678` - `billingAccounts/{billing_account_id\}`, for example, `billingAccounts/012345-567890-ABCDEF` */ parent?: string; @@ -1999,7 +1999,7 @@ export namespace cloudbilling_v1 { export interface Params$Resource$Organizations$Billingaccounts$List extends StandardParameters { /** - * Options for how to filter the returned billing accounts. This only supports filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts) under a single provided parent billing account. (e.g. "master_billing_account=billingAccounts/012345-678901-ABCDEF"). Boolean algebra and other fields are not currently supported. + * Options for how to filter the returned billing accounts. This only supports filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts) under a single provided parent billing account. (for example, `master_billing_account=billingAccounts/012345-678901-ABCDEF`). Boolean algebra and other fields are not currently supported. */ filter?: string; /** @@ -2011,14 +2011,14 @@ export namespace cloudbilling_v1 { */ pageToken?: string; /** - * Optional. The parent resource to list billing accounts from. Format: - organizations/{organization_id\} eg organizations/12345678 - billingAccounts/{billing_account_id\} eg `billingAccounts/012345-567890-ABCDEF` + * Optional. The parent resource to list billing accounts from. Format: - `organizations/{organization_id\}`, for example, `organizations/12345678` - `billingAccounts/{billing_account_id\}`, for example, `billingAccounts/012345-567890-ABCDEF` */ parent?: string; } export interface Params$Resource$Organizations$Billingaccounts$Move extends StandardParameters { /** - * Required. The resource name of the Organization to reparent the billing account under. Must be of the form `organizations/{organization_id\}`. + * Required. The resource name of the Organization to move the billing account under. Must be of the form `organizations/{organization_id\}`. */ destinationParent?: string; /** diff --git a/src/apis/cloudbilling/v1beta.ts b/src/apis/cloudbilling/v1beta.ts index 068b6dd45a..d17ad8f964 100644 --- a/src/apis/cloudbilling/v1beta.ts +++ b/src/apis/cloudbilling/v1beta.ts @@ -144,15 +144,15 @@ export namespace cloudbilling_v1beta { sourceRegion?: string | null; } /** - * Specifies usage for Cloud CDN egress. + * Specifies usage for Cloud CDN Data Transfer. */ export interface Schema$CloudCdnEgressWorkload { /** - * The destination for the cache egress charges. + * The destination for the cache data transfer. */ cacheEgressDestination?: string | null; /** - * Cache egress usage. The rate of data cache egressed in the destination. For example : units such as "GiBy/s" or "TBy/mo". + * Cache data transfer usage. The rate of data cache transferred to the destination. Use units such as GiBy/s or TiBy/mo, based on [The Unified Code for Units of Measure](https://ucum.org/ucum.html) standard. */ cacheEgressRate?: Schema$Usage; } @@ -178,15 +178,15 @@ export namespace cloudbilling_v1beta { cacheLookUpRate?: Schema$Usage; } /** - * The interconnect egress only includes the Interconnect Egress. Please use the standard egress traffic interface to specify your standard egress usage. + * Includes the estimate for Interconnect Data Transfer only. To specify usage for data transfer between VMs and internet end-points, use the Standard Tier Internet Data Transfer interface. */ export interface Schema$CloudInterconnectEgressWorkload { /** - * Data egress usage. This usage applies when you move or copy data from one Google Cloud service to another service. Expected units such as "GiBy/s, By/s, etc." + * Outbound data transfer usage. This usage applies when you move or copy data from one Google Cloud service to another service. The units are GiBy/s, By/s, and so on, based on [The Unified Code for Units of Measure](https://ucum.org/ucum.html) standard. */ egressRate?: Schema$Usage; /** - * Locations in the [Interconnect connection location table](https://cloud.google.com/vpc/network-pricing#interconnect-pricing). This is the interconnect egress charges. + * Locations in the [Interconnect connection location table](https://cloud.google.com/vpc/network-pricing#interconnect-pricing). These are the Interconnect Data Transfer charges. */ interconnectConnectionLocation?: string | null; } @@ -212,7 +212,7 @@ export namespace cloudbilling_v1beta { provisionedLinkCount?: Schema$Usage; } /** - * Specification of a network type. Network egress within Google Cloud applies when you move or copy data from one Cloud Storage bucket to another or when another Google Cloud service accesses data in your Cloud Storage bucket.This includes the network egress within Google Cloud and the general network usage. + * Specification of a network type. Network data transfer within Google Cloud applies when you move or copy data from one Cloud Storage bucket to another or when another Google Cloud service accesses data in your Cloud Storage bucket.This includes the network data transfer within Google Cloud and the general network usage. */ export interface Schema$CloudStorageEgressWorkload { /** @@ -220,7 +220,7 @@ export namespace cloudbilling_v1beta { */ destinationContinent?: string | null; /** - * Egress usage rate. This usage applies when you move or copy data from one Cloud Storage bucket to another or when another Google Cloud service accesses data in your Cloud Storage bucket. Expected units such as "GiBy/s, By/s, ..." + * Data transfer usage rate. This usage applies when you move or copy data from one Cloud Storage bucket to another or when another Google Cloud service accesses data in your Cloud Storage bucket. The expected units are GiBy/s, By/s, and so on, based on [The Unified Code for Units of Measure](https://ucum.org/ucum.html) standard. */ egressRate?: Schema$Usage; /** @@ -233,11 +233,11 @@ export namespace cloudbilling_v1beta { */ export interface Schema$CloudStorageWorkload { /** - * Data retrieval usage. A retrieval cost applies when data or metadata is read, copied, or rewritten . For example: units such as "GiBy/s" or "By/s". + * Data retrieval usage. A retrieval cost applies when data or metadata is read, copied, or rewritten . For example: units such as "GiB/s" or "B/s". */ dataRetrieval?: Schema$Usage; /** - * Data storage usage. The amount of data stored in buckets. For example: units such as "GiBy/s" or "TBy/mo". + * Data storage usage. The amount of data stored in buckets. For example: units such as GiBy/s or TiBy/mo, based on [The Unified Code for Units of Measure](https://ucum.org/ucum.html) standard. */ dataStored?: Schema$Usage; /** @@ -564,6 +564,19 @@ export namespace cloudbilling_v1beta { */ skuGroup?: string | null; } + /** + * Response message for ListBillingAccountPrices. + */ + export interface Schema$GoogleCloudBillingBillingaccountpricesV1betaListBillingAccountPricesResponse { + /** + * The returned billing account prices. + */ + billingAccountPrices?: Schema$GoogleCloudBillingBillingaccountpricesV1betaBillingAccountPrice[]; + /** + * 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. + */ + nextPageToken?: string | null; + } /** * Encapsulates a contract feature that the list price (DefaultPrice) will be used for the price if the current list price drops lower than the custom fixed price. Available to new contracts after March 21, 2022. Applies to all fixed price SKUs in the contract, including FixedPrice, FixedDiscount, MigratedPrice, and MergedPrice. */ @@ -966,6 +979,19 @@ export namespace cloudbilling_v1beta { */ level?: string | null; } + /** + * Response message for ListPrices. + */ + export interface Schema$GoogleCloudBillingPricesV1betaListPricesResponse { + /** + * 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. + */ + nextPageToken?: string | null; + /** + * The returned publicly listed prices. + */ + prices?: Schema$GoogleCloudBillingPricesV1betaPrice[]; + } /** * Encapsulates the latest price for a SKU. */ @@ -1186,28 +1212,28 @@ export namespace cloudbilling_v1beta { acceleratorType?: string | null; } /** - * Egress traffic between two regions. + * Data transfer between two regions. */ export interface Schema$InterRegionEgress { /** - * Which [region](https://cloud.google.com/compute/docs/regions-zones) the egress data goes to. + * Which [region](https://cloud.google.com/compute/docs/regions-zones) the data is transferred to. */ destinationRegion?: string | null; /** - * VM to VM egress usage. Expected units such as "GiBy/s, By/s, etc." + * VM to VM data transfer usage. The expected units such are GiBy/s, By/s, and so on. */ egressRate?: Schema$Usage; /** - * Which [region](https://cloud.google.com/compute/docs/regions-zones) the egress data comes from. + * Which [region](https://cloud.google.com/compute/docs/regions-zones) the data is transferred from. */ sourceRegion?: string | null; } /** - * Egress traffic within the same region. When source region and destination region are in the same zone, using the internal IP addresses, there isn't any egress charge. + * Data transfer within the same region. When the source region and destination region are in the same zone, using internal IP addresses, there isn't any charge for data transfer. */ export interface Schema$IntraRegionEgress { /** - * VM to VM egress usage. Expected units such as "GiBy/s, By/s, etc." + * VM to VM data transfer usage. The expected are GiBy/s, By/s, and so on. */ egressRate?: Schema$Usage; } @@ -1275,7 +1301,7 @@ export namespace cloudbilling_v1beta { machineType?: string | null; } /** - * Specify Premium Tier Internet egress networking. + * Specify a Premium Tier Internet Data Transfer networking workload. */ export interface Schema$PremiumTierEgressWorkload { /** @@ -1283,11 +1309,11 @@ export namespace cloudbilling_v1beta { */ destinationContinent?: string | null; /** - * Premium Tier egress usage. Expected units such as "GiBy/s, By/s, etc." + * Premium Tier Data Transfer usage. The expected units are GiBy/s, By/s, and so on, based on [The Unified Code for Units of Measure](https://ucum.org/ucum.html) standard. */ egressRate?: Schema$Usage; /** - * Which [region](https://cloud.google.com/compute/docs/regions-zones) the egress data comes from. + * Which [region](https://cloud.google.com/compute/docs/regions-zones) the data comes from. */ sourceRegion?: string | null; } @@ -1416,15 +1442,15 @@ export namespace cloudbilling_v1beta { usageUnit?: string | null; } /** - * Specify Standard Tier Internet egress networking. + * Specify Standard Tier Internet Data Transfer. */ export interface Schema$StandardTierEgressWorkload { /** - * Standard tier egress usage. Expected units such as "GiBy/s, By/s, etc." + * Standard Tier Data Transfer usage. The expected units are GiBy/s, By/s, and so on, based on the [The Unified Code for Units of Measure](https://ucum.org/ucum.html) standard. */ egressRate?: Schema$Usage; /** - * Which [region](https://cloud.google.com/compute/docs/regions-zones) the egress data comes from. + * Which [region](https://cloud.google.com/compute/docs/regions-zones) the data is transferred from. */ sourceRegion?: string | null; } @@ -1506,7 +1532,7 @@ export namespace cloudbilling_v1beta { virtualCpuCount?: string | null; } /** - * Specify VM to VM egress. + * Specify VM to VM data transfer. */ export interface Schema$VmToVmEgressWorkload { interRegionEgress?: Schema$InterRegionEgress; @@ -1517,7 +1543,7 @@ export namespace cloudbilling_v1beta { */ export interface Schema$Workload { /** - * Usage on Google Cloud CDN Egress. + * Usage on Google Cloud CDN Data Transfer. */ cloudCdnEgressWorkload?: Schema$CloudCdnEgressWorkload; /** @@ -1525,7 +1551,7 @@ export namespace cloudbilling_v1beta { */ cloudCdnWorkload?: Schema$CloudCdnWorkload; /** - * Usage on Google Cloud Interconnect Egress. + * Usage on Google Cloud Interconnect Data Transfer. */ cloudInterconnectEgressWorkload?: Schema$CloudInterconnectEgressWorkload; /** @@ -1533,7 +1559,7 @@ export namespace cloudbilling_v1beta { */ cloudInterconnectWorkload?: Schema$CloudInterconnectWorkload; /** - * Usage on a cloud storage egress. + * Usage on Cloud Storage Data Transfer. */ cloudStorageEgressWorkload?: Schema$CloudStorageEgressWorkload; /** @@ -1549,15 +1575,15 @@ export namespace cloudbilling_v1beta { */ name?: string | null; /** - * Usage on Premium Tier Internet Egress. + * Usage on Premium Tier Internet Data Transfer. */ premiumTierEgressWorkload?: Schema$PremiumTierEgressWorkload; /** - * Usage on Standard Tier Internet Egress. + * Usage on Standard Tier Internet Data Transfer. */ standardTierEgressWorkload?: Schema$StandardTierEgressWorkload; /** - * Usage on Vm to Vm Egress. + * Usage on VM to VM Data Transfer. */ vmToVmEgressWorkload?: Schema$VmToVmEgressWorkload; } @@ -2362,9 +2388,11 @@ export namespace cloudbilling_v1beta { export class Resource$Billingaccounts$Skus { context: APIRequestContext; price: Resource$Billingaccounts$Skus$Price; + prices: Resource$Billingaccounts$Skus$Prices; constructor(context: APIRequestContext) { this.context = context; this.price = new Resource$Billingaccounts$Skus$Price(this.context); + this.prices = new Resource$Billingaccounts$Skus$Prices(this.context); } /** @@ -2696,6 +2724,129 @@ export namespace cloudbilling_v1beta { name?: string; } + export class Resource$Billingaccounts$Skus$Prices { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Lists the latest prices for SKUs available to your Cloud Billing account. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Billingaccounts$Skus$Prices$List, + options: StreamMethodOptions + ): GaxiosPromise; + list( + params?: Params$Resource$Billingaccounts$Skus$Prices$List, + options?: MethodOptions + ): GaxiosPromise; + list( + params: Params$Resource$Billingaccounts$Skus$Prices$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Billingaccounts$Skus$Prices$List, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Billingaccounts$Skus$Prices$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Billingaccounts$Skus$Prices$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Billingaccounts$Skus$Prices$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Billingaccounts$Skus$Prices$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://cloudbilling.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1beta/{+parent}/prices').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + } + + export interface Params$Resource$Billingaccounts$Skus$Prices$List + extends StandardParameters { + /** + * Optional. ISO-4217 currency code for the price. If not specified, currency of billing account will be used. + */ + currencyCode?: string; + /** + * Optional. Maximum number of billing account price to return. Results may return fewer than this value. Default value is 50 and maximum value is 5000. + */ + pageSize?: number; + /** + * Optional. Page token received from a previous ListBillingAccountPrices call to retrieve the next page of results. If this field is empty, the first page is returned. + */ + pageToken?: string; + /** + * Required. To list all Billing Account SKUs, use `-` as the SKU ID. Format: `billingAccounts/{billing_account\}/skus/-` Note: Specifying an actual SKU resource id will return a collection of one Billing Account Price. + */ + parent?: string; + } + export class Resource$Skugroups { context: APIRequestContext; skus: Resource$Skugroups$Skus; @@ -3128,9 +3279,11 @@ export namespace cloudbilling_v1beta { export class Resource$Skus { context: APIRequestContext; price: Resource$Skus$Price; + prices: Resource$Skus$Prices; constructor(context: APIRequestContext) { this.context = context; this.price = new Resource$Skus$Price(this.context); + this.prices = new Resource$Skus$Prices(this.context); } } @@ -3244,6 +3397,127 @@ export namespace cloudbilling_v1beta { name?: string; } + export class Resource$Skus$Prices { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Lists the latest prices for all SKUs. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Skus$Prices$List, + options: StreamMethodOptions + ): GaxiosPromise; + list( + params?: Params$Resource$Skus$Prices$List, + options?: MethodOptions + ): GaxiosPromise; + list( + params: Params$Resource$Skus$Prices$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Skus$Prices$List, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Skus$Prices$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Skus$Prices$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || {}) as Params$Resource$Skus$Prices$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Skus$Prices$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://cloudbilling.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1beta/{+parent}/prices').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + } + + export interface Params$Resource$Skus$Prices$List extends StandardParameters { + /** + * Optional. ISO-4217 currency code for the price. If not specified, USD will be used. + */ + currencyCode?: string; + /** + * Optional. Maximum number of prices to return. Results may return fewer than this value. Default value is 50 and maximum value is 5000. + */ + pageSize?: number; + /** + * Optional. Page token received from a previous ListPrices call to retrieve the next page of results. If this field is empty, the first page is returned. + */ + pageToken?: string; + /** + * Required. To list the prices for all SKUs, use `-` as the SKU ID. Format: `skus/-` Specifying a specific SKU ID returns a collection with one Price object for the SKU. + */ + parent?: string; + } + export class Resource$V1beta { context: APIRequestContext; constructor(context: APIRequestContext) {