Compartir a través de

Job Agents - Get

  • Referencia
Servicio:
SQL Database
Versión de la API:
2023-08-01

Obtiene un agente de trabajo.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}?api-version=2023-08-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 desde la API de Azure Resource Manager o el portal.
serverName
 path True

string

Nombre del servidor.
subscriptionId
 path True

string

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

string

Versión de la API que se va a usar para la solicitud.

Respuestas

Nombre Tipo Description
200 OK

JobAgent

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

ErrorResponse

Respuestas de error: ***

  • 400 ManagedInstanceStoppingOrStopped: operación en conflicto enviada mientras la instancia está en estado de detención o detención

  • 400 ManagedInstanceStarting: operación en conflicto enviada mientras la instancia está en estado de inicio

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

  • 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado.

  • 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=2023-08-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": "JA400",
    "capacity": 400
  },
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  }
}

Definiciones

Nombre Description
ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.
ErrorDetail

Detalle del error.
ErrorResponse

Respuesta de error
JobAgent

Un agente de trabajo de Azure SQL.
JobAgentIdentity

Configuración de identidad de Azure Active Directory para un recurso.
JobAgentIdentityType

Tipo de identidad del agente de trabajo
JobAgentState

Estado del agente de trabajo.
JobAgentUserAssignedIdentity

Configuración de identidad de Azure Active Directory para un recurso.
Sku

Una SKU de recursos de ARM.

ErrorAdditionalInfo

Object

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.
type

string

Tipo de información adicional.

ErrorDetail

Object

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.
code

string

Código de error.
details

ErrorDetail[]

Detalles del error.
message

string

Mensaje de error.
target

string

Destino del error.

ErrorResponse

Object

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

JobAgent

Object

Un agente de trabajo de Azure SQL.

Nombre Tipo Description
id

string

Identificador de recurso.
identity

JobAgentIdentity

Identidad del agente de trabajo.
location

string

Ubicación del recurso.
name

string

Nombre del recurso.
properties.databaseId

string (arm-id)

Identificador de recurso de la base de datos en el 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 de recursos.
type

string

Tipo de recurso.

JobAgentIdentity

Object

Configuración de identidad de Azure Active Directory para un recurso.

Nombre Tipo Description
tenantId

string (uuid)

Identificador de inquilino de identidad del agente de trabajo
type

JobAgentIdentityType

Tipo de identidad del agente de trabajo
userAssignedIdentities

<string,  JobAgentUserAssignedIdentity>

Identificadores de recursos de las identidades asignadas por el usuario que se van a usar

JobAgentIdentityType

Enumeración

Tipo de identidad del agente de trabajo

Valor Description
None
SystemAssigned
SystemAssignedUserAssigned
UserAssigned

JobAgentState

Enumeración

Estado del agente de trabajo.

Valor Description
Creating
Deleting
Disabled
Ready
Updating

JobAgentUserAssignedIdentity

Object

Configuración de identidad de Azure Active Directory para un recurso.

Nombre Tipo Description
clientId

string (uuid)

Identificador de cliente de Azure Active Directory.
principalId

string (uuid)

Identificador de entidad de seguridad de Azure Active Directory.

Sku

Object

Una SKU de recursos de ARM.

Nombre Tipo Description
capacity

integer (int32)

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 de número, 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.