Endpoint configuration registry REST version v1

{schema}://{host}/api/{version}

  • schema: required(one of http, https - default: http)
  • host: required(string - default: localhost)
  • version: required(v1)
Configurations

Per-endpoint configurations.

put get delete
put

Creates or updates (if exists) endpoint configuration for given endpoint identifier and application version.

get

Returns endpoint configuration details by endpoint identifier and application version.

delete

Deletes endpoint configuration by endpoint identifier and application version.

Creates or updates (if exists) endpoint configuration for given endpoint identifier and application version.

Secured by oauth_2_0 with scopes:
  • endpoint:update

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • endpointId: required(string)

    Identifier of the endpoint to operate on

    Example:

    7d5dda9b-c9f6-427d-91ea-9891a4f62cbb
  • appVersionName: required(string)

    Application version name

    Example:

    smart-kettle-v1

Body

Media type: application/json

Type: any

Example:

{
  "active": true,
  "pushInterval": 5
}

HTTP status code 200

Configuration is successfully upserted.

Headers

  • ETag: required(string)

    Entity tag of the returned configuration.

    Example:

    "33a64df551425fcc55e4d42a148795d9f25f89d4"

Body

Media type: application/json

Type: object

Properties
  • configId: required(string)

    Configuration ID

  • config: required(string)

    Configuration payload

  • createdDate: required(datetime)

    Time of configuration creation

  • updatedDate: required(datetime)

    Time of last configuration udpate

Example:

{
  "configId": "231f1aae-a4be-11ea-bb37-0242ac130002",
  "config": "{\"active\": true,\"pushInterval\": 5}",
  "createdDate": "2017-03-17T11:30:02.643Z",
  "updatedDate": "2017-03-17T11:30:02.643Z"
}

HTTP status code 400

Invalid request. E.g. missed required parameters or malformed JSON.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

HTTP status code 404

Endpoint configuration schema not found but expected. The requirement to the schema existence is configured in the application configuration.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

HTTP status code 422

Endpoint configuration is unprocessable entity for config schema.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

HTTP status code 503

Service is configured with invalid endpoint configuration schema.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Returns endpoint configuration details by endpoint identifier and application version.

Secured by oauth_2_0 with scopes:
  • endpoint:read

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • endpointId: required(string)

    Identifier of the endpoint to operate on

    Example:

    7d5dda9b-c9f6-427d-91ea-9891a4f62cbb
  • appVersionName: required(string)

    Application version name

    Example:

    smart-kettle-v1

Headers

  • If-None-Match: (string)

    Configuration identifier of the last configuration known to the caller. If the current configuration identifier matches one specified in If-None-Match header, no operation is performed and 304 Not modified status code is returned.

    Example:

    "33a64df551425fcc55e4d42a148795d9f25f89d4"

HTTP status code 200

Endpoint configuration is successfully retrieved.

Headers

  • ETag: required(string)

    Identifier of the returned configuration.

    Example:

    "33a64df551425fcc55e4d42a148795d9f25f89d4"

Body

Media type: application/json

Type: object

Properties
  • configId: required(string)

    Configuration ID

  • config: required(string)

    Configuration payload

  • createdDate: required(datetime)

    Time of configuration creation

  • updatedDate: required(datetime)

    Time of last configuration udpate

Example:

{
  "configId": "231f1aae-a4be-11ea-bb37-0242ac130002",
  "config": "{\"active\": true,\"pushInterval\": 5}",
  "createdDate": "2017-03-17T11:30:02.643Z",
  "updatedDate": "2017-03-17T11:30:02.643Z"
}

HTTP status code 304

Not modified.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Deletes endpoint configuration by endpoint identifier and application version.

Secured by oauth_2_0 with scopes:
  • endpoint:delete

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • endpointId: required(string)

    Identifier of the endpoint to operate on

    Example:

    7d5dda9b-c9f6-427d-91ea-9891a4f62cbb
  • appVersionName: required(string)

    Application version name

    Example:

    smart-kettle-v1

HTTP status code 204

Endpoint configuration was successfully deleted.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

put
put

Creates or updates (if exists) configuration for given endpoints in scope of specified application versions.

put
put

Creates or updates (if exists) configuration for endpoints that match specified filter.

Creates or updates (if exists) configuration for endpoints that match specified filter.

Secured by oauth_2_0 with scopes:
  • endpoint:update

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • filterId: required(string)

    Endpoint filter ID

    Example:

    79c717d9-eedd-4f71-b9f8-86caf7e309e4

Body

Media type: application/json

Type: any

Example:

{
  "active": true,
  "pushInterval": 5
}

HTTP status code 200

Configurations is successfully upserted.

HTTP status code 400

Invalid request. E.g. missed required parameters or malformed JSON.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

HTTP status code 404

Endpoint configuration schema not found but expected. The requirement to the schema existence is configured in the application configuration.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

HTTP status code 422

Endpoint configuration is unprocessable entity for config schema.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

HTTP status code 503

Service is configured with invalid endpoint configuration schema.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Default configurations

Default endpoint configuration for an application version.

put get delete
put

Upserts current default configuration for a given application version.

get

Returns current default configuration.

delete

Deletes default configuration by application version.

Upserts current default configuration for a given application version.

Secured by oauth_2_0 with scopes:
  • application:endpoint-config:update

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appVersionName: required(string)

    Application version name.

    Example:

    smart-kettle-v1

Headers

  • If-Match: (string)

    ETag of the last configuration known to the caller. If the current ETag does not match one specified in If-Match header, no operation is performed and 412 Precondition failed status code is returned.

    Example:

    "3334623"

Body

Media type: application/json

Type: any

Example:

{
  "active": true,
  "pushInterval": 5
}

HTTP status code 200

Default configuration is successfully upserted.

Headers

  • ETag: required(string)

    Entity tag of the returned configuration.

    Example:

    "33a64df551425fcc55e4d42a148795d9f25f89d4"

Body

Media type: application/json

Type: object

Properties
  • configId: required(string)

    Configuration ID

  • config: required(string)

    Configuration payload

  • createdDate: required(datetime)

    Time of configuration creation

  • updatedDate: required(datetime)

    Time of last configuration udpate

Example:

{
  "configId": "231f1aae-a4be-11ea-bb37-0242ac130002",
  "config": "{\"active\": true,\"pushInterval\": 5}",
  "createdDate": "2017-03-17T11:30:02.643Z",
  "updatedDate": "2017-03-17T11:30:02.643Z"
}

HTTP status code 400

Invalid request. E.g. missed required parameters or malformed JSON.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

HTTP status code 404

Endpoint configuration schema not found but expected. The requirement to the schema existence is configured in the application configuration.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

HTTP status code 412

Precondition failed. Operation was not performed due to optimistic locking failure.

HTTP status code 422

Endpoint configuration is unprocessable entity for config schema.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

HTTP status code 503

Service is configured with invalid endpoint configuration schema.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Returns current default configuration.

Secured by oauth_2_0 with scopes:
  • application:endpoint-config:read

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appVersionName: required(string)

    Application version name.

    Example:

    smart-kettle-v1

Headers

  • If-None-Match: (string)

    Configuration identifier of the last configuration known to the caller. If the current configuration identifier matches one specified in If-None-Match header, no operation is performed and 304 Not modified status code is returned.

    Example:

    "33a64df551425fcc55e4d42a148795d9f25f89d4"

HTTP status code 200

Default configuration is successfully retrieved.

Headers

  • ETag: required(string)

    Entity tag of the returned configuration.

    Example:

    "33a64df551425fcc55e4d42a148795d9f25f89d4"

Body

Media type: application/json

Type: object

Properties
  • configId: required(string)

    Configuration ID

  • config: required(string)

    Configuration payload

  • createdDate: required(datetime)

    Time of configuration creation

  • updatedDate: required(datetime)

    Time of last configuration udpate

Example:

{
  "configId": "231f1aae-a4be-11ea-bb37-0242ac130002",
  "config": "{\"active\": true,\"pushInterval\": 5}",
  "createdDate": "2017-03-17T11:30:02.643Z",
  "updatedDate": "2017-03-17T11:30:02.643Z"
}

HTTP status code 304

Not modified.

HTTP status code 404

Application version not found or user does not have permissions to perform this operation.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Deletes default configuration by application version.

Secured by oauth_2_0 with scopes:
  • endpoint:delete

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appVersionName: required(string)

    Application version name.

    Example:

    smart-kettle-v1

HTTP status code 204

Default configuration was successfully deleted.

HTTP status code 404

Application version not found or user does not have permissions to perform this operation.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Configuration schemas

Per-version configuration schema.

get
get

Returns endpoint configuration schema by application version.

Returns endpoint configuration schema by application version.

Secured by oauth_2_0 with scopes:
  • application:read

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appVersionName: required(string)

    Application version name.

    Example:

    smart_kettle_v1

HTTP status code 200

Returns current endpoint configuration schema (if exist) for the application version.

Body

Media type: application/json

Type: object

Example:

{
  "$id": "https://example.com/test.schema.json",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Test",
  "type": "object",
  "properties": {
    "testProp": {
      "description": "Description of property",
      "type": "integer",
      "minimum": 0
    }
  }
}

HTTP status code 404

Endpoint configuration schema not found.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

HTTP status code 503

Service is configured with invalid endpoint configuration schema.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

put

Per-version configuration schema validation.

put

Validates endpoint configuration schema by application version name.

Validates endpoint configuration schema by application version name.

Secured by oauth_2_0 with scopes:
  • application:read

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appVersionName: required(string)

    Application version name.

    Example:

    smart_kettle_v1

Body

Media type: application/json

Type: any

Example:

{
  "active": true,
  "pushInterval": 5
}

HTTP status code 200

Configuration passed validation successfully or schema is not expected and is missing.

HTTP status code 400

Invalid request. E.g. missed required parameters or malformed JSON.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

HTTP status code 404

Endpoint configuration schema not found but expected. The requirement to the schema existence is configured in the application configuration.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

HTTP status code 422

Endpoint configuration is unprocessable entity for config schema.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

HTTP status code 503

Service is configured with invalid endpoint configuration schema.

Body

Media type: application/json

Type: traits.ecr-api-types.ClientErrorResponse

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Configuration statuses

Configuration statuses history.

get
get
System configuration

Operations on system configuration

post get
post

Creates a new item.

get

Retrieves list.

Creates a new item.

Secured by oauth_2_0 with scopes:
  • tenant:update

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • tenantId: required(string)

    Tenant ID.

Body

Media type: application/json

Type: object

Properties
  • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

    Name.

  • displayName: (string)

    Display name.

  • config: required(string)

    Config.

Example:

{
  "name": "alert-email-recipients",
  "displayName": "Alert email recipients",
  "config": "{\"emails\": [\"alert-monitor@acme.com\"]}"
}

HTTP status code 201

Item is successfully created.

Headers

  • Location: required(string)

    URI in format `{schema}://{host}/ecr/api/v1/system/tenants/{tenantId}/configs/{configId}

    Example:

    https://cloud.kaaiot.com/ecr/api/v1/system/tenants/c2df5743-8e18-40e9-a163-08ee93a3b0d4/configs/3dd9b3a1-05be-461a-8531-4891254191a6
  • ETag: required(string)

    Entity tag used for conditional updates.

HTTP status code 401

Request is not authenticated.

HTTP status code 403

Principal does not have sufficient permissions to perform this operation.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Retrieves list.

Secured by oauth_2_0 with scopes:
  • tenant:read

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • tenantId: required(string)

    Tenant ID.

Query Parameters

  • page: (number - default: 0)

    Page number.

    Example:

    0
  • size: (number - default: 100)

    Page size.

    Example:

    10
  • sort: (one of createdAt, updatedAt - default: createdAt)

    Field to sort by.

    Example:

    updatedAt
  • sortOrder: (one of asc, desc - default: desc)

    Sort direction.

    Example:

    asc
  • name: (string)

    Config name. Supports partial match.

    Example:

    alert-email-recipients

HTTP status code 200

List is successfully retrieved.

Body

Media type: application/json

Type: object

Properties
  • totalElements: required(integer)

    Total number of elements available for retrieval.

  • content: required(array of system-config-type.ItemResponse)

    Items: ItemResponse

    • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

      Name.

    • displayName: (string)

      Display name.

    • config: required(string)

      Config.

    • configId: required(string)

      Config ID.

    • createdAt: required(datetime)

      Timestamp in ISO 8601 format (UTC timezone) showing when the record was created.

      Example:

      2023-06-30T12:30:54.540Z
    • updatedAt: required(datetime)

      Timestamp in ISO 8601 format (UTC timezone) showing when the record was last updated.

      Example:

      2023-06-30T12:30:54.540Z

Example:

{
  "content": [
    {
      "configId": "89449e85-7721-4437-8f25-23a99fe45a1c",
      "name": "alert-email-recipients",
      "displayName": "Alert email recipients",
      "config": "{\"emails\": [\"alert-monitor@acme.com\"]}",
      "createdAt": "2024-02-02T01:23:29.841Z",
      "updatedAt": "2024-02-02T01:23:29.841Z"
    }
  ],
  "totalElements": 1
}

HTTP status code 401

Request is not authenticated.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

get
get

Retrieves current active config by its name.

Retrieves current active config by its name.

Secured by oauth_2_0 with scopes:
  • tenant:read

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • tenantId: required(string)

    Tenant ID.

Query Parameters

  • name: (string)

    Config name. Supports partial match.

    Example:

    alert-email-recipients

HTTP status code 200

Item is successfully retrieved.

Body

Media type: application/json

Type: object

Properties
  • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

    Name.

  • displayName: (string)

    Display name.

  • config: required(string)

    Config.

  • configId: required(string)

    Config ID.

  • createdAt: required(datetime)

    Timestamp in ISO 8601 format (UTC timezone) showing when the record was created.

    Example:

    2023-06-30T12:30:54.540Z
  • updatedAt: required(datetime)

    Timestamp in ISO 8601 format (UTC timezone) showing when the record was last updated.

    Example:

    2023-06-30T12:30:54.540Z

Example:

{
  "configId": "89449e85-7721-4437-8f25-23a99fe45a1c",
  "name": "alert-email-recipients",
  "displayName": "Alert email recipients",
  "config": "{\"emails\": [\"alert-monitor@acme.com\"]}",
  "createdAt": "2024-02-02T01:23:29.841Z",
  "updatedAt": "2024-02-02T01:23:29.841Z"
}

HTTP status code 401

Request is not authenticated.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

get put delete
get

Retrieves item.

put

Updates item.

delete

Deletes.

Retrieves item.

Secured by oauth_2_0 with scopes:
  • tenant:read

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • tenantId: required(string)

    Tenant ID.

  • configId: required(string)

    Config ID.

HTTP status code 200

Item is successfully retrieved.

Headers

  • ETag: required(string)

    Entity tag used for conditional updates.

Body

Media type: application/json

Type: object

Properties
  • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

    Name.

  • displayName: (string)

    Display name.

  • config: required(string)

    Config.

  • configId: required(string)

    Config ID.

  • createdAt: required(datetime)

    Timestamp in ISO 8601 format (UTC timezone) showing when the record was created.

    Example:

    2023-06-30T12:30:54.540Z
  • updatedAt: required(datetime)

    Timestamp in ISO 8601 format (UTC timezone) showing when the record was last updated.

    Example:

    2023-06-30T12:30:54.540Z

Example:

{
  "configId": "89449e85-7721-4437-8f25-23a99fe45a1c",
  "name": "alert-email-recipients",
  "displayName": "Alert email recipients",
  "config": "{\"emails\": [\"alert-monitor@acme.com\"]}",
  "createdAt": "2024-02-02T01:23:29.841Z",
  "updatedAt": "2024-02-02T01:23:29.841Z"
}

HTTP status code 401

Request is not authenticated.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Updates item.

Secured by oauth_2_0 with scopes:
  • tenant:update

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • tenantId: required(string)

    Tenant ID.

  • configId: required(string)

    Config ID.

Headers

  • If-Match: (string)

    ETag of the last configuration known to the caller. If the current ETag does not match one specified in If-Match header, no operation is performed and 412 Precondition failed status code is returned.

    Example:

    "3334623"

Body

Media type: application/json

Type: object

Properties
  • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

    Name.

  • displayName: (string)

    Display name.

  • config: required(string)

    Config.

Example:

{
  "name": "alert-email-recipients",
  "displayName": "Alert email recipients",
  "config": "{\"emails\": [\"alert-monitor@acme.com\"]}"
}

HTTP status code 401

Request is not authenticated.

HTTP status code 412

Precondition failed. Operation was not performed due to optimistic locking failure.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Deletes.

Secured by oauth_2_0 with scopes:
  • tenant:update

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • tenantId: required(string)

    Tenant ID.

  • configId: required(string)

    Config ID.

HTTP status code 204

Item is successfully deleted.

HTTP status code 401

Request is not authenticated.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

post get
post

Creates a new item.

get

Retrieves list.

Creates a new item.

Secured by oauth_2_0 with scopes:
  • application:update

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appName: required(string)

    Application name.

Body

Media type: application/json

Type: object

Properties
  • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

    Name.

  • displayName: (string)

    Display name.

  • config: required(string)

    Config.

Example:

{
  "name": "alert-email-recipients",
  "displayName": "Alert email recipients",
  "config": "{\"emails\": [\"alert-monitor@acme.com\"]}"
}

HTTP status code 201

Item is successfully created.

Headers

  • Location: required(string)

    URI in format `{schema}://{host}/ecr/api/v1/system/applications/{appName}/configs/{configId}

    Example:

    https://cloud.kaaiot.com/ecr/api/v1/system/applications/clecugjml4es73b02jjg/configs/3dd9b3a1-05be-461a-8531-4891254191a6
  • ETag: required(string)

    Entity tag used for conditional updates.

HTTP status code 401

Request is not authenticated.

HTTP status code 403

Principal does not have sufficient permissions to perform this operation.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Retrieves list.

Secured by oauth_2_0 with scopes:
  • application:read

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appName: required(string)

    Application name.

Query Parameters

  • page: (number - default: 0)

    Page number.

    Example:

    0
  • size: (number - default: 100)

    Page size.

    Example:

    10
  • sort: (one of createdAt, updatedAt - default: createdAt)

    Field to sort by.

    Example:

    updatedAt
  • sortOrder: (one of asc, desc - default: desc)

    Sort direction.

    Example:

    asc
  • name: (string)

    Config name. Supports partial match.

    Example:

    alert-email-recipients

HTTP status code 200

List is successfully retrieved.

Body

Media type: application/json

Type: object

Properties
  • totalElements: required(integer)

    Total number of elements available for retrieval.

  • content: required(array of system-config-type.ItemResponse)

    Items: ItemResponse

    • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

      Name.

    • displayName: (string)

      Display name.

    • config: required(string)

      Config.

    • configId: required(string)

      Config ID.

    • createdAt: required(datetime)

      Timestamp in ISO 8601 format (UTC timezone) showing when the record was created.

      Example:

      2023-06-30T12:30:54.540Z
    • updatedAt: required(datetime)

      Timestamp in ISO 8601 format (UTC timezone) showing when the record was last updated.

      Example:

      2023-06-30T12:30:54.540Z

Example:

{
  "content": [
    {
      "configId": "89449e85-7721-4437-8f25-23a99fe45a1c",
      "name": "alert-email-recipients",
      "displayName": "Alert email recipients",
      "config": "{\"emails\": [\"alert-monitor@acme.com\"]}",
      "createdAt": "2024-02-02T01:23:29.841Z",
      "updatedAt": "2024-02-02T01:23:29.841Z"
    }
  ],
  "totalElements": 1
}

HTTP status code 401

Request is not authenticated.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

get
get

Retrieves current active config by its name.

Retrieves current active config by its name.

Secured by oauth_2_0 with scopes:
  • application:read

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appName: required(string)

    Application name.

Query Parameters

  • name: (string)

    Config name. Supports partial match.

    Example:

    alert-email-recipients

HTTP status code 200

Item is successfully retrieved.

Body

Media type: application/json

Type: object

Properties
  • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

    Name.

  • displayName: (string)

    Display name.

  • config: required(string)

    Config.

  • configId: required(string)

    Config ID.

  • createdAt: required(datetime)

    Timestamp in ISO 8601 format (UTC timezone) showing when the record was created.

    Example:

    2023-06-30T12:30:54.540Z
  • updatedAt: required(datetime)

    Timestamp in ISO 8601 format (UTC timezone) showing when the record was last updated.

    Example:

    2023-06-30T12:30:54.540Z

Example:

{
  "configId": "89449e85-7721-4437-8f25-23a99fe45a1c",
  "name": "alert-email-recipients",
  "displayName": "Alert email recipients",
  "config": "{\"emails\": [\"alert-monitor@acme.com\"]}",
  "createdAt": "2024-02-02T01:23:29.841Z",
  "updatedAt": "2024-02-02T01:23:29.841Z"
}

HTTP status code 401

Request is not authenticated.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

get put delete
get

Retrieves item.

put

Updates item.

delete

Deletes.

Retrieves item.

Secured by oauth_2_0 with scopes:
  • application:read

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appName: required(string)

    Application name.

  • configId: required(string)

    Config ID.

HTTP status code 200

Item is successfully retrieved.

Headers

  • ETag: required(string)

    Entity tag used for conditional updates.

Body

Media type: application/json

Type: object

Properties
  • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

    Name.

  • displayName: (string)

    Display name.

  • config: required(string)

    Config.

  • configId: required(string)

    Config ID.

  • createdAt: required(datetime)

    Timestamp in ISO 8601 format (UTC timezone) showing when the record was created.

    Example:

    2023-06-30T12:30:54.540Z
  • updatedAt: required(datetime)

    Timestamp in ISO 8601 format (UTC timezone) showing when the record was last updated.

    Example:

    2023-06-30T12:30:54.540Z

Example:

{
  "configId": "89449e85-7721-4437-8f25-23a99fe45a1c",
  "name": "alert-email-recipients",
  "displayName": "Alert email recipients",
  "config": "{\"emails\": [\"alert-monitor@acme.com\"]}",
  "createdAt": "2024-02-02T01:23:29.841Z",
  "updatedAt": "2024-02-02T01:23:29.841Z"
}

HTTP status code 401

Request is not authenticated.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Updates item.

Secured by oauth_2_0 with scopes:
  • application:update

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appName: required(string)

    Application name.

  • configId: required(string)

    Config ID.

Headers

  • If-Match: (string)

    ETag of the last configuration known to the caller. If the current ETag does not match one specified in If-Match header, no operation is performed and 412 Precondition failed status code is returned.

    Example:

    "3334623"

Body

Media type: application/json

Type: object

Properties
  • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

    Name.

  • displayName: (string)

    Display name.

  • config: required(string)

    Config.

Example:

{
  "name": "alert-email-recipients",
  "displayName": "Alert email recipients",
  "config": "{\"emails\": [\"alert-monitor@acme.com\"]}"
}

HTTP status code 204

Item is successfully updated.

HTTP status code 401

Request is not authenticated.

HTTP status code 412

Precondition failed. Operation was not performed due to optimistic locking failure.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Deletes.

Secured by oauth_2_0 with scopes:
  • application:update

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appName: required(string)

    Application name.

  • configId: required(string)

    Config ID.

HTTP status code 204

Item is successfully deleted.

HTTP status code 401

Request is not authenticated.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

post get
post

Creates a new item.

get

Retrieves list.

Creates a new item.

Secured by oauth_2_0 with scopes:
  • application:update

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appVersionName: required(string)

    Application version name.

Body

Media type: application/json

Type: object

Properties
  • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

    Name.

  • displayName: (string)

    Display name.

  • config: required(string)

    Config.

Example:

{
  "name": "alert-email-recipients",
  "displayName": "Alert email recipients",
  "config": "{\"emails\": [\"alert-monitor@acme.com\"]}"
}

HTTP status code 201

Item is successfully created.

Headers

  • Location: required(string)

    URI in format `{schema}://{host}/ecr/api/v1/system/app-versions/{appVersionName}/configs/{configId}

    Example:

    https://cloud.kaaiot.com/ecr/api/v1/system/app-versions/clecugjml4es73b02jjg-v1/configs/3dd9b3a1-05be-461a-8531-4891254191a6
  • ETag: required(string)

    Entity tag used for conditional updates.

HTTP status code 401

Request is not authenticated.

HTTP status code 403

Principal does not have sufficient permissions to perform this operation.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Retrieves list.

Secured by oauth_2_0 with scopes:
  • application:read

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appVersionName: required(string)

    Application version name.

Query Parameters

  • page: (number - default: 0)

    Page number.

    Example:

    0
  • size: (number - default: 100)

    Page size.

    Example:

    10
  • sort: (one of createdAt, updatedAt - default: createdAt)

    Field to sort by.

    Example:

    updatedAt
  • sortOrder: (one of asc, desc - default: desc)

    Sort direction.

    Example:

    asc
  • name: (string)

    Config name. Supports partial match.

    Example:

    alert-email-recipients

HTTP status code 200

List is successfully retrieved.

Body

Media type: application/json

Type: object

Properties
  • totalElements: required(integer)

    Total number of elements available for retrieval.

  • content: required(array of system-config-type.ItemResponse)

    Items: ItemResponse

    • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

      Name.

    • displayName: (string)

      Display name.

    • config: required(string)

      Config.

    • configId: required(string)

      Config ID.

    • createdAt: required(datetime)

      Timestamp in ISO 8601 format (UTC timezone) showing when the record was created.

      Example:

      2023-06-30T12:30:54.540Z
    • updatedAt: required(datetime)

      Timestamp in ISO 8601 format (UTC timezone) showing when the record was last updated.

      Example:

      2023-06-30T12:30:54.540Z

Example:

{
  "content": [
    {
      "configId": "89449e85-7721-4437-8f25-23a99fe45a1c",
      "name": "alert-email-recipients",
      "displayName": "Alert email recipients",
      "config": "{\"emails\": [\"alert-monitor@acme.com\"]}",
      "createdAt": "2024-02-02T01:23:29.841Z",
      "updatedAt": "2024-02-02T01:23:29.841Z"
    }
  ],
  "totalElements": 1
}

HTTP status code 401

Request is not authenticated.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

get
get

Retrieves current active config by its name.

Retrieves current active config by its name.

Secured by oauth_2_0 with scopes:
  • application:read

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appVersionName: required(string)

    Application version name.

Query Parameters

  • name: (string)

    Config name. Supports partial match.

    Example:

    alert-email-recipients

HTTP status code 200

Item is successfully retrieved.

Body

Media type: application/json

Type: object

Properties
  • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

    Name.

  • displayName: (string)

    Display name.

  • config: required(string)

    Config.

  • configId: required(string)

    Config ID.

  • createdAt: required(datetime)

    Timestamp in ISO 8601 format (UTC timezone) showing when the record was created.

    Example:

    2023-06-30T12:30:54.540Z
  • updatedAt: required(datetime)

    Timestamp in ISO 8601 format (UTC timezone) showing when the record was last updated.

    Example:

    2023-06-30T12:30:54.540Z

Example:

{
  "configId": "89449e85-7721-4437-8f25-23a99fe45a1c",
  "name": "alert-email-recipients",
  "displayName": "Alert email recipients",
  "config": "{\"emails\": [\"alert-monitor@acme.com\"]}",
  "createdAt": "2024-02-02T01:23:29.841Z",
  "updatedAt": "2024-02-02T01:23:29.841Z"
}

HTTP status code 401

Request is not authenticated.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

get put delete
get

Retrieves item.

put

Updates item.

delete

Deletes.

Retrieves item.

Secured by oauth_2_0 with scopes:
  • application:read

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appVersionName: required(string)

    Application version name.

  • configId: required(string)

    Config ID.

HTTP status code 200

Item is successfully retrieved.

Headers

  • ETag: required(string)

    Entity tag used for conditional updates.

Body

Media type: application/json

Type: object

Properties
  • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

    Name.

  • displayName: (string)

    Display name.

  • config: required(string)

    Config.

  • configId: required(string)

    Config ID.

  • createdAt: required(datetime)

    Timestamp in ISO 8601 format (UTC timezone) showing when the record was created.

    Example:

    2023-06-30T12:30:54.540Z
  • updatedAt: required(datetime)

    Timestamp in ISO 8601 format (UTC timezone) showing when the record was last updated.

    Example:

    2023-06-30T12:30:54.540Z

Example:

{
  "configId": "89449e85-7721-4437-8f25-23a99fe45a1c",
  "name": "alert-email-recipients",
  "displayName": "Alert email recipients",
  "config": "{\"emails\": [\"alert-monitor@acme.com\"]}",
  "createdAt": "2024-02-02T01:23:29.841Z",
  "updatedAt": "2024-02-02T01:23:29.841Z"
}

HTTP status code 401

Request is not authenticated.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Updates item.

Secured by oauth_2_0 with scopes:
  • application:update

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appVersionName: required(string)

    Application version name.

  • configId: required(string)

    Config ID.

Headers

  • If-Match: (string)

    ETag of the last configuration known to the caller. If the current ETag does not match one specified in If-Match header, no operation is performed and 412 Precondition failed status code is returned.

    Example:

    "3334623"

Body

Media type: application/json

Type: object

Properties
  • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

    Name.

  • displayName: (string)

    Display name.

  • config: required(string)

    Config.

Example:

{
  "name": "alert-email-recipients",
  "displayName": "Alert email recipients",
  "config": "{\"emails\": [\"alert-monitor@acme.com\"]}"
}

HTTP status code 204

Item is successfully updated.

HTTP status code 401

Request is not authenticated.

HTTP status code 412

Precondition failed. Operation was not performed due to optimistic locking failure.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Deletes.

Secured by oauth_2_0 with scopes:
  • application:update

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • appVersionName: required(string)

    Application version name.

  • configId: required(string)

    Config ID.

HTTP status code 204

Item is successfully deleted.

HTTP status code 401

Request is not authenticated.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

post get
post

Creates a new item.

get

Retrieves list.

Creates a new item.

Secured by oauth_2_0 with scopes:
  • endpoint:update

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • endpointId: required(string)

    Endpoint ID.

Body

Media type: application/json

Type: object

Properties
  • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

    Name.

  • displayName: (string)

    Display name.

  • config: required(string)

    Config.

Example:

{
  "name": "alert-email-recipients",
  "displayName": "Alert email recipients",
  "config": "{\"emails\": [\"alert-monitor@acme.com\"]}"
}

HTTP status code 201

Item is successfully created.

Headers

  • Location: required(string)

    URI in format `{schema}://{host}/ecr/api/v1/system/endpoints/{endpointId}/configs/{configId}

    Example:

    https://cloud.kaaiot.com/ecr/api/v1/system/endpoints/01473a21-222c-4957-aba5-70511c986e75/configs/3dd9b3a1-05be-461a-8531-4891254191a6
  • ETag: required(string)

    Entity tag used for conditional updates.

HTTP status code 401

Request is not authenticated.

HTTP status code 403

Principal does not have sufficient permissions to perform this operation.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Retrieves list.

Secured by oauth_2_0 with scopes:
  • endpoint:read

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • endpointId: required(string)

    Endpoint ID.

Query Parameters

  • page: (number - default: 0)

    Page number.

    Example:

    0
  • size: (number - default: 100)

    Page size.

    Example:

    10
  • sort: (one of createdAt, updatedAt - default: createdAt)

    Field to sort by.

    Example:

    updatedAt
  • sortOrder: (one of asc, desc - default: desc)

    Sort direction.

    Example:

    asc
  • name: (string)

    Config name. Supports partial match.

    Example:

    alert-email-recipients

HTTP status code 200

List is successfully retrieved.

Body

Media type: application/json

Type: object

Properties
  • totalElements: required(integer)

    Total number of elements available for retrieval.

  • content: required(array of system-config-type.ItemResponse)

    Items: ItemResponse

    • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

      Name.

    • displayName: (string)

      Display name.

    • config: required(string)

      Config.

    • configId: required(string)

      Config ID.

    • createdAt: required(datetime)

      Timestamp in ISO 8601 format (UTC timezone) showing when the record was created.

      Example:

      2023-06-30T12:30:54.540Z
    • updatedAt: required(datetime)

      Timestamp in ISO 8601 format (UTC timezone) showing when the record was last updated.

      Example:

      2023-06-30T12:30:54.540Z

Example:

{
  "content": [
    {
      "configId": "89449e85-7721-4437-8f25-23a99fe45a1c",
      "name": "alert-email-recipients",
      "displayName": "Alert email recipients",
      "config": "{\"emails\": [\"alert-monitor@acme.com\"]}",
      "createdAt": "2024-02-02T01:23:29.841Z",
      "updatedAt": "2024-02-02T01:23:29.841Z"
    }
  ],
  "totalElements": 1
}

HTTP status code 401

Request is not authenticated.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

get
get

Retrieves current active config by its name.

Retrieves current active config by its name.

Secured by oauth_2_0 with scopes:
  • endpoint:read

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • endpointId: required(string)

    Endpoint ID.

Query Parameters

  • name: (string)

    Config name. Supports partial match.

    Example:

    alert-email-recipients

HTTP status code 200

Item is successfully retrieved.

Body

Media type: application/json

Type: object

Properties
  • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

    Name.

  • displayName: (string)

    Display name.

  • config: required(string)

    Config.

  • configId: required(string)

    Config ID.

  • createdAt: required(datetime)

    Timestamp in ISO 8601 format (UTC timezone) showing when the record was created.

    Example:

    2023-06-30T12:30:54.540Z
  • updatedAt: required(datetime)

    Timestamp in ISO 8601 format (UTC timezone) showing when the record was last updated.

    Example:

    2023-06-30T12:30:54.540Z

Example:

{
  "configId": "89449e85-7721-4437-8f25-23a99fe45a1c",
  "name": "alert-email-recipients",
  "displayName": "Alert email recipients",
  "config": "{\"emails\": [\"alert-monitor@acme.com\"]}",
  "createdAt": "2024-02-02T01:23:29.841Z",
  "updatedAt": "2024-02-02T01:23:29.841Z"
}

HTTP status code 401

Request is not authenticated.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

get put delete
get

Retrieves item.

put

Updates item.

delete

Deletes.

Retrieves item.

Secured by oauth_2_0 with scopes:
  • endpoint:read

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • endpointId: required(string)

    Endpoint ID.

  • configId: required(string)

    Config ID.

HTTP status code 200

Item is successfully retrieved.

Headers

  • ETag: required(string)

    Entity tag used for conditional updates.

Body

Media type: application/json

Type: object

Properties
  • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

    Name.

  • displayName: (string)

    Display name.

  • config: required(string)

    Config.

  • configId: required(string)

    Config ID.

  • createdAt: required(datetime)

    Timestamp in ISO 8601 format (UTC timezone) showing when the record was created.

    Example:

    2023-06-30T12:30:54.540Z
  • updatedAt: required(datetime)

    Timestamp in ISO 8601 format (UTC timezone) showing when the record was last updated.

    Example:

    2023-06-30T12:30:54.540Z

Example:

{
  "configId": "89449e85-7721-4437-8f25-23a99fe45a1c",
  "name": "alert-email-recipients",
  "displayName": "Alert email recipients",
  "config": "{\"emails\": [\"alert-monitor@acme.com\"]}",
  "createdAt": "2024-02-02T01:23:29.841Z",
  "updatedAt": "2024-02-02T01:23:29.841Z"
}

HTTP status code 401

Request is not authenticated.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Updates item.

Secured by oauth_2_0 with scopes:
  • endpoint:update

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • endpointId: required(string)

    Endpoint ID.

  • configId: required(string)

    Config ID.

Headers

  • If-Match: (string)

    ETag of the last configuration known to the caller. If the current ETag does not match one specified in If-Match header, no operation is performed and 412 Precondition failed status code is returned.

    Example:

    "3334623"

Body

Media type: application/json

Type: object

Properties
  • name: required(string - pattern: ^[a-zA-Z0-9@._-]{3,100}+$)

    Name.

  • displayName: (string)

    Display name.

  • config: required(string)

    Config.

Example:

{
  "name": "alert-email-recipients",
  "displayName": "Alert email recipients",
  "config": "{\"emails\": [\"alert-monitor@acme.com\"]}"
}

HTTP status code 204

Item is successfully updated.

HTTP status code 401

Request is not authenticated.

HTTP status code 412

Precondition failed. Operation was not performed due to optimistic locking failure.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.

Deletes.

Secured by oauth_2_0 with scopes:
  • endpoint:update

ECR supports OAuth 2.0 for authenticating all API requests.

URI Parameters

  • endpointId: required(string)

    Endpoint ID.

  • configId: required(string)

    Config ID.

HTTP status code 204

Item is successfully deleted.

HTTP status code 401

Request is not authenticated.

Secured by oauth_2_0

Headers

  • Authorization: (string)

    Used to send a valid OAuth 2 access token. Example: "Authorization: Bearer 'access_token'" where 'access_token' must be replaced by a valid OAuth access token. This header is needed only if API authentication is enabled for the service.