From c07bbbfa255783c51c36409c260c0b32e9f2a9bb Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Fri, 31 Jul 2020 13:31:52 -0700 Subject: [PATCH 01/28] Adds base for updating Microsoft.DigitalTwins from version preview/2020-03-01-preview to version 2020-10-31 --- .../stable/2020-10-31/digitaltwins.json | 1144 +++++++++++++++++ ...talTwinsCheckNameAvailability_example.json | 21 + .../examples/DigitalTwinsDelete_example.json | 26 + .../DigitalTwinsEndpointDelete_example.json | 27 + .../DigitalTwinsEndpointGet_example.json | 25 + .../DigitalTwinsEndpointPut_example.json | 45 + .../DigitalTwinsEndpointsGet_example.json | 40 + .../examples/DigitalTwinsGet_example.json | 24 + ...gitalTwinsListByResourceGroup_example.json | 38 + .../examples/DigitalTwinsList_example.json | 37 + .../DigitalTwinsOperationsList_example.json | 50 + .../examples/DigitalTwinsPatch_example.json | 33 + .../examples/DigitalTwinsPut_example.json | 41 + 13 files changed, 1551 insertions(+) create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsCheckNameAvailability_example.json create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsDelete_example.json create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointDelete_example.json create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointGet_example.json create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointPut_example.json create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsGet_example.json create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsListByResourceGroup_example.json create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsList_example.json create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsOperationsList_example.json create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPatch_example.json create mode 100644 specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPut_example.json diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json new file mode 100644 index 000000000000..ad2e784412c5 --- /dev/null +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -0,0 +1,1144 @@ +{ + "swagger": "2.0", + "info": { + "version": "2020-03-01-preview", + "title": "AzureDigitalTwinsManagementClient", + "description": "Azure Digital Twins Client for managing DigitalTwinsInstance" + }, + "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": { + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}": { + "get": { + "tags": [ + "DigitalTwinsInstance" + ], + "description": "Get DigitalTwinsInstances resource.", + "operationId": "DigitalTwins_Get", + "x-ms-examples": { + "Get a DigitalTwinsInstance resource": { + "$ref": "./examples/DigitalTwinsGet_example.json" + } + }, + "parameters": [ + { + "$ref": "#/parameters/api-version" + }, + { + "$ref": "#/parameters/subscriptionId" + }, + { + "$ref": "#/parameters/resourceGroupName" + }, + { + "$ref": "#/parameters/resourceName" + } + ], + "responses": { + "200": { + "description": "The body contains all the non-security properties of the DigitalTwinsInstance. Security-related properties are set to null.", + "schema": { + "$ref": "#/definitions/DigitalTwinsDescription" + } + }, + "default": { + "description": "Error response describing why the operation failed.", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + } + }, + "put": { + "tags": [ + "DigitalTwinsInstance" + ], + "description": "Create or update the metadata of a DigitalTwinsInstance. The usual pattern to modify a property is to retrieve the DigitalTwinsInstance and security metadata, and then combine them with the modified values in a new body to update the DigitalTwinsInstance.", + "operationId": "DigitalTwins_CreateOrUpdate", + "x-ms-long-running-operation": true, + "x-ms-examples": { + "Put a DigitalTwinsInstance resource": { + "$ref": "./examples/DigitalTwinsPut_example.json" + } + }, + "parameters": [ + { + "$ref": "#/parameters/api-version" + }, + { + "$ref": "#/parameters/subscriptionId" + }, + { + "$ref": "#/parameters/resourceGroupName" + }, + { + "$ref": "#/parameters/resourceName" + }, + { + "name": "digitalTwinsCreate", + "in": "body", + "description": "The DigitalTwinsInstance and security metadata.", + "required": true, + "schema": { + "$ref": "#/definitions/DigitalTwinsDescription" + } + } + ], + "responses": { + "200": { + "description": "This is returned as a response to the status polling request for the create or update operation. The body contains the resource representation that indicates a transitional provisioning state.", + "schema": { + "$ref": "#/definitions/DigitalTwinsDescription" + } + }, + "201": { + "description": "Created - Put request accepted; the operation will complete asynchronously.", + "schema": { + "$ref": "#/definitions/DigitalTwinsDescription" + } + }, + "default": { + "description": "Error response describing why the operation failed.", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + } + }, + "patch": { + "tags": [ + "DigitalTwinsInstance" + ], + "description": "Update metadata of DigitalTwinsInstance.", + "operationId": "DigitalTwins_Update", + "x-ms-long-running-operation": true, + "x-ms-examples": { + "Patch a DigitalTwinsInstance resource": { + "$ref": "./examples/DigitalTwinsPatch_example.json" + } + }, + "parameters": [ + { + "$ref": "#/parameters/api-version" + }, + { + "$ref": "#/parameters/subscriptionId" + }, + { + "$ref": "#/parameters/resourceGroupName" + }, + { + "$ref": "#/parameters/resourceName" + }, + { + "name": "digitalTwinsPatchDescription", + "in": "body", + "description": "The DigitalTwinsInstance and security metadata.", + "required": true, + "schema": { + "$ref": "#/definitions/DigitalTwinsPatchDescription" + } + } + ], + "responses": { + "200": { + "description": "This is returned as a response to the status polling request for the create or update operation. The body contains the resource representation that indicates a transitional provisioning state.", + "schema": { + "$ref": "#/definitions/DigitalTwinsDescription" + } + }, + "201": { + "description": "Accepted - Put request accepted; the operation will complete asynchronously." + }, + "default": { + "description": "Error response describing why the operation failed.", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + } + }, + "delete": { + "tags": [ + "DigitalTwinsInstance" + ], + "description": "Delete a DigitalTwinsInstance.", + "operationId": "DigitalTwins_Delete", + "x-ms-long-running-operation": true, + "x-ms-examples": { + "Delete a DigitalTwinsInstance resource": { + "$ref": "./examples/DigitalTwinsDelete_example.json" + } + }, + "parameters": [ + { + "$ref": "#/parameters/api-version" + }, + { + "$ref": "#/parameters/subscriptionId" + }, + { + "$ref": "#/parameters/resourceGroupName" + }, + { + "$ref": "#/parameters/resourceName" + } + ], + "responses": { + "200": { + "description": "This is returned as a response to the status polling request for the delete operation. The body contains the resource representation that indicates a transitional provisioning state." + }, + "202": { + "description": "Accepted - Delete request accepted; the operation will complete asynchronously.", + "schema": { + "$ref": "#/definitions/DigitalTwinsDescription" + } + }, + "204": { + "description": "Once the long running delete operation completes successfully, a 204 No Content status code is returned when the status polling request finds the DigitalTwins service metadata in the service and the status of the delete operation is set to a completed state." + }, + "default": { + "description": "Error response describing why the operation failed.", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints": { + "get": { + "tags": [ + "Endpoints" + ], + "description": "Get DigitalTwinsInstance Endpoints.", + "operationId": "DigitalTwinsEndpoint_List", + "x-ms-examples": { + "Get a DigitalTwinsInstance endpoints": { + "$ref": "./examples/DigitalTwinsEndpointsGet_example.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + }, + "parameters": [ + { + "$ref": "#/parameters/api-version" + }, + { + "$ref": "#/parameters/subscriptionId" + }, + { + "$ref": "#/parameters/resourceGroupName" + }, + { + "$ref": "#/parameters/resourceName" + } + ], + "responses": { + "200": { + "description": "The body contains all the non-security properties of the DigitalTwinsInstance. Security-related properties are set to null.", + "schema": { + "$ref": "#/definitions/DigitalTwinsEndpointResourceListResult" + } + }, + "default": { + "description": "Error response describing why the operation failed.", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints/{endpointName}": { + "get": { + "tags": [ + "Endpoints" + ], + "description": "Get DigitalTwinsInstances Endpoint.", + "operationId": "DigitalTwinsEndpoint_Get", + "x-ms-examples": { + "Get a DigitalTwinsInstance endpoint": { + "$ref": "./examples/DigitalTwinsEndpointGet_example.json" + } + }, + "parameters": [ + { + "$ref": "#/parameters/api-version" + }, + { + "$ref": "#/parameters/subscriptionId" + }, + { + "$ref": "#/parameters/resourceGroupName" + }, + { + "$ref": "#/parameters/resourceName" + }, + { + "$ref": "#/parameters/endpointName" + } + ], + "responses": { + "200": { + "description": "The body contains all the non-security properties of the DigitalTwinsInstance. Security-related properties are set to null.", + "schema": { + "$ref": "#/definitions/DigitalTwinsEndpointResource" + } + }, + "default": { + "description": "Default error response", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + } + }, + "put": { + "tags": [ + "Endpoints" + ], + "description": "Create or update DigitalTwinsInstance endpoint.", + "operationId": "DigitalTwinsEndpoint_CreateOrUpdate", + "x-ms-long-running-operation": true, + "x-ms-examples": { + "Put a DigitalTwinsInstance resource": { + "$ref": "./examples/DigitalTwinsEndpointPut_example.json" + } + }, + "parameters": [ + { + "$ref": "#/parameters/api-version" + }, + { + "$ref": "#/parameters/subscriptionId" + }, + { + "$ref": "#/parameters/resourceGroupName" + }, + { + "$ref": "#/parameters/resourceName" + }, + { + "$ref": "#/parameters/endpointName" + }, + { + "name": "endpointDescription", + "in": "body", + "description": "The DigitalTwinsInstance endpoint metadata and security metadata.", + "required": true, + "schema": { + "$ref": "#/definitions/DigitalTwinsEndpointResource" + } + } + ], + "responses": { + "200": { + "description": "This is returned as a response to the status polling request for the create or update operation. The body contains the resource representation that indicates a transitional provisioning state.", + "schema": { + "$ref": "#/definitions/DigitalTwinsEndpointResource" + } + }, + "201": { + "description": "Created - Put request accepted; the operation will complete asynchronously.", + "schema": { + "$ref": "#/definitions/DigitalTwinsEndpointResource" + } + }, + "default": { + "description": "Error response describing why the operation failed.", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + } + }, + "delete": { + "tags": [ + "Endpoints" + ], + "description": "Delete a DigitalTwinsInstance endpoint.", + "operationId": "DigitalTwinsEndpoint_Delete", + "x-ms-long-running-operation": true, + "x-ms-examples": { + "Delete a DigitalTwinsInstance endpoint": { + "$ref": "./examples/DigitalTwinsEndpointDelete_example.json" + } + }, + "parameters": [ + { + "$ref": "#/parameters/api-version" + }, + { + "$ref": "#/parameters/subscriptionId" + }, + { + "$ref": "#/parameters/resourceGroupName" + }, + { + "$ref": "#/parameters/resourceName" + }, + { + "$ref": "#/parameters/endpointName" + } + ], + "responses": { + "200": { + "description": "This is returned as a response to the status polling request for the delete operation. The body contains the resource representation that indicates a transitional provisioning state." + }, + "202": { + "description": "Accepted - Delete request accepted; the operation will complete asynchronously.", + "schema": { + "$ref": "#/definitions/DigitalTwinsEndpointResource" + } + }, + "204": { + "description": "Once the long running delete operation completes successfully, a 204 No Content status code is returned when the status polling request finds the DigitalTwins service metadata in the service and the status of the delete operation is set to a completed state." + }, + "default": { + "description": "Error response describing why the operation failed.", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + } + } + }, + "/subscriptions/{subscriptionId}/providers/Microsoft.DigitalTwins/digitalTwinsInstances": { + "get": { + "tags": [ + "DigitalTwinsInstance" + ], + "description": "Get all the DigitalTwinsInstances in a subscription.", + "operationId": "DigitalTwins_List", + "x-ms-examples": { + "Get DigitalTwinsInstance resources by subscription": { + "$ref": "./examples/DigitalTwinsList_example.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + }, + "parameters": [ + { + "$ref": "#/parameters/api-version" + }, + { + "$ref": "#/parameters/subscriptionId" + } + ], + "responses": { + "200": { + "description": "This is a synchronous operation. The body contains a JSON-serialized array of the metadata from all the DigitalTwinsInstances in the subscription.", + "schema": { + "$ref": "#/definitions/DigitalTwinsDescriptionListResult" + } + }, + "default": { + "description": "Error response describing why the operation failed.", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances": { + "get": { + "tags": [ + "DigitalTwinsInstance" + ], + "description": "Get all the DigitalTwinsInstances in a resource group.", + "operationId": "DigitalTwins_ListByResourceGroup", + "x-ms-examples": { + "Get DigitalTwinsInstance resources by resource group": { + "$ref": "./examples/DigitalTwinsListByResourceGroup_example.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + }, + "parameters": [ + { + "$ref": "#/parameters/api-version" + }, + { + "$ref": "#/parameters/subscriptionId" + }, + { + "$ref": "#/parameters/resourceGroupName" + } + ], + "responses": { + "200": { + "description": "This is a synchronous operation. The body contains a JSON-serialized array of the metadata from all the DigitalTwinsInstances in the resource group.", + "schema": { + "$ref": "#/definitions/DigitalTwinsDescriptionListResult" + } + }, + "default": { + "description": "Error response describing why the operation failed.", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + } + } + }, + "/providers/Microsoft.DigitalTwins/operations": { + "get": { + "tags": [ + "Operations" + ], + "description": "Lists all of the available DigitalTwins service REST API operations.", + "operationId": "Operations_List", + "x-ms-examples": { + "Get available operations": { + "$ref": "./examples/DigitalTwinsOperationsList_example.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + }, + "parameters": [ + { + "$ref": "#/parameters/api-version" + } + ], + "responses": { + "200": { + "description": "OK. The request has succeeded.", + "schema": { + "$ref": "#/definitions/OperationListResult" + } + }, + "default": { + "description": "Error response describing why the operation failed.", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + } + } + }, + "/subscriptions/{subscriptionId}/providers/Microsoft.DigitalTwins/locations/{location}/checkNameAvailability": { + "post": { + "tags": [ + "CheckNameAvailability" + ], + "description": "Check if a DigitalTwinsInstance name is available.", + "operationId": "DigitalTwins_CheckNameAvailability", + "x-ms-examples": { + "Check name Availability": { + "$ref": "./examples/DigitalTwinsCheckNameAvailability_example.json" + } + }, + "parameters": [ + { + "$ref": "#/parameters/api-version" + }, + { + "$ref": "#/parameters/subscriptionId" + }, + { + "$ref": "#/parameters/location" + }, + { + "name": "digitalTwinsInstanceCheckName", + "in": "body", + "description": "Set the name parameter in the DigitalTwinsInstanceCheckName structure to the name of the DigitalTwinsInstance to check.", + "required": true, + "schema": { + "$ref": "#/definitions/CheckNameRequest" + } + } + ], + "responses": { + "200": { + "description": "This is a synchronous operation. The body contains a JSON-serialized response that specifies whether the DigitalTwins service name is available. If the name is not available, the body contains the reason.", + "schema": { + "$ref": "#/definitions/CheckNameResult" + } + }, + "default": { + "description": "Error response describing why the operation failed.", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + } + } + } + }, + "definitions": { + "DigitalTwinsProperties": { + "description": "The properties of a DigitalTwinsInstance.", + "type": "object", + "properties": { + "createdTime": { + "description": "Time when DigitalTwinsInstance was created.", + "readOnly": true, + "type": "string", + "format": "date-time" + }, + "lastUpdatedTime": { + "description": "Time when DigitalTwinsInstance was created.", + "readOnly": true, + "type": "string", + "format": "date-time" + }, + "provisioningState": { + "description": "The provisioning state.", + "enum": [ + "Provisioning", + "Deleting", + "Succeeded", + "Failed", + "Canceled" + ], + "type": "string", + "readOnly": true, + "x-ms-enum": { + "name": "provisioningState", + "modelAsString": true + } + }, + "hostName": { + "description": "Api endpoint to work with DigitalTwinsInstance.", + "type": "string", + "readOnly": true + } + } + }, + "DigitalTwinsSkuInfo": { + "description": "Information about the SKU of the DigitalTwinsInstance.", + "type": "object", + "properties": { + "name": { + "description": "The name of the SKU.", + "enum": [ + "F1" + ], + "type": "string", + "x-ms-enum": { + "name": "DigitalTwinsSku", + "modelAsString": true + } + } + }, + "required": [ + "name" + ] + }, + "DigitalTwinsDescription": { + "description": "The description of the DigitalTwins service.", + "type": "object", + "properties": { + "properties": { + "x-ms-client-flatten": true, + "description": "DigitalTwins instance properties.", + "$ref": "#/definitions/DigitalTwinsProperties" + } + }, + "allOf": [ + { + "$ref": "#/definitions/DigitalTwinsResource" + } + ] + }, + "DigitalTwinsPatchDescription": { + "description": "The description of the DigitalTwins service.", + "type": "object", + "properties": { + "tags": { + "description": "Instance tags", + "type": "object", + "additionalProperties": { + "type": "string" + } + } + } + }, + "DigitalTwinsResource": { + "description": "The common properties of a DigitalTwinsInstance.", + "properties": { + "id": { + "readOnly": true, + "type": "string", + "description": "The resource identifier." + }, + "name": { + "readOnly": true, + "type": "string", + "description": "The resource name.", + "pattern": "^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$" + }, + "type": { + "readOnly": true, + "type": "string", + "description": "The resource type." + }, + "location": { + "type": "string", + "description": "The resource location.", + "x-ms-mutability": [ + "create", + "read" + ] + }, + "tags": { + "type": "object", + "additionalProperties": { + "type": "string" + }, + "description": "The resource tags." + }, + "sku": { + "description": "This property is reserved for future use, and will be ignored/omitted", + "$ref": "#/definitions/DigitalTwinsSkuInfo" + } + }, + "x-ms-azure-resource": true, + "required": [ + "location" + ] + }, + "ErrorResponse": { + "description": "Error response.", + "properties": { + "error": { + "description": "Error description", + "$ref": "#/definitions/ErrorDefinition" + } + } + }, + "ErrorDefinition": { + "description": "Error definition.", + "properties": { + "code": { + "description": "Service specific error code which serves as the substatus for the HTTP error code.", + "type": "string", + "readOnly": true + }, + "message": { + "description": "Description of the error.", + "type": "string", + "readOnly": true + }, + "details": { + "description": "Internal error details.", + "type": "array", + "items": { + "$ref": "#/definitions/ErrorDefinition" + }, + "readOnly": true + } + } + }, + "DigitalTwinsDescriptionListResult": { + "description": "A list of DigitalTwins description objects with a next link.", + "type": "object", + "properties": { + "nextLink": { + "description": "The link used to get the next page of DigitalTwins description objects.", + "type": "string" + }, + "value": { + "description": "A list of DigitalTwins description objects.", + "type": "array", + "items": { + "$ref": "#/definitions/DigitalTwinsDescription" + } + } + } + }, + "OperationListResult": { + "description": "A list of DigitalTwins service operations. It contains a list of operations and a URL link to get the next set of results.", + "type": "object", + "properties": { + "nextLink": { + "description": "The link used to get the next page of DigitalTwins description objects.", + "type": "string" + }, + "value": { + "description": "A list of DigitalTwins operations supported by the Microsoft.DigitalTwins resource provider.", + "type": "array", + "readOnly": true, + "items": { + "$ref": "#/definitions/Operation" + } + } + } + }, + "Operation": { + "description": "DigitalTwins service REST API operation", + "type": "object", + "properties": { + "name": { + "readOnly": true, + "type": "string", + "description": "Operation name: {provider}/{resource}/{read | write | action | delete}" + }, + "display": { + "description": "Operation properties display", + "$ref": "#/definitions/OperationDisplay" + } + } + }, + "OperationDisplay": { + "description": "The object that represents the operation.", + "type": "object", + "properties": { + "provider": { + "readOnly": true, + "type": "string", + "description": "Service provider: Microsoft DigitalTwins" + }, + "resource": { + "readOnly": true, + "type": "string", + "description": "Resource Type: DigitalTwinsInstances" + }, + "operation": { + "readOnly": true, + "type": "string", + "description": "Name of the operation" + }, + "description": { + "readOnly": true, + "type": "string", + "description": "Friendly description for the operation," + } + } + }, + "CheckNameRequest": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "Resource name." + }, + "type": { + "type": "string", + "enum": [ + "Microsoft.DigitalTwins/digitalTwinsInstances" + ], + "x-ms-enum": { + "name": "Type", + "modelAsString": false + }, + "description": "The type of resource, for instance Microsoft.DigitalTwins/digitalTwinsInstances." + } + }, + "required": [ + "name", + "type" + ], + "description": "The result returned from a database check name availability request." + }, + "CheckNameResult": { + "type": "object", + "properties": { + "nameAvailable": { + "type": "boolean", + "description": "Specifies a Boolean value that indicates if the name is available." + }, + "name": { + "type": "string", + "description": "The name that was checked." + }, + "message": { + "type": "string", + "description": "Message indicating an unavailable name due to a conflict, or a description of the naming rules that are violated." + }, + "reason": { + "type": "string", + "enum": [ + "Invalid", + "AlreadyExists" + ], + "x-ms-enum": { + "name": "reason", + "modelAsString": true + }, + "description": "Message providing the reason why the given name is invalid." + } + }, + "description": "The result returned from a check name availability request." + }, + "ExternalResource": { + "description": "Definition of a Resource.", + "type": "object", + "properties": { + "id": { + "readOnly": true, + "type": "string", + "description": "The resource identifier." + }, + "name": { + "readOnly": true, + "type": "string", + "description": "Extension resource name.", + "pattern": "^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$" + }, + "type": { + "readOnly": true, + "type": "string", + "description": "The resource type." + } + } + }, + "DigitalTwinsEndpointResource": { + "description": "DigitalTwinsInstance endpoint resource.", + "x-ms-azure-resource": true, + "allOf": [ + { + "$ref": "#/definitions/ExternalResource" + } + ], + "properties": { + "properties": { + "description": "DigitalTwinsInstance endpoint resource properties.", + "$ref": "#/definitions/DigitalTwinsEndpointResourceProperties" + } + } + }, + "DigitalTwinsEndpointResourceProperties": { + "description": "Properties related to Digital Twins Endpoint", + "discriminator": "endpointType", + "required": [ + "endpointType" + ], + "properties": { + "endpointType": { + "description": "The type of Digital Twins endpoint", + "enum": [ + "EventHub", + "EventGrid", + "ServiceBus" + ], + "x-ms-enum": { + "name": "endpointType", + "modelAsString": true + }, + "type": "string" + }, + "provisioningState": { + "description": "The provisioning state.", + "enum": [ + "Provisioning", + "Deleting", + "Succeeded", + "Failed", + "Canceled" + ], + "type": "string", + "readOnly": true, + "x-ms-enum": { + "name": "EndpointProvisioningState", + "modelAsString": true + } + }, + "createdTime": { + "description": "Time when the Endpoint was added to DigitalTwinsInstance.", + "type": "string", + "format": "date-time", + "readOnly": true + }, + "tags": { + "type": "object", + "additionalProperties": { + "type": "string" + }, + "description": "The resource tags." + } + } + }, + "ServiceBus": { + "description": "properties related to servicebus.", + "required": [ + "primaryConnectionString", + "secondaryConnectionString" + ], + "x-ms-discriminator-value": "ServiceBus", + "allOf": [ + { + "$ref": "#/definitions/DigitalTwinsEndpointResourceProperties" + }, + { + "type": "object", + "properties": { + "primaryConnectionString": { + "description": "PrimaryConnectionString of the endpoint. Will be obfuscated during read", + "type": "string" + }, + "secondaryConnectionString": { + "description": "SecondaryConnectionString of the endpoint. Will be obfuscated during read", + "type": "string" + } + } + } + ] + }, + "EventHub": { + "description": "properties related to eventhub.", + "required": [ + "connectionString-PrimaryKey", + "connectionString-SecondaryKey" + ], + "x-ms-discriminator-value": "EventHub", + "allOf": [ + { + "type": "object", + "properties": { + "connectionString-PrimaryKey": { + "description": "PrimaryConnectionString of the endpoint. Will be obfuscated during read", + "type": "string" + }, + "connectionString-SecondaryKey": { + "description": "SecondaryConnectionString of the endpoint. Will be obfuscated during read", + "type": "string" + } + } + }, + { + "$ref": "#/definitions/DigitalTwinsEndpointResourceProperties" + } + ] + }, + "EventGrid": { + "description": "properties related to eventgrid.", + "required": [ + "accessKey1", + "accessKey2" + ], + "x-ms-discriminator-value": "EventGrid", + "allOf": [ + { + "$ref": "#/definitions/DigitalTwinsEndpointResourceProperties" + }, + { + "type": "object", + "properties": { + "TopicEndpoint": { + "description": "EventGrid Topic Endpoint", + "type": "string" + }, + "accessKey1": { + "description": "EventGrid secondary accesskey. Will be obfuscated during read", + "type": "string" + }, + "accessKey2": { + "description": "EventGrid secondary accesskey. Will be obfuscated during read", + "type": "string" + } + } + } + ] + }, + "DigitalTwinsEndpointResourceListResult": { + "description": "A list of DigitalTwinsInstance Endpoints with a next link.", + "type": "object", + "properties": { + "nextLink": { + "description": "The link used to get the next page of DigitalTwinsInstance Endpoints.", + "type": "string" + }, + "value": { + "description": "A list of DigitalTwinsInstance Endpoints.", + "type": "array", + "items": { + "$ref": "#/definitions/DigitalTwinsEndpointResource" + } + } + } + } + }, + "parameters": { + "subscriptionId": { + "name": "subscriptionId", + "in": "path", + "description": "The subscription identifier.", + "required": true, + "type": "string" + }, + "api-version": { + "name": "api-version", + "enum": [ + "2020-03-01-preview" + ], + "in": "query", + "description": "Version of the DigitalTwinsInstance Management API.", + "required": true, + "type": "string", + "minLength": 10 + }, + "resourceGroupName": { + "name": "resourceGroupName", + "in": "path", + "description": "The name of the resource group that contains the DigitalTwinsInstance.", + "required": true, + "type": "string", + "x-ms-parameter-location": "method", + "minLength": 1, + "maxLength": 64 + }, + "resourceName": { + "name": "resourceName", + "in": "path", + "description": "The name of the DigitalTwinsInstance.", + "required": true, + "type": "string", + "x-ms-parameter-location": "method", + "minLength": 1, + "maxLength": 64 + }, + "location": { + "name": "location", + "in": "path", + "description": "Location of DigitalTwinsInstance.", + "x-ms-parameter-location": "method", + "required": true, + "type": "string", + "minLength": 3 + }, + "endpointName": { + "name": "endpointName", + "in": "path", + "description": "Name of Endpoint Resource.", + "required": true, + "type": "string", + "x-ms-parameter-location": "method", + "pattern": "^[A-Za-z0-9-._]{1,64}$", + "minLength": 1, + "maxLength": 64 + } + } +} diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsCheckNameAvailability_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsCheckNameAvailability_example.json new file mode 100644 index 000000000000..57e83ec4c7c3 --- /dev/null +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsCheckNameAvailability_example.json @@ -0,0 +1,21 @@ +{ + "parameters": { + "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", + "location": "WestUS", + "api-version": "2020-03-01-preview", + "digitalTwinsInstanceCheckName": { + "name": "myadtinstance", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances" + } + }, + "responses": { + "200": { + "body": { + "nameAvailable": false, + "name": "myadtinstance", + "message": "Name 'myadtinstance' is already taken. Please specify a different name", + "reason": "AlreadyExists" + } + } + } +} diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsDelete_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsDelete_example.json new file mode 100644 index 000000000000..4961b326a398 --- /dev/null +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsDelete_example.json @@ -0,0 +1,26 @@ +{ + "parameters": { + "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", + "resourceGroupName": "resRg", + "resourceName": "myDigitalTwinsService", + "api-version": "2020-03-01-preview" + }, + "responses": { + "200": {}, + "202": { + "body": { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService", + "location": "westus", + "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "name": "myDigitalTwinsService", + "properties": { + "createdTime": "2019-11-19T12:55:05.229Z", + "lastUpdatedTime": "2019-12-06T12:21:58.610Z", + "provisioningState": "Deleting", + "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net" + } + } + }, + "204": {} + } +} diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointDelete_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointDelete_example.json new file mode 100644 index 000000000000..8fc0949a930b --- /dev/null +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointDelete_example.json @@ -0,0 +1,27 @@ +{ + "parameters": { + "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", + "resourceGroupName": "resRg", + "resourceName": "myDigitalTwinsService", + "endpointName": "myendpoint", + "api-version": "2020-03-01-preview" + }, + "responses": { + "200": {}, + "202": { + "body": { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService/endpoints/myServiceBus", + "type": "Microsoft.DigitalTwins/digitalTwinsInstance/endpoints", + "name": "myendpoint", + "properties": { + "endpointType": "ServiceBus", + "provisioningState": "Deleting", + "primaryConnectionString": "************", + "secondaryConnectionString": "************", + "createdTime": "2019-11-19T01:10:34.350Z" + } + } + }, + "204": {} + } +} diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointGet_example.json new file mode 100644 index 000000000000..e697f45cba39 --- /dev/null +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointGet_example.json @@ -0,0 +1,25 @@ +{ + "parameters": { + "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", + "resourceGroupName": "resRg", + "resourceName": "myDigitalTwinsService", + "endpointName": "myServiceBus", + "api-version": "2020-03-01-preview" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService/endpoints/myServiceBus", + "type": "Microsoft.DigitalTwins/digitalTwinsInstance/endpoints", + "name": "myendpoint", + "properties": { + "endpointType": "ServiceBus", + "provisioningState": "Provisioned", + "primaryConnectionString": "************", + "secondaryConnectionString": "************", + "createdTime": "2019-11-19T01:10:34.350Z" + } + } + } + } +} diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointPut_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointPut_example.json new file mode 100644 index 000000000000..84a81d99d476 --- /dev/null +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointPut_example.json @@ -0,0 +1,45 @@ +{ + "parameters": { + "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", + "resourceGroupName": "resRg", + "resourceName": "myDigitalTwinsService", + "api-version": "2020-03-01-preview", + "endpointName": "myServiceBus", + "endpointDescription": { + "properties": { + "endpointType": "ServiceBus", + "primaryConnectionString": "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=xyzxyzoX4=", + "secondaryConnectionString": "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=xyzxyzoX4=" + } + } + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService/endpoints/myServiceBus", + "type": "Microsoft.DigitalTwins/digitalTwinsInstance/endpoints", + "name": "myServiceBus", + "properties": { + "endpointType": "ServiceBus", + "primaryConnectionString": "************", + "secondaryConnectionString": "************", + "createdTime": "2019-11-19T01:10:34.350Z" + } + } + }, + "201": { + "body": { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService/endpoints/myServiceBus", + "type": "Microsoft.DigitalTwins/digitalTwinsInstance/endpoints", + "name": "myendpoint", + "properties": { + "endpointType": "ServiceBus", + "provisioningState": "Provisioning", + "primaryConnectionString": "************", + "secondaryConnectionString": "************", + "createdTime": "2019-11-19T01:10:34.350Z" + } + } + } + } +} diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json new file mode 100644 index 000000000000..b7de375a7741 --- /dev/null +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json @@ -0,0 +1,40 @@ +{ + "parameters": { + "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", + "resourceGroupName": "resRg", + "resourceName": "myDigitalTwinsService", + "api-version": "2020-03-01-preview" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService/endpoints/myServiceBus", + "type": "Microsoft.DigitalTwins/digitalTwinsInstance/endpoints", + "name": "myendpoint1", + "properties": { + "endpointType": "ServiceBus", + "provisioningState": "Provisioned", + "primaryConnectionString": "************", + "secondaryConnectionString": "************", + "createdTime": "2019-11-19T01:10:34.350Z" + } + }, + { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService/endpoints/myServiceBus", + "type": "Microsoft.DigitalTwins/digitalTwinsInstance/endpoints", + "name": "myendpoint2", + "properties": { + "endpointType": "EventHub", + "provisioningState": "Provisioned", + "connectionString-PrimaryKey": "************", + "connectionString-SecondaryKey": "************", + "createdTime": "2019-11-19T01:10:34.350Z" + } + } + ] + } + } + } +} diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsGet_example.json new file mode 100644 index 000000000000..3c2d917a47e7 --- /dev/null +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsGet_example.json @@ -0,0 +1,24 @@ +{ + "parameters": { + "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", + "resourceGroupName": "resRg", + "resourceName": "myDigitalTwinsService", + "api-version": "2020-03-01-preview" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService", + "location": "westus", + "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "name": "myDigitalTwinsService", + "properties": { + "createdTime": "2019-11-19T12:55:05.229Z", + "lastUpdatedTime": "2019-12-06T12:21:58.610Z", + "provisioningState": "Provisioning", + "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net" + } + } + } + } +} diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsListByResourceGroup_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsListByResourceGroup_example.json new file mode 100644 index 000000000000..7cc9457d1122 --- /dev/null +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsListByResourceGroup_example.json @@ -0,0 +1,38 @@ +{ + "parameters": { + "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", + "api-version": "2020-03-01-preview", + "resourceGroupName": "resRg" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService", + "location": "westus", + "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "name": "myDigitalTwinsService", + "properties": { + "createdTime": "2019-11-19T12:55:05.229Z", + "provisioningState": "Provisioning", + "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net" + } + }, + { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService2", + "location": "westus", + "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "name": "myDigitalTwinsService2", + "properties": { + "createdTime": "2019-11-19T12:55:05.229Z", + "provisioningState": "Provisioning", + "hostName": "https://myDigitalTwinsService2.api.wus2.ss.azuredigitaltwins-test.net" + } + } + ] + } + } + } +} diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsList_example.json new file mode 100644 index 000000000000..9b5ea011dbd3 --- /dev/null +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsList_example.json @@ -0,0 +1,37 @@ +{ + "parameters": { + "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", + "api-version": "2020-03-01-preview" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService", + "location": "westus", + "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "name": "myDigitalTwinsService", + "properties": { + "createdTime": "2019-11-19T12:55:05.229Z", + "provisioningState": "Provisioning", + "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net" + } + }, + { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg2/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService2", + "location": "westus", + "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "name": "myDigitalTwinsService2", + "properties": { + "createdTime": "2019-11-19T12:55:05.229Z", + "provisioningState": "Provisioning", + "hostName": "https://myDigitalTwinsService2.api.wus2.ss.azuredigitaltwins-test.net" + } + } + ] + } + } + } +} diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsOperationsList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsOperationsList_example.json new file mode 100644 index 000000000000..4356bafad941 --- /dev/null +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsOperationsList_example.json @@ -0,0 +1,50 @@ +{ + "parameters": { + "api-version": "2020-03-01-preview" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "name": "Microsoft.DigitalTwins/checkNameAvailability/action", + "display": { + "provider": "Microsoft Digital Twins Service", + "resource": "Microsoft Digital Twins Service instance", + "operation": "Check Digital Twins Service name availability.", + "description": "Check Digital Twins Service name availability." + } + }, + { + "name": "Microsoft.DigitalTwins/DigitalTwinsInstance/write", + "display": { + "provider": "Microsoft Digital Twins Service", + "resource": "Microsoft Digital Twins Service instance", + "operation": "Create or update a Digital Twins Service instance.", + "description": "Create or update a Digital Twins Service instance." + } + }, + { + "name": "Microsoft.DigitalTwins/DigitalTwinsInstance/read", + "display": { + "provider": "Microsoft Digital Twins Service", + "resource": "Microsoft Digital Twins Service instance", + "operation": "Get a Digital Twins Service instance.", + "description": "Get a Digital Twins Service instance." + } + }, + { + "name": "Microsoft.DigitalTwins/DigitalTwinsInstance/delete", + "display": { + "provider": "Microsoft Digital Twins Service", + "resource": "Microsoft Digital Twins Service instance", + "operation": "Delete a Digital Twins Service instance.", + "description": "Delete a Digital Twins Service instance." + } + } + ] + } + } + } +} diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPatch_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPatch_example.json new file mode 100644 index 000000000000..fcf1a7d2e56e --- /dev/null +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPatch_example.json @@ -0,0 +1,33 @@ +{ + "parameters": { + "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", + "resourceGroupName": "resRg", + "resourceName": "myDigitalTwinsService", + "api-version": "2020-03-01-preview", + "digitalTwinsPatchDescription": { + "tags": { + "purpose": "dev" + } + } + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService", + "location": "westus", + "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "name": "myDigitalTwinsService", + "tags": { + "purpose": "dev" + }, + "properties": { + "createdTime": "2019-11-19T12:55:05.229Z", + "lastUpdatedTime": "2019-12-06T12:21:58.610Z", + "provisioningState": "Provisioning", + "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net" + } + } + }, + "201": {} + } +} diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPut_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPut_example.json new file mode 100644 index 000000000000..523e94e93049 --- /dev/null +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPut_example.json @@ -0,0 +1,41 @@ +{ + "parameters": { + "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", + "resourceGroupName": "resRg", + "resourceName": "myDigitalTwinsService", + "api-version": "2020-03-01-preview", + "digitalTwinsCreate": { + "location": "WestUS" + } + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService", + "location": "westus", + "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "name": "myDigitalTwinsService", + "properties": { + "createdTime": "2019-11-19T12:55:05.229Z", + "lastUpdatedTime": "2019-12-06T12:21:58.610Z", + "provisioningState": "Provisioning", + "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net" + } + } + }, + "201": { + "body": { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService", + "location": "westus", + "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "name": "myDigitalTwinsService", + "properties": { + "createdTime": "2019-11-19T12:55:05.229Z", + "lastUpdatedTime": "2019-12-06T12:21:58.610Z", + "provisioningState": "Provisioning", + "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net" + } + } + } + } +} From 1adf0ba692afdf524e5df9ef2051a26a5591c6e7 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Fri, 31 Jul 2020 13:32:14 -0700 Subject: [PATCH 02/28] Updates readme --- specification/digitaltwins/resource-manager/readme.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/specification/digitaltwins/resource-manager/readme.md b/specification/digitaltwins/resource-manager/readme.md index dcdba572a32c..bdf3e2c21e2c 100644 --- a/specification/digitaltwins/resource-manager/readme.md +++ b/specification/digitaltwins/resource-manager/readme.md @@ -26,9 +26,18 @@ These are the global settings for the digitaltwins. ``` yaml openapi-type: arm -tag: package-2020-03-01-preview +tag: package-2020-10 ``` + +### Tag: package-2020-10 + +These settings apply only when `--tag=package-2020-10` is specified on the command line. + +```yaml $(tag) == 'package-2020-10' +input-file: + - Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +``` ### Tag: package-2020-03-01-preview These settings apply only when `--tag=package-2020-03-01-preview` is specified on the command line. From d00bfb05deaf0c1ee3033226b0a330663d57898d Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Fri, 31 Jul 2020 13:32:18 -0700 Subject: [PATCH 03/28] Updates API version in new specs and examples --- .../stable/2020-10-31/digitaltwins.json | 4 ++-- .../examples/DigitalTwinsCheckNameAvailability_example.json | 2 +- .../2020-10-31/examples/DigitalTwinsDelete_example.json | 2 +- .../examples/DigitalTwinsEndpointDelete_example.json | 2 +- .../2020-10-31/examples/DigitalTwinsEndpointGet_example.json | 2 +- .../2020-10-31/examples/DigitalTwinsEndpointPut_example.json | 2 +- .../2020-10-31/examples/DigitalTwinsEndpointsGet_example.json | 2 +- .../stable/2020-10-31/examples/DigitalTwinsGet_example.json | 2 +- .../examples/DigitalTwinsListByResourceGroup_example.json | 2 +- .../stable/2020-10-31/examples/DigitalTwinsList_example.json | 2 +- .../examples/DigitalTwinsOperationsList_example.json | 2 +- .../stable/2020-10-31/examples/DigitalTwinsPatch_example.json | 2 +- .../stable/2020-10-31/examples/DigitalTwinsPut_example.json | 2 +- 13 files changed, 14 insertions(+), 14 deletions(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json index ad2e784412c5..1ed6e37ab95f 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -1,7 +1,7 @@ { "swagger": "2.0", "info": { - "version": "2020-03-01-preview", + "version": "2020-10-31", "title": "AzureDigitalTwinsManagementClient", "description": "Azure Digital Twins Client for managing DigitalTwinsInstance" }, @@ -1092,7 +1092,7 @@ "api-version": { "name": "api-version", "enum": [ - "2020-03-01-preview" + "2020-10-31" ], "in": "query", "description": "Version of the DigitalTwinsInstance Management API.", diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsCheckNameAvailability_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsCheckNameAvailability_example.json index 57e83ec4c7c3..bde5704ba988 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsCheckNameAvailability_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsCheckNameAvailability_example.json @@ -2,7 +2,7 @@ "parameters": { "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", "location": "WestUS", - "api-version": "2020-03-01-preview", + "api-version": "2020-10-31", "digitalTwinsInstanceCheckName": { "name": "myadtinstance", "type": "Microsoft.DigitalTwins/digitalTwinsInstances" diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsDelete_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsDelete_example.json index 4961b326a398..df259869d2f2 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsDelete_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsDelete_example.json @@ -3,7 +3,7 @@ "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", "resourceGroupName": "resRg", "resourceName": "myDigitalTwinsService", - "api-version": "2020-03-01-preview" + "api-version": "2020-10-31" }, "responses": { "200": {}, diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointDelete_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointDelete_example.json index 8fc0949a930b..d7d4a09f0cf7 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointDelete_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointDelete_example.json @@ -4,7 +4,7 @@ "resourceGroupName": "resRg", "resourceName": "myDigitalTwinsService", "endpointName": "myendpoint", - "api-version": "2020-03-01-preview" + "api-version": "2020-10-31" }, "responses": { "200": {}, diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointGet_example.json index e697f45cba39..371906db8e1b 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointGet_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointGet_example.json @@ -4,7 +4,7 @@ "resourceGroupName": "resRg", "resourceName": "myDigitalTwinsService", "endpointName": "myServiceBus", - "api-version": "2020-03-01-preview" + "api-version": "2020-10-31" }, "responses": { "200": { diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointPut_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointPut_example.json index 84a81d99d476..f224353cacec 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointPut_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointPut_example.json @@ -3,7 +3,7 @@ "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", "resourceGroupName": "resRg", "resourceName": "myDigitalTwinsService", - "api-version": "2020-03-01-preview", + "api-version": "2020-10-31", "endpointName": "myServiceBus", "endpointDescription": { "properties": { diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json index b7de375a7741..d6825a032d66 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json @@ -3,7 +3,7 @@ "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", "resourceGroupName": "resRg", "resourceName": "myDigitalTwinsService", - "api-version": "2020-03-01-preview" + "api-version": "2020-10-31" }, "responses": { "200": { diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsGet_example.json index 3c2d917a47e7..53e0f128986f 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsGet_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsGet_example.json @@ -3,7 +3,7 @@ "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", "resourceGroupName": "resRg", "resourceName": "myDigitalTwinsService", - "api-version": "2020-03-01-preview" + "api-version": "2020-10-31" }, "responses": { "200": { diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsListByResourceGroup_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsListByResourceGroup_example.json index 7cc9457d1122..b5d0df2a1f88 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsListByResourceGroup_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsListByResourceGroup_example.json @@ -1,7 +1,7 @@ { "parameters": { "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", - "api-version": "2020-03-01-preview", + "api-version": "2020-10-31", "resourceGroupName": "resRg" }, "responses": { diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsList_example.json index 9b5ea011dbd3..f5d1f661f37d 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsList_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsList_example.json @@ -1,7 +1,7 @@ { "parameters": { "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", - "api-version": "2020-03-01-preview" + "api-version": "2020-10-31" }, "responses": { "200": { diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsOperationsList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsOperationsList_example.json index 4356bafad941..f4d4798ac361 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsOperationsList_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsOperationsList_example.json @@ -1,6 +1,6 @@ { "parameters": { - "api-version": "2020-03-01-preview" + "api-version": "2020-10-31" }, "responses": { "200": { diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPatch_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPatch_example.json index fcf1a7d2e56e..b67a244b88aa 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPatch_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPatch_example.json @@ -3,7 +3,7 @@ "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", "resourceGroupName": "resRg", "resourceName": "myDigitalTwinsService", - "api-version": "2020-03-01-preview", + "api-version": "2020-10-31", "digitalTwinsPatchDescription": { "tags": { "purpose": "dev" diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPut_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPut_example.json index 523e94e93049..f1c2c1728c4c 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPut_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPut_example.json @@ -3,7 +3,7 @@ "subscriptionId": "50016170-c839-41ba-a724-51e9df440b9e", "resourceGroupName": "resRg", "resourceName": "myDigitalTwinsService", - "api-version": "2020-03-01-preview", + "api-version": "2020-10-31", "digitalTwinsCreate": { "location": "WestUS" } From 6be31bd2dc4f2d763c3d0ffd096fe531cf78f4db Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Tue, 4 Aug 2020 11:59:39 -0700 Subject: [PATCH 04/28] Aligned descriptions with GA controller models, and regex patterns in parameters --- .../stable/2020-10-31/digitaltwins.json | 310 ++++++++++++++---- 1 file changed, 248 insertions(+), 62 deletions(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json index 1ed6e37ab95f..057d9c52a0c1 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -609,7 +609,7 @@ "format": "date-time" }, "lastUpdatedTime": { - "description": "Time when DigitalTwinsInstance was created.", + "description": "Time when DigitalTwinsInstance was updated.", "readOnly": true, "type": "string", "format": "date-time" @@ -633,30 +633,11 @@ "hostName": { "description": "Api endpoint to work with DigitalTwinsInstance.", "type": "string", + "nullable": true, "readOnly": true } } }, - "DigitalTwinsSkuInfo": { - "description": "Information about the SKU of the DigitalTwinsInstance.", - "type": "object", - "properties": { - "name": { - "description": "The name of the SKU.", - "enum": [ - "F1" - ], - "type": "string", - "x-ms-enum": { - "name": "DigitalTwinsSku", - "modelAsString": true - } - } - }, - "required": [ - "name" - ] - }, "DigitalTwinsDescription": { "description": "The description of the DigitalTwins service.", "type": "object", @@ -680,6 +661,7 @@ "tags": { "description": "Instance tags", "type": "object", + "nullable": true, "additionalProperties": { "type": "string" } @@ -698,7 +680,7 @@ "readOnly": true, "type": "string", "description": "The resource name.", - "pattern": "^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$" + "pattern": "^(?!-)[A-Za-z0-9-]{3,63}(? Date: Tue, 4 Aug 2020 12:37:09 -0700 Subject: [PATCH 05/28] Update nullable attribute to x-nullable --- .../stable/2020-10-31/digitaltwins.json | 48 +++++++++---------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json index 057d9c52a0c1..020939b14251 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -633,7 +633,7 @@ "hostName": { "description": "Api endpoint to work with DigitalTwinsInstance.", "type": "string", - "nullable": true, + "x-nullable": true, "readOnly": true } } @@ -661,7 +661,7 @@ "tags": { "description": "Instance tags", "type": "object", - "nullable": true, + "x-nullable": true, "additionalProperties": { "type": "string" } @@ -697,7 +697,7 @@ }, "tags": { "type": "object", - "nullable": true, + "x-nullable": true, "additionalProperties": { "type": "string" }, @@ -734,7 +734,7 @@ "details": { "description": "Internal error details.", "type": "array", - "nullable": true, + "x-nullable": true, "items": { "$ref": "#/definitions/ErrorDefinition" }, @@ -749,7 +749,7 @@ "nextLink": { "description": "The link used to get the next page of DigitalTwins description objects.", "type": "string", - "nullable": true + "x-nullable": true }, "value": { "description": "A list of DigitalTwins description objects.", @@ -767,7 +767,7 @@ "nextLink": { "description": "The link used to get the next page of DigitalTwins description objects.", "type": "string", - "nullable": true + "x-nullable": true }, "value": { "description": "A list of DigitalTwins operations supported by the Microsoft.DigitalTwins resource provider.", @@ -795,7 +795,7 @@ "origin": { "readOnly": true, "type": "string", - "nullable": true, + "x-nullable": true, "description": "The intended executor of the operation." }, "isDataAction": { @@ -805,7 +805,7 @@ }, "properties": { "description": "Extra properties for the operation.", - "nullable": true, + "x-nullable": true, "$ref": "#/definitions/OperationProperties" } } @@ -842,7 +842,7 @@ "properties": { "serviceSpecification": { "description": "Service specification of the operation.", - "nullable": true, + "x-nullable": true, "$ref": "#/definitions/OperationServiceSpecification" } } @@ -855,7 +855,7 @@ "description": "Metric specifications for the operation.", "readOnly": true, "type": "array", - "nullable": true, + "x-nullable": true, "items": { "$ref": "#/definitions/OperationMetricSpecification" } @@ -864,7 +864,7 @@ "description": "Log specifications for the operation.", "readOnly": true, "type": "array", - "nullable": true, + "x-nullable": true, "items": { "$ref": "#/definitions/OperationLogSpecification" } @@ -913,7 +913,7 @@ "$ref": "#definitions/OperationMetricAggregationType" }, "supportedAggregationTypes": { - "nullable": true, + "x-nullable": true, "description": "", "type": "array", "items": { @@ -921,7 +921,7 @@ } }, "dimensions": { - "nullable": true, + "x-nullable": true, "description": "", "type": "array", "items": { @@ -929,7 +929,7 @@ } }, "availabilities": { - "nullable": true, + "x-nullable": true, "description": "", "type": "array", "items": { @@ -938,7 +938,7 @@ }, "lockAggregationType": { "type": "string", - "nullable": true, + "x-nullable": true, "description": "" } } @@ -974,7 +974,7 @@ }, "internalName": { "type": "string", - "nullable": true, + "x-nullable": true, "readOnly": true, "description": "" } @@ -1134,7 +1134,7 @@ "Canceled" ], "type": "string", - "nullable": true, + "x-nullable": true, "readOnly": true, "x-ms-enum": { "name": "EndpointProvisioningState", @@ -1144,19 +1144,19 @@ "createdTime": { "description": "Time when the Endpoint was added to DigitalTwinsInstance.", "type": "string", - "nullable": true, + "x-nullable": true, "format": "date-time", "readOnly": true }, "deadLetterSecret": { "description": "Dead letter storage secret. Will be obfuscated during read.", "type": "string", - "nullable": true, + "x-nullable": true, "readOnly": true }, "tags": { "type": "object", - "nullable": true, + "x-nullable": true, "additionalProperties": { "type": "string" }, @@ -1184,7 +1184,7 @@ "secondaryConnectionString": { "description": "SecondaryConnectionString of the endpoint. Will be obfuscated during read.", "type": "string", - "nullable": true + "x-nullable": true } } } @@ -1210,7 +1210,7 @@ "connectionString-SecondaryKey": { "description": "SecondaryConnectionString of the endpoint. Will be obfuscated during read.", "type": "string", - "nullable": true + "x-nullable": true } } } @@ -1241,7 +1241,7 @@ "accessKey2": { "description": "EventGrid secondary accesskey. Will be obfuscated during read.", "type": "string", - "nullable": true + "x-nullable": true } } } @@ -1254,7 +1254,7 @@ "nextLink": { "description": "The link used to get the next page of DigitalTwinsInstance Endpoints.", "type": "string", - "nullable": true + "x-nullable": true }, "value": { "description": "A list of DigitalTwinsInstance Endpoints.", From dc64a573c45322e5f6889395fb7f9a9644e793e6 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Thu, 13 Aug 2020 14:30:40 -0700 Subject: [PATCH 06/28] Latest updates --- .../stable/2020-10-31/digitaltwins.json | 15 +++++---------- ...DigitalTwinsCheckNameAvailability_example.json | 1 - 2 files changed, 5 insertions(+), 11 deletions(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json index 020939b14251..33ae6c326383 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -211,9 +211,6 @@ } ], "responses": { - "200": { - "description": "This is returned as a response to the status polling request for the delete operation. The body contains the resource representation that indicates a transitional provisioning state." - }, "202": { "description": "Accepted - Delete request accepted; the operation will complete asynchronously.", "schema": { @@ -410,9 +407,6 @@ } ], "responses": { - "200": { - "description": "This is returned as a response to the status polling request for the delete operation. The body contains the resource representation that indicates a transitional provisioning state." - }, "202": { "description": "Accepted - Delete request accepted; the operation will complete asynchronously.", "schema": { @@ -498,7 +492,7 @@ ], "responses": { "200": { - "description": "This is a synchronous operation. The body contains a JSON-serialized array of the metadata from all the DigitalTwinsInstances in the resource group.", + "description": "This is a synchronous operation. The body contains a JSON-serialized array of the metadata from all the DigitalTwinsInstances in the resource group. If more data is available, the body will contain a link to the next page of items (nextLink).", "schema": { "$ref": "#/definitions/DigitalTwinsDescriptionListResult" } @@ -1049,14 +1043,15 @@ }, "message": { "type": "string", + "x-nullable": true, "description": "Message indicating an unavailable name due to a conflict, or a description of the naming rules that are violated." }, "reason": { "type": "string", + "x-nullable": true, "enum": [ - "NameIsAvailable", - "NameConflict", - "InvalidName" + "Invalid", + "AlreadyExists" ], "x-ms-enum": { "name": "reason", diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsCheckNameAvailability_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsCheckNameAvailability_example.json index bde5704ba988..0df8dfcc15b9 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsCheckNameAvailability_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsCheckNameAvailability_example.json @@ -12,7 +12,6 @@ "200": { "body": { "nameAvailable": false, - "name": "myadtinstance", "message": "Name 'myadtinstance' is already taken. Please specify a different name", "reason": "AlreadyExists" } From 1b33f4de4220f7b1e0e6b9298517f321664a1840 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Thu, 13 Aug 2020 16:49:36 -0700 Subject: [PATCH 07/28] Add x-ms-secret = true for endpoint PUT --- .../Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json | 1 + 1 file changed, 1 insertion(+) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json index 33ae6c326383..b5684020762f 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -325,6 +325,7 @@ "description": "Create or update DigitalTwinsInstance endpoint.", "operationId": "DigitalTwinsEndpoint_CreateOrUpdate", "x-ms-long-running-operation": true, + "x-ms-secret": true, "x-ms-examples": { "Put a DigitalTwinsInstance resource": { "$ref": "./examples/DigitalTwinsEndpointPut_example.json" From a1af63a9a009a9d1ca17a390208c5b3c41df9f57 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Fri, 14 Aug 2020 10:48:46 -0700 Subject: [PATCH 08/28] Latest changes --- .../stable/2020-10-31/digitaltwins.json | 21 +++++++++++-------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json index b5684020762f..7fae83952c0b 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -112,7 +112,7 @@ ], "responses": { "200": { - "description": "This is returned as a response to the status polling request for the create or update operation. The body contains the resource representation that indicates a transitional provisioning state.", + "description": "This is returned as a response when the resource already exists and was updated successfully.", "schema": { "$ref": "#/definitions/DigitalTwinsDescription" } @@ -173,9 +173,6 @@ "$ref": "#/definitions/DigitalTwinsDescription" } }, - "201": { - "description": "Accepted - Put request accepted; the operation will complete asynchronously." - }, "default": { "description": "Error response describing why the operation failed.", "schema": { @@ -218,7 +215,7 @@ } }, "204": { - "description": "Once the long running delete operation completes successfully, a 204 No Content status code is returned when the status polling request finds the DigitalTwins service metadata in the service and the status of the delete operation is set to a completed state." + "description": "Returned when the long running delete operation has finished, or the Digital Twins instance does not exist." }, "default": { "description": "Error response describing why the operation failed.", @@ -325,7 +322,6 @@ "description": "Create or update DigitalTwinsInstance endpoint.", "operationId": "DigitalTwinsEndpoint_CreateOrUpdate", "x-ms-long-running-operation": true, - "x-ms-secret": true, "x-ms-examples": { "Put a DigitalTwinsInstance resource": { "$ref": "./examples/DigitalTwinsEndpointPut_example.json" @@ -415,7 +411,7 @@ } }, "204": { - "description": "Once the long running delete operation completes successfully, a 204 No Content status code is returned when the status polling request finds the DigitalTwins service metadata in the service and the status of the delete operation is set to a completed state." + "description": "Returned when the long running delete operation has finished, or the egress endpoint does not exist." }, "default": { "description": "Error response describing why the operation failed.", @@ -1145,6 +1141,7 @@ "readOnly": true }, "deadLetterSecret": { + "x-ms-secret": true, "description": "Dead letter storage secret. Will be obfuscated during read.", "type": "string", "x-nullable": true, @@ -1174,10 +1171,12 @@ "type": "object", "properties": { "primaryConnectionString": { + "x-ms-secret": true, "description": "PrimaryConnectionString of the endpoint. Will be obfuscated during read.", "type": "string" }, "secondaryConnectionString": { + "x-ms-secret": true, "description": "SecondaryConnectionString of the endpoint. Will be obfuscated during read.", "type": "string", "x-nullable": true @@ -1199,11 +1198,13 @@ { "type": "object", "properties": { - "connectionString-PrimaryKey": { + "connectionStringPrimaryKey": { + "x-ms-secret": true, "description": "PrimaryConnectionString of the endpoint. Will be obfuscated during read.", "type": "string" }, - "connectionString-SecondaryKey": { + "connectionStringSecondaryKey": { + "x-ms-secret": true, "description": "SecondaryConnectionString of the endpoint. Will be obfuscated during read.", "type": "string", "x-nullable": true @@ -1231,10 +1232,12 @@ "type": "string" }, "accessKey1": { + "x-ms-secret": true, "description": "EventGrid secondary accesskey. Will be obfuscated during read.", "type": "string" }, "accessKey2": { + "x-ms-secret": true, "description": "EventGrid secondary accesskey. Will be obfuscated during read.", "type": "string", "x-nullable": true From 2d74b343e97c0a0da1719b816ea8717b4a80808c Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Fri, 14 Aug 2020 11:03:38 -0700 Subject: [PATCH 09/28] Fix reference issue --- .../stable/2020-10-31/digitaltwins.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json index 7fae83952c0b..b2775ea2abd1 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -901,14 +901,14 @@ }, "aggregationType": { "description": "", - "$ref": "#definitions/OperationMetricAggregationType" + "$ref": "#/definitions/OperationMetricAggregationType" }, "supportedAggregationTypes": { "x-nullable": true, "description": "", "type": "array", "items": { - "$ref": "#definitions/OperationMetricAggregationType" + "$ref": "#/definitions/OperationMetricAggregationType" } }, "dimensions": { @@ -916,7 +916,7 @@ "description": "", "type": "array", "items": { - "$ref": "#definitions/OperationMetricDimension" + "$ref": "#/definitions/OperationMetricDimension" } }, "availabilities": { @@ -924,7 +924,7 @@ "description": "", "type": "array", "items": { - "$ref": "#definitions/OperationMetricAvailability" + "$ref": "#/definitions/OperationMetricAvailability" } }, "lockAggregationType": { From 7859958760f29ad03629f8b08efe645d4f4e361b Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Fri, 14 Aug 2020 11:21:27 -0700 Subject: [PATCH 10/28] Simplify operationResults --- .../stable/2020-10-31/digitaltwins.json | 184 ------------------ 1 file changed, 184 deletions(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json index b2775ea2abd1..8ee92b24a243 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -793,11 +793,6 @@ "readOnly": true, "type": "boolean", "description": "If the operation is a data action (for data plane rbac)." - }, - "properties": { - "description": "Extra properties for the operation.", - "x-nullable": true, - "$ref": "#/definitions/OperationProperties" } } }, @@ -827,185 +822,6 @@ } } }, - "OperationProperties": { - "description": "The object that represents the operation properties.", - "type": "object", - "properties": { - "serviceSpecification": { - "description": "Service specification of the operation.", - "x-nullable": true, - "$ref": "#/definitions/OperationServiceSpecification" - } - } - }, - "OperationServiceSpecification": { - "description": "The object that represents the service specification.", - "type": "object", - "properties": { - "metricSpecifications": { - "description": "Metric specifications for the operation.", - "readOnly": true, - "type": "array", - "x-nullable": true, - "items": { - "$ref": "#/definitions/OperationMetricSpecification" - } - }, - "logSpecifications": { - "description": "Log specifications for the operation.", - "readOnly": true, - "type": "array", - "x-nullable": true, - "items": { - "$ref": "#/definitions/OperationLogSpecification" - } - } - } - }, - "OperationMetricSpecification": { - "type": "object", - "properties": { - "name": { - "type": "string", - "description": "" - }, - "displayName": { - "type": "string", - "description": "" - }, - "displayDescription": { - "type": "string", - "description": "" - }, - "fillGapWithZero": { - "type": "boolean", - "description": "" - }, - "unit": { - "description": "", - "enum": [ - "Bytes", - "BytesPerSecond", - "Count", - "CountPerSecond", - "Percent", - "Seconds", - "Milliseconds" - ], - "type": "string", - "readOnly": true, - "x-ms-enum": { - "name": "OperationMetricSpecificationUnit", - "modelAsString": true - } - }, - "aggregationType": { - "description": "", - "$ref": "#/definitions/OperationMetricAggregationType" - }, - "supportedAggregationTypes": { - "x-nullable": true, - "description": "", - "type": "array", - "items": { - "$ref": "#/definitions/OperationMetricAggregationType" - } - }, - "dimensions": { - "x-nullable": true, - "description": "", - "type": "array", - "items": { - "$ref": "#/definitions/OperationMetricDimension" - } - }, - "availabilities": { - "x-nullable": true, - "description": "", - "type": "array", - "items": { - "$ref": "#/definitions/OperationMetricAvailability" - } - }, - "lockAggregationType": { - "type": "string", - "x-nullable": true, - "description": "" - } - } - }, - "OperationMetricAggregationType": { - "enum": [ - "Average", - "Last", - "Maximum", - "Minimum", - "None", - "Total" - ], - "type": "string", - "readOnly": true, - "x-ms-enum": { - "name": "OperationMetricAggregationType", - "modelAsString": true - } - }, - "OperationMetricDimension": { - "type": "object", - "properties": { - "name": { - "type": "string", - "readOnly": true, - "description": "" - }, - "displayName": { - "type": "string", - "readOnly": true, - "description": "" - }, - "internalName": { - "type": "string", - "x-nullable": true, - "readOnly": true, - "description": "" - } - } - }, - "OperationMetricAvailability": { - "type": "object", - "properties": { - "timeGrain": { - "type": "string", - "readOnly": true, - "description": "" - }, - "blobDuration": { - "type": "string", - "readOnly": true, - "description": "" - } - } - }, - "OperationLogSpecification": { - "type": "object", - "properties": { - "name": { - "type": "string", - "readOnly": true, - "description": "Name of the log specification." - }, - "displayName": { - "type": "string", - "readOnly": true, - "description": "Display name for the log specification." - }, - "blobDuration": { - "type": "string", - "readOnly": true, - "description": "Blob duration of the log specification." - } - } - }, "CheckNameRequest": { "type": "object", "properties": { From 3d82a03ed62f733d52cc750fd960d2a538c7957c Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Fri, 14 Aug 2020 11:38:32 -0700 Subject: [PATCH 11/28] Update required property name --- .../Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json index 8ee92b24a243..a0307297b635 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -1004,7 +1004,7 @@ "EventHub": { "description": "Properties related to EventHub.", "required": [ - "connectionString-PrimaryKey" + "connectionStringPrimaryKey" ], "x-ms-discriminator-value": "EventHub", "allOf": [ From b6cf729d1d52d30cdb7194764db91a93802dcb10 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Fri, 14 Aug 2020 14:10:03 -0700 Subject: [PATCH 12/28] Update examples --- .../stable/2020-10-31/digitaltwins.json | 6 ++++++ .../examples/DigitalTwinsDelete_example.json | 17 +++++++++++++++-- .../DigitalTwinsEndpointDelete_example.json | 17 +++++++++++++++-- .../DigitalTwinsEndpointGet_example.json | 4 ++-- .../DigitalTwinsEndpointPut_example.json | 7 ++++--- .../DigitalTwinsEndpointsGet_example.json | 12 ++++++------ .../examples/DigitalTwinsGet_example.json | 4 ++-- ...DigitalTwinsListByResourceGroup_example.json | 12 +++++++----- .../examples/DigitalTwinsList_example.json | 10 ++++++---- .../examples/DigitalTwinsPatch_example.json | 7 +++---- .../examples/DigitalTwinsPut_example.json | 13 ++++++++----- 11 files changed, 74 insertions(+), 35 deletions(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json index a0307297b635..d56cc9b949ea 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -208,6 +208,12 @@ } ], "responses": { + "200": { + "description": "Returned if the operation was cancelled or failed.", + "schema": { + "$ref": "#/definitions/DigitalTwinsDescription" + } + }, "202": { "description": "Accepted - Delete request accepted; the operation will complete asynchronously.", "schema": { diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsDelete_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsDelete_example.json index df259869d2f2..bc330601fb42 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsDelete_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsDelete_example.json @@ -6,12 +6,25 @@ "api-version": "2020-10-31" }, "responses": { - "200": {}, + "200": { + "body": { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService", + "location": "westus", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances", + "name": "myDigitalTwinsService", + "properties": { + "createdTime": "2019-11-19T12:55:05.229Z", + "lastUpdatedTime": "2019-12-06T12:21:58.610Z", + "provisioningState": "Failed", + "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net" + } + } + }, "202": { "body": { "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService", "location": "westus", - "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances", "name": "myDigitalTwinsService", "properties": { "createdTime": "2019-11-19T12:55:05.229Z", diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointDelete_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointDelete_example.json index d7d4a09f0cf7..6ebf4c0dc557 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointDelete_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointDelete_example.json @@ -7,11 +7,24 @@ "api-version": "2020-10-31" }, "responses": { - "200": {}, + "200": { + "body": { + "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService/endpoints/myServiceBus", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints", + "name": "myendpoint", + "properties": { + "endpointType": "ServiceBus", + "provisioningState": "Failed", + "primaryConnectionString": "************", + "secondaryConnectionString": "************", + "createdTime": "2019-11-19T01:10:34.350Z" + } + } + }, "202": { "body": { "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService/endpoints/myServiceBus", - "type": "Microsoft.DigitalTwins/digitalTwinsInstance/endpoints", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints", "name": "myendpoint", "properties": { "endpointType": "ServiceBus", diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointGet_example.json index 371906db8e1b..0c338747946d 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointGet_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointGet_example.json @@ -10,11 +10,11 @@ "200": { "body": { "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService/endpoints/myServiceBus", - "type": "Microsoft.DigitalTwins/digitalTwinsInstance/endpoints", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints", "name": "myendpoint", "properties": { "endpointType": "ServiceBus", - "provisioningState": "Provisioned", + "provisioningState": "Succeeded", "primaryConnectionString": "************", "secondaryConnectionString": "************", "createdTime": "2019-11-19T01:10:34.350Z" diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointPut_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointPut_example.json index f224353cacec..75c5314c681b 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointPut_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointPut_example.json @@ -17,10 +17,11 @@ "200": { "body": { "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService/endpoints/myServiceBus", - "type": "Microsoft.DigitalTwins/digitalTwinsInstance/endpoints", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints", "name": "myServiceBus", "properties": { "endpointType": "ServiceBus", + "provisioningState": "Succeeded", "primaryConnectionString": "************", "secondaryConnectionString": "************", "createdTime": "2019-11-19T01:10:34.350Z" @@ -30,8 +31,8 @@ "201": { "body": { "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService/endpoints/myServiceBus", - "type": "Microsoft.DigitalTwins/digitalTwinsInstance/endpoints", - "name": "myendpoint", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints", + "name": "myServiceBus", "properties": { "endpointType": "ServiceBus", "provisioningState": "Provisioning", diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json index d6825a032d66..54e03b4dfee8 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json @@ -11,11 +11,11 @@ "value": [ { "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService/endpoints/myServiceBus", - "type": "Microsoft.DigitalTwins/digitalTwinsInstance/endpoints", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints", "name": "myendpoint1", "properties": { "endpointType": "ServiceBus", - "provisioningState": "Provisioned", + "provisioningState": "Succeeded", "primaryConnectionString": "************", "secondaryConnectionString": "************", "createdTime": "2019-11-19T01:10:34.350Z" @@ -23,13 +23,13 @@ }, { "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService/endpoints/myServiceBus", - "type": "Microsoft.DigitalTwins/digitalTwinsInstance/endpoints", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances/endpoints", "name": "myendpoint2", "properties": { "endpointType": "EventHub", - "provisioningState": "Provisioned", - "connectionString-PrimaryKey": "************", - "connectionString-SecondaryKey": "************", + "provisioningState": "Succeeded", + "connectionStringPrimaryKey": "************", + "connectionStringSecondaryKey": "************", "createdTime": "2019-11-19T01:10:34.350Z" } } diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsGet_example.json index 53e0f128986f..3296834f087a 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsGet_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsGet_example.json @@ -10,12 +10,12 @@ "body": { "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService", "location": "westus", - "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances", "name": "myDigitalTwinsService", "properties": { "createdTime": "2019-11-19T12:55:05.229Z", "lastUpdatedTime": "2019-12-06T12:21:58.610Z", - "provisioningState": "Provisioning", + "provisioningState": "Succeeded", "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net" } } diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsListByResourceGroup_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsListByResourceGroup_example.json index b5d0df2a1f88..e1d83d0ee610 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsListByResourceGroup_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsListByResourceGroup_example.json @@ -12,23 +12,25 @@ { "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService", "location": "westus", - "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances", "name": "myDigitalTwinsService", "properties": { "createdTime": "2019-11-19T12:55:05.229Z", - "provisioningState": "Provisioning", + "lastUpdatedTime": "2019-11-19T12:51:05.229Z", + "provisioningState": "Succeeded", "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net" } }, { "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService2", "location": "westus", - "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances", "name": "myDigitalTwinsService2", "properties": { - "createdTime": "2019-11-19T12:55:05.229Z", + "createdTime": "2019-11-19T12:55:07.229Z", + "lastUpdatedTime": "2019-11-19T12:55:07.229Z", "provisioningState": "Provisioning", - "hostName": "https://myDigitalTwinsService2.api.wus2.ss.azuredigitaltwins-test.net" + "hostName": null } } ] diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsList_example.json index f5d1f661f37d..782077a67cea 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsList_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsList_example.json @@ -11,23 +11,25 @@ { "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService", "location": "westus", - "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances", "name": "myDigitalTwinsService", "properties": { "createdTime": "2019-11-19T12:55:05.229Z", - "provisioningState": "Provisioning", + "lastUpdatedTime": "2019-11-19T12:55:07.229Z", + "provisioningState": "Succeeded", "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net" } }, { "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg2/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService2", "location": "westus", - "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances", "name": "myDigitalTwinsService2", "properties": { "createdTime": "2019-11-19T12:55:05.229Z", + "lastUpdatedTime": "2019-11-19T12:55:07.229Z", "provisioningState": "Provisioning", - "hostName": "https://myDigitalTwinsService2.api.wus2.ss.azuredigitaltwins-test.net" + "hostName": null } } ] diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPatch_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPatch_example.json index b67a244b88aa..98fe3253c706 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPatch_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPatch_example.json @@ -15,7 +15,7 @@ "body": { "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService", "location": "westus", - "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances", "name": "myDigitalTwinsService", "tags": { "purpose": "dev" @@ -23,11 +23,10 @@ "properties": { "createdTime": "2019-11-19T12:55:05.229Z", "lastUpdatedTime": "2019-12-06T12:21:58.610Z", - "provisioningState": "Provisioning", + "provisioningState": "Succeeded", "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net" } } - }, - "201": {} + } } } diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPut_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPut_example.json index f1c2c1728c4c..560c09c1abcf 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPut_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsPut_example.json @@ -13,12 +13,15 @@ "body": { "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService", "location": "westus", - "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances", "name": "myDigitalTwinsService", + "tags": { + "purpose": "dev" + }, "properties": { "createdTime": "2019-11-19T12:55:05.229Z", "lastUpdatedTime": "2019-12-06T12:21:58.610Z", - "provisioningState": "Provisioning", + "provisioningState": "Succeeded", "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net" } } @@ -27,13 +30,13 @@ "body": { "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/DigitalTwinsInstance/myDigitalTwinsService", "location": "westus", - "type": "Microsoft.DigitalTwins/DigitalTwinsInstance", + "type": "Microsoft.DigitalTwins/digitalTwinsInstances", "name": "myDigitalTwinsService", "properties": { "createdTime": "2019-11-19T12:55:05.229Z", - "lastUpdatedTime": "2019-12-06T12:21:58.610Z", + "lastUpdatedTime": "2019-11-19T12:55:05.229Z", "provisioningState": "Provisioning", - "hostName": "https://myDigitalTwinsService.api.wus2.ss.azuredigitaltwins-test.net" + "hostName": null } } } From 82727d929dd0368c02ab7e0e3e24d5e5c13a8e1d Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Fri, 14 Aug 2020 14:28:28 -0700 Subject: [PATCH 13/28] Update provisioning states --- .../stable/2020-10-31/digitaltwins.json | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json index d56cc9b949ea..fc1f93796922 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -618,7 +618,12 @@ "Deleting", "Succeeded", "Failed", - "Canceled" + "Canceled", + "Deleted", + "Warning", + "Suspending", + "Restoring", + "Moving" ], "type": "string", "readOnly": true, @@ -945,7 +950,12 @@ "Deleting", "Succeeded", "Failed", - "Canceled" + "Canceled", + "Deleted", + "Warning", + "Suspending", + "Restoring", + "Moving" ], "type": "string", "x-nullable": true, From 0345f8b6e6b7ba3746fe123bc047bd290a15b979 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Fri, 14 Aug 2020 14:32:36 -0700 Subject: [PATCH 14/28] Add 200OK response to delete endpoints --- .../stable/2020-10-31/digitaltwins.json | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json index fc1f93796922..e3a367ae0536 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -410,6 +410,12 @@ } ], "responses": { + "200": { + "description": "Returned if the operation was cancelled or failed.", + "schema": { + "$ref": "#/definitions/DigitalTwinsEndpointResource" + } + }, "202": { "description": "Accepted - Delete request accepted; the operation will complete asynchronously.", "schema": { From 2e304e426ed37030e62cd5e2353dabea50134579 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Fri, 14 Aug 2020 14:36:26 -0700 Subject: [PATCH 15/28] Adds suppression to readme --- specification/digitaltwins/resource-manager/readme.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/specification/digitaltwins/resource-manager/readme.md b/specification/digitaltwins/resource-manager/readme.md index bdf3e2c21e2c..73aafbb29bc4 100644 --- a/specification/digitaltwins/resource-manager/readme.md +++ b/specification/digitaltwins/resource-manager/readme.md @@ -29,15 +29,15 @@ openapi-type: arm tag: package-2020-10 ``` - ### Tag: package-2020-10 These settings apply only when `--tag=package-2020-10` is specified on the command line. -```yaml $(tag) == 'package-2020-10' +``` yaml $(tag) == 'package-2020-10' input-file: - Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json ``` + ### Tag: package-2020-03-01-preview These settings apply only when `--tag=package-2020-03-01-preview` is specified on the command line. @@ -125,4 +125,8 @@ directive: reason: |- Flattening properties generates SDK (using autorest) that does not support polymorphism. In this case DigitalTwinsEndpointResourceProperties is used as a base class for EventGrid, EventHub and ServiceBus. Flattening DigitalTwinsEndpointResourceProperties removes the link between DigitalTwinsEndpointResource and resources above. + - suppress: TrackedResourceListByImmediateParent + where: $.definitions + from: digitaltwins.json + reason: 'This is a proxy resource, not a tracked resource.' ``` From 16cf92293334dd676ec6e618a39843506ae3a5e8 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Fri, 14 Aug 2020 14:39:08 -0700 Subject: [PATCH 16/28] Adds suppression to readme --- specification/digitaltwins/resource-manager/readme.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/specification/digitaltwins/resource-manager/readme.md b/specification/digitaltwins/resource-manager/readme.md index 73aafbb29bc4..91b726e0fd47 100644 --- a/specification/digitaltwins/resource-manager/readme.md +++ b/specification/digitaltwins/resource-manager/readme.md @@ -129,4 +129,8 @@ directive: where: $.definitions from: digitaltwins.json reason: 'This is a proxy resource, not a tracked resource.' + - suppress: EnumInsteadOfBoolean + where: $.definitions.CheckNameResult.properties.nameAvailable + from: digitaltwins.json + reason: The value will always be a boolean. ``` From 38fe1a217793255b906aaea3d4ad7780645efeef Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Fri, 14 Aug 2020 14:50:43 -0700 Subject: [PATCH 17/28] Fix operation list example --- .../DigitalTwinsOperationsList_example.json | 40 ++++++++++--------- 1 file changed, 22 insertions(+), 18 deletions(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsOperationsList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsOperationsList_example.json index f4d4798ac361..d96c0521b2cf 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsOperationsList_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsOperationsList_example.json @@ -8,40 +8,44 @@ "body": { "value": [ { - "name": "Microsoft.DigitalTwins/checkNameAvailability/action", + "name": "Microsoft.DigitalTwins/models/read", "display": { - "provider": "Microsoft Digital Twins Service", - "resource": "Microsoft Digital Twins Service instance", - "operation": "Check Digital Twins Service name availability.", - "description": "Check Digital Twins Service name availability." - } + "provider": "Azure Digital Twins", + "resource": "Model", + "operation": "Read Model", + "description": "Read any Model" + }, + "isDataAction": true }, { - "name": "Microsoft.DigitalTwins/DigitalTwinsInstance/write", + "name": "Microsoft.DigitalTwins/digitalTwinsInstances/write", "display": { - "provider": "Microsoft Digital Twins Service", - "resource": "Microsoft Digital Twins Service instance", + "provider": "Microsoft.DigitalTwins", + "resource": "digitalTwinsInstances", "operation": "Create or update a Digital Twins Service instance.", "description": "Create or update a Digital Twins Service instance." - } + }, + "isDataAction": false }, { - "name": "Microsoft.DigitalTwins/DigitalTwinsInstance/read", + "name": "Microsoft.DigitalTwins/digitalTwinsInstances/read", "display": { - "provider": "Microsoft Digital Twins Service", - "resource": "Microsoft Digital Twins Service instance", + "provider": "Microsoft.DigitalTwins", + "resource": "digitalTwinsInstances", "operation": "Get a Digital Twins Service instance.", "description": "Get a Digital Twins Service instance." - } + }, + "isDataAction": false }, { - "name": "Microsoft.DigitalTwins/DigitalTwinsInstance/delete", + "name": "Microsoft.DigitalTwins/digitalTwinsInstances/delete", "display": { - "provider": "Microsoft Digital Twins Service", - "resource": "Microsoft Digital Twins Service instance", + "provider": "Microsoft.DigitalTwins", + "resource": "digitalTwinsInstances", "operation": "Delete a Digital Twins Service instance.", "description": "Delete a Digital Twins Service instance." - } + }, + "isDataAction": false } ] } From 7df55e42ec50bb1abb55573a55fa700a85881980 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Tue, 18 Aug 2020 16:48:44 -0700 Subject: [PATCH 18/28] Add additional provisioning state for endpoints --- .../Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json index e3a367ae0536..7067c8d3f077 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -961,7 +961,8 @@ "Warning", "Suspending", "Restoring", - "Moving" + "Moving", + "Disabled" ], "type": "string", "x-nullable": true, From 95536c0734eac279c1cdf017a55d72fb5449d152 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Tue, 18 Aug 2020 18:06:08 -0700 Subject: [PATCH 19/28] Remove tags from endpoint --- .../stable/2020-10-31/digitaltwins.json | 8 -------- 1 file changed, 8 deletions(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json index 7067c8d3f077..5166d5607bc1 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -985,14 +985,6 @@ "type": "string", "x-nullable": true, "readOnly": true - }, - "tags": { - "type": "object", - "x-nullable": true, - "additionalProperties": { - "type": "string" - }, - "description": "The resource tags." } } }, From fdbc49b6a3ffd6609d19ba2125609886846bda59 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Tue, 25 Aug 2020 12:54:16 -0700 Subject: [PATCH 20/28] Address internal reviewer comments --- .../stable/2020-10-31/digitaltwins.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json index 5166d5607bc1..5bfc58a534b2 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -209,7 +209,7 @@ ], "responses": { "200": { - "description": "Returned if the operation was cancelled or failed.", + "description": "Returned if the operation was canceled or failed.", "schema": { "$ref": "#/definitions/DigitalTwinsDescription" } @@ -411,7 +411,7 @@ ], "responses": { "200": { - "description": "Returned if the operation was cancelled or failed.", + "description": "Returned if the operation was canceled or failed.", "schema": { "$ref": "#/definitions/DigitalTwinsEndpointResource" } From 938e3352637e57f11d8448cd6c3e3096b62b4548 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Mon, 31 Aug 2020 14:15:43 -0700 Subject: [PATCH 21/28] Update x-ms-secret properties to be nullable --- .../stable/2020-10-31/digitaltwins.json | 12 +++++++----- .../examples/DigitalTwinsEndpointsGet_example.json | 4 ++-- 2 files changed, 9 insertions(+), 7 deletions(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json index 5bfc58a534b2..a649d243d702 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json @@ -983,8 +983,7 @@ "x-ms-secret": true, "description": "Dead letter storage secret. Will be obfuscated during read.", "type": "string", - "x-nullable": true, - "readOnly": true + "x-nullable": true } } }, @@ -1004,7 +1003,8 @@ "primaryConnectionString": { "x-ms-secret": true, "description": "PrimaryConnectionString of the endpoint. Will be obfuscated during read.", - "type": "string" + "type": "string", + "x-nullable": true }, "secondaryConnectionString": { "x-ms-secret": true, @@ -1032,7 +1032,8 @@ "connectionStringPrimaryKey": { "x-ms-secret": true, "description": "PrimaryConnectionString of the endpoint. Will be obfuscated during read.", - "type": "string" + "type": "string", + "x-nullable": true }, "connectionStringSecondaryKey": { "x-ms-secret": true, @@ -1065,7 +1066,8 @@ "accessKey1": { "x-ms-secret": true, "description": "EventGrid secondary accesskey. Will be obfuscated during read.", - "type": "string" + "type": "string", + "x-nullable": true }, "accessKey2": { "x-ms-secret": true, diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json index 54e03b4dfee8..0da7c0950e3f 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json @@ -15,9 +15,9 @@ "name": "myendpoint1", "properties": { "endpointType": "ServiceBus", - "provisioningState": "Succeeded", "primaryConnectionString": "************", "secondaryConnectionString": "************", + "provisioningState": "Succeeded", "createdTime": "2019-11-19T01:10:34.350Z" } }, @@ -27,9 +27,9 @@ "name": "myendpoint2", "properties": { "endpointType": "EventHub", - "provisioningState": "Succeeded", "connectionStringPrimaryKey": "************", "connectionStringSecondaryKey": "************", + "provisioningState": "Succeeded", "createdTime": "2019-11-19T01:10:34.350Z" } } From e13a89f0a3da882cef8d684fc3854d88a55df6ec Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Mon, 31 Aug 2020 15:28:13 -0700 Subject: [PATCH 22/28] Adds suppression to readme --- specification/digitaltwins/resource-manager/readme.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/specification/digitaltwins/resource-manager/readme.md b/specification/digitaltwins/resource-manager/readme.md index 91b726e0fd47..9f6d2a49c013 100644 --- a/specification/digitaltwins/resource-manager/readme.md +++ b/specification/digitaltwins/resource-manager/readme.md @@ -133,4 +133,8 @@ directive: where: $.definitions.CheckNameResult.properties.nameAvailable from: digitaltwins.json reason: The value will always be a boolean. + - suppress: SECRET_PROPERTY + where: '$.definitions.ServiceBus.allOf["1"].properties.primaryConnectionString' + from: digitaltwins.json + reason: 'Secrets are obfuscated on GETs. E.g., "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=***". This is to allow customers to identify the namespace of the resource.' ``` From 25901f87653532154f172847ec8dcb9aac7f1380 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Mon, 31 Aug 2020 15:39:04 -0700 Subject: [PATCH 23/28] Update examples with more realistic obfuscated connection strings --- .../examples/DigitalTwinsEndpointDelete_example.json | 8 ++++---- .../examples/DigitalTwinsEndpointGet_example.json | 4 ++-- .../examples/DigitalTwinsEndpointPut_example.json | 8 ++++---- .../examples/DigitalTwinsEndpointsGet_example.json | 4 ++-- 4 files changed, 12 insertions(+), 12 deletions(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointDelete_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointDelete_example.json index 6ebf4c0dc557..55c92b479c41 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointDelete_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointDelete_example.json @@ -15,8 +15,8 @@ "properties": { "endpointType": "ServiceBus", "provisioningState": "Failed", - "primaryConnectionString": "************", - "secondaryConnectionString": "************", + "primaryConnectionString": "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=***", + "secondaryConnectionString": "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=***", "createdTime": "2019-11-19T01:10:34.350Z" } } @@ -29,8 +29,8 @@ "properties": { "endpointType": "ServiceBus", "provisioningState": "Deleting", - "primaryConnectionString": "************", - "secondaryConnectionString": "************", + "primaryConnectionString": "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=***", + "secondaryConnectionString": "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=***", "createdTime": "2019-11-19T01:10:34.350Z" } } diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointGet_example.json index 0c338747946d..800b1d510614 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointGet_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointGet_example.json @@ -15,8 +15,8 @@ "properties": { "endpointType": "ServiceBus", "provisioningState": "Succeeded", - "primaryConnectionString": "************", - "secondaryConnectionString": "************", + "primaryConnectionString": "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=***", + "secondaryConnectionString": "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=***", "createdTime": "2019-11-19T01:10:34.350Z" } } diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointPut_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointPut_example.json index 75c5314c681b..4745faf5479b 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointPut_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointPut_example.json @@ -22,8 +22,8 @@ "properties": { "endpointType": "ServiceBus", "provisioningState": "Succeeded", - "primaryConnectionString": "************", - "secondaryConnectionString": "************", + "primaryConnectionString": "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=***", + "secondaryConnectionString": "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=***", "createdTime": "2019-11-19T01:10:34.350Z" } } @@ -36,8 +36,8 @@ "properties": { "endpointType": "ServiceBus", "provisioningState": "Provisioning", - "primaryConnectionString": "************", - "secondaryConnectionString": "************", + "primaryConnectionString": "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=***", + "secondaryConnectionString": "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=***", "createdTime": "2019-11-19T01:10:34.350Z" } } diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json index 0da7c0950e3f..a7525b702cd6 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsEndpointsGet_example.json @@ -15,8 +15,8 @@ "name": "myendpoint1", "properties": { "endpointType": "ServiceBus", - "primaryConnectionString": "************", - "secondaryConnectionString": "************", + "primaryConnectionString": "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=***", + "secondaryConnectionString": "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=***", "provisioningState": "Succeeded", "createdTime": "2019-11-19T01:10:34.350Z" } From d1f5e753787f91fad383e65e15d5d796be432547 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Mon, 31 Aug 2020 15:40:58 -0700 Subject: [PATCH 24/28] Adds suppression to readme --- specification/digitaltwins/resource-manager/readme.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/specification/digitaltwins/resource-manager/readme.md b/specification/digitaltwins/resource-manager/readme.md index 9f6d2a49c013..85d802b57ec4 100644 --- a/specification/digitaltwins/resource-manager/readme.md +++ b/specification/digitaltwins/resource-manager/readme.md @@ -137,4 +137,8 @@ directive: where: '$.definitions.ServiceBus.allOf["1"].properties.primaryConnectionString' from: digitaltwins.json reason: 'Secrets are obfuscated on GETs. E.g., "Endpoint=sb://mysb.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=***". This is to allow customers to identify the namespace of the resource.' + - suppress: SECRET_PROPERTY + where: '$.definitions.ServiceBus.allOf["1"].properties.secondaryConnectionString' + from: digitaltwins.json + reason: Secrets are obfuscated on read. ``` From 7b6ddf64ac189ed1bacdac3c6502e9c90ff53d61 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Mon, 31 Aug 2020 15:44:13 -0700 Subject: [PATCH 25/28] Adds suppression to readme --- specification/digitaltwins/resource-manager/readme.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/specification/digitaltwins/resource-manager/readme.md b/specification/digitaltwins/resource-manager/readme.md index 85d802b57ec4..70a92a64c28c 100644 --- a/specification/digitaltwins/resource-manager/readme.md +++ b/specification/digitaltwins/resource-manager/readme.md @@ -141,4 +141,8 @@ directive: where: '$.definitions.ServiceBus.allOf["1"].properties.secondaryConnectionString' from: digitaltwins.json reason: Secrets are obfuscated on read. + - suppress: SECRET_PROPERTY + where: '$.definitions.EventHub.allOf["1"].properties.connectionStringPrimaryKey' + from: digitaltwins.json + reason: Secrets are obfuscated on read. ``` From d379157fede0467e6bc6399492f726181beffff3 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Mon, 31 Aug 2020 15:46:54 -0700 Subject: [PATCH 26/28] Adds suppression to readme --- specification/digitaltwins/resource-manager/readme.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/specification/digitaltwins/resource-manager/readme.md b/specification/digitaltwins/resource-manager/readme.md index 70a92a64c28c..2bd8fd23fc25 100644 --- a/specification/digitaltwins/resource-manager/readme.md +++ b/specification/digitaltwins/resource-manager/readme.md @@ -145,4 +145,8 @@ directive: where: '$.definitions.EventHub.allOf["1"].properties.connectionStringPrimaryKey' from: digitaltwins.json reason: Secrets are obfuscated on read. + - suppress: SECRET_PROPERTY + where: '$.definitions.EventHub.allOf["1"].properties.connectionStringSecondaryKey' + from: digitaltwins.json + reason: Secrets are obfuscated on read. ``` From 93c71cee7c377ed36a89d345b363dac8341e7c36 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Mon, 31 Aug 2020 16:50:05 -0700 Subject: [PATCH 27/28] Run npm prettier on changes --- .../examples/DigitalTwinsOperationsList_example.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsOperationsList_example.json b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsOperationsList_example.json index d96c0521b2cf..a7b1096490d5 100644 --- a/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsOperationsList_example.json +++ b/specification/digitaltwins/resource-manager/Microsoft.DigitalTwins/stable/2020-10-31/examples/DigitalTwinsOperationsList_example.json @@ -10,10 +10,10 @@ { "name": "Microsoft.DigitalTwins/models/read", "display": { - "provider": "Azure Digital Twins", - "resource": "Model", - "operation": "Read Model", - "description": "Read any Model" + "provider": "Azure Digital Twins", + "resource": "Model", + "operation": "Read Model", + "description": "Read any Model" }, "isDataAction": true }, From 3850f3c1de0af97710c559654163780e2bb4e322 Mon Sep 17 00:00:00 2001 From: Sebastian Herzig-Patel Date: Wed, 2 Sep 2020 12:07:45 -0700 Subject: [PATCH 28/28] Updated readmes --- .../resource-manager/readme.go.md | 12 +++++++ .../resource-manager/readme.java.md | 14 ++++++++ .../digitaltwins/resource-manager/readme.md | 5 ++- .../resource-manager/readme.python.md | 33 ++++++++++++++++++- .../resource-manager/readme.ruby.md | 12 ++++++- 5 files changed, 73 insertions(+), 3 deletions(-) diff --git a/specification/digitaltwins/resource-manager/readme.go.md b/specification/digitaltwins/resource-manager/readme.go.md index 8da406275cdd..78e8b74c463d 100644 --- a/specification/digitaltwins/resource-manager/readme.go.md +++ b/specification/digitaltwins/resource-manager/readme.go.md @@ -6,15 +6,27 @@ These settings apply only when `--go` is specified on the command line. go: license-header: MICROSOFT_APACHE_NO_VERSION clear-output-folder: true + namespace: digitaltwins ``` ### Go multi-api ``` yaml $(go) && $(multiapi) batch: + - tag: package-2020-10 - tag: package-2020-03-01-preview ``` +### Tag: package-2020-10 and go + +These settings apply only when `--tag=package-2020-10 --go` is specified on the command line. +Please also specify `--go-sdks-folder=digitaltwins`. + +```yaml $(tag) == 'package-2020-10' && $(go) +namespace: digitaltwins +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2020-10-31/$(namespace) +``` + ### Tag: package-2020-03-01-preview and go These settings apply only when `--tag=package-2020-03-01-preview --go` is specified on the command line. diff --git a/specification/digitaltwins/resource-manager/readme.java.md b/specification/digitaltwins/resource-manager/readme.java.md index 14298c23e4ee..e85c4d26fdcb 100644 --- a/specification/digitaltwins/resource-manager/readme.java.md +++ b/specification/digitaltwins/resource-manager/readme.java.md @@ -16,9 +16,23 @@ output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-digitaltwins ``` yaml $(java) && $(multiapi) batch: + - tag: package-2020-10 - tag: package-2020-03-01-preview ``` +### Tag: package-2020-10 and java + +These settings apply only when `--tag=package-2020-10 --java` is specified on the command line. +Please also specify `--azure-libraries-for-java=`. + +``` yaml $(tag) == 'package-2020-10' && $(java) && $(multiapi) +java: + namespace: com.microsoft.azure.management.digitaltwins.v2020_10_31 + output-folder: $(azure-libraries-for-java-folder)/sdk/digitaltwins/mgmt-v2020_10_31 +regenerate-manager: true +generate-interface: true +``` + ### Tag: package-2020-03-01-preview and java These settings apply only when `--tag=package-2020-03-01-preview --java` is specified on the command line. diff --git a/specification/digitaltwins/resource-manager/readme.md b/specification/digitaltwins/resource-manager/readme.md index 2bd8fd23fc25..ec6b8ab4c413 100644 --- a/specification/digitaltwins/resource-manager/readme.md +++ b/specification/digitaltwins/resource-manager/readme.md @@ -59,6 +59,8 @@ This is not used by Autorest itself. ``` yaml $(swagger-to-sdk) swagger-to-sdk: - repo: azure-sdk-for-python + after_scripts: + - python ./scripts/multiapi_init_gen.py azure-mgmt-digitaltwins - repo: azure-sdk-for-java - repo: azure-sdk-for-go - repo: azure-sdk-for-js @@ -103,12 +105,13 @@ require: $(this-folder)/../../../profiles/readme.md # all the input files across all versions input-file: + - $(this-folder)/Microsoft.DigitalTwins/stable/2020-10-31/digitaltwins.json - $(this-folder)/Microsoft.DigitalTwins/preview/2020-03-01-preview/digitaltwins.json ``` If there are files that should not be in the `all-api-versions` set, -uncomment the `exclude-file` section below and add the file paths. +uncomment the `exclude-file` section below and add the file paths. ``` yaml $(tag) == 'all-api-versions' #exclude-file: diff --git a/specification/digitaltwins/resource-manager/readme.python.md b/specification/digitaltwins/resource-manager/readme.python.md index 24e1b64ff0e7..b6ac8b85de37 100644 --- a/specification/digitaltwins/resource-manager/readme.python.md +++ b/specification/digitaltwins/resource-manager/readme.python.md @@ -10,7 +10,6 @@ python: payload-flattening-threshold: 2 namespace: azure.mgmt.digitaltwins package-name: azure-mgmt-digitaltwins - package-version: 2020-03-01-preview clear-output-folder: true ``` @@ -19,3 +18,35 @@ python: no-namespace-folders: true output-folder: $(python-sdks-folder)/digitaltwins/azure-mgmt-digitaltwins/azure/mgmt/digitaltwins ``` + +### Python multi-api + +Generate all API versions currently shipped for this package + +```yaml $(python) && $(multiapi) +batch: + - tag: package-2020-10 + - tag: package-2020-03-01-preview +``` + +### Tag: package-2020-10 and python + +These settings apply only when `--tag=package-2020-10 --python` is specified on the command line. +Please also specify `--python-sdks-folder=`. + +``` yaml $(tag) == 'package-2020-10' && $(python) +python: + namespace: azure.mgmt.digitaltwins.v2020_10_31 + output-folder: $(python-sdks-folder)/digitaltwins/azure-mgmt-digitaltwins/azure/mgmt/digitaltwins/v2020_10_31_preview +``` + +### Tag: package-2020-03-01-preview and python + +These settings apply only when `--tag=package-2020-03-01-preview --python` is specified on the command line. +Please also specify `--python-sdks-folder=`. + +``` yaml $(tag) == 'package-2020-03-01-preview' && $(python) +python: + namespace: azure.mgmt.digitaltwins.v2020_03_01_preview + output-folder: $(python-sdks-folder)/digitaltwins/azure-mgmt-digitaltwins/azure/mgmt/digitaltwins/v2020_03_01_preview +``` diff --git a/specification/digitaltwins/resource-manager/readme.ruby.md b/specification/digitaltwins/resource-manager/readme.ruby.md index 31f23b70c07d..ea228f0d9175 100644 --- a/specification/digitaltwins/resource-manager/readme.ruby.md +++ b/specification/digitaltwins/resource-manager/readme.ruby.md @@ -4,10 +4,20 @@ These settings apply only when `--ruby` is specified on the command line. ```yaml package-name: azure_mgmt_digitaltwins -package-version: 2020-03-01-preview +package-version: 2020-10-31 azure-arm: true ``` +### Tag: package-2020-10 and ruby + +These settings apply only when `--tag=package-2020-10 --ruby` is specified on the command line. +Please also specify `--ruby-sdks-folder=`. + +```yaml $(tag) == 'package-2020-10' && $(ruby) +namespace: Microsoft.DigitalTwins +output-folder: $(ruby-sdks-folder)/digitaltwins +``` + ### Tag: package-2020-03-01-preview and ruby These settings apply only when `--tag=package-2020-03-01-preview --ruby` is specified on the command line.