Get cost tag metadata, assigned users, or resources

GET 
/cost-management/tags/:key

Without action, returns tag metadata for {key} (gzip supported via Accept-Encoding). With action=getusers or getresources, returns assignments for a TagValue. value is required for assignment queries unless retrieveall=yes (getresources only returns full tag resource details when retrieveall=yes). Invalid action returns IPV-1041. Response body is oneOf variants under CostTagByKeyResponseBody (metadata, users, or resources).

Request

Responses

200

Tag metadata or assignment payload. Shape depends on action (oneOf CostTagByKeyResponseBody).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Validation failure. Body is {"Message": " - "}. Common codes: IPV-1041 (invalid action), IPV-1002 (unknown tag/value), GE-1034 (access/authorization failures).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend failure. Body is {"Message": " - "}.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers