Condividi tramite


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
jobName
path True

string

Nome del processo di streaming.

resourceGroupName
path True

string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.

Criterio di espressione regolare: ^[-\w\._\(\)]+$

subscriptionId
path True

string

ID della sottoscrizione di destinazione.

transformationName
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

Transformation

La trasformazione è stata creata o sostituita correttamente.

Intestazioni

ETag: string

201 Created

Transformation

La trasformazione è stata creata o sostituita correttamente.

Intestazioni

ETag: string

Other Status Codes

Error

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

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