Sync Agents - List By Server

  • 참조
Service:
SQL Database
API Version:
2021-11-01

서버에서 에이전트 동기화를 Lists.

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

URI 매개 변수

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

string

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

string

동기화 에이전트가 호스트되는 서버의 이름입니다.
subscriptionId
 path True

string

Azure 구독을 식별하는 구독 ID입니다.
api-version
 query True

string

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

응답

Name 형식 Description
200 OK

SyncAgentListResult

동기화 에이전트 목록을 성공적으로 검색했습니다.
Other Status Codes

오류 응답: ***

  • 400 InvalidSyncGroupCreateOrUpdateRequest - 동기화 그룹 만들기 또는 업데이트 요청 본문이 비어 있습니다.

  • 400 InvalidSyncMemberCreateOrUpdateRequest - 동기화 멤버 만들기 또는 업데이트 요청 본문이 비어 있습니다.

  • 400 InvalidSyncAgentCreateOrUpdateRequest - 동기화 에이전트 요청 만들기 또는 업데이트 본문이 비어 있습니다.

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

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

  • 400 InvalidSyncAgentResourceId - 잘못된 동기화 에이전트 리소스 식별자입니다.

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

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

  • 400 InvalidParameterValue - 매개 변수에 잘못된 값이 지정되었습니다.

  • 400 MissingServerName - 서버 이름이 없습니다.

  • 400 MissingDatabaseName - 데이터베이스 이름이 없습니다.

  • 400 MissingSyncGroupName - 동기화 그룹 이름이 없습니다.

  • 400 MissingConflictResolutionPolicy - 충돌 해결 정책이 없습니다.

  • 400 MissingSyncAgentName - 동기화 에이전트 이름이 없습니다.

  • 400 SyncOperation_GenericFailure - 데이터 동기화 작업을 수행하지 못했습니다.

  • 400 SyncOperation_WrongSyncDatabase - 지정된 동기화 데이터베이스가 기존 데이터베이스와 일치하지 않습니다.

  • 400 SyncOperation_DwInSyncGroup - 데이터 동기화에서 datawarehouse Edition을 사용할 수 없습니다.

  • 400 SyncOperation_MasterDbInSyncGroup - 데이터 동기화에서 논리 master 사용할 수 없습니다.

  • 400 CannotDeleteInUseSyncAgent - 동기화 멤버에서 사용되므로 동기화 에이전트를 삭제할 수 없습니다.

  • 400 InvalidSyncAgent - 동기화 에이전트가 잘못되었습니다.

  • 400 InvalidSyncMetadataDatabase - 동기화 메타데이터 데이터베이스가 잘못되었습니다.

  • 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다.

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

  • 404 DatabaseDoesNotExist - 사용자가 이 서버 instance 존재하지 않는 데이터베이스 이름을 지정했습니다.

  • 409 SyncOperation_AgentAlreadyExists - 이름이 같은 동기화 에이전트가 이미 있습니다.

  • 409 SyncOperation_AgentIdAlreadyExists - 동일한 ID를 가진 동기화 에이전트가 이미 있습니다.

예제

Get sync agents under a server

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncagentcrud-65440/providers/Microsoft.Sql/servers/syncagentcrud-8475/syncAgents?api-version=2021-11-01

Sample Response

Status code:
200 
{
  "value": [
    {
      "properties": {
        "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-Onebox/providers/Microsoft.Sql/servers/syncagentcrud-8475/databases/sync",
        "state": "NeverConnected",
        "isUpToDate": true,
        "expiryTime": "9999-12-31T23:59:59.9999999Z",
        "version": "4.2.0.0"
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-Onebox/providers/Microsoft.Sql/servers/syncagentcrud-8475/syncAgents/syncagentcrud-3187",
      "name": "syncagent",
      "type": "Microsoft.Sql/servers/syncAgents"
    }
  ]
}

정의

Name Description
SyncAgent

Azure SQL 데이터베이스 동기화 에이전트입니다.
SyncAgentListResult

동기화 에이전트 목록입니다.
SyncAgentState

동기화 에이전트의 상태입니다.

SyncAgent

Azure SQL 데이터베이스 동기화 에이전트입니다.

Name 형식 Description
id

string

리소스 ID입니다.
name

string

리소스 이름입니다.
properties.expiryTime

string

동기화 에이전트 버전의 만료 시간입니다.
properties.isUpToDate

boolean

동기화 에이전트 버전이 최신 상태인 경우
properties.lastAliveTime

string

동기화 에이전트의 마지막 활성 시간입니다.
properties.name

string

동기화 에이전트의 이름입니다.
properties.state

SyncAgentState

동기화 에이전트의 상태입니다.
properties.syncDatabaseId

string

동기화 에이전트에 있는 동기화 데이터베이스의 ARM 리소스 ID입니다.
properties.version

string

동기화 에이전트의 버전입니다.
type

string

리소스 종류.

SyncAgentListResult

동기화 에이전트 목록입니다.

Name 형식 Description
nextLink

string

연결하여 결과의 다음 페이지를 검색합니다.
value

SyncAgent[]

결과 배열입니다.

SyncAgentState

동기화 에이전트의 상태입니다.

Name 형식 Description
NeverConnected

string

Offline

string

Online

string