@googleapis/serviceusage 21.1.0 → 23.0.0

package/v1.ts

@@ -179,7 +179,7 @@ export namespace serviceusage_v1 {
     /**
      * Output only. Analysis result of updating a policy.
      */
-    analysis?: Schema$AnalysisResult;
+    analysisResult?: Schema$AnalysisResult;
     /**
      * Output only. The type of analysis.
      */
@@ -264,11 +264,28 @@ export namespace serviceusage_v1 {
      * The type of this aspect configuration.
      */
     kind?: string | null;
+    /**
+     * Optional. Rules of the Configuration.
+     */
+    rules?: Schema$AspectRule[];
     /**
      * Content of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`.
      */
     spec?: {[key: string]: any} | null;
   }
+  /**
+   * Rule-based configuration for an aspect.
+   */
+  export interface Schema$AspectRule {
+    /**
+     * Required. Rules of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `google/api/configaspects/proto`.
+     */
+    config?: {[key: string]: any} | null;
+    /**
+     * Required. Selects the RPC methods to which this rule applies. Refer to selector for syntax details.
+     */
+    selector?: string | null;
+  }
   /**
    * `Authentication` defines the authentication configuration for API methods provided by an API service. Example: name: calendar.googleapis.com authentication: providers: - id: google_calendar_auth jwks_uri: https://www.googleapis.com/oauth2/v1/certs issuer: https://securetoken.google.com rules: - selector: "*" requirements: provider_id: google_calendar_auth - selector: google.calendar.Delegate oauth: canonical_scopes: https://www.googleapis.com/auth/calendar.read
    */
@@ -391,7 +408,7 @@ export namespace serviceusage_v1 {
      */
     overridesByRequestProtocol?: {[key: string]: Schema$BackendRule} | null;
     /**
-     * no-lint
+     * Path translation specifies how to combine the backend address with the request path in order to produce the appropriate forwarding URL for the request. See PathTranslation for more details.
      */
     pathTranslation?: string | null;
     /**
@@ -607,7 +624,7 @@ export namespace serviceusage_v1 {
      */
     referenceDocsUri?: string | null;
     /**
-     * Configuration for which RPCs should be generated in the GAPIC client.
+     * Configuration for which RPCs should be generated in the GAPIC client. Note: This field should not be used in most cases.
      */
     selectiveGapicGeneration?: Schema$SelectiveGapicGeneration;
   }
@@ -616,11 +633,11 @@ export namespace serviceusage_v1 {
    */
   export interface Schema$ConsumerPolicy {
     /**
-     * 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)
+     * Output only. The time the policy was created. For singleton policies, this is the first touch of the policy.
      */
-    annotations?: {[key: string]: string} | null;
+    createTime?: string | null;
     /**
-     * Enable rules define usable services and service groups.
+     * Enable rules define usable services and groups. There can currently be at most one `EnableRule`. This restriction will be lifted in later releases.
      */
     enableRules?: Schema$EnableRule[];
     /**
@@ -628,11 +645,11 @@ export namespace serviceusage_v1 {
      */
     etag?: string | null;
     /**
-     * Output only. The resource name of the policy. We only allow consumer policy name as `default` for now: `projects/12345/consumerPolicies/default`, `folders/12345/consumerPolicies/default`, `organizations/12345/consumerPolicies/default`.
+     * 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`.
      */
     name?: string | null;
     /**
-     * The last-modified time.
+     * Output only. The time the policy was last updated.
      */
     updateTime?: string | null;
   }
@@ -897,7 +914,7 @@ export namespace serviceusage_v1 {
     serviceId?: string | null;
   }
   /**
-   * The consumer policy rule that defines usable services and service groups.
+   * The consumer policy rule that defines enabled services and groups.
    */
   export interface Schema$EnableRule {
     /**
@@ -905,15 +922,11 @@ export namespace serviceusage_v1 {
      */
     enableType?: string | null;
     /**
-     * DEPRECATED: Please use field `values`. Service group should have prefix `groups/`. The names of the service groups that are enabled (Not Implemented). Example: `groups/googleServices`.
-     */
-    groups?: string[] | null;
-    /**
-     * DEPRECATED: Please use field `values`. Service should have prefix `services/`. The names of the services that are enabled. Example: `storage.googleapis.com`.
+     * The names of the services that are enabled. Example: `services/storage.googleapis.com`.
      */
     services?: string[] | null;
     /**
-     * The names of the services or service groups that are enabled. Example: `services/storage.googleapis.com`, `groups/googleServices`, `groups/allServices`.
+     * Deprecated: Use the `services` field instead. The names of the services or service groups that are enabled. Example: `services/storage.googleapis.com`, `groups/googleServices`, `groups/allServices`.
      */
     values?: string[] | null;
   }
@@ -1138,7 +1151,7 @@ export namespace serviceusage_v1 {
      */
     documentation?: Schema$Documentation;
     /**
-     * Configuration for network endpoints. If this is empty, then an endpoint with the same name as the service is automatically generated to service all defined APIs. WARNING: Defining any entries in the `endpoints` list disables the automatic generation of default endpoint variations (e.g., `{service\}.clients6.google.com`, `content-{service\}.googleapis.com`, and mTLS variants like `{service\}.mtls.googleapis.com`). To retain these default variations, you are required to explicitly include your main service endpoint (e.g., `myservice.googleapis.com`) in this list alongside any other custom endpoints (like REP, GFE, etc.).
+     * Configuration for network endpoints. If this is empty, then an endpoint with the same name as the service is automatically generated to service all defined APIs.
      */
     endpoints?: Schema$Endpoint[];
     /**
@@ -1315,6 +1328,53 @@ export namespace serviceusage_v1 {
      */
     usage?: Schema$Usage;
   }
+  /**
+   * A message to group the analysis information.
+   */
+  export interface Schema$GoogleApiServiceusageV2alphaAnalysis {
+    /**
+     * Output only. Analysis result of updating a policy.
+     */
+    analysisResult?: Schema$GoogleApiServiceusageV2alphaAnalysisResult;
+    /**
+     * Output only. The type of analysis.
+     */
+    analysisType?: string | null;
+    /**
+     * Output only. The user friendly display name of the analysis type. E.g. service dependency analysis, service resource usage analysis, etc.
+     */
+    displayName?: string | null;
+    /**
+     * The names of the service that has analysis result of warnings or blockers. Example: `services/storage.googleapis.com`.
+     */
+    service?: string | null;
+  }
+  /**
+   * An analysis result including blockers and warnings.
+   */
+  export interface Schema$GoogleApiServiceusageV2alphaAnalysisResult {
+    /**
+     * Blocking information that would prevent the policy changes at runtime.
+     */
+    blockers?: Schema$GoogleApiServiceusageV2alphaImpact[];
+    /**
+     * Warning information indicating that the policy changes might be unsafe, but will not block the changes at runtime.
+     */
+    warnings?: Schema$GoogleApiServiceusageV2alphaImpact[];
+  }
+  /**
+   * Metadata for the `AnalyzeConsumerPolicy` method.
+   */
+  export interface Schema$GoogleApiServiceusageV2alphaAnalyzeConsumerPolicyMetadata {}
+  /**
+   * The response of analyzing a consumer policy update.
+   */
+  export interface Schema$GoogleApiServiceusageV2alphaAnalyzeConsumerPolicyResponse {
+    /**
+     * 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.
+     */
+    analysis?: Schema$GoogleApiServiceusageV2alphaAnalysis[];
+  }
   /**
    * Consumer Policy is a set of rules that define what services or service groups can be used for a cloud resource hierarchy.
    */
@@ -1353,6 +1413,23 @@ export namespace serviceusage_v1 {
      */
     services?: string[] | null;
   }
+  /**
+   * A message to group impacts of updating a policy.
+   */
+  export interface Schema$GoogleApiServiceusageV2alphaImpact {
+    /**
+     * Output only. User friendly impact detail in a free form message.
+     */
+    detail?: string | null;
+    /**
+     * Output only. The type of impact.
+     */
+    impactType?: string | null;
+    /**
+     * 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.
+     */
+    parent?: string | null;
+  }
   /**
    * Metadata for the `UpdateConsumerPolicy` method.
    */
@@ -1590,9 +1667,9 @@ export namespace serviceusage_v1 {
      */
     impactType?: string | null;
     /**
-     * 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.
+     * Output only. This field will be populated only for the `DEPENDENCY_MISSING_DEPENDENCIES` impact type. Example: `services/compute.googleapis.com`. Impact.detail will be in format : `missing service dependency: {missing_dependency\}.`
      */
-    parent?: string | null;
+    missingDependency?: string | null;
   }
   /**
    * Metadata message that provides information such as progress, partial failures, and similar information on each GetOperation call of LRO returned by ImportAdminOverrides.
@@ -1786,49 +1863,6 @@ export namespace serviceusage_v1 {
      */
     totalPollTimeout?: string | null;
   }
-  /**
-   * McpEnableRule contains MCP enablement related rules.
-   */
-  export interface Schema$McpEnableRule {
-    /**
-     * List of enabled MCP services.
-     */
-    mcpServices?: Schema$McpService[];
-  }
-  /**
-   * MCP Consumer Policy is a set of rules that define MCP related policy for a cloud resource hierarchy.
-   */
-  export interface Schema$McpPolicy {
-    /**
-     * Output only. The time the policy was created. For singleton policies (such as the `default` policy), this is the first touch of the policy.
-     */
-    createTime?: string | null;
-    /**
-     * An opaque tag indicating the current version of the policy, used for concurrency control.
-     */
-    etag?: string | null;
-    /**
-     * McpEnableRules contains MCP enablement related rules.
-     */
-    mcpEnableRules?: Schema$McpEnableRule[];
-    /**
-     * Output only. The resource name of the policy. Only the `default` policy is supported. We allow the following formats: `projects/{PROJECT_NUMBER\}/mcpPolicies/default`, `projects/{PROJECT_ID\}/mcpPolicies/default`, `folders/{FOLDER_ID\}/mcpPolicies/default`, `organizations/{ORG_ID\}/mcpPolicies/default`.
-     */
-    name?: string | null;
-    /**
-     * Output only. The time the policy was last updated.
-     */
-    updateTime?: string | null;
-  }
-  /**
-   * McpService contains the service names that are enabled for MCP.
-   */
-  export interface Schema$McpService {
-    /**
-     * The names of the services that are enabled for MCP. Example: `services/library-example.googleapis.com`
-     */
-    service?: string | null;
-  }
   /**
    * Method represents a method of an API interface. New usages of this message as an alternative to MethodDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.
    */
@@ -1974,10 +2008,18 @@ export namespace serviceusage_v1 {
    * Bind API methods to metrics. Binding a method to a metric causes that metric's configured quota behaviors to apply to the method call.
    */
   export interface Schema$MetricRule {
+    /**
+     * Optional. Metrics to update when the selected methods are called, and the associated cost applied to each metric, iff the source of the call is an agent. The key of the map is the metric name, and the values are the amount increased for the metric against which the quota limits are defined. The value must not be negative.
+     */
+    agenticMetricCosts?: {[key: string]: string} | null;
     /**
      * Metrics to update when the selected methods are called, and the associated cost applied to each metric. The key of the map is the metric name, and the values are the amount increased for the metric against which the quota limits are defined. The value must not be negative.
      */
     metricCosts?: {[key: string]: string} | null;
+    /**
+     * Optional. Metrics to update when the selected methods are called, and the associated cost applied to each metric, iff the source of the call is not an agent. The key of the map is the metric name, and the values are the amount increased for the metric against which the quota limits are defined. The value must not be negative.
+     */
+    nonagenticMetricCosts?: {[key: string]: string} | null;
     /**
      * Selects the methods to which this rule applies. Refer to selector for syntax details.
      */
@@ -2257,6 +2299,10 @@ export namespace serviceusage_v1 {
      * Name of the quota limit. The name must be provided, and it must be unique within the service. The name can only include alphanumeric characters as well as '-'. The maximum length of the limit name is 64 characters.
      */
     name?: string | null;
+    /**
+     * Optional. This is only informational, the logic to allocate the quota to the correct metric (such as in `metric_rules`) should identify which quota metrics to allocate to.
+     */
+    trafficSource?: string | null;
     /**
      * 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.
      */
@@ -2322,7 +2368,7 @@ export namespace serviceusage_v1 {
     common?: Schema$CommonLanguageSettings;
   }
   /**
-   * This message is used to configure the generation of a subset of the RPCs in a service for client libraries.
+   * This message is used to configure the generation of a subset of the RPCs in a service for client libraries. Note: This feature should not be used in most cases.
    */
   export interface Schema$SelectiveGapicGeneration {
     /**
@@ -2466,10 +2512,6 @@ export namespace serviceusage_v1 {
    * Metadata for the `UpdateContentSecurityPolicy` method.
    */
   export interface Schema$UpdateContentSecurityPolicyMetadata {}
-  /**
-   * Metadata for the `UpdateMcpPolicy` method.
-   */
-  export interface Schema$UpdateMcpPolicyMetadata {}
   /**
    * Configuration controlling usage of a service.
    */
@@ -2492,7 +2534,7 @@ export namespace serviceusage_v1 {
    */
   export interface Schema$UsageRule {
     /**
-     *  Use this rule to configure unregistered calls for the service. Unregistered calls are calls that do not contain consumer project identity. (Example: calls that do not contain an API key). WARNING: By default, API methods do not allow unregistered calls, and each method call must be identified by a consumer project identity.
+     * Use this rule to configure unregistered calls for the service. Unregistered calls are calls that do not contain consumer project identity. (Example: calls that do not contain an API key). WARNING: By default, API methods do not allow unregistered calls, and each method call must be identified by a consumer project identity.
      */
     allowUnregisteredCalls?: boolean | null;
     /**
@@ -2606,8 +2648,7 @@ export namespace serviceusage_v1 {
         | BodyResponseCallback<Schema$Empty>
         | BodyResponseCallback<Readable>,
       callback?:
-        | BodyResponseCallback<Schema$Empty>
-        | BodyResponseCallback<Readable>
+        BodyResponseCallback<Schema$Empty> | BodyResponseCallback<Readable>
     ):
       | void
       | Promise<GaxiosResponseWithHTTP2<Schema$Empty>>
@@ -2741,8 +2782,7 @@ export namespace serviceusage_v1 {
         | BodyResponseCallback<Schema$Empty>
         | BodyResponseCallback<Readable>,
       callback?:
-        | BodyResponseCallback<Schema$Empty>
-        | BodyResponseCallback<Readable>
+        BodyResponseCallback<Schema$Empty> | BodyResponseCallback<Readable>
     ):
       | void
       | Promise<GaxiosResponseWithHTTP2<Schema$Empty>>
@@ -2882,8 +2922,7 @@ export namespace serviceusage_v1 {
         | BodyResponseCallback<Schema$Operation>
         | BodyResponseCallback<Readable>,
       callback?:
-        | BodyResponseCallback<Schema$Operation>
-        | BodyResponseCallback<Readable>
+        BodyResponseCallback<Schema$Operation> | BodyResponseCallback<Readable>
     ):
       | void
       | Promise<GaxiosResponseWithHTTP2<Schema$Operation>>
@@ -3010,8 +3049,7 @@ export namespace serviceusage_v1 {
     list(
       params: Params$Resource$Operations$List,
       options:
-        | MethodOptions
-        | BodyResponseCallback<Schema$ListOperationsResponse>,
+        MethodOptions | BodyResponseCallback<Schema$ListOperationsResponse>,
       callback: BodyResponseCallback<Schema$ListOperationsResponse>
     ): void;
     list(
@@ -3231,8 +3269,7 @@ export namespace serviceusage_v1 {
         | BodyResponseCallback<Schema$Operation>
         | BodyResponseCallback<Readable>,
       callback?:
-        | BodyResponseCallback<Schema$Operation>
-        | BodyResponseCallback<Readable>
+        BodyResponseCallback<Schema$Operation> | BodyResponseCallback<Readable>
     ):
       | void
       | Promise<GaxiosResponseWithHTTP2<Schema$Operation>>
@@ -3355,8 +3392,7 @@ export namespace serviceusage_v1 {
     batchGet(
       params: Params$Resource$Services$Batchget,
       options:
-        | MethodOptions
-        | BodyResponseCallback<Schema$BatchGetServicesResponse>,
+        MethodOptions | BodyResponseCallback<Schema$BatchGetServicesResponse>,
       callback: BodyResponseCallback<Schema$BatchGetServicesResponse>
     ): void;
     batchGet(
@@ -3530,8 +3566,7 @@ export namespace serviceusage_v1 {
         | BodyResponseCallback<Schema$Operation>
         | BodyResponseCallback<Readable>,
       callback?:
-        | BodyResponseCallback<Schema$Operation>
-        | BodyResponseCallback<Readable>
+        BodyResponseCallback<Schema$Operation> | BodyResponseCallback<Readable>
     ):
       | void
       | Promise<GaxiosResponseWithHTTP2<Schema$Operation>>
@@ -3679,8 +3714,7 @@ export namespace serviceusage_v1 {
         | BodyResponseCallback<Schema$Operation>
         | BodyResponseCallback<Readable>,
       callback?:
-        | BodyResponseCallback<Schema$Operation>
-        | BodyResponseCallback<Readable>
+        BodyResponseCallback<Schema$Operation> | BodyResponseCallback<Readable>
     ):
       | void
       | Promise<GaxiosResponseWithHTTP2<Schema$Operation>>
@@ -3949,8 +3983,7 @@ export namespace serviceusage_v1 {
     list(
       params: Params$Resource$Services$List,
       options:
-        | MethodOptions
-        | BodyResponseCallback<Schema$ListServicesResponse>,
+        MethodOptions | BodyResponseCallback<Schema$ListServicesResponse>,
       callback: BodyResponseCallback<Schema$ListServicesResponse>
     ): void;
     list(