Cloud Functions API (cloudfunctions:v2beta)

2022-02-15

14 new methods | New API

Additions

    Methods
  • cloudfunctions.projects.locations.functions.patch

      HTTP Method : PATCH

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/functions/{functionsId}

      Parameter Order : name

      Parameters :

        name

          Location : path

          Pattern : ^projects/[^/]+/locations/[^/]+/functions/[^/]+$

          Required : Yes

          Type : string

          Description : A user-defined name of the function. Function names must be unique globally and match pattern `projects/*/locations/*/functions/*`

        updateMask

          Type : string

          Description : The list of fields to be updated. If no field mask is provided, all provided fields in the request will be updated.

          Format : google-fieldmask

          Location : query

      Description : Updates existing function.

      Path : v2beta/{+name}

  • cloudfunctions.projects.locations.functions.create

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Parameter Order : parent

      Description : 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.

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/functions

      HTTP Method : POST

      Parameters :

        functionId

          Type : string

          Description : The ID to use for the function, which will become the final component of the function's resource name. This value should be 4-63 characters, and valid characters are /a-z-/.

          Location : query

        parent

          Description : Required. The project and location in which the function should be created, specified in the format `projects/*/locations/*`

          Location : path

          Pattern : ^projects/[^/]+/locations/[^/]+$

          Type : string

          Required : Yes

      Path : v2beta/{+parent}/functions

  • cloudfunctions.projects.locations.functions.testIamPermissions

      Parameter Order : resource

      Description : Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.

      Path : v2beta/{+resource}:testIamPermissions

      Parameters :

        resource

          Pattern : ^projects/[^/]+/locations/[^/]+/functions/[^/]+$

          Type : string

          Description : REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.

          Required : Yes

          Location : path

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/functions/{functionsId}:testIamPermissions

      HTTP Method : POST

      Scopes : https://www.googleapis.com/auth/cloud-platform

  • cloudfunctions.projects.locations.functions.generateDownloadUrl

      Description : Returns a signed URL for downloading deployed function source code. The URL is only valid for a limited period and should be used within 30 minutes of generation. For more information about the signed URL usage see: https://cloud.google.com/storage/docs/access-control/signed-urls

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/functions/{functionsId}:generateDownloadUrl

      Parameters :

        name

          Type : string

          Description : Required. The name of function for which source code Google Cloud Storage signed URL should be generated.

          Required : Yes

          Location : path

          Pattern : ^projects/[^/]+/locations/[^/]+/functions/[^/]+$

      Parameter Order : name

      HTTP Method : POST

      Path : v2beta/{+name}:generateDownloadUrl

  • cloudfunctions.projects.locations.functions.delete

      Parameters :

        name

          Description : Required. The name of the function which should be deleted.

          Pattern : ^projects/[^/]+/locations/[^/]+/functions/[^/]+$

          Required : Yes

          Location : path

          Type : string

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/functions/{functionsId}

      Description : 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.

      Path : v2beta/{+name}

      HTTP Method : DELETE

      Parameter Order : name

  • cloudfunctions.projects.locations.functions.getIamPolicy

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/functions/{functionsId}:getIamPolicy

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Path : v2beta/{+resource}:getIamPolicy

      Parameter Order : resource

      Parameters :

        resource

          Type : string

          Location : path

          Description : REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.

          Required : Yes

          Pattern : ^projects/[^/]+/locations/[^/]+/functions/[^/]+$

        options.requestedPolicyVersion

          Location : query

          Format : int32

          Type : integer

          Description : Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).

      Description : Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.

      HTTP Method : GET

  • cloudfunctions.projects.locations.functions.get

      Path : v2beta/{+name}

      Description : Returns a function with the given name from the requested project.

      HTTP Method : GET

      Parameter Order : name

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Parameters :

        name

          Required : Yes

          Location : path

          Description : Required. The name of the function which details should be obtained.

          Pattern : ^projects/[^/]+/locations/[^/]+/functions/[^/]+$

          Type : string

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/functions/{functionsId}

  • cloudfunctions.projects.locations.functions.setIamPolicy

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Description : Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

      Parameter Order : resource

      Parameters :

        resource

          Pattern : ^projects/[^/]+/locations/[^/]+/functions/[^/]+$

          Type : string

          Location : path

          Description : REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.

          Required : Yes

      HTTP Method : POST

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/functions/{functionsId}:setIamPolicy

      Path : v2beta/{+resource}:setIamPolicy

  • cloudfunctions.projects.locations.functions.generateUploadUrl

      Path : v2beta/{+parent}/functions:generateUploadUrl

      Parameter Order : parent

      HTTP Method : POST

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/functions:generateUploadUrl

      Description : 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. * 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` And this header SHOULD NOT be specified: * `Authorization: Bearer YOUR_TOKEN`

      Parameters :

        parent

          Description : Required. The project and location in which the Google Cloud Storage signed URL should be generated, specified in the format `projects/*/locations/*`.

          Location : path

          Type : string

          Pattern : ^projects/[^/]+/locations/[^/]+$

          Required : Yes

      Scopes : https://www.googleapis.com/auth/cloud-platform

  • cloudfunctions.projects.locations.functions.list

      Path : v2beta/{+parent}/functions

      Parameter Order : parent

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Parameters :

        parent

          Required : Yes

          Location : path

          Description : 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.

          Type : string

          Pattern : ^projects/[^/]+/locations/[^/]+$

        filter

          Description : The filter for Functions that match the filter expression, following the syntax outlined in https://google.aip.dev/160.

          Location : query

          Type : string

        pageToken

          Type : string

          Location : query

          Description : 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.

        orderBy

          Type : string

          Description : The sorting order of the resources returned. Value should be a comma separated list of fields. The default sorting oder is ascending. See https://google.aip.dev/132#ordering.

          Location : query

        pageSize

          Location : query

          Type : integer

          Description : Maximum number of functions to return per call.

          Format : int32

      Description : Returns a list of functions that belong to the requested project.

      HTTP Method : GET

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/functions

  • cloudfunctions.projects.locations.operations.get

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Parameters :

        name

          Location : path

          Pattern : ^projects/[^/]+/locations/[^/]+/operations/[^/]+$

          Type : string

          Required : Yes

          Description : The name of the operation resource.

      Path : v2beta/{+name}

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}

      Description : Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.

      HTTP Method : GET

      Parameter Order : name

  • cloudfunctions.projects.locations.operations.list

      Description : Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/*/operations`. To override the binding, API services can add a binding such as `"/v1/{name=users/*}/operations"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.

      Parameter Order : name

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/operations

      Parameters :

        filter

          Description : Required. A filter for matching the requested operations. The supported formats of *filter* are: To query for a specific function: project:*,location:*,function:* To query for all of the latest operations for a project: project:*,latest:true

          Location : query

          Type : string

        pageToken

          Location : query

          Description : Token identifying which result to start with, which is returned by a previous list call. Pagination is only supported when querying for a specific function.

          Type : string

        name

          Required : Yes

          Location : path

          Description : Must not be set.

          Type : string

          Pattern : ^projects/[^/]+/locations/[^/]+$

        pageSize

          Description : The maximum number of records that should be returned. Requested page size cannot exceed 100. If not set, the default page size is 100. Pagination is only supported when querying for a specific function.

          Location : query

          Type : integer

          Format : int32

      Scopes : https://www.googleapis.com/auth/cloud-platform

      HTTP Method : GET

      Path : v2beta/{+name}/operations

  • cloudfunctions.projects.locations.runtimes.list

      Parameters :

        filter

          Description : The filter for Runtimes that match the filter expression, following the syntax outlined in https://google.aip.dev/160.

          Type : string

          Location : query

        parent

          Description : Required. The project and location from which the runtimes should be listed, specified in the format `projects/*/locations/*`

          Required : Yes

          Type : string

          Pattern : ^projects/[^/]+/locations/[^/]+$

          Location : path

      HTTP Method : GET

      Path : v2beta/{+parent}/runtimes

      Parameter Order : parent

      Flat Path : v2beta/projects/{projectsId}/locations/{locationsId}/runtimes

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Description : Returns a list of runtimes that are supported for the requested project.

  • cloudfunctions.projects.locations.list

      Parameters :

        pageSize

          Description : The maximum number of results to return. If not set, the service selects a default.

          Format : int32

          Location : query

          Type : integer

        name

          Type : string

          Required : Yes

          Pattern : ^projects/[^/]+$

          Description : The resource that owns the locations collection, if applicable.

          Location : path

        filter

          Type : string

          Location : query

          Description : A filter to narrow down results to a preferred subset. The filtering language accepts strings like "displayName=tokyo", and is documented in more detail in [AIP-160](https://google.aip.dev/160).

        pageToken

          Type : string

          Description : A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.

          Location : query

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Flat Path : v2beta/projects/{projectsId}/locations

      Description : Lists information about the supported locations for this service.

      HTTP Method : GET

      Parameter Order : name

      Path : v2beta/{+name}/locations