[Hub Generated] Review request for Microsoft.Security to add version preview/2023-09-01-preview (#24384)

* Adds base for updating Microsoft.Security from version preview/2023-05-01-preview to version 2023-09-01-preview

* Updates readme

* Updates API version in new specs and examples

* Add initial version of SecurityConnecto DevOps swagger specification

* Add examples, fix prettier issues

* Update details in request/response example objects

* Remove ids from AzDO projects/repos in request

* Updating Onboarding State name

* Adding back newline

* Fine tuning examples with onboardingState, adding available inventory examples

* Update OperationIDs. Update common-types to v5. Update Examples.

* Update OperationIDs. Update common-types to v5. Update Examples.

* Resolve linter issues

* try to reduce operationid

* Update operations to fix docs generation

* Update examples

* Update OperationIDs prefix

* Update to new listAvailable endpoints

* Address PR feedback, add ghazdoState property.

* Add "ghazdo" (GitHub Advanced Security for Azure DevOps) to custom words.

* Update 'ghazdo' to 'gitHubAdvancedSecurity'

* Updating with latest API design, bringing more consistency to descriptions, addressing feedback from Microsoft.Security RP.

* Fix Azure DevOps Repositories examples

* Rename Configurations and OperationResults to all SDK build

* Update examples

* Allign examples with MDC

* Fix and suppress linter issues

* use new suppression syntax

* duplicate supressions

* fix typo in description

---------

Co-authored-by: Johnathon Mohr <[email protected]>

Author: ivadim

specification/security/resource-manager/Microsoft.Security/preview/2023-09-01-preview/examples/SecurityConnectorsDevOps/CreateOrUpdateAzureDevOpsOrgs_example.json

@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "subscriptionId": "0806e1cd-cfda-4ff8-b99c-2b0af42cffd3",
+    "resourceGroupName": "myRg",
+    "securityConnectorName": "mySecurityConnectorName",
+    "orgName": "myAzDevOpsOrg",
+    "azureDevOpsOrg": {
+      "properties": {
+        "onboardingState": "NotApplicable",
+        "actionableRemediation": {
+          "state": "Enabled"
+        }
+      }
+    },
+    "api-version": "2023-09-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "properties": {
+          "onboardingState": "Onboarded",
+          "actionableRemediation": {
+            "state": "Enabled"
+          },
+          "provisioningState": "Succeeded"
+        },
+        "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/myAzDevOpsOrg",
+        "name": "myAzDevOpsOrg",
+        "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs"
+      }
+    },
+    "201": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/operationResults/4e826cf1-5c36-4808-a7d2-fb4f5170978b?api-version=2023-09-01-preview"
+      },
+      "body": {
+        "properties": {
+          "onboardingState": "NotApplicable",
+          "actionableRemediation": {
+            "state": "None"
+          },
+          "provisioningState": "Accepted"
+        },
+        "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/myAzDevOpsOrg",
+        "name": "myAzDevOpsOrg",
+        "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs"
+      }
+    }
+  }
+}

specification/security/resource-manager/Microsoft.Security/preview/2023-09-01-preview/examples/SecurityConnectorsDevOps/CreateOrUpdateAzureDevOpsProjects_example.json

@@ -0,0 +1,56 @@
+{
+  "parameters": {
+    "subscriptionId": "0806e1cd-cfda-4ff8-b99c-2b0af42cffd3",
+    "resourceGroupName": "myRg",
+    "securityConnectorName": "mySecurityConnectorName",
+    "orgName": "myAzDevOpsOrg",
+    "projectName": "myAzDevOpsProject",
+    "azureDevOpsProject": {
+      "properties": {
+        "onboardingState": "NotApplicable",
+        "actionableRemediation": {
+          "state": "Enabled"
+        }
+      }
+    },
+    "api-version": "2023-09-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "properties": {
+          "parentOrgName": "myAzDevOpsOrg",
+          "projectId": "9ebbed8f-a9cc-405f-a647-b235e22179de",
+          "onboardingState": "Onboarded",
+          "actionableRemediation": {
+            "state": "Enabled"
+          },
+          "provisioningState": "Succeeded"
+        },
+        "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/myAzDevOpsOrg/projects/myAzDevOpsProject",
+        "name": "myAzDevOpsProject",
+        "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs/projects"
+      }
+    },
+    "201": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/operationResults/4e826cf1-5c36-4808-a7d2-fb4f5170978b?api-version=2023-09-01-preview"
+      },
+      "body": {
+        "properties": {
+          "parentOrgName": "myAzDevOpsOrg",
+          "projectId": "9ebbed8f-a9cc-405f-a647-b235e22179de",
+          "onboardingState": "NotApplicable",
+          "actionableRemediation": {
+            "state": "None"
+          },
+          "provisioningState": "Accepted"
+        },
+        "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/myAzDevOpsOrg/projects/myAzDevOpsProject",
+        "name": "myAzDevOpsProject",
+        "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs/projects"
+      }
+    }
+  }
+}

specification/security/resource-manager/Microsoft.Security/preview/2023-09-01-preview/examples/SecurityConnectorsDevOps/CreateOrUpdateAzureDevOpsRepos_example.json

@@ -0,0 +1,59 @@
+{
+  "parameters": {
+    "subscriptionId": "0806e1cd-cfda-4ff8-b99c-2b0af42cffd3",
+    "resourceGroupName": "myRg",
+    "securityConnectorName": "mySecurityConnectorName",
+    "orgName": "myAzDevOpsOrg",
+    "projectName": "myAzDevOpsProject",
+    "repoName": "myAzDevOpsRepo",
+    "azureDevOpsRepository": {
+      "properties": {
+        "onboardingState": "NotApplicable",
+        "actionableRemediation": {
+          "state": "Enabled"
+        }
+      }
+    },
+    "api-version": "2023-09-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "properties": {
+          "parentOrgName": "myAzDevOpsOrg",
+          "parentProjectName": "myAzDevOpsProject",
+          "repoId": "cb64ab91-c9ba-46df-b44c-c769358bccdf",
+          "onboardingState": "Onboarded",
+          "actionableRemediation": {
+            "state": "Enabled"
+          },
+          "provisioningState": "Succeeded"
+        },
+        "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/myAzDevOpsOrg/projects/myAzDevOpsProject/repos/myAzDevOpsRepo",
+        "name": "myAzDevOpsRepo",
+        "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs/projects/repos"
+      }
+    },
+    "201": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/operationResults/4e826cf1-5c36-4808-a7d2-fb4f5170978b?api-version=2023-09-01-preview"
+      },
+      "body": {
+        "properties": {
+          "parentOrgName": "myAzDevOpsOrg",
+          "parentProjectName": "myAzDevOpsProject",
+          "repoId": "cb64ab91-c9ba-46df-b44c-c769358bccdf",
+          "onboardingState": "NotApplicable",
+          "actionableRemediation": {
+            "state": "None"
+          },
+          "provisioningState": "Accepted"
+        },
+        "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/myAzDevOpsOrg/projects/myAzDevOpsProject/repos/myAzDevOpsRepo",
+        "name": "myAzDevOpsRepo",
+        "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs/projects/repos"
+      }
+    }
+  }
+}

specification/security/resource-manager/Microsoft.Security/preview/2023-09-01-preview/examples/SecurityConnectorsDevOps/CreateOrUpdateDevOpsConfigurationsOnboardCurrentAndFuture_example.json

@@ -0,0 +1,56 @@
+{
+  "parameters": {
+    "subscriptionId": "0806e1cd-cfda-4ff8-b99c-2b0af42cffd3",
+    "resourceGroupName": "myRg",
+    "securityConnectorName": "mySecurityConnectorName",
+    "devOpsConfiguration": {
+      "properties": {
+        "authorization": {
+          "code": "00000000000000000000"
+        },
+        "autoDiscovery": "Enabled"
+      }
+    },
+    "api-version": "2023-09-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "properties": {
+          "autoDiscovery": "Enabled",
+          "provisioningState": "Succeeded"
+        },
+        "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
+        "name": "default",
+        "type": "Microsoft.Security/securityConnectors/devops"
+      }
+    },
+    "201": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/operationResults/4e826cf1-5c36-4808-a7d2-fb4f5170978b?api-version=2023-09-01-preview"
+      },
+      "body": {
+        "properties": {
+          "provisioningState": "Accepted"
+        },
+        "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
+        "name": "default",
+        "type": "Microsoft.Security/securityConnectors/devops"
+      }
+    },
+    "202": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/operationResults/4e826cf1-5c36-4808-a7d2-fb4f5170978b?api-version=2023-09-01-preview"
+      },
+      "body": {
+        "properties": {
+          "provisioningState": "Accepted"
+        },
+        "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
+        "name": "default",
+        "type": "Microsoft.Security/securityConnectors/devops"
+      }
+    }
+  }
+}

specification/security/resource-manager/Microsoft.Security/preview/2023-09-01-preview/examples/SecurityConnectorsDevOps/CreateOrUpdateDevOpsConfigurationsOnboardCurrentOnly_example.json

@@ -0,0 +1,56 @@
+{
+  "parameters": {
+    "subscriptionId": "0806e1cd-cfda-4ff8-b99c-2b0af42cffd3",
+    "resourceGroupName": "myRg",
+    "securityConnectorName": "mySecurityConnectorName",
+    "devOpsConfiguration": {
+      "properties": {
+        "authorization": {
+          "code": "00000000000000000000"
+        },
+        "autoDiscovery": "Disabled"
+      }
+    },
+    "api-version": "2023-09-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "properties": {
+          "autoDiscovery": "Disabled",
+          "provisioningState": "Succeeded"
+        },
+        "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
+        "name": "default",
+        "type": "Microsoft.Security/securityConnectors/devops"
+      }
+    },
+    "201": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/operationResults/4e826cf1-5c36-4808-a7d2-fb4f5170978b?api-version=2023-09-01-preview"
+      },
+      "body": {
+        "properties": {
+          "provisioningState": "Accepted"
+        },
+        "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
+        "name": "default",
+        "type": "Microsoft.Security/securityConnectors/devops"
+      }
+    },
+    "202": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/operationResults/4e826cf1-5c36-4808-a7d2-fb4f5170978b?api-version=2023-09-01-preview"
+      },
+      "body": {
+        "properties": {
+          "provisioningState": "Accepted"
+        },
+        "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
+        "name": "default",
+        "type": "Microsoft.Security/securityConnectors/devops"
+      }
+    }
+  }
+}

specification/security/resource-manager/Microsoft.Security/preview/2023-09-01-preview/examples/SecurityConnectorsDevOps/CreateOrUpdateDevOpsConfigurationsOnboardSelected_example.json

@@ -0,0 +1,64 @@
+{
+  "parameters": {
+    "subscriptionId": "0806e1cd-cfda-4ff8-b99c-2b0af42cffd3",
+    "resourceGroupName": "myRg",
+    "securityConnectorName": "mySecurityConnectorName",
+    "devOpsConfiguration": {
+      "properties": {
+        "authorization": {
+          "code": "00000000000000000000"
+        },
+        "autoDiscovery": "Disabled",
+        "topLevelInventoryList": [
+          "org1",
+          "org2"
+        ]
+      }
+    },
+    "api-version": "2023-09-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "properties": {
+          "autoDiscovery": "Disabled",
+          "topLevelInventoryList": [
+            "org1",
+            "org2"
+          ],
+          "provisioningState": "Succeeded"
+        },
+        "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
+        "name": "default",
+        "type": "Microsoft.Security/securityConnectors/devops"
+      }
+    },
+    "201": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/operationResults/4e826cf1-5c36-4808-a7d2-fb4f5170978b?api-version=2023-09-01-preview"
+      },
+      "body": {
+        "properties": {
+          "provisioningState": "Accepted"
+        },
+        "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
+        "name": "default",
+        "type": "Microsoft.Security/securityConnectors/devops"
+      }
+    },
+    "202": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/operationResults/4e826cf1-5c36-4808-a7d2-fb4f5170978b?api-version=2023-09-01-preview"
+      },
+      "body": {
+        "properties": {
+          "provisioningState": "Accepted"
+        },
+        "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
+        "name": "default",
+        "type": "Microsoft.Security/securityConnectors/devops"
+      }
+    }
+  }
+}

specification/security/resource-manager/Microsoft.Security/preview/2023-09-01-preview/examples/SecurityConnectorsDevOps/DeleteDevOpsConfigurations_example.json

@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "subscriptionId": "0806e1cd-cfda-4ff8-b99c-2b0af42cffd3",
+    "resourceGroupName": "myRg",
+    "securityConnectorName": "mySecurityConnectorName",
+    "api-version": "2023-09-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {}
+    },
+    "202": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/operationResults/4e826cf1-5c36-4808-a7d2-fb4f5170978b?api-version=2023-09-01-preview"
+      }
+    },
+    "204": {
+      "headers": {}
+    }
+  }
+}

specification/security/resource-manager/Microsoft.Security/preview/2023-09-01-preview/examples/SecurityConnectorsDevOps/GetAzureDevOpsOrgs_example.json

@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "subscriptionId": "0806e1cd-cfda-4ff8-b99c-2b0af42cffd3",
+    "resourceGroupName": "myRg",
+    "securityConnectorName": "mySecurityConnectorName",
+    "orgName": "myAzDevOpsOrg",
+    "api-version": "2023-09-01-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "properties": {
+          "onboardingState": "Onboarded",
+          "actionableRemediation": {
+            "state": "Enabled"
+          },
+          "provisioningState": "Succeeded"
+        },
+        "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/myAzDevOpsOrg",
+        "name": "myAzDevOpsOrg",
+        "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs"
+      }
+    }
+  }
+}