다음을 통해 공유


Job Agents - Update

작업 에이전트를 업데이트합니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
jobAgentName
path True

string

업데이트할 작업 에이전트의 이름입니다.

resourceGroupName
path True

string

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

serverName
path True

string

서버의 이름입니다.

subscriptionId
path True

string

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

api-version
query True

string

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

요청 본문

Name 형식 Description
identity

JobAgentIdentity

작업 에이전트에 할당된 관리 ID

sku

Sku

SKU의 이름 및 계층입니다.

tags

object

리소스 태그.

응답

Name 형식 Description
200 OK

JobAgent

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

202 Accepted

허용

헤더

Location: string

Other Status Codes

ErrorResponse

오류 응답: ***

  • 400 ManagedInstanceStoppingOrStopped - 인스턴스가 중지/중지된 상태인 동안 제출된 충돌 작업

  • 400 ManagedInstanceStarting - 인스턴스가 시작 상태에 있는 동안 제출된 충돌 작업

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

  • 400 MissingIdentityType - ID 유형을 지정하십시오.

  • 400 MultipleIdentitiesOnJobAgent - 작업 에이전트당 하나의 사용자 관리 ID만 지정하세요.

  • 400 InvalidIdentityTenantId - tenantId는 만들기 또는 업데이트 요청에 지정할 수 없습니다.

  • 400 InvalidIdentityType - "None" 또는 "UserAssigned" ID 형식만 지정하세요.

  • 400 SkuMismatchingNameCapacity - 제공된 SKU 용량이 제공된 SKU 이름과 일치하지 않습니다.

  • 400 ElasticJobAgentEditionUnsupported - 지정된 SLO는 작업 에이전트에 대해 지원되지 않습니다. 지원되는 SLO를 사용하여 다시 시도하세요.

  • 400 ElasticJobAgentObjectiveAssignmentInProgress - 탄력적 작업 에이전트 '{0}'에 대한 SLO 할당이 현재 진행 중입니다. 나중에 작업을 다시 시도하세요.

  • 400 ElasticJobAgentEditionUnsupported - 지정된 SLO는 작업 에이전트에 대해 지원되지 않습니다. 지원되는 SLO를 사용하여 다시 시도하세요.

  • 400 ElasticJobsNotSupportedOnAutoPauseEnabledDatabase - 작업 에이전트가 해당 데이터베이스가 일시 중지되지 않도록 하기 때문에 자동 일시 중지 사용 서버리스 데이터베이스는 Elastic Jobs 데이터베이스로 지원되지 않습니다. 이 서버리스 데이터베이스에서 자동 일시 중지를 사용하지 않도록 설정하거나 이 데이터베이스를 사용하는 작업 에이전트를 삭제할 수 있습니다. 자세한 내용은 여기를 참조하세요. https://docs.microsoft.com/azure/azure-sql/database/serverless-tier-overview#auto-pausing

  • 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.

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

  • 404 JobAgentNotFound - 지정된 작업 에이전트가 지정된 논리 서버에 없습니다.

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

  • 404 OperationIdNotFound - ID가 있는 작업이 없습니다.

  • 409 ServerDisabled - 서버를 사용할 수 없습니다.

  • 409 ElasticJobAgentOperationUnavailable - 탄력적 작업 에이전트 '{0}'에 대해 '{1}' 작업이 차단되었습니다{2}

  • 409 CannotCancelOperation - 관리 작업이 취소할 수 없는 상태입니다.

  • 409 OperationCancelled - 사용자가 작업을 취소했습니다.

  • 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다.

  • 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요.

  • 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

Update a job agent's identity.
Update a job agent's sku.
Update a job agent's tags.

Update a job agent's identity.

샘플 요청

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

{
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/test-umi": {}
    }
  }
}

샘플 응답

{
  "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",
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/test-umi": {
        "clientId": "e09c8507-0000-0000-97e2-18c5beec59dc",
        "principalId": "0c29d9b7-0ae2-4014-96ea-faf8e0cf2bc7"
      }
    }
  }
}
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/southeastasia/jobAgentOperationResults/00000000-1111-2222-3333-444444444444?api-version=2017-03-01-preview

Update a job agent's sku.

샘플 요청

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

{
  "sku": {
    "name": "JA200"
  }
}

샘플 응답

{
  "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",
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  },
  "sku": {
    "name": "JA200",
    "capacity": 200
  }
}
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/southeastasia/jobAgentOperationResults/00000000-1111-2222-3333-444444444444?api-version=2017-03-01-preview

Update a job agent's tags.

샘플 요청

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

{
  "tags": {
    "mytag1": "myvalue1"
  }
}

샘플 응답

{
  "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",
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  },
  "tags": {
    "mytag1": "myvalue1"
  }
}
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/southeastasia/jobAgentOperationResults/00000000-1111-2222-3333-444444444444?api-version=2017-03-01-preview

정의

Name Description
ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

JobAgent

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

JobAgentIdentity

리소스에 대한 Azure Active Directory ID 구성입니다.

JobAgentIdentityType

작업 에이전트 ID 형식

JobAgentState

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

JobAgentUpdate

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

JobAgentUserAssignedIdentity

리소스에 대한 Azure Active Directory ID 구성입니다.

Sku

ARM 리소스 SKU입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

JobAgent

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

Name 형식 Description
id

string

리소스 ID입니다.

identity

JobAgentIdentity

작업 에이전트의 ID입니다.

location

string

리소스 위치입니다.

name

string

리소스 이름입니다.

properties.databaseId

string (arm-id)

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

properties.state

JobAgentState

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

sku

Sku

SKU의 이름 및 계층입니다.

tags

object

리소스 태그.

type

string

리소스 종류입니다.

JobAgentIdentity

리소스에 대한 Azure Active Directory ID 구성입니다.

Name 형식 Description
tenantId

string (uuid)

작업 에이전트 ID 테넌트 ID

type

JobAgentIdentityType

작업 에이전트 ID 형식

userAssignedIdentities

<string,  JobAgentUserAssignedIdentity>

사용할 사용자 할당 ID의 리소스 ID

JobAgentIdentityType

작업 에이전트 ID 형식

Description
None
SystemAssigned
UserAssigned
SystemAssignedUserAssigned

JobAgentState

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

Description
Creating
Ready
Updating
Deleting
Disabled

JobAgentUpdate

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

Name 형식 Description
identity

JobAgentIdentity

작업 에이전트에 할당된 관리 ID

sku

Sku

SKU의 이름 및 계층입니다.

tags

object

리소스 태그.

JobAgentUserAssignedIdentity

리소스에 대한 Azure Active Directory ID 구성입니다.

Name 형식 Description
clientId

string (uuid)

Azure Active Directory 클라이언트 ID입니다.

principalId

string (uuid)

Azure Active Directory 보안 주체 ID입니다.

Sku

ARM 리소스 SKU입니다.

Name 형식 Description
capacity

integer (int32)

특정 SKU의 용량입니다.

family

string

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

name

string

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

size

string

특정 SKU의 크기

tier

string

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