@googleapis/servicecontrol 1.0.0 → 1.1.1

package/v2.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 */
@@ -207,6 +206,10 @@ export namespace servicecontrol_v2 {
      * 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.
      */
@@ -293,6 +296,10 @@ export namespace servicecontrol_v2 {
      * 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.
      */
@@ -349,7 +356,7 @@ export namespace servicecontrol_v2 {
      */
     headers?: {[key: string]: string} | null;
     /**
-     * An 'OK' status allows the operation. Any other status indicates a denial; [google.rpc.Status.details]() would contain additional details about the denial.
+     * Operation is allowed when this field is not set. Any non-'OK' status indicates a denial; google.rpc.Status.details would contain additional details about the denial.
      */
     status?: Schema$Status;
   }
@@ -366,6 +373,27 @@ export namespace servicecontrol_v2 {
      */
     serviceMetadata?: {[key: string]: any} | 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.
    */
@@ -383,7 +411,7 @@ export namespace servicecontrol_v2 {
      */
     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;
     /**
@@ -391,6 +419,15 @@ export namespace servicecontrol_v2 {
      */
     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;
+  }
   /**
    * Request message for the Report method.
    */
@@ -405,7 +442,7 @@ export namespace servicecontrol_v2 {
     serviceConfigId?: string | null;
   }
   /**
-   * Response message for the Report method. If the request contains any invalid data, the server returns an RPC error.
+   * Response message for the Report method.
    */
   export interface Schema$ReportResponse {}
   /**
@@ -433,7 +470,7 @@ export namespace servicecontrol_v2 {
      */
     method?: string | null;
     /**
-     * The HTTP URL path.
+     * The HTTP URL path, excluding the query parameters.
      */
     path?: string | null;
     /**
@@ -466,7 +503,7 @@ export namespace servicecontrol_v2 {
    */
   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;
     /**
@@ -474,7 +511,7 @@ export namespace servicecontrol_v2 {
      */
     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;
     /**
@@ -491,7 +528,7 @@ export namespace servicecontrol_v2 {
    */
   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;
     /**
@@ -527,7 +564,7 @@ export namespace servicecontrol_v2 {
      */
     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;
     /**
@@ -543,6 +580,14 @@ export namespace servicecontrol_v2 {
    * Describes a resource referenced in the request.
    */
   export interface Schema$ResourceInfo {
+    /**
+     * Optional. The identifier of the container of this resource. For Google Cloud APIs, the resource container must be one of the following formats: - `projects/` - `folders/` - `organizations/` Required for the policy enforcement on the container level (e.g. VPCSC, Location Policy check, Org Policy check).
+     */
+    container?: string | null;
+    /**
+     * Optional. The location of the resource, it must be a valid zone, region or multiregion, for example: "europe-west4", "northamerica-northeast1-a". Required for location policy check.
+     */
+    location?: string | null;
     /**
      * The name of the resource referenced in the request.
      */
@@ -574,7 +619,7 @@ export namespace servicecontrol_v2 {
    */
   export interface Schema$Response {
     /**
-     * The length of time it takes the backend service to fully respond to a request. Measured from when the destination service starts to send the request to the backend until when the destination service receives the complete response from the backend.
+     * The amount of time it takes the backend service to fully respond to a request. Measured from when the destination service starts to send the request to the backend until when the destination service receives the complete response from the backend.
      */
     backendLatency?: string | null;
     /**
@@ -603,7 +648,7 @@ export namespace servicecontrol_v2 {
      */
     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;
     /**
@@ -612,7 +657,37 @@ export namespace servicecontrol_v2 {
     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 {
     /**
@@ -646,6 +721,187 @@ export namespace servicecontrol_v2 {
      */
     thirdPartyClaims?: {[key: string]: any} | 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$V2HttpRequest {
+    /**
+     * 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$V2LogEntry {
+    /**
+     * Optional. Information about the HTTP request associated with this log entry, if applicable.
+     */
+    httpRequest?: Schema$V2HttpRequest;
+    /**
+     * 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$V2LogEntryOperation;
+    /**
+     * 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$V2LogEntrySourceLocation;
+    /**
+     * 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$V2LogEntryOperation {
+    /**
+     * 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$V2LogEntrySourceLocation {
+    /**
+     * 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;
@@ -654,64 +910,7 @@ export namespace servicecontrol_v2 {
     }
 
     /**
-     * Private Preview. This feature is only available for approved services. This method provides admission control for services that are integrated with [Service Infrastructure](/service-infrastructure). It checks whether an operation should be allowed based on the service configuration and relevant policies. It must be called before the operation is executed. For more information, see [Admission Control](/service-infrastructure/docs/admission-control). NOTE: The admission control has an expected policy propagation delay of 60s. The caller **must** not depend on the most recent policy changes. NOTE: The admission control has a hard limit of 1 referenced resources per call. If an operation refers to more than 1 resources, the caller must call the Check method multiple times. This method requires the `servicemanagement.services.check` permission on the specified service. For more information, see [Service Control API Access Control](https://cloud.google.com/service-infrastructure/docs/service-control/access-control).
-     * @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('v2');
-     *
-     * 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
-     *       // {
-     *       //   "attributes": {},
-     *       //   "flags": "my_flags",
-     *       //   "resources": [],
-     *       //   "serviceConfigId": "my_serviceConfigId"
-     *       // }
-     *     },
-     *   });
-     *   console.log(res.data);
-     *
-     *   // Example response
-     *   // {
-     *   //   "headers": {},
-     *   //   "status": {}
-     *   // }
-     * }
-     *
-     * main().catch(e => {
-     *   console.error(e);
-     *   throw e;
-     * });
-     *
-     * ```
+     * Private Preview. This feature is only available for approved services. This method provides admission control for services that are integrated with [Service Infrastructure](https://cloud.google.com/service-infrastructure). It checks whether an operation should be allowed based on the service configuration and relevant policies. It must be called before the operation is executed. For more information, see [Admission Control](https://cloud.google.com/service-infrastructure/docs/admission-control). NOTE: The admission control has an expected policy propagation delay of 60s. The caller **must** not depend on the most recent policy changes. NOTE: The admission control has a hard limit of 1 referenced resources per call. If an operation refers to more than 1 resources, the caller must call the Check method multiple times. This method requires the `servicemanagement.services.check` permission on the specified service. For more information, see [Service Control API Access Control](https://cloud.google.com/service-infrastructure/docs/service-control/access-control).
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -798,59 +997,7 @@ export namespace servicecontrol_v2 {
     }
 
     /**
-     * Private Preview. This feature is only available for approved services. This method provides telemetry reporting for services that are integrated with [Service Infrastructure](/service-infrastructure). It reports a list of operations that have occurred on a service. It must be called after the operations have been executed. For more information, see [Telemetry Reporting](/service-infrastructure/docs/telemetry-reporting). NOTE: The telemetry reporting has a hard limit of 1000 operations and 1MB per Report call. It is recommended to have no more than 100 operations per call. This method requires the `servicemanagement.services.report` permission on the specified service. For more information, see [Service Control API Access Control](https://cloud.google.com/service-infrastructure/docs/service-control/access-control).
-     * @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('v2');
-     *
-     * 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
-     *   // {}
-     * }
-     *
-     * main().catch(e => {
-     *   console.error(e);
-     *   throw e;
-     * });
-     *
-     * ```
+     * Private Preview. This feature is only available for approved services. This method provides telemetry reporting for services that are integrated with [Service Infrastructure](https://cloud.google.com/service-infrastructure). It reports a list of operations that have occurred on a service. It must be called after the operations have been executed. For more information, see [Telemetry Reporting](https://cloud.google.com/service-infrastructure/docs/telemetry-reporting). NOTE: The telemetry reporting has a hard limit of 1000 operations and 1MB per Report call. It is recommended to have no more than 100 operations per call. This method requires the `servicemanagement.services.report` permission on the specified service. For more information, see [Service Control API Access Control](https://cloud.google.com/service-infrastructure/docs/service-control/access-control).
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.