FmsClient
This is the Firewall Manager API Reference. This guide is for developers who need detailed information about the Firewall Manager API actions, data types, and errors. For detailed information about Firewall Manager features, see the Firewall Manager Developer Guide.
Some API actions require explicit resource permissions. For information, see the developer guide topic Service roles for Firewall Manager.
Functions
Sets a Firewall Manager default administrator account. The Firewall Manager default administrator account can manage third-party firewalls and has full administrative scope that allows administration of all policy types, accounts, organizational units, and Regions. This account must be a member account of the organization in Organizations whose resources you want to protect.
Sets the Firewall Manager policy administrator as a tenant administrator of a third-party firewall service. A tenant is an instance of the third-party firewall service that's associated with your Amazon Web Services customer account.
Associate resources to a Firewall Manager resource set.
Disassociates resources from a Firewall Manager resource set.
Permanently deletes an Firewall Manager applications list.
Deletes an Firewall Manager association with the IAM role and the Amazon Simple Notification Service (SNS) topic that is used to record Firewall Manager SNS logs.
Permanently deletes an Firewall Manager policy.
Permanently deletes an Firewall Manager protocols list.
Deletes the specified ResourceSet.
Disassociates an Firewall Manager administrator account. To set a different account as an Firewall Manager administrator, submit a PutAdminAccount request. To set an account as a default administrator account, you must submit an AssociateAdminAccount request.
Disassociates a Firewall Manager policy administrator from a third-party firewall tenant. When you call DisassociateThirdPartyFirewall
, the third-party firewall vendor deletes all of the firewalls that are associated with the account.
Returns the Organizations account that is associated with Firewall Manager as the Firewall Manager default administrator.
Returns information about the specified account's administrative scope. The admistrative scope defines the resources that an Firewall Manager administrator can manage.
Returns information about the specified Firewall Manager applications list.
Returns detailed compliance information about the specified member account. Details include resources that are in and out of compliance with the specified policy.
Information about the Amazon Simple Notification Service (SNS) topic that is used to record Firewall Manager SNS logs.
Returns information about the specified Firewall Manager policy.
If you created a Shield Advanced policy, returns policy-level attack summary information in the event of a potential DDoS attack. Other policy types are currently unsupported.
Returns information about the specified Firewall Manager protocols list.
Gets information about a specific resource set.
The onboarding status of a Firewall Manager admin account to third-party firewall vendor tenant.
Retrieves violations for a resource based on the specified Firewall Manager policy and Amazon Web Services account.
Returns a AdminAccounts
object that lists the Firewall Manager administrators within the organization that are onboarded to Firewall Manager by AssociateAdminAccount.
Lists the accounts that are managing the specified Organizations member account. This is useful for any member account so that they can view the accounts who are managing their account. This operation only returns the managing administrators that have the requested account within their AdminScope.
Returns an array of AppsListDataSummary
objects.
Returns an array of PolicyComplianceStatus
objects. Use PolicyComplianceStatus
to get a summary of which member accounts are protected by the specified policy.
Returns an array of resources in the organization's accounts that are available to be associated with a resource set.
Returns a MemberAccounts
object that lists the member accounts in the administrator's Amazon Web Services organization.
Returns an array of PolicySummary
objects.
Returns an array of ProtocolsListDataSummary
objects.
Returns an array of resources that are currently associated to a resource set.
Returns an array of ResourceSetSummary
objects.
Retrieves the list of tags for the specified Amazon Web Services resource.
Retrieves a list of all of the third-party firewall policies that are associated with the third-party firewall administrator's account.
Creates or updates an Firewall Manager administrator account. The account must be a member of the organization that was onboarded to Firewall Manager by AssociateAdminAccount. Only the organization's management account can create an Firewall Manager administrator account. When you create an Firewall Manager administrator account, the service checks to see if the account is already a delegated administrator within Organizations. If the account isn't a delegated administrator, Firewall Manager calls Organizations to delegate the account within Organizations. For more information about administrator accounts within Organizations, see Managing the Amazon Web Services Accounts in Your Organization.
Creates an Firewall Manager applications list.
Designates the IAM role and Amazon Simple Notification Service (SNS) topic that Firewall Manager uses to record SNS logs.
Creates an Firewall Manager policy.
Creates an Firewall Manager protocols list.
Creates the resource set.
Adds one or more tags to an Amazon Web Services resource.
Removes one or more tags from an Amazon Web Services resource.
Inherited functions
Sets a Firewall Manager default administrator account. The Firewall Manager default administrator account can manage third-party firewalls and has full administrative scope that allows administration of all policy types, accounts, organizational units, and Regions. This account must be a member account of the organization in Organizations whose resources you want to protect.
Sets the Firewall Manager policy administrator as a tenant administrator of a third-party firewall service. A tenant is an instance of the third-party firewall service that's associated with your Amazon Web Services customer account.
Associate resources to a Firewall Manager resource set.
Disassociates resources from a Firewall Manager resource set.
Permanently deletes an Firewall Manager applications list.
Deletes an Firewall Manager association with the IAM role and the Amazon Simple Notification Service (SNS) topic that is used to record Firewall Manager SNS logs.
Permanently deletes an Firewall Manager policy.
Permanently deletes an Firewall Manager protocols list.
Deletes the specified ResourceSet.
Disassociates an Firewall Manager administrator account. To set a different account as an Firewall Manager administrator, submit a PutAdminAccount request. To set an account as a default administrator account, you must submit an AssociateAdminAccount request.
Disassociates a Firewall Manager policy administrator from a third-party firewall tenant. When you call DisassociateThirdPartyFirewall
, the third-party firewall vendor deletes all of the firewalls that are associated with the account.
Returns the Organizations account that is associated with Firewall Manager as the Firewall Manager default administrator.
Returns information about the specified account's administrative scope. The admistrative scope defines the resources that an Firewall Manager administrator can manage.
Returns information about the specified Firewall Manager applications list.
Returns detailed compliance information about the specified member account. Details include resources that are in and out of compliance with the specified policy.
Information about the Amazon Simple Notification Service (SNS) topic that is used to record Firewall Manager SNS logs.
Returns information about the specified Firewall Manager policy.
If you created a Shield Advanced policy, returns policy-level attack summary information in the event of a potential DDoS attack. Other policy types are currently unsupported.
Returns information about the specified Firewall Manager protocols list.
Gets information about a specific resource set.
The onboarding status of a Firewall Manager admin account to third-party firewall vendor tenant.
Retrieves violations for a resource based on the specified Firewall Manager policy and Amazon Web Services account.
Returns a AdminAccounts
object that lists the Firewall Manager administrators within the organization that are onboarded to Firewall Manager by AssociateAdminAccount.
Paginate over ListAdminAccountsForOrganizationResponse results.
Lists the accounts that are managing the specified Organizations member account. This is useful for any member account so that they can view the accounts who are managing their account. This operation only returns the managing administrators that have the requested account within their AdminScope.
Paginate over ListAdminsManagingAccountResponse results.
Returns an array of AppsListDataSummary
objects.
Paginate over ListAppsListsResponse results.
Returns an array of PolicyComplianceStatus
objects. Use PolicyComplianceStatus
to get a summary of which member accounts are protected by the specified policy.
Paginate over ListComplianceStatusResponse results.
Returns an array of resources in the organization's accounts that are available to be associated with a resource set.
Returns a MemberAccounts
object that lists the member accounts in the administrator's Amazon Web Services organization.
Paginate over ListMemberAccountsResponse results.
Returns an array of PolicySummary
objects.
Paginate over ListPoliciesResponse results.
Returns an array of ProtocolsListDataSummary
objects.
Paginate over ListProtocolsListsResponse results.
Returns an array of resources that are currently associated to a resource set.
Returns an array of ResourceSetSummary
objects.
Retrieves the list of tags for the specified Amazon Web Services resource.
Retrieves a list of all of the third-party firewall policies that are associated with the third-party firewall administrator's account.
Paginate over ListThirdPartyFirewallFirewallPoliciesResponse results.
Creates or updates an Firewall Manager administrator account. The account must be a member of the organization that was onboarded to Firewall Manager by AssociateAdminAccount. Only the organization's management account can create an Firewall Manager administrator account. When you create an Firewall Manager administrator account, the service checks to see if the account is already a delegated administrator within Organizations. If the account isn't a delegated administrator, Firewall Manager calls Organizations to delegate the account within Organizations. For more information about administrator accounts within Organizations, see Managing the Amazon Web Services Accounts in Your Organization.
Creates an Firewall Manager applications list.
Designates the IAM role and Amazon Simple Notification Service (SNS) topic that Firewall Manager uses to record SNS logs.
Creates an Firewall Manager policy.
Creates an Firewall Manager protocols list.
Creates the resource set.
Adds one or more tags to an Amazon Web Services resource.
Removes one or more tags from an Amazon Web Services resource.
Create a copy of the client with one or more configuration values overridden. This method allows the caller to perform scoped config overrides for one or more client operations.