Versions Compared

Key

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

Table of Contents
maxLevel1

Get

 

Get a List of Profiles

DescriptionGet a list of profiles

URL

/api/profiles/list

HTTP MethodGET
Response Formatsjson

Security

None
Available sinceSonar Version 3.3

Examples

Response Format

Code Block
titleJSON
languagejavascript
[
  {
    "name":"Sonar way with Findbugs",
    "language":"java",
    "default":false
  },
  {
    "name":"Sonar way",
    "language":"java",
    "default":false
  },
  ...
]

Parameters

Parameter

Description

Required

Default Value

Example Value

language

Profile language

No

None

java

project

Project key or id

No

None

org.codehaus.sonar:sonar

format

Response

formats.
Possible values: json

format can be set through:

  • Parameter format: json
  • Or the 'Accept' property in the HTTP header:
  • Accept:application/json

If nothing is set, json is used.

NoNonejson

Get Coding Rules Activated in a Quality Profile

...

Parameter

Description

Required

Default Value

Example Value

language

Project language

Yes

None

java

name

Profile name. If not set, the default profile for the selected language is used.

No

None

Sonar%20way

rule_repositories

Comma-separated list of rules repository keys.

No

None

pmd,findbugs

rule_severities

Comma-separated list of rule severities.
Possible values: BLOCKER | CRITICAL | MAJOR | MINOR | INFO.

No

None

BLOCKER,CRITICAL

format

Response

formats.
Possible values

format can be set through:

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

Backup a Quality Profile

DescriptionBackup a quality profile

URL

/api/profiles/backup

HTTP MethodGET
Response Formatsjson | xml
Security

Requires Global Administrator roleAdminister Quality Profiles permission

Available sinceSonar Version 3.1

Examples

Use CaseExample Request
Backup the default java quality profile

GET http://localhost:9000/api/profiles/backup?language=java

Backup the java quality profile 'Sonar%20way'

GET http://localhost:9000/api/profiles/backup?language=java&name=Sonar%20way

...

Code Block
titleJSON
languagejavascript
{
  "backup":
  "<?xml version=\"1.0\" encoding=\"UTF-8\"?>
   <!-- Generated by Sonar -->
   <profile>
     <name>Sonar for Sonar</name>
     <language>java</language>
     <rules>
       <rule>
         <repositoryKey>checkstyle</repositoryKey>
         <key>com.puppycrawl.tools.checkstyle.checks.TodoCommentCheck_1296413157</key>
         <priority>INFO</priority>
         <parameters>
           <parameter>
             <key>format</key><value>TODO</value>
          </parameter>
        </parameters>
      </rule>
      ...
    </rules>
    <alerts>
      <alert>
        <metric>blocker_violations</metric>
        <operator>&gt;</operator>
        <warning></warning>
        <error>0</error>
      </alert>
      ...
    </alerts>
  </profile>"
}

Parameters

Parameter

Description

Required

Default Value

Example Value

language

Project language

Yes

None

java

name

Profile name. If not set, the default profile for the selected language is used.

No

None

Sonar%20way

format

Response formats.
Possible values: json | xmlformat can be set through:

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

Restore a Quality Profile Backup

DescriptionRestore a quality profile backup

URL

/api/profiles/restore

HTTP MethodPOST
Security

Requires Global Administrator roleAdminister Quality Profiles permission

Available sinceSonar Version 3.1

Examples

Use CaseExample Request
Restore a quality profile from a backup

curl -X POST -u admin:admin -F 'backup=@backup.com' -v http://localhost:9000/api/profiles/restore

...

DescriptionDelete a quality profile

URL

/api/profiles/destroy

HTTP MethodPOST
Security

Requires Global Administrator roleAdminister Quality Profiles permission

Available sinceSonar Version 3.3

Examples

Use CaseExample Request
Delete the java quality profile Sonar%way'Sonar way'

curl -u admin:admin -d "language=java&name=Sonar way" -X POST http://localhost:9000/api/profiles/destroy

...

Parameter

Description

Required

Default ValueExample Value

language

Profile language

Yes

Nonejava
nameProfile nameYesNoneSonar way

Set a Quality Profile as Default

DescriptionDelete a quality profile

URL

/api/profiles/set_as_default

HTTP MethodPOST
Security

Requires Administer Quality Profiles permission

Available sinceVersion 3.3

Examples

Use CaseExample Request
Set the java quality profile 'Sonar way' as default

curl -u admin:admin -d "language=java&name=Sonar way" -X POST http://localhost:9000/api/profiles/set_as_default

Parameters

Parameter

Description

Required

Default ValueExample Value

language

Profile language

Yes

Nonejava
nameProfile nameYesNoneSonar way