blob: b2a18dc17b18a5559cad289ad1bec4bfb0c25e3f [file] [log] [blame]
{
"swagger" : "2.0",
"info" : {
"description" : "This provides the REST API for admin\n operations",
"version" : "v1",
"title" : "Pulsar Admin REST API",
"license" : {
"name" : "Apache 2.0",
"url" : "http://www.apache.org/licenses/LICENSE-2.0.html"
}
},
"basePath" : "/admin",
"tags" : [ {
"name" : "broker-stats"
}, {
"name" : "brokers"
}, {
"name" : "clusters"
}, {
"name" : "namespaces"
}, {
"name" : "non-persistent topic"
}, {
"name" : "persistent topic"
}, {
"name" : "properties"
}, {
"name" : "resource-quotas"
} ],
"schemes" : [ "http", "https" ],
"paths" : {
"/broker-stats/allocator-stats/{allocator}" : {
"get" : {
"tags" : [ "broker-stats" ],
"summary" : "Get the stats for the Netty allocator. Available allocators are 'default' and 'ml-cache'",
"description" : "",
"operationId" : "getAllocatorStats",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "allocator",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/AllocatorStats"
}
},
"403" : {
"description" : "Don't have admin permission"
}
}
}
},
"/broker-stats/bookieops" : {
"get" : {
"tags" : [ "broker-stats" ],
"summary" : "Get pending bookie client op stats by namesapce",
"description" : "",
"operationId" : "getPendingBookieOpsStats",
"produces" : [ "application/json" ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "object",
"additionalProperties" : {
"$ref" : "#/definitions/PendingBookieOpsStats"
}
}
},
"403" : {
"description" : "Don't have admin permission"
}
}
}
},
"/broker-stats/broker-resource-availability/{property}/{cluster}/{namespace}" : {
"get" : {
"tags" : [ "broker-stats" ],
"summary" : "Broker availability report",
"description" : "This API gives the current broker availability in percent, each resource percentage usage is calculated and thensum of all of the resource usage percent is called broker-resource-availability<br/><br/>THIS API IS ONLY FOR USE BY TESTING FOR CONFIRMING NAMESPACE ALLOCATION ALGORITHM",
"operationId" : "getBrokerResourceAvailability",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "object",
"additionalProperties" : {
"$ref" : "#/definitions/ResourceUnit"
}
}
},
"403" : {
"description" : "Don't have admin permission"
},
"409" : {
"description" : "Load-manager doesn't support operation"
}
}
}
},
"/broker-stats/destinations" : {
"get" : {
"tags" : [ "broker-stats" ],
"summary" : "Get all the destination stats by namesapce",
"description" : "",
"operationId" : "getDestinations2",
"produces" : [ "application/json" ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/OutputStream"
}
},
"403" : {
"description" : "Don't have admin permission"
}
}
}
},
"/broker-stats/load-report" : {
"get" : {
"tags" : [ "broker-stats" ],
"summary" : "Get Load for this broker",
"description" : "consists of destinationstats & systemResourceUsage",
"operationId" : "getLoadReport",
"produces" : [ "application/json" ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/LoadReport"
}
},
"403" : {
"description" : "Don't have admin permission"
}
}
}
},
"/broker-stats/mbeans" : {
"get" : {
"tags" : [ "broker-stats" ],
"summary" : "Get all the mbean details of this broker JVM",
"description" : "",
"operationId" : "getMBeans",
"produces" : [ "application/json" ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/Metrics"
}
}
},
"403" : {
"description" : "Don't have admin permission"
}
}
}
},
"/broker-stats/metrics" : {
"get" : {
"tags" : [ "broker-stats" ],
"summary" : "Gets the metrics for Monitoring",
"description" : "Requested should be executed by Monitoring agent on each broker to fetch the metrics",
"operationId" : "getMetrics",
"produces" : [ "application/json" ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/Metrics"
}
}
},
"403" : {
"description" : "Don't have admin permission"
}
}
}
},
"/brokers/configuration" : {
"get" : {
"tags" : [ "brokers" ],
"summary" : "Get all updatable dynamic configurations's name",
"description" : "",
"operationId" : "getDynamicConfigurationName",
"produces" : [ "application/json" ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"items" : {
"type" : "object"
}
}
}
}
}
},
"/brokers/configuration/values" : {
"get" : {
"tags" : [ "brokers" ],
"summary" : "Get value of all dynamic configurations' value overridden on local config",
"description" : "",
"operationId" : "getAllDynamicConfigurations",
"produces" : [ "application/json" ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "object",
"additionalProperties" : {
"type" : "object"
}
}
},
"404" : {
"description" : "Configuration not found"
}
}
}
},
"/brokers/configuration/{configName}/{configValue}" : {
"post" : {
"tags" : [ "brokers" ],
"summary" : "Update dynamic serviceconfiguration into zk only. This operation requires Pulsar super-user privileges.",
"description" : "",
"operationId" : "updateDynamicConfiguration",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "configName",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "configValue",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"204" : {
"description" : "Service configuration updated successfully"
},
"403" : {
"description" : "You don't have admin permission to update service-configuration"
},
"404" : {
"description" : "Configuration not found"
},
"412" : {
"description" : "Configuration can't be updated dynamically"
}
}
}
},
"/brokers/{cluster}" : {
"get" : {
"tags" : [ "brokers" ],
"summary" : "Get the list of active brokers (web service addresses) in the cluster.",
"description" : "",
"operationId" : "getActiveBrokers",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"uniqueItems" : true,
"items" : {
"type" : "string"
}
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Cluster doesn't exist"
}
}
}
},
"/brokers/{cluster}/{broker}/ownedNamespaces" : {
"get" : {
"tags" : [ "brokers" ],
"summary" : "Get the list of namespaces served by the specific broker",
"description" : "",
"operationId" : "getOwnedNamespaes",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "broker",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "object",
"additionalProperties" : {
"$ref" : "#/definitions/NamespaceOwnershipStatus"
}
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Cluster doesn't exist"
}
}
}
},
"/clusters" : {
"get" : {
"tags" : [ "clusters" ],
"summary" : "Get the list of all the Pulsar clusters.",
"description" : "",
"operationId" : "getClusters",
"produces" : [ "application/json" ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"uniqueItems" : true,
"items" : {
"type" : "string"
}
}
},
"403" : {
"description" : "Don't have admin permission"
}
}
}
},
"/clusters/{cluster}" : {
"get" : {
"tags" : [ "clusters" ],
"summary" : "Get the configuration data for the specified cluster.",
"description" : "",
"operationId" : "getCluster",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/ClusterData"
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Cluster doesn't exist"
}
}
},
"post" : {
"tags" : [ "clusters" ],
"summary" : "Update the configuration for a cluster.",
"description" : "This operation requires Pulsar super-user privileges.",
"operationId" : "updateCluster",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"204" : {
"description" : "Cluster has been updated"
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Cluster doesn't exist"
}
}
},
"put" : {
"tags" : [ "clusters" ],
"summary" : "Provisions a new cluster. This operation requires Pulsar super-user privileges.",
"description" : "The name cannot contain '/' characters.",
"operationId" : "createCluster",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"204" : {
"description" : "Cluster has been created"
},
"403" : {
"description" : "You don't have admin permission to create the cluster"
},
"409" : {
"description" : "Cluster already exists"
},
"412" : {
"description" : "Cluster name is not valid"
}
}
},
"delete" : {
"tags" : [ "clusters" ],
"summary" : "Delete an existing cluster",
"description" : "",
"operationId" : "deleteCluster",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"204" : {
"description" : "Cluster has been updated"
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Cluster doesn't exist"
},
"412" : {
"description" : "Cluster is not empty"
}
}
}
},
"/clusters/{cluster}/namespaceIsolationPolicies" : {
"get" : {
"tags" : [ "clusters" ],
"summary" : "Get the namespace isolation policies assigned in the cluster",
"description" : "",
"operationId" : "getNamespaceIsolationPolicies",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "object",
"additionalProperties" : {
"$ref" : "#/definitions/NamespaceIsolationData"
}
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Cluster doesn't exist"
}
}
}
},
"/clusters/{cluster}/namespaceIsolationPolicies/{policyName}" : {
"get" : {
"tags" : [ "clusters" ],
"summary" : "Get a single namespace isolation policy assigned in the cluster",
"description" : "",
"operationId" : "getNamespaceIsolationPolicy",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "policyName",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/NamespaceIsolationData"
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Policy doesn't exist"
},
"412" : {
"description" : "Cluster doesn't exist"
}
}
},
"post" : {
"tags" : [ "clusters" ],
"summary" : "Set namespace isolation policy",
"description" : "",
"operationId" : "setNamespaceIsolationPolicy",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "policyName",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission or plicy is read only"
},
"412" : {
"description" : "Cluster doesn't exist"
}
}
},
"delete" : {
"tags" : [ "clusters" ],
"summary" : "Delete namespace isolation policy",
"description" : "",
"operationId" : "deleteNamespaceIsolationPolicy",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "policyName",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission or plicy is read only"
},
"412" : {
"description" : "Cluster doesn't exist"
}
}
}
},
"/clusters/{cluster}/peers" : {
"post" : {
"tags" : [ "clusters" ],
"summary" : "Update peer-cluster-list for a cluster.",
"description" : "This operation requires Pulsar super-user privileges.",
"operationId" : "setPeerClusterNames",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"204" : {
"description" : "Cluster has been updated"
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Cluster doesn't exist"
},
"412" : {
"description" : "Peer cluster doesn't exist"
}
}
}
},
"/namespaces/{property}" : {
"get" : {
"tags" : [ "namespaces" ],
"summary" : "Get the list of all the namespaces for a certain property.",
"description" : "",
"operationId" : "getPropertyNamespaces",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"uniqueItems" : true,
"items" : {
"type" : "string"
}
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property doesn't exist"
}
}
}
},
"/namespaces/{property}/{cluster}" : {
"get" : {
"tags" : [ "namespaces" ],
"summary" : "Get the list of all the namespaces for a certain property on single cluster.",
"description" : "",
"operationId" : "getNamespacesForCluster",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"uniqueItems" : true,
"items" : {
"type" : "string"
}
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property or cluster doesn't exist"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}" : {
"get" : {
"tags" : [ "namespaces" ],
"summary" : "Get the dump all the policies specified for a namespace.",
"description" : "",
"operationId" : "getPolicies",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/Policies"
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property or cluster or namespace doesn't exist"
}
}
},
"put" : {
"tags" : [ "namespaces" ],
"summary" : "Creates a new empty namespace with no policies attached.",
"description" : "",
"operationId" : "createNamespace",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property or cluster or namespace doesn't exist"
},
"409" : {
"description" : "Namespace already exists"
},
"412" : {
"description" : "Namespace name is not valid"
}
}
},
"delete" : {
"tags" : [ "namespaces" ],
"summary" : "Delete a namespace and all the destinations under it.",
"description" : "",
"operationId" : "deleteNamespace",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property or cluster or namespace doesn't exist"
},
"409" : {
"description" : "Namespace is not empty"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/backlogQuota" : {
"post" : {
"tags" : [ "namespaces" ],
"summary" : " Set a backlog quota for all the destinations on a namespace.",
"description" : "",
"operationId" : "setBacklogQuota",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "backlogQuotaType",
"in" : "query",
"required" : false,
"type" : "string",
"enum" : [ "destination_storage" ]
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace does not exist"
},
"409" : {
"description" : "Concurrent modification"
},
"412" : {
"description" : "Specified backlog quota exceeds retention quota. Increase retention quota and retry request"
}
}
},
"delete" : {
"tags" : [ "namespaces" ],
"summary" : "Remove a backlog quota policy from a namespace.",
"description" : "",
"operationId" : "removeBacklogQuota",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "backlogQuotaType",
"in" : "query",
"required" : false,
"type" : "string",
"enum" : [ "destination_storage" ]
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace does not exist"
},
"409" : {
"description" : "Concurrent modification"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/backlogQuotaMap" : {
"get" : {
"tags" : [ "namespaces" ],
"summary" : "Get backlog quota map on a namespace.",
"description" : "",
"operationId" : "getBacklogQuotaMap",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "object",
"additionalProperties" : {
"type" : "object"
}
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace does not exist"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/bundles" : {
"get" : {
"tags" : [ "namespaces" ],
"summary" : "Get the bundles split data.",
"description" : "",
"operationId" : "getBundlesData",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/BundlesData"
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property or cluster or namespace doesn't exist"
},
"412" : {
"description" : "Namespace is not setup to split in bundles"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/clearBacklog" : {
"post" : {
"tags" : [ "namespaces" ],
"summary" : "Clear backlog for all destinations on a namespace.",
"description" : "",
"operationId" : "clearNamespaceBacklog",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace does not exist"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/clearBacklog/{subscription}" : {
"post" : {
"tags" : [ "namespaces" ],
"summary" : "Clear backlog for a given subscription on all destinations on a namespace.",
"description" : "",
"operationId" : "clearNamespaceBacklogForSubscription",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "subscription",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace does not exist"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/deduplication" : {
"post" : {
"tags" : [ "namespaces" ],
"summary" : "Enable or disable broker side deduplication for all topics in a namespace",
"description" : "",
"operationId" : "modifyDeduplication",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property or cluster or namespace doesn't exist"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/destinations" : {
"get" : {
"tags" : [ "namespaces" ],
"summary" : "Get the list of all the destinations under a certain namespace.",
"description" : "",
"operationId" : "getDestinations",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"uniqueItems" : true,
"items" : {
"type" : "string"
}
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property or cluster or namespace doesn't exist"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/dispatchRate" : {
"get" : {
"tags" : [ "namespaces" ],
"summary" : "Get dispatch-rate configured for the namespace, -1 represents not configured yet",
"description" : "",
"operationId" : "getDispatchRate",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/DispatchRate"
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace does not exist"
}
}
},
"post" : {
"tags" : [ "namespaces" ],
"summary" : "Set dispatch-rate throttling for all topics of the namespace",
"description" : "",
"operationId" : "setDispatchRate",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/messageTTL" : {
"get" : {
"tags" : [ "namespaces" ],
"summary" : "Get the message TTL for the namespace",
"description" : "",
"operationId" : "getNamespaceMessageTTL",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "integer",
"format" : "int32"
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property or cluster or namespace doesn't exist"
}
}
},
"post" : {
"tags" : [ "namespaces" ],
"summary" : "Set message TTL in seconds for namespace",
"description" : "",
"operationId" : "setNamespaceMessageTTL",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property or cluster or namespace doesn't exist"
},
"412" : {
"description" : "Invalid TTL"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/permissions" : {
"get" : {
"tags" : [ "namespaces" ],
"summary" : "Retrieve the permissions for a namespace.",
"description" : "",
"operationId" : "getPermissions",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "object",
"additionalProperties" : {
"type" : "object"
}
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property or cluster or namespace doesn't exist"
},
"409" : {
"description" : "Namespace is not empty"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/permissions/{role}" : {
"post" : {
"tags" : [ "namespaces" ],
"summary" : "Grant a new permission to a role on a namespace.",
"description" : "",
"operationId" : "grantPermissionOnNamespace",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "role",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property or cluster or namespace doesn't exist"
},
"409" : {
"description" : "Concurrent modification"
}
}
},
"delete" : {
"tags" : [ "namespaces" ],
"summary" : "Revoke all permissions to a role on a namespace.",
"description" : "",
"operationId" : "revokePermissionsOnNamespace",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "role",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property or cluster or namespace doesn't exist"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/persistence" : {
"get" : {
"tags" : [ "namespaces" ],
"summary" : "Get the persistence configuration for a namespace.",
"description" : "",
"operationId" : "getPersistence",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/PersistencePolicies"
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace does not exist"
},
"409" : {
"description" : "Concurrent modification"
}
}
},
"post" : {
"tags" : [ "namespaces" ],
"summary" : "Set the persistence configuration for all the destinations on a namespace.",
"description" : "",
"operationId" : "setPersistence",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"400" : {
"description" : "Invalid persistence policies"
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace does not exist"
},
"409" : {
"description" : "Concurrent modification"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/replication" : {
"get" : {
"tags" : [ "namespaces" ],
"summary" : "Get the replication clusters for a namespace.",
"description" : "",
"operationId" : "getNamespaceReplicationClusters",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"items" : {
"type" : "string"
}
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property or cluster or namespace doesn't exist"
},
"412" : {
"description" : "Namespace is not global"
}
}
},
"post" : {
"tags" : [ "namespaces" ],
"summary" : "Set the replication clusters for a namespace.",
"description" : "",
"operationId" : "setNamespaceReplicationClusters",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property or cluster or namespace doesn't exist"
},
"409" : {
"description" : "Peer-cluster can't be part of replication-cluster"
},
"412" : {
"description" : "Namespace is not global or invalid cluster ids"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/retention" : {
"get" : {
"tags" : [ "namespaces" ],
"summary" : "Get retention config on a namespace.",
"description" : "",
"operationId" : "getRetention",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/RetentionPolicies"
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace does not exist"
}
}
},
"post" : {
"tags" : [ "namespaces" ],
"summary" : " Set retention configuration on a namespace.",
"description" : "",
"operationId" : "setRetention",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace does not exist"
},
"409" : {
"description" : "Concurrent modification"
},
"412" : {
"description" : "Retention Quota must exceed backlog quota"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/unload" : {
"put" : {
"tags" : [ "namespaces" ],
"summary" : "Unload namespace",
"description" : "Unload an active namespace from the current broker serving it. Performing this operation will let the brokerremoves all producers, consumers, and connections using this namespace, and close all destinations (includingtheir persistent store). During that operation, the namespace is marked as tentatively unavailable until thebroker completes the unloading action. This operation requires strictly super user privileges, since it wouldresult in non-persistent message loss and unexpected connection closure to the clients.",
"operationId" : "unloadNamespace",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property or cluster or namespace doesn't exist"
},
"412" : {
"description" : "Namespace is already unloaded or Namespace has bundles activated"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/unsubscribe/{subscription}" : {
"post" : {
"tags" : [ "namespaces" ],
"summary" : "Unsubscribes the given subscription on all destinations on a namespace.",
"description" : "",
"operationId" : "unsubscribeNamespace",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "subscription",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace does not exist"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/{bundle}" : {
"delete" : {
"tags" : [ "namespaces" ],
"summary" : "Delete a namespace bundle and all the destinations under it.",
"description" : "",
"operationId" : "deleteNamespaceBundle",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "bundle",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Property or cluster or namespace doesn't exist"
},
"409" : {
"description" : "Namespace bundle is not empty"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/{bundle}/clearBacklog" : {
"post" : {
"tags" : [ "namespaces" ],
"summary" : "Clear backlog for all destinations on a namespace bundle.",
"description" : "",
"operationId" : "clearNamespaceBundleBacklog",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "bundle",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace does not exist"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/{bundle}/clearBacklog/{subscription}" : {
"post" : {
"tags" : [ "namespaces" ],
"summary" : "Clear backlog for a given subscription on all destinations on a namespace bundle.",
"description" : "",
"operationId" : "clearNamespaceBundleBacklogForSubscription",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "subscription",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "bundle",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace does not exist"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/{bundle}/split" : {
"put" : {
"tags" : [ "namespaces" ],
"summary" : "Split a namespace bundle",
"description" : "",
"operationId" : "splitNamespaceBundle",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "bundle",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
}, {
"name" : "unload",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/{bundle}/unload" : {
"put" : {
"tags" : [ "namespaces" ],
"summary" : "Unload a namespace bundle",
"description" : "",
"operationId" : "unloadNamespaceBundle",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "bundle",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
}
}
}
},
"/namespaces/{property}/{cluster}/{namespace}/{bundle}/unsubscribe/{subscription}" : {
"post" : {
"tags" : [ "namespaces" ],
"summary" : "Unsubscribes the given subscription on all destinations on a namespace bundle.",
"description" : "",
"operationId" : "unsubscribeNamespaceBundle",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "subscription",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "bundle",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace does not exist"
}
}
}
},
"/non-persistent/{property}/{cluster}/{namespace}" : {
"get" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Get the list of destinations under a namespace.",
"description" : "",
"operationId" : "getList",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"items" : {
"type" : "string"
}
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace doesn't exist"
}
}
}
},
"/non-persistent/{property}/{cluster}/{namespace}/partitioned" : {
"get" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Get the list of partitioned topics under a namespace.",
"description" : "",
"operationId" : "getPartitionedTopicList",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"items" : {
"type" : "string"
}
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace doesn't exist"
}
}
}
},
"/non-persistent/{property}/{cluster}/{namespace}/{destination}" : {
"delete" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Delete a topic.",
"description" : "The topic cannot be deleted if there's any active subscription or producer connected to the it.",
"operationId" : "deleteTopic",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "destination",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Topic does not exist"
},
"412" : {
"description" : "Topic has active producers/subscriptions"
}
}
}
},
"/non-persistent/{property}/{cluster}/{namespace}/{destination}/all_subscription/expireMessages/{expireTimeInSeconds}" : {
"post" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Expire messages on all subscriptions of topic.",
"description" : "",
"operationId" : "expireMessagesForAllSubscriptions",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "destination",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "expireTimeInSeconds",
"in" : "path",
"required" : true,
"type" : "integer",
"format" : "int32"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Topic or subscription does not exist"
}
}
}
},
"/non-persistent/{property}/{cluster}/{namespace}/{destination}/backlog" : {
"get" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Get estimated backlog for offline topic.",
"description" : "",
"operationId" : "getBacklog",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "destination",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/PersistentOfflineTopicStats"
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace does not exist"
}
}
}
},
"/non-persistent/{property}/{cluster}/{namespace}/{destination}/internal-info" : {
"get" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Get the internal stats for the topic.",
"description" : "",
"operationId" : "getManagedLedgerInfo",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "destination",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Topic does not exist"
}
}
}
},
"/non-persistent/{property}/{cluster}/{namespace}/{destination}/internalStats" : {
"get" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Get the internal stats for the topic.",
"description" : "",
"operationId" : "getInternalStats",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "destination",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/PersistentTopicInternalStats"
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Topic does not exist"
}
}
}
},
"/non-persistent/{property}/{cluster}/{namespace}/{destination}/partitioned-stats" : {
"get" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Get the stats for the partitioned topic.",
"description" : "",
"operationId" : "getPartitionedStats",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "destination",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/PartitionedTopicStats"
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Topic does not exist"
}
}
}
},
"/non-persistent/{property}/{cluster}/{namespace}/{destination}/partitions" : {
"get" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Get partitioned topic metadata.",
"description" : "",
"operationId" : "getPartitionedMetadata",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "destination",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/PartitionedTopicMetadata"
}
},
"403" : {
"description" : "Don't have admin permission"
}
}
},
"post" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Increment partitons of an existing partitioned topic.",
"description" : "It only increments partitions of existing non-global partitioned-topic",
"operationId" : "updatePartitionedTopic",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "destination",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"409" : {
"description" : "Partitioned topic does not exist"
}
}
},
"put" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Create a partitioned topic.",
"description" : "It needs to be called before creating a producer on a partitioned topic.",
"operationId" : "createPartitionedTopic",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "destination",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"409" : {
"description" : "Partitioned topic already exist"
}
}
},
"delete" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Delete a partitioned topic.",
"description" : "It will also delete all the partitions of the topic if it exists.",
"operationId" : "deletePartitionedTopic",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "destination",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Partitioned topic does not exist"
}
}
}
},
"/non-persistent/{property}/{cluster}/{namespace}/{destination}/permissions" : {
"get" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Get permissions on a destination.",
"description" : "Retrieve the effective permissions for a destination. These permissions are defined by the permissions set at thenamespace level combined (union) with any eventual specific permission set on the destination.",
"operationId" : "getPermissionsOnDestination",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "destination",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "object",
"additionalProperties" : {
"type" : "object"
}
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace doesn't exist"
}
}
}
},
"/non-persistent/{property}/{cluster}/{namespace}/{destination}/permissions/{role}" : {
"post" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Grant a new permission to a role on a single destination.",
"description" : "",
"operationId" : "grantPermissionsOnDestination",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "destination",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "role",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace doesn't exist"
},
"409" : {
"description" : "Concurrent modification"
}
}
},
"delete" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Revoke permissions on a destination.",
"description" : "Revoke permissions to a role on a single destination. If the permission was not set at the destinationlevel, but rather at the namespace level, this operation will return an error (HTTP status code 412).",
"operationId" : "revokePermissionsOnDestination",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "destination",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "role",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Namespace doesn't exist"
},
"412" : {
"description" : "Permissions are not set at the destination level"
}
}
}
},
"/non-persistent/{property}/{cluster}/{namespace}/{destination}/stats" : {
"get" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Get the stats for the topic.",
"description" : "",
"operationId" : "getStats",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "destination",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "authoritative",
"in" : "query",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/PersistentTopicStats"
}
},
"403" : {
"description" : "Don't have admin permission"
},
"404" : {
"description" : "Topic does not exist"
}
}
}
},
"/non-persistent/{property}/{cluster}/{namespace}/{destination}/subscription/{subName}" : {
"delete" : {
"tags" : [ "non-persistent topic" ],
"summary" : "Delete a subscription.",
"description" : "There should not be any active consumers on the subscription.",
"operationId" : "deleteSubscription",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "property",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "cluster",
"in" : "path",
"required" : true,
"type" : "string"
}, {
"name" : "namespace",
"in" : "path",
"required" : true,
"type" : "string"