Get a tag by its ID

get/tags/{tagId}
Internal-Use Only

Get a tag by its ID

Request Samples

1

Response Samples

1{
2  "creationTimeStamp": "2021-04-13T00:00:00Z",
3  "createdBy": "sasuser",
4  "modifiedTimeStamp": "2021-04-13T00:00:00Z",
5  "modifiedBy": "sasuser",
6  "id": "a56ce67a-54e0-44e4-bce2-2398a8b27b2e",
7  "links": [
8    {
9      "method": "GET",
10      "rel": "self",
11      "href": "/catalog/tags/a56ce67a-54e0-44e4-bce2-2398a8b27b2e?memberStart=0&memberLimit=2147483647",
12      "uri": "/catalog/tags/a56ce67a-54e0-44e4-bce2-2398a8b27b2e?memberStart=0&memberLimit=2147483647",
13      "type": "application/vnd.sas.metadata.tag"
14    },
15    {
16      "method": "GET",
17      "rel": "up",
18      "href": "/catalog/tags",
19      "uri": "/catalog/tags",
20      "type": "application/vnd.sas.collection",
21      "itemType": "application/vnd.sas.metadata.tag.summary"
22    },
23    {
24      "method": "PUT",
25      "rel": "update",
26      "href": "/catalog/tags/a56ce67a-54e0-44e4-bce2-2398a8b27b2e",
27      "uri": "/catalog/tags/a56ce67a-54e0-44e4-bce2-2398a8b27b2e",
28      "type": "application/vnd.sas.metadata.tag",
29      "responseType": "application/vnd.sas.metadata.tag"
30    },
31    {
32      "method": "DELETE",
33      "rel": "delete",
34      "href": "/catalog/tags/a56ce67a-54e0-44e4-bce2-2398a8b27b2e",
35      "uri": "/catalog/tags/a56ce67a-54e0-44e4-bce2-2398a8b27b2e"
36    }
37  ],
38  "version": 1,
39  "name": "Sales",
40  "members": {
41    "version": 1,
42    "type": "id",
43    "template": "/catalog/instances/{id}",
44    "resources": [
45      "b7a9f8f7-e939-2f4d-bb4b-b6740702f2bf",
46      "91411bc6-a921-e443-80f0-c89c9c9216e6"
47    ]
48  }
49}

Path Parameters

NameTypeRequiredDescription
tagId
string
true

The ID of the Tag

Query Parameters

NameTypeRequiredDescription
memberFilter
string<filter-criteria>
false

Filter criteria for returned tag member objects. See Filtering in REST APIs. The entity instance properties that can be used as filter criteria are:

  • id,
  • name,
  • label,
  • description,
  • type,
  • createdBy,
  • creationTimeStamp,
  • modifiedBy, and
  • modifiedTimeStamp
memberLimit
integer
false

Maximum number of tag member objects to return. Defaults to 10.

Default:
10
memberStart
integer
false

0-based Offset of first tag member object to return. Defaults to 0.

Header Parameters

NameTypeRequiredDescription
Accept
string
false

The desired representation for the response.

Allowed values:
application/vnd.sas.metadata.tag+jsonapplication/vnd.sas.metadata.tag.summary+jsonapplication/json
Default:
application/vnd.sas.metadata.tag+json

Responses

StatusMeaningDescription
200OKThe request succeeded.HeadersSchema
400Bad RequestBad request (the request is not well-formed).Schema
401UnauthorizedNot authenticated.Schema
403ForbiddenThe user does not have permission to complete this request.Schema
404Not FoundThe specified resource was not found.Schema