Api-roll 47: 2017-03-27

discovery/googleapis/appengine__v1.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/CydBYfZ8LICDy6eugptbrOxuOz0\"",
+    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/jvAB1N_FX7xzyPOdjzd58bQdWjQ\"",
     "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:v1",
     "kind": "discovery#restDescription",
     "name": "appengine",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 98 matching lines @@
                     "response": {
                         "$ref": "Application"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/appengine.admin",
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/cloud-platform.read-only"
                     ]
                 },
                 "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": "v1/apps",
                     "request": {
                         "$ref": "Application"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
                 },
                 "patch": {
-                    "description": "Updates the specified Application resource. You can update the following fields: auth_domain (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps#Application.FIELDS.auth_domain) default_cookie_expiration (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps#Application.FIELDS.default_cookie_expiration)",
+                    "description": "Updates the specified Application resource. You can update the following fields: auth_domain - Google authentication domain for controlling user access to the application. default_cookie_expiration - Cookie expiration policy for the application.",
                     "httpMethod": "PATCH",
                     "id": "appengine.apps.patch",
                     "parameterOrder": [
                         "appsId"
                     ],
                     "parameters": {
                         "appsId": {
                             "description": "Part of `name`. Name of the Application resource to update. Example: apps/myapp.",
                             "location": "path",
                             "required": true,
@@ skipping 211 matching lines @@
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 },
                                 "updateMask": {
                                     "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/v1/apps.services.versions#inboundservicetype) and automatic scaling (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#automaticscaling). You must specify the shardBy (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services#shardby) field in the Service 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/v1/apps.services.versions#inboundservicetype) and automatic scaling (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#automaticscaling). You must specify the shardBy (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services#shardby) field in the Service 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": "v1/apps/{appsId}/services/{servicesId}",
                             "request": {
                                 "$ref": "Service"
                             },
                             "response": {
                                 "$ref": "Operation"
@@ skipping 249 matching lines @@
                                     },
                                     "scopes": [
                                         "https://www.googleapis.com/auth/cloud-platform"
                                     ]
                                 }
                             },
                             "resources": {
                                 "instances": {
                                     "methods": {
                                         "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.services.versions.instances.list",
                                             "parameterOrder": [
                                                 "appsId",
                                                 "servicesId",
                                                 "versionsId"
                                             ],
                                             "parameters": {
                                                 "appsId": {
                                                     "description": "Part of `parent`. Name of the parent Version resource. Example: apps/myapp/services/default/versions/v1.",
@@ skipping 251 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 75 matching lines @@
             "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.",
                     "type": "string"
                 },
                 "dispatchRules": {
-                    "description": "HTTP path dispatch rules for requests to the application that do not explicitly target a service or version. Rules are order-dependent.@OutputOnly",
+                    "description": "HTTP path dispatch rules for requests to the application that do not explicitly target a service or version. Rules are order-dependent. Up to 20 dispatch rules can be supported.@OutputOnly",
                     "items": {
                         "$ref": "UrlDispatchRule"
                     },
                     "type": "array"
                 },
                 "authDomain": {
                     "description": "Google Apps authentication domain that controls which users can access this application.Defaults to open access for any Google Account.",
                     "type": "string"
                 },
                 "locationId": {
                     "description": "Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored.Defaults to us-central.Options are:us-central - Central USeurope-west - Western Europeus-east1 - Eastern US",
                     "type": "string"
                 },
                 "codeBucket": {
                     "description": "Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands.@OutputOnly",
                     "type": "string"
                 },
                 "defaultCookieExpiration": {
                     "description": "Cookie expiration policy for this application.",
                     "type": "string"
                 },
+                "servingStatus": {
+                    "description": "Serving status of this application.",
+                    "enum": [
+                        "UNSPECIFIED",
+                        "SERVING",
+                        "USER_DISABLED",
+                        "SYSTEM_DISABLED"
+                    ],
+                    "type": "string"
+                },
                 "defaultHostname": {
                     "description": "Hostname used to reach this 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"
+                },
+                "gcrDomain": {
+                    "description": "The Google Container Registry domain used for storing managed build docker images for this application.",
+                    "type": "string"
                 }
             },
             "type": "object"
         },
         "UrlDispatchRule": {
             "description": "Rules to match an HTTP request and dispatch that request to a service.",
             "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.",
+                    "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"
                 },
                 "service": {
                     "description": "Resource ID of a service in this application that should serve the matched request. The service 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": "OAuth2 client secret to use for the authentication flow.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"
+        },
         "RepairApplicationRequest": {
             "description": "Request message for 'Applications.RepairApplication'.",
             "id": "RepairApplicationRequest",
             "type": "object"
         },
         "ListServicesResponse": {
             "description": "Response message for Services.ListServices.",
             "id": "ListServicesResponse",
             "properties": {
                 "services": {
@@ skipping 31 matching lines @@
         },
         "TrafficSplit": {
             "description": "Traffic routing configuration for versions within a single service. Traffic splits define how traffic directed to the service is assigned to versions.",
             "id": "TrafficSplit",
             "properties": {
                 "shardBy": {
                     "description": "Mechanism used to determine which version a request is sent to. The traffic selection algorithm will be stable for either type until allocations are changed.",
                     "enum": [
                         "UNSPECIFIED",
                         "COOKIE",
-                        "IP"
+                        "IP",
+                        "RANDOM"
                     ],
                     "type": "string"
                 },
                 "allocations": {
                     "additionalProperties": {
                         "format": "double",
                         "type": "number"
                     },
                     "description": "Mapping from version IDs within the service to fractional (0.000, 1] allocations of traffic for that version. Each version can be specified only once, but some versions in the service may not have any traffic allocation. Services that have traffic allocated cannot be deleted until either the service is deleted or their traffic allocation is removed. Allocations must sum to 1. Up to two decimal place precision is supported for IP-based splits and up to three decimal places is supported for cookie-based splits.",
                     "type": "object"
@@ skipping 162 matching lines @@
                     "type": "object"
                 },
                 "defaultExpiration": {
                     "description": "Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding StaticFilesHandler (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler) does not specify its own expiration time.Only returned in GET requests if view=FULL is set.",
                     "type": "string"
                 },
                 "healthCheck": {
                     "$ref": "HealthCheck",
                     "description": "Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes.Only returned in GET requests if view=FULL is set."
                 },
+                "readinessCheck": {
+                    "$ref": "ReadinessCheck",
+                    "description": "Configures readiness health checking for VM instances. Unhealthy instances are not put into the backend traffic rotation.Only returned in GET requests if view=FULL is set."
+                },
+                "livenessCheck": {
+                    "$ref": "LivenessCheck",
+                    "description": "Configures liveness health checking for VM instances. Unhealthy instances are stopped and replaced with new instancesOnly returned in GET requests if view=FULL is set."
+                },
                 "nobuildFilesRegex": {
                     "description": "Files that match this pattern will not be built into this version. Only applicable for Go runtimes.Only returned in GET requests if view=FULL is set.",
                     "type": "string"
                 },
                 "deployment": {
                     "$ref": "Deployment",
                     "description": "Code and application artifacts that make up this version.Only returned in GET requests if view=FULL is set."
                 },
                 "versionUrl": {
                     "description": "Serving URL for this version. Example: \"https://myversion-dot-myservice-dot-myapp.appspot.com\"@OutputOnly",
@@ skipping 497 matching lines @@
                     "description": "Interval between health checks.",
                     "type": "string"
                 },
                 "timeout": {
                     "description": "Time before the health check is considered failed.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
+        "ReadinessCheck": {
+            "description": "Readiness checking configuration for VM instances. Unhealthy instances are removed from traffic rotation.",
+            "id": "ReadinessCheck",
+            "properties": {
+                "path": {
+                    "description": "The request path.",
+                    "type": "string"
+                },
+                "host": {
+                    "description": "Host header to send when performing a HTTP Readiness check. Example: \"myapp.appspot.com\"",
+                    "type": "string"
+                },
+                "failureThreshold": {
+                    "description": "Number of consecutive failed checks required before removing traffic.",
+                    "format": "uint32",
+                    "type": "integer"
+                },
+                "successThreshold": {
+                    "description": "Number of consecutive successful checks required before receiving traffic.",
+                    "format": "uint32",
+                    "type": "integer"
+                },
+                "checkInterval": {
+                    "description": "Interval between health checks.",
+                    "type": "string"
+                },
+                "timeout": {
+                    "description": "Time before the check is considered failed.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "LivenessCheck": {
+            "description": "Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances.",
+            "id": "LivenessCheck",
+            "properties": {
+                "path": {
+                    "description": "The request path.",
+                    "type": "string"
+                },
+                "host": {
+                    "description": "Host header to send when performing a HTTP Liveness check. Example: \"myapp.appspot.com\"",
+                    "type": "string"
+                },
+                "failureThreshold": {
+                    "description": "Number of consecutive failed checks required before considering the VM unhealthy.",
+                    "format": "uint32",
+                    "type": "integer"
+                },
+                "successThreshold": {
+                    "description": "Number of consecutive successful checks required before considering the VM healthy.",
+                    "format": "uint32",
+                    "type": "integer"
+                },
+                "checkInterval": {
+                    "description": "Interval between health checks.",
+                    "type": "string"
+                },
+                "timeout": {
+                    "description": "Time before the check is considered failed.",
+                    "type": "string"
+                },
+                "initialDelay": {
+                    "description": "The initial delay before starting to execute the checks.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "Deployment": {
             "description": "Code and application artifacts used to deploy a version to App Engine.",
             "id": "Deployment",
             "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 to 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."
                 },
                 "zip": {
                     "$ref": "ZipInfo",
                     "description": "The zip file for this deployment, if this is a zip deployment."
                 }
             },
             "type": "object"
         },
         "FileInfo": {
             "description": "Single source file that is part of the version to be deployed. Each source file that is deployed must be specified separately.",
             "id": "FileInfo",
             "properties": {
                 "sourceUrl": {
                     "description": "URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com//'.",
                     "type": "string"
                 },
                 "sha1Sum": {
                     "description": "The SHA1 hash of the file, in hex.",
                     "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"
         },
         "ZipInfo": {
             "description": "The zip file information for a zip deployment.",
             "id": "ZipInfo",
             "properties": {
                 "sourceUrl": {
@@ skipping 127 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": "v1"
 }