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

/buckets/string/bundles/string

Example HTTP response


         {
  "link" : {
    "href" : "string",
    "params" : {
      "string" : "string"
    }
  },
  "versionMetadata" : {
    "link" : {
      "href" : "string",
      "params" : {
        "string" : "string"
      }
    },
    "id" : "string",
    "bundleId" : "string",
    "bucketId" : "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
    }
  },
  "filename" : "string"
}