appengine.v1alpha1.appEngineFlexibleAppVersion
Index
fn new(name)
obj metadata
fn withAnnotations(annotations)
fn withAnnotationsMixin(annotations)
fn withClusterName(clusterName)
fn withCreationTimestamp(creationTimestamp)
fn withDeletionGracePeriodSeconds(deletionGracePeriodSeconds)
fn withDeletionTimestamp(deletionTimestamp)
fn withFinalizers(finalizers)
fn withFinalizersMixin(finalizers)
fn withGenerateName(generateName)
fn withGeneration(generation)
fn withLabels(labels)
fn withLabelsMixin(labels)
fn withName(name)
fn withNamespace(namespace)
fn withOwnerReferences(ownerReferences)
fn withOwnerReferencesMixin(ownerReferences)
fn withResourceVersion(resourceVersion)
fn withSelfLink(selfLink)
fn withUid(uid)
obj spec
fn withBetaSettings(betaSettings)
fn withBetaSettingsMixin(betaSettings)
fn withDefaultExpiration(defaultExpiration)
fn withDeleteServiceOnDestroy(deleteServiceOnDestroy)
fn withEnvVariables(envVariables)
fn withEnvVariablesMixin(envVariables)
fn withHandlers(handlers)
fn withHandlersMixin(handlers)
fn withInboundServices(inboundServices)
fn withInboundServicesMixin(inboundServices)
fn withInstanceClass(instanceClass)
fn withNobuildFilesRegex(nobuildFilesRegex)
fn withNoopOnDestroy(noopOnDestroy)
fn withProject(project)
fn withResourceID(resourceID)
fn withRuntime(runtime)
fn withRuntimeApiVersion(runtimeApiVersion)
fn withRuntimeChannel(runtimeChannel)
fn withRuntimeMainExecutablePath(runtimeMainExecutablePath)
fn withServiceAccount(serviceAccount)
fn withServingStatus(servingStatus)
obj spec.apiConfig
obj spec.automaticScaling
fn withCoolDownPeriod(coolDownPeriod)
fn withMaxConcurrentRequests(maxConcurrentRequests)
fn withMaxIdleInstances(maxIdleInstances)
fn withMaxPendingLatency(maxPendingLatency)
fn withMaxTotalInstances(maxTotalInstances)
fn withMinIdleInstances(minIdleInstances)
fn withMinPendingLatency(minPendingLatency)
fn withMinTotalInstances(minTotalInstances)
obj spec.automaticScaling.cpuUtilization
obj spec.automaticScaling.diskUtilization
obj spec.automaticScaling.networkUtilization
obj spec.automaticScaling.requestUtilization
obj spec.deployment
obj spec.endpointsApiService
obj spec.entrypoint
obj spec.handlers
obj spec.livenessCheck
obj spec.manualScaling
obj spec.network
obj spec.readinessCheck
obj spec.resources
obj spec.serviceRef
obj spec.vpcAccessConnector
Fields
fn new
new(name)
new returns an instance of AppEngineFlexibleAppVersion
obj metadata
"ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create."
fn metadata.withAnnotations
withAnnotations(annotations)
"Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations"
fn metadata.withAnnotationsMixin
withAnnotationsMixin(annotations)
"Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations"
Note: This function appends passed data to existing values
fn metadata.withClusterName
withClusterName(clusterName)
"The name of the cluster which the object belongs to. This is used to distinguish resources with same name and namespace in different clusters. This field is not set anywhere right now and apiserver is going to ignore it if set in create or update request."
fn metadata.withCreationTimestamp
withCreationTimestamp(creationTimestamp)
"Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers."
fn metadata.withDeletionGracePeriodSeconds
withDeletionGracePeriodSeconds(deletionGracePeriodSeconds)
"Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only."
fn metadata.withDeletionTimestamp
withDeletionTimestamp(deletionTimestamp)
"Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers."
fn metadata.withFinalizers
withFinalizers(finalizers)
"Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list."
fn metadata.withFinalizersMixin
withFinalizersMixin(finalizers)
"Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list."
Note: This function appends passed data to existing values
fn metadata.withGenerateName
withGenerateName(generateName)
"GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will NOT return a 409 - instead, it will either return 201 Created or 500 with Reason ServerTimeout indicating a unique name could not be found in the time allotted, and the client should retry (optionally after the time indicated in the Retry-After header).\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency"
fn metadata.withGeneration
withGeneration(generation)
"A sequence number representing a specific generation of the desired state. Populated by the system. Read-only."
fn metadata.withLabels
withLabels(labels)
"Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels"
fn metadata.withLabelsMixin
withLabelsMixin(labels)
"Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels"
Note: This function appends passed data to existing values
fn metadata.withName
withName(name)
"Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/identifiers#names"
fn metadata.withNamespace
withNamespace(namespace)
"Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/namespaces"
fn metadata.withOwnerReferences
withOwnerReferences(ownerReferences)
"List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller."
fn metadata.withOwnerReferencesMixin
withOwnerReferencesMixin(ownerReferences)
"List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller."
Note: This function appends passed data to existing values
fn metadata.withResourceVersion
withResourceVersion(resourceVersion)
"An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency"
fn metadata.withSelfLink
withSelfLink(selfLink)
"SelfLink is a URL representing this object. Populated by the system. Read-only.\n\nDEPRECATED Kubernetes will stop propagating this field in 1.20 release and the field is planned to be removed in 1.21 release."
fn metadata.withUid
withUid(uid)
"UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: http://kubernetes.io/docs/user-guide/identifiers#uids"
obj spec
fn spec.withBetaSettings
withBetaSettings(betaSettings)
"Metadata settings that are supplied to this version to enable beta runtime features."
fn spec.withBetaSettingsMixin
withBetaSettingsMixin(betaSettings)
"Metadata settings that are supplied to this version to enable beta runtime features."
Note: This function appends passed data to existing values
fn spec.withDefaultExpiration
withDefaultExpiration(defaultExpiration)
"Duration that static files should be cached by web proxies and browsers.\nOnly applicable if the corresponding StaticFilesHandler does not specify its own expiration time."
fn spec.withDeleteServiceOnDestroy
withDeleteServiceOnDestroy(deleteServiceOnDestroy)
"If set to 'true', the service will be deleted if it is the last version."
fn spec.withEnvVariables
withEnvVariables(envVariables)
fn spec.withEnvVariablesMixin
withEnvVariablesMixin(envVariables)
Note: This function appends passed data to existing values
fn spec.withHandlers
withHandlers(handlers)
"An ordered list of URL-matching patterns that should be applied to incoming requests.\nThe first matching URL handles the request and other request handlers are not attempted."
fn spec.withHandlersMixin
withHandlersMixin(handlers)
"An ordered list of URL-matching patterns that should be applied to incoming requests.\nThe first matching URL handles the request and other request handlers are not attempted."
Note: This function appends passed data to existing values
fn spec.withInboundServices
withInboundServices(inboundServices)
"A list of the types of messages that this application is able to receive. Possible values: [\"INBOUND_SERVICE_MAIL\", \"INBOUND_SERVICE_MAIL_BOUNCE\", \"INBOUND_SERVICE_XMPP_ERROR\", \"INBOUND_SERVICE_XMPP_MESSAGE\", \"INBOUND_SERVICE_XMPP_SUBSCRIBE\", \"INBOUND_SERVICE_XMPP_PRESENCE\", \"INBOUND_SERVICE_CHANNEL_PRESENCE\", \"INBOUND_SERVICE_WARMUP\"]."
fn spec.withInboundServicesMixin
withInboundServicesMixin(inboundServices)
"A list of the types of messages that this application is able to receive. Possible values: [\"INBOUND_SERVICE_MAIL\", \"INBOUND_SERVICE_MAIL_BOUNCE\", \"INBOUND_SERVICE_XMPP_ERROR\", \"INBOUND_SERVICE_XMPP_MESSAGE\", \"INBOUND_SERVICE_XMPP_SUBSCRIBE\", \"INBOUND_SERVICE_XMPP_PRESENCE\", \"INBOUND_SERVICE_CHANNEL_PRESENCE\", \"INBOUND_SERVICE_WARMUP\"]."
Note: This function appends passed data to existing values
fn spec.withInstanceClass
withInstanceClass(instanceClass)
"Instance class that is used to run this version. Valid values are\nAutomaticScaling: F1, F2, F4, F4_1G\nManualScaling: B1, B2, B4, B8, B4_1G\nDefaults to F1 for AutomaticScaling and B1 for ManualScaling."
fn spec.withNobuildFilesRegex
withNobuildFilesRegex(nobuildFilesRegex)
"Files that match this pattern will not be built into this version. Only applicable for Go runtimes."
fn spec.withNoopOnDestroy
withNoopOnDestroy(noopOnDestroy)
"If set to 'true', the application version will not be deleted."
fn spec.withProject
withProject(project)
"Immutable."
fn spec.withResourceID
withResourceID(resourceID)
"Immutable. Optional. The versionId of the resource. Used for creation and acquisition. When unset, the value of metadata.name
is used as the default."
fn spec.withRuntime
withRuntime(runtime)
"Desired runtime. Example python27."
fn spec.withRuntimeApiVersion
withRuntimeApiVersion(runtimeApiVersion)
"The version of the API in the given runtime environment.\nPlease see the app.yaml reference for valid values at 'https://cloud.google.com/appengine/docs/standard/
fn spec.withRuntimeChannel
withRuntimeChannel(runtimeChannel)
"The channel of the runtime to use. Only available for some runtimes."
fn spec.withRuntimeMainExecutablePath
withRuntimeMainExecutablePath(runtimeMainExecutablePath)
"The path or name of the app's main executable."
fn spec.withServiceAccount
withServiceAccount(serviceAccount)
"The identity that the deployed version will run as. Admin API will use the App Engine Appspot service account as\ndefault if this field is neither provided in app.yaml file nor through CLI flag."
fn spec.withServingStatus
withServingStatus(servingStatus)
"Current serving status of this version. Only the versions with a SERVING status create instances and can be billed. Default value: \"SERVING\" Possible values: [\"SERVING\", \"STOPPED\"]."
obj spec.apiConfig
"Serving configuration for Google Cloud Endpoints."
fn spec.apiConfig.withAuthFailAction
withAuthFailAction(authFailAction)
"Action to take when users access resources that require authentication. Default value: \"AUTH_FAIL_ACTION_REDIRECT\" Possible values: [\"AUTH_FAIL_ACTION_REDIRECT\", \"AUTH_FAIL_ACTION_UNAUTHORIZED\"]."
fn spec.apiConfig.withLogin
withLogin(login)
"Level of login required to access this resource. Default value: \"LOGIN_OPTIONAL\" Possible values: [\"LOGIN_OPTIONAL\", \"LOGIN_ADMIN\", \"LOGIN_REQUIRED\"]."
fn spec.apiConfig.withScript
withScript(script)
"Path to the script from the application root directory."
fn spec.apiConfig.withSecurityLevel
withSecurityLevel(securityLevel)
"Security (HTTPS) enforcement for this URL. Possible values: [\"SECURE_DEFAULT\", \"SECURE_NEVER\", \"SECURE_OPTIONAL\", \"SECURE_ALWAYS\"]."
fn spec.apiConfig.withUrl
withUrl(url)
"URL to serve the endpoint at."
obj spec.automaticScaling
"Automatic scaling is based on request rate, response latencies, and other application metrics."
fn spec.automaticScaling.withCoolDownPeriod
withCoolDownPeriod(coolDownPeriod)
"The time period that the Autoscaler should wait before it starts collecting information from a new instance.\nThis prevents the autoscaler from collecting information when the instance is initializing,\nduring which the collected usage would not be reliable. Default: 120s."
fn spec.automaticScaling.withMaxConcurrentRequests
withMaxConcurrentRequests(maxConcurrentRequests)
"Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance.\n\nDefaults to a runtime-specific value."
fn spec.automaticScaling.withMaxIdleInstances
withMaxIdleInstances(maxIdleInstances)
"Maximum number of idle instances that should be maintained for this version."
fn spec.automaticScaling.withMaxPendingLatency
withMaxPendingLatency(maxPendingLatency)
"Maximum amount of time that a request should wait in the pending queue before starting a new instance to handle it."
fn spec.automaticScaling.withMaxTotalInstances
withMaxTotalInstances(maxTotalInstances)
"Maximum number of instances that should be started to handle requests for this version. Default: 20."
fn spec.automaticScaling.withMinIdleInstances
withMinIdleInstances(minIdleInstances)
"Minimum number of idle instances that should be maintained for this version. Only applicable for the default version of a service."
fn spec.automaticScaling.withMinPendingLatency
withMinPendingLatency(minPendingLatency)
"Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it."
fn spec.automaticScaling.withMinTotalInstances
withMinTotalInstances(minTotalInstances)
"Minimum number of running instances that should be maintained for this version. Default: 2."
obj spec.automaticScaling.cpuUtilization
"Target scaling by CPU usage."
fn spec.automaticScaling.cpuUtilization.withAggregationWindowLength
withAggregationWindowLength(aggregationWindowLength)
"Period of time over which CPU utilization is calculated."
fn spec.automaticScaling.cpuUtilization.withTargetUtilization
withTargetUtilization(targetUtilization)
"Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1."
obj spec.automaticScaling.diskUtilization
"Target scaling by disk usage."
fn spec.automaticScaling.diskUtilization.withTargetReadBytesPerSecond
withTargetReadBytesPerSecond(targetReadBytesPerSecond)
"Target bytes read per second."
fn spec.automaticScaling.diskUtilization.withTargetReadOpsPerSecond
withTargetReadOpsPerSecond(targetReadOpsPerSecond)
"Target ops read per seconds."
fn spec.automaticScaling.diskUtilization.withTargetWriteBytesPerSecond
withTargetWriteBytesPerSecond(targetWriteBytesPerSecond)
"Target bytes written per second."
fn spec.automaticScaling.diskUtilization.withTargetWriteOpsPerSecond
withTargetWriteOpsPerSecond(targetWriteOpsPerSecond)
"Target ops written per second."
obj spec.automaticScaling.networkUtilization
"Target scaling by network usage."
fn spec.automaticScaling.networkUtilization.withTargetReceivedBytesPerSecond
withTargetReceivedBytesPerSecond(targetReceivedBytesPerSecond)
"Target bytes received per second."
fn spec.automaticScaling.networkUtilization.withTargetReceivedPacketsPerSecond
withTargetReceivedPacketsPerSecond(targetReceivedPacketsPerSecond)
"Target packets received per second."
fn spec.automaticScaling.networkUtilization.withTargetSentBytesPerSecond
withTargetSentBytesPerSecond(targetSentBytesPerSecond)
"Target bytes sent per second."
fn spec.automaticScaling.networkUtilization.withTargetSentPacketsPerSecond
withTargetSentPacketsPerSecond(targetSentPacketsPerSecond)
"Target packets sent per second."
obj spec.automaticScaling.requestUtilization
"Target scaling by request utilization."
fn spec.automaticScaling.requestUtilization.withTargetConcurrentRequests
withTargetConcurrentRequests(targetConcurrentRequests)
"Target number of concurrent requests."
fn spec.automaticScaling.requestUtilization.withTargetRequestCountPerSecond
withTargetRequestCountPerSecond(targetRequestCountPerSecond)
"Target requests per second."
obj spec.deployment
"Code and application artifacts that make up this version."
fn spec.deployment.withFiles
withFiles(files)
"Manifest of the files stored in Google Cloud Storage that are included as part of this version.\nAll files must be readable using the credentials supplied with this call."
fn spec.deployment.withFilesMixin
withFilesMixin(files)
"Manifest of the files stored in Google Cloud Storage that are included as part of this version.\nAll files must be readable using the credentials supplied with this call."
Note: This function appends passed data to existing values
obj spec.deployment.cloudBuildOptions
"Options for the build operations performed as a part of the version deployment. Only applicable when creating a version using source code directly."
fn spec.deployment.cloudBuildOptions.withAppYamlPath
withAppYamlPath(appYamlPath)
"Path to the yaml file used in deployment, used to determine runtime configuration details."
fn spec.deployment.cloudBuildOptions.withCloudBuildTimeout
withCloudBuildTimeout(cloudBuildTimeout)
"The Cloud Build timeout used as part of any dependent builds performed by version creation. Defaults to 10 minutes.\n\nA duration in seconds with up to nine fractional digits, terminated by 's'. Example: \"3.5s\"."
obj spec.deployment.container
"The Docker image for the container that runs the version."
fn spec.deployment.container.withImage
withImage(image)
"URI to the hosted container image in Google Container Registry. The URI must be fully qualified and include a tag or digest.\nExamples: \"gcr.io/my-project/image:tag\" or \"gcr.io/my-project/image@digest\"."
obj spec.deployment.files
"Manifest of the files stored in Google Cloud Storage that are included as part of this version.\nAll files must be readable using the credentials supplied with this call."
fn spec.deployment.files.withName
withName(name)
fn spec.deployment.files.withSha1Sum
withSha1Sum(sha1Sum)
"SHA1 checksum of the file."
fn spec.deployment.files.withSourceUrl
withSourceUrl(sourceUrl)
"Source URL."
obj spec.deployment.zip
"Zip File."
fn spec.deployment.zip.withFilesCount
withFilesCount(filesCount)
"files count."
fn spec.deployment.zip.withSourceUrl
withSourceUrl(sourceUrl)
"Source URL."
obj spec.endpointsApiService
"Code and application artifacts that make up this version."
fn spec.endpointsApiService.withConfigId
withConfigId(configId)
"Endpoints service configuration ID as specified by the Service Management API. For example \"2016-09-19r1\".\n\nBy default, the rollout strategy for Endpoints is \"FIXED\". This means that Endpoints starts up with a particular configuration ID.\nWhen a new configuration is rolled out, Endpoints must be given the new configuration ID. The configId field is used to give the configuration ID\nand is required in this case.\n\nEndpoints also has a rollout strategy called \"MANAGED\". When using this, Endpoints fetches the latest configuration and does not need\nthe configuration ID. In this case, configId must be omitted."
fn spec.endpointsApiService.withDisableTraceSampling
withDisableTraceSampling(disableTraceSampling)
"Enable or disable trace sampling. By default, this is set to false for enabled."
fn spec.endpointsApiService.withName
withName(name)
"Endpoints service name which is the name of the \"service\" resource in the Service Management API.\nFor example \"myapi.endpoints.myproject.cloud.goog\"."
fn spec.endpointsApiService.withRolloutStrategy
withRolloutStrategy(rolloutStrategy)
"Endpoints rollout strategy. If FIXED, configId must be specified. If MANAGED, configId must be omitted. Default value: \"FIXED\" Possible values: [\"FIXED\", \"MANAGED\"]."
obj spec.entrypoint
"The entrypoint for the application."
fn spec.entrypoint.withShell
withShell(shell)
"The format should be a shell command that can be fed to bash -c."
obj spec.handlers
"An ordered list of URL-matching patterns that should be applied to incoming requests.\nThe first matching URL handles the request and other request handlers are not attempted."
fn spec.handlers.withAuthFailAction
withAuthFailAction(authFailAction)
"Actions to take when the user is not logged in. Possible values: [\"AUTH_FAIL_ACTION_REDIRECT\", \"AUTH_FAIL_ACTION_UNAUTHORIZED\"]."
fn spec.handlers.withLogin
withLogin(login)
"Methods to restrict access to a URL based on login status. Possible values: [\"LOGIN_OPTIONAL\", \"LOGIN_ADMIN\", \"LOGIN_REQUIRED\"]."
fn spec.handlers.withRedirectHttpResponseCode
withRedirectHttpResponseCode(redirectHttpResponseCode)
"30x code to use when performing redirects for the secure field. Possible values: [\"REDIRECT_HTTP_RESPONSE_CODE_301\", \"REDIRECT_HTTP_RESPONSE_CODE_302\", \"REDIRECT_HTTP_RESPONSE_CODE_303\", \"REDIRECT_HTTP_RESPONSE_CODE_307\"]."
fn spec.handlers.withSecurityLevel
withSecurityLevel(securityLevel)
"Security (HTTPS) enforcement for this URL. Possible values: [\"SECURE_DEFAULT\", \"SECURE_NEVER\", \"SECURE_OPTIONAL\", \"SECURE_ALWAYS\"]."
fn spec.handlers.withUrlRegex
withUrlRegex(urlRegex)
"URL prefix. Uses regular expression syntax, which means regexp special characters must be escaped, but should not contain groupings.\nAll URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path."
obj spec.handlers.script
"Executes a script to handle the requests that match this URL pattern.\nOnly the auto value is supported for Node.js in the App Engine standard environment, for example \"script:\" \"auto\"."
fn spec.handlers.script.withScriptPath
withScriptPath(scriptPath)
"Path to the script from the application root directory."
obj spec.handlers.staticFiles
"Files served directly to the user for a given URL, such as images, CSS stylesheets, or JavaScript source files.\nStatic file handlers describe which files in the application directory are static files, and which URLs serve them."
fn spec.handlers.staticFiles.withApplicationReadable
withApplicationReadable(applicationReadable)
"Whether files should also be uploaded as code data. By default, files declared in static file handlers are\nuploaded as static data and are only served to end users; they cannot be read by the application. If enabled,\nuploads are charged against both your code and static data storage resource quotas."
fn spec.handlers.staticFiles.withExpiration
withExpiration(expiration)
"Time a static file served by this handler should be cached by web proxies and browsers.\nA duration in seconds with up to nine fractional digits, terminated by 's'. Example \"3.5s\".\nDefault is '0s'."
fn spec.handlers.staticFiles.withHttpHeaders
withHttpHeaders(httpHeaders)
"HTTP headers to use for all responses from these URLs.\nAn object containing a list of \"key:value\" value pairs.\"."
fn spec.handlers.staticFiles.withHttpHeadersMixin
withHttpHeadersMixin(httpHeaders)
"HTTP headers to use for all responses from these URLs.\nAn object containing a list of \"key:value\" value pairs.\"."
Note: This function appends passed data to existing values
fn spec.handlers.staticFiles.withMimeType
withMimeType(mimeType)
"MIME type used to serve all files served by this handler.\nDefaults to file-specific MIME types, which are derived from each file's filename extension."
fn spec.handlers.staticFiles.withPath
withPath(path)
"Path to the static files matched by the URL pattern, from the application root directory.\nThe path can refer to text matched in groupings in the URL pattern."
fn spec.handlers.staticFiles.withRequireMatchingFile
withRequireMatchingFile(requireMatchingFile)
"Whether this handler should match the request if the file referenced by the handler does not exist."
fn spec.handlers.staticFiles.withUploadPathRegex
withUploadPathRegex(uploadPathRegex)
"Regular expression that matches the file paths for all files that should be referenced by this handler."
obj spec.livenessCheck
"Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances."
fn spec.livenessCheck.withCheckInterval
withCheckInterval(checkInterval)
"Interval between health checks."
fn spec.livenessCheck.withFailureThreshold
withFailureThreshold(failureThreshold)
"Number of consecutive failed checks required before considering the VM unhealthy. Default: 4."
fn spec.livenessCheck.withHost
withHost(host)
"Host header to send when performing a HTTP Readiness check. Example: \"myapp.appspot.com\"."
fn spec.livenessCheck.withInitialDelay
withInitialDelay(initialDelay)
"The initial delay before starting to execute the checks. Default: \"300s\"."
fn spec.livenessCheck.withPath
withPath(path)
"The request path."
fn spec.livenessCheck.withSuccessThreshold
withSuccessThreshold(successThreshold)
"Number of consecutive successful checks required before considering the VM healthy. Default: 2."
fn spec.livenessCheck.withTimeout
withTimeout(timeout)
"Time before the check is considered failed. Default: \"4s\"."
obj spec.manualScaling
"A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time."
fn spec.manualScaling.withInstances
withInstances(instances)
"Number of instances to assign to the service at the start.\n\nNote: When managing the number of instances at runtime through the App Engine Admin API or the (now deprecated) Python 2\nModules API set_num_instances() you must use 'lifecycle.ignore_changes = [\"manual_scaling\"[0].instances]' to prevent drift detection."
obj spec.network
"Extra network settings."
fn spec.network.withForwardedPorts
withForwardedPorts(forwardedPorts)
"List of ports, or port pairs, to forward from the virtual machine to the application container."
fn spec.network.withForwardedPortsMixin
withForwardedPortsMixin(forwardedPorts)
"List of ports, or port pairs, to forward from the virtual machine to the application container."
Note: This function appends passed data to existing values
fn spec.network.withInstanceTag
withInstanceTag(instanceTag)
"Tag to apply to the instance during creation."
fn spec.network.withName
withName(name)
"Google Compute Engine network where the virtual machines are created. Specify the short name, not the resource path."
fn spec.network.withSessionAffinity
withSessionAffinity(sessionAffinity)
"Enable session affinity."
fn spec.network.withSubnetwork
withSubnetwork(subnetwork)
"Google Cloud Platform sub-network where the virtual machines are created. Specify the short name, not the resource path.\n\nIf the network that the instance is being created in is a Legacy network, then the IP address is allocated from the IPv4Range.\nIf the network that the instance is being created in is an auto Subnet Mode Network, then only network name should be specified (not the subnetworkName) and the IP address is created from the IPCidrRange of the subnetwork that exists in that zone for that network.\nIf the network that the instance is being created in is a custom Subnet Mode Network, then the subnetworkName must be specified and the IP address is created from the IPCidrRange of the subnetwork.\nIf specified, the subnetwork must exist in the same region as the App Engine flexible environment application."
obj spec.readinessCheck
"Configures readiness health checking for instances. Unhealthy instances are not put into the backend traffic rotation."
fn spec.readinessCheck.withAppStartTimeout
withAppStartTimeout(appStartTimeout)
"A maximum time limit on application initialization, measured from moment the application successfully\nreplies to a healthcheck until it is ready to serve traffic. Default: \"300s\"."
fn spec.readinessCheck.withCheckInterval
withCheckInterval(checkInterval)
"Interval between health checks. Default: \"5s\"."
fn spec.readinessCheck.withFailureThreshold
withFailureThreshold(failureThreshold)
"Number of consecutive failed checks required before removing traffic. Default: 2."
fn spec.readinessCheck.withHost
withHost(host)
"Host header to send when performing a HTTP Readiness check. Example: \"myapp.appspot.com\"."
fn spec.readinessCheck.withPath
withPath(path)
"The request path."
fn spec.readinessCheck.withSuccessThreshold
withSuccessThreshold(successThreshold)
"Number of consecutive successful checks required before receiving traffic. Default: 2."
fn spec.readinessCheck.withTimeout
withTimeout(timeout)
"Time before the check is considered failed. Default: \"4s\"."
obj spec.resources
"Machine resources for a version."
fn spec.resources.withCpu
withCpu(cpu)
"Number of CPU cores needed."
fn spec.resources.withDiskGb
withDiskGb(diskGb)
"Disk size (GB) needed."
fn spec.resources.withMemoryGb
withMemoryGb(memoryGb)
"Memory (GB) needed."
fn spec.resources.withVolumes
withVolumes(volumes)
"List of ports, or port pairs, to forward from the virtual machine to the application container."
fn spec.resources.withVolumesMixin
withVolumesMixin(volumes)
"List of ports, or port pairs, to forward from the virtual machine to the application container."
Note: This function appends passed data to existing values
obj spec.resources.volumes
"List of ports, or port pairs, to forward from the virtual machine to the application container."
fn spec.resources.volumes.withName
withName(name)
"Unique name for the volume."
fn spec.resources.volumes.withSizeGb
withSizeGb(sizeGb)
"Volume size in gigabytes."
fn spec.resources.volumes.withVolumeType
withVolumeType(volumeType)
"Underlying volume type, e.g. 'tmpfs'."
obj spec.serviceRef
fn spec.serviceRef.withExternal
withExternal(external)
"Allowed value: The name
field of an AppEngineService
resource."
fn spec.serviceRef.withName
withName(name)
"Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names"
fn spec.serviceRef.withNamespace
withNamespace(namespace)
"Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/"
obj spec.vpcAccessConnector
"Enables VPC connectivity for standard apps."
fn spec.vpcAccessConnector.withName
withName(name)
"Full Serverless VPC Access Connector name e.g. /projects/my-project/locations/us-central1/connectors/c1."