Compute Node - List

Elenca i nodi di calcolo nel pool specificato.

GET {batchUrl}/pools/{poolId}/nodes?api-version=2023-11-01.18.0
GET {batchUrl}/pools/{poolId}/nodes?$filter={$filter}&$select={$select}&maxresults={maxresults}&timeout={timeout}&api-version=2023-11-01.18.0

Parametri dell'URI

Nome In Necessario Tipo Descrizione
batchUrl
path True

string

URL di base per tutte le richieste di servizio Azure Batch.

poolId
path True

string

ID del pool da cui si desidera elencare nodi di calcolo.

api-version
query True

string

Versione dell'API client.

$filter
query

string

Clausola OData $filter. Per altre informazioni sulla costruzione di questo filtro, vedere https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-nodes-in-a-pool.

$select
query

string

Clausola di $select OData.

maxresults
query

integer

int32

Numero massimo di elementi da restituire nella risposta. È possibile restituire un massimo di 1000 nodi di calcolo.

timeout
query

integer

int32

Tempo massimo per cui il server può trascorrere l'elaborazione della richiesta, in secondi. Il valore predefinito è 30 secondi.

Intestazione della richiesta

Media Types: "application/json; odata=minimalmetadata"

Nome Necessario Tipo Descrizione
client-request-id

string

uuid

Identità richiesta generata dal chiamante, sotto forma di GUID senza decorazioni come parentesi graffe, ad esempio 9C4D50E-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Se il server deve restituire l'ID richiesta client nella risposta.

ocp-date

string

date-time-rfc1123

Ora in cui è stata eseguita la richiesta. Le librerie client in genere impostano l'ora dell'orologio del sistema corrente; impostarla in modo esplicito se si chiama direttamente l'API REST.

Risposte

Nome Tipo Descrizione
200 OK

ComputeNodeListResult

Risposta contenente l'elenco dei nodi di calcolo.

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
Other Status Codes

BatchError

Errore dal servizio Batch.

Sicurezza

azure_auth

Microsoft Entra flusso di codice di autenticazione OAuth 2.0

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Descrizione
user_impersonation Rappresentare l'account utente

Authorization

Type: apiKey
In: header

Esempio

Node list

Sample Request

GET account.region.batch.azure.com/pools/poolId/nodes?api-version=2023-11-01.18.0


Sample Response

{
  "value": [
    {
      "id": "tvm-1695681911_1-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2016-11-22T22:22:27.2236818Z",
      "lastBootTime": "2016-11-22T22:22:24.4634125Z",
      "allocationTime": "2016-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_1-20161122t193202z",
      "vmSize": "small",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2016-11-22T22:22:27.2236818Z",
        "endTime": "2016-11-22T22:22:27.567189Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2016-11-22T22:22:24.4634125Z"
      }
    },
    {
      "id": "tvm-1695681911_2-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2016-11-22T19:37:31.4285526Z",
      "lastBootTime": "2016-11-22T19:37:28.623369Z",
      "allocationTime": "2016-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_2-20161122t193202z",
      "vmSize": "small",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2016-11-22T19:37:31.4285526Z",
        "endTime": "2016-11-22T19:37:31.838028Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2016-11-22T22:22:24.4634125Z"
      }
    },
    {
      "id": "tvm-1695681911_3-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_3-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2016-11-22T19:36:51.0013378Z",
      "lastBootTime": "2016-11-22T19:36:48.21721Z",
      "allocationTime": "2016-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_3-20161122t193202z",
      "vmSize": "small",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2016-11-22T19:36:51.0013378Z",
        "endTime": "2016-11-22T19:36:51.2363447Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2016-11-22T22:22:24.4634125Z"
      }
    }
  ]
}

Definizioni

Nome Descrizione
AutoUserScope

Ambito dell'utente automatico

AutoUserSpecification

Specifica i parametri per l'utente automatico che esegue un'attività nel servizio Batch.

BatchError

Risposta di errore ricevuta dal servizio Azure Batch.

BatchErrorDetail

Elemento di informazioni aggiuntive incluse in una risposta di errore Azure Batch.

CertificateReference

Riferimento a un certificato da installare nei nodi di calcolo in un pool.

CertificateStoreLocation

Percorso dell'archivio certificati nel nodo di calcolo in cui installare il certificato.

CertificateVisibility

Quali account utente nel nodo di calcolo devono avere accesso ai dati privati del certificato.

ComputeNode

Nodo di calcolo nel servizio Batch.

ComputeNodeEndpointConfiguration

Configurazione dell'endpoint per il nodo di calcolo.

ComputeNodeError

Errore rilevato da un nodo di calcolo.

ComputeNodeIdentityReference

Riferimento a un'identità assegnata dall'utente associata al pool batch che verrà usato da un nodo di calcolo.

ComputeNodeListResult

Risultato dell'elenco dei nodi di calcolo in un pool.

ComputeNodeState

Stato corrente del nodo di calcolo.

ContainerRegistry

Registro contenitori privati.

ContainerWorkingDirectory

Percorso della directory di lavoro attività contenitore.

ElevationLevel

Livello di elevazione dell'utente.

EnvironmentSetting

Variabile di ambiente da impostare in un processo task.

ErrorCategory

Categoria dell'errore.

ErrorMessage

Messaggio di errore ricevuto in una risposta di errore Azure Batch.

ImageReference

Riferimento a un'immagine di Azure Macchine virtuali Marketplace o a un'immagine della raccolta di calcolo di Azure. Per ottenere l'elenco di tutti i riferimenti all'immagine Azure Marketplace verificati da Azure Batch, vedere l'operazione "Elenca immagini supportate".

InboundEndpoint

Endpoint in ingresso in un nodo di calcolo.

InboundEndpointProtocol

Protocollo dell'endpoint.

NameValuePair

Rappresenta una coppia nome/valore.

NodeAgentInformation

Informazioni sull'agente nodo di calcolo.

ResourceFile

Un singolo file o più file da scaricare in un nodo di calcolo.

SchedulingState

Indica se il nodo di calcolo è disponibile per la pianificazione delle attività.

StartTask

Attività eseguita quando un nodo aggiunge un pool nel servizio Azure Batch o quando il nodo di calcolo viene riavviato o ricreato.

StartTaskInformation

Informazioni su startTask in esecuzione in un nodo di calcolo.

StartTaskState

Stato di StartTask nel nodo di calcolo.

TaskContainerExecutionInformation

Contiene informazioni sul contenitore in cui è in esecuzione un'attività.

TaskContainerSettings

Impostazioni del contenitore per un'attività.

TaskExecutionInformation

Informazioni sull'esecuzione di un'attività.

TaskExecutionResult

Risultato dell'esecuzione dell'attività.

TaskFailureInformation

Informazioni su un errore dell'attività.

TaskInformation

Informazioni su un'attività in esecuzione in un nodo di calcolo.

TaskState

Stato dell'attività.

UserIdentity

Definizione dell'identità utente in cui viene eseguita l'attività.

VirtualMachineInfo

Informazioni sullo stato corrente della macchina virtuale.

AutoUserScope

Ambito dell'utente automatico

Nome Tipo Descrizione
pool

string

Specifica che l'attività viene eseguita come account utente automatico comune creato in ogni nodo di calcolo in un pool.

task

string

Specifica che il servizio deve creare un nuovo utente per l'attività.

AutoUserSpecification

Specifica i parametri per l'utente automatico che esegue un'attività nel servizio Batch.

Nome Tipo Descrizione
elevationLevel

ElevationLevel

Livello di elevazione dell'utente automatico.
Il valore predefinito nonAdmin.

scope

AutoUserScope

Ambito dell'utente automatico
Il valore predefinito è pool. Se il pool esegue Windows, è necessario specificare un valore di Task se è necessario un isolamento più rigoroso tra le attività. Ad esempio, se l'attività modifica il Registro di sistema in modo da influire su altre attività o se i certificati sono stati specificati nel pool che non devono essere accessibili dalle normali attività, ma devono essere accessibili da StartTasks.

BatchError

Risposta di errore ricevuta dal servizio Azure Batch.

Nome Tipo Descrizione
code

string

Identificatore dell'errore. I codici sono invarianti e devono essere usati a livello di codice.

message

ErrorMessage

Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

values

BatchErrorDetail[]

Raccolta di coppie chiave-valore contenenti dettagli aggiuntivi sull'errore.

BatchErrorDetail

Elemento di informazioni aggiuntive incluse in una risposta di errore Azure Batch.

Nome Tipo Descrizione
key

string

Identificatore che specifica il significato della proprietà Value.

value

string

Informazioni aggiuntive incluse nella risposta all'errore.

CertificateReference

Riferimento a un certificato da installare nei nodi di calcolo in un pool.

Nome Tipo Descrizione
storeLocation

CertificateStoreLocation

Percorso dell'archivio certificati nel nodo di calcolo in cui installare il certificato.
Il valore predefinito è currentuser. Questa proprietà è applicabile solo per i pool configurati con nodi di calcolo Windows, creati con cloudServiceConfiguration o con virtualMachineConfiguration usando un riferimento all'immagine di Windows. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire query per questa posizione. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente ,ad esempio /home/{user-name}/certs) e i certificati vengono inseriti in tale directory.

storeName

string

Nome dell'archivio certificati nel nodo di calcolo in cui installare il certificato.
Questa proprietà è applicabile solo per i pool configurati con nodi di calcolo Windows, creati con cloudServiceConfiguration o con virtualMachineConfiguration usando un riferimento all'immagine di Windows. I nomi comuni dell'archivio includono: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ma è anche possibile usare qualsiasi nome dell'archivio personalizzato. Il valore predefinito è My.

thumbprint

string

Identificazione personale del certificato.

thumbprintAlgorithm

string

Algoritmo con cui è associata l'identificazione personale. Questo deve essere sha1.

visibility

CertificateVisibility[]

Quale account utente nel nodo di calcolo deve avere accesso ai dati privati del certificato.
È possibile specificare più visibilità in questa raccolta. Il valore predefinito è tutti gli account.

CertificateStoreLocation

Percorso dell'archivio certificati nel nodo di calcolo in cui installare il certificato.

Nome Tipo Descrizione
currentuser

string

I certificati devono essere installati nell'archivio certificati CurrentUser.

localmachine

string

I certificati devono essere installati nell'archivio certificati LocalMachine.

CertificateVisibility

Quali account utente nel nodo di calcolo devono avere accesso ai dati privati del certificato.

Nome Tipo Descrizione
remoteuser

string

Il certificato deve essere visibile agli account utente in cui gli utenti accedono in remoto al nodo di calcolo.

starttask

string

Il certificato deve essere visibile all'account utente in cui viene eseguito StartTask. Si noti che se l'ambito dell'utente automatico è Pool sia per StartTask che per un'attività, questo certificato sarà visibile anche all'attività.

task

string

Il certificato deve essere visibile agli account utente in cui vengono eseguite le attività del processo.

ComputeNode

Nodo di calcolo nel servizio Batch.

Nome Tipo Descrizione
affinityId

string

Identificatore che può essere passato quando si aggiunge un'attività per richiedere che l'attività venga pianificata in questo nodo di calcolo.
Si noti che si tratta solo di un'affinità temporanea. Se il nodo di calcolo di destinazione è occupato o non disponibile al momento della pianificazione dell'attività, l'attività verrà pianificata altrove.

allocationTime

string

Ora in cui questo nodo di calcolo è stato allocato al pool.
Questo è il momento in cui il nodo di calcolo è stato inizialmente allocato e non cambia una volta impostato. Non viene aggiornato quando il nodo di calcolo è guarito o preceduto.

certificateReferences

CertificateReference[]

Elenco dei certificati installati nel nodo di calcolo.
Per i nodi di Windows, il servizio Batch installa i certificati nell'archivio certificati e nel percorso specificati. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire query per questa posizione. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente ,ad esempio /home/{user-name}/certs) e i certificati vengono inseriti in tale directory.

Avviso: questa proprietà è deprecata e verrà rimossa dopo febbraio 2024. Usare invece l'estensione Azure KeyVault .

endpointConfiguration

ComputeNodeEndpointConfiguration

Configurazione dell'endpoint per il nodo di calcolo.

errors

ComputeNodeError[]

Elenco degli errori attualmente rilevati dal nodo di calcolo.

id

string

ID del nodo di calcolo.
Ogni nodo di calcolo aggiunto a un pool viene assegnato un ID univoco. Ogni volta che un nodo di calcolo viene rimosso da un pool, tutti i file locali vengono eliminati e l'ID viene recuperato e potrebbe essere riutilizzato per i nuovi nodi di calcolo.

ipAddress

string

Indirizzo IP che altri nodi possono usare per comunicare con questo nodo di calcolo.
Ogni nodo di calcolo aggiunto a un pool viene assegnato un indirizzo IP univoco. Ogni volta che un nodo di calcolo viene rimosso da un pool, tutti i file locali vengono eliminati e l'indirizzo IP viene recuperato e potrebbe essere riutilizzato per i nuovi nodi di calcolo.

isDedicated

boolean

Se questo nodo di calcolo è un nodo di calcolo dedicato. Se false, il nodo di calcolo è un nodo di calcolo spot/con priorità bassa.

lastBootTime

string

Ultima volta in cui è stato avviato il nodo di calcolo.
Questa proprietà potrebbe non essere presente se lo stato del nodo di calcolo non è utilizzabile.

nodeAgentInfo

NodeAgentInformation

Informazioni sulla versione dell'agente del nodo di calcolo e sull'ora in cui il nodo di calcolo è stato aggiornato a una nuova versione.
L'agente nodo di calcolo Batch è un programma in esecuzione in ogni nodo di calcolo nel pool e offre funzionalità Batch nel nodo di calcolo.

recentTasks

TaskInformation[]

Elenco delle attività di cui è stato recentemente modificato lo stato.
Questa proprietà è presente solo se almeno un'attività è stata eseguita in questo nodo di calcolo perché è stata assegnata al pool.

runningTaskSlotsCount

integer

Numero totale di slot di pianificazione usati attualmente in esecuzione attività di processo nel nodo di calcolo. Sono incluse attività di Job Manager e attività normali, ma non preparazione processi, rilascio processi o attività di avvio.

runningTasksCount

integer

Numero totale di attività di processo attualmente in esecuzione nel nodo di calcolo. Sono incluse attività di Job Manager e attività normali, ma non preparazione processi, rilascio processi o attività di avvio.

schedulingState

SchedulingState

Indica se il nodo di calcolo è disponibile per la pianificazione delle attività.

startTask

StartTask

L'attività specificata per l'esecuzione nel nodo di calcolo durante il join del pool.
Batch ritenta attività quando viene attivata un'operazione di ripristino in un nodo. Alcuni esempi di operazioni di ripristino includono (ma non sono limitati a) quando un nodo non integro viene riavviato o un nodo di calcolo scomparso a causa di un errore host. I tentativi dovuti alle operazioni di ripristino sono indipendenti da e non vengono conteggiati rispetto al maxTaskRetryCount. Anche se maxTaskRetryCount è 0, potrebbe verificarsi un tentativo interno a causa di un'operazione di ripristino. A causa di questo, tutte le attività devono essere idempotenti. Ciò significa che le attività devono tollerare l'interruzione e il riavvio senza causare alcun danneggiamento o dati duplicati. La procedura consigliata per le attività a esecuzione prolungata consiste nell'usare una forma di checkpoint. In alcuni casi, startTask può essere eseguito nuovamente anche se il nodo di calcolo non è stato riavviato. È consigliabile prestare particolare attenzione per evitare StartTasks che creano processi di interruzione o installano/avviano i servizi dalla directory di lavoro StartTask, in quanto questo impedisce a Batch di essere in grado di eseguire nuovamente StartTask.

startTaskInfo

StartTaskInformation

Informazioni di runtime sull'esecuzione di StartTask nel nodo di calcolo.

state

ComputeNodeState

Stato corrente del nodo di calcolo.
Il nodo di calcolo con priorità spot/bassa è stato preceduto. Le attività in esecuzione nel nodo di calcolo quando è stato preceduto verranno riprogrammate quando un altro nodo di calcolo diventa disponibile.

stateTransitionTime

string

Ora in cui il nodo di calcolo ha immesso lo stato corrente.

totalTasksRun

integer

Numero totale di attività di processo completate nel nodo di calcolo. Sono incluse attività di Job Manager e attività normali, ma non preparazione processi, rilascio processi o attività di avvio.

totalTasksSucceeded

integer

Numero totale di attività del processo che sono state completate correttamente (con exitCode 0) nel nodo di calcolo. Sono incluse attività di Job Manager e attività normali, ma non preparazione processi, rilascio processi o attività di avvio.

url

string

URL del nodo di calcolo.

virtualMachineInfo

VirtualMachineInfo

Informazioni sullo stato corrente della macchina virtuale.

vmSize

string

Dimensioni della macchina virtuale che ospita il nodo di calcolo.
Per informazioni sulle dimensioni disponibili delle macchine virtuali nei pool, vedere Scegliere una dimensione della macchina virtuale per i nodi di calcolo in un pool di Azure Batch (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).

ComputeNodeEndpointConfiguration

Configurazione dell'endpoint per il nodo di calcolo.

Nome Tipo Descrizione
inboundEndpoints

InboundEndpoint[]

Elenco di endpoint in ingresso accessibili nel nodo di calcolo.

ComputeNodeError

Errore rilevato da un nodo di calcolo.

Nome Tipo Descrizione
code

string

Identificatore per l'errore del nodo di calcolo. I codici sono invarianti e devono essere usati a livello di codice.

errorDetails

NameValuePair[]

Elenco di dettagli di errore aggiuntivi correlati all'errore del nodo di calcolo.

message

string

Messaggio che descrive l'errore del nodo di calcolo, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

ComputeNodeIdentityReference

Riferimento a un'identità assegnata dall'utente associata al pool batch che verrà usato da un nodo di calcolo.

Nome Tipo Descrizione
resourceId

string

ID risorsa ARM dell'identità assegnata dall'utente.

ComputeNodeListResult

Risultato dell'elenco dei nodi di calcolo in un pool.

Nome Tipo Descrizione
odata.nextLink

string

URL per ottenere il set successivo di risultati.

value

ComputeNode[]

Elenco dei nodi di calcolo.

ComputeNodeState

Stato corrente del nodo di calcolo.

Nome Tipo Descrizione
creating

string

Il servizio Batch ha ottenuto la macchina virtuale sottostante da Calcolo di Azure, ma non ha ancora avviato l'aggiunta al pool.

idle

string

Il nodo di calcolo non esegue attualmente un'attività.

leavingpool

string

Il nodo di calcolo sta lasciando il pool, perché l'utente lo ha rimosso in modo esplicito o perché il ridimensionamento o la scalabilità automatica del pool.

offline

string

Il nodo di calcolo non esegue attualmente un'attività e la pianificazione delle nuove attività nel nodo di calcolo è disabilitata.

preempted

string

Il nodo di calcolo con priorità spot/bassa è stato preceduto. Le attività in esecuzione nel nodo di calcolo quando è stato preceduto verranno riprogrammate quando un altro nodo di calcolo diventa disponibile.

rebooting

string

Il nodo di calcolo viene riavviato.

reimaging

string

Il nodo di calcolo è reimaging.

running

string

Il nodo di calcolo esegue una o più attività (diversa da startTask).

starting

string

Il servizio Batch viene avviato nella macchina virtuale sottostante.

starttaskfailed

string

StartTask non è riuscito nel nodo di calcolo (ed è stato esaurito tutti i tentativi) e waitForSuccess è impostato. Il nodo di calcolo non è utilizzabile per l'esecuzione di attività.

unknown

string

Il servizio Batch ha perso contatto con il nodo di calcolo e non conosce il relativo stato vero.

unusable

string

Impossibile usare il nodo di calcolo per l'esecuzione dell'attività a causa di errori.

waitingforstarttask

string

StartTask ha avviato l'esecuzione nel nodo di calcolo, ma waitForSuccess è impostato e StartTask non è ancora stato completato.

ContainerRegistry

Registro contenitori privati.

Nome Tipo Descrizione
identityReference

ComputeNodeIdentityReference

Riferimento all'identità assegnata dall'utente da usare per accedere a un Registro Azure Container anziché al nome utente e alla password.
Riferimento a un'identità assegnata dall'utente associata al pool batch che verrà usato da un nodo di calcolo.

password

string

Password per accedere al server del Registro di sistema.

registryServer

string

URL del Registro di sistema.
Se omesso, il valore predefinito è "docker.io".

username

string

Nome utente da accedere al server del Registro di sistema.

ContainerWorkingDirectory

Percorso della directory di lavoro attività contenitore.

Nome Tipo Descrizione
containerImageDefault

string

Usare la directory di lavoro definita nell'immagine del contenitore. Tenere presente che questa directory non conterrà i file di risorse scaricati da Batch.

taskWorkingDirectory

string

Usare la directory di lavoro dell'attività del servizio Batch standard, che conterrà i file di risorse attività popolati da Batch.

ElevationLevel

Livello di elevazione dell'utente.

Nome Tipo Descrizione
admin

string

L'utente è un utente con accesso con privilegi elevati e opera con autorizzazioni di amministratore complete.

nonadmin

string

L'utente è un utente standard senza accesso con privilegi elevati.

EnvironmentSetting

Variabile di ambiente da impostare in un processo task.

Nome Tipo Descrizione
name

string

Nome della variabile di ambiente.

value

string

Valore della variabile di ambiente.

ErrorCategory

Categoria dell'errore.

Nome Tipo Descrizione
servererror

string

L'errore è dovuto a un problema interno del server.

usererror

string

L'errore è dovuto a un problema dell'utente, ad esempio la configurazione errata.

ErrorMessage

Messaggio di errore ricevuto in una risposta di errore Azure Batch.

Nome Tipo Descrizione
lang

string

Codice del linguaggio del messaggio di errore

value

string

Testo del messaggio.

ImageReference

Riferimento a un'immagine di Azure Macchine virtuali Marketplace o a un'immagine della raccolta di calcolo di Azure. Per ottenere l'elenco di tutti i riferimenti all'immagine Azure Marketplace verificati da Azure Batch, vedere l'operazione "Elenca immagini supportate".

Nome Tipo Descrizione
exactVersion

string

Versione specifica dell'immagine della piattaforma o dell'immagine del marketplace usata per creare il nodo. Questo campo di sola lettura differisce da 'version' solo se il valore specificato per 'version' quando il pool è stato creato è stato 'latest'.

offer

string

Tipo di offerta dell'immagine di Azure Macchine virtuali Marketplace.
Ad esempio, UbuntuServer o WindowsServer.

publisher

string

Autore dell'immagine di Azure Macchine virtuali Marketplace.
Ad esempio, Canonico o MicrosoftWindowsServer.

sku

string

SKU dell'immagine di Azure Macchine virtuali Marketplace.
Ad esempio, 18.04-LTS o 2019-Datacenter.

version

string

Versione dell'immagine di Azure Macchine virtuali Marketplace.
È possibile specificare un valore "latest" per selezionare la versione più recente di un'immagine. Se omesso, il valore predefinito è 'latest'.

virtualMachineImageId

string

Identificatore di risorsa ARM dell'immagine della raccolta di calcolo di Azure. I nodi di calcolo nel pool verranno creati usando questo ID immagine. Si tratta del modulo /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/version/{VersionId} o /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName} per la definizione predefinita della versione dell'immagine più recente.
Questa proprietà si escludono a vicenda con altre proprietà ImageReference. L'immagine della raccolta di calcolo di Azure deve avere repliche nella stessa area e deve trovarsi nella stessa sottoscrizione dell'account Azure Batch. Se la versione dell'immagine non è specificata nell'imageId, verrà usata la versione più recente. Per informazioni sulle impostazioni del firewall per l'agente nodo di calcolo Batch per comunicare con il servizio Batch, vedere https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

InboundEndpoint

Endpoint in ingresso in un nodo di calcolo.

Nome Tipo Descrizione
backendPort

integer

Numero di porta back-end dell'endpoint.

frontendPort

integer

Numero di porta pubblica dell'endpoint.

name

string

Nome dell'endpoint.

protocol

InboundEndpointProtocol

Protocollo dell'endpoint.

publicFQDN

string

Nome di dominio completo pubblico per il nodo di calcolo.

publicIPAddress

string

Indirizzo IP pubblico del nodo di calcolo.

InboundEndpointProtocol

Protocollo dell'endpoint.

Nome Tipo Descrizione
tcp

string

Usare TCP per l'endpoint.

udp

string

Usare UDP per l'endpoint.

NameValuePair

Rappresenta una coppia nome/valore.

Nome Tipo Descrizione
name

string

Nome nella coppia nome-valore.

value

string

Valore nella coppia nome-valore.

NodeAgentInformation

Informazioni sull'agente nodo di calcolo.

Nome Tipo Descrizione
lastUpdateTime

string

Ora in cui l'agente nodo di calcolo è stato aggiornato nel nodo di calcolo.
Si tratta dell'ora più recente in cui l'agente nodo di calcolo è stato aggiornato a una nuova versione.

version

string

Versione dell'agente del nodo di calcolo Batch in esecuzione nel nodo di calcolo.
Questo numero di versione può essere controllato con le note sulla versione dell'agente del nodo di calcolo disponibili in https://github.com/Azure/Batch/blob/master/changelogs/nodeagent/CHANGELOG.md.

ResourceFile

Un singolo file o più file da scaricare in un nodo di calcolo.

Nome Tipo Descrizione
autoStorageContainerName

string

Nome del contenitore di archiviazione nell'account di archiviazione automatica.
Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl si escludono a vicenda e una di esse deve essere specificata.

blobPrefix

string

Prefisso BLOB da usare durante il download di BLOB da un contenitore di Archiviazione di Azure. Verranno scaricati solo i BLOB i cui nomi iniziano con il prefisso specificato.
La proprietà è valida solo quando si usa autoStorageContainerName o storageContainerUrl. Questo prefisso può essere un nome file parziale o una sottodirectory. Se non viene specificato un prefisso, verranno scaricati tutti i file nel contenitore.

fileMode

string

Attributo della modalità di autorizzazione file in formato ottale.
Questa proprietà si applica solo ai file scaricati nei nodi di calcolo Linux. Verrà ignorato se viene specificato per un resourceFile che verrà scaricato in un nodo di calcolo Windows. Se questa proprietà non viene specificata per un nodo di calcolo Linux, al file viene applicato il valore predefinito 0770.

filePath

string

Percorso nel nodo di calcolo in cui scaricare i file rispetto alla directory di lavoro dell'attività.
Se viene specificata la proprietà httpUrl, filePath è obbligatorio e descrive il percorso in cui verrà scaricato il file, incluso il nome file. In caso contrario, se viene specificata la proprietà autoStorageContainerName o storageContainerUrl, filePath è facoltativo ed è la directory in cui scaricare i file. Nel caso in cui filePath venga usato come directory, tutte le strutture di directory già associate ai dati di input verranno mantenute complete e aggiunte alla directory filePath specificata. Il percorso relativo specificato non può uscire dalla directory di lavoro dell'attività, ad esempio utilizzando '.'.

httpUrl

string

URL del file da scaricare.
Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl si escludono a vicenda e una di esse deve essere specificata. Se l'URL punta a Archiviazione BLOB di Azure, deve essere leggibile dai nodi di calcolo. Esistono tre modi per ottenere tale URL per un BLOB nell'archiviazione di Azure: includere una firma di accesso condiviso che concede le autorizzazioni di lettura per il BLOB, usare un'identità gestita con autorizzazione di lettura o impostare l'ACL per il BLOB o il relativo contenitore per consentire l'accesso pubblico.

identityReference

ComputeNodeIdentityReference

Riferimento all'identità assegnata dall'utente da usare per accedere ai Archiviazione BLOB di Azure specificati da storageContainerUrl o httpUrl
Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.

storageContainerUrl

string

URL del contenitore BLOB all'interno di Archiviazione BLOB di Azure.
Le proprietà autoStorageContainerName, storageContainerUrl e httpUrl si escludono a vicenda e una di esse deve essere specificata. Questo URL deve essere leggibile ed elencabile dai nodi di calcolo. Esistono tre modi per ottenere tale URL per un contenitore in Archiviazione di Azure: includere una firma di accesso condiviso che concede autorizzazioni di lettura ed elenco per il contenitore, usare un'identità gestita con autorizzazioni di lettura ed elenco o impostare l'ACL per il contenitore per consentire l'accesso pubblico.

SchedulingState

Indica se il nodo di calcolo è disponibile per la pianificazione delle attività.

Nome Tipo Descrizione
disabled

string

Nessuna nuova attività verrà pianificata nel nodo di calcolo. Le attività già in esecuzione nel nodo di calcolo possono comunque essere eseguite al completamento. Tutti i nodi di calcolo iniziano con la pianificazione abilitata.

enabled

string

Le attività possono essere pianificate nel nodo di calcolo.

StartTask

Attività eseguita quando un nodo aggiunge un pool nel servizio Azure Batch o quando il nodo di calcolo viene riavviato o ricreato.

Nome Tipo Descrizione
commandLine

string

Riga di comando di StartTask.
La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux. Se la riga di comando fa riferimento ai percorsi di file, deve usare un percorso relativo (rispetto alla directory di lavoro attività) o usare la variabile di ambiente fornita da Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

containerSettings

TaskContainerSettings

Impostazioni per il contenitore in cui viene eseguito StartTask.
Quando viene specificato, tutte le directory vengono mappate in modo ricorsivo al di sotto del AZ_BATCH_NODE_ROOT_DIR (la radice delle directory di Azure Batch nel nodo) vengono mappate nel contenitore, tutte le variabili di ambiente attività vengono mappate nel contenitore e la riga di comando attività viene eseguita nel contenitore. I file generati nel contenitore all'esterno di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi nel disco host, ovvero le API file batch non potranno accedere a tali file.

environmentSettings

EnvironmentSetting[]

Elenco delle impostazioni delle variabili di ambiente per StartTask.

maxTaskRetryCount

integer

Numero massimo di tentativi di ripetizione dell'attività.
Il servizio Batch esegue il tentativo di un'attività se il codice di uscita è diverso da zero. Si noti che questo valore controlla specificamente il numero di tentativi. Il servizio Batch tenterà l'attività una sola volta e potrebbe quindi riprovare fino a questo limite. Ad esempio, se il numero massimo di tentativi è 3, Batch prova l'attività fino a 4 volte (un tentativo iniziale e 3 tentativi). Se il numero massimo di tentativi è 0, il servizio Batch non riprova l'attività. Se il numero massimo di tentativi è -1, il servizio Batch esegue il tentativo dell'attività senza limiti, ma non è consigliabile per un'attività di avvio o per qualsiasi attività. Il valore predefinito è 0, ovvero nessun tentativo.

resourceFiles

ResourceFile[]

Elenco di file scaricati dal servizio Batch nel nodo di calcolo prima di eseguire la riga di comando. È disponibile una dimensione massima per l'elenco dei file di risorse. Quando la dimensione massima viene superata, la richiesta avrà esito negativo e il codice di errore della risposta sarà RequestEntityTooLarge. In questo caso, la raccolta di ResourceFiles deve essere ridotta in dimensioni. Ciò può essere ottenuto usando i file .zip, i pacchetti applicazione o i contenitori Docker.
I file elencati in questo elemento si trovano nella directory di lavoro dell'attività.

userIdentity

UserIdentity

Identità utente in cui viene eseguito StartTask.
Se omesso, l'attività viene eseguita come utente non amministrativo univoco per l'attività.

waitForSuccess

boolean

Se il servizio Batch deve attendere che StartTask venga completato correttamente, ovvero per uscire con il codice di uscita 0) prima di pianificare qualsiasi attività nel nodo di calcolo.
Se true e StartTask ha esito negativo in un nodo, il servizio Batch esegue il tentativo startTask fino al numero massimo di tentativi (maxTaskRetryCount). Se l'attività non è ancora stata completata dopo tutti i tentativi, il servizio Batch contrassegna il nodo non utilizzabile e non pianifica attività. Questa condizione può essere rilevata tramite lo stato del nodo di calcolo e i dettagli sulle informazioni sugli errori. Se false, il servizio Batch non attenderà il completamento di StartTask. In questo caso, altre attività possono iniziare a eseguire nel nodo di calcolo mentre StartTask è ancora in esecuzione; e anche se StartTask ha esito negativo, le nuove attività continueranno a essere pianificate nel nodo di calcolo. Il valore predefinito è true.

StartTaskInformation

Informazioni su startTask in esecuzione in un nodo di calcolo.

Nome Tipo Descrizione
containerInfo

TaskContainerExecutionInformation

Informazioni sul contenitore in cui è in esecuzione l'attività.
Questa proprietà viene impostata solo se l'attività viene eseguita in un contesto del contenitore.

endTime

string

Ora in cui StartTask ha arrestato l'esecuzione.
Questa è l'ora di fine dell'esecuzione più recente di StartTask, se l'esecuzione è stata completata (anche se l'esecuzione non è riuscita e un nuovo tentativo è in sospeso). Questo elemento non è presente se StartTask è attualmente in esecuzione.

exitCode

integer

Codice di uscita del programma specificato nella riga di comando StartTask.
Questa proprietà viene impostata solo se StartTask è nello stato completato. In generale, il codice di uscita per un processo riflette la convenzione specifica implementata dallo sviluppatore di applicazioni per tale processo. Se si usa il valore del codice di uscita per prendere decisioni nel codice, assicurarsi di conoscere la convenzione di uscita del codice utilizzata dal processo dell'applicazione. Tuttavia, se il servizio Batch termina startTask (a causa del timeout o della terminazione dell'utente tramite l'API) potrebbe essere visualizzato un codice di uscita definito dal sistema operativo.

failureInfo

TaskFailureInformation

Informazioni che descrivono l'errore dell'attività, se presente.
Questa proprietà viene impostata solo se l'attività è nello stato completato e ha rilevato un errore.

lastRetryTime

string

Ora più recente in cui è stato avviato un nuovo tentativo dell'attività.
Questo elemento è presente solo se l'oggetto Task è stato riprovato (ad esempio, retryCount è diverso da zero). Se presente, questa operazione è in genere uguale a startTime, ma può essere diversa se l'attività è stata riavviata per motivi diversi da quelli di ripetizione; Ad esempio, se il nodo di calcolo è stato riavviato durante un nuovo tentativo, l'avvioTime viene aggiornato ma l'ultimoRetryTime non è.

result

TaskExecutionResult

Risultato dell'esecuzione dell'attività.
Se il valore è "non riuscito", i dettagli dell'errore sono disponibili nella proprietà failureInfo.

retryCount

integer

Numero di tentativi di ripetizione dell'attività dal servizio Batch.
Gli errori dell'applicazione attività (codice di uscita non zero) vengono riprovati, vengono rieseguati errori di pre-elaborazione (impossibile eseguire l'attività) e non vengono riprovati gli errori di caricamento dei file. Il servizio Batch ritenta l'attività fino al limite specificato dai vincoli.

startTime

string

Ora in cui startTask ha avviato l'esecuzione.
Questo valore viene reimpostato ogni volta che l'attività viene riavviata o riprovata, ovvero questa è l'ora più recente in cui startTask ha avviato l'esecuzione.

state

StartTaskState

Stato di StartTask nel nodo di calcolo.

StartTaskState

Stato di StartTask nel nodo di calcolo.

Nome Tipo Descrizione
completed

string

StartTask è stato chiuso con codice di uscita 0 oppure StartTask non è riuscito e il limite di ripetizione dei tentativi è stato raggiunto oppure il processo StartTask non è stato eseguito a causa di errori di preparazione delle attività ,ad esempio errori di download del file di risorse.

running

string

StartTask è attualmente in esecuzione.

TaskContainerExecutionInformation

Contiene informazioni sul contenitore in cui è in esecuzione un'attività.

Nome Tipo Descrizione
containerId

string

ID del contenitore.

error

string

Informazioni dettagliate sull'errore sul contenitore.
Questa è la stringa di errore dettagliata del servizio Docker, se disponibile. Equivale al campo di errore restituito da "docker inspect".

state

string

Stato del contenitore.
Questo è lo stato del contenitore in base al servizio Docker. Equivale al campo di stato restituito da "docker inspect".

TaskContainerSettings

Impostazioni del contenitore per un'attività.

Nome Tipo Descrizione
containerRunOptions

string

Opzioni aggiuntive per il comando create del contenitore.
Queste opzioni aggiuntive vengono fornite come argomenti al comando "docker create", oltre a quelli controllati dal servizio Batch.

imageName

string

Immagine da usare per creare il contenitore in cui verrà eseguita l'attività.
Questo è il riferimento completo all'immagine, come verrebbe specificato in "docker pull". Se non viene fornito alcun tag come parte del nome immagine, il tag ":latest" viene usato come valore predefinito.

registry

ContainerRegistry

Registro privato che contiene l'immagine del contenitore.
Questa impostazione può essere omessa se è già stata specificata durante la creazione del pool.

workingDirectory

ContainerWorkingDirectory

Percorso della directory di lavoro dell'attività contenitore.
Il valore predefinito è "taskWorkingDirectory".

TaskExecutionInformation

Informazioni sull'esecuzione di un'attività.

Nome Tipo Descrizione
containerInfo

TaskContainerExecutionInformation

Informazioni sul contenitore in cui è in esecuzione l'attività.
Questa proprietà viene impostata solo se l'attività viene eseguita in un contesto contenitore.

endTime

string

Ora in cui l'attività è stata completata.
Questa proprietà viene impostata solo se l'oggetto Task è nello stato Completato.

exitCode

integer

Codice di uscita del programma specificato nella riga di comando Task.
Questa proprietà viene impostata solo se l'oggetto Task è nello stato completato. In generale, il codice di uscita per un processo riflette la convenzione specifica implementata dallo sviluppatore dell'applicazione per tale processo. Se si usa il valore del codice di uscita per prendere decisioni nel codice, assicurarsi di conoscere la convenzione di codice di uscita usata dal processo dell'applicazione. Tuttavia, se il servizio Batch termina l'attività (a causa del timeout o della chiusura dell'utente tramite l'API), è possibile che venga visualizzato un codice di uscita definito dal sistema operativo.

failureInfo

TaskFailureInformation

Informazioni che descrivono l'errore dell'attività, se presenti.
Questa proprietà viene impostata solo se l'oggetto Task è nello stato completato e si è verificato un errore.

lastRequeueTime

string

L'ora più recente in cui l'attività è stata accodata dal servizio Batch come risultato di una richiesta dell'utente.
Questa proprietà viene impostata solo se requeueCount è diverso da zero.

lastRetryTime

string

Ora più recente in cui è stata avviata l'esecuzione di un nuovo tentativo dell'attività.
Questo elemento è presente solo se l'attività è stata ritentata (ad esempio, retryCount è diverso da zero). Se presente, si tratta in genere dello stesso valore di startTime, ma può essere diverso se l'attività è stata riavviata per motivi diversi dai tentativi; Ad esempio, se il nodo di calcolo è stato riavviato durante un nuovo tentativo, startTime viene aggiornato ma lastRetryTime non è.

requeueCount

integer

Numero di volte in cui l'attività è stata accodata dal servizio Batch come risultato di una richiesta dell'utente.
Quando l'utente rimuove i nodi di calcolo da un pool (ridimensionando/compattando il pool) o quando il processo è disabilitato, l'utente può specificare che l'esecuzione di attività nei nodi di calcolo deve essere rimessa in coda per l'esecuzione. Questo conteggio tiene traccia del numero di volte in cui l'attività è stata riquedata per questi motivi.

result

TaskExecutionResult

Risultato dell'esecuzione dell'attività.
Se il valore è "failed", i dettagli dell'errore sono disponibili nella proprietà failureInfo.

retryCount

integer

Numero di tentativi di ripetizione dell'attività da parte del servizio Batch.
Gli errori dell'applicazione attività (codice di uscita diverso da zero) vengono ritentati, si verificano errori di pre-elaborazione (non è stato possibile eseguire l'attività) e gli errori di caricamento dei file non vengono ritentati. Il servizio Batch ritenta l'attività fino al limite specificato dai vincoli.

startTime

string

Ora in cui è stata avviata l'esecuzione dell'attività.
'Running' corrisponde allo stato in esecuzione, quindi se l'attività specifica i file di risorse o i pacchetti, l'ora di inizio riflette l'ora di inizio in cui l'attività ha iniziato a scaricare o distribuire questi file. Se l'attività è stata riavviata o ritentata, si tratta dell'ora più recente in cui l'attività è stata avviata. Questa proprietà è presente solo per Attività che si trovano nello stato in esecuzione o completato.

TaskExecutionResult

Risultato dell'esecuzione dell'attività.

Nome Tipo Descrizione
failure

string

Errore durante l'elaborazione dell'attività. L'errore potrebbe essersi verificato prima dell'avvio del processo attività, durante l'esecuzione del processo attività o dopo l'uscita del processo attività.

success

string

L'attività è stata eseguita correttamente.

TaskFailureInformation

Informazioni su un errore dell'attività.

Nome Tipo Descrizione
category

ErrorCategory

Categoria dell'errore attività.

code

string

Identificatore per l'errore dell'attività. I codici sono invarianti e devono essere utilizzati a livello di codice.

details

NameValuePair[]

Elenco di dettagli aggiuntivi relativi all'errore.

message

string

Messaggio che descrive l'errore dell'attività, che deve essere adatto per la visualizzazione in un'interfaccia utente.

TaskInformation

Informazioni su un'attività in esecuzione in un nodo di calcolo.

Nome Tipo Descrizione
executionInfo

TaskExecutionInformation

Informazioni sull'esecuzione dell'attività.

jobId

string

ID del processo a cui appartiene l'attività.

subtaskId

integer

ID della sottotask se l'attività è un'attività a più istanze.

taskId

string

ID dell'attività.

taskState

TaskState

Stato corrente dell'attività.

taskUrl

string

URL dell'attività.

TaskState

Stato dell'attività.

Nome Tipo Descrizione
active

string

L'attività viene accodata e in grado di eseguire, ma non è attualmente assegnata a un nodo di calcolo. Un'attività entra in questo stato quando viene creata, quando è abilitata dopo essere disabilitata o quando è in attesa di un nuovo tentativo dopo un'esecuzione non riuscita.

completed

string

L'attività non è più idonea per l'esecuzione, in genere perché l'attività è stata completata correttamente o l'attività ha terminato correttamente e ha esaurito il limite di tentativi. Un'attività viene contrassegnata anche come completata se si è verificato un errore durante l'avvio dell'attività o quando l'attività è stata terminata.

preparing

string

L'attività è stata assegnata a un nodo di calcolo, ma è in attesa del completamento di un'attività di preparazione del processo necessaria nel nodo di calcolo. Se l'attività preparazione processo ha esito positivo, l'attività verrà spostata in esecuzione. Se l'attività preparazione processo ha esito negativo, l'attività tornerà attiva e sarà idonea per essere assegnata a un nodo di calcolo diverso.

running

string

L'attività è in esecuzione in un nodo di calcolo. Ciò include la preparazione a livello di attività, ad esempio il download di file di risorse o la distribuzione di pacchetti specificati nell'attività, non significa necessariamente che la riga di comando attività abbia avviato l'esecuzione.

UserIdentity

Definizione dell'identità utente in cui viene eseguita l'attività.

Nome Tipo Descrizione
autoUser

AutoUserSpecification

Utente automatico con cui viene eseguita l'attività.
Le proprietà userName e autoUser si escludono a vicenda; è necessario specificarne uno, ma non entrambi.

username

string

Nome dell'identità utente in cui viene eseguita l'attività.
Le proprietà userName e autoUser si escludono a vicenda; è necessario specificarne uno, ma non entrambi.

VirtualMachineInfo

Informazioni sullo stato corrente della macchina virtuale.

Nome Tipo Descrizione
imageReference

ImageReference

Riferimento all'immagine del Marketplace della macchina virtuale di Azure.

scaleSetVmResourceId

string

ID risorsa della macchina virtuale corrente del set di scalabilità di macchine virtuali del nodo di calcolo. Definito solo se l'account Batch è stato creato con la relativa proprietà poolAllocationMode impostata su 'UserSubscription'.