Apigee-access modülünü kullanma

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

apigee-access modülü, Node.js uygulama kodundan API proxy akışı değişkenlerine ve önbelleklere erişmenizi sağlar. Modül, Apigee Edge platformuna dahildir. Diğer Node.js modüllerinde olduğu gibi yüklemeniz gerekmez.

apigee-access'i edinme

apigee-access modülü, Apigee Edge platformuna entegre edilmiştir. Node.js kodunu Edge'e dağıttığınızda bu modül kullanılabilir. Dağıttığınız herhangi bir Node.js kodunda bunu istemeniz yeterlidir. Örneğin:

var access=require('apigee-access');

Akış değişkenlerine erişme

Bir Node.js uygulamasını Edge'e dağıttığınızda desteklenen "hazır" akış değişkenlerine, politikalar tarafından oluşturulan akış değişkenlerine ve Node.js kodunuzda kendinizin oluşturduğu akış değişkenlerine erişebilirsiniz. Akış değişkenleri, Edge'de çalışan bir API proxy'si bağlamında oluşturulur ve bu bağlamda bulunur. Ayrıntılı bilgi için Node.js'de akış değişkenlerine erişme başlıklı makaleyi inceleyin.

Önbelleğe erişme

apigee-access modülü, Node.js kodunuzdan Apigee Edge dağıtılmış önbelleğine erişmenizi sağlar. Ayrıntılı bilgi için Node.js'de önbelleğe erişme başlıklı makaleyi inceleyin.

Kota hizmetini kullanma

apigee-access modülü, Node.js kodunuzdan Apigee Edge kota hizmetine erişmenizi sağlar. Ayrıntılı bilgi için Node.js'de kota hizmetine erişme başlıklı makaleyi inceleyin.

Anahtar/değer eşlemelerine erişme

apigee-access modülü, Node.js kodunuzdan Apigee Edge anahtar/değer eşlemelerine (KVM'ler) erişmenizi sağlar. Ayrıntılı bilgi için Node.js'de anahtar/değer eşlemlerine erişme başlıklı makaleyi inceleyin.

Yerel modda ve dağıtılmış modda çalıştırma

Yerel geliştirme ve testi desteklemek için apigee-access modülü, Apigee Edge'e bağımlı olmadan yerel modda çalışır. Ancak modül, Edge'e dağıtılan bir API proxy'siyle kullanıldığında "yerel" işlevinin yerini yerel Edge işlevi alır. Örneğin, akış değişkenlerinin tamamına dağıtılan modda erişilebilirken Node.js uygulamasını yerel olarak çalıştırdığınızda yalnızca küçük bir alt küme kullanılabilir. Bu yerel mod değişkenlerinin listesi için Yerel modda çalıştırma başlıklı makaleyi inceleyin.

Modülün hangi modda çalıştığını belirleme

apigee-access'i hangi modda çalıştırdığınızı belirlemek için:

var access = require('apigee-access')
console.log('The deployment mode is ' + access.getMode());

getMode() işlevinin döndürdüğü değer, Node.js uygulamasının Apigee Edge'e dağıtılıp dağıtılmadığını veya bağımsız modda çalışıp çalışmadığını gösterir. Yöntem, şu iki dize sonucundan birini döndürür:

  • apigee - Node.js uygulaması Apigee Edge'de çalışıyor ve tüm işlevler destekleniyor.
  • standalone - Node.js uygulaması, Apigee Edge ortamı dışında çalışıyor ve belgenin üst kısmında açıklanan varsayılan işlev devreye giriyor.

Dağıtılmış modda çalıştırma

Edge'e dağıtıldığında, politikalar tarafından ayarlanan değişkenler apigee-access tarafından görülebilir. Bu modülün yöntemleriyle eklenen veya değiştirilen değişkenler ise proxy akışındaki sonraki politikalar tarafından görülebilir.

Desteklenen değişkenlerin bağlantısını Değişken Referansı bölümünde bulabilirsiniz. Bu değişkenler ve kendi adlarınızla oluşturduğunuz tüm değişkenler apigee-access tarafından görülebilir. Bazı değişkenlerin salt okunur olduğunu unutmayın. Bunlar Değişken Referansı'nda tanımlanır.

Yerel modda çalıştırma

"Yerel modda" Node.js kodunuzu Apigee Edge bağlamı dışında çalıştırıyorsunuz. Bu modda, önceden tanımlanmış akış değişkenlerinin çoğu Node.js kodunuzda erişilemez. Bu tabloda, kullanılabilen akış değişkenlerinin küçük bir alt kümesi gösterilmektedir. Bu değişkenler, Apigee Edge için Node.js uygulamalarının yerel olarak geliştirilmesini ve test edilmesini desteklemek amacıyla burada desteklenir.

Değişken Salt okunur Tür Notlar
client.received.start.time Evet Dize İsteğin alındığı zaman
client.received.end.time Evet Dize İsteğin alındığı zaman
client.received.start.timestamp Evet Tamsayı İsteğin alındığı zaman
client.received.end.timestamp Evet Tamsayı İsteğin alındığı zaman

Apigee Edge platformunda çok daha büyük bir önceden tanımlanmış değişken grubu desteklenir. Tam liste için Apigee Edge Değişkenler Referansı'na bakın.