Afficher en anglais

Partage via

Microsoft.MachineLearning webServices 2017-01-01

  • Article
Choisir une langue de déploiement

Définition de ressource Bicep

Le type de ressource webServices peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.MachineLearning/webServices, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.MachineLearning/webServices@2017-01-01' = {
  location: 'string'
  name: 'string'
  properties: {
    assets: {
      {customized property}: {
        id: 'string'
        inputPorts: {
          {customized property}: {
            type: 'string'
          }
        }
        locationInfo: {
          credentials: 'string'
          uri: 'string'
        }
        metadata: {
          {customized property}: 'string'
        }
        name: 'string'
        outputPorts: {
          {customized property}: {
            type: 'string'
          }
        }
        parameters: [
          {
            modeValuesInfo: {
              {customized property}: {
                interfaceString: 'string'
                parameters: [
                  ...
                ]
              }
            }
            name: 'string'
            parameterType: 'string'
          }
        ]
        type: 'string'
      }
    }
    commitmentPlan: {
      id: 'string'
    }
    description: 'string'
    diagnostics: {
      expiry: 'string'
      level: 'string'
    }
    exampleRequest: {
      globalParameters: {
        {customized property}: any(...)
      }
      inputs: {
        {customized property}: [
          [
            any(...)
          ]
        ]
      }
    }
    exposeSampleData: bool
    input: {
      description: 'string'
      properties: {
        {customized property}: {
          description: 'string'
          format: 'string'
          properties: {
            {customized property}: {
              enum: [
                any(...)
              ]
              format: 'string'
              type: 'string'
              x-ms-isnullable: bool
              x-ms-isordered: bool
            }
          }
          title: 'string'
          type: 'string'
        }
      }
      title: 'string'
      type: 'string'
    }
    keys: {
      primary: 'string'
      secondary: 'string'
    }
    machineLearningWorkspace: {
      id: 'string'
    }
    output: {
      description: 'string'
      properties: {
        {customized property}: {
          description: 'string'
          format: 'string'
          properties: {
            {customized property}: {
              enum: [
                any(...)
              ]
              format: 'string'
              type: 'string'
              x-ms-isnullable: bool
              x-ms-isordered: bool
            }
          }
          title: 'string'
          type: 'string'
        }
      }
      title: 'string'
      type: 'string'
    }
    parameters: {
      {customized property}: {
        certificateThumbprint: 'string'
        value: any(...)
      }
    }
    payloadsInBlobStorage: bool
    payloadsLocation: {
      credentials: 'string'
      uri: 'string'
    }
    readOnly: bool
    realtimeConfiguration: {
      maxConcurrentCalls: int
    }
    storageAccount: {
      key: 'string'
      name: 'string'
    }
    title: 'string'
    packageType: 'string'
    // For remaining properties, see WebServiceProperties objects
  }
  tags: {
    {customized property}: 'string'
  }
}

Objets WebServiceProperties

Définissez la propriété packageType pour spécifier le type d’objet.

Pour Graph, utilisez :

{
  package: {
    edges: [
      {
        sourceNodeId: 'string'
        sourcePortId: 'string'
        targetNodeId: 'string'
        targetPortId: 'string'
      }
    ]
    graphParameters: {
      {customized property}: {
        description: 'string'
        links: [
          {
            nodeId: 'string'
            parameterKey: 'string'
          }
        ]
        type: 'string'
      }
    }
    nodes: {
      {customized property}: {
        assetId: 'string'
        inputId: 'string'
        outputId: 'string'
        parameters: {
          {customized property}: {
            certificateThumbprint: 'string'
            value: any(...)
          }
        }
      }
    }
  }
  packageType: 'Graph'
}

Valeurs de propriété

AssetItem

Nom Description Valeur
id ID de la ressource. corde
inputPorts Informations sur les ports d’entrée de la ressource. AssetItemInputPorts
locationInfo Informations d’accès pour la ressource. BlobLocation (obligatoire)
métadonnées Si la ressource est un module personnalisé, elle contient les métadonnées du module. AssetItemMetadata
nom Nom convivial de la ressource. chaîne (obligatoire)
outputPorts Informations sur les ports de sortie de la ressource. AssetItemOutputPorts
Paramètres Si la ressource est un module personnalisé, cela contient les paramètres du module. ModuleAssetParameter[]
type Type de ressource. 'Module'
'Resource' (obligatoire)

AssetItemInputPorts

Nom Description Valeur

AssetItemMetadata

Nom Description Valeur

AssetItemOutputPorts

Nom Description Valeur

BlobLocation

Nom Description Valeur
Pouvoirs Accéder aux informations d’identification de l’objet blob, le cas échéant (par exemple, blob spécifié par la chaîne de connexion du compte de stockage + URI d’objet blob) corde
URI URI à partir duquel l’objet blob est accessible. Par exemple, aml://abc pour les ressources système ou les https://xyz pour les ressources utilisateur ou la charge utile. chaîne (obligatoire)

ColumnSpecification

Nom Description Valeur
énumération Si le type de données est catégoriel, il fournit la liste des catégories acceptées. any[]
format Informations de format supplémentaires pour le type de données. 'Byte'
'Char'
'Complex128'
'Complex64'
'Date-heure'
'Date-timeOffset'
'Double'
'Duration'
'Float'
'Int16'
'Int32'
'Int64'
'Int8'
'Uint16'
'Uint32'
'Uint64'
'Uint8'
type Type de données de la colonne. 'Boolean'
'Integer'
'Number'
'String' (obligatoire)
x-ms-isnullable Indicateur indiquant si le type prend en charge les valeurs Null ou non. Bool
x-ms-isordered Indicateur indiquant si les catégories sont traitées comme un ensemble ordonné ou non, s’il s’agit d’une colonne catégorielle. Bool

Plan d’engagement

Nom Description Valeur
id Spécifie l’ID Azure Resource Manager du plan d’engagement associé au service web. chaîne (obligatoire)

DiagnosticsConfiguration

Nom Description Valeur
expiration Spécifie la date et l’heure à laquelle la journalisation cessera. Si la valeur est Null, la collecte de diagnostics n’est pas limitée au temps. corde
niveau Spécifie la détail de la sortie de diagnostic. Les valeurs valides sont : Aucun - désactive le suivi ; Erreur : collecte uniquement les traces d’erreur (stderr) ; All : collecte toutes les traces (stdout et stderr). 'All'
'Erreur'
'None' (obligatoire)

ExampleRequest

Nom Description Valeur
globalParameters Exemples de données d’entrée pour les paramètres globaux du service web ExampleRequestGlobalParameters
Entrées Exemples de données d’entrée pour les entrées du service web données sous la forme d’un nom d’entrée pour l’exemple de mappage de matrice de valeurs d’entrée. ExampleRequestInputs

ExampleRequestGlobalParameters

Nom Description Valeur

ExampleRequestInputs

Nom Description Valeur

GraphEdge

Nom Description Valeur
sourceNodeId Identificateur du nœud de graphe source. corde
sourcePortId Identificateur du port du nœud source à partir duquel se connecte le bord. corde
targetNodeId Identificateur du nœud de graphique de destination. corde
targetPortId Identificateur du port du nœud de destination auquel se connecte le bord. corde

GraphNode

Nom Description Valeur
assetId ID de la ressource représentée par ce nœud. corde
inputId ID de l’élément d’entrée représenté par ce nœud. corde
outputId ID de l’élément de sortie représenté par ce nœud. corde
Paramètres Le cas échéant, les paramètres du nœud. Les paramètres de graphe globaux sont mappés dans ces paramètres, avec des valeurs définies au moment de l’exécution. GraphNodeParameters

GraphNodeParameters

Nom Description Valeur

GraphPackage

Nom Description Valeur
Bords Liste des arêtes qui composent le graphique. GraphEdge []
graphParameters Collection de paramètres globaux pour le graphe, donné sous la forme d’un nom de paramètre global à la carte GraphParameter. Chaque paramètre a ici une correspondance 1:1 avec la carte des valeurs de paramètres globaux déclarée au niveau webServiceProperties. GraphPackageGraphParameters
Nœuds Ensemble de nœuds composant le graphe, fourni en tant que nodeId à la carte GraphNode GraphPackageNodes

GraphPackageGraphParameters

Nom Description Valeur

GraphPackageNodes

Nom Description Valeur

GraphParameter

Nom Description Valeur
description Description de ce paramètre de graphe. corde
Liens Liens d’association pour ce paramètre aux nœuds du graphique. GraphParameterLink[] (obligatoire)
type Type du paramètre Graph. 'Boolean'
'ColumnPicker'
'Credential'
'DataGatewayName'
'Double'
'Énuméré'
'Float'
'Int'
'Mode'
'ParameterRange'
'Script'
'String' (obligatoire)
Nom Description Valeur
nodeId Identificateur du nœud de graphe chaîne (obligatoire)
parameterKey Identificateur du paramètre de nœud auquel le paramètre global est mappé. chaîne (obligatoire)

InputPort

Nom Description Valeur
type Type de données de port. 'Dataset'

MachineLearningWorkspace

Nom Description Valeur
id Spécifie l’ID d’espace de travail de l’espace de travail Machine Learning associé au service web chaîne (obligatoire)

Microsoft.MachineLearning/webServices

Nom Description Valeur
emplacement Spécifie l’emplacement de la ressource. chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
Propriétés Contient la charge utile de propriété qui décrit le service web. WebServiceProperties (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

ModeValueInfo

Nom Description Valeur
interfaceString Nom de la chaîne d’interface pour le paramètre imbriqué. corde
Paramètres Définition du paramètre. ModuleAssetParameter[]

ModuleAssetParameter

Nom Description Valeur
modeValuesInfo Définitions des paramètres d’interface imbriqués s’il s’agit d’un paramètre de module complexe. ModuleAssetParameterModeValuesInfo
nom Nom du paramètre. corde
parameterType Type de paramètre. corde

ModuleAssetParameterModeValuesInfo

Nom Description Valeur

OutputPort

Nom Description Valeur
type Type de données de port. 'Dataset'

RealtimeConfiguration

Nom Description Valeur
maxConcurrentCalls Spécifie le nombre maximal d’appels simultanés qui peuvent être effectués au service web. Valeur minimale : 4, valeur maximale : 200. Int

Contraintes:
Valeur minimale = 4
Valeur maximale = 200

ResourceTags

Nom Description Valeur

ServiceInputOutputSpecification

Nom Description Valeur
description Description du schéma Swagger. corde
Propriétés Spécifie une collection qui contient le schéma de colonne pour chaque entrée ou sortie du service web. Pour plus d’informations, consultez la spécification Swagger. ServiceInputOutputSpecificationProperties (obligatoire)
titre Titre de votre schéma Swagger. corde
type Type de l’entité décrite dans swagger. Toujours 'object'. chaîne (obligatoire)

ServiceInputOutputSpecificationProperties

Nom Description Valeur

StorageAccount

Nom Description Valeur
clé Spécifie la clé utilisée pour accéder au compte de stockage. corde
nom Spécifie le nom du compte de stockage. corde

TableSpecification

Nom Description Valeur
description Description du schéma Swagger. corde
format Format, si 'type' n’est pas 'object' corde
Propriétés Jeu de colonnes dans la table de données. TableSpecificationProperties
titre Titre du schéma Swagger. corde
type Type de l’entité décrite dans swagger. chaîne (obligatoire)

TableSpecificationProperties

Nom Description Valeur

WebServiceKeys

Nom Description Valeur
primaire Clé d’accès primaire. corde
secondaire Clé d’accès secondaire. corde

WebServiceParameter

Nom Description Valeur
certificateThumbprint Si la valeur du paramètre dans le champ « valeur » est chiffrée, l’empreinte numérique du certificat doit être placée ici. corde
valeur Valeur du paramètre quelconque

WebServiceProperties

Nom Description Valeur
actif Contient des propriétés définies par l’utilisateur décrivant les ressources du service web. Les propriétés sont exprimées sous forme de paires Clé/Valeur. WebServicePropertiesAssets
commitmentPlan Contient le plan d’engagement associé à ce service web. Définir au moment de la création. Une fois définie, cette valeur ne peut pas être modifiée. Remarque : Le plan d’engagement n’est pas retourné par les appels aux opérations GET. CommitmentPlan
description Description du service web. corde
diagnostic Paramètres contrôlant la collection de traces de diagnostics pour le service web. DiagnosticsConfiguration
exampleRequest Définit des exemples de données d’entrée pour une ou plusieurs entrées du service. ExampleRequest
exposeSampleData Lorsque la valeur est true, les exemples de données sont inclus dans la définition swagger du service web. La valeur par défaut est true. Bool
entrée Contient le schéma Swagger 2.0 décrivant une ou plusieurs entrées du service web. Pour plus d’informations, consultez la spécification Swagger. ServiceInputOutputSpecification
Clés Contient les clés d’approvisionnement du service web. Si vous ne spécifiez pas de clés d’approvisionnement, le système Azure Machine Learning les génère pour vous. Remarque : les clés ne sont pas retournées à partir d’appels aux opérations GET. WebServiceKeys
machineLearningWorkspace Spécifie l’espace de travail Machine Learning contenant l’expérience source du service web. MachineLearningWorkspace
sortie Contient le schéma Swagger 2.0 décrivant une ou plusieurs sorties du service web. Pour plus d’informations, consultez la spécification Swagger. ServiceInputOutputSpecification
packageType Défini sur « Graph » pour le type WebServicePropertiesForGraph. 'Graph' (obligatoire)
Paramètres Ensemble de valeurs de paramètres globaux définies pour le service web, étant donné qu’un nom de paramètre global est mappé par défaut. Si aucune valeur par défaut n’est spécifiée, le paramètre est considéré comme obligatoire. WebServicePropertiesParameters
payloadsInBlobStorage Lorsque la valeur est true, indique que la taille de la charge utile est supérieure à 3 Mo. Sinon, false. Si la taille de la charge utile dépasse 3 Mo, la charge utile est stockée dans un objet blob et le paramètre PayloadsLocation contient l’URI de l’objet blob. Sinon, cette valeur est définie sur false et Assets, Input, Output, Package, Parameters, ExampleRequest sont inline. Les tailles de charge utile sont déterminées en ajoutant la taille des ressources, des entrées, des sorties, du package, des paramètres et de l’exempleRequest. Bool
payloadsLocation URI de l’objet blob de charge utile. Ce paramètre contient une valeur uniquement si le paramètre payloadsInBlobStorage a la valeur true. Sinon, la valeur null est définie. BlobLocation
readOnly Lorsque la valeur est true, indique que le service web est en lecture seule et ne peut plus être mis à jour ou corrigé, supprimé uniquement. La valeur par défaut est false. Remarque : Une fois défini sur true, vous ne pouvez pas modifier sa valeur. Bool
realtimeConfiguration Contient les paramètres de configuration du point de terminaison du service web. RealtimeConfiguration
storageAccount Spécifie le compte de stockage qu’Azure Machine Learning utilise pour stocker des informations sur le service web. Seul le nom du compte de stockage est retourné par les appels aux opérations GET. Lors de la mise à jour des informations du compte de stockage, vous devez vous assurer que toutes les ressources nécessaires sont disponibles dans le nouveau compte de stockage ou que les appels à votre service web échouent. StorageAccount
titre Titre du service web. corde

WebServicePropertiesAssets

Nom Description Valeur

WebServicePropertiesForGraph

Nom Description Valeur
colis Définition du package de graphe qui compose ce service web. GraphPackage
packageType Spécifie le type de package. Les valeurs valides sont Graph (Spécifie un service web publié via Machine Learning Studio) et Code (spécifie un service web publié à l’aide de code tel que Python). Remarque : Le code n’est pas pris en charge pour l’instant. 'Graph' (obligatoire)

WebServicePropertiesParameters

Nom Description Valeur

Définition de ressource de modèle ARM

Le type de ressource webServices peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.MachineLearning/webServices, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.MachineLearning/webServices",
  "apiVersion": "2017-01-01",
  "name": "string",
  "location": "string",
  "properties": {
    "assets": {
      "{customized property}": {
        "id": "string",
        "inputPorts": {
          "{customized property}": {
            "type": "string"
          }
        },
        "locationInfo": {
          "credentials": "string",
          "uri": "string"
        },
        "metadata": {
          "{customized property}": "string"
        },
        "name": "string",
        "outputPorts": {
          "{customized property}": {
            "type": "string"
          }
        },
        "parameters": [
          {
            "modeValuesInfo": {
              "{customized property}": {
                "interfaceString": "string",
                "parameters": [
                  ...
                ]
              }
            },
            "name": "string",
            "parameterType": "string"
          }
        ],
        "type": "string"
      }
    },
    "commitmentPlan": {
      "id": "string"
    },
    "description": "string",
    "diagnostics": {
      "expiry": "string",
      "level": "string"
    },
    "exampleRequest": {
      "globalParameters": {
        "{customized property}": {}
      },
      "inputs": {
        "{customized property}": [
          [ {} ]
        ]
      }
    },
    "exposeSampleData": "bool",
    "input": {
      "description": "string",
      "properties": {
        "{customized property}": {
          "description": "string",
          "format": "string",
          "properties": {
            "{customized property}": {
              "enum": [ {} ],
              "format": "string",
              "type": "string",
              "x-ms-isnullable": "bool",
              "x-ms-isordered": "bool"
            }
          },
          "title": "string",
          "type": "string"
        }
      },
      "title": "string",
      "type": "string"
    },
    "keys": {
      "primary": "string",
      "secondary": "string"
    },
    "machineLearningWorkspace": {
      "id": "string"
    },
    "output": {
      "description": "string",
      "properties": {
        "{customized property}": {
          "description": "string",
          "format": "string",
          "properties": {
            "{customized property}": {
              "enum": [ {} ],
              "format": "string",
              "type": "string",
              "x-ms-isnullable": "bool",
              "x-ms-isordered": "bool"
            }
          },
          "title": "string",
          "type": "string"
        }
      },
      "title": "string",
      "type": "string"
    },
    "parameters": {
      "{customized property}": {
        "certificateThumbprint": "string",
        "value": {}
      }
    },
    "payloadsInBlobStorage": "bool",
    "payloadsLocation": {
      "credentials": "string",
      "uri": "string"
    },
    "readOnly": "bool",
    "realtimeConfiguration": {
      "maxConcurrentCalls": "int"
    },
    "storageAccount": {
      "key": "string",
      "name": "string"
    },
    "title": "string",
    "packageType": "string"
    // For remaining properties, see WebServiceProperties objects
  },
  "tags": {
    "{customized property}": "string"
  }
}

Objets WebServiceProperties

Définissez la propriété packageType pour spécifier le type d’objet.

Pour Graph, utilisez :

{
  "package": {
    "edges": [
      {
        "sourceNodeId": "string",
        "sourcePortId": "string",
        "targetNodeId": "string",
        "targetPortId": "string"
      }
    ],
    "graphParameters": {
      "{customized property}": {
        "description": "string",
        "links": [
          {
            "nodeId": "string",
            "parameterKey": "string"
          }
        ],
        "type": "string"
      }
    },
    "nodes": {
      "{customized property}": {
        "assetId": "string",
        "inputId": "string",
        "outputId": "string",
        "parameters": {
          "{customized property}": {
            "certificateThumbprint": "string",
            "value": {}
          }
        }
      }
    }
  },
  "packageType": "Graph"
}

Valeurs de propriété

AssetItem

Nom Description Valeur
id ID de la ressource. corde
inputPorts Informations sur les ports d’entrée de la ressource. AssetItemInputPorts
locationInfo Informations d’accès pour la ressource. BlobLocation (obligatoire)
métadonnées Si la ressource est un module personnalisé, elle contient les métadonnées du module. AssetItemMetadata
nom Nom convivial de la ressource. chaîne (obligatoire)
outputPorts Informations sur les ports de sortie de la ressource. AssetItemOutputPorts
Paramètres Si la ressource est un module personnalisé, cela contient les paramètres du module. ModuleAssetParameter[]
type Type de ressource. 'Module'
'Resource' (obligatoire)

AssetItemInputPorts

Nom Description Valeur

AssetItemMetadata

Nom Description Valeur

AssetItemOutputPorts

Nom Description Valeur

BlobLocation

Nom Description Valeur
Pouvoirs Accéder aux informations d’identification de l’objet blob, le cas échéant (par exemple, blob spécifié par la chaîne de connexion du compte de stockage + URI d’objet blob) corde
URI URI à partir duquel l’objet blob est accessible. Par exemple, aml://abc pour les ressources système ou les https://xyz pour les ressources utilisateur ou la charge utile. chaîne (obligatoire)

ColumnSpecification

Nom Description Valeur
énumération Si le type de données est catégoriel, il fournit la liste des catégories acceptées. any[]
format Informations de format supplémentaires pour le type de données. 'Byte'
'Char'
'Complex128'
'Complex64'
'Date-heure'
'Date-timeOffset'
'Double'
'Duration'
'Float'
'Int16'
'Int32'
'Int64'
'Int8'
'Uint16'
'Uint32'
'Uint64'
'Uint8'
type Type de données de la colonne. 'Boolean'
'Integer'
'Number'
'String' (obligatoire)
x-ms-isnullable Indicateur indiquant si le type prend en charge les valeurs Null ou non. Bool
x-ms-isordered Indicateur indiquant si les catégories sont traitées comme un ensemble ordonné ou non, s’il s’agit d’une colonne catégorielle. Bool

Plan d’engagement

Nom Description Valeur
id Spécifie l’ID Azure Resource Manager du plan d’engagement associé au service web. chaîne (obligatoire)

DiagnosticsConfiguration

Nom Description Valeur
expiration Spécifie la date et l’heure à laquelle la journalisation cessera. Si la valeur est Null, la collecte de diagnostics n’est pas limitée au temps. corde
niveau Spécifie la détail de la sortie de diagnostic. Les valeurs valides sont : Aucun - désactive le suivi ; Erreur : collecte uniquement les traces d’erreur (stderr) ; All : collecte toutes les traces (stdout et stderr). 'All'
'Erreur'
'None' (obligatoire)

ExampleRequest

Nom Description Valeur
globalParameters Exemples de données d’entrée pour les paramètres globaux du service web ExampleRequestGlobalParameters
Entrées Exemples de données d’entrée pour les entrées du service web données sous la forme d’un nom d’entrée pour l’exemple de mappage de matrice de valeurs d’entrée. ExampleRequestInputs

ExampleRequestGlobalParameters

Nom Description Valeur

ExampleRequestInputs

Nom Description Valeur

GraphEdge

Nom Description Valeur
sourceNodeId Identificateur du nœud de graphe source. corde
sourcePortId Identificateur du port du nœud source à partir duquel se connecte le bord. corde
targetNodeId Identificateur du nœud de graphique de destination. corde
targetPortId Identificateur du port du nœud de destination auquel se connecte le bord. corde

GraphNode

Nom Description Valeur
assetId ID de la ressource représentée par ce nœud. corde
inputId ID de l’élément d’entrée représenté par ce nœud. corde
outputId ID de l’élément de sortie représenté par ce nœud. corde
Paramètres Le cas échéant, les paramètres du nœud. Les paramètres de graphe globaux sont mappés dans ces paramètres, avec des valeurs définies au moment de l’exécution. GraphNodeParameters

GraphNodeParameters

Nom Description Valeur

GraphPackage

Nom Description Valeur
Bords Liste des arêtes qui composent le graphique. GraphEdge []
graphParameters Collection de paramètres globaux pour le graphe, donné sous la forme d’un nom de paramètre global à la carte GraphParameter. Chaque paramètre a ici une correspondance 1:1 avec la carte des valeurs de paramètres globaux déclarée au niveau webServiceProperties. GraphPackageGraphParameters
Nœuds Ensemble de nœuds composant le graphe, fourni en tant que nodeId à la carte GraphNode GraphPackageNodes

GraphPackageGraphParameters

Nom Description Valeur

GraphPackageNodes

Nom Description Valeur

GraphParameter

Nom Description Valeur
description Description de ce paramètre de graphe. corde
Liens Liens d’association pour ce paramètre aux nœuds du graphique. GraphParameterLink[] (obligatoire)
type Type du paramètre Graph. 'Boolean'
'ColumnPicker'
'Credential'
'DataGatewayName'
'Double'
'Énuméré'
'Float'
'Int'
'Mode'
'ParameterRange'
'Script'
'String' (obligatoire)

GraphParameterLink

Nom Description Valeur
nodeId Identificateur du nœud de graphe chaîne (obligatoire)
parameterKey Identificateur du paramètre de nœud auquel le paramètre global est mappé. chaîne (obligatoire)

InputPort

Nom Description Valeur
type Type de données de port. 'Dataset'

MachineLearningWorkspace

Nom Description Valeur
id Spécifie l’ID d’espace de travail de l’espace de travail Machine Learning associé au service web chaîne (obligatoire)

Microsoft.MachineLearning/webServices

Nom Description Valeur
apiVersion Version de l’API '2017-01-01'
emplacement Spécifie l’emplacement de la ressource. chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
Propriétés Contient la charge utile de propriété qui décrit le service web. WebServiceProperties (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.MachineLearning/webServices'

ModeValueInfo

Nom Description Valeur
interfaceString Nom de la chaîne d’interface pour le paramètre imbriqué. corde
Paramètres Définition du paramètre. ModuleAssetParameter[]

ModuleAssetParameter

Nom Description Valeur
modeValuesInfo Définitions des paramètres d’interface imbriqués s’il s’agit d’un paramètre de module complexe. ModuleAssetParameterModeValuesInfo
nom Nom du paramètre. corde
parameterType Type de paramètre. corde

ModuleAssetParameterModeValuesInfo

Nom Description Valeur

OutputPort

Nom Description Valeur
type Type de données de port. 'Dataset'

RealtimeConfiguration

Nom Description Valeur
maxConcurrentCalls Spécifie le nombre maximal d’appels simultanés qui peuvent être effectués au service web. Valeur minimale : 4, valeur maximale : 200. Int

Contraintes:
Valeur minimale = 4
Valeur maximale = 200

ResourceTags

Nom Description Valeur

ServiceInputOutputSpecification

Nom Description Valeur
description Description du schéma Swagger. corde
Propriétés Spécifie une collection qui contient le schéma de colonne pour chaque entrée ou sortie du service web. Pour plus d’informations, consultez la spécification Swagger. ServiceInputOutputSpecificationProperties (obligatoire)
titre Titre de votre schéma Swagger. corde
type Type de l’entité décrite dans swagger. Toujours 'object'. chaîne (obligatoire)

ServiceInputOutputSpecificationProperties

Nom Description Valeur

StorageAccount

Nom Description Valeur
clé Spécifie la clé utilisée pour accéder au compte de stockage. corde
nom Spécifie le nom du compte de stockage. corde

TableSpecification

Nom Description Valeur
description Description du schéma Swagger. corde
format Format, si 'type' n’est pas 'object' corde
Propriétés Jeu de colonnes dans la table de données. TableSpecificationProperties
titre Titre du schéma Swagger. corde
type Type de l’entité décrite dans swagger. chaîne (obligatoire)

TableSpecificationProperties

Nom Description Valeur

WebServiceKeys

Nom Description Valeur
primaire Clé d’accès primaire. corde
secondaire Clé d’accès secondaire. corde

WebServiceParameter

Nom Description Valeur
certificateThumbprint Si la valeur du paramètre dans le champ « valeur » est chiffrée, l’empreinte numérique du certificat doit être placée ici. corde
valeur Valeur du paramètre quelconque

WebServiceProperties

Nom Description Valeur
actif Contient des propriétés définies par l’utilisateur décrivant les ressources du service web. Les propriétés sont exprimées sous forme de paires Clé/Valeur. WebServicePropertiesAssets
commitmentPlan Contient le plan d’engagement associé à ce service web. Définir au moment de la création. Une fois définie, cette valeur ne peut pas être modifiée. Remarque : Le plan d’engagement n’est pas retourné par les appels aux opérations GET. CommitmentPlan
description Description du service web. corde
diagnostic Paramètres contrôlant la collection de traces de diagnostics pour le service web. DiagnosticsConfiguration
exampleRequest Définit des exemples de données d’entrée pour une ou plusieurs entrées du service. ExampleRequest
exposeSampleData Lorsque la valeur est true, les exemples de données sont inclus dans la définition swagger du service web. La valeur par défaut est true. Bool
entrée Contient le schéma Swagger 2.0 décrivant une ou plusieurs entrées du service web. Pour plus d’informations, consultez la spécification Swagger. ServiceInputOutputSpecification
Clés Contient les clés d’approvisionnement du service web. Si vous ne spécifiez pas de clés d’approvisionnement, le système Azure Machine Learning les génère pour vous. Remarque : les clés ne sont pas retournées à partir d’appels aux opérations GET. WebServiceKeys
machineLearningWorkspace Spécifie l’espace de travail Machine Learning contenant l’expérience source du service web. MachineLearningWorkspace
sortie Contient le schéma Swagger 2.0 décrivant une ou plusieurs sorties du service web. Pour plus d’informations, consultez la spécification Swagger. ServiceInputOutputSpecification
packageType Défini sur « Graph » pour le type WebServicePropertiesForGraph. 'Graph' (obligatoire)
Paramètres Ensemble de valeurs de paramètres globaux définies pour le service web, étant donné qu’un nom de paramètre global est mappé par défaut. Si aucune valeur par défaut n’est spécifiée, le paramètre est considéré comme obligatoire. WebServicePropertiesParameters
payloadsInBlobStorage Lorsque la valeur est true, indique que la taille de la charge utile est supérieure à 3 Mo. Sinon, false. Si la taille de la charge utile dépasse 3 Mo, la charge utile est stockée dans un objet blob et le paramètre PayloadsLocation contient l’URI de l’objet blob. Sinon, cette valeur est définie sur false et Assets, Input, Output, Package, Parameters, ExampleRequest sont inline. Les tailles de charge utile sont déterminées en ajoutant la taille des ressources, des entrées, des sorties, du package, des paramètres et de l’exempleRequest. Bool
payloadsLocation URI de l’objet blob de charge utile. Ce paramètre contient une valeur uniquement si le paramètre payloadsInBlobStorage a la valeur true. Sinon, la valeur null est définie. BlobLocation
readOnly Lorsque la valeur est true, indique que le service web est en lecture seule et ne peut plus être mis à jour ou corrigé, supprimé uniquement. La valeur par défaut est false. Remarque : Une fois défini sur true, vous ne pouvez pas modifier sa valeur. Bool
realtimeConfiguration Contient les paramètres de configuration du point de terminaison du service web. RealtimeConfiguration
storageAccount Spécifie le compte de stockage qu’Azure Machine Learning utilise pour stocker des informations sur le service web. Seul le nom du compte de stockage est retourné par les appels aux opérations GET. Lors de la mise à jour des informations du compte de stockage, vous devez vous assurer que toutes les ressources nécessaires sont disponibles dans le nouveau compte de stockage ou que les appels à votre service web échouent. StorageAccount
titre Titre du service web. corde

WebServicePropertiesAssets

Nom Description Valeur

WebServicePropertiesForGraph

Nom Description Valeur
colis Définition du package de graphe qui compose ce service web. GraphPackage
packageType Spécifie le type de package. Les valeurs valides sont Graph (Spécifie un service web publié via Machine Learning Studio) et Code (spécifie un service web publié à l’aide de code tel que Python). Remarque : Le code n’est pas pris en charge pour l’instant. 'Graph' (obligatoire)

WebServicePropertiesParameters

Nom Description Valeur

Exemples d’utilisation

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource webServices peut être déployé avec des opérations qui ciblent :

  • groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.MachineLearning/webServices, ajoutez terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearning/webServices@2017-01-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      assets = {
        {customized property} = {
          id = "string"
          inputPorts = {
            {customized property} = {
              type = "string"
            }
          }
          locationInfo = {
            credentials = "string"
            uri = "string"
          }
          metadata = {
            {customized property} = "string"
          }
          name = "string"
          outputPorts = {
            {customized property} = {
              type = "string"
            }
          }
          parameters = [
            {
              modeValuesInfo = {
                {customized property} = {
                  interfaceString = "string"
                  parameters = [
                    ...
                  ]
                }
              }
              name = "string"
              parameterType = "string"
            }
          ]
          type = "string"
        }
      }
      commitmentPlan = {
        id = "string"
      }
      description = "string"
      diagnostics = {
        expiry = "string"
        level = "string"
      }
      exampleRequest = {
        globalParameters = {
          {customized property} = ?
        }
        inputs = {
          {customized property} = [
            [
              ?
            ]
          ]
        }
      }
      exposeSampleData = bool
      input = {
        description = "string"
        properties = {
          {customized property} = {
            description = "string"
            format = "string"
            properties = {
              {customized property} = {
                enum = [
                  ?
                ]
                format = "string"
                type = "string"
                x-ms-isnullable = bool
                x-ms-isordered = bool
              }
            }
            title = "string"
            type = "string"
          }
        }
        title = "string"
        type = "string"
      }
      keys = {
        primary = "string"
        secondary = "string"
      }
      machineLearningWorkspace = {
        id = "string"
      }
      output = {
        description = "string"
        properties = {
          {customized property} = {
            description = "string"
            format = "string"
            properties = {
              {customized property} = {
                enum = [
                  ?
                ]
                format = "string"
                type = "string"
                x-ms-isnullable = bool
                x-ms-isordered = bool
              }
            }
            title = "string"
            type = "string"
          }
        }
        title = "string"
        type = "string"
      }
      parameters = {
        {customized property} = {
          certificateThumbprint = "string"
          value = ?
        }
      }
      payloadsInBlobStorage = bool
      payloadsLocation = {
        credentials = "string"
        uri = "string"
      }
      readOnly = bool
      realtimeConfiguration = {
        maxConcurrentCalls = int
      }
      storageAccount = {
        key = "string"
        name = "string"
      }
      title = "string"
      packageType = "string"
      // For remaining properties, see WebServiceProperties objects
    }
  }
}

Objets WebServiceProperties

Définissez la propriété packageType pour spécifier le type d’objet.

Pour Graph, utilisez :

{
  package = {
    edges = [
      {
        sourceNodeId = "string"
        sourcePortId = "string"
        targetNodeId = "string"
        targetPortId = "string"
      }
    ]
    graphParameters = {
      {customized property} = {
        description = "string"
        links = [
          {
            nodeId = "string"
            parameterKey = "string"
          }
        ]
        type = "string"
      }
    }
    nodes = {
      {customized property} = {
        assetId = "string"
        inputId = "string"
        outputId = "string"
        parameters = {
          {customized property} = {
            certificateThumbprint = "string"
            value = ?
          }
        }
      }
    }
  }
  packageType = "Graph"
}

Valeurs de propriété

AssetItem

Nom Description Valeur
id ID de la ressource. corde
inputPorts Informations sur les ports d’entrée de la ressource. AssetItemInputPorts
locationInfo Informations d’accès pour la ressource. BlobLocation (obligatoire)
métadonnées Si la ressource est un module personnalisé, elle contient les métadonnées du module. AssetItemMetadata
nom Nom convivial de la ressource. chaîne (obligatoire)
outputPorts Informations sur les ports de sortie de la ressource. AssetItemOutputPorts
Paramètres Si la ressource est un module personnalisé, cela contient les paramètres du module. ModuleAssetParameter[]
type Type de ressource. 'Module'
'Resource' (obligatoire)

AssetItemInputPorts

Nom Description Valeur

AssetItemMetadata

Nom Description Valeur

AssetItemOutputPorts

Nom Description Valeur

BlobLocation

Nom Description Valeur
Pouvoirs Accéder aux informations d’identification de l’objet blob, le cas échéant (par exemple, blob spécifié par la chaîne de connexion du compte de stockage + URI d’objet blob) corde
URI URI à partir duquel l’objet blob est accessible. Par exemple, aml://abc pour les ressources système ou les https://xyz pour les ressources utilisateur ou la charge utile. chaîne (obligatoire)

ColumnSpecification

Nom Description Valeur
énumération Si le type de données est catégoriel, il fournit la liste des catégories acceptées. any[]
format Informations de format supplémentaires pour le type de données. 'Byte'
'Char'
'Complex128'
'Complex64'
'Date-heure'
'Date-timeOffset'
'Double'
'Duration'
'Float'
'Int16'
'Int32'
'Int64'
'Int8'
'Uint16'
'Uint32'
'Uint64'
'Uint8'
type Type de données de la colonne. 'Boolean'
'Integer'
'Number'
'String' (obligatoire)
x-ms-isnullable Indicateur indiquant si le type prend en charge les valeurs Null ou non. Bool
x-ms-isordered Indicateur indiquant si les catégories sont traitées comme un ensemble ordonné ou non, s’il s’agit d’une colonne catégorielle. Bool

Plan d’engagement

Nom Description Valeur
id Spécifie l’ID Azure Resource Manager du plan d’engagement associé au service web. chaîne (obligatoire)

DiagnosticsConfiguration

Nom Description Valeur
expiration Spécifie la date et l’heure à laquelle la journalisation cessera. Si la valeur est Null, la collecte de diagnostics n’est pas limitée au temps. corde
niveau Spécifie la détail de la sortie de diagnostic. Les valeurs valides sont : Aucun - désactive le suivi ; Erreur : collecte uniquement les traces d’erreur (stderr) ; All : collecte toutes les traces (stdout et stderr). 'All'
'Erreur'
'None' (obligatoire)

ExampleRequest

Nom Description Valeur
globalParameters Exemples de données d’entrée pour les paramètres globaux du service web ExampleRequestGlobalParameters
Entrées Exemples de données d’entrée pour les entrées du service web données sous la forme d’un nom d’entrée pour l’exemple de mappage de matrice de valeurs d’entrée. ExampleRequestInputs

ExampleRequestGlobalParameters

Nom Description Valeur

ExampleRequestInputs

Nom Description Valeur

GraphEdge

Nom Description Valeur
sourceNodeId Identificateur du nœud de graphe source. corde
sourcePortId Identificateur du port du nœud source à partir duquel se connecte le bord. corde
targetNodeId Identificateur du nœud de graphique de destination. corde
targetPortId Identificateur du port du nœud de destination auquel se connecte le bord. corde

GraphNode

Nom Description Valeur
assetId ID de la ressource représentée par ce nœud. corde
inputId ID de l’élément d’entrée représenté par ce nœud. corde
outputId ID de l’élément de sortie représenté par ce nœud. corde
Paramètres Le cas échéant, les paramètres du nœud. Les paramètres de graphe globaux sont mappés dans ces paramètres, avec des valeurs définies au moment de l’exécution. GraphNodeParameters

GraphNodeParameters

Nom Description Valeur

GraphPackage

Nom Description Valeur
Bords Liste des arêtes qui composent le graphique. GraphEdge []
graphParameters Collection de paramètres globaux pour le graphe, donné sous la forme d’un nom de paramètre global à la carte GraphParameter. Chaque paramètre a ici une correspondance 1:1 avec la carte des valeurs de paramètres globaux déclarée au niveau webServiceProperties. GraphPackageGraphParameters
Nœuds Ensemble de nœuds composant le graphe, fourni en tant que nodeId à la carte GraphNode GraphPackageNodes

GraphPackageGraphParameters

Nom Description Valeur

GraphPackageNodes

Nom Description Valeur

GraphParameter

Nom Description Valeur
description Description de ce paramètre de graphe. corde
Liens Liens d’association pour ce paramètre aux nœuds du graphique. GraphParameterLink[] (obligatoire)
type Type du paramètre Graph. 'Boolean'
'ColumnPicker'
'Credential'
'DataGatewayName'
'Double'
'Énuméré'
'Float'
'Int'
'Mode'
'ParameterRange'
'Script'
'String' (obligatoire)

GraphParameterLink

Nom Description Valeur
nodeId Identificateur du nœud de graphe chaîne (obligatoire)
parameterKey Identificateur du paramètre de nœud auquel le paramètre global est mappé. chaîne (obligatoire)

InputPort

Nom Description Valeur
type Type de données de port. 'Dataset'

MachineLearningWorkspace

Nom Description Valeur
id Spécifie l’ID d’espace de travail de l’espace de travail Machine Learning associé au service web chaîne (obligatoire)

Microsoft.MachineLearning/webServices

Nom Description Valeur
emplacement Spécifie l’emplacement de la ressource. chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
Propriétés Contient la charge utile de propriété qui décrit le service web. WebServiceProperties (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.MachineLearning/webServices@2017-01-01 »

ModeValueInfo

Nom Description Valeur
interfaceString Nom de la chaîne d’interface pour le paramètre imbriqué. corde
Paramètres Définition du paramètre. ModuleAssetParameter[]

ModuleAssetParameter

Nom Description Valeur
modeValuesInfo Définitions des paramètres d’interface imbriqués s’il s’agit d’un paramètre de module complexe. ModuleAssetParameterModeValuesInfo
nom Nom du paramètre. corde
parameterType Type de paramètre. corde

ModuleAssetParameterModeValuesInfo

Nom Description Valeur

OutputPort

Nom Description Valeur
type Type de données de port. 'Dataset'

RealtimeConfiguration

Nom Description Valeur
maxConcurrentCalls Spécifie le nombre maximal d’appels simultanés qui peuvent être effectués au service web. Valeur minimale : 4, valeur maximale : 200. Int

Contraintes:
Valeur minimale = 4
Valeur maximale = 200

ResourceTags

Nom Description Valeur

ServiceInputOutputSpecification

Nom Description Valeur
description Description du schéma Swagger. corde
Propriétés Spécifie une collection qui contient le schéma de colonne pour chaque entrée ou sortie du service web. Pour plus d’informations, consultez la spécification Swagger. ServiceInputOutputSpecificationProperties (obligatoire)
titre Titre de votre schéma Swagger. corde
type Type de l’entité décrite dans swagger. Toujours 'object'. chaîne (obligatoire)

ServiceInputOutputSpecificationProperties

Nom Description Valeur

StorageAccount

Nom Description Valeur
clé Spécifie la clé utilisée pour accéder au compte de stockage. corde
nom Spécifie le nom du compte de stockage. corde

TableSpecification

Nom Description Valeur
description Description du schéma Swagger. corde
format Format, si 'type' n’est pas 'object' corde
Propriétés Jeu de colonnes dans la table de données. TableSpecificationProperties
titre Titre du schéma Swagger. corde
type Type de l’entité décrite dans swagger. chaîne (obligatoire)

TableSpecificationProperties

Nom Description Valeur

WebServiceKeys

Nom Description Valeur
primaire Clé d’accès primaire. corde
secondaire Clé d’accès secondaire. corde

WebServiceParameter

Nom Description Valeur
certificateThumbprint Si la valeur du paramètre dans le champ « valeur » est chiffrée, l’empreinte numérique du certificat doit être placée ici. corde
valeur Valeur du paramètre quelconque

WebServiceProperties

Nom Description Valeur
actif Contient des propriétés définies par l’utilisateur décrivant les ressources du service web. Les propriétés sont exprimées sous forme de paires Clé/Valeur. WebServicePropertiesAssets
commitmentPlan Contient le plan d’engagement associé à ce service web. Définir au moment de la création. Une fois définie, cette valeur ne peut pas être modifiée. Remarque : Le plan d’engagement n’est pas retourné par les appels aux opérations GET. CommitmentPlan
description Description du service web. corde
diagnostic Paramètres contrôlant la collection de traces de diagnostics pour le service web. DiagnosticsConfiguration
exampleRequest Définit des exemples de données d’entrée pour une ou plusieurs entrées du service. ExampleRequest
exposeSampleData Lorsque la valeur est true, les exemples de données sont inclus dans la définition swagger du service web. La valeur par défaut est true. Bool
entrée Contient le schéma Swagger 2.0 décrivant une ou plusieurs entrées du service web. Pour plus d’informations, consultez la spécification Swagger. ServiceInputOutputSpecification
Clés Contient les clés d’approvisionnement du service web. Si vous ne spécifiez pas de clés d’approvisionnement, le système Azure Machine Learning les génère pour vous. Remarque : les clés ne sont pas retournées à partir d’appels aux opérations GET. WebServiceKeys
machineLearningWorkspace Spécifie l’espace de travail Machine Learning contenant l’expérience source du service web. MachineLearningWorkspace
sortie Contient le schéma Swagger 2.0 décrivant une ou plusieurs sorties du service web. Pour plus d’informations, consultez la spécification Swagger. ServiceInputOutputSpecification
packageType Défini sur « Graph » pour le type WebServicePropertiesForGraph. 'Graph' (obligatoire)
Paramètres Ensemble de valeurs de paramètres globaux définies pour le service web, étant donné qu’un nom de paramètre global est mappé par défaut. Si aucune valeur par défaut n’est spécifiée, le paramètre est considéré comme obligatoire. WebServicePropertiesParameters
payloadsInBlobStorage Lorsque la valeur est true, indique que la taille de la charge utile est supérieure à 3 Mo. Sinon, false. Si la taille de la charge utile dépasse 3 Mo, la charge utile est stockée dans un objet blob et le paramètre PayloadsLocation contient l’URI de l’objet blob. Sinon, cette valeur est définie sur false et Assets, Input, Output, Package, Parameters, ExampleRequest sont inline. Les tailles de charge utile sont déterminées en ajoutant la taille des ressources, des entrées, des sorties, du package, des paramètres et de l’exempleRequest. Bool
payloadsLocation URI de l’objet blob de charge utile. Ce paramètre contient une valeur uniquement si le paramètre payloadsInBlobStorage a la valeur true. Sinon, la valeur null est définie. BlobLocation
readOnly Lorsque la valeur est true, indique que le service web est en lecture seule et ne peut plus être mis à jour ou corrigé, supprimé uniquement. La valeur par défaut est false. Remarque : Une fois défini sur true, vous ne pouvez pas modifier sa valeur. Bool
realtimeConfiguration Contient les paramètres de configuration du point de terminaison du service web. RealtimeConfiguration
storageAccount Spécifie le compte de stockage qu’Azure Machine Learning utilise pour stocker des informations sur le service web. Seul le nom du compte de stockage est retourné par les appels aux opérations GET. Lors de la mise à jour des informations du compte de stockage, vous devez vous assurer que toutes les ressources nécessaires sont disponibles dans le nouveau compte de stockage ou que les appels à votre service web échouent. StorageAccount
titre Titre du service web. corde

WebServicePropertiesAssets

Nom Description Valeur

WebServicePropertiesForGraph

Nom Description Valeur
colis Définition du package de graphe qui compose ce service web. GraphPackage
packageType Spécifie le type de package. Les valeurs valides sont Graph (Spécifie un service web publié via Machine Learning Studio) et Code (spécifie un service web publié à l’aide de code tel que Python). Remarque : Le code n’est pas pris en charge pour l’instant. 'Graph' (obligatoire)

WebServicePropertiesParameters

Nom Description Valeur