Job Agents - Create Or Update

Membuat atau memperbarui agen pekerjaan.

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

Parameter URI

Name In Required Type Description
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

Name Required Type Description
location True
  • string

Lokasi sumber daya.

properties.databaseId True
  • string

ID sumber daya database untuk menyimpan metadata pekerjaan.

sku

Nama dan tingkat SKU.

tags
  • object

Tag sumber daya.

Respons

Name Type Description
200 OK

Berhasil memperbarui agen pekerjaan.

201 Created

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 DatabaseDoesNotExist - Database yang diminta tidak ditemukan

  • 400 JobAgentExceededQuota - Tidak dapat membuat agen pekerjaan karena akan melebihi kuota.

  • 400 JobAgentAlreadyExists - Agen pekerjaan sudah ada di server.

  • 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 CannotUseReservedDatabaseName - Tidak dapat menggunakan nama database yang dipesan dalam operasi ini.

  • 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan

  • 404 SubscriptionNotFound - Langganan yang diminta tidak ditemukan.

  • 404 PropertyChangeUnsupported - Properti tidak dapat dimodifikasi.

Contoh

Create or update a job agent with all properties
Create or update a job agent with minimum properties

Create or update a job agent with all properties

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1?api-version=2017-03-01-preview

{
  "location": "southeastasia",
  "sku": {
    "name": "Agent",
    "capacity": 100
  },
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  },
  "tags": {
    "octopus": "agent"
  }
}

Sample Response

{
  "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"
  },
  "tags": {
    "octopus": "agent"
  }
}
{
  "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"
  },
  "tags": {
    "octopus": "agent"
  }
}

Create or update a job agent with minimum properties

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1?api-version=2017-03-01-preview

{
  "location": "southeastasia",
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  }
}

Sample Response

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

Definisi

JobAgent

Agen pekerjaan Azure SQL.

JobAgentState

Status agen pekerjaan.

Sku

SKU Sumber Daya ARM.

JobAgent

Agen pekerjaan Azure SQL.

Name Type Description
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

Status agen pekerjaan.

sku

Nama dan tingkat SKU.

tags
  • object

Tag sumber daya.

type
  • string

Jenis sumber daya

JobAgentState

Status agen pekerjaan.

Name Type Description
Creating
  • string
Deleting
  • string
Disabled
  • string
Ready
  • string
Updating
  • string

Sku

SKU Sumber Daya ARM.

Name Type Description
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.