Registries

APIs to create, update, list registries

Create Registry.

Create a Registry.

Securityx-api-key

Request

query Parameters

space_ref

string

Unique space path

Request Body schema: application/json

request for create and update registry

allowedPattern	Array of strings
blockedPattern	Array of strings
	Array of objects (CleanupPolicy)
	object (RegistryConfig) SubConfig specific for Virtual or Upstream Registry
description	string
identifier required	string
labels	Array of strings
packageType required	string (PackageType) refers to package Enum: "DOCKER" "MAVEN" "GENERIC" "HELM"
parentRef	string
	Array of objects (Scanner)

Responses

201

response for create, get and update registry

400

Bad request

401

Unauthenticated

403

Unauthorized

500

Internal server error

post/har/api/v1/registry

Request samples

Payload
curl
Java
Go

application/json

{"allowedPattern": ["string"
],
"blockedPattern": ["string"
],
"cleanupPolicy": [{"expireDays": 0,
"name": "string",
"packagePrefix": ["string"
],
"versionPrefix": ["string"
]
}
],
"config": {"type": "VIRTUAL",
"upstreamProxies": ["string"
]
},
"description": "string",
"identifier": "string",
"labels": ["string"
],
"packageType": "DOCKER",
"parentRef": "string",
"scanners": [{"name": "AQUA_TRIVY"
}
]
}

Response samples

application/json

{"data": {"allowedPattern": ["string"
],
"blockedPattern": ["string"
],
"cleanupPolicy": [{"expireDays": 0,
"name": "string",
"packagePrefix": ["string"
],
"versionPrefix": ["string"
]
}
],
"config": {"type": "VIRTUAL",
"upstreamProxies": ["string"
]
},
"createdAt": "string",
"description": "string",
"identifier": "string",
"labels": ["string"
],
"modifiedAt": "string",
"packageType": "DOCKER",
"url": "string"
},
"status": "SUCCESS"
}

Delete a Registry

Delete a Registry in the account for the given key

Securityx-api-key

Request

path Parameters

registry_ref

required

string

Unique registry path.

Responses

200

Success Response

400

Bad request

401

Unauthenticated

403

Unauthorized

404

The specified resource was not found

500

Internal server error

delete/har/api/v1/registry/{registry_ref}

Request samples

curl
Java
Go

Response samples

application/json

{"status": "SUCCESS"
}

Returns Registry Details

Returns Registry Details in the account for the given key

Securityx-api-key

Request

path Parameters

registry_ref

required

string

Unique registry path.

Responses

200

response for create, get and update registry

400

Bad request

401

Unauthenticated

403

Unauthorized

404

The specified resource was not found

500

Internal server error

get/har/api/v1/registry/{registry_ref}

Request samples

curl
Java
Go

Response samples

application/json

{"data": {"allowedPattern": ["string"
],
"blockedPattern": ["string"
],
"cleanupPolicy": [{"expireDays": 0,
"name": "string",
"packagePrefix": ["string"
],
"versionPrefix": ["string"
]
}
],
"config": {"type": "VIRTUAL",
"upstreamProxies": ["string"
]
},
"createdAt": "string",
"description": "string",
"identifier": "string",
"labels": ["string"
],
"modifiedAt": "string",
"packageType": "DOCKER",
"url": "string"
},
"status": "SUCCESS"
}

Updates a Registry

Updates a Registry in the account for the given key

Securityx-api-key

Request

path Parameters

registry_ref

required

string

Unique registry path.

Request Body schema: application/json

request for create and update registry

allowedPattern	Array of strings
blockedPattern	Array of strings
	Array of objects (CleanupPolicy)
	object (RegistryConfig) SubConfig specific for Virtual or Upstream Registry
description	string
identifier required	string
labels	Array of strings
packageType required	string (PackageType) refers to package Enum: "DOCKER" "MAVEN" "GENERIC" "HELM"
parentRef	string
	Array of objects (Scanner)

Responses

200

response for create, get and update registry

400

Bad request

401

Unauthenticated

403

Unauthorized

404

The specified resource was not found

500

Internal server error

put/har/api/v1/registry/{registry_ref}

Request samples

Payload
curl
Java
Go

application/json

{"allowedPattern": ["string"
],
"blockedPattern": ["string"
],
"cleanupPolicy": [{"expireDays": 0,
"name": "string",
"packagePrefix": ["string"
],
"versionPrefix": ["string"
]
}
],
"config": {"type": "VIRTUAL",
"upstreamProxies": ["string"
]
},
"description": "string",
"identifier": "string",
"labels": ["string"
],
"packageType": "DOCKER",
"parentRef": "string",
"scanners": [{"name": "AQUA_TRIVY"
}
]
}

Response samples

application/json

{"data": {"allowedPattern": ["string"
],
"blockedPattern": ["string"
],
"cleanupPolicy": [{"expireDays": 0,
"name": "string",
"packagePrefix": ["string"
],
"versionPrefix": ["string"
]
}
],
"config": {"type": "VIRTUAL",
"upstreamProxies": ["string"
]
},
"createdAt": "string",
"description": "string",
"identifier": "string",
"labels": ["string"
],
"modifiedAt": "string",
"packageType": "DOCKER",
"url": "string"
},
"status": "SUCCESS"
}

List Artifacts for Registry

Lists all the Artifacts for Registry

Securityx-api-key

Request

path Parameters

registry_ref

required

string

Unique registry path.

query Parameters

label	Array of strings Label.
page	integer <int64> Default: 1 Current page number
size	integer <int64> Default: 20 Number of items per page
sort_order	string sortOrder
sort_field	string sortField
search_term	string search Term.

Responses

200

response for list artifact

400

Bad request

401

Unauthenticated

403

Unauthorized

404

The specified resource was not found

500

Internal server error

get/har/api/v1/registry/{registry_ref}/artifacts

Request samples

curl
Java
Go

Response samples

application/json

{"data": {"artifacts": [{"downloadsCount": 0,
"labels": ["string"
],
"lastModified": "string",
"latestVersion": "string",
"name": "string",
"packageType": "DOCKER",
"registryIdentifier": "string",
"registryPath": "string"
}
],
"itemCount": 1,
"pageCount": 100,
"pageIndex": 0,
"pageSize": 1
},
"status": "SUCCESS"
}

Returns CLI Client Setup Details

Returns CLI Client Setup Details based on package type

Securityx-api-key

Request

path Parameters

registry_ref

required

string

Unique registry path.

query Parameters

artifact	string Artifat
version	string Version

Responses

200

response for client setup details

400

Bad request

401

Unauthenticated

403

Unauthorized

404

The specified resource was not found

500

Internal server error

get/har/api/v1/registry/{registry_ref}/client-setup-details

Request samples

curl
Java
Go

Response samples

application/json

{"data": {"mainHeader": "string",
"secHeader": "string",
"sections": [{"header": "string",
"steps": [{"commands": [{"label": null,
"value": null
}
],
"header": "string",
"type": "Static"
}
]
}
]
},
"status": "SUCCESS"
}

➔ Next to Artifacts