Job Agents - Create Or Update

Referensi

Service:: SQL Database

API Version:: 2021-11-01

Membuat atau memperbarui agen pekerjaan.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
jobAgentName	path	True	string	Nama agen pekerjaan yang akan dibuat atau diperbarui.
resourceGroupName	path	True	string	Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.
serverName	path	True	string	Nama server.
subscriptionId	path	True	string	ID langganan yang mengidentifikasi langganan Azure.
api-version	query	True	string	Versi API yang digunakan untuk permintaan.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
location	True	string	Lokasi sumber daya.
properties.databaseId	True	string	ID sumber daya database untuk menyimpan metadata pekerjaan.
sku		Sku	Nama dan tingkat SKU.
tags		object	Tag sumber daya.

Respons

Nama	Jenis	Deskripsi
200 OK	JobAgent	Berhasil memperbarui agen pekerjaan.
201 Created	JobAgent	Berhasil membuat agen pekerjaan.
202 Accepted		Diterima
Other Status Codes		Respons Kesalahan: *** 400 InvalidResourceRequestBody - Properti sumber daya atau sumber daya dalam isi permintaan kosong atau tidak valid. Diperlukan 400 MissingSkuName - Nama Sku. 400 InvalidDatabaseResourceId - Pengidentifikasi sumber daya database tidak valid. 400 MismatchingSubscriptionWithUrl - Langganan yang disediakan tidak cocok dengan langganan di Url. 400 MismatchingResourceGroupNameWithUrl - Nama grup sumber daya yang disediakan tidak cocok dengan nama di Url. 400 MismatchingServerNameWithUrl - Nama server yang disediakan tidak cocok dengan nama di Url. 400 JobAgentDatabaseEditionUnsupported - Tujuan tingkat layanan database yang ditentukan tidak didukung untuk digunakan sebagai database agen pekerjaan. 400 JobAgentDatabaseSecondary - Agen pekerjaan tidak dapat ditautkan ke database geo-sekunder. 400 JobAgentDatabaseAlreadyLinked - Database yang ditentukan sudah ditautkan ke agen pekerjaan lain. 400 DatabaseDoesNotExist - Database yang diminta tidak ditemukan 400 CannotUseReservedDatabaseName - Tidak dapat menggunakan nama database yang dipesan dalam operasi ini. 400 JobAgentExceededQuota - Tidak dapat membuat agen pekerjaan karena akan melebihi kuota. 400 JobAgentAlreadyExists - Agen pekerjaan sudah ada di server. 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan. 404 PropertyChangeUnsupported - Properti tidak dapat dimodifikasi. 404 SubscriptionNotFound - Langganan yang diminta tidak ditemukan. 404 OperationIdNotFound - Operasi dengan Id tidak ada. 409 ServerDisabled - Server dinonaktifkan. 409 OperationCancelled - Operasi telah dibatalkan oleh pengguna. 409 OperationInterrupted - Operasi pada sumber daya tidak dapat diselesaikan karena terganggu oleh operasi lain pada sumber daya yang sama. 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 500 OperationTimedOut - Waktu operasi habis dan secara otomatis digulung balik. Coba lagi operasi ini. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

Contoh

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

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

Status code:: 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"
  }
}

Status code:: 202

Definisi

Nama	Deskripsi
JobAgent	Agen pekerjaan Azure SQL.
JobAgentState	Status agen pekerjaan.
Sku	SKU Sumber Daya ARM.

JobAgent

Agen pekerjaan Azure SQL.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
location	string	Lokasi sumber daya.
name	string	Nama sumber daya.
properties.databaseId	string	ID sumber daya database untuk menyimpan metadata pekerjaan.
properties.state	JobAgentState	Status agen pekerjaan.
sku	Sku	Nama dan tingkat SKU.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya

JobAgentState

Status agen pekerjaan.

Nama	Jenis	Deskripsi
Creating	string
Deleting	string
Disabled	string
Ready	string
Updating	string

Sku

SKU Sumber Daya ARM.

Nama	Jenis	Deskripsi
capacity	integer	Kapasitas SKU tertentu.
family	string	Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini.
name	string	Nama SKU, biasanya, kode huruf + Angka, misalnya P3.
size	string	Ukuran SKU tertentu
tier	string	Tingkat atau edisi SKU tertentu, misalnya Dasar, Premium.