Job Agents - Update

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Aktualizace agenta úloh.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
jobAgentName	path	True	string	Název agenta úloh, který se má aktualizovat.
resourceGroupName	path	True	string	Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API Resource Manager Azure nebo z portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Typ	Description
tags	object	Značky prostředků.

Odpovědi

Name	Typ	Description
200 OK	JobAgent	Agent úloh se úspěšně aktualizoval.
202 Accepted		Přijato
Other Status Codes		Chybové odpovědi: *** 400 InvalidResourceRequestBody – prostředek nebo vlastnosti prostředku v textu požadavku jsou prázdné nebo neplatné. 404 SubscriptionDoesNotHaveServer – Požadovaný server se nenašel. 404 ServerNotInSubscriptionResourceGroup – zadaný server v zadané skupině prostředků a předplatném neexistuje. 404 PropertyChangeUnsupported – Vlastnost nelze změnit. 404 JobAgentNotFound – Zadaný agent úloh na zadaném logickém serveru neexistuje. 404 OperationIdNotFound – operace s ID neexistuje. 409 ServerDisabled – Server je zakázaný. 409 OperationCancelled – operace byla zrušena uživatelem. 409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad maximální počet požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

Update a job agent's tags.

Ukázkový požadavek

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.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")), com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @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

Ukázková odpověď

Stavový kód:

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

Stavový kód:

202

Definice

Name	Description
JobAgent	Agent úloh Azure SQL.
JobAgentState	Stav agenta úloh.
JobAgentUpdate	Aktualizace agenta úloh Azure SQL.
Sku	Skladová položka prostředku ARM.

JobAgent

Object

Agent úloh Azure SQL.

Name	Typ	Description
id	string	ID prostředku.
location	string	Umístění prostředku.
name	string	Název prostředku.
properties.databaseId	string	ID prostředku databáze, do které se mají ukládat metadata úlohy.
properties.state	JobAgentState	Stav agenta úloh.
sku	Sku	Název a úroveň skladové položky.
tags	object	Značky prostředků.
type	string	Typ prostředku.

JobAgentState

Enumeration

Stav agenta úloh.

Hodnota	Description
Creating
Deleting
Disabled
Ready
Updating

JobAgentUpdate

Object

Aktualizace agenta úloh Azure SQL.

Name	Typ	Description
tags	object	Značky prostředků.

Sku

Object

Skladová položka prostředku ARM.

Name	Typ	Description
capacity	integer	Kapacita konkrétní skladové položky.
family	string	Pokud má služba různé generace hardwaru pro stejnou skladovou položku, můžete to tady zaznamenat.
name	string	Název skladové položky, obvykle písmeno + číslo, například P3.
size	string	Velikost konkrétní skladové položky
tier	string	Úroveň nebo edice konkrétní skladové položky, například Basic, Premium.