Merge pull request #231689 from mumian/0322-postgresql

add parameter samples and descriptions

Author: AnnaMHuff

articles/postgresql/flexible-server/quickstart-create-server-bicep.md

@@ -102,9 +102,9 @@ New-AzResourceGroupDeployment -ResourceGroupName exampleRG  -TemplateFile "./mai
 
 You'll be prompted to enter these values:
 
-- **serverName**: enter a name for the PostgreSQL server.
-- **administratorLogin**: enter the Azure Database for PostgreSQL server's administrator account name.
-- **administratorLoginPassword**: enter the administrator password.
+- **serverName**: enter a unique name that identifies your Azure Database for PostgreSQL server. For example, `mydemoserver-pg`. The domain name `postgres.database.azure.com` is appended to the server name you provide. The server can contain only lowercase letters, numbers, and the hyphen (-) character. It must contain at least 3 through 63 characters.
+- **administratorLogin**: enter your own login account to use when you connect to the server. For example, `myadmin`. The admin login name can't be `azure_superuser`, `azure_pg_admin`, `admin`, `administrator`, `root`, `guest`, or `public`. It can't start with `pg_`.
+- **administratorLoginPassword**: enter a new password for the server admin account. It must contain between 8 and 128 characters. Your password must contain characters from three of the following categories: English uppercase letters, English lowercase letters, numbers (0 through 9), and non-alphanumeric characters (!, $, #, %, etc.).
 
 ## Review deployed resources
 

articles/postgresql/flexible-server/quickstart-create-server-portal.md

@@ -30,17 +30,17 @@ To create an Azure Database for PostgreSQL server, take the following steps:
 
 1. Select **Create a resource** (+) in the upper-left corner of the portal.
 
-2. Select **Databases** > **Azure Database for PostgreSQL**.
+1. Select **Databases** > **Azure Database for PostgreSQL**.
 
     :::image type="content" source="./media/quickstart-create-database-portal/1-create-database.png" alt-text="The Azure Database for PostgreSQL in menu":::
 
-3. Select the **Flexible server** deployment option.
+1. Select the **Flexible server** deployment option.
 
    :::image type="content" source="./media/quickstart-create-database-portal/2-select-deployment-option.png" alt-text="Select Azure Database for PostgreSQL - Flexible server deployment option":::
 
-4. Fill out the **Basics** form with the following information:
+1. Fill out the **Basics** form with the following information:
 
-    :::image type="content" source="./media/quickstart-create-database-portal/3-create-basics.png" alt-text="Create a server":::
+    :::image type="content" source="./media/quickstart-create-database-portal/3-create-basics.png" alt-text="Create a server.":::
 
     Setting|Suggested Value|Description
     ---|---|---
@@ -56,12 +56,11 @@ To create an Azure Database for PostgreSQL server, take the following steps:
     Version|The latest major version| The latest PostgreSQL major version, unless you have specific requirements otherwise.
     Compute + storage | **General Purpose**, **4 vCores**, **512 GB**, **7 days** | The compute, storage, and backup configurations for your new server. Select **Configure server**. *General Purpose*, *4 vCores*, *512 GB*, and *7 days* are the default values for **Compute tier**, **vCore**, **Storage**, and **Backup Retention Period**.  You can leave those sliders as is or adjust them. <br> <br> To configure your server with **Geo-redundant Backup** to protect from region-level failures, you can check the box ON. Note that the Geo-redundant backup can be configured only at the time of server creation. To save this pricing tier selection, select **OK**. The next screenshot captures these selections.
 
-    :::image type="content" source="./media/quickstart-create-database-portal/4-pricing-tier-geo-backup.png" alt-text="The Pricing tier pane":::
+    :::image type="content" source="./media/quickstart-create-database-portal/4-pricing-tier-geo-backup.png" alt-text="The Pricing tier pane.":::
 
-    
-5. Configure Networking options
-6. 
-    On the **Networking** tab, you can choose how your server is reachable. Azure Database for PostgreSQL Flexible Server provides two ways to connect to your server:
+1. Configure Networking options
+
+1. On the **Networking** tab, you can choose how your server is reachable. Azure Database for PostgreSQL Flexible Server provides two ways to connect to your server:
    - Public access (allowed IP addresses)
    - Private access (VNet Integration)
 
@@ -72,16 +71,13 @@ To create an Azure Database for PostgreSQL server, take the following steps:
     > [!NOTE]
     > You can't change the connectivity method after you create the server. For example, if you select **Public access (allowed IP addresses)** when you create the server, you can't change to **Private access (VNet Integration)** after the server is created. We highly recommend that you create your server with private access to help secure access to your server via VNet Integration. [Learn more about private access in the concepts article.](./concepts-networking.md)
 
+    :::image type="content" source="./media/quickstart-create-database-portal/5-networking.png" alt-text="The Networking pane.":::
 
-    :::image type="content" source="./media/quickstart-create-database-portal/5-networking.png" alt-text="The Networking pane":::
-
-  
-
-6. Select **Review + create** to review your selections. Select **Create** to provision the server. This operation may take a few minutes.
+1. Select **Review + create** to review your selections. Select **Create** to provision the server. This operation may take a few minutes.
 
-7. On the toolbar, select the **Notifications** icon (a bell) to monitor the deployment process. Once the deployment is done, you can select **Pin to dashboard**, which creates a tile for this server on your Azure portal dashboard as a shortcut to the server's **Overview** page. Selecting **Go to resource** opens the server's **Overview** page.
+1. On the toolbar, select the **Notifications** icon (a bell) to monitor the deployment process. Once the deployment is done, you can select **Pin to dashboard**, which creates a tile for this server on your Azure portal dashboard as a shortcut to the server's **Overview** page. Selecting **Go to resource** opens the server's **Overview** page.
 
-    :::image type="content" source="./media/quickstart-create-database-portal/7-notifications.png" alt-text="The Notifications pane":::
+    :::image type="content" source="./media/quickstart-create-database-portal/7-notifications.png" alt-text="The Notifications pane.":::
 
    By default, a **postgres** database is created under your server. The [postgres](https://www.postgresql.org/docs/current/static/app-initdb.html) database is a default database that's meant for use by users, utilities, and third-party applications. (The other default database is **azure_maintenance**. Its function is to separate the managed service processes from user actions. You cannot access this database.)
 
@@ -95,7 +91,7 @@ When you create your Azure Database for PostgreSQL server, a default database na
 
 Open your server's **Overview** page. Make a note of the **Server name** and the **Server admin login name**. Hover your cursor over each field, and the copy symbol appears to the right of the text. Select the copy symbol as needed to copy the values.
 
- :::image type="content" source="./media/quickstart-create-database-portal/8-server-name.png" alt-text="The server Overview page":::
+ :::image type="content" source="./media/quickstart-create-database-portal/8-server-name.png" alt-text="The server Overview page.":::
 
 ## Connect to the PostgreSQL database using psql
 
@@ -108,7 +104,7 @@ There are a number of applications you can use to connect to your Azure Database
    ```
 
    For example, the following command connects to the default database called **postgres** on your PostgreSQL server **mydemoserver.postgres.database.azure.com** using access credentials. Enter the `<server_admin_password>` you chose when prompted for password.
-  
+
    ```bash
    psql --host=mydemoserver-pg.postgres.database.azure.com --port=5432 --username=myadmin --dbname=postgres
    ```
@@ -135,19 +131,19 @@ There are a number of applications you can use to connect to your Azure Database
    >
    > Confirm your client's IP is allowed in the firewall rules step above.
 
-2. Create a blank database called "mypgsqldb" at the prompt by typing the following command:
+1. Create a blank database called "mypgsqldb" at the prompt by typing the following command:
 
     ```bash
     CREATE DATABASE mypgsqldb;
     ```
 
-3. At the prompt, execute the following command to switch connections to the newly created database **mypgsqldb**:
+1. At the prompt, execute the following command to switch connections to the newly created database **mypgsqldb**:
 
     ```bash
     \c mypgsqldb
     ```
 
-4. Type  `\q`, and then select the Enter key to quit psql.
+1. Type  `\q`, and then select the Enter key to quit psql.
 
 You connected to the Azure Database for PostgreSQL server via psql, and you created a blank user database.
 
@@ -162,18 +158,19 @@ To delete the entire resource group, including the newly created server:
 
 1. Locate your resource group in the portal. On the menu on the left, select **Resource groups**. Then select the name of your resource group, such as the example, **myresourcegroup**.
 
-2. On your resource group page, select **Delete**. Enter the name of your resource group, such as the example, **myresourcegroup**, in the text box to confirm deletion. Select **Delete**.
+1. On your resource group page, select **Delete**. Enter the name of your resource group, such as the example, **myresourcegroup**, in the text box to confirm deletion. Select **Delete**.
 
 To delete only the newly created server:
 
 1. Locate your server in the portal, if you don't have it open. On the menu on the left, select **All resources**. Then search for the server you created.
 
-2. On the **Overview** page, select **Delete**.
+1. On the **Overview** page, select **Delete**.
 
     :::image type="content" source="./media/quickstart-create-database-portal/9-delete.png" alt-text="The Delete button":::
 
-3. Confirm the name of the server you want to delete, and view the databases under it that are affected. Enter your server name in the text box, such as the example, **mydemoserver**. Select **Delete**.
+1. Confirm the name of the server you want to delete, and view the databases under it that are affected. Enter your server name in the text box, such as the example, **mydemoserver**. Select **Delete**.
 
 ## Next steps
+
 > [!div class="nextstepaction"]
 > [Deploy a Django app with App Service and PostgreSQL](tutorial-django-app-service-postgres.md)