Class: Aws::ControlCatalog::Types::GetControlResponse

Inherits:
Struct
  • Object
show all
Defined in:
gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb

Overview

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#aliasesArray<String>

A list of alternative identifiers for the control. These are human-readable designators, such as SH.S3.1. Several aliases can refer to the same control across different Amazon Web Services services or compliance frameworks.

Returns:

  • (Array<String>)


571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
# File 'gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb', line 571

class GetControlResponse < Struct.new(
  :arn,
  :aliases,
  :name,
  :description,
  :behavior,
  :severity,
  :region_configuration,
  :implementation,
  :parameter_requirement_summary,
  :parameters,
  :create_time,
  :governed_resources,
  :governed_providers)
  SENSITIVE = []
  include Aws::Structure
end

#arnString

The Amazon Resource Name (ARN) of the control.

Returns:

  • (String)


571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
# File 'gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb', line 571

class GetControlResponse < Struct.new(
  :arn,
  :aliases,
  :name,
  :description,
  :behavior,
  :severity,
  :region_configuration,
  :implementation,
  :parameter_requirement_summary,
  :parameters,
  :create_time,
  :governed_resources,
  :governed_providers)
  SENSITIVE = []
  include Aws::Structure
end

#behaviorString

A term that identifies the control's functional behavior. One of Preventive, Detective, Proactive

Returns:

  • (String)


571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
# File 'gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb', line 571

class GetControlResponse < Struct.new(
  :arn,
  :aliases,
  :name,
  :description,
  :behavior,
  :severity,
  :region_configuration,
  :implementation,
  :parameter_requirement_summary,
  :parameters,
  :create_time,
  :governed_resources,
  :governed_providers)
  SENSITIVE = []
  include Aws::Structure
end

#create_timeTime

A timestamp that notes the time when the control was released (start of its life) as a governance capability in Amazon Web Services.

Returns:

  • (Time)


571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
# File 'gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb', line 571

class GetControlResponse < Struct.new(
  :arn,
  :aliases,
  :name,
  :description,
  :behavior,
  :severity,
  :region_configuration,
  :implementation,
  :parameter_requirement_summary,
  :parameters,
  :create_time,
  :governed_resources,
  :governed_providers)
  SENSITIVE = []
  include Aws::Structure
end

#descriptionString

A description of what the control does.

Returns:

  • (String)


571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
# File 'gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb', line 571

class GetControlResponse < Struct.new(
  :arn,
  :aliases,
  :name,
  :description,
  :behavior,
  :severity,
  :region_configuration,
  :implementation,
  :parameter_requirement_summary,
  :parameters,
  :create_time,
  :governed_resources,
  :governed_providers)
  SENSITIVE = []
  include Aws::Structure
end

#governed_providersArray<String>

A list of providers whose resources are governed by this control. For example, a value of AWS indicates that the control governs Amazon Web Services resources.

Returns:

  • (Array<String>)


571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
# File 'gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb', line 571

class GetControlResponse < Struct.new(
  :arn,
  :aliases,
  :name,
  :description,
  :behavior,
  :severity,
  :region_configuration,
  :implementation,
  :parameter_requirement_summary,
  :parameters,
  :create_time,
  :governed_resources,
  :governed_providers)
  SENSITIVE = []
  include Aws::Structure
end

#governed_resourcesArray<String>

A list of resource types that are governed by this control. This information helps you understand which controls can govern certain types of resources, and conversely, which resources are affected when the control is implemented. For Amazon Web Services controls, the resources are represented as CloudFormation resource types. For non-Amazon Web Services controls, the resources are represented in a provider-specific format. If GovernedResources cannot be represented by available resource types, it’s returned as an empty list.

Returns:

  • (Array<String>)


571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
# File 'gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb', line 571

class GetControlResponse < Struct.new(
  :arn,
  :aliases,
  :name,
  :description,
  :behavior,
  :severity,
  :region_configuration,
  :implementation,
  :parameter_requirement_summary,
  :parameters,
  :create_time,
  :governed_resources,
  :governed_providers)
  SENSITIVE = []
  include Aws::Structure
end

#implementationTypes::ImplementationDetails

Returns information about the control, as an ImplementationDetails object that shows the underlying implementation type for a control.



571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
# File 'gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb', line 571

class GetControlResponse < Struct.new(
  :arn,
  :aliases,
  :name,
  :description,
  :behavior,
  :severity,
  :region_configuration,
  :implementation,
  :parameter_requirement_summary,
  :parameters,
  :create_time,
  :governed_resources,
  :governed_providers)
  SENSITIVE = []
  include Aws::Structure
end

#nameString

The display name of the control.

Returns:

  • (String)


571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
# File 'gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb', line 571

class GetControlResponse < Struct.new(
  :arn,
  :aliases,
  :name,
  :description,
  :behavior,
  :severity,
  :region_configuration,
  :implementation,
  :parameter_requirement_summary,
  :parameters,
  :create_time,
  :governed_resources,
  :governed_providers)
  SENSITIVE = []
  include Aws::Structure
end

#parameter_requirement_summaryString

A summary that indicates whether the control requires parameters, accepts optional parameters, or does not support parameters. Use this field to determine whether you need to supply parameter values when you enable the control.

Returns:

  • (String)


571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
# File 'gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb', line 571

class GetControlResponse < Struct.new(
  :arn,
  :aliases,
  :name,
  :description,
  :behavior,
  :severity,
  :region_configuration,
  :implementation,
  :parameter_requirement_summary,
  :parameters,
  :create_time,
  :governed_resources,
  :governed_providers)
  SENSITIVE = []
  include Aws::Structure
end

#parametersArray<Types::ControlParameter>

Returns an array of ControlParameter objects that specify the parameters a control supports. An empty list is returned for controls that don’t support parameters.

Returns:



571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
# File 'gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb', line 571

class GetControlResponse < Struct.new(
  :arn,
  :aliases,
  :name,
  :description,
  :behavior,
  :severity,
  :region_configuration,
  :implementation,
  :parameter_requirement_summary,
  :parameters,
  :create_time,
  :governed_resources,
  :governed_providers)
  SENSITIVE = []
  include Aws::Structure
end

#region_configurationTypes::RegionConfiguration

Returns information about the control, including the scope of the control, if enabled, and the Regions in which the control is available for deployment. For more information about scope, see Global services.

If you are applying controls through an Amazon Web Services Control Tower landing zone environment, remember that the values returned in the RegionConfiguration API operation are not related to the governed Regions in your landing zone. For example, if you are governing Regions A,B,and C while the control is available in Regions A, B, C, and D, you'd see a response with DeployableRegions of A, B, C, and D for a control with REGIONAL scope, even though you may not intend to deploy the control in Region D, because you do not govern it through your landing zone.



571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
# File 'gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb', line 571

class GetControlResponse < Struct.new(
  :arn,
  :aliases,
  :name,
  :description,
  :behavior,
  :severity,
  :region_configuration,
  :implementation,
  :parameter_requirement_summary,
  :parameters,
  :create_time,
  :governed_resources,
  :governed_providers)
  SENSITIVE = []
  include Aws::Structure
end

#severityString

An enumerated type, with the following possible values:

Returns:

  • (String)


571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
# File 'gems/aws-sdk-controlcatalog/lib/aws-sdk-controlcatalog/types.rb', line 571

class GetControlResponse < Struct.new(
  :arn,
  :aliases,
  :name,
  :description,
  :behavior,
  :severity,
  :region_configuration,
  :implementation,
  :parameter_requirement_summary,
  :parameters,
  :create_time,
  :governed_resources,
  :governed_providers)
  SENSITIVE = []
  include Aws::Structure
end