다음을 통해 공유

Replicas - List By Server

  • 참조
서비스:
PostgreSQL
API 버전:
2022-12-01

지정된 서버에 대한 모든 복제본을 나열합니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}/replicas?api-version=2022-12-01

URI 매개 변수

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

string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.
serverName
 path True

string

서버의 이름입니다.

regex 패턴: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*
subscriptionId
 path True

string

대상 구독의 ID입니다.
api-version
 query True

string

이 작업에 사용할 API 버전입니다.

응답

Name 형식 Description
200 OK

ServerListResult

정상
Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

ReplicasListByServer

샘플 요청

GET https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/flexibleServers/sourcepgservername/replicas?api-version=2022-12-01

샘플 응답

상태 코드:
200 
{
  "value": [
    {
      "sku": {
        "name": "Standard_D4s_v3",
        "tier": "GeneralPurpose"
      },
      "properties": {
        "fullyQualifiedDomainName": "pgtestsvc5rep.postgres.database.azure.com",
        "version": "12",
        "minorVersion": "6",
        "administratorLogin": "cloudsa",
        "state": "Ready",
        "availabilityZone": "2",
        "storage": {
          "storageSizeGB": 512
        },
        "dataEncryption": {
          "type": "SystemManaged"
        },
        "authConfig": {
          "activeDirectoryAuth": "Disabled",
          "passwordAuth": "Enabled"
        },
        "backup": {
          "backupRetentionDays": 7,
          "geoRedundantBackup": "Disabled",
          "earliestRestoreDate": "2021-05-27T00:28:17.7279547+00:00"
        },
        "network": {
          "publicNetworkAccess": "Enabled"
        },
        "highAvailability": {
          "mode": "Disabled",
          "state": "NotEnabled"
        },
        "maintenanceWindow": {
          "customWindow": "Disabled",
          "dayOfWeek": 0,
          "startHour": 0,
          "startMinute": 0
        },
        "replicationRole": "AsyncReplica",
        "replicaCapacity": 0
      },
      "location": "westus",
      "tags": {
        "ElasticServer": "1"
      },
      "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/flexibleServers/pgtestsvc5rep",
      "name": "pgtestsvc5rep",
      "type": "Microsoft.DBforPostgreSQL/flexibleServers"
    }
  ]
}

정의

Name Description
activeDirectoryAuthEnum

사용하도록 설정하면 Azure Active Directory 인증이 사용됩니다.
ArmServerKeyType

시스템 관리 및 Azure Key Vault인지를 보여 주는 데이터 암호화 형식입니다.
AuthConfig

서버의 인증 구성 속성
Backup

서버의 백업 속성
createdByType

리소스를 만든 ID 유형입니다.
CreateMode

새 PostgreSQL 서버를 만드는 모드입니다.
DataEncryption

서버의 데이터 암호화 속성
ErrorAdditionalInfo

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

오류 세부 정보입니다.
ErrorResponse

오류 응답
GeoRedundantBackupEnum

서버에서 Geo-Redundant 백업을 사용할 수 있는지 여부를 나타내는 값입니다.
HighAvailability

서버의 고가용성 속성
HighAvailabilityMode

서버에 대한 HA 모드입니다.
IdentityType

이 리소스와 연결된 ID 유형입니다. 현재 'None 및 UserAssigned'로 제한됨
MaintenanceWindow

서버의 유지 관리 기간 속성입니다.
Network

서버의 네트워크 속성입니다.
passwordAuthEnum

사용하도록 설정하면 암호 인증이 사용됩니다.
ReplicationRole

복제 집합에서 서버의 역할을 나타내는 데 사용됩니다.
Server

서버를 나타냅니다.
ServerHAState

사용자에게 표시되는 HA 서버의 상태입니다.
ServerListResult

서버 목록입니다.
ServerPublicNetworkAccessState

공용 네트워크 액세스가 활성화되었는지 여부
ServerState

사용자에게 표시되는 서버의 상태입니다.
ServerVersion

서버의 버전입니다.
Sku

서버의 Sku 정보 관련 속성입니다.
SkuTier

특정 SKU의 계층(예: 버스트 가능)입니다.
Storage

서버의 스토리지 속성
systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
UserAssignedIdentity

이 애플리케이션과 연결된 ID를 설명하는 정보입니다.
UserIdentity

애플리케이션과 연결된 단일 사용자 할당 ID에 대해 설명합니다.

activeDirectoryAuthEnum

사용하도록 설정하면 Azure Active Directory 인증이 사용됩니다.

Name 형식 Description
Disabled

string

Enabled

string

ArmServerKeyType

시스템 관리 및 Azure Key Vault인지를 보여 주는 데이터 암호화 형식입니다.

Name 형식 Description
AzureKeyVault

string

SystemManaged

string

AuthConfig

서버의 인증 구성 속성

Name 형식 Default value Description
activeDirectoryAuth

activeDirectoryAuthEnum

사용하도록 설정하면 Azure Active Directory 인증이 활성화됩니다.
passwordAuth

passwordAuthEnum

Enabled

사용하도록 설정하면 암호 인증이 활성화됩니다.
tenantId

string

서버의 테넌트 ID입니다.

Backup

서버의 백업 속성

Name 형식 Default value Description
backupRetentionDays

integer

7

서버의 백업 보존 기간(일)입니다.
earliestRestoreDate

string

서버에 대한 가장 빠른 복원 지점 시간(ISO8601 형식)입니다.
geoRedundantBackup

GeoRedundantBackupEnum

Disabled

서버에서 Geo-Redundant 백업을 사용할 수 있는지 여부를 나타내는 값입니다.

createdByType

리소스를 만든 ID 유형입니다.

Name 형식 Description
Application

string

Key

string

ManagedIdentity

string

User

string

CreateMode

새 PostgreSQL 서버를 만드는 모드입니다.

Name 형식 Description
Create

string

Default

string

GeoRestore

string

PointInTimeRestore

string

Replica

string

Update

string

DataEncryption

서버의 데이터 암호화 속성

Name 형식 Description
primaryKeyURI

string

주 서버의 데이터 암호화 키에 대한 URI입니다.
primaryUserAssignedIdentityId

string

주 서버의 데이터 암호화에 사용할 사용자 할당 ID의 리소스 ID입니다.
type

ArmServerKeyType

시스템 관리형 및 Azure Key Vault인지를 보여 주는 데이터 암호화 형식입니다.

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

Error 개체.

GeoRedundantBackupEnum

서버에서 Geo-Redundant 백업을 사용할 수 있는지 여부를 나타내는 값입니다.

Name 형식 Description
Disabled

string

Enabled

string

HighAvailability

서버의 고가용성 속성

Name 형식 Default value Description
mode

HighAvailabilityMode

Disabled

서버에 대한 HA 모드입니다.
standbyAvailabilityZone

string

대기의 가용성 영역 정보입니다.
state

ServerHAState

사용자에게 표시되는 HA 서버의 상태입니다.

HighAvailabilityMode

서버에 대한 HA 모드입니다.

Name 형식 Description
Disabled

string

SameZone

string

ZoneRedundant

string

IdentityType

이 리소스와 연결된 ID 유형입니다. 현재 'None 및 UserAssigned'로 제한됨

Name 형식 Description
None

string

UserAssigned

string

MaintenanceWindow

서버의 유지 관리 기간 속성입니다.

Name 형식 Default value Description
customWindow

string

Disabled

사용자 지정 창을 사용할지 또는 사용하지 않도록 설정했는지 여부를 나타냅니다.
dayOfWeek

integer

0

유지 관리 기간의 요일
startHour

integer

0

유지 관리 기간의 시작 시간
startMinute

integer

0

유지 관리 기간의 시작 시간(분)

Network

서버의 네트워크 속성입니다.

Name 형식 Description
delegatedSubnetResourceId

string

위임된 서브넷 arm 리소스 ID입니다. 서버를 VNET으로 삽입하려는 경우( 즉, 프라이빗 액세스 서버)를 만드는 동안 전달해야 합니다. 업데이트하는 동안 프라이빗 DNS 영역에 대한 값을 업데이트하려는 경우에만 이 값을 전달합니다.
privateDnsZoneArmResourceId

string

프라이빗 DNS 영역 arm 리소스 ID입니다. 서버를 VNET으로 삽입하려는 경우( 즉, 프라이빗 액세스 서버)를 만드는 동안 전달해야 합니다. 업데이트하는 동안 프라이빗 DNS 영역에 대한 값을 업데이트하려는 경우에만 이 값을 전달합니다.
publicNetworkAccess

ServerPublicNetworkAccessState

공용 네트워크 액세스가 활성화되었는지 여부

passwordAuthEnum

사용하도록 설정하면 암호 인증이 사용됩니다.

Name 형식 Description
Disabled

string

Enabled

string

ReplicationRole

복제 집합에서 서버의 역할을 나타내는 데 사용됩니다.

Name 형식 Description
AsyncReplica

string

GeoAsyncReplica

string

None

string

Primary

string

Server

서버를 나타냅니다.

Name 형식 Description
id

string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity

UserAssignedIdentity

애플리케이션의 ID를 설명합니다.
location

string

리소스가 있는 지리적 위치
name

string

리소스의 이름입니다.
properties.administratorLogin

string

서버의 관리자 로그인 이름입니다. 서버를 만들 때만 지정할 수 있습니다(만들기에 필요).
properties.administratorLoginPassword

string

관리자 로그인 암호(서버 만들기에 필요).
properties.authConfig

AuthConfig

서버의 AuthConfig 속성입니다.
properties.availabilityZone

string

서버의 가용성 영역 정보입니다.
properties.backup

Backup

서버의 백업 속성입니다.
properties.createMode

CreateMode

새 PostgreSQL 서버를 만드는 모드입니다.
properties.dataEncryption

DataEncryption

서버의 데이터 암호화 속성입니다.
properties.fullyQualifiedDomainName

string

서버의 정규화된 도메인 이름입니다.
properties.highAvailability

HighAvailability

서버의 고가용성 속성입니다.
properties.maintenanceWindow

MaintenanceWindow

서버의 유지 관리 기간 속성입니다.
properties.minorVersion

string

서버의 부 버전입니다.
properties.network

Network

서버의 네트워크 속성입니다. 이 네트워크 속성은 서버를 프라이빗 액세스 서버로 설정하려는 경우에만 전달해야 합니다.
properties.pointInTimeUTC

string

복원할 시간을 지정하는 복원 지점 생성 시간(ISO8601 형식)입니다. 'createMode'가 'PointInTimeRestore' 또는 'GeoRestore'인 경우 필요합니다.
properties.replicaCapacity

integer

서버에 허용되는 복제본입니다.
properties.replicationRole

ReplicationRole

서버의 복제 역할
properties.sourceServerResourceId

string

복원할 원본 서버 리소스 ID입니다. 'createMode'가 'PointInTimeRestore' 또는 'GeoRestore' 또는 'Replica'인 경우 필요합니다. 이 속성은 복제본 서버에 대해서만 반환됩니다.
properties.state

ServerState

사용자에게 표시되는 서버의 상태입니다.
properties.storage

Storage

서버의 스토리지 속성입니다.
properties.version

ServerVersion

PostgreSQL 서버 버전입니다.
sku

Sku

서버의 SKU(가격 책정 계층)입니다.
systemData

systemData

이 리소스와 관련된 시스템 메타데이터입니다.
tags

object

리소스 태그.
type

string

리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

ServerHAState

사용자에게 표시되는 HA 서버의 상태입니다.

Name 형식 Description
CreatingStandby

string

FailingOver

string

Healthy

string

NotEnabled

string

RemovingStandby

string

ReplicatingData

string

ServerListResult

서버 목록입니다.

Name 형식 Description
nextLink

string

작업의 다음 페이지를 가져오는 데 사용되는 링크입니다.
value

Server[]

유연한 서버 목록

ServerPublicNetworkAccessState

공용 네트워크 액세스가 활성화되었는지 여부

Name 형식 Description
Disabled

string

Enabled

string

ServerState

사용자에게 표시되는 서버의 상태입니다.

Name 형식 Description
Disabled

string

Dropping

string

Ready

string

Starting

string

Stopped

string

Stopping

string

Updating

string

ServerVersion

서버의 버전입니다.

Name 형식 Description
11

string

12

string

13

string

14

string

Sku

서버의 Sku 정보 관련 속성입니다.

Name 형식 Description
name

string

sku의 이름(일반적으로 계층 + 제품군 + 코어)입니다(예: Standard_D4s_v3).
tier

SkuTier

특정 SKU의 계층(예: 버스트 가능)입니다.

SkuTier

특정 SKU의 계층(예: 버스트 가능)입니다.

Name 형식 Description
Burstable

string

GeneralPurpose

string

MemoryOptimized

string

Storage

서버의 스토리지 속성

Name 형식 Description
storageSizeGB

integer

서버에 허용되는 최대 스토리지입니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string

UTC(리소스 만들기)의 타임스탬프입니다.
createdBy

string

리소스를 만든 ID입니다.
createdByType

createdByType

리소스를 만든 ID의 형식입니다.
lastModifiedAt

string

리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID 유형입니다.

UserAssignedIdentity

이 애플리케이션과 연결된 ID를 설명하는 정보입니다.

Name 형식 Description
tenantId

string

서버의 테넌트 ID입니다.
type

IdentityType

이 리소스와 연결된 ID 유형 현재 '없음 및 UserAssigned'로 제한됨
userAssignedIdentities

<string,  UserIdentity>

는 사용자 할당 ID 맵을 나타냅니다.

UserIdentity

애플리케이션과 연결된 단일 사용자 할당 ID에 대해 설명합니다.

Name 형식 Description
clientId

string

이 ID가 나타내는 서비스 주체의 클라이언트 식별자입니다.
principalId

string

이 ID가 나타내는 서비스 주체의 개체 식별자입니다.