Swagger for Communication Services Resource Manager Preview

specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/examples/createOrUpdate.json

@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "subscriptionId": "12345",
+    "resourceGroupName": "MyResourceGroup",
+    "communicationServiceName": "MyCommunicationResource",
+    "api-version": "2020-08-20-preview",
+    "parameters": {
+      "location": "Global",
+      "properties": {
+        "dataLocation": "United States"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/12345/resourceGroups/MyResourceGroup/providers/Microsoft.Communication/CommunicationServices/MyCommunicationResource",
+        "name": "MyCommunicationResource",
+        "type": "Microsoft.Communication/CommunicationServices",
+        "location": "Global",
+        "properties": {
+          "dataLocation": "United States",
+          "provisioningState": "Succeeded",
+          "hostName": "mycommunicationresource.communications.azure.com"
+        }
+      }
+    },
+    "201": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/providers/Microsoft.Communication/locations/westus/operationStatuses/ed5d502c-acaa-42ec-ad61-0d8488a9fd1d"
+      },
+      "body": {
+        "id": "/subscriptions/12345/resourceGroups/MyResourceGroup/providers/Microsoft.Communication/CommunicationServices/MyCommunicationResource",
+        "name": "MyCommunicationResource",
+        "type": "Microsoft.Communication/CommunicationServices",
+        "location": "Global",
+        "properties": {
+          "dataLocation": "United States",
+          "provisioningState": "Accepted"
+        }
+      }
+    }
+  }
+}

specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/examples/delete.json

@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "subscriptionId": "12345",
+    "resourceGroupName": "MyResourceGroup",
+    "communicationServiceName": "MyCommunicationResource",
+    "api-version": "2020-08-20-preview"
+  },
+  "responses": {
+    "200": {},
+    "202": {
+      "headers": {
+        "Location": "https://management.azure.com/providers/Microsoft.Communication/locations/westus/operationStatuses/ed5d502c-acaa-42ec-ad61-0d8488a9fd1d"
+      }
+    },
+    "204": {}
+  }
+}

specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/examples/get.json

@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "subscriptionId": "12345",
+    "resourceGroupName": "MyResourceGroup",
+    "communicationServiceName": "MyCommunicationResource",
+    "api-version": "2020-08-20-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/12345/resourceGroups/MyResourceGroup/providers/Microsoft.Communication/CommunicationServices/MyCommunicationResource",
+        "name": "MyCommunicationResource",
+        "type": "Microsoft.Communication/CommunicationServices",
+        "location": "Global",
+        "properties": {
+          "dataLocation": "United States",
+          "provisioningState": "Running",
+          "hostName": "mycommunicationservice.comms.azure.net",
+          "version": "0.2.0"
+        }
+      }
+    },
+    "default": {
+      "body": {
+        "error": {
+          "code": "ResourceNotFound",
+          "message": "The requested resource was not found"
+        }
+      }
+    }
+  }
+}

specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/examples/getOperationStatus.json

@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "location": "westus2",
+    "operationId": "db5f291f-284d-46e9-9152-d5c83f7c14b8",
+    "api-version": "2020-08-20-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "db5f291f-284d-46e9-9152-d5c83f7c14b8",
+        "status": "Succeeded",
+        "startTime": "2020-07-06T17:06:26.100Z",
+        "endTime": "2020-07-06T17:06:42.800Z",
+        "percentComplete": 100
+      }
+    },
+    "default": {
+      "body": {
+        "error": {
+          "code": "OperationNotFound",
+          "message": "The requested async operation was not found"
+        }
+      }
+    }
+  }
+}

specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/examples/linkNotificationHub.json

@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "subscriptionId": "12345",
+    "resourceGroupName": "MyResourceGroup",
+    "communicationServiceName": "MyCommunicationResource",
+    "api-version": "2020-08-20-preview",
+    "linkNotificationHubParameters": {
+      "resourceId": "/subscriptions/12345/resourceGroups/MyOtherResourceGroup/providers/Microsoft.NotificationHubs/namespaces/MyNamespace/notificationHubs/MyHub",
+      "connectionString": "Endpoint=sb://MyNamespace.servicebus.windows.net/;SharedAccessKey=abcd1234"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "resourceId": "/subscriptions/12345/resourceGroups/MyOtherResourceGroup/providers/Microsoft.NotificationHubs/namespaces/MyNamespace/notificationHubs/MyHub"
+      }
+    },
+    "default": {
+      "body": {
+        "error": {
+          "code": "WrongSubscription",
+          "message": "The notification hub must be in the same subscription as the communication service"
+        }
+      }
+    }
+  }
+}

specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/examples/listByResourceGroup.json

@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "subscriptionId": "12345",
+    "resourceGroupName": "MyResourceGroup",
+    "api-version": "2020-08-20-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "properties": {
+              "provisioningState": "Running",
+              "dataLocation": "United States",
+              "hostName": "mycommunicationservice.comms.azure.net",
+              "version": "0.2.0"
+            }
+          }
+        ]
+      }
+    }
+  }
+}

specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/examples/listBySubscription.json

@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "subscriptionId": "12345",
+    "api-version": "2020-08-20-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "properties": {
+              "provisioningState": "Running",
+              "dataLocation": "United States",
+              "hostName": "mycommunicationservice.comms.azure.net",
+              "version": "0.2.0"
+            }
+          }
+        ]
+      }
+    }
+  }
+}

specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/examples/listKeys.json

@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "subscriptionId": "12345",
+    "resourceGroupName": "MyResourceGroup",
+    "communicationServiceName": "MyCommunicationResource",
+    "api-version": "2020-08-20-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "primaryKey": "1234",
+        "secondaryKey": "ABCD"
+      }
+    }
+  }
+}

specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/examples/regenerateKey.json

@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "subscriptionId": "12345",
+    "resourceGroupName": "MyResourceGroup",
+    "communicationServiceName": "MyCommunicationResource",
+    "api-version": "2020-08-20-preview",
+    "parameters": {
+      "keyType": "Primary"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "primaryKey": "1234",
+        "primaryConnectionString": "endpoint=http://example.com;accesskey=1234"
+      }
+    },
+    "201": {
+      "body": {}
+    }
+  }
+}

specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/examples/update.json

@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "subscriptionId": "12345",
+    "resourceGroupName": "MyResourceGroup",
+    "communicationServiceName": "MyCommunicationResource",
+    "api-version": "2020-08-20-preview",
+    "parameters": {
+      "tags": {
+        "newTag": "newVal"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/12345/resourceGroups/MyResourceGroup/providers/Microsoft.Communication/CommunicationServices/MyCommunicationResource",
+        "name": "MyCommunicationResource",
+        "type": "Microsoft.Communication/CommunicationServices",
+        "location": "Global",
+        "tags": {
+          "newTag": "newVal"
+        },
+        "properties": {
+          "provisioningState": "Succeeded",
+          "dataLocation": "United States",
+          "hostName": "mycommunicationresource.communications.azure.com",
+          "version": "0.2.0"
+        }
+      }
+    }
+  }
+}

specification/communication/resource-manager/readme.csharp.md

@@ -0,0 +1,15 @@
+## C#
+
+These settings apply only when `--csharp` is specified on the command line.
+Please also specify `--csharp-sdks-folder=<path to "SDKs" directory of your azure-sdk-for-net clone>`.
+
+```yaml $(csharp)
+csharp:
+  azure-arm: true
+  license-header: MICROSOFT_MIT_NO_VERSION
+  payload-flattening-threshold: 1
+  clear-output-folder: true
+  client-side-validation: false
+  namespace: Microsoft.Azure.Management.Communication
+  output-folder: $(csharp-sdks-folder)/communication/Microsoft.Azure.Management.Communication/src/Generated
+```

specification/communication/resource-manager/readme.go.md

@@ -0,0 +1,26 @@
+## Go
+
+These settings apply only when `--go` is specified on the command line.
+
+``` yaml $(go)
+go:
+  license-header: MICROSOFT_APACHE_NO_VERSION
+  namespace: communication
+  clear-output-folder: true
+```
+
+### Go multi-api
+
+``` yaml $(go) && $(multiapi)
+batch:
+  - tag: package-2020-08-20-preview
+```
+
+### Tag: package-2020-08-20-preview and go
+
+These settings apply only when `--tag=package-2020-08-20-preview --go` is specified on the command line.
+Please also specify `--go-sdk-folder=<path to the root directory of your azure-sdk-for-go clone>`.
+
+``` yaml $(tag) == 'package-2020-08-20-preview' && $(go)
+output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2020-08-20-preview/$(namespace)
+```

specification/communication/resource-manager/readme.md

@@ -0,0 +1,70 @@
+# vsonline
+
+> see https://aka.ms/autorest
+
+This is the AutoRest configuration file for Azure Communication Services.
+
+---
+
+## Getting Started
+
+To build the SDKs for Azure Communication Services, simply [Install AutoRest](https://aka.ms/autorest/install) or via `npm` (`npm install -g autorest`) and in this folder run:
+
+> `autorest`
+
+To see additional help and options, run:
+
+> `autorest --help`
+
+---
+
+## Configuration
+
+### Basic Information
+
+These are the global settings for the Azure Communication Services API.
+
+```yaml
+title: CommunicationServiceManagementClient
+openapi-type: arm
+openapi-subtype: rpaas
+tag: package-2020-08-20-preview
+```
+
+### Tag: package-2020-08-20-preview
+
+These settings apply only when `--tag=package-2020-08-20-preview` is specified on the command line.
+
+```yaml $(tag) == 'package-2020-08-20-preview'
+input-file:
+  - Microsoft.Communication/preview/2020-08-20-preview/CommunicationService.json
+```
+
+# Code Generation
+
+## Swagger to SDK
+
+This section describes what SDK should be generated by the automatic system.
+This is not used by Autorest itself.
+
+```yaml $(swagger-to-sdk)
+swagger-to-sdk:
+  - repo: azure-sdk-for-net
+  - repo: azure-sdk-for-python
+  - repo: azure-sdk-for-python-track2
+  - repo: azure-sdk-for-go
+    after_scripts:
+      - bundle install && rake arm:regen_all_profiles['azure_mgmt_vsonline']
+```
+
+## CSharp
+
+See configuration in [readme.csharp.md](./readme.csharp.md)
+
+## Python
+
+See configuration in [readme.python.md](./readme.python.md)
+
+## Go
+
+See configuration in [readme.go.md](./readme.go.md)