We recommend new projects start with resources from the AWS provider.
aws-native.backup.Framework
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
Contains detailed information about a framework. Frameworks contain controls, which evaluate and report on your backup events and resources. Frameworks generate daily compliance results.
Create Framework Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Framework(name: string, args: FrameworkArgs, opts?: CustomResourceOptions);
@overload
def Framework(resource_name: str,
args: FrameworkArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Framework(resource_name: str,
opts: Optional[ResourceOptions] = None,
framework_controls: Optional[Sequence[FrameworkControlArgs]] = None,
framework_description: Optional[str] = None,
framework_name: Optional[str] = None,
framework_tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
func NewFramework(ctx *Context, name string, args FrameworkArgs, opts ...ResourceOption) (*Framework, error)
public Framework(string name, FrameworkArgs args, CustomResourceOptions? opts = null)
public Framework(String name, FrameworkArgs args)
public Framework(String name, FrameworkArgs args, CustomResourceOptions options)
type: aws-native:backup:Framework
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args FrameworkArgs
- 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 FrameworkArgs
- 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 FrameworkArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args FrameworkArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args FrameworkArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Framework 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 Framework resource accepts the following input properties:
- Framework
Controls List<Pulumi.Aws Native. Backup. Inputs. Framework Control> - Contains detailed information about all of the controls of a framework. Each framework must contain at least one control.
- Framework
Description string - An optional description of the framework with a maximum 1,024 characters.
- Framework
Name string - The unique name of a framework. This name is between 1 and 256 characters, starting with a letter, and consisting of letters (a-z, A-Z), numbers (0-9), and underscores (_).
- List<Pulumi.
Aws Native. Inputs. Tag> - Metadata that you can assign to help organize the frameworks that you create. Each tag is a key-value pair.
- Framework
Controls []FrameworkControl Args - Contains detailed information about all of the controls of a framework. Each framework must contain at least one control.
- Framework
Description string - An optional description of the framework with a maximum 1,024 characters.
- Framework
Name string - The unique name of a framework. This name is between 1 and 256 characters, starting with a letter, and consisting of letters (a-z, A-Z), numbers (0-9), and underscores (_).
- Tag
Args - Metadata that you can assign to help organize the frameworks that you create. Each tag is a key-value pair.
- framework
Controls List<FrameworkControl> - Contains detailed information about all of the controls of a framework. Each framework must contain at least one control.
- framework
Description String - An optional description of the framework with a maximum 1,024 characters.
- framework
Name String - The unique name of a framework. This name is between 1 and 256 characters, starting with a letter, and consisting of letters (a-z, A-Z), numbers (0-9), and underscores (_).
- List<Tag>
- Metadata that you can assign to help organize the frameworks that you create. Each tag is a key-value pair.
- framework
Controls FrameworkControl[] - Contains detailed information about all of the controls of a framework. Each framework must contain at least one control.
- framework
Description string - An optional description of the framework with a maximum 1,024 characters.
- framework
Name string - The unique name of a framework. This name is between 1 and 256 characters, starting with a letter, and consisting of letters (a-z, A-Z), numbers (0-9), and underscores (_).
- Tag[]
- Metadata that you can assign to help organize the frameworks that you create. Each tag is a key-value pair.
- framework_
controls Sequence[FrameworkControl Args] - Contains detailed information about all of the controls of a framework. Each framework must contain at least one control.
- framework_
description str - An optional description of the framework with a maximum 1,024 characters.
- framework_
name str - The unique name of a framework. This name is between 1 and 256 characters, starting with a letter, and consisting of letters (a-z, A-Z), numbers (0-9), and underscores (_).
- Sequence[Tag
Args] - Metadata that you can assign to help organize the frameworks that you create. Each tag is a key-value pair.
- framework
Controls List<Property Map> - Contains detailed information about all of the controls of a framework. Each framework must contain at least one control.
- framework
Description String - An optional description of the framework with a maximum 1,024 characters.
- framework
Name String - The unique name of a framework. This name is between 1 and 256 characters, starting with a letter, and consisting of letters (a-z, A-Z), numbers (0-9), and underscores (_).
- List<Property Map>
- Metadata that you can assign to help organize the frameworks that you create. Each tag is a key-value pair.
Outputs
All input properties are implicitly available as output properties. Additionally, the Framework resource produces the following output properties:
- Creation
Time string - The date and time that a framework is created, in ISO 8601 representation. The value of CreationTime is accurate to milliseconds. For example, 2020-07-10T15:00:00.000-08:00 represents the 10th of July 2020 at 3:00 PM 8 hours behind UTC.
- Deployment
Status string - The deployment status of a framework. The statuses are:
CREATE_IN_PROGRESS | UPDATE_IN_PROGRESS | DELETE_IN_PROGRESS | COMPLETED | FAILED
- Framework
Arn string - An Amazon Resource Name (ARN) that uniquely identifies Framework as a resource
- Framework
Status string A framework consists of one or more controls. Each control governs a resource, such as backup plans, backup selections, backup vaults, or recovery points. You can also turn AWS Config recording on or off for each resource. The statuses are:
ACTIVE
when recording is turned on for all resources governed by the framework.PARTIALLY_ACTIVE
when recording is turned off for at least one resource governed by the framework.INACTIVE
when recording is turned off for all resources governed by the framework.UNAVAILABLE
when AWS Backup is unable to validate recording status at this time.- Id string
- The provider-assigned unique ID for this managed resource.
- Creation
Time string - The date and time that a framework is created, in ISO 8601 representation. The value of CreationTime is accurate to milliseconds. For example, 2020-07-10T15:00:00.000-08:00 represents the 10th of July 2020 at 3:00 PM 8 hours behind UTC.
- Deployment
Status string - The deployment status of a framework. The statuses are:
CREATE_IN_PROGRESS | UPDATE_IN_PROGRESS | DELETE_IN_PROGRESS | COMPLETED | FAILED
- Framework
Arn string - An Amazon Resource Name (ARN) that uniquely identifies Framework as a resource
- Framework
Status string A framework consists of one or more controls. Each control governs a resource, such as backup plans, backup selections, backup vaults, or recovery points. You can also turn AWS Config recording on or off for each resource. The statuses are:
ACTIVE
when recording is turned on for all resources governed by the framework.PARTIALLY_ACTIVE
when recording is turned off for at least one resource governed by the framework.INACTIVE
when recording is turned off for all resources governed by the framework.UNAVAILABLE
when AWS Backup is unable to validate recording status at this time.- Id string
- The provider-assigned unique ID for this managed resource.
- creation
Time String - The date and time that a framework is created, in ISO 8601 representation. The value of CreationTime is accurate to milliseconds. For example, 2020-07-10T15:00:00.000-08:00 represents the 10th of July 2020 at 3:00 PM 8 hours behind UTC.
- deployment
Status String - The deployment status of a framework. The statuses are:
CREATE_IN_PROGRESS | UPDATE_IN_PROGRESS | DELETE_IN_PROGRESS | COMPLETED | FAILED
- framework
Arn String - An Amazon Resource Name (ARN) that uniquely identifies Framework as a resource
- framework
Status String A framework consists of one or more controls. Each control governs a resource, such as backup plans, backup selections, backup vaults, or recovery points. You can also turn AWS Config recording on or off for each resource. The statuses are:
ACTIVE
when recording is turned on for all resources governed by the framework.PARTIALLY_ACTIVE
when recording is turned off for at least one resource governed by the framework.INACTIVE
when recording is turned off for all resources governed by the framework.UNAVAILABLE
when AWS Backup is unable to validate recording status at this time.- id String
- The provider-assigned unique ID for this managed resource.
- creation
Time string - The date and time that a framework is created, in ISO 8601 representation. The value of CreationTime is accurate to milliseconds. For example, 2020-07-10T15:00:00.000-08:00 represents the 10th of July 2020 at 3:00 PM 8 hours behind UTC.
- deployment
Status string - The deployment status of a framework. The statuses are:
CREATE_IN_PROGRESS | UPDATE_IN_PROGRESS | DELETE_IN_PROGRESS | COMPLETED | FAILED
- framework
Arn string - An Amazon Resource Name (ARN) that uniquely identifies Framework as a resource
- framework
Status string A framework consists of one or more controls. Each control governs a resource, such as backup plans, backup selections, backup vaults, or recovery points. You can also turn AWS Config recording on or off for each resource. The statuses are:
ACTIVE
when recording is turned on for all resources governed by the framework.PARTIALLY_ACTIVE
when recording is turned off for at least one resource governed by the framework.INACTIVE
when recording is turned off for all resources governed by the framework.UNAVAILABLE
when AWS Backup is unable to validate recording status at this time.- id string
- The provider-assigned unique ID for this managed resource.
- creation_
time str - The date and time that a framework is created, in ISO 8601 representation. The value of CreationTime is accurate to milliseconds. For example, 2020-07-10T15:00:00.000-08:00 represents the 10th of July 2020 at 3:00 PM 8 hours behind UTC.
- deployment_
status str - The deployment status of a framework. The statuses are:
CREATE_IN_PROGRESS | UPDATE_IN_PROGRESS | DELETE_IN_PROGRESS | COMPLETED | FAILED
- framework_
arn str - An Amazon Resource Name (ARN) that uniquely identifies Framework as a resource
- framework_
status str A framework consists of one or more controls. Each control governs a resource, such as backup plans, backup selections, backup vaults, or recovery points. You can also turn AWS Config recording on or off for each resource. The statuses are:
ACTIVE
when recording is turned on for all resources governed by the framework.PARTIALLY_ACTIVE
when recording is turned off for at least one resource governed by the framework.INACTIVE
when recording is turned off for all resources governed by the framework.UNAVAILABLE
when AWS Backup is unable to validate recording status at this time.- id str
- The provider-assigned unique ID for this managed resource.
- creation
Time String - The date and time that a framework is created, in ISO 8601 representation. The value of CreationTime is accurate to milliseconds. For example, 2020-07-10T15:00:00.000-08:00 represents the 10th of July 2020 at 3:00 PM 8 hours behind UTC.
- deployment
Status String - The deployment status of a framework. The statuses are:
CREATE_IN_PROGRESS | UPDATE_IN_PROGRESS | DELETE_IN_PROGRESS | COMPLETED | FAILED
- framework
Arn String - An Amazon Resource Name (ARN) that uniquely identifies Framework as a resource
- framework
Status String A framework consists of one or more controls. Each control governs a resource, such as backup plans, backup selections, backup vaults, or recovery points. You can also turn AWS Config recording on or off for each resource. The statuses are:
ACTIVE
when recording is turned on for all resources governed by the framework.PARTIALLY_ACTIVE
when recording is turned off for at least one resource governed by the framework.INACTIVE
when recording is turned off for all resources governed by the framework.UNAVAILABLE
when AWS Backup is unable to validate recording status at this time.- id String
- The provider-assigned unique ID for this managed resource.
Supporting Types
FrameworkControl, FrameworkControlArgs
- Control
Name string - The name of a control. This name is between 1 and 256 characters.
- Control
Input List<Pulumi.Parameters Aws Native. Backup. Inputs. Framework Control Input Parameter> - A list of ParameterName and ParameterValue pairs.
- Control
Scope Pulumi.Aws Native. Backup. Inputs. Framework Control Control Scope Properties - The scope of a control. The control scope defines what the control will evaluate. Three examples of control scopes are: a specific backup plan, all backup plans with a specific tag, or all backup plans.
- Control
Name string - The name of a control. This name is between 1 and 256 characters.
- Control
Input []FrameworkParameters Control Input Parameter - A list of ParameterName and ParameterValue pairs.
- Control
Scope FrameworkControl Control Scope Properties - The scope of a control. The control scope defines what the control will evaluate. Three examples of control scopes are: a specific backup plan, all backup plans with a specific tag, or all backup plans.
- control
Name String - The name of a control. This name is between 1 and 256 characters.
- control
Input List<FrameworkParameters Control Input Parameter> - A list of ParameterName and ParameterValue pairs.
- control
Scope FrameworkControl Control Scope Properties - The scope of a control. The control scope defines what the control will evaluate. Three examples of control scopes are: a specific backup plan, all backup plans with a specific tag, or all backup plans.
- control
Name string - The name of a control. This name is between 1 and 256 characters.
- control
Input FrameworkParameters Control Input Parameter[] - A list of ParameterName and ParameterValue pairs.
- control
Scope FrameworkControl Control Scope Properties - The scope of a control. The control scope defines what the control will evaluate. Three examples of control scopes are: a specific backup plan, all backup plans with a specific tag, or all backup plans.
- control_
name str - The name of a control. This name is between 1 and 256 characters.
- control_
input_ Sequence[Frameworkparameters Control Input Parameter] - A list of ParameterName and ParameterValue pairs.
- control_
scope FrameworkControl Control Scope Properties - The scope of a control. The control scope defines what the control will evaluate. Three examples of control scopes are: a specific backup plan, all backup plans with a specific tag, or all backup plans.
- control
Name String - The name of a control. This name is between 1 and 256 characters.
- control
Input List<Property Map>Parameters - A list of ParameterName and ParameterValue pairs.
- control
Scope Property Map - The scope of a control. The control scope defines what the control will evaluate. Three examples of control scopes are: a specific backup plan, all backup plans with a specific tag, or all backup plans.
FrameworkControlControlScopeProperties, FrameworkControlControlScopePropertiesArgs
- Compliance
Resource List<string>Ids - The ID of the only AWS resource that you want your control scope to contain.
- Compliance
Resource List<string>Types - Describes whether the control scope includes one or more types of resources, such as
EFS
orRDS
. - List<Pulumi.
Aws Native. Backup. Inputs. Framework Tag> - Describes whether the control scope includes resources with one or more tags. Each tag is a key-value pair.
- Compliance
Resource []stringIds - The ID of the only AWS resource that you want your control scope to contain.
- Compliance
Resource []stringTypes - Describes whether the control scope includes one or more types of resources, such as
EFS
orRDS
. - []Framework
Tag - Describes whether the control scope includes resources with one or more tags. Each tag is a key-value pair.
- compliance
Resource List<String>Ids - The ID of the only AWS resource that you want your control scope to contain.
- compliance
Resource List<String>Types - Describes whether the control scope includes one or more types of resources, such as
EFS
orRDS
. - List<Framework
Tag> - Describes whether the control scope includes resources with one or more tags. Each tag is a key-value pair.
- compliance
Resource string[]Ids - The ID of the only AWS resource that you want your control scope to contain.
- compliance
Resource string[]Types - Describes whether the control scope includes one or more types of resources, such as
EFS
orRDS
. - Framework
Tag[] - Describes whether the control scope includes resources with one or more tags. Each tag is a key-value pair.
- compliance_
resource_ Sequence[str]ids - The ID of the only AWS resource that you want your control scope to contain.
- compliance_
resource_ Sequence[str]types - Describes whether the control scope includes one or more types of resources, such as
EFS
orRDS
. - Sequence[Framework
Tag] - Describes whether the control scope includes resources with one or more tags. Each tag is a key-value pair.
- compliance
Resource List<String>Ids - The ID of the only AWS resource that you want your control scope to contain.
- compliance
Resource List<String>Types - Describes whether the control scope includes one or more types of resources, such as
EFS
orRDS
. - List<Property Map>
- Describes whether the control scope includes resources with one or more tags. Each tag is a key-value pair.
FrameworkControlInputParameter, FrameworkControlInputParameterArgs
- Parameter
Name string - The name of a parameter, for example,
BackupPlanFrequency
. - Parameter
Value string - The value of parameter, for example,
hourly
.
- Parameter
Name string - The name of a parameter, for example,
BackupPlanFrequency
. - Parameter
Value string - The value of parameter, for example,
hourly
.
- parameter
Name String - The name of a parameter, for example,
BackupPlanFrequency
. - parameter
Value String - The value of parameter, for example,
hourly
.
- parameter
Name string - The name of a parameter, for example,
BackupPlanFrequency
. - parameter
Value string - The value of parameter, for example,
hourly
.
- parameter_
name str - The name of a parameter, for example,
BackupPlanFrequency
. - parameter_
value str - The value of parameter, for example,
hourly
.
- parameter
Name String - The name of a parameter, for example,
BackupPlanFrequency
. - parameter
Value String - The value of parameter, for example,
hourly
.
FrameworkTag, FrameworkTagArgs
- Key string
- The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- Value string
- The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- Key string
- The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- Value string
- The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- key String
- The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- value String
- The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- key string
- The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- value string
- The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- key str
- The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- value str
- The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- key String
- The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- value String
- The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
Tag, TagArgs
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.