| <html><body> |
| <style> |
| |
| body, h1, h2, h3, div, span, p, pre, a { |
| margin: 0; |
| padding: 0; |
| border: 0; |
| font-weight: inherit; |
| font-style: inherit; |
| font-size: 100%; |
| font-family: inherit; |
| vertical-align: baseline; |
| } |
| |
| body { |
| font-size: 13px; |
| padding: 1em; |
| } |
| |
| h1 { |
| font-size: 26px; |
| margin-bottom: 1em; |
| } |
| |
| h2 { |
| font-size: 24px; |
| margin-bottom: 1em; |
| } |
| |
| h3 { |
| font-size: 20px; |
| margin-bottom: 1em; |
| margin-top: 1em; |
| } |
| |
| pre, code { |
| line-height: 1.5; |
| font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; |
| } |
| |
| pre { |
| margin-top: 0.5em; |
| } |
| |
| h1, h2, h3, p { |
| font-family: Arial, sans serif; |
| } |
| |
| h1, h2, h3 { |
| border-bottom: solid #CCC 1px; |
| } |
| |
| .toc_element { |
| margin-top: 0.5em; |
| } |
| |
| .firstline { |
| margin-left: 2 em; |
| } |
| |
| .method { |
| margin-top: 1em; |
| border: solid 1px #CCC; |
| padding: 1em; |
| background: #EEE; |
| } |
| |
| .details { |
| font-weight: bold; |
| font-size: 14px; |
| } |
| |
| </style> |
| |
| <h1><a href="cloudfunctions_v1beta2.html">Cloud Functions API</a> . <a href="cloudfunctions_v1beta2.projects.html">projects</a> . <a href="cloudfunctions_v1beta2.projects.locations.html">locations</a> . <a href="cloudfunctions_v1beta2.projects.locations.functions.html">functions</a></h1> |
| <h2>Instance Methods</h2> |
| <p class="toc_element"> |
| <code><a href="#call">call(name, body=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Synchronously invokes a deployed Cloud Function. To be used for testing</p> |
| <p class="toc_element"> |
| <code><a href="#create">create(location, body=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Creates a new function. If a function with the given name already exists in</p> |
| <p class="toc_element"> |
| <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p> |
| <p class="firstline">Deletes a function with the given name from the specified project. If the</p> |
| <p class="toc_element"> |
| <code><a href="#generateDownloadUrl">generateDownloadUrl(name, body=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Returns a signed URL for downloading deployed function source code.</p> |
| <p class="toc_element"> |
| <code><a href="#generateUploadUrl">generateUploadUrl(parent, body=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Returns a signed URL for uploading a function source code.</p> |
| <p class="toc_element"> |
| <code><a href="#get">get(name, x__xgafv=None)</a></code></p> |
| <p class="firstline">Returns a function with the given name from the requested project.</p> |
| <p class="toc_element"> |
| <code><a href="#list">list(location, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Returns a list of functions that belong to the requested project.</p> |
| <p class="toc_element"> |
| <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> |
| <p class="firstline">Retrieves the next page of results.</p> |
| <p class="toc_element"> |
| <code><a href="#update">update(name, body=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Updates existing function.</p> |
| <h3>Method Details</h3> |
| <div class="method"> |
| <code class="details" id="call">call(name, body=None, x__xgafv=None)</code> |
| <pre>Synchronously invokes a deployed Cloud Function. To be used for testing |
| purposes as very limited traffic is allowed. For more information on |
| the actual limits refer to [API Calls]( |
| https://cloud.google.com/functions/quotas#rate_limits). |
| |
| Args: |
| name: string, Required. The name of the function to be called. (required) |
| body: object, The request body. |
| The object takes the form of: |
| |
| { # Request for the `CallFunction` method. |
| "data": "A String", # Required. Input to be passed to the function. |
| } |
| |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { # Response of `CallFunction` method. |
| "result": "A String", # Result populated for successful execution of synchronous function. Will |
| # not be populated if function does not return a result through context. |
| "executionId": "A String", # Execution id of function invocation. |
| "error": "A String", # Either system or user-function generated error. Set if execution |
| # was not successful. |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="create">create(location, body=None, x__xgafv=None)</code> |
| <pre>Creates a new function. If a function with the given name already exists in |
| the specified project, the long running operation will return |
| `ALREADY_EXISTS` error. |
| |
| Args: |
| location: string, Required. The project and location in which the function should be created, specified |
| in the format `projects/*/locations/*` (required) |
| body: object, The request body. |
| The object takes the form of: |
| |
| { # Describes a Cloud Function that contains user computation executed in |
| # response to an event. It encapsulate function and triggers configurations. |
| "timeout": "A String", # The function execution timeout. Execution is considered failed and |
| # can be terminated if the function is not completed at the end of the |
| # timeout period. Defaults to 60 seconds. |
| "runtime": "A String", # The runtime in which to run the function. Required when deploying a new |
| # function, optional when updating an existing function. For a complete |
| # list of possible choices, see the |
| # [`gcloud` command |
| # reference](/sdk/gcloud/reference/functions/deploy#--runtime). |
| "eventTrigger": { # Describes EventTrigger, used to request events be sent from another # A source that fires events in response to a condition in another service. |
| # service. |
| "failurePolicy": { # Describes the policy in case of function's execution failure. # Specifies policy for failed executions. |
| # If empty, then defaults to ignoring failures (i.e. not retrying them). |
| "retry": { # Describes the retry policy in case of function's execution failure. # If specified, then the function will be retried in case of a failure. |
| # A function execution will be retried on any failure. |
| # A failed execution will be retried up to 7 days with an exponential backoff |
| # (capped at 10 seconds). |
| # Retried execution is charged as any other execution. |
| }, |
| }, |
| "resource": "A String", # Which instance of the source's service should send events. E.g. for Pub/Sub |
| # this would be a Pub/Sub topic at `projects/*/topics/*`. For Google Cloud |
| # Storage this would be a bucket at `projects/*/buckets/*`. For any source |
| # that only supports one instance per-project, this should be the name of the |
| # project (`projects/*`) |
| "service": "A String", # The hostname of the service that should be observed. |
| # |
| # If no string is provided, the default service implementing the API will |
| # be used. For example, `storage.googleapis.com` is the default for all |
| # event types in the `google.storage` namespace. |
| "eventType": "A String", # `event_type` names contain the service that is sending an event and the |
| # kind of event that was fired. Must be of the form |
| # `providers/*/eventTypes/*` e.g. Directly handle a Message published to |
| # Google Cloud Pub/Sub `providers/cloud.pubsub/eventTypes/topic.publish`. |
| # |
| # Handle an object changing in Google Cloud Storage: |
| # `providers/cloud.storage/eventTypes/object.change` |
| # |
| # Handle a write to the Firebase Realtime Database: |
| # `providers/google.firebase.database/eventTypes/ref.write` |
| }, |
| "serviceAccount": "A String", # The email of the function's service account. If empty, defaults to |
| # `{project_id}@appspot.gserviceaccount.com`. |
| "entryPoint": "A String", # The name of the function (as defined in source code) that will be |
| # executed. Defaults to the resource name suffix, if not specified. For |
| # backward compatibility, if function with given name is not found, then the |
| # system will try to use function named "function". |
| # For Node.js this is name of a function exported by the module specified |
| # in `source_location`. |
| "status": "A String", # Output only. Status of the function deployment. |
| "sourceRepositoryUrl": "A String", # The URL pointing to the hosted repository where the function is defined. |
| # There are supported Cloud Source Repository URLs in the following |
| # formats: |
| # |
| # To refer to a specific commit: |
| # `https://source.developers.google.com/projects/*/repos/*/revisions/*/paths/*` |
| # To refer to a moveable alias (branch): |
| # `https://source.developers.google.com/projects/*/repos/*/moveable-aliases/*/paths/*` |
| # In particular, to refer to HEAD use `master` moveable alias. |
| # To refer to a specific fixed alias (tag): |
| # `https://source.developers.google.com/projects/*/repos/*/fixed-aliases/*/paths/*` |
| # |
| # You may omit `paths/*` if you want to use the main directory. |
| "environmentVariables": { # Environment variables that shall be available during function execution. |
| "a_key": "A String", |
| }, |
| "labels": { # Labels associated with this Cloud Function. |
| "a_key": "A String", |
| }, |
| "updateTime": "A String", # Output only. The last update timestamp of a Cloud Function. |
| "vpcConnector": "A String", # The VPC Network Connector that this cloud function can connect to. It can |
| # be either the fully-qualified URI, or the short name of the network |
| # connector resource. The format of this field is |
| # `projects/*/locations/*/connectors/*` |
| # |
| # This field is mutually exclusive with `network` field and will eventually |
| # replace it. |
| # |
| # See [the VPC documentation](https://cloud.google.com/compute/docs/vpc) for |
| # more information on connecting Cloud projects. |
| "latestOperation": "A String", # Output only. Name of the most recent operation modifying the function. If |
| # the function status is `DEPLOYING` or `DELETING`, then it points to the |
| # active operation. |
| "httpsTrigger": { # Describes HTTPSTrigger, could be used to connect web hooks to function. # An HTTPS endpoint type of source that can be triggered via URL. |
| "url": "A String", # Output only. The deployed url for the function. |
| }, |
| "sourceArchiveUrl": "A String", # The Google Cloud Storage URL, starting with gs://, pointing to the zip |
| # archive which contains the function. |
| "sourceUploadUrl": "A String", # The Google Cloud Storage signed URL used for source uploading, generated |
| # by google.cloud.functions.v1beta2.GenerateUploadUrl |
| "maxInstances": 42, # The limit on the maximum number of function instances that may coexist at a |
| # given time. |
| "sourceRepository": { # Describes the location of the function source in a remote repository. # The hosted repository where the function is defined. |
| "tag": "A String", # The name of the tag that captures the state of the repository from |
| # which the function should be fetched. |
| "repositoryUrl": "A String", # URL to the hosted repository where the function is defined. Only paths in |
| # https://source.developers.google.com domain are supported. The path should |
| # contain the name of the repository. |
| "deployedRevision": "A String", # Output only. The id of the revision that was resolved at the moment of |
| # function creation or update. For example when a user deployed from a |
| # branch, it will be the revision id of the latest change on this branch at |
| # that time. If user deployed from revision then this value will be always |
| # equal to the revision specified by the user. |
| "revision": "A String", # The id of the revision that captures the state of the repository from |
| # which the function should be fetched. |
| "sourcePath": "A String", # The path within the repository where the function is defined. The path |
| # should point to the directory where Cloud Functions files are located. Use |
| # "/" if the function is defined directly in the root directory of a |
| # repository. |
| "branch": "A String", # The name of the branch from which the function should be fetched. |
| }, |
| "network": "A String", # The VPC Network that this cloud function can connect to. It can be |
| # either the fully-qualified URI, or the short name of the network resource. |
| # If the short network name is used, the network must belong to the same |
| # project. Otherwise, it must belong to a project within the same |
| # organization. The format of this field is either |
| # `projects/{project}/global/networks/{network}` or `{network}`, where |
| # {project} is a project id where the network is defined, and {network} is |
| # the short name of the network. |
| # |
| # This field is mutually exclusive with `vpc_connector` and will be replaced |
| # by it. |
| # |
| # See [the VPC documentation](https://cloud.google.com/compute/docs/vpc) for |
| # more information on connecting Cloud projects. |
| "versionId": "A String", # Output only. The version identifier of the Cloud Function. Each deployment attempt |
| # results in a new version of a function being created. |
| "availableMemoryMb": 42, # The amount of memory in MB available for a function. |
| # Defaults to 256MB. |
| "name": "A String", # A user-defined name of the function. Function names must be unique |
| # globally and match pattern `projects/*/locations/*/functions/*` |
| } |
| |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { # This resource represents a long-running operation that is the result of a |
| # network API call. |
| "response": { # The normal response of the operation in case of success. If the original |
| # method returns no data on success, such as `Delete`, the response is |
| # `google.protobuf.Empty`. If the original method is standard |
| # `Get`/`Create`/`Update`, the response should be the resource. For other |
| # methods, the response should have the type `XxxResponse`, where `Xxx` |
| # is the original method name. For example, if the original method name |
| # is `TakeSnapshot()`, the inferred response type is |
| # `TakeSnapshotResponse`. |
| "a_key": "", # Properties of the object. Contains field @type with type URL. |
| }, |
| "metadata": { # Service-specific metadata associated with the operation. It typically |
| # contains progress information and common metadata such as create time. |
| # Some services might not provide such metadata. Any method that returns a |
| # long-running operation should document the metadata type, if any. |
| "a_key": "", # Properties of the object. Contains field @type with type URL. |
| }, |
| "name": "A String", # The server-assigned name, which is only unique within the same service that |
| # originally returns it. If you use the default HTTP mapping, the |
| # `name` should be a resource name ending with `operations/{unique_id}`. |
| "done": True or False, # If the value is `false`, it means the operation is still in progress. |
| # If `true`, the operation is completed, and either `error` or `response` is |
| # available. |
| "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation. |
| # different programming environments, including REST APIs and RPC APIs. It is |
| # used by [gRPC](https://github.com/grpc). Each `Status` message contains |
| # three pieces of data: error code, error message, and error details. |
| # |
| # You can find out more about this error model and how to work with it in the |
| # [API Design Guide](https://cloud.google.com/apis/design/errors). |
| "code": 42, # The status code, which should be an enum value of google.rpc.Code. |
| "details": [ # A list of messages that carry the error details. There is a common set of |
| # message types for APIs to use. |
| { |
| "a_key": "", # Properties of the object. Contains field @type with type URL. |
| }, |
| ], |
| "message": "A String", # A developer-facing error message, which should be in English. Any |
| # user-facing error message should be localized and sent in the |
| # google.rpc.Status.details field, or localized by the client. |
| }, |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="delete">delete(name, x__xgafv=None)</code> |
| <pre>Deletes a function with the given name from the specified project. If the |
| given function is used by some trigger, the trigger will be updated to |
| remove this function. |
| |
| Args: |
| name: string, Required. The name of the function which should be deleted. (required) |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { # This resource represents a long-running operation that is the result of a |
| # network API call. |
| "response": { # The normal response of the operation in case of success. If the original |
| # method returns no data on success, such as `Delete`, the response is |
| # `google.protobuf.Empty`. If the original method is standard |
| # `Get`/`Create`/`Update`, the response should be the resource. For other |
| # methods, the response should have the type `XxxResponse`, where `Xxx` |
| # is the original method name. For example, if the original method name |
| # is `TakeSnapshot()`, the inferred response type is |
| # `TakeSnapshotResponse`. |
| "a_key": "", # Properties of the object. Contains field @type with type URL. |
| }, |
| "metadata": { # Service-specific metadata associated with the operation. It typically |
| # contains progress information and common metadata such as create time. |
| # Some services might not provide such metadata. Any method that returns a |
| # long-running operation should document the metadata type, if any. |
| "a_key": "", # Properties of the object. Contains field @type with type URL. |
| }, |
| "name": "A String", # The server-assigned name, which is only unique within the same service that |
| # originally returns it. If you use the default HTTP mapping, the |
| # `name` should be a resource name ending with `operations/{unique_id}`. |
| "done": True or False, # If the value is `false`, it means the operation is still in progress. |
| # If `true`, the operation is completed, and either `error` or `response` is |
| # available. |
| "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation. |
| # different programming environments, including REST APIs and RPC APIs. It is |
| # used by [gRPC](https://github.com/grpc). Each `Status` message contains |
| # three pieces of data: error code, error message, and error details. |
| # |
| # You can find out more about this error model and how to work with it in the |
| # [API Design Guide](https://cloud.google.com/apis/design/errors). |
| "code": 42, # The status code, which should be an enum value of google.rpc.Code. |
| "details": [ # A list of messages that carry the error details. There is a common set of |
| # message types for APIs to use. |
| { |
| "a_key": "", # Properties of the object. Contains field @type with type URL. |
| }, |
| ], |
| "message": "A String", # A developer-facing error message, which should be in English. Any |
| # user-facing error message should be localized and sent in the |
| # google.rpc.Status.details field, or localized by the client. |
| }, |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="generateDownloadUrl">generateDownloadUrl(name, body=None, x__xgafv=None)</code> |
| <pre>Returns a signed URL for downloading deployed function source code. |
| The URL is only valid for a limited period and should be used within |
| minutes after generation. |
| For more information about the signed URL usage see: |
| https://cloud.google.com/storage/docs/access-control/signed-urls |
| |
| Args: |
| name: string, The name of function for which source code Google Cloud Storage signed |
| URL should be generated. (required) |
| body: object, The request body. |
| The object takes the form of: |
| |
| { # Request of `GenerateDownloadUrl` method. |
| "versionId": "A String", # The optional version of function. |
| } |
| |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { # Response of `GenerateDownloadUrl` method. |
| "downloadUrl": "A String", # The generated Google Cloud Storage signed URL that should be used for |
| # function source code download. |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="generateUploadUrl">generateUploadUrl(parent, body=None, x__xgafv=None)</code> |
| <pre>Returns a signed URL for uploading a function source code. |
| For more information about the signed URL usage see: |
| https://cloud.google.com/storage/docs/access-control/signed-urls |
| Once the function source code upload is complete, the used signed |
| URL should be provided in CreateFunction or UpdateFunction request |
| as a reference to the function source code. |
| |
| When uploading source code to the generated signed URL, please follow |
| these restrictions: |
| |
| * Source file type should be a zip file. |
| * Source file size should not exceed 100MB limit. |
| * No credentials should be attached - the signed URLs provide access to the |
| target bucket using internal service identity; if credentials were |
| attached, the identity from the credentials would be used, but that |
| identity does not have permissions to upload files to the URL. |
| |
| When making a HTTP PUT request, these two headers need to be specified: |
| |
| * `content-type: application/zip` |
| * `x-goog-content-length-range: 0,104857600` |
| |
| And this header SHOULD NOT be specified: |
| |
| * `Authorization: Bearer YOUR_TOKEN` |
| |
| Args: |
| parent: string, The project and location in which the Google Cloud Storage signed URL |
| should be generated, specified in the format `projects/*/locations/*`. (required) |
| body: object, The request body. |
| The object takes the form of: |
| |
| { # Request of `GenerateUploadUrl` method. |
| } |
| |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { # Response of `GenerateUploadUrl` method. |
| "uploadUrl": "A String", # The generated Google Cloud Storage signed URL that should be used for a |
| # function source code upload. The uploaded file should be a zip archive |
| # which contains a function. |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="get">get(name, x__xgafv=None)</code> |
| <pre>Returns a function with the given name from the requested project. |
| |
| Args: |
| name: string, Required. The name of the function which details should be obtained. (required) |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { # Describes a Cloud Function that contains user computation executed in |
| # response to an event. It encapsulate function and triggers configurations. |
| "timeout": "A String", # The function execution timeout. Execution is considered failed and |
| # can be terminated if the function is not completed at the end of the |
| # timeout period. Defaults to 60 seconds. |
| "runtime": "A String", # The runtime in which to run the function. Required when deploying a new |
| # function, optional when updating an existing function. For a complete |
| # list of possible choices, see the |
| # [`gcloud` command |
| # reference](/sdk/gcloud/reference/functions/deploy#--runtime). |
| "eventTrigger": { # Describes EventTrigger, used to request events be sent from another # A source that fires events in response to a condition in another service. |
| # service. |
| "failurePolicy": { # Describes the policy in case of function's execution failure. # Specifies policy for failed executions. |
| # If empty, then defaults to ignoring failures (i.e. not retrying them). |
| "retry": { # Describes the retry policy in case of function's execution failure. # If specified, then the function will be retried in case of a failure. |
| # A function execution will be retried on any failure. |
| # A failed execution will be retried up to 7 days with an exponential backoff |
| # (capped at 10 seconds). |
| # Retried execution is charged as any other execution. |
| }, |
| }, |
| "resource": "A String", # Which instance of the source's service should send events. E.g. for Pub/Sub |
| # this would be a Pub/Sub topic at `projects/*/topics/*`. For Google Cloud |
| # Storage this would be a bucket at `projects/*/buckets/*`. For any source |
| # that only supports one instance per-project, this should be the name of the |
| # project (`projects/*`) |
| "service": "A String", # The hostname of the service that should be observed. |
| # |
| # If no string is provided, the default service implementing the API will |
| # be used. For example, `storage.googleapis.com` is the default for all |
| # event types in the `google.storage` namespace. |
| "eventType": "A String", # `event_type` names contain the service that is sending an event and the |
| # kind of event that was fired. Must be of the form |
| # `providers/*/eventTypes/*` e.g. Directly handle a Message published to |
| # Google Cloud Pub/Sub `providers/cloud.pubsub/eventTypes/topic.publish`. |
| # |
| # Handle an object changing in Google Cloud Storage: |
| # `providers/cloud.storage/eventTypes/object.change` |
| # |
| # Handle a write to the Firebase Realtime Database: |
| # `providers/google.firebase.database/eventTypes/ref.write` |
| }, |
| "serviceAccount": "A String", # The email of the function's service account. If empty, defaults to |
| # `{project_id}@appspot.gserviceaccount.com`. |
| "entryPoint": "A String", # The name of the function (as defined in source code) that will be |
| # executed. Defaults to the resource name suffix, if not specified. For |
| # backward compatibility, if function with given name is not found, then the |
| # system will try to use function named "function". |
| # For Node.js this is name of a function exported by the module specified |
| # in `source_location`. |
| "status": "A String", # Output only. Status of the function deployment. |
| "sourceRepositoryUrl": "A String", # The URL pointing to the hosted repository where the function is defined. |
| # There are supported Cloud Source Repository URLs in the following |
| # formats: |
| # |
| # To refer to a specific commit: |
| # `https://source.developers.google.com/projects/*/repos/*/revisions/*/paths/*` |
| # To refer to a moveable alias (branch): |
| # `https://source.developers.google.com/projects/*/repos/*/moveable-aliases/*/paths/*` |
| # In particular, to refer to HEAD use `master` moveable alias. |
| # To refer to a specific fixed alias (tag): |
| # `https://source.developers.google.com/projects/*/repos/*/fixed-aliases/*/paths/*` |
| # |
| # You may omit `paths/*` if you want to use the main directory. |
| "environmentVariables": { # Environment variables that shall be available during function execution. |
| "a_key": "A String", |
| }, |
| "labels": { # Labels associated with this Cloud Function. |
| "a_key": "A String", |
| }, |
| "updateTime": "A String", # Output only. The last update timestamp of a Cloud Function. |
| "vpcConnector": "A String", # The VPC Network Connector that this cloud function can connect to. It can |
| # be either the fully-qualified URI, or the short name of the network |
| # connector resource. The format of this field is |
| # `projects/*/locations/*/connectors/*` |
| # |
| # This field is mutually exclusive with `network` field and will eventually |
| # replace it. |
| # |
| # See [the VPC documentation](https://cloud.google.com/compute/docs/vpc) for |
| # more information on connecting Cloud projects. |
| "latestOperation": "A String", # Output only. Name of the most recent operation modifying the function. If |
| # the function status is `DEPLOYING` or `DELETING`, then it points to the |
| # active operation. |
| "httpsTrigger": { # Describes HTTPSTrigger, could be used to connect web hooks to function. # An HTTPS endpoint type of source that can be triggered via URL. |
| "url": "A String", # Output only. The deployed url for the function. |
| }, |
| "sourceArchiveUrl": "A String", # The Google Cloud Storage URL, starting with gs://, pointing to the zip |
| # archive which contains the function. |
| "sourceUploadUrl": "A String", # The Google Cloud Storage signed URL used for source uploading, generated |
| # by google.cloud.functions.v1beta2.GenerateUploadUrl |
| "maxInstances": 42, # The limit on the maximum number of function instances that may coexist at a |
| # given time. |
| "sourceRepository": { # Describes the location of the function source in a remote repository. # The hosted repository where the function is defined. |
| "tag": "A String", # The name of the tag that captures the state of the repository from |
| # which the function should be fetched. |
| "repositoryUrl": "A String", # URL to the hosted repository where the function is defined. Only paths in |
| # https://source.developers.google.com domain are supported. The path should |
| # contain the name of the repository. |
| "deployedRevision": "A String", # Output only. The id of the revision that was resolved at the moment of |
| # function creation or update. For example when a user deployed from a |
| # branch, it will be the revision id of the latest change on this branch at |
| # that time. If user deployed from revision then this value will be always |
| # equal to the revision specified by the user. |
| "revision": "A String", # The id of the revision that captures the state of the repository from |
| # which the function should be fetched. |
| "sourcePath": "A String", # The path within the repository where the function is defined. The path |
| # should point to the directory where Cloud Functions files are located. Use |
| # "/" if the function is defined directly in the root directory of a |
| # repository. |
| "branch": "A String", # The name of the branch from which the function should be fetched. |
| }, |
| "network": "A String", # The VPC Network that this cloud function can connect to. It can be |
| # either the fully-qualified URI, or the short name of the network resource. |
| # If the short network name is used, the network must belong to the same |
| # project. Otherwise, it must belong to a project within the same |
| # organization. The format of this field is either |
| # `projects/{project}/global/networks/{network}` or `{network}`, where |
| # {project} is a project id where the network is defined, and {network} is |
| # the short name of the network. |
| # |
| # This field is mutually exclusive with `vpc_connector` and will be replaced |
| # by it. |
| # |
| # See [the VPC documentation](https://cloud.google.com/compute/docs/vpc) for |
| # more information on connecting Cloud projects. |
| "versionId": "A String", # Output only. The version identifier of the Cloud Function. Each deployment attempt |
| # results in a new version of a function being created. |
| "availableMemoryMb": 42, # The amount of memory in MB available for a function. |
| # Defaults to 256MB. |
| "name": "A String", # A user-defined name of the function. Function names must be unique |
| # globally and match pattern `projects/*/locations/*/functions/*` |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="list">list(location, pageToken=None, pageSize=None, x__xgafv=None)</code> |
| <pre>Returns a list of functions that belong to the requested project. |
| |
| Args: |
| location: string, Required. The project and location from which the function should be listed, |
| specified in the format `projects/*/locations/*` |
| If you want to list functions in all locations, use "-" in place of a |
| location. When listing functions in all locations, if one or more |
| location(s) are unreachable, the response will contain functions from all |
| reachable locations along with the names of any unreachable locations. (required) |
| pageToken: string, The value returned by the last |
| `ListFunctionsResponse`; indicates that |
| this is a continuation of a prior `ListFunctions` call, and that the |
| system should return the next page of data. |
| pageSize: integer, Maximum number of functions to return per call. |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { # Response for the `ListFunctions` method. |
| "nextPageToken": "A String", # If not empty, indicates that there may be more functions that match |
| # the request; this value should be passed in a new |
| # google.cloud.functions.v1beta2.ListFunctionsRequest |
| # to get more functions. |
| "functions": [ # The functions that match the request. |
| { # Describes a Cloud Function that contains user computation executed in |
| # response to an event. It encapsulate function and triggers configurations. |
| "timeout": "A String", # The function execution timeout. Execution is considered failed and |
| # can be terminated if the function is not completed at the end of the |
| # timeout period. Defaults to 60 seconds. |
| "runtime": "A String", # The runtime in which to run the function. Required when deploying a new |
| # function, optional when updating an existing function. For a complete |
| # list of possible choices, see the |
| # [`gcloud` command |
| # reference](/sdk/gcloud/reference/functions/deploy#--runtime). |
| "eventTrigger": { # Describes EventTrigger, used to request events be sent from another # A source that fires events in response to a condition in another service. |
| # service. |
| "failurePolicy": { # Describes the policy in case of function's execution failure. # Specifies policy for failed executions. |
| # If empty, then defaults to ignoring failures (i.e. not retrying them). |
| "retry": { # Describes the retry policy in case of function's execution failure. # If specified, then the function will be retried in case of a failure. |
| # A function execution will be retried on any failure. |
| # A failed execution will be retried up to 7 days with an exponential backoff |
| # (capped at 10 seconds). |
| # Retried execution is charged as any other execution. |
| }, |
| }, |
| "resource": "A String", # Which instance of the source's service should send events. E.g. for Pub/Sub |
| # this would be a Pub/Sub topic at `projects/*/topics/*`. For Google Cloud |
| # Storage this would be a bucket at `projects/*/buckets/*`. For any source |
| # that only supports one instance per-project, this should be the name of the |
| # project (`projects/*`) |
| "service": "A String", # The hostname of the service that should be observed. |
| # |
| # If no string is provided, the default service implementing the API will |
| # be used. For example, `storage.googleapis.com` is the default for all |
| # event types in the `google.storage` namespace. |
| "eventType": "A String", # `event_type` names contain the service that is sending an event and the |
| # kind of event that was fired. Must be of the form |
| # `providers/*/eventTypes/*` e.g. Directly handle a Message published to |
| # Google Cloud Pub/Sub `providers/cloud.pubsub/eventTypes/topic.publish`. |
| # |
| # Handle an object changing in Google Cloud Storage: |
| # `providers/cloud.storage/eventTypes/object.change` |
| # |
| # Handle a write to the Firebase Realtime Database: |
| # `providers/google.firebase.database/eventTypes/ref.write` |
| }, |
| "serviceAccount": "A String", # The email of the function's service account. If empty, defaults to |
| # `{project_id}@appspot.gserviceaccount.com`. |
| "entryPoint": "A String", # The name of the function (as defined in source code) that will be |
| # executed. Defaults to the resource name suffix, if not specified. For |
| # backward compatibility, if function with given name is not found, then the |
| # system will try to use function named "function". |
| # For Node.js this is name of a function exported by the module specified |
| # in `source_location`. |
| "status": "A String", # Output only. Status of the function deployment. |
| "sourceRepositoryUrl": "A String", # The URL pointing to the hosted repository where the function is defined. |
| # There are supported Cloud Source Repository URLs in the following |
| # formats: |
| # |
| # To refer to a specific commit: |
| # `https://source.developers.google.com/projects/*/repos/*/revisions/*/paths/*` |
| # To refer to a moveable alias (branch): |
| # `https://source.developers.google.com/projects/*/repos/*/moveable-aliases/*/paths/*` |
| # In particular, to refer to HEAD use `master` moveable alias. |
| # To refer to a specific fixed alias (tag): |
| # `https://source.developers.google.com/projects/*/repos/*/fixed-aliases/*/paths/*` |
| # |
| # You may omit `paths/*` if you want to use the main directory. |
| "environmentVariables": { # Environment variables that shall be available during function execution. |
| "a_key": "A String", |
| }, |
| "labels": { # Labels associated with this Cloud Function. |
| "a_key": "A String", |
| }, |
| "updateTime": "A String", # Output only. The last update timestamp of a Cloud Function. |
| "vpcConnector": "A String", # The VPC Network Connector that this cloud function can connect to. It can |
| # be either the fully-qualified URI, or the short name of the network |
| # connector resource. The format of this field is |
| # `projects/*/locations/*/connectors/*` |
| # |
| # This field is mutually exclusive with `network` field and will eventually |
| # replace it. |
| # |
| # See [the VPC documentation](https://cloud.google.com/compute/docs/vpc) for |
| # more information on connecting Cloud projects. |
| "latestOperation": "A String", # Output only. Name of the most recent operation modifying the function. If |
| # the function status is `DEPLOYING` or `DELETING`, then it points to the |
| # active operation. |
| "httpsTrigger": { # Describes HTTPSTrigger, could be used to connect web hooks to function. # An HTTPS endpoint type of source that can be triggered via URL. |
| "url": "A String", # Output only. The deployed url for the function. |
| }, |
| "sourceArchiveUrl": "A String", # The Google Cloud Storage URL, starting with gs://, pointing to the zip |
| # archive which contains the function. |
| "sourceUploadUrl": "A String", # The Google Cloud Storage signed URL used for source uploading, generated |
| # by google.cloud.functions.v1beta2.GenerateUploadUrl |
| "maxInstances": 42, # The limit on the maximum number of function instances that may coexist at a |
| # given time. |
| "sourceRepository": { # Describes the location of the function source in a remote repository. # The hosted repository where the function is defined. |
| "tag": "A String", # The name of the tag that captures the state of the repository from |
| # which the function should be fetched. |
| "repositoryUrl": "A String", # URL to the hosted repository where the function is defined. Only paths in |
| # https://source.developers.google.com domain are supported. The path should |
| # contain the name of the repository. |
| "deployedRevision": "A String", # Output only. The id of the revision that was resolved at the moment of |
| # function creation or update. For example when a user deployed from a |
| # branch, it will be the revision id of the latest change on this branch at |
| # that time. If user deployed from revision then this value will be always |
| # equal to the revision specified by the user. |
| "revision": "A String", # The id of the revision that captures the state of the repository from |
| # which the function should be fetched. |
| "sourcePath": "A String", # The path within the repository where the function is defined. The path |
| # should point to the directory where Cloud Functions files are located. Use |
| # "/" if the function is defined directly in the root directory of a |
| # repository. |
| "branch": "A String", # The name of the branch from which the function should be fetched. |
| }, |
| "network": "A String", # The VPC Network that this cloud function can connect to. It can be |
| # either the fully-qualified URI, or the short name of the network resource. |
| # If the short network name is used, the network must belong to the same |
| # project. Otherwise, it must belong to a project within the same |
| # organization. The format of this field is either |
| # `projects/{project}/global/networks/{network}` or `{network}`, where |
| # {project} is a project id where the network is defined, and {network} is |
| # the short name of the network. |
| # |
| # This field is mutually exclusive with `vpc_connector` and will be replaced |
| # by it. |
| # |
| # See [the VPC documentation](https://cloud.google.com/compute/docs/vpc) for |
| # more information on connecting Cloud projects. |
| "versionId": "A String", # Output only. The version identifier of the Cloud Function. Each deployment attempt |
| # results in a new version of a function being created. |
| "availableMemoryMb": 42, # The amount of memory in MB available for a function. |
| # Defaults to 256MB. |
| "name": "A String", # A user-defined name of the function. Function names must be unique |
| # globally and match pattern `projects/*/locations/*/functions/*` |
| }, |
| ], |
| "unreachable": [ # Locations that could not be reached. The response does not include any |
| # functions from these locations. |
| "A String", |
| ], |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="list_next">list_next(previous_request, previous_response)</code> |
| <pre>Retrieves the next page of results. |
| |
| Args: |
| previous_request: The request for the previous page. (required) |
| previous_response: The response from the request for the previous page. (required) |
| |
| Returns: |
| A request object that you can call 'execute()' on to request the next |
| page. Returns None if there are no more items in the collection. |
| </pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="update">update(name, body=None, x__xgafv=None)</code> |
| <pre>Updates existing function. |
| |
| Args: |
| name: string, Required. The name of the function to be updated. (required) |
| body: object, The request body. |
| The object takes the form of: |
| |
| { # Describes a Cloud Function that contains user computation executed in |
| # response to an event. It encapsulate function and triggers configurations. |
| "timeout": "A String", # The function execution timeout. Execution is considered failed and |
| # can be terminated if the function is not completed at the end of the |
| # timeout period. Defaults to 60 seconds. |
| "runtime": "A String", # The runtime in which to run the function. Required when deploying a new |
| # function, optional when updating an existing function. For a complete |
| # list of possible choices, see the |
| # [`gcloud` command |
| # reference](/sdk/gcloud/reference/functions/deploy#--runtime). |
| "eventTrigger": { # Describes EventTrigger, used to request events be sent from another # A source that fires events in response to a condition in another service. |
| # service. |
| "failurePolicy": { # Describes the policy in case of function's execution failure. # Specifies policy for failed executions. |
| # If empty, then defaults to ignoring failures (i.e. not retrying them). |
| "retry": { # Describes the retry policy in case of function's execution failure. # If specified, then the function will be retried in case of a failure. |
| # A function execution will be retried on any failure. |
| # A failed execution will be retried up to 7 days with an exponential backoff |
| # (capped at 10 seconds). |
| # Retried execution is charged as any other execution. |
| }, |
| }, |
| "resource": "A String", # Which instance of the source's service should send events. E.g. for Pub/Sub |
| # this would be a Pub/Sub topic at `projects/*/topics/*`. For Google Cloud |
| # Storage this would be a bucket at `projects/*/buckets/*`. For any source |
| # that only supports one instance per-project, this should be the name of the |
| # project (`projects/*`) |
| "service": "A String", # The hostname of the service that should be observed. |
| # |
| # If no string is provided, the default service implementing the API will |
| # be used. For example, `storage.googleapis.com` is the default for all |
| # event types in the `google.storage` namespace. |
| "eventType": "A String", # `event_type` names contain the service that is sending an event and the |
| # kind of event that was fired. Must be of the form |
| # `providers/*/eventTypes/*` e.g. Directly handle a Message published to |
| # Google Cloud Pub/Sub `providers/cloud.pubsub/eventTypes/topic.publish`. |
| # |
| # Handle an object changing in Google Cloud Storage: |
| # `providers/cloud.storage/eventTypes/object.change` |
| # |
| # Handle a write to the Firebase Realtime Database: |
| # `providers/google.firebase.database/eventTypes/ref.write` |
| }, |
| "serviceAccount": "A String", # The email of the function's service account. If empty, defaults to |
| # `{project_id}@appspot.gserviceaccount.com`. |
| "entryPoint": "A String", # The name of the function (as defined in source code) that will be |
| # executed. Defaults to the resource name suffix, if not specified. For |
| # backward compatibility, if function with given name is not found, then the |
| # system will try to use function named "function". |
| # For Node.js this is name of a function exported by the module specified |
| # in `source_location`. |
| "status": "A String", # Output only. Status of the function deployment. |
| "sourceRepositoryUrl": "A String", # The URL pointing to the hosted repository where the function is defined. |
| # There are supported Cloud Source Repository URLs in the following |
| # formats: |
| # |
| # To refer to a specific commit: |
| # `https://source.developers.google.com/projects/*/repos/*/revisions/*/paths/*` |
| # To refer to a moveable alias (branch): |
| # `https://source.developers.google.com/projects/*/repos/*/moveable-aliases/*/paths/*` |
| # In particular, to refer to HEAD use `master` moveable alias. |
| # To refer to a specific fixed alias (tag): |
| # `https://source.developers.google.com/projects/*/repos/*/fixed-aliases/*/paths/*` |
| # |
| # You may omit `paths/*` if you want to use the main directory. |
| "environmentVariables": { # Environment variables that shall be available during function execution. |
| "a_key": "A String", |
| }, |
| "labels": { # Labels associated with this Cloud Function. |
| "a_key": "A String", |
| }, |
| "updateTime": "A String", # Output only. The last update timestamp of a Cloud Function. |
| "vpcConnector": "A String", # The VPC Network Connector that this cloud function can connect to. It can |
| # be either the fully-qualified URI, or the short name of the network |
| # connector resource. The format of this field is |
| # `projects/*/locations/*/connectors/*` |
| # |
| # This field is mutually exclusive with `network` field and will eventually |
| # replace it. |
| # |
| # See [the VPC documentation](https://cloud.google.com/compute/docs/vpc) for |
| # more information on connecting Cloud projects. |
| "latestOperation": "A String", # Output only. Name of the most recent operation modifying the function. If |
| # the function status is `DEPLOYING` or `DELETING`, then it points to the |
| # active operation. |
| "httpsTrigger": { # Describes HTTPSTrigger, could be used to connect web hooks to function. # An HTTPS endpoint type of source that can be triggered via URL. |
| "url": "A String", # Output only. The deployed url for the function. |
| }, |
| "sourceArchiveUrl": "A String", # The Google Cloud Storage URL, starting with gs://, pointing to the zip |
| # archive which contains the function. |
| "sourceUploadUrl": "A String", # The Google Cloud Storage signed URL used for source uploading, generated |
| # by google.cloud.functions.v1beta2.GenerateUploadUrl |
| "maxInstances": 42, # The limit on the maximum number of function instances that may coexist at a |
| # given time. |
| "sourceRepository": { # Describes the location of the function source in a remote repository. # The hosted repository where the function is defined. |
| "tag": "A String", # The name of the tag that captures the state of the repository from |
| # which the function should be fetched. |
| "repositoryUrl": "A String", # URL to the hosted repository where the function is defined. Only paths in |
| # https://source.developers.google.com domain are supported. The path should |
| # contain the name of the repository. |
| "deployedRevision": "A String", # Output only. The id of the revision that was resolved at the moment of |
| # function creation or update. For example when a user deployed from a |
| # branch, it will be the revision id of the latest change on this branch at |
| # that time. If user deployed from revision then this value will be always |
| # equal to the revision specified by the user. |
| "revision": "A String", # The id of the revision that captures the state of the repository from |
| # which the function should be fetched. |
| "sourcePath": "A String", # The path within the repository where the function is defined. The path |
| # should point to the directory where Cloud Functions files are located. Use |
| # "/" if the function is defined directly in the root directory of a |
| # repository. |
| "branch": "A String", # The name of the branch from which the function should be fetched. |
| }, |
| "network": "A String", # The VPC Network that this cloud function can connect to. It can be |
| # either the fully-qualified URI, or the short name of the network resource. |
| # If the short network name is used, the network must belong to the same |
| # project. Otherwise, it must belong to a project within the same |
| # organization. The format of this field is either |
| # `projects/{project}/global/networks/{network}` or `{network}`, where |
| # {project} is a project id where the network is defined, and {network} is |
| # the short name of the network. |
| # |
| # This field is mutually exclusive with `vpc_connector` and will be replaced |
| # by it. |
| # |
| # See [the VPC documentation](https://cloud.google.com/compute/docs/vpc) for |
| # more information on connecting Cloud projects. |
| "versionId": "A String", # Output only. The version identifier of the Cloud Function. Each deployment attempt |
| # results in a new version of a function being created. |
| "availableMemoryMb": 42, # The amount of memory in MB available for a function. |
| # Defaults to 256MB. |
| "name": "A String", # A user-defined name of the function. Function names must be unique |
| # globally and match pattern `projects/*/locations/*/functions/*` |
| } |
| |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { # This resource represents a long-running operation that is the result of a |
| # network API call. |
| "response": { # The normal response of the operation in case of success. If the original |
| # method returns no data on success, such as `Delete`, the response is |
| # `google.protobuf.Empty`. If the original method is standard |
| # `Get`/`Create`/`Update`, the response should be the resource. For other |
| # methods, the response should have the type `XxxResponse`, where `Xxx` |
| # is the original method name. For example, if the original method name |
| # is `TakeSnapshot()`, the inferred response type is |
| # `TakeSnapshotResponse`. |
| "a_key": "", # Properties of the object. Contains field @type with type URL. |
| }, |
| "metadata": { # Service-specific metadata associated with the operation. It typically |
| # contains progress information and common metadata such as create time. |
| # Some services might not provide such metadata. Any method that returns a |
| # long-running operation should document the metadata type, if any. |
| "a_key": "", # Properties of the object. Contains field @type with type URL. |
| }, |
| "name": "A String", # The server-assigned name, which is only unique within the same service that |
| # originally returns it. If you use the default HTTP mapping, the |
| # `name` should be a resource name ending with `operations/{unique_id}`. |
| "done": True or False, # If the value is `false`, it means the operation is still in progress. |
| # If `true`, the operation is completed, and either `error` or `response` is |
| # available. |
| "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation. |
| # different programming environments, including REST APIs and RPC APIs. It is |
| # used by [gRPC](https://github.com/grpc). Each `Status` message contains |
| # three pieces of data: error code, error message, and error details. |
| # |
| # You can find out more about this error model and how to work with it in the |
| # [API Design Guide](https://cloud.google.com/apis/design/errors). |
| "code": 42, # The status code, which should be an enum value of google.rpc.Code. |
| "details": [ # A list of messages that carry the error details. There is a common set of |
| # message types for APIs to use. |
| { |
| "a_key": "", # Properties of the object. Contains field @type with type URL. |
| }, |
| ], |
| "message": "A String", # A developer-facing error message, which should be in English. Any |
| # user-facing error message should be localized and sent in the |
| # google.rpc.Status.details field, or localized by the client. |
| }, |
| }</pre> |
| </div> |
| |
| </body></html> |
