1. Registry
  2. Packages
  3. AWS
  4. API Docs
  5. networksecuritymanager
  6. AdminAccount
Viewing docs for AWS v7.55.0
published on Friday, Nov 13, 2026 by Pulumi
aws logo aws logo
Viewing docs for AWS v7.55.0
published on Friday, Nov 13, 2026 by Pulumi

    Manages an AWS Network Security Manager Admin Account. An administrator account can centrally create and manage AWS WAF and Shield Advanced protection across the accounts and organizational units (OUs) of an AWS Organization. The resource must be managed from the organization’s management account, and the administrator’s authority can be narrowed with an adminScope.

    AWS Organizations trusted access for Network Security Manager must remain enabled. If trusted access is disabled outside Terraform, the resource is treated as absent during refresh.

    Setting an administrator account again shortly after it was removed, or while the service is still creating its service-linked role, is rejected by AWS with a ConflictException. The resource retries the request until it is accepted or the create timeout expires.

    Example Usage

    Basic Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const example = new aws.networksecuritymanager.AdminAccount("example", {
        accountId: "123456789012",
        priority: 1,
    });
    
    import pulumi
    import pulumi_aws as aws
    
    example = aws.networksecuritymanager.AdminAccount("example",
        account_id="123456789012",
        priority=1)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/networksecuritymanager"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := networksecuritymanager.NewAdminAccount(ctx, "example", &networksecuritymanager.AdminAccountArgs{
    			AccountId: pulumi.String("123456789012"),
    			Priority:  pulumi.Int(1),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var example = new Aws.NetworkSecurityManager.AdminAccount("example", new()
        {
            AccountId = "123456789012",
            Priority = 1,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.networksecuritymanager.AdminAccount;
    import com.pulumi.aws.networksecuritymanager.AdminAccountArgs;
    import java.util.ArrayList;
    import java.util.Arrays;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var example = new AdminAccount("example", AdminAccountArgs.builder()
                .accountId("123456789012")
                .priority(1)
                .build());
    
        }
    }
    
    resources:
      example:
        type: aws:networksecuritymanager:AdminAccount
        properties:
          accountId: '123456789012'
          priority: 1
    
    terraform {
      required_providers {
        aws = {
          source = "pulumi/aws"
        }
      }
    }
    
    resource "aws_networksecuritymanager_admin_account" "example" {
      lifecycle {
        create_before_destroy = true
      }
      account_id = "123456789012"
      priority   = 1
    }
    

    Scoped Administrator

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const example = new aws.networksecuritymanager.AdminAccount("example", {
        adminScope: {
            firewallTypeScope: {
                firewallTypes: ["WAF"],
            },
            scopeFilter: {
                includeOnly: {
                    organizationalUnits: ["ou-abcd-12345678"],
                },
            },
        },
        accountId: "123456789012",
        priority: 2,
    });
    
    import pulumi
    import pulumi_aws as aws
    
    example = aws.networksecuritymanager.AdminAccount("example",
        admin_scope={
            "firewall_type_scope": {
                "firewall_types": ["WAF"],
            },
            "scope_filter": {
                "include_only": {
                    "organizational_units": ["ou-abcd-12345678"],
                },
            },
        },
        account_id="123456789012",
        priority=2)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/networksecuritymanager"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := networksecuritymanager.NewAdminAccount(ctx, "example", &networksecuritymanager.AdminAccountArgs{
    			AdminScope: &networksecuritymanager.AdminAccountAdminScopeArgs{
    				FirewallTypeScope: &networksecuritymanager.AdminAccountAdminScopeFirewallTypeScopeArgs{
    					FirewallTypes: pulumi.StringArray{
    						pulumi.String("WAF"),
    					},
    				},
    				ScopeFilter: &networksecuritymanager.AdminAccountAdminScopeScopeFilterArgs{
    					IncludeOnly: &networksecuritymanager.AdminAccountAdminScopeScopeFilterIncludeOnlyArgs{
    						OrganizationalUnits: pulumi.StringArray{
    							pulumi.String("ou-abcd-12345678"),
    						},
    					},
    				},
    			},
    			AccountId: pulumi.String("123456789012"),
    			Priority:  pulumi.Int(2),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var example = new Aws.NetworkSecurityManager.AdminAccount("example", new()
        {
            AdminScope = new Aws.NetworkSecurityManager.Inputs.AdminAccountAdminScopeArgs
            {
                FirewallTypeScope = new Aws.NetworkSecurityManager.Inputs.AdminAccountAdminScopeFirewallTypeScopeArgs
                {
                    FirewallTypes = new[]
                    {
                        "WAF",
                    },
                },
                ScopeFilter = new Aws.NetworkSecurityManager.Inputs.AdminAccountAdminScopeScopeFilterArgs
                {
                    IncludeOnly = new Aws.NetworkSecurityManager.Inputs.AdminAccountAdminScopeScopeFilterIncludeOnlyArgs
                    {
                        OrganizationalUnits = new[]
                        {
                            "ou-abcd-12345678",
                        },
                    },
                },
            },
            AccountId = "123456789012",
            Priority = 2,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.networksecuritymanager.AdminAccount;
    import com.pulumi.aws.networksecuritymanager.AdminAccountArgs;
    import com.pulumi.aws.networksecuritymanager.inputs.AdminAccountAdminScopeArgs;
    import com.pulumi.aws.networksecuritymanager.inputs.AdminAccountAdminScopeFirewallTypeScopeArgs;
    import com.pulumi.aws.networksecuritymanager.inputs.AdminAccountAdminScopeScopeFilterArgs;
    import com.pulumi.aws.networksecuritymanager.inputs.AdminAccountAdminScopeScopeFilterIncludeOnlyArgs;
    import java.util.ArrayList;
    import java.util.Arrays;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var example = new AdminAccount("example", AdminAccountArgs.builder()
                .adminScope(AdminAccountAdminScopeArgs.builder()
                    .firewallTypeScope(AdminAccountAdminScopeFirewallTypeScopeArgs.builder()
                        .firewallTypes("WAF")
                        .build())
                    .scopeFilter(AdminAccountAdminScopeScopeFilterArgs.builder()
                        .includeOnly(AdminAccountAdminScopeScopeFilterIncludeOnlyArgs.builder()
                            .organizationalUnits("ou-abcd-12345678")
                            .build())
                        .build())
                    .build())
                .accountId("123456789012")
                .priority(2)
                .build());
    
        }
    }
    
    resources:
      example:
        type: aws:networksecuritymanager:AdminAccount
        properties:
          adminScope:
            firewallTypeScope:
              firewallTypes:
                - WAF
            scopeFilter:
              includeOnly:
                organizationalUnits:
                  - ou-abcd-12345678
          accountId: '123456789012'
          priority: 2
    
    terraform {
      required_providers {
        aws = {
          source = "pulumi/aws"
        }
      }
    }
    
    resource "aws_networksecuritymanager_admin_account" "example" {
      lifecycle {
        create_before_destroy = true
      }
      admin_scope {
        firewall_type_scope {
          firewall_types = ["WAF"]
        }
        scope_filter {
          include_only {
            organizational_units = ["ou-abcd-12345678"]
          }
        }
      }
      account_id = "123456789012"
      priority   = 2
    }
    

    Create AdminAccount Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new AdminAccount(name: string, args: AdminAccountArgs, opts?: CustomResourceOptions);
    @overload
    def AdminAccount(resource_name: str,
                     args: AdminAccountArgs,
                     opts: Optional[ResourceOptions] = None)
    
    @overload
    def AdminAccount(resource_name: str,
                     opts: Optional[ResourceOptions] = None,
                     account_id: Optional[str] = None,
                     priority: Optional[int] = None,
                     admin_scope: Optional[AdminAccountAdminScopeArgs] = None,
                     region: Optional[str] = None,
                     timeouts: Optional[AdminAccountTimeoutsArgs] = None)
    func NewAdminAccount(ctx *Context, name string, args AdminAccountArgs, opts ...ResourceOption) (*AdminAccount, error)
    public AdminAccount(string name, AdminAccountArgs args, CustomResourceOptions? opts = null)
    public AdminAccount(String name, AdminAccountArgs args)
    public AdminAccount(String name, AdminAccountArgs args, CustomResourceOptions options)
    
    type: aws:networksecuritymanager:AdminAccount
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws_networksecuritymanager_admin_account" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args AdminAccountArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args AdminAccountArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args AdminAccountArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args AdminAccountArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args AdminAccountArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var awsAdminAccountResource = new Aws.NetworkSecurityManager.AdminAccount("awsAdminAccountResource", new()
    {
        AccountId = "string",
        Priority = 0,
        AdminScope = new Aws.NetworkSecurityManager.Inputs.AdminAccountAdminScopeArgs
        {
            FirewallTypeScope = new Aws.NetworkSecurityManager.Inputs.AdminAccountAdminScopeFirewallTypeScopeArgs
            {
                AllFirewallTypesEnabled = false,
                FirewallTypes = new[]
                {
                    "string",
                },
            },
            ScopeFilter = new Aws.NetworkSecurityManager.Inputs.AdminAccountAdminScopeScopeFilterArgs
            {
                ExcludeOnly = new Aws.NetworkSecurityManager.Inputs.AdminAccountAdminScopeScopeFilterExcludeOnlyArgs
                {
                    Accounts = new[]
                    {
                        "string",
                    },
                    OrganizationalUnits = new[]
                    {
                        "string",
                    },
                },
                IncludeAll = false,
                IncludeOnly = new Aws.NetworkSecurityManager.Inputs.AdminAccountAdminScopeScopeFilterIncludeOnlyArgs
                {
                    Accounts = new[]
                    {
                        "string",
                    },
                    OrganizationalUnits = new[]
                    {
                        "string",
                    },
                },
            },
        },
        Region = "string",
        Timeouts = new Aws.NetworkSecurityManager.Inputs.AdminAccountTimeoutsArgs
        {
            Create = "string",
            Delete = "string",
            Update = "string",
        },
    });
    
    example, err := networksecuritymanager.NewAdminAccount(ctx, "awsAdminAccountResource", &networksecuritymanager.AdminAccountArgs{
    	AccountId: pulumi.String("string"),
    	Priority:  pulumi.Int(0),
    	AdminScope: &networksecuritymanager.AdminAccountAdminScopeArgs{
    		FirewallTypeScope: &networksecuritymanager.AdminAccountAdminScopeFirewallTypeScopeArgs{
    			AllFirewallTypesEnabled: pulumi.Bool(false),
    			FirewallTypes: pulumi.StringArray{
    				pulumi.String("string"),
    			},
    		},
    		ScopeFilter: &networksecuritymanager.AdminAccountAdminScopeScopeFilterArgs{
    			ExcludeOnly: &networksecuritymanager.AdminAccountAdminScopeScopeFilterExcludeOnlyArgs{
    				Accounts: pulumi.StringArray{
    					pulumi.String("string"),
    				},
    				OrganizationalUnits: pulumi.StringArray{
    					pulumi.String("string"),
    				},
    			},
    			IncludeAll: pulumi.Bool(false),
    			IncludeOnly: &networksecuritymanager.AdminAccountAdminScopeScopeFilterIncludeOnlyArgs{
    				Accounts: pulumi.StringArray{
    					pulumi.String("string"),
    				},
    				OrganizationalUnits: pulumi.StringArray{
    					pulumi.String("string"),
    				},
    			},
    		},
    	},
    	Region: pulumi.String("string"),
    	Timeouts: &networksecuritymanager.AdminAccountTimeoutsArgs{
    		Create: pulumi.String("string"),
    		Delete: pulumi.String("string"),
    		Update: pulumi.String("string"),
    	},
    })
    
    resource "aws_networksecuritymanager_admin_account" "awsAdminAccountResource" {
      lifecycle {
        create_before_destroy = true
      }
      account_id = "string"
      priority   = 0
      admin_scope = {
        firewall_type_scope = {
          all_firewall_types_enabled = false
          firewall_types             = ["string"]
        }
        scope_filter = {
          exclude_only = {
            accounts             = ["string"]
            organizational_units = ["string"]
          }
          include_all = false
          include_only = {
            accounts             = ["string"]
            organizational_units = ["string"]
          }
        }
      }
      region = "string"
      _ {
        timeouts = {
          create = "string"
          delete = "string"
          update = "string"
        }
      }
    }
    
    var awsAdminAccountResource = new com.pulumi.aws.networksecuritymanager.AdminAccount("awsAdminAccountResource", com.pulumi.aws.networksecuritymanager.AdminAccountArgs.builder()
        .accountId("string")
        .priority(0)
        .adminScope(AdminAccountAdminScopeArgs.builder()
            .firewallTypeScope(AdminAccountAdminScopeFirewallTypeScopeArgs.builder()
                .allFirewallTypesEnabled(false)
                .firewallTypes("string")
                .build())
            .scopeFilter(AdminAccountAdminScopeScopeFilterArgs.builder()
                .excludeOnly(AdminAccountAdminScopeScopeFilterExcludeOnlyArgs.builder()
                    .accounts("string")
                    .organizationalUnits("string")
                    .build())
                .includeAll(false)
                .includeOnly(AdminAccountAdminScopeScopeFilterIncludeOnlyArgs.builder()
                    .accounts("string")
                    .organizationalUnits("string")
                    .build())
                .build())
            .build())
        .region("string")
        .timeouts(AdminAccountTimeoutsArgs.builder()
            .create("string")
            .delete("string")
            .update("string")
            .build())
        .build());
    
    aws_admin_account_resource = aws.networksecuritymanager.AdminAccount("awsAdminAccountResource",
        account_id="string",
        priority=0,
        admin_scope={
            "firewall_type_scope": {
                "all_firewall_types_enabled": False,
                "firewall_types": ["string"],
            },
            "scope_filter": {
                "exclude_only": {
                    "accounts": ["string"],
                    "organizational_units": ["string"],
                },
                "include_all": False,
                "include_only": {
                    "accounts": ["string"],
                    "organizational_units": ["string"],
                },
            },
        },
        region="string",
        timeouts={
            "create": "string",
            "delete": "string",
            "update": "string",
        })
    
    const awsAdminAccountResource = new aws.networksecuritymanager.AdminAccount("awsAdminAccountResource", {
        accountId: "string",
        priority: 0,
        adminScope: {
            firewallTypeScope: {
                allFirewallTypesEnabled: false,
                firewallTypes: ["string"],
            },
            scopeFilter: {
                excludeOnly: {
                    accounts: ["string"],
                    organizationalUnits: ["string"],
                },
                includeAll: false,
                includeOnly: {
                    accounts: ["string"],
                    organizationalUnits: ["string"],
                },
            },
        },
        region: "string",
        timeouts: {
            create: "string",
            "delete": "string",
            update: "string",
        },
    });
    
    type: aws:networksecuritymanager:AdminAccount
    properties:
        accountId: string
        adminScope:
            firewallTypeScope:
                allFirewallTypesEnabled: false
                firewallTypes:
                    - string
            scopeFilter:
                excludeOnly:
                    accounts:
                        - string
                    organizationalUnits:
                        - string
                includeAll: false
                includeOnly:
                    accounts:
                        - string
                    organizationalUnits:
                        - string
        priority: 0
        region: string
        timeouts:
            create: string
            delete: string
            update: string
    

    AdminAccount Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The AdminAccount resource accepts the following input properties:

    AccountId string
    AWS account ID to set as a Network Security Manager administrator account.
    Priority int

    Priority of the administrator account, between 1 and 10.

    The following arguments are optional:

    AdminScope AdminAccountAdminScope
    Scope of what the administrator account can manage. If omitted, AWS applies its default scope. See adminScope Block below.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Timeouts AdminAccountTimeouts
    AccountId string
    AWS account ID to set as a Network Security Manager administrator account.
    Priority int

    Priority of the administrator account, between 1 and 10.

    The following arguments are optional:

    AdminScope AdminAccountAdminScopeArgs
    Scope of what the administrator account can manage. If omitted, AWS applies its default scope. See adminScope Block below.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Timeouts AdminAccountTimeoutsArgs
    account_id string
    AWS account ID to set as a Network Security Manager administrator account.
    priority number

    Priority of the administrator account, between 1 and 10.

    The following arguments are optional:

    admin_scope object
    Scope of what the administrator account can manage. If omitted, AWS applies its default scope. See adminScope Block below.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    timeouts object
    accountId String
    AWS account ID to set as a Network Security Manager administrator account.
    priority Integer

    Priority of the administrator account, between 1 and 10.

    The following arguments are optional:

    adminScope AdminAccountAdminScope
    Scope of what the administrator account can manage. If omitted, AWS applies its default scope. See adminScope Block below.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    timeouts AdminAccountTimeouts
    accountId string
    AWS account ID to set as a Network Security Manager administrator account.
    priority number

    Priority of the administrator account, between 1 and 10.

    The following arguments are optional:

    adminScope AdminAccountAdminScope
    Scope of what the administrator account can manage. If omitted, AWS applies its default scope. See adminScope Block below.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    timeouts AdminAccountTimeouts
    account_id str
    AWS account ID to set as a Network Security Manager administrator account.
    priority int

    Priority of the administrator account, between 1 and 10.

    The following arguments are optional:

    admin_scope AdminAccountAdminScopeArgs
    Scope of what the administrator account can manage. If omitted, AWS applies its default scope. See adminScope Block below.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    timeouts AdminAccountTimeoutsArgs
    accountId String
    AWS account ID to set as a Network Security Manager administrator account.
    priority Number

    Priority of the administrator account, between 1 and 10.

    The following arguments are optional:

    adminScope Property Map
    Scope of what the administrator account can manage. If omitted, AWS applies its default scope. See adminScope Block below.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    timeouts Property Map

    Outputs

    All input properties are implicitly available as output properties. Additionally, the AdminAccount resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Status string
    Status of the administrator account. Valid values: ONBOARDED, OFFBOARDED.
    Id string
    The provider-assigned unique ID for this managed resource.
    Status string
    Status of the administrator account. Valid values: ONBOARDED, OFFBOARDED.
    id string
    The provider-assigned unique ID for this managed resource.
    status string
    Status of the administrator account. Valid values: ONBOARDED, OFFBOARDED.
    id String
    The provider-assigned unique ID for this managed resource.
    status String
    Status of the administrator account. Valid values: ONBOARDED, OFFBOARDED.
    id string
    The provider-assigned unique ID for this managed resource.
    status string
    Status of the administrator account. Valid values: ONBOARDED, OFFBOARDED.
    id str
    The provider-assigned unique ID for this managed resource.
    status str
    Status of the administrator account. Valid values: ONBOARDED, OFFBOARDED.
    id String
    The provider-assigned unique ID for this managed resource.
    status String
    Status of the administrator account. Valid values: ONBOARDED, OFFBOARDED.

    Look up Existing AdminAccount Resource

    Get an existing AdminAccount resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: AdminAccountState, opts?: CustomResourceOptions): AdminAccount
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            account_id: Optional[str] = None,
            admin_scope: Optional[AdminAccountAdminScopeArgs] = None,
            priority: Optional[int] = None,
            region: Optional[str] = None,
            status: Optional[str] = None,
            timeouts: Optional[AdminAccountTimeoutsArgs] = None) -> AdminAccount
    func GetAdminAccount(ctx *Context, name string, id IDInput, state *AdminAccountState, opts ...ResourceOption) (*AdminAccount, error)
    public static AdminAccount Get(string name, Input<string> id, AdminAccountState? state, CustomResourceOptions? opts = null)
    public static AdminAccount get(String name, Output<String> id, AdminAccountState state, CustomResourceOptions options)
    resources:  existingAdminAccount:    type: aws:networksecuritymanager:AdminAccount    get:      id: ${id}
    import {
      to = aws_networksecuritymanager_admin_account.example
      id = "${id}"
    }
    
    name string
    The unique name of the resulting resource.
    id Input<ID>
    The unique provider ID of the resource to look up.
    state AdminAccountState
    Known property values the provider needs, along with the ID, to find the resource. Usually not required.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resulting resource.
    id str
    The unique provider ID of the resource to look up.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resulting resource.
    id IDInput
    The unique provider ID of the resource to look up.
    state AdminAccountState
    Known property values the provider needs, along with the ID, to find the resource. Usually not required.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resulting resource.
    id Input<string>
    The unique provider ID of the resource to look up.
    state AdminAccountState
    Known property values the provider needs, along with the ID, to find the resource. Usually not required.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resulting resource.
    id Output<String>
    The unique provider ID of the resource to look up.
    state AdminAccountState
    Known property values the provider needs, along with the ID, to find the resource. Usually not required.
    options CustomResourceOptions
    Bag of options to control resource's behavior.
    The following state arguments are supported:
    AccountId string
    AWS account ID to set as a Network Security Manager administrator account.
    AdminScope AdminAccountAdminScope
    Scope of what the administrator account can manage. If omitted, AWS applies its default scope. See adminScope Block below.
    Priority int

    Priority of the administrator account, between 1 and 10.

    The following arguments are optional:

    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Status string
    Status of the administrator account. Valid values: ONBOARDED, OFFBOARDED.
    Timeouts AdminAccountTimeouts
    AccountId string
    AWS account ID to set as a Network Security Manager administrator account.
    AdminScope AdminAccountAdminScopeArgs
    Scope of what the administrator account can manage. If omitted, AWS applies its default scope. See adminScope Block below.
    Priority int

    Priority of the administrator account, between 1 and 10.

    The following arguments are optional:

    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Status string
    Status of the administrator account. Valid values: ONBOARDED, OFFBOARDED.
    Timeouts AdminAccountTimeoutsArgs
    account_id string
    AWS account ID to set as a Network Security Manager administrator account.
    admin_scope object
    Scope of what the administrator account can manage. If omitted, AWS applies its default scope. See adminScope Block below.
    priority number

    Priority of the administrator account, between 1 and 10.

    The following arguments are optional:

    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    status string
    Status of the administrator account. Valid values: ONBOARDED, OFFBOARDED.
    timeouts object
    accountId String
    AWS account ID to set as a Network Security Manager administrator account.
    adminScope AdminAccountAdminScope
    Scope of what the administrator account can manage. If omitted, AWS applies its default scope. See adminScope Block below.
    priority Integer

    Priority of the administrator account, between 1 and 10.

    The following arguments are optional:

    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    status String
    Status of the administrator account. Valid values: ONBOARDED, OFFBOARDED.
    timeouts AdminAccountTimeouts
    accountId string
    AWS account ID to set as a Network Security Manager administrator account.
    adminScope AdminAccountAdminScope
    Scope of what the administrator account can manage. If omitted, AWS applies its default scope. See adminScope Block below.
    priority number

    Priority of the administrator account, between 1 and 10.

    The following arguments are optional:

    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    status string
    Status of the administrator account. Valid values: ONBOARDED, OFFBOARDED.
    timeouts AdminAccountTimeouts
    account_id str
    AWS account ID to set as a Network Security Manager administrator account.
    admin_scope AdminAccountAdminScopeArgs
    Scope of what the administrator account can manage. If omitted, AWS applies its default scope. See adminScope Block below.
    priority int

    Priority of the administrator account, between 1 and 10.

    The following arguments are optional:

    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    status str
    Status of the administrator account. Valid values: ONBOARDED, OFFBOARDED.
    timeouts AdminAccountTimeoutsArgs
    accountId String
    AWS account ID to set as a Network Security Manager administrator account.
    adminScope Property Map
    Scope of what the administrator account can manage. If omitted, AWS applies its default scope. See adminScope Block below.
    priority Number

    Priority of the administrator account, between 1 and 10.

    The following arguments are optional:

    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    status String
    Status of the administrator account. Valid values: ONBOARDED, OFFBOARDED.
    timeouts Property Map

    Supporting Types

    AdminAccountAdminScope, AdminAccountAdminScopeArgs

    FirewallTypeScope AdminAccountAdminScopeFirewallTypeScope
    Firewall types that the administrator can create and manage. See firewallTypeScope Block below.
    ScopeFilter AdminAccountAdminScopeScopeFilter
    Accounts and OUs that are in the administrator's scope. See scopeFilter Block below.
    FirewallTypeScope AdminAccountAdminScopeFirewallTypeScope
    Firewall types that the administrator can create and manage. See firewallTypeScope Block below.
    ScopeFilter AdminAccountAdminScopeScopeFilter
    Accounts and OUs that are in the administrator's scope. See scopeFilter Block below.
    firewall_type_scope object
    Firewall types that the administrator can create and manage. See firewallTypeScope Block below.
    scope_filter object
    Accounts and OUs that are in the administrator's scope. See scopeFilter Block below.
    firewallTypeScope AdminAccountAdminScopeFirewallTypeScope
    Firewall types that the administrator can create and manage. See firewallTypeScope Block below.
    scopeFilter AdminAccountAdminScopeScopeFilter
    Accounts and OUs that are in the administrator's scope. See scopeFilter Block below.
    firewallTypeScope AdminAccountAdminScopeFirewallTypeScope
    Firewall types that the administrator can create and manage. See firewallTypeScope Block below.
    scopeFilter AdminAccountAdminScopeScopeFilter
    Accounts and OUs that are in the administrator's scope. See scopeFilter Block below.
    firewall_type_scope AdminAccountAdminScopeFirewallTypeScope
    Firewall types that the administrator can create and manage. See firewallTypeScope Block below.
    scope_filter AdminAccountAdminScopeScopeFilter
    Accounts and OUs that are in the administrator's scope. See scopeFilter Block below.
    firewallTypeScope Property Map
    Firewall types that the administrator can create and manage. See firewallTypeScope Block below.
    scopeFilter Property Map
    Accounts and OUs that are in the administrator's scope. See scopeFilter Block below.

    AdminAccountAdminScopeFirewallTypeScope, AdminAccountAdminScopeFirewallTypeScopeArgs

    AllFirewallTypesEnabled bool
    Whether to allow the administrator to manage all firewall types.
    FirewallTypes List<string>
    Set of firewall types that the administrator can manage. Valid values: WAF, SHIELD_ADVANCED.
    AllFirewallTypesEnabled bool
    Whether to allow the administrator to manage all firewall types.
    FirewallTypes []string
    Set of firewall types that the administrator can manage. Valid values: WAF, SHIELD_ADVANCED.
    all_firewall_types_enabled bool
    Whether to allow the administrator to manage all firewall types.
    firewall_types list(string)
    Set of firewall types that the administrator can manage. Valid values: WAF, SHIELD_ADVANCED.
    allFirewallTypesEnabled Boolean
    Whether to allow the administrator to manage all firewall types.
    firewallTypes List<String>
    Set of firewall types that the administrator can manage. Valid values: WAF, SHIELD_ADVANCED.
    allFirewallTypesEnabled boolean
    Whether to allow the administrator to manage all firewall types.
    firewallTypes string[]
    Set of firewall types that the administrator can manage. Valid values: WAF, SHIELD_ADVANCED.
    all_firewall_types_enabled bool
    Whether to allow the administrator to manage all firewall types.
    firewall_types Sequence[str]
    Set of firewall types that the administrator can manage. Valid values: WAF, SHIELD_ADVANCED.
    allFirewallTypesEnabled Boolean
    Whether to allow the administrator to manage all firewall types.
    firewallTypes List<String>
    Set of firewall types that the administrator can manage. Valid values: WAF, SHIELD_ADVANCED.

    AdminAccountAdminScopeScopeFilter, AdminAccountAdminScopeScopeFilterArgs

    ExcludeOnly AdminAccountAdminScopeScopeFilterExcludeOnly
    Accounts and OUs to exclude from the administrator's scope; everything else is in scope. See excludeOnly Block below.
    IncludeAll bool
    Whether to include all accounts and OUs of the organization in scope. Must be true if set.
    IncludeOnly AdminAccountAdminScopeScopeFilterIncludeOnly
    Only the specified accounts and OUs are in the administrator's scope. See includeOnly Block below.
    ExcludeOnly AdminAccountAdminScopeScopeFilterExcludeOnly
    Accounts and OUs to exclude from the administrator's scope; everything else is in scope. See excludeOnly Block below.
    IncludeAll bool
    Whether to include all accounts and OUs of the organization in scope. Must be true if set.
    IncludeOnly AdminAccountAdminScopeScopeFilterIncludeOnly
    Only the specified accounts and OUs are in the administrator's scope. See includeOnly Block below.
    exclude_only object
    Accounts and OUs to exclude from the administrator's scope; everything else is in scope. See excludeOnly Block below.
    include_all bool
    Whether to include all accounts and OUs of the organization in scope. Must be true if set.
    include_only object
    Only the specified accounts and OUs are in the administrator's scope. See includeOnly Block below.
    excludeOnly AdminAccountAdminScopeScopeFilterExcludeOnly
    Accounts and OUs to exclude from the administrator's scope; everything else is in scope. See excludeOnly Block below.
    includeAll Boolean
    Whether to include all accounts and OUs of the organization in scope. Must be true if set.
    includeOnly AdminAccountAdminScopeScopeFilterIncludeOnly
    Only the specified accounts and OUs are in the administrator's scope. See includeOnly Block below.
    excludeOnly AdminAccountAdminScopeScopeFilterExcludeOnly
    Accounts and OUs to exclude from the administrator's scope; everything else is in scope. See excludeOnly Block below.
    includeAll boolean
    Whether to include all accounts and OUs of the organization in scope. Must be true if set.
    includeOnly AdminAccountAdminScopeScopeFilterIncludeOnly
    Only the specified accounts and OUs are in the administrator's scope. See includeOnly Block below.
    exclude_only AdminAccountAdminScopeScopeFilterExcludeOnly
    Accounts and OUs to exclude from the administrator's scope; everything else is in scope. See excludeOnly Block below.
    include_all bool
    Whether to include all accounts and OUs of the organization in scope. Must be true if set.
    include_only AdminAccountAdminScopeScopeFilterIncludeOnly
    Only the specified accounts and OUs are in the administrator's scope. See includeOnly Block below.
    excludeOnly Property Map
    Accounts and OUs to exclude from the administrator's scope; everything else is in scope. See excludeOnly Block below.
    includeAll Boolean
    Whether to include all accounts and OUs of the organization in scope. Must be true if set.
    includeOnly Property Map
    Only the specified accounts and OUs are in the administrator's scope. See includeOnly Block below.

    AdminAccountAdminScopeScopeFilterExcludeOnly, AdminAccountAdminScopeScopeFilterExcludeOnlyArgs

    Accounts List<string>
    Set of AWS account IDs.
    OrganizationalUnits List<string>
    Set of AWS Organizations OU IDs (ou-...). Root IDs are not accepted.
    Accounts []string
    Set of AWS account IDs.
    OrganizationalUnits []string
    Set of AWS Organizations OU IDs (ou-...). Root IDs are not accepted.
    accounts list(string)
    Set of AWS account IDs.
    organizational_units list(string)
    Set of AWS Organizations OU IDs (ou-...). Root IDs are not accepted.
    accounts List<String>
    Set of AWS account IDs.
    organizationalUnits List<String>
    Set of AWS Organizations OU IDs (ou-...). Root IDs are not accepted.
    accounts string[]
    Set of AWS account IDs.
    organizationalUnits string[]
    Set of AWS Organizations OU IDs (ou-...). Root IDs are not accepted.
    accounts Sequence[str]
    Set of AWS account IDs.
    organizational_units Sequence[str]
    Set of AWS Organizations OU IDs (ou-...). Root IDs are not accepted.
    accounts List<String>
    Set of AWS account IDs.
    organizationalUnits List<String>
    Set of AWS Organizations OU IDs (ou-...). Root IDs are not accepted.

    AdminAccountAdminScopeScopeFilterIncludeOnly, AdminAccountAdminScopeScopeFilterIncludeOnlyArgs

    Accounts List<string>
    Set of AWS account IDs.
    OrganizationalUnits List<string>
    Set of AWS Organizations OU IDs (ou-...). Root IDs are not accepted.
    Accounts []string
    Set of AWS account IDs.
    OrganizationalUnits []string
    Set of AWS Organizations OU IDs (ou-...). Root IDs are not accepted.
    accounts list(string)
    Set of AWS account IDs.
    organizational_units list(string)
    Set of AWS Organizations OU IDs (ou-...). Root IDs are not accepted.
    accounts List<String>
    Set of AWS account IDs.
    organizationalUnits List<String>
    Set of AWS Organizations OU IDs (ou-...). Root IDs are not accepted.
    accounts string[]
    Set of AWS account IDs.
    organizationalUnits string[]
    Set of AWS Organizations OU IDs (ou-...). Root IDs are not accepted.
    accounts Sequence[str]
    Set of AWS account IDs.
    organizational_units Sequence[str]
    Set of AWS Organizations OU IDs (ou-...). Root IDs are not accepted.
    accounts List<String>
    Set of AWS account IDs.
    organizationalUnits List<String>
    Set of AWS Organizations OU IDs (ou-...). Root IDs are not accepted.

    AdminAccountTimeouts, AdminAccountTimeoutsArgs

    Create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    Delete string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    Update string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    Create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    Delete string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    Update string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create str
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete str
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update str
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

    Import

    Identity Schema

    Required

    • adminAccountId (String) AWS account ID of the administrator account, corresponding to the resource’s accountId argument.

    Optional

    • accountId (String) AWS Account where this resource is managed.
    • region (String) Region where this resource is managed.

    Using pulumi import, import Network Security Manager Admin Account using the accountId. For example:

    $ pulumi import aws:networksecuritymanager/adminAccount:AdminAccount example 123456789012
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo aws logo
    Viewing docs for AWS v7.55.0
    published on Friday, Nov 13, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial