Merge pull request #235 from senatol/feature-cosmosdbpostgresql2

Add cosmosdb postgresql command module

Commands/cosmosdb/postgres/_check-name-availability.md

@@ -0,0 +1,9 @@
+# [Command] _cosmosdb postgres check-name-availability_
+
+Checks availability of a cluster name. Cluster names should be globally unique; at least 3 characters and at most 40 characters long; they must only contain lowercase letters, numbers, and hyphens; and must not start or end with a hyphen.
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvY2hlY2tuYW1lYXZhaWxhYmlsaXR5/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.dbforpostgresql/checknameavailability 2022-11-08 -->

Commands/cosmosdb/postgres/cluster/_create.md

@@ -0,0 +1,41 @@
+# [Command] _cosmosdb postgres cluster create_
+
+Create a new cluster with servers.
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvc2VydmVyZ3JvdXBzdjIve30=/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.dbforpostgresql/servergroupsv2/{} 2022-11-08 -->
+
+#### examples
+
+- Create a new single node cluster
+    ```bash
+        cosmosdb postgres cluster create -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --enable-ha false --coordinator-v-cores 8 --coordinator-server-edition "GeneralPurpose" --coordinator-storage 131072 --enable-shards-on-coord true --node-count 0 --preferred-primary-zone "1" --login-password "password"
+    ```
+
+- Create a new cluster as a point in time restore
+    ```bash
+        cosmosdb postgres cluster create -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --point-in-time-utc "2017-12-14T00:00:37.467Z" --source-location "eastus" --source-resource-id "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testGroup/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/source-cluster"
+    ```
+
+- Create a new cluster as a read replica
+    ```bash
+        cosmosdb postgres cluster create -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --source-location "eastus" --source-resource-id "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testGroup/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/source-cluster"
+    ```
+
+- Create a new multi-node cluster
+    ```bash
+        cosmosdb postgres cluster create -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --enable-ha false --coordinator-v-cores 8 --coordinator-server-edition "GeneralPurpose" --coordinator-storage 131072 --enable-shards-on-coord false --node-count 3 --node-server-edition "MemoryOptimized" --node-v-cores 8 --node-storage 131072 --postgresql-version "15" --preferred-primary-zone "1" --login-password "password"
+    ```
+
+- Create a new single node Burstable 1 vCore cluster
+    ```bash
+        cosmosdb postgres cluster create -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --enable-ha false --coordinator-v-cores 1 --coordinator-server-edition "BurstableMemoryOptimized" --coord-public-ip-access true --coordinator-storage 131072 --enable-shards-on-coord true --node-count 0 --preferred-primary-zone "1" --login-password "password"
+    ```
+
+- Create a new single node Burstable 2 vCores cluster
+    ```bash
+        cosmosdb postgres cluster create -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --enable-ha false --coordinator-v-cores 2 --coordinator-server-edition "BurstableGeneralPurpose" --coord-public-ip-access true --coordinator-storage 131072 --enable-shards-on-coord true --node-count 0 --preferred-primary-zone "1" --login-password "password"
+    ```

Commands/cosmosdb/postgres/cluster/_delete.md

@@ -0,0 +1,16 @@
+# [Command] _cosmosdb postgres cluster delete_
+
+Delete a cluster together with servers in it.
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvc2VydmVyZ3JvdXBzdjIve30=/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.dbforpostgresql/servergroupsv2/{} 2022-11-08 -->
+
+#### examples
+
+- Delete the cluster
+    ```bash
+        cosmosdb postgres cluster delete -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"
+    ```

Commands/cosmosdb/postgres/cluster/_list.md

@@ -0,0 +1,22 @@
+# [Command] _cosmosdb postgres cluster list_
+
+List all clusters in a subscription or a resource group.
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvc2VydmVyZ3JvdXBzdjI=/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.dbforpostgresql/servergroupsv2 2022-11-08 -->
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.dbforpostgresql/servergroupsv2 2022-11-08 -->
+
+#### examples
+
+- List clusters in a resource group
+    ```bash
+        cosmosdb postgres cluster list -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"
+    ```
+
+- List clusters in a subscription
+    ```bash
+        cosmosdb postgres cluster list --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"
+    ```

Commands/cosmosdb/postgres/cluster/_promote.md

@@ -0,0 +1,16 @@
+# [Command] _cosmosdb postgres cluster promote_
+
+Promotes read replica cluster to an independent read-write cluster.
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvc2VydmVyZ3JvdXBzdjIve30vcHJvbW90ZQ==/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.dbforpostgresql/servergroupsv2/{}/promote 2022-11-08 -->
+
+#### examples
+
+- Promote read replica cluster to an independent read-write cluster
+    ```bash
+        cosmosdb postgres cluster promote -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"
+    ```

Commands/cosmosdb/postgres/cluster/_restart.md

@@ -0,0 +1,16 @@
+# [Command] _cosmosdb postgres cluster restart_
+
+Restarts all nodes in the cluster.
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvc2VydmVyZ3JvdXBzdjIve30vcmVzdGFydA==/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.dbforpostgresql/servergroupsv2/{}/restart 2022-11-08 -->
+
+#### examples
+
+- Restart all servers in the cluster
+    ```bash
+        cosmosdb postgres cluster restart -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"
+    ```

Commands/cosmosdb/postgres/cluster/_show.md

@@ -0,0 +1,16 @@
+# [Command] _cosmosdb postgres cluster show_
+
+Get information about a cluster such as compute and storage configuration and cluster lifecycle metadata such as cluster creation date and time.
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvc2VydmVyZ3JvdXBzdjIve30=/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.dbforpostgresql/servergroupsv2/{} 2022-11-08 -->
+
+#### examples
+
+- Show details of cluster
+    ```bash
+        cosmosdb postgres cluster show -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"
+    ```

Commands/cosmosdb/postgres/cluster/_start.md

@@ -0,0 +1,16 @@
+# [Command] _cosmosdb postgres cluster start_
+
+Starts stopped compute on all cluster nodes.
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvc2VydmVyZ3JvdXBzdjIve30vc3RhcnQ=/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.dbforpostgresql/servergroupsv2/{}/start 2022-11-08 -->
+
+#### examples
+
+- Start all servers in the cluster
+    ```bash
+        cosmosdb postgres cluster start -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"
+    ```

Commands/cosmosdb/postgres/cluster/_stop.md

@@ -0,0 +1,16 @@
+# [Command] _cosmosdb postgres cluster stop_
+
+Stops compute on all cluster nodes.
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvc2VydmVyZ3JvdXBzdjIve30vc3RvcA==/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.dbforpostgresql/servergroupsv2/{}/stop 2022-11-08 -->
+
+#### examples
+
+- Stop all servers in the cluster
+    ```bash
+        cosmosdb postgres cluster stop -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"
+    ```

Commands/cosmosdb/postgres/cluster/_update.md

@@ -0,0 +1,36 @@
+# [Command] _cosmosdb postgres cluster update_
+
+Update an existing cluster. The request body can contain one or several properties from the cluster definition.
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvc2VydmVyZ3JvdXBzdjIve30=/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.dbforpostgresql/servergroupsv2/{} 2022-11-08 -->
+
+#### examples
+
+- Scale compute up or down
+    ```bash
+        cosmosdb postgres cluster update -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --node-v-cores 16
+    ```
+
+- Scale out: Add new worker nodes
+    ```bash
+        cosmosdb postgres cluster update -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --node-count 2
+    ```
+
+- Scale up storage
+    ```bash
+        cosmosdb postgres cluster update -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --coordinator-storage 2097152
+    ```
+
+- Update multiple configuration settings of the cluster
+    ```bash
+        cosmosdb postgres cluster update -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --node-v-cores 16 --node-count 4 coordinator-v-cores 16 --login-password "newPassword"
+    ```
+
+- Update or define maintenance window
+    ```bash
+        cosmosdb postgres cluster update -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --maintenance-window day-of-week=1 start-hour=2 --start-minute=0 custom-window="Enabled"
+    ```

Commands/cosmosdb/postgres/cluster/readme.md

@@ -0,0 +1,37 @@
+# [Group] _cosmosdb postgres cluster_
+
+Manage Azure Cosmos DB for PostgreSQL clusters.
+
+## Subgroups
+
+- [server](/Commands/cosmosdb/postgres/cluster/server/readme.md)
+: Manage Azure Cosmos DB for PostgreSQL cluster servers.
+
+## Commands
+
+- [create](/Commands/cosmosdb/postgres/cluster/_create.md)
+: Create a new cluster with servers.
+
+- [delete](/Commands/cosmosdb/postgres/cluster/_delete.md)
+: Delete a cluster together with servers in it.
+
+- [list](/Commands/cosmosdb/postgres/cluster/_list.md)
+: List all clusters in a subscription or a resource group.
+
+- [promote](/Commands/cosmosdb/postgres/cluster/_promote.md)
+: Promotes read replica cluster to an independent read-write cluster.
+
+- [restart](/Commands/cosmosdb/postgres/cluster/_restart.md)
+: Restarts all nodes in the cluster.
+
+- [show](/Commands/cosmosdb/postgres/cluster/_show.md)
+: Get information about a cluster such as compute and storage configuration and cluster lifecycle metadata such as cluster creation date and time.
+
+- [start](/Commands/cosmosdb/postgres/cluster/_start.md)
+: Starts stopped compute on all cluster nodes.
+
+- [stop](/Commands/cosmosdb/postgres/cluster/_stop.md)
+: Stops compute on all cluster nodes.
+
+- [update](/Commands/cosmosdb/postgres/cluster/_update.md)
+: Update an existing cluster. The request body can contain one or several properties from the cluster definition.

Commands/cosmosdb/postgres/cluster/server/_list.md

@@ -0,0 +1,16 @@
+# [Command] _cosmosdb postgres cluster server list_
+
+List servers of a cluster.
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvc2VydmVyZ3JvdXBzdjIve30vc2VydmVycw==/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.dbforpostgresql/servergroupsv2/{}/servers 2022-11-08 -->
+
+#### examples
+
+- List servers of the cluster
+    ```bash
+        cosmosdb postgres cluster server list --cluster-name "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"
+    ```

Commands/cosmosdb/postgres/cluster/server/_show.md

@@ -0,0 +1,16 @@
+# [Command] _cosmosdb postgres cluster server show_
+
+Get information about a server in cluster.
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvc2VydmVyZ3JvdXBzdjIve30vc2VydmVycy97fQ==/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.dbforpostgresql/servergroupsv2/{}/servers/{} 2022-11-08 -->
+
+#### examples
+
+- Show the server of cluster
+    ```bash
+        cosmosdb postgres cluster server show -n "test-cluster-c" --cluster-name "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"
+    ```

Commands/cosmosdb/postgres/cluster/server/readme.md

@@ -0,0 +1,11 @@
+# [Group] _cosmosdb postgres cluster server_
+
+Manage Azure Cosmos DB for PostgreSQL cluster servers.
+
+## Commands
+
+- [list](/Commands/cosmosdb/postgres/cluster/server/_list.md)
+: List servers of a cluster.
+
+- [show](/Commands/cosmosdb/postgres/cluster/server/_show.md)
+: Get information about a server in cluster.

Commands/cosmosdb/postgres/configuration/_list.md

@@ -0,0 +1,16 @@
+# [Command] _cosmosdb postgres configuration list_
+
+List all the configurations of a cluster.
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvc2VydmVyZ3JvdXBzdjIve30vY29uZmlndXJhdGlvbnM=/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.dbforpostgresql/servergroupsv2/{}/configurations 2022-11-08 -->
+
+#### examples
+
+- List configurations of the cluster
+    ```bash
+        cosmosdb postgres configuration list --cluster-name "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"
+    ```

Commands/cosmosdb/postgres/configuration/_show.md

@@ -0,0 +1,16 @@
+# [Command] _cosmosdb postgres configuration show_
+
+Get information of a configuration for coordinator and nodes.
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvc2VydmVyZ3JvdXBzdjIve30vY29uZmlndXJhdGlvbnMve30=/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.dbforpostgresql/servergroupsv2/{}/configurations/{} 2022-11-08 -->
+
+#### examples
+
+- Get configuration details
+    ```bash
+        cosmosdb postgres configuration show -n "array-nulls" --cluster-name "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"
+    ```

Commands/cosmosdb/postgres/configuration/coordinator/_show.md

@@ -0,0 +1,16 @@
+# [Command] _cosmosdb postgres configuration coordinator show_
+
+Get information of a configuration for coordinator.
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvc2VydmVyZ3JvdXBzdjIve30vY29vcmRpbmF0b3Jjb25maWd1cmF0aW9ucy97fQ==/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.dbforpostgresql/servergroupsv2/{}/coordinatorconfigurations/{} 2022-11-08 -->
+
+#### examples
+
+- Get configuration details for coordinator
+    ```bash
+        cosmosdb postgres configuration coordinator show -n "array_nulls" --cluster-name "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"
+    ```

Commands/cosmosdb/postgres/configuration/coordinator/_update.md

@@ -0,0 +1,16 @@
+# [Command] _cosmosdb postgres configuration coordinator update_
+
+Updates configuration of coordinator in a cluster
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvc2VydmVyZ3JvdXBzdjIve30vY29vcmRpbmF0b3Jjb25maWd1cmF0aW9ucy97fQ==/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.dbforpostgresql/servergroupsv2/{}/coordinatorconfigurations/{} 2022-11-08 -->
+
+#### examples
+
+- Update single configuration of coordinator
+    ```bash
+        cosmosdb postgres configuration coordinator update -n "array_nulls" --value "off" --cluster-name "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"
+    ```

Commands/cosmosdb/postgres/configuration/coordinator/readme.md

@@ -0,0 +1,11 @@
+# [Group] _cosmosdb postgres configuration coordinator_
+
+Manage Azure Cosmos DB for PostgreSQL coordinator configurations.
+
+## Commands
+
+- [show](/Commands/cosmosdb/postgres/configuration/coordinator/_show.md)
+: Get information of a configuration for coordinator.
+
+- [update](/Commands/cosmosdb/postgres/configuration/coordinator/_update.md)
+: Updates configuration of coordinator in a cluster

Commands/cosmosdb/postgres/configuration/node/_show.md

@@ -0,0 +1,16 @@
+# [Command] _cosmosdb postgres configuration node show_
+
+Get information of a configuration for worker nodes.
+
+## Versions
+
+### [2022-11-08](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kYmZvcnBvc3RncmVzcWwvc2VydmVyZ3JvdXBzdjIve30vbm9kZWNvbmZpZ3VyYXRpb25zL3t9/2022-11-08.xml) **Preview**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.dbforpostgresql/servergroupsv2/{}/nodeconfigurations/{} 2022-11-08 -->
+
+#### examples
+
+- Get configuration details for node
+    ```bash
+        cosmosdb postgres configuration node show -n "array_nulls" --cluster-name "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"
+    ```