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 |
---|---|---|---|---|
job
|
path | True |
string |
Nom du travail de diffusion en continu. |
resource
|
path | True |
string |
Nom du groupe de ressources. Le nom ne respecte pas la casse. Modèle d’expression régulière: |
subscription
|
path | True |
string |
ID de l’abonnement cible. |
transformation
|
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 |
La transformation a été créée ou remplacée avec succès. En-têtes ETag: string |
|
201 Created |
La transformation a été créée ou remplacée avec succès. En-têtes ETag: string |
|
Other Status Codes |
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 |
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 |