爱吃酸菜鱼的胖子

西大

JOB API---获取Build相关信息:     刚才我们获取的是job所有的相关信息，可能我们还需要获取某一次build的信息    则可以通过地址 http://192.168.6.224:8080/job/pythontest/{build_number}/api/json?pretty=true    如果我们要获得这个pythontest第一次build的信息    http://192.168.6.224:8080/job/pythontest/1/api/json?pretty=true  　　
　　JOB API--信息过滤:
　　之前获取的所有相关信息，可以通过添加参数tree=XXX[]，来过滤出你所感兴趣的节点，类似于正则表达式
　　详细的可以参考，之前站点API 说明中的"Controlling the amount of data you fetch"这一节
　　如何用，假设通过 http://192.168.6.224:8080/job/pythontest/api/json?pretty=true 会获取所有的信息
　　那么添加   tree=builds

  可以获取所有builds下的节点
　　地址拼接为 ，直接http get请求
　　http://192.168.6.224:8080/job/pythontest/api/json?pretty=true&tree=builds

　　通过地址 http://192.168.6.224:8080/job/pythontest/api/json?pretty=true&tree=builds[displayName]
　　可以获取builds下，所有displayName的节点，其中一共有三个displayName

　　如果要获取三个displayName节点中第二个节点，可以通过{X,Y}
　　http://192.168.6.224:8080/job/pythontest/api/json?pretty=true&tree=builds[displayName]{1,2}

　　如果要获取两个相关的节点，通过,连接两个过滤节点
　　http://192.168.6.224:8080/job/pythontest/api/json?pretty=true&tree=builds

,url

　　这样就可以获取build和url的信息

　　
　　
　　JOB API--执行Build:
　　1 直接执行，不包括参数
　　此时暂时删除pytest的参数,使它可以直接执行
　　那么执行build的API地址就是
　　http://192.168.6.224:8080/job/pythontest/build
　　请求方法为POST，通过post man发送这个请求
　　会发现请求失败，返回"Authentication required"

　　此提示信息说明执行job的时候需要身份认证，可以通过postman的"Authorization"，选择“Basic Auth”， 再输入登录jeknins，可以有权限
　　执行job的用户名和密码

　　此时再次提交,Job执行成功
　　2 包括参数执行
　　仍然是用pytest这个job，只是添加了参数test(一个字符串的参数)
　　带参数执行的API地址，请求仍然是POST
　　http://192.168.6.224:8080/job/pythontest/buildWithParameters
　　仍然需要认证，参数可以设置为test="testonly"

　　此时提交job执行成功

　　JOB API--获取和更新描述信息:
　　通过API可以获取和更新JOB的description的信息
　　1.获取Description信息
　　API地址:http://192.168.6.224:8080/job/pythontest/description
　　（pythontest是job name)
　　请求方法"GET"，不需要认证

　　2 更新Description信息
　　更新description的时候，API地址还是
　　http://192.168.6.224:8080/job/pythontest/description(pythontest是jobname)
　　只是请求方法为POST,添加一个参数 description，填写要更新的description的内容
　　同样需要身份验证

　　
　　JOB API--禁用和启动Job:
　　1 禁用job
　　要禁用某一个job API地址 http://192.168.6.224:8080/job/pythontest/disable
　　(pythontest是job name)
　　请求方法是POST

　　执行成功，在jenkins中查看job ,此时已禁用

　　2 启用Job
　　之前的job,pythntest已经禁用，要重新启用这个job
　　API地址 http://192.168.6.224:8080/job/pythontest/enable（pythontest是job name)
　　请求方法是POST，执行后，job变成正常状态
　　
　　JOB API--删除JOB:
　　要删除一个job，仍然可以通过API
　　地址  http://192.168.6.224:8080/job/pythontest/doDelete (pythntest是job name)
　　请求方法是post，需要认证
　　
　　
　　JOB API--JOB conofig.xml:
　　JOB的配置信息，通过地址 http://192.168.6.224:8080/job/pythontest/config.xml( pythntest是job name)
　　获取到的是一个xml的格式，这个里面包括了详细的配置信息，同样的地址通过post可以更新配置
　　主要是后面用这个config.xml可以用来创建job

　　
　　
　　
　　
　　站点 API:
　　站点所有相关的API，都是可以从地址http://192.168.6.224:8080/api  中查询到，同样可以查询job的相关信息等
　　但不同的是，还可以创建Job,拷贝Job，停止或重启Jenkis的服务
　　通过 http://192.168.6.224:8080/api/json?pretty=true （JSON)  可以查询到站点中所有的job信息

　　同样的XML地址是 http://192.168.6.224:8080/api/xml
　　查询同样支持，通过tree进行过滤
　　如通过 http://192.168.6.224:8080/api/json?pretty=true&tree=jobs[name

]
　　可以过滤出所有jobs的name

　　
　　站点API_创建Job
　　要创建一个Job，首先要明白每个Job的配置信息都保存在config.xml中，如之前我们已经创建的job pythontest，通过访问地址
　　http://192.168.6.224:8080/job/pythontest/config.xml
　　就可以获得job相关的详细配置信息，当然需要先登录
　　config.xml的配置信息如下,这个里面包括了job的配置，包括名称，命令等

　　要创建一个新的Job，可以参考或复制这个config.xml文件
　　创建Job的API地址是http://192.168.6.224:8080/createItem
　　假设我们要新创建一个job,叫 “testjob”
　　那么第一步，要在Jenkins的安装目录下，找到子目录\jobs，然后在其中创建一个目录 ，就叫testjob
　　如果不创建这个目录，直接调用API，是会失败的

　　然后准备config.xml文件，作为job的配置信息，可以从刚才的pythontest的配置直接拷贝得到，然后简单修改下name
　　举例通过Postman进行，访问的API地址，请求方法为POST，需要身份验证
　　http://192.168.6.224:8080/createItem?name=testjob
　　地址后面的name就是要创建的job的name
　　在Header中创建 Content-Type，值为application/xml
　　请求的Boy中类型选择为binary
　　然后选择刚才准备的config.xml文件

　　此时调用，这个接口，Job可以创建成功
　　站点API_拷贝Job
　　要通过API拷贝一个已存在的Job,需要访问的API地址仍然是，请求还是POST
　　http://192.168.6.224:8080/createItem
　　再需要添加三个参数
　　分别是   name (复制后新创建的的job name,如pythontest2
　　mode(模式，固定给予值copy)
　　from( 要复制的Job的Job name,如pythontest)

　　
　　站点API_重启
　　通过API地址 http://192.168.6.224:8080/restart
　　可以重启Jenkins
　　通过API地址 http://192.168.6.224:8080/safeRestart
　　可以安全重启Jenkins
　　
　　
　　
　　参考文档:
　　1   https://wiki.jenkins.io/display/JENKINS/Remote+access+API
　　2   获取Jenkins project build结果 http://blog.csdn.net/ljj_9/article/details/70270977