Api-roll 47: 2017-03-27

discovery/googleapis_beta/appengine__v1beta4.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": "\"tbys6C40o18GZwyMen5GMkdK-3s/WPOHGBs1fdHtwU9urrOWmhzm9OM\"",
+    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/Se7Ars-pJUGCXY_MujlPxE-KCds\"",
     "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:v1beta4",
     "kind": "discovery#restDescription",
     "name": "appengine",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 73 matching lines @@
             ],
             "location": "query",
             "type": "string"
         }
     },
     "protocol": "rest",
     "resources": {
         "apps": {
             "methods": {
                 "create": {
-                    "description": "Creates an App Engine application for a Google Cloud Platform project. This requires a project that excludes an App Engine application. For details about creating a project without an application, see the Google Cloud Resource Manager create project topic (https://cloud.google.com/resource-manager/docs/creating-project).",
+                    "description": "Creates an App Engine application for a Google Cloud Platform project. Required fields: id - The ID of the target Cloud Platform project. location - The region (https://cloud.google.com/appengine/docs/locations) where you want the App Engine application located.For more information about App Engine applications, see Managing Projects, Applications, and Billing (https://cloud.google.com/appengine/docs/python/console/).",
                     "httpMethod": "POST",
                     "id": "appengine.apps.create",
                     "path": "v1beta4/apps",
                     "request": {
                         "$ref": "Application"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
@@ skipping 258 matching lines @@
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 },
                                 "mask": {
                                     "description": "Standard field mask for the set of fields to be updated.",
                                     "location": "query",
                                     "type": "string"
                                 },
                                 "migrateTraffic": {
-                                    "description": "Set to true to gradually shift traffic from one version to another single version. By default, traffic is shifted immediately. For gradual traffic migration, the target version must be located within instances that are configured for both warmup requests (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#inboundservicetype) and automatic scaling (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#automaticscaling). You must specify the shardBy (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules#shardby) field in the Module resource. Gradual traffic migration is not supported in the App Engine flexible environment. For examples, see Migrating and Splitting Traffic (https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic).",
+                                    "description": "Set to true to gradually shift traffic to one or more versions that you specify. By default, traffic is shifted immediately. For gradual traffic migration, the target versions must be located within instances that are configured for both warmup requests (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#inboundservicetype) and automatic scaling (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#automaticscaling). You must specify the shardBy (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules#shardby) field in the Module resource. Gradual traffic migration is not supported in the App Engine flexible environment. For examples, see Migrating and Splitting Traffic (https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic).",
                                     "location": "query",
                                     "type": "boolean"
                                 }
                             },
                             "path": "v1beta4/apps/{appsId}/modules/{modulesId}",
                             "request": {
                                 "$ref": "Module"
                             },
                             "response": {
                                 "$ref": "Operation"
@@ skipping 309 matching lines @@
                                             "response": {
                                                 "$ref": "Instance"
                                             },
                                             "scopes": [
                                                 "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.",
+                                            "description": "Lists the instances of a version.Tip: To aggregate details about instances over time, see the Stackdriver Monitoring API (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list).",
                                             "httpMethod": "GET",
                                             "id": "appengine.apps.modules.versions.instances.list",
                                             "parameterOrder": [
                                                 "appsId",
                                                 "modulesId",
                                                 "versionsId"
                                             ],
                                             "parameters": {
                                                 "appsId": {
                                                     "description": "Part of `name`. Name of the resource requested. Example: apps/myapp/modules/default/versions/v1.",
@@ skipping 161 matching lines @@
                                 "https://www.googleapis.com/auth/appengine.admin",
                                 "https://www.googleapis.com/auth/cloud-platform",
                                 "https://www.googleapis.com/auth/cloud-platform.read-only"
                             ]
                         }
                     }
                 }
             }
         }
     },
-    "revision": "20161208",
+    "revision": "20170324",
     "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"
@@ skipping 104 matching lines @@
                     "description": "Cookie expiration policy for this application.",
                     "type": "string"
                 },
                 "defaultHostname": {
                     "description": "Hostname used to reach the application, as resolved by App Engine.@OutputOnly",
                     "type": "string"
                 },
                 "defaultBucket": {
                     "description": "Google Cloud Storage bucket that can be used by this application to store content.@OutputOnly",
                     "type": "string"
+                },
+                "iap": {
+                    "$ref": "IdentityAwareProxy"
                 }
             },
             "type": "object"
         },
         "UrlDispatchRule": {
             "description": "Rules to match an HTTP request and dispatch that request to a module.",
             "id": "UrlDispatchRule",
             "properties": {
                 "domain": {
                     "description": "Domain name to match against. The wildcard \"*\" is supported if specified before a period: \"*.\".Defaults to matching all domains: \"*\".",
                     "type": "string"
                 },
                 "path": {
                     "description": "Pathname within the host. Must start with a \"/\". A single \"*\" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters.",
                     "type": "string"
                 },
                 "module": {
                     "description": "Resource ID of a module in this application that should serve the matched request. The module must already exist. Example: default.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
+        "IdentityAwareProxy": {
+            "description": "Identity-Aware Proxy",
+            "id": "IdentityAwareProxy",
+            "properties": {
+                "enabled": {
+                    "description": "Whether the serving infrastructure will authenticate and authorize all incoming requests.If true, the oauth2_client_id and oauth2_client_secret fields must be non-empty.",
+                    "type": "boolean"
+                },
+                "oauth2ClientId": {
+                    "description": "OAuth2 client ID to use for the authentication flow.",
+                    "type": "string"
+                },
+                "oauth2ClientSecret": {
+                    "description": "For security reasons, this value cannot be retrieved via the API. Instead, the SHA-256 hash of the value is returned in the oauth2_client_secret_sha256 field.@InputOnly",
+                    "type": "string"
+                },
+                "oauth2ClientSecretSha256": {
+                    "description": "Hex-encoded SHA-256 hash of the client secret.@OutputOnly",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "Version": {
             "description": "A Version resource is a specific set of source code and configuration files that are deployed into a module.",
             "id": "Version",
             "properties": {
                 "name": {
                     "description": "Full path to the Version resource in the API. Example: apps/myapp/modules/default/versions/v1.@OutputOnly",
                     "type": "string"
                 },
                 "id": {
                     "description": "Relative name of the version within the module. Example: v1. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: \"default\", \"latest\", and any name with the prefix \"ah-\".",
@@ skipping 681 matching lines @@
             "properties": {
                 "files": {
                     "additionalProperties": {
                         "$ref": "FileInfo"
                     },
                     "description": "Manifest of the files stored in Google Cloud Storage that are included as part of this version. All files must be readable using the credentials supplied with this call.",
                     "type": "object"
                 },
                 "container": {
                     "$ref": "ContainerInfo",
-                    "description": "A Docker image that App Engine uses the run the version. Only applicable for instances in App Engine flexible environment."
+                    "description": "The Docker image for the container that runs the version. Only applicable for instances running in the App Engine flexible environment."
                 },
                 "sourceReferences": {
                     "description": "Origin of the source code for this deployment. There can be more than one source reference per version if source code is distributed among multiple repositories.",
                     "items": {
                         "$ref": "SourceReference"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
@@ skipping 11 matching lines @@
                     "type": "string"
                 },
                 "mimeType": {
                     "description": "The MIME type of the file.Defaults to the value from Google Cloud Storage.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ContainerInfo": {
-            "description": "Docker image that is used to start a VM container for the version you deploy.",
+            "description": "Docker image that is used to create a container and start a VM instance for the version that you deploy. Only applicable for instances running in the App Engine flexible environment.",
             "id": "ContainerInfo",
             "properties": {
                 "image": {
-                    "description": "URI to the hosted container image in a Docker repository. The URI must be fully qualified and include a tag or digest. Examples: \"gcr.io/my-project/image:tag\" or \"gcr.io/my-project/image@digest\"",
+                    "description": "URI to the hosted container image in Google Container Registry. The URI must be fully qualified and include a tag or digest. Examples: \"gcr.io/my-project/image:tag\" or \"gcr.io/my-project/image@digest\"",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "SourceReference": {
             "description": "Reference to a particular snapshot of the source tree used to build and deploy the application.",
             "id": "SourceReference",
             "properties": {
                 "repository": {
@@ skipping 190 matching lines @@
             "id": "DebugInstanceRequest",
             "properties": {
                 "sshKey": {
                     "description": "Public SSH key to add to the instance. Examples: [USERNAME]:ssh-rsa [KEY_VALUE] [USERNAME] [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.",
+            "description": "The response message for Locations.ListLocations.",
             "id": "ListLocationsResponse",
             "properties": {
                 "locations": {
                     "description": "A list of locations that matches the specified filter in the request.",
                     "items": {
                         "$ref": "Location"
                     },
                     "type": "array"
                 },
                 "nextPageToken": {
@@ skipping 111 matching lines @@
                     "description": "User who requested this operation.@OutputOnly",
                     "type": "string"
                 },
                 "target": {
                     "description": "Name of the resource that this operation is acting on. Example: apps/myapp/services/default.@OutputOnly",
                     "type": "string"
                 }
             },
             "type": "object"
         },
+        "OperationMetadataV1Beta": {
+            "description": "Metadata for the given google.longrunning.Operation.",
+            "id": "OperationMetadataV1Beta",
+            "properties": {
+                "method": {
+                    "description": "API method that initiated this operation. Example: google.appengine.v1beta.Versions.CreateVersion.@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/services/default.@OutputOnly",
+                    "type": "string"
+                },
+                "ephemeralMessage": {
+                    "description": "Ephemeral message that may change every time the operation is polled. @OutputOnly",
+                    "type": "string"
+                },
+                "warning": {
+                    "description": "Durable messages that persist on every operation poll. @OutputOnly",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
         "OperationMetadataV1": {
             "description": "Metadata for the given google.longrunning.Operation.",
             "id": "OperationMetadataV1",
             "properties": {
                 "method": {
                     "description": "API method that initiated this operation. Example: google.appengine.v1.Versions.CreateVersion.@OutputOnly",
                     "type": "string"
                 },
                 "insertTime": {
                     "description": "Time that this operation was created.@OutputOnly",
@@ skipping 38 matching lines @@
                     "type": "boolean"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "",
     "title": "Google App Engine Admin API",
     "version": "v1beta4"
 }