Virtual Data Centers

WARNING

API w tej wersji zostało wycofane 9 czerwca 2025 roku.

Tworzenie VDC

Aby utworzyć VDC, wyślij request jak poniżej.

POST https://365.exea.pl/api/v3/vdcs
Accept: application/json
Authorization: Bearer {{token}}
Content-Type: application/json

{
    "name": "Sample VDC name",
    "description": null,
    "project_id": "44c733cd-03ec-4e38-92a3-2fd92782358b",
    "org_id": "1c06e278-7dd6-42c0-98df-906d40047733",
    "provider_vdc_id": "85882236-a50f-4ad0-9fce-fb22c2fbb0d9",
    "network_pool_id": "2e8da594-37e2-412e-811d-2e0785d78ea1",
    "compute_capacity": {
        "cpu": {
            "limit": 2400
        },
        "memory": {
            "limit": 2048
        }
    },
    "pvdc_storage_profiles": [
        {
            "id": "f5e78cca-4223-46f9-9600-b4e326550a45",
            "limit": 50000,
            "default" : true
        },
        {
            "id": "0054a6d5-0360-4426-8fe4-3184ac97366b",
            "limit": 50000,
            "default" : false
        },
        {
            "id": "85882236-a50f-4ad0-9fce-fb22c2fbb0d9",
            "limit": 50000,
            "default" : false
        }
    ]
}

Opis pól

Pole	Opis
name	Nazwa VDC, musi być unikatowa w obrębie organizacji VMware Cloud Directora
description	Opis (opcjonalne)
project_id	ID projektu Exea365 należącego do użytkownika korzystającego z API
org_id	ID organizacji VMware Cloud Director
provider_vdc_id	ID Provider VDC, o dostępne ID zapytaj swojego opiekuna w Exea
network_pool_id	ID Network Pool, o dostępne ID zapytaj swojego opiekuna w Exea
compute_capacity.cpu.limit	Limit CPU w MHz, wymagana liczba całkowita między 2400 a 240000 (1–100 CPU)
compute_capacity.memory.limit	Limit pamięci w MB, wymagana liczba całkowita między 1024 a 262144 MB (1–256 GB)
pvdc_storage_profile.id	ID Provider VDC Storage Profile, o dostępne ID zapytaj swojego opiekuna w Exea
pvdc_storage_profile.limit	Limit pojemności dysku w MB, wymagana liczba całkowita między 1024 a 2 147 483 648 MB (1 GB – 2 TB )

Przykładowe odpowiedzi

HTTP/1.1 201 Created

{
  "task": {
    "id": "993056ed-c481-4dac-b703-1b1c1e7f03d7",
    "operation": "Create VDC",
    "status": "success",
    "vdc": {
      "id": "c0c0d2ff-5902-4cfa-9030-683347fe9733",
      "name": "grezlikowski-test-9"
    }
  }
}

HTTP/1.1 422 Unprocessable Content

{
  "task": {
    "id": "9930534f-6f74-4165-b89f-14705f93e9b2",
    "operation": "Create VDC",
    "status": "error",
    "details": "VDC name must be unique in organization."
  }
}

HTTP/1.1 201 Created

"https://vcloud.exea.pl/tenant/Grezlik-API-Tests/vdcs/e17e0d84-692c-446e-a8c5-71012b0bbb0f/general-settings"

Status 201 oznacza, że zapytanie było prawidłowe i dane zostały przekazane do VMware Cloud Director, a obiekt VDC jest w trakcie tworzenia. W odpowiedzi znajduje się link do nowo utworzonego VDC.

---

HTTP/1.1 422 Unprocessable Content

{
    "errors": {
        "name": [
            "VDC name must be unique in organization"
        ]
    }
}

Nazwy VDC muszą być unikatowe w obrębie organizacji. W związku z tym nie można utworzyć VDC z nazwą, która już istnieje.

Automatyczne tworzenie usługi

Uwaga! Utworzenie VDC poprzez Exea365 API jest jednoznaczne z utworzeniem zamówienia i usługi cloud w Exea365 i będzie naliczana za nią opłata.

Dezaktywacja VDC

Dezaktywowanie VDC powoduje, że nie można w nim zaalokować nowych zasobów. Nie można utworzyć nowych vApps/VMs oraz nie można uruchomić żadnych nowych maszyn wirtualnych. Dezaktywacja nie wpływa na już używane zasoby. Jeśli jakieś maszyny wirtualne są włączone, pozostają włączone po dezaktywacji VDC.

Aby dezaktywować VDC, wyślij request jak poniżej.

POST https://365.exea.pl/api/v3/vdcs/VDC_ID/disable
Accept: application/json
Authorization: Bearer {{token}}

VDC zostanie dezaktywowane.

Przykładowe odpowiedzi

HTTP/1.1 200 OK

"VDC b84d60cf-f8a3-474c-84e8-6cfa35675309 is disabled"

Potwierdzenie, że VDC zostało dezaktywowane.

HTTP/1.1 404 Not Found

{
    "Cannot find VDC eb3fc3dd-ec8e-44bd-a4d3-71f66021cad4."
}

Nie można dezaktywować VDC. VDC o danym ID nie istnieje.

HTTP/1.1 409 Conflict

{
    "message": "Cannot disable VDC.",
    "vmware_api_response": "HTTP 403 - [ 65efd04c-2600-4110-9440-ad02c8a7276b ] Either you need some or all of the following rights [ORG_VDC_ENABLE_DISABLE] to perform operations [ORGANIZATION_VDC_DISABLE] for b84d60cf-f8a3-474c-84e8-6cfa35675309 or the target entity is invalid."
}

Informacja na temat niepowodzenia i jego przyczyny. Tutaj: nie masz uprawnień do wykonania operacji.

Usuwanie VDC

Aby usunąć VDC, wyślij request jak poniżej.

DELETE https://365.exea.pl/api/v3/vdcs/VDC_ID
Accept: application/json
Authorization: Bearer {{token}}

VDC zostanie usunięte wraz z powiązanymi obiektami (Edge Gateway, sieci, vApp).

Przykładowe odpowiedzi

HTTP/1.1 202 Accepted

{
  "task": {
    "id": "99305bc8-1f68-4cff-9753-adee0721228b",
    "operation": "Delete VDC",
    "status": "queued"
  }
}

HTTP/1.1 404 Not Found

{
  "task": {
    "id": "993058ac-a02c-4e9a-af36-bdbd6eb58784",
    "operation": "Delete VDC",
    "status": "error",
    "details": "Cannot find VDC 750570be-9119-499d-accb-41b4961b9e37."
  }
}