|
2 | 2 | "components": { |
3 | 3 | "parameters": { |
4 | 4 | "dremioId": { |
5 | | - "description": "The Dremio UUID.", |
| 5 | + "description": "The Dremio instance UUID.", |
6 | 6 | "in": "path", |
7 | 7 | "name": "dremioId", |
8 | 8 | "required": true, |
|
12 | 12 | } |
13 | 13 | }, |
14 | 14 | "dremioUserId": { |
15 | | - "description": "The dremio user UUID.", |
| 15 | + "description": "The Dremio user UUID.", |
16 | 16 | "in": "path", |
17 | 17 | "name": "dremioUserId", |
18 | 18 | "required": true, |
|
22 | 22 | } |
23 | 23 | }, |
24 | 24 | "pageSize": { |
25 | | - "description": "Maximum number of items to return", |
| 25 | + "description": "Maximum number of items to return.", |
26 | 26 | "in": "query", |
27 | 27 | "name": "pageSize", |
28 | 28 | "schema": { |
|
104 | 104 | "type": "object" |
105 | 105 | }, |
106 | 106 | "authentication": { |
107 | | - "description": "Dremio authentication settings. A change here triggers a Dremio restart and will incur downtime.", |
| 107 | + "description": "Dremio instance authentication settings. A change here triggers a Dremio restart and will incur downtime.", |
108 | 108 | "properties": { |
109 | 109 | "azuread": { |
110 | 110 | "$ref": "#/components/schemas/azuread" |
|
154 | 154 | ], |
155 | 155 | "type": "object" |
156 | 156 | }, |
| 157 | + "create-dremio-instancePayload": { |
| 158 | + "properties": { |
| 159 | + "authentication": { |
| 160 | + "$ref": "#/components/schemas/authentication" |
| 161 | + }, |
| 162 | + "description": { |
| 163 | + "description": "The description is a longer text chosen by the user to provide more context for the resource.", |
| 164 | + "maxLength": 1024, |
| 165 | + "type": "string" |
| 166 | + }, |
| 167 | + "displayName": { |
| 168 | + "description": "The display name is a short name chosen by the user to identify the resource.", |
| 169 | + "maxLength": 32, |
| 170 | + "minLength": 1, |
| 171 | + "pattern": "^[a-zA-Z0-9 ]*$", |
| 172 | + "type": "string" |
| 173 | + } |
| 174 | + }, |
| 175 | + "required": [ |
| 176 | + "displayName" |
| 177 | + ] |
| 178 | + }, |
157 | 179 | "create-dremio-userPayload": { |
158 | 180 | "properties": { |
159 | 181 | "description": { |
|
203 | 225 | "password" |
204 | 226 | ] |
205 | 227 | }, |
206 | | - "create-dremioPayload": { |
207 | | - "properties": { |
208 | | - "authentication": { |
209 | | - "$ref": "#/components/schemas/authentication" |
210 | | - }, |
211 | | - "description": { |
212 | | - "description": "The description is a longer text chosen by the user to provide more context for the resource.", |
213 | | - "maxLength": 1024, |
214 | | - "type": "string" |
215 | | - }, |
216 | | - "displayName": { |
217 | | - "description": "The display name is a short name chosen by the user to identify the resource.", |
218 | | - "maxLength": 32, |
219 | | - "minLength": 1, |
220 | | - "pattern": "^[a-zA-Z0-9 ]*$", |
221 | | - "type": "string" |
222 | | - } |
223 | | - }, |
224 | | - "required": [ |
225 | | - "displayName" |
226 | | - ] |
227 | | - }, |
228 | 228 | "dremioResponse": { |
229 | 229 | "properties": { |
230 | 230 | "authentication": { |
|
439 | 439 | "x-go-type-skip-optional-pointer": true |
440 | 440 | }, |
441 | 441 | "redirectUrl": { |
442 | | - "description": "The URL where Dremio is hosted. The URL must match the redirect URL set in the Identity Provider.", |
| 442 | + "description": "The URL where the Dremio instance is hosted. The URL must match the redirect URL set in the Identity Provider.", |
443 | 443 | "readOnly": true, |
444 | 444 | "type": "string" |
445 | 445 | }, |
|
457 | 457 | ], |
458 | 458 | "type": "object" |
459 | 459 | }, |
460 | | - "update-dremioPayload": { |
| 460 | + "update-dremio-instancePayload": { |
461 | 461 | "properties": { |
462 | 462 | "authentication": { |
463 | 463 | "$ref": "#/components/schemas/authentication" |
|
487 | 487 | "paths": { |
488 | 488 | "/v1alpha/projects/{projectId}/regions/{regionId}/dremios": { |
489 | 489 | "get": { |
490 | | - "description": "Returns a list of all dremio instances within the project.", |
491 | | - "operationId": "list-dremios", |
| 490 | + "description": "Returns a list of all Dremio instances within the project.", |
| 491 | + "operationId": "list-dremio-instances", |
492 | 492 | "parameters": [ |
493 | 493 | { |
494 | 494 | "$ref": "#/components/parameters/pageToken" |
|
506 | 506 | } |
507 | 507 | } |
508 | 508 | }, |
509 | | - "description": "Successful response with all dremio instances." |
| 509 | + "description": "Successful response with all Dremio instances." |
510 | 510 | }, |
511 | 511 | "401": { |
512 | 512 | "$ref": "#/components/responses/unauthorized" |
|
533 | 533 | } |
534 | 534 | ], |
535 | 535 | "post": { |
536 | | - "description": "Creates a new Dremio within the project.", |
537 | | - "operationId": "create-dremio", |
| 536 | + "description": "Creates a new Dremio instance within the project.", |
| 537 | + "operationId": "create-dremio-instance", |
538 | 538 | "requestBody": { |
539 | 539 | "content": { |
540 | 540 | "application/json": { |
541 | 541 | "schema": { |
542 | | - "$ref": "#/components/schemas/create-dremioPayload" |
| 542 | + "$ref": "#/components/schemas/create-dremio-instancePayload" |
543 | 543 | } |
544 | 544 | } |
545 | 545 | }, |
|
554 | 554 | } |
555 | 555 | } |
556 | 556 | }, |
557 | | - "description": "Dremio has been accepted." |
| 557 | + "description": "Dremio instance has been accepted." |
558 | 558 | }, |
559 | 559 | "400": { |
560 | 560 | "$ref": "#/components/responses/badRequest" |
|
581 | 581 | }, |
582 | 582 | "/v1alpha/projects/{projectId}/regions/{regionId}/dremios/{dremioId}": { |
583 | 583 | "delete": { |
584 | | - "description": "Deletes the given Dremio.", |
585 | | - "operationId": "delete-dremio", |
| 584 | + "description": "Deletes the given Dremio instance.", |
| 585 | + "operationId": "delete-dremio-instance", |
586 | 586 | "responses": { |
587 | 587 | "202": { |
588 | | - "description": "Dremio deletion has been accepted." |
| 588 | + "description": "Dremio instance deletion has been accepted." |
589 | 589 | }, |
590 | 590 | "401": { |
591 | 591 | "$ref": "#/components/responses/unauthorized" |
|
610 | 610 | } |
611 | 611 | }, |
612 | 612 | "get": { |
613 | | - "description": "Returns the details for the given Dremio.", |
| 613 | + "description": "Returns the details for the given Dremio instance.", |
614 | 614 | "operationId": "get-dremio", |
615 | 615 | "responses": { |
616 | 616 | "200": { |
|
621 | 621 | } |
622 | 622 | } |
623 | 623 | }, |
624 | | - "description": "Dremio details successfully retrieved." |
| 624 | + "description": "Dremio instance details successfully retrieved." |
625 | 625 | }, |
626 | 626 | "401": { |
627 | 627 | "$ref": "#/components/responses/unauthorized" |
|
654 | 654 | } |
655 | 655 | ], |
656 | 656 | "put": { |
657 | | - "description": "Updates the given Dremio. Please note that changing certain fields will trigger a Dremio restart and will incur downtime. See the request body information for more details.", |
658 | | - "operationId": "update-dremio", |
| 657 | + "description": "Updates the given Dremio instance. Please note that changing certain fields will trigger a Dremio restart and will incur downtime. See the request body information for more details.", |
| 658 | + "operationId": "update-dremio-instance", |
659 | 659 | "requestBody": { |
660 | 660 | "content": { |
661 | 661 | "application/json": { |
662 | 662 | "schema": { |
663 | | - "$ref": "#/components/schemas/update-dremioPayload" |
| 663 | + "$ref": "#/components/schemas/update-dremio-instancePayload" |
664 | 664 | } |
665 | 665 | } |
666 | 666 | }, |
|
675 | 675 | } |
676 | 676 | } |
677 | 677 | }, |
678 | | - "description": "Dremio update has been accepted." |
| 678 | + "description": "Dremio instance update has been accepted." |
679 | 679 | }, |
680 | 680 | "401": { |
681 | 681 | "$ref": "#/components/responses/unauthorized" |
|
702 | 702 | }, |
703 | 703 | "/v1alpha/projects/{projectId}/regions/{regionId}/dremios/{dremioId}/users": { |
704 | 704 | "get": { |
705 | | - "description": "Returns a list of all dremio admin users for the given dremio instance.", |
| 705 | + "description": "Returns a list of all Dremio admin users for the given dremio instance.", |
706 | 706 | "operationId": "list-dremio-users", |
707 | 707 | "parameters": [ |
708 | 708 | { |
|
721 | 721 | } |
722 | 722 | } |
723 | 723 | }, |
724 | | - "description": "Successful response with all dremio admin users" |
| 724 | + "description": "Successful response with all Dremio admin users." |
725 | 725 | }, |
726 | 726 | "401": { |
727 | 727 | "$ref": "#/components/responses/unauthorized" |
|
751 | 751 | } |
752 | 752 | ], |
753 | 753 | "post": { |
754 | | - "description": "Creates a new dremio admin user for the given dremio instance", |
| 754 | + "description": "Creates a new Dremio admin user for the given Dremio instance.", |
755 | 755 | "operationId": "create-dremio-user", |
756 | 756 | "requestBody": { |
757 | 757 | "content": { |
|
0 commit comments