Job Agents - Update

Service:

SQL Database

API Version:

2021-11-01

匯報 作業代理程式。

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

URI 參數

名稱	位於	必要	類型	Description
jobAgentName	path	True	string	要更新之作業代理程序的名稱。
resourceGroupName	path	True	string	包含資源的資源群組名稱。 您可以從 Azure 資源管理員 API 或入口網站取得這個值。
serverName	path	True	string	伺服器的名稱。
subscriptionId	path	True	string	可識別 Azure 訂用帳戶的訂用帳戶識別碼。
api-version	query	True	string	要用於要求的 API 版本。

要求本文

名稱	類型	Description
tags	object	資源標籤。

回應

名稱	類型	Description
200 OK	JobAgent	已成功更新作業代理程式。
202 Accepted		已接受
Other Status Codes		錯誤回應： ≦ 400 InvalidResourceRequestBody - 要求本文中的資源或資源屬性是空的或無效的。 404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器 404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。 404 PropertyChangeUnsupported - 無法修改屬性。 404 JobAgentNotFound - 指定的作業代理程式不存在於指定的邏輯伺服器中。 404 OperationIdNotFound - 標識符為的作業不存在。 409 ServerDisabled - 伺服器已停用。 409 OperationCancelled - 使用者已取消作業。 409 OperationInterrupted - 無法完成資源上的作業，因為它被相同資源上的另一個作業中斷。 429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。 429 SubscriptionTooManyRequests - 超出可用資源可處理的最大要求。 500 OperationTimedOut - 作業逾時並自動回復。 請重試該作業。 503 TooManyRequests - 超出可用資源可處理之最大要求的要求。

範例

Update a job agent's tags.

Sample Request

HTTP

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

{
  "tags": {
    "mytag1": "myvalue1"
  }
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.JobAgentUpdate;
import java.util.HashMap;
import java.util.Map;

/** Samples for JobAgents Update. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/UpdateJobAgent.json
     */
    /**
     * Sample code: Update a job agent's tags.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAJobAgentSTags(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobAgents().update("group1", "server1", "agent1",
            new JobAgentUpdate().withTags(mapOf("mytag1", "myvalue1")), Context.NONE);
    }

    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

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

Status code:

202

定義

名稱	Description
JobAgent	Azure SQL 作業代理程式。
JobAgentState	作業代理程序的狀態。
JobAgentUpdate	Azure SQL 作業代理程式的更新。
Sku	ARM 資源 SKU。

JobAgent

Azure SQL 作業代理程式。

名稱	類型	Description
id	string	資源識別碼。
location	string	資源位置。
name	string	資源名稱。
properties.databaseId	string	要儲存作業元數據的資料庫資源標識碼。
properties.state	JobAgentState	作業代理程序的狀態。
sku	Sku	SKU 的名稱和層級。
tags	object	資源標籤。
type	string	資源類型。

JobAgentState

作業代理程序的狀態。

名稱	類型	Description
Creating	string
Deleting	string
Disabled	string
Ready	string
Updating	string

JobAgentUpdate

Azure SQL 作業代理程式的更新。

名稱	類型	Description
tags	object	資源標籤。

Sku

ARM 資源 SKU。

名稱	類型	Description
capacity	integer	特定 SKU 的容量。
family	string	如果服務有不同層代的硬體，則針對相同的SKU，則可以在這裡擷取。
name	string	SKU 的名稱，通常是字母 + 數字代碼，例如 P3。
size	string	特定 SKU 的大小
tier	string	特定 SKU 的層級或版本，例如基本、進階。