FmsClient

interface FmsClient : SdkClient

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.

Properties

Link copied to clipboard
abstract override val config: FmsClient.Config

FmsClient's configuration

Functions

Link copied to clipboard

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.

Link copied to clipboard

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.

Link copied to clipboard

Associate resources to a Firewall Manager resource set.

Link copied to clipboard

Disassociates resources from a Firewall Manager resource set.

Link copied to clipboard

Permanently deletes an Firewall Manager applications list.

Link copied to clipboard
abstract suspend fun deleteNotificationChannel(input: DeleteNotificationChannelRequest = DeleteNotificationChannelRequest { }): DeleteNotificationChannelResponse

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.

Link copied to clipboard

Permanently deletes an Firewall Manager policy.

Link copied to clipboard

Permanently deletes an Firewall Manager protocols list.

Link copied to clipboard

Deletes the specified ResourceSet.

Link copied to clipboard
abstract suspend fun disassociateAdminAccount(input: DisassociateAdminAccountRequest = DisassociateAdminAccountRequest { }): DisassociateAdminAccountResponse

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.

Link copied to clipboard

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.

Link copied to clipboard
abstract suspend fun getAdminAccount(input: GetAdminAccountRequest = GetAdminAccountRequest { }): GetAdminAccountResponse

Returns the Organizations account that is associated with Firewall Manager as the Firewall Manager default administrator.

Link copied to clipboard

Returns information about the specified account's administrative scope. The admistrative scope defines the resources that an Firewall Manager administrator can manage.

Link copied to clipboard
abstract suspend fun getAppsList(input: GetAppsListRequest): GetAppsListResponse

Returns information about the specified Firewall Manager applications list.

Link copied to clipboard

Returns detailed compliance information about the specified member account. Details include resources that are in and out of compliance with the specified policy.

Link copied to clipboard
abstract suspend fun getNotificationChannel(input: GetNotificationChannelRequest = GetNotificationChannelRequest { }): GetNotificationChannelResponse

Information about the Amazon Simple Notification Service (SNS) topic that is used to record Firewall Manager SNS logs.

Link copied to clipboard
abstract suspend fun getPolicy(input: GetPolicyRequest): GetPolicyResponse

Returns information about the specified Firewall Manager policy.

Link copied to clipboard

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.

Link copied to clipboard

Returns information about the specified Firewall Manager protocols list.

Link copied to clipboard

Gets information about a specific resource set.

Link copied to clipboard

The onboarding status of a Firewall Manager admin account to third-party firewall vendor tenant.

Link copied to clipboard

Retrieves violations for a resource based on the specified Firewall Manager policy and Amazon Web Services account.

Link copied to clipboard
abstract suspend fun listAdminAccountsForOrganization(input: ListAdminAccountsForOrganizationRequest = ListAdminAccountsForOrganizationRequest { }): ListAdminAccountsForOrganizationResponse

Returns a AdminAccounts object that lists the Firewall Manager administrators within the organization that are onboarded to Firewall Manager by AssociateAdminAccount.

Link copied to clipboard
abstract suspend fun listAdminsManagingAccount(input: ListAdminsManagingAccountRequest = ListAdminsManagingAccountRequest { }): ListAdminsManagingAccountResponse

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.

Link copied to clipboard

Returns an array of AppsListDataSummary objects.

Link copied to clipboard

Returns an array of PolicyComplianceStatus objects. Use PolicyComplianceStatus to get a summary of which member accounts are protected by the specified policy.

Link copied to clipboard

Returns an array of resources in the organization's accounts that are available to be associated with a resource set.

Link copied to clipboard
abstract suspend fun listMemberAccounts(input: ListMemberAccountsRequest = ListMemberAccountsRequest { }): ListMemberAccountsResponse

Returns a MemberAccounts object that lists the member accounts in the administrator's Amazon Web Services organization.

Link copied to clipboard
abstract suspend fun listPolicies(input: ListPoliciesRequest = ListPoliciesRequest { }): ListPoliciesResponse

Returns an array of PolicySummary objects.

Link copied to clipboard

Returns an array of ProtocolsListDataSummary objects.

Link copied to clipboard

Returns an array of resources that are currently associated to a resource set.

Link copied to clipboard
abstract suspend fun listResourceSets(input: ListResourceSetsRequest = ListResourceSetsRequest { }): ListResourceSetsResponse

Returns an array of ResourceSetSummary objects.

Link copied to clipboard

Retrieves the list of tags for the specified Amazon Web Services resource.

Link copied to clipboard

Retrieves a list of all of the third-party firewall policies that are associated with the third-party firewall administrator's account.

Link copied to clipboard

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.

Link copied to clipboard
abstract suspend fun putAppsList(input: PutAppsListRequest): PutAppsListResponse

Creates an Firewall Manager applications list.

Link copied to clipboard

Designates the IAM role and Amazon Simple Notification Service (SNS) topic that Firewall Manager uses to record SNS logs.

Link copied to clipboard
abstract suspend fun putPolicy(input: PutPolicyRequest): PutPolicyResponse

Creates an Firewall Manager policy.

Link copied to clipboard

Creates an Firewall Manager protocols list.

Link copied to clipboard

Creates the resource set.

Link copied to clipboard
abstract suspend fun tagResource(input: TagResourceRequest): TagResourceResponse

Adds one or more tags to an Amazon Web Services resource.

Link copied to clipboard

Removes one or more tags from an Amazon Web Services resource.

Inherited functions

Link copied to clipboard

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.

Link copied to clipboard

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.

Link copied to clipboard

Associate resources to a Firewall Manager resource set.

Link copied to clipboard

Disassociates resources from a Firewall Manager resource set.

Link copied to clipboard
expect abstract fun close()
Link copied to clipboard

Permanently deletes an Firewall Manager applications list.

Link copied to clipboard

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.

Link copied to clipboard
inline suspend fun FmsClient.deletePolicy(crossinline block: DeletePolicyRequest.Builder.() -> Unit): DeletePolicyResponse

Permanently deletes an Firewall Manager policy.

Link copied to clipboard

Permanently deletes an Firewall Manager protocols list.

Link copied to clipboard

Deletes the specified ResourceSet.

Link copied to clipboard

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.

Link copied to clipboard

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.

Link copied to clipboard

Returns the Organizations account that is associated with Firewall Manager as the Firewall Manager default administrator.

Link copied to clipboard
inline suspend fun FmsClient.getAdminScope(crossinline block: GetAdminScopeRequest.Builder.() -> Unit): GetAdminScopeResponse

Returns information about the specified account's administrative scope. The admistrative scope defines the resources that an Firewall Manager administrator can manage.

Link copied to clipboard
inline suspend fun FmsClient.getAppsList(crossinline block: GetAppsListRequest.Builder.() -> Unit): GetAppsListResponse

Returns information about the specified Firewall Manager applications list.

Link copied to clipboard

Returns detailed compliance information about the specified member account. Details include resources that are in and out of compliance with the specified policy.

Link copied to clipboard

Information about the Amazon Simple Notification Service (SNS) topic that is used to record Firewall Manager SNS logs.

Link copied to clipboard
inline suspend fun FmsClient.getPolicy(crossinline block: GetPolicyRequest.Builder.() -> Unit): GetPolicyResponse

Returns information about the specified Firewall Manager policy.

Link copied to clipboard

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.

Link copied to clipboard

Returns information about the specified Firewall Manager protocols list.

Link copied to clipboard

Gets information about a specific resource set.

Link copied to clipboard

The onboarding status of a Firewall Manager admin account to third-party firewall vendor tenant.

Link copied to clipboard

Retrieves violations for a resource based on the specified Firewall Manager policy and Amazon Web Services account.

Link copied to clipboard

Returns a AdminAccounts object that lists the Firewall Manager administrators within the organization that are onboarded to Firewall Manager by AssociateAdminAccount.

Link copied to clipboard

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.

Link copied to clipboard
inline suspend fun FmsClient.listAppsLists(crossinline block: ListAppsListsRequest.Builder.() -> Unit): ListAppsListsResponse

Returns an array of AppsListDataSummary objects.

Link copied to clipboard

Returns an array of PolicyComplianceStatus objects. Use PolicyComplianceStatus to get a summary of which member accounts are protected by the specified policy.

Link copied to clipboard

Returns an array of resources in the organization's accounts that are available to be associated with a resource set.

Link copied to clipboard

Returns a MemberAccounts object that lists the member accounts in the administrator's Amazon Web Services organization.

Link copied to clipboard
inline suspend fun FmsClient.listPolicies(crossinline block: ListPoliciesRequest.Builder.() -> Unit): ListPoliciesResponse

Returns an array of PolicySummary objects.

Link copied to clipboard
Link copied to clipboard

Returns an array of ProtocolsListDataSummary objects.

Link copied to clipboard

Returns an array of resources that are currently associated to a resource set.

Link copied to clipboard

Returns an array of ResourceSetSummary objects.

Link copied to clipboard

Retrieves the list of tags for the specified Amazon Web Services resource.

Link copied to clipboard

Retrieves a list of all of the third-party firewall policies that are associated with the third-party firewall administrator's account.

Link copied to clipboard

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.

Link copied to clipboard
inline suspend fun FmsClient.putAppsList(crossinline block: PutAppsListRequest.Builder.() -> Unit): PutAppsListResponse

Creates an Firewall Manager applications list.

Link copied to clipboard

Designates the IAM role and Amazon Simple Notification Service (SNS) topic that Firewall Manager uses to record SNS logs.

Link copied to clipboard
inline suspend fun FmsClient.putPolicy(crossinline block: PutPolicyRequest.Builder.() -> Unit): PutPolicyResponse

Creates an Firewall Manager policy.

Link copied to clipboard

Creates an Firewall Manager protocols list.

Link copied to clipboard

Creates the resource set.

Link copied to clipboard
inline suspend fun FmsClient.tagResource(crossinline block: TagResourceRequest.Builder.() -> Unit): TagResourceResponse

Adds one or more tags to an Amazon Web Services resource.

Link copied to clipboard
inline suspend fun FmsClient.untagResource(crossinline block: UntagResourceRequest.Builder.() -> Unit): UntagResourceResponse

Removes one or more tags from an Amazon Web Services resource.

Link copied to clipboard

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.