Overview
As part of migrating to JFrog Artifactory, you need to remap all your Bintray REST API and Bintray commands to Artifactory to prevent your current automation processes from breaking. When migrating to Artifactory, a number of commands are no longer supported or can now be performed in the MyJFrog Platform.
Using Artifactory REST API
The main advantages of using the Artifactory REST API are:
Unlimited Number of Queries: In Bintray, API queries are limited to resources that do not belong to a user or to the organization the user is part of. The current limit per Self-hosted user is 300 queries a day, and 1440 per month.
Artifactory does not provide limits in regards to the maximum number of queries a user can execute per day. However, if the service is self hosted, user queries can be monitored via the Artifactory access log file, in order to detect unusual number of requests coming from the same user.
Unlimited Number of Results Per Page for each Query: In Bintray, the number of results returned for each query is limited to 50 results per page. Whereas Artifactory does not have a limit on the number of results on the page.
For more information, see Artifactory REST APIs.
Using JFrog CLI
JFrog CLI can also be used for different functions when working with JFrog Artifactory. While the basic command syntax is the same, there may be variation in the commands, options and parameters available for each product.
Migrating to the Artifactory REST API
Bintray to Artifactory REST API Mapping
The process of migrating your Bintray automation to Artifactory involves replacing the commands from the Bintray API to the Artifactory API.
The following table lists the Bintray API commands and the corresponding command in the Artifactory API.
Category | Action | Bintray API | Artifactory API | Comments |
|---|---|---|---|---|
REPOSITORY MANAGEMENT | ||||
Get Repositories | Bintray REST API#Get Repositories | Artifactory REST API#Get Repositories | ||
Get Repository | Bintray REST API#Get Repository | Artifactory REST API#Repository Configuration | ||
Create Repository | Bintray REST API#Create Repository | Artifactory REST API#Create Repository | ||
Update repository | Bintray REST API#Update Repository | Artifactory REST API#Update Repository Configuration | ||
Delete repository | Bintray REST API#Delete Repository | Artifactory REST API#Delete Repository | ||
Delete Docker repository | Bintray REST API#Delete Docker Repository | Artifactory REST API#Delete Repository | ||
Repository search | Bintray REST API#Repository Search | Artifactory REST API#Get Repositories | ||
USER MANAGEMENT | ||||
Get User | Bintray REST API#Get User | Artifactory REST API#Get Users | ||
User Search | Bintray REST API#User Search | Artifactory REST API#Get Users | ||
Get Teams | Bintray REST API#Get Teams | Artifactory REST API#Get Groups | ||
Create Teams | Bintray REST API#Create Team | Artifactory REST API#Create or Replace Group | ||
Update Teams | Bintray REST API#Update Team | Artifactory REST API#Update Group | ||
Delete Team | Bintray REST API#Delete Team | Artifactory REST API#Delete Group | ||
SECURITY AND PERMISSIONS | ||||
Get All Team Permissions | Bintray REST API#Get All Team Permissions | Artifactory REST API#Get Permission Targets | ||
Get Team Permission | Bintray REST API#Get Team Permission | Artifactory REST API#Get Permission Targets | ||
Set Team Permission | Bintray REST API#Set Team Permission | Artifactory REST API#Create or Replace Permission Target | ||
Get Access Keys | Bintray REST API#Get Access Keys | Artifactory REST API#Get Tokens | Access Tokens have replaced Access Keys | |
Get Access Key | Bintray REST API#Get Access Key | Artifactory REST API#Get Tokens | ||
Create Access Key | Bintray REST API#Create Access Key | Artifactory REST API#Create Token | ||
Delete Access Key | Bintray REST API#Delete Access Key | Artifactory REST API#Revoke Token | ||
Update Access Key | Bintray REST API#Update Access Key | Artifactory REST API#Refresh Token | ||
Get Entitlements | Bintray REST API#Get Entitlements | Artifactory REST API#Get Permission Targets | Alternative usage | |
Get Entitlement | Bintray REST API#Get Entitlements | Artifactory REST API#Get Permission Target | ||
Create Entitlement | Bintray REST API#Create Entitlement | Artifactory REST API#Create or Replace Permission Target | ||
Delete Entitlement | Bintray REST API#Delete Entitlement | Artifactory REST API#Delete Permission Target | ||
Update Entitlement | Bintray REST API#Update Entitlement | Artifactory REST API#Create or Replace Permission Target | ||
Delete Team Permission | Bintray REST API#Delete Team Permission | Artifactory REST API#Delete Permission Target | ||
ARTIFACT MANAGEMENT | ||||
Upload Content | Bintray REST API#Upload Content | Artifactory REST API#Deploy Artifact | ||
Delete Content | Bintray REST API#Delete Content | Artifactory REST API#Delete Item | ||
Schedule Repository Metadata Calculation | Bintray REST API#Schedule Metadata Calculation | Artifactory REST API#Calculate YUM Repository Metadata | ||
Delete Docker tag | Bintray REST API#Delete Docker Tag | Artifactory REST API#Delete Item | Delete must apply to a folder where the image is stored. | |
Update Package | Bintray REST API#Update Package | Artifactory REST API#Update Item Properties | Alternative | |
Content Download | Bintray REST API#Download Content | Artifactory REST API#Retrieve Artifact | ||
URL Signing | Bintray REST API#URL Signing | Create signed URL | ||
Package Search | Bintray REST API#Package Search | Artifactory REST API#Artifact Search (QuickSearch) | ||
Maven Package Search | Bintray REST API#MavenPackage Search | Artifactory REST API#GAVC Search | ||
Get Package Files | Bintray REST API#Get Package Files | Using Properties in Deployment and Resolution | Can be achieved in Artifactory by searching files that are part of a particular delivery, using properties, or based on the layout | |
Get Version Files | Bintray REST API#Get Version Files | Using Properties in Deployment and Resolution | Can be achieved in Artifactory by searching files that are part of a particular delivery, using properties, or based on the layout | |
File Search by Name | Bintray REST API#File Search by Name | Artifactory REST API#Artifact Search (QuickSearch) | ||
File Search by checksum | Bintray REST API#File Search by Checksum | Artifactory REST API#Checksum Search | ||
Get Attributes | Bintray REST API#Get Attributes | Artifactory REST API#Item Properties | ||
Attribute Search | Bintray REST API#Attribute Search | Artifactory REST API#Property Search | ||
Get Files Attributes | Bintray REST API#Attribute Search | Artifactory REST API#Item Properties | ||
Search File Attributes | Bintray REST API#Delete File Attributes | Artifactory REST API#Delete Item Properties | ||
METADATA MANAGEMENT | ||||
Set File Attributes | Bintray REST API#Set File Attributes | Artifactory REST API#Set Item Properties | ||
Update File Attributes | Bintray REST API#Update File Attributes | Artifactory REST API#Update Item Properties | ||
Delete File Attributes | Bintray REST API#Delete File Attributes | Artifactory REST API#Delete Item Properties | ||
STATISTICS AND USAGE REPORTS | ||||
Get Usage Report For Repository | Bintray REST API#Get Usage Report For Repository | Artifactory REST API#Get Storage Summary Info | Alternative | |
Bintray REST APIs Migrated to MyJFrog
GEOLOCATIONS AND IP RESTRICTIONS |
|---|
Set Geo Restrictions |
Get Geo Restrictions |
Update Geo Restrictions |
Set IP Restrictions |
Get IP Restrictions |
Update IP Restrictions |
Delete IP Restrictions |
Bintray REST API Commands Not Supported in Artifactory
GEO LOCATIONS | METADATA MANAGEMENT |
Get Products | Set Attributes |
Create Product | Update Attributes |
Update Product | Delete Attributes |
Delete Product | STATISTICS AND REPORT USAGE |
Get Organization | Get Daily Downloads |
Get Followers | Get Total Downloads |
Re-generate Subject URL Signing Key | Get Downloads by Country |
ARTIFACT MANAGEMENT | Get Usage Report For Subject |
Publish/Discard Uploaded Content | Get Usage Report For Package |
Content Signing | Get Usage Report Grouped By Business Unit |
Link Package | LOGS |
Unlink Package | List Package Download Log Files |
Create Version | Download Package Download Log File |
Delete Version | WEBHOOKS |
Update version | Get Webhooks |
Version for File | Register a Webhook |
File in Download List | Test a Webhook |
Get Product Signed EULAs | Delete a Webhook |
Get Signed EULAs-All Products | SECURITY |
Get EULAs | Entitlement Search By Access Key |
Get EULAs | Entitlement Search By Tag |
Create EULA | USAGE THRESHOLDS |
Update EULA | Get Usage Threshold |
Delete EULA | Create Usage Threshold |
Get EULA by File Path | Create Usage Threshold |
Create Readme | Delete Usage Thresholds |
Create Product Readme | LICENSES |
Delete Product Readme | Get Proprietary Licenses |
Create Package Release Notes | Create Proprietary License |
Delete Package Release Notes | Update Proprietary License |
Create Version Release Notes | Delete Proprietary License |
Dynamic Download | Get OSS Licenses |
EULA-Protected Product Version download | MONITORING |
Get Packages | Stream API (Events Firehose) |
Get Package | |
Package for File | |
Get Version | |
Get Readme | |
Get Package Release Notes | |
Get Version Release Notes |
Migrating to the JFrog Artifactory CLI
Bintray to Artifactory CLI Mapping
The following table lists the Bintray CLI commands and their corresponding commands in the Artifactory CLI.
Action | Bintray CLI Commands | Artifactory CLI Commands |
|---|---|---|
Content | CLI for JFrog Bintray#Configuration | CLI for JFrog Artifactory#Configuration |
Uploading files | CLI for JFrog Bintray#Uploading Files | CLI for JFrog Artifactory#Uploading Files |
Downloading files | CLI for JFrog Bintray#Downloading a File | CLI for JFrog Artifactory#Downloading Files |
Downloading a version | CLI for JFrog Bintray#Downloading a Version | CLI for JFrog Artifactory#Downloading Files |
Creating a version | CLI for JFrog Bintray#Creating a Version | CLI for JFrog Artifactory#UploadingFiles |
Updating a version | CLI for JFrog Bintray#Updating a Version | CLI for JFrog Artifactory#Setting Properties on Files |
Publishing a version | CLI for JFrog Bintray#Publishing a Version | CLI for JFrog Artifactory#Uploading Files |
Getting version details | CLI for JFrog Bintray#Getting Version Details | CLI for JFrog Artifactory#Searching Files |
Deleting a version | CLI for JFrog Bintray#Deleting a Version | CLI for JFrog Artifactory#Deleting Files |
Bintray CLI Commands Not Supported in Artifactory
Getting Package Details |
Updating a Package |
Deleting a Package |
Getting Package Details |
Managing Entitlements |
Managing AccessKeys |
Signing a File With Your GPG Key |
Displaying Log Files Connected to a Package |
Downloading a Log File Connected to a Package |
Connecting to an Event Notification Stream |