Matomo

List Matomo Instances

GEThttps://api.cegedim.cloud/itcare/analytics/matomo

Query parameters

Response

200400

OK

Body

application/vnd.cegedim-it.v1+json

totalElementsinteger (int64)

totalPagesinteger (int32)

firstboolean

sizeinteger (int32)

contentarray of MatomoV1 (object)

numberinteger (int32)

sortarray of SortObject (object)

pageablePageableObject (object)

numberOfElementsinteger (int32)

lastboolean

emptyboolean

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/analytics/matomo', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "totalElements": 0,
  "totalPages": 0,
  "first": false,
  "size": 0,
  "content": [
    {
      "id": 0,
      "name": "text",
      "type": "text",
      "internalType": "text",
      "status": "text",
      "category": "text",
      "technology": "text",
      "family": "text",
      "label": "text",
      "comment": "text",
      "productCode": "text",
      "productName": "text",
      "productVersion": "text",
      "cloudId": 0,
      "cloudName": "text",
      "serviceId": 0,
      "serviceName": "text",
      "serviceKey": "text",
      "environment": "text",
      "endOfSupportAt": "2025-01-02T14:40:11.343Z",
      "supportPhase": "text",
      "creationUser": "text",
      "creationTime": "text",
      "releasedAt": "2025-01-02T14:40:11.343Z",
      "endOfSalesAt": "2025-01-02T14:40:11.343Z",
      "extendedSupportAt": "2025-01-02T14:40:11.343Z",
      "monitoringEnabled": false,
      "monitoringAlerting": false,
      "monitoringOnCallEnabled": false,
      "monitoringRequested": false,
      "replicationStatus": false,
      "backupStatus": false,
      "patchParty": {
        "excluded": false,
        "exclusionReason": "text",
        "patchGroup": "text",
        "patchDate": "2025-01-02T14:40:11.343Z",
        "patchTag": "text",
        "name": "text",
        "id": 0,
        "excludedBy": "text",
        "exclusionDate": "2025-01-02T14:40:11.343Z"
      },
      "metrologyUrl": "text",
      "path": "text",
      "resourceType": "text",
      "internalResourceId": 0,
      "backupPolicyDetails": {
        "backups": [
          {
            "id": 0,
            "type": "text",
            "backupSize": 0,
            "backupLastDate": "2025-01-02T14:40:11.343Z"
          }
        ],
        "policies": [
          {
            "name": "text",
            "label": "text",
            "scope": "text",
            "type": "text",
            "replication": false,
            "durationInHours": 0,
            "startTime": "text",
            "timezone": "text",
            "policyId": "text",
            "backupLastDate": "2025-01-02T14:40:11.343Z",
            "backupSize": 0
          }
        ]
      },
      "version": "text",
      "url": "text",
      "sizing": "text",
      "availableActions": [
        {
          "operation": "text",
          "available": false,
          "unavailabilityCauses": [
            "text"
          ]
        }
      ],
      "actionsInProgress": [
        {
          "process": "text",
          "status": "SUCCESS,IN_PROGRESS,ERROR",
          "message": "text",
          "id": 0,
          "internalId": 0,
          "resourceName": "text",
          "resourceType": "text",
          "family": "text",
          "lastUpdatedAt": "2025-01-02T14:40:11.343Z"
        }
      ]
    }
  ],
  "number": 0,
  "sort": [
    {
      "direction": "text",
      "nullHandling": "text",
      "ascending": false,
      "property": "text",
      "ignoreCase": false
    }
  ],
  "pageable": {
    "offset": 0,
    "sort": [
      {
        "direction": "text",
        "nullHandling": "text",
        "ascending": false,
        "property": "text",
        "ignoreCase": false
      }
    ],
    "pageSize": 0,
    "pageNumber": 0,
    "paged": false,
    "unpaged": false
  },
  "numberOfElements": 0,
  "last": false,
  "empty": false
}

Create a Matomo instance

This method allows to create a matomo instance.

You will have to know at the minimum :

• where you want to host your instance (region attribute)
• name of instance (name attribute)
• sizing of the instance (sizing attribute). The possible values are : XS (Up to 100K ppm), S(Up to 1M ppm), M(Up to 10M ppm), L(Up to 100M ppm), XL(More than 100M ppm)
• how to connect to the instance (password attribute). The password must be At least one lowercase, one uppercase, one digit, one special character, minimum length must be 12.
• On which service the matomo instance belongs to (serviceId attribute).
• Other settings (defaultWebSiteName, defaultWebUri).

This method is asynchronous (status code 202) and you'll have to wait for async action to be completed by checking its status.

POST /analytics/matomo
{
	"name": "pmatomo01",
	"region": "EB",
	"sizing":"XS",
	"serviceId":"123",
	"password": "Password!!??",
	"defaultWebSiteName": "ITCare",
	"defaultWebUri": "https://itcare.cegedim.cloud"
	
}

POSThttps://api.cegedim.cloud/itcare/analytics/matomo

Body

application/vnd.cegedim-it.v1+json

serviceId*integer (int64)

id of service to put instance in.

regulationstring

Regulation. Refer to the regulation of the Area (HDS|STANDARD). If absent, default 'STANDARD' will be used.

region*string

Region. that is a low-latency network area, available in List Regions method. If absent, default Area of Region will be used.

cloudIdinteger (int64)

monitoringEnabledboolean

Indicates if monitoring will be setup. If absent, it will be automatically be setup if this is an production environment, or if backup is enabled.

noMonitoringProdReasonstring

Indicates why a production resource is not under monitoring.

onCallSupervisionboolean

Indicates if on call teams will be called on non business hours if an incident occurs on instance. If absent, set to false.

monitoringAlertingboolean

Indicates if alerting should be activated. If absent, set to false.

backupEnabledboolean

Indicates if backup has to be setup on instance. If absent, backup will be setup automatically if instance is in a production service.

noBackupProdReasonstring

Indicates why a production resource is not under backup.

replicationEnabledboolean

Indicates if replication will be setup. If absent, it will be automatically be setup if this is an production environment

noReplicationProdReasonstring

Indicates why a production resource is not replicated.

serverBackupPolicyIdstring

BackupPolicy id. Refers to desired backup policy to be applied for the virtual machine, must be set when backup is enabled.

dbBackupPolicyIdstring

BackupPolicy id. Refers to desired backup policy to be applied for the database, must be set when backup is enabled.

sizing*string

Sizing. L, XL , XS, S, M. Sizing for matomo instances

password*string

Password to connect to the matomo instance.

name*string

Name of Matomo Instance

Pattern: [a-z0-9\-]{4,60}$

defaultWebSiteName*string

Default website name to be configured in Matomo, if left empty, a dummy value will be configured

defaultWebUri*string

Default website url to be configured in Matomo, if left empty, a dummy value will be configured

Response

200400

OK

Body

application/vnd.cegedim-it.v1+json

processstring

Code of action performed

statusenum

Status label of action

SUCCESS,IN_PROGRESS,ERROR

messagestring

Human readable message of status

idinteger (int32)

internalIdinteger (int64)

resourceNamestring

resourceTypestring

familystring

lastUpdatedAtstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/analytics/matomo', {
    method: 'POST',
    headers: {
      "Content-Type": "application/vnd.cegedim-it.v1+json"
    },
    body: JSON.stringify({
      "defaultWebSiteName": "text",
      "defaultWebUri": "text",
      "name": "text",
      "password": "text",
      "region": "text",
      "serviceId": 0,
      "sizing": "text"
    }),
});
const data = await response.json();

Response

200

{
  "process": "text",
  "status": "SUCCESS,IN_PROGRESS,ERROR",
  "message": "text",
  "id": 0,
  "internalId": 0,
  "resourceName": "text",
  "resourceType": "text",
  "family": "text",
  "lastUpdatedAt": "2025-01-02T14:40:11.343Z"
}

Get a Matomo Instance

GEThttps://api.cegedim.cloud/itcare/analytics/matomo/{id}

Path parameters

id*integer (int64)

id, example: 123

Response

200400

OK

Body

application/vnd.cegedim-it.v1+json

idinteger (int64)

namestring

typestring

internalTypestring

statusstring

categorystring

technologystring

familystring

labelstring

commentstring

productCodestring

productNamestring

productVersionstring

cloudIdinteger (int64)

cloudNamestring

serviceIdinteger (int64)

serviceNamestring

serviceKeystring

environmentstring

endOfSupportAtstring (date-time)

supportPhasestring

creationUserstring

creationTimestring

releasedAtstring (date-time)

endOfSalesAtstring (date-time)

extendedSupportAtstring (date-time)

monitoringEnabledboolean

monitoringAlertingboolean

monitoringOnCallEnabledboolean

monitoringRequestedboolean

replicationStatusboolean

backupStatusboolean

patchPartyPatchPartyV1 (object)

Representation of a resource patch party

metrologyUrlstring

pathstring

resourceTypestring

internalResourceIdinteger (int64)

backupPolicyDetailsBackupPolicyDetailsV1 (object)

versionstring

urlstring

sizingstring

availableActionsarray of AvailableActionV1 (object)

actionsInProgressarray of ActionInformationV1 (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/analytics/matomo/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "id": 0,
  "name": "text",
  "type": "text",
  "internalType": "text",
  "status": "text",
  "category": "text",
  "technology": "text",
  "family": "text",
  "label": "text",
  "comment": "text",
  "productCode": "text",
  "productName": "text",
  "productVersion": "text",
  "cloudId": 0,
  "cloudName": "text",
  "serviceId": 0,
  "serviceName": "text",
  "serviceKey": "text",
  "environment": "text",
  "endOfSupportAt": "2025-01-02T14:40:11.343Z",
  "supportPhase": "text",
  "creationUser": "text",
  "creationTime": "text",
  "releasedAt": "2025-01-02T14:40:11.343Z",
  "endOfSalesAt": "2025-01-02T14:40:11.343Z",
  "extendedSupportAt": "2025-01-02T14:40:11.343Z",
  "monitoringEnabled": false,
  "monitoringAlerting": false,
  "monitoringOnCallEnabled": false,
  "monitoringRequested": false,
  "replicationStatus": false,
  "backupStatus": false,
  "patchParty": {
    "excluded": false,
    "exclusionReason": "text",
    "patchGroup": "text",
    "patchDate": "2025-01-02T14:40:11.343Z",
    "patchTag": "text",
    "name": "text",
    "id": 0,
    "excludedBy": "text",
    "exclusionDate": "2025-01-02T14:40:11.343Z"
  },
  "metrologyUrl": "text",
  "path": "text",
  "resourceType": "text",
  "internalResourceId": 0,
  "backupPolicyDetails": {
    "backups": [
      {
        "id": 0,
        "type": "text",
        "backupSize": 0,
        "backupLastDate": "2025-01-02T14:40:11.343Z"
      }
    ],
    "policies": [
      {
        "name": "text",
        "label": "text",
        "scope": "text",
        "type": "text",
        "replication": false,
        "durationInHours": 0,
        "startTime": "text",
        "timezone": "text",
        "policyId": "text",
        "backupLastDate": "2025-01-02T14:40:11.343Z",
        "backupSize": 0
      }
    ]
  },
  "version": "text",
  "url": "text",
  "sizing": "text",
  "availableActions": [
    {
      "operation": "text",
      "available": false,
      "unavailabilityCauses": [
        "text"
      ]
    }
  ],
  "actionsInProgress": [
    {
      "process": "text",
      "status": "SUCCESS,IN_PROGRESS,ERROR",
      "message": "text",
      "id": 0,
      "internalId": 0,
      "resourceName": "text",
      "resourceType": "text",
      "family": "text",
      "lastUpdatedAt": "2025-01-02T14:40:11.343Z"
    }
  ]
}

Delete a Matomo instance

This method allows to delete a matomo instance.

This method is asynchronous (status code 202) and you'll have to wait for async action to be completed by checking its status.

DELETE /analytics/matomo/123

DELETEhttps://api.cegedim.cloud/itcare/analytics/matomo/{id}

Path parameters

id*integer (int64)

id, example: 123

Response

200400

OK

Body

application/vnd.cegedim-it.v1+json

processstring

Code of action performed

statusenum

Status label of action

SUCCESS,IN_PROGRESS,ERROR

messagestring

Human readable message of status

idinteger (int32)

internalIdinteger (int64)

resourceNamestring

resourceTypestring

familystring

lastUpdatedAtstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/analytics/matomo/{id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

200

{
  "process": "text",
  "status": "SUCCESS,IN_PROGRESS,ERROR",
  "message": "text",
  "id": 0,
  "internalId": 0,
  "resourceName": "text",
  "resourceType": "text",
  "family": "text",
  "lastUpdatedAt": "2025-01-02T14:40:11.343Z"
}

Update a Matomo instance

This method allows to update a matomo instance.

Structure of payload is generic and describes :

• operation you want to be performed
• options data relative to the operation performed - see details - optional.

Below are different operations currently implemented.

Start matomo instance

Use the start operation to start a matomo instance.

Starts matomo instance.

This method is synchronous (status code 202).

Example :

PATCH /analytics/matomo/1234
{
    "operation": "start"
}

Stop matomo instance

Use the stop operation to stop the nodes of the matomo instance and the instance itself.

This operation cannot be undone afterwards.

This method is synchronous (status code 202).

PATCH /analytics/matomo/1234
{
	"operation":"stop"
}

Extend matomo instance

Use the extend operation to stop the nodes of the matomo instance and the instance itself.

This operation cannot be undone afterwards.

This method is synchronous (status code 202).

PATCH /analytics/matomo/1234
{
	"operation":"extend",
	"options" : {
	  "sizing" : "M"
	}
}

PATCHhttps://api.cegedim.cloud/itcare/analytics/matomo/{id}

Path parameters

id*integer (int64)

id, example: 123

Body

application/jsonapplication/vnd.cegedim-it.v1+json

operationstring

optionsobject

Response

200400

OK

Body

application/vnd.cegedim-it.v1+json

processstring

Code of action performed

statusenum

Status label of action

SUCCESS,IN_PROGRESS,ERROR

messagestring

Human readable message of status

idinteger (int32)

internalIdinteger (int64)

resourceNamestring

resourceTypestring

familystring

lastUpdatedAtstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/analytics/matomo/{id}', {
    method: 'PATCH',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "process": "text",
  "status": "SUCCESS,IN_PROGRESS,ERROR",
  "message": "text",
  "id": 0,
  "internalId": 0,
  "resourceName": "text",
  "resourceType": "text",
  "family": "text",
  "lastUpdatedAt": "2025-01-02T14:40:11.343Z"
}