Merge pull request Azure#140 from gaoyp830/yunga/RI

[Reservations] Update cli commands to 2022-11-01 version
ShreyaAnand · Mar 8, 2023 · fe0f197 · fe0f197
2 parents ca5de74 + 1e5e229
commit fe0f197
Show file tree

Hide file tree

Showing 62 changed files with 7,530 additions and 0 deletions.
diff --git a/Commands/reservations/_calculate-exchange.md b/Commands/reservations/_calculate-exchange.md
@@ -15,3 +15,14 @@ Calculates price for exchanging `Reservations` if there are no policy errors.
     ```bash
         reservations calculate-exchange --ris-to-exchange "[{reservation-id:/providers/microsoft.capacity/reservationOrders/40000000-aaaa-bbbb-cccc-200000000012/reservations/51000000-aaaa-bbbb-cccc-200000000012,quantity:1},{reservation-id:/providers/microsoft.capacity/reservationOrders/90000000-aaaa-bbbb-cccc-200000000012/reservations/36000000-aaaa-bbbb-cccc-200000000012,quantity:1}]" --ris-to-purchase "[{reserved-resource-type:VirtualMachines,applied-scope-type:Shared,billing-scope:12350000-aaaa-bbbb-cccc-200000000012,display-name:exchangeTest1,quantity:1,sku:Standard_B1s,term:P1Y,billing-plan:Monthly,location:eastus},{reserved-resource-type:VirtualMachines,applied-scope-type:Shared,billing-scope:12350000-aaaa-bbbb-cccc-200000000012,display-name:exchangeTest2,quantity:1,sku:Standard_B1s,term:P1Y,billing-plan:Monthly,location:eastus}]"
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvY2FsY3VsYXRlZXhjaGFuZ2U=/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/calculateexchange 2022-11-01 -->
+
+#### examples
+
+- Calculate exchange
+    ```bash
+        reservations calculate-exchange --ris-to-exchange "[{reservation-id:/providers/microsoft.capacity/reservationOrders/40000000-aaaa-bbbb-cccc-200000000012/reservations/51000000-aaaa-bbbb-cccc-200000000012,quantity:1},{reservation-id:/providers/microsoft.capacity/reservationOrders/90000000-aaaa-bbbb-cccc-200000000012/reservations/36000000-aaaa-bbbb-cccc-200000000012,quantity:1}]" --ris-to-purchase "[{reserved-resource-type:VirtualMachines,applied-scope-type:Shared,billing-scope:12350000-aaaa-bbbb-cccc-200000000012,display-name:exchangeTest1,quantity:1,sku:Standard_B1s,term:P1Y,billing-plan:Monthly,location:eastus},{reserved-resource-type:VirtualMachines,applied-scope-type:Shared,billing-scope:12350000-aaaa-bbbb-cccc-200000000012,display-name:exchangeTest2,quantity:1,sku:Standard_B1s,term:P1Y,billing-plan:Monthly,location:eastus}]"
+    ```
diff --git a/Commands/reservations/_exchange.md b/Commands/reservations/_exchange.md
@@ -15,3 +15,14 @@ Returns one or more `Reservations` in exchange for one or more `Reservation` pur
     ```bash
         reservations exchange --session-id 40000000-aaaa-bbbb-cccc-200000000012
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvZXhjaGFuZ2U=/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/exchange 2022-11-01 -->
+
+#### examples
+
+- Exchange reservations
+    ```bash
+        reservations exchange --session-id 40000000-aaaa-bbbb-cccc-200000000012
+    ```
diff --git a/Commands/reservations/_list.md b/Commands/reservations/_list.md
@@ -0,0 +1,31 @@
+# [Command] _reservations list_
+
+List the reservations that the user has access to in the current tenant.
+
+## Versions
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25z/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/reservations 2022-11-01 -->
+
+#### examples
+
+- List reservations under the current tenant
+    ```bash
+        reservations list
+    ```
+
+- List reservation which has "Failed" state under the current tenant
+    ```bash
+        reservations list --selected-state "Failed"
+    ```
+
+- List all "VirtualMachines" reservations under the current tenant
+    ```bash
+        az reservations list --filter "properties/reservedResourceType eq 'VirtualMachines'"
+    ```
+
+- List reservation and order the result by quantity in descending order
+    ```bash
+        reservations list --orderby 'properties/quantity desc'
+    ```
diff --git a/Commands/reservations/catalog/_show.md b/Commands/reservations/catalog/_show.md
@@ -14,3 +14,14 @@ Get catalog of available reservation.
     ```bash
         reservations catalog show --subscription-id 7a802e4f-129c-4574-9b46-638f17b60dd5 --location eastus --reserved-resource-type VirtualMachines
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jYXBhY2l0eS9jYXRhbG9ncw==/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.capacity/catalogs 2022-11-01 -->
+
+#### examples
+
+- Get catalog of VM reservation skus
+    ```bash
+        reservations catalog show --subscription-id 7a802e4f-129c-4574-9b46-638f17b60dd5 --location eastus --reserved-resource-type VirtualMachines
+    ```
diff --git a/Commands/reservations/readme.md b/Commands/reservations/readme.md
@@ -25,3 +25,6 @@ Azure Reservations
 - [exchange](/Commands/reservations/_exchange.md)
 : Returns one or more `Reservations` in exchange for one or more `Reservation` purchases.
 
+
+- [list](/Commands/reservations/_list.md)
+: List the reservations that the user has access to in the current tenant.
diff --git a/Commands/reservations/reservation-order-id/_list.md b/Commands/reservations/reservation-order-id/_list.md
@@ -14,3 +14,14 @@ List applicable `Reservation`s that are applied to this subscription or a resour
     ```bash
         reservations reservation-order-id list --subscription-id 50000000-aaaa-bbbb-cccc-100000000002
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jYXBhY2l0eS9hcHBsaWVkcmVzZXJ2YXRpb25z/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.capacity/appliedreservations 2022-11-01 -->
+
+#### examples
+
+- See reservation order ids that are applied to subscription.
+    ```bash
+        reservations reservation-order-id list --subscription-id 50000000-aaaa-bbbb-cccc-100000000002
+    ```
diff --git a/Commands/reservations/reservation-order/_calculate-refund.md b/Commands/reservations/reservation-order/_calculate-refund.md
@@ -15,3 +15,14 @@ Calculate price for returning `Reservations` if there are no policy errors.
     ```bash
         reservations reservation-order calculate-refund --reservation-order-id 0000000-aaaa-bbbb-cccc-20000000001 --id /providers/microsoft.capacity/reservationOrders/0000000-aaaa-bbbb-cccc-20000000001 --scope Reservation --quantity 1 --reservation-id /providers/microsoft.capacity/reservationOrders/0000000-aaaa-bbbb-cccc-20000000001/reservations/50000000-aaaa-bbbb-cccc-200000000000
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25vcmRlcnMve30vY2FsY3VsYXRlcmVmdW5k/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/reservationorders/{}/calculaterefund 2022-11-01 -->
+
+#### examples
+
+- Calculate refund
+    ```bash
+        reservations reservation-order calculate-refund --reservation-order-id 0000000-aaaa-bbbb-cccc-20000000001 --id /providers/microsoft.capacity/reservationOrders/0000000-aaaa-bbbb-cccc-20000000001 --scope Reservation --quantity 1 --reservation-id /providers/microsoft.capacity/reservationOrders/0000000-aaaa-bbbb-cccc-20000000001/reservations/50000000-aaaa-bbbb-cccc-200000000000
+    ```
diff --git a/Commands/reservations/reservation-order/_calculate.md b/Commands/reservations/reservation-order/_calculate.md
@@ -14,3 +14,14 @@ Calculate price for placing a `ReservationOrder`.
     ```bash
         reservations reservation-order calculate --applied-scope-type Shared --billing-scope 50000000-aaaa-bbbb-cccc-100000000002 --display-name name1 --quantity 1 --reserved-resource-type VirtualMachines --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvY2FsY3VsYXRlcHJpY2U=/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/calculateprice 2022-11-01 -->
+
+#### examples
+
+- Calculate price
+    ```bash
+        reservations reservation-order calculate --applied-scope-type Shared --billing-scope 50000000-aaaa-bbbb-cccc-100000000002 --display-name name1 --quantity 1 --reserved-resource-type VirtualMachines --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus
+    ```
diff --git a/Commands/reservations/reservation-order/_change-directory.md b/Commands/reservations/reservation-order/_change-directory.md
@@ -14,3 +14,14 @@ Change directory (tenant) of `ReservationOrder` and all `Reservation` under it t
     ```bash
         reservations reservation-order change-directory --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000000 --destination-tenant-id 10000000-aaaa-bbbb-cccc-200000000011
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25vcmRlcnMve30vY2hhbmdlZGlyZWN0b3J5/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/reservationorders/{}/changedirectory 2022-11-01 -->
+
+#### examples
+
+- Change a reservation order to another tenant
+    ```bash
+        reservations reservation-order change-directory --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000000 --destination-tenant-id 10000000-aaaa-bbbb-cccc-200000000011
+    ```
diff --git a/Commands/reservations/reservation-order/_list.md b/Commands/reservations/reservation-order/_list.md
@@ -14,3 +14,14 @@ List of all the `ReservationOrder`s that the user has access to in the current t
     ```bash
         reservations reservation-order list
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25vcmRlcnM=/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/reservationorders 2022-11-01 -->
+
+#### examples
+
+- List of all the reservation orders that the user has access to in the current tenant.
+    ```bash
+        reservations reservation-order list
+    ```
diff --git a/Commands/reservations/reservation-order/_purchase.md b/Commands/reservations/reservation-order/_purchase.md
@@ -19,3 +19,19 @@ Create `ReservationOrder` and create resource under the specified URI.
     ```bash
         reservations reservation-order purchase --reservation-order-id 40000000-aaaa-bbbb-cccc-200000000005 --applied-scope-type Single --billing-scope 50000000-aaaa-bbbb-cccc-200000000005 --reserved-resource-type VirtualMachines --display-name testername1 --quantity 1 --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus --applied-scope '/subscriptions/50000000-aaaa-bbbb-cccc-200000000005/resourceGroups/rg1' --instance-flexibility Off
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25vcmRlcnMve30=/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/reservationorders/{} 2022-11-01 -->
+
+#### examples
+
+- Purchase a single scope reservation
+    ```bash
+        reservations reservation-order purchase --reservation-order-id 40000000-aaaa-bbbb-cccc-200000000005 --applied-scope-type Single --billing-scope 50000000-aaaa-bbbb-cccc-200000000005 --reserved-resource-type VirtualMachines --display-name name1 --quantity 1 --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus --applied-scope 50000000-aaaa-bbbb-cccc-200000000010
+    ```
+
+- Purchase a Single scope with resource group reservation
+    ```bash
+        reservations reservation-order purchase --reservation-order-id 40000000-aaaa-bbbb-cccc-200000000005 --applied-scope-type Single --billing-scope 50000000-aaaa-bbbb-cccc-200000000005 --reserved-resource-type VirtualMachines --display-name testername1 --quantity 1 --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus --applied-scope '/subscriptions/50000000-aaaa-bbbb-cccc-200000000005/resourceGroups/rg1' --instance-flexibility Off
+    ```
diff --git a/Commands/reservations/reservation-order/_return.md b/Commands/reservations/reservation-order/_return.md
@@ -14,3 +14,14 @@ Return a reservation.
     ```bash
         reservations reservation-order return --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000000 --return-reason mockReason --scope Reservation --quantity 1 --reservation-id /providers/microsoft.capacity/reservationOrders/50000000-aaaa-bbbb-cccc-200000000000/reservations/30000000-aaaa-bbbb-cccc-200000000011 --session-id 40000000-aaaa-bbbb-cccc-200000000012
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25vcmRlcnMve30vcmV0dXJu/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/reservationorders/{}/return 2022-11-01 -->
+
+#### examples
+
+- Return a reservation
+    ```bash
+        reservations reservation-order return --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000000 --return-reason mockReason --scope Reservation --quantity 1 --reservation-id /providers/microsoft.capacity/reservationOrders/50000000-aaaa-bbbb-cccc-200000000000/reservations/30000000-aaaa-bbbb-cccc-200000000011 --session-id 40000000-aaaa-bbbb-cccc-200000000020
+    ```
diff --git a/Commands/reservations/reservation-order/_show.md b/Commands/reservations/reservation-order/_show.md
@@ -14,3 +14,14 @@ Get the details of the `ReservationOrder`.
     ```bash
         reservations reservation-order show --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000005
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25vcmRlcnMve30=/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/reservationorders/{} 2022-11-01 -->
+
+#### examples
+
+- Get the details of a reservation order
+    ```bash
+        reservations reservation-order show --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000005
+    ```
diff --git a/Commands/reservations/reservation-order/_update.md b/Commands/reservations/reservation-order/_update.md
@@ -7,3 +7,7 @@ Update `ReservationOrder` and create resource under the specified URI.
 ### [2022-03-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25vcmRlcnMve30=/2022-03-01.xml) **Stable**
 
 <!-- mgmt-plane /providers/microsoft.capacity/reservationorders/{} 2022-03-01 -->
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25vcmRlcnMve30=/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/reservationorders/{} 2022-11-01 -->
diff --git a/Commands/reservations/reservation/_archive.md b/Commands/reservations/reservation/_archive.md
@@ -14,3 +14,14 @@ Archiving a `Reservation` which is in cancelled/expired state and move it to `Ar
     ```bash
         reservations reservation archive --reservation-order-id 40000000-aaaa-bbbb-cccc-20000000000 --reservation-id 50000000-aaaa-bbbb-cccc-200000000000
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25vcmRlcnMve30vcmVzZXJ2YXRpb25zL3t9L2FyY2hpdmU=/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/reservationorders/{}/reservations/{}/archive 2022-11-01 -->
+
+#### examples
+
+- Archiving a reservation
+    ```bash
+        reservations reservation archive --reservation-order-id 40000000-aaaa-bbbb-cccc-20000000000 --reservation-id 50000000-aaaa-bbbb-cccc-200000000000
+    ```
diff --git a/Commands/reservations/reservation/_list-available-scope.md b/Commands/reservations/reservation/_list-available-scope.md
@@ -14,3 +14,14 @@ List Available Scopes for `Reservation`.
     ```bash
         reservations reservation list-available-scope --reservation-order-id 40000000-aaaa-bbbb-cccc-20000000000 --reservation-id 30000000-aaaa-bbbb-cccc-20000000000 --scopes ['/subscriptions/60000000-aaaa-bbbb-cccc-20000000000']
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25vcmRlcnMve30vcmVzZXJ2YXRpb25zL3t9L2F2YWlsYWJsZXNjb3Blcw==/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/reservationorders/{}/reservations/{}/availablescopes 2022-11-01 -->
+
+#### examples
+
+- List reservation available scopes
+    ```bash
+        reservations reservation list-available-scope --reservation-order-id 40000000-aaaa-bbbb-cccc-20000000000 --reservation-id 30000000-aaaa-bbbb-cccc-20000000000 --scopes ['/subscriptions/60000000-aaaa-bbbb-cccc-20000000000']
+    ```
diff --git a/Commands/reservations/reservation/_list-history.md b/Commands/reservations/reservation/_list-history.md
@@ -14,3 +14,14 @@ List of all the revisions for the `Reservation`.
     ```bash
         reservations reservation list-history --reservation-id 50000000-aaaa-bbbb-cccc-100000000002 --reservation-order-id 10000000-aaaa-bbbb-cccc-100000000005
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25vcmRlcnMve30vcmVzZXJ2YXRpb25zL3t9L3JldmlzaW9ucw==/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/reservationorders/{}/reservations/{}/revisions 2022-11-01 -->
+
+#### examples
+
+- Get history of a reservation.
+    ```bash
+        reservations reservation list-history --reservation-id 50000000-aaaa-bbbb-cccc-100000000002 --reservation-order-id 10000000-aaaa-bbbb-cccc-100000000005
+    ```
diff --git a/Commands/reservations/reservation/_list.md b/Commands/reservations/reservation/_list.md
@@ -14,3 +14,14 @@ List Reservations within a single `ReservationOrder`.
     ```bash
         reservations reservation list --reservation-order-id 50000000-aaaa-bbbb-cccc-100000000002
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25vcmRlcnMve30vcmVzZXJ2YXRpb25z/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/reservationorders/{}/reservations 2022-11-01 -->
+
+#### examples
+
+- List all reservations within a reservation order.
+    ```bash
+        reservations reservation list --reservation-order-id 50000000-aaaa-bbbb-cccc-100000000002
+    ```
diff --git a/Commands/reservations/reservation/_merge.md b/Commands/reservations/reservation/_merge.md
@@ -14,3 +14,14 @@ Merge the specified `Reservation`s into a new `Reservation`. The two `Reservatio
     ```bash
         reservations reservation merge --reservation-order-id 10000000-aaaa-bbbb-cccc-100000000005 --sources "['/providers/Microsoft.Capacity/reservationOrders/10000000-aaaa-bbbb-cccc-100000000005/reservations/30000000-aaaa-bbbb-cccc-100000000002','/providers/Microsoft.Capacity/reservationOrders/10000000-aaaa-bbbb-cccc-100000000005/reservations/30000000-aaaa-bbbb-cccc-100000000004']"
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25vcmRlcnMve30vbWVyZ2U=/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/reservationorders/{}/merge 2022-11-01 -->
+
+#### examples
+
+- Merge reservations
+    ```bash
+        reservations reservation merge --reservation-order-id 10000000-aaaa-bbbb-cccc-100000000005 --sources "['/providers/Microsoft.Capacity/reservationOrders/10000000-aaaa-bbbb-cccc-100000000005/reservations/30000000-aaaa-bbbb-cccc-100000000002','/providers/Microsoft.Capacity/reservationOrders/10000000-aaaa-bbbb-cccc-100000000005/reservations/30000000-aaaa-bbbb-cccc-100000000004']"
+    ```
diff --git a/Commands/reservations/reservation/_show.md b/Commands/reservations/reservation/_show.md
@@ -14,3 +14,14 @@ Get specific `Reservation` details.
     ```bash
         reservations reservation show --reservation-id 40000000-aaaa-bbbb-cccc-100000000001 --reservation-order-id 10000000-aaaa-bbbb-cccc-200000000001
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25vcmRlcnMve30vcmVzZXJ2YXRpb25zL3t9/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/reservationorders/{}/reservations/{} 2022-11-01 -->
+
+#### examples
+
+- Get a reservation detail
+    ```bash
+        reservations reservation show --reservation-id 40000000-aaaa-bbbb-cccc-100000000001 --reservation-order-id 10000000-aaaa-bbbb-cccc-200000000001
+    ```
diff --git a/Commands/reservations/reservation/_split.md b/Commands/reservations/reservation/_split.md
@@ -14,3 +14,14 @@ Split a `Reservation` into two `Reservation`s with specified quantity distributi
     ```bash
         reservations reservation split --quantities "[2,8]" --reservation-id /providers/Microsoft.Capacity/reservationOrders/30000000-aaaa-bbbb-cccc-100000000004/reservations/40000000-aaaa-bbbb-cccc-100000000001 --reservation-order-id 30000000-aaaa-bbbb-cccc-100000000004
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25vcmRlcnMve30vc3BsaXQ=/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/reservationorders/{}/split 2022-11-01 -->
+
+#### examples
+
+- Split a reservation
+    ```bash
+        reservations reservation split --quantities "[2,8]" --reservation-id /providers/Microsoft.Capacity/reservationOrders/30000000-aaaa-bbbb-cccc-100000000004/reservations/40000000-aaaa-bbbb-cccc-100000000001 --reservation-order-id 30000000-aaaa-bbbb-cccc-100000000004
+    ```
diff --git a/Commands/reservations/reservation/_unarchive.md b/Commands/reservations/reservation/_unarchive.md
@@ -14,3 +14,14 @@ Unarchiving a `Reservation` moves it to the state it was before archiving.
     ```bash
         reservations reservation unarchive --reservation-order-id 40000000-aaaa-bbbb-cccc-20000000000 --reservation-id 50000000-aaaa-bbbb-cccc-200000000000
     ```
+
+### [2022-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuY2FwYWNpdHkvcmVzZXJ2YXRpb25vcmRlcnMve30vcmVzZXJ2YXRpb25zL3t9L3VuYXJjaGl2ZQ==/2022-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.capacity/reservationorders/{}/reservations/{}/unarchive 2022-11-01 -->
+
+#### examples
+
+- Unarchiving a reservation
+    ```bash
+        reservations reservation unarchive --reservation-order-id 40000000-aaaa-bbbb-cccc-20000000000 --reservation-id 50000000-aaaa-bbbb-cccc-200000000000
+    ```