Adding Query Parameter to GenerateSshKeyPair API (#26090)

* init

* PR comments

* Turning this into a POST

* fix

* another fix

* fixes

* fixes

* fix

Author: kamusta-msft

specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2023-09-01/examples/sshPublicKeyExamples/SshPublicKey_GenerateKeyPair_EncryptionWithEd25519.json

@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2023-09-01",
+    "sshPublicKeyName": "mySshPublicKeyName",
+    "parameters": {
+      "encryptionType": "RSA"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "privateKey": "{ssh private key}",
+        "publicKey": "{ssh-rsa public key}",
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/SshPublicKeys/mySshPublicKeyName"
+      }
+    }
+  }
+}

specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2023-09-01/examples/sshPublicKeyExamples/SshPublicKey_GenerateKeyPair_EncryptionWithRSA.json

@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2023-09-01",
+    "sshPublicKeyName": "mySshPublicKeyName",
+    "parameters": {
+      "encryptionType": "RSA"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "privateKey": "{ed25519 private key}",
+        "publicKey": "{ed25519 public key}",
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/SshPublicKeys/mySshPublicKeyName"
+      }
+    }
+  }
+}

specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2023-09-01/sshPublicKey.json

@@ -371,6 +371,15 @@
             "type": "string",
             "description": "The name of the SSH public key."
           },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": false,
+            "schema": {
+              "$ref": "#/definitions/SshGenerateKeyPairInputParameters"
+            },
+            "description": "Parameters supplied to generate the SSH public key."
+          },
           {
             "$ref": "../../../common-types/v1/common.json#/parameters/ApiVersionParameter"
           },
@@ -395,6 +404,12 @@
         "x-ms-examples": {
           "Generate an SSH key pair.": {
             "$ref": "./examples/sshPublicKeyExamples/SshPublicKey_GenerateKeyPair.json"
+          },
+          "Generate an SSH key pair with RSA encryption.": {
+            "$ref": "./examples/sshPublicKeyExamples/SshPublicKey_GenerateKeyPair_EncryptionWithRSA.json"
+          },
+          "Generate an SSH key pair with Ed25519 encryption.": {
+            "$ref": "./examples/sshPublicKeyExamples/SshPublicKey_GenerateKeyPair_EncryptionWithEd25519.json"
           }
         }
       }
@@ -480,6 +495,24 @@
         "value"
       ],
       "description": "The list SSH public keys operation response."
+    },
+    "SshGenerateKeyPairInputParameters": {
+      "type": "object",
+      "properties": {
+        "encryptionType": {
+          "type": "string",
+          "description": "The encryption type of the SSH keys to be generated. See SshEncryptionTypes for possible set of values. If not provided, will default to RSA",
+          "enum": [
+            "RSA",
+            "Ed25519"
+          ],
+          "x-ms-enum": {
+            "name": "SshEncryptionTypes",
+            "modelAsString": true
+          }
+        }
+      },
+      "description": "Parameters for GenerateSshKeyPair."
     }
   }
 }