Skip to main content

Endpoint di utilizzo

Recupera esecuzioni di Server

Questo endpoint viene utilizzato per la creazione di report sull'utilizzo offline.

Per recuperare i dettagli su tutte le esecuzioni di Server, usa l'endpoint GET {baseURL}/v3/usage. Questo endpoint restituisce un file che contiene eventi di esecuzione e deve essere salvato come file TMP o AVRO.

Dopo aver scaricato il report sull'utilizzo, accedi all'interfaccia utente di Alteryx Analytics Cloud (AAC) e caricalo. Al termine del caricamento in AAC, viene generato un file di risposta. Carica il file di risposta su Server, come descritto in Carica file di risposta sull'utilizzo di Server in AAC.

  1. Sign in to AAC as a Workspace Admin.

  2. Go to your Profile menu > Workspace Admin.

  3. Go to Monitoring > Offline Server Usage.

  4. Select Upload Server Data.

  5. Drag and drop or browse to your usage report (TMP file) and select Upload.

When the upload to AAC completes, a confirmation file with the last provided record’s event ID will be automatically saved to your Downloads folder. Take the response file and upload it back to Server as described in Upload Server Usage AAC Response File to Server.

Nota

Solo gli amministratori di Server possono usare questo endpoint.

Parametri

Nessun parametro.

curl -X 'GET' \
  'http://pod-6650776.extendthereach.com/webapi/v3/usage' \
  -H 'accept: application/octet-stream' \
  -H 'authorization: Bearer BearerTokenGoesHere'
  • 200: scarica i record di utilizzo come file.

  • 401: autorizzazione negata.

  • 404: nessun record disponibile per il download.

  • 500: InternalServerError.

Carica file di risposta sull'utilizzo di Server in AAC

Questo endpoint viene utilizzato per la creazione di report sull'utilizzo offline.

Dopo aver caricato il report di utilizzo tramite l'interfaccia utente di AAC, carica il file di risposta restituito utilizzando l'endpoint POST {baseURL}/v3/usage.

Quando il file AAC viene elaborato dalla chiamata POST, gli eventi di esecuzione segnalati vengono eliminati dal database. Il file successivo generato dalla chiamata GET /v3/usage recupera gli eventi di esecuzione verificatisi dopo l'ultima chiamata GET.

Nota

Solo gli amministratori di Server possono usare questo endpoint.

Parametri

file (formData): obbligatorio. Carica un file contenente un singolo ULID (EventID). Tutti gli eventi di utilizzo con EventIds inferiori o uguali a questo ULID verranno eliminati.

curl -X 'POST' \
  'http://pod-6650776.extendthereach.com/webapi/v3/usage' \
  -H 'accept: application/json' \
  -H 'authorization: BearerTokenGoesHere' \
  -H 'Content-Type: multipart/form-data' \
  -F 'file=@ServerUsage.csv;type=text/csv'
  • 200: file di risposta AAC elaborato ed eventi di utilizzo eliminati.

  • 400: file di risposta AAC mancante o vuoto.

  • 401: autorizzazione negata. Si verifica se un utente non amministratore tenta di utilizzare questo endpoint o quando vengono forniti un segreto o una chiave errati.

  • 500: InternalServerError.