DebianグループディストリビューションAPI

プラン: Free、Premium、Ultimate
提供形態: GitLab Self-Managed

このAPIを使用して、Debianグループディストリビューションを管理します。このAPIはデフォルトで無効になっている機能フラグの背後にあります。このAPIを使用するには、有効にする必要があります。

このAPIは開発中であり、本番環境での使用を意図したものではありません。

DebianグループAPIを有効にする

Debianグループリポジトリのサポートは、まだ開発中です。デフォルトで無効になっている機能フラグの背後にゲートがあります。GitLab RailsコンソールにアクセスできるGitLab管理者は、それを有効にすることを選択できます。それを有効にするには、DebianグループAPIを有効にするの手順に従ってください。

DebianディストリビューションAPIへの認証

DebianディストリビューションAPIへの認証を参照してください。

グループ内のすべてのDebianディストリビューションをリストする

指定されたグループ内のDebianディストリビューションをリストします。

GET /groups/:id/-/debian_distributions

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス。
`codename`	文字列	いいえ	特定の`codename`でフィルタリングします。
`suite`	文字列	いいえ	特定の`suite`でフィルタリングします。

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/5/-/debian_distributions"

レスポンス例:

[
  {
    "id": 1,
    "codename": "sid",
    "suite": null,
    "origin": null,
    "label": null,
    "version": null,
    "description": null,
    "valid_time_duration_seconds": null,
    "components": [
      "main"
    ],
    "architectures": [
      "all",
      "amd64"
    ]
  }
]

単一のDebianグループディストリビューション

単一のDebianグループディストリビューションを取得します。

GET /groups/:id/-/debian_distributions/:codename

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス。
`codename`	文字列	はい	ディストリビューションの`codename`。

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/5/-/debian_distributions/unstable"

レスポンス例:

{
  "id": 1,
  "codename": "sid",
  "suite": null,
  "origin": null,
  "label": null,
  "version": null,
  "description": null,
  "valid_time_duration_seconds": null,
  "components": [
    "main"
  ],
  "architectures": [
    "all",
    "amd64"
  ]
}

単一のDebianグループディストリビューションキー

単一のDebianグループディストリビューションキーを取得します。

GET /groups/:id/-/debian_distributions/:codename/key.asc

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス。
`codename`	文字列	はい	ディストリビューションの`codename`。

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/5/-/debian_distributions/unstable/key.asc"

レスポンス例:

Debianグループディストリビューションを作成する

Debianグループディストリビューションを作成します。

POST /groups/:id/-/debian_distributions

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス。
`codename`	文字列	はい	Debianディストリビューションのコードネーム。
`suite`	文字列	いいえ	新しいDebianディストリビューションのスイート。
`origin`	文字列	いいえ	新しいDebianディストリビューションのorigin。
`label`	文字列	いいえ	新しいDebianディストリビューションのラベル。
`version`	文字列	いいえ	新しいDebianディストリビューションのバージョン。
`description`	文字列	いいえ	新しいDebianディストリビューションの説明。
`valid_time_duration_seconds`	整数	いいえ	新しいDebianディストリビューションの有効期間（秒）。
`components`	文字列配列	いいえ	新しいDebianディストリビューションのコンポーネントのリスト。
`architectures`	文字列配列	いいえ	新しいDebianディストリビューションのアーキテクチャのリスト。

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/5/-/debian_distributions?codename=sid"

レスポンス例:

{
  "id": 1,
  "codename": "sid",
  "suite": null,
  "origin": null,
  "label": null,
  "version": null,
  "description": null,
  "valid_time_duration_seconds": null,
  "components": [
    "main"
  ],
  "architectures": [
    "all",
    "amd64"
  ]
}

Debianグループディストリビューションを更新する

Debianグループディストリビューションを更新します。

PUT /groups/:id/-/debian_distributions/:codename

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス。
`codename`	文字列	はい	Debianディストリビューションの新しいコードネーム。
`suite`	文字列	いいえ	Debianディストリビューションの新しいスイート。
`origin`	文字列	いいえ	Debianディストリビューションの新しいorigin。
`label`	文字列	いいえ	Debianディストリビューションの新しいラベル。
`version`	文字列	いいえ	Debianディストリビューションの新しいバージョン。
`description`	文字列	いいえ	Debianディストリビューションの新しい説明。
`valid_time_duration_seconds`	整数	いいえ	Debianディストリビューションの新しい有効期間（秒）。
`components`	文字列配列	いいえ	Debianディストリビューションの新しいコンポーネントのリスト。
`architectures`	文字列配列	いいえ	Debianディストリビューションの新しいアーキテクチャのリスト。

curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/5/-/debian_distributions/unstable?suite=new-suite&valid_time_duration_seconds=604800"

レスポンス例:

{
  "id": 1,
  "codename": "sid",
  "suite": "new-suite",
  "origin": null,
  "label": null,
  "version": null,
  "description": null,
  "valid_time_duration_seconds": 604800,
  "components": [
    "main"
  ],
  "architectures": [
    "all",
    "amd64"
  ]
}

Debianグループディストリビューションを削除する

Debianグループディストリビューションを削除します。

DELETE /groups/:id/-/debian_distributions/:codename

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス。
`codename`	文字列	はい	Debianディストリビューションのコードネーム。

curl --request DELETE \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/5/-/debian_distributions/unstable"