GOgoogle
apps

GET /v1/apps/{appsId}/services/{servicesId}/versions/{versionsId}

Changed on

Gets the specified Version resource. By default, only a BASIC_VIEW will be returned. Specify the FULL_VIEW parameter to get the full resource.

Request

  • Base URL
    https://appengine.googleapis.com
  • Auth
    • OAuth 2 and OAuth 2
      Implicithttps://accounts.google.com/o/oauth2/auth
      Scopeshttps://www.googleapis.com/auth/appengine.admin
      Authorization codehttps://accounts.google.com/o/oauth2/auth
      Token URLhttps://accounts.google.com/o/oauth2/token
      Scopeshttps://www.googleapis.com/auth/appengine.admin
    • or OAuth 2 and OAuth 2
      Implicithttps://accounts.google.com/o/oauth2/auth
      Scopeshttps://www.googleapis.com/auth/cloud-platform
      Authorization codehttps://accounts.google.com/o/oauth2/auth
      Token URLhttps://accounts.google.com/o/oauth2/token
      Scopeshttps://www.googleapis.com/auth/cloud-platform
    • or OAuth 2 and OAuth 2
      Implicithttps://accounts.google.com/o/oauth2/auth
      Scopeshttps://www.googleapis.com/auth/cloud-platform.read-only
      Authorization codehttps://accounts.google.com/o/oauth2/auth
      Token URLhttps://accounts.google.com/o/oauth2/token
      Scopeshttps://www.googleapis.com/auth/cloud-platform.read-only
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Path parameters

appsIdstring required

Part of name. Required. Name of the resource requested. Example: apps/myapp/services/default/versions/v1.

servicesIdstring required

Part of name. See documentation of appsId.

versionsIdstring required

Part of name. See documentation of appsId.

Query parameters

view'BASIC' | 'FULL'

Controls the set of fields returned in the Get response.

Response

Successful response

appEngineApisboolean

Allows App Engine second generation runtimes to access the legacy bundled services.

appEngineBundledServicesstring[]

List of specific App Engine Bundled Services that are enabled for this Version.

betaSettingsobject

Metadata settings that are supplied to this version to enable beta runtime features.

buildEnvVariablesobject

Environment variables available to the build environment.Only returned in GET requests if view=FULL is set.

createTimestring google-datetime

Time that this version was created.@OutputOnly

createdBystring

Output only. Email address of the user who created this version.@OutputOnly

defaultExpirationstring google-duration

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.

diskUsageBytesstring int64

Output only. Total size in bytes of all the files that are included in this version and currently hosted on the App Engine disk.@OutputOnly

envstring

App Engine execution environment for this version.Defaults to standard.

envVariablesobject

Environment variables available to the application.Only returned in GET requests if view=FULL is set.

generatedCustomerMetadataobject

Additional Google Generated Customer Metadata, this field won't be provided by default and can be requested by setting the IncludeExtraData field in GetVersionRequest

idstring

Relative name of the version within the service. Example: v1. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".

inboundServicesstring[]

Before an application can receive email or XMPP messages, the application must be configured to enable the service.

instanceClassstring

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.

namestring

Output only. Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1.@OutputOnly

nobuildFilesRegexstring

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.

runtimestring

Desired runtime. Example: python27.

runtimeApiVersionstring

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//config/appref

runtimeChannelstring

The channel of the runtime to use. Only available for some runtimes. Defaults to the default channel.

runtimeMainExecutablePathstring

The path or name of the app's main executable.

serviceAccountstring

The identity that the deployed version will run as. Admin API will use the App Engine Appspot service account as default if this field is neither provided in app.yaml file nor through CLI flag.

servingStatus'SERVING_STATUS_UNSPECIFIED' | 'SERVING' | 'STOPPED'

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.

threadsafeboolean

Whether multiple requests can be dispatched to this version at once.

versionUrlstring

Output only. Serving URL for this version. Example: "https://myversion-dot-myservice-dot-myapp.appspot.com"@OutputOnly

vmboolean

Whether to deploy this version in a container on a virtual machine.

zonesstring[]

The Google Compute Engine zones that are supported by this version in the App Engine flexible environment. Deprecated.

Changes

  • 26594fa2c248Revision changes
    • info

      the security scope https://www.googleapis.com/auth/appengine.admin was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/appengine.admin was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform.read-only was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform.read-only was removed from the endpoint's security scheme Oauth2c

  • 6e6d92024789Revision changes
    • breaking

      removed the media type */* for the response with the status

    • info

      the security scope https://www.googleapis.com/auth/appengine.admin was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/appengine.admin was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform.read-only was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform.read-only was removed from the endpoint's security scheme Oauth2c