Job Agents - Create Or Update

Başvuru

Hizmet:: SQL Database

API Sürümü:: 2021-11-01

bir iş aracısı oluşturur veya güncelleştirir.

PUT 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	Oluşturulacak veya 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	Gerekli	Tür	Description
location	True	string	Kaynak konumu.
properties.databaseId	True	string	İş meta verilerini depolamak için veritabanının kaynak kimliği.
sku		Sku	SKU'nun adı ve katmanı.
tags		object	Kaynak etiketleri.

Yanıtlar

Name	Tür	Description
200 OK	JobAgent	İş aracısı başarıyla güncelleştirildi.
201 Created	JobAgent	İş aracısı başarıyla oluşturuldu.
202 Accepted		Kabul edildi
Other Status Codes		Hata Yanıtları: ** 400 InvalidResourceRequestBody - İstek gövdesindeki kaynak veya kaynak özellikleri boş veya geçersiz. 400 MissingSkuName - Sku adı gereklidir. 400 InvalidDatabaseResourceId - Geçersiz veritabanı kaynak tanımlayıcısı. 400 MismatchingSubscriptionWithUrl - Sağlanan abonelik Url'deki abonelikle eşleşmedi. 400 MismatchingResourceGroupNameWithUrl - Sağlanan kaynak grubu adı Url'deki adla eşleşmedi. 400 MismatchingServerNameWithUrl - Sağlanan sunucu adı Url'deki adla eşleşmedi. 400 JobAgentDatabaseEditionUnsupported - Belirtilen veritabanının hizmet düzeyi hedefi iş aracısı veritabanı olarak kullanılmak üzere desteklenmiyor. 400 JobAgentDatabaseSecondary - İş aracısı coğrafi olarak ikincil bir veritabanına bağlanamaz. 400 JobAgentDatabaseAlreadyLinked - Belirtilen veritabanı zaten başka bir iş aracısına bağlı. 400 DatabaseDoesNotExist - İstenen veritabanı bulunamadı 400 CannotUseReservedDatabaseName - Bu işlemde ayrılmış veritabanı adı kullanılamaz. 400 JobAgentExceededQuota - Kotayı aşacağından iş aracısı oluşturulamadı. 400 JobAgentAlreadyExists - İş aracısı sunucuda zaten var. 404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı 404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok. 404 PropertyChangeUnsupported - Özellik değiştirilemez. 404 SubscriptionNotFound - İstenen abonelik bulunamadı. 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

Create or update a job agent

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


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.JobAgentInner;

/** Samples for JobAgents CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateJobAgent.json
     */
    /**
     * Sample code: Create or update a job agent.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateAJobAgent(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobAgents().createOrUpdate("group1", "server1", "agent1",
            new JobAgentInner().withLocation("southeastasia").withDatabaseId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"),
            Context.NONE);
    }
}

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

Örnek yanıt

Durum kodu:: 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",
  "sku": {
    "name": "Agent",
    "capacity": 100
  },
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  }
}

Durum kodu:: 201

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

Durum kodu:: 202

Tanımlar

Name	Description
JobAgent	bir Azure SQL iş aracısı.
JobAgentState	İş aracısının durumu.
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

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.

Aracılığıyla paylaş