Job Agents - Get

  • Referencia
Servicio:
SQL Database
Versión de la API:
2021-11-01

Obtiene un agente de trabajo.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}?api-version=2021-11-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
jobAgentName
 path True

string

Nombre del agente de trabajo que se va a recuperar.
resourceGroupName
 path True

string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.
serverName
 path True

string

El nombre del servidor.
subscriptionId
 path True

string

El id. de suscripción que identifica una suscripción de Azure.
api-version
 query True

string

La versión de API que se usará para la solicitud.

Respuestas

Nombre Tipo Description
200 OK

JobAgent

Recuperó correctamente el agente de trabajo especificado.
Other Status Codes

Respuestas de error: ***

  • 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado

  • 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

  • 404 JobAgentNotFound: el agente de trabajo especificado no existe en el servidor lógico especificado.

  • 409 ServerDisabled: el servidor está deshabilitado.

Ejemplos

Get a job agent

Solicitud de ejemplo

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1?api-version=2021-11-01

Respuesta de muestra

status code:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1",
  "name": "agent1",
  "type": "Microsoft.Sql/servers/jobAgents",
  "location": "southeastasia",
  "sku": {
    "name": "Agent",
    "capacity": 400
  },
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  }
}

Definiciones

Nombre Description
JobAgent

Un agente de trabajo de Azure SQL.
JobAgentState

Estado del agente de trabajo.
Sku

Una SKU de recursos de ARM.

JobAgent

Un agente de trabajo de Azure SQL.

Nombre Tipo Description
id

string

Identificador del recurso.
location

string

Ubicación del recurso
name

string

Nombre del recurso.
properties.databaseId

string

Identificador de recurso de la base de datos en la que se almacenarán los metadatos del trabajo.
properties.state

JobAgentState

Estado del agente de trabajo.
sku

Sku

Nombre y nivel de la SKU.
tags

object

Etiquetas del recurso.
type

string

Tipo de recurso.

JobAgentState

Estado del agente de trabajo.

Nombre Tipo Description
Creating

string

Deleting

string

Disabled

string

Ready

string

Updating

string

Sku

Una SKU de recursos de ARM.

Nombre Tipo Description
capacity

integer

Capacidad de la SKU determinada.
family

string

Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.
name

string

El nombre de la SKU, normalmente, una letra + código numérico, por ejemplo, P3.
size

string

Tamaño de la SKU determinada
tier

string

Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium.