Adds tag API commands (quay#1226)

Co-authored-by: Steven Smith <[email protected]>

Author: stevsmit

README.adoc

@@ -217,7 +217,7 @@ You can make content appear only in the upstream by using the `ifdef::upstream`
 ifdef::downstream[]
 == How do I make content appear in downstream but not in upstream?
 
-You can make content appear only in the link:https://access.redhat.com/documentation/en-us/red_hat_quay/3/[downstream] by using the `ifdef::downstream` conditional around the content that you only want to appear downstream. For example: 
+You can make content appear only in the link:https://access.redhat.com/documentation/en-us/red_hat_quay/{producty}/[downstream] by using the `ifdef::downstream` conditional around the content that you only want to appear downstream. For example: 
 
 ----
 \ifdef::downstream[]

api/master.adoc

@@ -119,6 +119,8 @@ include::modules/listing-repos-superuser-api.adoc[leveloffset=+3]
 include::modules/managing-organization-quota-superuser-api.adoc[leveloffset=+3]
 include::modules/managing-user-quota-superuser-api.adoc[leveloffset=+3]
 include::modules/retrieving-build-info-superuser-api.adoc[leveloffset=+3]
+//tag
+include::modules/managing-tags-api.adoc[leveloffset=+2]
 
 
 include::modules/managing-service-keys-api.adoc[leveloffset=+3]

deploy_quay/master.adoc

@@ -84,7 +84,7 @@ include::modules/clair-cve.adoc[leveloffset=+3]
 
 .Additional resources
 
-* link:https://access.redhat.com/documentation/en-us/red_hat_quay/3/html-single/vulnerability_reporting_with_clair_on_red_hat_quay/index#vulnerability-reporting-clair-quay-overview[Vulnerability reporting with Clair on {productname}]
+* link:https://access.redhat.com/documentation/en-us/red_hat_quay/{producty}/html-single/vulnerability_reporting_with_clair_on_red_hat_quay/index#vulnerability-reporting-clair-quay-overview[Vulnerability reporting with Clair on {productname}]
 
 include::modules/proc_deploy_quay_poc_restart.adoc[leveloffset=+2]
 

deploy_quay_on_openshift_op_tng/master.adoc

@@ -54,7 +54,7 @@ include::modules/operator-unmanaged-redis.adoc[leveloffset=+1]
 [role="_additional-resources"]
 .Additional resources
 
-xref:https://access.redhat.com/documentation/en-us/red_hat_quay/3/html-single/configure_red_hat_quay/index#config-fields-redis[Redis configuration fields]
+xref:https://access.redhat.com/documentation/en-us/red_hat_quay/{producty}/html-single/configure_red_hat_quay/index#config-fields-redis[Redis configuration fields]
 
 include::modules/operator-unmanaged-hpa.adoc[leveloffset=+3]
 include::modules/operator-unmanaged-route.adoc[leveloffset=+3]

deploy_red_hat_quay_operator/master.adoc

@@ -51,7 +51,7 @@ include::modules/operator-unmanaged-redis.adoc[leveloffset=+3]
 
 [role="_additional-resources"]
 .Additional resources
-link:https://access.redhat.com/documentation/en-us/red_hat_quay/3/html-single/configure_red_hat_quay/index#config-fields-redis[Redis configuration fields]
+link:https://access.redhat.com/documentation/en-us/red_hat_quay/{producty}/html-single/configure_red_hat_quay/index#config-fields-redis[Redis configuration fields]
 
 include::modules/operator-unmanaged-hpa.adoc[leveloffset=+3]
 include::modules/operator-unmanaged-route.adoc[leveloffset=+3]
@@ -98,4 +98,4 @@ include::modules/creating-custom-ssl-certs-config-bundle.adoc[leveloffset=+2]
 [role="quay-next-steps"]
 .Next steps
 
-* https://access.redhat.com/documentation/en-us/red_hat_quay/3/html-single/red_hat_quay_operator_features/[{productname} features]
+* https://access.redhat.com/documentation/en-us/red_hat_quay/{producty}/html-single/red_hat_quay_operator_features/[{productname} features]

modules/adding-a-new-tag-to-image-api.adoc

@@ -51,7 +51,7 @@ $ curl -X POST \
 {}
 ----
 
-. To see a list of tags after creating a new tag you can use the link:https://docs.redhat.com/en/documentation/red_hat_quay/3/html-single/red_hat_quay_api_guide/index#listrepotags[`GET /api/v1/repository/{repository}/tag/`] command. For example:
+. To see a list of tags after creating a new tag you can use the link:https://docs.redhat.com/en/documentation/red_hat_quay/{producty}/html-single/red_hat_quay_api_guide/index#listrepotags[`GET /api/v1/repository/{repository}/tag/`] command. For example:
 +
 [source,terminal]
 ----

modules/adding-managing-labels-api.adoc

@@ -6,12 +6,12 @@
 
 .Prerequisites
 
-* You have link:https://access.redhat.com/documentation/en-us/red_hat_quay/3/html-single/red_hat_quay_api_guide/index#creating-oauth-access-token[Created an OAuth access token].
+* You have link:https://access.redhat.com/documentation/en-us/red_hat_quay/{producty}/html-single/red_hat_quay_api_guide/index#creating-oauth-access-token[Created an OAuth access token].
 * You have set `BROWSER_API_CALLS_XHR_ONLY: false` in your `config.yaml` file.
 
 .Procedure
 
-. Use the link:https://docs.redhat.com/en/documentation/red_hat_quay/3/html-single/red_hat_quay_api_guide/index#getrepomanifest[`GET /api/v1/repository/{repository}/manifest/{manifestref}`] command to retrieve the details of a specific manifest in a repository:
+. Use the link:https://docs.redhat.com/en/documentation/red_hat_quay/{producty}/html-single/red_hat_quay_api_guide/index#getrepomanifest[`GET /api/v1/repository/{repository}/manifest/{manifestref}`] command to retrieve the details of a specific manifest in a repository:
 +
 [source,terminal]
 ----
@@ -21,7 +21,7 @@ $ curl -X GET \
   https://<quay-server.example.com>/api/v1/repository/<repository>/manifest/<manifestref>
 ----
 
-. Use the link:https://docs.redhat.com/en/documentation/red_hat_quay/3/html-single/red_hat_quay_api_guide/index#listmanifestlabels[`GET /api/v1/repository/{repository}/manifest/{manifestref}/labels`] command to retrieve a list of labels for a specific manifest:
+. Use the link:https://docs.redhat.com/en/documentation/red_hat_quay/{producty}/html-single/red_hat_quay_api_guide/index#listmanifestlabels[`GET /api/v1/repository/{repository}/manifest/{manifestref}/labels`] command to retrieve a list of labels for a specific manifest:
 +
 [source,terminal]
 ----
@@ -38,7 +38,7 @@ $ curl -X GET \
 {"labels": [{"id": "e9f717d2-c1dd-4626-802d-733a029d17ad", "key": "org.opencontainers.image.url", "value": "https://github.com/docker-library/busybox", "source_type": "manifest", "media_type": "text/plain"}, {"id": "2d34ec64-4051-43ad-ae06-d5f81003576a", "key": "org.opencontainers.image.version", "value": "1.36.1-glibc", "source_type": "manifest", "media_type": "text/plain"}]}
 ----
 
-. Use the link:https://docs.redhat.com/en/documentation/red_hat_quay/3/html-single/red_hat_quay_api_guide/index#getmanifestlabel[`GET /api/v1/repository/{repository}/manifest/{manifestref}/labels/{labelid}`] command to obtain information about a specific manifest:
+. Use the link:https://docs.redhat.com/en/documentation/red_hat_quay/{producty}/html-single/red_hat_quay_api_guide/index#getmanifestlabel[`GET /api/v1/repository/{repository}/manifest/{manifestref}/labels/{labelid}`] command to obtain information about a specific manifest:
 +
 [source,terminal]
 ----
@@ -55,7 +55,7 @@ $ curl -X GET \
 {"id": "e9f717d2-c1dd-4626-802d-733a029d17ad", "key": "org.opencontainers.image.url", "value": "https://github.com/docker-library/busybox", "source_type": "manifest", "media_type": "text/plain"}
 ----
 
-. You can add an additional label to a manifest in a given repository with the link:https://docs.redhat.com/en/documentation/red_hat_quay/3/html-single/red_hat_quay_api_guide/index#addmanifestlabel[`POST /api/v1/repository/{repository}/manifest/{manifestref}/labels`] command. For example:
+. You can add an additional label to a manifest in a given repository with the link:https://docs.redhat.com/en/documentation/red_hat_quay/{producty}/html-single/red_hat_quay_api_guide/index#addmanifestlabel[`POST /api/v1/repository/{repository}/manifest/{manifestref}/labels`] command. For example:
 +
 [source,terminal]
 ----
@@ -77,7 +77,7 @@ $ curl -X POST \
 {"label": {"id": "346593fd-18c8-49db-854f-4cb1fb76ff9c", "key": "example-key", "value": "example-value", "source_type": "api", "media_type": "text/plain"}}
 ----
 
-. You can delete a label using the link:https://docs.redhat.com/en/documentation/red_hat_quay/3/html-single/red_hat_quay_api_guide/index#deletemanifestlabel[`DELETE /api/v1/repository/{repository}/manifest/{manifestref}/labels/{labelid}`] command:
+. You can delete a label using the link:https://docs.redhat.com/en/documentation/red_hat_quay/{producty}/html-single/red_hat_quay_api_guide/index#deletemanifestlabel[`DELETE /api/v1/repository/{repository}/manifest/{manifestref}/labels/{labelid}`] command:
 +
 [source,terminal]
 ----

modules/adjust-access-user-repo-api.adoc

@@ -13,12 +13,12 @@ Use the following procedure to adjust access settings for a user or robot accoun
 .Prerequisites
 
 * You have created a user account or robot account.
-* You have link:https://access.redhat.com/documentation/en-us/red_hat_quay/3/html-single/red_hat_quay_api_guide/index#creating-oauth-access-token[Created an OAuth access token].
+* You have link:https://access.redhat.com/documentation/en-us/red_hat_quay/{producty}/html-single/red_hat_quay_api_guide/index#creating-oauth-access-token[Created an OAuth access token].
 * You have set `BROWSER_API_CALLS_XHR_ONLY: false` in your `config.yaml` file.
 
 .Procedure
 
-. Enter the following link:https://docs.redhat.com/en/documentation/red_hat_quay/3/html-single/red_hat_quay_api_guide/index#changeuserpermissions[`PUT /api/v1/repository/{repository}/permissions/user/{username}`] command to change the permissions of a user:
+. Enter the following link:https://docs.redhat.com/en/documentation/red_hat_quay/{producty}/html-single/red_hat_quay_api_guide/index#changeuserpermissions[`PUT /api/v1/repository/{repository}/permissions/user/{username}`] command to change the permissions of a user:
 +
 [source,terminal]
 ----
@@ -36,7 +36,7 @@ $ curl -X PUT \
 {"role": "admin", "name": "quayadmin+test", "is_robot": true, "avatar": {"name": "quayadmin+test", "hash": "ca9afae0a9d3ca322fc8a7a866e8476dd6c98de543decd186ae090e420a88feb", "color": "#8c564b", "kind": "robot"}}
 ----
 
-. To delete the current permission, you can enter the link:https://docs.redhat.com/en/documentation/red_hat_quay/3/html-single/red_hat_quay_api_guide/index#deleteuserpermissions[`DELETE /api/v1/repository/{repository}/permissions/user/{username}`] command:
+. To delete the current permission, you can enter the link:https://docs.redhat.com/en/documentation/red_hat_quay/{producty}/html-single/red_hat_quay_api_guide/index#deleteuserpermissions[`DELETE /api/v1/repository/{repository}/permissions/user/{username}`] command:
 +
 [source,terminal]
 ----
@@ -46,7 +46,7 @@ $ curl -X DELETE \
   https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository>/permissions/user/<username>
 ----
 +
-This command does not return any output in the CLI. Instead, you can check that the permissions were deleted by entering the link:https://docs.redhat.com/en/documentation/red_hat_quay/3/html-single/red_hat_quay_api_guide/index#listrepouserpermissions[`GET /api/v1/repository/{repository}/permissions/user/`] command:
+This command does not return any output in the CLI. Instead, you can check that the permissions were deleted by entering the link:https://docs.redhat.com/en/documentation/red_hat_quay/{producty}/html-single/red_hat_quay_api_guide/index#listrepouserpermissions[`GET /api/v1/repository/{repository}/permissions/user/`] command:
 +
 [source,terminal]
 ----

modules/adjusting-repository-access-via-the-api.adoc

@@ -11,7 +11,7 @@ The visibility of your repository can be set to `private` or `public` by using t
 
 .Prerequisites 
 
-* You have link:https://access.redhat.com/documentation/en-us/red_hat_quay/3/html-single/red_hat_quay_api_guide/index#creating-oauth-access-token[Created an OAuth access token].
+* You have link:https://access.redhat.com/documentation/en-us/red_hat_quay/{producty}/html-single/red_hat_quay_api_guide/index#creating-oauth-access-token[Created an OAuth access token].
 * You have set `BROWSER_API_CALLS_XHR_ONLY: false` in your `config.yaml` file.
 * You have created a repository. 
 

modules/api-tag-deleteFullTag.adoc

@@ -35,3 +35,12 @@ _required_|The name of the tag|string
 |403|Unauthorized access|<<_apierror,ApiError>>
 |404|Not found|<<_apierror,ApiError>>
 |===
+
+[discrete]
+== Example command
+
+[source,terminal]
+----
+$ curl -X DELETE "https://quay-server.example.com/api/v1/repository/<namespace>/<repo_name>/tag/<tag_name>" \
+  -H "Authorization: Bearer <your_access_token>"
+----