Job Agents - Create Or Update

Referencia

Service:: SQL Database

API Version:: 2021-11-01

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=2021-11-01

URI-paraméterek

Name	In	Kötelező	Típus	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	Kötelező	Típus	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		Sku	A termékváltozat neve és szintje.
tags		object	Erőforráscímkék.

Válaszok

Name	Típus	Description
200 OK	JobAgent	A feladatügynök frissítése sikerült.
201 Created	JobAgent	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ástulajdonsá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 EltérésSubscriptionWithUrl – 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 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 DatabaseDoesNotExist – A kért adatbázis nem található 400 CannotUseReservedDatabaseName – Ebben a műveletben nem használható fenntartott adatbázisnév. 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. 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található 404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és előfizetésben. 404 PropertyChangeUnsupported – A tulajdonság nem módosítható. 404 SubscriptionNotFound – A kért előfizetés nem található. 404 OperationIdNotFound – Az azonosítóval rendelkező művelet nem létezik. 409 ServerDisabled – A kiszolgáló le van tiltva. 409 OperationCancelled – A felhasználó megszakította a műveletet. 409 OperationInterrupted – Az erőforráson végzett művelet nem hajtható végre, mert egy másik művelet megszakította ugyanazon az erőforráson. 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések. 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések. 500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Please retry the operation. 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.

Példák

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

Definíciók

Name	Description
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	Típus	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	JobAgentState	A feladatügynök állapota.
sku	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	Típus	Description
Creating	string
Deleting	string
Disabled	string
Ready	string
Updating	string

Sku

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

Name	Típus	Description
capacity	integer	Az adott termékváltozat kapacitása.
family	string	Ha a szolgáltatás eltérő hardvergenerációval rendelkezik ugyanahhoz a termékváltozathoz, akkor az itt rögzíthető.
name	string	A termékváltozat neve, általában egy betű + szám kód, például 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.