GET /api/ptables
Lista wszystkich partycji

GET /api/operatingsystems/:operatingsystem_id/ptables
Lista wszystkich partycji dla systemu operacyjnego

GET /api/locations/:location_id/ptables
Lista wszystkich partycji na lokalizację

GET /api/organizations/:organization_id/ptables
Lista wszystkich partycji na organizację

Przykłady

GET /api/ptables
200
{
  "total": 2,
  "subtotal": 2,
  "page": 1,
  "per_page": 20,
  "search": null,
  "sort": {
    "by": null,
    "order": null
  },
  "results": [
    {
      "os_family": null,
      "created_at": "2019-09-11 14:34:13 UTC",
      "updated_at": "2019-09-11 14:34:13 UTC",
      "name": "Example partition table",
      "id": 615088209
    },
    {
      "os_family": "Redhat",
      "created_at": "2019-09-11 14:34:42 UTC",
      "updated_at": "2019-09-11 14:34:42 UTC",
      "name": "ptable214",
      "id": 1007981802
    }
  ]
}

Parametry

Nazwa parametru Opis
operatingsystem_id
opcjonalny

ID systemów operacyjnych

Validations:

  • Must be a String

location_id
opcjonalny

Zakres w zależności od lokalizacji

Validations:

  • Must be a Integer

organization_id
opcjonalny

Zakres w zależności od organizacji

Validations:

  • Must be a Integer

search
opcjonalny

rezultat filtrowania

Validations:

  • Must be a String

order
opcjonalny

Sort field and order, eg. ‘id DESC’

Validations:

  • Must be a String

page
opcjonalny

Page number, starting at 1

Validations:

  • Must be a number.

per_page
opcjonalny

Number of results per page to return

Validations:

  • Must be a number.

Search fields

Field name Typ Possible values
default true, false
family string
layout text
location string
location_id integer
locked true, false
name string
organization string
organization_id integer
snippet true, false
template text
vendor string

GET /api/ptables/:id
Pokaż tabelę partycji

Przykłady

GET /api/ptables/1007981804-ptable216
200
{
  "layout": "zerombr\\nclearpart --all    --initlabel\\npart /boot --fstype ext3 --size=<%= 10 * 10 %> --asprimary\\npart /     --f   stype ext3 --size=1024 --grow\\npart swap  --recommended",
  "locked": false,
  "os_family": "Redhat",
  "created_at": "2019-09-11 14:34:43 UTC",
  "updated_at": "2019-09-11 14:34:43 UTC",
  "name": "ptable216",
  "id": 1007981804,
  "operatingsystems": [
    {
      "id": 1073012828,
      "name": "Redhat",
      "title": "RHEL 6.1"
    }
  ],
  "locations": [
    {
      "id": 255093256,
      "name": "Location 1",
      "title": "Location 1",
      "description": null
    }
  ],
  "organizations": [
    {
      "id": 447626438,
      "name": "Organization 1",
      "title": "Organization 1",
      "description": null
    }
  ]
}

Parametry

Nazwa parametru Opis
location_id
opcjonalny

Zakres w zależności od lokalizacji

Validations:

  • Must be a Integer

organization_id
opcjonalny

Zakres w zależności od organizacji

Validations:

  • Must be a Integer

id
wymagany

Validations:

  • Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.


POST /api/ptables
Tworzenie tablicy partycji

Przykłady

POST /api/ptables
{
  "ptable": {
    "name": "W",
    "layout": "d-i partman-auto/disk"
  }
}
201
{
  "layout": "d-i partman-auto/disk",
  "locked": false,
  "os_family": null,
  "created_at": "2019-09-11 14:34:42 UTC",
  "updated_at": "2019-09-11 14:34:42 UTC",
  "name": "W",
  "id": 1007981781,
  "operatingsystems": [],
  "locations": [],
  "organizations": []
}

Parametry

Nazwa parametru Opis
location_id
opcjonalny

Zakres w zależności od lokalizacji

Validations:

  • Must be a Integer

organization_id
opcjonalny

Zakres w zależności od organizacji

Validations:

  • Must be a Integer

ptable
wymagany

Validations:

  • Must be a Hash

ptable[name]
wymagany

Validations:

  • Must be a String

ptable[layout]
wymagany

Validations:

  • Must be a String

ptable[snippet]
opcjonalny , nil dopuszczalny

Validations:

  • Must be one of: true, false, 1, 0.

ptable[audit_comment]
opcjonalny , nil dopuszczalny

Validations:

  • Must be a String

ptable[locked]
opcjonalny , nil dopuszczalny

Czy szablon jest zablokowany do edycji

Validations:

  • Must be one of: true, false, 1, 0.

ptable[os_family]
opcjonalny , nil dopuszczalny

Validations:

  • Must be a String

ptable[operatingsystem_ids]
opcjonalny , nil dopuszczalny

Tablica identyfikatorów systemu operacyjnego skojarzona z tablicą partycji

Validations:

  • Must be an array of any type

ptable[host_ids]
opcjonalny , nil dopuszczalny

Tablica identyfikatorów hosta powiązana z tablicą partycji

Validations:

  • Must be an array of any type

ptable[hostgroup_ids]
opcjonalny , nil dopuszczalny

Tablica ID grupy hostów skojarzona z tablicą partycji

Validations:

  • Must be an array of any type

ptable[location_ids]
opcjonalny , nil dopuszczalny

ZMIEŃ lokalizacje o podanym id

Validations:

  • Must be an array of any type

ptable[organization_ids]
opcjonalny , nil dopuszczalny

ZMIEŃ organizacje o podanym id

Validations:

  • Must be an array of any type


POST /api/ptables/import
Import a provisioning template

Przykłady

POST /api/ptables/import
{
  "ptable": {
    "name": "ptable212",
    "template": "b"
  }
}
201
{
  "template": "b",
  "name": "ptable212",
  "id": 1007981800,
  "snippet": false,
  "template_kind_id": null,
  "created_at": "2019-09-11T14:34:42.858Z",
  "updated_at": "2019-09-11T14:34:42.873Z",
  "locked": false,
  "default": false,
  "vendor": null,
  "os_family": "Redhat"
}

Parametry

Nazwa parametru Opis
location_id
opcjonalny

Zakres w zależności od lokalizacji

Validations:

  • Must be a Integer

organization_id
opcjonalny

Zakres w zależności od organizacji

Validations:

  • Must be a Integer

ptable
wymagany

Validations:

  • Must be a Hash

ptable[name]
opcjonalny

nazwa szablonu

Validations:

  • Must be a String

ptable[template]
opcjonalny

template contents including metadata

Validations:

  • Must be a String

ptable[location_ids]
opcjonalny , nil dopuszczalny

ZMIEŃ lokalizacje o podanym id

Validations:

  • Must be an array of any type

ptable[organization_ids]
opcjonalny , nil dopuszczalny

ZMIEŃ organizacje o podanym id

Validations:

  • Must be an array of any type

options
opcjonalny

Validations:

  • Must be a Hash

options[force]
opcjonalny , nil dopuszczalny

use if you want update locked templates

Validations:

  • Must be one of: true, false, 1, 0.

options[associate]
opcjonalny , nil dopuszczalny

determines when the template should associate objects based on metadata, new means only when new template is being created, always means both for new and existing template which is only being updated, never ignores metadata

Validations:

  • Must be one of: new, always, never.

options[lock]
opcjonalny , nil dopuszczalny

lock imported templates (false by default)

Validations:

  • Must be one of: true, false, 1, 0.

options[default]
opcjonalny , nil dopuszczalny

makes the template default meaning it will be automatically associated with newly created organizations and locations (false by default)

Validations:

  • Must be one of: true, false, 1, 0.


GET /api/ptables/revision

Parametry

Nazwa parametru Opis
location_id
opcjonalny

Zakres w zależności od lokalizacji

Validations:

  • Must be a Integer

organization_id
opcjonalny

Zakres w zależności od organizacji

Validations:

  • Must be a Integer

version
opcjonalny

wersja szablonu

Validations:

  • Must be a String


PUT /api/ptables/:id
Aktualizacja tablicy partycji

Przykłady

PUT /api/ptables/1007981787-ptable201
{
  "ptable": {
    "audit_comment": "aha",
    "template": "tmp"
  }
}
200
{
  "layout": "tmp",
  "locked": false,
  "os_family": "Redhat",
  "created_at": "2019-09-11 14:34:42 UTC",
  "updated_at": "2019-09-11 14:34:42 UTC",
  "name": "ptable201",
  "id": 1007981787,
  "operatingsystems": [],
  "locations": [
    {
      "id": 255093256,
      "name": "Location 1",
      "title": "Location 1",
      "description": null
    }
  ],
  "organizations": [
    {
      "id": 447626438,
      "name": "Organization 1",
      "title": "Organization 1",
      "description": null
    }
  ]
}

Parametry

Nazwa parametru Opis
location_id
opcjonalny

Zakres w zależności od lokalizacji

Validations:

  • Must be a Integer

organization_id
opcjonalny

Zakres w zależności od organizacji

Validations:

  • Must be a Integer

id
wymagany

Validations:

  • Must be a String

ptable
wymagany

Validations:

  • Must be a Hash

ptable[name]
opcjonalny

Validations:

  • Must be a String

ptable[layout]
opcjonalny

Validations:

  • Must be a String

ptable[snippet]
opcjonalny , nil dopuszczalny

Validations:

  • Must be one of: true, false, 1, 0.

ptable[audit_comment]
opcjonalny , nil dopuszczalny

Validations:

  • Must be a String

ptable[locked]
opcjonalny , nil dopuszczalny

Czy szablon jest zablokowany do edycji

Validations:

  • Must be one of: true, false, 1, 0.

ptable[os_family]
opcjonalny , nil dopuszczalny

Validations:

  • Must be a String

ptable[operatingsystem_ids]
opcjonalny , nil dopuszczalny

Tablica identyfikatorów systemu operacyjnego skojarzona z tablicą partycji

Validations:

  • Must be an array of any type

ptable[host_ids]
opcjonalny , nil dopuszczalny

Tablica identyfikatorów hosta powiązana z tablicą partycji

Validations:

  • Must be an array of any type

ptable[hostgroup_ids]
opcjonalny , nil dopuszczalny

Tablica ID grupy hostów skojarzona z tablicą partycji

Validations:

  • Must be an array of any type

ptable[location_ids]
opcjonalny , nil dopuszczalny

ZMIEŃ lokalizacje o podanym id

Validations:

  • Must be an array of any type

ptable[organization_ids]
opcjonalny , nil dopuszczalny

ZMIEŃ organizacje o podanym id

Validations:

  • Must be an array of any type


DELETE /api/ptables/:id
Usuwanie tablicy partycji

Przykłady

DELETE /api/ptables/1007981794-ptable206
{
  "ptable": {}
}
422
{
  "error": {
    "id": 1007981794,
    "errors": {
      "base": [
        "ptable206 is used by host312"
      ]
    },
    "full_messages": [
      "ptable206 is used by host312"
    ]
  }
}

Parametry

Nazwa parametru Opis
location_id
opcjonalny

Zakres w zależności od lokalizacji

Validations:

  • Must be a Integer

organization_id
opcjonalny

Zakres w zależności od organizacji

Validations:

  • Must be a Integer

id
wymagany

Validations:

  • Must be a String


POST /api/ptables/:id/clone
Sklonuj szablon

Przykłady

POST /api/ptables/1007981806-ptable218/clone
{
  "ptable": {
    "name": ""
  }
}
422
{
  "error": {
    "id": 1007981806,
    "errors": {
      "name": [
        "can't be blank"
      ]
    },
    "full_messages": [
      "Name can't be blank"
    ]
  }
}

Parametry

Nazwa parametru Opis
location_id
opcjonalny

Zakres w zależności od lokalizacji

Validations:

  • Must be a Integer

organization_id
opcjonalny

Zakres w zależności od organizacji

Validations:

  • Must be a Integer

id
wymagany

Validations:

  • Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.

ptable
wymagany

Validations:

  • Must be a Hash

ptable[name]
wymagany

nazwa szablonu

Validations:

  • Must be a String


GET /api/ptables/:id/export
Export a partition template to ERB

Przykłady

GET /api/ptables/1007981785-ptable199/export
200
zerombr\nclearpart --all    --initlabel\npart /boot --fstype ext3 --size=<%= 10 * 10 %> --asprimary\npart /     --f   stype ext3 --size=1024 --grow\npart swap  --recommended
<%#
name: ptable199
snippet: false
model: Ptable
os_family: Redhat
organizations:
- Organization 1
locations:
- Location 1
%>

Parametry

Nazwa parametru Opis
location_id
opcjonalny

Zakres w zależności od lokalizacji

Validations:

  • Must be a Integer

organization_id
opcjonalny

Zakres w zależności od organizacji

Validations:

  • Must be a Integer

id
wymagany

Validations:

  • Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.