Jump to

• Request
• Response
• Examples

View Resource Usage tags applied on an Account

get

/metering/api/v1/usage/{accountId}/tags

Retrieve all tags applied on usage posted for a given account.

Request

Path Parameters

• accountId: string
  Account name, starts with cacct.

Query Parameters

• tagType: string
  tagType can be NATIVE , NON-NATIVE or ALL. OCI tags are non-native

  Default Value: NATIVE

Back to Top

Response

Supported Media Types

• application/vnd.com.oracle.oraclecloud.metering.usage+json

200 Response

Success

Body ()

Root Schema : AccountUsageTags

Type: object

Title: AccountUsageTags

Show Source

• accountId(optional): string
• canonicalLink(optional): string
• items(optional): array items

{
    "type":"object",
    "title":"AccountUsageTags",
    "properties":{
        "accountId":{
            "description":"",
            "type":"string"
        },
        "items":{
            "description":"",
            "type":"array",
            "items":{
                "type":"array",
                "items":{
                    "$ref":"#/definitions/json_UsageTag"
                }
            }
        },
        "canonicalLink":{
            "description":"",
            "type":"string"
        }
    },
    "description":""
}

Nested Schema : items

Type: array

Show Source

• Array of: array items

{
    "description":"",
    "type":"array",
    "items":{
        "type":"array",
        "items":{
            "$ref":"#/definitions/json_UsageTag"
        }
    }
}

Nested Schema : items

Type: array

Show Source

• Array of: object UsageTag
  Title: UsageTag

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/json_UsageTag"
    }
}

Nested Schema : UsageTag

Type: object

Title: UsageTag

Show Source

• createdOn(optional): object createdOn
• tag(optional): string
  Text representing a tag.
• tagType(optional): string
  Native or non-native. OCI tags are non-native.

{
    "type":"object",
    "title":"UsageTag",
    "properties":{
        "tag":{
            "description":"Text representing a tag.",
            "type":"string"
        },
        "tagType":{
            "description":"Native or non-native. OCI tags are non-native.",
            "type":"string"
        },
        "createdOn":{
            "description":"",
            "type":"object"
        }
    },
    "description":""
}

Nested Schema : createdOn

Type: object

Default Response

Unexpected error.

Back to Top

Examples

These APIs are deprecated. See Cost Analysis Overview, Using the API for more information on how to track and optimize your Oracle Cloud Infrastructure spending. See the Deprecated Notices (Endpoints) to see if there is a replacement endpoint.

Back to Top