Api-roll 41: 2016-08-26

discovery/googleapis/servicemanagement__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/cloud-platform.read-only": {
                     "description": "View your data across Google Cloud Platform services"
                 },
                 "https://www.googleapis.com/auth/service.management": {
                     "description": "Manage your Google API service configuration"
                 },
                 "https://www.googleapis.com/auth/service.management.readonly": {
                     "description": "View your Google API service configuration"
                 }
             }
         }
     },
     "basePath": "",
     "baseUrl": "https://servicemanagement.googleapis.com/",
     "batchPath": "batch",
     "canonicalName": "Service Management",
-    "description": "The service management API for Google Cloud Platform",
+    "description": "Google Service Management allows service producers to publish their services on Google Cloud Platform so that they can be discovered and used by service consumers.",
     "discoveryVersion": "v1",
     "documentationLink": "https://cloud.google.com/service-management/",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "servicemanagement:v1",
     "kind": "discovery#restDescription",
     "name": "servicemanagement",
     "ownerDomain": "google.com",
@@ skipping 169 matching lines @@
                     "id": "servicemanagement.services.getConfig",
                     "parameterOrder": [
                         "serviceName"
                     ],
                     "parameters": {
                         "configId": {
                             "location": "query",
                             "type": "string"
                         },
                         "serviceName": {
-                            "description": "The name of the service.  See the `ServiceManager` overview for naming\nrequirements.  For example: `example.googleapis.com`.",
+                            "description": "The name of the service.  See the [overview](/service-management/overview)\nfor naming requirements.  For example: `example.googleapis.com`.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "v1/services/{serviceName}/config",
                     "response": {
                         "$ref": "Service"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/cloud-platform.read-only",
                         "https://www.googleapis.com/auth/service.management",
                         "https://www.googleapis.com/auth/service.management.readonly"
                     ]
                 },
                 "undelete": {
                     "description": "Revives a previously deleted managed service. The method restores the\nservice using the configuration at the time the service was deleted.\nThe target service must exist and must have been deleted within the\nlast 30 days.\n\nOperation<response: UndeleteServiceResponse>",
                     "httpMethod": "POST",
                     "id": "servicemanagement.services.undelete",
                     "parameterOrder": [
                         "serviceName"
                     ],
                     "parameters": {
                         "serviceName": {
-                            "description": "The name of the service. See the `ServiceManager` overview for naming\nrequirements. For example: `example.googleapis.com`.",
+                            "description": "The name of the service. See the [overview](/service-management/overview)\nfor naming requirements. For example: `example.googleapis.com`.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "v1/services/{serviceName}:undelete",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
@@ skipping 55 matching lines @@
                         "$ref": "ListServicesResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/cloud-platform.read-only",
                         "https://www.googleapis.com/auth/service.management",
                         "https://www.googleapis.com/auth/service.management.readonly"
                     ]
                 },
                 "create": {
-                    "description": "Creates a new managed service.\n\nOperation<response: ManagedService>",
+                    "description": "Creates a new managed service.\nPlease note one producer project can own no more than 20 services.\n\nOperation<response: ManagedService>",
                     "httpMethod": "POST",
                     "id": "servicemanagement.services.create",
                     "parameterOrder": [],
                     "parameters": {},
                     "path": "v1/services",
                     "request": {
                         "$ref": "ManagedService"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/service.management"
                     ]
                 },
                 "enable": {
-                    "description": "Enable a managed service for a project with default setting.\n\nOperation<response: EnableServiceResponse>",
+                    "description": "Enable a managed service for a project with default setting.\n\nOperation<response: EnableServiceResponse>\n\ngoogle.rpc.Status errors may contain a\ngoogle.rpc.PreconditionFailure error detail.",
                     "httpMethod": "POST",
                     "id": "servicemanagement.services.enable",
                     "parameterOrder": [
                         "serviceName"
                     ],
                     "parameters": {
                         "serviceName": {
                             "description": "Name of the service to enable. Specifying an unknown service name will\ncause the request to fail.",
                             "location": "path",
                             "required": true,
@@ skipping 42 matching lines @@
                 },
                 "delete": {
                     "description": "Deletes a managed service. This method will change the serivce in the\n`Soft-Delete` state for 30 days. Within this period, service producers may\ncall UndeleteService to restore the service.\nAfter 30 days, the service will be permanently deleted.\n\nOperation<response: google.protobuf.Empty>",
                     "httpMethod": "DELETE",
                     "id": "servicemanagement.services.delete",
                     "parameterOrder": [
                         "serviceName"
                     ],
                     "parameters": {
                         "serviceName": {
-                            "description": "The name of the service.  See the `ServiceManager` overview for naming\nrequirements.  For example: `example.googleapis.com`.",
+                            "description": "The name of the service.  See the [overview](/service-management/overview)\nfor naming requirements.  For example: `example.googleapis.com`.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "v1/services/{serviceName}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
@@ skipping 42 matching lines @@
                                 "rolloutId"
                             ],
                             "parameters": {
                                 "rolloutId": {
                                     "description": "The id of the rollout resource.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 },
                                 "serviceName": {
-                                    "description": "The name of the service.  See the `ServiceManager` overview for naming\nrequirements.  For example: `example.googleapis.com`.",
+                                    "description": "The name of the service.  See the [overview](/service-management/overview)\nfor naming requirements.  For example: `example.googleapis.com`.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "v1/services/{serviceName}/rollouts/{rolloutId}",
                             "response": {
                                 "$ref": "Rollout"
                             },
                             "scopes": [
                                 "https://www.googleapis.com/auth/cloud-platform",
                                 "https://www.googleapis.com/auth/cloud-platform.read-only",
                                 "https://www.googleapis.com/auth/service.management",
                                 "https://www.googleapis.com/auth/service.management.readonly"
                             ]
                         },
                         "create": {
-                            "description": "Creates a new service configuration rollout. Based on rollout, the\nGoogle Service Management will roll out the service configurations to\ndifferent backend services. For example, the logging configuration will be\npushed to Google Cloud Logging.\n\nOperation<response: Rollout>",
+                            "description": "Creates a new service configuration rollout. Based on rollout, the\nGoogle Service Management will roll out the service configurations to\ndifferent backend services. For example, the logging configuration will be\npushed to Google Cloud Logging.\n\nPlease note that any previous pending and running Rollouts and associated\nOperations will be automatically cancelled so that the latest Rollout will\nnot be blocked by previous Rollouts.\n\nOperation<response: Rollout>",
                             "httpMethod": "POST",
                             "id": "servicemanagement.services.rollouts.create",
                             "parameterOrder": [
                                 "serviceName"
                             ],
                             "parameters": {
                                 "serviceName": {
-                                    "description": "The name of the service.  See the `ServiceManager` overview for naming\nrequirements.  For example: `example.googleapis.com`.",
+                                    "description": "The name of the service.  See the [overview](/service-management/overview)\nfor naming requirements.  For example: `example.googleapis.com`.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "v1/services/{serviceName}/rollouts",
                             "request": {
                                 "$ref": "Rollout"
                             },
                             "response": {
@@ skipping 12 matching lines @@
                                 "serviceName"
                             ],
                             "parameters": {
                                 "pageSize": {
                                     "description": "The max number of items to include in the response list.",
                                     "format": "int32",
                                     "location": "query",
                                     "type": "integer"
                                 },
                                 "serviceName": {
-                                    "description": "The name of the service.  See the `ServiceManager` overview for naming\nrequirements.  For example: `example.googleapis.com`.",
+                                    "description": "The name of the service.  See the [overview](/service-management/overview)\nfor naming requirements.  For example: `example.googleapis.com`.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 },
                                 "pageToken": {
                                     "description": "The token of the page to retrieve.",
                                     "location": "query",
                                     "type": "string"
                                 }
                             },
@@ skipping 14 matching lines @@
                     "methods": {
                         "submit": {
                             "description": "Creates a new service configuration (version) for a managed service based\non\nuser-supplied configuration source files (for example: OpenAPI\nSpecification). This method stores the source configurations as well as the\ngenerated service configuration. To rollout the service configuration to\nother services,\nplease call CreateServiceRollout.\n\nOperation<response: SubmitConfigSourceResponse>",
                             "httpMethod": "POST",
                             "id": "servicemanagement.services.configs.submit",
                             "parameterOrder": [
                                 "serviceName"
                             ],
                             "parameters": {
                                 "serviceName": {
-                                    "description": "The name of the service.  See the `ServiceManager` overview for naming\nrequirements.  For example: `example.googleapis.com`.",
+                                    "description": "The name of the service.  See the [overview](/service-management/overview)\nfor naming requirements.  For example: `example.googleapis.com`.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "v1/services/{serviceName}/configs:submit",
                             "request": {
                                 "$ref": "SubmitConfigSourceRequest"
                             },
                             "response": {
@@ skipping 12 matching lines @@
                                 "serviceName",
                                 "configId"
                             ],
                             "parameters": {
                                 "configId": {
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 },
                                 "serviceName": {
-                                    "description": "The name of the service.  See the `ServiceManager` overview for naming\nrequirements.  For example: `example.googleapis.com`.",
+                                    "description": "The name of the service.  See the [overview](/service-management/overview)\nfor naming requirements.  For example: `example.googleapis.com`.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "v1/services/{serviceName}/configs/{configId}",
                             "response": {
                                 "$ref": "Service"
                             },
                             "scopes": [
                                 "https://www.googleapis.com/auth/cloud-platform",
                                 "https://www.googleapis.com/auth/cloud-platform.read-only",
                                 "https://www.googleapis.com/auth/service.management",
                                 "https://www.googleapis.com/auth/service.management.readonly"
                             ]
                         },
                         "create": {
                             "description": "Creates a new service configuration (version) for a managed service.\nThis method only stores the service configuration. To roll out the service\nconfiguration to backend systems please call\nCreateServiceRollout.",
                             "httpMethod": "POST",
                             "id": "servicemanagement.services.configs.create",
                             "parameterOrder": [
                                 "serviceName"
                             ],
                             "parameters": {
                                 "serviceName": {
-                                    "description": "The name of the service.  See the `ServiceManager` overview for naming\nrequirements.  For example: `example.googleapis.com`.",
+                                    "description": "The name of the service.  See the [overview](/service-management/overview)\nfor naming requirements.  For example: `example.googleapis.com`.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "v1/services/{serviceName}/configs",
                             "request": {
                                 "$ref": "Service"
                             },
                             "response": {
@@ skipping 12 matching lines @@
                                 "serviceName"
                             ],
                             "parameters": {
                                 "pageSize": {
                                     "description": "The max number of items to include in the response list.",
                                     "format": "int32",
                                     "location": "query",
                                     "type": "integer"
                                 },
                                 "serviceName": {
-                                    "description": "The name of the service.  See the `ServiceManager` overview for naming\nrequirements.  For example: `example.googleapis.com`.",
+                                    "description": "The name of the service.  See the [overview](/service-management/overview)\nfor naming requirements.  For example: `example.googleapis.com`.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 },
                                 "pageToken": {
                                     "description": "The token of the page to retrieve.",
                                     "location": "query",
                                     "type": "string"
                                 }
                             },
@@ skipping 35 matching lines @@
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/service.management"
                     ]
                 }
             }
         }
     },
-    "revision": "20160803",
+    "revision": "20160822",
     "rootUrl": "https://servicemanagement.googleapis.com/",
     "schemas": {
         "Api": {
             "description": "Api is a light-weight descriptor for a protocol buffer service.",
             "id": "Api",
             "properties": {
                 "methods": {
                     "description": "The methods of this api, in unspecified order.",
                     "items": {
                         "$ref": "Method"
@@ skipping 52 matching lines @@
                     },
                     "type": "array"
                 },
                 "selector": {
                     "description": "Selects the methods to which this rule applies. Use '*' to indicate all\nmethods in all APIs.\n\nRefer to selector for syntax details.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
-        "ConfigOptions": {
-            "description": "A set of options to cover use of source config within `ServiceManager`\nand related tools.",
-            "id": "ConfigOptions",
-            "properties": {},
-            "type": "object"
-        },
         "Diagnostic": {
             "description": "Represents a diagnostic message (error or warning)",
             "id": "Diagnostic",
             "properties": {
                 "location": {
                     "description": "File name and line number of the error or warning.",
                     "type": "string"
                 },
                 "kind": {
                     "description": "The kind of diagnostic information provided.",
@@ skipping 26 matching lines @@
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "MonitoredResourceDescriptor": {
             "description": "An object that describes the schema of a MonitoredResource object using a\ntype name and a set of labels.  For example, the monitored resource\ndescriptor for Google Compute Engine VM instances has a type of\n`\"gce_instance\"` and specifies the use of the labels `\"instance_id\"` and\n`\"zone\"` to identify particular VM instances.\n\nDifferent APIs can support different monitored resource types. APIs generally\nprovide a `list` method that returns the monitored resource descriptors used\nby the API.",
             "id": "MonitoredResourceDescriptor",
             "properties": {
                 "displayName": {
-                    "description": "Optional. A concise name for the monitored resource type that might be\ndisplayed in user interfaces. For example, `\"Google Cloud SQL Database\"`.",
+                    "description": "Optional. A concise name for the monitored resource type that might be\ndisplayed in user interfaces. It should be a Title Cased Noun Phrase,\nwithout any article or other determiners. For example,\n`\"Google Cloud SQL Database\"`.",
                     "type": "string"
                 },
                 "description": {
                     "description": "Optional. A detailed description of the monitored resource type that might\nbe used in documentation.",
                     "type": "string"
                 },
                 "labels": {
                     "description": "Required. A set of labels used to describe instances of this monitored\nresource type. For example, an individual Google Cloud SQL database is\nidentified by values for the labels `\"database_id\"` and `\"zone\"`.",
                     "items": {
                         "$ref": "LabelDescriptor"
@@ skipping 123 matching lines @@
                     "description": "Defines the metrics used by this service.",
                     "items": {
                         "$ref": "MetricDescriptor"
                     },
                     "type": "array"
                 },
                 "systemParameters": {
                     "$ref": "SystemParameters",
                     "description": "Configuration for system parameters."
                 },
+                "endpoints": {
+                    "description": "Configuration for network endpoints.  If this is empty, then an endpoint\nwith the same name as the service is automatically generated to service all\ndefined APIs.",
+                    "items": {
+                        "$ref": "Endpoint"
+                    },
+                    "type": "array"
+                },
                 "name": {
                     "description": "The DNS address at which this service is available,\ne.g. `calendar.googleapis.com`.",
                     "type": "string"
                 },
                 "producerProjectId": {
                     "description": "The id of the Google developer project that owns the service.\nMembers of this project can manage the service configuration,\nmanage consumption of the service, etc.",
                     "type": "string"
                 },
                 "documentation": {
                     "$ref": "Documentation",
@@ skipping 209 matching lines @@
         },
         "ManagedService": {
             "description": "The full representation of a Service that is managed by\nGoogle Service Management.",
             "id": "ManagedService",
             "properties": {
                 "producerProjectId": {
                     "description": "ID of the project that produces and owns this service.",
                     "type": "string"
                 },
                 "serviceName": {
-                    "description": "The name of the service. See the [overview](/service-management/overview)\nfor naming requirements.\nThis name must match `google.api.Service.name` in the\n`service_config` field.",
+                    "description": "The name of the service. See the [overview](/service-management/overview)\nfor naming requirements.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ConfigFile": {
             "description": "Generic specification of a source configuration file",
             "id": "ConfigFile",
             "properties": {
                 "filePath": {
@@ skipping 246 matching lines @@
                         "CANCELLED",
                         "FAILED",
                         "PENDING"
                     ],
                     "enumDescriptions": [
                         "No status specified.",
                         "The Rollout is in progress.",
                         "The Rollout has completed successfully.",
                         "The Rollout has been cancelled. This can happen if you have overlapping\nRollout pushes, and the previous ones will be cancelled.",
                         "The Rollout has failed. It is typically caused by configuration errors.",
-                        "The Rollout has started yet and is pending for execution."
+                        "The Rollout has not started yet and is pending for execution."
                     ],
                     "type": "string"
                 },
                 "deleteServiceStrategy": {
                     "$ref": "DeleteServiceStrategy",
                     "description": "The strategy associated with a rollout to delete a `ManagedService`.\nReadonly."
                 },
                 "createTime": {
                     "description": "Creation time of the rollout. Readonly.",
                     "format": "google-datetime",
@@ skipping 14 matching lines @@
             "description": "Represents a source file which is used to generate the service configuration\ndefined by `google.api.Service`.",
             "id": "ConfigSource",
             "properties": {
                 "files": {
                     "description": "Set of source configuration files that are used to generate a service\nconfiguration (`google.api.Service`).",
                     "items": {
                         "$ref": "ConfigFile"
                     },
                     "type": "array"
                 },
-                "options": {
-                    "$ref": "ConfigOptions",
-                    "description": "Options to cover use of source configuration within ServiceManager and\ntools"
-                },
                 "id": {
                     "description": "A unique ID for a specific instance of this message, typically assigned\nby the client for tracking purpose. If empty, the server may choose to\ngenerate one instead.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Method": {
             "description": "Method represents a method of an api.",
             "id": "Method",
@@ skipping 363 matching lines @@
                     },
                     "type": "array"
                 },
                 "message": {
                     "description": "A developer-facing error message, which should be in English. Any\nuser-facing error message should be localized and sent in the\ngoogle.rpc.Status.details field, or localized by the client.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
+        "Endpoint": {
+            "description": "`Endpoint` describes a network endpoint that serves a set of APIs.\nA service may expose any number of endpoints, and all endpoints share the\nsame service configuration, such as quota configuration and monitoring\nconfiguration.\n\nExample service configuration:\n\n    name: library-example.googleapis.com\n    endpoints:\n      # Below entry makes 'google.example.library.v1.Library'\n      # API be served from endpoint address library-example.googleapis.com.\n      # It also allows HTTP OPTIONS calls to be passed to the backend, for\n      # it to decide whether the subsequent cross-origin request is\n      # allowed to proceed.\n    - name: library-example.googleapis.com\n      apis: google.example.library.v1.Library\n      allow_cors: true\n      # Below entry makes 'google.example.library.v1.Library'\n      # API be served from endpoint address\n      # google.example.library-example.v1.LibraryManager.\n    - name: library-manager.googleapis.com\n      apis: google.example.library.v1.LibraryManager\n      # BNS address for a borg job. Can specify a task by appending\n      # \"/taskId\" (e.g. \"/0\") to the job spec.\n\nExample OpenAPI extension for endpoint with allow_cors set to true:\n\n    {\n      \"swagger\": \"2.0\",\n      \"info\": {\n        \"description\": \"A simple...\"\n      },\n      \"host\": \"MY_PROJECT_ID.appspot.com\",\n      \"x-google-endpoints\": [{\n        \"name\": \"MY_PROJECT_ID.appspot.com\",\n        \"allow_cors\": \"true\"\n      }]\n    }",
+            "id": "Endpoint",
+            "properties": {
+                "apis": {
+                    "description": "The list of APIs served by this endpoint.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
+                "allowCors": {
+                    "description": "Allowing\n[CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka\ncross-domain traffic, would allow the backends served from this endpoint to\nreceive and respond to HTTP OPTIONS requests. The response will be used by\nthe browser to determine whether the subsequent cross-origin request is\nallowed to proceed.",
+                    "type": "boolean"
+                },
+                "name": {
+                    "description": "The canonical name of this endpoint.",
+                    "type": "string"
+                },
+                "aliases": {
+                    "description": "DEPRECATED: This field is no longer supported. Instead of using aliases,\nplease specify multiple google.api.Endpoint for each of the intented\nalias.\n\nAdditional names that this endpoint will be hosted on.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
+                "features": {
+                    "description": "The list of features enabled on this endpoint.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
         "Page": {
             "description": "Represents a documentation page. A page can contain subpages to represent\nnested documentation set structure.",
             "id": "Page",
             "properties": {
                 "subpages": {
                     "description": "Subpages of this page. The order of subpages specified here will be\nhonored in the generated docset.",
                     "items": {
                         "$ref": "Page"
                     },
                     "type": "array"
@@ skipping 178 matching lines @@
         },
         "AuthenticationRule": {
             "description": "Authentication rules for the service.\n\nBy default, if a method has any authentication requirements, every request\nmust include a valid credential matching one of the requirements.\nIt's an error to include more than one kind of credential in a single\nrequest.\n\nIf a method doesn't have any auth requirements, request credentials will be\nignored.",
             "id": "AuthenticationRule",
             "properties": {
                 "oauth": {
                     "$ref": "OAuthRequirements",
                     "description": "The requirements for OAuth credentials."
                 },
                 "allowWithoutCredential": {
-                    "description": "Whether to allow requests without a credential.  If quota is enabled, an\nAPI key is required for such request to pass the quota check.",
+                    "description": "Whether to allow requests without a credential. The credential can be\nan OAuth token, Google cookies (first-party auth) or EndUserCreds.\n\nFor requests without credentials, if the service control environment is\nspecified, each incoming request **must** be associated with a service\nconsumer. This can be done by passing an API key that belongs to a consumer\nproject.",
                     "type": "boolean"
                 },
                 "requirements": {
                     "description": "Requirements for additional authentication providers.",
                     "items": {
                         "$ref": "AuthRequirement"
                     },
                     "type": "array"
                 },
                 "selector": {
@@ skipping 686 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "",
     "title": "Google Service Management API",
     "version": "v1"
 }