ai_core_sdk.ai_core_v2_client module

class ai_core_sdk.ai_core_v2_client.AICoreV2Client(base_url: str, auth_url: str = None, client_id: str = None, client_secret: str = None, cert_str: str = None, key_str: str = None, cert_file_path: str = None, key_file_path: str = None, token_creator: Callable[[], str] = None, resource_group: str = None, client_type: str = 'AI Core Python SDK', **kwargs)

Bases: object

The AICoreV2Client is the class implemented to interact with the AI Core endpoints. The user can use its attributes corresponding to the resources, for interacting with endpoints related to that resource. (i.e., aicoreclient.scenario)

Parameters:

  • base_url (str) – Base URL of the AI Core. Should include the base path as well. (i.e., “<base_url>/lm/scenarios” should work)

  • auth_url (str, optional) – URL of the authorization endpoint. Should be the full URL (including /oauth/token), defaults to None

  • client_id (str, optional) – client id to be used for authorization, defaults to None

  • client_secret (str, optional) – client secret to be used for authorization, defaults to None

  • cert_str (str, optional) – certificate file content, needs to be provided alongside the key_str parameter, defaults to None

  • key_str (str, optional) – key file content, needs to be provided alongside the cert_str parameter, defaults to None

  • cert_file_path (str, optional) – path to the certificate file, needs to be provided alongside the key_file_path parameter, defaults to None

  • key_file_path (str, optional) – path to the key file, needs to be provided alongside the cert_file_path parameter, defaults to None

  • token_creator (Callable[[], str], optional) – the function which returns the Bearer token, when called. Either this, or auth_url & client_id & client_secret should be specified, defaults to None

  • resource_group (str, optional) – The default resource group which will be used while sending the requests to the server. If not set, the resource_group should be specified with every request to the server, defaults to None

  • client_type (str, optional) – The client type which will be sent in the User-Agent header of the requests, defaults to “AI Core Python SDK”

  • **kwargs –

    • read_timeout (int): Read timeout for requests in seconds, defaults to 60s

    • connect_timeout (int): Connect timeout for requests in seconds, defaults to 60s

    • num_request_retries (int): Number of retries for failing requests with http status code 429, 500, 502, 503 or 504, defaults to 10

logger = <Logger ai_core_sdk (INFO)>
__init__(base_url: str, auth_url: str = None, client_id: str = None, client_secret: str = None, cert_str: str = None, key_str: str = None, cert_file_path: str = None, key_file_path: str = None, token_creator: Callable[[], str] = None, resource_group: str = None, client_type: str = 'AI Core Python SDK', **kwargs)
static from_env(profile_name: str = None, **kwargs)

Alternative way to create an AICoreV2Client object. Parameters for base_url, auth_url, client_id, client_secret, x.509 credentials (either as file path or string) and resource_group can be passed as keyword or are pulled from environment variables. It is also possible to use a profile, which is a json file in the config directory. The profile name can be passed as keyword or is pulled from the environment variable AICORE_PROFILE. If no profile is specified, the default profile is used. A specific path to a config, that should be used, can be set via the environment variable AICORE_CONFIG. The hierarchy of precedence is: 1. keyword argument 2. environment variable 3. configuration file 4. value from VCAP_SERVICES environment variable, if exists

Parameters:

profile_name (optional, str) – name of the profile to use, defaults to None. If None is passed, the profile is read from the environment variable AICORE_PROFILE. If this is not set, the default profile is used. The default profile is read from $AICORE_HOME/config.json.

**kwargs: check the parameters of the class constructor