Convert Federated Repository to a Local Repository

JFrog REST APIs

Content Type
REST API
ft:sourceType
Paligo

Description: Converts the specified Federated repository to a local repository.

Important

The conversion from Federated back to local is allowed only if the Federated repository is not part of an active Federation containing additional members.

Since: 7.103.0

Security: Requires an admin user

Usage: POST /api/federation/convertToLocal

Produces: application/json

Sample Request:

curl --location 'http://localhost:8082/artifactory/api/federation/convertToLocal'
--header 'Content-Type: application/json'
--header 'Authorization: Basic YWRtaW46cGFzc3dvcmQ='
--data '["repo1", "repo2"]'

The request body includes the following information:

Property

Description

data

A comma-separated list of Federated repositories to convert back to local repositories.

Note

There is no limit to the number of repositories that can be included, but a large number of repositories might take a few seconds to process. The repositories can belong to different projects, provided the administrator has access to those projects.

Sample Output (all repos converted successfully — return status 200):

Successfully converted from federated to local repositories: [repo1, repo2]

Sample Output (some repos converted successfully — return status 200):

{
    "failedConversionRepositories": {
        "repo2": "Repo repo2 contains remote members",
    }
}

Sample Output (all repos failed to convert — return status 400):

{
    "failedConversionRepositories": {
        "repo2": "Repo repo2 does not exist or is not of Federated type",
        "repo1": "Repo repo1 contains remote members"
    }
}

Status Codes:

Code

Description

200

One or more repos converted successfully

400

Repos failed to convert

401

Bad Credentials

403

Permission Denied

404

Not Found