Job Agents - Update

Service:

SQL Database

API Version:

2021-11-01

bir iş aracısı Güncelleştirmeler.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
jobAgentName	path	True	string	Güncelleştirilecek iş aracısının adı.
resourceGroupName	path	True	string	Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.
serverName	path	True	string	Sunucunun adı.
subscriptionId	path	True	string	Azure aboneliğini tanımlayan abonelik kimliği.
api-version	query	True	string	İstek için kullanılacak API sürümü.

İstek Gövdesi

Name	Tür	Description
tags	object	Kaynak etiketleri.

Yanıtlar

Name	Tür	Description
200 OK	JobAgent	İş aracısı başarıyla güncelleştirildi.
202 Accepted		Kabul edildi
Other Status Codes		Hata Yanıtları: ** 400 InvalidResourceRequestBody - İstek gövdesindeki kaynak veya kaynak özellikleri boş veya geçersiz. 404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı 404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok. 404 PropertyChangeUnsupported - Özellik değiştirilemez. 404 JobAgentNotFound - Belirtilen iş aracısı belirtilen mantıksal sunucuda yok. 404 OperationIdNotFound - Kimliği olan işlem yok. 409 ServerDisabled - Sunucu devre dışı bırakıldı. 409 OperationCancelled - İşlem kullanıcı tarafından iptal edildi. 409 İşlem Kesildi - Aynı kaynakta başka bir işlem tarafından kesintiye uğradığından kaynak üzerindeki işlem tamamlanamadı. 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler. 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler. 500 OperationTimedOut - İşlem zaman aşımına uğradı ve otomatik olarak geri alındı. Lütfen işlemi yeniden deneyin. 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.

Örnekler

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

Tanımlar

Name	Description
JobAgent	bir Azure SQL iş aracısı.
JobAgentState	İş aracısının durumu.
JobAgentUpdate	bir Azure SQL iş aracısı güncelleştirmesi.
Sku	ARM Kaynağı SKU'su.

JobAgent

bir Azure SQL iş aracısı.

Name	Tür	Description
id	string	Kaynak Kimliği.
location	string	Kaynak konumu.
name	string	Kaynak adı.
properties.databaseId	string	İş meta verilerini depolamak için veritabanının kaynak kimliği.
properties.state	JobAgentState	İş aracısının durumu.
sku	Sku	SKU'nun adı ve katmanı.
tags	object	Kaynak etiketleri.
type	string	Kaynak türü.

JobAgentState

İş aracısının durumu.

Name	Tür	Description
Creating	string
Deleting	string
Disabled	string
Ready	string
Updating	string

JobAgentUpdate

bir Azure SQL iş aracısı güncelleştirmesi.

Name	Tür	Description
tags	object	Kaynak etiketleri.

Sku

ARM Kaynağı SKU'su.

Name	Tür	Description
capacity	integer	Belirli bir SKU'nun kapasitesi.
family	string	Hizmetin aynı SKU için farklı nesil donanımları varsa, bu durum burada yakalanabilir.
name	string	SKU adı, genellikle bir harf + Sayı kodu, örneğin P3.
size	string	Belirli SKU'nun boyutu
tier	string	Belirli bir SKU'nun katmanı veya sürümü, örneğin Temel, Premium.