vmware.vapi.vmc package

Submodules

vmware.vapi.vmc.client module

CSP Refresh token based SecurityContextFilter

class vmware.vapi.vmc.client.VmcClient(session, refresh_token, vmc_url, csp_url)

Bases: vmware.vapi.bindings.stub.ApiClient

VMC Client class that providess access to stubs for all the services in the VMC API

Initialize VmcClient by creating a stub factory instance using a CSP Security context filter added to the filter chain of the connector

Parameters

  • session (requests.Session) – Requests HTTP session instance

  • refresh_token (str) – Refresh token obtained from CSP

  • vmc_url (str) – URL of the VMC service

  • csp_url (str) – URL of the CSP service

vmware.vapi.vmc.client.create_vmc_client(refresh_token, session=None)

Helper method to create an instance of the VMC API client using the public VMC and CSP URL.

Parameters

  • refresh_token (str) – Refresh token obtained from CSP

  • session (requests.Session or None) – Requests HTTP session instance. If not specified, then one is automatically created and used

Return type

vmware.vapi.vmc.client.VmcClient

Returns

VMC Client instance

vmware.vapi.vmc.csp_filter module

CSP Refresh token based SecurityContextFilter

class vmware.vapi.vmc.csp_filter.CSPSecurityContextFilter(session, refresh_token, refresh_url)

Bases: vmware.vapi.security.client.security_context_filter.SecurityContextFilter

CSP Security Context filter in API Provider chain adds the security context based on a refresh token to the execution context passed in.

Initialize SecurityContextFilter

Parameters

  • session (requests.Session) – Requests Session object to use for making HTTP calls

  • refresh_token (str) – Refresh token to use for obtaining an access token

  • refresh_url (str) – URL that allows exchanging a refresh token for an access token

get_max_retries()

Get the max number of retries

Return type

int

Returns

Number of retries

get_security_context(on_error)

Retrieve security context. If this method is called after an error occured, then a new access token is obtained using the refresh token and a new security context is created.

Parameters

on_error (bool) – Whether this method is called after getting an error

Return type

vmware.vapi.core.SecurityContext

Returns

Security context

should_retry(error_value)

Returns whether the request should be retried or not based on the error specified.

Parameters

error_value (vmware.vapi.data.value.ErrorValue) – Method error

Return type

bool

Returns

Returns True if request should be retried in case the error is either Unauthenticated or Unauthorized else False