Amazon Web Services, Inc.

AWS Network Security Manager Customer API

AWS Network Security Manager helps you centrally configure and deploy network security protections across your organization. Supported protections include AWS…

Identity & security#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

AWS Network Security Manager helps you centrally configure and deploy network security protections across your organization. Supported protections include AWS WAF and AWS Shield Advanced. This centralized approach reduces the overhead of managing protections individually across accounts and ensures consistent security at scale. You define reusable rules and templates , then combine them into policies . Next, you select the accounts and resources to protect with scopes and roll the protections out with deployments . For example, you can define a set of AWS WAF rules and group them into a policy. Then deploy that policy across all accounts in your organization with a single deployment. This API reference describes the operations and data types for AWS Network Security Manager. For conceptual information, tutorials, and guidance on writing rule configurations, see the AWS Network Security Manager Developer Guide . For the default quotas that apply to your account, see Quotas . For the service endpoints available in each Region, see AWS Network Security Manager endpoints and quotas in the AWS General Reference .

Endpoints 46

Deployment

  • GETList deployments/deployments?maxResults=0&nextToken=string&status=stringLists the deployments in the account. You can filter the results by status and page through them using maxResults and nextToken .
  • POSTCreate deployment/deploymentsCreates a deployment. A deployment applies one or more policies to the accounts and resources selected by a scope. Use isPublished to create the deployment in…
  • GETList deployment snapshots/deployments/:deploymentIdentifier/snapshots?maxResults=0&nextToken=stringLists the snapshots of the specified deployment.
  • POSTCreate deployment snapshot/deployments/:deploymentIdentifier/snapshotsCreates a snapshot of the current published version of the specified deployment.
  • GETGet deployment/deployments/:deploymentIdentifierRetrieves the details of the specified deployment, including coverage information and any warnings.
  • DELETEDelete deployment/deployments/:deploymentIdentifierDeletes the specified deployment.
  • PATCHUpdate deployment/deployments/:deploymentIdentifierUpdates the specified deployment. To prevent conflicting concurrent updates, provide the current updateToken . Use isPublished to publish the update or keep…
  • GETList resource synchronization statuses/resource-sync-statuses?deploymentIdentifier=string&synchronizationStatus=string&maxResults=0&nextToken=stringLists the synchronization statuses of the resources covered by the specified deployment. You can filter the results by synchronization status and page through…

Policy

  • GETList policies/policies?maxResults=0&nextToken=string&status=stringLists the policies in the account. You can filter the results by status and page through them using maxResults and nextToken .
  • POSTCreate policy/policiesCreates a policy. A policy combines templates and rules with enforcement settings for a firewall type, such as AWS WAF or AWS Shield Advanced. Use isPublished…
  • GETList policy snapshots/policies/:policyIdentifier/snapshots?maxResults=0&nextToken=stringLists the snapshots of the specified policy.
  • POSTCreate policy snapshot/policies/:policyIdentifier/snapshotsCreates a snapshot of the current published version of the specified policy.
  • GETGet policy/policies/:policyIdentifierRetrieves the details of the specified policy.
  • DELETEDelete policy/policies/:policyIdentifierDeletes the specified policy.
  • PATCHUpdate policy/policies/:policyIdentifierUpdates the specified policy. To prevent conflicting concurrent updates, provide the current updateToken . Use isPublished to publish the update or keep the…

Rule

  • GETList rules/rules?maxResults=0&nextToken=string&status=stringLists the rules in the account. You can filter the results by status and page through them using maxResults and nextToken .
  • POSTCreate rule/rulesCreates a rule. A rule defines a network security configuration to enforce, such as an AWS WAF rule group or configuration data. Use isPublished to create the…
  • GETList rule snapshots/rules/:ruleIdentifier/snapshots?maxResults=0&nextToken=stringLists the snapshots of the specified rule.
  • POSTCreate rule snapshot/rules/:ruleIdentifier/snapshotsCreates a snapshot of the current published version of the specified rule. A snapshot is an immutable, versioned copy that other resources can reference.
  • GETGet rule/rules/:ruleIdentifierRetrieves the details of the specified rule.
  • DELETEDelete rule/rules/:ruleIdentifierDeletes the specified rule.
  • PATCHUpdate rule/rules/:ruleIdentifierUpdates the specified rule. To prevent conflicting concurrent updates, provide the current updateToken . Use isPublished to publish the update or keep the…

Scope

  • GETList scopes/scopes?maxResults=0&nextToken=string&status=stringLists the scopes in the account. You can filter the results by status and page through them using maxResults and nextToken .
  • POSTCreate scope/scopesCreates a scope. A scope selects the accounts and resources that a deployment applies to. Use isPublished to create the scope in published ( ACTIVE ) or draft…
  • GETList scope snapshots/scopes/:scopeIdentifier/snapshots?maxResults=0&nextToken=stringLists the snapshots of the specified scope.
  • POSTCreate scope snapshot/scopes/:scopeIdentifier/snapshotsCreates a snapshot of the current published version of the specified scope.
  • GETGet scope/scopes/:scopeIdentifierRetrieves the details of the specified scope.
  • DELETEDelete scope/scopes/:scopeIdentifierDeletes the specified scope.
  • PATCHUpdate scope/scopes/:scopeIdentifierUpdates the specified scope. To prevent conflicting concurrent updates, provide the current updateToken . Use isPublished to publish the update or keep the…

Template

  • GETList templates/templates?maxResults=0&nextToken=string&status=stringLists the templates in the account. You can filter the results by status and page through them using maxResults and nextToken .
  • POSTCreate template/templatesCreates a template. A template groups one or more rules to simplify reuse across policies. You can also associate rules with a policy directly, without a…
  • GETList template snapshots/templates/:templateIdentifier/snapshots?maxResults=0&nextToken=stringLists the snapshots of the specified template.
  • POSTCreate template snapshot/templates/:templateIdentifier/snapshotsCreates a snapshot of the current published version of the specified template.
  • GETGet template/templates/:templateIdentifierRetrieves the details of the specified template.
  • DELETEDelete template/templates/:templateIdentifierDeletes the specified template.
  • PATCHUpdate template/templates/:templateIdentifierUpdates the specified template. To prevent conflicting concurrent updates, provide the current updateToken . Use isPublished to publish the update or keep the…
  • GETGet admin account/admin-account/:accountIdRetrieves the details of the specified AWS Network Security Manager administrator account.
  • DELETEDelete admin account/admin-account/:accountIdRemoves the specified AWS Network Security Manager administrator account.
  • POSTGenerate rule configuration/GenerateRuleConfigurationGenerates a rule configuration from a natural-language description. Provide a prompt along with the rule's firewall type and rule type. The service returns a…
  • GETList admin accounts/admin-accounts?maxResults=0&nextToken=stringLists the AWS Network Security Manager administrator accounts in the organization.
  • GETList aggregate resource synchronization statuses/aggregate-sync-statuses?synchronizationStatus=string&maxResults=0&nextToken=stringLists the aggregated synchronization statuses of resources across the deployments in your administrator account. You can filter the results by synchronization…
  • GETList resource associations/resource-associations?resourceIdentifier=string&maxResults=0&nextToken=stringLists the resources associated with the specified resource.
  • GETList tags for resource/tags/:resourceArnLists the tags associated with the specified resource.
  • POSTTag resource/tags/:resourceArnAdds or overwrites the specified tags on the given resource.
  • DELETEUntag resource/tags/:resourceArn?tagKeys=Removes the specified tags from the given resource.
  • PUTPut admin account/admin-accountSets the AWS account that serves as an AWS Network Security Manager administrator account, and optionally configures the scope of resources that the…

API details

Base URL
https://network-security-manager.{region}.amazonaws.com
Authentication
AWS Signature Version 4 (requests signed with your AWS access key)
Operations
46 operations on 23 pathsGET 21POST 12DELETE 7PATCH 5PUT 1
Main resources
Deployment 8Policy 7Rule 7Scope 7Template 7
Description format
AWS Smithy model, API version 2025-10-30

How to test the AWS Network Security Manager Customer API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the AWS Network Security Manager Customer API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses AWS Signature Version 4 (requests signed with your AWS access key). Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “List deployments” (GET /deployments?maxResults=0&nextToken=string&status=string), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the AWS Network Security Manager Customer API?

AWS Network Security Manager helps you centrally configure and deploy network security protections across your organization. Supported protections include AWS… It is listed under Identity & security and has 46 endpoints.

Who publishes the AWS Network Security Manager Customer API?

It is listed from Amazon Web Services, Inc.'s public API description (an OpenAPI document), not published by Amazon Web Services, Inc. on Swastik Codes. Anyone who controls amazonaws.com can claim the profile by adding a DNS TXT record.

What is the base URL of the AWS Network Security Manager Customer API?

Requests go to https://network-security-manager.{region}.amazonaws.com. Endpoint paths are added to this base URL.

How do I authenticate with the AWS Network Security Manager Customer API?

With AWS Signature Version 4 (requests signed with your AWS access key).

How many endpoints does the AWS Network Security Manager Customer API have?

46 operations on 23 paths (21 GET, 12 POST, 7 DELETE, 5 PATCH, 1 PUT). The largest groups are Deployment, Policy, Rule, Scope.

Is forking the AWS Network Security Manager Customer API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.