esp_sdk.ExternalAccountsApi

All URIs are relative to https://api.evident.io

Method	HTTP request	Description
add_compliance_standard	POST /api/v2/external_accounts/{external_account_id}/compliance_standards.json_api	Add a compliance standard to an external account
add_custom_compliance_standard	POST /api/v2/external_accounts/{external_account_id}/custom_compliance_standards.json_api	Add a custom compliance standard to an external account
add_disabled_signature	POST /api/v2/external_accounts/disabled_signatures.json_api	Disable a set of signatures for an external account or a set of external accounts for a signature
delete	DELETE /api/v2/external_accounts/{id}.json_api	Delete a(n) External Account
list	PUT /api/v2/external_accounts.json_api	Get a list of External Accounts
list_compliance_standards	GET /api/v2/external_accounts/{external_account_id}/compliance_standards.json_api	Get a list of compliance standards for an external account
list_custom_compliance_standards	GET /api/v2/external_accounts/{external_account_id}/custom_compliance_standards.json_api	Get a list of custom compliance standards for an external account
list_disabled_signatures	PUT /api/v2/external_accounts/{external_account_id}/disabled_signatures.json_api	Get a list all the disabled signatures for an external account
remove_compliance_standard	DELETE /api/v2/external_accounts/{external_account_id}/compliance_standards/{compliance_standard_id}.json_api	Remove a compliance standard from an external account
remove_custom_compliance_standard	DELETE /api/v2/external_accounts/{external_account_id}/custom_compliance_standards/{custom_compliance_standard_id}.json_api	Remove a custom compliance standard from an external account
remove_disabled_signature	DELETE /api/v2/external_accounts/disabled_signatures.json_api	Re-enable a set of signatures for an external account or a set of external accounts for a signature
show	GET /api/v2/external_accounts/{id}.json_api	Show a single External Account

add_compliance_standard

ComplianceStandard add_compliance_standard(external_account_id, compliance_standard_id, include=include)

Add a compliance standard to an external account

Example

from __future__ import print_statement
import time
import esp_sdk
from esp_sdk.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = esp_sdk.ExternalAccountsApi()
external_account_id = 56 # int | The ID of the external account this compliance standard belongs to
compliance_standard_id = 56 # int | The ID of the compliance standard that belongs to this external account
include = 'include_example' # str | Related objects that can be included in the response:  compliance_domains, compliance_controls See Including Objects for more information. (optional)

try: 
    # Add a compliance standard to an external account
    api_response = api_instance.add_compliance_standard(external_account_id, compliance_standard_id, include=include)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ExternalAccountsApi->add_compliance_standard: %s\n" % e)

Parameters

Name	Type	Description	Notes
external_account_id	int	The ID of the external account this compliance standard belongs to
compliance_standard_id	int	The ID of the compliance standard that belongs to this external account
include	str	Related objects that can be included in the response: compliance_domains, compliance_controls See Including Objects for more information.	[optional]

Return type

ComplianceStandard

Authorization

See https://github.com/EvidentSecurity/esp-sdk-python#set-your-hmac-security-keys

HTTP request headers

Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

add_custom_compliance_standard

Meta add_custom_compliance_standard(external_account_id, custom_compliance_standard_id)

Add a custom compliance standard to an external account

Example

from __future__ import print_statement
import time
import esp_sdk
from esp_sdk.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = esp_sdk.ExternalAccountsApi()
external_account_id = 56 # int | The ID of the external account this custom compliance standard belongs to
custom_compliance_standard_id = 56 # int | The ID of the custom compliance standard that belongs to this external account

try: 
    # Add a custom compliance standard to an external account
    api_response = api_instance.add_custom_compliance_standard(external_account_id, custom_compliance_standard_id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ExternalAccountsApi->add_custom_compliance_standard: %s\n" % e)

Parameters

Name	Type	Description	Notes
external_account_id	int	The ID of the external account this custom compliance standard belongs to
custom_compliance_standard_id	int	The ID of the custom compliance standard that belongs to this external account

Return type

Meta

Authorization

See https://github.com/EvidentSecurity/esp-sdk-python#set-your-hmac-security-keys

HTTP request headers

Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

add_disabled_signature

Signature add_disabled_signature(external_account_ids, signature_ids, include=include)

Disable a set of signatures for an external account or a set of external accounts for a signature

Example

from __future__ import print_statement
import time
import esp_sdk
from esp_sdk.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = esp_sdk.ExternalAccountsApi()
external_account_ids = [56] # list[int] | The IDs of the external_account(s) to disable
signature_ids = [56] # list[int] | The IDs of the signature(s) to disable
include = 'include_example' # str | Related objects that can be included in the response:  service, suppressions See Including Objects for more information. (optional)

try: 
    # Disable a set of signatures for an external account or a set of external accounts for a signature
    api_response = api_instance.add_disabled_signature(external_account_ids, signature_ids, include=include)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ExternalAccountsApi->add_disabled_signature: %s\n" % e)

Parameters

Name	Type	Description	Notes
external_account_ids	list[int]	The IDs of the external_account(s) to disable
signature_ids	list[int]	The IDs of the signature(s) to disable
include	str	Related objects that can be included in the response: service, suppressions See Including Objects for more information.	[optional]

Return type

Signature

Authorization

See https://github.com/EvidentSecurity/esp-sdk-python#set-your-hmac-security-keys

HTTP request headers

Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

delete

Meta delete(id)

Delete a(n) External Account

Example

from __future__ import print_statement
import time
import esp_sdk
from esp_sdk.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = esp_sdk.ExternalAccountsApi()
id = 56 # int | External Account ID

try: 
    # Delete a(n) External Account
    api_response = api_instance.delete(id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ExternalAccountsApi->delete: %s\n" % e)

Parameters

Name	Type	Description	Notes
id	int	External Account ID

Return type

Meta

Authorization

See https://github.com/EvidentSecurity/esp-sdk-python#set-your-hmac-security-keys

HTTP request headers

Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

list

PaginatedCollection list(include=include, filter=filter, page=page)

Get a list of External Accounts

Example

from __future__ import print_statement
import time
import esp_sdk
from esp_sdk.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = esp_sdk.ExternalAccountsApi()
include = 'include_example' # str | Related objects that can be included in the response:  organization, sub_organization, team, scan_intervals, disabled_signatures, suppressions, azure_group See Including Objects for more information. (optional)
filter = {'key': 'filter_example'} # dict(str, str) | Filter Params for Searching.  Equality Searchable Attributes: [id, nickname, name] Matching Searchable Attributes: [nickname, name] Limited Searchable Attributes: [account_eq, arn_eq, provider_eq, subscription_id_eq] Sortable Attributes: [name, updated_at, created_at, id] Searchable Associations: [organization, sub_organization, team, azure_group, compliance_standards, disabled_signatures, integrations, scheduled_exports, suppressions] See Searching Lists for more information. See the filter parameter of the association's list action to see what attributes are searchable on each association. See Conditions on Relationships in Searching Lists for more information. (optional)
page = '{:number=>1,+:size=>20}' # str | Page Number and Page Size.  Number is the page number of the collection to return, size is the number of items to return per page. (optional) (default to {:number=>1,+:size=>20})

try: 
    # Get a list of External Accounts
    api_response = api_instance.list(include=include, filter=filter, page=page)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ExternalAccountsApi->list: %s\n" % e)

Parameters

Name	Type	Description	Notes
include	str	Related objects that can be included in the response: organization, sub_organization, team, scan_intervals, disabled_signatures, suppressions, azure_group See Including Objects for more information.	[optional]
filter	dict(str, str)	Filter Params for Searching. Equality Searchable Attributes: [id, nickname, name] Matching Searchable Attributes: [nickname, name] Limited Searchable Attributes: [account_eq, arn_eq, provider_eq, subscription_id_eq] Sortable Attributes: [name, updated_at, created_at, id] Searchable Associations: [organization, sub_organization, team, azure_group, compliance_standards, disabled_signatures, integrations, scheduled_exports, suppressions] See Searching Lists for more information. See the filter parameter of the association's list action to see what attributes are searchable on each association. See Conditions on Relationships in Searching Lists for more information.	[optional]
page	str	Page Number and Page Size. Number is the page number of the collection to return, size is the number of items to return per page.	[optional] [default to {:number=>1,+:size=>20}]

Return type

PaginatedCollection

Authorization

See https://github.com/EvidentSecurity/esp-sdk-python#set-your-hmac-security-keys

HTTP request headers

Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

list_compliance_standards

PaginatedCollection list_compliance_standards(external_account_id, include=include, page=page)

Get a list of compliance standards for an external account

Example

from __future__ import print_statement
import time
import esp_sdk
from esp_sdk.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = esp_sdk.ExternalAccountsApi()
external_account_id = 56 # int | The ID of the external account this compliance standard belongs to
include = 'include_example' # str | Related objects that can be included in the response:  compliance_domains, compliance_controls See Including Objects for more information. (optional)
page = '{:number=>1,+:size=>20}' # str | Page Number and Page Size.  Number is the page number of the collection to return, size is the number of items to return per page. (optional) (default to {:number=>1,+:size=>20})

try: 
    # Get a list of compliance standards for an external account
    api_response = api_instance.list_compliance_standards(external_account_id, include=include, page=page)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ExternalAccountsApi->list_compliance_standards: %s\n" % e)

Parameters

Name	Type	Description	Notes
external_account_id	int	The ID of the external account this compliance standard belongs to
include	str	Related objects that can be included in the response: compliance_domains, compliance_controls See Including Objects for more information.	[optional]
page	str	Page Number and Page Size. Number is the page number of the collection to return, size is the number of items to return per page.	[optional] [default to {:number=>1,+:size=>20}]

Return type

PaginatedCollection

Authorization

See https://github.com/EvidentSecurity/esp-sdk-python#set-your-hmac-security-keys

HTTP request headers

Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

list_custom_compliance_standards

PaginatedCollection list_custom_compliance_standards(external_account_id, include=include, page=page)

Get a list of custom compliance standards for an external account

Example

from __future__ import print_statement
import time
import esp_sdk
from esp_sdk.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = esp_sdk.ExternalAccountsApi()
external_account_id = 56 # int | The ID of the external account this custom compliance standard belongs to
include = 'include_example' # str | Related objects that can be included in the response:  custom_compliance_domains, custom_compliance_controls See Including Objects for more information. (optional)
page = '{:number=>1,+:size=>20}' # str | Page Number and Page Size.  Number is the page number of the collection to return, size is the number of items to return per page. (optional) (default to {:number=>1,+:size=>20})

try: 
    # Get a list of custom compliance standards for an external account
    api_response = api_instance.list_custom_compliance_standards(external_account_id, include=include, page=page)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ExternalAccountsApi->list_custom_compliance_standards: %s\n" % e)

Parameters

Name	Type	Description	Notes
external_account_id	int	The ID of the external account this custom compliance standard belongs to
include	str	Related objects that can be included in the response: custom_compliance_domains, custom_compliance_controls See Including Objects for more information.	[optional]
page	str	Page Number and Page Size. Number is the page number of the collection to return, size is the number of items to return per page.	[optional] [default to {:number=>1,+:size=>20}]

Return type

PaginatedCollection

Authorization

See https://github.com/EvidentSecurity/esp-sdk-python#set-your-hmac-security-keys

HTTP request headers

Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

list_disabled_signatures

PaginatedCollection list_disabled_signatures(external_account_id, include=include, filter=filter, page=page)

Get a list all the disabled signatures for an external account

Example

from __future__ import print_statement
import time
import esp_sdk
from esp_sdk.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = esp_sdk.ExternalAccountsApi()
external_account_id = 56 # int | The ID of the external account to retrieve the disabled signatures for
include = 'include_example' # str | Related objects that can be included in the response:  service, suppressions See Including Objects for more information. (optional)
filter = {'key': 'filter_example'} # dict(str, str) | Filter Params for Searching.  Equality Searchable Attributes: [id, risk_level, service_id, disabled, supports_user_attribution, name, identifier, description, resolution] Matching Searchable Attributes: [name, identifier, description, resolution] Limited Searchable Attributes: [service_provider_eq, service_provider_in, service_name_in, identifier_cont] Sortable Attributes: [name, identifier, updated_at, created_at, id] Searchable Associations: [signature_copy, disabled_external_accounts, integrations, suppressions] See Searching Lists for more information. See the filter parameter of the association's list action to see what attributes are searchable on each association. See Conditions on Relationships in Searching Lists for more information. (optional)
page = '{:number=>1,+:size=>20}' # str | Page Number and Page Size.  Number is the page number of the collection to return, size is the number of items to return per page. (optional) (default to {:number=>1,+:size=>20})

try: 
    # Get a list all the disabled signatures for an external account
    api_response = api_instance.list_disabled_signatures(external_account_id, include=include, filter=filter, page=page)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ExternalAccountsApi->list_disabled_signatures: %s\n" % e)

Parameters

Name	Type	Description	Notes
external_account_id	int	The ID of the external account to retrieve the disabled signatures for
include	str	Related objects that can be included in the response: service, suppressions See Including Objects for more information.	[optional]
filter	dict(str, str)	Filter Params for Searching. Equality Searchable Attributes: [id, risk_level, service_id, disabled, supports_user_attribution, name, identifier, description, resolution] Matching Searchable Attributes: [name, identifier, description, resolution] Limited Searchable Attributes: [service_provider_eq, service_provider_in, service_name_in, identifier_cont] Sortable Attributes: [name, identifier, updated_at, created_at, id] Searchable Associations: [signature_copy, disabled_external_accounts, integrations, suppressions] See Searching Lists for more information. See the filter parameter of the association's list action to see what attributes are searchable on each association. See Conditions on Relationships in Searching Lists for more information.	[optional]
page	str	Page Number and Page Size. Number is the page number of the collection to return, size is the number of items to return per page.	[optional] [default to {:number=>1,+:size=>20}]

Return type

PaginatedCollection

Authorization

See https://github.com/EvidentSecurity/esp-sdk-python#set-your-hmac-security-keys

HTTP request headers

Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

remove_compliance_standard

Meta remove_compliance_standard(external_account_id, compliance_standard_id)

Remove a compliance standard from an external account

Example

from __future__ import print_statement
import time
import esp_sdk
from esp_sdk.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = esp_sdk.ExternalAccountsApi()
external_account_id = 56 # int | The ID of the external account this compliance standard belongs to
compliance_standard_id = 56 # int | The ID of the compliance standard that belongs to this external account

try: 
    # Remove a compliance standard from an external account
    api_response = api_instance.remove_compliance_standard(external_account_id, compliance_standard_id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ExternalAccountsApi->remove_compliance_standard: %s\n" % e)

Parameters

Name	Type	Description	Notes
external_account_id	int	The ID of the external account this compliance standard belongs to
compliance_standard_id	int	The ID of the compliance standard that belongs to this external account

Return type

Meta

Authorization

See https://github.com/EvidentSecurity/esp-sdk-python#set-your-hmac-security-keys

HTTP request headers

Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

remove_custom_compliance_standard

Meta remove_custom_compliance_standard(external_account_id, custom_compliance_standard_id)

Remove a custom compliance standard from an external account

Example

from __future__ import print_statement
import time
import esp_sdk
from esp_sdk.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = esp_sdk.ExternalAccountsApi()
external_account_id = 56 # int | The ID of the external account this custom compliance standard belongs to
custom_compliance_standard_id = 56 # int | The ID of the custom compliance standard that belongs to this external account

try: 
    # Remove a custom compliance standard from an external account
    api_response = api_instance.remove_custom_compliance_standard(external_account_id, custom_compliance_standard_id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ExternalAccountsApi->remove_custom_compliance_standard: %s\n" % e)

Parameters

Name	Type	Description	Notes
external_account_id	int	The ID of the external account this custom compliance standard belongs to
custom_compliance_standard_id	int	The ID of the custom compliance standard that belongs to this external account

Return type

Meta

Authorization

See https://github.com/EvidentSecurity/esp-sdk-python#set-your-hmac-security-keys

HTTP request headers

Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

remove_disabled_signature

Meta remove_disabled_signature(external_account_ids, signature_ids)

Re-enable a set of signatures for an external account or a set of external accounts for a signature

Example

from __future__ import print_statement
import time
import esp_sdk
from esp_sdk.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = esp_sdk.ExternalAccountsApi()
external_account_ids = [56] # list[int] | The IDs of the external_account(s) to enable
signature_ids = [56] # list[int] | The IDs of the signature(s) to enable

try: 
    # Re-enable a set of signatures for an external account or a set of external accounts for a signature
    api_response = api_instance.remove_disabled_signature(external_account_ids, signature_ids)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ExternalAccountsApi->remove_disabled_signature: %s\n" % e)

Parameters

Name	Type	Description	Notes
external_account_ids	list[int]	The IDs of the external_account(s) to enable
signature_ids	list[int]	The IDs of the signature(s) to enable

Return type

Meta

Authorization

See https://github.com/EvidentSecurity/esp-sdk-python#set-your-hmac-security-keys

HTTP request headers

Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

show

ExternalAccount show(id, include=include)

Show a single External Account

Example

from __future__ import print_statement
import time
import esp_sdk
from esp_sdk.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = esp_sdk.ExternalAccountsApi()
id = 56 # int | External Account ID
include = 'include_example' # str | Related objects that can be included in the response:  organization, sub_organization, team, scan_intervals, disabled_signatures, suppressions, azure_group See Including Objects for more information. (optional)

try: 
    # Show a single External Account
    api_response = api_instance.show(id, include=include)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ExternalAccountsApi->show: %s\n" % e)

Parameters

Name	Type	Description	Notes
id	int	External Account ID
include	str	Related objects that can be included in the response: organization, sub_organization, team, scan_intervals, disabled_signatures, suppressions, azure_group See Including Objects for more information.	[optional]

Return type

ExternalAccount

Authorization

See https://github.com/EvidentSecurity/esp-sdk-python#set-your-hmac-security-keys

HTTP request headers

Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

FilesExpand file tree

ExternalAccountsApi.md

Latest commit

History

ExternalAccountsApi.md

File metadata and controls

esp_sdk.ExternalAccountsApi

add_compliance_standard

Example

Parameters

Return type

Authorization

HTTP request headers

add_custom_compliance_standard

Example

Parameters

Return type

Authorization

HTTP request headers

add_disabled_signature

Example

Parameters

Return type

Authorization

HTTP request headers

delete

Example

Parameters

Return type

Authorization

HTTP request headers

list

Example

Parameters

Return type

Authorization

HTTP request headers

list_compliance_standards

Example

Parameters

Return type

Authorization

HTTP request headers

list_custom_compliance_standards

Example

Parameters

Return type

Authorization

HTTP request headers

list_disabled_signatures

Example

Parameters

Return type

Authorization

HTTP request headers

remove_compliance_standard

Example

Parameters

Return type

Authorization

HTTP request headers

remove_custom_compliance_standard

Example

Parameters

Return type

Authorization

HTTP request headers

remove_disabled_signature

Example

Parameters

Return type

Authorization

HTTP request headers

show

Example

Parameters

Return type

Authorization

HTTP request headers