Compartir a través de


Job Agents - Create Or Update

Crea o actualiza un agente de trabajo.

PUT 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 crear o actualizar.

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.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
location True

string

Ubicación del recurso

properties.databaseId True

string

Identificador de recurso de la base de datos en el que almacenar los metadatos del trabajo.

sku

Sku

Nombre y nivel de la SKU.

tags

object

Etiquetas del recurso.

Respuestas

Nombre Tipo Description
200 OK

JobAgent

Se actualizó correctamente el agente de trabajo.

201 Created

JobAgent

Ha creado correctamente el agente de trabajo.

202 Accepted

Aceptado

Other Status Codes

Respuestas de error: ***

  • 400 InvalidResourceRequestBody: las propiedades de recurso o recurso del cuerpo de la solicitud están vacías o no son válidas.

  • 400 MissingSkuName: se requiere el nombre de Sku.

  • 400 InvalidDatabaseResourceId: identificador de recurso de base de datos no válido.

  • 400 No coincidentesSubscriptionWithUrl: la suscripción proporcionada no coincide con la suscripción en la dirección URL.

  • 400 No coincidentesResourceGroupNameWithUrl: el nombre del grupo de recursos proporcionado no coincide con el nombre de la dirección URL.

  • 400 No coincidentesServerNameWithUrl: el nombre del servidor proporcionado no coincide con el nombre de la dirección URL.

  • 400 JobAgentDatabaseEditionUnsupported: el objetivo de nivel de servicio de la base de datos especificado no se admite para su uso como base de datos del agente de trabajo.

  • 400 JobAgentDatabaseSecondary: un agente de trabajo no se puede vincular a una base de datos secundaria geográfica.

  • 400 JobAgentDatabaseAlreadyLinked: la base de datos especificada ya está vinculada a otro agente de trabajo.

  • 400 DatabaseDoesNotExist: no se encontró la base de datos solicitada.

  • 400 CannotUseReservedDatabaseName: no se puede usar el nombre reservado de la base de datos en esta operación.

  • 400 JobAgentExceededQuota: no se pudo crear el agente de trabajo porque superaría la cuota.

  • 400 JobAgentAlreadyExists: el agente de trabajo ya existe en el servidor.

  • 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 PropertyChangeUnsupported: no se puede modificar la propiedad.

  • 404 SubscriptionNotFound: no se encontró la suscripción solicitada.

  • 404 OperationIdNotFound: la operación con id. no existe.

  • 409 ServerDisabled: el servidor está deshabilitado.

  • 409 OperationCancelled: el usuario canceló la operación.

  • 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso.

  • 429 SuscripciónTooManyCreateUpdateRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.

  • 429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.

  • 500 OperationTimedOut: se agota el tiempo de espera de la operación y se revierte automáticamente. Vuelva a intentar la operación y,

  • 503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que se pueden procesar mediante recursos disponibles.

Ejemplos

Create or update a job agent

Solicitud de ejemplo

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

{
  "location": "southeastasia",
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  }
}

Respuesta de muestra

{
  "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": 100
  },
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  }
}
{
  "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": 100
  },
  "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 el que almacenar 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

El nivel o la edición de la SKU determinada, por ejemplo, Básico, Premium.