MENU
      View registry list

        View registry list


        Article summary

        Available in Classic and VPC

        View the list of registries registered in Container Registry.

        Requests

        The following describes the request format for the endpoint. The request format is as follows.

        MethodURI
        GET/repositories

        Request headers

        For headers common to all Container Registry APIs, see Container Registry common headers.

        Request query parameters

        The following describes the request query parameters.

        FieldTypeRequiredDescription
        pageNumberOptionalPage number to view
        • Enter a value greater than 0 for the page number
        pagesizeNumberOptionalSize of the page to view
        • Enter a value greater than 0 for the page size

        Request example

        The following is a sample request.

        curl -X GET "https://ncr.apigw.ntruss.com/ncr/api/v2/repositories"
        -H "Content-Type: application/json; charset=utf-8"
        -H "x-ncp-apigw-timestamp: {Timestamp}"
        -H "x-ncp-iam-access-key: {Sub Account Access Key}"
        -H "x-ncp-apigw-signature-v2: {API Gateway Signature}"
        Curl

        Responses

        The following describes the response format.

        Response syntax

        The response syntax is as follows.

        {
            "count": "number",
            "next": "number",
            "previous": "number",
            "results": [
                {
                    "bucket": "string",
                    "created": "number",
                    "end_point": "string",
                    "end_point_enabled": "boolean",
                    "name": "string",
                    "private_end_point": "string",
                    "private_id": "string",
                    "public_reg_status": "boolean",
                    "scan_on_push_enabled": "boolean",
                    "status": "string"
                }
            ]
        }
        JSON

        Response body

        The following describes the response body.

        FieldTypeRequiredDescription
        countNumber-Total number of registries registered
        nextNumber-Number of the next page
        • It returns null if there is no next page
        previousNumber-Number of the previous page
        • It returns null if there is no previous page
        results[].bucketString-Name of the Object Storage bucket integrated with the registry
        result[].[].createdNumber-Registry creation date
        results[].end_pointString-Endpoint for Docker client to access the registry
        results[].end_point_enabledBoolean-Endpoint accessibility
        results[].nameString-Registry name
        results[].private_end_pointString-Endpoint for Docker client to access the registry
        • Available only on NAVER Cloud Platform's VPC network
        results[].private_idString-ID of the private endpoint
        results[].public_reg_statusBoolean-Whether the user who accessed without authentication has Pull permissions
        • true | false
        results[].scan_on_push_enabledBoolean-Whether to automatically scan for vulnerabilities when uploading container images
        • true | false
        results[].statusString-Integration status of registry and Object Storage
        • running | disconnected
          • running: normal status
          • disconnected: bucket deleted

        Response status codes

        The following describes response status codes. For response status codes common to all Container Registry APIs, see Container Registry response status codes.

        HTTP status codeCodeMessageDescription
        200-OKRequest succeeded

        Response example

        The following is a sample response.

        {
            "count": 1,
            "next": null,
            "previous": null,
            "results": [
                {
                    "bucket": "ncpdocker",
                    "created": 1711695272000,
                    "end_point": "ncpdocker.kr.ncr.ntruss.com",
                    "end_point_enabled": true,
                    "name": "ncpdocker",
                    "private_end_point": "pdxxxnzd.kr.private-ncr.ntruss.com",
                    "private_id": "pdxxxnzd",
                    "public_reg_status": false,
                    "scan_on_push_enabled": false,
                    "status": "running"
                }
            ]
        }
        JSON

        Was this article helpful?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.