Tbyfield/devcenter draft 1

specification/devcenter/resource-manager/Microsoft.DevCenter/stable/2025-02-01/commonDefinitions.json

@@ -0,0 +1,170 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "version": "2025-02-01",
+    "title": "DevCenter",
+    "description": "DevCenter Management API"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {},
+  "definitions": {
+    "Capability": {
+      "description": "A name/value pair to describe a capability.",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Name of the capability.",
+          "type": "string",
+          "readOnly": true
+        },
+        "value": {
+          "description": "Value of the capability.",
+          "type": "string",
+          "readOnly": true
+        }
+      }
+    },
+    "TrackedResourceUpdate": {
+      "description": "Base tracked resource type for PATCH updates",
+      "type": "object",
+      "properties": {
+        "tags": {
+          "$ref": "#/definitions/Tags",
+          "description": "Resource tags."
+        },
+        "location": {
+          "type": "string",
+          "x-ms-mutability": [
+            "read",
+            "create"
+          ],
+          "description": "The geo-location where the resource lives"
+        }
+      }
+    },
+    "Tags": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "x-ms-mutability": [
+        "read",
+        "create",
+        "update"
+      ],
+      "description": "Resource tags."
+    },
+    "DevCenterSku": {
+      "description": "The resource model definition representing SKU for DevCenter resources",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "../../../../../common-types/resource-management/v5/types.json#/definitions/Sku"
+        }
+      ],
+      "properties": {
+        "resourceType": {
+          "type": "string",
+          "description": "The name of the resource type",
+          "readOnly": true
+        },
+        "locations": {
+          "description": "SKU supported locations.",
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "type": "string"
+          }
+        },
+        "capabilities": {
+          "description": "Collection of name/value pairs to describe the SKU capabilities.",
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/Capability"
+          },
+          "x-ms-identifiers": []
+        }
+      },
+      "required": [
+        "name"
+      ]
+    },
+    "ProvisioningState": {
+      "type": "string",
+      "description": "Provisioning state of the resource.",
+      "enum": [
+        "NotSpecified",
+        "Accepted",
+        "Running",
+        "Creating",
+        "Created",
+        "Updating",
+        "Updated",
+        "Deleting",
+        "Deleted",
+        "Succeeded",
+        "Failed",
+        "Canceled",
+        "MovingResources",
+        "TransientFailure",
+        "RolloutInProgress",
+        "StorageProvisioningFailed"
+      ],
+      "readOnly": true,
+      "x-ms-enum": {
+        "name": "ProvisioningState",
+        "modelAsString": true
+      }
+    }
+  },
+  "parameters": {
+    "ProjectNameParameter": {
+      "name": "projectName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the project.",
+      "x-ms-parameter-location": "method",
+      "pattern": "^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$",
+      "minLength": 3,
+      "maxLength": 63
+    },
+    "TopParameter": {
+      "name": "$top",
+      "in": "query",
+      "description": "The maximum number of resources to return from the operation. Example: '$top=10'.",
+      "type": "integer",
+      "format": "int32",
+      "required": false,
+      "x-ms-parameter-location": "method"
+    }
+  }
+}