|
114 | 114 | "operations": {
|
115 | 115 | "methods": {
|
116 | 116 | "cancel": {
|
117 |
| - "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", |
| 117 | + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", |
118 | 118 | "flatPath": "v1/operations/{operationsId}:cancel",
|
119 | 119 | "httpMethod": "POST",
|
120 | 120 | "id": "serviceusage.operations.cancel",
|
|
426 | 426 | }
|
427 | 427 | }
|
428 | 428 | },
|
429 |
| - "revision": "20240929", |
| 429 | + "revision": "20241219", |
430 | 430 | "rootUrl": "https://serviceusage.googleapis.com/",
|
431 | 431 | "schemas": {
|
432 | 432 | "AddEnableRulesMetadata": {
|
|
502 | 502 | "enum": [
|
503 | 503 | "ANALYSIS_TYPE_UNSPECIFIED",
|
504 | 504 | "ANALYSIS_TYPE_DEPENDENCY",
|
505 |
| - "ANALYSIS_TYPE_RESOURCE_USAGE" |
| 505 | + "ANALYSIS_TYPE_RESOURCE_USAGE", |
| 506 | + "ANALYSIS_TYPE_RESOURCE_EXISTENCE" |
506 | 507 | ],
|
507 | 508 | "enumDescriptions": [
|
508 | 509 | "Unspecified analysis type. Do not use.",
|
509 | 510 | "The analysis of service dependencies.",
|
510 |
| - "The analysis of service resource usage." |
| 511 | + "The analysis of service resource usage.", |
| 512 | + "The analysis of service resource existence." |
511 | 513 | ],
|
512 | 514 | "readOnly": true,
|
513 | 515 | "type": "string"
|
|
1231 | 1233 | "description": "`Documentation` provides the information for describing a service. Example: documentation: summary: > The Google Calendar API gives access to most calendar features. pages: - name: Overview content: (== include google/foo/overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==) subpages: - name: Java content: (== include google/foo/tutorial_java.md ==) rules: - selector: google.calendar.Calendar.Get description: > ... - selector: google.calendar.Calendar.Put description: > ... Documentation is provided in markdown syntax. In addition to standard markdown features, definition lists, tables and fenced code blocks are supported. Section headers can be provided and are interpreted relative to the section nesting of the context where a documentation fragment is embedded. Documentation from the IDL is merged with documentation defined via the config at normalization time, where documentation provided by config rules overrides IDL provided. A number of constructs specific to the API platform are supported in documentation text. In order to reference a proto element, the following notation can be used: [fully.qualified.proto.name][] To override the display text used for the link, this can be used: [display text][fully.qualified.proto.name] Text can be excluded from doc using the following notation: (-- internal comment --) A few directives are available in documentation. Note that directives must appear on a single line to be properly identified. The `include` directive includes a markdown file from an external source: (== include path/to/file ==) The `resource_for` directive marks a message to be the resource of a collection in REST view. If it is not specified, tools attempt to infer the resource from the operations in a collection: (== resource_for v1.shelves.books ==) The directive `suppress_warning` does not directly affect documentation and is documented together with service config validation.",
|
1232 | 1234 | "id": "Documentation",
|
1233 | 1235 | "properties": {
|
| 1236 | + "additionalIamInfo": { |
| 1237 | + "description": "Optional information about the IAM configuration. This is typically used to link to documentation about a product's IAM roles and permissions.", |
| 1238 | + "type": "string" |
| 1239 | + }, |
1234 | 1240 | "documentationRootUrl": {
|
1235 | 1241 | "description": "The URL to the root of documentation.",
|
1236 | 1242 | "type": "string"
|
|
1524 | 1530 | "description": "Experimental features to be included during client library generation. These fields will be deprecated once the feature graduates and is enabled by default.",
|
1525 | 1531 | "id": "ExperimentalFeatures",
|
1526 | 1532 | "properties": {
|
| 1533 | + "protobufPythonicTypesEnabled": { |
| 1534 | + "description": "Enables generation of protobuf code using new types that are more Pythonic which are included in `protobuf>=5.29.x`. This feature will be enabled by default 1 month after launching the feature in preview packages.", |
| 1535 | + "type": "boolean" |
| 1536 | + }, |
1527 | 1537 | "restAsyncIoEnabled": {
|
1528 | 1538 | "description": "Enables generation of asynchronous REST clients if `rest` transport is enabled. By default, asynchronous REST clients will not be generated. This feature will be enabled by default 1 month after launching the feature in preview packages.",
|
1529 | 1539 | "type": "boolean"
|
|
1692 | 1702 | "common": {
|
1693 | 1703 | "$ref": "CommonLanguageSettings",
|
1694 | 1704 | "description": "Some settings."
|
| 1705 | + }, |
| 1706 | + "renamedServices": { |
| 1707 | + "additionalProperties": { |
| 1708 | + "type": "string" |
| 1709 | + }, |
| 1710 | + "description": "Map of service names to renamed services. Keys are the package relative service names and values are the name to be used for the service client and call options. publishing: go_settings: renamed_services: Publisher: TopicAdmin", |
| 1711 | + "type": "object" |
1695 | 1712 | }
|
1696 | 1713 | },
|
1697 | 1714 | "type": "object"
|
|
2044 | 2061 | "properties": {},
|
2045 | 2062 | "type": "object"
|
2046 | 2063 | },
|
| 2064 | + "GoogleApiServiceusageV2betaAnalysis": { |
| 2065 | + "description": "A message to group the analysis information.", |
| 2066 | + "id": "GoogleApiServiceusageV2betaAnalysis", |
| 2067 | + "properties": { |
| 2068 | + "analysis": { |
| 2069 | + "$ref": "GoogleApiServiceusageV2betaAnalysisResult", |
| 2070 | + "description": "Output only. Analysis result of updating a policy.", |
| 2071 | + "readOnly": true |
| 2072 | + }, |
| 2073 | + "analysisType": { |
| 2074 | + "description": "Output only. The type of analysis.", |
| 2075 | + "enum": [ |
| 2076 | + "ANALYSIS_TYPE_UNSPECIFIED", |
| 2077 | + "ANALYSIS_TYPE_DEPENDENCY", |
| 2078 | + "ANALYSIS_TYPE_RESOURCE_USAGE" |
| 2079 | + ], |
| 2080 | + "enumDescriptions": [ |
| 2081 | + "Unspecified analysis type. Do not use.", |
| 2082 | + "The analysis of service dependencies.", |
| 2083 | + "The analysis of service resource usage." |
| 2084 | + ], |
| 2085 | + "readOnly": true, |
| 2086 | + "type": "string" |
| 2087 | + }, |
| 2088 | + "displayName": { |
| 2089 | + "description": "Output only. The user friendly display name of the analysis type. E.g. service dependency analysis, service resource usage analysis, etc.", |
| 2090 | + "readOnly": true, |
| 2091 | + "type": "string" |
| 2092 | + }, |
| 2093 | + "service": { |
| 2094 | + "description": "The names of the service that has analysis result of warnings or blockers. Example: `services/storage.googleapis.com`.", |
| 2095 | + "type": "string" |
| 2096 | + } |
| 2097 | + }, |
| 2098 | + "type": "object" |
| 2099 | + }, |
| 2100 | + "GoogleApiServiceusageV2betaAnalysisResult": { |
| 2101 | + "description": "An analysis result including blockers and warnings.", |
| 2102 | + "id": "GoogleApiServiceusageV2betaAnalysisResult", |
| 2103 | + "properties": { |
| 2104 | + "blockers": { |
| 2105 | + "description": "Blocking information that would prevent the policy changes at runtime.", |
| 2106 | + "items": { |
| 2107 | + "$ref": "GoogleApiServiceusageV2betaImpact" |
| 2108 | + }, |
| 2109 | + "type": "array" |
| 2110 | + }, |
| 2111 | + "warnings": { |
| 2112 | + "description": "Warning information indicating that the policy changes might be unsafe, but will not block the changes at runtime.", |
| 2113 | + "items": { |
| 2114 | + "$ref": "GoogleApiServiceusageV2betaImpact" |
| 2115 | + }, |
| 2116 | + "type": "array" |
| 2117 | + } |
| 2118 | + }, |
| 2119 | + "type": "object" |
| 2120 | + }, |
| 2121 | + "GoogleApiServiceusageV2betaAnalyzeConsumerPolicyMetadata": { |
| 2122 | + "description": "Metadata for the `AnalyzeConsumerPolicy` method.", |
| 2123 | + "id": "GoogleApiServiceusageV2betaAnalyzeConsumerPolicyMetadata", |
| 2124 | + "properties": {}, |
| 2125 | + "type": "object" |
| 2126 | + }, |
| 2127 | + "GoogleApiServiceusageV2betaAnalyzeConsumerPolicyResponse": { |
| 2128 | + "description": "The response of analyzing a consumer policy update.", |
| 2129 | + "id": "GoogleApiServiceusageV2betaAnalyzeConsumerPolicyResponse", |
| 2130 | + "properties": { |
| 2131 | + "analysis": { |
| 2132 | + "description": "The list of analyses returned from performing the intended policy update analysis. The analysis is grouped by service name and different analysis types. The empty analysis list means that the consumer policy can be updated without any warnings or blockers.", |
| 2133 | + "items": { |
| 2134 | + "$ref": "GoogleApiServiceusageV2betaAnalysis" |
| 2135 | + }, |
| 2136 | + "type": "array" |
| 2137 | + } |
| 2138 | + }, |
| 2139 | + "type": "object" |
| 2140 | + }, |
| 2141 | + "GoogleApiServiceusageV2betaConsumerPolicy": { |
| 2142 | + "description": "Consumer Policy is a set of rules that define what services or service groups can be used for a cloud resource hierarchy.", |
| 2143 | + "id": "GoogleApiServiceusageV2betaConsumerPolicy", |
| 2144 | + "properties": { |
| 2145 | + "annotations": { |
| 2146 | + "additionalProperties": { |
| 2147 | + "type": "string" |
| 2148 | + }, |
| 2149 | + "description": "Optional. Annotations is an unstructured key-value map stored with a policy that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. [AIP-128](https://google.aip.dev/128#annotations)", |
| 2150 | + "type": "object" |
| 2151 | + }, |
| 2152 | + "createTime": { |
| 2153 | + "description": "Output only. The time the policy was created. For singleton policies, this is the first touch of the policy.", |
| 2154 | + "format": "google-datetime", |
| 2155 | + "readOnly": true, |
| 2156 | + "type": "string" |
| 2157 | + }, |
| 2158 | + "enableRules": { |
| 2159 | + "description": "Enable rules define usable services, groups, and categories. There can currently be at most one `EnableRule`. This restriction will be lifted in later releases.", |
| 2160 | + "items": { |
| 2161 | + "$ref": "GoogleApiServiceusageV2betaEnableRule" |
| 2162 | + }, |
| 2163 | + "type": "array" |
| 2164 | + }, |
| 2165 | + "etag": { |
| 2166 | + "description": "Output only. An opaque tag indicating the current version of the policy, used for concurrency control.", |
| 2167 | + "readOnly": true, |
| 2168 | + "type": "string" |
| 2169 | + }, |
| 2170 | + "name": { |
| 2171 | + "description": "Output only. The resource name of the policy. Only the `default` policy is supported: `projects/12345/consumerPolicies/default`, `folders/12345/consumerPolicies/default`, `organizations/12345/consumerPolicies/default`.", |
| 2172 | + "readOnly": true, |
| 2173 | + "type": "string" |
| 2174 | + }, |
| 2175 | + "updateTime": { |
| 2176 | + "description": "Output only. The time the policy was last updated.", |
| 2177 | + "format": "google-datetime", |
| 2178 | + "readOnly": true, |
| 2179 | + "type": "string" |
| 2180 | + } |
| 2181 | + }, |
| 2182 | + "type": "object" |
| 2183 | + }, |
| 2184 | + "GoogleApiServiceusageV2betaEnableRule": { |
| 2185 | + "description": "The consumer policy rule that defines enabled services, groups, and categories.", |
| 2186 | + "id": "GoogleApiServiceusageV2betaEnableRule", |
| 2187 | + "properties": { |
| 2188 | + "services": { |
| 2189 | + "description": "The names of the services that are enabled. Example: `services/storage.googleapis.com`.", |
| 2190 | + "items": { |
| 2191 | + "type": "string" |
| 2192 | + }, |
| 2193 | + "type": "array" |
| 2194 | + } |
| 2195 | + }, |
| 2196 | + "type": "object" |
| 2197 | + }, |
| 2198 | + "GoogleApiServiceusageV2betaImpact": { |
| 2199 | + "description": "A message to group impacts of updating a policy.", |
| 2200 | + "id": "GoogleApiServiceusageV2betaImpact", |
| 2201 | + "properties": { |
| 2202 | + "detail": { |
| 2203 | + "description": "Output only. User friendly impact detail in a free form message.", |
| 2204 | + "readOnly": true, |
| 2205 | + "type": "string" |
| 2206 | + }, |
| 2207 | + "impactType": { |
| 2208 | + "description": "Output only. The type of impact.", |
| 2209 | + "enum": [ |
| 2210 | + "IMPACT_TYPE_UNSPECIFIED", |
| 2211 | + "DEPENDENCY_MISSING_DEPENDENCIES" |
| 2212 | + ], |
| 2213 | + "enumDescriptions": [ |
| 2214 | + "Reserved Blocks (Block n contains codes from 100n to 100(n+1) -1 Block 0 - Special/Admin codes Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY Block 2 - Impact Type of ANALYSIS_TYPE_RESOURCE_USAGE ...", |
| 2215 | + "Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY" |
| 2216 | + ], |
| 2217 | + "readOnly": true, |
| 2218 | + "type": "string" |
| 2219 | + } |
| 2220 | + }, |
| 2221 | + "type": "object" |
| 2222 | + }, |
| 2223 | + "GoogleApiServiceusageV2betaUpdateConsumerPolicyMetadata": { |
| 2224 | + "description": "Metadata for the `UpdateConsumerPolicy` method.", |
| 2225 | + "id": "GoogleApiServiceusageV2betaUpdateConsumerPolicyMetadata", |
| 2226 | + "properties": {}, |
| 2227 | + "type": "object" |
| 2228 | + }, |
2047 | 2229 | "Http": {
|
2048 | 2230 | "description": "Defines the HTTP configuration for an API service. It contains a list of HttpRule, each specifying the mapping of an RPC method to one or more HTTP REST API methods.",
|
2049 | 2231 | "id": "Http",
|
|
2125 | 2307 | "description": "Output only. The type of impact.",
|
2126 | 2308 | "enum": [
|
2127 | 2309 | "IMPACT_TYPE_UNSPECIFIED",
|
2128 |
| - "DEPENDENCY_MISSING_DEPENDENCIES" |
| 2310 | + "DEPENDENCY_MISSING_DEPENDENCIES", |
| 2311 | + "RESOURCE_EXISTENCE_PROJECT" |
2129 | 2312 | ],
|
2130 | 2313 | "enumDescriptions": [
|
2131 |
| - "Reserved Blocks (Block n contains codes from 100n to 100(n+1) -1 Block 0 - Special/Admin codes Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY Block 2 - Impact Type of ANALYSIS_TYPE_RESOURCE_USAGE ...", |
2132 |
| - "Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY" |
| 2314 | + "Reserved Blocks (Block n contains codes from 100n to 100(n+1) -1 Block 0 - Special/Admin codes Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY Block 2 - Impact Type of ANALYSIS_TYPE_RESOURCE_USAGE Block 3 - Impact Type of ANALYSIS_TYPE_RESOURCE_EXISTENCE ...", |
| 2315 | + "Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY", |
| 2316 | + "Block 3 - Impact Type of ANALYSIS_TYPE_RESOURCE_EXISTENCE" |
2133 | 2317 | ],
|
2134 | 2318 | "readOnly": true,
|
2135 | 2319 | "type": "string"
|
| 2320 | + }, |
| 2321 | + "parent": { |
| 2322 | + "description": "The parent resource that the analysis is based on and the service name that the analysis is for. Example: `projects/100/services/compute.googleapis.com`, folders/101/services/compute.googleapis.com` and `organizations/102/services/compute.googleapis.com`. Usually, the parent resource here is same as the parent resource of the analyzed policy. However, for some analysis types, the parent can be different. For example, for resource existence analysis, if the parent resource of the analyzed policy is a folder or an organization, the parent resource here can still be the project that contains the resources.", |
| 2323 | + "type": "string" |
2136 | 2324 | }
|
2137 | 2325 | },
|
2138 | 2326 | "type": "object"
|
|
3061 | 3249 | "type": "string"
|
3062 | 3250 | },
|
3063 | 3251 | "unit": {
|
3064 |
| - "description": "Specify the unit of the quota limit. It uses the same syntax as Metric.unit. The supported unit kinds are determined by the quota backend system. Here are some examples: * \"1/min/{project}\" for quota per minute per project. Note: the order of unit components is insignificant. The \"1\" at the beginning is required to follow the metric unit syntax.", |
| 3252 | + "description": "Specify the unit of the quota limit. It uses the same syntax as MetricDescriptor.unit. The supported unit kinds are determined by the quota backend system. Here are some examples: * \"1/min/{project}\" for quota per minute per project. Note: the order of unit components is insignificant. The \"1\" at the beginning is required to follow the metric unit syntax.", |
3065 | 3253 | "type": "string"
|
3066 | 3254 | },
|
3067 | 3255 | "values": {
|
|
0 commit comments