REST API Reference

Back Next

Getting a new token

If you have Kubernetes DevOps engineers privileges, you can request a token that you can use to access and download images from the artifactory.

GET request

To get a new token, use the following URI:

/public/core/v3/containerimagetoken/create

The following table lists the potential error codes for a request:

HTTP status code	Description
401	Unauthenticated or unauthorized.
403	Insufficient privilege. The get.k8s.repository.token privilege is required to access this API.

GET response

If successful, returns the token ID and the token value.

GET response examples

To get a new token, use the following request:

GET <baseApiUrl>/public/core/v3/containerimagetoken/create
Content-type: application/json
Accept: application/json
INFA-SESSION-ID: <SessionId>

If successful, you might receive a "200 OK" response like the following example:

{
    "tokenId":"<token ID>",
    "tokenValue":"<token value>"
}

If you have insufficient privileges, you might receive a "403 Forbidden" response like the following example:

{
    "error": {
        "code": "AIS_007",
        "message": "Privilege - view.k8s.agent.config required for accessing this API.",
        "debugMessage": "Privilege - view.k8s.agent.config required for accessing this API.",
        "requestId": "l2EpwkFoqkEjrEJURclPw2",
        "details": null
    }
}

If the token has been revoked, you might receive a "400 Bad Request" response like the following example:

{
    "error": {
        "code": "AIS_014",
        "message": "Token with id:<token ID> already revoked.",
        "debugMessage": "Token with id:<token ID> already revoked.",
        "requestId": "iVdlwEoaFiZd3vb0LvLVmp",
        "details": null
    }
}

Rename Saved Search

Table of Contents

REST API Reference

REST API Reference

Getting a new token

Getting a new token

GET request

GET response

GET response examples