Job Agents - Create Or Update

Feladatügynököt hoz létre vagy frissít.

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

URI-paraméterek

Name In Required Type Description
jobAgentName
path True
  • string

A létrehozandó vagy frissítendő feladatügynök neve.

resourceGroupName
path True
  • string

Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.

serverName
path True
  • string

A kiszolgáló neve.

subscriptionId
path True
  • string

Az Azure-előfizetést azonosító előfizetés-azonosító.

api-version
query True
  • string

A kéréshez használandó API-verzió.

Kérelem törzse

Name Required Type Description
location True
  • string

Erőforrás helye.

properties.databaseId True
  • string

A feladat metaadatainak tárolására használt adatbázis erőforrás-azonosítója.

sku

A termékváltozat neve és szintje.

tags
  • object

Erőforráscímkék.

Válaszok

Name Type Description
200 OK

A feladatügynök frissítése sikerült.

201 Created

A feladatügynök létrehozása sikerült.

202 Accepted

Elfogadva

Other Status Codes

Hibaválaszok: ***

  • 400 InvalidResourceRequestBody – A kérelemtörzsben lévő erőforrás- vagy erőforrás-tulajdonságok üresek vagy érvénytelenek.

  • 400 MissingSkuName – A termékváltozat neve kötelező.

  • 400 InvalidDatabaseResourceId – Érvénytelen adatbázis-erőforrás-azonosító.

  • 400 MismatchingSubscriptionWithUrl – A megadott előfizetés nem egyezett az URL-címben szereplő előfizetéssel.

  • 400 MismatchingResourceGroupNameWithUrl – A megadott erőforráscsoport neve nem egyezett az URL-címben megadott névvel.

  • 400 MismatchingServerNameWithUrl – A megadott kiszolgálónév nem egyezett az URL-címben megadott névvel.

  • 400 DatabaseDoesNotExist – A kért adatbázis nem található

  • 400 JobAgentExceededQuota – Nem hozható létre feladatügynök, mert túllépné a kvótát.

  • 400 JobAgentAlreadyExists – A feladatügynök már létezik a kiszolgálón.

  • 400 JobAgentDatabaseEditionUnsupported – A megadott adatbázis szolgáltatásiszint-célkitűzése nem támogatott feladatügynök-adatbázisként való használatra.

  • 400 JobAgentDatabaseSecondary – A feladatügynökök nem csatolhatók földrajzilag másodlagos adatbázishoz.

  • 400 JobAgentDatabaseAlreadyLinked – A megadott adatbázis már hozzá van kapcsolva egy másik feladatügynökhöz.

  • 400 CannotUseReservedDatabaseName – Ebben a műveletben nem használható fenntartott adatbázisnév.

  • 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található

  • 404 SubscriptionNotFound – A kért előfizetés nem található.

  • 404 PropertyChangeUnsupported – A tulajdonság nem módosítható.

Példák

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

Definíciók

JobAgent

Egy Azure SQL feladatügynök.

JobAgentState

A feladatügynök állapota.

Sku

ARM-erőforrás-termékváltozat.

JobAgent

Egy Azure SQL feladatügynök.

Name Type Description
id
  • string

Erőforrás-azonosító.

location
  • string

Erőforrás helye.

name
  • string

Erőforrás neve.

properties.databaseId
  • string

A feladat metaadatainak tárolására használt adatbázis erőforrás-azonosítója.

properties.state

A feladatügynök állapota.

sku

A termékváltozat neve és szintje.

tags
  • object

Erőforráscímkék.

type
  • string

Erőforrástípus.

JobAgentState

A feladatügynök állapota.

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

Sku

ARM-erőforrás-termékváltozat.

Name Type Description
capacity
  • integer

Az adott termékváltozat kapacitása.

family
  • string

Ha a szolgáltatás eltérő hardvergenerációval rendelkezik ugyanahhoz az SKU-hoz, az itt rögzíthető.

name
  • string

A termékváltozat neve, általában betű + számkód, pl. P3.

size
  • string

Az adott termékváltozat mérete

tier
  • string

Az adott termékváltozat szintje vagy kiadása, például alapszintű, Prémium.