ジョブ・テンプレートのラベルの作成
post
/api/v2/job_templates/{id}/labels/
次のラベル・フィールドを指定してこのリソースに対してPOSTリクエストを行って、このジョブ・テンプレートに関連付けられた新しいラベルを作成します。
name
: このラベルの名前。(文字列、必須)organization
: このラベルが属する組織。(id、必須)
ジョブ・テンプレートのラベルの追加:
このジョブ・テンプレートに既存のラベルを関連付けるには、id
フィールドのみを指定してこのリソースに対してPOSTリクエストを行います。
このジョブ・テンプレートからのラベルの除去:
このジョブ・テンプレートからラベルを除去するには、id
およびdisassociate
フィールドを指定してこのリソースに対してPOSTリクエストを行います。
他のいずれのリソースにも関連付けられていないラベルは削除されます。 3つのイベントの結果として、ラベルとリソースの関連付けが解除されることがあります。
- ラベルが、関連するジョブ・テンプレートから明示的に関連付けを解除される
- ジョブがラベルとともに削除される
- クリーン・アップ・ジョブによって、ジョブがラベルとともに削除される
リクエスト
サポートされているメディア・タイプ
- application/json
パス・パラメータ