REST Resource: projects.databases.collectionGroups.indexes
Stay organized with collections
Save and categorize content based on your preferences.
Resource: Index
Cloud Firestore indexes enable simple and complex queries against documents in a database.
JSON representation |
{
"name": string,
"queryScope": enum (QueryScope ),
"fields": [
{
object (IndexField )
}
],
"state": enum (State )
} |
Fields |
name |
string
Output only. A server defined name for this index. The form of this name for composite indexes will be: projects/{projectId}/databases/{databaseId}/collectionGroups/{collectionId}/indexes/{composite_index_id} For single field indexes, this field will be empty.
|
queryScope |
enum (QueryScope )
Indexes with a collection query scope specified allow queries against a collection that is the child of a specific document, specified at query time, and that has the same collection id. Indexes with a collection group query scope specified allow queries against all collections descended from a specific document, specified at query time, and that have the same collection id as this index.
|
fields[] |
object (IndexField )
The fields supported by this index. For composite indexes, this is always 2 or more fields. The last field entry is always for the field path __name__ . If, on creation, __name__ was not specified as the last field, it will be added automatically with the same direction as that of the last field defined. If the final field in a composite index is not directional, the __name__ will be ordered ASCENDING (unless explicitly specified). For single field indexes, this will always be exactly one entry with a field path equal to the field path of the associated field.
|
state |
enum (State )
Output only. The serving state of the index.
|
Methods |
|
Creates a composite index. |
|
Deletes a composite index. |
|
Gets a composite index. |
|
Lists composite indexes. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-06-20 UTC.
[null,null,["Last updated 2025-06-20 UTC."],[],[],null,["# REST Resource: projects.databases.collectionGroups.indexes\n\nResource: Index\n---------------\n\nCloud Firestore indexes enable simple and complex queries against documents in a database.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"queryScope\": enum (`QueryScope`), \"fields\": [ { object (`IndexField`) } ], \"state\": enum (`State`) } ``` |\n\n| Fields ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. A server defined name for this index. The form of this name for composite indexes will be: `projects/{projectId}/databases/{databaseId}/collectionGroups/{collectionId}/indexes/{composite_index_id}` For single field indexes, this field will be empty. |\n| `queryScope` | `enum (``QueryScope``)` Indexes with a collection query scope specified allow queries against a collection that is the child of a specific document, specified at query time, and that has the same collection id. Indexes with a collection group query scope specified allow queries against all collections descended from a specific document, specified at query time, and that have the same collection id as this index. |\n| `fields[]` | `object (``IndexField``)` The fields supported by this index. For composite indexes, this is always 2 or more fields. The last field entry is always for the field path `__name__`. If, on creation, `__name__` was not specified as the last field, it will be added automatically with the same direction as that of the last field defined. If the final field in a composite index is not directional, the `__name__` will be ordered ASCENDING (unless explicitly specified). For single field indexes, this will always be exactly one entry with a field path equal to the field path of the associated field. |\n| `state` | `enum (``State``)` Output only. The serving state of the index. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------------------------|----------------------------|\n| ### [create](/docs/firestore/reference/rest/v1beta2/projects.databases.collectionGroups.indexes/create) | Creates a composite index. |\n| ### [delete](/docs/firestore/reference/rest/v1beta2/projects.databases.collectionGroups.indexes/delete) | Deletes a composite index. |\n| ### [get](/docs/firestore/reference/rest/v1beta2/projects.databases.collectionGroups.indexes/get) | Gets a composite index. |\n| ### [list](/docs/firestore/reference/rest/v1beta2/projects.databases.collectionGroups.indexes/list) | Lists composite indexes. |"]]