Api-roll 42: 2016-11-08

discovery/googleapis/servicecontrol__v1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/cloud-platform": {
                     "description": "View and manage your data across Google Cloud Platform services"
                 },
                 "https://www.googleapis.com/auth/servicecontrol": {
                     "description": "Manage your Google Service Control data"
                 }
@@ skipping 102 matching lines @@
             "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
             "location": "query",
             "type": "string"
         }
     },
     "protocol": "rest",
     "resources": {
         "services": {
             "methods": {
                 "check": {
-                    "description": "Checks an operation with Google Service Control to decide whether\nthe given operation should proceed. It should be called before the\noperation is executed.\n\nThis method requires the `servicemanagement.services.check` permission\non the specified service. For more information, see\n[Google Cloud IAM](https://cloud.google.com/iam).",
+                    "description": "Checks an operation with Google Service Control to decide whether\nthe given operation should proceed. It should be called before the\noperation is executed.\n\nIf feasible, the client should cache the check results and reuse them for\nup to 60s. In case of server errors, the client may rely on the cached\nresults for longer time.\n\nThis method requires the `servicemanagement.services.check` permission\non the specified service. For more information, see\n[Google Cloud IAM](https://cloud.google.com/iam).",
                     "httpMethod": "POST",
                     "id": "servicecontrol.services.check",
                     "parameterOrder": [
                         "serviceName"
                     ],
                     "parameters": {
                         "serviceName": {
                             "description": "The service name as specified in its service configuration. For example,\n`\"pubsub.googleapis.com\"`.\n\nSee google.api.Service for the definition of a service name.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "v1/services/{serviceName}:check",
                     "request": {
                         "$ref": "CheckRequest"
                     },
                     "response": {
                         "$ref": "CheckResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/servicecontrol"
                     ]
                 },
                 "report": {
-                    "description": "Reports operations to Google Service Control. It should be called\nafter the operation is completed.\n\nThis method requires the `servicemanagement.services.report` permission\non the specified service. For more information, see\n[Google Cloud IAM](https://cloud.google.com/iam).",
+                    "description": "Reports operations to Google Service Control. It should be called\nafter the operation is completed.\n\nIf feasible, the client should aggregate reporting data for up to 5s to\nreduce API traffic. Limiting aggregation to 5s is to reduce data loss\nduring client crashes. Clients should carefully choose the aggregation\nwindow to avoid data loss risk more than 0.01% for business and\ncompliance reasons.\n\nThis method requires the `servicemanagement.services.report` permission\non the specified service. For more information, see\n[Google Cloud IAM](https://cloud.google.com/iam).",
                     "httpMethod": "POST",
                     "id": "servicecontrol.services.report",
                     "parameterOrder": [
                         "serviceName"
                     ],
                     "parameters": {
                         "serviceName": {
                             "description": "The service name as specified in its service configuration. For example,\n`\"pubsub.googleapis.com\"`.\n\nSee google.api.Service for the definition of a service name.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "v1/services/{serviceName}:report",
                     "request": {
                         "$ref": "ReportRequest"
                     },
                     "response": {
                         "$ref": "ReportResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/servicecontrol"
                     ]
                 }
             }
         }
     },
-    "revision": "20160815",
+    "revision": "20161031",
     "rootUrl": "https://servicecontrol.googleapis.com/",
     "schemas": {
         "CheckError": {
             "description": "Defines the errors to be returned in\ngoogle.api.servicecontrol.v1.CheckResponse.check_errors.",
             "id": "CheckError",
             "properties": {
                 "code": {
                     "description": "The error code.",
                     "enum": [
                         "ERROR_CODE_UNSPECIFIED",
@@ skipping 168 matching lines @@
             },
             "type": "object"
         },
         "CheckRequest": {
             "description": "Request message for the Check method.",
             "id": "CheckRequest",
             "properties": {
                 "operation": {
                     "$ref": "Operation",
                     "description": "The operation to be checked."
+                },
+                "serviceConfigId": {
+                    "description": "Specifies which version of service configuration should be used to process\nthe request.\n\nIf unspecified or no matching version can be found, the\nlatest one will be used.",
+                    "type": "string"
                 }
             },
             "type": "object"
         },
         "LogEntry": {
             "description": "An individual log entry.",
             "id": "LogEntry",
             "properties": {
                 "textPayload": {
                     "description": "The log entry payload, represented as a Unicode string (UTF-8).",
@@ skipping 21 matching lines @@
                         "DEBUG",
                         "INFO",
                         "NOTICE",
                         "WARNING",
                         "ERROR",
                         "CRITICAL",
                         "ALERT",
                         "EMERGENCY"
                     ],
                     "enumDescriptions": [
-                        "The log entry has no assigned severity level.",
-                        "Debug or trace information.",
-                        "Routine information, such as ongoing status or performance.",
-                        "Normal but significant events, such as start up, shut down, or\nconfiguration.",
-                        "Warning events might cause problems.",
-                        "Error events are likely to cause problems.",
-                        "Critical events cause more severe problems or brief outages.",
-                        "A person must take an action immediately.",
-                        "One or more systems are unusable."
+                        "(0) The log entry has no assigned severity level.",
+                        "(100) Debug or trace information.",
+                        "(200) Routine information, such as ongoing status or performance.",
+                        "(300) Normal but significant events, such as start up, shut down, or\na configuration change.",
+                        "(400) Warning events might cause problems.",
+                        "(500) Error events are likely to cause problems.",
+                        "(600) Critical events cause more severe problems or outages.",
+                        "(700) A person must take an action immediately.",
+                        "(800) One or more systems are unusable."
                     ],
                     "type": "string"
                 },
                 "name": {
                     "description": "Required. The log to which this log entry belongs. Examples: `\"syslog\"`,\n`\"book_log\"`.",
                     "type": "string"
                 },
                 "protoPayload": {
                     "additionalProperties": {
                         "description": "Properties of the object. Contains field @type with type URL.",
@@ skipping 17 matching lines @@
         "ReportRequest": {
             "description": "Request message for the Report method.",
             "id": "ReportRequest",
             "properties": {
                 "operations": {
                     "description": "Operations to be reported.\n\nTypically the service should report one operation per request.\nPutting multiple operations into a single request is allowed, but should\nbe used only when multiple operations are natually available at the time\nof the report.\n\nIf multiple operations are in a single request, the total request size\nshould be no larger than 1MB. See ReportResponse.report_errors for\npartial failure behavior.",
                     "items": {
                         "$ref": "Operation"
                     },
                     "type": "array"
+                },
+                "serviceConfigId": {
+                    "description": "Specifies which version of service config should be used to process the\nrequest.\n\nIf unspecified or no matching version can be found, the\nlatest one will be used.",
+                    "type": "string"
                 }
             },
             "type": "object"
         },
         "MetricValueSet": {
             "description": "Represents a set of metric values in the same metric.\nEach metric value in the set should have a unique combination of start time,\nend time, and label values.",
             "id": "MetricValueSet",
             "properties": {
                 "metricName": {
                     "description": "The metric name defined in the service configuration.",
@@ skipping 51 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ReportResponse": {
             "description": "Response message for the Report method.",
             "id": "ReportResponse",
             "properties": {
                 "reportErrors": {
-                    "description": "Partial failures, one for each `Operation` in the request that failed\nprocessing. There are three possible combinations of the RPC status:\n\n1. The combination of a successful RPC status and an empty `report_errors`\n   list indicates a complete success where all `Operations` in the\n   request are processed successfully.\n2. The combination of a successful RPC status and a non-empty\n   `report_errors` list indicates a partial success where some\n   `Operations` in the request succeeded. Each\n   `Operation` that failed processing has a corresponding item\n   in this list.\n3. A failed RPC status indicates a complete failure where none of the\n   `Operations` in the request succeeded.",
+                    "description": "Partial failures, one for each `Operation` in the request that failed\nprocessing. There are three possible combinations of the RPC status:\n\n1. The combination of a successful RPC status and an empty `report_errors`\n   list indicates a complete success where all `Operations` in the\n   request are processed successfully.\n2. The combination of a successful RPC status and a non-empty\n   `report_errors` list indicates a partial success where some\n   `Operations` in the request succeeded. Each\n   `Operation` that failed processing has a corresponding item\n   in this list.\n3. A failed RPC status indicates a general non-deterministic failure.\n   When this happens, it's impossible to know which of the\n   'Operations' in the request succeeded or failed.",
                     "items": {
                         "$ref": "ReportError"
                     },
                     "type": "array"
                 },
                 "serviceConfigId": {
                     "description": "The actual config id used to process the request.",
                     "type": "string"
                 }
             },
@@ skipping 110 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "",
     "title": "Google Service Control API",
     "version": "v1"
 }