|
1 | 1 | { |
2 | 2 | "swagger": "2.0", |
3 | 3 | "info": { |
4 | | - "version": "31.1.1", |
| 4 | + "version": "31.2.1", |
5 | 5 | "title": "Avi ALBServicesJob Object API", |
6 | 6 | "contact": { |
7 | 7 | "name": "Avi Networks Inc.", |
8 | 8 | "url": "https://avinetworks.com/contact-us", |
9 | 9 | |
10 | 10 | }, |
11 | | - "description": "CLI\n```\n- configure albservicesjob <key>\n- show albservicesjob <key>\n```\n" |
| 11 | + "description": "Avi ALBServicesJob object api\n```\n- configure albservicesjob <key>\n- show albservicesjob <key>\n```\n\nAPI permission: PERMISSION_CONTROLLER\n" |
12 | 12 | }, |
| 13 | + "tags": [ |
| 14 | + { |
| 15 | + "name": "ALBServicesJob" |
| 16 | + } |
| 17 | + ], |
| 18 | + "schemes": [ |
| 19 | + "https" |
| 20 | + ], |
13 | 21 | "securityDefinitions": { |
14 | 22 | "basicAuth": { |
15 | 23 | "type": "basic", |
|
20 | 28 | "paths": { |
21 | 29 | "/albservicesjob": { |
22 | 30 | "get": { |
| 31 | + "tags": [ |
| 32 | + "ALBServicesJob" |
| 33 | + ], |
| 34 | + "description": "/albservicesjob", |
| 35 | + "operationId": "GET /albservicesjob", |
23 | 36 | "consumes": [ |
24 | 37 | "application/json" |
25 | 38 | ], |
|
119 | 132 | } |
120 | 133 | }, |
121 | 134 | "post": { |
| 135 | + "tags": [ |
| 136 | + "ALBServicesJob" |
| 137 | + ], |
| 138 | + "description": "/albservicesjob", |
| 139 | + "operationId": "POST /albservicesjob", |
122 | 140 | "consumes": [ |
123 | 141 | "application/json" |
124 | 142 | ], |
|
184 | 202 | }, |
185 | 203 | "/albservicesjob/{uuid}": { |
186 | 204 | "get": { |
| 205 | + "tags": [ |
| 206 | + "ALBServicesJob" |
| 207 | + ], |
| 208 | + "description": "/albservicesjob/{uuid}", |
| 209 | + "operationId": "GET /albservicesjob/{uuid}", |
187 | 210 | "consumes": [ |
188 | 211 | "application/json" |
189 | 212 | ], |
|
274 | 297 | }, |
275 | 298 | "401": { |
276 | 299 | "description": "log in failed" |
| 300 | + }, |
| 301 | + "404": { |
| 302 | + "description": "object not found" |
277 | 303 | } |
278 | 304 | } |
279 | 305 | }, |
280 | 306 | "put": { |
| 307 | + "tags": [ |
| 308 | + "ALBServicesJob" |
| 309 | + ], |
| 310 | + "description": "/albservicesjob/{uuid}", |
| 311 | + "operationId": "PUT /albservicesjob/{uuid}", |
281 | 312 | "consumes": [ |
282 | 313 | "application/json" |
283 | 314 | ], |
|
351 | 382 | }, |
352 | 383 | "401": { |
353 | 384 | "description": "log in failed" |
| 385 | + }, |
| 386 | + "404": { |
| 387 | + "description": "object not found" |
354 | 388 | } |
355 | 389 | } |
356 | 390 | }, |
357 | 391 | "patch": { |
| 392 | + "tags": [ |
| 393 | + "ALBServicesJob" |
| 394 | + ], |
| 395 | + "description": "/albservicesjob/{uuid}", |
| 396 | + "operationId": "PATCH /albservicesjob/{uuid}", |
358 | 397 | "consumes": [ |
359 | 398 | "application/json" |
360 | 399 | ], |
|
428 | 467 | }, |
429 | 468 | "401": { |
430 | 469 | "description": "log in failed" |
| 470 | + }, |
| 471 | + "404": { |
| 472 | + "description": "object not found" |
431 | 473 | } |
432 | 474 | } |
433 | 475 | }, |
434 | 476 | "delete": { |
| 477 | + "tags": [ |
| 478 | + "ALBServicesJob" |
| 479 | + ], |
| 480 | + "description": "/albservicesjob/{uuid}", |
| 481 | + "operationId": "DELETE /albservicesjob/{uuid}", |
435 | 482 | "consumes": [ |
436 | 483 | "application/json" |
437 | 484 | ], |
|
495 | 542 | } |
496 | 543 | }, |
497 | 544 | "404": { |
498 | | - "description": "not found" |
| 545 | + "description": "object not found" |
499 | 546 | } |
500 | 547 | } |
501 | 548 | } |
|
515 | 562 | "type": "string" |
516 | 563 | }, |
517 | 564 | "command": { |
518 | | - "description": "The command to be triggered by the albservicesjob. Field introduced in 21.1.3. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.", |
| 565 | + "description": "The command to be triggered by the albservicesjob. Field introduced in 21.1.3. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.", |
519 | 566 | "type": "string" |
520 | 567 | }, |
521 | 568 | "configpb_attributes": { |
522 | | - "description": "Protobuf versioning for config pbs. Field introduced in 21.1.3. Allowed in Enterprise edition with any value, Essentials edition with any value, Basic edition with any value, Enterprise with Cloud Services edition.", |
| 569 | + "description": "Protobuf versioning for config pbs. Field introduced in 21.1.3. Allowed with any value in Enterprise, Essentials, Basic, Enterprise with Cloud Services edition.", |
523 | 570 | "$ref": "#/definitions/ConfigPbAttributes" |
524 | 571 | }, |
525 | 572 | "end_time": { |
526 | | - "description": "Time at which the albservicesjob ended. Field introduced in 21.1.3. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.", |
| 573 | + "description": "Time at which the albservicesjob ended. Field introduced in 21.1.3. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.", |
527 | 574 | "$ref": "#/definitions/TimeStamp" |
528 | 575 | }, |
529 | 576 | "name": { |
530 | | - "description": "The name of the albservicesjob. Field introduced in 21.1.3. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.", |
| 577 | + "description": "The name of the albservicesjob. Field introduced in 21.1.3. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.", |
531 | 578 | "type": "string" |
532 | 579 | }, |
533 | 580 | "params": { |
534 | | - "description": "Job params. Field introduced in 22.1.1. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.", |
| 581 | + "description": "Job params. Field introduced in 22.1.1. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.", |
535 | 582 | "type": "array", |
536 | 583 | "items": { |
537 | 584 | "$ref": "#/definitions/ALBServicesJobParam" |
538 | 585 | } |
539 | 586 | }, |
540 | 587 | "pulse_job_id": { |
541 | | - "description": "A unique identifier for this job entry on the Pulse Cloud Services. Field introduced in 21.1.3. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.", |
| 588 | + "description": "A unique identifier for this job entry on the Pulse Cloud Services. Field introduced in 21.1.3. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.", |
542 | 589 | "type": "string" |
543 | 590 | }, |
544 | 591 | "pulse_sync_status": { |
545 | | - "description": "Status of sync to Pulse Cloud Services(result uploads/state updates). Field introduced in 22.1.1. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.", |
| 592 | + "description": "Status of sync to Pulse Cloud Services(result uploads/state updates). Field introduced in 22.1.1. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.", |
546 | 593 | "type": "boolean" |
547 | 594 | }, |
548 | 595 | "result": { |
549 | | - "description": "Job result. Field introduced in 22.1.1. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.", |
| 596 | + "description": "Job result. Field introduced in 22.1.1. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.", |
550 | 597 | "type": "string" |
551 | 598 | }, |
552 | 599 | "start_time": { |
553 | | - "description": "Time at which the albservicesjob started. Field introduced in 21.1.3. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.", |
| 600 | + "description": "Time at which the albservicesjob started. Field introduced in 21.1.3. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.", |
554 | 601 | "$ref": "#/definitions/TimeStamp" |
555 | 602 | }, |
556 | 603 | "status": { |
557 | | - "description": "The status of the albservicesjob. Enum options - UNDETERMINED, PENDING, IN_PROGRESS, COMPLETED, FAILED, NOT_ENABLED. Field introduced in 21.1.3. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.", |
| 604 | + "description": "The status of the albservicesjob. Enum options - UNDETERMINED, PENDING, IN_PROGRESS, COMPLETED, FAILED, NOT_ENABLED. Field introduced in 21.1.3. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.", |
558 | 605 | "type": "string", |
559 | 606 | "default": "PENDING" |
560 | 607 | }, |
561 | 608 | "status_update_time": { |
562 | | - "description": "Time at which the status of albservicesjob updated. Field introduced in 22.1.6. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.", |
| 609 | + "description": "Time at which the status of albservicesjob updated. Field introduced in 22.1.6. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.", |
563 | 610 | "$ref": "#/definitions/TimeStamp" |
564 | 611 | }, |
565 | 612 | "tenant_ref": { |
566 | | - "description": "The unique identifier of the tenant to which this albservicesjob belongs. It is a reference to an object of type Tenant. Field introduced in 21.1.3. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.", |
| 613 | + "description": "The unique identifier of the tenant to which this albservicesjob belongs. It is a reference to an object of type Tenant. Field introduced in 21.1.3. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.", |
567 | 614 | "type": "string" |
568 | 615 | }, |
569 | 616 | "token": { |
570 | | - "description": "Job token. Field introduced in 22.1.1. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.", |
| 617 | + "description": "Job token. Field introduced in 22.1.1. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.", |
571 | 618 | "type": "string" |
572 | 619 | }, |
573 | 620 | "url": { |
|
576 | 623 | "type": "string" |
577 | 624 | }, |
578 | 625 | "uuid": { |
579 | | - "description": "A unique identifier for this albservicesjob entry. Field introduced in 21.1.3. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.", |
| 626 | + "description": "A unique identifier for this albservicesjob entry. Field introduced in 21.1.3. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.", |
580 | 627 | "type": "string" |
581 | 628 | } |
582 | 629 | } |
|
607 | 654 | "type": "object", |
608 | 655 | "properties": { |
609 | 656 | "key": { |
610 | | - "description": "Parameter name. Field introduced in 22.1.1. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.", |
| 657 | + "description": "Parameter name. Field introduced in 22.1.1. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.", |
611 | 658 | "type": "string" |
612 | 659 | }, |
613 | 660 | "value": { |
614 | | - "description": "Parameter value. Field introduced in 22.1.1. Allowed in Enterprise edition with any value, Enterprise with Cloud Services edition.", |
| 661 | + "description": "Parameter value. Field introduced in 22.1.1. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.", |
615 | 662 | "type": "string" |
616 | 663 | } |
617 | 664 | } |
|
620 | 667 | "type": "object", |
621 | 668 | "properties": { |
622 | 669 | "version": { |
623 | | - "description": "Protobuf version number. Gets incremented if there is se Diff of federated diff in config pbs.This field will be a monotonically increasing number indicating the number of Config Update operations. Field introduced in 21.1.1. Allowed in Enterprise edition with any value, Essentials edition with any value, Basic edition with any value, Enterprise with Cloud Services edition.", |
| 670 | + "description": "Version sequence number that monotonically advances with each configuration update event. Field introduced in 21.1.1. Allowed with any value in Enterprise, Essentials, Basic, Enterprise with Cloud Services edition.", |
624 | 671 | "type": "integer", |
625 | 672 | "default": 1, |
626 | 673 | "format": "uint32" |
|
635 | 682 | ], |
636 | 683 | "properties": { |
637 | 684 | "secs": { |
638 | | - "description": " Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.", |
| 685 | + "description": " Allowed with any value in Enterprise, Essentials, Basic, Enterprise with Cloud Services edition.", |
639 | 686 | "type": "integer", |
640 | 687 | "format": "int64" |
641 | 688 | }, |
642 | 689 | "usecs": { |
643 | | - "description": " Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.", |
| 690 | + "description": " Allowed with any value in Enterprise, Essentials, Basic, Enterprise with Cloud Services edition.", |
644 | 691 | "type": "integer", |
645 | 692 | "format": "int64" |
646 | 693 | } |
|
0 commit comments