Job Agents - Update

Service:

SQL Database

API Version:

2021-11-01

Aktualizacje agenta zadań.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
jobAgentName	path	True	string	Nazwa agenta zadania do zaktualizowania.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu.
serverName	path	True	string	Nazwa serwera.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa	Typ	Opis
tags	object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	JobAgent	Pomyślnie zaktualizowano agenta zadania.
202 Accepted		Zaakceptowano
Other Status Codes		Odpowiedzi na błędy: *** 400 InvalidResourceRequestBody — właściwości zasobu lub zasobu w treści żądania są puste lub nieprawidłowe. 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji. 404 PropertyChangeUnsupported — nie można zmodyfikować właściwości. 404 JobAgentNotFound — określony agent zadania nie istnieje na określonym serwerze logicznym. 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje. 409 ServerDisabled — serwer jest wyłączony. 409 OperationCancelled — operacja została anulowana przez użytkownika. 409 OperationInterrupted — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie. 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 500 OperationTimedOut — upłynął limit czasu operacji i został automatycznie wycofany. Ponów próbę wykonania operacji. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

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

Definicje

Nazwa	Opis
JobAgent	Agent zadań Azure SQL.
JobAgentState	Stan agenta zadania.
JobAgentUpdate	Aktualizacja agenta zadań Azure SQL.
Sku	Jednostka SKU zasobu usługi ARM.

JobAgent

Agent zadań Azure SQL.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
location	string	Lokalizacja zasobu.
name	string	Nazwa zasobu.
properties.databaseId	string	Identyfikator zasobu bazy danych do przechowywania metadanych zadania.
properties.state	JobAgentState	Stan agenta zadania.
sku	Sku	Nazwa i warstwa jednostki SKU.
tags	object	Tagi zasobów.
type	string	Typ zasobu.

JobAgentState

Stan agenta zadania.

Nazwa	Typ	Opis
Creating	string
Deleting	string
Disabled	string
Ready	string
Updating	string

JobAgentUpdate

Aktualizacja agenta zadań Azure SQL.

Nazwa	Typ	Opis
tags	object	Tagi zasobów.

Sku

Jednostka SKU zasobu usługi ARM.

Nazwa	Typ	Opis
capacity	integer	Pojemność określonej jednostki SKU.
family	string	Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj.
name	string	Nazwa jednostki SKU, zazwyczaj litera + kod liczbowy, np. P3.
size	string	Rozmiar określonej jednostki SKU
tier	string	Warstwa lub wersja określonej jednostki SKU, np. Podstawowa, Premium.