|
52 | 52 | },
|
53 | 53 | "CookiePersistence": {
|
54 | 54 | "properties": {
|
55 |
| - "insert": { |
56 |
| - "description": "Insert specifies if a new cookie should be inserted by the Application Load Balancer or not.", |
57 |
| - "type": "boolean" |
58 |
| - }, |
59 | 55 | "name": {
|
60 | 56 | "description": "Cookie is the name of the cookie to use.",
|
61 | 57 | "type": "string"
|
62 | 58 | },
|
63 | 59 | "ttl": {
|
64 |
| - "description": "TTL specifies the time-to-live for the cookie.\nThe default value is 0s, if set to zero, and it acts as a session cookie, expiring when the client session ends.\nTTL is configurable only when insert is set to true.", |
| 60 | + "description": "TTL specifies the time-to-live for the cookie.\nThe default value is 0s, and it acts as a session cookie, expiring when the client session ends.\n", |
65 | 61 | "example": "120s",
|
66 | 62 | "pattern": "^-?(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,9})?s$",
|
67 | 63 | "title": "TTL (Time-to-live)",
|
|
692 | 688 | },
|
693 | 689 | "type": "object"
|
694 | 690 | },
|
695 |
| - "SessionPersistence": { |
696 |
| - "properties": { |
697 |
| - "useSourceIpAddress": { |
698 |
| - "description": "If enabled then all connections from one source IP address are redirected to the same target. This setting changes the load balancing algorithm to Maglev.", |
699 |
| - "example": true, |
700 |
| - "title": "UseSourceIPAddress", |
701 |
| - "type": "boolean" |
702 |
| - } |
703 |
| - }, |
704 |
| - "type": "object" |
705 |
| - }, |
706 | 691 | "Status": {
|
707 | 692 | "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).",
|
708 | 693 | "properties": {
|
|
751 | 736 | "pattern": "^[0-9a-z](?:(?:[0-9a-z]|-){0,18}[0-9a-z])?$",
|
752 | 737 | "type": "string"
|
753 | 738 | },
|
754 |
| - "sessionPersistence": { |
755 |
| - "$ref": "#/components/schemas/SessionPersistence" |
756 |
| - }, |
757 | 739 | "targetPort": {
|
758 | 740 | "description": "The number identifying the port where each target listens for traffic.",
|
759 | 741 | "example": 5732,
|
|
885 | 867 | "pattern": "^[0-9a-z](?:(?:[0-9a-z]|-){0,18}[0-9a-z])?$",
|
886 | 868 | "type": "string"
|
887 | 869 | },
|
888 |
| - "sessionPersistence": { |
889 |
| - "$ref": "#/components/schemas/SessionPersistence" |
890 |
| - }, |
891 | 870 | "targetPort": {
|
892 | 871 | "description": "The number identifying the port where each target listens for traffic.",
|
893 | 872 | "example": 5732,
|
|
915 | 894 | "paths": {
|
916 | 895 | "/v1alpha/plans": {
|
917 | 896 | "get": {
|
918 |
| - "description": "ListPlans returns for the configured service plans for a project.", |
| 897 | + "description": "Lists the configured service plans for a project.", |
919 | 898 | "operationId": "ListPlans",
|
920 | 899 | "responses": {
|
921 | 900 | "200": {
|
|
964 | 943 | "/v1alpha/projects/{projectId}": {
|
965 | 944 | "delete": {
|
966 | 945 | "deprecated": true,
|
967 |
| - "description": "DEPRECATED! Disabling the application load balancer functionality is now automatic. The endpoint is kept for compatibility.\n Disable will disable the application load balancer functionality for the project specified.", |
| 946 | + "description": "DEPRECATED! Disabling the Application Load Balancer functionality is now automatic.\n This endpoint is kept for compatibility.\n Disables the Application Load Balancer functionality for the specified project.", |
968 | 947 | "operationId": "DisableService",
|
969 | 948 | "parameters": [
|
970 | 949 | {
|
|
1021 | 1000 | },
|
1022 | 1001 | "get": {
|
1023 | 1002 | "deprecated": true,
|
1024 |
| - "description": "DEPRECATED! Checking the status is now obsolete. The endpoint is kept for compatibility.\n Status will return the Application Load Balancer functionality status for the project specified.", |
| 1003 | + "description": "DEPRECATED! Checking the status is now obsolete. The endpoint is kept for compatibility.\n Status will return the Application Load Balancer functionality status for the specified project.", |
1025 | 1004 | "operationId": "GetServiceStatus",
|
1026 | 1005 | "parameters": [
|
1027 | 1006 | {
|
|
1078 | 1057 | },
|
1079 | 1058 | "post": {
|
1080 | 1059 | "deprecated": true,
|
1081 |
| - "description": "DEPRECATED! Use CreateLoadBalancer directly instead.\n Enable will enable the Application Load Balancer functionality for the project specified.", |
| 1060 | + "description": "DEPRECATED! Checking the status is now obsolete. The endpoint is kept for compatibility.\n Enables the Application Load Balancer service for the specified project.", |
1082 | 1061 | "operationId": "EnableService",
|
1083 | 1062 | "parameters": [
|
1084 | 1063 | {
|
|
1146 | 1125 | },
|
1147 | 1126 | "/v1alpha/projects/{projectId}/credentials": {
|
1148 | 1127 | "get": {
|
1149 |
| - "description": "List Credentials", |
| 1128 | + "description": "Lists the stored Observability credentials.", |
1150 | 1129 | "operationId": "ListCredentials",
|
1151 | 1130 | "parameters": [
|
1152 | 1131 | {
|
|
1202 | 1181 | "summary": "List all credentials in a project."
|
1203 | 1182 | },
|
1204 | 1183 | "post": {
|
1205 |
| - "description": "Create credentials can be used to store existing credentials, which are valid to be used for Application Load Balancer Observability.\n This means, e.g. when using ARGUS, that credentials first must be created for that ARGUS instance (by using their API) and\n then can be provided to the Application Load Balancer by storing them with this endpoint.", |
| 1184 | + "description": "Creates and stores credentials for use with Application Load Balancer Observability.\n For example, when using ARGUS, credentials must first be created via the ARGUS API\n and then stored with this endpoint to be used by the Application Load Balancer.", |
1206 | 1185 | "operationId": "CreateCredentials",
|
1207 | 1186 | "parameters": [
|
1208 | 1187 | {
|
|
1280 | 1259 | },
|
1281 | 1260 | "/v1alpha/projects/{projectId}/credentials/{credentialsRef}": {
|
1282 | 1261 | "delete": {
|
1283 |
| - "description": "Delete Credential", |
| 1262 | + "description": "Deletes the stored Observability credentials.", |
1284 | 1263 | "operationId": "DeleteCredentials",
|
1285 | 1264 | "parameters": [
|
1286 | 1265 | {
|
|
1344 | 1323 | "summary": "Delete a single credential in a project."
|
1345 | 1324 | },
|
1346 | 1325 | "get": {
|
1347 |
| - "description": "Get Credentials", |
| 1326 | + "description": "Gets the stored Observability credentials.", |
1348 | 1327 | "operationId": "GetCredentials",
|
1349 | 1328 | "parameters": [
|
1350 | 1329 | {
|
|
1411 | 1390 | "summary": "Get a single credential reference in a project."
|
1412 | 1391 | },
|
1413 | 1392 | "put": {
|
1414 |
| - "description": "Update Credentials", |
| 1393 | + "description": "Updates the stored Observability credentials.", |
1415 | 1394 | "operationId": "UpdateCredentials",
|
1416 | 1395 | "parameters": [
|
1417 | 1396 | {
|
|
1490 | 1469 | },
|
1491 | 1470 | "/v1alpha/projects/{projectId}/load-balancers": {
|
1492 | 1471 | "get": {
|
1493 |
| - "description": "ListLoadBalancer will list load balancers of a project. This contains information set during\n creation or updates for every load balancer in the project. Additionally, it will have information about\n the state of the load balancer in the form of a status field and error description feedback.", |
| 1472 | + "description": "Lists all Application Load Balancers in a project.\n Includes details from creation or updates, along with their status and any error descriptions.", |
1494 | 1473 | "operationId": "ListLoadBalancers",
|
1495 | 1474 | "parameters": [
|
1496 | 1475 | {
|
|
1562 | 1541 | "summary": "List load balancers in a project."
|
1563 | 1542 | },
|
1564 | 1543 | "post": {
|
1565 |
| - "description": "Create Application Load Balancer will create a Application Load Balancer.\n The default load balancing algorithm is round robin unless useSourceIpAddress in session persistence is enabled for a target pool then it is Maglev.", |
| 1544 | + "description": "Creates an Application Load Balancer.\n The default load balancing algorithm is Maglev, and selecting a different algorithm is currently not supported.", |
1566 | 1545 | "operationId": "CreateLoadBalancer",
|
1567 | 1546 | "parameters": [
|
1568 | 1547 | {
|
|
1643 | 1622 | },
|
1644 | 1623 | "/v1alpha/projects/{projectId}/load-balancers/{name}": {
|
1645 | 1624 | "delete": {
|
1646 |
| - "description": "DeleteLoadBalancer will delete a given load balancer.", |
| 1625 | + "description": "Deletes the specified Application Load Balancer.", |
1647 | 1626 | "operationId": "DeleteLoadBalancer",
|
1648 | 1627 | "parameters": [
|
1649 | 1628 | {
|
|
1707 | 1686 | "summary": "Delete a given load balancer in a project."
|
1708 | 1687 | },
|
1709 | 1688 | "get": {
|
1710 |
| - "description": "Get Load Balancer will get a single load balancer of a project. This contains all the information set during\n creation or updates. Additionally, it will have information about the state of the load balancer in the form\n of a status field and error description feedback.", |
| 1689 | + "description": "Retrieves details of a specific Application Load Balancer in a project.\n Includes creation and update information, current status, and any error descriptions.", |
1711 | 1690 | "operationId": "GetLoadBalancer",
|
1712 | 1691 | "parameters": [
|
1713 | 1692 | {
|
|
1774 | 1753 | "summary": "Get a single application load balancer in a project."
|
1775 | 1754 | },
|
1776 | 1755 | "put": {
|
1777 |
| - "description": "Update Load Balancer allows the change of listeners and target pools of an existing Load Balancer.\n The Load balancer resource version needs to be the current version to ensure concurrency safe updates.\n The default load balancing algorithm is round robin unless useSourceIpAddress in session persistence is enabled for a target pool then it is Maglev.", |
| 1756 | + "description": "Updates an existing Application Load Balancer by modifying its listeners and target pools.\n Ensure the resource version is current to maintain concurrency safety.\n The default load balancing algorithm is Maglev, and selecting a different algorithm is currently not supported.", |
1778 | 1757 | "operationId": "UpdateLoadBalancer",
|
1779 | 1758 | "parameters": [
|
1780 | 1759 | {
|
|
1853 | 1832 | },
|
1854 | 1833 | "/v1alpha/projects/{projectId}/load-balancers/{name}/target-pools/{targetPoolName}": {
|
1855 | 1834 | "put": {
|
1856 |
| - "description": "ReplaceTargetPool will replace a specific target pool of a load balancer with new content.\n Useful to add/remove target servers. will update a load balancer.\n Only replaces the mentioned target pools and leaves others unchanged.\n Cannot be used to create or rename a target pool.", |
| 1835 | + "description": "Replaces the content of a specific target pool in the Application Load Balancer (useful for adding or removing target servers).\n Only updates the specified target pool, leaving others unchanged.\n Cannot be used to create or rename target pools.", |
1857 | 1836 | "operationId": "UpdateTargetPool",
|
1858 | 1837 | "parameters": [
|
1859 | 1838 | {
|
|
1937 | 1916 | },
|
1938 | 1917 | "/v1alpha/projects/{projectId}/quota": {
|
1939 | 1918 | "get": {
|
1940 |
| - "description": "GetQuota gets the configured application load balancer quota for the project. Default is 3.", |
| 1919 | + "description": "Retrieves the configured Application Load Balancer quota for the project.\n The default quota is 3.", |
1941 | 1920 | "operationId": "GetQuota",
|
1942 | 1921 | "parameters": [
|
1943 | 1922 | {
|
|
0 commit comments