Apigee-access modülünü kullanma

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

apigee-access modülü, API proxy akışı değişkenlerine ve önbelleklerine Node.js uygulama kodundan erişmenizi sağlar. Modül, Apigee Edge platformuna dahildir. Diğer Node.js modülleriyle yaptığınız gibi yüklemenize gerek yoktur.

Apigee-access alma

apigee-access modülü, Apigee Edge platformuna entegre edilmiştir. Node.js kodunu Edge'e dağıttığınızda bu modüle erişebilirsiniz. Yalnızca dağıttığınız Node.js kodunda bunu zorunlu kılmanız 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 "kullanıma hazır" akış değişkenlerine, politikalar tarafından oluşturulan akış değişkenlerine ve Node.js kodunuzdan kendi oluşturduğunuz akış değişkenlerine erişebilirsiniz. Akış değişkenleri, Edge'de çalışan bir API proxy'si bağlamında oluşturulur ve bulunur. Ayrıntılı bilgi için Node.js'de akış değişkenlerine erişme bölümüne bakın.

Önbelleğe erişme

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

Kota hizmetini kullanma

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

Anahtar/Değer Eşlemesine Erişim

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

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

apigee-access modülü, yerel geliştirme ve test sürecini desteklemek için Apigee Edge'de herhangi bir bağımlılık olmadan yerel modda çalışır. Ancak modül Edge'ye dağıtılan bir API proxy'si ile kullanıldığında "yerel" işlevin yerini yerel Edge işlevi alır. Örneğin, dağıtılan modda akış değişkenlerinin tamamına erişebilirsiniz. Node.js uygulamasını yerel olarak çalıştırdığınızda ise yalnızca küçük bir alt küme kullanılabilir. Bu yerel mod değişkenlerinin listesi için Yerel modda çalıştırma konusuna bakın.

Modülün çalıştığı modu 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ürülen değeri, 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ı bildirir. 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ının dışında çalışıyor ve belgenin üst kısmında açıklanan varsayılan işlev devreye giriyor.

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

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

Desteklenen değişkenlerin bağlantısını Değişkenler Referansı'nda 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şkenler Referansı'nda tanımlanmıştır.

Yerel modda çalışma

"Yerel modda", Node.js kodunuzu Apigee Edge bağlamında çalıştırırsınız. Bu modda, önceden tanımlanmış akış değişkenlerinin çoğuna Node.js kodunuzdan erişilemez. Bu tabloda, kullanılabilen küçük akış değişkenleri alt kümesi gösterilmektedir. Bu değişkenler, Apigee Edge için Node.js uygulamalarının yerel geliştirilmesini ve test edilmesini desteklemek için burada desteklenmektedir.

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

Yine Apigee Edge platformunda önceden tanımlanmış çok daha fazla değişken desteklenir. Tam liste için Apigee Edge Değişkenler Referansı'na bakın.