Skip to content

Commit

Permalink
[Hub Generated] Review request for Microsoft.Media to add version pre…
Browse files Browse the repository at this point in the history 
…view/2021-11-01-preview (#16089)

* Adds base for updating Microsoft.Media from version preview/2021-05-01-preview to version 2021-11-01-preview

* Updates readme

* Updates API version in new specs and examples

* Update to use 2021-11-01 version of the swaggers and examples

* Remove unused examples and fix prettier errors.

* fix patch  where required is empty.

* fix some lint errors

* fix a json parse issue.

* fix enum casing

* fix missing 204 on endpointconnections delete

* create entities for Patch operation

* updating descriptions

* fixed a bad commit.

* fix validation errors

* fix few more validation issues.

* fix sample validaitons

* fix examples

* Update PrivateEndpoints to use v3 version of commonTypes to use systemData

* change all commontypes to v3

* add long running operation to operations

* update missing descriptions

* fix a parameter name to operationId

* Update few more descriptions

* adding supressions for few failed validations

* fix suppreesions

* add few more descriptions
  • Loading branch information
@giakas
giakas authored Sep 30, 2021
1 parent 8117acc commit c481083
Show file tree
Hide file tree
Showing 61 changed files with 10,347 additions and 3 deletions.
380 changes: 380 additions & 0 deletions ...ideoanalyzer/resource-manager/Microsoft.Media/preview/2021-11-01-preview/EdgeModules.json
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,380 @@
{
"schemes": [
"https"
],
"swagger": "2.0",
"info": {
"title": "Azure Video Analyzer Resource Provider",
"description": "Azure Video Analyzer resource provider API definition.",
"version": "2021-11-01-preview"
},
"host": "management.azure.com",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"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"
}
}
},
"definitions": {
"EdgeModuleProperties": {
"properties": {
"edgeModuleId": {
"type": "string",
"format": "uuid",
"description": "Internal ID generated for the instance of the Video Analyzer edge module.",
"readOnly": true,
"x-nullable": false
}
},
"type": "object",
"description": "Application level properties for the edge module resource."
},
"ListProvisioningTokenInput": {
"properties": {
"expirationDate": {
"type": "string",
"format": "date-time",
"description": "The desired expiration date of the registration token. The Azure Video Analyzer IoT edge module must be initialized and connected to the Internet prior to the token expiration date."
}
},
"type": "object",
"required": [
"expirationDate"
],
"description": "The input parameters to generate registration token for the Azure Video Analyzer IoT edge module."
},
"EdgeModuleProvisioningToken": {
"properties": {
"expirationDate": {
"type": "string",
"format": "date-time",
"description": "The expiration date of the registration token. The Azure Video Analyzer IoT edge module must be initialized and connected to the Internet prior to the token expiration date.",
"readOnly": true,
"x-nullable": false
},
"token": {
"type": "string",
"description": "The token blob to be provided to the Azure Video Analyzer IoT edge module through the Azure IoT Edge module twin properties.",
"readOnly": true
}
},
"type": "object",
"description": "Provisioning token properties. A provisioning token allows for a single instance of Azure Video analyzer IoT edge module to be initialized and authorized to the cloud account. The provisioning token itself is short lived and it is only used for the initial handshake between IoT edge module and the cloud. After the initial handshake, the IoT edge module will agree on a set of authentication keys which will be auto-rotated as long as the module is able to periodically connect to the cloud. A new provisioning token can be generated for the same IoT edge module in case the module state lost or reset."
},
"EdgeModuleEntity": {
"allOf": [
{
"$ref": "../../../../../common-types/resource-management/v3/types.json#/definitions/ProxyResource"
}
],
"properties": {
"properties": {
"$ref": "#/definitions/EdgeModuleProperties",
"description": "The resource properties.",
"x-ms-client-flatten": true
}
},
"type": "object",
"description": "The representation of an edge module."
},
"EdgeModuleEntityCollection": {
"properties": {
"value": {
"type": "array",
"items": {
"$ref": "#/definitions/EdgeModuleEntity"
},
"description": "A collection of EdgeModuleEntity items."
},
"@nextLink": {
"type": "string",
"description": "A link to the next page of the collection (when the collection contains too many results to return in one response)."
}
},
"type": "object",
"description": "A collection of EdgeModuleEntity items."
}
},
"paths": {
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/edgeModules": {
"get": {
"summary": "List all existing edge module resources.",
"description": "List all existing edge module resources, along with their JSON representations.",
"operationId": "EdgeModules_List",
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/EdgeModuleEntityCollection"
}
},
"default": {
"description": "Detailed error information.",
"schema": {
"$ref": "../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse"
}
}
},
"parameters": [
{
"$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter"
},
{
"$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter"
},
{
"$ref": "#/parameters/AzureVideoAnalyzerAccountName"
},
{
"$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter"
},
{
"name": "$top",
"in": "query",
"required": false,
"type": "integer",
"format": "int32",
"description": "Specifies a non-negative integer n that limits the number of items returned from a collection. The service returns the number of available items up to but not greater than the specified value n."
}
],
"x-ms-pageable": {
"nextLinkName": "@nextLink"
},
"x-ms-examples": {
"Lists the registered edge modules.": {
"$ref": "examples/edge-modules-list.json"
}
}
}
},
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/edgeModules/{edgeModuleName}": {
"get": {
"summary": "Retrieves an existing edge module resource.",
"description": "Retrieves an existing edge module resource with the given name.",
"operationId": "EdgeModules_Get",
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/EdgeModuleEntity"
}
},
"default": {
"description": "Detailed error information.",
"schema": {
"$ref": "../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse"
}
}
},
"parameters": [
{
"$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter"
},
{
"$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter"
},
{
"$ref": "#/parameters/AzureVideoAnalyzerAccountName"
},
{
"name": "edgeModuleName",
"in": "path",
"required": true,
"type": "string",
"description": "The Edge Module name."
},
{
"$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter"
}
],
"x-ms-examples": {
"Gets edge module registration.": {
"$ref": "examples/edge-modules-get.json"
}
}
},
"put": {
"summary": "Creates a new edge module or updates an existing one.",
"description": "Creates a new edge module or updates an existing one. An edge module resource enables a single instance of an Azure Video Analyzer IoT edge module to interact with the Video Analyzer Account. This is used for authorization and also to make sure that the particular edge module instance only has access to the data it requires from the Azure Video Analyzer service. A new edge module resource should be created for every new instance of an Azure Video Analyzer edge module deployed to you Azure IoT edge environment. Edge module resources can be deleted if the specific module is not in use anymore.",
"operationId": "EdgeModules_CreateOrUpdate",
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/EdgeModuleEntity"
}
},
"201": {
"description": "Created",
"schema": {
"$ref": "#/definitions/EdgeModuleEntity"
}
},
"default": {
"description": "Detailed error information.",
"schema": {
"$ref": "../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse"
}
}
},
"parameters": [
{
"$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter"
},
{
"$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter"
},
{
"$ref": "#/parameters/AzureVideoAnalyzerAccountName"
},
{
"name": "edgeModuleName",
"in": "path",
"required": true,
"type": "string",
"description": "The Edge Module name."
},
{
"name": "parameters",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/EdgeModuleEntity"
},
"description": "The request parameters"
},
{
"$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter"
}
],
"x-ms-examples": {
"Registers an edge module.": {
"$ref": "examples/edge-modules-create.json"
}
}
},
"delete": {
"summary": "Deletes an existing edge module resource.",
"description": "Deletes an existing edge module resource. Deleting the edge module resource will prevent an Azure Video Analyzer IoT edge module which was previously initiated with the module provisioning token from communicating with the cloud.",
"operationId": "EdgeModules_Delete",
"responses": {
"200": {
"description": "OK"
},
"204": {
"description": "NoContent"
},
"default": {
"description": "Detailed error information.",
"schema": {
"$ref": "../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse"
}
}
},
"parameters": [
{
"$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter"
},
{
"$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter"
},
{
"$ref": "#/parameters/AzureVideoAnalyzerAccountName"
},
{
"name": "edgeModuleName",
"in": "path",
"required": true,
"type": "string",
"description": "The Edge Module name."
},
{
"$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter"
}
],
"x-ms-examples": {
"Deletes an edge module registration.": {
"$ref": "examples/edge-modules-delete.json"
}
}
}
},
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/edgeModules/{edgeModuleName}/listProvisioningToken": {
"post": {
"summary": "Creates a new provisioning token.",
"description": "Creates a new provisioning token. A provisioning token allows for a single instance of Azure Video analyzer IoT edge module to be initialized and authorized to the cloud account. The provisioning token itself is short lived and it is only used for the initial handshake between IoT edge module and the cloud. After the initial handshake, the IoT edge module will agree on a set of authentication keys which will be auto-rotated as long as the module is able to periodically connect to the cloud. A new provisioning token can be generated for the same IoT edge module in case the module state lost or reset.",
"operationId": "EdgeModules_ListProvisioningToken",
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/EdgeModuleProvisioningToken"
}
},
"default": {
"description": "Detailed error information.",
"schema": {
"$ref": "../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse"
}
}
},
"parameters": [
{
"$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter"
},
{
"$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter"
},
{
"$ref": "#/parameters/AzureVideoAnalyzerAccountName"
},
{
"name": "edgeModuleName",
"in": "path",
"required": true,
"type": "string",
"description": "The Edge Module name."
},
{
"name": "parameters",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/ListProvisioningTokenInput"
},
"description": "The request parameters"
},
{
"$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter"
}
],
"x-ms-examples": {
"Generate the Provisioning token for an edge module registration.": {
"$ref": "examples/edge-modules-listProvisioningToken.json"
}
}
}
}
},
"parameters": {
"AzureVideoAnalyzerAccountName": {
"name": "accountName",
"in": "path",
"required": true,
"type": "string",
"description": "The Azure Video Analyzer account name.",
"x-ms-parameter-location": "method"
}
}
}
Loading

0 comments on commit c481083

Please sign in to comment.