blob: 3b9aaed77c8892242c2eeb6136fbdeabfe539de2 [file] [log] [blame]
Ash Wilson89466cc2014-08-29 11:27:39 -04001package gophercloud
2
Ash Wilson89466cc2014-08-29 11:27:39 -04003// ProviderClient stores details that are required to interact with any services within a specific provider's API.
4//
5// Generally, you acquire a ProviderClient by calling the `NewClient()` method in the appropriate provider's child package,
6// providing whatever authentication credentials are required.
7type ProviderClient struct {
Ash Wilson89466cc2014-08-29 11:27:39 -04008
Ash Wilsonc6372fe2014-09-03 11:24:52 -04009 // IdentityEndpoint is the front door to an openstack provider.
10 // Generally this will be populated when you authenticate.
11 // It should be the *root* resource of the identity service, not of a specific identity version.
12 IdentityEndpoint string
13
14 // Reauthenticate is a callback that will be invoked to reauthenticate this client, if reauthentication is enabled.
15 Reauthenticate func() error
Ash Wilson89466cc2014-08-29 11:27:39 -040016
Ash Wilson89466cc2014-08-29 11:27:39 -040017 // TokenID is the most recently valid token issued.
18 TokenID string
Ash Wilsonb8401a72014-09-08 17:07:49 -040019
20 // EndpointLocator describes how this provider discovers the endpoints for its constituent services.
21 EndpointLocator EndpointLocator
Ash Wilson89466cc2014-08-29 11:27:39 -040022}
23
Ash Wilsonc6372fe2014-09-03 11:24:52 -040024// AuthenticatedHeaders returns a map of HTTP headers that are common for all authenticated service requests.
Ash Wilson89466cc2014-08-29 11:27:39 -040025func (client *ProviderClient) AuthenticatedHeaders() map[string]string {
26 return map[string]string{"X-Auth-Token": client.TokenID}
27}