Job Agents - Get
Ottiene un agente di processo.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}?api-version=2025-01-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
job
|
path | True |
string |
Nome dell'agente di processo da recuperare. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole. |
|
server
|
path | True |
string |
Il nome del server. |
|
subscription
|
path | True |
string (uuid) |
ID della sottoscrizione di destinazione. Il valore deve essere un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
Operazione Azure completata con successo. |
|
| Other Status Codes |
Risposta di errore imprevista. |
Sicurezza
azure_auth
Azure Active Directory OAuth2 Flow.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome | Descrizione |
|---|---|
| user_impersonation | rappresentare l'account utente |
Esempio
Get a job agent
Esempio di richiesta
Risposta di esempio
{
"name": "agent1",
"type": "Microsoft.Sql/servers/jobAgents",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1",
"location": "southeastasia",
"properties": {
"databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
},
"sku": {
"name": "JA400",
"capacity": 400
}
}
Definizioni
| Nome | Descrizione |
|---|---|
|
created |
Tipo di identità che ha creato la risorsa. |
|
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
|
Error |
Dettagli dell'errore. |
|
Error |
Risposta di errore |
|
Job |
Un agente di lavoro Azure SQL. |
|
Job |
Azure Active Directory configurazione dell'identità per una risorsa. |
|
Job |
Tipo di identità dell'agente di processo |
|
Job |
Stato dell'agente di processo. |
|
Job |
Azure Active Directory configurazione dell'identità per una risorsa. |
| Sku |
SKU della risorsa ARM. |
|
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
createdByType
Tipo di identità che ha creato la risorsa.
| Valore | Descrizione |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
| Nome | Tipo | Descrizione |
|---|---|---|
| info |
object |
Informazioni aggiuntive. |
| type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
| Nome | Tipo | Descrizione |
|---|---|---|
| additionalInfo |
Informazioni aggiuntive sull'errore. |
|
| code |
string |
Codice di errore. |
| details |
Dettagli dell'errore. |
|
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Oggetto error. |
JobAgent
Un agente di lavoro Azure SQL.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string (arm-id) |
ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| identity |
Identità dell'agente processo. |
|
| location |
string |
Posizione geografica in cui risiede la risorsa |
| name |
string |
Nome della risorsa |
| properties.databaseId |
string (arm-id) |
ID risorsa del database in cui archiviare i metadati del processo. |
| properties.state |
Stato dell'agente di processo. |
|
| sku |
Nome e livello dello SKU. |
|
| systemData |
Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy. |
|
| tags |
object |
Tag di risorsa. |
| type |
string |
Tipo di risorsa. Ad esempio: "Microsoft. Compute/virtualMachines" oppure "Microsoft. Storage/storageAccounts" |
JobAgentIdentity
Azure Active Directory configurazione dell'identità per una risorsa.
| Nome | Tipo | Descrizione |
|---|---|---|
| tenantId |
string (uuid) |
ID tenant dell'identità dell'agente di processo |
| type |
Tipo di identità dell'agente di processo |
|
| userAssignedIdentities |
<string,
Job |
ID risorsa delle identità assegnate dall'utente da usare |
JobAgentIdentityType
Tipo di identità dell'agente di processo
| Valore | Descrizione |
|---|---|
| None |
Nessuno |
| SystemAssigned |
Assegnato dal sistema |
| UserAssigned |
UserAssigned |
| SystemAssignedUserAssigned |
SystemAssignedUserAssigned |
JobAgentState
Stato dell'agente di processo.
| Valore | Descrizione |
|---|---|
| Creating |
Creazione |
| Ready |
Ready |
| Updating |
Aggiornamento |
| Deleting |
Deleting |
| Disabled |
Disattivato |
JobAgentUserAssignedIdentity
Azure Active Directory configurazione dell'identità per una risorsa.
| Nome | Tipo | Descrizione |
|---|---|---|
| clientId |
string (uuid) |
L'ID client di Azure Active Directory. |
| principalId |
string (uuid) |
L'id principale di Azure Active Directory. |
Sku
SKU della risorsa ARM.
| Nome | Tipo | Descrizione |
|---|---|---|
| capacity |
integer (int32) |
Capacità dello SKU specifico. |
| family |
string |
Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. |
| name |
string |
Il nome dello SKU, in genere, una lettera + codice numerico, ad esempio P3. |
| size |
string |
Dimensioni dello SKU specifico |
| tier |
string |
Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium. |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
| Nome | Tipo | Descrizione |
|---|---|---|
| createdAt |
string (date-time) |
Timestamp della creazione della risorsa (UTC). |
| createdBy |
string |
Identità che ha creato la risorsa. |
| createdByType |
Tipo di identità che ha creato la risorsa. |
|
| lastModifiedAt |
string (date-time) |
Il timestamp dell'ultima modifica della risorsa (UTC) |
| lastModifiedBy |
string |
Identità che ha modificato l'ultima volta la risorsa. |
| lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |