ينشئ الفهرس المحدد. الحالة الأولية للفهرس الذي تم إنشاؤه حديثًا هي CREATING
. عند إكمال عملية إرجاع google.longrunning.Operation
، ستكون الولاية هي READY
. إذا كان الفهرس متوفّرًا حاليًا، سيعرض الاستدعاء حالة ALREADY_EXISTS
.
أثناء الإنشاء، قد تؤدي العملية إلى حدوث خطأ، وفي هذه الحالة سيتم نقل الفهرس إلى حالة ERROR
. يمكن استرداد العملية عن طريق إصلاح البيانات التي تسبّبت في حدوث الخطأ، وإزالة الفهرس باستخدام delete
، ثم إعادة إنشاء الفهرس باستخدام create
.
لا يمكن إنشاء فهارس تتضمّن حقلاً واحدًا.
طلب HTTP
POST https://firestore.googleapis.com/v1beta1/{parent=projects/*/databases/*}/indexes
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
parent |
اسم قاعدة البيانات التي سيتم تطبيق هذا الفهرس عليها. مثلاً: |
نص الطلب
يحتوي نص الطلب على مثيل Index
.
نص الاستجابة
في حال نجاح الإجراء، يحتوي نص الاستجابة على مثيل Operation
تم إنشاؤه حديثًا.
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.