This recipe shows you how to read and write an entity in Cloud Datastore from a Cloud Function.

View the source code.

1. Follow the Cloud Functions quickstart guide to setup Cloud Functions for your project.

2. Clone this repository:

    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
    cd nodejs-docs-samples/functions/datastore
   

3. Ensure the Cloud Datastore API is enabled:

Click here to enable the Cloud Datastore API

1. Deploy the "get" function with an HTTP trigger:

    gcloud functions deploy get --runtime [YOUR_RUNTIME] --trigger-http
   

   • Replace [YOUR_RUNTIME] with the name of the runtime you are using. For a complete list, see the gcloud reference.

2. Deploy the "set" function with an HTTP trigger:

    gcloud functions deploy set --runtime [YOUR_RUNTIME] --trigger-http
   

3. Deploy the "del" function with an HTTP trigger:

    gcloud functions deploy del --runtime [YOUR_RUNTIME] --trigger-http
   

4. Call the "set" function to create a new entity:

    gcloud functions call set --data '{"kind":"Task","key":"sampletask1","value":{"description":"Buy milk"}}'
   

   or

    curl -H "Content-Type: application/json" -X POST -d '{"kind":"Task","key":"sampletask1","value":{"description":"Buy milk"}}' "https://[YOUR_REGION]-[YOUR_PROJECT_ID].cloudfunctions.net/set"
   

   • Replace [YOUR_REGION] with the region where your function is deployed.
   • Replace [YOUR_PROJECT_ID] with your Google Cloud Platform project ID.

5. Call the "get" function to read the newly created entity:

    gcloud functions call get --data '{"kind":"Task","key":"sampletask1"}'
   

   or

    curl -H "Content-Type: application/json" -X POST -d '{"kind":"Task","key":"sampletask1"}' "https://[YOUR_REGION]-[YOUR_PROJECT_ID].cloudfunctions.net/get"
   

   • Replace [YOUR_REGION] with the region where your function is deployed.
   • Replace [YOUR_PROJECT_ID] with your Google Cloud Platform project ID.

6. Call the "del" function to delete the entity:

    gcloud alpha functions call del --data '{"kind":"Task","key":"sampletask1"}'
   

   or

    curl -H "Content-Type: application/json" -X POST -d '{"kind":"Task","key":"sampletask1"}' "https://[YOUR_REGION]-[YOUR_PROJECT_ID].cloudfunctions.net/del"
   

   • Replace [YOUR_REGION] with the region where your function is deployed.
   • Replace [YOUR_PROJECT_ID] with your Google Cloud Platform project ID.

7. Call the "get" function again to verify it was deleted:

    gcloud functions call get --data '{"kind":"Task","key":"sampletask1"}'
   

   or

    curl -H "Content-Type: application/json" -X POST -d '{"kind":"Task","key":"sampletask1"}' "https://[YOUR_REGION]-[YOUR_PROJECT_ID].cloudfunctions.net/get"
   

   • Replace [YOUR_REGION] with the region where your function is deployed.
   • Replace [YOUR_PROJECT_ID] with your Google Cloud Platform project ID.