ニフクラAPI (DevOps with Gitlab: UpdateRunnerParameterGroup)

UpdateRunnerParameterGroup

処理概要

指定したRunnerパラメーターグループの設定を更新します。

リクエストURL

PUT /v1/parameterGroups/{ParameterGroupName}

指定するパラメーター

パスパラメーター

パラメーター	型	説明	必須
ParameterGroupName	string	Runnerパラメータグループ名	○

リクエストボディ

パラメーター	型	説明	必須
changedParameterGroupName	string	Runnerパラメーターグループ 使用可能文字: 63文字以内の半角英数小文字と-ハイフンが利用可能(先頭と末尾の-は禁止)
description	string	メモ 使用可能文字: 255文字以内の全角半角

応答フィールド

フィールド (項目)	型	説明
parameterGroup	object
␣description	string	メモ
␣parameterGroupName	string	Runnerパラメーターグループ
␣region	string	Runnerが稼働するリージョン名
␣dockerParameters	object
␣␣disableCache	boolean	キャッシュの無効化
␣␣disableEntrypointOverwrite	boolean	エントリポイントの上書き無効化
␣␣extraHosts[]	object[]
␣␣␣hostName	string	ホスト名
␣␣␣ipAddress	string	IPアドレス
␣␣image	string	デフォルトのイメージ
␣␣oomKillDisable	boolean	OOMキラーの無効化
␣␣privileged	boolean	特権での実行
␣␣shmSize	integer	/dev/shmに割り当てる容量
␣␣tlsVerify	boolean	TLSの検証
␣␣volumes	string[]	キャッシュストレージパス
␣createTime	string	Runnerパラメーターグループの作成日時
␣runnerNames	string[]	パラメータに紐づいているRunner

リクエストサンプル

    curl -XPUT https://jp-east-1.devops.api.nifcloud.com/v1/parameterGroups/gitlab1pg
    -H 'X-Amz-Date: 20230401T000000Z'
    -H 'Authorization: AWS4-HMAC-SHA256 ...'
    -H 'content-type:application/json'
    -d '
{
    "changedParameterGroupName":"changed-param1",
    "description":"Changed description"
}'

  

応答サンプル

    {
    "parameterGroup":{
        "description":"changed description",
        "parameterGroupName":"changed_name",
        "region":"jp-east-1",
        "dockerParameters":{
            "disableCache":false,
            "disableEntrypointOverwrite":false,
            "extraHosts":[
                {
                    "hostName":"example.com",
                    "ipAddress":"x.x.x.x"
                }
            ],
            "image":"alpine:latest",
            "oomKillDisable":false,
            "privileged":false,
            "shmSize":0,
            "tlsVerify":false,
            "volumes":[
                "/cache"
            ]
        },
        "createTime":"2023-03-15T10:28:13Z",
        "runnerNames":[]
    }
}