Aracılığıyla paylaş

PostgreSQL için Cosmos DB REST API

Postgres için Azure Cosmos DB , işlem uygulamaları için tam olarak yönetilen, bulutta yerel olarak dağıtılmış bir SQL veritabanıdır.

Kaynak Sağlayıcısı Temsili Durum Aktarımı (REST) API'leri, Azure Cosmos DB kaynaklarınızı program aracılığıyla yönetmenizi sağlar. Desteklenen ana kategoriler şunlardır:

  • Kümeyi dağıtma, yönetme veya yükseltme.
  • Koordinatör \ çalışan düğümü yapılandırmalarını yönetin.
  • Güvenlik duvarı kurallarını yönetin.
  • Özel uç nokta bağlantılarını ve özel bağlantı kaynaklarını yönetin.
  • Rolleri yönetin.

Yetkilendirme

Tüm Azure Resource Manager REST çağrılarının başarılı olması için istek üst bilgisinde geçerli bir yetkilendirme belirteci olması gerekir. Bu yetkilendirme belirtecini alma hakkında ayrıntılı bilgi için bkz . İsteği oluşturma: Erişim belirteci alma.

REST API çağrıları yapma

PostgreSQL için Azure Cosmos DB dahil olmak üzere tüm Azure hizmetleri için REST API çağrıları yapmanın çeşitli yolları vardır. Postman'i REST API çağrıları için en evrensel çok amaçlı araç olarak kullanabilirsiniz. Curl'i, devops otomasyonunda kullanılanlar gibi katılımsız betikler de dahil olmak üzere diğer bazı senaryolar için de kullanabilirsiniz. Azure CLI'dan REST API çağrıları yapmak için kolay bir yol olarak 'az rest'i de kullanabilirsiniz.

Yer tutucular ve değerler

Aşağıdaki bilgiler, bu REST API'lerini kullanarak yapabileceğiniz tüm görevler için ortaktır:

  • değerini 2022-11-08 gibi en son kullanılabilir API sürümüyle değiştirin{api-version}.
  • değerini URI'deki abonelik tanımlayıcınızla değiştirin {subscriptionId} . Bu değer, 6B29FC40-CA47-1067-B31D-00DD010662DA gibi aboneliğinize özgü bir GUID'dir. Azure portal abonelikler dikey penceresini kullanarak abonelik kimliğini bulun.
  • öğesini kaynak grubuyla değiştirin {resourceGroupName} . Daha fazla bilgi için bkz. Azure kaynaklarınızı yönetmek için Kaynak gruplarını kullanma.
  • değerini PostgreSQL için Azure Cosmos DB kümenizin adıyla değiştirin {clusterName} . Mydemocluster gibi kısa adı kullanın.
  • content-Type üst bilgisini application/json olarak ayarlayın.
  • Yetkilendirme üst bilgisini Azure Active Directory'den aldığınız bir JSON Web Belirteci olarak ayarlayın. Daha fazla bilgi için Yetkilendirme bölümüne bakın.

Değerler

PostgreSQL kümeleri ve düğümleri için Azure Cosmos DB'ye yönelik çeşitli REST API çağrıları için desteklenen değerleri belirlemek için aşağıdaki başvuruyu kullanın.

Küme oluşturma ve güncelleştirme

  • properties.postgresqlVersion: Kümenizdeki tüm düğümlerde ana PostgreSQL sürümü. Desteklenen bir ana PostgreSQL sürümü belirtin. Örneğin, "15". Desteklenen Postgres sürümlerinin listesine bakın. Küme, en son ikincil PostgreSQL sürümü ve seçilen bölgede kullanılabilen en son karşılık gelen Citus sürümüyle oluşturulur.
  • properties.citusVersion: Kümenizdeki tüm düğümlere yüklenen Citus uzantısının sürümü. Örneğin, "11.3". Şu anda desteklenen Citus sürümüne bakın.
    • Bu özellik yeni bir küme sağlama için isteğe bağlıdır. Bu özellik atlanırsa, belirtilen ana PostgreSQL sürümü için desteklenen Citus'un en son sürümü yüklenir.
    • Bu özelliğin birincil örneği, 11.0 ile 11.3 gibi Citus sürüm yükseltmesidir. Kümenizdeki ana PostgreSQL sürümü için güncelleştirilmiş bir Citus sürümü yayımlandığında, yalnızca Citus sürümünü geçerli ana PostgreSQL sürümü için desteklenen en son sürüme yükseltmek için küme güncelleştirme API çağrısı kullanabilirsiniz.
  • properties.administratorLoginPassword: Kümenizdeki tüm düğümlerde 'citus' rolü parolası. Parolanın aşağıdaki gereksinimleri karşılaması gerekiyor
    • Uzunluk: En az 8 karakter ve en çok 128 karakter
    • Karmaşıklık: Aşağıdaki kategorilerin her birinden karakterler içermelidir:
      • İngilizce alfabesinin büyük harfleri
      • İngilizce alfabesinin küçük harfleri
      • Sayılar (0-9)
      • Alfasayısal olmayan karakterler (!, $, #, %, vb.)
    • Paroladaki rol adı: Rol adının tamamını veya bir bölümünü içeremez. Rol adının bir bölümü üç veya daha fazla ardışık alfasayısal karakter olarak tanımlanır
  • properties.coordinatorServerEdition: Tek bir düğümdeki veya çok düğümlü kümenin koordinatöründeki işlem türü. Desteklenen tek düğüm ve çok düğümlü işlem için aşağıdaki değerleri kullanın
    • Tek düğüm
      • Burstable, 1 sanal çekirdek: BurstableMemoryOptimized
      • Burstable, 2 sanal çekirdek: BurstableGeneralPurpose
      • Ani artırılamaz, desteklenen sanal çekirdekler: GeneralPurpose
    • Çok düğümlü
      • Ani artırılamaz, desteklenen sanal çekirdekler: GeneralPurpose
  • properties.coordinatorVCores: Tek düğümdeki veya çok düğümlü kümenin koordinatöründeki işlem sanal çekirdeklerinin sayısı. Bu sayfada desteklenen değerlere bakın.
  • properties.coordinatorStorageQuotaInMb: Tek bir düğümde MiB'de veya çok düğümlü kümedeki koordinatörde depolama boyutu. Tek düğümlü ve çok düğümlü yapılandırmalar için desteklenen depolama boyutlarına bakın. Örneğin, 128 GiB depolama alanı belirtmek için "131072" değeri (128 GiB * 1024 = 131072 MiB) kullanın.
  • properties.nodeServerEdition: Çalışan düğümlerindeki işlem türü. Yalnızca "MemoryOptimized" değeri desteklenir.
  • properties.nodeVCores: Çok düğümlü kümedeki her çalışan düğümündeki işlem sanal çekirdeklerinin sayısı. Bu sayfada desteklenen değerlere bakın.
  • properties.nodeStorageQuotaInMb: Çok düğümlü kümedeki bir çalışan düğümünde MiB'de depolama boyutu. Bkz. Desteklenen depolama boyutları çok düğümlü yapılandırmalar. Örneğin, 2 TiB depolama alanı belirtmek için "2097152" değeri kullanın (2 TiB * 1024 = 2048 GiB * 1024 = 2097152 MiB).
  • properties.coordinatorEnablePublicIpAccess: "False" olarak ayarlandığında, bu özellik küme düzenleyicisine genel erişimi devre dışı bırakır.
  • properties.nodeEnablePublicIpAccess: Bu özelliğin varsayılan değeri , çalışan düğümlerine doğrudan genel erişimi etkin bir şekilde devre dışı bırakmak için 'false' değeridir. Çok düğümlü kümelerdeki çalışan düğümlerine isteğe bağlı doğrudan erişimi etkinleştirmek için bu özelliği "True" olarak ayarlamanız ve bu genel IP adresleri için güvenlik duvarı kuralları oluşturmanız gerekir. Tüm güvenlik duvarı kuralları koordinatör ve tüm çalışan düğümleri için geçerlidir.

Güvenlik duvarı kuralı oluşturma

  • properties.startIpAddress ve properties.endIpAddress
    • Tek bir genel IP adresi için güvenlik duvarı kuralı oluşturmak için bu IP adresini hem startIpAddress hem de endIpAddress için bir değer olarak belirtin.
    • Azure tarafından yönetilen herhangi bir IP adresinden bağlantılara izin vermek için hem startIpAddress hem de endIpAddress değerleri için "0.0.0.0" belirtin. Bu güvenlik duvarı kuralının diğer müşterilerin Azure aboneliklerinden bağlantılara izin vereceğini unutmayın.

Rol oluşturma

  • properties.password: Kümenizdeki tüm düğümlerde oluşturulacak Postgres rolünün parolası. Parolanın aşağıdaki gereksinimleri karşılaması gerekiyor
    • Uzunluk: En az 8 karakter ve en çok 128 karakter
    • Karmaşıklık: Aşağıdaki kategorilerin her birinden karakterler içermelidir:
      • İngilizce alfabesinin büyük harfleri
      • İngilizce alfabesinin küçük harfleri
      • Sayılar (0-9)
      • Alfasayısal olmayan karakterler (!, $, #, %, vb.)
    • Paroladaki rol adı: Rol adının tamamını veya bir bölümünü içeremez. Rol adının bir bölümü üç veya daha fazla ardışık alfasayısal karakter olarak tanımlanır
  • Last updated on