Merge pull request #100309 from markjbrown/ps-scale-scheduler

scale cosmos on a schedule

Author: Jak-MS

articles/cosmos-db/TOC.yml

@@ -869,6 +869,9 @@
       - name: Find request unit charge
         displayName: request units, RUs, RU, charge, consumption
         href: find-request-unit-charge.md
+      - name: Scale using Azure Functions timer
+        displayName: request units, RUs, RU, timer
+        href: scale-on-schedule.md
     - name: Work with containers and items
       items:
       - name: Work with Cosmos DB data

articles/cosmos-db/index.yml

@@ -152,6 +152,8 @@ landingContent:
             url: how-to-provision-container-throughput.md
           - text: Get the request unit charges 
             url: find-request-unit-charge.md
+          - text: Scale using Azure Functions timer
+            url: scale-on-schedule.md
 
   # Card
   - title: Build an app with SQL API 

articles/cosmos-db/scale-on-schedule.md

@@ -0,0 +1,25 @@
+---
+title: Scale Azure Cosmos DB on a schedule by using Azure Functions timer
+description: Learn how to scale changes in throughput in Azure Cosmos DB using PowerShell and Azure Functions.
+author: markjbrown
+ms.service: cosmos-db
+ms.topic: conceptual
+ms.date: 01/13/2020
+ms.author: mjbrown
+---
+
+# Scale Azure Cosmos DB throughput by using Azure Functions Timer trigger
+
+The performance of an Azure Cosmos account is based on the amount of provisioned throughput expressed in Request Units per second (RU/s). The provisioning is at a second granularity and is billed based upon the highest RU/s per hour. This provisioned capacity model enables the service to provide a predictable and consistent throughput, guaranteed low latency, and high availability. Most production workloads these features. However, in development and testing environments where Azure Cosmos DB is only used during working hours, you can scale up the throughput in the morning and scale back down in the evening after working hours.
+
+You can set the throughput via [Azure Resource Manager Templates](resource-manager-samples.md), [Azure CLI](cli-samples.md), and [PowerShell](powershell-samples-sql.md), for Core (SQL) API accounts, or by using the language-specific Azure Cosmos DB SDKs. The benefit of using Resource Manager Templates, Azure CLI or PowerShell is that they support all Azure Cosmos DB model APIs.
+
+## Throughput scheduler sample project
+
+To simplify the process to scale Azure Cosmos DB on a schedule we've created a sample project called [Azure Cosmos throughput scheduler](https://github.com/Azure-Samples/azure-cosmos-throughput-scheduler). This project is an Azure Functions app with two timer triggers- "ScaleUpTrigger" and "ScaleDownTrigger". The triggers run a PowerShell script that sets the throughput on each resource as defined in the `resources.json` file in each trigger. The ScaleUpTrigger is configured to run at 8 AM UTC and the ScaleDownTrigger is configured to run at 6 PM UTC and these times can be easily updated within the `function.json` file for each trigger.
+
+You can clone this project locally, modify it to specify the Azure Cosmos DB resources to scale up and down and the schedule to run. Later you can deploy it in an Azure subscription and secure it using managed service identity with [Role-based Access Control](role-based-access-control.md) (RBAC) permissions with the "Azure Cosmos DB operator" role to set throughput on your Azure Cosmos accounts.
+
+## Next Steps
+
+- Learn more and download the sample from [Azure Cosmos DB throughput scheduler](https://github.com/Azure-Samples/azure-cosmos-throughput-scheduler).