google-apis-rs/google_appengine1_beta5_cli/build_html/search/search_index.json

{"config":{"indexing":"full","lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"The appengine1-beta5 command-line interface (CLI) allows to use most features of the Google appengine service from the comfort of your terminal. By default all output is printed to standard out, but flags can be set to direct it into a file independent of your shell's capabilities. Errors will be printed to standard error, and cause the program's exit code to be non-zero. If data-structures are requested, these will be returned as pretty-printed JSON, to be useful as input to other tools. Everything else about the appengine API can be found at the official documentation site . Installation and Source Code Install the command-line interface with cargo using: cargo install google-appengine1_beta5-cli Find the source code on github . Usage This documentation was generated from the appengine API at revision 20181005 . The CLI is at version 5.0.4 . appengine1-beta5 [options] apps create (-r <kv>)... [-p <v>]... [-o <out>] get <apps-id> [-p <v>]... [-o <out>] locations-get <apps-id> <locations-id> [-p <v>]... [-o <out>] locations-list <apps-id> [-p <v>]... [-o <out>] operations-get <apps-id> <operations-id> [-p <v>]... [-o <out>] operations-list <apps-id> [-p <v>]... [-o <out>] patch <apps-id> (-r <kv>)... [-p <v>]... [-o <out>] services-delete <apps-id> <services-id> [-p <v>]... [-o <out>] services-get <apps-id> <services-id> [-p <v>]... [-o <out>] services-list <apps-id> [-p <v>]... [-o <out>] services-patch <apps-id> <services-id> (-r <kv>)... [-p <v>]... [-o <out>] services-versions-create <apps-id> <services-id> (-r <kv>)... [-p <v>]... [-o <out>] services-versions-delete <apps-id> <services-id> <versions-id> [-p <v>]... [-o <out>] services-versions-get <apps-id> <services-id> <versions-id> [-p <v>]... [-o <out>] services-versions-instances-debug <apps-id> <services-id> <versions-id> <instances-id> (-r <kv>)... [-p <v>]... [-o <out>] services-versions-instances-delete <apps-id> <services-id> <versions-id> <instances-id> [-p <v>]... [-o <out>] services-versions-instances-get <apps-id> <services-id> <versions-id> <instances-id> [-p <v>]... [-o <out>] services-versions-instances-list <apps-id> <services-id> <versions-id> [-p <v>]... [-o <out>] services-versions-list <apps-id> <services-id> [-p <v>]... [-o <out>] services-versions-patch <apps-id> <services-id> <versions-id> (-r <kv>)... [-p <v>]... [-o <out>] appengine1-beta5 --help Configuration: [--scope <url>]... Specify the authentication a method should be executed in. Each scope requires the user to grant this application permission to use it. If unset, it defaults to the shortest scope url for a particular method. --config-dir <folder> A directory into which we will store our persistent data. Defaults to a user-writable directory that we will create during the first invocation. [default: ~/.google-service-cli] Configuration The program will store all persistent data in the ~/.google-service-cli directory in JSON files prefixed with appengine1-beta5- . You can change the directory used to store configuration with the --config-dir flag on a per-invocation basis. More information about the various kinds of persistent data are given in the following paragraphs. Authentication Most APIs require a user to authenticate any request. If this is the case, the scope determines the set of permissions granted. The granularity of these is usually no more than read-only or full-access . If not set, the system will automatically select the smallest feasible scope, e.g. when invoking a method that is read-only, it will ask only for a read-only scope. You may use the --scope flag to specify a scope directly. All applicable scopes are documented in the respective method's CLI documentation. The first time a scope is used, the user is asked for permission. Follow the instructions given by the CLI to grant permissions, or to decline. If a scope was authenticated by the user, the respective information will be stored as JSON in the configuration directory, e.g. ~/.google-service-cli/appengine1-beta5-token-<scope-hash>.json . No manual management of these tokens is necessary. To revoke granted authentication, please refer to the official documentation . Application Secrets In order to allow any application to use Google services, it will need to be registered using the Google Developer Console . APIs the application may use are then enabled for it one by one. Most APIs can be used for free and have a daily quota. To allow more comfortable usage of the CLI without forcing anyone to register an own application, the CLI comes with a default application secret that is configured accordingly. This also means that heavy usage all around the world may deplete the daily quota. You can workaround this limitation by putting your own secrets file at this location: ~/.google-service-cli/appengine1-beta5-secret.json , assuming that the required appengine API was enabled for it. Such a secret file can be downloaded in the Google Developer Console at APIs & auth -> Credentials -> Download JSON and used as is. Learn more about how to setup Google projects and enable APIs using the official documentation . Debugging Even though the CLI does its best to provide usable error messages, sometimes it might be desirable to know what exactly led to a particular issue. This is done by allowing all client-server communication to be output to standard error as-is . The --debug flag will print errors using the Debug representation to standard error. You may consider redirecting standard error into a file for ease of use, e.g. appengine1-beta5 --debug <resource> <method> [options] 2>debug.txt .","title":"Home"},{"location":"#installation-and-source-code","text":"Install the command-line interface with cargo using: cargo install google-appengine1_beta5-cli Find the source code on github .","title":"Installation and Source Code"},{"location":"#usage","text":"This documentation was generated from the appengine API at revision 20181005 . The CLI is at version 5.0.4 . appengine1-beta5 [options] apps create (-r <kv>)... [-p <v>]... [-o <out>] get <apps-id> [-p <v>]... [-o <out>] locations-get <apps-id> <locations-id> [-p <v>]... [-o <out>] locations-list <apps-id> [-p <v>]... [-o <out>] operations-get <apps-id> <operations-id> [-p <v>]... [-o <out>] operations-list <apps-id> [-p <v>]... [-o <out>] patch <apps-id> (-r <kv>)... [-p <v>]... [-o <out>] services-delete <apps-id> <services-id> [-p <v>]... [-o <out>] services-get <apps-id> <services-id> [-p <v>]... [-o <out>] services-list <apps-id> [-p <v>]... [-o <out>] services-patch <apps-id> <services-id> (-r <kv>)... [-p <v>]... [-o <out>] services-versions-create <apps-id> <services-id> (-r <kv>)... [-p <v>]... [-o <out>] services-versions-delete <apps-id> <services-id> <versions-id> [-p <v>]... [-o <out>] services-versions-get <apps-id> <services-id> <versions-id> [-p <v>]... [-o <out>] services-versions-instances-debug <apps-id> <services-id> <versions-id> <instances-id> (-r <kv>)... [-p <v>]... [-o <out>] services-versions-instances-delete <apps-id> <services-id> <versions-id> <instances-id> [-p <v>]... [-o <out>] services-versions-instances-get <apps-id> <services-id> <versions-id> <instances-id> [-p <v>]... [-o <out>] services-versions-instances-list <apps-id> <services-id> <versions-id> [-p <v>]... [-o <out>] services-versions-list <apps-id> <services-id> [-p <v>]... [-o <out>] services-versions-patch <apps-id> <services-id> <versions-id> (-r <kv>)... [-p <v>]... [-o <out>] appengine1-beta5 --help Configuration: [--scope <url>]... Specify the authentication a method should be executed in. Each scope requires the user to grant this application permission to use it. If unset, it defaults to the shortest scope url for a particular method. --config-dir <folder> A directory into which we will store our persistent data. Defaults to a user-writable directory that we will create during the first invocation. [default: ~/.google-service-cli]","title":"Usage"},{"location":"#configuration","text":"The program will store all persistent data in the ~/.google-service-cli directory in JSON files prefixed with appengine1-beta5- . You can change the directory used to store configuration with the --config-dir flag on a per-invocation basis. More information about the various kinds of persistent data are given in the following paragraphs.","title":"Configuration"},{"location":"#authentication","text":"Most APIs require a user to authenticate any request. If this is the case, the scope determines the set of permissions granted. The granularity of these is usually no more than read-only or full-access . If not set, the system will automatically select the smallest feasible scope, e.g. when invoking a method that is read-only, it will ask only for a read-only scope. You may use the --scope flag to specify a scope directly. All applicable scopes are documented in the respective method's CLI documentation. The first time a scope is used, the user is asked for permission. Follow the instructions given by the CLI to grant permissions, or to decline. If a scope was authenticated by the user, the respective information will be stored as JSON in the configuration directory, e.g. ~/.google-service-cli/appengine1-beta5-token-<scope-hash>.json . No manual management of these tokens is necessary. To revoke granted authentication, please refer to the official documentation .","title":"Authentication"},{"location":"#application-secrets","text":"In order to allow any application to use Google services, it will need to be registered using the Google Developer Console . APIs the application may use are then enabled for it one by one. Most APIs can be used for free and have a daily quota. To allow more comfortable usage of the CLI without forcing anyone to register an own application, the CLI comes with a default application secret that is configured accordingly. This also means that heavy usage all around the world may deplete the daily quota. You can workaround this limitation by putting your own secrets file at this location: ~/.google-service-cli/appengine1-beta5-secret.json , assuming that the required appengine API was enabled for it. Such a secret file can be downloaded in the Google Developer Console at APIs & auth -> Credentials -> Download JSON and used as is. Learn more about how to setup Google projects and enable APIs using the official documentation .","title":"Application Secrets"},{"location":"#debugging","text":"Even though the CLI does its best to provide usable error messages, sometimes it might be desirable to know what exactly led to a particular issue. This is done by allowing all client-server communication to be output to standard error as-is . The --debug flag will print errors using the Debug representation to standard error. You may consider redirecting standard error into a file for ease of use, e.g. appengine1-beta5 --debug <resource> <method> [options] 2>debug.txt .","title":"Debugging"},{"location":"apps_create/","text":"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/). Scopes You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps create ... Required Request Value The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure. In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely. For example, a structure like this: Application: auth-domain: string code-bucket: string default-bucket: string default-cookie-expiration: string default-hostname: string iap: enabled: boolean oauth2-client-id: string oauth2-client-secret: string oauth2-client-secret-sha256: string id: string location: string name: string can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time. -r . auth-domain=et Google Apps authentication domain that controls which users can access this application.Defaults to open access for any Google Account. code-bucket=magna A 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 default-bucket=no A Google Cloud Storage bucket that can be used by the application to store content.@OutputOnly default-cookie-expiration=ipsum Cookie expiration policy for this application. default-hostname=voluptua. Hostname used to reach the application, as resolved by App Engine.@OutputOnly iap enabled=false 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. oauth2-client-id=amet. OAuth2 client ID to use for the authentication flow. oauth2-client-secret=takimata 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 oauth2-client-secret-sha256=amet. Hex-encoded SHA-256 hash of the client secret.@OutputOnly .. id=duo 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. location=ipsum 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 name=gubergren Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly About Cursors The cursor position is key to comfortably set complex nested structures. The following rules apply: The cursor position is always set relative to the current one, unless the field name starts with the . character. Fields can be nested such as in -r f.s.o . The cursor position is set relative to the top-level structure if it starts with . , e.g. -r .s.s You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify -r struct.sub_struct=bar . You can move the cursor one level up by using .. . Each additional . moves it up one additional level. E.g. ... would go three levels up. Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Create"},{"location":"apps_create/#scopes","text":"You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps create ...","title":"Scopes"},{"location":"apps_create/#required-request-value","text":"The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure. In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely. For example, a structure like this: Application: auth-domain: string code-bucket: string default-bucket: string default-cookie-expiration: string default-hostname: string iap: enabled: boolean oauth2-client-id: string oauth2-client-secret: string oauth2-client-secret-sha256: string id: string location: string name: string can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time. -r . auth-domain=et Google Apps authentication domain that controls which users can access this application.Defaults to open access for any Google Account. code-bucket=magna A 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 default-bucket=no A Google Cloud Storage bucket that can be used by the application to store content.@OutputOnly default-cookie-expiration=ipsum Cookie expiration policy for this application. default-hostname=voluptua. Hostname used to reach the application, as resolved by App Engine.@OutputOnly iap enabled=false 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. oauth2-client-id=amet. OAuth2 client ID to use for the authentication flow. oauth2-client-secret=takimata 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 oauth2-client-secret-sha256=amet. Hex-encoded SHA-256 hash of the client secret.@OutputOnly .. id=duo 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. location=ipsum 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 name=gubergren Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly","title":"Required Request Value"},{"location":"apps_create/#about-cursors","text":"The cursor position is key to comfortably set complex nested structures. The following rules apply: The cursor position is always set relative to the current one, unless the field name starts with the . character. Fields can be nested such as in -r f.s.o . The cursor position is set relative to the top-level structure if it starts with . , e.g. -r .s.s You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify -r struct.sub_struct=bar . You can move the cursor one level up by using .. . Each additional . moves it up one additional level. E.g. ... would go three levels up.","title":"About Cursors"},{"location":"apps_create/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_create/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_get/","text":"Gets information about an application. Scopes You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps get ... Required Scalar Argument <apps-id> (string) Part of name . Name of the application to get. Example: apps/myapp. Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional Method Properties You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p ensure-resources-exist=boolean Certain resources associated with an application are created on-demand. Controls whether these resources should be created when performing the GET operation. If specified and any resources could not be created, the request will fail with an error code. Additionally, this parameter can cause the request to take longer to complete. Note: This parameter will be deprecated in a future version of the API. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Get"},{"location":"apps_get/#scopes","text":"You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps get ...","title":"Scopes"},{"location":"apps_get/#required-scalar-argument","text":"<apps-id> (string) Part of name . Name of the application to get. Example: apps/myapp.","title":"Required Scalar Argument"},{"location":"apps_get/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_get/#optional-method-properties","text":"You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p ensure-resources-exist=boolean Certain resources associated with an application are created on-demand. Controls whether these resources should be created when performing the GET operation. If specified and any resources could not be created, the request will fail with an error code. Additionally, this parameter can cause the request to take longer to complete. Note: This parameter will be deprecated in a future version of the API.","title":"Optional Method Properties"},{"location":"apps_get/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_locations-get/","text":"Gets information about a location. Scopes You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps locations-get ... Required Scalar Arguments <apps-id> (string) Part of name . Resource name for the location. <locations-id> (string) Part of name . See documentation of appsId . Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Locations Get"},{"location":"apps_locations-get/#scopes","text":"You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps locations-get ...","title":"Scopes"},{"location":"apps_locations-get/#required-scalar-arguments","text":"<apps-id> (string) Part of name . Resource name for the location. <locations-id> (string) Part of name . See documentation of appsId .","title":"Required Scalar Arguments"},{"location":"apps_locations-get/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_locations-get/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_locations-list/","text":"Lists information about the supported locations for this service. Scopes You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps locations-list ... Required Scalar Argument <apps-id> (string) Part of name . The resource that owns the locations collection, if applicable. Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional Method Properties You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p filter=string The standard list filter. -p page-size=integer The standard list page size. -p page-token=string The standard list page token. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Locations List"},{"location":"apps_locations-list/#scopes","text":"You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps locations-list ...","title":"Scopes"},{"location":"apps_locations-list/#required-scalar-argument","text":"<apps-id> (string) Part of name . The resource that owns the locations collection, if applicable.","title":"Required Scalar Argument"},{"location":"apps_locations-list/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_locations-list/#optional-method-properties","text":"You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p filter=string The standard list filter. -p page-size=integer The standard list page size. -p page-token=string The standard list page token.","title":"Optional Method Properties"},{"location":"apps_locations-list/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_operations-get/","text":"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. Scopes You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps operations-get ... Required Scalar Arguments <apps-id> (string) Part of name . The name of the operation resource. <operations-id> (string) Part of name . See documentation of appsId . Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Operations Get"},{"location":"apps_operations-get/#scopes","text":"You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps operations-get ...","title":"Scopes"},{"location":"apps_operations-get/#required-scalar-arguments","text":"<apps-id> (string) Part of name . The name of the operation resource. <operations-id> (string) Part of name . See documentation of appsId .","title":"Required Scalar Arguments"},{"location":"apps_operations-get/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_operations-get/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_operations-list/","text":"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 allows API services to override the binding to use different resource name schemes, such as users/ /operations. To override the binding, API services can add a binding such as \"/v1/{name=users/ }/operations\" to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id. Scopes You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps operations-list ... Required Scalar Argument <apps-id> (string) Part of name . The name of the operation's parent resource. Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional Method Properties You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p filter=string The standard list filter. -p page-size=integer The standard list page size. -p page-token=string The standard list page token. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Operations List"},{"location":"apps_operations-list/#scopes","text":"You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps operations-list ...","title":"Scopes"},{"location":"apps_operations-list/#required-scalar-argument","text":"<apps-id> (string) Part of name . The name of the operation's parent resource.","title":"Required Scalar Argument"},{"location":"apps_operations-list/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_operations-list/#optional-method-properties","text":"You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p filter=string The standard list filter. -p page-size=integer The standard list page size. -p page-token=string The standard list page token.","title":"Optional Method Properties"},{"location":"apps_operations-list/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_patch/","text":"Updates the specified Application resource. You can update the following fields: auth_domain (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps#Application.FIELDS.auth_domain) default_cookie_expiration (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps#Application.FIELDS.default_cookie_expiration) Scopes You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps patch ... Required Scalar Argument <apps-id> (string) Part of name . Name of the Application resource to update. Example: apps/myapp. Required Request Value The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure. In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely. For example, a structure like this: Application: auth-domain: string code-bucket: string default-bucket: string default-cookie-expiration: string default-hostname: string iap: enabled: boolean oauth2-client-id: string oauth2-client-secret: string oauth2-client-secret-sha256: string id: string location: string name: string can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time. -r . auth-domain=lorem Google Apps authentication domain that controls which users can access this application.Defaults to open access for any Google Account. code-bucket=gubergren A 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 default-bucket=eos A Google Cloud Storage bucket that can be used by the application to store content.@OutputOnly default-cookie-expiration=dolor Cookie expiration policy for this application. default-hostname=ea Hostname used to reach the application, as resolved by App Engine.@OutputOnly iap enabled=true 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. oauth2-client-id=invidunt OAuth2 client ID to use for the authentication flow. oauth2-client-secret=amet 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 oauth2-client-secret-sha256=duo Hex-encoded SHA-256 hash of the client secret.@OutputOnly .. id=ipsum 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. location=sed 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 name=ut Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly About Cursors The cursor position is key to comfortably set complex nested structures. The following rules apply: The cursor position is always set relative to the current one, unless the field name starts with the . character. Fields can be nested such as in -r f.s.o . The cursor position is set relative to the top-level structure if it starts with . , e.g. -r .s.s You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify -r struct.sub_struct=bar . You can move the cursor one level up by using .. . Each additional . moves it up one additional level. E.g. ... would go three levels up. Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional Method Properties You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p mask=string Standard field mask for the set of fields to be updated. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Patch"},{"location":"apps_patch/#scopes","text":"You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps patch ...","title":"Scopes"},{"location":"apps_patch/#required-scalar-argument","text":"<apps-id> (string) Part of name . Name of the Application resource to update. Example: apps/myapp.","title":"Required Scalar Argument"},{"location":"apps_patch/#required-request-value","text":"The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure. In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely. For example, a structure like this: Application: auth-domain: string code-bucket: string default-bucket: string default-cookie-expiration: string default-hostname: string iap: enabled: boolean oauth2-client-id: string oauth2-client-secret: string oauth2-client-secret-sha256: string id: string location: string name: string can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time. -r . auth-domain=lorem Google Apps authentication domain that controls which users can access this application.Defaults to open access for any Google Account. code-bucket=gubergren A 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 default-bucket=eos A Google Cloud Storage bucket that can be used by the application to store content.@OutputOnly default-cookie-expiration=dolor Cookie expiration policy for this application. default-hostname=ea Hostname used to reach the application, as resolved by App Engine.@OutputOnly iap enabled=true 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. oauth2-client-id=invidunt OAuth2 client ID to use for the authentication flow. oauth2-client-secret=amet 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 oauth2-client-secret-sha256=duo Hex-encoded SHA-256 hash of the client secret.@OutputOnly .. id=ipsum 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. location=sed 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 name=ut Full path to the Application resource in the API. Example: apps/myapp.@OutputOnly","title":"Required Request Value"},{"location":"apps_patch/#about-cursors","text":"The cursor position is key to comfortably set complex nested structures. The following rules apply: The cursor position is always set relative to the current one, unless the field name starts with the . character. Fields can be nested such as in -r f.s.o . The cursor position is set relative to the top-level structure if it starts with . , e.g. -r .s.s You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify -r struct.sub_struct=bar . You can move the cursor one level up by using .. . Each additional . moves it up one additional level. E.g. ... would go three levels up.","title":"About Cursors"},{"location":"apps_patch/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_patch/#optional-method-properties","text":"You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p mask=string Standard field mask for the set of fields to be updated.","title":"Optional Method Properties"},{"location":"apps_patch/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_services-delete/","text":"Deletes the specified service and all enclosed versions. Scopes You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-delete ... Required Scalar Arguments <apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp/services/default. <services-id> (string) Part of name . See documentation of appsId . Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Services Delete"},{"location":"apps_services-delete/#scopes","text":"You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-delete ...","title":"Scopes"},{"location":"apps_services-delete/#required-scalar-arguments","text":"<apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp/services/default. <services-id> (string) Part of name . See documentation of appsId .","title":"Required Scalar Arguments"},{"location":"apps_services-delete/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_services-delete/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_services-get/","text":"Gets the current configuration of the specified service. Scopes You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-get ... Required Scalar Arguments <apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp/services/default. <services-id> (string) Part of name . See documentation of appsId . Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Services Get"},{"location":"apps_services-get/#scopes","text":"You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-get ...","title":"Scopes"},{"location":"apps_services-get/#required-scalar-arguments","text":"<apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp/services/default. <services-id> (string) Part of name . See documentation of appsId .","title":"Required Scalar Arguments"},{"location":"apps_services-get/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_services-get/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_services-list/","text":"Lists all the services in the application. Scopes You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-list ... Required Scalar Argument <apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp. Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional Method Properties You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p page-size=integer Maximum results to return per page. -p page-token=string Continuation token for fetching the next page of results. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Services List"},{"location":"apps_services-list/#scopes","text":"You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-list ...","title":"Scopes"},{"location":"apps_services-list/#required-scalar-argument","text":"<apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp.","title":"Required Scalar Argument"},{"location":"apps_services-list/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_services-list/#optional-method-properties","text":"You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p page-size=integer Maximum results to return per page. -p page-token=string Continuation token for fetching the next page of results.","title":"Optional Method Properties"},{"location":"apps_services-list/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_services-patch/","text":"Updates the configuration of the specified service. Scopes You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-patch ... Required Scalar Arguments <apps-id> (string) Part of name . Name of the resource to update. Example: apps/myapp/services/default. <services-id> (string) Part of name . See documentation of appsId . Required Request Value The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure. In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely. For example, a structure like this: Service: id: string name: string split: allocations: { string: number } shard-by: string can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time. -r . id=gubergren Relative name of the service within the application. Example: default.@OutputOnly name=rebum. Full path to the Service resource in the API. Example: apps/myapp/services/default.@OutputOnly split allocations=key=0.34810194289930996 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. the value will be associated with the given key shard-by=ipsum 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. About Cursors The cursor position is key to comfortably set complex nested structures. The following rules apply: The cursor position is always set relative to the current one, unless the field name starts with the . character. Fields can be nested such as in -r f.s.o . The cursor position is set relative to the top-level structure if it starts with . , e.g. -r .s.s You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify -r struct.sub_struct=bar . You can move the cursor one level up by using .. . Each additional . moves it up one additional level. E.g. ... would go three levels up. Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional Method Properties You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p mask=string Standard field mask for the set of fields to be updated. -p migrate-traffic=boolean 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/v1beta5/apps.services.versions#inboundservicetype) and automatic scaling (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#automaticscaling). You must specify the shardBy (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/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). Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Services Patch"},{"location":"apps_services-patch/#scopes","text":"You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-patch ...","title":"Scopes"},{"location":"apps_services-patch/#required-scalar-arguments","text":"<apps-id> (string) Part of name . Name of the resource to update. Example: apps/myapp/services/default. <services-id> (string) Part of name . See documentation of appsId .","title":"Required Scalar Arguments"},{"location":"apps_services-patch/#required-request-value","text":"The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure. In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely. For example, a structure like this: Service: id: string name: string split: allocations: { string: number } shard-by: string can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time. -r . id=gubergren Relative name of the service within the application. Example: default.@OutputOnly name=rebum. Full path to the Service resource in the API. Example: apps/myapp/services/default.@OutputOnly split allocations=key=0.34810194289930996 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. the value will be associated with the given key shard-by=ipsum 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.","title":"Required Request Value"},{"location":"apps_services-patch/#about-cursors","text":"The cursor position is key to comfortably set complex nested structures. The following rules apply: The cursor position is always set relative to the current one, unless the field name starts with the . character. Fields can be nested such as in -r f.s.o . The cursor position is set relative to the top-level structure if it starts with . , e.g. -r .s.s You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify -r struct.sub_struct=bar . You can move the cursor one level up by using .. . Each additional . moves it up one additional level. E.g. ... would go three levels up.","title":"About Cursors"},{"location":"apps_services-patch/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_services-patch/#optional-method-properties","text":"You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p mask=string Standard field mask for the set of fields to be updated. -p migrate-traffic=boolean 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/v1beta5/apps.services.versions#inboundservicetype) and automatic scaling (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#automaticscaling). You must specify the shardBy (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/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).","title":"Optional Method Properties"},{"location":"apps_services-patch/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_services-versions-create/","text":"Deploys new code and resource files to a new version. Scopes You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-create ... Required Scalar Arguments <apps-id> (string) Part of name . Name of the resource to update. For example: \"apps/myapp/services/default\". <services-id> (string) Part of name . See documentation of appsId . Required Request Value The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure. In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely. For example, a structure like this: Version: api-config: auth-fail-action: string login: string script: string security-level: string url: string automatic-scaling: cool-down-period: string cpu-utilization: aggregation-window-length: string target-utilization: number disk-utilization: target-read-bytes-per-sec: integer target-read-ops-per-sec: integer target-write-bytes-per-sec: integer target-write-ops-per-sec: integer max-concurrent-requests: integer max-idle-instances: integer max-pending-latency: string max-total-instances: integer min-idle-instances: integer min-pending-latency: string min-total-instances: integer network-utilization: target-received-bytes-per-sec: integer target-received-packets-per-sec: integer target-sent-bytes-per-sec: integer target-sent-packets-per-sec: integer request-utilization: target-concurrent-requests: integer target-request-count-per-sec: integer basic-scaling: idle-timeout: string max-instances: integer beta-settings: { string: string } creation-time: string default-expiration: string deployer: string deployment: container: image: string disk-usage-bytes: string endpoints-api-service: config-id: string disable-trace-sampling: boolean name: string rollout-strategy: string env: string env-variables: { string: string } health-check: check-interval: string disable-health-check: boolean healthy-threshold: integer host: string restart-threshold: integer timeout: string unhealthy-threshold: integer id: string inbound-services: [string] instance-class: string manual-scaling: instances: integer name: string network: forwarded-ports: [string] instance-tag: string name: string subnetwork-name: string nobuild-files-regex: string resources: cpu: number disk-gb: number memory-gb: number runtime: string runtime-api-version: string serving-status: string threadsafe: boolean vm: boolean can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time. -r .api-config auth-fail-action=ipsum Action to take when users access resources that require authentication. Defaults to redirect. login=est Level of login required to access this resource. Defaults to optional. script=gubergren Path to the script from the application root directory. security-level=ea Security (HTTPS) enforcement for this URL. url=dolor URL to serve the endpoint at. ..automatic-scaling cool-down-period=lorem The time period that the Autoscaler (https://cloud.google.com/compute/docs/autoscaler/) should wait before it starts collecting information from a new instance. This prevents the autoscaler from collecting information when the instance is initializing, during which the collected usage would not be reliable. Only applicable in the App Engine flexible environment. cpu-utilization aggregation-window-length=eos Period of time over which CPU utilization is calculated. target-utilization=0.11853734747270994 Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1. ..disk-utilization target-read-bytes-per-sec=31 Target bytes read per second. target-read-ops-per-sec=21 Target ops read per second. target-write-bytes-per-sec=40 Target bytes written per second. target-write-ops-per-sec=86 Target ops written per second. .. max-concurrent-requests=88 Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.Defaults to a runtime-specific value. max-idle-instances=77 Maximum number of idle instances that should be maintained for this version. max-pending-latency=sed Maximum amount of time that a request should wait in the pending queue before starting a new instance to handle it. max-total-instances=77 Maximum number of instances that should be started to handle requests. min-idle-instances=33 Minimum number of idle instances that should be maintained for this version. Only applicable for the default version of a module. min-pending-latency=vero Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it. min-total-instances=70 Minimum number of instances that should be maintained for this version. network-utilization target-received-bytes-per-sec=8 Target bytes received per second. target-received-packets-per-sec=81 Target packets received per second. target-sent-bytes-per-sec=67 Target bytes sent per second. target-sent-packets-per-sec=79 Target packets sent per second. ..request-utilization target-concurrent-requests=73 Target number of concurrent requests. target-request-count-per-sec=99 Target requests per second. ...basic-scaling idle-timeout=consetetur Duration of time after the last request that an instance must wait before the instance is shut down. max-instances=9 Maximum number of instances to create for this version. .. beta-settings=key=dolor Metadata settings that are supplied to this version to enable beta runtime features. the value will be associated with the given key creation-time=et Time that this version was created.@OutputOnly default-expiration=et 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. deployer=sadipscing Email address of the user who created this version.@OutputOnly deployment.container image=stet 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\" ... disk-usage-bytes=dolor Total size of version files hosted on App Engine disk in bytes.@OutputOnly endpoints-api-service config-id=duo Endpoints service configuration id as specified by the Service Management API. For example \"2016-09-19r1\"By default, the Endpoints service configuration id is fixed and config_id must be specified. To keep the Endpoints service configuration id updated with each rollout, specify RolloutStrategy.MANAGED and omit config_id. disable-trace-sampling=false Enable or disable trace sampling. By default, this is set to false for enabled. name=vero Endpoints service name which is the name of the \"service\" resource in the Service Management API. For example \"myapi.endpoints.myproject.cloud.goog\" rollout-strategy=invidunt Endpoints rollout strategy. If FIXED, config_id must be specified. If MANAGED, config_id must be omitted. .. env=stet App Engine execution environment to use for this version.Defaults to 1. env-variables=key=vero Environment variables made available to the application.Only returned in GET requests if view=FULL is set. the value will be associated with the given key health-check check-interval=elitr Interval between health checks. disable-health-check=true Whether to explicitly disable health checks for this instance. healthy-threshold=1 Number of consecutive successful health checks required before receiving traffic. host=accusam Host header to send when performing an HTTP health check. Example: \"myapp.appspot.com\" restart-threshold=42 Number of consecutive failed health checks required before an instance is restarted. timeout=consetetur Time before the health check is considered failed. unhealthy-threshold=73 Number of consecutive failed health checks required before removing traffic. .. id=et 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-\". inbound-services=erat Before an application can receive email or XMPP messages, the application must be configured to enable the service. Each invocation of this argument appends the given value to the array. instance-class=consetetur Instance class that is used to run this version. Valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling. manual-scaling instances=99 Number of instances to assign to the service at the start. This number can later be altered by using the Modules API (https://cloud.google.com/appengine/docs/python/modules/functions) set_num_instances() function. .. name=sed Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1.@OutputOnly network forwarded-ports=takimata List of ports, or port pairs, to forward from the virtual machine to the application container. Each invocation of this argument appends the given value to the array. instance-tag=dolores Tag to apply to the VM instance during creation. name=gubergren Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path.Defaults to default. subnetwork-name=et Google Cloud Platform sub-network where the virtual machines are created. Specify the short name, not the resource path.If a subnetwork name is specified, a network name will also be required unless it is for the default network. If the network the VM instance is being created in is a Legacy network, then the IP address is allocated from the IPv4Range. If the network the VM instance is being created in is an auto Subnet Mode Network, then only network name should be specified (not the subnetwork_name) and the IP address is created from the IPCidrRange of the subnetwork that exists in that zone for that network. If the network the VM instance is being created in is a custom Subnet Mode Network, then the subnetwork_name must be specified and the IP address is created from the IPCidrRange of the subnetwork.If specified, the subnetwork must exist in the same region as the Flex app. .. nobuild-files-regex=accusam 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. resources cpu=0.974461005485015 Number of CPU cores needed. disk-gb=0.5290758052968516 Disk size (GB) needed. memory-gb=0.5284480987860815 Memory (GB) needed. .. runtime=amet. Desired runtime. Example: python27. runtime-api-version=ea The version of the API in the given runtime environment. Please see the app.yaml reference for valid values at https://cloud.google.com/appengine/docs/standard/<language>/config/appref serving-status=sadipscing Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING. threadsafe=true Whether multiple requests can be dispatched to this version at once. vm=true Whether to deploy this version in a container on a virtual machine. About Cursors The cursor position is key to comfortably set complex nested structures. The following rules apply: The cursor position is always set relative to the current one, unless the field name starts with the . character. Fields can be nested such as in -r f.s.o . The cursor position is set relative to the top-level structure if it starts with . , e.g. -r .s.s You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify -r struct.sub_struct=bar . You can move the cursor one level up by using .. . Each additional . moves it up one additional level. E.g. ... would go three levels up. Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Services Versions Create"},{"location":"apps_services-versions-create/#scopes","text":"You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-create ...","title":"Scopes"},{"location":"apps_services-versions-create/#required-scalar-arguments","text":"<apps-id> (string) Part of name . Name of the resource to update. For example: \"apps/myapp/services/default\". <services-id> (string) Part of name . See documentation of appsId .","title":"Required Scalar Arguments"},{"location":"apps_services-versions-create/#required-request-value","text":"The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure. In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely. For example, a structure like this: Version: api-config: auth-fail-action: string login: string script: string security-level: string url: string automatic-scaling: cool-down-period: string cpu-utilization: aggregation-window-length: string target-utilization: number disk-utilization: target-read-bytes-per-sec: integer target-read-ops-per-sec: integer target-write-bytes-per-sec: integer target-write-ops-per-sec: integer max-concurrent-requests: integer max-idle-instances: integer max-pending-latency: string max-total-instances: integer min-idle-instances: integer min-pending-latency: string min-total-instances: integer network-utilization: target-received-bytes-per-sec: integer target-received-packets-per-sec: integer target-sent-bytes-per-sec: integer target-sent-packets-per-sec: integer request-utilization: target-concurrent-requests: integer target-request-count-per-sec: integer basic-scaling: idle-timeout: string max-instances: integer beta-settings: { string: string } creation-time: string default-expiration: string deployer: string deployment: container: image: string disk-usage-bytes: string endpoints-api-service: config-id: string disable-trace-sampling: boolean name: string rollout-strategy: string env: string env-variables: { string: string } health-check: check-interval: string disable-health-check: boolean healthy-threshold: integer host: string restart-threshold: integer timeout: string unhealthy-threshold: integer id: string inbound-services: [string] instance-class: string manual-scaling: instances: integer name: string network: forwarded-ports: [string] instance-tag: string name: string subnetwork-name: string nobuild-files-regex: string resources: cpu: number disk-gb: number memory-gb: number runtime: string runtime-api-version: string serving-status: string threadsafe: boolean vm: boolean can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time. -r .api-config auth-fail-action=ipsum Action to take when users access resources that require authentication. Defaults to redirect. login=est Level of login required to access this resource. Defaults to optional. script=gubergren Path to the script from the application root directory. security-level=ea Security (HTTPS) enforcement for this URL. url=dolor URL to serve the endpoint at. ..automatic-scaling cool-down-period=lorem The time period that the Autoscaler (https://cloud.google.com/compute/docs/autoscaler/) should wait before it starts collecting information from a new instance. This prevents the autoscaler from collecting information when the instance is initializing, during which the collected usage would not be reliable. Only applicable in the App Engine flexible environment. cpu-utilization aggregation-window-length=eos Period of time over which CPU utilization is calculated. target-utilization=0.11853734747270994 Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1. ..disk-utilization target-read-bytes-per-sec=31 Target bytes read per second. target-read-ops-per-sec=21 Target ops read per second. target-write-bytes-per-sec=40 Target bytes written per second. target-write-ops-per-sec=86 Target ops written per second. .. max-concurrent-requests=88 Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.Defaults to a runtime-specific value. max-idle-instances=77 Maximum number of idle instances that should be maintained for this version. max-pending-latency=sed Maximum amount of time that a request should wait in the pending queue before starting a new instance to handle it. max-total-instances=77 Maximum number of instances that should be started to handle requests. min-idle-instances=33 Minimum number of idle instances that should be maintained for this version. Only applicable for the default version of a module. min-pending-latency=vero Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it. min-total-instances=70 Minimum number of instances that should be maintained for this version. network-utilization target-received-bytes-per-sec=8 Target bytes received per second. target-received-packets-per-sec=81 Target packets received per second. target-sent-bytes-per-sec=67 Target bytes sent per second. target-sent-packets-per-sec=79 Target packets sent per second. ..request-utilization target-concurrent-requests=73 Target number of concurrent requests. target-request-count-per-sec=99 Target requests per second. ...basic-scaling idle-timeout=consetetur Duration of time after the last request that an instance must wait before the instance is shut down. max-instances=9 Maximum number of instances to create for this version. .. beta-settings=key=dolor Metadata settings that are supplied to this version to enable beta runtime features. the value will be associated with the given key creation-time=et Time that this version was created.@OutputOnly default-expiration=et 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. deployer=sadipscing Email address of the user who created this version.@OutputOnly deployment.container image=stet 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\" ... disk-usage-bytes=dolor Total size of version files hosted on App Engine disk in bytes.@OutputOnly endpoints-api-service config-id=duo Endpoints service configuration id as specified by the Service Management API. For example \"2016-09-19r1\"By default, the Endpoints service configuration id is fixed and config_id must be specified. To keep the Endpoints service configuration id updated with each rollout, specify RolloutStrategy.MANAGED and omit config_id. disable-trace-sampling=false Enable or disable trace sampling. By default, this is set to false for enabled. name=vero Endpoints service name which is the name of the \"service\" resource in the Service Management API. For example \"myapi.endpoints.myproject.cloud.goog\" rollout-strategy=invidunt Endpoints rollout strategy. If FIXED, config_id must be specified. If MANAGED, config_id must be omitted. .. env=stet App Engine execution environment to use for this version.Defaults to 1. env-variables=key=vero Environment variables made available to the application.Only returned in GET requests if view=FULL is set. the value will be associated with the given key health-check check-interval=elitr Interval between health checks. disable-health-check=true Whether to explicitly disable health checks for this instance. healthy-threshold=1 Number of consecutive successful health checks required before receiving traffic. host=accusam Host header to send when performing an HTTP health check. Example: \"myapp.appspot.com\" restart-threshold=42 Number of consecutive failed health checks required before an instance is restarted. timeout=consetetur Time before the health check is considered failed. unhealthy-threshold=73 Number of consecutive failed health checks required before removing traffic. .. id=et 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-\". inbound-services=erat Before an application can receive email or XMPP messages, the application must be configured to enable the service. Each invocation of this argument appends the given value to the array. instance-class=consetetur Instance class that is used to run this version. Valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling. manual-scaling instances=99 Number of instances to assign to the service at the start. This number can later be altered by using the Modules API (https://cloud.google.com/appengine/docs/python/modules/functions) set_num_instances() function. .. name=sed Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1.@OutputOnly network forwarded-ports=takimata List of ports, or port pairs, to forward from the virtual machine to the application container. Each invocation of this argument appends the given value to the array. instance-tag=dolores Tag to apply to the VM instance during creation. name=gubergren Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path.Defaults to default. subnetwork-name=et Google Cloud Platform sub-network where the virtual machines are created. Specify the short name, not the resource path.If a subnetwork name is specified, a network name will also be required unless it is for the default network. If the network the VM instance is being created in is a Legacy network, then the IP address is allocated from the IPv4Range. If the network the VM instance is being created in is an auto Subnet Mode Network, then only network name should be specified (not the subnetwork_name) and the IP address is created from the IPCidrRange of the subnetwork that exists in that zone for that network. If the network the VM instance is being created in is a custom Subnet Mode Network, then the subnetwork_name must be specified and the IP address is created from the IPCidrRange of the subnetwork.If specified, the subnetwork must exist in the same region as the Flex app. .. nobuild-files-regex=accusam 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. resources cpu=0.974461005485015 Number of CPU cores needed. disk-gb=0.5290758052968516 Disk size (GB) needed. memory-gb=0.5284480987860815 Memory (GB) needed. .. runtime=amet. Desired runtime. Example: python27. runtime-api-version=ea The version of the API in the given runtime environment. Please see the app.yaml reference for valid values at https://cloud.google.com/appengine/docs/standard/<language>/config/appref serving-status=sadipscing Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING. threadsafe=true Whether multiple requests can be dispatched to this version at once. vm=true Whether to deploy this version in a container on a virtual machine.","title":"Required Request Value"},{"location":"apps_services-versions-create/#about-cursors","text":"The cursor position is key to comfortably set complex nested structures. The following rules apply: The cursor position is always set relative to the current one, unless the field name starts with the . character. Fields can be nested such as in -r f.s.o . The cursor position is set relative to the top-level structure if it starts with . , e.g. -r .s.s You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify -r struct.sub_struct=bar . You can move the cursor one level up by using .. . Each additional . moves it up one additional level. E.g. ... would go three levels up.","title":"About Cursors"},{"location":"apps_services-versions-create/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_services-versions-create/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_services-versions-delete/","text":"Deletes an existing version. Scopes You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-delete ... Required Scalar Arguments <apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp/services/default/versions/v1. <services-id> (string) Part of name . See documentation of appsId . <versions-id> (string) Part of name . See documentation of appsId . Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Services Versions Delete"},{"location":"apps_services-versions-delete/#scopes","text":"You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-delete ...","title":"Scopes"},{"location":"apps_services-versions-delete/#required-scalar-arguments","text":"<apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp/services/default/versions/v1. <services-id> (string) Part of name . See documentation of appsId . <versions-id> (string) Part of name . See documentation of appsId .","title":"Required Scalar Arguments"},{"location":"apps_services-versions-delete/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_services-versions-delete/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_services-versions-get/","text":"Gets the specified Version resource. By default, only a BASIC_VIEW will be returned. Specify the FULL_VIEW parameter to get the full resource. Scopes You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-get ... Required Scalar Arguments <apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp/services/default/versions/v1. <services-id> (string) Part of name . See documentation of appsId . <versions-id> (string) Part of name . See documentation of appsId . Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional Method Properties You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p view=string Controls the set of fields returned in the Get response. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Services Versions Get"},{"location":"apps_services-versions-get/#scopes","text":"You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-get ...","title":"Scopes"},{"location":"apps_services-versions-get/#required-scalar-arguments","text":"<apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp/services/default/versions/v1. <services-id> (string) Part of name . See documentation of appsId . <versions-id> (string) Part of name . See documentation of appsId .","title":"Required Scalar Arguments"},{"location":"apps_services-versions-get/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_services-versions-get/#optional-method-properties","text":"You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p view=string Controls the set of fields returned in the Get response.","title":"Optional Method Properties"},{"location":"apps_services-versions-get/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_services-versions-instances-debug/","text":"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. Scopes You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-instances-debug ... Required Scalar Arguments <apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. <services-id> (string) Part of name . See documentation of appsId . <versions-id> (string) Part of name . See documentation of appsId . <instances-id> (string) Part of name . See documentation of appsId . Required Request Value The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure. In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely. For example, a structure like this: DebugInstanceRequest: ssh-key: string can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time. -r . ssh-key=sit 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). About Cursors The cursor position is key to comfortably set complex nested structures. The following rules apply: The cursor position is always set relative to the current one, unless the field name starts with the . character. Fields can be nested such as in -r f.s.o . The cursor position is set relative to the top-level structure if it starts with . , e.g. -r .s.s You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify -r struct.sub_struct=bar . You can move the cursor one level up by using .. . Each additional . moves it up one additional level. E.g. ... would go three levels up. Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Services Versions Instances Debug"},{"location":"apps_services-versions-instances-debug/#scopes","text":"You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-instances-debug ...","title":"Scopes"},{"location":"apps_services-versions-instances-debug/#required-scalar-arguments","text":"<apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. <services-id> (string) Part of name . See documentation of appsId . <versions-id> (string) Part of name . See documentation of appsId . <instances-id> (string) Part of name . See documentation of appsId .","title":"Required Scalar Arguments"},{"location":"apps_services-versions-instances-debug/#required-request-value","text":"The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure. In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely. For example, a structure like this: DebugInstanceRequest: ssh-key: string can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time. -r . ssh-key=sit 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).","title":"Required Request Value"},{"location":"apps_services-versions-instances-debug/#about-cursors","text":"The cursor position is key to comfortably set complex nested structures. The following rules apply: The cursor position is always set relative to the current one, unless the field name starts with the . character. Fields can be nested such as in -r f.s.o . The cursor position is set relative to the top-level structure if it starts with . , e.g. -r .s.s You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify -r struct.sub_struct=bar . You can move the cursor one level up by using .. . Each additional . moves it up one additional level. E.g. ... would go three levels up.","title":"About Cursors"},{"location":"apps_services-versions-instances-debug/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_services-versions-instances-debug/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_services-versions-instances-delete/","text":"Stops a running instance. Scopes You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-instances-delete ... Required Scalar Arguments <apps-id> (string) Part of name . Name of the resource requested. For example: \"apps/myapp/services/default/versions/v1/instances/instance-1\". <services-id> (string) Part of name . See documentation of appsId . <versions-id> (string) Part of name . See documentation of appsId . <instances-id> (string) Part of name . See documentation of appsId . Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Services Versions Instances Delete"},{"location":"apps_services-versions-instances-delete/#scopes","text":"You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-instances-delete ...","title":"Scopes"},{"location":"apps_services-versions-instances-delete/#required-scalar-arguments","text":"<apps-id> (string) Part of name . Name of the resource requested. For example: \"apps/myapp/services/default/versions/v1/instances/instance-1\". <services-id> (string) Part of name . See documentation of appsId . <versions-id> (string) Part of name . See documentation of appsId . <instances-id> (string) Part of name . See documentation of appsId .","title":"Required Scalar Arguments"},{"location":"apps_services-versions-instances-delete/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_services-versions-instances-delete/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_services-versions-instances-get/","text":"Gets instance information. Scopes You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-instances-get ... Required Scalar Arguments <apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. <services-id> (string) Part of name . See documentation of appsId . <versions-id> (string) Part of name . See documentation of appsId . <instances-id> (string) Part of name . See documentation of appsId . Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Services Versions Instances Get"},{"location":"apps_services-versions-instances-get/#scopes","text":"You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-instances-get ...","title":"Scopes"},{"location":"apps_services-versions-instances-get/#required-scalar-arguments","text":"<apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp/services/default/versions/v1/instances/instance-1. <services-id> (string) Part of name . See documentation of appsId . <versions-id> (string) Part of name . See documentation of appsId . <instances-id> (string) Part of name . See documentation of appsId .","title":"Required Scalar Arguments"},{"location":"apps_services-versions-instances-get/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_services-versions-instances-get/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_services-versions-instances-list/","text":"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). Scopes You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-instances-list ... Required Scalar Arguments <apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp/services/default/versions/v1. <services-id> (string) Part of name . See documentation of appsId . <versions-id> (string) Part of name . See documentation of appsId . Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional Method Properties You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p page-size=integer Maximum results to return per page. -p page-token=string Continuation token for fetching the next page of results. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Services Versions Instances List"},{"location":"apps_services-versions-instances-list/#scopes","text":"You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-instances-list ...","title":"Scopes"},{"location":"apps_services-versions-instances-list/#required-scalar-arguments","text":"<apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp/services/default/versions/v1. <services-id> (string) Part of name . See documentation of appsId . <versions-id> (string) Part of name . See documentation of appsId .","title":"Required Scalar Arguments"},{"location":"apps_services-versions-instances-list/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_services-versions-instances-list/#optional-method-properties","text":"You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p page-size=integer Maximum results to return per page. -p page-token=string Continuation token for fetching the next page of results.","title":"Optional Method Properties"},{"location":"apps_services-versions-instances-list/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_services-versions-list/","text":"Lists the versions of a service. Scopes You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-list ... Required Scalar Arguments <apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp/services/default. <services-id> (string) Part of name . See documentation of appsId . Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional Method Properties You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p page-size=integer Maximum results to return per page. -p page-token=string Continuation token for fetching the next page of results. -p view=string Controls the set of fields returned in the List response. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Services Versions List"},{"location":"apps_services-versions-list/#scopes","text":"You will need authorization for at least one of the following scopes to make a valid call: https://www.googleapis.com/auth/appengine.admin https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/cloud-platform.read-only If unset, the scope for this method defaults to https://www.googleapis.com/auth/appengine.admin . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-list ...","title":"Scopes"},{"location":"apps_services-versions-list/#required-scalar-arguments","text":"<apps-id> (string) Part of name . Name of the resource requested. Example: apps/myapp/services/default. <services-id> (string) Part of name . See documentation of appsId .","title":"Required Scalar Arguments"},{"location":"apps_services-versions-list/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_services-versions-list/#optional-method-properties","text":"You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p page-size=integer Maximum results to return per page. -p page-token=string Continuation token for fetching the next page of results. -p view=string Controls the set of fields returned in the List response.","title":"Optional Method Properties"},{"location":"apps_services-versions-list/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"},{"location":"apps_services-versions-patch/","text":"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. Scopes You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-patch ... Required Scalar Arguments <apps-id> (string) Part of name . Name of the resource to update. Example: apps/myapp/services/default/versions/1. <services-id> (string) Part of name . See documentation of appsId . <versions-id> (string) Part of name . See documentation of appsId . Required Request Value The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure. In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely. For example, a structure like this: Version: api-config: auth-fail-action: string login: string script: string security-level: string url: string automatic-scaling: cool-down-period: string cpu-utilization: aggregation-window-length: string target-utilization: number disk-utilization: target-read-bytes-per-sec: integer target-read-ops-per-sec: integer target-write-bytes-per-sec: integer target-write-ops-per-sec: integer max-concurrent-requests: integer max-idle-instances: integer max-pending-latency: string max-total-instances: integer min-idle-instances: integer min-pending-latency: string min-total-instances: integer network-utilization: target-received-bytes-per-sec: integer target-received-packets-per-sec: integer target-sent-bytes-per-sec: integer target-sent-packets-per-sec: integer request-utilization: target-concurrent-requests: integer target-request-count-per-sec: integer basic-scaling: idle-timeout: string max-instances: integer beta-settings: { string: string } creation-time: string default-expiration: string deployer: string deployment: container: image: string disk-usage-bytes: string endpoints-api-service: config-id: string disable-trace-sampling: boolean name: string rollout-strategy: string env: string env-variables: { string: string } health-check: check-interval: string disable-health-check: boolean healthy-threshold: integer host: string restart-threshold: integer timeout: string unhealthy-threshold: integer id: string inbound-services: [string] instance-class: string manual-scaling: instances: integer name: string network: forwarded-ports: [string] instance-tag: string name: string subnetwork-name: string nobuild-files-regex: string resources: cpu: number disk-gb: number memory-gb: number runtime: string runtime-api-version: string serving-status: string threadsafe: boolean vm: boolean can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time. -r .api-config auth-fail-action=et Action to take when users access resources that require authentication. Defaults to redirect. login=tempor Level of login required to access this resource. Defaults to optional. script=aliquyam Path to the script from the application root directory. security-level=ipsum Security (HTTPS) enforcement for this URL. url=et URL to serve the endpoint at. ..automatic-scaling cool-down-period=sanctus The time period that the Autoscaler (https://cloud.google.com/compute/docs/autoscaler/) should wait before it starts collecting information from a new instance. This prevents the autoscaler from collecting information when the instance is initializing, during which the collected usage would not be reliable. Only applicable in the App Engine flexible environment. cpu-utilization aggregation-window-length=lorem Period of time over which CPU utilization is calculated. target-utilization=0.7347003486631798 Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1. ..disk-utilization target-read-bytes-per-sec=72 Target bytes read per second. target-read-ops-per-sec=82 Target ops read per second. target-write-bytes-per-sec=32 Target bytes written per second. target-write-ops-per-sec=33 Target ops written per second. .. max-concurrent-requests=8 Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.Defaults to a runtime-specific value. max-idle-instances=90 Maximum number of idle instances that should be maintained for this version. max-pending-latency=et Maximum amount of time that a request should wait in the pending queue before starting a new instance to handle it. max-total-instances=7 Maximum number of instances that should be started to handle requests. min-idle-instances=21 Minimum number of idle instances that should be maintained for this version. Only applicable for the default version of a module. min-pending-latency=no Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it. min-total-instances=10 Minimum number of instances that should be maintained for this version. network-utilization target-received-bytes-per-sec=24 Target bytes received per second. target-received-packets-per-sec=56 Target packets received per second. target-sent-bytes-per-sec=69 Target bytes sent per second. target-sent-packets-per-sec=32 Target packets sent per second. ..request-utilization target-concurrent-requests=6 Target number of concurrent requests. target-request-count-per-sec=70 Target requests per second. ...basic-scaling idle-timeout=aliquyam Duration of time after the last request that an instance must wait before the instance is shut down. max-instances=54 Maximum number of instances to create for this version. .. beta-settings=key=est Metadata settings that are supplied to this version to enable beta runtime features. the value will be associated with the given key creation-time=et Time that this version was created.@OutputOnly default-expiration=sea 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. deployer=consetetur Email address of the user who created this version.@OutputOnly deployment.container image=consetetur 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\" ... disk-usage-bytes=stet Total size of version files hosted on App Engine disk in bytes.@OutputOnly endpoints-api-service config-id=est Endpoints service configuration id as specified by the Service Management API. For example \"2016-09-19r1\"By default, the Endpoints service configuration id is fixed and config_id must be specified. To keep the Endpoints service configuration id updated with each rollout, specify RolloutStrategy.MANAGED and omit config_id. disable-trace-sampling=false Enable or disable trace sampling. By default, this is set to false for enabled. name=elitr Endpoints service name which is the name of the \"service\" resource in the Service Management API. For example \"myapi.endpoints.myproject.cloud.goog\" rollout-strategy=duo Endpoints rollout strategy. If FIXED, config_id must be specified. If MANAGED, config_id must be omitted. .. env=diam App Engine execution environment to use for this version.Defaults to 1. env-variables=key=est Environment variables made available to the application.Only returned in GET requests if view=FULL is set. the value will be associated with the given key health-check check-interval=sit Interval between health checks. disable-health-check=false Whether to explicitly disable health checks for this instance. healthy-threshold=26 Number of consecutive successful health checks required before receiving traffic. host=lorem Host header to send when performing an HTTP health check. Example: \"myapp.appspot.com\" restart-threshold=84 Number of consecutive failed health checks required before an instance is restarted. timeout=stet Time before the health check is considered failed. unhealthy-threshold=82 Number of consecutive failed health checks required before removing traffic. .. id=eos 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-\". inbound-services=et Before an application can receive email or XMPP messages, the application must be configured to enable the service. Each invocation of this argument appends the given value to the array. instance-class=sea Instance class that is used to run this version. Valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling. manual-scaling instances=27 Number of instances to assign to the service at the start. This number can later be altered by using the Modules API (https://cloud.google.com/appengine/docs/python/modules/functions) set_num_instances() function. .. name=at Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1.@OutputOnly network forwarded-ports=dolore List of ports, or port pairs, to forward from the virtual machine to the application container. Each invocation of this argument appends the given value to the array. instance-tag=eirmod Tag to apply to the VM instance during creation. name=lorem Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path.Defaults to default. subnetwork-name=accusam Google Cloud Platform sub-network where the virtual machines are created. Specify the short name, not the resource path.If a subnetwork name is specified, a network name will also be required unless it is for the default network. If the network the VM instance is being created in is a Legacy network, then the IP address is allocated from the IPv4Range. If the network the VM instance is being created in is an auto Subnet Mode Network, then only network name should be specified (not the subnetwork_name) and the IP address is created from the IPCidrRange of the subnetwork that exists in that zone for that network. If the network the VM instance is being created in is a custom Subnet Mode Network, then the subnetwork_name must be specified and the IP address is created from the IPCidrRange of the subnetwork.If specified, the subnetwork must exist in the same region as the Flex app. .. nobuild-files-regex=amet 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. resources cpu=0.5528213400607493 Number of CPU cores needed. disk-gb=0.15972633079770038 Disk size (GB) needed. memory-gb=0.711397230560734 Memory (GB) needed. .. runtime=takimata Desired runtime. Example: python27. runtime-api-version=lorem The version of the API in the given runtime environment. Please see the app.yaml reference for valid values at https://cloud.google.com/appengine/docs/standard/<language>/config/appref serving-status=et Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING. threadsafe=false Whether multiple requests can be dispatched to this version at once. vm=true Whether to deploy this version in a container on a virtual machine. About Cursors The cursor position is key to comfortably set complex nested structures. The following rules apply: The cursor position is always set relative to the current one, unless the field name starts with the . character. Fields can be nested such as in -r f.s.o . The cursor position is set relative to the top-level structure if it starts with . , e.g. -r .s.s You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify -r struct.sub_struct=bar . You can move the cursor one level up by using .. . Each additional . moves it up one additional level. E.g. ... would go three levels up. Optional Output Flags The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output. Optional Method Properties You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p mask=string Standard field mask for the set of fields to be updated. Optional General Properties The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Services Versions Patch"},{"location":"apps_services-versions-patch/#scopes","text":"You will need authorization for the https://www.googleapis.com/auth/cloud-platform scope to make a valid call. If unset, the scope for this method defaults to https://www.googleapis.com/auth/cloud-platform . You can set the scope for this method like this: appengine1-beta5 --scope <scope> apps services-versions-patch ...","title":"Scopes"},{"location":"apps_services-versions-patch/#required-scalar-arguments","text":"<apps-id> (string) Part of name . Name of the resource to update. Example: apps/myapp/services/default/versions/1. <services-id> (string) Part of name . See documentation of appsId . <versions-id> (string) Part of name . See documentation of appsId .","title":"Required Scalar Arguments"},{"location":"apps_services-versions-patch/#required-request-value","text":"The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure. In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely. For example, a structure like this: Version: api-config: auth-fail-action: string login: string script: string security-level: string url: string automatic-scaling: cool-down-period: string cpu-utilization: aggregation-window-length: string target-utilization: number disk-utilization: target-read-bytes-per-sec: integer target-read-ops-per-sec: integer target-write-bytes-per-sec: integer target-write-ops-per-sec: integer max-concurrent-requests: integer max-idle-instances: integer max-pending-latency: string max-total-instances: integer min-idle-instances: integer min-pending-latency: string min-total-instances: integer network-utilization: target-received-bytes-per-sec: integer target-received-packets-per-sec: integer target-sent-bytes-per-sec: integer target-sent-packets-per-sec: integer request-utilization: target-concurrent-requests: integer target-request-count-per-sec: integer basic-scaling: idle-timeout: string max-instances: integer beta-settings: { string: string } creation-time: string default-expiration: string deployer: string deployment: container: image: string disk-usage-bytes: string endpoints-api-service: config-id: string disable-trace-sampling: boolean name: string rollout-strategy: string env: string env-variables: { string: string } health-check: check-interval: string disable-health-check: boolean healthy-threshold: integer host: string restart-threshold: integer timeout: string unhealthy-threshold: integer id: string inbound-services: [string] instance-class: string manual-scaling: instances: integer name: string network: forwarded-ports: [string] instance-tag: string name: string subnetwork-name: string nobuild-files-regex: string resources: cpu: number disk-gb: number memory-gb: number runtime: string runtime-api-version: string serving-status: string threadsafe: boolean vm: boolean can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time. -r .api-config auth-fail-action=et Action to take when users access resources that require authentication. Defaults to redirect. login=tempor Level of login required to access this resource. Defaults to optional. script=aliquyam Path to the script from the application root directory. security-level=ipsum Security (HTTPS) enforcement for this URL. url=et URL to serve the endpoint at. ..automatic-scaling cool-down-period=sanctus The time period that the Autoscaler (https://cloud.google.com/compute/docs/autoscaler/) should wait before it starts collecting information from a new instance. This prevents the autoscaler from collecting information when the instance is initializing, during which the collected usage would not be reliable. Only applicable in the App Engine flexible environment. cpu-utilization aggregation-window-length=lorem Period of time over which CPU utilization is calculated. target-utilization=0.7347003486631798 Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1. ..disk-utilization target-read-bytes-per-sec=72 Target bytes read per second. target-read-ops-per-sec=82 Target ops read per second. target-write-bytes-per-sec=32 Target bytes written per second. target-write-ops-per-sec=33 Target ops written per second. .. max-concurrent-requests=8 Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.Defaults to a runtime-specific value. max-idle-instances=90 Maximum number of idle instances that should be maintained for this version. max-pending-latency=et Maximum amount of time that a request should wait in the pending queue before starting a new instance to handle it. max-total-instances=7 Maximum number of instances that should be started to handle requests. min-idle-instances=21 Minimum number of idle instances that should be maintained for this version. Only applicable for the default version of a module. min-pending-latency=no Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it. min-total-instances=10 Minimum number of instances that should be maintained for this version. network-utilization target-received-bytes-per-sec=24 Target bytes received per second. target-received-packets-per-sec=56 Target packets received per second. target-sent-bytes-per-sec=69 Target bytes sent per second. target-sent-packets-per-sec=32 Target packets sent per second. ..request-utilization target-concurrent-requests=6 Target number of concurrent requests. target-request-count-per-sec=70 Target requests per second. ...basic-scaling idle-timeout=aliquyam Duration of time after the last request that an instance must wait before the instance is shut down. max-instances=54 Maximum number of instances to create for this version. .. beta-settings=key=est Metadata settings that are supplied to this version to enable beta runtime features. the value will be associated with the given key creation-time=et Time that this version was created.@OutputOnly default-expiration=sea 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. deployer=consetetur Email address of the user who created this version.@OutputOnly deployment.container image=consetetur 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\" ... disk-usage-bytes=stet Total size of version files hosted on App Engine disk in bytes.@OutputOnly endpoints-api-service config-id=est Endpoints service configuration id as specified by the Service Management API. For example \"2016-09-19r1\"By default, the Endpoints service configuration id is fixed and config_id must be specified. To keep the Endpoints service configuration id updated with each rollout, specify RolloutStrategy.MANAGED and omit config_id. disable-trace-sampling=false Enable or disable trace sampling. By default, this is set to false for enabled. name=elitr Endpoints service name which is the name of the \"service\" resource in the Service Management API. For example \"myapi.endpoints.myproject.cloud.goog\" rollout-strategy=duo Endpoints rollout strategy. If FIXED, config_id must be specified. If MANAGED, config_id must be omitted. .. env=diam App Engine execution environment to use for this version.Defaults to 1. env-variables=key=est Environment variables made available to the application.Only returned in GET requests if view=FULL is set. the value will be associated with the given key health-check check-interval=sit Interval between health checks. disable-health-check=false Whether to explicitly disable health checks for this instance. healthy-threshold=26 Number of consecutive successful health checks required before receiving traffic. host=lorem Host header to send when performing an HTTP health check. Example: \"myapp.appspot.com\" restart-threshold=84 Number of consecutive failed health checks required before an instance is restarted. timeout=stet Time before the health check is considered failed. unhealthy-threshold=82 Number of consecutive failed health checks required before removing traffic. .. id=eos 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-\". inbound-services=et Before an application can receive email or XMPP messages, the application must be configured to enable the service. Each invocation of this argument appends the given value to the array. instance-class=sea Instance class that is used to run this version. Valid values are: AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling. manual-scaling instances=27 Number of instances to assign to the service at the start. This number can later be altered by using the Modules API (https://cloud.google.com/appengine/docs/python/modules/functions) set_num_instances() function. .. name=at Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1.@OutputOnly network forwarded-ports=dolore List of ports, or port pairs, to forward from the virtual machine to the application container. Each invocation of this argument appends the given value to the array. instance-tag=eirmod Tag to apply to the VM instance during creation. name=lorem Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path.Defaults to default. subnetwork-name=accusam Google Cloud Platform sub-network where the virtual machines are created. Specify the short name, not the resource path.If a subnetwork name is specified, a network name will also be required unless it is for the default network. If the network the VM instance is being created in is a Legacy network, then the IP address is allocated from the IPv4Range. If the network the VM instance is being created in is an auto Subnet Mode Network, then only network name should be specified (not the subnetwork_name) and the IP address is created from the IPCidrRange of the subnetwork that exists in that zone for that network. If the network the VM instance is being created in is a custom Subnet Mode Network, then the subnetwork_name must be specified and the IP address is created from the IPCidrRange of the subnetwork.If specified, the subnetwork must exist in the same region as the Flex app. .. nobuild-files-regex=amet 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. resources cpu=0.5528213400607493 Number of CPU cores needed. disk-gb=0.15972633079770038 Disk size (GB) needed. memory-gb=0.711397230560734 Memory (GB) needed. .. runtime=takimata Desired runtime. Example: python27. runtime-api-version=lorem The version of the API in the given runtime environment. Please see the app.yaml reference for valid values at https://cloud.google.com/appengine/docs/standard/<language>/config/appref serving-status=et Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING. threadsafe=false Whether multiple requests can be dispatched to this version at once. vm=true Whether to deploy this version in a container on a virtual machine.","title":"Required Request Value"},{"location":"apps_services-versions-patch/#about-cursors","text":"The cursor position is key to comfortably set complex nested structures. The following rules apply: The cursor position is always set relative to the current one, unless the field name starts with the . character. Fields can be nested such as in -r f.s.o . The cursor position is set relative to the top-level structure if it starts with . , e.g. -r .s.s You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify -r struct.sub_struct=bar . You can move the cursor one level up by using .. . Each additional . moves it up one additional level. E.g. ... would go three levels up.","title":"About Cursors"},{"location":"apps_services-versions-patch/#optional-output-flags","text":"The method's return value a JSON encoded structure, which will be written to standard output by default. -o out out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.","title":"Optional Output Flags"},{"location":"apps_services-versions-patch/#optional-method-properties","text":"You may set the following properties to further configure the call. Please note that -p is followed by one or more key-value-pairs, and is called like this -p k1=v1 k2=v2 even though the listing below repeats the -p for completeness. -p mask=string Standard field mask for the set of fields to be updated.","title":"Optional Method Properties"},{"location":"apps_services-versions-patch/#optional-general-properties","text":"The following properties can configure any call, and are not specific to this method. -p $-xgafv=string V1 error format. -p access-token=string OAuth access token. -p alt=string Data format for response. -p callback=string JSONP -p fields=string Selector specifying which fields to include in a partial response. -p key=string API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -p oauth-token=string OAuth 2.0 token for the current user. -p pretty-print=boolean Returns response with indentations and line breaks. -p quota-user=string Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -p upload-type=string Legacy upload protocol for media (e.g. \"media\", \"multipart\"). -p upload-protocol=string Upload protocol for media (e.g. \"raw\", \"multipart\").","title":"Optional General Properties"}]}