Merge pull request #253010 from seesharprun/cosmos-gremlin-quickstarts

Cosmos DB | Revamp Gremlin quickstarts

Author: American-Dipper

articles/cosmos-db/.openpublishing.redirection.cosmos-db.json

@@ -6214,6 +6214,16 @@
       "source_path_from_root": "/articles/cosmos-db/rag-data-openai.md",
       "redirect_url": "/azure/cosmos-db/vector-search",
       "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/cosmos-db/gremlin/quickstart-java.md",
+      "redirect_url": "/azure/cosmos-db/gremlin/quickstart-console",
+      "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/cosmos-db/gremlin/quickstart-php.md",
+      "redirect_url": "/azure/cosmos-db/gremlin/quickstart-console",
+      "redirect_document_id": false
     }
   ]
 }

articles/cosmos-db/gremlin/TOC.yml

@@ -10,18 +10,14 @@
       href: gremlin-api-faq.yml
 - name: Quickstarts
   items:
-    - name: Gremlin console
+    - name: Console
       href: quickstart-console.md
-    - name: .NET
-      href: quickstart-dotnet.md
-    - name: Java
-      href: quickstart-java.md
-    - name: Node.js
-      href: quickstart-nodejs.md
     - name: Python
       href: quickstart-python.md
-    - name: PHP
-      href: quickstart-php.md
+    - name: Node.js
+      href: quickstart-nodejs.md
+    - name: .NET
+      href: quickstart-dotnet.md
 - name: Tutorials
   items:
     - name: Query data using Gremlin

articles/cosmos-db/gremlin/includes/create-account-database-graph-cli.md

@@ -0,0 +1,87 @@
+---
+author: seesharprun
+ms.author: sidandrews
+ms.service: cosmos-db
+ms.subservice: apache-gremlin
+ms.topic: include
+ms.date: 09/27/2023
+---
+
+1. Create shell variables for *accountName*, *resourceGroupName*, and *location*.
+
+    ```azurecli-interactive
+    # Variable for resource group name
+    resourceGroupName="msdocs-cosmos-gremlin-quickstart"
+    location="westus"
+    
+    # Variable for account name with a randomly generated suffix
+    
+    let suffix=$RANDOM*$RANDOM
+    accountName="msdocs-gremlin-$suffix"
+    ```
+
+1. If you haven't already, sign in to the Azure CLI using `az login`.
+
+1. Use `az group create` to create a new resource group in your subscription.
+
+    ```azurecli-interactive
+    az group create \
+        --name $resourceGroupName \
+        --location $location
+    ```
+
+1. Use `az cosmosdb create` to create a new API for NoSQL account with default settings.
+
+    ```azurecli-interactive
+    az cosmosdb create \
+        --resource-group $resourceGroupName \
+        --name $accountName \
+        --capabilities "EnableGremlin" \
+        --locations regionName=$location \
+        --enable-free-tier true
+    ```
+
+    > [!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 this command fails to apply the free tier discount, this means another account in the subscription has already been enabled with free tier.
+
+1. Get the API for Gremlin endpoint *NAME* for the account using `az cosmosdb show`.
+
+    ```azurecli-interactive
+    az cosmosdb show \
+        --resource-group $resourceGroupName \
+        --name $accountName \
+        --query "name"
+    ```
+
+1. Find the *KEY* from the list of keys for the account with `az-cosmosdb-keys-list`.
+
+    ```azurecli-interactive
+    az cosmosdb keys list \
+        --resource-group $resourceGroupName \
+        --name $accountName \
+        --type "keys" \
+        --query "primaryMasterKey"
+    ```
+
+1. Record the *NAME* and *KEY* values. You use these credentials later.
+
+1. Create a *database* named `cosmicworks` using `az cosmosdb gremlin database create`.
+
+    ```azurecli-interactive
+    az cosmosdb gremlin database create \
+        --resource-group $resourceGroupName \
+        --account-name $accountName \
+        --name "cosmicworks"
+    ```
+
+1. Create a *graph* using `az cosmosdb gremlin graph create`. Name the graph `products`, then set the throughput to `400`, and finally set the partition key path to `/category`.
+
+    ```azurecli-interactive
+    az cosmosdb gremlin graph create \
+        --resource-group $resourceGroupName \
+        --account-name $accountName \
+        --database-name "cosmicworks" \
+        --name "products" \
+        --partition-key-path "/category" \
+        --throughput 400
+    ```

articles/cosmos-db/gremlin/includes/delete-account-cli.md

@@ -0,0 +1,17 @@
+---
+author: seesharprun
+ms.author: sidandrews
+ms.service: cosmos-db
+ms.subservice: apache-gremlin
+ms.topic: include
+ms.date: 09/27/2023
+---
+
+1. Open your terminal in any folder.
+
+1. Use `az group delete` to delete the resource group.
+
+    ```azurecli-interactive
+    az group delete \
+        --name $resourceGroupName
+    ```

articles/cosmos-db/gremlin/includes/quickstart-devlang.md

@@ -0,0 +1,16 @@
+---
+author: seesharprun
+ms.author: sidandrews
+ms.service: cosmos-db
+ms.subservice: apache-gremlin
+ms.topic: include
+ms.date: 09/27/2023
+---
+
+> [!div class="op_single_selector"]
+>
+> - [Console](../quickstart-console.md)
+> - [Python](../quickstart-python.md)
+> - [Node.js](../quickstart-nodejs.md)
+> - [.NET](../quickstart-dotnet.md)
+>