Partager via


Transformations - Create Or Replace

Crée une transformation ou remplace une transformation déjà existante sous un travail de streaming existant.

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

Paramètres URI

Nom Dans Obligatoire Type Description
jobName
path True

string

Nom du travail de diffusion en continu.

resourceGroupName
path True

string

Nom du groupe de ressources. Le nom ne respecte pas la casse.

Modèle d’expression régulière: ^[-\w\._\(\)]+$

subscriptionId
path True

string

ID de l’abonnement cible.

transformationName
path True

string

Nom de la transformation.

api-version
query True

string

Version de l’API à utiliser pour cette opération.

En-tête de la demande

Nom Obligatoire Type Description
If-Match

string

ETag de la transformation. Omettez cette valeur pour toujours remplacer la transformation actuelle. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.

If-None-Match

string

Définissez la valeur « * » pour permettre la création d’une nouvelle transformation, mais pour empêcher la mise à jour d’une transformation existante. D’autres valeurs entraînent une réponse 412 Pré-condition Failed.

Corps de la demande

Nom Type Description
name

string

Nom de la ressource

properties.query

string

Spécifie la requête qui sera exécutée dans le travail de streaming. Vous pouvez en savoir plus sur le langage de requête Stream Analytics (SAQL) ici : https://msdn.microsoft.com/library/azure/dn834998 . Obligatoire sur les demandes PUT (CreateOrReplace).

properties.streamingUnits

integer

Indique le nombre d’unités de streaming que la tâche de streaming utilise.

properties.validStreamingUnits

integer[]

Spécifie les unités de diffusion en continu valides vers laquelle un travail de streaming peut être mis à l’échelle.

Réponses

Nom Type Description
200 OK

Transformation

La transformation a été créée ou remplacée avec succès.

En-têtes

ETag: string

201 Created

Transformation

La transformation a été créée ou remplacée avec succès.

En-têtes

ETag: string

Other Status Codes

Error

Erreur.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

Create a transformation

Exemple de requête

PUT https://management.azure.com/subscriptions/56b5e0a9-b645-407d-99b0-c64f86013e3d/resourcegroups/sjrg4423/providers/Microsoft.StreamAnalytics/streamingjobs/sj8374/transformations/transformation952?api-version=2020-03-01

{
  "properties": {
    "streamingUnits": 6,
    "query": "Select Id, Name from inputtest"
  }
}

Exemple de réponse

ETag: be3cfaa2-3d02-4624-92d7-a26766306c8b
{
  "id": "/subscriptions/56b5e0a9-b645-407d-99b0-c64f86013e3d/resourceGroups/sjrg4423/providers/Microsoft.StreamAnalytics/streamingjobs/sj8374/transformations/transformation952",
  "name": "transformation952",
  "type": "Microsoft.StreamAnalytics/streamingjobs/transformations",
  "properties": {
    "streamingUnits": 6,
    "query": "Select Id, Name from inputtest"
  }
}
ETag: be3cfaa2-3d02-4624-92d7-a26766306c8b
{
  "id": "/subscriptions/56b5e0a9-b645-407d-99b0-c64f86013e3d/resourceGroups/sjrg4423/providers/Microsoft.StreamAnalytics/streamingjobs/sj8374/transformations/transformation952",
  "name": "transformation952",
  "type": "Microsoft.StreamAnalytics/streamingjobs/transformations",
  "properties": {
    "streamingUnits": 6,
    "query": "Select Id, Name from inputtest"
  }
}

Définitions

Nom Description
Error

Représentation d’erreur courante.

Transformation

Objet de transformation contenant toutes les informations associées à la transformation nommée. Toutes les transformations sont contenues dans un travail de streaming.

Error

Représentation d’erreur courante.

Nom Type Description
error

Error

Propriétés de définition d’erreur.

Transformation

Objet de transformation contenant toutes les informations associées à la transformation nommée. Toutes les transformations sont contenues dans un travail de streaming.

Nom Type Valeur par défaut Description
id

string

ID de ressource

name

string

Nom de la ressource

properties.etag

string

Balise d’entité actuelle pour la transformation. Il s’agit d’une chaîne opaque. Vous pouvez l’utiliser pour détecter si la ressource a changé entre les requêtes. Vous pouvez également l’utiliser dans les en-têtes If-Match ou If-None-Match pour les opérations d’écriture pour une concurrence optimiste.

properties.query

string

Spécifie la requête qui sera exécutée dans le travail de streaming. Vous pouvez en savoir plus sur le langage de requête Stream Analytics (SAQL) ici : https://msdn.microsoft.com/library/azure/dn834998 . Obligatoire sur les demandes PUT (CreateOrReplace).

properties.streamingUnits

integer

3

Indique le nombre d’unités de streaming que la tâche de streaming utilise.

properties.validStreamingUnits

integer[]

Spécifie les unités de diffusion en continu valides vers laquelle un travail de streaming peut être mis à l’échelle.

type

string

Type de ressource