Api-roll 42: 2016-11-08

discovery/googleapis_beta/appengine__v1beta5.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
+                "https://www.googleapis.com/auth/appengine.admin": {
+                    "description": "View and manage your applications deployed on Google App Engine"
+                },
                 "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"
                 }
             }
         }
     },
     "basePath": "",
     "baseUrl": "https://appengine.googleapis.com/",
     "batchPath": "batch",
     "description": "Provisions and manages App Engine applications.",
     "discoveryVersion": "v1",
     "documentationLink": "https://cloud.google.com/appengine/docs/admin-api/",
-    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/WgHFQRJNa9ABhjOi9ooEWesv8kc\"",
+    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/bxm0Hg_anT2iVOk8OuVymCOFgn0\"",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "appengine:v1beta5",
     "kind": "discovery#restDescription",
     "name": "appengine",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 114 matching lines @@
                             "type": "boolean"
                         }
                     },
                     "path": "v1beta5/apps/{appsId}",
                     "response": {
                         "$ref": "Application"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
+                },
+                "patch": {
+                    "description": "Updates application fields.",
+                    "httpMethod": "PATCH",
+                    "id": "appengine.apps.patch",
+                    "parameterOrder": [
+                        "appsId"
+                    ],
+                    "parameters": {
+                        "appsId": {
+                            "description": "Part of `name`. Name of the application to update. Example: `apps/myapp`.",
+                            "location": "path",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "mask": {
+                            "description": "Standard field mask for the set of fields to be updated.",
+                            "location": "query",
+                            "type": "string"
+                        }
+                    },
+                    "path": "v1beta5/apps/{appsId}",
+                    "request": {
+                        "$ref": "Application"
+                    },
+                    "response": {
+                        "$ref": "Operation"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform"
+                    ]
                 }
             },
             "resources": {
                 "operations": {
                     "methods": {
-                        "get": {
-                            "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
-                            "httpMethod": "GET",
-                            "id": "appengine.apps.operations.get",
-                            "parameterOrder": [
-                                "appsId",
-                                "operationsId"
-                            ],
-                            "parameters": {
-                                "appsId": {
-                                    "description": "Part of `name`. The name of the operation resource.",
-                                    "location": "path",
-                                    "required": true,
-                                    "type": "string"
-                                },
-                                "operationsId": {
-                                    "description": "Part of `name`. See documentation of `appsId`.",
-                                    "location": "path",
-                                    "required": true,
-                                    "type": "string"
-                                }
-                            },
-                            "path": "v1beta5/apps/{appsId}/operations/{operationsId}",
-                            "response": {
-                                "$ref": "Operation"
-                            },
-                            "scopes": [
-                                "https://www.googleapis.com/auth/cloud-platform"
-                            ]
-                        },
                         "list": {
                             "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding below allows API services to override the binding to use different resource name schemes, such as `users/*/operations`.",
                             "httpMethod": "GET",
                             "id": "appengine.apps.operations.list",
                             "parameterOrder": [
                                 "appsId"
                             ],
                             "parameters": {
                                 "appsId": {
                                     "description": "Part of `name`. The name of the operation collection.",
@@ skipping 16 matching lines @@
                                     "description": "The standard list page token.",
                                     "location": "query",
                                     "type": "string"
                                 }
                             },
                             "path": "v1beta5/apps/{appsId}/operations",
                             "response": {
                                 "$ref": "ListOperationsResponse"
                             },
                             "scopes": [
-                                "https://www.googleapis.com/auth/cloud-platform"
+                                "https://www.googleapis.com/auth/appengine.admin",
+                                "https://www.googleapis.com/auth/cloud-platform",
+                                "https://www.googleapis.com/auth/cloud-platform.read-only"
+                            ]
+                        },
+                        "get": {
+                            "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
+                            "httpMethod": "GET",
+                            "id": "appengine.apps.operations.get",
+                            "parameterOrder": [
+                                "appsId",
+                                "operationsId"
+                            ],
+                            "parameters": {
+                                "appsId": {
+                                    "description": "Part of `name`. The name of the operation resource.",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                },
+                                "operationsId": {
+                                    "description": "Part of `name`. See documentation of `appsId`.",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v1beta5/apps/{appsId}/operations/{operationsId}",
+                            "response": {
+                                "$ref": "Operation"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/appengine.admin",
+                                "https://www.googleapis.com/auth/cloud-platform",
+                                "https://www.googleapis.com/auth/cloud-platform.read-only"
                             ]
                         }
                     }
                 },
                 "services": {
                     "methods": {
                         "delete": {
                             "description": "Deletes the specified service and all enclosed versions.",
                             "httpMethod": "DELETE",
                             "id": "appengine.apps.services.delete",
@@ skipping 43 matching lines @@
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "v1beta5/apps/{appsId}/services/{servicesId}",
                             "response": {
                                 "$ref": "Service"
                             },
                             "scopes": [
-                                "https://www.googleapis.com/auth/cloud-platform"
+                                "https://www.googleapis.com/auth/appengine.admin",
+                                "https://www.googleapis.com/auth/cloud-platform",
+                                "https://www.googleapis.com/auth/cloud-platform.read-only"
                             ]
                         },
                         "list": {
                             "description": "Lists all the services in the application.",
                             "httpMethod": "GET",
                             "id": "appengine.apps.services.list",
                             "parameterOrder": [
                                 "appsId"
                             ],
                             "parameters": {
@@ skipping 13 matching lines @@
                                     "description": "Continuation token for fetching the next page of results.",
                                     "location": "query",
                                     "type": "string"
                                 }
                             },
                             "path": "v1beta5/apps/{appsId}/services",
                             "response": {
                                 "$ref": "ListServicesResponse"
                             },
                             "scopes": [
-                                "https://www.googleapis.com/auth/cloud-platform"
+                                "https://www.googleapis.com/auth/appengine.admin",
+                                "https://www.googleapis.com/auth/cloud-platform",
+                                "https://www.googleapis.com/auth/cloud-platform.read-only"
                             ]
                         },
                         "patch": {
                             "description": "Updates the configuration of the specified service.",
                             "httpMethod": "PATCH",
                             "id": "appengine.apps.services.patch",
                             "parameterOrder": [
                                 "appsId",
                                 "servicesId"
                             ],
@@ skipping 142 matching lines @@
                                             ],
                                             "location": "query",
                                             "type": "string"
                                         }
                                     },
                                     "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}",
                                     "response": {
                                         "$ref": "Version"
                                     },
                                     "scopes": [
-                                        "https://www.googleapis.com/auth/cloud-platform"
+                                        "https://www.googleapis.com/auth/appengine.admin",
+                                        "https://www.googleapis.com/auth/cloud-platform",
+                                        "https://www.googleapis.com/auth/cloud-platform.read-only"
                                     ]
                                 },
                                 "list": {
                                     "description": "Lists the versions of a service.",
                                     "httpMethod": "GET",
                                     "id": "appengine.apps.services.versions.list",
                                     "parameterOrder": [
                                         "appsId",
                                         "servicesId"
                                     ],
@@ skipping 29 matching lines @@
                                             "description": "Continuation token for fetching the next page of results.",
                                             "location": "query",
                                             "type": "string"
                                         }
                                     },
                                     "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions",
                                     "response": {
                                         "$ref": "ListVersionsResponse"
                                     },
                                     "scopes": [
-                                        "https://www.googleapis.com/auth/cloud-platform"
+                                        "https://www.googleapis.com/auth/appengine.admin",
+                                        "https://www.googleapis.com/auth/cloud-platform",
+                                        "https://www.googleapis.com/auth/cloud-platform.read-only"
                                     ]
                                 },
                                 "patch": {
                                     "description": "Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses: * [`serving_status`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. * [`instance_class`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. * [`automatic_scaling.min_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. * [`automatic_scaling.max_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment.",
                                     "httpMethod": "PATCH",
                                     "id": "appengine.apps.services.versions.patch",
                                     "parameterOrder": [
                                         "appsId",
                                         "servicesId",
                                         "versionsId"
@@ skipping 116 matching lines @@
                                                     "location": "path",
                                                     "required": true,
                                                     "type": "string"
                                                 }
                                             },
                                             "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances/{instancesId}",
                                             "response": {
                                                 "$ref": "Instance"
                                             },
                                             "scopes": [
-                                                "https://www.googleapis.com/auth/cloud-platform"
+                                                "https://www.googleapis.com/auth/appengine.admin",
+                                                "https://www.googleapis.com/auth/cloud-platform",
+                                                "https://www.googleapis.com/auth/cloud-platform.read-only"
                                             ]
                                         },
                                         "list": {
                                             "description": "Lists the instances of a version.",
                                             "httpMethod": "GET",
                                             "id": "appengine.apps.services.versions.instances.list",
                                             "parameterOrder": [
                                                 "appsId",
                                                 "servicesId",
                                                 "versionsId"
@@ skipping 27 matching lines @@
                                                     "description": "Continuation token for fetching the next page of results.",
                                                     "location": "query",
                                                     "type": "string"
                                                 }
                                             },
                                             "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances",
                                             "response": {
                                                 "$ref": "ListInstancesResponse"
                                             },
                                             "scopes": [
-                                                "https://www.googleapis.com/auth/cloud-platform"
+                                                "https://www.googleapis.com/auth/appengine.admin",
+                                                "https://www.googleapis.com/auth/cloud-platform",
+                                                "https://www.googleapis.com/auth/cloud-platform.read-only"
                                             ]
                                         },
                                         "debug": {
                                             "description": "Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in \"debug mode\", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started. Only applicable for instances in App Engine flexible environment.",
                                             "httpMethod": "POST",
                                             "id": "appengine.apps.services.versions.instances.debug",
                                             "parameterOrder": [
                                                 "appsId",
                                                 "servicesId",
                                                 "versionsId",
@@ skipping 73 matching lines @@
                                     "description": "The standard list page token.",
                                     "location": "query",
                                     "type": "string"
                                 }
                             },
                             "path": "v1beta5/apps/{appsId}/locations",
                             "response": {
                                 "$ref": "ListLocationsResponse"
                             },
                             "scopes": [
-                                "https://www.googleapis.com/auth/cloud-platform"
+                                "https://www.googleapis.com/auth/appengine.admin",
+                                "https://www.googleapis.com/auth/cloud-platform",
+                                "https://www.googleapis.com/auth/cloud-platform.read-only"
                             ]
                         },
                         "get": {
                             "description": "Get information about a location.",
                             "httpMethod": "GET",
                             "id": "appengine.apps.locations.get",
                             "parameterOrder": [
                                 "appsId",
                                 "locationsId"
                             ],
                             "parameters": {
                                 "appsId": {
                                     "description": "Part of `name`. Resource name for the location.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 },
                                 "locationsId": {
                                     "description": "Part of `name`. See documentation of `appsId`.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "v1beta5/apps/{appsId}/locations/{locationsId}",
                             "response": {
                                 "$ref": "Location"
                             },
                             "scopes": [
-                                "https://www.googleapis.com/auth/cloud-platform"
+                                "https://www.googleapis.com/auth/appengine.admin",
+                                "https://www.googleapis.com/auth/cloud-platform",
+                                "https://www.googleapis.com/auth/cloud-platform.read-only"
                             ]
                         }
                     }
                 }
             }
         }
     },
-    "revision": "20160802",
+    "revision": "20161101",
     "rootUrl": "https://appengine.googleapis.com/",
     "schemas": {
+        "ListOperationsResponse": {
+            "description": "The response message for Operations.ListOperations.",
+            "id": "ListOperationsResponse",
+            "properties": {
+                "operations": {
+                    "description": "A list of operations that matches the specified filter in the request.",
+                    "items": {
+                        "$ref": "Operation"
+                    },
+                    "type": "array"
+                },
+                "nextPageToken": {
+                    "description": "The standard List next-page token.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "Operation": {
             "description": "This resource represents a long-running operation that is the result of a network API call.",
             "id": "Operation",
             "properties": {
                 "name": {
                     "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`.",
                     "type": "string"
                 },
                 "metadata": {
                     "additionalProperties": {
                         "description": "Properties of the object. Contains field @type with type URL.",
                         "type": "any"
                     },
                     "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.",
                     "type": "object"
                 },
                 "done": {
                     "description": "If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available.",
                     "type": "boolean"
                 },
                 "error": {
                     "$ref": "Status",
-                    "description": "The error result of the operation in case of failure."
+                    "description": "The error result of the operation in case of failure or cancellation."
                 },
                 "response": {
                     "additionalProperties": {
                         "description": "Properties of the object. Contains field @type with type URL.",
                         "type": "any"
                     },
                     "description": "The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.",
                     "type": "object"
                 }
             },
@@ skipping 19 matching lines @@
                             "description": "Properties of the object. Contains field @type with type URL.",
                             "type": "any"
                         },
                         "type": "object"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
-        "ListOperationsResponse": {
-            "description": "The response message for Operations.ListOperations.",
-            "id": "ListOperationsResponse",
-            "properties": {
-                "operations": {
-                    "description": "A list of operations that matches the specified filter in the request.",
-                    "items": {
-                        "$ref": "Operation"
-                    },
-                    "type": "array"
-                },
-                "nextPageToken": {
-                    "description": "The standard List next-page token.",
-                    "type": "string"
-                }
-            },
-            "type": "object"
-        },
         "Application": {
             "description": "An Application resource contains the top-level configuration of an App Engine application.",
             "id": "Application",
             "properties": {
                 "name": {
                     "description": "Full path to the Application resource in the API. Example: `apps/myapp`. @OutputOnly",
                     "type": "string"
                 },
                 "id": {
                     "description": "Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: `myapp`.",
@@ skipping 895 matching lines @@
                     "format": "int64",
                     "type": "string"
                 },
                 "vmStatus": {
                     "description": "Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly",
                     "type": "string"
                 },
                 "vmUnlocked": {
                     "description": "Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment. @OutputOnly",
                     "type": "boolean"
+                },
+                "vmIp": {
+                    "description": "The IP address of this instance. Only applicable for instances in App Engine flexible environment. @OutputOnly",
+                    "type": "string"
                 }
             },
             "type": "object"
         },
         "ListInstancesResponse": {
             "description": "Response message for `Instances.ListInstances`.",
             "id": "ListInstancesResponse",
             "properties": {
                 "instances": {
                     "description": "The instances belonging to the requested version.",
                     "items": {
                         "$ref": "Instance"
                     },
                     "type": "array"
                 },
                 "nextPageToken": {
                     "description": "Continuation token for fetching the next page of results.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DebugInstanceRequest": {
             "description": "Request message for `Instances.DebugInstance`.",
             "id": "DebugInstanceRequest",
+            "properties": {
+                "sshKey": {
+                    "description": "Public SSH key to add to the instance. Example: `[USERNAME]:ssh-rsa KEY_VALUE` or `[USERNAME]:ssh-rsa [KEY_VALUE] google-ssh {\"userName\":\"[USERNAME]\",\"expireOn\":\"[EXPIRE_TIME]\"}` For more information, see [Adding and Removing SSH Keys](https://cloud.google.com/compute/docs/instances/adding-removing-ssh-keys)",
+                    "type": "string"
+                }
+            },
             "type": "object"
         },
         "ListLocationsResponse": {
             "description": "The response message for LocationService.ListLocations.",
             "id": "ListLocationsResponse",
             "properties": {
                 "locations": {
                     "description": "A list of locations that matches the specified filter in the request.",
                     "items": {
                         "$ref": "Location"
                     },
                     "type": "array"
                 },
                 "nextPageToken": {
                     "description": "The standard List next-page token.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Location": {
             "description": "A resource that represents Google Cloud Platform location.",
             "id": "Location",
             "properties": {
                 "name": {
                     "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`",
                     "type": "string"
                 },
                 "locationId": {
-                    "description": "The cononical id for this location. For example: `\"us-east1\"`.",
+                    "description": "The canonical id for this location. For example: `\"us-east1\"`.",
                     "type": "string"
                 },
                 "labels": {
                     "additionalProperties": {
                         "type": "string"
                     },
                     "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}",
                     "type": "object"
                 },
                 "metadata": {
                     "additionalProperties": {
                         "description": "Properties of the object. Contains field @type with type URL.",
                         "type": "any"
                     },
                     "description": "Service-specific metadata. For example the available capacity at the given location.",
                     "type": "object"
                 }
             },
             "type": "object"
         },
+        "OperationMetadataExperimental": {
+            "description": "Metadata for the given google.longrunning.Operation.",
+            "id": "OperationMetadataExperimental",
+            "properties": {
+                "method": {
+                    "description": "API method that initiated this operation. Example: `google.appengine.experimental.CustomDomains.CreateCustomDomain`. @OutputOnly",
+                    "type": "string"
+                },
+                "insertTime": {
+                    "description": "Time that this operation was created. @OutputOnly",
+                    "type": "string"
+                },
+                "endTime": {
+                    "description": "Time that this operation completed. @OutputOnly",
+                    "type": "string"
+                },
+                "user": {
+                    "description": "User who requested this operation. @OutputOnly",
+                    "type": "string"
+                },
+                "target": {
+                    "description": "Name of the resource that this operation is acting on. Example: `apps/myapp/customDomains/example.com`. @OutputOnly",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "OperationMetadata": {
             "description": "Metadata for the given google.longrunning.Operation.",
             "id": "OperationMetadata",
             "properties": {
                 "operationType": {
                     "description": "Type of this operation. Deprecated, use method field instead. Example: \"create_version\". @OutputOnly",
                     "type": "string"
                 },
                 "insertTime": {
                     "description": "Timestamp that this operation was created. @OutputOnly",
@@ skipping 85 matching lines @@
                     "type": "boolean"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "",
     "title": "Google App Engine Admin API",
     "version": "v1beta5"
 }