Functions - Update

Atualizações uma função existente em um trabalho de streaming existente. Isso pode ser usado para atualizar parcialmente (ou seja, atualizar uma ou duas propriedades) uma função sem afetar o restante da definição de função ou trabalho.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StreamAnalytics/streamingjobs/{jobName}/functions/{functionName}?api-version=2020-03-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
functionName
path True

string

O nome da função.

jobName
path True

string

O nome do trabalho de streaming.

resourceGroupName
path True

string

O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True

string

A ID da assinatura de destino.

api-version
query True

string

A versão da API a ser usada para esta operação.

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
If-Match

string

A ETag da função. Omita esse valor para sempre substituir a função atual. Especifique o valor ETag visto pela última vez para evitar a substituição acidental de alterações simultâneas.

Corpo da solicitação

Nome Tipo Description
name

string

Nome do recurso

properties FunctionProperties:

As propriedades associadas a uma função.

Respostas

Nome Tipo Description
200 OK

Function

A função foi atualizada com êxito.

Headers

ETag: string

Other Status Codes

Error

Erro.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Update a JavaScript function
Update an Azure ML function

Update a JavaScript function

Sample Request

PATCH https://management.azure.com/subscriptions/56b5e0a9-b645-407d-99b0-c64f86013e3d/resourcegroups/sjrg1637/providers/Microsoft.StreamAnalytics/streamingjobs/sj8653/functions/function8197?api-version=2020-03-01

{
  "properties": {
    "type": "Scalar",
    "properties": {
      "binding": {
        "type": "Microsoft.StreamAnalytics/JavascriptUdf",
        "properties": {
          "script": "function (a, b) { return a * b; }"
        }
      }
    }
  }
}

Sample Response

ETag: 94a512d5-2f59-4e39-b9c8-bca4abd74b7e
{
  "id": "/subscriptions/56b5e0a9-b645-407d-99b0-c64f86013e3d/resourceGroups/sjrg1637/providers/Microsoft.StreamAnalytics/streamingjobs/sj8653/functions/function8197",
  "name": "function8197",
  "type": "Microsoft.StreamAnalytics/streamingjobs/functions",
  "properties": {
    "type": "Scalar",
    "properties": {
      "inputs": [
        {
          "dataType": "Any"
        }
      ],
      "output": {
        "dataType": "Any"
      },
      "binding": {
        "type": "Microsoft.StreamAnalytics/JavascriptUdf",
        "properties": {
          "script": "function (a, b) { return a * b; }"
        }
      }
    }
  }
}

Update an Azure ML function

Sample Request

PATCH https://management.azure.com/subscriptions/56b5e0a9-b645-407d-99b0-c64f86013e3d/resourcegroups/sjrg7/providers/Microsoft.StreamAnalytics/streamingjobs/sj9093/functions/function588?api-version=2020-03-01

{
  "properties": {
    "type": "Scalar",
    "properties": {
      "binding": {
        "type": "Microsoft.MachineLearning/WebService",
        "properties": {
          "batchSize": 5000
        }
      }
    }
  }
}

Sample Response

ETag: 281cbf11-cd50-4a44-b833-cf170ce74748
{
  "id": "/subscriptions/56b5e0a9-b645-407d-99b0-c64f86013e3d/resourceGroups/sjrg7/providers/Microsoft.StreamAnalytics/streamingjobs/sj9093/functions/function588",
  "name": "function588",
  "type": "Microsoft.StreamAnalytics/streamingjobs/functions",
  "properties": {
    "type": "Scalar",
    "properties": {
      "inputs": [
        {
          "dataType": "nvarchar(max)"
        }
      ],
      "output": {
        "dataType": "nvarchar(max)"
      },
      "binding": {
        "type": "Microsoft.MachineLearning/WebService",
        "properties": {
          "endpoint": "someAzureMLEndpointURL",
          "inputs": {
            "name": "input1",
            "columnNames": [
              {
                "name": "tweet",
                "dataType": "string",
                "mapTo": 0
              }
            ]
          },
          "outputs": [
            {
              "name": "Sentiment",
              "dataType": "string"
            }
          ],
          "batchSize": 5000
        }
      }
    }
  }
}

Definições

Nome Description
AggregateFunctionProperties

As propriedades associadas a uma função de agregação.

AzureMachineLearningWebServiceFunctionBinding

A associação a um serviço Web do Azure Machine Learning.

AzureMachineLearningWebServiceInputColumn

Descreve uma coluna de entrada para o ponto de extremidade do serviço Web do Azure Machine Learning.

AzureMachineLearningWebServiceInputs

As entradas para o ponto de extremidade do serviço Web do Azure Machine Learning.

AzureMachineLearningWebServiceOutputColumn

Descreve uma coluna de saída para o ponto de extremidade do serviço Web do Azure Machine Learning.

Error

Representação de erro comum.

Function

Um objeto de função, contendo todas as informações associadas à função nomeada. Todas as funções estão contidas em um trabalho de streaming.

FunctionInput

Descreve um parâmetro de entrada de uma função.

FunctionOutput

Descreve a saída de uma função.

JavaScriptFunctionBinding

A associação a uma função JavaScript.

ScalarFunctionProperties

As propriedades associadas a uma função escalar.

AggregateFunctionProperties

As propriedades associadas a uma função de agregação.

Nome Tipo Description
etag

string

A marca de entidade atual para a função. Essa é uma cadeia de caracteres opaca. Você pode usá-lo para detectar se o recurso foi alterado entre solicitações. Você também pode usá-lo nos cabeçalhos If-Match ou If-None-Match para operações de gravação para simultaneidade otimista.

properties.binding FunctionBinding:

A associação física da função. Por exemplo, no caso do serviço Web do Azure Machine Learning, isso descreve o ponto de extremidade.

properties.inputs

FunctionInput[]

Descreve um parâmetro de entrada de uma função.

properties.output

FunctionOutput

Descreve a saída de uma função.

type string:

Aggregate

Indica o tipo de função.

AzureMachineLearningWebServiceFunctionBinding

A associação a um serviço Web do Azure Machine Learning.

Nome Tipo Description
properties.apiKey

string

A chave de API usada para autenticar com Request-Response ponto de extremidade.

properties.batchSize

integer

Número entre 1 e 10000 que descreve o número máximo de linhas para cada solicitação de execução do Azure ML RRS. O padrão é 1000.

properties.endpoint

string

O Request-Response executar o ponto de extremidade do serviço Web do Azure Machine Learning. Saiba mais aqui: https://docs.microsoft.com/en-us/azure/machine-learning/machine-learning-consume-web-services#request-response-service-rrs

properties.inputs

AzureMachineLearningWebServiceInputs

As entradas para o ponto de extremidade do serviço Web do Azure Machine Learning.

properties.outputs

AzureMachineLearningWebServiceOutputColumn[]

Uma lista de saídas da execução do ponto de extremidade do serviço Web do Azure Machine Learning.

type string:

Microsoft.MachineLearning/WebService

Indica o tipo de associação de função.

AzureMachineLearningWebServiceInputColumn

Descreve uma coluna de entrada para o ponto de extremidade do serviço Web do Azure Machine Learning.

Nome Tipo Description
dataType

string

O tipo de dados (com suporte do Azure Machine Learning) da coluna de entrada. Uma lista de tipos de dados válidos do Azure Machine Learning é descrita em https://msdn.microsoft.com/en-us/library/azure/dn905923.aspx .

mapTo

integer

O índice baseado em zero do parâmetro de função para o qual essa entrada é mapeada.

name

string

Nome da coluna de entrada.

AzureMachineLearningWebServiceInputs

As entradas para o ponto de extremidade do serviço Web do Azure Machine Learning.

Nome Tipo Description
columnNames

AzureMachineLearningWebServiceInputColumn[]

Uma lista de colunas de entrada para o ponto de extremidade do serviço Web do Azure Machine Learning.

name

string

Nome da entrada. Esse é o nome fornecido durante a criação do ponto de extremidade.

AzureMachineLearningWebServiceOutputColumn

Descreve uma coluna de saída para o ponto de extremidade do serviço Web do Azure Machine Learning.

Nome Tipo Description
dataType

string

O tipo de dados (com suporte do Azure Machine Learning) da coluna de saída. Uma lista de tipos de dados válidos do Azure Machine Learning é descrita em https://msdn.microsoft.com/en-us/library/azure/dn905923.aspx .

name

string

Nome da coluna de saída.

Error

Representação de erro comum.

Nome Tipo Description
error

Error

Propriedades de definição de erro.

Function

Um objeto de função, contendo todas as informações associadas à função nomeada. Todas as funções estão contidas em um trabalho de streaming.

Nome Tipo Description
id

string

ID do recurso

name

string

Nome do recurso

properties FunctionProperties:

As propriedades associadas a uma função.

type

string

Tipo de recurso

FunctionInput

Descreve um parâmetro de entrada de uma função.

Nome Tipo Description
dataType

string

O tipo de dados (com suporte do Azure Stream Analytics) do parâmetro de entrada de função. Uma lista de tipos de dados válidos do Azure Stream Analytics é descrita em https://msdn.microsoft.com/en-us/library/azure/dn835065.aspx

isConfigurationParameter

boolean

Um sinalizador que indica se o parâmetro é um parâmetro de configuração. True se espera-se que esse parâmetro de entrada seja uma constante. O padrão é false.

FunctionOutput

Descreve a saída de uma função.

Nome Tipo Description
dataType

string

O tipo de dados (com suporte do Azure Stream Analytics) da saída da função. Uma lista de tipos de dados válidos do Azure Stream Analytics é descrita em https://msdn.microsoft.com/en-us/library/azure/dn835065.aspx

JavaScriptFunctionBinding

A associação a uma função JavaScript.

Nome Tipo Description
properties.script

string

O código JavaScript que contém uma única definição de função. Por exemplo: 'function (x, y) { return x + y; }'

type string:

Microsoft.StreamAnalytics/JavascriptUdf

Indica o tipo de associação de função.

ScalarFunctionProperties

As propriedades associadas a uma função escalar.

Nome Tipo Description
etag

string

A marca de entidade atual para a função. Essa é uma cadeia de caracteres opaca. Você pode usá-lo para detectar se o recurso foi alterado entre solicitações. Você também pode usá-lo nos cabeçalhos If-Match ou If-None-Match para operações de gravação para simultaneidade otimista.

properties.binding FunctionBinding:

A associação física da função. Por exemplo, no caso do serviço Web do Azure Machine Learning, isso descreve o ponto de extremidade.

properties.inputs

FunctionInput[]

Descreve um parâmetro de entrada de uma função.

properties.output

FunctionOutput

Descreve a saída de uma função.

type string:

Scalar

Indica o tipo de função.