RegistryUI Documentation
/udr/v1api/tags
| Endpoint | Method | Description |
|---|---|---|
| /udr/v1api/tags | GET | Returns all available tags in a repository (based on user's permission). |
The returned tags depend on the user's permissions in RegistryUI. Anonymous users only have access to this API if the API has been defined as a Public API (see Registry > Settings, Public tab in your instance of RegistryUI).
The returned list of tags is sorted by name (ascending).
Authentication
Basic Authorization header required for access to tags in private repositories. Anonymous users only have access to this API and tags in public repositories if the API has been defined as a Public API (see Registry > Settings, Public tab in your instance of RegistryUI).
Query String Arguments
| Argument | Type | Description |
|---|---|---|
| repository | string | Defines the full path of the repository for which tags are retrieved. |
| startAfter | string | Optional. If a tag name is specified, only tags with names after the specified name (ordered by tag name, ascending) are returned. |
| skip | integer | Optional. The specified number of tags are skipped and not returned in the list of tags. This can be used for pagination, when limiting the number of returned tags. |
| take | integer | Optional. The specified number of tags are returned in the list of tags even if more tags are available. This can be used for pagination, limiting the number of returned tags. |
Response
A JSON object is returned. If an error occurs, the "error" field will contain a descriptive error message (see Standard API Response).
| Field | Type | Description |
|---|---|---|
| total | integer | Contains the total number of tags that match the search criteria (startAfter) or the total number of available tags. Fewer tags may be returned (see Count) based on skip/take arguments. total always indicates how many tags would be available overall if skip/take were not used. |
| count | integer | Contains the number of tags that are returned in the entries field. More tags may be available (see total) based on skip/take arguments. |
| entries | TagEntry (see below) | An array of tag entries describing each tag. |
Tag Entry
Each entry in the entries field of the API response describes one tag.
Only the fields listed here are officially supported at this time and only these should be used. All other fields are used internally by RegistryUI and may change in future releases.
| Field | Type | Description |
|---|---|---|
| repositoryName | string | The complete path of the repository within the Docker Registry. |
| tagName | string | The tag name. |
| lastUpdated | date/time (UTC) | Contains the date/time the tag was updated. |
| lastUpdatedBy | string | Contains the user name of the user that last updated the tag. |
| details | Contains the tag details as returned by the Docker Registry API. | |
| pushCount | integer | The number of times this tag was pushed. |
| pullCount | integer | The number of times this tag was pulled. |
| pullCommand | string | The Docker command used to pull the image tag. |
| pushCommand | string | The Docker command used to push the image tag. |
Example
curl -u username:usertoken -d "" https://registry.yoursite.com/udr/v1api/tags?repository=httpd
Response:
{
"error": null,
"total": 1,
"count": 1,
"entries": [
{
"id": 1010,
"repositoryName": "httpd",
"tagName": "latest",
"tenantId": 1,
"available": true,
"lastUpdated": "2020-02-11T17:55:41.0968036",
"lastUpdatedBy": "build",
"lastUpdatedById": 1005,
"details": {
"digest": "sha256:1e0cddb4e8282099b384d44232e1edc1eb91c033d774f432f3f68dd7b193b3b1",
"size": 61854416,
"architecture": "amd64",
"layers": [
{
"id": "c0b26a5bd0394a391f647e257c73f393a05ec8f996d6e612988d77568c3bc63d",
"config": {
"cmd": [
"httpd-foreground"
],
"env": [
"PATH=/usr/local/apache2/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
"HTTPD_PREFIX=/usr/local/apache2",
"HTTPD_VERSION=2.4.41",
"HTTPD_SHA256=133d48298fe5315ae9366a0ec66282fa4040efa5d566174481077ade7d18ea40",
"HTTPD_PATCHES="
],
"workingDir": "/usr/local/apache2",
"entryPoint": null
},
"containerConfig": {
"cmd": [
"/bin/sh",
"-c",
"#(nop) ",
"CMD [\"httpd-foreground\"]"
],
"env": [
"PATH=/usr/local/apache2/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
"HTTPD_PREFIX=/usr/local/apache2",
"HTTPD_VERSION=2.4.41",
"HTTPD_SHA256=133d48298fe5315ae9366a0ec66282fa4040efa5d566174481077ade7d18ea40",
"HTTPD_PATCHES="
],
"workingDir": "/usr/local/apache2",
"entryPoint": null
},
"created": "2020-02-02T00:15:26.9313022Z",
"docker_Version": "18.09.7",
"os": "linux",
"parent": "95fc03403fba47e8fe3cd946237dd737e0daae01c22099d57891ec09e44b2222",
"size": 32
},
{
"id": "95fc03403fba47e8fe3cd946237dd737e0daae01c22099d57891ec09e44b2222",
"config": null,
"containerConfig": {
"cmd": [
"/bin/sh -c #(nop) EXPOSE 80"
],
"env": null,
"workingDir": null,
"entryPoint": null
},
"created": "2020-02-02T00:15:26.6078347Z",
"docker_Version": null,
"os": null,
"parent": "a6800fd52e267f9657985b9b2a54945fc995d98d71254b9e10ef5a865a4057c0",
"size": 32
},
{
"id": "a6800fd52e267f9657985b9b2a54945fc995d98d71254b9e10ef5a865a4057c0",
"config": null,
"containerConfig": {
"cmd": [
"/bin/sh -c #(nop) COPY file:c432ff61c4993ecdef4786f48d91a96f8f0707f6179816ccb98db661bfb96b90 in /usr/local/bin/ "
],
"env": null,
"workingDir": null,
"entryPoint": null
},
"created": "2020-02-02T00:15:26.2560292Z",
"docker_Version": null,
"os": null,
"parent": "0c07ea3eb5bd5dce030ddba85b0b5ccce640eb137186324f133540892bbf1474",
"size": 295
},
{
"id": "0c07ea3eb5bd5dce030ddba85b0b5ccce640eb137186324f133540892bbf1474",
"config": null,
"containerConfig": {
"cmd": [
"/bin/sh -c #(nop) STOPSIGNAL SIGWINCH"
],
"env": null,
"workingDir": null,
"entryPoint": null
},
"created": "2020-02-02T00:15:25.7546756Z",
"docker_Version": null,
"os": null,
"parent": "b2a786a02352ae97e17e0367b2b200599376d07cdf6357da36c0bf393de64dd2",
"size": 32
},
{
"id": "b2a786a02352ae97e17e0367b2b200599376d07cdf6357da36c0bf393de64dd2",
"config": null,
"containerConfig": {
"cmd": [
"/bin/sh -c set -eux; \t\tsavedAptMark=\"$(apt-mark showmanual)\"; \tapt-get update; \tapt-get install -y --no-install-recommends \t\tbzip2 \t\tca-certificates \t\tdirmngr \t\tdpkg-dev \t\tgcc \t\tgnupg \t\tlibbrotli-dev \t\tlibcurl4-openssl-dev \t\tlibjansson-dev \t\tliblua5.2-dev \t\tlibnghttp2-dev \t\tlibpcre3-dev \t\tlibssl-dev \t\tlibxml2-dev \t\tmake \t\twget \t\tzlib1g-dev \t; \trm -r /var/lib/apt/lists/*; \t\tddist() { \t\tlocal f=\"$1\"; shift; \t\tlocal distFile=\"$1\"; shift; \t\tlocal success=; \t\tlocal distUrl=; \t\tfor distUrl in \t\t\t'https://www.apache.org/dyn/closer.cgi?action=download&filename=' \t\t\thttps://www-us.apache.org/dist/ \t\t\thttps://www.apache.org/dist/ \t\t\thttps://archive.apache.org/dist/ \t\t; do \t\t\tif wget -O \"$f\" \"$distUrl$distFile\" && [ -s \"$f\" ]; then \t\t\t\tsuccess=1; \t\t\t\tbreak; \t\t\tfi; \t\tdone; \t\t[ -n \"$success\" ]; \t}; \t\tddist 'httpd.tar.bz2' \"httpd/httpd-$HTTPD_VERSION.tar.bz2\"; \techo \"$HTTPD_SHA256 *httpd.tar.bz2\" | sha256sum -c -; \t\tddist 'httpd.tar.bz2.asc' \"httpd/httpd-$HTTPD_VERSION.tar.bz2.asc\"; \texport GNUPGHOME=\"$(mktemp -d)\"; \tfor key in \t\tA93D62ECC3C8EA12DB220EC934EA76E6791485A8 \t\tB9E8213AEFB861AF35A41F2C995E35221AD84DFF \t; do \t\tgpg --batch --keyserver ha.pool.sks-keyservers.net --recv-keys \"$key\"; \tdone; \tgpg --batch --verify httpd.tar.bz2.asc httpd.tar.bz2; \tcommand -v gpgconf && gpgconf --kill all || :; \trm -rf \"$GNUPGHOME\" httpd.tar.bz2.asc; \t\tmkdir -p src; \ttar -xf httpd.tar.bz2 -C src --strip-components=1; \trm httpd.tar.bz2; \tcd src; \t\tpatches() { \t\twhile [ \"$#\" -gt 0 ]; do \t\t\tlocal patchFile=\"$1\"; shift; \t\t\tlocal patchSha256=\"$1\"; shift; \t\t\tddist \"$patchFile\" \"httpd/patches/apply_to_$HTTPD_VERSION/$patchFile\"; \t\t\techo \"$patchSha256 *$patchFile\" | sha256sum -c -; \t\t\tpatch -p0 < \"$patchFile\"; \t\t\trm -f \"$patchFile\"; \t\tdone; \t}; \tpatches $HTTPD_PATCHES; \t\tgnuArch=\"$(dpkg-architecture --query DEB_BUILD_GNU_TYPE)\"; \tCFLAGS=\"$(dpkg-buildflags --get CFLAGS)\"; \tCPPFLAGS=\"$(dpkg-buildflags --get CPPFLAGS)\"; \tLDFLAGS=\"$(dpkg-buildflags --get LDFLAGS)\"; \t./configure \t\t--build=\"$gnuArch\" \t\t--prefix=\"$HTTPD_PREFIX\" \t\t--enable-mods-shared=reallyall \t\t--enable-mpms-shared=all \t\t--enable-pie \t\tCFLAGS=\"-pipe $CFLAGS\" \t\tCPPFLAGS=\"$CPPFLAGS\" \t\tLDFLAGS=\"-Wl,--as-needed $LDFLAGS\" \t; \tmake -j \"$(nproc)\"; \tmake install; \t\tcd ..; \trm -r src man manual; \t\tsed -ri \t\t-e 's!^(\\s*CustomLog)\\s+\\S+!\\1 /proc/self/fd/1!g' \t\t-e 's!^(\\s*ErrorLog)\\s+\\S+!\\1 /proc/self/fd/2!g' \t\t-e 's!^(\\s*TransferLog)\\s+\\S+!\\1 /proc/self/fd/1!g' \t\t\"$HTTPD_PREFIX/conf/httpd.conf\" \t\t\"$HTTPD_PREFIX/conf/extra/httpd-ssl.conf\" \t; \t\tapt-mark auto '.*' > /dev/null; \t[ -z \"$savedAptMark\" ] || apt-mark manual $savedAptMark; \tfind /usr/local -type f -executable -exec ldd '' ';' \t\t| awk '/=>/ { print $(NF-1) }' \t\t| sort -u \t\t| xargs -r dpkg-query --search \t\t| cut -d: -f1 \t\t| sort -u \t\t| xargs -r apt-mark manual \t; \tapt-get purge -y --auto-remove -o APT::AutoRemove::RecommendsImportant=false; \t\thttpd -v"
],
"env": null,
"workingDir": null,
"entryPoint": null
},
"created": "2020-02-02T00:15:25.3746167Z",
"docker_Version": null,
"os": null,
"parent": "2399759b1daa5d0128b3a2cb40baabd1c9ddcbfcab84d8010dc50c26c0495850",
"size": 24380329
},
{
"id": "2399759b1daa5d0128b3a2cb40baabd1c9ddcbfcab84d8010dc50c26c0495850",
"config": null,
"containerConfig": {
"cmd": [
"/bin/sh -c #(nop) ENV HTTPD_PATCHES="
],
"env": null,
"workingDir": null,
"entryPoint": null
},
"created": "2020-02-02T00:12:15.6780942Z",
"docker_Version": null,
"os": null,
"parent": "f8a68e4f8b40c9fea5d75075295d0dca174345f5555107fc69add0439b6f19cb",
"size": 32
},
{
"id": "f8a68e4f8b40c9fea5d75075295d0dca174345f5555107fc69add0439b6f19cb",
"config": null,
"containerConfig": {
"cmd": [
"/bin/sh -c #(nop) ENV HTTPD_SHA256=133d48298fe5315ae9366a0ec66282fa4040efa5d566174481077ade7d18ea40"
],
"env": null,
"workingDir": null,
"entryPoint": null
},
"created": "2020-02-02T00:12:15.4979004Z",
"docker_Version": null,
"os": null,
"parent": "f379f735b64610c9b8b62a0e9edce9a727e0a1c95580a5aca439048aabd93780",
"size": 32
},
{
"id": "f379f735b64610c9b8b62a0e9edce9a727e0a1c95580a5aca439048aabd93780",
"config": null,
"containerConfig": {
"cmd": [
"/bin/sh -c #(nop) ENV HTTPD_VERSION=2.4.41"
],
"env": null,
"workingDir": null,
"entryPoint": null
},
"created": "2020-02-02T00:12:15.3303601Z",
"docker_Version": null,
"os": null,
"parent": "84862af2f5327d2ac60338df844ed79d94b0241096877824e1bfa97113e53df3",
"size": 32
},
{
"id": "84862af2f5327d2ac60338df844ed79d94b0241096877824e1bfa97113e53df3",
"config": null,
"containerConfig": {
"cmd": [
"/bin/sh -c set -eux; \tapt-get update; \tapt-get install -y --no-install-recommends \t\tlibapr1-dev \t\tlibaprutil1-dev \t\tlibaprutil1-ldap \t; \trm -rf /var/lib/apt/lists/*"
],
"env": null,
"workingDir": null,
"entryPoint": null
},
"created": "2020-02-02T00:12:15.1077727Z",
"docker_Version": null,
"os": null,
"parent": "44edf3b6735498a47289022ca931973876925d0ff414d757d05271f088543625",
"size": 10374036
},
{
"id": "44edf3b6735498a47289022ca931973876925d0ff414d757d05271f088543625",
"config": null,
"containerConfig": {
"cmd": [
"/bin/sh -c #(nop) WORKDIR /usr/local/apache2"
],
"env": null,
"workingDir": null,
"entryPoint": null
},
"created": "2020-02-02T00:12:07.4985286Z",
"docker_Version": null,
"os": null,
"parent": "e41b46853b1a2d35a8e27cddc7c85a77c2947f2599e88a66570c7afc14332566",
"size": 32
},
{
"id": "e41b46853b1a2d35a8e27cddc7c85a77c2947f2599e88a66570c7afc14332566",
"config": null,
"containerConfig": {
"cmd": [
"/bin/sh -c mkdir -p \"$HTTPD_PREFIX\" \t&& chown www-data:www-data \"$HTTPD_PREFIX\""
],
"env": null,
"workingDir": null,
"entryPoint": null
},
"created": "2020-02-02T00:12:07.3064987Z",
"docker_Version": null,
"os": null,
"parent": "cdbdf40e7e44e3c257a73177e7c1e5e528a4d0ee3697d056b2e8611399ad5bb2",
"size": 147
},
{
"id": "cdbdf40e7e44e3c257a73177e7c1e5e528a4d0ee3697d056b2e8611399ad5bb2",
"config": null,
"containerConfig": {
"cmd": [
"/bin/sh -c #(nop) ENV PATH=/usr/local/apache2/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
],
"env": null,
"workingDir": null,
"entryPoint": null
},
"created": "2020-02-02T00:12:06.5032313Z",
"docker_Version": null,
"os": null,
"parent": "9bcf8de5714aa9cd216a07dc0994da747d65ffc82fffc0e6f80220c1256b0947",
"size": 32
},
{
"id": "9bcf8de5714aa9cd216a07dc0994da747d65ffc82fffc0e6f80220c1256b0947",
"config": null,
"containerConfig": {
"cmd": [
"/bin/sh -c #(nop) ENV HTTPD_PREFIX=/usr/local/apache2"
],
"env": null,
"workingDir": null,
"entryPoint": null
},
"created": "2020-02-02T00:12:06.3345254Z",
"docker_Version": null,
"os": null,
"parent": "3f0aff498b0ad59549bf7a124fb794ded4cb343b4c4d4876e33e2c7d0f17df42",
"size": 32
},
{
"id": "3f0aff498b0ad59549bf7a124fb794ded4cb343b4c4d4876e33e2c7d0f17df42",
"config": null,
"containerConfig": {
"cmd": [
"/bin/sh -c #(nop) CMD [\"bash\"]"
],
"env": null,
"workingDir": null,
"entryPoint": null
},
"created": "2020-02-01T17:20:54.4308284Z",
"docker_Version": null,
"os": null,
"parent": "2f4d187059e32e19275b0c65439356ef9109a92610cbe02136a0b04e851b97dc",
"size": 32
},
{
"id": "2f4d187059e32e19275b0c65439356ef9109a92610cbe02136a0b04e851b97dc",
"config": null,
"containerConfig": {
"cmd": [
"/bin/sh -c #(nop) ADD file:ba0c39345ccc4a882289d473ae8a67087056aa4475a26f3492fff75933d707de in / "
],
"env": null,
"workingDir": null,
"entryPoint": null
},
"created": "2020-02-01T17:20:54.180869Z",
"docker_Version": null,
"os": null,
"parent": null,
"size": 27092260
}
]
},
"pullCount": 0,
"pushCount": 1,
"size": 61854416,
"os": "amd64",
"digest": "sha256:1e0cddb4e8282099b384d44232e1edc1eb91c033d774f432f3f68dd7b193b3b1",
"created": "2020-02-08T12:25:26.602566",
"updated": "2020-02-11T17:56:45.185324",
"deletingUser": 0,
"pullCommand": "docker pull demo.registryui.com/httpd:latest",
"pushCommand": "docker push demo.registryui.com/httpd:latest"
}
]
}