Dostępne metody API

Ten artykuł zawiera przegląd metod REST API usługi Xopero ONE Management Service, przeznaczonych do obsługi funkcji i operacji związanych z Git.

Autoryzacja

Metoda logowania (POST)

Metoda ta służy do logowania się do usługi Xopero ONE Management Service.

Wygenerowany token dostępu accessToken musi być dołączany do nagłówka autoryzacji we wszystkich kolejnych zapytaniach API.

Endpoint:

POST https://<server_address>/account/login

Parametry metody:

Parameter	Description	Type
email	Nazwa użytkownika Xopero ONE (adres e-mail).	string
password	Hasło do konta Xopero ONE.	string
rememberMe	Określa, czy sesja ma zostać zapamiętana (wartość logiczna).	bool

Przykład JSON:

{
    "email":"[email protected]",
   "password":"admin123",
    "rememberMe":true
}

Response:

{
 "userId":"a4ac78431-30c2-4d65-bd3e-eb6416784c",     "accessToken":"yMDA1LzA1L2lka4acXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6ImZiODZiNDMxLTMwYzItNGQ2NS1iZDNlLWViNjQxzL25hbWUiOiJhjm1lbG9uQHhvcGVyby5jb20iLCJodHRwOhjvc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2a4aclbWFpbGFkZHJlc3MiOiJtLm1lbG9uQHhvcGVyby5jb20iLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOlsiU3l50IiwiVXNlck1hbmFnZW1lbnQiXSwiZXhwIjoxNjU0NjkwNhj4LCJpc3MiOiJodHRa4acxob3N0OjUwMDAiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0OjUwMDAifQ.eHVRw1KqYi3SOqN-AJUXoEIFKxGVokhoMp910L1LkzA"
}

---

GitOrganizationController

Metoda GetMany (POST)

Pobiera listę organizacji Git powiązanych z kontem.

Autoryzacja jest wymagana.

Endpoint:

POST https://<server_address>/git/organizations/getmany

Parametry metody:

Parameter	Description	Type
limit	Liczba wyników zwracanych na jednej stronie.	int
orderby	Nazwa pola, według którego wyniki mają być sortowane.	string
ordertype	Kierunek sortowania (np. rosnąco).	string
page	Numer strony wyników.	int
filters	Tablica filtrów danych.	array [filters]

Przykład JSON:

{
    "limit": 2,
    "orderby": "Name",
    "ordertype": "asc",
    "Page": 2
}

Response:

{
    "currentPage": 2,
    "pageCount": 2,
    "totalEntries": 4,
    "result": [
        {
            "id": "a4ac2cd0-ed2f-4ced-be39-60c631e033ff",
            "driver": 1,
            "name": "OrgName",
            "apiUrl": null,
            "isReadOnly": false,
            "protectedRepositories": 43,
            "totalRepositories": 58,
            "missingLicences": 58,
            "removedRepositories": 15,
            "defaultWorkerId": "a4ac11eb-bbe7-406e-b3da-24fb4df5642a",
            "isCreatedByMarketplace": false,
            "synchronizationInProgress": false,
            "plans": [
                {
                    "id": "a4acff69-266e-4771-b47b-fd5e4fae6a40",
                    "name": "name1",
                    "backupType": 5,
                    "includeMetadata": true,
                    "repoCount": 1,
                    "lastStatus": {
                        "successes": 0,
                        "warnings": 0,
                        "errors": 1
                    },
                    "planFinishedTime": 1643754961233,
                    "isRunning": false
                },
                {
                    "id": "a4ac8dd-6bf4-4c6c-8bc3-7305a9cc4dad",
                    "name": "name2",
                    "backupType": 5,
                    "includeMetadata": true,
                    "repoCount": 1,
                    "lastStatus": {
                        "successes": 0,
                        "warnings": 0,
                        "errors": 1
                    },
                    "planFinishedTime": 1643754482141,
                    "isRunning": false
                },
                {
                    "id": "a4ac8001-1d3f-45ae-bb7a-49e86286ad6b",
                    "name": "name3",
                    "backupType": 5,
                    "includeMetadata": true,
                    "repoCount": 1,
                    "lastStatus": {
                        "successes": 0,
                        "warnings": 0,
                        "errors": 1
                    },
                    "planFinishedTime": 1643754482453,
                    "isRunning": false
                }
            ]
        },
        {
            "id": "a4ac6bff8-0000-0000-0000-000000000000",
            "driver": 2,
            "name": "xopero",
            "apiUrl": null,
            "isReadOnly": false,
            "protectedRepositories": 1,
            "totalRepositories": 775,
            "missingLicences": 676,
            "removedRepositories": 0,
            "defaultWorkerId": "a4ac0f30-6641-a4ac7-ac26-fd7e47abf8f3",
            "isCreatedByMarketplace": false,
            "synchronizationInProgress": false,
            "plans": [
                {
                    "id": "3a4ac5-fdd1-4a4ac1-9415-66d0fbedb0e0",
                    "name": "name1",
                    "backupType": 5,
                    "includeMetadata": true,
                    "repoCount": 1,
                    "lastStatus": {
                        "successes": 1,
                        "warnings": 0,
                        "errors": 0
                    },
                    "planFinishedTime": 1645136722019,
                    "isRunning": false
                },
                {
                    "id": "a4aca5252-2d02-a4ac-8a24-e2be4598c8ce",
                    "name": "name2",
                    "backupType": 5,
                    "includeMetadata": true,
                    "repoCount": 1,
                    "lastStatus": {
                        "successes": 0,
                        "warnings": 1,
                        "errors": 0
                    },
                    "planFinishedTime": 1645115366992,
                    "isRunning": false
                },
                {
                    "id": "a4acb8c-7b2a-a4ac83-8167-44a9a1e14272",
                    "name": "name3",
                    "backupType": 5,
                    "includeMetadata": true,
                    "repoCount": 1,
                    "lastStatus": {
                        "successes": 0,
                        "warnings": 1,
                        "errors": 0
                    },
                    "planFinishedTime": 1645115380587,
                    "isRunning": false
                }
            ]
        }
    ]
}

---

Plans controller

Metoda AttachGitRepository (POST)

Przypisuje repozytorium Git do istniejącego planu backupu. Warunkiem jest istnienie zarówno planu, jak i repozytorium w systemie.

Autoryzacja jest wymagana.

Endpoint:

POST https://<server_address>/plans/attachgitrepository

Parametry metody:

Parameter	Description	Type
planid	Identyfikator planu*.	guid
repositoryid	Identyfikator repozytorium Git.	guid

* GetMany .

Przykład JSON:

{
    "planid":"hjkhkj60b-baac-4564-a92d-918e6940b136",
    "repositoryid":"ca4ac8f1c-a425-4869-8757-32c6567gc9aeb"
}

Response:

200 OK

Metoda DetachGitRepository (POST)

Odłącza wybrane repozytorium Git od planu backupu.

Autoryzacja jest wymagana.

Endpoint:

POST https://<server_address>/plans/detachgitrepository

Parametry metody:

Parameter	Description	Type
planid	Identyfikator planu*.	guid
repositoryid	Identyfikator repozytorium Git.	guid

* GetMany .

Przykład JSON:

{
    "planid":"hjkhkj60b-baac-4564-a92d-918e6940b136",
    "repositoryid":"a4ac8f1c-a425-48hj-8757-32hj567gchjeb"
}

Response:

200 OK

Metoda ListAssignedToOrganization (POST)

Zwraca listę planów backupu, do których przypisane są repozytoria należące do konkretnej organizacji.

Autoryzacja jest wymagana.

Endpoint:

POST https://<server_address>/plans/listassignedtoorganization

Parametry metody:

Parameter	Description	Type
limit	Określa maksymalną liczbę wyników zwróconych w pojedynczej API response.	int
page	Numer strony.	int
organizationid	Identyfikator repozytorium Git.	guid

Przykład JSON:

{
    "limit":5,
    "page":5,
    "organizationid":"a4a4acgd0-eg78f-4a4ac-kl39-99ka4ac1e777ff"
}

Response:

{
    "currentPage": 5,
    "pageCount": 5,
    "totalEntries": 23,
    "result": [
        {
            "id": "ea6a260b-a4ac-4204-a92d-918e6940b136",
            "name": "example1",
            "includeAllRepositories": false,
            "repositoryIds": [
                "c1961c1c-a425-a4ac-8757-32d5b6fc9aeb"
            ]
        },
        {
            "id": "fba158dd-6bf4-a4ac-8bc3-7305a9cc4dad",
            "name": "example2",
            "includeAllRepositories": false,
            "repositoryIds": [
                "de5c5995-b422-43c4-90b7-7ee182480dbb"
            ]
        },
        {
            "id": "fdb48001-1d3f-45ae-bb7a-49e86286ad6b",
            "name": "example3",
            "includeAllRepositories": false,
            "repositoryIds": [
                "a4ac5995-b422-43c4-a4ac-7ee182480dbb"
            ]
        }
     ]
}

Metoda ModifyGitPlan (POST)

Umożliwia edycję ustawień istniejącego planu backupu Git. Pozwala na zmianę harmonogramu, retencji, kompresji czy szyfrowania.

Autoryzacja jest wymagana.

Endpoint:

POST https://<server_address>/plans/modifygitplan

Parametry metody:

Parameter	Description	Type
id	Identyfikator planu*.	guid
name	Nazwa planu.	string
isActive	Wskazuje na to czy plan jest aktualnie aktywny (true) lub nieaktywny (false).	bool
type	Określa typ planu backupu.	EPlanType
backupType	Typ backupu (jeśli typ planu to backup).	EPlanType
storageId	Identyfikator magazynu.	guid
repositoriesIds	Tablica identyfikatorów repozytoriów Git.	array [guid]
workerId	Unikalny identyfikator urządzenia wykonującego operację.	guid
schedule	Harmonogram backupu.	BackupScheduleDTO
advancedOptions	Opcje zaawansowane.	dictionary [string, string]
compressionSettings	Ustawienia kompresji.	CompressionSettingsEntry
encryptionSettings	Ustawienia szyfrowania.	EncryptionSettingsEntry
customActions	Akcje zdefiniowane przez użytkownika.	BackupCustomActionsEntry
inculdeAllReposistories	Jeśli jest ustawione jako true, plan ignoruje wybrane repozytoria i uwzględnia wszystkie repozytoria w organizacji.	bool
organizationId	Identyfikator organizacji Git.	guid
includeMetadata	Jeśli jest ustawione jako true, backup zawiera tylko metadane.	bool

* GetMany .

Przykład JSON

{
   "id":"a4acc15-b08b-40cb-a4ac-5e40ea4ac54",
   "isActive":true,
   "name":"example",
   "backupType":5,
   "schedule":{
      "id":"a4ac21-6da6-4c8c-a4ac5-f2ffca4ac516",
      "scheme":3,
      "delay":0,
      "preventSystemSleep":false,
      "options":[
         {
            "type":1,
            "trigger":1,
            "frequency":1,
            "days":[
               1
            ],
            "startAt":[
               {
                  "hour":17,
                  "minute":25
               }
            ],
            "interval":0,
            "nthDayOfWeek":0
         },
         {
            "type":3,
            "trigger":1,
            "frequency":3,
            "days":[
               1,
               2,
               3,
               4,
               5
            ],
            "startAt":[
               {
                  "hour":17,
                  "minute":25
               }
            ],
            "interval":0,
            "nthDayOfWeek":0
         }
      ],
      "backupWindow":
      [     
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]
      ],
      "retention":{
         "id":"00000000-0000-0000-0000-000000000000",
         "rule":1,
         "options":null,
         "order":0
      }
   },
   "compressionSettings":{
      "codec":2,
      "level":2
   },
   "encryptionSettings":null,
   "customActions":{
      "preBackupAction":null,
      "postSnapshotAction":null,
      "postBackupAction":null
   },
   "advancedOptions":{
      "useVss":"True",
      "maxTaskRetriesCount":"3",
      "taskRetriesFrequency":"60000",
      "maxConcurrentTasks":"5",
      "processorProperties_PartSize":"1048576"
   },
   "deltaSettings":null,
   "workerId":"a4ac1eb-bbe7-a4ac-b3da-a4acf5642a",
   "filteringSettings":null,
   "organizationId":"a4ac2cd0-ea4ac-4ced-be39-6a4ace033ff",
   "repositoriesIds":[
      "c1961c1c-a425-4769-8757-32d5b6fc9aeb"
   ],
   "includeAllRepositories":false,
   "includeMetadata":true,
   "storageId":"a4ac74ac-7a4ac-4fec-9448-a4ace9267d7"
}

Response:

200 OK

---

GitRepositoryController

Metoda Activate (POST)

Aktywuje licencje dla wybranych repozytoriów Git.

Autoryzacja jest wymagana. Aby skorzystać z tej metody, użytkownik musi posiadać uprawnienia (role) DataRemoveManagement lub GitManagement.

Endpoint:

POST https://<server_address>/git/repositories/activate

Parametry metody:

Parameter	Description	Type
Ids	Identyfikatory repozytoriów, które mają zostać aktywowane.	array [guid]

Przykład JSON:

{
    "Ids":[
        "a4ac979e-0000-0000-0000-000000000000",
        "a4acca07-0000-0000-0000-000000000000",
        "a4ac7c5-0000-0000-0000-000000000000",
        "a4ac9d7a-0000-0000-0000-000000000000",
        "1a4ac9bc9-0000-0000-0000-000000000000",
        "a4ac79fe9-0000-0000-0000-000000000000",
        "a4ac3f220-0000-0000-0000-000000000000",
        "a4aca817-0000-0000-0000-000000000000"
    ]
}

Response:

{
    "success": [],
    "error": [
        {
            "id": "a4ac7979e-0000-0000-0000-000000000000",
            "errorCode": "LI5020"
        },
        {
            "id": "a4acdca07-0000-0000-0000-000000000000",
            "errorCode": "LI5020"
        },
        {
            "id": "a4ac797c5-0000-0000-0000-000000000000",
            "errorCode": "LI5020"
        },
        {
            "id": "a4ac79d7a-0000-0000-0000-000000000000",
            "errorCode": "LI5020"
        },
        {
            "id": "a4ac79bc9-0000-0000-0000-000000000000",
            "errorCode": "LI5020"
        },
        {
            "id": "a4ac79fe9-0000-0000-0000-000000000000",
            "errorCode": "LI5020"
        },
        {
            "id": "a4ac3f220-0000-0000-0000-000000000000",
            "errorCode": "LI5020"
        },
        {
            "id": "a4acea817-0000-0000-0000-000000000000",
            "errorCode": "LI5020"
        }
    ]
}

Metoda Deactivate (POST)

Dezaktywuje licencje dla wybranych repozytoriów Git.

Autoryzacja jest wymagana. Aby skorzystać z tej metody, użytkownik musi posiadać uprawnienia (role) DataRemoveManagement lub GitManagement.

Endpoint:

POST https://<server_address>/git/repositories/deactivate

Parametry metody:

Parameter	Description	Type
Ids	Identyfikatory repozytoriów, które mają zostać dezaktywowane	array [guid]

Przykład JSON:

{
    "Ids":[
        "a4ac7979e-0000-0000-0000-000000000000",
        "a4acdca07-0000-0000-0000-000000000000",
        "a4ac797c5-0000-0000-0000-000000000000",
        "a4ac79d7a-0000-0000-0000-000000000000",
        "a4ac79bc9-0000-0000-0000-000000000000",
        "a4ac79fe9-0000-0000-0000-000000000000",
        "a4ac3f220-0000-0000-0000-000000000000",
        "a4acea817-0000-0000-0000-000000000000"
    ]
}

Response:

{
    "success": [],
    "error": [
        {
            "id": "a4ac7979e-0000-0000-0000-000000000000",
            "errorCode": "GT1001"
        },
        {
            "id": "a4acdca07-0000-0000-0000-000000000000",
            "errorCode": "GT1001"
        },
        {
            "id": "a4ac797c5-0000-0000-0000-000000000000",
            "errorCode": "GT1001"
        },
        {
            "id": "a4ac79d7a-0000-0000-0000-000000000000",
            "errorCode": "GT1001"
        },
        {
            "id": "a4ac79bc9-0000-0000-0000-000000000000",
            "errorCode": "GT1001"
        },
        {
            "id": "a4ac79fe9-0000-0000-0000-000000000000",
            "errorCode": "GT1001"
        },
        {
            "id": "a4ac3f220-0000-0000-0000-000000000000",
            "errorCode": "GT1001"
        },
        {
            "id": "a4acea817-0000-0000-0000-000000000000",
            "errorCode": "GT1001"
        }
    ]
}

Metoda GetMany (POST)

Pobiera szczegółową listę repozytoriów Git należących do danej organizacji.

Autoryzacja jest wymagana.

Endpoint:

POST https://<server_address>/git/repositories/getmany

Parametry metody:

Parameter	Description	Type
id	Identyfikator organizacji Git.	guid
limit	Definiuje liczbę zwróconych repozytoriów na stronę.	int
orderby	Nazwa pola do sortowania.	string
ordertype	Porządek sortowania: rosnący(asc) lub malejący (desc).	string
page	Numer strony.	int
filters	Filtry danych.	array [filter]

Przykład JSON:

{
    "id": "a4ac2cd0-a4ac-4ced-be39-a4ac31e033ff",
    "limit": 2,
    "orderby": "Name",
    "ordertype": "asc",
    "page": 1,
    "filters":[
    {
        "operator": "eq",
        "value": true,
        "property": "IsRemoved"
    }
    ]
}

Response:

{
    "currentPage": 1,
    "pageCount": 1,
    "totalEntries": 2,
    "result": {
        "synchronizationInProgress": false,
        "lastSynchronizationRepositoriesStartTime": 1645546071481,
        "repositories": [
            {
                "id": "a4ac3ac7d-99e4-a4ac-b5a4-a4acdeee5",
                "serverId": "a4acac7d-99e4-a4ac-b5a4-ea4ac2deee5",
                "name": "org/repo1",
                "lastBackup": 0,
                "lastSuccessfulBackup": 0,
                "nextBackup": 0,
                "isProtected": true,
                "isRemoved": true,
                "status": 2,
                "lastBackupTaskStatus": 0,
                "isPublic": false
            },
            {
                "id": "a4acf294-b30e-a4ac-aabb-6a4ac6578686",
                "serverId": "a4ac294-b30e-a4ac-aabb-63a4ac578686",
                "name": "org/repo2",
                "lastBackup": 0,
                "lastSuccessfulBackup": 0,
                "nextBackup": 1645556400000,
                "isProtected": true,
                "isRemoved": true,
                "status": 2,
                "lastBackupTaskStatus": 0,
                "isPublic": false
            }
       ],
     "removedRepositories": 15
}

Metoda Remove (POST)

Usuwa dane repozytorium z systemu.

Autoryzacja jest wymagana. Aby skorzystać z tej metody, użytkownik musi posiadać uprawnienia (role) DataRemoveManagement lub GitManagement.

Endpoint:

POST https://<server_address>/git/repositories/remove

Parametry metody:

Parameter	Description	Type
id	Lista identyfikatorów repozytoriów do usunięcia z systemu.	guid
removedata	Jeśli jest ustawione jako true, system usunie również dane backupowe tych repozytoriów.	bool

Przykład JSON:

{
    "id": "a4acd28-eee0-404a-a4ac0-6ca4ac260ca",
    "removedata": true
}

Response:

{
    "succeededIds": [
        "a4ac8d28-eee0-a4ac-a070-6a4ac76260ca"
    ],
    "failedIds": [],
    "errors": []
}

---

Synchronizacja

Metoda Sync (POST)

Uruchamia ręczną synchronizację struktury organizacji Git z usługą Xopero ONE.

Autoryzacja jest wymagana.

Endpoint:

POST https://<server_address>/git/repositories/sync

Parametry metody:

Parameter	Description	Type
id	Identyfikator organizacji Git.	guid

Przykład JSON:

{
    "id": "a4ac2cd0-a4ac-4ced-a4ac-60ca4ac3ff"
}

Response:

200 OK