Job Agents - Create Or Update

Referens

Tjänst:: SQL Database

API-version:: 2021-11-01

Skapar eller uppdaterar en jobbagent.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
jobAgentName	path	True	string	Namnet på den jobbagent som ska skapas eller uppdateras.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
serverName	path	True	string	Namnet på servern.
subscriptionId	path	True	string	Prenumerations-ID:t som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Obligatorisk	Typ	Description
location	True	string	Resursplats.
properties.databaseId	True	string	Resurs-ID för databasen som jobbmetadata ska lagras i.
sku		Sku	SKU:ns namn och nivå.
tags		object	Resurstaggar.

Svar

Name	Typ	Description
200 OK	JobAgent	Jobbagenten har uppdaterats.
201 Created	JobAgent	Jobbagenten har skapats.
202 Accepted		Har godkänts
Other Status Codes		Felsvar: *** 400 InvalidResourceRequestBody – Resursen eller resursegenskaperna i begärandetexten är tomma eller ogiltiga. 400 MissingSkuName – Sku-namn krävs. 400 InvalidDatabaseResourceId – Ogiltig databasresursidentifierare. 400 MismatchingSubscriptionWithUrl – den angivna prenumerationen matchade inte prenumerationen i URL:en. 400 MismatchingResourceGroupNameWithUrl – det angivna resursgruppsnamnet matchade inte namnet i URL:en. 400 MismatchingServerNameWithUrl – Det angivna servernamnet matchade inte namnet i URL:en. 400 JobAgentDatabaseEditionUnsupported – Den angivna databasens servicenivåmål stöds inte för användning som jobbagentdatabas. 400 JobAgentDatabaseSecondary – En jobbagent kan inte länkas till en geo-sekundär databas. 400 JobAgentDatabaseAlreadyLinked – Den angivna databasen är redan länkad till en annan jobbagent. 400 DatabaseDoesNotExist – Den begärda databasen hittades inte 400 CannotUseReservedDatabaseName – Det går inte att använda reserverade databasnamn i den här åtgärden. 400 JobAgentExceededEdQuota – Det gick inte att skapa jobbagenten eftersom den skulle överskrida kvoten. 400 JobAgentAlreadyExists – Jobbagenten finns redan på servern. 404 SubscriptionDoesNotHaveServer – den begärda servern hittades inte 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen. 404 PropertyChangeUnsupported – Egenskapen kan inte ändras. 404 SubscriptionNotFound – Den begärda prenumerationen hittades inte. 404 OperationIdNotFound – Åtgärden med ID finns inte. 409 ServerDisabled – Servern är inaktiverad. 409 OperationCancelled – Åtgärden har avbrutits av användaren. 409 Åtgärd avbröts – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs. 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök att utföra åtgärden igen. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

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.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"),
            com.azure.core.util.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

Exempelsvar

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

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

Statuskod:: 202

Definitioner

Name	Description
JobAgent	En Azure SQL jobbagent.
JobAgentState	Jobbagentens tillstånd.
Sku	En ARM-resurs-SKU.

JobAgent

En Azure SQL jobbagent.

Name	Typ	Description
id	string	Resurs-ID.
location	string	Resursplats.
name	string	Resursnamn.
properties.databaseId	string	Resurs-ID för databasen som jobbmetadata ska lagras i.
properties.state	JobAgentState	Jobbagentens tillstånd.
sku	Sku	SKU:ns namn och nivå.
tags	object	Resurstaggar.
type	string	Resurstyp.

JobAgentState

Jobbagentens tillstånd.

Name	Typ	Description
Creating	string
Deleting	string
Disabled	string
Ready	string
Updating	string

Sku

En ARM-resurs-SKU.

Name	Typ	Description
capacity	integer	Kapacitet för den specifika SKU:n.
family	string	Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här.
name	string	Namnet på SKU:n, vanligtvis en bokstav + nummerkod, t.ex. P3.
size	string	Storleken på den specifika SKU:n
tier	string	Nivån eller utgåvan av den specifika SKU:n, t.ex. Basic, Premium.

Dela via