Api-roll 42: 2016-11-08

generated/googleapis/lib/servicecontrol/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.servicecontrol.v1;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
@@ skipping 28 matching lines @@
   final commons.ApiRequester _requester;
 
   ServicesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Checks an operation with Google Service Control to decide whether
    * the given operation should proceed. It should be called before the
    * operation is executed.
    *
+   * If feasible, the client should cache the check results and reuse them for
+   * up to 60s. In case of server errors, the client may rely on the cached
+   * results for longer time.
+   *
    * This method requires the `servicemanagement.services.check` permission
    * on the specified service. For more information, see
    * [Google Cloud IAM](https://cloud.google.com/iam).
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [serviceName] - The service name as specified in its service configuration.
    * For example,
@@ skipping 33 matching lines @@
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new CheckResponse.fromJson(data));
   }
 
   /**
    * Reports operations to Google Service Control. It should be called
    * after the operation is completed.
    *
+   * If feasible, the client should aggregate reporting data for up to 5s to
+   * reduce API traffic. Limiting aggregation to 5s is to reduce data loss
+   * during client crashes. Clients should carefully choose the aggregation
+   * window to avoid data loss risk more than 0.01% for business and
+   * compliance reasons.
+   *
    * This method requires the `servicemanagement.services.report` permission
    * on the specified service. For more information, see
    * [Google Cloud IAM](https://cloud.google.com/iam).
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [serviceName] - The service name as specified in its service configuration.
    * For example,
@@ skipping 107 matching lines @@
       _json["detail"] = detail;
     }
     return _json;
   }
 }
 
 /** Request message for the Check method. */
 class CheckRequest {
   /** The operation to be checked. */
   Operation operation;
+  /**
+   * Specifies which version of service configuration should be used to process
+   * the request.
+   *
+   * If unspecified or no matching version can be found, the
+   * latest one will be used.
+   */
+  core.String serviceConfigId;
 
   CheckRequest();
 
   CheckRequest.fromJson(core.Map _json) {
     if (_json.containsKey("operation")) {
       operation = new Operation.fromJson(_json["operation"]);
     }
+    if (_json.containsKey("serviceConfigId")) {
+      serviceConfigId = _json["serviceConfigId"];
+    }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (operation != null) {
       _json["operation"] = (operation).toJson();
     }
+    if (serviceConfigId != null) {
+      _json["serviceConfigId"] = serviceConfigId;
+    }
     return _json;
   }
 }
 
 /** Response message for the Check method. */
 class CheckResponse {
   /**
    * Indicate the decision of the check.
    *
    * If no check errors are present, the service should process the operation.
@@ skipping 317 matching lines @@
    * values that belong to a set of approved types.
    *
    * The values for Object must be JSON objects. It can consist of `num`,
    * `String`, `bool` and `null` as well as `Map` and `List` values.
    */
   core.Map<core.String, core.Object> protoPayload;
   /**
    * The severity of the log entry. The default value is
    * `LogSeverity.DEFAULT`.
    * Possible string values are:
-   * - "DEFAULT" : The log entry has no assigned severity level.
-   * - "DEBUG" : Debug or trace information.
-   * - "INFO" : Routine information, such as ongoing status or performance.
-   * - "NOTICE" : Normal but significant events, such as start up, shut down, or
-   * configuration.
-   * - "WARNING" : Warning events might cause problems.
-   * - "ERROR" : Error events are likely to cause problems.
-   * - "CRITICAL" : Critical events cause more severe problems or brief outages.
-   * - "ALERT" : A person must take an action immediately.
-   * - "EMERGENCY" : One or more systems are unusable.
+   * - "DEFAULT" : (0) The log entry has no assigned severity level.
+   * - "DEBUG" : (100) Debug or trace information.
+   * - "INFO" : (200) Routine information, such as ongoing status or
+   * performance.
+   * - "NOTICE" : (300) Normal but significant events, such as start up, shut
+   * down, or
+   * a configuration change.
+   * - "WARNING" : (400) Warning events might cause problems.
+   * - "ERROR" : (500) Error events are likely to cause problems.
+   * - "CRITICAL" : (600) Critical events cause more severe problems or outages.
+   * - "ALERT" : (700) A person must take an action immediately.
+   * - "EMERGENCY" : (800) One or more systems are unusable.
    */
   core.String severity;
   /**
    * The log entry payload, represented as a structure that
    * is expressed as a JSON object.
    *
    * The values for Object must be JSON objects. It can consist of `num`,
    * `String`, `bool` and `null` as well as `Map` and `List` values.
    */
   core.Map<core.String, core.Object> structPayload;
@@ skipping 371 matching lines @@
    * Typically the service should report one operation per request.
    * Putting multiple operations into a single request is allowed, but should
    * be used only when multiple operations are natually available at the time
    * of the report.
    *
    * If multiple operations are in a single request, the total request size
    * should be no larger than 1MB. See ReportResponse.report_errors for
    * partial failure behavior.
    */
   core.List<Operation> operations;
+  /**
+   * Specifies which version of service config should be used to process the
+   * request.
+   *
+   * If unspecified or no matching version can be found, the
+   * latest one will be used.
+   */
+  core.String serviceConfigId;
 
   ReportRequest();
 
   ReportRequest.fromJson(core.Map _json) {
     if (_json.containsKey("operations")) {
       operations = _json["operations"].map((value) => new Operation.fromJson(value)).toList();
     }
+    if (_json.containsKey("serviceConfigId")) {
+      serviceConfigId = _json["serviceConfigId"];
+    }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (operations != null) {
       _json["operations"] = operations.map((value) => (value).toJson()).toList();
     }
+    if (serviceConfigId != null) {
+      _json["serviceConfigId"] = serviceConfigId;
+    }
     return _json;
   }
 }
 
 /** Response message for the Report method. */
 class ReportResponse {
   /**
    * Partial failures, one for each `Operation` in the request that failed
    * processing. There are three possible combinations of the RPC status:
    *
    * 1. The combination of a successful RPC status and an empty `report_errors`
    *    list indicates a complete success where all `Operations` in the
    *    request are processed successfully.
    * 2. The combination of a successful RPC status and a non-empty
    *    `report_errors` list indicates a partial success where some
    *    `Operations` in the request succeeded. Each
    *    `Operation` that failed processing has a corresponding item
    *    in this list.
-   * 3. A failed RPC status indicates a complete failure where none of the
-   *    `Operations` in the request succeeded.
+   * 3. A failed RPC status indicates a general non-deterministic failure.
+   *    When this happens, it's impossible to know which of the
+   *    'Operations' in the request succeeded or failed.
    */
   core.List<ReportError> reportErrors;
   /** The actual config id used to process the request. */
   core.String serviceConfigId;
 
   ReportResponse();
 
   ReportResponse.fromJson(core.Map _json) {
     if (_json.containsKey("reportErrors")) {
       reportErrors = _json["reportErrors"].map((value) => new ReportError.fromJson(value)).toList();
@@ skipping 110 matching lines @@
     }
     if (details != null) {
       _json["details"] = details;
     }
     if (message != null) {
       _json["message"] = message;
     }
     return _json;
   }
 }