任务控制REST API

概述

任务控制中心公开了一个丰富的REST API，允许对注册的JFrog平台进行完全自动化的管理部署(詹妮弗)。

这提供了一个方便且最新的自描述API，各种工具都可以使用它来自动化管理和配置操作。

基URL

任务控制REST URL由以下组成:

:<路由器端口>/<服务上下文>/api/<版本> .

例如，V1API:

http://SERVER_HOSTNAME:8082/mc/api/v1 #或在您的本地机器上:http://localhost:8082/mc/api/v1

例如，V3API:

http://SERVER_HOSTNAME:8082/mc/api/v3 #或在您的本地机器上:http://localhost:8082/mc/api/v3

一个uthentication

任务控制的REST API支持认证类型:

类型

描述

访问令牌

用户必须在授权头中使用访问令牌作为承载令牌。

使用承载令牌进行身份验证的示例:

创建用于MC的访问令牌:

curl -X POST -d 'username=' -d 'scope=applied-permissions/user' -d 'audience=jfmc@*' -d 'expires_in=3600' -d 'grant_type=client_credentials' http://localhost:8082/access/api/v1/oauth/token -H '授权:holder '

运行

curl http://localhost:8082/mc/api/v1/jpds -H '授权:承载<令牌>'

使用

任务控制REST API可以以REST API的任何标准方式调用。下面以cURL为例介绍如何使用Mission Control REST API。

使用和配置cURL

你可以下载旋度在这里。学习如何使用和配置旋度在这里。

—创建JPD

下面的示例演示如何调用create用户REST API。

你有任务控制在你当地的JPD运行
你想要创建另一个叫"美国西部"的警局
您创建了一个名为createjpd.json

要使用该文件注册这个新的JPD，您可以使用以下命令:

使用cURL和REST API

$ curl -X POST 'http://localhost:8082/mc/api/v1/jpds' -H '授权:持有者' -H '内容类型:应用程序/json;charset=UTF-8' -T createjpd.json

文件createsite。Json将包含以下内容:

{" name ":“于”、“url”:“http://somehost”,“令牌”:“xxx”,“位置”:{“城市”:“森尼维耳市”,“country_code”:“我们”,“纬度”:37.368830,经度:-122.036350}}

页面内容

阅读更多

系统

系统健康检查

描述:获取任务控制是否正在运行的指示。无需身份验证。
自:4.0
用法:GET / api / v1 /系统/平
例子:

GET /api/v1/system/ping OK

代理(弃用)

创建代理(弃用)

描述:添加代理。
自:3.2
安全:需要管理员用户
用法:POST / api / v3 /代理

消耗:application / json

例子:

POST /api/v3/ proxy HTTP/1.1 {"name": "proxy-01"， "url": "http://proxyurl:8080"， "sites": [{"source_site": "source-Site"， "destination_site": "destination-Site"}]， "username": "username"， "password": "password"}

例子:

$ curl 'http://localhost:8080/api/v3/proxies' -i -u 'admin:password' -X POST -H 'Content-Type: application/json;charset=UTF-8' -d '{"name": "proxy-01"， "url": "http://proxyurl:8080"， "sites": [{"source_site": "source-Site"， "destination_site": "destination-Site"}]， "username": "username"， "password": "password"}

创建外部代理(弃用)

描述:添加外部代理。
自:3.2
安全:需要管理员用户
用法:POST / api / v3 /代理
消耗:application / json

例子:

POST /api/v3/ proxy HTTP/1.1 {"name": "proxy-01"， "url": "http://proxyurl:8080"， "sites": [{"source_site": "source-Site"}]， "username": "username"， "password": "password"}

按名称更新代理(已弃用)

描述:更新代理。
自:3.2
安全:需要管理员用户
用法:POST / api / v3 /代理/{名称}
消耗:application / json

例子:

PUT /api/v3/ agents /proxy-01 HTTP/1.1 {"name": "proxy-01-1"， "url": "http://a53dacff-7d2a-4991-bea0-231abe891e52:8080"， "sites": [{"source_site": "source-Site2"， "destination_site": "destination-Site2"}]， "username": "username1"， "password": "password1"}

获取代理列表(已弃用)

描述:获取代理列表。
自:3.2
安全:需要管理员用户
用法:Get / api / v3 /代理
消耗:application / json

例子:

GET /api/v3/ proxy HTTP/1.1 [{"name": "proxy-01"， "url": "http://ff121cae-f1f1-4639-85ff-cb07c744c730"， "sites": [{"source_site": "source-site-name"， "destination_site": "destination-site-name"}]}， {"name": "proxy-02"， "url": "http://14dc60cb-e3c2-476f-b4a6-263adf70a34d"， "sites": [{"source_site": "source-site-name"}]}]

命令行:

$ curl 'http://localhost:8080/api/v3/proxies' -i -u 'admin:密码' -H '内容类型:应用程序/json;charset = utf - 8 '

获取源服务过滤的代理列表(已弃用)

描述:按源服务获取代理列表。
自:3.2
安全:需要管理员用户
用法:/ api / v3 /代理吗?年代rc_service={service_name}
消耗:application / json

例子:

/ api / v3 /代理吗?年代rc_service=artifactory HTTP/1.1 [ { "name" : "proxy-01", "url" : "http://cfc3cf06-18b2-414c-a3e7-12dfd593201d", "sites" : [ { "source_site" : "source-site-name", "destination_site" : "destination-site-name" } ] } ]

获取目标服务过滤的代理列表(已弃用)

描述:获取按目标服务筛选的代理列表。
自:3.2
安全:需要管理员用户
用法:/ api / v3 /代理吗?dest_service = {destination_service_name}
消耗:application / json

例子:

/ api / v3 /代理吗?dest_service=artifactory HTTP/1.1 [{"name": "proxy-01"， "url": "http://609c68a0-9e8c-4104-adac-0623914c85bf"， "sites": [{"source_site": "source-site-name"， "destination_site": "destination-site-name"}]}]

获取按源和目标服务筛选的代理列表(已弃用)

描述:按源服务获取代理列表。
自:3.2
安全:需要管理员用户
用法:/ api / v3 /代理吗?年代rc_service={source_service_name}&dest_service={destination_service_name}
消耗:application / json

例子:

/ api / v3 /代理吗?年代rc_service=source-artifactory&dest_service=destination [ { "name" : "proxy-01", "url" : "http://609c68a0-9e8c-4104-adac-0623914c85bf", "sites" : [ { "source_site" : "source-site-name", "destination_site" : "destination-site-name" } ] } ]

按名称获取代理(已弃用)

描述:按名字找一个代理。
自:3.2
安全:需要管理员用户
用法:GET / api / v3 /代理/{名称}
消耗:application / json

例子:

GET /api/v3/ agents /proxy-01 HTTP/1.1 {"name": "proxy-01"， "url": "http://0277a02d-5267-46c9-a5c9-7836f0bff8fb"， "sites": [{"source_site": "source-Site"， "destination_site": "destination-Site"}]}

按名称删除代理(已弃用)

描述:从任务控制中移除代理。
自:3.2
安全:需要管理员用户
用法:删除/ api / v3 /代理/{名称}
消耗:application / json

例子:

删除/api/v3/ proxy /proxy-01 HTTP/1.1

网站(弃用)

这些是配置站点时的相关字段:

场	类型	可选	描述
名字	字符串	假	网站的名称
描述	字符串	真正的	网站的描述
城市	对象	假	网站的城市
city.name	字符串	真正的	城市的名字
city.country_code	字符串	真正的	城市国家代码
city.longitude	数量	假	城市的经度
city.latitude	数量	假	城市的纬度
服务	数组	真正的	服务名称

创建站点(已弃用)

描述:创建一个新站点。
注:这个API是弃用从版本4.x开始。
自:2．0
安全:需要管理员用户
用法:POST / api / v3 /网站

返回代码:

201 -无内容
400 -无法找到具有以下名称的服务:，'<服务名称>'，'<服务名称>'

409 -名称' <网站名称>已经存在。
消耗:application / json

{"name": "<站点名称>"，"description": "<站点名称>"，"city": {"name": "<城市名称>"，"country_code": "<国家代码>"，"latitude": <城市纬度坐标>，"longitude": <城市高度坐标>}，"services":["<服务名称>"]}

例子:
在本例中，创建了一个新的Sunnyvale站点，服务“art -west”和“xray-west”与新站点相关联。如果服务存在，201年创建将被返回。

$ curl 'http://localhost:8080/api/v3/sites' -i -u 'admin:password' -X POST -H 'Content-Type: application/json;charset=UTF-8' -T createsite.json

createsite.json

{"name": "US - West "， "description": "US West coast site"， "city": {"name": "Sunnyvale"， "country_code": "US"， "latitude": 37.368830， "longitude": -122.036350}， "services": ["art - West "， "xray-west"]}

更新站点(已弃用)

描述:按名称更新当前站点。
注:这个API是弃用从版本4.x开始。
自:2．0
安全:需要admin用户
使用: PUT /api/v3/sites/{name}

返回代码:

204 -无内容
409 -没有找到标识符“”的实体“Site”
消耗:application / json

{"name": "<更新站点名称>"，"description": "<更新站点描述>"，"city": {"name": "<更新城市名称>"，"country_code": "<更新国家代码>"，"latitude": <更新城市纬度坐标>，"longitude": <更新城市纬度坐标>}，"services": [{"name": "<服务名称>"，"type": ""}]}

例子：

在本例中，使用适当的属性将名为Argentina的现有站点更新为Mexico Data Center。如果“阿根廷”这个网站存在，204无内容将被退回

$ curl -XPUT 'http://localhost:8080/api/v3/sites/Argentina' -i -u 'admin:密码' -H '内容类型:应用程序/json;charset=UTF-8' -T updatesite.json

updatesite.json

{"name": "Mexico Data Center"， "description": "Updated site description"， "city": {"name": "Mexico city"， "country_code": "MX"， "latitude": 19.428470， "longitude": -99.127660}}

按名称部分更新站点(已弃用)

描述:更新站点不需要更新属性．
注:这个API是弃用从版本4.x开始。
自:2.1
安全:需要管理员用户
用法:把/ api / v3 /服务/{名称}

返回代码:

204 -无内容
消耗:application / json

补丁/ api / v3 /网站/{名称}

例子:

PATCH /api/v3/sites/Site%20name HTTP/1.1 Content-Type: application/json;charset=UTF-8 Host: localhost:8080 Content- length: 119 {"name": "更新后的站点名称"，"description": "更新后的站点描述"，"services": ["Artifactory name"]} HTTP/1.1 204无内容

例子:

$ curl 'http://localhost:8080/api/v3/sites/Site%20name' -i -u 'admin:password' -X PATCH -H 'Content-Type: application/json;charset=UTF-8' -d '{"name": "更新的站点名称"，"description": "更新的站点描述"，"services": ["Artifactory name"]}'

获取站点(已弃用)

描述:按名称获取站点

注:这个API是弃用从版本4.x开始。
自:2．0
安全:需要管理员用户
用法:GET / api / v3 /网站/{名称}

返回代码:

200 -成功
409 -实体“站点”与标识符“{name}”不被发现”
生产:application / json

{"name": "<站点名称>"，"description": "<站点名称>"，"city": {"name": "<城市名称>"，"country_code": "CODE"， "latitude": <城市纬度坐标>，"longitude": <城市高度坐标>}，"services": [{"name": "<服务名称>"，"type": ""}]}

例子:

在本例中，正在检索有关名为“中国”的站点的信息。如果网站“中国”存在200年成功将被退回

$ curl -XGET 'http://localhost:8080/api/v3/sites/China' -uadmin:密码

示例输出

{"name": "北京"，"description": "北京数据中心"，"city": {"name": "北京"，"country_code": "CN"， "latitude": 39.907500， "longitude": 116.397230}， "services": [{"name": " artin - Beijing"， "type": "ARTIFACTORY"}]} 200成功

获取站点列表(已弃用)

描述:获取所有站点的列表
注:这个API是弃用从版本4.x开始。
自:2．0
安全:需要管理员用户
用法:GET / api / v3 /网站/

返回代码:

200 -成功
409 -没有找到标识符“”的实体“Site”
生产:application / json

[{"name": "<站点名称>"，"description": "<站点名称>"，"city": {"name": "<城市名称>"，"country_code": "CODE"， "latitude": <城市纬度坐标>，"longitude": <城市高度坐标>}，"services": [{"name": "<服务名称>"，"type": ""}]}]

例子:

$ curl -XGET 'http://localhost:8080/api/v3/sites' -uadmin:密码

示例输出

[{"name": "China"， "description": "" city": {"name": "Shanghai"， "country_code": "CN"， "latitude": 31.22222， "longitude": 121.45806}， "services": [{"name": "China"， "type": "ARTIFACTORY"}]}， {"name": "Argentina"， "description": "AR"， "latitude": -34.61315， "longitude": -58.37723}， "services": [{"name": "Source Local"， "type": "ARTIFACTORY"}]}] 200成功

删除站点(已弃用)

描述: 删除站点

注: 这个API是弃用从版本4.x开始。
自:2．0
安全:需要管理员用户
用法:删除/ api / v3 /网站/{名称}
返回代码:

200 -成功
409 -不能删除站点{name}，它有非空服务:{服务名}

例子:

$ curl -XDELETE 'http://localhost:8080/api/v3/sites/China' -uadmin:密码-H "内容类型:应用程序/json"

服务(弃用)

创建服务(已弃用)

描述:创建一个新服务。

注:这个API是弃用从版本4.x开始。
自: 2.0.在3.2中更新，增加了属性

安全:需要管理员用户

用法:POST / api / v3 /服务

返回代码:

201 -创建
409 -日志含义连接服务失败。请核实所提供的服务信息是否正确
消耗:application / json

{"name": "<服务名称>"，"description": "<服务描述>"，"url": "<服务url >"， "username": "<服务管理员用户名>"，"password": "<服务管理员密码>"，"type": "" "site_name": "<站点名称">，"auth_token": "<服务的认证令牌，而不是使用用户名/密码>"，"pair_with_auth_provider": ""， "auth_provider": ""}

例子:

$ curl 'http://localhost:8080/api/v3/services' -i -u 'admin:password' -X POST -H 'Content-Type: application/json;charset=UTF-8' -T createservice.json

createservice.json

{"name": "dev-west"， "description": "Artifactory服务西部开发"，"url": "https://artifactory-west.acme.com/artifactory"， "username": "admin"， "password": "password"， "type": "Artifactory "} 201已创建

更新服务(已弃用)

描述: 更新服务
注:这个API是弃用从版本4.x开始。

自:2．0
安全:需要管理员用户
用法:把/ api / v3 /服务/{名称}

返回代码:

204 -无内容
409 - Url 已经存在
消耗:application / json

{"name": "<服务名称>"，"description": "<服务描述>"，"url": "<服务url >"， "username": "<服务管理员用户名>"，"password": "<服务管理员密码>"}

例子:

$ curl 'http://localhost:8080/api/v3/services/dev-west' -i -u 'admin:password' -X PUT -H 'Content-Type: application/json;charset=UTF-8' -T updateservice.json

updateservice.json

{"name": "dev-east"， "description": "Artifactory service in East region"， "url": "https://artifactory-east.acme.com/artifactory"， "username": "admin"， "password": "password"} 204无内容

获取服务列表(已弃用)

描述:获取所有服务的列表
注:这个API是弃用从版本4.x开始。
自:2．0

安全:需要管理员用户
用法:GET / api / v3 /服务/
生产:application / json

例子:

$ curl -XGET 'http://localhost:8080/api/v3/services' -uadmin:密码

示例输出

[{"name": "阿根廷"，"description": "Artifactory服务于阿根廷发展"，"url": "http://10.0.0.8:8082/artifactory"， "type": "Artifactory "， "service_type": "jfrt"， "service_id": "jfrt@01ccgfzxdyqd3y0d816fns0zhh"， "site": {"city": {"country_code": "AR"， "latitude": -34.61315， "longitude": -58.37723， "name": "Buenos Aires"}， "description": "" name": "Argentina"}}， {"name": "China"， "description": "Artifactory服务于中国发展"，"url":"http://10.0.0.8:8081/artifactory"， "type": "ARTIFACTORY"， "service_type": "jfrt"， "service_id": "jfrt@01cdmdjarccxy009wnzmwf06jp"， "site": {"city": {"country_code": "CN"， "latitude": 31.22222， "longitude": 121.45806， "name": "Shanghai"}， "description": "" name": "China"}}] 200成功

根据源获取带有代理的服务列表(已弃用)

描述: 获取任务控制通过代理管理的服务的列表
注: 这个API是弃用从版本4.x开始。
自:3.2
安全:需要管理员用户
用法:GET请求/api/v3/services?年代ource=SourceConsumes: application/json

例子:

GET / api / v3 /服务?年代ource=Source%20Artifactory%20Name HTTP/1.1 [ { "name" : "Source Artifactory Name", "url" : "http://Source Artifactory Name.com/artifactory", "type" : "ARTIFACTORY", "service_type" : "jfrt", "service_id" : "jfrt@01crqghgxara0b0ej8nct10dyd", "site" : { "name" : "Source Site Name", "description" : "59551ac7-d8a3-426d-90a7-730219f11ddc", "city" : { "name" : "73955951-ef5c-4864-a118-561b117fdb7c", "latitude" : 66.778899, "longitude" : 44.556644 } } }, { "name" : "Destination Artifactory Name", "url" : "http://Destination Artifactory Name.com/artifactory", "type" : "ARTIFACTORY", "service_type" : "jfrt", "service_id" : "jfrt@01crqghgxf30e91k6gascc1r7p", "site" : { "name" : "Destination Site Name", "description" : "06dce948-ef85-45d6-b600-c2dc8ca57a63", "city" : { "name" : "c64f2329-2021-49ec-9188-cea1840f9df6", "latitude" : 66.778899, "longitude" : 44.556644 } }, "proxy" : { "url" : "http://proxy.com" } } ]

使用基于源的代理按名称获取服务(已弃用)

描述:通过代理获得由任务控制中心管理的名称服务。

注:这个API是弃用从版本4.x开始。
自:3.2
安全:需要管理员用户
用法:GET / api / v3 /服务/{名称}

例子:

GET / api / v3 /服务/ jfrt % 4001 crqgh6fyxtpn1eyddfwa1hk1 ?年代ource=Source%20Artifactory%20Name { "name" : "Destination Artifactory Name", "url" : "http://Destination Artifactory Name.com/artifactory", "type" : "ARTIFACTORY", "service_type" : "jfrt", "service_id" : "jfrt@01crqgh6fyxtpn1eyddfwa1hk1", "site" : { "name" : "Destination Site Name", "description" : "31c51fe9-dfa0-48d4-8ce7-675e2b6b1b43", "city" : { "name" : "28759984-cf1a-41bc-952c-33e4e3a7c4a0", "latitude" : 66.778899, "longitude" : 44.556644 } }, "proxy" : { "url" : "http://proxy.com" } }

删除服务(已弃用)

描述:删除服务
注:这个API是弃用从版本4.x开始。
自:2．0
安全:需要管理员用户
用法:删除/ api / v3 /服务/ {name}
返回代码:

200 -成功

例子:

$ curl -XDELETE 'http://localhost:8080/api/v3/services/Argentina' -uadmin:密码-H "内容类型:应用程序/json"

获取存储库列表(已弃用)

描述:获取指定Artifactory服务中的存储库列表

注: 这个API是弃用从版本4.x开始。
自:2．0

安全:需要管理员用户

用法:得到api / v3 /服务/ artifactory /{名称}/存储库

返回代码:

200 -成功

无法找到名称<服务名称>的Artifactory实例
消耗:application / json

例子:

$ curl -XGET 'http://localhost:8080/api/v3/services/artifactory/{name}/repositories' -uadmin:密码

示例输出

[{"repository_key": "bower-local"， "description": ""， "type": "local"， "package_type": "bower"}， {"repository_key": "generic-local"， "description": "" type": "package_type": "generic"}， {"repository_key": "lib -release-local"， "description": "" type": "local"， "package_type": "maven"}，…{“repository_key”:“npm”、“描述”:“”,“类型”:“虚拟”,“package_type”:“npm”}]

詹妮弗

添加詹妮弗

描述:增加一个新的JPD任务控制。

自:4.0

安全:需要管理员用户

用法:帖子/ mc / api / v1 /詹妮弗年代

返回代码:

201 -创建
400 -日志含义连接JPD失败。请核实所提供的JPD信息是否正确
409 -与现有的JPD (URL，名称)冲突

消耗:application / json

{“名称”:“<詹妮弗名称>”,“url”:“<詹妮弗url >”,“令牌”:“<连接键>”,“位置”:{“city_name”:“<城市名称>”,“country_code”:“<国家代码>”,“纬度”:< >纬度,经度:<经度>},“标签”:(“< 0 >标签”,“< 1 >标签”)}

例子:

$ curl -X POST 'http://localhost:8082/mc/api/v1/jpds' -H '授权:持有者' -H '内容类型:应用程序/json;charset=UTF-8' -T create_JPD.json

create_JPD.json

{"name": "dev-west"， "url": "https://artifactory-west.acme.com"， "token": "<加入token>"， "location": {"city_name": "San Francisco"， "country_code": "US"， "latitude": 37.7749， "longitude": 122.4194}， "tags": ["prod"， "dev"]} 201已创建

更新詹妮弗

描述:更新JPD

自:4.0

安全:需要管理员用户

用法:把/ mc / api / v1 /詹妮弗/ {id}

返回代码:

204 -无内容
400 -日志含义连接JPD失败。请核实所提供的JPD信息是否正确
409 -与现有的JPD (URL，名称)冲突

消耗:application / json

{“名称”:“<詹妮弗名称>”,“url”:“<詹妮弗url >”,“令牌”:“<连接键>”,“位置”:{“city_name”:“<城市名称>”,“country_code”:“<国家代码>”,“纬度”:< >纬度,经度:<经度>},“标签”:(“< 0 >标签”,“< 1 >标签”)}

例子:

$ curl -X PUT 'http://localhost:8082/api/v1/jpds/JPD-3' -H '授权:持有人<令牌>' -H '内容类型:应用程序/json;charset=UTF-8' -T update_JPD.json

update_JPD.json

{" name ": " new_name”、“url”:“http://new-jpd-url: 8080 /詹妮弗。{"city_name": "Toulouse"， "country_code": "FR"， "latitude": 43.6043， "longitude": 1.4437}}

获取JPD名单

描述:获得所有JPDs的列表，可选过滤根据标签，名称，url或状态。这些过滤器可以包含通配符*。

自:4.0

安全:需要管理员用户

用法:GET / mc / api / v1 /詹妮弗(?名字=&tag=&url=&status=

生产:application / json

例子:

$ curl -X GET 'http://localhost:8082/mc/api/v1/jpds' -H '授权:持有者<令牌>'

示例输出

[{"id": "JPD-1"， "licenses": [{"expired": false， "license_hash": "2c2ef96d8a90ea2bb91287258dc8ab72a6b0f749"， "licensed_to": "www.si-fil.com"， "type": "ENTERPRISE_PLUS_TRIAL"， "valid_through": "2020-02-14"}]， "location": {"city_name": "Nuuk"， "country_code": "GL"， "latitude": 64.18347， "longitude": -51.72157}， "name": "HOME"， "services": [{"status": {"code": "ONLINE"}， "type": "JFMC"}]， "status": {"code": "ONLINE"}， "type": "JFMC"}]， "status": {"code": "ONLINE"}， "message": "message":“所有服务在线”、“警告 ": [] }, " 标签:[],“url”:“http://jpd。local/"}] 200成功

通过id找到警局

描述:根据id获取一个JPD

自:4.0

安全:需要管理员用户

用法:GET请求到/mc/api/v1/jpds/

消耗:application / json

例子:

$ curl -X GET 'http://localhost:8082/mc/api/v1/jpds/JPD-1' -H '授权:持有者<令牌>'

{"id": " jjp -1"， "license ": [{"expired": false， "license_hash": "2c2ef96d8a90ea2bb91287258dc8ab72a6b0f749"， "licensed_to": "www.si-fil.com"， "type": "ENTERPRISE_PLUS_TRIAL"， "valid_through": "2020-02-14"}]， "location": {"city_name": "Nuuk"， "country_code": "GL"， "latitude": 64.18347， "longitude": -51.72157}， "name": "HOME"， "services": [{"status": {"code": "ONLINE"}， "type": "JFMC"}]， "status": {"code": "ONLINE"}， "type": "JFMC"}]， "status": {"code": "ONLINE"}， "message": "message":“所有服务在线”、“警告 ": [] }, " 标签:[],“url”:“http://jpd。local/"} 200成功

删除詹妮弗

描述:从任务控制中心移除一个JPD

自:4.0

安全:需要管理员用户

用法:删除/ mc / api / v1 /詹妮弗/ {id}

返回代码:

200 -成功
204 -无内容
404 -未找到

例子:

$ curl -X DELETE 'http://localhost:8082/mc/api/v1/jpds/JPD-321' -H '授权:持有者<令牌>'

访问联合会

获取单个JPD的Access Federation配置

描述:获取特定JPD的访问联合配置。返回为所提供的JPD配置的Federation目标。

自:4.0

安全:需要管理员用户

用法:GET /mc/api/v1/federation/{JPD ID}

返回代码:

200 -成功
400 - JPD不是一个有效的接入联盟候选人。
404 -未找到JPD。
消耗:application / json

请求示例:

$ curl -X GET 'http://localhost:8082/mc/api/v1/mc/api/v1/federation/JPD-1' -H '授权:持有者<令牌>'

反应的例子:

{“实体”:“团体”,“用户”,“目标”:[{“名称”:“JFP-2”、“代码”:“access2JPDId”、“url”:“http://localhost: 37837 /访问”}]}

获取所有jpd的联邦访问配置

描述:获取所有jpd的访问联合配置。

自:4.0

安全:需要管理员用户

用法:GET / mc / api / v1 /詹妮弗/联盟吗?includeNonConfiguredJPDs = false

返回代码:

200 -成功

生产:application / json

请求示例:

$ curl -X GET 'http://localhost:8082/mc/api/v1/mc/api/v1/federation?include_non_configured=false' -H '授权:持有者<令牌>'

反应的例子:

[{“源”:“artifactory1”,“实体”:“团体”,“用户”,“目标”:[{“名称”:“JPD-2”、“代码”:“access2JPDId”、“url”:“url2”}]}]

在JPD上配置Access Federation

描述:为特定的JPD配置访问联合。作为先决条件，必须为基于的Access Federation正确配置了源和目标这．
自:4.0
安全:需要管理员用户
用法:PUT /mc/api/v1/jpds/{JPD ID}/federation

返回代码:

200 -成功
400,422 -无效输入
404 - JPD没有找到或没有一个Artifactory

示例请求:

curl -X PUT 'http://localhost:8082/mc/api/v1/mc/api/v1/federation/JPD-12' -H '授权:承载<令牌>' -H '内容类型:应用程序/json;charset=UTF-8' -d '{"entities": ["USERS"， "GROUPS"]， "targets": [{"name": "artifactory2"， "url": "http://localhost:8080/access"}]}'

示例响应:

[{"label": "获取artifactory1配置"，"status": "OK"}， {"label": "从artifactory1获取访问令牌"，"status": "OK"}， {"label": "检查artifactory2是否信任artifactory1"， "status": "OK"}， {"label": "向artifactory1发送配置"，"status": "OK"}， {"label": "将目标artifactory2添加到artifactory1"， "status": "OK"}]

获取联盟候选人

描述:获取Access Federation候选人。
自:4.0
安全:需要管理员用户
用法:GET / mc / api / v1 /联盟的候选人

返回代码:
200 -成功

请求示例:

curl -X GET 'http://localhost:8082/mc/api/v1/mc/api/v1/federation/candidates' -H '授权:承载<令牌>'

反应的例子:

[" JPD-12”、“JPD-13”)

创建网格

描述:创建网格拓扑。作为先决条件，必须为基于的Access Federation正确配置了源和目标这．

自:4.0
安全:需要管理员用户
用法:POST / mc / api / v1 /联合会/ create_mesh
返回代码:

200 -成功
400,422 -无效输入
404 - JPD没有找到或没有一个Artifactory

请求示例:

curl -X POST 'http://localhost:8082/mc/api/v1/federation/create_mesh -H '授权:承载' -H '内容类型:应用程序/json;utf - 8字符集=“- d”{“詹妮弗”:“JPD-12”、“JPD-13”,“实体”(“用户”,“团体”,“权限”,“令牌”]}”

反应的例子:

[{"label": "SUCCESSFUL"， "status": "OK"}]

监控(弃用)

获取服务状态(已弃用)

描述:获取所有服务的状态
注:这个API是弃用从版本4.x开始。
自: 2.0
使用GET /api/v3/services/monitoring/status
返回代码:

200 -成功

生产: application / json

[{"service_name": "<服务名称>"，"up_time_in_sec": <服务已启动时间(秒)>，"service_state": "< ONLINE | OFFLINE >"}]

例子：

$ curl -XGET 'http://localhost:8080/api/v3/services/monitoring/status' -uadmin:密码

示例输出

[{"service_name": "中国"，"up_time_in_sec": 29282， "service_state": "ONLINE"}， {"service_name": "阿根廷"，"up_time_in_sec": 131， "service_state": "ONLINE"}]

获取服务状态(已弃用)

描述:获取指定服务的状态
注:这个API是弃用从版本4.x开始。
自: 2.0
使用: GET /api/v3/services/{name}/monitoring/status
返回代码:

200 -成功
409 -无法找到服务名称<服务名称>
生产: application / json

{"service_name": "<服务名称>"，"up_time_in_sec": <服务已经启动的时间(秒)>，"service_state": "< ONLINE | OFFLINE >"}

例子:

$ curl -XGET 'http://localhost:8080/api/v3/services/China/monitoring/status' -uadmin:密码

示例输出

{"service_name": "China"， "up_time_in_sec": 46182， "service_state": "ONLINE"}

支持

创建支持包

描述:创建一个新的支持包。
自:4.0
安全:需要管理员用户
笔记:所有的捆绑项目都是可选的。
使用POST /mc/api/v1/system/support/bundle

返回代码:
202 -支持包正在创建中，将很快可用
400 -无效的选项值
403 -未经授权

示例使用：

POST /mc/api/v1/system/support/bundle HTTP/1.1 {"name": "My support bundle"， "description": " support bundle generated because issue XYZ"， "parameters": {"configuration": true， "system": true， "logs": {"include": true， "start_date": "2018-09-19"， "end_date": "2018-09-20"}， "thread_dump": {"count": 1， "interval": 0}}}}}

例子:

$ curl -X POST -H '授权:持有人<令牌>' https://my-mission-control.jfrogdev.co/api/v1/system/support/bundle -H '内容类型:应用程序/json' \ -d '{"name": "JFMC支持包"，"description": "支持包因XYZ问题而生成"，"parameters": {"configuration": true， "system": true， "thread_dump": {"count": 1， "interval": 0}， "logs": {"include": true， "start_date": "2018-12-25"， "end_date": "2019-01-07"}}}'

示例输出:

HTTP/1.1 202 Accepted Content-Type: application/json Server: task -control/SNAPSHOT Strict-Transport-Security: max-age=31536000;inclesubdomains Content-Length: 247 {"id": "SUPP20180912154413548991"， "artifactory": {"service_id": "jfrt@4754684682741"， "bundle_url": "http://artifactory.www.si-fil.com/artifactory/jfrog-support-bundle/SUPP20180912154413548991/jfmc/test_JPD}}

获取支持包列表

描述:获取可用支持包的列表。
自:4.0
安全:需要管理员用户
使用GET /mc/api/v1/system/support/bundles

返回代码:
200 -成功
403 -未经授权

例子:

GET /mc/api/v1/system/support/bundles HTTP/1.1

回应:

{“计数”:2,“包”:[{“名称”:“一”,“描述”:“aaa级”、“id”:“1”,“创建”:“2018 - 10 - 01 - t09:50:11z”},{“名称”:“B”、“id”:“2”,“创建”:“2018 - 10 - 01 - t09:50:11z”}]}

获取支持包的详细信息

描述:获取特定支持包的详细信息。
自:4.0
安全:需要管理员用户
使用GET /mc/api/v1/system/support/bundle/{id}

返回代码:
200 -成功
403 -未经授权
404 -提供的ID没有引用现有的支持包

例子:

GET /mc/api/v1/system/support/bundle/SUPP20180912154413548991 HTTP/1.1

回应:

{" name ": "问题# 1234”、“描述”:“支持包创建的问题# 1234调查”、“artifactory”:{“service_id”:“jfrt@4754684682741”、“bundle_url”:“http://artifactory.www.si-fil.com/artifactory/jfrog-admin-supportbundle/SUPP20180912154413548991/jfmc/01c7b8rg70nrqr1cck7k4x0yp7”},“参数”:{“配置”:真的,“系统”:真的,“日志”:{“包括”:真的,“start_date”:“2018-09-30”,“end_date”:“2018-10-01”},“thread_dump”:{“计数”:1、“间隔”:0}}， "available":5， "created": " 2018-10-01t9: 50:10z "}

下载支持包

描述:以ZIP文件的形式下载支持包。
自:4.0
安全:需要管理员用户。您需要在Artifactory上启用“下载文件夹”权限。
使用GET /mc/api/v1/system/support/bundle/{id}/archive

返回代码:
200 -成功
403 -未经授权(可能是“下载文件夹”选项没有在身份验证提供程序Artifactory上启用)
404 -提供的ID没有引用现有的支持包，或者在Authentication Provider Artifactory存储库中找不到ZIP

例子:

GET /mc/api/v1/system/support/bundle/SUPP20180912154413548991/archive HTTP/1.1

删除支持包

描述:删除一个支持包，以及Artifactory中的ZIP文件。
自:4.0
安全:需要管理员用户
使用DELETE /mc/api/v1/system/support/bundle/{id}

返回代码:
204 -成功
403 -未经授权
404 -提供的ID没有引用现有的支持包

例子:

DELETE /mc/api/v1/system/support/bundle/SUPP20180912154413548991 HTTP/1.1

创建平台支持包(已弃用)

描述:创建一个新的支持包。为几个JPDs创建支持包
自:4.0
安全:需要管理员用户
使用POST /mc/api/v1/platform/support/bundle

返回代码:

200 -支持包正在创建，将很快可用
422 - JPD列表空或太大
504 -超时
400 -无效请求

示例使用：

POST /mc/api/v1/system/support/bundle HTTP/1.1 {"name": "my_support_bundle"， "description": "平台支持bundle测试描述"，"services": ["self"， "jfrt@64845741457245711"]， "parameters": {"configuration": true， "system": true， "logs": {"include": true， "start_date": "2019-03-14"， "end_date": "2019-03-15"}， "thread_dump": {"count": 1， "interval": 0}}}}}

示例输出:

示例输出

200 OK Content-Type: application/json Server: task -control/SNAPSHOT Strict-Transport-Security: max-age=31536000;内容长度includeSubDomains: 487 {" id ":“20190315 - 1624 - cab48ff6 - 33 - e4 - 4 - e17 b2c9 - 845 a71ffa3a7”、“地点”:[{“service_id”:“jfrt@01d612nxv8yfcn119xsj7d1jrz”、“artifactory”:{“service_id”:“jfrt@other.www.si-fil.com”、“bundle_url”:“http://other.www.si-fil.com/artifactory /" } }, { " service_id”:“jfmc@01c7b8rg70nrqr1cck7k4x0yp7”、“artifactory”:{“service_id”:“jfrt@auth-provider.www.si-fil.com”、“bundle_url”:“http://auth-provider.www.si-fil.com/artifactory /" } } ] }

获取平台支持包列表(已弃用)

描述:获取先前创建的支持包的列表。
自:4.0
安全:需要管理员用户
使用GET /mc/api/v1/platform/support/bundles

返回代码:

200 -好的
400 -无效请求

示例使用：

GET /mc/api/v1/platform/support/bundles HTTP/1.1授权:Basic YWRtaW46cGFzc3dvcmQ= Content-Type: application/json;charset=UTF-8主机:localhost:8080

示例输出:

HTTP/1.1 200 OK Content-Type: application/json Server: task -control/SNAPSHOT Strict-Transport-Security: max-age=31536000;includeSubDomains Content-Length: 319 {"bundles": [{"id": "20190218-1554-c5043f76-4d6d-49e2-9ab7-2999b7af02ef"， "name": "sb-name"， "description": "sb-description"， "created": "20190218-1553-bb12b2e0-3b16-44aa-889a-513c14976542"， "created": "2019-02-18T15:53:00Z"}]， "count": 2}

获取平台支持包元数据(已弃用)

描述:获取先前创建的支持包的元数据。
自:3．5
安全:需要管理员用户
使用GET /mc/api/v1/system/support/bundle/{id}

返回代码:

200 -好的
400 -无效请求

示例使用：

GET /mc/api/v1/platform/support/bundle/20190218-1554-88722539-78af-41bc-a5d7-e7567fb7189f HTTP/1.1授权:承载xxx内容类型:应用/json;charset=UTF-8主机:localhost:8081

示例输出:

HTTP/1.1 200 OK Content-Type: application/json Server: task -control/SNAPSHOT Strict-Transport-Security: max-age=31536000;includeSubDomains内容长度:742 {" id ": " 20190218 - 1554 - 20190218 - 78 - af - 41 - bc - a5d7 e7567fb7189f”、“名称”:“sb-name”、“描述”:“sb-description”,“状态”:“成功”,“创建”:“2019 - 02 - 18 t15:54:00z”,“参数”:{“配置”:真的,“系统”:真的,“日志”:{“包括”:真的,“start_date”:“2019-03-14”,“end_date”:“2019-03-15”},“thread_dump”:{“计数”:1、“间隔”:0}},“地点”:[{“service_id”:“jfxr@2222”、“artifactory”:{“service_id”:“jfrt@jfxr”，“bundle_url”:“https://art。Jfxr "}}， {"service_id": "jfds@1111"， "artifactory": {"service_id": "jfrt@jfds"， "bundle_url": "https://arti "。Jfds "}}]}

获取平台支持包(弃用)

描述:以ZIP文件的形式下载先前创建的支持包。
自:4.0
安全:需要管理员用户
使用GET /mc/api/v1/platform/support/bundle/{id}/archive

返回代码:

200 -支持包zip将下载
400 -无效请求

示例使用：

GET /mc/api/v1/platform/support/bundle/20190218-1553-2ea5aa8c-0ee7-4981-9028-d19c653b423a/archive HTTP/1.1授权:Basic YWRtaW46cGFzc3dvcmQ= Content-Type: application/json;charset=UTF-8主机:localhost:8081

示例输出:

HTTP/1.1 200 OK内容处理:附件;filename="20190218-1553-2ea5aa8c-0ee7-4981-9028-d19c653b423 .zip" Content-Type: application/zip Server: task -control/SNAPSHOT Strict-Transport-Security: max-age=31536000;include esubdomains Content-Length: 28

删除平台支持包(弃用)

描述:删除之前创建的支持包，以及Artifactory中的ZIP文件。
自:4.0
安全:需要管理员用户
使用DELETE /mc/api/v1/platform/support/bundle/{id}

返回代码:

支持包成功删除
404 -支持包id未找到或无效
500 -支持无法删除

示例使用：

DELETE /mc/api/v1/platform/support/bundle/20190218-1554-7d3f4afa-a129-435e-822a-d19a052f9b4a HTTP/1.1授权:Basic YWRtaW46cGFzc3dvcmQ= Content-Type: application/json;charset=UTF-8主机:localhost:8081

示例输出:

HTTP/1.1 200 OK Content-Type: application/json Server: task -control/SNAPSHOT Strict-Transport-Security: max-age=31536000;inclesubdomains Content-Length: 110 {"deleted": ["jfmc@01c7b8rg70nrqr1cck7k4x0yp7"， "jfrt@01d612qkz4bjqt0e36d13s1ry5"]， "failures": []}

灾难恢复(已弃用)

创建容灾Pair(已弃用)

描述 :将Master和Target Artifactory服务匹配为容灾pair。
注: 这个API是弃用从版本4.x开始。
自:2．0
安全:需要admin用户
使用: POST /api/v3/dr-configs
消耗: application / json

{"source": "<源实例>"，"target": "<目标实例>"}

生产:application / json

{"active": "NONE"， "dr_replications_enabled": ， "state": "NONE"}

例子:

$ curl -X POST 'http://localhost:8080/api/v3/dr-configs' -i -u 'admin:密码' -H '内容类型:应用程序/json;charset=UTF-8' -T createdr.json

createdr.json

{"来源":"墨西哥"，"目标":"中国"}

示例返回:

示例返回

{"active": "NONE"， "dr_replications_enabled": false， "state": "NONE"}

脚本(弃用)

获取脚本(已废弃)

描述:获取所有脚本的列表
注:这个API是弃用从版本4.x开始。
自:2．0
安全:需要管理员用户
用法:得到/ api / v3 /脚本

返回代码:

200 -成功

生产:application / json

[{"name": "<脚本名>"}]

例子:

$ curl -XGET 'http://localhost:8080/api/v3/scripts' -uadmin:密码

[{"name": "Create_repository"}， {"name": "Delete_repository"}， {"name": "ldap"}， {"name": "Create_service"}] 200成功

获取脚本用户输入(已废弃)

描述:获取所需脚本用户输入的列表
注:这个API是弃用从版本4.x开始。
自:2．0
安全:需要管理员用户
用法:GET / api / v3 /脚本/{名称}/ user_inputs
返回代码:

200 -成功
404 -没有找到标识符“”的实体“Script”
生产:application / json
例子:

$ curl -XGET 'http://localhost:8080/api/v3/scripts/{name}/user_inputs' -uadmin:密码

示例输出

{"ArtifactoryDsl#0#LocalRepositoryDsl#0#description#0": {"name": "在这里输入所需的用户输入值"，"description": "请提供一个描述"，"value": "这是一个通用描述"，"type": "STRING"， "multivalue ": false}}

执行脚本(已弃用)

描述:在指定的服务上执行指定的脚本
注:这个API是弃用从版本4.x开始。
自:2．0
安全:需要管理员用户
用法:把/ api / v3 / execute_script /{名称}
返回代码:

200 -成功
404 -基于所提供输入的错误。
消耗:Application /json(仅当脚本需要用户输入时)
当脚本需要用户输入时，这是描述由返回的JSON对象获取脚本用户输入端点。
生产:application / json

[{"instance":{"name":"<实例名称>"，"url":"<实例url >"， "type":"<实例类型>"}，"status":"< OK | ERROR >"， "execution_duration":}]

如果出现错误，输出如下:

[{"instance":{"name":"<实例名称>"，"url":"<实例url >"， "type":"<实例类型>"}，"status":"ERROR"， ERROR:{"type":"<错误类型>"，"message":"<错误消息>"，"details":["<附加信息>"]，}，"execution_duration":<持续时间以秒为单位>}]

例子:

$ curl -uadmin:密码-XPUT http://localhost:8080/api/v3/execute_script/{Script_Name} -d '{}' -H '内容类型:应用程序/json'

示例输出

[{"instance":{"name":"Mexico"， "url":"http://172.31.61.159:8081/artifactory"， "type":"ARTIFACTORY"}， "status":"OK"， "execution_duration":1622， "operation":"UPDATE_REPOSITORY"}]

许可证桶

把水桶

描述:检索系统中所有的license桶。

自:4.0

安全:需要管理员用户

用法:得到/ mc / api / v1 /桶

返回代码:

200 -成功

生产:application / json

[{"identifier": "<桶id>"， "name": "<桶名>"，"size": <桶>中的license数量，"license_type": ""}]

示例用法:

GET /mc/api/v1/buckets [{"id": "12345"， "name": "bucket-test-1"， "size": 10， "license_type": "ENTERPRISE"}， {"id": "1234567"， "name": "bucket-test-2"， "size": 5， "license_type": "EDGE"}]

创建桶

描述:创建一个新的License Bucket。

自:4.0

安全:需要管理员用户

用法:POST / mc / api / v1 /桶

返回代码:

201 -创建
409 -名称“<桶名>”已经存在
409 - Url '<桶Url >'已经存在

消耗:application / json

{" name ":“< Bucket名称>”,“url”:“<桶url >”,“关键”:“<斗关键> "}

例子:

$ curl -X POST 'http://localhost:8082/mc/api/v1/buckets' -H '授权:持有者' -H '内容类型:应用程序/json;charset=UTF-8' -T createbucket.json

createbucket.json

{"name": "main-bucket"， "url": "https://bintray.www.si-fil.com/license-buckets/test_www.si-fil.com/12345678/12345678.json?expiry=1528199600307&id=ABCDEFGhiJkLmNoPQR"， "key": "16629dbf7fefc9d179b36ba005685c2dd8376aad3278178e735da1633c6bd3c6"}

201已创建{"subject": "JFrog"， "product_name": "Artifactory"， "product_id": 6， "license_type": "HA"， "issued_date": "2018-04-12T16:02:55.549+03:00"， "valid_date": "2019-04-12T16:02:54.759+03:00"， "quantity": 10， "signature": "06307c34405e6ab70c5d249a7ba7cffd81947d5f"， "name": "main-bucket"， "used":0， "url": "https://bintray.www.si-fil.com/license-buckets/test_www.si-fil.com/12345678/12345678.json?expiry=1528199600307&id=ABCDEFGhiJkLmNoPQR"}

上传桶

描述:上传并创建一个新的License Bucket。
自:4.0
安全:需要管理员用户
用法:POST / mc / api / v1 /桶
内容类型:多部分/格式

返回代码:

201 -创建
400 -您的bucket文件无法使用。请验证文件是否正确，密钥是否有效。
409 -名称“<桶名>”已经存在

消耗:application / json

name |任务控制文件中桶的名称。|桶文件的路径

生产:application / json

{"subject": "JFrog"， "product_name": "Artifactory"， "product_id": 6， "license_type": "HA"， "issued_date": "2016-04-12T16:02:55.549+03:00"， "valid_date": "2017-04-12T16:02:54.759+03:00"， "quantity": 10， "identifier": "bucket-test-1"， "signature": "06307c34405e6ab70c5d249a7ba7cffd81947d5f"， "name": "Test-bucket-name"， "used":0}

例子:

curl -X POST 'http://localhost:8082/mc/api/v1/buckets' -H '授权:holder ' -H 'Content-Type: multipart/form-data' -F 'file=@/tmp/728939433.json;type=application/octet-stream' -F 'key=d18fc5bc05dc3b6419ab6cd127f16cf6b57d7650ea0ef03cde130918f6f25487' -F 'name=mybucket'

删除桶

描述:删除桶。
自:4.0
安全:需要admin用户
用法:删除/ mc / api / v1 /桶/{名称}
返回代码:204 -成功

例子:

$ curl -X DELETE 'http://localhost:8082/mc/api/v1/buckets/main-bucket' -H '授权:holder ' -H "Content- type: application/json" 204无内容

获取桶状态

描述:获取指定桶的报告。
自:4.0
安全:需要管理员用户
用法:GET / api / v1 /桶/{标识符}/报告
生产:application / json

例子:

{"identifier": "<桶ID>"， "name": "<桶名>"，"size": "<桶中license总数>"，"valid_through": "<有效截止日期>"，"已发行":"<发行日期>"，"type": ""，"licenses": {"used": "<正在使用的license数量>"，"available": "<可用的license数量>"，"max_used": "有史以来同时使用的最大license数量>"}，"jpds": [{"name": ""，"license_count":"<此JPD使用的license数量>"}]，"split_buckets": [{"name": "<分裂桶名称>"，"identifier": "<分裂桶标识>"，"issued": "<发布日期>"，"license_count": "< license数量>"}]，"unknown_uses": [{"name": "<未知使用的空闲标签>"，"license_count": "<已使用的license数量>"}]，"pipelines": {"execution_nodes": "<管道>的执行节点数量"}}

返回代码:

200 -成功

例子:

$ curl -X GET 'http://localhost:8082/mc/api/v1/buckets/415921223/report' -i -H '授权:承载<令牌>'

示例输出

{"identifier": "266200796"， "name": "edge-bucket"， "size": 10， "valid_through": "2020-02-14T00:00:00.000Z"， "issued": "2019-02-14T14:27:29.584Z"， "type": "EDGE_TRIAL"， "licenses": {"used": 0， "available": 10， "max_used": 0}} 200成功

附加许可

描述:将桶中的license附加到指定的JPD。

自:4.0

安全:需要管理员用户

用法:POST / mc / api / v1 /桶/{名称}/部署

消耗:application / json

{"jpd_id": ""， "license_count": <上传到Artifactory的license数量>}

生产:application / json

返回代码:

200 -成功

400 - " id 的JPD未找到。"

500 -“无法从桶到部署许可证”

例子:

$ curl -X POST 'http://localhost:8082/mc/api/v1/buckets/{name}/deploy' -H '授权:持有者' -H '内容类型:应用程序/json;charset=UTF-8' -T attachlicense.json

attachlicense.json

{"jpd_id": "JPD-12"， "license_count": 1}

示例输出

{"success": true， "message": " assign 1 license from bucket bucket-test-1 to JPD-12."｝

获得许可证

描述:从一个桶中获取一个或多个许可证并返回。在bucket报告的“Unknown usage”部分下，这些许可证被标记为已使用。
自:4.0
安全:需要管理员用户
用法:POST / mc / api / v1 /桶/{名称}/收购
消耗:application / json

{"name": "<一个自由文本标签>"，"license_count": <获取>的许可证数量}

生产:application / json
返回代码:

200 -成功

404 - "标识符为'<不存在桶Id>'的实体'LicenseBucket'未找到。"

例子:

$ curl -X POST 'http://localhost:8082/mc/api/v1/buckets/{name}/acquire' -H '授权:持有者' -H '内容类型:应用程序/json;charset=UTF-8' -T acquirellicense .json

acquirelicense.json

{"name": "team-A-license"， "license_count": 1}

示例输出

{"license_keys": [""]}

安全(弃用)

获取证书(已弃用)

描述的列表安装SSL证书。
自: 3.5.0
安全:需要admin用户
使用:请求/ api / v3 / trust_store
生产：application / json
返回代码:

示例使用：

GET /api/v3/trust_store HTTP/1.1授权:Basic YWRtaW46cGFzc3dvcmQ= Content-Type: application/json;charset=UTF-8主机:localhost:8080

示例输出:

HTTP/1.1 200 OK Content-Type: application/json X-JFrog-Service-Id: jfmc@01c7b8rg70nrqr1cck7k4x0yp7 Server: task -control/SNAPSHOT Strict-Transport-Security: max-age=31536000;包括esubdomains Content-Length: 1614 [{"alias": "google.com"， "issued_by": "CN=谷歌Internet Authority G3, O=谷歌Trust Services, C=US"， "issued_to": "CN=*.google.com, O=谷歌LLC, L=山景，ST=California, C=US"， "issued_at": "2019-01-15T13:15:00Z"， "valid_until": "2019-04-09T13:15:00Z"， "fingerprint": "9F64B072B23B5AE8A069E6CC2E3353119EA6AAE0C92D4228AD70F06C5BA932D896251254BD2D5833ABB572EDDF29BF82B70B3979}， {"alias": "jfrog.info"， "issued_by": "CN=*.google.com, O=谷歌Trust Services, C=US"， "issued_to": "CN=*.google.com, O=谷歌Trust Services, C=US"， "issued_to"， "issued_at": "2019-04-09T13:15:00Z"， "valid_until": "2019-04-09T13:15:00Z"， "fingerprint": " 9f64b072b23b5ae8a069e6cc2e3353119ea6aae0c92d4228ad70f06c5ba932d896251254bd2d5833abb572eddf29bf82b70bby ":"CN=GeoTrust RSA CA 2018, OU=www.digicert.com, O=DigiCert Inc, C=US"， "issued_to": "CN=*.jfrog.info, O=JFrog LTD, L=Netanya, C=IL"， "issued_at": "2018-10-15T00:00:00Z"， "valid_until": "2019-07-03T12:00:00Z"， "fingerprint": "965CA066A55D0FCD55BA0EF8DF1C3DD509D91A5EED1EA5DA7EE79549F8A0BB55A59A8F1078F72AC1461C02D8C934786B2E85D9CE}]

获取证书(已弃用)

描述:返回单个安装SSL证书。
自: 3.5.0
安全:需要admin用户
使用:请求/ api / v3 / trust_store /{别名}
生产：application / json
返回代码:

示例使用：

GET /api/v3/trust_store/cert-alias HTTP/1.1授权:Basic YWRtaW46cGFzc3dvcmQ= Content-Type: application/json;charset=UTF-8主机:localhost:8080

示例输出:

HTTP/1.1 200 OK Content-Type: application/json X-JFrog-Service-Id: jfmc@01c7b8rg70nrqr1cck7k4x0yp7 Server: task -control/SNAPSHOT Strict-Transport-Security: max-age=31536000;inclesubdomains Content-Length: 795 {"alias": "cert-alias"， "issued_by": "CN=GeoTrust RSA CA 2018, OU=www.digicert.com, O=DigiCert Inc, C=US"， "issued_to": "CN=*.jfrog.info, O=JFrog LTD, L=Netanya, C=IL"， "issued_at": "2018-10-15T00:00:00Z"， "valid_until": "2019-07-03T12:00:00Z"， "fingerprint":“965 ca066a55d0fcd55ba0ef8df1c3dd509d91a5eed1ea5da7ee79549f8a0bb55a59a8f1078f72ac1461c02d8c934786b2e85d9ce01a037a40225a54b339608adf76ff9b7d26ddd885cf6b49230e5389b92738794c5b59fc1b27b3aed24bd4c99a6d571d91bf8f0f385644e44ccf23d5078c4931fc675fdcc2b220fececfb534c311cc192ff2832ebd9116ec7ae8598050678ef630f262452664aa6aaf39ad662ced60e50ac1f73cac555fcbd4d7a007e7681a865a4e03039e519058e927d6dd2cc037471394ff6c6d05bcf781534638ad7bce44702ea653763f258dfd697df9ac985f247be96dc70fc73372b22681f1a3d4d022cdb3cc216fa3F0FA242CFBA01 "}

添加证书(弃用)

描述:添加SSL证书。
自: 3.5.0
安全:需要admin用户
使用: POST请求到/api/v3/trust_store
消耗:多部分/格式
生产:application / json

示例使用：

POST /api/v3/trust_store HTTP/1.1授权:Basic YWRtaW46cGFzc3dvcmQ= Content-Type: multipart/form-data;border =6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm Host: localhost:8080—6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm Content-Disposition: form-data;name=public_key Content-Type: application/pkix-cert -----BEGIN CERTIFICATE----- << PEM format >> -----END CERTIFICATE----- --6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm Content-Disposition: form-data;name=alias内容类型:text/plain cert-alias——6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm——

示例输出:

HTTP/1.1 201 Created Content-Type: application/json X-JFrog-Service-Id: jfmc@01c7b8rg70nrqr1cck7k4x0yp7 Server: task -control/SNAPSHOT Strict-Transport-Security: max-age=31536000;inclesubdomains Content-Length: 795 {"alias": "cert-alias"， "issued_by": "CN=GeoTrust RSA CA 2018, OU=www.digicert.com, O=DigiCert Inc, C=US"， "issued_to": "CN=*.jfrog.info, O=JFrog LTD, L=Netanya, C=IL"， "issued_at": "2018-10-15T00:00:00Z"， "valid_until": "2019-07-03T12:00:00Z"， "fingerprint": "965CA066A55D0FCD55BA0EF8DF1C3DD509D91A5EED1EA5DA7EE79549F8A0BB55A59A8F1078F72AC1461C02D8C934786B2E85D9CE}

删除证书(弃用)

描述:删除SSL证书。
自: 3.5.0
安全:需要admin用户
使用删除/api/v3/trust_store/{alias}
生产：application / json
示例用法:

DELETE /api/v3/trust_store/cert-alias HTTP/1.1授权:Basic YWRtaW46cGFzc3dvcmQ= Content-Type: application/json;charset=UTF-8主机:localhost:8080

示例输出:

HTTP/1.1 204 No内容X-JFrog-Service-Id: jfmc@01c7b8rg70nrqr1cck7k4x0yp7 Server: task -control/SNAPSHOT Strict-Transport-Security: max-age=31536000;includeSubDomains

更新证书(弃用)

描述:更新SSL证书。
自: 3.5.0
安全:需要admin用户
使用:聚氨酯请求/api/v3/{alias}
生产:application / json

示例使用：

PUT /api/v3/trust_store/cert-alias HTTP/1.1授权:Basic YWRtaW46cGFzc3dvcmQ= Content-Type: multipart/form-data;边界=“1 opex3safvmwkc3clpfw5jdrezllrdihcdmsldqx”;border =6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm Host: localhost:8080—6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm Content-Disposition: form-data;= public_key名称;filename=file Content-Type: application/pkix-cert -----BEGIN CERTIFICATE----- << PEM format >> -----END CERTIFICATE----- --6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm Content-Disposition: form-data;name =别名;filename=file内容类型:text/plain new——6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm——.

示例输出:

HTTP/1.1 200 OK Content-Type: application/json X-JFrog-Service-Id: jfmc@01c7b8rg70nrqr1cck7k4x0yp7 Server: task -control/SNAPSHOT Strict-Transport-Security: max-age=31536000;inclesubdomains Content-Length: 788 {"alias": "new"， "issued_by": "CN=GeoTrust RSA CA 2018, OU=www.digicert.com, O=DigiCert Inc, C=US"， "issued_to": "CN=*.jfrog.info, O=JFrog LTD, L=Netanya, C=IL"， "issued_at": "2018-10-15T00:00:00Z"， "valid_until": "2019-07-03T12:00:00Z"， "fingerprint": ""}

下载证书(弃用)

描述:下载SSL证书。
自: 3.5.0
安全:需要admin用户
使用:请求/api/v3/trust_store/{alias}/cert
生产:application / json

示例使用：

GET /api/v3/trust_store/cert-alias/cert HTTP/1.1授权:Basic YWRtaW46cGFzc3dvcmQ= Content-Type: application/json;charset=UTF-8主机:localhost:8080

示例输出:

HTTP/1.1 200 OK内容处理:附件;文件名= " cert-alias。内容类型:application/pkix-cert X-JFrog-Service-Id: jfmc@01c7b8rg70nrqr1cck7k4x0yp7 Server: task -control/SNAPSHOT Strict-Transport-Security: max-age=31536000;inclesubdomains Content-Length: 70 -----BEGIN CERTIFICATE----- << PEM format >> -----END CERTIFICATE-----

设置(弃用)

更新基本URL(已弃用)

描述: 设置其他服务用于与任务控制进行通信的基本URL
注: 这个API是弃用从版本4.x开始。

自:3.2
安全:需要具有管理员权限的用户
用法:把/ api / v3 /设置/ base_url
请求参数:
base_url -外部可访问的URL
示例用法:

curl 'http://localhost:8080/api/v3/settings/base_url' -i -u 'admin:password' -X PUT -H 'Content-Type: application/json;charset=UTF-8' -d '{"base_url": "http://baseUrl-to-mc:8080/"}' 204无内容

身份验证(弃用)

创建令牌(已废弃)

描述: 创建访问令牌
注: 这个API是弃用从版本4.x开始。

自: 3．0
安全:需要有效用户
用法: POST / api / v3 /安全/令牌
请求参数:
用户名-分配令牌的用户
Expires_in令牌有效期(以秒为单位)
可刷新的-如果为真，令牌可以刷新
内容类型: 应用程序/ x-www-form-urlencoded
生产: application / json
示例用法:

curl 'http://localhost:8080/api/v3/security/token' -i -u 'admin:password' -X POST -H {"username": "central-user"， "expires_in": 1000， "refreshable": true} Response: {"access_token": "eyJ2Z…"kMzA"， "expires_in": 1000， "refresh_token": "2b5f…"0664"， "scope": " application -permissions/user"， "token_type": " holder "}

修改密码(已弃用)

描述: 修改用户密码
注: 这个API是弃用从版本4.x开始。

自: 2.1
安全:用户可以修改自己的密码。要求admin用户修改所有用户密码
用法: 把/ api / v3 /认证/ changePassword
请求参数:
用户名—要修改密码的用户
密码—新密码
消耗: application / json
返回代码: 204 -无内容
示例用法:

$ curl 'http://localhost:8080/api/v3/auth/changePassword' -i -u 'admin:password' -X PUT -d username=admin -d password=pa$1word 204无内容

撤销令牌(已弃用)

描述:撤销访问令牌
注:这个API是弃用从版本4.x开始。

自: 3．0
安全:需要有效用户
用法: POST / api / v3 /安全/令牌/撤销
内容类型:应用程序/ x-www-form-urlencoded
返回代码:
204 -无内容

示例用法:

curl 'http://localhost:8080/api/v3/security/token/revoke' -i -u 'admin:password' -X DELETE -H 'Content-Type: application/json'

内容

空间工具

任务控制REST API

概述

基URL

一个uthentication

使用和配置cURL

—创建JPD

系统

系统健康检查

代理(弃用)

创建代理(弃用)

创建外部代理(弃用)

按名称更新代理(已弃用)

获取代理列表(已弃用)

获取源服务过滤的代理列表(已弃用)

获取目标服务过滤的代理列表(已弃用)

获取按源和目标服务筛选的代理列表(已弃用)

按名称获取代理(已弃用)

按名称删除代理(已弃用)

网站(弃用)

创建站点(已弃用)

更新站点(已弃用)

按名称部分更新站点(已弃用)

获取站点(已弃用)

获取站点列表(已弃用)

删除站点(已弃用)

服务(弃用)

创建服务(已弃用)

更新服务(已弃用)

获取服务列表(已弃用)

根据源获取带有代理的服务列表(已弃用)

使用基于源的代理按名称获取服务(已弃用)

删除服务(已弃用)

获取存储库列表(已弃用)

詹妮弗

添加詹妮弗

更新詹妮弗

获取JPD名单

通过id找到警局

删除詹妮弗

访问联合会

获取单个JPD的Access Federation配置

获取所有jpd的联邦访问配置

在JPD上配置Access Federation

获取联盟候选人

创建网格

监控(弃用)

获取服务状态(已弃用)

获取服务状态(已弃用)

支持

创建支持包

获取支持包列表

获取支持包的详细信息

下载支持包

删除支持包

创建平台支持包(已弃用)

获取平台支持包列表(已弃用)

获取平台支持包元数据(已弃用)

获取平台支持包(弃用)

删除平台支持包(弃用)

灾难恢复(已弃用)

创建容灾Pair(已弃用)

脚本(弃用)

获取脚本(已废弃)

获取脚本用户输入(已废弃)

执行脚本(已弃用)

许可证桶

把水桶

创建桶

上传桶

删除桶

获取桶状态

附加许可

获得许可证

安全(弃用)

获取证书(已弃用)

获取证书(已弃用)

添加证书(弃用)

删除证书(弃用)