HCPE-929: bubble up network, resource-manager, operation service errors

[bcmdarroch]

🛠️ Description

This PR regenerates the network, resource-manager, and operation service SDKs from swagger that was regenerated using grpc-gateway v1.15. This version of grpc-gateway contains this fix, which adds a default error response to each endpoint.

Due to another change that added a service prefix to each endpoint to ensure uniqueness (an OpenAPI requirement), all of the file names were changed.

🏞 Background

Currently, all the service swagger files lack a default error object. This means go-swagger can't generate an error handling function, and so the service client can only return the status code and this unhelpful message:

Error: unable to get HVN (network1): response status code does not match any response statuses defined for this endpoint in the swagger spec (status 404): {}

With this change, go-swagger will generate error handlers from the default error response in the swagger. Specifically, we get this block:

/*NetworkServiceCreateDefault handles this case with default header values.

An unexpected error response.
*/
type NetworkServiceCreateDefault struct {
	_statusCode int

	Payload *models.GrpcGatewayRuntimeError
}

// Code gets the status code for the network service create default response
func (o *NetworkServiceCreateDefault) Code() int {
	return o._statusCode
}

func (o *NetworkServiceCreateDefault) Error() string {
	return fmt.Sprintf("[POST /network/2020-09-07/organizations/{network.location.organization_id}/projects/{network.location.project_id}/networks][%d] NetworkService_Create default  %+v", o._statusCode, o.Payload)
}

func (o *NetworkServiceCreateDefault) GetPayload() *models.GrpcGatewayRuntimeError {
	return o.Payload
}

func (o *NetworkServiceCreateDefault) readResponse(response runtime.ClientResponse, consumer runtime.Consumer, formats strfmt.Registry) error {

	o.Payload = new(models.GrpcGatewayRuntimeError)

	// response payload
	if err := consumer.Consume(response.Body(), o.Payload); err != nil && err != io.EOF {
		return err
	}

	return nil
}

These handlers pass along the complete API error:

[GET /network/2020-09-07/organizations/{location.organization_id}/projects/{location.project_id}/clusters/{id}][404] NetworkService_Get default  &{Code:5 Details:[] Error:hvn not found Message:hvn not found}

🔗 External Links

Story: Expose Complete Errors

🏗️ How to Build and Test the Change

1. With your local environment running, set the following environment variables:

export HCP_CLIENT_ID="servicePrincipalKeyClientID"
export HCP_CLIENT_SECRET="servicePrincipalKeyClientSecret"
export HCP_API_HOST="some.host.com"        (if unset, uses prod default)
export HCP_AUTH_URL="some.host.com"        (if unset, uses prod default)

2. Update /cmd/hcp-sdk-go-client/main.go with some call that will error (like a GET for a consul cluster that doesn't exist).

getParams := network.NewNetworkServiceGetParams()
getParams.LocationOrganizationID = orgID
getParams.LocationProjectID = projID
getParams.ID := "not-found"

resp, err := networkClient.NetworkServiceGet(getParams, nil)
if err != nil {
log.Fatal(err)
}
fmt.Printf("Response: %#v\n\n", resp.Payload)

3. go run ./cmd/hcp-sdk-go-client. Check out that complete API error! ✨

👍 Definition of Done

• network service errors are returned with complete details
• resource-manager service errors are returned with complete details
• operation service errors are returned with complete details

[roaks3]

LGTM!