This API is used to query information about tags bound to RDS instances under the current account. The limitations are as follows:

  • If the user enters an instance ID, all tags bound to this instance are queried and the other filter conditions are not valid.
  • When you query tags, if only TagKey is provided and no TagValue is provided, results for all tags matching the TagKey condition are returned. If both TagKey and TagValue are provided, only results for tags matching both conditions are returned.

Request Parameters

Name Type Required or not Description
Action String Yes Required parameter. Value: DescribeTags.
RegionId String Yes Region where the instance is located. For example, cn-hangzhou.
DBInstanceId String No Instance ID. If this parameter is entered, all other filter conditions are invalid.
Tags Json String No
  • The list of tags to be queried, including the TagKey and TagValue.
  • The TagKey cannot be blank, but the TagValue can.
  • Format sample: {“key1”:”value1”}.

Return Parameters

Name Type Description
<Public Return Parameters> None For more information, see Public parameters.
Items List<TagInfos> Arrays composed of tag information


Name Type Description
TagKey String TagKey
TagValue String TagValue
DBInstanceIds List<DBInstanceId> IDs of instances bound to this tag


Name Type Description
DBInstanceId String Instance ID