Merge pull request #229344 from TimShererWithAquent/us2036619b

Freshness Pass User Story: 2036619 Quickstart - Create Azure Cosmos DB resources from the Azure portal

Author: v-regandowner

articles/cosmos-db/includes/cosmos-db-create-dbaccount.md

@@ -4,58 +4,76 @@
 ms.reviewer: mjbrown
  ms.service: cosmos-db
  ms.topic: include
- ms.date: 07/02/2021
+ ms.date: 03/03/2023
 ms.custom: include file, ignite-2022
 ---
 
 1. From the Azure portal menu or the **Home page**, select **Create a resource**.
 
-1. On the **New** page, search for and select **Azure Cosmos DB**.
+1. Search for **Azure Cosmos DB**. Select **Create** > **Azure Cosmos DB**.
 
-1. On the **Select API option** page, select the **Create** option within the **NoSQL - Recommend** section. Azure Cosmos DB provides five APIs: NoSQL and MongoDB for document data, Gremlin for graph data, Azure Table, and Cassandra. Currently, you must create a separate account for each API. [Learn more about the API for NoSQL](../introduction.md).
+1. On the **Create an Azure Cosmos DB account** page, select the **Create** option within the **Azure Cosmos DB for NoSQL** section.
+
+   Azure Cosmos DB provides several APIs:
+
+   - NoSQL, for document data
+   - PostgreSQL
+   - MongoDB, for document data
+   - Apache Cassandra
+   - Table
+   - Apache Gremlin, for graph data
+
+   To learn more about the API for NoSQL, see [Welcome to Azure Cosmos DB](../introduction.md).
 
 1. In the **Create Azure Cosmos DB Account** page, enter the basic settings for the new Azure Cosmos DB account.
 
    |Setting|Value|Description |
    |---|---|---|
    |Subscription|Subscription name|Select the Azure subscription that you want to use for this Azure Cosmos DB account. |
    |Resource Group|Resource group name|Select a resource group, or select **Create new**, then enter a unique name for the new resource group. |
-   |Account Name|A unique name|Enter a name to identify your Azure Cosmos DB account. Because *documents.azure.com* is appended to the name that you provide to create your URI, use a unique name.<br><br>The name can only contain lowercase letters, numbers, and the hyphen (-) character. It must be between 3-44 characters in length.|
+   |Account Name|A unique name|Enter a name to identify your Azure Cosmos DB account. Because *documents.azure.com* is appended to the name that you provide to create your URI, use a unique name. The name can contain only lowercase letters, numbers, and the hyphen (-) character. It must be 3-44 characters.|
    |Location|The region closest to your users|Select a geographic location to host your Azure Cosmos DB account. Use the location that is closest to your users to give them the fastest access to the data.|
-   |Capacity mode|Provisioned throughput or Serverless|Select **Provisioned throughput** to create an account in [provisioned throughput](../set-throughput.md) mode. Select **Serverless** to create an account in [serverless](../serverless.md) mode.|
-   |Apply Azure Cosmos DB free tier discount|**Apply** or **Do not apply**|With Azure Cosmos DB free tier, you'll get the first 1000 RU/s and 25 GB of storage for free in an account. Learn more about [free tier](https://azure.microsoft.com/pricing/details/cosmos-db/).|
+   |Capacity mode|**Provisioned throughput** or **Serverless**|Select **Provisioned throughput** to create an account in [provisioned throughput](../set-throughput.md) mode. Select **Serverless** to create an account in [serverless](../serverless.md) mode.|
+   |Apply Azure Cosmos DB free tier discount|**Apply** or **Do not apply**|With Azure Cosmos DB free tier, you get the first 1000 RU/s and 25 GB of storage for free in an account. Learn more about [free tier](https://azure.microsoft.com/pricing/details/cosmos-db/).|
+   |Limit total account throughput|Selected or not|Limit the total amount of throughput that can be provisioned on this account. This limit prevents unexpected charges related to provisioned throughput. You can update or remove this limit after your account is created.|
 
-   > [!NOTE]
-   > You can have up to one free tier Azure Cosmos DB account per Azure subscription and must opt-in when creating the account. If you do not see the option to apply the free tier discount, this means another account in the subscription has already been enabled with free tier.
+   You can have up to one free tier Azure Cosmos DB account per Azure subscription and must opt in when creating the account. If you don't see the option to apply the free tier discount, another account in the subscription has already been enabled with free tier.
+
+   :::image type="content" source="./media/cosmos-db-create-dbaccount/azure-cosmos-db-create-new-account-detail.png" alt-text="Screenshot shows the Create Azure Cosmos DB Account page." lightbox="./media/cosmos-db-create-dbaccount/azure-cosmos-db-create-new-account-detail.png":::
 
-   :::image type="content" source="./media/cosmos-db-create-dbaccount/azure-cosmos-db-create-new-account-detail.png" alt-text="The new account page for Azure Cosmos DB":::
+   > [!NOTE]
+   > The following options are not available if you select **Serverless** as the **Capacity mode**:
+   >
+   > - Apply Free Tier Discount
+   > - Limit total account throughput
 
 1. In the **Global Distribution** tab, configure the following details. You can leave the default values for this quickstart:
 
    |Setting|Value|Description |
    |---|---|---|
    |Geo-Redundancy|Disable|Enable or disable global distribution on your account by pairing your region with a pair region. You can add more regions to your account later.|
    |Multi-region Writes|Disable|Multi-region writes capability allows you to take advantage of the provisioned throughput for your databases and containers across the globe.|
+   |Availability Zones|Disable|Availability Zones help you further improve availability and resiliency of your application.|
 
    > [!NOTE]
-   > The following options are not available if you select **Serverless** as the **Capacity mode**:
-   > - Apply Free Tier Discount
+   > The following options are not available if you select **Serverless** as the **Capacity mode** in the previous **Basics** page:
+   >
    > - Geo-redundancy
    > - Multi-region Writes
 
-1. Optionally you can configure more details in the following tabs:
+1. Optionally, you can configure more details in the following tabs:
 
-   * **Networking** - Configure [access from a virtual network](../how-to-configure-vnet-service-endpoint.md).
-   * **Backup Policy** - Configure either [periodic](../configure-periodic-backup-restore.md) or [continuous](../provision-account-continuous-backup.md) backup policy.
-   * **Encryption** - Use either service-managed key or a [customer-managed key](../how-to-setup-cmk.md#create-a-new-azure-cosmos-account).
-   * **Tags** - Tags are name/value pairs that enable you to categorize resources and view consolidated billing by applying the same tag to multiple resources and resource groups.
+   - **Networking**. Configure [access from a virtual network](../how-to-configure-vnet-service-endpoint.md).
+   - **Backup Policy**. Configure either [periodic](../configure-periodic-backup-restore.md) or [continuous](../provision-account-continuous-backup.md) backup policy.
+   - **Encryption**. Use either service-managed key or a [customer-managed key](../how-to-setup-cmk.md#create-a-new-azure-cosmos-account).
+   - **Tags**. Tags are name/value pairs that enable you to categorize resources and view consolidated billing by applying the same tag to multiple resources and resource groups.
 
 1. Select **Review + create**.
 
 1. Review the account settings, and then select **Create**. It takes a few minutes to create the account. Wait for the portal page to display **Your deployment is complete**.
 
-   :::image type="content" source="./media/cosmos-db-create-dbaccount/azure-cosmos-db-account-created.png" alt-text="The Azure portal Notifications pane":::
+   :::image type="content" source="./media/cosmos-db-create-dbaccount/azure-cosmos-db-account-created.png" alt-text="Screenshot shows that your deployment is complete." lightbox="./media/cosmos-db-create-dbaccount/azure-cosmos-db-account-created.png":::
 
-1. Select **Go to resource** to go to the Azure Cosmos DB account page. 
+1. Select **Go to resource** to go to the Azure Cosmos DB account page.
 
-   :::image type="content" source="./media/cosmos-db-create-dbaccount/azure-cosmos-db-account-created-2.png" alt-text="The Azure Cosmos DB account page":::
+   :::image type="content" source="./media/cosmos-db-create-dbaccount/azure-cosmos-db-account-created-2.png" alt-text="Screenshot shows the Azure Cosmos DB account page." lightbox="./media/cosmos-db-create-dbaccount/azure-cosmos-db-account-created-2.png":::

articles/cosmos-db/includes/cosmos-db-create-sql-api-query-data.md

@@ -5,25 +5,25 @@
  author: seesharprun
  ms.service: cosmos-db
  ms.topic: include
- ms.date: 04/05/2019
+ ms.date: 03/03/2023
  ms.author: sidandrews
 ms.reviewer: mjbrown
 ms.custom: include file, ignite-2022
 ---
 You can use queries in Data Explorer to retrieve and filter your data.
 
-1. At the top of the **Items** tab in Data Explorer, review the default query `SELECT * FROM c`. This query retrieves and displays all documents from the container ordered by ID. 
-   
-   :::image type="content" source="./media/cosmos-db-create-sql-api-query-data/azure-cosmosdb-data-explorer-query.png" alt-text="Default query in Data Explorer is SELECT * FROM c":::
-   
+1. At the top of the **Items** tab in Data Explorer, review the default query `SELECT * FROM c`. This query retrieves and displays all documents from the container ordered by ID.
+
+   :::image type="content" source="./media/cosmos-db-create-sql-api-query-data/azure-cosmosdb-data-explorer-query.png" alt-text="Screenshot shows the default query in Data Explorer, SELECT * FROM c." lightbox="./media/cosmos-db-create-sql-api-query-data/azure-cosmosdb-data-explorer-query.png":::
+
 1. To change the query, select **Edit Filter**, replace the default query with `ORDER BY c._ts DESC`, and then select **Apply Filter**.
-   
-   :::image type="content" source="./media/cosmos-db-create-sql-api-query-data/azure-cosmosdb-data-explorer-edit-query.png" alt-text="Change the default query by adding ORDER BY c._ts DESC and clicking Apply Filter":::
 
-   The modified query displays the documents in descending order based on their time stamp, so now your second document is listed first. 
-   
-   :::image type="content" source="./media/cosmos-db-create-sql-api-query-data/azure-cosmosdb-data-explorer-edited-query.png" alt-text="Changed query to ORDER BY c._ts DESC and clicking Apply Filter":::
+   :::image type="content" source="./media/cosmos-db-create-sql-api-query-data/azure-cosmosdb-data-explorer-edit-query.png" alt-text="Screenshot shows a change to the default query to ORDER BY c._ts DESC." lightbox="./media/cosmos-db-create-sql-api-query-data/azure-cosmosdb-data-explorer-edit-query.png":::
+
+   The modified query displays the documents in descending order based on their description, so now your second document is listed first.
+
+   :::image type="content" source="./media/cosmos-db-create-sql-api-query-data/azure-cosmosdb-data-explorer-edited-query.png" alt-text="Screenshot shows the result of the changed query." lightbox="./media/cosmos-db-create-sql-api-query-data/azure-cosmosdb-data-explorer-edited-query.png":::
 
-If you're familiar with SQL syntax, you can enter any supported [SQL queries](../nosql/query/getting-started.md) in the query predicate box. You can also use Data Explorer to create stored procedures, UDFs, and triggers for server-side business logic. 
+If you're familiar with SQL syntax, you can enter any supported [SQL queries](../nosql/query/getting-started.md) in the query predicate box. You can also use Data Explorer to create stored procedures, user defined functions, and triggers for server-side business logic.
 
-Data Explorer provides easy Azure portal access to all of the built-in programmatic data access features available in the APIs. You also use the portal to scale throughput, get keys and connection strings, and review metrics and SLAs for your Azure Cosmos DB account.
+Data Explorer provides easy access in the Azure portal to all of the built-in programmatic data access features available in the APIs. You can also use the Azure portal to scale throughput, get keys and connection strings, and review metrics and SLAs for your Azure Cosmos DB account.