Deployments API

Deployments API

获取项目中的部署列表.

status 属性可以是以下值之一：

  • created
  • running
  • success
  • failed
  • canceled
  1. curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/deployments"
  1. [  {  "created_at":  "2016-08-11T07:36:40.222Z",  "updated_at":  "2016-08-11T07:38:12.414Z",  "status":  "created",  "deployable":  {  "commit":  {  "author_email":  "admin@example.com",  "author_name":  "Administrator",  "created_at":  "2016-08-11T09:36:01.000+02:00",  "id":  "99d03678b90d914dbb1b109132516d71a4a03ea8",  "message":  "Merge branch 'new-title' into 'master'\r\n\r\nUpdate README\r\n\r\n\r\n\r\nSee merge request !1",  "short_id":  "99d03678",  "title":  "Merge branch 'new-title' into 'master'\r"  },  "coverage":  null,  "created_at":  "2016-08-11T07:36:27.357Z",  "finished_at":  "2016-08-11T07:36:39.851Z",  "id":  657,  "name":  "deploy",  "ref":  "master",  "runner":  null,  "stage":  "deploy",  "started_at":  null,  "status":  "success",  "tag":  false,  "user":  {  "id":  1,  "name":  "Administrator",  "username":  "root",  "state":  "active",  "avatar_url":  "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",  "web_url":  "http://gitlab.dev/root",  "created_at":  "2015-12-21T13:14:24.077Z",  "bio":  null,  "location":  null,  "public_email":  "",  "skype":  "",  "linkedin":  "",  "twitter":  "",  "website_url":  "",  "organization":  ""  },  "pipeline":  {  "created_at":  "2016-08-11T02:12:10.222Z",  "id":  36,  "ref":  "master",  "sha":  "99d03678b90d914dbb1b109132516d71a4a03ea8",  "status":  "success",  "updated_at":  "2016-08-11T02:12:10.222Z",  "web_url":  "http://gitlab.dev/root/project/pipelines/12"  }  },  "environment":  {  "external_url":  "https://about.gitlab.com",  "id":  9,  "name":  "production"  },  "id":  41,  "iid":  1,  "ref":  "master",  "sha":  "99d03678b90d914dbb1b109132516d71a4a03ea8",  "user":  {  "avatar_url":  "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",  "id":  1,  "name":  "Administrator",  "state":  "active",  "username":  "root",  "web_url":  "http://localhost:3000/root"  }  },  {  "created_at":  "2016-08-11T11:32:35.444Z",  "updated_at":  "2016-08-11T11:34:01.123Z",  "status":  "created",  "deployable":  {  "commit":  {  "author_email":  "admin@example.com",  "author_name":  "Administrator",  "created_at":  "2016-08-11T13:28:26.000+02:00",  "id":  "a91957a858320c0e17f3a0eca7cfacbff50ea29a",  "message":  "Merge branch 'rename-readme' into 'master'\r\n\r\nRename README\r\n\r\n\r\n\r\nSee merge request !2",  "short_id":  "a91957a8",  "title":  "Merge branch 'rename-readme' into 'master'\r"  },  "coverage":  null,  "created_at":  "2016-08-11T11:32:24.456Z",  "finished_at":  "2016-08-11T11:32:35.145Z",  "id":  664,  "name":  "deploy",  "ref":  "master",  "runner":  null,  "stage":  "deploy",  "started_at":  null,  "status":  "success",  "tag":  false,  "user":  {  "id":  1,  "name":  "Administrator",  "username":  "root",  "state":  "active",  "avatar_url":  "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",  "web_url":  "http://gitlab.dev/root",  "created_at":  "2015-12-21T13:14:24.077Z",  "bio":  null,  "location":  null,  "public_email":  "",  "skype":  "",  "linkedin":  "",  "twitter":  "",  "website_url":  "",  "organization":  ""  },  "pipeline":  {  "created_at":  "2016-08-11T07:43:52.143Z",  "id":  37,  "ref":  "master",  "sha":  "a91957a858320c0e17f3a0eca7cfacbff50ea29a",  "status":  "success",  "updated_at":  "2016-08-11T07:43:52.143Z",  "web_url":  "http://gitlab.dev/root/project/pipelines/13"  }  },  "environment":  {  "external_url":  "https://about.gitlab.com",  "id":  9,  "name":  "production"  },  "id":  42,  "iid":  2,  "ref":  "master",  "sha":  "a91957a858320c0e17f3a0eca7cfacbff50ea29a",  "user":  {  "avatar_url":  "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",  "id":  1,  "name":  "Administrator",  "state":  "active",  "username":  "root",  "web_url":  "http://localhost:3000/root"  }  }  ]
  1. GET /projects/:id/deployments/:deployment_id

回应范例

    1. POST /projects/:id/deployments

    状态可以是以下值之一：

    • created
    • running
    • success
    • failed
    • canceled
    1. curl --data "environment=production&sha=a91957a858320c0e17f3a0eca7cfacbff50ea29a&ref=master&tag=false&status=success" --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/deployments"
    1. PUT /projects/:id/deployments/:deployment_id
    1. curl --request PUT --data "status=success" --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/deployments/42"

    响应示例：

      在 GitLab 12.7 中引入 .

      它支持与相同的参数，并将以相同的格式返回响应：