List Cluster ActiveGates

Published Jun 14, 2022

Lists all available ActiveGates.

Authentication

To execute this request, you need the Service Provider API (ServiceProviderAPI) permission assigned to your API token. Generate your API token via Cluster Management Console (CMC). To learn how to obtain and use it, see Cluster API - Authentication.

Endpoint

/api/cluster/v2/activeGates

ActiveGate ID conversion

The ID returned for the Cluster ActiveGate v2 endpoint is a hexadecimal representation of the node ID. If you want to use the ID in other endpoints that require the entity ID—for example, v1 endpoints with /api/v1.0/onpremise/sslCertificate—you need to convert it to the decimal representation of the entity ID.

Parameters

Parameter	Type	Description	In	Required
hostname	string	Filters the resulting set of ActiveGates by the name of the host it's running on. You can specify a partial name. In that case, the `CONTAINS` operator is used.	query	Optional
osType	string	Filters the resulting set of ActiveGates by the OS type of the host it's running on. The element can hold these values `LINUX` `WINDOWS`	query	Optional
osArchitecture	string	Filters the resulting set of ActiveGates by the OS architecture of the host it's running on. The element can hold these values `X86` `S390` `ARM` `PPCLE`	query	Optional
networkAddress	string	Filters the resulting set of ActiveGates by the network address. You can specify a partial address. In that case, the `CONTAINS` operator is used.	query	Optional
loadBalancerAddress	string	Filters the resulting set of ActiveGates by the Load Balancer address. You can specify a partial address. In that case, the `CONTAINS` operator is used.	query	Optional
type	string	Filters the resulting set of ActiveGates by the ActiveGate type. The element can hold these values `ENVIRONMENT` `ENVIRONMENT_MULTI` `CLUSTER`	query	Optional
networkZone	string	Filters the resulting set of ActiveGates by the network zone. You can specify a partial name. In that case, the `CONTAINS` operator is used.	query	Optional
updateStatus	string	Filters the resulting set of ActiveGates by the auto-update status. The element can hold these values `INCOMPATIBLE` `OUTDATED` `SCHEDULED` `SUPPRESSED` `UNKNOWN` `UP2DATE` `UPDATE_IN_PROGRESS` `UPDATE_PENDING` `UPDATE_PROBLEM`	query	Optional
versionCompareType	string	Filters the resulting set of ActiveGates by the specified version. Specify the comparison operator here. The element can hold these values `EQUAL` `GREATER` `GREATER_EQUAL` `LOWER` `LOWER_EQUAL`	query	Optional
version	string	Filters the resulting set of ActiveGates by the specified version. Specify the version in `<major>.<minor>.<revision>` format (for example, `1.195.0`) here.	query	Optional
autoUpdate	string	Filters the resulting set of ActiveGates by the actual state of auto-update. The element can hold these values `DISABLED` `ENABLED`	query	Optional
group	string	Filters the resulting set of ActiveGates by the group. You can specify a partial name. In that case, the `CONTAINS` operator is used.	query	Optional
online	boolean	Filters the resulting set of ActiveGates by the communication status.	query	Optional
enabledModule	string[]	Filters the resulting set of ActiveGates by the enabled modules. The element can hold these values `AWS` `AZURE` `BEACON_FORWARDER` `CLOUD_FOUNDRY` `DB_INSIGHT` `DEBUGGING` `EXTENSIONS_V1` `EXTENSIONS_V2` `KUBERNETES` `LOGS` `MEMORY_DUMPS` `METRIC_API` `ONE_AGENT_ROUTING` `OTLP_INGEST` `REST_API` `SYNTHETIC` `VMWARE` `Z_OS`	query	Optional
disabledModule	string[]	Filters the resulting set of ActiveGates by the disabled modules. The element can hold these values `AWS` `AZURE` `BEACON_FORWARDER` `CLOUD_FOUNDRY` `DB_INSIGHT` `DEBUGGING` `EXTENSIONS_V1` `EXTENSIONS_V2` `KUBERNETES` `LOGS` `MEMORY_DUMPS` `METRIC_API` `ONE_AGENT_ROUTING` `OTLP_INGEST` `REST_API` `SYNTHETIC` `VMWARE` `Z_OS`	query	Optional
containerized	boolean	Filters the resulting set of ActiveGates to those which are running in container (`true`) or not (`false`).	query	Optional
tokenState	string	Filters the resulting set of ActiveGates to those with authorization token in specified state. The element can hold these values `ABSENT` `EXPIRING` `INVALID` `UNKNOWN` `UNSUPPORTED` `VALID`	query	Optional
tokenExpirationSet	boolean	Filters the resulting set of ActiveGates to those with set expiration date for authorization token.	query	Optional
fipsMode	boolean	Filters the resulting set of ActiveGates to those which are running in FIPS mode (`true`) or not (`false`).	query	Optional

Response

Response codes

Code	Type	Description
200	ActiveGateList	Success
400	ErrorEnvelope	Failed. The input is invalid.

Response body objects

The `ActiveGateList` object

A list of ActiveGates.

Element	Type	Description
activeGates	ActiveGate[]	A list of ActiveGates.

The `ActiveGate` object

Parameters of the ActiveGate.

Element	Type	Description
activeGateTokens	ActiveGateTokenInfoDto[]	A list of the ActiveGate tokens.
autoUpdateSettings	ActiveGateAutoUpdateConfig	Configuration of the ActiveGate auto-updates.
autoUpdateStatus	string	The current status of auto-updates of the ActiveGate. The element can hold these values `INCOMPATIBLE` `OUTDATED` `SCHEDULED` `SUPPRESSED` `UNKNOWN` `UP2DATE` `UPDATE_IN_PROGRESS` `UPDATE_PENDING` `UPDATE_PROBLEM`
connectedHosts	ActiveGateConnectedHosts	Information about hosts currently connected to the ActiveGate
containerized	boolean	ActiveGate is deployed in container (`true`) or not (`false`).
environments	string[]	A list of environments (specified by IDs) the ActiveGate can connect to.
fipsMode	boolean	ActiveGate is running in FIPS compliant mode (`true`) or not (`false`).
group	string	The group of the ActiveGate.
hostname	string	The name of the host the ActiveGate is running on.
id	string	The ID of the ActiveGate.
loadBalancerAddresses	string[]	A list of Load Balancer addresses of the ActiveGate.
mainEnvironment	string	The ID of the main environment for a multi-environment ActiveGate.
modules	ActiveGateModule[]	A list of modules of the ActiveGate.
networkAddresses	string[]	A list of network addresses of the ActiveGate.
networkZone	string	The network zone of the ActiveGate.
offlineSince	integer	The timestamp since when the ActiveGate is offline. The `null` value means the ActiveGate is online.
osArchitecture	string	The OS architecture that the ActiveGate is running on. The element can hold these values `S390` `X86` `ARM` `PPCLE`
osBitness	string	The OS bitness that the ActiveGate is running on. The element can hold these values `64`
osType	string	The OS type that the ActiveGate is running on. The element can hold these values `LINUX` `WINDOWS`
type	string	The type of the ActiveGate. The element can hold these values `CLUSTER` `ENVIRONMENT` `ENVIRONMENT_MULTI`
version	string	The current version of the ActiveGate in the `<major>.<minor>.<revision>.<timestamp>` format.

The `ActiveGateTokenInfoDto` object

Information about ActiveGate token.

Element Type Description

environmentId

string

Element	Type	Description
environmentId	string	The environment ID to which the token belongs. Only available if more than one environment is supported.
id	string	The ActiveGate token identifier, consisting of prefix and public part of the token.
state	string	State of the ActiveGate token. The element can hold these values `ABSENT` `EXPIRING` `INVALID` `UNKNOWN` `UNSUPPORTED` `VALID`

The environment ID to which the token belongs.

Only available if more than one environment is supported.

string

The ActiveGate token identifier, consisting of prefix and public part of the token.

state

string

State of the ActiveGate token.

The element can hold these values

ABSENT
EXPIRING
INVALID
UNKNOWN
UNSUPPORTED
VALID

The `ActiveGateAutoUpdateConfig` object

Configuration of the ActiveGate auto-updates.

Element Type Description

effectiveSetting

string

Element	Type	Description
effectiveSetting	string	The actual state of the ActiveGate auto-update. Applicable only if the setting parameter is set to `INHERITED`. In that case, the value is taken from the parent setting. Otherwise, it's just a duplicate of the setting value. The element can hold these values `ENABLED` `DISABLED`
setting	string	The state of the ActiveGate auto-update: enabled, disabled, or inherited. If set to `INHERITED`, the setting is inherited from the global configuration set on the environment or Managed cluster level. The element can hold these values `DISABLED` `ENABLED` `INHERITED`

The actual state of the ActiveGate auto-update.

Applicable only if the setting parameter is set to INHERITED. In that case, the value is taken from the parent setting. Otherwise, it's just a duplicate of the setting value.

The element can hold these values

ENABLED
DISABLED

setting

string

The state of the ActiveGate auto-update: enabled, disabled, or inherited.

If set to INHERITED, the setting is inherited from the global configuration set on the environment or Managed cluster level.

The element can hold these values

DISABLED
ENABLED
INHERITED

The `ActiveGateConnectedHosts` object

Information about hosts currently connected to the ActiveGate

Element	Type	Description
number	integer	The number of hosts currently connected to the ActiveGate

The `ActiveGateModule` object

Information about ActiveGate module

Element	Type	Description
attributes	object	The attributes of the ActiveGate module.
enabled	boolean	The module is enabled (`true`) or disabled (`false`).
misconfigured	boolean	The module is misconfigured (`true`) or not (`false`).
type	string	The type of ActiveGate module. The element can hold these values `AWS` `AZURE` `BEACON_FORWARDER` `CLOUD_FOUNDRY` `DB_INSIGHT` `DEBUGGING` `EXTENSIONS_V1` `EXTENSIONS_V2` `KUBERNETES` `LOGS` `MEMORY_DUMPS` `METRIC_API` `ONE_AGENT_ROUTING` `OTLP_INGEST` `REST_API` `SYNTHETIC` `VMWARE` `Z_OS`
version	string	The version of the ActiveGate module.

The `ErrorEnvelope` object

Element	Type	Description
error	Error	-

The `Error` object

Element	Type	Description
code	integer	The HTTP status code
constraintViolations	ConstraintViolation[]	A list of constraint violations
message	string	The error message

The `ConstraintViolation` object

A list of constraint violations

Element	Type	Description
location	string	-
message	string	-
parameterLocation	string	- The element can hold these values `HEADER` `PATH` `PAYLOAD_BODY` `QUERY`
path	string	-

Response body JSON models

{
  "activeGates": [
    {
      "activeGateTokens": [
        {
          "environmentId": "string",
          "id": "dt0g02.4KWZO5EF",
          "state": "ABSENT"
        }
      ],
      "autoUpdateSettings": {
        "effectiveSetting": "ENABLED",
        "setting": "INHERITED"
      },
      "autoUpdateStatus": "OUTDATED",
      "connectedHosts": {
        "number": 150
      },
      "containerized": true,
      "environments": [
        "string"
      ],
      "fipsMode": true,
      "group": "default",
      "hostname": "exampleHostname",
      "id": "0x3efdd091",
      "loadBalancerAddresses": [
        "string"
      ],
      "mainEnvironment": "d1bf4a7e-666b-43af-9f45-718g98372e2f",
      "modules": [
        {
          "attributes": {},
          "enabled": true,
          "misconfigured": true,
          "type": "KUBERNETES",
          "version": "string"
        }
      ],
      "networkAddresses": [
        "string"
      ],
      "networkZone": "exampleNetworkZone",
      "offlineSince": 1582031917814,
      "osArchitecture": "X86",
      "osBitness": "64",
      "osType": "WINDOWS",
      "type": "ENVIRONMENT",
      "version": "1.185.0.20200201-120000"
    }
  ]
}

{
  "error": {
    "code": 1,
    "constraintViolations": [
      {
        "location": "string",
        "message": "string",
        "parameterLocation": "HEADER",
        "path": "string"
      }
    ],
    "message": "string"
  }
}

Example

In this example, the request lists all available ActiveGates.

The API token is passed in the Authorization header.

Curl

curl -X GET "https://latest.managed-dev.dynalabs.io/api/cluster/v2/activeGates?versionCompareType=EQUAL" -H "accept: application/json; charset=utf-8" -H "Authorization: Api-Token dt0c01.123245ABC6XYZ12345ABCEFG.ABCDEFGHIFONYABCWKIHM6HDNWP4QK2EOABC6EDEF6HIJ3C33CUBTABC64ABC"

Request URL

https://myManaged.cluster.com/api/cluster/v2/activeGates?versionCompareType=EQUAL

Response body

{
  "activeGates": [
    {
      "id": "0x12f7f345",
      "networkAddresses": [
        "10.0.2.15"
      ],
      "loadBalancerAddresses": [],
      "osType": "LINUX",
      "osArchitecture": "X86",
      "osBitness": "64",
      "autoUpdateStatus": "OUTDATED",
      "offlineSince": 1656926608637,
      "version": "1.242.0.20220506-012008",
      "type": "ENVIRONMENT",
      "hostname": "10.0.3.14",
      "mainEnvironment": null,
      "environments": [],
      "autoUpdateSettings": {
        "setting": "INHERITED",
        "effectiveSetting": "DISABLED"
      },
      "networkZone": "aistitenantzone",
      "group": "default",
      "modules": [],
      "containerized": false,
      "connectedHosts": {
        "number": 0
      },
      "activeGateTokens": []
    },
    {
      "id": "0xe12f4b4e",
      "networkAddresses": [
        "abc.efg-hij.org",
        "172.18.149.164"
      ],
      "loadBalancerAddresses": [
        "172.18.149.164"
      ],
      "osType": "LINUX",
      "osArchitecture": "X86",
      "osBitness": "64",
      "autoUpdateStatus": "UP2DATE",
      "offlineSince": null,
      "version": "1.247.0.20220707-181710",
      "type": "CLUSTER",
      "hostname": "abc.efg-hij.org",
      "mainEnvironment": null,
      "environments": [],
      "autoUpdateSettings": {
        "setting": "ENABLED",
        "effectiveSetting": "ENABLED"
      },
      "networkZone": "ab-cde-xyz",
      "group": "default",
      "modules": [
        {
          "type": "AWS",
          "enabled": true,
          "attributes": {},
          "version": null,
          "misconfigured": false
        },
        {
          "type": "ONE_AGENT_ROUTING",
          "enabled": true,
          "attributes": {},
          "version": null,
          "misconfigured": false
        },
        {
          "type": "Z_OS",
          "enabled": false,
          "attributes": {},
          "version": null,
          "misconfigured": false
        },
        {
          "type": "KUBERNETES",
          "enabled": true,
          "attributes": {},
          "version": null,
          "misconfigured": false
        },
        {
          "type": "METRIC_API",
          "enabled": true,
          "attributes": {},
          "version": null,
          "misconfigured": false
        },
        {
          "type": "EXTENSIONS_V1",
          "enabled": false,
          "attributes": {},
          "version": null,
          "misconfigured": false
        },
        {
          "type": "VMWARE",
          "enabled": true,
          "attributes": {},
          "version": null,
          "misconfigured": false
        },
        {
          "type": "CLOUD_FOUNDRY",
          "enabled": true,
          "attributes": {},
          "version": null,
          "misconfigured": false
        },
        {
          "type": "SYNTHETIC",
          "enabled": false,
          "attributes": {
            "SYNTHETIC_BROWSER_MONITOR": "false",
            "SYNTHETIC_HTTP_MONITOR": "false"
          },
          "version": null,
          "misconfigured": false
        },
        {
          "type": "DB_INSIGHT",
          "enabled": true,
          "attributes": {},
          "version": null,
          "misconfigured": false
        },
        {
          "type": "REST_API",
          "enabled": true,
          "attributes": {},
          "version": null,
          "misconfigured": false
        },
        {
          "type": "OTLP_INGEST",
          "enabled": true,
          "attributes": {},
          "version": null,
          "misconfigured": false
        },
        {
          "type": "MEMORY_DUMPS",
          "enabled": false,
          "attributes": {},
          "version": null,
          "misconfigured": false
        },
        {
          "type": "AZURE",
          "enabled": true,
          "attributes": {},
          "version": null,
          "misconfigured": false
        },
        {
          "type": "LOGS",
          "enabled": true,
          "attributes": {},
          "version": null,
          "misconfigured": false
        },
        {
          "type": "EXTENSIONS_V2",
          "enabled": false,
          "attributes": {},
          "version": null,
          "misconfigured": false
        },
        {
          "type": "BEACON_FORWARDER",
          "enabled": true,
          "attributes": {},
          "version": null,
          "misconfigured": false
        }
      ],
      "containerized": false,
      "connectedHosts": {
        "number": 3
      },
      "activeGateTokens": [
        {
          "state": "VALID",
          "id": "dt0g02.ABC2FTDE",
          "environmentId": null
             }
      ]
    }
  ]
}

Response code

200

List Cluster ActiveGates

Authentication

Endpoint

Parameters

Response

Response codes

Response body objects

The ActiveGateList object

The ActiveGate object

The ActiveGateTokenInfoDto object

The ActiveGateAutoUpdateConfig object

The ActiveGateConnectedHosts object

The ActiveGateModule object

The ErrorEnvelope object

The Error object

The ConstraintViolation object

Response body JSON models

Example

Curl

Request URL

Response body

Response code

The `ActiveGateList` object

The `ActiveGate` object

The `ActiveGateTokenInfoDto` object

The `ActiveGateAutoUpdateConfig` object

The `ActiveGateConnectedHosts` object

The `ActiveGateModule` object

The `ErrorEnvelope` object

The `Error` object

The `ConstraintViolation` object