Docs sync done from apache/pulsar (#2dace76)

apache · Oct 11, 2024 · eb47910 · eb47910
1 parent 846d6a9
commit eb47910
Show file tree

Hide file tree

Showing 4 changed files with 272 additions and 2 deletions.
diff --git a/static/reference/next/client/client-configuration-client.md b/static/reference/next/client/client-configuration-client.md
@@ -56,7 +56,7 @@ Release the connection if it is not used for more than [connectionMaxIdleSeconds
 
 **Type**: `int`
 
-**Default**: `25`
+**Default**: `60`
 
 ### connectionTimeoutMs
 Duration of waiting for a connection to a broker to be established.If the duration passes without a response from a broker, the connection attempt is dropped.

diff --git a/static/reference/next/config/reference-configuration-client.md b/static/reference/next/config/reference-configuration-client.md
@@ -56,7 +56,7 @@ Release the connection if it is not used for more than [connectionMaxIdleSeconds
 
 **Type**: `int`
 
-**Default**: `25`
+**Default**: `60`
 
 ### connectionTimeoutMs
 Duration of waiting for a connection to a broker to be established.If the duration passes without a response from a broker, the connection attempt is dropped.

diff --git a/static/swagger/master/swagger.json b/static/swagger/master/swagger.json
@@ -823,6 +823,34 @@
  "consumerName": {
  "type": "string"
  },
+ "drainingHashes": {
+ "items": {
+ "$ref": "#/definitions/DrainingHash"
+ },
+ "type": "array"
+ },
+ "drainingHashesClearedTotal": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "drainingHashesCount": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "drainingHashesUnackedMessages": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "keyHashRangeArrays": {
+ "items": {
+ "items": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "type": "array"
+ },
+ "type": "array"
+ },
  "keyHashRanges": {
  "items": {
  "type": "string"
@@ -1053,6 +1081,23 @@
  },
  "type": "object"
  },
+ "DrainingHash": {
+ "properties": {
+ "blockedAttempts": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "hash": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "unackMsgs": {
+ "format": "int32",
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
  "EntryFilters": {
  "properties": {
  "entryFilterNames": {
@@ -2215,6 +2260,18 @@
  "format": "int64",
  "type": "integer"
  },
+ "drainingHashesClearedTotal": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "drainingHashesCount": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "drainingHashesUnackedMessages": {
+ "format": "int32",
+ "type": "integer"
+ },
  "durable": {
  "type": "boolean"
  },
@@ -4128,6 +4185,18 @@
  "format": "int64",
  "type": "integer"
  },
+ "drainingHashesClearedTotal": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "drainingHashesCount": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "drainingHashesUnackedMessages": {
+ "format": "int32",
+ "type": "integer"
+ },
  "durable": {
  "type": "boolean"
  },
@@ -6703,6 +6772,72 @@
  ]
  }
  },
+ "/namespaces/grantPermissionsOnTopics": {
+ "post": {
+ "consumes": [
+ "application/json"
+ ],
+ "description": "",
+ "operationId": "Namespaces_grantPermissionsOnTopics",
+ "produces": [
+ "application/json"
+ ],
+ "responses": {
+ "204": {
+ "description": "Operation successful"
+ },
+ "401": {
+ "description": "Don't have permission to administrate resources on this tenant"
+ },
+ "403": {
+ "description": "Don't have admin permission"
+ },
+ "404": {
+ "description": "tenant/namespace/topic doesn't exit"
+ },
+ "500": {
+ "description": "Internal server error"
+ }
+ },
+ "summary": "Grant new permissions to a role on multi-topics.",
+ "tags": [
+ "namespaces"
+ ]
+ }
+ },
+ "/namespaces/revokePermissionsOnTopics": {
+ "post": {
+ "consumes": [
+ "application/json"
+ ],
+ "description": "",
+ "operationId": "Namespaces_revokePermissionsOnTopics",
+ "produces": [
+ "application/json"
+ ],
+ "responses": {
+ "204": {
+ "description": "Operation successful"
+ },
+ "401": {
+ "description": "Don't have permission to administrate resources on this tenant"
+ },
+ "403": {
+ "description": "Don't have admin permission"
+ },
+ "404": {
+ "description": "tenant/namespace/topic doesn't exit"
+ },
+ "500": {
+ "description": "Internal server error"
+ }
+ },
+ "summary": "Revoke new permissions to a role on multi-topics.",
+ "tags": [
+ "namespaces"
+ ]
+ }
+ },
  "/namespaces/{cluster}/antiAffinity/{group}": {
  "get": {
  "consumes": [

diff --git a/static/swagger/master/v2/swagger.json b/static/swagger/master/v2/swagger.json
@@ -823,6 +823,34 @@
  "consumerName": {
  "type": "string"
  },
+ "drainingHashes": {
+ "items": {
+ "$ref": "#/definitions/DrainingHash"
+ },
+ "type": "array"
+ },
+ "drainingHashesClearedTotal": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "drainingHashesCount": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "drainingHashesUnackedMessages": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "keyHashRangeArrays": {
+ "items": {
+ "items": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "type": "array"
+ },
+ "type": "array"
+ },
  "keyHashRanges": {
  "items": {
  "type": "string"
@@ -1053,6 +1081,23 @@
  },
  "type": "object"
  },
+ "DrainingHash": {
+ "properties": {
+ "blockedAttempts": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "hash": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "unackMsgs": {
+ "format": "int32",
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
  "EntryFilters": {
  "properties": {
  "entryFilterNames": {
@@ -2215,6 +2260,18 @@
  "format": "int64",
  "type": "integer"
  },
+ "drainingHashesClearedTotal": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "drainingHashesCount": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "drainingHashesUnackedMessages": {
+ "format": "int32",
+ "type": "integer"
+ },
  "durable": {
  "type": "boolean"
  },
@@ -4128,6 +4185,18 @@
  "format": "int64",
  "type": "integer"
  },
+ "drainingHashesClearedTotal": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "drainingHashesCount": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "drainingHashesUnackedMessages": {
+ "format": "int32",
+ "type": "integer"
+ },
  "durable": {
  "type": "boolean"
  },
@@ -6703,6 +6772,72 @@
  ]
  }
  },
+ "/namespaces/grantPermissionsOnTopics": {
+ "post": {
+ "consumes": [
+ "application/json"
+ ],
+ "description": "",
+ "operationId": "Namespaces_grantPermissionsOnTopics",
+ "produces": [
+ "application/json"
+ ],
+ "responses": {
+ "204": {
+ "description": "Operation successful"
+ },
+ "401": {
+ "description": "Don't have permission to administrate resources on this tenant"
+ },
+ "403": {
+ "description": "Don't have admin permission"
+ },
+ "404": {
+ "description": "tenant/namespace/topic doesn't exit"
+ },
+ "500": {
+ "description": "Internal server error"
+ }
+ },
+ "summary": "Grant new permissions to a role on multi-topics.",
+ "tags": [
+ "namespaces"
+ ]
+ }
+ },
+ "/namespaces/revokePermissionsOnTopics": {
+ "post": {
+ "consumes": [
+ "application/json"
+ ],
+ "description": "",
+ "operationId": "Namespaces_revokePermissionsOnTopics",
+ "produces": [
+ "application/json"
+ ],
+ "responses": {
+ "204": {
+ "description": "Operation successful"
+ },
+ "401": {
+ "description": "Don't have permission to administrate resources on this tenant"
+ },
+ "403": {
+ "description": "Don't have admin permission"
+ },
+ "404": {
+ "description": "tenant/namespace/topic doesn't exit"
+ },
+ "500": {
+ "description": "Internal server error"
+ }
+ },
+ "summary": "Revoke new permissions to a role on multi-topics.",
+ "tags": [
+ "namespaces"
+ ]
+ }
+ },
  "/namespaces/{cluster}/antiAffinity/{group}": {
  "get": {
  "consumes": [