Full documentation for SonarQube has moved to a new location: http://docs.sonarqube.org/display/SONAR

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Next »

Table of Contents

Get a List of Profiles

DescriptionGet a list of profiles

URL

/api/profiles/list

HTTP MethodGET
Response Formatsjson

Security

None
Available sinceSonar 3.3

Examples

Use Case

Example Request

Get all the profiles

GET http://nemo.sonarsource.org/api/profiles/list

Get all the java profiles

GET http://nemo.sonarsource.org/api/profiles/list?language=java

Get all the profiles used by project org.codehaus.sonar:sonar

GET http://nemo.sonarsource.org/api/profiles/list?project=org.codehaus.sonar:sonar

Get the java profile used by project org.codehaus.sonar:sonar

GET http://nemo.sonarsource.org/api/profiles/list?project=org.codehaus.sonar:sonar&language=java

Response Format

JSON

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

formatResponse formats.
Possible values: json
NoNonejson

Get Coding Rules Activated in a Quality Profile

DescriptionGet the list of coding rules activated in a quality profile

URL

/api/profiles

HTTP MethodGET
Response Formatsjson | xml

Security

None

Examples

Use CaseExample Request
Get all the coding rules activated on the default java quality profile

GET http://nemo.sonarsource.org/api/profiles?language=java

Get all the coding rules activated on the java quality profile 'Common rules'

GET http://nemo.sonarsource.org/api/profiles?language=java&name=Common%20rules

Response Format

JSON

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

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

formatResponse formats.
Possible values: xml | json
NoNonejson

Backup a Quality Profile

DescriptionBackup a quality profile

URL

/api/profiles/backup

HTTP MethodGET
Response Formatsjson | xml
Security

Requires Global Administrator role

Available sinceSonar 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

Response Format

JSON

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 | xml

NoNonejson

Restore a Quality Profile Backup

DescriptionRestore a quality profile backup

URL

/api/profiles/restore

HTTP MethodPOST
Security

Requires Global Administrator role

Available sinceSonar 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

Parameters

Parameter

Description

Required

backup

Path to the file containing the backup (HTML format)

Yes

Delete a Quality Profile

DescriptionDelete a quality profile

URL

/api/profiles/destroy

HTTP MethodPOST
Security

Requires Global Administrator role

Available sinceSonar 3.3

Examples

Use CaseExample Request
Delete the java profile Sonar%way

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

Parameters

Parameter

Description

Required

Default ValueExample Value

language

Profile language

Yes

Nonejava
nameProfile nameYesNoneSonar way
  • No labels