Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info
iconfalse
titleTable of Contents

Table of Contents
maxLevel1

Get a List of Rules

DescriptionGet a list of rules

URL

/api/rules

HTTP MethodGET
Response Formatsjson | xml | csv

Security

None

...

Parameter

Description

Required

Default Value

Example Value

language

Key of the language

No

Nonejava

plugin

Comma-separated list of rules plugins

No

None

findbugs,pmd

searchtext

To filter on rules containing a specified text in their name, key or title

No

None

braces

profile

When this parameter is defined, a node 'status' is added for each 'rule' node with values 'INACTIVE' or 'ACTIVE'.
It is recommended to use the /api/profiles web service instead. 

No

None

Sonar%20way

priorities

List of INACTIVE, ACTIVE, BLOCKER, CRITICAL, MAJOR, MINOR, INFO.
It is recommended to use the /api/profiles web service instead of ACTIVE and INACTIVE.

No

None

BLOCKER,CRITICAL

format

Response format can be set through:

  • Parameter format: xml | json | csv
  • Or the 'Accept' property in the HTTP header:
    • Accept:text/xml
    • Accept:application/json
If nothing is set, json is used.
NoNonejson

Add Tags to a Rule

DescriptionAdd tags to a rule

URL

/api/rule_tags/add

HTTP MethodPOST

Security

Requires Administer Quality Profiles permission

Available sinceVersion 4.2

Examples

Use CaseExample Request
Add tags "mytag" and "yourtag" to rule "squid:S1219" 

curl -X POST -v -u admin:admin "http://localhost:9000/api/rules/add_tags?key=squid:S1219&tags=mytag,yourtag"

Parameters

Parameter

Description

Required

Default Value

Example Value

key

Rule keyYes

None

squid:S1219

tagsComma-separated list of tagsYesNonemytag,yourtag

Remove Tags From a Rule

DescriptionRemove tags from a rule

URL

/api/rule_tags/remove

HTTP MethodPOST

Security

Requires Administer Quality Profiles permission

Available sinceVersion 4.2

Examples

Use CaseExample Request
Remove tags "mytag" and "yourtag" from rule "squid:S1219" 

curl -X POST -v -u admin:admin "http://localhost:9000/api/rules/remove_tags?key=squid:S1219&tags=mytag,yourtag"

Parameters

Parameter

Description

Required

Default Value

Example Value

key

Rule keyYes

None

squid:S1219

tagsComma-separated list of tagsYesNonemytag,yourtag