GRgravitee-io
Data Planes

Get a data plane

Changed on

Retrieves a single Automation-managed data plane by its id.

get/organizations/{orgId}/environments/{envId}/dataplanes/{dataPlaneId}

Request

  • Base URL
    http://localhost:8093/automation
  • URL
    http://localhost:8093/automation/organizations/{orgId}/environments/{envId}/dataplanes/{dataPlaneId}
  • Auth
    HTTP bearer

Path parameters

orgIdstring required

Identifier of the organization that owns the environment.

envIdstring required

Identifier of the environment the resource belongs to.

dataPlaneIdstring required

Id of the data plane within the environment.

Response

The data plane

configurationobject

Connection settings. Write-only: it can hold credentials.

createdAtstring date-time

Creation timestamp (ISO-8601 / RFC 3339, UTC). Read-only.

databasestring

Name of the database the configuration points at. Read-only.

environmentIdstring

Identifier of the environment the data plane belongs to. Read-only.

gatewayUrlstring

Base URL of the gateway serving the domains bound to this data plane. Must be an absolute http(s) URL with a lowercase scheme; omitted or empty leaves it unset.

hostsstring[]

Hosts the configuration points at, as host:port. Read-only.

idstring required

Stable, immutable identifier for the data plane within its environment. Lowercase alphanumeric and hyphens, starting and ending with an alphanumeric character. This is the value a domain's dataPlaneId refers to.

namestring

Human-readable name of the data plane.

organizationIdstring

Identifier of the organization the data plane belongs to. Read-only.

typestring

Data plane plugin type identifier, matching the dataplane-am-<type> plugin. Immutable after creation.

updatedAtstring date-time

Last-update timestamp (ISO-8601 / RFC 3339, UTC). Read-only.

Example response

{
  "configuration": {
    "mongodb": {
      "dbname": "gravitee-am-acme",
      "host": "mongo",
      "port": 27017
    }
  },
  "database": "gravitee-am-acme",
  "environmentId": "DEFAULT",
  "gatewayUrl": "https://gateway-eu.example.com",
  "hosts": [
    "mongo:27017"
  ],
  "id": "acme-eu",
  "name": "ACME EU data plane",
  "organizationId": "DEFAULT",
  "type": "mongodb"
}

Changes