Help Center> CodeArts Pipeline> API Reference> API> Tenant-level open source governance policy management> Creating a Tenant-Level Open Source Governance Policy
Updated on 2023-11-28 GMT+08:00

Creating a Tenant-Level Open Source Governance Policy

Function

Creating a Tenant-Level Open Source Governance Policy

URI

POST /v2/{domain_id}/tenant/open-source/rule-sets/create

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

domain_id

Yes

String

Indicates the tenant ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token. Can be obtained by calling the IAM API for obtaining the user token (the value of X-Subject-Token in the response header).

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

name

Yes

String

Open Source Governance Policy Name

content

Yes

OpenSourceRuleContent object

Open Source Governance Policy Rule Details

Table 4 OpenSourceRuleContent

Parameter

Mandatory

Type

Description

version_set

No

VersionSetProperty object

Open-source dependencies

security

No

SecurityProperty object

Vulnerability

license

No

LicenseProperty object

License

Table 5 VersionSetProperty

Parameter

Mandatory

Type

Description

enable

No

Boolean

Enable Configuration

rules

No

Array of VersionSetRule objects

Rule list.

Table 6 VersionSetRule

Parameter

Mandatory

Type

Description

enable

No

Boolean

Health Check

ecosystem

No

String

Dependency Degree

package_name

No

String

Package name

package_version

No

String

Package Version

description

No

String

Rules

predicate

No

String

Comparison Rule

Table 7 SecurityProperty

Parameter

Mandatory

Type

Description

enable

No

Boolean

Enable Configuration

rules

No

SecurityRule object

Rule Details

Table 8 SecurityRule

Parameter

Mandatory

Type

Description

severity

No

severity object

Severity

cve

No

cve object

Vulnerability ID

Table 9 severity

Parameter

Mandatory

Type

Description

enable

No

Boolean

Enable Configuration

values

No

Array of strings

Severity

Table 10 cve

Parameter

Mandatory

Type

Description

enable

No

Boolean

Enable Configuration

values

No

Array of strings

Vulnerability ID

Table 11 LicenseProperty

Parameter

Mandatory

Type

Description

enable

No

Boolean

Health Check

rules

No

Array of rules objects

Rule list.

Table 12 rules

Parameter

Mandatory

Type

Description

values

No

Array of strings

License Details

predicate

No

String

Comparison Rule

Response Parameters

Status code: 200

Table 13 Response body parameters

Parameter

Type

Description

status

Boolean

Status

rule_set_id

String

Rule Set ID

Status code: 400

Table 14 Response body parameters

Parameter

Type

Description

error_msg

String

Error Message

error_code

String

Error code.

Example Requests

POST https://{endpoint}/v2/ce8df55870164338a72d7e828a966a2a/tenant/open-source/rule-sets/create

{
  "name" : "Creating an Open Source Governance Policy - 20231020180239",
  "content" : {
    "version_set" : {
      "enable" : true,
      "rules" : [ {
        "ecosystem" : "Maven",
        "package_name" : "sboot",
        "predicate" : "eq",
        "package_version" : "1.1",
        "description" : "",
        "enable" : true
      } ]
    },
    "security" : {
      "enable" : true,
      "rules" : {
        "severity" : {
          "enable" : false,
          "values" : [ ]
        },
        "cve" : {
          "enable" : false,
          "values" : [ "" ]
        }
      }
    },
    "license" : {
      "enable" : true,
      "rules" : [ {
        "values" : [ ],
        "predicate" : "contain"
      } ]
    }
  }
}

Example Responses

Status code: 200

OK

{
  "status" : true,
  "rule_set_id" : "1ea8a33ca6d64efab19a99057625a14d"
}

Status Codes

Status Code

Description

200

OK

400

Bad request

401

Unauthorized

403

Forbidden

404

Not Found

Error Codes

See Error Codes.