다음을 통해 공유

Microsoft.DBforPostgreSQL 유연한 서버

Bicep 리소스 정의

flexibleServers 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.DBforPostgreSQL/flexibleServers 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.DBforPostgreSQL/flexibleServers@2025-01-01-preview' = {
  identity: {
    principalId: 'string'
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    administratorLogin: 'string'
    administratorLoginPassword: 'string'
    authConfig: {
      activeDirectoryAuth: 'string'
      passwordAuth: 'string'
      tenantId: 'string'
    }
    availabilityZone: 'string'
    backup: {
      backupRetentionDays: int
      geoRedundantBackup: 'string'
    }
    cluster: {
      clusterSize: int
    }
    createMode: 'string'
    dataEncryption: {
      geoBackupKeyURI: 'string'
      geoBackupUserAssignedIdentityId: 'string'
      primaryKeyURI: 'string'
      primaryUserAssignedIdentityId: 'string'
      type: 'string'
    }
    highAvailability: {
      mode: 'string'
      standbyAvailabilityZone: 'string'
    }
    maintenanceWindow: {
      customWindow: 'string'
      dayOfWeek: int
      startHour: int
      startMinute: int
    }
    network: {
      delegatedSubnetResourceId: 'string'
      privateDnsZoneArmResourceId: 'string'
      publicNetworkAccess: 'string'
    }
    pointInTimeUTC: 'string'
    replica: {
      promoteMode: 'string'
      promoteOption: 'string'
      role: 'string'
    }
    replicationRole: 'string'
    sourceServerResourceId: 'string'
    storage: {
      autoGrow: 'string'
      iops: int
      storageSizeGB: int
      throughput: int
      tier: 'string'
      type: 'string'
    }
    version: 'string'
  }
  sku: {
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

속성 값

Microsoft.DBforPostgreSQL/유연한 서버 (Flexible Servers)

이름 묘사 값
신원 유연한 서버에 할당된 사용자 할당 관리 ID입니다. UserAssignedIdentity
위치 리소스가 있는 지리적 위치 string(필수)
이름 리소스 이름 문자열

제약 조건:
최소 길이 = 3
최대 길이 = 63
패턴 = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*(필수)
속성 유연한 서버의 속성입니다. 서버 속성
SKU (재고 관리 코드) 유연한 서버의 컴퓨팅 계층 및 크기. 스쿠
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

인증 구성

이름 묘사 값
activeDirectoryAuth 서버가 Microsoft Entra 인증을 지원하는지 여부를 나타냅니다. '사용 안 함'
'사용'
비밀번호인증 서버가 암호 기반 인증을 지원하는지 여부를 나타냅니다. '사용 안 함'
'사용'
테넌트ID 위임된 리소스의 테넌트 식별자입니다. 문자열

백업

이름 묘사 값
백업보존일 유연한 서버에 대한 백업 보존 일수입니다. 정수 (int)
geoRedundant백업 서버가 지리적으로 중복된 백업을 만들도록 구성되어 있는지 여부를 나타냅니다. '사용 안 함'
'사용'

클러스터

이름 묘사 값
클러스터 크기 탄력적 클러스터에 할당된 노드의 수입니다. 정수 (int)

데이터 암호화

이름 묘사 값
geoBackupKeyURI 지리적으로 중복된 백업을 지원하도록 구성된 유연한 서버에 연결된 지리적으로 중복된 스토리지의 데이터 암호화를 위해 Azure Key Vault 키에 액세스하는 데 사용되는 사용자 할당 관리 ID의 식별자입니다. 문자열
geoBackupUserAssignedIdentityId 지리적으로 중복된 백업을 지원하도록 구성된 유연한 서버에 연결된 지리적으로 중복된 스토리지의 데이터 암호화를 위해 Azure Key Vault 키에 액세스하는 데 사용되는 사용자 할당 관리 ID의 식별자입니다. 문자열
primaryKeyURI 유연한 서버에 연결된 기본 스토리지의 데이터 암호화에 사용되는 Azure Key Vault의 키 URI입니다. 문자열
primaryUserAssignedIdentityId 유연한 서버에 연결된 기본 스토리지의 데이터 암호화를 위해 Azure Key Vault 키에 액세스하는 데 사용되는 사용자 할당 관리 ID의 식별자입니다. 문자열
형 유연한 서버에서 사용하는 데이터 암호화 유형입니다. 'AzureKeyVault'
'시스템 관리'

고가용성

이름 묘사 값
모드 유연한 서버를 위한 고가용성 모드입니다. '사용 안 함'
'사임존'
'ZoneRedundant'
대기가용성존 고가용성이 SameZone 또는 ZoneRedundant로 설정될 때 생성되는 대기 서버와 연결된 가용성 영역입니다. 문자열

유지 관리 창

이름 묘사 값
사용자 정의 창 사용자 지정 창이 활성화되었는지 여부를 나타냅니다. 문자열
요일의주 유지 관리 창에 사용할 요일입니다. 정수 (int)
시작 시간 유지 관리 창에 사용할 시작 시간입니다. 정수 (int)
startMinute 시작 분 유지 관리 창에 사용할 시작 시간(분)입니다. 정수 (int)

네트워크

이름 묘사 값
delegatedSubnetResourceId 위임된 서브넷의 리소스 식별자입니다. 서버를 사용자 고유의 가상 네트워크에 통합하려는 경우 새 서버를 만드는 동안 필요합니다. 업데이트 작업의 경우 프라이빗 DNS 영역에 할당된 값을 변경하려는 경우에만 이 속성을 제공해야 합니다. 문자열
privateDnsZoneArmResourceId 프라이빗 DNS 영역의 식별자입니다. 서버를 사용자 고유의 가상 네트워크에 통합하려는 경우 새 서버를 만드는 동안 필요합니다. 업데이트 작업의 경우 프라이빗 DNS 영역에 할당된 값을 변경하려는 경우에만 이 속성을 제공해야 합니다. 문자열
공공 네트워크 접근 공용 네트워크 액세스를 사용할 수 있는지 여부를 나타냅니다. '사용 안 함'
'사용'

복제본

이름 묘사 값
프로모션 모드 읽기 전용 복제본에 적용할 작업 유형입니다. 이 속성은 쓰기 전용입니다. 독립 실행형은 읽기 전용 복제본이 독립 실행형 서버로 승격되고 복제 세트에서 완전히 독립적인 엔터티가 됨을 의미합니다. 전환은 읽기 복제본이 주 서버와 함께 역할을 수행함을 의미합니다. '독립 실행형'
'전환'
프로모션옵션 promoteMode 속성에 지정된 작업을 처리할 때 사용할 데이터 동기화 옵션: 이 속성은 쓰기 전용입니다. 계획됨은 작업이 작업을 시작하기 전에 읽기 전용 복제본의 데이터가 원본 서버와 완전히 동기화될 때까지 대기함을 의미합니다. Forced는 작업이 작업을 시작하기 전에 읽기 복제본의 데이터가 원본 서버와 동기화될 때까지 기다리지 않음을 의미합니다. '강제'
'계획됨'
역할 복제 세트에서 서버의 역할입니다. '비동기 복제'
'GeoAsyncReplica'
'없음'
'기본'

서버 속성

이름 묘사 값
관리자로그인 PostgreSQL 인스턴스에 할당된 첫 번째 암호 기반 관리자로 지정된 로그인의 이름입니다. 서버에서 암호 기반 인증을 처음 활성화할 때 지정해야 합니다. 한 번 지정된 값으로 설정하면 서버의 남은 수명 동안 변경할 수 없습니다. 암호 기반 인증을 사용하도록 설정된 서버에서 암호 기반 인증을 사용하지 않도록 설정하면 이 암호 기반 역할이 삭제되지 않습니다. 문자열
administratorLoginPassword 관리자 로그인에 할당된 암호입니다. 암호 인증이 활성화되어 있는 한 이 암호는 언제든지 변경할 수 있습니다. 문자열

제약 조건:
중요한 값입니다. 보안 매개 변수로 전달합니다.
인증 구성 유연한 서버의 인증 구성 속성. 인증 구성
availabilityZone(가용성) 유연한 서버의 가용성 영역입니다. 문자열
백업 유연한 서버의 백업 속성. 백업
클러스터 유연한 서버의 클러스터 속성입니다. 클러스터
크리에이션모드 새 유연한 서버의 만들기 모드입니다. '만들기'
'기본값'
'지오리스토어'
'PointInTimeRestore'
'레플리카'
'리바이브드롭'
'업데이트'
데이터 암호화 유연한 서버의 데이터 암호화 속성. 데이터 암호화
고가용성 유연한 서버의 고가용성 속성입니다. 고가용성
유지 보수창 유연한 서버의 유지 관리 기간 속성. 유지 관리 창
네트워크 유연한 서버의 네트워크 속성입니다. 고객이 제공한 가상 네트워크에 서버를 통합하려는 경우에만 필요합니다. 네트워크
포인트인타임UTC 새 유연한 서버에서 복원하려는 백업의 생성 시간(ISO8601 형식)입니다. 'createMode'가 'PointInTimeRestore', 'GeoRestore' 또는 'ReviveDropped'인 경우 필요합니다. 문자열
복제본 유연한 서버의 읽기 복제본 속성. 서버를 승격하려는 경우에만 필요합니다. 복제본
replicationRole 복제 세트에서 서버의 역할입니다. '비동기 복제'
'GeoAsyncReplica'
'없음'
'기본'
sourceServerResourceId 새 유연한 서버의 원본으로 사용할 유연한 서버의 식별자입니다. 'createMode'가 'PointInTimeRestore', 'GeoRestore', 'Replica' 또는 'ReviveDropped'인 경우 필요합니다. 이 속성은 대상 유연한 서버가 읽기 복제본인 경우에만 반환됩니다. 문자열
보관 유연한 서버의 스토리지 속성입니다. 스토리지
버전 PostgreSQL 데이터베이스 엔진의 주 버전입니다. '11'
'12'
'13'
'14'
'15'
'16'
'17'

SKU (재고 관리 코드)

이름 묘사 값
이름 유연한 서버에 할당된 지정된 컴퓨팅 크기로 알려진 이름입니다. string(필수)
계층 유연한 서버에 할당된 컴퓨팅의 계층입니다. '버스트 가능'
'범용'
'MemoryOptimized'(필수)

보관

이름 묘사 값
자동 성장 사용 가능한 공간이 0에 가깝고 조건이 스토리지 크기를 자동으로 늘릴 수 있는 경우 유연한 서버의 스토리지 크기 자동 증가를 사용하거나 사용하지 않도록 설정하는 플래그입니다. '사용 안 함'
'사용'
IOPS 스토리지에 지원되는 최대 IOPS입니다. 스토리지 유형이 PremiumV2_LRS 또는 UltraSSD_LRS인 경우 필요합니다. 정수 (int)
스토리지 크기GB 유연한 서버에 할당된 스토리지의 크기입니다. 정수 (int)
처리량 스토리지에 지원되는 최대 처리량입니다. 스토리지 유형이 PremiumV2_LRS 또는 UltraSSD_LRS인 경우 필요합니다. 정수 (int)
계층 유연한 서버의 스토리지 계층입니다. 'P1'
'P10'
'P15'
'P2'
'P20'
'P3'
'P30'
'P4'
'P40'
'P50'
'P6'
'P60'
'P70'
'P80'
형 유연한 서버에 할당된 스토리지 유형입니다. 허용되는 값은 Premium_LRS, PremiumV2_LRS 또는 UltraSSD_LRS입니다. 지정하지 않으면 기본값은 Premium_LRS입니다. 'PremiumV2_LRS'
'Premium_LRS'
'UltraSSD_LRS'

TrackedResource태그

이름 묘사 값

사용자 할당 ID

이름 묘사 값
principalId 사용자 할당 관리 ID에 연결된 서비스 주체의 개체 식별자입니다. 문자열
형 유연한 서버와 연결된 ID 유형입니다. '없음'
'시스템 할당됨'
'시스템 할당, 사용자 할당'
'UserAssigned'(필수)
userAssignedIdentities 사용자가 할당한 관리 ID의 매핑입니다. UserAssignedIdentityMap

사용자 할당 신원 확인 맵

이름 묘사 값

사용자 신원

이름 묘사 값
클라이언트 ID 사용자 할당 관리 ID에 연결된 서비스 주체의 클라이언트 식별자입니다. 문자열
principalId 사용자 할당 관리 ID에 연결된 서비스 주체의 개체 식별자입니다. 문자열

사용 예제

Azure 확인된 모듈

다음 Azure 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.

모듈 묘사
DB for Postgre SQL 유연한 서버 Postgre SQL 유연한 서버용 DB용 AVM 리소스 모듈

Azure 빠른 시작 샘플

다음 Azure 빠른 시작 템플릿에는 이 리소스 유형을 배포하기 위한 Bicep 샘플이 포함되어 있습니다.

Bicep 파일 묘사
PgFlex 서버 만들기 & Backup Vault 통해 보호를 사용하도록 설정 PostgreSQL 유연한 서버를 만들고 Backup 자격 증명 모음을 통해 보호를 사용하도록 설정하는 템플릿
AAD 사용하여 Azure Database for PostgreSQL(유연한) 배포 이 템플릿은 AAD 통합을 사용하여 유연한 서버 Azure Database for PostgreSQL을 배포하는 방법을 제공합니다.
VNet을 사용하여 Azure Database for PostgreSQL(유연한) 배포 이 템플릿은 VNet 통합을 사용하여 유연한 서버 Azure Database for PostgreSQL을 배포하는 방법을 제공합니다.
PostgreSQL 및 VNet 통합 사용하여 웹앱의 SonarQube 이 템플릿은 PostgreSQL 유연한 서버, VNet 통합 및 프라이빗 DNS를 사용하여 Linux의 웹앱에 SonarQube를 쉽게 배포할 수 있도록 합니다.

ARM 템플릿 리소스 정의

flexibleServers 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.DBforPostgreSQL/flexibleServers 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.DBforPostgreSQL/flexibleServers",
  "apiVersion": "2025-01-01-preview",
  "name": "string",
  "identity": {
    "principalId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "location": "string",
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "authConfig": {
      "activeDirectoryAuth": "string",
      "passwordAuth": "string",
      "tenantId": "string"
    },
    "availabilityZone": "string",
    "backup": {
      "backupRetentionDays": "int",
      "geoRedundantBackup": "string"
    },
    "cluster": {
      "clusterSize": "int"
    },
    "createMode": "string",
    "dataEncryption": {
      "geoBackupKeyURI": "string",
      "geoBackupUserAssignedIdentityId": "string",
      "primaryKeyURI": "string",
      "primaryUserAssignedIdentityId": "string",
      "type": "string"
    },
    "highAvailability": {
      "mode": "string",
      "standbyAvailabilityZone": "string"
    },
    "maintenanceWindow": {
      "customWindow": "string",
      "dayOfWeek": "int",
      "startHour": "int",
      "startMinute": "int"
    },
    "network": {
      "delegatedSubnetResourceId": "string",
      "privateDnsZoneArmResourceId": "string",
      "publicNetworkAccess": "string"
    },
    "pointInTimeUTC": "string",
    "replica": {
      "promoteMode": "string",
      "promoteOption": "string",
      "role": "string"
    },
    "replicationRole": "string",
    "sourceServerResourceId": "string",
    "storage": {
      "autoGrow": "string",
      "iops": "int",
      "storageSizeGB": "int",
      "throughput": "int",
      "tier": "string",
      "type": "string"
    },
    "version": "string"
  },
  "sku": {
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

속성 값

Microsoft.DBforPostgreSQL/유연한 서버 (Flexible Servers)

이름 묘사 값
API버전 api 버전 '2025-01-01-미리보기'
신원 유연한 서버에 할당된 사용자 할당 관리 ID입니다. UserAssignedIdentity
위치 리소스가 있는 지리적 위치 string(필수)
이름 리소스 이름 문자열

제약 조건:
최소 길이 = 3
최대 길이 = 63
패턴 = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*(필수)
속성 유연한 서버의 속성입니다. 서버 속성
SKU (재고 관리 코드) 유연한 서버의 컴퓨팅 계층 및 크기. 스쿠
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
형 리소스 종류 'Microsoft.DBforPostgreSQL/flexibleServers'

인증 구성

이름 묘사 값
activeDirectoryAuth 서버가 Microsoft Entra 인증을 지원하는지 여부를 나타냅니다. '사용 안 함'
'사용'
비밀번호인증 서버가 암호 기반 인증을 지원하는지 여부를 나타냅니다. '사용 안 함'
'사용'
테넌트ID 위임된 리소스의 테넌트 식별자입니다. 문자열

백업

이름 묘사 값
백업보존일 유연한 서버에 대한 백업 보존 일수입니다. 정수 (int)
geoRedundant백업 서버가 지리적으로 중복된 백업을 만들도록 구성되어 있는지 여부를 나타냅니다. '사용 안 함'
'사용'

클러스터

이름 묘사 값
클러스터 크기 탄력적 클러스터에 할당된 노드의 수입니다. 정수 (int)

데이터 암호화

이름 묘사 값
geoBackupKeyURI 지리적으로 중복된 백업을 지원하도록 구성된 유연한 서버에 연결된 지리적으로 중복된 스토리지의 데이터 암호화를 위해 Azure Key Vault 키에 액세스하는 데 사용되는 사용자 할당 관리 ID의 식별자입니다. 문자열
geoBackupUserAssignedIdentityId 지리적으로 중복된 백업을 지원하도록 구성된 유연한 서버에 연결된 지리적으로 중복된 스토리지의 데이터 암호화를 위해 Azure Key Vault 키에 액세스하는 데 사용되는 사용자 할당 관리 ID의 식별자입니다. 문자열
primaryKeyURI 유연한 서버에 연결된 기본 스토리지의 데이터 암호화에 사용되는 Azure Key Vault의 키 URI입니다. 문자열
primaryUserAssignedIdentityId 유연한 서버에 연결된 기본 스토리지의 데이터 암호화를 위해 Azure Key Vault 키에 액세스하는 데 사용되는 사용자 할당 관리 ID의 식별자입니다. 문자열
형 유연한 서버에서 사용하는 데이터 암호화 유형입니다. 'AzureKeyVault'
'시스템 관리'

고가용성

이름 묘사 값
모드 유연한 서버를 위한 고가용성 모드입니다. '사용 안 함'
'사임존'
'ZoneRedundant'
대기가용성존 고가용성이 SameZone 또는 ZoneRedundant로 설정될 때 생성되는 대기 서버와 연결된 가용성 영역입니다. 문자열

유지 관리 창

이름 묘사 값
사용자 정의 창 사용자 지정 창이 활성화되었는지 여부를 나타냅니다. 문자열
요일의주 유지 관리 창에 사용할 요일입니다. 정수 (int)
시작 시간 유지 관리 창에 사용할 시작 시간입니다. 정수 (int)
startMinute 시작 분 유지 관리 창에 사용할 시작 시간(분)입니다. 정수 (int)

네트워크

이름 묘사 값
delegatedSubnetResourceId 위임된 서브넷의 리소스 식별자입니다. 서버를 사용자 고유의 가상 네트워크에 통합하려는 경우 새 서버를 만드는 동안 필요합니다. 업데이트 작업의 경우 프라이빗 DNS 영역에 할당된 값을 변경하려는 경우에만 이 속성을 제공해야 합니다. 문자열
privateDnsZoneArmResourceId 프라이빗 DNS 영역의 식별자입니다. 서버를 사용자 고유의 가상 네트워크에 통합하려는 경우 새 서버를 만드는 동안 필요합니다. 업데이트 작업의 경우 프라이빗 DNS 영역에 할당된 값을 변경하려는 경우에만 이 속성을 제공해야 합니다. 문자열
공공 네트워크 접근 공용 네트워크 액세스를 사용할 수 있는지 여부를 나타냅니다. '사용 안 함'
'사용'

복제본

이름 묘사 값
프로모션 모드 읽기 전용 복제본에 적용할 작업 유형입니다. 이 속성은 쓰기 전용입니다. 독립 실행형은 읽기 전용 복제본이 독립 실행형 서버로 승격되고 복제 세트에서 완전히 독립적인 엔터티가 됨을 의미합니다. 전환은 읽기 복제본이 주 서버와 함께 역할을 수행함을 의미합니다. '독립 실행형'
'전환'
프로모션옵션 promoteMode 속성에 지정된 작업을 처리할 때 사용할 데이터 동기화 옵션: 이 속성은 쓰기 전용입니다. 계획됨은 작업이 작업을 시작하기 전에 읽기 전용 복제본의 데이터가 원본 서버와 완전히 동기화될 때까지 대기함을 의미합니다. Forced는 작업이 작업을 시작하기 전에 읽기 복제본의 데이터가 원본 서버와 동기화될 때까지 기다리지 않음을 의미합니다. '강제'
'계획됨'
역할 복제 세트에서 서버의 역할입니다. '비동기 복제'
'GeoAsyncReplica'
'없음'
'기본'

서버 속성

이름 묘사 값
관리자로그인 PostgreSQL 인스턴스에 할당된 첫 번째 암호 기반 관리자로 지정된 로그인의 이름입니다. 서버에서 암호 기반 인증을 처음 활성화할 때 지정해야 합니다. 한 번 지정된 값으로 설정하면 서버의 남은 수명 동안 변경할 수 없습니다. 암호 기반 인증을 사용하도록 설정된 서버에서 암호 기반 인증을 사용하지 않도록 설정하면 이 암호 기반 역할이 삭제되지 않습니다. 문자열
administratorLoginPassword 관리자 로그인에 할당된 암호입니다. 암호 인증이 활성화되어 있는 한 이 암호는 언제든지 변경할 수 있습니다. 문자열

제약 조건:
중요한 값입니다. 보안 매개 변수로 전달합니다.
인증 구성 유연한 서버의 인증 구성 속성. 인증 구성
availabilityZone(가용성) 유연한 서버의 가용성 영역입니다. 문자열
백업 유연한 서버의 백업 속성. 백업
클러스터 유연한 서버의 클러스터 속성입니다. 클러스터
크리에이션모드 새 유연한 서버의 만들기 모드입니다. '만들기'
'기본값'
'지오리스토어'
'PointInTimeRestore'
'레플리카'
'리바이브드롭'
'업데이트'
데이터 암호화 유연한 서버의 데이터 암호화 속성. 데이터 암호화
고가용성 유연한 서버의 고가용성 속성입니다. 고가용성
유지 보수창 유연한 서버의 유지 관리 기간 속성. 유지 관리 창
네트워크 유연한 서버의 네트워크 속성입니다. 고객이 제공한 가상 네트워크에 서버를 통합하려는 경우에만 필요합니다. 네트워크
포인트인타임UTC 새 유연한 서버에서 복원하려는 백업의 생성 시간(ISO8601 형식)입니다. 'createMode'가 'PointInTimeRestore', 'GeoRestore' 또는 'ReviveDropped'인 경우 필요합니다. 문자열
복제본 유연한 서버의 읽기 복제본 속성. 서버를 승격하려는 경우에만 필요합니다. 복제본
replicationRole 복제 세트에서 서버의 역할입니다. '비동기 복제'
'GeoAsyncReplica'
'없음'
'기본'
sourceServerResourceId 새 유연한 서버의 원본으로 사용할 유연한 서버의 식별자입니다. 'createMode'가 'PointInTimeRestore', 'GeoRestore', 'Replica' 또는 'ReviveDropped'인 경우 필요합니다. 이 속성은 대상 유연한 서버가 읽기 복제본인 경우에만 반환됩니다. 문자열
보관 유연한 서버의 스토리지 속성입니다. 스토리지
버전 PostgreSQL 데이터베이스 엔진의 주 버전입니다. '11'
'12'
'13'
'14'
'15'
'16'
'17'

SKU (재고 관리 코드)

이름 묘사 값
이름 유연한 서버에 할당된 지정된 컴퓨팅 크기로 알려진 이름입니다. string(필수)
계층 유연한 서버에 할당된 컴퓨팅의 계층입니다. '버스트 가능'
'범용'
'MemoryOptimized'(필수)

보관

이름 묘사 값
자동 성장 사용 가능한 공간이 0에 가깝고 조건이 스토리지 크기를 자동으로 늘릴 수 있는 경우 유연한 서버의 스토리지 크기 자동 증가를 사용하거나 사용하지 않도록 설정하는 플래그입니다. '사용 안 함'
'사용'
IOPS 스토리지에 지원되는 최대 IOPS입니다. 스토리지 유형이 PremiumV2_LRS 또는 UltraSSD_LRS인 경우 필요합니다. 정수 (int)
스토리지 크기GB 유연한 서버에 할당된 스토리지의 크기입니다. 정수 (int)
처리량 스토리지에 지원되는 최대 처리량입니다. 스토리지 유형이 PremiumV2_LRS 또는 UltraSSD_LRS인 경우 필요합니다. 정수 (int)
계층 유연한 서버의 스토리지 계층입니다. 'P1'
'P10'
'P15'
'P2'
'P20'
'P3'
'P30'
'P4'
'P40'
'P50'
'P6'
'P60'
'P70'
'P80'
형 유연한 서버에 할당된 스토리지 유형입니다. 허용되는 값은 Premium_LRS, PremiumV2_LRS 또는 UltraSSD_LRS입니다. 지정하지 않으면 기본값은 Premium_LRS입니다. 'PremiumV2_LRS'
'Premium_LRS'
'UltraSSD_LRS'

TrackedResource태그

이름 묘사 값

사용자 할당 ID

이름 묘사 값
principalId 사용자 할당 관리 ID에 연결된 서비스 주체의 개체 식별자입니다. 문자열
형 유연한 서버와 연결된 ID 유형입니다. '없음'
'시스템 할당됨'
'시스템 할당, 사용자 할당'
'UserAssigned'(필수)
userAssignedIdentities 사용자가 할당한 관리 ID의 매핑입니다. UserAssignedIdentityMap

사용자 할당 신원 확인 맵

이름 묘사 값

사용자 신원

이름 묘사 값
클라이언트 ID 사용자 할당 관리 ID에 연결된 서비스 주체의 클라이언트 식별자입니다. 문자열
principalId 사용자 할당 관리 ID에 연결된 서비스 주체의 개체 식별자입니다. 문자열

사용 예제

Azure 빠른 시작 템플릿

다음 Azure 빠른 시작 템플릿은 이 리소스 유형을 배포할 있습니다.

템플렛 묘사
PgFlex 서버 만들기 & Backup Vault 통해 보호를 사용하도록 설정

Azure에 배포 		PostgreSQL 유연한 서버를 만들고 Backup 자격 증명 모음을 통해 보호를 사용하도록 설정하는 템플릿
AAD 사용하여 Azure Database for PostgreSQL(유연한) 배포

Azure에 배포 		이 템플릿은 AAD 통합을 사용하여 유연한 서버 Azure Database for PostgreSQL을 배포하는 방법을 제공합니다.
VNet을 사용하여 Azure Database for PostgreSQL(유연한) 배포

Azure에 배포 		이 템플릿은 VNet 통합을 사용하여 유연한 서버 Azure Database for PostgreSQL을 배포하는 방법을 제공합니다.
PostgreSQL 및 VNet 통합 사용하여 웹앱의 SonarQube

Azure에 배포 		이 템플릿은 PostgreSQL 유연한 서버, VNet 통합 및 프라이빗 DNS를 사용하여 Linux의 웹앱에 SonarQube를 쉽게 배포할 수 있도록 합니다.

Terraform(AzAPI 공급자) 리소스 정의

flexibleServers 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

  • 리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.DBforPostgreSQL/flexibleServers 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DBforPostgreSQL/flexibleServers@2025-01-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      administratorLogin = "string"
      administratorLoginPassword = "string"
      authConfig = {
        activeDirectoryAuth = "string"
        passwordAuth = "string"
        tenantId = "string"
      }
      availabilityZone = "string"
      backup = {
        backupRetentionDays = int
        geoRedundantBackup = "string"
      }
      cluster = {
        clusterSize = int
      }
      createMode = "string"
      dataEncryption = {
        geoBackupKeyURI = "string"
        geoBackupUserAssignedIdentityId = "string"
        primaryKeyURI = "string"
        primaryUserAssignedIdentityId = "string"
        type = "string"
      }
      highAvailability = {
        mode = "string"
        standbyAvailabilityZone = "string"
      }
      maintenanceWindow = {
        customWindow = "string"
        dayOfWeek = int
        startHour = int
        startMinute = int
      }
      network = {
        delegatedSubnetResourceId = "string"
        privateDnsZoneArmResourceId = "string"
        publicNetworkAccess = "string"
      }
      pointInTimeUTC = "string"
      replica = {
        promoteMode = "string"
        promoteOption = "string"
        role = "string"
      }
      replicationRole = "string"
      sourceServerResourceId = "string"
      storage = {
        autoGrow = "string"
        iops = int
        storageSizeGB = int
        throughput = int
        tier = "string"
        type = "string"
      }
      version = "string"
    }
    sku = {
      name = "string"
      tier = "string"
    }
  }
}

속성 값

Microsoft.DBforPostgreSQL/유연한 서버 (Flexible Servers)

이름 묘사 값
신원 유연한 서버에 할당된 사용자 할당 관리 ID입니다. UserAssignedIdentity
위치 리소스가 있는 지리적 위치 string(필수)
이름 리소스 이름 문자열

제약 조건:
최소 길이 = 3
최대 길이 = 63
패턴 = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*(필수)
속성 유연한 서버의 속성입니다. 서버 속성
SKU (재고 관리 코드) 유연한 서버의 컴퓨팅 계층 및 크기. 스쿠
태그 리소스 태그 태그 이름 및 값의 사전입니다.
형 리소스 종류 "Microsoft.DBforPostgreSQL/flexibleServers@2025-01-01-preview"

인증 구성

이름 묘사 값
activeDirectoryAuth 서버가 Microsoft Entra 인증을 지원하는지 여부를 나타냅니다. '사용 안 함'
'사용'
비밀번호인증 서버가 암호 기반 인증을 지원하는지 여부를 나타냅니다. '사용 안 함'
'사용'
테넌트ID 위임된 리소스의 테넌트 식별자입니다. 문자열

백업

이름 묘사 값
백업보존일 유연한 서버에 대한 백업 보존 일수입니다. 정수 (int)
geoRedundant백업 서버가 지리적으로 중복된 백업을 만들도록 구성되어 있는지 여부를 나타냅니다. '사용 안 함'
'사용'

클러스터

이름 묘사 값
클러스터 크기 탄력적 클러스터에 할당된 노드의 수입니다. 정수 (int)

데이터 암호화

이름 묘사 값
geoBackupKeyURI 지리적으로 중복된 백업을 지원하도록 구성된 유연한 서버에 연결된 지리적으로 중복된 스토리지의 데이터 암호화를 위해 Azure Key Vault 키에 액세스하는 데 사용되는 사용자 할당 관리 ID의 식별자입니다. 문자열
geoBackupUserAssignedIdentityId 지리적으로 중복된 백업을 지원하도록 구성된 유연한 서버에 연결된 지리적으로 중복된 스토리지의 데이터 암호화를 위해 Azure Key Vault 키에 액세스하는 데 사용되는 사용자 할당 관리 ID의 식별자입니다. 문자열
primaryKeyURI 유연한 서버에 연결된 기본 스토리지의 데이터 암호화에 사용되는 Azure Key Vault의 키 URI입니다. 문자열
primaryUserAssignedIdentityId 유연한 서버에 연결된 기본 스토리지의 데이터 암호화를 위해 Azure Key Vault 키에 액세스하는 데 사용되는 사용자 할당 관리 ID의 식별자입니다. 문자열
형 유연한 서버에서 사용하는 데이터 암호화 유형입니다. 'AzureKeyVault'
'시스템 관리'

고가용성

이름 묘사 값
모드 유연한 서버를 위한 고가용성 모드입니다. '사용 안 함'
'사임존'
'ZoneRedundant'
대기가용성존 고가용성이 SameZone 또는 ZoneRedundant로 설정될 때 생성되는 대기 서버와 연결된 가용성 영역입니다. 문자열

유지 관리 창

이름 묘사 값
사용자 정의 창 사용자 지정 창이 활성화되었는지 여부를 나타냅니다. 문자열
요일의주 유지 관리 창에 사용할 요일입니다. 정수 (int)
시작 시간 유지 관리 창에 사용할 시작 시간입니다. 정수 (int)
startMinute 시작 분 유지 관리 창에 사용할 시작 시간(분)입니다. 정수 (int)

네트워크

이름 묘사 값
delegatedSubnetResourceId 위임된 서브넷의 리소스 식별자입니다. 서버를 사용자 고유의 가상 네트워크에 통합하려는 경우 새 서버를 만드는 동안 필요합니다. 업데이트 작업의 경우 프라이빗 DNS 영역에 할당된 값을 변경하려는 경우에만 이 속성을 제공해야 합니다. 문자열
privateDnsZoneArmResourceId 프라이빗 DNS 영역의 식별자입니다. 서버를 사용자 고유의 가상 네트워크에 통합하려는 경우 새 서버를 만드는 동안 필요합니다. 업데이트 작업의 경우 프라이빗 DNS 영역에 할당된 값을 변경하려는 경우에만 이 속성을 제공해야 합니다. 문자열
공공 네트워크 접근 공용 네트워크 액세스를 사용할 수 있는지 여부를 나타냅니다. '사용 안 함'
'사용'

복제본

이름 묘사 값
프로모션 모드 읽기 전용 복제본에 적용할 작업 유형입니다. 이 속성은 쓰기 전용입니다. 독립 실행형은 읽기 전용 복제본이 독립 실행형 서버로 승격되고 복제 세트에서 완전히 독립적인 엔터티가 됨을 의미합니다. 전환은 읽기 복제본이 주 서버와 함께 역할을 수행함을 의미합니다. '독립 실행형'
'전환'
프로모션옵션 promoteMode 속성에 지정된 작업을 처리할 때 사용할 데이터 동기화 옵션: 이 속성은 쓰기 전용입니다. 계획됨은 작업이 작업을 시작하기 전에 읽기 전용 복제본의 데이터가 원본 서버와 완전히 동기화될 때까지 대기함을 의미합니다. Forced는 작업이 작업을 시작하기 전에 읽기 복제본의 데이터가 원본 서버와 동기화될 때까지 기다리지 않음을 의미합니다. '강제'
'계획됨'
역할 복제 세트에서 서버의 역할입니다. '비동기 복제'
'GeoAsyncReplica'
'없음'
'기본'

서버 속성

이름 묘사 값
관리자로그인 PostgreSQL 인스턴스에 할당된 첫 번째 암호 기반 관리자로 지정된 로그인의 이름입니다. 서버에서 암호 기반 인증을 처음 활성화할 때 지정해야 합니다. 한 번 지정된 값으로 설정하면 서버의 남은 수명 동안 변경할 수 없습니다. 암호 기반 인증을 사용하도록 설정된 서버에서 암호 기반 인증을 사용하지 않도록 설정하면 이 암호 기반 역할이 삭제되지 않습니다. 문자열
administratorLoginPassword 관리자 로그인에 할당된 암호입니다. 암호 인증이 활성화되어 있는 한 이 암호는 언제든지 변경할 수 있습니다. 문자열

제약 조건:
중요한 값입니다. 보안 매개 변수로 전달합니다.
인증 구성 유연한 서버의 인증 구성 속성. 인증 구성
availabilityZone(가용성) 유연한 서버의 가용성 영역입니다. 문자열
백업 유연한 서버의 백업 속성. 백업
클러스터 유연한 서버의 클러스터 속성입니다. 클러스터
크리에이션모드 새 유연한 서버의 만들기 모드입니다. '만들기'
'기본값'
'지오리스토어'
'PointInTimeRestore'
'레플리카'
'리바이브드롭'
'업데이트'
데이터 암호화 유연한 서버의 데이터 암호화 속성. 데이터 암호화
고가용성 유연한 서버의 고가용성 속성입니다. 고가용성
유지 보수창 유연한 서버의 유지 관리 기간 속성. 유지 관리 창
네트워크 유연한 서버의 네트워크 속성입니다. 고객이 제공한 가상 네트워크에 서버를 통합하려는 경우에만 필요합니다. 네트워크
포인트인타임UTC 새 유연한 서버에서 복원하려는 백업의 생성 시간(ISO8601 형식)입니다. 'createMode'가 'PointInTimeRestore', 'GeoRestore' 또는 'ReviveDropped'인 경우 필요합니다. 문자열
복제본 유연한 서버의 읽기 복제본 속성. 서버를 승격하려는 경우에만 필요합니다. 복제본
replicationRole 복제 세트에서 서버의 역할입니다. '비동기 복제'
'GeoAsyncReplica'
'없음'
'기본'
sourceServerResourceId 새 유연한 서버의 원본으로 사용할 유연한 서버의 식별자입니다. 'createMode'가 'PointInTimeRestore', 'GeoRestore', 'Replica' 또는 'ReviveDropped'인 경우 필요합니다. 이 속성은 대상 유연한 서버가 읽기 복제본인 경우에만 반환됩니다. 문자열
보관 유연한 서버의 스토리지 속성입니다. 스토리지
버전 PostgreSQL 데이터베이스 엔진의 주 버전입니다. '11'
'12'
'13'
'14'
'15'
'16'
'17'

SKU (재고 관리 코드)

이름 묘사 값
이름 유연한 서버에 할당된 지정된 컴퓨팅 크기로 알려진 이름입니다. string(필수)
계층 유연한 서버에 할당된 컴퓨팅의 계층입니다. '버스트 가능'
'범용'
'MemoryOptimized'(필수)

보관

이름 묘사 값
자동 성장 사용 가능한 공간이 0에 가깝고 조건이 스토리지 크기를 자동으로 늘릴 수 있는 경우 유연한 서버의 스토리지 크기 자동 증가를 사용하거나 사용하지 않도록 설정하는 플래그입니다. '사용 안 함'
'사용'
IOPS 스토리지에 지원되는 최대 IOPS입니다. 스토리지 유형이 PremiumV2_LRS 또는 UltraSSD_LRS인 경우 필요합니다. 정수 (int)
스토리지 크기GB 유연한 서버에 할당된 스토리지의 크기입니다. 정수 (int)
처리량 스토리지에 지원되는 최대 처리량입니다. 스토리지 유형이 PremiumV2_LRS 또는 UltraSSD_LRS인 경우 필요합니다. 정수 (int)
계층 유연한 서버의 스토리지 계층입니다. 'P1'
'P10'
'P15'
'P2'
'P20'
'P3'
'P30'
'P4'
'P40'
'P50'
'P6'
'P60'
'P70'
'P80'
형 유연한 서버에 할당된 스토리지 유형입니다. 허용되는 값은 Premium_LRS, PremiumV2_LRS 또는 UltraSSD_LRS입니다. 지정하지 않으면 기본값은 Premium_LRS입니다. 'PremiumV2_LRS'
'Premium_LRS'
'UltraSSD_LRS'

TrackedResource태그

이름 묘사 값

사용자 할당 ID

이름 묘사 값
principalId 사용자 할당 관리 ID에 연결된 서비스 주체의 개체 식별자입니다. 문자열
형 유연한 서버와 연결된 ID 유형입니다. '없음'
'시스템 할당됨'
'시스템 할당, 사용자 할당'
'UserAssigned'(필수)
userAssignedIdentities 사용자가 할당한 관리 ID의 매핑입니다. UserAssignedIdentityMap

사용자 할당 신원 확인 맵

이름 묘사 값

사용자 신원

이름 묘사 값
클라이언트 ID 사용자 할당 관리 ID에 연결된 서비스 주체의 클라이언트 식별자입니다. 문자열
principalId 사용자 할당 관리 ID에 연결된 서비스 주체의 개체 식별자입니다. 문자열

사용 예제

Azure 확인된 모듈

다음 Azure 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.

모듈 묘사
DB for Postgre SQL 유연한 서버 Postgre SQL 유연한 서버용 DB용 AVM 리소스 모듈