Transformations - Create Or Replace
Crea una trasformazione o sostituisce una trasformazione già esistente in un processo di streaming esistente.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StreamAnalytics/streamingjobs/{jobName}/transformations/{transformationName}?api-version=2020-03-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
job
|
path | True |
string |
Nome del processo di streaming. |
resource
|
path | True |
string |
Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole. Criterio di espressione regolare: |
subscription
|
path | True |
string |
ID della sottoscrizione di destinazione. |
transformation
|
path | True |
string |
Nome della trasformazione. |
api-version
|
query | True |
string |
Versione dell'API da usare per questa operazione. |
Intestazione della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
If-Match |
string |
ETag della trasformazione. Omettere questo valore per sovrascrivere sempre la trasformazione corrente. Specificare l'ultimo valore ETag visualizzato per impedire la sovrascrittura accidentale delle modifiche simultanee. |
|
If-None-Match |
string |
Impostare su '*' per consentire la creazione di una nuova trasformazione, ma per impedire l'aggiornamento di una trasformazione esistente. Altri valori comportano una risposta pre-condizione 412 Non riuscita. |
Corpo della richiesta
Nome | Tipo | Descrizione |
---|---|---|
name |
string |
Nome risorsa |
properties.query |
string |
Specifica la query che verrà eseguita nel processo di streaming. Altre informazioni sul linguaggio di query di Analisi di flusso (SAQL) sono disponibili qui: https://msdn.microsoft.com/library/azure/dn834998 . Obbligatorio nelle richieste PUT (CreateOrReplace). |
properties.streamingUnits |
integer |
Specifica il numero di unità di streaming usate dal processo di streaming. |
properties.validStreamingUnits |
integer[] |
Specifica le unità di streaming valide a cui è possibile ridimensionare un processo di streaming. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
La trasformazione è stata creata o sostituita correttamente. Intestazioni ETag: string |
|
201 Created |
La trasformazione è stata creata o sostituita correttamente. Intestazioni ETag: string |
|
Other Status Codes |
Errore. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
Nome | Descrizione |
---|---|
user_impersonation | rappresentare l'account utente |
Esempio
Create a transformation
Esempio di richiesta
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"
}
}
Risposta di esempio
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"
}
}
Definizioni
Nome | Descrizione |
---|---|
Error |
Rappresentazione di errore comune. |
Transformation |
Oggetto trasformazione contenente tutte le informazioni associate alla trasformazione denominata. Tutte le trasformazioni sono contenute in un processo di streaming. |
Error
Rappresentazione di errore comune.
Nome | Tipo | Descrizione |
---|---|---|
error |
Proprietà di definizione degli errori. |
Transformation
Oggetto trasformazione contenente tutte le informazioni associate alla trasformazione denominata. Tutte le trasformazioni sono contenute in un processo di streaming.
Nome | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
id |
string |
ID risorsa |
|
name |
string |
Nome risorsa |
|
properties.etag |
string |
Tag di entità corrente per la trasformazione. Si tratta di una stringa opaca. È possibile usarlo per rilevare se la risorsa è cambiata tra le richieste. È anche possibile usarlo nelle intestazioni di If-Match o If-None-Match per le operazioni di scrittura per la concorrenza ottimistica. |
|
properties.query |
string |
Specifica la query che verrà eseguita nel processo di streaming. Altre informazioni sul linguaggio di query di Analisi di flusso (SAQL) sono disponibili qui: https://msdn.microsoft.com/library/azure/dn834998 . Obbligatorio nelle richieste PUT (CreateOrReplace). |
|
properties.streamingUnits |
integer |
3 |
Specifica il numero di unità di streaming usate dal processo di streaming. |
properties.validStreamingUnits |
integer[] |
Specifica le unità di streaming valide a cui è possibile ridimensionare un processo di streaming. |
|
type |
string |
Tipo di risorsa |