3.2.2. Create extension bundle version
POST /buckets/{bucketId}/bundles/{bundleType}
Description
Creates a version of an extension bundle by uploading a binary artifact. If an extension bundle already exists in the given bucket with the same group id and artifact id as that of the bundle being uploaded, then it will be added as a new version to the existing bundle. If an extension bundle does not already exist in the given bucket with the same group id and artifact id, then a new extension bundle will be created and this version will be added to the new bundle. Client's may optionally supply a SHA-256 in hex format through the multi-part form field 'sha256'. If supplied, then this value will be compared against the SHA-256 computed by the server, and the bundle will be rejected if the values do not match. If not supplied, the bundle will be accepted, but will be marked to indicate that the client did not supply a SHA-256 during creation.
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Path |
bucketId required |
The bucket identifier |
string |
Path |
bundleType required |
The type of the bundle |
enum (nifi-nar, minifi-cpp) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
successful operation |
BundleVersion |
400 |
NiFi Registry was unable to complete the request because it was invalid. The request should not be retried without modification. |
No Content |
401 |
Client could not be authenticated. |
No Content |
403 |
Client is not authorized to make this request. |
No Content |
404 |
The specified resource could not be found. |
No Content |
409 |
NiFi Registry was unable to complete the request because it assumes a server state that is not valid. |
No Content |
Consumes
-
multipart/form-data
Produces
-
application/json
Security
Type | Name |
---|---|
apiKey |
Authorization |
Example HTTP request
Request path
/buckets/string/bundles/string
Example HTTP response
Response 200
{
"link" : {
"href" : "string",
"params" : {
"string" : "string"
}
},
"versionMetadata" : {
"link" : {
"href" : "string",
"params" : {
"string" : "string"
}
},
"id" : "string",
"bundleId" : "string",
"bucketId" : "string",
"groupId" : "string",
"artifactId" : "string",
"version" : "string",
"timestamp" : 0,
"author" : "string",
"description" : "string",
"sha256" : "string",
"sha256Supplied" : true,
"contentSize" : 0,
"systemApiVersion" : "string",
"buildInfo" : {
"buildTool" : "string",
"buildFlags" : "string",
"buildBranch" : "string",
"buildTag" : "string",
"buildRevision" : "string",
"built" : 0,
"builtBy" : "string"
}
},
"dependencies" : [ {
"groupId" : "string",
"artifactId" : "string",
"version" : "string"
} ],
"bundle" : {
"link" : {
"href" : "string",
"params" : {
"string" : "string"
}
},
"identifier" : "string",
"name" : "string",
"description" : "string",
"bucketIdentifier" : "string",
"bucketName" : "string",
"createdTimestamp" : 0,
"modifiedTimestamp" : 0,
"type" : "string",
"permissions" : {
"canRead" : true,
"canWrite" : true,
"canDelete" : true
},
"bundleType" : "string",
"groupId" : "string",
"artifactId" : "string",
"versionCount" : 0
},
"bucket" : {
"link" : {
"href" : "string",
"params" : {
"string" : "string"
}
},
"identifier" : "string",
"name" : "string",
"createdTimestamp" : 0,
"description" : "string",
"allowBundleRedeploy" : true,
"allowPublicRead" : true,
"permissions" : {
"canRead" : true,
"canWrite" : true,
"canDelete" : true
},
"revision" : {
"clientId" : "string",
"version" : 0,
"lastModifier" : "string"
}
},
"filename" : "string"
}