Job Agents - Create Or Update

작업 에이전트를 만들거나 업데이트합니다.

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

URI 매개 변수

Name In Required Type Description
jobAgentName
path True
  • string

만들거나 업데이트할 작업 에이전트의 이름입니다.

resourceGroupName
path True
  • string

리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.

serverName
path True
  • string

서버의 이름입니다.

subscriptionId
path True
  • string

Azure 구독을 식별하는 구독 ID입니다.

api-version
query True
  • string

요청에 사용할 API 버전입니다.

요청 본문

Name Required Type Description
location True
  • string

리소스 위치.

properties.databaseId True
  • string

작업 메타데이터를 저장할 데이터베이스의 리소스 ID입니다.

sku

SKU의 이름 및 계층입니다.

tags
  • object

리소스 태그.

응답

Name Type Description
200 OK

작업 에이전트를 업데이트했습니다.

201 Created

작업 에이전트를 성공적으로 만들었습니다.

202 Accepted

수락됨

Other Status Codes

오류 응답: ***

  • 400 InvalidResourceRequestBody - 요청 본문의 리소스 또는 리소스 속성이 비어 있거나 잘못되었습니다.

  • 400 MissingSkuName - Sku 이름이 필요합니다.

  • 400 InvalidDatabaseResourceId - 잘못된 데이터베이스 리소스 식별자입니다.

  • 400 MismatchingSubscriptionWithUrl - 제공된 구독이 URL의 구독과 일치하지 않습니다.

  • 400 MismatchingResourceGroupNameWithUrl - 제공된 리소스 그룹 이름이 URL의 이름과 일치하지 않습니다.

  • 400 MismatchingServerNameWithUrl - 제공된 서버 이름이 URL의 이름과 일치하지 않습니다.

  • 400 DatabaseDoesNotExist - 요청된 데이터베이스를 찾을 수 없습니다.

  • 400 JobAgentExceededQuota - 할당량을 초과하므로 작업 에이전트를 만들 수 없습니다.

  • 400 JobAgentAlreadyExists - 작업 에이전트가 서버에 이미 있습니다.

  • 400 JobAgentDatabaseEditionUnsupported - 지정된 데이터베이스의 서비스 수준 목표는 작업 에이전트 데이터베이스로 사용할 수 없습니다.

  • 400 JobAgentDatabaseSecondary - 작업 에이전트를 지역 보조 데이터베이스에 연결할 수 없습니다.

  • 400 JobAgentDatabaseAlreadyLinked - 지정된 데이터베이스가 이미 다른 작업 에이전트에 연결되어 있습니다.

  • 400 CannotUseReservedDatabaseName - 이 작업에서 예약된 데이터베이스 이름을 사용할 수 없습니다.

  • 404 SubscriptionDoesNotHaveServer - 요청한 서버를 찾을 수 없습니다.

  • 404 SubscriptionNotFound - 요청한 구독을 찾을 수 없습니다.

  • 404 PropertyChangeUnsupported - 속성을 수정할 수 없습니다.

예제

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

정의

JobAgent

Azure SQL 작업 에이전트입니다.

JobAgentState

작업 에이전트의 상태입니다.

Sku

ARM 리소스 SKU입니다.

JobAgent

Azure SQL 작업 에이전트입니다.

Name Type Description
id
  • string

리소스 ID입니다.

location
  • string

리소스 위치.

name
  • string

리소스 이름입니다.

properties.databaseId
  • string

작업 메타데이터를 저장할 데이터베이스의 리소스 ID입니다.

properties.state

작업 에이전트의 상태입니다.

sku

SKU의 이름 및 계층입니다.

tags
  • object

리소스 태그.

type
  • string

리소스 종류.

JobAgentState

작업 에이전트의 상태입니다.

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

Sku

ARM 리소스 SKU입니다.

Name Type Description
capacity
  • integer

특정 SKU의 용량입니다.

family
  • string

서비스에 동일한 SKU에 대해 서로 다른 세대의 하드웨어가 있는 경우 여기에서 캡처할 수 있습니다.

name
  • string

일반적으로 문자 + 숫자 코드(예: P3)인 SKU의 이름입니다.

size
  • string

특정 SKU의 크기

tier
  • string

특정 SKU의 계층 또는 버전(예: Basic, Premium)