Microsoft.MachineLearningServices workspaces/onlineEndpoints 2021-03-01-preview

Bicep resource definition

The workspaces/onlineEndpoints resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.MachineLearningServices/workspaces/onlineEndpoints resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/onlineEndpoints@2021-03-01-preview' = {
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    authMode: 'string'
    description: 'string'
    keys: {
      primaryKey: 'string'
      secondaryKey: 'string'
    }
    properties: {
      {customized property}: 'string'
    }
    target: 'string'
    traffic: {
      {customized property}: int
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Property values

EndpointAuthKeys

Name Description Value
primaryKey The primary key. string
secondaryKey The secondary key. string

Microsoft.MachineLearningServices/workspaces/onlineEndpoints

Name Description Value
identity Service identity associated with a resource. ResourceIdentity
kind Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type. string
location The geo-location where the resource lives string (required)
name The resource name string

Constraints:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$ (required)
parent In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource.

For more information, see Child resource outside parent resource.
Symbolic name for resource of type: workspaces
properties [Required] Additional attributes of the entity. OnlineEndpoint (required)
tags Resource tags Dictionary of tag names and values. See Tags in templates

OnlineEndpoint

Name Description Value
authMode [Required] Inference endpoint authentication mode type 'AADToken'
'AMLToken'
'Key' (required)
description Description of the inference endpoint. string
keys EndpointAuthKeys to set initially on an Endpoint.
This property will always be returned as null. AuthKey values must be retrieved using the ListKeys API.
EndpointAuthKeys
properties Property dictionary. Properties can be added, but not removed or altered. OnlineEndpointProperties
target ARM resource ID of the compute if it exists.
optional
string
traffic Traffic rules on how the traffic will be routed across deployments. OnlineEndpointTraffic

OnlineEndpointProperties

Name Description Value

OnlineEndpointTraffic

Name Description Value

ResourceIdentity

Name Description Value
type Defines values for a ResourceIdentity's type. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Dictionary of the user assigned identities, key is ARM resource ID of the UAI. ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Value

TrackedResourceTags

Name Description Value

UserAssignedIdentityMeta

Name Description Value
clientId Aka application ID, a unique identifier generated by Azure AD that is tied to an application and service principal during its initial provisioning. string
principalId The object ID of the service principal object for your managed identity that is used to grant role-based access to an Azure resource. string

ARM template resource definition

The workspaces/onlineEndpoints resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.MachineLearningServices/workspaces/onlineEndpoints resource, add the following JSON to your template.

{
  "type": "Microsoft.MachineLearningServices/workspaces/onlineEndpoints",
  "apiVersion": "2021-03-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "authMode": "string",
    "description": "string",
    "keys": {
      "primaryKey": "string",
      "secondaryKey": "string"
    },
    "properties": {
      "{customized property}": "string"
    },
    "target": "string",
    "traffic": {
      "{customized property}": "int"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Property values

EndpointAuthKeys

Name Description Value
primaryKey The primary key. string
secondaryKey The secondary key. string

Microsoft.MachineLearningServices/workspaces/onlineEndpoints

Name Description Value
apiVersion The api version '2021-03-01-preview'
identity Service identity associated with a resource. ResourceIdentity
kind Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type. string
location The geo-location where the resource lives string (required)
name The resource name string

Constraints:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$ (required)
properties [Required] Additional attributes of the entity. OnlineEndpoint (required)
tags Resource tags Dictionary of tag names and values. See Tags in templates
type The resource type 'Microsoft.MachineLearningServices/workspaces/onlineEndpoints'

OnlineEndpoint

Name Description Value
authMode [Required] Inference endpoint authentication mode type 'AADToken'
'AMLToken'
'Key' (required)
description Description of the inference endpoint. string
keys EndpointAuthKeys to set initially on an Endpoint.
This property will always be returned as null. AuthKey values must be retrieved using the ListKeys API.
EndpointAuthKeys
properties Property dictionary. Properties can be added, but not removed or altered. OnlineEndpointProperties
target ARM resource ID of the compute if it exists.
optional
string
traffic Traffic rules on how the traffic will be routed across deployments. OnlineEndpointTraffic

OnlineEndpointProperties

Name Description Value

OnlineEndpointTraffic

Name Description Value

ResourceIdentity

Name Description Value
type Defines values for a ResourceIdentity's type. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Dictionary of the user assigned identities, key is ARM resource ID of the UAI. ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Value

TrackedResourceTags

Name Description Value

UserAssignedIdentityMeta

Name Description Value
clientId Aka application ID, a unique identifier generated by Azure AD that is tied to an application and service principal during its initial provisioning. string
principalId The object ID of the service principal object for your managed identity that is used to grant role-based access to an Azure resource. string

Terraform (AzAPI provider) resource definition

The workspaces/onlineEndpoints resource type can be deployed with operations that target:

  • Resource groups

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.MachineLearningServices/workspaces/onlineEndpoints resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces/onlineEndpoints@2021-03-01-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
        clientId = "string"
        principalId = "string"
      }
    }
  }
  kind = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      authMode = "string"
      description = "string"
      keys = {
        primaryKey = "string"
        secondaryKey = "string"
      }
      properties = {
        {customized property} = "string"
      }
      target = "string"
      traffic = {
        {customized property} = int
      }
    }
  })
}

Property values

EndpointAuthKeys

Name Description Value
primaryKey The primary key. string
secondaryKey The secondary key. string

Microsoft.MachineLearningServices/workspaces/onlineEndpoints

Name Description Value
identity Service identity associated with a resource. ResourceIdentity
kind Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type. string
location The geo-location where the resource lives string (required)
name The resource name string

Constraints:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$ (required)
parent_id The ID of the resource that is the parent for this resource. ID for resource of type: workspaces
properties [Required] Additional attributes of the entity. OnlineEndpoint (required)
tags Resource tags Dictionary of tag names and values.
type The resource type "Microsoft.MachineLearningServices/workspaces/onlineEndpoints@2021-03-01-preview"

OnlineEndpoint

Name Description Value
authMode [Required] Inference endpoint authentication mode type 'AADToken'
'AMLToken'
'Key' (required)
description Description of the inference endpoint. string
keys EndpointAuthKeys to set initially on an Endpoint.
This property will always be returned as null. AuthKey values must be retrieved using the ListKeys API.
EndpointAuthKeys
properties Property dictionary. Properties can be added, but not removed or altered. OnlineEndpointProperties
target ARM resource ID of the compute if it exists.
optional
string
traffic Traffic rules on how the traffic will be routed across deployments. OnlineEndpointTraffic

OnlineEndpointProperties

Name Description Value

OnlineEndpointTraffic

Name Description Value

ResourceIdentity

Name Description Value
type Defines values for a ResourceIdentity's type. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Dictionary of the user assigned identities, key is ARM resource ID of the UAI. ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Value

TrackedResourceTags

Name Description Value

UserAssignedIdentityMeta

Name Description Value
clientId Aka application ID, a unique identifier generated by Azure AD that is tied to an application and service principal during its initial provisioning. string
principalId The object ID of the service principal object for your managed identity that is used to grant role-based access to an Azure resource. string