SecurityHubClient#
Index > SecurityHub > SecurityHubClient
Auto-generated documentation for SecurityHub type annotations stubs module mypy-boto3-securityhub.
SecurityHubClient#
Type annotations and code completion for boto3.client("securityhub").
boto3 documentation
# SecurityHubClient usage example
from boto3.session import Session
from mypy_boto3_securityhub.client import SecurityHubClient
def get_securityhub_client() -> SecurityHubClient:
return Session().client("securityhub")Exceptions#
boto3 client exceptions are generated in runtime.
This class provides code completion for boto3.client("securityhub").exceptions structure.
# Exceptions.exceptions usage example
client = boto3.client("securityhub")
try:
do_something(client)
except (
client.exceptions.AccessDeniedException,
client.exceptions.ClientError,
client.exceptions.InternalException,
client.exceptions.InvalidAccessException,
client.exceptions.InvalidInputException,
client.exceptions.LimitExceededException,
client.exceptions.ResourceConflictException,
client.exceptions.ResourceInUseException,
client.exceptions.ResourceNotFoundException,
) as e:
print(e)# Exceptions.exceptions type checking example
from mypy_boto3_securityhub.client import Exceptions
def handle_error(exc: Exceptions.AccessDeniedException) -> None:
...Methods#
accept_administrator_invitation#
.
Type annotations and code completion for boto3.client("securityhub").accept_administrator_invitation method.
boto3 documentation
# accept_administrator_invitation method definition
def accept_administrator_invitation(
self,
*,
AdministratorId: str,
InvitationId: str,
) -> Dict[str, Any]:
...# accept_administrator_invitation method usage example with argument unpacking
kwargs: AcceptAdministratorInvitationRequestRequestTypeDef = { # (1)
"AdministratorId": ...,
"InvitationId": ...,
}
parent.accept_administrator_invitation(**kwargs)accept_invitation#
This method is deprecated.
Type annotations and code completion for boto3.client("securityhub").accept_invitation method.
boto3 documentation
# accept_invitation method definition
def accept_invitation(
self,
*,
MasterId: str,
InvitationId: str,
) -> Dict[str, Any]:
...# accept_invitation method usage example with argument unpacking
kwargs: AcceptInvitationRequestRequestTypeDef = { # (1)
"MasterId": ...,
"InvitationId": ...,
}
parent.accept_invitation(**kwargs)batch_delete_automation_rules#
Deletes one or more automation rules.
Type annotations and code completion for boto3.client("securityhub").batch_delete_automation_rules method.
boto3 documentation
# batch_delete_automation_rules method definition
def batch_delete_automation_rules(
self,
*,
AutomationRulesArns: Sequence[str],
) -> BatchDeleteAutomationRulesResponseTypeDef: # (1)
...# batch_delete_automation_rules method usage example with argument unpacking
kwargs: BatchDeleteAutomationRulesRequestRequestTypeDef = { # (1)
"AutomationRulesArns": ...,
}
parent.batch_delete_automation_rules(**kwargs)batch_disable_standards#
Disables the standards specified by the provided StandardsSubscriptionArns.
Type annotations and code completion for boto3.client("securityhub").batch_disable_standards method.
boto3 documentation
# batch_disable_standards method definition
def batch_disable_standards(
self,
*,
StandardsSubscriptionArns: Sequence[str],
) -> BatchDisableStandardsResponseTypeDef: # (1)
...# batch_disable_standards method usage example with argument unpacking
kwargs: BatchDisableStandardsRequestRequestTypeDef = { # (1)
"StandardsSubscriptionArns": ...,
}
parent.batch_disable_standards(**kwargs)batch_enable_standards#
Enables the standards specified by the provided StandardsArn.
Type annotations and code completion for boto3.client("securityhub").batch_enable_standards method.
boto3 documentation
# batch_enable_standards method definition
def batch_enable_standards(
self,
*,
StandardsSubscriptionRequests: Sequence[StandardsSubscriptionRequestTypeDef], # (1)
) -> BatchEnableStandardsResponseTypeDef: # (2)
...# batch_enable_standards method usage example with argument unpacking
kwargs: BatchEnableStandardsRequestRequestTypeDef = { # (1)
"StandardsSubscriptionRequests": ...,
}
parent.batch_enable_standards(**kwargs)batch_get_automation_rules#
Retrieves a list of details for automation rules based on rule Amazon Resource Names (ARNs).
Type annotations and code completion for boto3.client("securityhub").batch_get_automation_rules method.
boto3 documentation
# batch_get_automation_rules method definition
def batch_get_automation_rules(
self,
*,
AutomationRulesArns: Sequence[str],
) -> BatchGetAutomationRulesResponseTypeDef: # (1)
...# batch_get_automation_rules method usage example with argument unpacking
kwargs: BatchGetAutomationRulesRequestRequestTypeDef = { # (1)
"AutomationRulesArns": ...,
}
parent.batch_get_automation_rules(**kwargs)batch_get_configuration_policy_associations#
Returns associations between an Security Hub configuration and a batch of target accounts, organizational units, or the root.
Type annotations and code completion for boto3.client("securityhub").batch_get_configuration_policy_associations method.
boto3 documentation
# batch_get_configuration_policy_associations method definition
def batch_get_configuration_policy_associations(
self,
*,
ConfigurationPolicyAssociationIdentifiers: Sequence[ConfigurationPolicyAssociationTypeDef], # (1)
) -> BatchGetConfigurationPolicyAssociationsResponseTypeDef: # (2)
...- See ConfigurationPolicyAssociationTypeDef
- See BatchGetConfigurationPolicyAssociationsResponseTypeDef
# batch_get_configuration_policy_associations method usage example with argument unpacking
kwargs: BatchGetConfigurationPolicyAssociationsRequestRequestTypeDef = { # (1)
"ConfigurationPolicyAssociationIdentifiers": ...,
}
parent.batch_get_configuration_policy_associations(**kwargs)batch_get_security_controls#
Provides details about a batch of security controls for the current Amazon Web Services account and Amazon Web Services Region.
Type annotations and code completion for boto3.client("securityhub").batch_get_security_controls method.
boto3 documentation
# batch_get_security_controls method definition
def batch_get_security_controls(
self,
*,
SecurityControlIds: Sequence[str],
) -> BatchGetSecurityControlsResponseTypeDef: # (1)
...# batch_get_security_controls method usage example with argument unpacking
kwargs: BatchGetSecurityControlsRequestRequestTypeDef = { # (1)
"SecurityControlIds": ...,
}
parent.batch_get_security_controls(**kwargs)batch_get_standards_control_associations#
For a batch of security controls and standards, identifies whether each control is currently enabled or disabled in a standard.
Type annotations and code completion for boto3.client("securityhub").batch_get_standards_control_associations method.
boto3 documentation
# batch_get_standards_control_associations method definition
def batch_get_standards_control_associations(
self,
*,
StandardsControlAssociationIds: Sequence[StandardsControlAssociationIdTypeDef], # (1)
) -> BatchGetStandardsControlAssociationsResponseTypeDef: # (2)
...# batch_get_standards_control_associations method usage example with argument unpacking
kwargs: BatchGetStandardsControlAssociationsRequestRequestTypeDef = { # (1)
"StandardsControlAssociationIds": ...,
}
parent.batch_get_standards_control_associations(**kwargs)batch_import_findings#
Imports security findings generated by a finding provider into Security Hub.
Type annotations and code completion for boto3.client("securityhub").batch_import_findings method.
boto3 documentation
# batch_import_findings method definition
def batch_import_findings(
self,
*,
Findings: Sequence[AwsSecurityFindingUnionTypeDef], # (1)
) -> BatchImportFindingsResponseTypeDef: # (2)
...- See AwsSecurityFindingTypeDef AwsSecurityFindingOutputTypeDef
- See BatchImportFindingsResponseTypeDef
# batch_import_findings method usage example with argument unpacking
kwargs: BatchImportFindingsRequestRequestTypeDef = { # (1)
"Findings": ...,
}
parent.batch_import_findings(**kwargs)batch_update_automation_rules#
Updates one or more automation rules based on rule Amazon Resource Names (ARNs) and input parameters.
Type annotations and code completion for boto3.client("securityhub").batch_update_automation_rules method.
boto3 documentation
# batch_update_automation_rules method definition
def batch_update_automation_rules(
self,
*,
UpdateAutomationRulesRequestItems: Sequence[UpdateAutomationRulesRequestItemTypeDef], # (1)
) -> BatchUpdateAutomationRulesResponseTypeDef: # (2)
...# batch_update_automation_rules method usage example with argument unpacking
kwargs: BatchUpdateAutomationRulesRequestRequestTypeDef = { # (1)
"UpdateAutomationRulesRequestItems": ...,
}
parent.batch_update_automation_rules(**kwargs)batch_update_findings#
Used by Security Hub customers to update information about their investigation into a finding.
Type annotations and code completion for boto3.client("securityhub").batch_update_findings method.
boto3 documentation
# batch_update_findings method definition
def batch_update_findings(
self,
*,
FindingIdentifiers: Sequence[AwsSecurityFindingIdentifierTypeDef], # (1)
Note: NoteUpdateTypeDef = ..., # (2)
Severity: SeverityUpdateTypeDef = ..., # (3)
VerificationState: VerificationStateType = ..., # (4)
Confidence: int = ...,
Criticality: int = ...,
Types: Sequence[str] = ...,
UserDefinedFields: Mapping[str, str] = ...,
Workflow: WorkflowUpdateTypeDef = ..., # (5)
RelatedFindings: Sequence[RelatedFindingTypeDef] = ..., # (6)
) -> BatchUpdateFindingsResponseTypeDef: # (7)
...- See AwsSecurityFindingIdentifierTypeDef
- See NoteUpdateTypeDef
- See SeverityUpdateTypeDef
- See VerificationStateType
- See WorkflowUpdateTypeDef
- See RelatedFindingTypeDef
- See BatchUpdateFindingsResponseTypeDef
# batch_update_findings method usage example with argument unpacking
kwargs: BatchUpdateFindingsRequestRequestTypeDef = { # (1)
"FindingIdentifiers": ...,
}
parent.batch_update_findings(**kwargs)batch_update_standards_control_associations#
For a batch of security controls and standards, this operation updates the enablement status of a control in a standard.
Type annotations and code completion for boto3.client("securityhub").batch_update_standards_control_associations method.
boto3 documentation
# batch_update_standards_control_associations method definition
def batch_update_standards_control_associations(
self,
*,
StandardsControlAssociationUpdates: Sequence[StandardsControlAssociationUpdateTypeDef], # (1)
) -> BatchUpdateStandardsControlAssociationsResponseTypeDef: # (2)
...- See StandardsControlAssociationUpdateTypeDef
- See BatchUpdateStandardsControlAssociationsResponseTypeDef
# batch_update_standards_control_associations method usage example with argument unpacking
kwargs: BatchUpdateStandardsControlAssociationsRequestRequestTypeDef = { # (1)
"StandardsControlAssociationUpdates": ...,
}
parent.batch_update_standards_control_associations(**kwargs)can_paginate#
Check if an operation can be paginated.
Type annotations and code completion for boto3.client("securityhub").can_paginate method.
boto3 documentation
# can_paginate method definition
def can_paginate(
self,
operation_name: str,
) -> bool:
...close#
Closes underlying endpoint connections.
Type annotations and code completion for boto3.client("securityhub").close method.
boto3 documentation
# close method definition
def close(
self,
) -> None:
...create_action_target#
Creates a custom action target in Security Hub.
Type annotations and code completion for boto3.client("securityhub").create_action_target method.
boto3 documentation
# create_action_target method definition
def create_action_target(
self,
*,
Name: str,
Description: str,
Id: str,
) -> CreateActionTargetResponseTypeDef: # (1)
...# create_action_target method usage example with argument unpacking
kwargs: CreateActionTargetRequestRequestTypeDef = { # (1)
"Name": ...,
"Description": ...,
"Id": ...,
}
parent.create_action_target(**kwargs)create_automation_rule#
Creates an automation rule based on input parameters.
Type annotations and code completion for boto3.client("securityhub").create_automation_rule method.
boto3 documentation
# create_automation_rule method definition
def create_automation_rule(
self,
*,
RuleOrder: int,
RuleName: str,
Description: str,
Criteria: AutomationRulesFindingFiltersTypeDef, # (1)
Actions: Sequence[AutomationRulesActionUnionTypeDef], # (2)
Tags: Mapping[str, str] = ...,
RuleStatus: RuleStatusType = ..., # (3)
IsTerminal: bool = ...,
) -> CreateAutomationRuleResponseTypeDef: # (4)
...- See AutomationRulesFindingFiltersTypeDef
- See AutomationRulesActionTypeDef AutomationRulesActionOutputTypeDef
- See RuleStatusType
- See CreateAutomationRuleResponseTypeDef
# create_automation_rule method usage example with argument unpacking
kwargs: CreateAutomationRuleRequestRequestTypeDef = { # (1)
"RuleOrder": ...,
"RuleName": ...,
"Description": ...,
"Criteria": ...,
"Actions": ...,
}
parent.create_automation_rule(**kwargs)create_configuration_policy#
Creates a configuration policy with the defined configuration.
Type annotations and code completion for boto3.client("securityhub").create_configuration_policy method.
boto3 documentation
# create_configuration_policy method definition
def create_configuration_policy(
self,
*,
Name: str,
ConfigurationPolicy: PolicyTypeDef, # (1)
Description: str = ...,
Tags: Mapping[str, str] = ...,
) -> CreateConfigurationPolicyResponseTypeDef: # (2)
...# create_configuration_policy method usage example with argument unpacking
kwargs: CreateConfigurationPolicyRequestRequestTypeDef = { # (1)
"Name": ...,
"ConfigurationPolicy": ...,
}
parent.create_configuration_policy(**kwargs)create_finding_aggregator#
.
Type annotations and code completion for boto3.client("securityhub").create_finding_aggregator method.
boto3 documentation
# create_finding_aggregator method definition
def create_finding_aggregator(
self,
*,
RegionLinkingMode: str,
Regions: Sequence[str] = ...,
) -> CreateFindingAggregatorResponseTypeDef: # (1)
...# create_finding_aggregator method usage example with argument unpacking
kwargs: CreateFindingAggregatorRequestRequestTypeDef = { # (1)
"RegionLinkingMode": ...,
}
parent.create_finding_aggregator(**kwargs)create_insight#
Creates a custom insight in Security Hub.
Type annotations and code completion for boto3.client("securityhub").create_insight method.
boto3 documentation
# create_insight method definition
def create_insight(
self,
*,
Name: str,
Filters: AwsSecurityFindingFiltersTypeDef, # (1)
GroupByAttribute: str,
) -> CreateInsightResponseTypeDef: # (2)
...# create_insight method usage example with argument unpacking
kwargs: CreateInsightRequestRequestTypeDef = { # (1)
"Name": ...,
"Filters": ...,
"GroupByAttribute": ...,
}
parent.create_insight(**kwargs)create_members#
Creates a member association in Security Hub between the specified accounts and the account used to make the request, which is the administrator account.
Type annotations and code completion for boto3.client("securityhub").create_members method.
boto3 documentation
# create_members method definition
def create_members(
self,
*,
AccountDetails: Sequence[AccountDetailsTypeDef], # (1)
) -> CreateMembersResponseTypeDef: # (2)
...# create_members method usage example with argument unpacking
kwargs: CreateMembersRequestRequestTypeDef = { # (1)
"AccountDetails": ...,
}
parent.create_members(**kwargs)decline_invitations#
.
Type annotations and code completion for boto3.client("securityhub").decline_invitations method.
boto3 documentation
# decline_invitations method definition
def decline_invitations(
self,
*,
AccountIds: Sequence[str],
) -> DeclineInvitationsResponseTypeDef: # (1)
...# decline_invitations method usage example with argument unpacking
kwargs: DeclineInvitationsRequestRequestTypeDef = { # (1)
"AccountIds": ...,
}
parent.decline_invitations(**kwargs)delete_action_target#
Deletes a custom action target from Security Hub.
Type annotations and code completion for boto3.client("securityhub").delete_action_target method.
boto3 documentation
# delete_action_target method definition
def delete_action_target(
self,
*,
ActionTargetArn: str,
) -> DeleteActionTargetResponseTypeDef: # (1)
...# delete_action_target method usage example with argument unpacking
kwargs: DeleteActionTargetRequestRequestTypeDef = { # (1)
"ActionTargetArn": ...,
}
parent.delete_action_target(**kwargs)delete_configuration_policy#
Deletes a configuration policy.
Type annotations and code completion for boto3.client("securityhub").delete_configuration_policy method.
boto3 documentation
# delete_configuration_policy method definition
def delete_configuration_policy(
self,
*,
Identifier: str,
) -> Dict[str, Any]:
...# delete_configuration_policy method usage example with argument unpacking
kwargs: DeleteConfigurationPolicyRequestRequestTypeDef = { # (1)
"Identifier": ...,
}
parent.delete_configuration_policy(**kwargs)delete_finding_aggregator#
.
Type annotations and code completion for boto3.client("securityhub").delete_finding_aggregator method.
boto3 documentation
# delete_finding_aggregator method definition
def delete_finding_aggregator(
self,
*,
FindingAggregatorArn: str,
) -> Dict[str, Any]:
...# delete_finding_aggregator method usage example with argument unpacking
kwargs: DeleteFindingAggregatorRequestRequestTypeDef = { # (1)
"FindingAggregatorArn": ...,
}
parent.delete_finding_aggregator(**kwargs)delete_insight#
Deletes the insight specified by the InsightArn.
Type annotations and code completion for boto3.client("securityhub").delete_insight method.
boto3 documentation
# delete_insight method definition
def delete_insight(
self,
*,
InsightArn: str,
) -> DeleteInsightResponseTypeDef: # (1)
...# delete_insight method usage example with argument unpacking
kwargs: DeleteInsightRequestRequestTypeDef = { # (1)
"InsightArn": ...,
}
parent.delete_insight(**kwargs)delete_invitations#
.
Type annotations and code completion for boto3.client("securityhub").delete_invitations method.
boto3 documentation
# delete_invitations method definition
def delete_invitations(
self,
*,
AccountIds: Sequence[str],
) -> DeleteInvitationsResponseTypeDef: # (1)
...# delete_invitations method usage example with argument unpacking
kwargs: DeleteInvitationsRequestRequestTypeDef = { # (1)
"AccountIds": ...,
}
parent.delete_invitations(**kwargs)delete_members#
Deletes the specified member accounts from Security Hub.
Type annotations and code completion for boto3.client("securityhub").delete_members method.
boto3 documentation
# delete_members method definition
def delete_members(
self,
*,
AccountIds: Sequence[str],
) -> DeleteMembersResponseTypeDef: # (1)
...# delete_members method usage example with argument unpacking
kwargs: DeleteMembersRequestRequestTypeDef = { # (1)
"AccountIds": ...,
}
parent.delete_members(**kwargs)describe_action_targets#
Returns a list of the custom action targets in Security Hub in your account.
Type annotations and code completion for boto3.client("securityhub").describe_action_targets method.
boto3 documentation
# describe_action_targets method definition
def describe_action_targets(
self,
*,
ActionTargetArns: Sequence[str] = ...,
NextToken: str = ...,
MaxResults: int = ...,
) -> DescribeActionTargetsResponseTypeDef: # (1)
...# describe_action_targets method usage example with argument unpacking
kwargs: DescribeActionTargetsRequestRequestTypeDef = { # (1)
"ActionTargetArns": ...,
}
parent.describe_action_targets(**kwargs)describe_hub#
Returns details about the Hub resource in your account, including the HubArn
and the time when you enabled Security Hub.
Type annotations and code completion for boto3.client("securityhub").describe_hub method.
boto3 documentation
# describe_hub method definition
def describe_hub(
self,
*,
HubArn: str = ...,
) -> DescribeHubResponseTypeDef: # (1)
...# describe_hub method usage example with argument unpacking
kwargs: DescribeHubRequestRequestTypeDef = { # (1)
"HubArn": ...,
}
parent.describe_hub(**kwargs)describe_organization_configuration#
Returns information about the way your organization is configured in Security Hub.
Type annotations and code completion for boto3.client("securityhub").describe_organization_configuration method.
boto3 documentation
# describe_organization_configuration method definition
def describe_organization_configuration(
self,
) -> DescribeOrganizationConfigurationResponseTypeDef: # (1)
...describe_products#
Returns information about product integrations in Security Hub.
Type annotations and code completion for boto3.client("securityhub").describe_products method.
boto3 documentation
# describe_products method definition
def describe_products(
self,
*,
NextToken: str = ...,
MaxResults: int = ...,
ProductArn: str = ...,
) -> DescribeProductsResponseTypeDef: # (1)
...# describe_products method usage example with argument unpacking
kwargs: DescribeProductsRequestRequestTypeDef = { # (1)
"NextToken": ...,
}
parent.describe_products(**kwargs)describe_standards#
Returns a list of the available standards in Security Hub.
Type annotations and code completion for boto3.client("securityhub").describe_standards method.
boto3 documentation
# describe_standards method definition
def describe_standards(
self,
*,
NextToken: str = ...,
MaxResults: int = ...,
) -> DescribeStandardsResponseTypeDef: # (1)
...# describe_standards method usage example with argument unpacking
kwargs: DescribeStandardsRequestRequestTypeDef = { # (1)
"NextToken": ...,
}
parent.describe_standards(**kwargs)describe_standards_controls#
Returns a list of security standards controls.
Type annotations and code completion for boto3.client("securityhub").describe_standards_controls method.
boto3 documentation
# describe_standards_controls method definition
def describe_standards_controls(
self,
*,
StandardsSubscriptionArn: str,
NextToken: str = ...,
MaxResults: int = ...,
) -> DescribeStandardsControlsResponseTypeDef: # (1)
...# describe_standards_controls method usage example with argument unpacking
kwargs: DescribeStandardsControlsRequestRequestTypeDef = { # (1)
"StandardsSubscriptionArn": ...,
}
parent.describe_standards_controls(**kwargs)disable_import_findings_for_product#
Disables the integration of the specified product with Security Hub.
Type annotations and code completion for boto3.client("securityhub").disable_import_findings_for_product method.
boto3 documentation
# disable_import_findings_for_product method definition
def disable_import_findings_for_product(
self,
*,
ProductSubscriptionArn: str,
) -> Dict[str, Any]:
...# disable_import_findings_for_product method usage example with argument unpacking
kwargs: DisableImportFindingsForProductRequestRequestTypeDef = { # (1)
"ProductSubscriptionArn": ...,
}
parent.disable_import_findings_for_product(**kwargs)disable_organization_admin_account#
Disables a Security Hub administrator account.
Type annotations and code completion for boto3.client("securityhub").disable_organization_admin_account method.
boto3 documentation
# disable_organization_admin_account method definition
def disable_organization_admin_account(
self,
*,
AdminAccountId: str,
) -> Dict[str, Any]:
...# disable_organization_admin_account method usage example with argument unpacking
kwargs: DisableOrganizationAdminAccountRequestRequestTypeDef = { # (1)
"AdminAccountId": ...,
}
parent.disable_organization_admin_account(**kwargs)disable_security_hub#
Disables Security Hub in your account only in the current Amazon Web Services Region.
Type annotations and code completion for boto3.client("securityhub").disable_security_hub method.
boto3 documentation
# disable_security_hub method definition
def disable_security_hub(
self,
) -> Dict[str, Any]:
...disassociate_from_administrator_account#
Disassociates the current Security Hub member account from the associated administrator account.
Type annotations and code completion for boto3.client("securityhub").disassociate_from_administrator_account method.
boto3 documentation
# disassociate_from_administrator_account method definition
def disassociate_from_administrator_account(
self,
) -> Dict[str, Any]:
...disassociate_from_master_account#
This method is deprecated.
Type annotations and code completion for boto3.client("securityhub").disassociate_from_master_account method.
boto3 documentation
# disassociate_from_master_account method definition
def disassociate_from_master_account(
self,
) -> Dict[str, Any]:
...disassociate_members#
Disassociates the specified member accounts from the associated administrator account.
Type annotations and code completion for boto3.client("securityhub").disassociate_members method.
boto3 documentation
# disassociate_members method definition
def disassociate_members(
self,
*,
AccountIds: Sequence[str],
) -> Dict[str, Any]:
...# disassociate_members method usage example with argument unpacking
kwargs: DisassociateMembersRequestRequestTypeDef = { # (1)
"AccountIds": ...,
}
parent.disassociate_members(**kwargs)enable_import_findings_for_product#
Enables the integration of a partner product with Security Hub.
Type annotations and code completion for boto3.client("securityhub").enable_import_findings_for_product method.
boto3 documentation
# enable_import_findings_for_product method definition
def enable_import_findings_for_product(
self,
*,
ProductArn: str,
) -> EnableImportFindingsForProductResponseTypeDef: # (1)
...# enable_import_findings_for_product method usage example with argument unpacking
kwargs: EnableImportFindingsForProductRequestRequestTypeDef = { # (1)
"ProductArn": ...,
}
parent.enable_import_findings_for_product(**kwargs)enable_organization_admin_account#
Designates the Security Hub administrator account for an organization.
Type annotations and code completion for boto3.client("securityhub").enable_organization_admin_account method.
boto3 documentation
# enable_organization_admin_account method definition
def enable_organization_admin_account(
self,
*,
AdminAccountId: str,
) -> Dict[str, Any]:
...# enable_organization_admin_account method usage example with argument unpacking
kwargs: EnableOrganizationAdminAccountRequestRequestTypeDef = { # (1)
"AdminAccountId": ...,
}
parent.enable_organization_admin_account(**kwargs)enable_security_hub#
Enables Security Hub for your account in the current Region or the Region you specify in the request.
Type annotations and code completion for boto3.client("securityhub").enable_security_hub method.
boto3 documentation
# enable_security_hub method definition
def enable_security_hub(
self,
*,
Tags: Mapping[str, str] = ...,
EnableDefaultStandards: bool = ...,
ControlFindingGenerator: ControlFindingGeneratorType = ..., # (1)
) -> Dict[str, Any]:
...# enable_security_hub method usage example with argument unpacking
kwargs: EnableSecurityHubRequestRequestTypeDef = { # (1)
"Tags": ...,
}
parent.enable_security_hub(**kwargs)generate_presigned_url#
Generate a presigned url given a client, its method, and arguments.
Type annotations and code completion for boto3.client("securityhub").generate_presigned_url method.
boto3 documentation
# generate_presigned_url method definition
def generate_presigned_url(
self,
ClientMethod: str,
Params: Mapping[str, Any] = ...,
ExpiresIn: int = 3600,
HttpMethod: str = ...,
) -> str:
...get_administrator_account#
Provides the details for the Security Hub administrator account for the current member account.
Type annotations and code completion for boto3.client("securityhub").get_administrator_account method.
boto3 documentation
# get_administrator_account method definition
def get_administrator_account(
self,
) -> GetAdministratorAccountResponseTypeDef: # (1)
...get_configuration_policy#
Provides information about a configuration policy.
Type annotations and code completion for boto3.client("securityhub").get_configuration_policy method.
boto3 documentation
# get_configuration_policy method definition
def get_configuration_policy(
self,
*,
Identifier: str,
) -> GetConfigurationPolicyResponseTypeDef: # (1)
...# get_configuration_policy method usage example with argument unpacking
kwargs: GetConfigurationPolicyRequestRequestTypeDef = { # (1)
"Identifier": ...,
}
parent.get_configuration_policy(**kwargs)get_configuration_policy_association#
Returns the association between a configuration and a target account, organizational unit, or the root.
Type annotations and code completion for boto3.client("securityhub").get_configuration_policy_association method.
boto3 documentation
# get_configuration_policy_association method definition
def get_configuration_policy_association(
self,
*,
Target: TargetTypeDef, # (1)
) -> GetConfigurationPolicyAssociationResponseTypeDef: # (2)
...# get_configuration_policy_association method usage example with argument unpacking
kwargs: GetConfigurationPolicyAssociationRequestRequestTypeDef = { # (1)
"Target": ...,
}
parent.get_configuration_policy_association(**kwargs)get_enabled_standards#
Returns a list of the standards that are currently enabled.
Type annotations and code completion for boto3.client("securityhub").get_enabled_standards method.
boto3 documentation
# get_enabled_standards method definition
def get_enabled_standards(
self,
*,
StandardsSubscriptionArns: Sequence[str] = ...,
NextToken: str = ...,
MaxResults: int = ...,
) -> GetEnabledStandardsResponseTypeDef: # (1)
...# get_enabled_standards method usage example with argument unpacking
kwargs: GetEnabledStandardsRequestRequestTypeDef = { # (1)
"StandardsSubscriptionArns": ...,
}
parent.get_enabled_standards(**kwargs)get_finding_aggregator#
.
Type annotations and code completion for boto3.client("securityhub").get_finding_aggregator method.
boto3 documentation
# get_finding_aggregator method definition
def get_finding_aggregator(
self,
*,
FindingAggregatorArn: str,
) -> GetFindingAggregatorResponseTypeDef: # (1)
...# get_finding_aggregator method usage example with argument unpacking
kwargs: GetFindingAggregatorRequestRequestTypeDef = { # (1)
"FindingAggregatorArn": ...,
}
parent.get_finding_aggregator(**kwargs)get_finding_history#
Returns history for a Security Hub finding in the last 90 days.
Type annotations and code completion for boto3.client("securityhub").get_finding_history method.
boto3 documentation
# get_finding_history method definition
def get_finding_history(
self,
*,
FindingIdentifier: AwsSecurityFindingIdentifierTypeDef, # (1)
StartTime: TimestampTypeDef = ...,
EndTime: TimestampTypeDef = ...,
NextToken: str = ...,
MaxResults: int = ...,
) -> GetFindingHistoryResponseTypeDef: # (2)
...# get_finding_history method usage example with argument unpacking
kwargs: GetFindingHistoryRequestRequestTypeDef = { # (1)
"FindingIdentifier": ...,
}
parent.get_finding_history(**kwargs)get_findings#
Returns a list of findings that match the specified criteria.
Type annotations and code completion for boto3.client("securityhub").get_findings method.
boto3 documentation
# get_findings method definition
def get_findings(
self,
*,
Filters: AwsSecurityFindingFiltersTypeDef = ..., # (1)
SortCriteria: Sequence[SortCriterionTypeDef] = ..., # (2)
NextToken: str = ...,
MaxResults: int = ...,
) -> GetFindingsResponseTypeDef: # (3)
...# get_findings method usage example with argument unpacking
kwargs: GetFindingsRequestRequestTypeDef = { # (1)
"Filters": ...,
}
parent.get_findings(**kwargs)get_insight_results#
Lists the results of the Security Hub insight specified by the insight ARN.
Type annotations and code completion for boto3.client("securityhub").get_insight_results method.
boto3 documentation
# get_insight_results method definition
def get_insight_results(
self,
*,
InsightArn: str,
) -> GetInsightResultsResponseTypeDef: # (1)
...# get_insight_results method usage example with argument unpacking
kwargs: GetInsightResultsRequestRequestTypeDef = { # (1)
"InsightArn": ...,
}
parent.get_insight_results(**kwargs)get_insights#
Lists and describes insights for the specified insight ARNs.
Type annotations and code completion for boto3.client("securityhub").get_insights method.
boto3 documentation
# get_insights method definition
def get_insights(
self,
*,
InsightArns: Sequence[str] = ...,
NextToken: str = ...,
MaxResults: int = ...,
) -> GetInsightsResponseTypeDef: # (1)
...# get_insights method usage example with argument unpacking
kwargs: GetInsightsRequestRequestTypeDef = { # (1)
"InsightArns": ...,
}
parent.get_insights(**kwargs)get_invitations_count#
.
Type annotations and code completion for boto3.client("securityhub").get_invitations_count method.
boto3 documentation
# get_invitations_count method definition
def get_invitations_count(
self,
) -> GetInvitationsCountResponseTypeDef: # (1)
...get_master_account#
This method is deprecated.
Type annotations and code completion for boto3.client("securityhub").get_master_account method.
boto3 documentation
# get_master_account method definition
def get_master_account(
self,
) -> GetMasterAccountResponseTypeDef: # (1)
...get_members#
Returns the details for the Security Hub member accounts for the specified account IDs.
Type annotations and code completion for boto3.client("securityhub").get_members method.
boto3 documentation
# get_members method definition
def get_members(
self,
*,
AccountIds: Sequence[str],
) -> GetMembersResponseTypeDef: # (1)
...# get_members method usage example with argument unpacking
kwargs: GetMembersRequestRequestTypeDef = { # (1)
"AccountIds": ...,
}
parent.get_members(**kwargs)get_security_control_definition#
Retrieves the definition of a security control.
Type annotations and code completion for boto3.client("securityhub").get_security_control_definition method.
boto3 documentation
# get_security_control_definition method definition
def get_security_control_definition(
self,
*,
SecurityControlId: str,
) -> GetSecurityControlDefinitionResponseTypeDef: # (1)
...# get_security_control_definition method usage example with argument unpacking
kwargs: GetSecurityControlDefinitionRequestRequestTypeDef = { # (1)
"SecurityControlId": ...,
}
parent.get_security_control_definition(**kwargs)invite_members#
.
Type annotations and code completion for boto3.client("securityhub").invite_members method.
boto3 documentation
# invite_members method definition
def invite_members(
self,
*,
AccountIds: Sequence[str],
) -> InviteMembersResponseTypeDef: # (1)
...# invite_members method usage example with argument unpacking
kwargs: InviteMembersRequestRequestTypeDef = { # (1)
"AccountIds": ...,
}
parent.invite_members(**kwargs)list_automation_rules#
A list of automation rules and their metadata for the calling account.
Type annotations and code completion for boto3.client("securityhub").list_automation_rules method.
boto3 documentation
# list_automation_rules method definition
def list_automation_rules(
self,
*,
NextToken: str = ...,
MaxResults: int = ...,
) -> ListAutomationRulesResponseTypeDef: # (1)
...# list_automation_rules method usage example with argument unpacking
kwargs: ListAutomationRulesRequestRequestTypeDef = { # (1)
"NextToken": ...,
}
parent.list_automation_rules(**kwargs)list_configuration_policies#
Lists the configuration policies that the Security Hub delegated administrator has created for your organization.
Type annotations and code completion for boto3.client("securityhub").list_configuration_policies method.
boto3 documentation
# list_configuration_policies method definition
def list_configuration_policies(
self,
*,
NextToken: str = ...,
MaxResults: int = ...,
) -> ListConfigurationPoliciesResponseTypeDef: # (1)
...# list_configuration_policies method usage example with argument unpacking
kwargs: ListConfigurationPoliciesRequestRequestTypeDef = { # (1)
"NextToken": ...,
}
parent.list_configuration_policies(**kwargs)list_configuration_policy_associations#
Provides information about the associations for your configuration policies and self-managed behavior.
Type annotations and code completion for boto3.client("securityhub").list_configuration_policy_associations method.
boto3 documentation
# list_configuration_policy_associations method definition
def list_configuration_policy_associations(
self,
*,
NextToken: str = ...,
MaxResults: int = ...,
Filters: AssociationFiltersTypeDef = ..., # (1)
) -> ListConfigurationPolicyAssociationsResponseTypeDef: # (2)
...# list_configuration_policy_associations method usage example with argument unpacking
kwargs: ListConfigurationPolicyAssociationsRequestRequestTypeDef = { # (1)
"NextToken": ...,
}
parent.list_configuration_policy_associations(**kwargs)list_enabled_products_for_import#
Lists all findings-generating solutions (products) that you are subscribed to receive findings from in Security Hub.
Type annotations and code completion for boto3.client("securityhub").list_enabled_products_for_import method.
boto3 documentation
# list_enabled_products_for_import method definition
def list_enabled_products_for_import(
self,
*,
NextToken: str = ...,
MaxResults: int = ...,
) -> ListEnabledProductsForImportResponseTypeDef: # (1)
...# list_enabled_products_for_import method usage example with argument unpacking
kwargs: ListEnabledProductsForImportRequestRequestTypeDef = { # (1)
"NextToken": ...,
}
parent.list_enabled_products_for_import(**kwargs)list_finding_aggregators#
If cross-Region aggregation is enabled, then ListFindingAggregators returns
the Amazon Resource Name (ARN) of the finding aggregator.
Type annotations and code completion for boto3.client("securityhub").list_finding_aggregators method.
boto3 documentation
# list_finding_aggregators method definition
def list_finding_aggregators(
self,
*,
NextToken: str = ...,
MaxResults: int = ...,
) -> ListFindingAggregatorsResponseTypeDef: # (1)
...# list_finding_aggregators method usage example with argument unpacking
kwargs: ListFindingAggregatorsRequestRequestTypeDef = { # (1)
"NextToken": ...,
}
parent.list_finding_aggregators(**kwargs)list_invitations#
.
Type annotations and code completion for boto3.client("securityhub").list_invitations method.
boto3 documentation
# list_invitations method definition
def list_invitations(
self,
*,
MaxResults: int = ...,
NextToken: str = ...,
) -> ListInvitationsResponseTypeDef: # (1)
...# list_invitations method usage example with argument unpacking
kwargs: ListInvitationsRequestRequestTypeDef = { # (1)
"MaxResults": ...,
}
parent.list_invitations(**kwargs)list_members#
Lists details about all member accounts for the current Security Hub administrator account.
Type annotations and code completion for boto3.client("securityhub").list_members method.
boto3 documentation
# list_members method definition
def list_members(
self,
*,
OnlyAssociated: bool = ...,
MaxResults: int = ...,
NextToken: str = ...,
) -> ListMembersResponseTypeDef: # (1)
...# list_members method usage example with argument unpacking
kwargs: ListMembersRequestRequestTypeDef = { # (1)
"OnlyAssociated": ...,
}
parent.list_members(**kwargs)list_organization_admin_accounts#
Lists the Security Hub administrator accounts.
Type annotations and code completion for boto3.client("securityhub").list_organization_admin_accounts method.
boto3 documentation
# list_organization_admin_accounts method definition
def list_organization_admin_accounts(
self,
*,
MaxResults: int = ...,
NextToken: str = ...,
) -> ListOrganizationAdminAccountsResponseTypeDef: # (1)
...# list_organization_admin_accounts method usage example with argument unpacking
kwargs: ListOrganizationAdminAccountsRequestRequestTypeDef = { # (1)
"MaxResults": ...,
}
parent.list_organization_admin_accounts(**kwargs)list_security_control_definitions#
Lists all of the security controls that apply to a specified standard.
Type annotations and code completion for boto3.client("securityhub").list_security_control_definitions method.
boto3 documentation
# list_security_control_definitions method definition
def list_security_control_definitions(
self,
*,
StandardsArn: str = ...,
NextToken: str = ...,
MaxResults: int = ...,
) -> ListSecurityControlDefinitionsResponseTypeDef: # (1)
...# list_security_control_definitions method usage example with argument unpacking
kwargs: ListSecurityControlDefinitionsRequestRequestTypeDef = { # (1)
"StandardsArn": ...,
}
parent.list_security_control_definitions(**kwargs)list_standards_control_associations#
Specifies whether a control is currently enabled or disabled in each enabled standard in the calling account.
Type annotations and code completion for boto3.client("securityhub").list_standards_control_associations method.
boto3 documentation
# list_standards_control_associations method definition
def list_standards_control_associations(
self,
*,
SecurityControlId: str,
NextToken: str = ...,
MaxResults: int = ...,
) -> ListStandardsControlAssociationsResponseTypeDef: # (1)
...# list_standards_control_associations method usage example with argument unpacking
kwargs: ListStandardsControlAssociationsRequestRequestTypeDef = { # (1)
"SecurityControlId": ...,
}
parent.list_standards_control_associations(**kwargs)list_tags_for_resource#
Returns a list of tags associated with a resource.
Type annotations and code completion for boto3.client("securityhub").list_tags_for_resource method.
boto3 documentation
# list_tags_for_resource method definition
def list_tags_for_resource(
self,
*,
ResourceArn: str,
) -> ListTagsForResourceResponseTypeDef: # (1)
...# list_tags_for_resource method usage example with argument unpacking
kwargs: ListTagsForResourceRequestRequestTypeDef = { # (1)
"ResourceArn": ...,
}
parent.list_tags_for_resource(**kwargs)start_configuration_policy_association#
Associates a target account, organizational unit, or the root with a specified configuration.
Type annotations and code completion for boto3.client("securityhub").start_configuration_policy_association method.
boto3 documentation
# start_configuration_policy_association method definition
def start_configuration_policy_association(
self,
*,
ConfigurationPolicyIdentifier: str,
Target: TargetTypeDef, # (1)
) -> StartConfigurationPolicyAssociationResponseTypeDef: # (2)
...# start_configuration_policy_association method usage example with argument unpacking
kwargs: StartConfigurationPolicyAssociationRequestRequestTypeDef = { # (1)
"ConfigurationPolicyIdentifier": ...,
"Target": ...,
}
parent.start_configuration_policy_association(**kwargs)start_configuration_policy_disassociation#
Disassociates a target account, organizational unit, or the root from a specified configuration.
Type annotations and code completion for boto3.client("securityhub").start_configuration_policy_disassociation method.
boto3 documentation
# start_configuration_policy_disassociation method definition
def start_configuration_policy_disassociation(
self,
*,
ConfigurationPolicyIdentifier: str,
Target: TargetTypeDef = ..., # (1)
) -> Dict[str, Any]:
...- See TargetTypeDef
# start_configuration_policy_disassociation method usage example with argument unpacking
kwargs: StartConfigurationPolicyDisassociationRequestRequestTypeDef = { # (1)
"ConfigurationPolicyIdentifier": ...,
}
parent.start_configuration_policy_disassociation(**kwargs)tag_resource#
Adds one or more tags to a resource.
Type annotations and code completion for boto3.client("securityhub").tag_resource method.
boto3 documentation
# tag_resource method definition
def tag_resource(
self,
*,
ResourceArn: str,
Tags: Mapping[str, str],
) -> Dict[str, Any]:
...# tag_resource method usage example with argument unpacking
kwargs: TagResourceRequestRequestTypeDef = { # (1)
"ResourceArn": ...,
"Tags": ...,
}
parent.tag_resource(**kwargs)untag_resource#
Removes one or more tags from a resource.
Type annotations and code completion for boto3.client("securityhub").untag_resource method.
boto3 documentation
# untag_resource method definition
def untag_resource(
self,
*,
ResourceArn: str,
TagKeys: Sequence[str],
) -> Dict[str, Any]:
...# untag_resource method usage example with argument unpacking
kwargs: UntagResourceRequestRequestTypeDef = { # (1)
"ResourceArn": ...,
"TagKeys": ...,
}
parent.untag_resource(**kwargs)update_action_target#
Updates the name and description of a custom action target in Security Hub.
Type annotations and code completion for boto3.client("securityhub").update_action_target method.
boto3 documentation
# update_action_target method definition
def update_action_target(
self,
*,
ActionTargetArn: str,
Name: str = ...,
Description: str = ...,
) -> Dict[str, Any]:
...# update_action_target method usage example with argument unpacking
kwargs: UpdateActionTargetRequestRequestTypeDef = { # (1)
"ActionTargetArn": ...,
}
parent.update_action_target(**kwargs)update_configuration_policy#
Updates a configuration policy.
Type annotations and code completion for boto3.client("securityhub").update_configuration_policy method.
boto3 documentation
# update_configuration_policy method definition
def update_configuration_policy(
self,
*,
Identifier: str,
Name: str = ...,
Description: str = ...,
UpdatedReason: str = ...,
ConfigurationPolicy: PolicyTypeDef = ..., # (1)
) -> UpdateConfigurationPolicyResponseTypeDef: # (2)
...# update_configuration_policy method usage example with argument unpacking
kwargs: UpdateConfigurationPolicyRequestRequestTypeDef = { # (1)
"Identifier": ...,
}
parent.update_configuration_policy(**kwargs)update_finding_aggregator#
.
Type annotations and code completion for boto3.client("securityhub").update_finding_aggregator method.
boto3 documentation
# update_finding_aggregator method definition
def update_finding_aggregator(
self,
*,
FindingAggregatorArn: str,
RegionLinkingMode: str,
Regions: Sequence[str] = ...,
) -> UpdateFindingAggregatorResponseTypeDef: # (1)
...# update_finding_aggregator method usage example with argument unpacking
kwargs: UpdateFindingAggregatorRequestRequestTypeDef = { # (1)
"FindingAggregatorArn": ...,
"RegionLinkingMode": ...,
}
parent.update_finding_aggregator(**kwargs)update_findings#
UpdateFindings is a deprecated operation.
Type annotations and code completion for boto3.client("securityhub").update_findings method.
boto3 documentation
# update_findings method definition
def update_findings(
self,
*,
Filters: AwsSecurityFindingFiltersTypeDef, # (1)
Note: NoteUpdateTypeDef = ..., # (2)
RecordState: RecordStateType = ..., # (3)
) -> Dict[str, Any]:
...# update_findings method usage example with argument unpacking
kwargs: UpdateFindingsRequestRequestTypeDef = { # (1)
"Filters": ...,
}
parent.update_findings(**kwargs)update_insight#
Updates the Security Hub insight identified by the specified insight ARN.
Type annotations and code completion for boto3.client("securityhub").update_insight method.
boto3 documentation
# update_insight method definition
def update_insight(
self,
*,
InsightArn: str,
Name: str = ...,
Filters: AwsSecurityFindingFiltersTypeDef = ..., # (1)
GroupByAttribute: str = ...,
) -> Dict[str, Any]:
...# update_insight method usage example with argument unpacking
kwargs: UpdateInsightRequestRequestTypeDef = { # (1)
"InsightArn": ...,
}
parent.update_insight(**kwargs)update_organization_configuration#
Updates the configuration of your organization in Security Hub.
Type annotations and code completion for boto3.client("securityhub").update_organization_configuration method.
boto3 documentation
# update_organization_configuration method definition
def update_organization_configuration(
self,
*,
AutoEnable: bool,
AutoEnableStandards: AutoEnableStandardsType = ..., # (1)
OrganizationConfiguration: OrganizationConfigurationTypeDef = ..., # (2)
) -> Dict[str, Any]:
...# update_organization_configuration method usage example with argument unpacking
kwargs: UpdateOrganizationConfigurationRequestRequestTypeDef = { # (1)
"AutoEnable": ...,
}
parent.update_organization_configuration(**kwargs)update_security_control#
Updates the properties of a security control.
Type annotations and code completion for boto3.client("securityhub").update_security_control method.
boto3 documentation
# update_security_control method definition
def update_security_control(
self,
*,
SecurityControlId: str,
Parameters: Mapping[str, ParameterConfigurationUnionTypeDef], # (1)
LastUpdateReason: str = ...,
) -> Dict[str, Any]:
...# update_security_control method usage example with argument unpacking
kwargs: UpdateSecurityControlRequestRequestTypeDef = { # (1)
"SecurityControlId": ...,
"Parameters": ...,
}
parent.update_security_control(**kwargs)update_security_hub_configuration#
Updates configuration options for Security Hub.
Type annotations and code completion for boto3.client("securityhub").update_security_hub_configuration method.
boto3 documentation
# update_security_hub_configuration method definition
def update_security_hub_configuration(
self,
*,
AutoEnableControls: bool = ...,
ControlFindingGenerator: ControlFindingGeneratorType = ..., # (1)
) -> Dict[str, Any]:
...# update_security_hub_configuration method usage example with argument unpacking
kwargs: UpdateSecurityHubConfigurationRequestRequestTypeDef = { # (1)
"AutoEnableControls": ...,
}
parent.update_security_hub_configuration(**kwargs)update_standards_control#
Used to control whether an individual security standard control is enabled or disabled.
Type annotations and code completion for boto3.client("securityhub").update_standards_control method.
boto3 documentation
# update_standards_control method definition
def update_standards_control(
self,
*,
StandardsControlArn: str,
ControlStatus: ControlStatusType = ..., # (1)
DisabledReason: str = ...,
) -> Dict[str, Any]:
...# update_standards_control method usage example with argument unpacking
kwargs: UpdateStandardsControlRequestRequestTypeDef = { # (1)
"StandardsControlArn": ...,
}
parent.update_standards_control(**kwargs)get_paginator#
Type annotations and code completion for boto3.client("securityhub").get_paginator method with overloads.
client.get_paginator("describe_action_targets")-> DescribeActionTargetsPaginatorclient.get_paginator("describe_products")-> DescribeProductsPaginatorclient.get_paginator("describe_standards_controls")-> DescribeStandardsControlsPaginatorclient.get_paginator("describe_standards")-> DescribeStandardsPaginatorclient.get_paginator("get_enabled_standards")-> GetEnabledStandardsPaginatorclient.get_paginator("get_finding_history")-> GetFindingHistoryPaginatorclient.get_paginator("get_findings")-> GetFindingsPaginatorclient.get_paginator("get_insights")-> GetInsightsPaginatorclient.get_paginator("list_configuration_policies")-> ListConfigurationPoliciesPaginatorclient.get_paginator("list_configuration_policy_associations")-> ListConfigurationPolicyAssociationsPaginatorclient.get_paginator("list_enabled_products_for_import")-> ListEnabledProductsForImportPaginatorclient.get_paginator("list_finding_aggregators")-> ListFindingAggregatorsPaginatorclient.get_paginator("list_invitations")-> ListInvitationsPaginatorclient.get_paginator("list_members")-> ListMembersPaginatorclient.get_paginator("list_organization_admin_accounts")-> ListOrganizationAdminAccountsPaginatorclient.get_paginator("list_security_control_definitions")-> ListSecurityControlDefinitionsPaginatorclient.get_paginator("list_standards_control_associations")-> ListStandardsControlAssociationsPaginator