Add struct field documentation extraction and improve API error handling

Co-authored-by: displague <317653+displague@users.noreply.github.com>

Author: Copilot

cmd/descriptions/fabricv4.json

@@ -29,8 +29,9 @@ func main() {
 
 	fmt.Printf("Found %d services\n", len(descriptions.Services))
 	for name, service := range descriptions.Services {
-		fmt.Printf("  - %s: %d methods\n", name, len(service.Methods))
+		fmt.Printf("  - %s: %d methods, %d types\n", name, len(service.Methods), len(service.Types))
 	}
+	fmt.Printf("Found %d global types\n", len(descriptions.Types))
 
 	fmt.Printf("Saving descriptions to: %s\n", *outputFile)
 	if err := descriptions.SaveToFile(*outputFile); err != nil {

cmd/extract-descriptions/main.go

@@ -19,8 +19,8 @@ equinix fabricv4 cloud-events search-cloud-events [flags]
       --cloud-event-search-request-filter-additional-properties string       cloud-event-search-request-filter-additional-properties (JSON)
       --cloud-event-search-request-filter-and string                         cloud-event-search-request-filter-and (JSON array)
       --cloud-event-search-request-pagination-additional-properties string   cloud-event-search-request-pagination-additional-properties (JSON)
-      --cloud-event-search-request-pagination-limit int                      cloud-event-search-request-pagination-limit
-      --cloud-event-search-request-pagination-offset int                     cloud-event-search-request-pagination-offset
+      --cloud-event-search-request-pagination-limit int                      Number of elements to be requested per page. Number must be between 1 and 100, and the default is 20.
+      --cloud-event-search-request-pagination-offset int                     Index of the first element.
   -h, --help                                                                 help for search-cloud-events
       --request string                                                       JSON payload for additional optional fields not exposed as flags
 ```

docs/equinix_fabricv4_cloud-events_search-cloud-events.md

@@ -17,7 +17,7 @@ equinix fabricv4 cloud-routers create-cloud-router-action [flags]
 ```
       --cloud-router-action-request-additional-properties string              cloud-router-action-request-additional-properties (required) (JSON)
       --cloud-router-action-request-connection-additional-properties string   cloud-router-action-request-connection-additional-properties (JSON)
-      --cloud-router-action-request-connection-uuid string                    cloud-router-action-request-connection-uuid
+      --cloud-router-action-request-connection-uuid string                    Connection UUID
       --cloud-router-action-request-type string                               cloud-router-action-request-type (required)
   -h, --help                                                                  help for create-cloud-router-action
       --request string                                                        JSON payload for additional optional fields not exposed as flags

docs/equinix_fabricv4_cloud-routers_create-cloud-router-action.md

@@ -16,17 +16,17 @@ equinix fabricv4 cloud-routers create-cloud-router-command [flags]
 
 ```
       --cloud-router-command-post-request-additional-properties string           cloud-router-command-post-request-additional-properties (required) (JSON)
-      --cloud-router-command-post-request-description string                     cloud-router-command-post-request-description
-      --cloud-router-command-post-request-name string                            cloud-router-command-post-request-name
+      --cloud-router-command-post-request-description string                     Customer-provided Cloud Router Command description
+      --cloud-router-command-post-request-name string                            Customer-provided Cloud Router Command name
       --cloud-router-command-post-request-project-additional-properties string   cloud-router-command-post-request-project-additional-properties (required) (JSON)
-      --cloud-router-command-post-request-project-project-id string              cloud-router-command-post-request-project-project-id (required)
+      --cloud-router-command-post-request-project-project-id string              Subscriber-assigned project ID (required)
       --cloud-router-command-post-request-request-additional-properties string   cloud-router-command-post-request-request-additional-properties (required) (JSON)
-      --cloud-router-command-post-request-request-data-bytes int                 cloud-router-command-post-request-request-data-bytes
-      --cloud-router-command-post-request-request-destination string             cloud-router-command-post-request-request-destination (required)
-      --cloud-router-command-post-request-request-hops-max int                   cloud-router-command-post-request-request-hops-max
-      --cloud-router-command-post-request-request-probes int                     cloud-router-command-post-request-request-probes
+      --cloud-router-command-post-request-request-data-bytes PING_COMMAND        Ping Command DataBytes.  This field is only applicable for commands of type PING_COMMAND.
+      --cloud-router-command-post-request-request-destination string             Fabric Cloud Router Ping or Traceroute Command Destination (required)
+      --cloud-router-command-post-request-request-hops-max TRACEROUTE_COMMAND    Maximum number of hops for the traceroute command. This field is only applicable for commands of type TRACEROUTE_COMMAND.
+      --cloud-router-command-post-request-request-probes TRACEROUTE_COMMAND      Number of probes for Fabric Cloud Router Traceroute Command. This field is only applicable for commands of type TRACEROUTE_COMMAND and is not configurable.
       --cloud-router-command-post-request-request-source-connection string       cloud-router-command-post-request-request-source-connection (JSON)
-      --cloud-router-command-post-request-request-timeout int                    cloud-router-command-post-request-request-timeout
+      --cloud-router-command-post-request-request-timeout PING_COMMAND           Timeout in seconds for Fabric Cloud Router Command:   - For PING_COMMAND: Packet timeout duration. The default value is 5.   - For `TRACEROUTE_COMMAND`: Probe timeout duration.     The default value is 2 and it is not configurable.
       --cloud-router-command-post-request-type string                            cloud-router-command-post-request-type (required)
   -h, --help                                                                     help for create-cloud-router-command
       --request string                                                           JSON payload for additional optional fields not exposed as flags

docs/equinix_fabricv4_cloud-routers_create-cloud-router-command.md

@@ -15,44 +15,44 @@ equinix fabricv4 cloud-routers create-cloud-router [flags]
 ### Options
 
 ```
-      --cloud-router-post-request-account-account-name string                             cloud-router-post-request-account-account-name
-      --cloud-router-post-request-account-account-number int                              cloud-router-post-request-account-account-number
+      --cloud-router-post-request-account-account-name string                             Account name
+      --cloud-router-post-request-account-account-number int                              Account number
       --cloud-router-post-request-account-additional-properties string                    cloud-router-post-request-account-additional-properties (JSON)
-      --cloud-router-post-request-account-global-cust-id string                           cloud-router-post-request-account-global-cust-id
-      --cloud-router-post-request-account-global-org-id string                            cloud-router-post-request-account-global-org-id
-      --cloud-router-post-request-account-global-organization-name string                 cloud-router-post-request-account-global-organization-name
-      --cloud-router-post-request-account-org-id int                                      cloud-router-post-request-account-org-id
-      --cloud-router-post-request-account-organization-name string                        cloud-router-post-request-account-organization-name
-      --cloud-router-post-request-account-reseller-account-name string                    cloud-router-post-request-account-reseller-account-name
-      --cloud-router-post-request-account-reseller-account-number int                     cloud-router-post-request-account-reseller-account-number
-      --cloud-router-post-request-account-reseller-org-id int                             cloud-router-post-request-account-reseller-org-id
-      --cloud-router-post-request-account-reseller-ucm-id string                          cloud-router-post-request-account-reseller-ucm-id
-      --cloud-router-post-request-account-ucm-id string                                   cloud-router-post-request-account-ucm-id
+      --cloud-router-post-request-account-global-cust-id string                           Account name
+      --cloud-router-post-request-account-global-org-id string                            Global organization identifier
+      --cloud-router-post-request-account-global-organization-name string                 Global organization name
+      --cloud-router-post-request-account-org-id int                                      Customer organization identifier
+      --cloud-router-post-request-account-organization-name string                        Customer organization name
+      --cloud-router-post-request-account-reseller-account-name string                    Reseller account name
+      --cloud-router-post-request-account-reseller-account-number int                     Reseller account number
+      --cloud-router-post-request-account-reseller-org-id int                             Reseller customer organization identifier
+      --cloud-router-post-request-account-reseller-ucm-id string                          Reseller account ucmId
+      --cloud-router-post-request-account-ucm-id string                                   Account ucmId
       --cloud-router-post-request-additional-properties string                            cloud-router-post-request-additional-properties (required) (JSON)
       --cloud-router-post-request-location-additional-properties string                   cloud-router-post-request-location-additional-properties (required) (JSON)
       --cloud-router-post-request-location-metro-code string                              cloud-router-post-request-location-metro-code (required)
-      --cloud-router-post-request-location-metro-href string                              cloud-router-post-request-location-metro-href
+      --cloud-router-post-request-location-metro-href string                              The Canonical URL at which the resource resides.
       --cloud-router-post-request-location-metro-name string                              cloud-router-post-request-location-metro-name
       --cloud-router-post-request-location-region string                                  cloud-router-post-request-location-region
       --cloud-router-post-request-marketplace-subscription-additional-properties string   cloud-router-post-request-marketplace-subscription-additional-properties (JSON)
-      --cloud-router-post-request-marketplace-subscription-href string                    cloud-router-post-request-marketplace-subscription-href
+      --cloud-router-post-request-marketplace-subscription-href string                    Marketplace Subscription URI
       --cloud-router-post-request-marketplace-subscription-type string                    cloud-router-post-request-marketplace-subscription-type
-      --cloud-router-post-request-marketplace-subscription-uuid string                    cloud-router-post-request-marketplace-subscription-uuid
-      --cloud-router-post-request-name string                                             cloud-router-post-request-name (required)
-      --cloud-router-post-request-notifications string                                    cloud-router-post-request-notifications (JSON array)
+      --cloud-router-post-request-marketplace-subscription-uuid string                    Equinix-assigned Marketplace Subscription identifier
+      --cloud-router-post-request-name string                                             Customer-provided Cloud Router name (required)
+      --cloud-router-post-request-notifications string                                    Preferences for notifications on connection configuration or status changes (JSON array)
       --cloud-router-post-request-order-additional-properties string                      cloud-router-post-request-order-additional-properties (JSON)
-      --cloud-router-post-request-order-billing-tier string                               cloud-router-post-request-order-billing-tier
-      --cloud-router-post-request-order-customer-reference-number string                  cloud-router-post-request-order-customer-reference-number
-      --cloud-router-post-request-order-order-id string                                   cloud-router-post-request-order-order-id
-      --cloud-router-post-request-order-order-number string                               cloud-router-post-request-order-order-number
-      --cloud-router-post-request-order-purchase-order-number string                      cloud-router-post-request-order-purchase-order-number
-      --cloud-router-post-request-order-term-length int                                   cloud-router-post-request-order-term-length
+      --cloud-router-post-request-order-billing-tier string                               Billing tier for connection bandwidth
+      --cloud-router-post-request-order-customer-reference-number string                  Customer reference number
+      --cloud-router-post-request-order-order-id string                                   Order Identification
+      --cloud-router-post-request-order-order-number string                               Order Reference Number
+      --cloud-router-post-request-order-purchase-order-number string                      Purchase order number
+      --cloud-router-post-request-order-term-length int                                   Term length in months, valid values are 1, 12, 24, 36 where 1 is the default value (for on-demand case).
       --cloud-router-post-request-package-additional-properties string                    cloud-router-post-request-package-additional-properties (required) (JSON)
       --cloud-router-post-request-package-code string                                     cloud-router-post-request-package-code (required)
-      --cloud-router-post-request-package-href string                                     cloud-router-post-request-package-href
+      --cloud-router-post-request-package-href string                                     Fabric Cloud Router URI
       --cloud-router-post-request-package-type string                                     cloud-router-post-request-package-type
       --cloud-router-post-request-project-additional-properties string                    cloud-router-post-request-project-additional-properties (JSON)
-      --cloud-router-post-request-project-project-id string                               cloud-router-post-request-project-project-id
+      --cloud-router-post-request-project-project-id string                               Subscriber-assigned project ID
       --cloud-router-post-request-type string                                             cloud-router-post-request-type (required)
       --dry-run                                                                           dry-run field (required)
   -h, --help                                                                              help for create-cloud-router

docs/equinix_fabricv4_cloud-routers_create-cloud-router.md

@@ -19,8 +19,8 @@ equinix fabricv4 cloud-routers search-cloud-router-commands [flags]
       --cloud-router-command-search-request-filter-additional-properties string       cloud-router-command-search-request-filter-additional-properties (JSON)
       --cloud-router-command-search-request-filter-and string                         cloud-router-command-search-request-filter-and (JSON array)
       --cloud-router-command-search-request-pagination-additional-properties string   cloud-router-command-search-request-pagination-additional-properties (JSON)
-      --cloud-router-command-search-request-pagination-limit int                      cloud-router-command-search-request-pagination-limit
-      --cloud-router-command-search-request-pagination-offset int                     cloud-router-command-search-request-pagination-offset
+      --cloud-router-command-search-request-pagination-limit int                      Number of elements to be requested per page. Number must be between 1 and 100, and the default is 20.
+      --cloud-router-command-search-request-pagination-offset int                     Index of the first element.
       --cloud-router-command-search-request-sort string                               cloud-router-command-search-request-sort (JSON array)
   -h, --help                                                                          help for search-cloud-router-commands
       --request string                                                                JSON payload for additional optional fields not exposed as flags

docs/equinix_fabricv4_cloud-routers_search-cloud-router-commands.md

@@ -21,8 +21,8 @@ equinix fabricv4 cloud-routers search-cloud-router-routes [flags]
       --route-table-entry-search-request-filter-additional-properties string       route-table-entry-search-request-filter-additional-properties (JSON)
       --route-table-entry-search-request-filter-and string                         route-table-entry-search-request-filter-and (JSON array)
       --route-table-entry-search-request-pagination-additional-properties string   route-table-entry-search-request-pagination-additional-properties (JSON)
-      --route-table-entry-search-request-pagination-limit int                      route-table-entry-search-request-pagination-limit
-      --route-table-entry-search-request-pagination-offset int                     route-table-entry-search-request-pagination-offset
+      --route-table-entry-search-request-pagination-limit int                      Number of elements to be requested per page. Number must be between 1 and 100, and the default is 20.
+      --route-table-entry-search-request-pagination-offset int                     Index of the first element.
       --route-table-entry-search-request-sort string                               route-table-entry-search-request-sort (JSON array)
       --router-id string                                                           Router UUID (required)
 ```

docs/equinix_fabricv4_cloud-routers_search-cloud-router-routes.md

@@ -19,8 +19,8 @@ equinix fabricv4 cloud-routers search-cloud-routers [flags]
       --cloud-router-search-request-filter-additional-properties string       cloud-router-search-request-filter-additional-properties (JSON)
       --cloud-router-search-request-filter-and string                         cloud-router-search-request-filter-and (JSON array)
       --cloud-router-search-request-pagination-additional-properties string   cloud-router-search-request-pagination-additional-properties (JSON)
-      --cloud-router-search-request-pagination-limit int                      cloud-router-search-request-pagination-limit
-      --cloud-router-search-request-pagination-offset int                     cloud-router-search-request-pagination-offset
+      --cloud-router-search-request-pagination-limit int                      Number of elements to be requested per page. Number must be between 1 and 100, and the default is 20.
+      --cloud-router-search-request-pagination-offset int                     Index of the first element.
       --cloud-router-search-request-sort string                               cloud-router-search-request-sort (JSON array)
   -h, --help                                                                  help for search-cloud-routers
       --request string                                                        JSON payload for additional optional fields not exposed as flags