Get Flexible Sync information

GET /groups/{groupId}/apps/{appId}/service/{serviceId}/config

Retrieve sync data for a specific Atlas App Services App when using Flexible Sync.

Path parameters

Responses

  • 200 application/json

    Successfully retrieved.

    Hide response attributes Show response attributes object
    • clusterId string

      The Service ID for the linked cluster.

    • clusterName string

      The name of the linked cluster

    • clusterType string

      The service type of the linked cluster ("atlas" by default)

      Values are atlas or serverless.

    • flexible_sync object
      Hide flexible_sync attributes Show flexible_sync attributes object
      • state string Required

        The state of the sync service ("enabled", "disabled", or empty if Sync is not configured).

      • database_name string

        The name of a database in the synced cluster where App Services stores data in Development Mode. App Services automatically generates a schema for each synced type and maps each object type to a collection within the database.

      • queryable_fields_names array[string]

        An array of queryable field names on any collection.

      • indexed_queryable_fields_names array[string]

        A list of field names to use as the indexed queryable field. Although this property is an array, Sync currently supports only one indexed queryable field. Therefore, this array may contain at most one element.

        The indexed queryable field must be present in the schema and be the same eligible field type in every collection you sync. The indexed queryable field name must also appear in queryable_fields_names since this is a global queryable field.

      • collection_queryable_fields_names object

        An array of queryable field names on the specified collection.

        Hide collection_queryable_fields_names attribute Show collection_queryable_fields_names attribute object
        • * object Additional properties
          Hide * attribute Show * attribute object
          • * string Additional properties

            The name of the queryable field.

      • permissions object

        Deprecated

      • last_disabled string

        The last time Sync was disabled, represented by the number of seconds since the UNIX epoch.

      • client_max_offline_days integer

        The number of days the client can be offline before a client reset is required.

      • is_recovery_mode_disabled boolean

        Specifies whether the client reset mode is disabled. By default, client reset mode is enabled and this value is false.

      • asymmetric_tables array[string]

        An array of the names of collections that are defined as asymmetric with Data Ingest, where clients can write data but not read.

    • groupName string

      The name of the App's Atlas Project.

    • orgName string

      The name of the App's Atlas Organization.

    • readPreference string

      Values are primary, primaryPreferred, secondary, secondaryPreferred, or nearest.

    • wireProtocolEnabled boolean
GET /groups/{groupId}/apps/{appId}/service/{serviceId}/config
curl \
 --request GET 'https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/service/{serviceId}/config' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "clusterId": "string",
  "clusterName": "string",
  "clusterType": "atlas",
  "flexible_sync": {
    "state": "string",
    "database_name": "string",
    "queryable_fields_names": [
      "string"
    ],
    "indexed_queryable_fields_names": [
      "string"
    ],
    "collection_queryable_fields_names": {
      "additionalProperty1": {
        "additionalProperty1": "string",
        "additionalProperty2": "string"
      },
      "additionalProperty2": {
        "additionalProperty1": "string",
        "additionalProperty2": "string"
      }
    },
    "permissions": {},
    "last_disabled": "string",
    "client_max_offline_days": 42,
    "is_recovery_mode_disabled": true,
    "asymmetric_tables": [
      "string"
    ]
  },
  "groupName": "string",
  "orgName": "string",
  "readPreference": "primary",
  "wireProtocolEnabled": true
}