Updated on 2023-04-04 GMT+08:00

Manually Synchronizing an Image

Function

Manually synchronize an image.

URI

POST /v2/manage/namespaces/{namespace}/repos/{repository}/sync_images

Table 1 describes the parameters.

Table 1 Parameter description

Parameter

Mandatory

Type

Description

namespace

Yes

String

Organization name.

repository

Yes

String

Image repository name.

Request

  • Request parameters
    Table 2 Request body parameter description

    Parameter

    Mandatory

    Type

    Description

    imageTag

    Yes

    Array of String

    Image tag list.

    override

    No

    Boolean

    Whether to overwrite. The default value is false, which indicates not to overwrite any nonidentical image that has the same name in the target organization.

    remoteNamespace

    Yes

    String

    Target organization.

    remoteRegionId

    Yes

    String

    Target region.

  • Example request
    POST https://{Endpoint}/v2/manage/namespaces/group/repos/busybox/sync_images

    Body:

    {
        "imageTag": [
            "v1"
        ],
        "override": false,
        "remoteNamespace": "sdsad",
        "remoteRegionId": "region-2"
    }

Response

  • Response parameters
    Table 3 Response body parameter description

    Parameter

    Type

    Description

    [Array element]

    Array of strings

    Image tags that fail to be synchronized.

  • Example response
    []

Status Code

Status Code

Description

200

Request successful.

400

Request error.

401

Authentication failed.

404

The organization does not exist.

500

Internal error.