Method: projects.databases.indexes.create

ينشئ الفهرس المحدد. الحالة الأولية للفهرس الذي تم إنشاؤه حديثًا هي CREATING. عند إكمال عملية إرجاع google.longrunning.Operation، ستكون الولاية هي READY. إذا كان الفهرس متوفّرًا حاليًا، سيعرض الاستدعاء حالة ALREADY_EXISTS.

أثناء الإنشاء، قد تؤدي العملية إلى حدوث خطأ، وفي هذه الحالة سيتم نقل الفهرس إلى حالة ERROR. يمكن استرداد العملية عن طريق إصلاح البيانات التي تسبّبت في حدوث الخطأ، وإزالة الفهرس باستخدام delete، ثم إعادة إنشاء الفهرس باستخدام create.

لا يمكن إنشاء فهارس تتضمّن حقلاً واحدًا.

طلب HTTP

POST https://firestore.googleapis.com/v1beta1/{parent=projects/*/databases/*}/indexes

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
parent

string

اسم قاعدة البيانات التي سيتم تطبيق هذا الفهرس عليها. مثلاً: projects/{projectId}/databases/{databaseId}

نص الطلب

يحتوي نص الطلب على مثيل Index.

نص الاستجابة

في حال نجاح الإجراء، يحتوي نص الاستجابة على مثيل Operation تم إنشاؤه حديثًا.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.