你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Job Agents - Create Or Update

创建或更新作业代理。

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

URI 参数

Name In Required Type Description
jobAgentName
path True
  • string

要创建或更新的作业代理的名称。

resourceGroupName
path True
  • string

包含该资源的资源组名称。 可以从 Azure 资源管理器 API 或门户获取此值。

serverName
path True
  • string

服务器的名称。

subscriptionId
path True
  • string

用于标识 Azure 订阅的订阅 ID。

api-version
query True
  • string

要用于请求的 API 版本。

请求正文

Name Required Type Description
location True
  • string

资源位置。

properties.databaseId True
  • string

要在其中存储作业元数据的数据库的资源 ID。

sku

SKU 的名称和层。

tags
  • object

资源标记。

响应

Name Type Description
200 OK

已成功更新作业代理。

201 Created

已成功创建作业代理。

202 Accepted

已接受

Other Status Codes

错误响应: ***

  • 400 InvalidResourceRequestBody - 请求正文中的资源或资源属性为空或无效。

  • 400 MissingSkuName - Sku 名称是必需的。

  • 400 InvalidDatabaseResourceId - 数据库资源标识符无效。

  • 400 不匹配SubscriptionWithUrl - 提供的订阅与 URL 中的订阅不匹配。

  • 400 不匹配ResourceGroupNameWithUrl - 提供的资源组名称与 URL 中的名称不匹配。

  • 400 不匹配ServerNameWithUrl - 提供的服务器名称与 URL 中的名称不匹配。

  • 400 JobAgentDatabaseEditionUnsupported - 不支持指定数据库的服务级别目标用作作业代理数据库。

  • 400 JobAgentDatabaseSecondary - 无法将作业代理链接到异地辅助数据库。

  • 400 JobAgentDatabaseAlreadyLinked - 指定的数据库已链接到另一个作业代理。

  • 400 DatabaseDoesNotExist - 找不到请求的数据库

  • 400 CannotUseReservedDatabaseName - 不能在此操作中使用保留的数据库名称。

  • 400 JobAgentExceededQuota - 无法创建作业代理,因为它会超过配额。

  • 400 JobAgentAlreadyExists - 作业代理已存在于服务器上。

  • 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器

  • 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。

  • 404 PropertyChangeUnsupported - 无法修改属性。

  • 404 SubscriptionNotFound - 找不到请求的订阅。

  • 404 OperationIdNotFound - ID 的操作不存在。

  • 409 ServerDisabled - 服务器已禁用。

  • 409 OperationCancelled - 操作已被用户取消。

  • 409 OperationInterrupted - 无法完成资源上的操作,因为它被同一资源上的另一个操作中断。

  • 429 SubscriptionTooManyCreateUpdateRequests - 请求超出了可用资源可以处理的最大请求。

  • 429 SubscriptionTooManyRequests - 请求超出可用资源可处理的最大请求数。

  • 500 OperationTimedOut - 操作超时并自动回滚。 请重试该操作。

  • 503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。

示例

Create or update a job agent

Sample Request

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"
  }
}

Sample Response

{
  "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"
  }
}

定义

JobAgent

Azure SQL作业代理。

JobAgentState

作业代理的状态。

Sku

ARM 资源 SKU。

JobAgent

Azure SQL作业代理。

Name Type Description
id
  • string

资源 ID。

location
  • string

资源位置。

name
  • string

资源名称。

properties.databaseId
  • string

要在其中存储作业元数据的数据库的资源 ID。

properties.state

作业代理的状态。

sku

SKU 的名称和层。

tags
  • object

资源标记。

type
  • string

资源类型。

JobAgentState

作业代理的状态。

Name Type Description
Creating
  • string
Deleting
  • string
Disabled
  • string
Ready
  • string
Updating
  • string

Sku

ARM 资源 SKU。

Name Type Description
capacity
  • integer

特定 SKU 的容量。

family
  • string

如果服务具有不同代的硬件(对于同一 SKU,则可以在此处捕获)。

name
  • string

SKU 的名称,通常为字母 + 数字代码,例如 P3。

size
  • string

特定 SKU 的大小

tier
  • string

特定 SKU 的层或版本,例如基本版、高级版。