4.15.07.00 - Private Cloud için Apigee Edge sürüm notları

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

8 Eylül 2015 Salı günü, Private Cloud için Apigee Edge'in önemli bir Özellik Sürümünü yayınladık.

Edge for Private Cloud'un üç aylık üç aylık sürümünden (4.15.04.00) bu yana aşağıdaki sürümler yayınlandı ve bu üç aylık sürüme dahil edildi:

• Bulut: 15.04.15, 15.04.29, 15.05.27, 15.06.10 ve 15.06.24
• Private Cloud: 4.15.04.01

Hangi Edge sürümlerini 4.15.07.00 sürümüne yükseltebileceğiniz

Mevcut Edge sürümünüze bağlı olarak şu iki işlemden birini yapabilirsiniz:

• Doğrudan 4.15.07.00 sürümüne yükseltin
• Kademeli olarak yükseltme yapın. Yani mevcut sürümünüzden Edge'in farklı bir sürümüne geçmeniz ve ardından 4.15.07.00'a yükseltmeniz gerekir.

Daha fazla bilgi için Hangi Edge for Private Cloud sürümlerini 4.15.07.00 sürümüne yükseltebileceğinizi inceleyin.

4.15.01.x sürümünden veya önceki bir sürümden yeni sürüme geçmeden önce

1. Cassandra SSTable sürümünü kontrol edin:
   1. Dizini /<install-root>/apigee4/data/cassandra/data olarak değiştirin.
   2. Bir bul komutu çalıştırın,
      > find . -name *-ic-*
      Cassandra 1 .2 SSTable kullanıyorsanız sonuçlar bir.db dosyaları grubu döndürecektir.
   3. Şu bulma komutunu çalıştırın:
      > find . -name *-hf-*
      Sonuçlar boş olmalıdır, yani hiçbir .db dosyası hf biçiminde değildir. hf biçiminde hiçbir dosya görmüyorsanız işlem tamamlanmıştır. Artık 4.15.07.00 sürümüne geçebilirsiniz.
      
      hf biçimi, Cassandra 1.0 SSTables içindir. hf biçiminde *.db dosyalarınız varsa SSTable'ı bu prosedürün geri kalanında açıklandığı gibi yükseltmeniz gerekir.
2. hf biçiminde *.db dosyaları bulursanız tüm Cassandra düğümlerini yükseltene kadar her Cassandra düğümünde aşağıdaki komutu çalıştırarak SSTable'ı yükseltin:
   > /<install-root>/Apigee4/share/apache-cassandra/bin/nodetool -h localhostUpgradestables -a
3. Tüm *.db dosyalarının Cassandra 1.2 sürümü için ic biçiminde olup olmadığını kontrol etmek üzere 1. adımı tekrarlayın.
4. Edge kurulumunuzdaki her Cassandra düğümünde 1 ile 3 arasındaki adımları tekrarlayın.
5. Edge 4.15.07.00 sürümüne yükseltin.
6. 4.15.07.00 yükseltmesinden sonra *.db dosyalarını kontrol ederek bunların hepsinin C* 2.0 stili kararlı sürüme yükseltildiğinden emin olun:
   > cd /<install-root>/Apigee4/data/cassandra/data
   > find . -name *-jb-*
   Cassandra 2 .0'ı çalıştırıyorsanız bu komut bir.db dosyaları grubu döndürecektir.

Yeni özellikler ve geliştirmeler

Bu sürümdeki yeni özellikler ve geliştirmeler aşağıda verilmiştir.

Yükleme ve yükseltme

Seçmeli bileşen yükseltme ve kaldırma

Apigee-upgrade.sh ve Apigee-uninstall.sh komut dosyaları artık yeni sürüme geçirmek veya kaldırmak için Edge bileşenlerini seçebilmenizi sağlıyor. Daha önce düğümdeki tüm bileşenler yükseltilmiş veya kaldırılmıştı. (OPDK-1377, OPDK-1175)

Yükseltme işlemini geri alma

Yükseltme sırasında Apigee-upgrade.sh başarısız olursa artık yükseltmeyi geri almak için Apigee-rollback.sh komut dosyasını kullanabilirsiniz. Yükseltme sorunlarını düzelttikten sonra yükseltme işlemini yeniden deneyebilirsiniz. (OPDK-1275)

Kısaltılmış yükleyici komut dosyası seçenekleri

Yükleme komut dosyaları artık --help gibi uzun seçeneklere sahip değil. Artık yalnızca -h gibi tek harfli seçenekleri kabul ediyorlar. (OPDK-1356)

SmartDokümanlar kurulumu

SmartDokümanlar'ı kurulum-smartdocs.sh komut dosyasıyla yüklerken kuruluş, ortam ve sanal ana makineyi girmeniz istenir. Bu, SmartDokümanlar'ın beklenen konuma yüklenmesini sağlar. Önceden, bu değerler komut dosyasına sabit kodlanıyordu. (OPDK-1310)

update-cass-pwd-in-config.sh'i istem olmadan çalıştırma

ENABLE_CASS_AUTH, CASS_KULLANICIADI ve CASS_password ortam değişkenlerini ayarlarsanız güncelleme-cass-pwd-in-config.sh komut dosyası istem olmadan çalışabilir. (OPDK-1309)

Kenar Platformu

Bu sürüme eklenen yeni Edge platformu özellikleri aşağıda verilmiştir.

Edge Private Cloud tarafından desteklenen OpenJDK 1.7

Edge'in bu sürümü Oracle JDK 1.7 ve OpenJDK 7'yi desteklerken JDK 1.6 desteğini kaldırdı. (OPDK-1187)

İşletim sistemi desteği

Private Cloud için Apigee Edge, işletim sistemi desteğini Red Hat Enterprise Linux 6.6 ve 7.0 (64 bit), CentOS 6.5, 6.6 ve 7.0 (64 bit) ve Oracle Linux 6.5'i içerecek şekilde genişletti.

Cassandra 2.0.15, OPDK 15.07'ye dahil

Bu sürüm Cassandra'nın 2.0.15 sürümünü yükler. Önceki bir sürüm için yükseltme yapıyorsanız Cassandra sürümünüz güncellenir. (OPDK-1197)

OAuth jetonu karma oluşturma işlemi için SHA2 desteği

Veritabanı güvenlik ihlali durumunda Edge, OAuth jetonlarını daha iyi korumak için OAuth jetonlarına karma oluşturma işlemi uygulayan SHA2 algoritmalarını (SHA1'e ek olarak) destekler. Düzenleme düzeyindeki yeni özelliklerle, yeni jetonlar için karma oluşturma işlemini etkinleştirebilir ve yapılandırabilir, ayrıca bu yeni özellikten önceki jetonlarda eski karma oluşturma işlemini kullanmaya devam edebilirsiniz. Daha önce Private Cloud için Edge'de, keymanagement.properties dosyasındaki (yönetim sunucunuzda ve mesaj işlemcilerinizde) hash.oauth.tokens.enabled adlı bir mülk, OAuth jetonlarının otomatik SHA1 karma oluşturma işlemini etkinleştiriyordu. Bu özellik kullanımdan kaldırıldı.

SHA1 karma oluşturma işlemini etkinleştirmek için daha önce hash.oauth.tokens.enabled özelliğini kullandıysanız bu sürüme yönelik yükseltme komut dosyası, sizin için otomatik olarak kuruluş düzeyindeki yeni özellikleri oluşturur. Yükseltme işleminden sonra doğrulamak için şu API ile sistem yöneticisi olarak bir GET işlemi yapın: https://{host}:{port}/v1/o/{kuruluşunuz}.

• Yeni özelliklerle kuruluşunuzda jeton karma oluşturma işlemini etkinleştirme hakkında bilgi edinmek için Erişim jetonları isteme konusundaki "Veritabanındaki jetonlara karma oluşturma işlemi yapma" bölümüne bakın.
• Mevcut jetonlara toplu olarak karma oluşturma işlemi uygulama hakkında bilgi edinmek için Edge for Private Cloud İşlem Rehberi'ni inceleyin. (APIRT-1389)

Günlük dosyaları için düz dizin yapısı

Message-logging.properties dosyasında yeni bir enable.flat.directory.structure özelliğini "true" (doğru) değerine ayarlayarak, Edge'i günlük dosyalarını düz dizin yapısında depolayacak şekilde yapılandırabilirsiniz. Daha fazla bilgi için Message Logging politikası bölümüne bakın. (APIRT-1394)

Ortam önbelleği performansı

Daha iyi bellek içi önbellek yönetimi ve kullanımı için ortam önbellek kaynaklarındaki "Bellekteki Maksimum Öğe Sayısı" ayarları kullanımdan kaldırılmıştır. Tüm önbellek kaynaklarında (varsayılan önbellek dahil) bulunan toplam öğe sayısı, önbelleğe ayrılan toplam belleğe bağlıdır. Varsayılan olarak, belirli bir mesaj işlemcisinde bellek içi önbelleğe alma için ayrılan toplam bellek, kullanılabilir belleğin% 40'ıdır. Bu değer, mesaj işlemci cache.properties dosyanızdaki önbellek özelliği ayarları tarafından belirlenir. Öğeler, yalnızca yeterli önbellek olmadığında veya öğelerin süresi dolduğunda bellek içi önbellekten çıkarılır.

Önbellek yönetiminde "Bellekteki Maksimum Öğe Sayısı" özelliğini kullanma eski davranışına geri dönmek için cache.properties dosyasında overrideMaxElementsInCacheResource=false özelliğini ayarlayın. (APIRT-1140)

API Hizmetleri

Bu sürüme eklenen yeni API Hizmetleri özellikleri aşağıda verilmiştir.

Varsayılan olarak yeni Proxy Düzenleyici

Yeni API proxy düzenleyicisi, yönetim kullanıcı arayüzünde varsayılan olarak etkindir. Yeni düzenleyici; koşullu akışların ve uç noktaların Genel Bakış sayfasındaki daha kapsamlı görünümler, Geliştirme sayfasındaki tüm yapılandırmalar; koşullu akışların, uç noktaların ve politikaların daha kolay bir şekilde eklenmesi, küçük snippet'ler yerine daha eksiksiz XML görünümleri, dosya adlarını ve metni tarayan arama gibi daha kapsamlı özellikler içerir. (MGMT-2279)

Yeni OAuth v2.0 Bilgi Politikası Silme

Yeni "OAuth v2.0 Bilgilerini Silme" politikası, OAuth v2 erişim jetonlarını ve yetkilendirme kodlarını silebilmenizi sağlar. Politika, daha önce Management API'si tarafından sağlanan işlevlerin yerini alır. Daha fazla bilgi için OAuthV2 Bilgi Politikası'nı silme bölümüne bakın. (MGMT-2257)

Yeni OAuth v1.0 Bilgi Politikası Silme

Yeni "OAuth v1.0 Bilgilerini Silme" politikası, OAuth v1.0 istek jetonlarını, erişim jetonlarını ve doğrulayıcı kodlarını silmenize olanak tanır. Politika, yönetim API'sinin önceden sağladığı işlevlerin yerini alır. Daha fazla bilgi için OAuth V1 Bilgi politikasını silme başlıklı makaleye bakın. (APIRT-1351)

Erişim Denetimi politikası

Erişim Denetimi politikası, X-FORWARDED-FOR HTTP üst bilgisinde IP adresleri bulunduğunda, IP adreslerinin izin verilenler ve ret listesine ekleme işlemleri için daha ayrıntılı değerlendirilmesini sağlayacak şekilde geliştirilmiştir.

Başlıkta birden fazla IP adresi denetimi etkinken (feature.enableMultipleXForwardCheckForACL özelliğini ayarlamak için Destek Ekibi ile iletişime geçin) politikadaki yeni bir <ValidateBasedOn> öğesi başlıktaki ilk IP'yi, son IP'yi veya tüm IP'leri kontrol etmenize olanak tanır. Daha fazla bilgi için Erişim denetimi politikası başlıklı makaleyi inceleyin.

Access Entity politikasındaki yeni varlıklar

Erişim Varlık Politikası ile şu yeni varlıklara erişim sağlanır: tüketici anahtarı kapsamları, yetkilendirme kodu, istek jetonu ve doğrulayıcı. Daha fazla bilgi için Access Entity politikası başlıklı makaleyi inceleyin.

İstatistik Toplayıcı politikası: İstatistik adının otomatik olarak küçük harfe dönüştürülmesi

API proxy düzenleyicisinde (Geliştirme sayfası > Araçlar > Özel Analytics Koleksiyonu) özel analiz koleksiyonu oluştururken toplayıcı değişkeni (istatistik) "Ad" küçük harf olmalıdır. Adı büyük harfle girerseniz araç, İstatistik Toplayıcı politikasında İstatistik adını otomatik olarak küçük harfe dönüştürür. (MGMT-740)

API proxy düzenleyicisinde Klasik İzleme özelliğinin kaldırılması

API proxy düzenleyicisindeki Trace işlevinin en yeni sürümü, beta sürümünden genel kullanıma sunuldu. "İzlemenin klasik sürümüne eriş" bağlantısıyla "klasik iz" erişimi artık kullanılamaz.

Yönetim kullanıcı arayüzünden Apigee Topluluğu erişimi Yardım menüsünden

Apigee Topluluğu'na, yönetim kullanıcı arayüzü Yardım menüsünden erişebilirsiniz.

Yönetim kullanıcı arayüzündeki hata mesajları

Yönetim kullanıcı arayüzündeki hata mesajı geliştirmeleri aşağıda verilmiştir:

• Siz kapatmadıkça tüm giriş oturumu boyunca tüm hata mesajlarını kullanıcı arayüzünde gruplandırmak ve görüntülemek için kullanılan yönetim kullanıcı arayüzü. Bu güncellemeyle, hata mesajları, oluştukları sayfadan ayrıldığınızda otomatik olarak temizlenir. (MGMT-2254)
• Yönetim kullanıcı arayüzü artık yinelenen hata mesajlarını gizlemiyor. (MGMT-2242)

Kullanıcı arayüzü performansı ve hata geliştirmeleri

Sayfa görüntüleme performansı ve hata mesajı temizlemesi de dahil olmak üzere, yönetim kullanıcı arayüzünün farklı alanlarında genel iyileştirmeler yapıldı.

Yönetim kullanıcı arayüzündeki Kuruluş Kullanıcıları sayfasındaki rol köprüleri

Yönetim kullanıcı arayüzündeki Kuruluş Kullanıcıları sayfasında (Yönetici > Kuruluş Kullanıcıları) rol adları artık köprülüdür. Böylece rol sayfalarına hızlıca gidebilirsiniz. (MGMT-1055)

Mesaj akışında yeni hedef değişkenleri

Mesaj akışlarındaki yeni değişkenler, hedef uç noktalar ve hedef sunucular için daha eksiksiz URL bilgileri sağlar:

• TargetEndpoint: request.url, target.basepath.with.query yerinin yerini alır.
• TargetServer: loadbalancing.targetserver, targetserver.name yerine geçer. Ayrıca target.basepath, yalnızca TargetEndpoint'in HTTPTargetConnection <LoadBalancer> öğesinde <Path> öğesi kullanıldığında doldurulur.

Server Name Indication (Sunucu Adı Göstergesi - SNI) desteği

Edge, güney sınırda (mesaj işlemciden hedef uç noktalara) Sunucu Adı Göstergesi'nin kullanımını destekler. SNI kullanmak istiyorsanız Apigee Destek Ekibi ile iletişime geçin.

Java 1.7 gereklidir.

TLS/SSL'nin bir uzantısı olan SNI ile bu hedeflerin tamamının aynı sertifikayı kullanmasına gerek kalmadan aynı IP adresi ve bağlantı noktası üzerinden birden fazla HTTPS hedefi sunulabilir.

Edge'e özel yapılandırma gerekmez. Ortamınız güney sınırındaki SNI için yapılandırılmışsa (Edge bulutu varsayılan olarak etkindir) Edge tarafından desteklenir.

Edge, istek URL'sinden ana makine adını otomatik olarak çıkarır ve bunu SSL el sıkışma isteğine ekler. Örneğin, hedef ana makine https://example.com/request/path ise Edge aşağıda gösterildiği gibi server_name uzantısını ekler:

SNI hakkında daha fazla bilgi için http://en.wikipedia.org/wiki/Server_Name_Indication adresine bakın.

SSL Sertifikaları ayrıntılarındaki "İmza Algoritması"

SSL sertifikası ayrıntılarına yeni bir "İmza Algoritması" alanı eklendi. Bu alan yönetim kullanıcı arayüzünde (Yönetici > SSL Sertifikaları) ve yönetim API'sinde (Anahtar Deposu veya Truststore'dan Sertifika Ayrıntılarını Alma) görüntülenebilmektedir. Alanda, sertifikayı oluşturmak için kullanılan karma algoritmasının türüne bağlı olarak "sha1WithRSAEncryption" veya "sha256WithRSAEncryption" gösterilir.

Süresi dolmak üzere olan SSL sertifikaları gösteriliyor

Yönetim arayüzündeki (Yönetici > SSL Sertifikaları) SSL Sertifikaları sayfası, yeni geçerlilik bitiş açılır menüsündeki seçiminize bağlı olarak SSL sertifikalarının süresinin 10, 15, 30 veya 90 gün içinde dolacağını belirtir.

Tehdit koruması hatası yapılandırması

Bir ileti JSON veya XML Tehdit Koruması politikasını geçemezse Edge, varsayılan olarak HTTP 500 Dahili Sunucu Hatası durum kodu ve ExecutionFailed hatası verir. Bu hata davranışını, kuruluş düzeyinde yeni bir mülkle değiştirebilirsiniz. features.isPolicyHttpStatusEnabled kuruluş özelliği "true" (doğru) değerine ayarlandığında aşağıdaki davranış gerçekleşir:

• İstek: Herhangi bir istek akışına tehdit koruması politikası eklendiğinde geçersiz mesajlara karşılık gelen bir politika hata mesajıyla birlikte 400 durum kodu döndürülür.
• Yanıt: Herhangi bir yanıt akışına eklenmiş bir tehdit koruması politikası olduğunda, geçersiz iletiler yine de 500 durum kodu döndürür ve (yalnızca ExecutionFailed yerine) karşılık gelen politika hata mesajlarından biri yayınlanır.

Cloud müşterileri, kuruluş mülkünü ayarlamak için Apigee Destek ekibiyle iletişime geçmelidir. Bu özellik, üç aylık bir sonraki Private Cloud sürümünde Edge Private Cloud müşterilerine sunulacaktır.

Uç noktalar, proxy'ler ve diğer varlıklar için güncellenen şemalar

TargetEndpoint, ProxyEndpoint, APIProxy ve daha birçok politika dışı varlık için referans şemalar güncellendi. https://github.com/apigee/api-platform-samples/tree/master/schemas adresine bakın. (APIRT-1249)

Geliştirici Hizmetleri

Bu sürümde yer alan Geliştirici Hizmetleri yeni özellikleri aşağıda verilmiştir.

SmartDokümanlar'ın genel kullanılabilirliği

SmartDokümanlar beta sürümünden genel kullanıma sunuluyor. Güncellemeler ve yeni özellikler şunlardır:

• Dosya veya URL ile içe aktarma dahil olmak üzere Swagger 2.0 desteği (özel adlandırılmış güvenlik nesneleri için destek dahil).
• SmartDokümanlar oluşturan şablonlarda görsel tasarım iyileştirmeleri.
• Geliştirici Portalı'ndaki kullanılabilirlik ve iş akışı iyileştirmelerine Drupal'daki İçerik > SmartDokümanlar menüsünden ulaşabilirsiniz.
• "Özel Jeton" kimlik doğrulaması olarak bilinen teknolojiye artık "API Anahtarı" adı veriliyor.
• Kimlik doğrulama "güvenlik" nesneleri düzeltme düzeyinde tanımlanır.
• Şablon düzeyinde istemci kimlik doğrulamasının yapılandırması. Yeni düzeltmeler artık önceden yapılandırılmış SmartDokümanlar istemci kimlik bilgilerini sıfırlamaz.

Diğer özellik açıklamaları için bu blog yayınını inceleyin.

SmartDokümanlar dokümanları için SmartDokümanlar'ı doküman API'leri için kullanma bölümüne bakın.

Yönetim kullanıcı arayüzünde gösterilen geliştirici uygulama adı

Edge'deki geliştirici uygulamalarında hem değişmeyen dahili bir Ad hem de değiştirebileceğiniz bir Görünen Ad bulunur. Yönetim kullanıcı arayüzündeki (Yayınla > Geliştirici Uygulamaları > uygulama adı) bir Geliştirici Uygulaması sayfasında, uygulamanın dahili "Adı" "Görünen Ad" ile birlikte görüntülenir. Böylece, sorun giderme ve API yönetimi için uygulamaların dahili adlarına göre görsel olarak daha kolay ayırt edilir.

Analiz Hizmetleri

Bu sürüme eklenen yeni Analytics Hizmetleri özellikleri aşağıda verilmiştir.

Korunan veriler için zaman sınırı

Yönetim kullanıcı arayüzü veya API ile analiz raporları oluştururken geçerli tarihten altı aydan daha eski olan verilere varsayılan olarak erişilemez. Altı aydan daha eski verilere erişmek istiyorsanız Apigee Destek Ekibi ile iletişime geçin.

Özel raporların klasik sürümü yönetim arayüzünden kaldırılıyor

Özel analiz raporlarının isteğe bağlı klasik sürümü, artık yönetim kullanıcı arayüzünde kullanılamaz.

Geliştirici Etkileşim widget'ı performansı

Ana analiz kontrol panelindeki (Geliştirici Etkileşimi bölümü) dönüşüm hunisi widget'ı daha iyi performans sağlamak için iyileştirildi.

Para kazanma

Bu sürümde yer alan yeni para kazanma özellikleri aşağıda verilmiştir.

Ücret planı e-posta bildirimleri

Yeni Ücret Planı e-posta bildirim türü, satın aldıkları hacim bantlı veya paket ücreti planlarında belirli bir işlem veya dolar sınırına ulaştıklarında geliştiricileri bilgilendirmenize olanak tanır. Ayrıntılar için Bildirim şablonlarını kullanarak bildirimleri ayarlama bölümüne göz atın.

Yinelenen Ücret ve Toplama Temeli dönemlerinin senkronizasyonu

Ücret planında, potansiyel olarak iki farklı dönem bulunmaktadır:

• Geliştiricilerden ne zaman yinelenen bir ücret alınacağını belirleyen, ücret planının Ücretler sekmesinde yapılandırılan Yinelenen Ücret dönemi.
• Hacim Bantlı veya Paket planları için ücret listesinde tanımlanan ve paket kullanımının geliştiriciler için ne zaman sıfırlandığını belirleyen Toplama Temeli dönemi.

Bu iki dönem artık senkronize edilir. Ücret planında hem sıfır olmayan bir yinelenen ücret hem de Hacim Bantlı veya Paket ücret listesi varsa her ikisi için de yinelenen ücret dönemi kullanılır. Örneğin, aylık olarak yinelenen bir ücret varsa ücret listesi paketleri de aylık olarak sıfırlanır (varsayılan olarak ayın başında).

Yinelenen bir ücret yoksa paketler, ücret listesinde tanımlanan Toplama Temeline göre sıfırlanır. Örneğin, geliştirici bir ücret listesini ayın 19'unda kullanmaya başlarsa ve Toplama Temeli her ay ise paket kullanımı ayın 19'undan sonraki bir ay sıfırlanır.

Toplama Temeli desteği sonlandırılmaktadır ve gelecekteki bir sürümde para kazanma özelliği kaldırılacaktır. Daha fazla bilgi için Ücret listesi planı ayrıntılarını belirtme bölümüne bakın.

Özet gelir raporlarındaki Özel Özellikler

İşlem kaydetme politikaları, isteğe bağlı olarak işlemlerden özel özellik verilerini yakalamanıza olanak tanır ve artık bu özel işlem özelliklerini özet gelir raporlarına dahil edebilirsiniz. Kuruluşunuza bir MINT.SUMMARY_CUSTOM_ATTRIBUTES özelliği ekleyerek raporlarda kullanılmak üzere veritabanı tablolarına hangi özel özelliklerin ekleneceğini belirtebilirsiniz.

Private Cloud için Apigee Edge müşterileri, aşağıdaki API çağrısı ve Sistem Yöneticisi kimlik bilgileriyle bayrağı ayarlayabilir.

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

API çağrısındaki özel özellikler dizisinin URL olarak kodlandığını unutmayın.

SmartDokümanlar yükseltme işlemi

Beta döneminde SmartDokümanlar'ı zaten kullanıyorsanız genel kullanıma sunulan sürümdeki yeni özellikler ve işlevler, geliştirici portalınızda SmartDokümanlar'ı yükseltmenizi gerektirir.

Geliştirici portalınızda yayınlanmış tüm SmartDokümanlar sayfaları çalışmaya devam eder ancak mevcut veya yeni sayfalarda yapılan değişiklikleri düzenlemeden ya da yayınlamadan önce güncelleme işlemini uygulamanız gerekir.

SmartDokümanlar'ı geliştirici portalınızda oluşturup yayınlayabileceğinizi, ancak SmartDokümanlar'ın Apigee'nin Edge API Yönetim Hizmetleri kapsamında bulunan API modelinden oluşturulduğunu unutmayın. Edge'de bir API modelinde yaptığınız değişiklikler tüm Pantheon ortamlarınızda aynı olur (geliştiricilerin Pantheon ortamlarında var olması gibi).

SmartDokümanlar beta sürümünden genel kullanıma geçmek için

1. 15.05.27 sürümünü Pantheon'daki dev veya test ortamlarınızda güncelleyip test edin.
2. Kullanmakta olduğunuz mevcut API modellerinin yerini alacak yeni bir model oluşturun.
   • Swagger veya WADL belgelerini içe aktarıyorsanız bunları tekrar yeni bir düzeltmeye aktarın.
   • API modelinizin bakımını SmartDokümanlar modülü aracılığıyla yapıyorsanız dosyayı SmartDokümanlar JSON dosyası olarak dışa aktarın ve dosya ekini kullanarak yeni modelinize aktarın.
3. Modelinizin düzeltmesinin güvenlik özelliklerini ayarlayın. İçerik > SmartDokümanlar > model sayfasında Güvenlik Ayarları'nı seçin.
   
4. İşlemler sütununda Ayarlar'ı tıklayarak model ayarları sayfasındaki (İçerik > SmartDokümanlar) önceden yapılandırılmış kimlik doğrulamasını kontrol edin.
   
5. Tüm özel şablonları, CSS ve JS öğelerinin v6'sını kullanacak şekilde güncelleyin ve authSchemes ve apiSchema gibi yeni nesne adlarını yansıtacak şekilde değişiklikler yapın. SmartDokümanlar şablonlarını güncelleme hakkında bilgi edinmek için SmartDokümanlar'ı doküman API'leri için kullanma bölümüne bakın.
6. Model düzeltmenizi yeniden oluşturun ve yayınlayın.
7. Yeni dokümanları doğruladıktan sonra üretim portalınızı 15.05.27 sürümüne güncelleyin.

Edge Enterprise müşterisiyseniz ve yükseltme işlemiyle ilgili sorularınız veya endişeleriniz varsa lütfen marsh@impression.com ve cnovak@impression.com adresine e-posta gönderin. Aksi takdirde en iyi yanıt için lütfen Apigee Topluluğu'nu kullanın.

Gelecekte yapılacak özellik değişiklikleri ve geliştirmeler

Bu bölümde, gelecekte yapılması beklenen özellik değişiklikleri ve geliştirmelerin önizlemesi sunulmaktadır:

Yanıt Önbelleği politika davranışında değişiklik

Gelecekteki bir sürümde çıkacak (belirlenecek) Yanıt Önbelleği politikasının <ExcludeErrorResponse> öğesinin varsayılan davranışı değişecek.

Mevcut davranış: Yanıt önbelleği politikasındaki <ExcludeErrorResponse> öğesi varsayılan olarak yanlıştır. Bu, varsayılan olarak, olası bir HTTP durum koduna (3xx dahil) sahip yanıtların, Yanıt Önbelleği politikası tarafından önbelleğe alındığı anlamına gelir.

Gelecekteki davranış: Yanıt Önbelleği politikasındaki <ExcludeErrorResponse> öğesi varsayılan olarak doğru olacaktır. Bu da varsayılan olarak yalnızca 200 ila 205 HTTP Durum kodlarına sahip yanıtların önbelleğe alınacağı anlamına gelir. Bu davranışı geçersiz kılmak ve tüm durum kodları için yanıtları önbelleğe almak amacıyla <ExcludeErrorResponse> öğesini açıkça true olarak ayarlamanız gerekir.

Şu anki çözüm: Private Cloud 4.15.07.00 ve daha eski sürümler için yalnızca 200 ila 205 durum kodlarına sahip yanıtları önbelleğe almak istiyorsanız <ExcludeErrorResponse> öğesini açıkça true olarak ayarlamanız gerekir.

Düzeltilen hatalar

Bu sürümde aşağıdaki hatalar düzeltilmiştir.

Bilinen sorunlar

Bu sürümde aşağıdaki bilinen sorunlar bulunuyor.

> source /{install-dir}/apigee4/bin/apigee-env.sh 

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4` 

> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh 

> rm /install-dir/apigee4/share/monetization 

************************************** 
In order to complete the monetization upgrade please run: 
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh 
************************************** 

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

<install_dir>/apigge4/bin/apigee-service message-processor restart