@googleapis/servicecontrol 1.0.0 → 1.1.1

package/v1.ts

@@ -12,7 +12,6 @@
 // limitations under the License.
 
 /* eslint-disable @typescript-eslint/no-explicit-any */
-/* eslint-disable @typescript-eslint/class-name-casing */
 /* eslint-disable @typescript-eslint/no-unused-vars */
 /* eslint-disable @typescript-eslint/no-empty-interface */
 /* eslint-disable @typescript-eslint/no-namespace */
@@ -223,6 +222,10 @@ export namespace servicecontrol_v1 {
      * The number of items returned from a List or Query API method, if applicable.
      */
     numResponseItems?: string | null;
+    /**
+     * Indicates the policy violations for this request. If the request is denied by the policy, violation information will be logged here.
+     */
+    policyViolationInfo?: Schema$PolicyViolationInfo;
     /**
      * The operation request. This may not include all request parameters, such as those that are too large, privacy-sensitive, or duplicated elsewhere in the log record. It should never include user-generated data, such as file contents. When the JSON object represented here has a proto equivalent, the proto name will be indicated in the `@type` property.
      */
@@ -309,6 +312,10 @@ export namespace servicecontrol_v1 {
      * The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: "//iam.googleapis.com/projects/{PROJECT_ID\}/serviceAccounts/{ACCOUNT\}/keys/{key\}"
      */
     serviceAccountKeyName?: string | null;
+    /**
+     * Records the history of delegated resource access across Google services.
+     */
+    serviceDelegationHistory?: Schema$ServiceDelegationHistory;
     /**
      * The third party identification (if any) of the authenticated user making the request. When the JSON object represented here has a proto equivalent, the proto name will be indicated in the `@type` property.
      */
@@ -437,7 +444,7 @@ export namespace servicecontrol_v1 {
     type?: string | null;
   }
   /**
-   * Distribution represents a frequency distribution of double-valued sample points. It contains the size of the population of sample points plus additional optional information: - the arithmetic mean of the samples - the minimum and maximum of the samples - the sum-squared-deviation of the samples, used to compute variance - a histogram of the values of the sample points
+   * Distribution represents a frequency distribution of double-valued sample points. It contains the size of the population of sample points plus additional optional information: * the arithmetic mean of the samples * the minimum and maximum of the samples * the sum-squared-deviation of the samples, used to compute variance * a histogram of the values of the sample points
    */
   export interface Schema$Distribution {
     /**
@@ -793,10 +800,6 @@ export namespace servicecontrol_v1 {
      * End time of the operation. Required when the operation is used in ServiceController.Report, but optional when the operation is used in ServiceController.Check.
      */
     endTime?: string | null;
-    /**
-     * Unimplemented.
-     */
-    extensions?: Array<{[key: string]: any}> | null;
     /**
      * DO NOT USE. This is an experimental field.
      */
@@ -842,6 +845,27 @@ export namespace servicecontrol_v1 {
      */
     userLabels?: {[key: string]: string} | null;
   }
+  /**
+   * Represents OrgPolicy Violation information.
+   */
+  export interface Schema$OrgPolicyViolationInfo {
+    /**
+     * Optional. Resource payload that is currently in scope and is subjected to orgpolicy conditions. This payload may be the subset of the actual Resource that may come in the request. This payload should not contain any core content.
+     */
+    payload?: {[key: string]: any} | null;
+    /**
+     * Optional. Tags referenced on the resource at the time of evaluation. These also include the federated tags, if they are supplied in the CheckOrgPolicy or CheckCustomConstraints Requests. Optional field as of now. These tags are the Cloud tags that are available on the resource during the policy evaluation and will be available as part of the OrgPolicy check response for logging purposes.
+     */
+    resourceTags?: {[key: string]: string} | null;
+    /**
+     * Optional. Resource type that the orgpolicy is checked against. Example: compute.googleapis.com/Instance, store.googleapis.com/bucket
+     */
+    resourceType?: string | null;
+    /**
+     * Optional. Policy violations
+     */
+    violationInfo?: Schema$ViolationInfo[];
+  }
   /**
    * This message defines attributes for a node that handles a network request. The node can be either a service or an application that sends, forwards, or receives the request. Service peers should fill in `principal` and `labels` as appropriate.
    */
@@ -859,7 +883,7 @@ export namespace servicecontrol_v1 {
      */
     port?: string | null;
     /**
-     * The identity of this peer. Similar to `Request.auth.principal`, but relative to the peer instead of the request. For example, the idenity associated with a load balancer that forwared the request.
+     * The identity of this peer. Similar to `Request.auth.principal`, but relative to the peer instead of the request. For example, the identity associated with a load balancer that forwarded the request.
      */
     principal?: string | null;
     /**
@@ -867,6 +891,15 @@ export namespace servicecontrol_v1 {
      */
     regionCode?: string | null;
   }
+  /**
+   * Information related to policy violations for this request.
+   */
+  export interface Schema$PolicyViolationInfo {
+    /**
+     * Indicates the orgpolicy violations for this resource.
+     */
+    orgPolicyViolationInfo?: Schema$OrgPolicyViolationInfo;
+  }
   /**
    * Represents error information for QuotaOperation.
    */
@@ -922,7 +955,7 @@ export namespace servicecontrol_v1 {
      */
     methodName?: string | null;
     /**
-     * Identity of the operation. This is expected to be unique within the scope of the service that generated the operation, and guarantees idempotency in case of retries. In order to ensure best performance and latency in the Quota backends, operation_ids are optimally associated with time, so that related operations can be accessed fast in storage. For this reason, the recommended token for services that intend to operate at a high QPS is Unix time in nanos + UUID
+     * Identity of the operation. For Allocation Quota, this is expected to be unique within the scope of the service that generated the operation, and guarantees idempotency in case of retries. In order to ensure best performance and latency in the Quota backends, operation_ids are optimally associated with time, so that related operations can be accessed fast in storage. For this reason, the recommended token for services that intend to operate at a high QPS is Unix time in nanos + UUID
      */
     operationId?: string | null;
     /**
@@ -1011,7 +1044,7 @@ export namespace servicecontrol_v1 {
      */
     method?: string | null;
     /**
-     * The HTTP URL path.
+     * The HTTP URL path, excluding the query parameters.
      */
     path?: string | null;
     /**
@@ -1044,7 +1077,7 @@ export namespace servicecontrol_v1 {
    */
   export interface Schema$RequestMetadata {
     /**
-     * The IP address of the caller. For caller from internet, this will be public IPv4 or IPv6 address. For caller from a Compute Engine VM with external IP address, this will be the VM's external IP address. For caller from a Compute Engine VM without external IP address, if the VM is in the same organization (or project) as the accessed resource, `caller_ip` will be the VM's internal IPv4 address, otherwise the `caller_ip` will be redacted to "gce-internal-ip". See https://cloud.google.com/compute/docs/vpc/ for more information.
+     * The IP address of the caller. For a caller from the internet, this will be the public IPv4 or IPv6 address. For calls made from inside Google's internal production network from one GCP service to another, `caller_ip` will be redacted to "private". For a caller from a Compute Engine VM with a external IP address, `caller_ip` will be the VM's external IP address. For a caller from a Compute Engine VM without a external IP address, if the VM is in the same organization (or project) as the accessed resource, `caller_ip` will be the VM's internal IPv4 address, otherwise `caller_ip` will be redacted to "gce-internal-ip". See https://cloud.google.com/compute/docs/vpc/ for more information.
      */
     callerIp?: string | null;
     /**
@@ -1052,7 +1085,7 @@ export namespace servicecontrol_v1 {
      */
     callerNetwork?: string | null;
     /**
-     * The user agent of the caller. This information is not authenticated and should be treated accordingly. For example: + `google-api-python-client/1.4.0`: The request was made by the Google API client for Python. + `Cloud SDK Command Line Tool apitools-client/1.0 gcloud/0.9.62`: The request was made by the Google Cloud SDK CLI (gcloud). + `AppEngine-Google; (+http://code.google.com/appengine; appid: s~my-project`: The request was made from the `my-project` App Engine app. NOLINT
+     * The user agent of the caller. This information is not authenticated and should be treated accordingly. For example: + `google-api-python-client/1.4.0`: The request was made by the Google API client for Python. + `Cloud SDK Command Line Tool apitools-client/1.0 gcloud/0.9.62`: The request was made by the Google Cloud SDK CLI (gcloud). + `AppEngine-Google; (+http://code.google.com/appengine; appid: s~my-project`: The request was made from the `my-project` App Engine app.
      */
     callerSuppliedUserAgent?: string | null;
     /**
@@ -1069,7 +1102,7 @@ export namespace servicecontrol_v1 {
    */
   export interface Schema$Resource {
     /**
-     * Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations
+     * Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/
      */
     annotations?: {[key: string]: string} | null;
     /**
@@ -1105,7 +1138,7 @@ export namespace servicecontrol_v1 {
      */
     service?: string | null;
     /**
-     * The type of the resource. The syntax is platform-specific because different platforms define their resources differently. For Google APIs, the type format must be "{service\}/{kind\}".
+     * The type of the resource. The syntax is platform-specific because different platforms define their resources differently. For Google APIs, the type format must be "{service\}/{kind\}", such as "pubsub.googleapis.com/Topic".
      */
     type?: string | null;
     /**
@@ -1121,6 +1154,10 @@ export namespace servicecontrol_v1 {
    * Describes a resource associated with this operation.
    */
   export interface Schema$ResourceInfo {
+    /**
+     * The resource permission required for this request.
+     */
+    permission?: string | null;
     /**
      * The identifier of the parent of this resource instance. Must be in one of the following formats: - `projects/` - `folders/` - `organizations/`
      */
@@ -1156,7 +1193,7 @@ export namespace servicecontrol_v1 {
      */
     firstPartyPrincipal?: Schema$FirstPartyPrincipal;
     /**
-     * A string representing the principal_subject associated with the identity. See go/3pical for more info on how principal_subject is formatted.
+     * A string representing the principal_subject associated with the identity. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name\}/subject/{subject)` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name\}[{subject\}]`
      */
     principalSubject?: string | null;
     /**
@@ -1165,7 +1202,37 @@ export namespace servicecontrol_v1 {
     thirdPartyPrincipal?: Schema$ThirdPartyPrincipal;
   }
   /**
-   * The context of a span, attached to Exemplars in Distribution values during aggregation. It contains the name of a span with format: projects/[PROJECT_ID_OR_NUMBER]/traces/[TRACE_ID]/spans/[SPAN_ID]
+   * The history of delegation across multiple services as the result of the original user's action. Such as "service A uses its own account to do something for user B". This differs from ServiceAccountDelegationInfo, which only tracks the history of direct token exchanges (impersonation).
+   */
+  export interface Schema$ServiceDelegationHistory {
+    /**
+     * The original end user who initiated the request to GCP.
+     */
+    originalPrincipal?: string | null;
+    /**
+     * Data identifying the service specific jobs or units of work that were involved in a chain of service calls.
+     */
+    serviceMetadata?: Schema$ServiceMetadata[];
+  }
+  /**
+   * Metadata describing the service and additional service specific information used to identify the job or unit of work at hand.
+   */
+  export interface Schema$ServiceMetadata {
+    /**
+     * Additional metadata provided by service teams to describe service specific job information that was triggered by the original principal.
+     */
+    jobMetadata?: {[key: string]: any} | null;
+    /**
+     * A string representing the principal_subject associated with the identity. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name\}/subject/{subject)` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name\}[{subject\}]` If the identity is a Google account (e.g. workspace user account or service account), this will be the email of the prefixed by `serviceAccount:`. For example: `serviceAccount:my-service-account@project-1.iam.gserviceaccount.com`. If the identity is an individual user, the identity will be formatted as: `user:user_ABC@email.com`.
+     */
+    principalSubject?: string | null;
+    /**
+     * The service's fully qualified domain name, e.g. "dataproc.googleapis.com".
+     */
+    serviceDomain?: string | null;
+  }
+  /**
+   * The context of a span. This is attached to an Exemplar in Distribution values during aggregation. It contains the name of a span with format: projects/[PROJECT_ID_OR_NUMBER]/traces/[TRACE_ID]/spans/[SPAN_ID]
    */
   export interface Schema$SpanContext {
     /**
@@ -1261,6 +1328,187 @@ export namespace servicecontrol_v1 {
      */
     value?: string | null;
   }
+  /**
+   * A common proto for logging HTTP requests. Only contains semantics defined by the HTTP specification. Product-specific logging information MUST be defined in a separate message.
+   */
+  export interface Schema$V1HttpRequest {
+    /**
+     * The number of HTTP response bytes inserted into cache. Set only when a cache fill was attempted.
+     */
+    cacheFillBytes?: string | null;
+    /**
+     * Whether or not an entity was served from cache (with or without validation).
+     */
+    cacheHit?: boolean | null;
+    /**
+     * Whether or not a cache lookup was attempted.
+     */
+    cacheLookup?: boolean | null;
+    /**
+     * Whether or not the response was validated with the origin server before being served from cache. This field is only meaningful if `cache_hit` is True.
+     */
+    cacheValidatedWithOriginServer?: boolean | null;
+    /**
+     * The request processing latency on the server, from the time the request was received until the response was sent.
+     */
+    latency?: string | null;
+    /**
+     * Protocol used for the request. Examples: "HTTP/1.1", "HTTP/2", "websocket"
+     */
+    protocol?: string | null;
+    /**
+     * The referer URL of the request, as defined in [HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
+     */
+    referer?: string | null;
+    /**
+     * The IP address (IPv4 or IPv6) of the client that issued the HTTP request. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
+     */
+    remoteIp?: string | null;
+    /**
+     * The request method. Examples: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`.
+     */
+    requestMethod?: string | null;
+    /**
+     * The size of the HTTP request message in bytes, including the request headers and the request body.
+     */
+    requestSize?: string | null;
+    /**
+     * The scheme (http, https), the host name, the path, and the query portion of the URL that was requested. Example: `"http://example.com/some/info?color=red"`.
+     */
+    requestUrl?: string | null;
+    /**
+     * The size of the HTTP response message sent back to the client, in bytes, including the response headers and the response body.
+     */
+    responseSize?: string | null;
+    /**
+     * The IP address (IPv4 or IPv6) of the origin server that the request was sent to.
+     */
+    serverIp?: string | null;
+    /**
+     * The response code indicating the status of the response. Examples: 200, 404.
+     */
+    status?: number | null;
+    /**
+     * The user agent sent by the client. Example: `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)"`.
+     */
+    userAgent?: string | null;
+  }
+  /**
+   * An individual log entry.
+   */
+  export interface Schema$V1LogEntry {
+    /**
+     * Optional. Information about the HTTP request associated with this log entry, if applicable.
+     */
+    httpRequest?: Schema$V1HttpRequest;
+    /**
+     * A unique ID for the log entry used for deduplication. If omitted, the implementation will generate one based on operation_id.
+     */
+    insertId?: string | null;
+    /**
+     * A set of user-defined (key, value) data that provides additional information about the log entry.
+     */
+    labels?: {[key: string]: string} | null;
+    /**
+     * A set of user-defined (key, value) data that provides additional information about the moniotored resource that the log entry belongs to.
+     */
+    monitoredResourceLabels?: {[key: string]: string} | null;
+    /**
+     * Required. The log to which this log entry belongs. Examples: `"syslog"`, `"book_log"`.
+     */
+    name?: string | null;
+    /**
+     * Optional. Information about an operation associated with the log entry, if applicable.
+     */
+    operation?: Schema$V1LogEntryOperation;
+    /**
+     * The log entry payload, represented as a protocol buffer that is expressed as a JSON object. The only accepted type currently is AuditLog.
+     */
+    protoPayload?: {[key: string]: any} | null;
+    /**
+     * The severity of the log entry. The default value is `LogSeverity.DEFAULT`.
+     */
+    severity?: string | null;
+    /**
+     * Optional. Source code location information associated with the log entry, if any.
+     */
+    sourceLocation?: Schema$V1LogEntrySourceLocation;
+    /**
+     * The log entry payload, represented as a structure that is expressed as a JSON object.
+     */
+    structPayload?: {[key: string]: any} | null;
+    /**
+     * The log entry payload, represented as a Unicode string (UTF-8).
+     */
+    textPayload?: string | null;
+    /**
+     * The time the event described by the log entry occurred. If omitted, defaults to operation start time.
+     */
+    timestamp?: string | null;
+    /**
+     * Optional. Resource name of the trace associated with the log entry, if any. If this field contains a relative resource name, you can assume the name is relative to `//tracing.googleapis.com`. Example: `projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824`
+     */
+    trace?: string | null;
+  }
+  /**
+   * Additional information about a potentially long-running operation with which a log entry is associated.
+   */
+  export interface Schema$V1LogEntryOperation {
+    /**
+     * Optional. Set this to True if this is the first log entry in the operation.
+     */
+    first?: boolean | null;
+    /**
+     * Optional. An arbitrary operation identifier. Log entries with the same identifier are assumed to be part of the same operation.
+     */
+    id?: string | null;
+    /**
+     * Optional. Set this to True if this is the last log entry in the operation.
+     */
+    last?: boolean | null;
+    /**
+     * Optional. An arbitrary producer identifier. The combination of `id` and `producer` must be globally unique. Examples for `producer`: `"MyDivision.MyBigCompany.com"`, `"github.com/MyProject/MyApplication"`.
+     */
+    producer?: string | null;
+  }
+  /**
+   * Additional information about the source code location that produced the log entry.
+   */
+  export interface Schema$V1LogEntrySourceLocation {
+    /**
+     * Optional. Source file name. Depending on the runtime environment, this might be a simple name or a fully-qualified name.
+     */
+    file?: string | null;
+    /**
+     * Optional. Human-readable name of the function or method being invoked, with optional context such as the class or package name. This information may be used in contexts such as the logs viewer, where a file and line number are less meaningful. The format can vary by language. For example: `qual.if.ied.Class.method` (Java), `dir/package.func` (Go), `function` (Python).
+     */
+    function?: string | null;
+    /**
+     * Optional. Line within the source file. 1-based; 0 indicates no line number available.
+     */
+    line?: string | null;
+  }
+  /**
+   * Provides information about the Policy violation info for this request.
+   */
+  export interface Schema$ViolationInfo {
+    /**
+     * Optional. Value that is being checked for the policy. This could be in encrypted form (if pii sensitive). This field will only be emitted in LIST_POLICY types
+     */
+    checkedValue?: string | null;
+    /**
+     * Optional. Constraint name
+     */
+    constraint?: string | null;
+    /**
+     * Optional. Error message that policy is indicating.
+     */
+    errorMessage?: string | null;
+    /**
+     * Optional. Indicates the type of the policy.
+     */
+    policyType?: string | null;
+  }
 
   export class Resource$Services {
     context: APIRequestContext;
@@ -1270,64 +1518,6 @@ export namespace servicecontrol_v1 {
 
     /**
      * Attempts to allocate quota for the specified consumer. It should be called before the operation is executed. This method requires the `servicemanagement.services.quota` permission on the specified service. For more information, see [Cloud IAM](https://cloud.google.com/iam). **NOTE:** The client **must** fail-open on server errors `INTERNAL`, `UNKNOWN`, `DEADLINE_EXCEEDED`, and `UNAVAILABLE`. To ensure system reliability, the server may inject these errors to prohibit any hard dependency on the quota functionality.
-     * @example
-     * ```js
-     * // Before running the sample:
-     * // - Enable the API at:
-     * //   https://console.developers.google.com/apis/api/servicecontrol.googleapis.com
-     * // - Login into gcloud by running:
-     * //   `$ gcloud auth application-default login`
-     * // - Install the npm module by running:
-     * //   `$ npm install googleapis`
-     *
-     * const {google} = require('googleapis');
-     * const servicecontrol = google.servicecontrol('v1');
-     *
-     * async function main() {
-     *   const auth = new google.auth.GoogleAuth({
-     *     // Scopes can be specified either as an array or as a single, space-delimited string.
-     *     scopes: [
-     *       'https://www.googleapis.com/auth/cloud-platform',
-     *       'https://www.googleapis.com/auth/servicecontrol',
-     *     ],
-     *   });
-     *
-     *   // Acquire an auth client, and bind it to all future calls
-     *   const authClient = await auth.getClient();
-     *   google.options({auth: authClient});
-     *
-     *   // Do the magic
-     *   const res = await servicecontrol.services.allocateQuota({
-     *     // Name of the service as specified in the service configuration. For example, `"pubsub.googleapis.com"`. See google.api.Service for the definition of a service name.
-     *     serviceName: 'placeholder-value',
-     *
-     *     // Request body metadata
-     *     requestBody: {
-     *       // request body parameters
-     *       // {
-     *       //   "allocateOperation": {},
-     *       //   "serviceConfigId": "my_serviceConfigId"
-     *       // }
-     *     },
-     *   });
-     *   console.log(res.data);
-     *
-     *   // Example response
-     *   // {
-     *   //   "allocateErrors": [],
-     *   //   "allocateInfo": {},
-     *   //   "operationId": "my_operationId",
-     *   //   "quotaMetrics": [],
-     *   //   "serviceConfigId": "my_serviceConfigId"
-     *   // }
-     * }
-     *
-     * main().catch(e => {
-     *   console.error(e);
-     *   throw e;
-     * });
-     *
-     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1422,68 +1612,7 @@ export namespace servicecontrol_v1 {
     }
 
     /**
-     * Checks whether an operation on a service should be allowed to proceed based on the configuration of the service and related policies. It must be called before the operation is executed. If feasible, the client should cache the check results and reuse them for 60 seconds. In case of any server errors, the client should rely on the cached results for much longer time to avoid outage. WARNING: There is general 60s delay for the configuration and policy propagation, therefore callers MUST NOT depend on the `Check` method having the latest policy information. NOTE: the CheckRequest has the size limit of 64KB. This method requires the `servicemanagement.services.check` permission on the specified service. For more information, see [Cloud IAM](https://cloud.google.com/iam).
-     * @example
-     * ```js
-     * // Before running the sample:
-     * // - Enable the API at:
-     * //   https://console.developers.google.com/apis/api/servicecontrol.googleapis.com
-     * // - Login into gcloud by running:
-     * //   `$ gcloud auth application-default login`
-     * // - Install the npm module by running:
-     * //   `$ npm install googleapis`
-     *
-     * const {google} = require('googleapis');
-     * const servicecontrol = google.servicecontrol('v1');
-     *
-     * async function main() {
-     *   const auth = new google.auth.GoogleAuth({
-     *     // Scopes can be specified either as an array or as a single, space-delimited string.
-     *     scopes: [
-     *       'https://www.googleapis.com/auth/cloud-platform',
-     *       'https://www.googleapis.com/auth/servicecontrol',
-     *     ],
-     *   });
-     *
-     *   // Acquire an auth client, and bind it to all future calls
-     *   const authClient = await auth.getClient();
-     *   google.options({auth: authClient});
-     *
-     *   // Do the magic
-     *   const res = await servicecontrol.services.check({
-     *     // The service name as specified in its service configuration. For example, `"pubsub.googleapis.com"`. See [google.api.Service](https://cloud.google.com/service-management/reference/rpc/google.api#google.api.Service) for the definition of a service name.
-     *     serviceName: 'placeholder-value',
-     *
-     *     // Request body metadata
-     *     requestBody: {
-     *       // request body parameters
-     *       // {
-     *       //   "operation": {},
-     *       //   "requestProjectSettings": false,
-     *       //   "serviceConfigId": "my_serviceConfigId",
-     *       //   "skipActivationCheck": false
-     *       // }
-     *     },
-     *   });
-     *   console.log(res.data);
-     *
-     *   // Example response
-     *   // {
-     *   //   "checkErrors": [],
-     *   //   "checkInfo": {},
-     *   //   "operationId": "my_operationId",
-     *   //   "quotaInfo": {},
-     *   //   "serviceConfigId": "my_serviceConfigId",
-     *   //   "serviceRolloutId": "my_serviceRolloutId"
-     *   // }
-     * }
-     *
-     * main().catch(e => {
-     *   console.error(e);
-     *   throw e;
-     * });
-     *
-     * ```
+     * Checks whether an operation on a service should be allowed to proceed based on the configuration of the service and related policies. It must be called before the operation is executed. If feasible, the client should cache the check results and reuse them for 60 seconds. In case of any server errors, the client should rely on the cached results for much longer time to avoid outage. WARNING: There is general 60s delay for the configuration and policy propagation, therefore callers MUST NOT depend on the `Check` method having the latest policy information. NOTE: the CheckRequest has the size limit (wire-format byte size) of 1MB. This method requires the `servicemanagement.services.check` permission on the specified service. For more information, see [Cloud IAM](https://cloud.google.com/iam).
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1571,62 +1700,6 @@ export namespace servicecontrol_v1 {
 
     /**
      * Reports operation results to Google Service Control, such as logs and metrics. It should be called after an operation is completed. If feasible, the client should aggregate reporting data for up to 5 seconds to reduce API traffic. Limiting aggregation to 5 seconds is to reduce data loss during client crashes. Clients should carefully choose the aggregation time window to avoid data loss risk more than 0.01% for business and compliance reasons. NOTE: the ReportRequest has the size limit (wire-format byte size) of 1MB. This method requires the `servicemanagement.services.report` permission on the specified service. For more information, see [Google Cloud IAM](https://cloud.google.com/iam).
-     * @example
-     * ```js
-     * // Before running the sample:
-     * // - Enable the API at:
-     * //   https://console.developers.google.com/apis/api/servicecontrol.googleapis.com
-     * // - Login into gcloud by running:
-     * //   `$ gcloud auth application-default login`
-     * // - Install the npm module by running:
-     * //   `$ npm install googleapis`
-     *
-     * const {google} = require('googleapis');
-     * const servicecontrol = google.servicecontrol('v1');
-     *
-     * async function main() {
-     *   const auth = new google.auth.GoogleAuth({
-     *     // Scopes can be specified either as an array or as a single, space-delimited string.
-     *     scopes: [
-     *       'https://www.googleapis.com/auth/cloud-platform',
-     *       'https://www.googleapis.com/auth/servicecontrol',
-     *     ],
-     *   });
-     *
-     *   // Acquire an auth client, and bind it to all future calls
-     *   const authClient = await auth.getClient();
-     *   google.options({auth: authClient});
-     *
-     *   // Do the magic
-     *   const res = await servicecontrol.services.report({
-     *     // The service name as specified in its service configuration. For example, `"pubsub.googleapis.com"`. See [google.api.Service](https://cloud.google.com/service-management/reference/rpc/google.api#google.api.Service) for the definition of a service name.
-     *     serviceName: 'placeholder-value',
-     *
-     *     // Request body metadata
-     *     requestBody: {
-     *       // request body parameters
-     *       // {
-     *       //   "operations": [],
-     *       //   "serviceConfigId": "my_serviceConfigId"
-     *       // }
-     *     },
-     *   });
-     *   console.log(res.data);
-     *
-     *   // Example response
-     *   // {
-     *   //   "reportErrors": [],
-     *   //   "serviceConfigId": "my_serviceConfigId",
-     *   //   "serviceRolloutId": "my_serviceRolloutId"
-     *   // }
-     * }
-     *
-     * main().catch(e => {
-     *   console.error(e);
-     *   throw e;
-     * });
-     *
-     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.