security_configurations

Creates, updates, deletes, gets or lists a security_configurations resource.

Overview

Name	security_configurations
Type	Resource
Id	aws.emr.security_configurations

Fields

The following fields are returned by SELECT queries:

describe_security_configuration

Name	Datatype	Description
creation_date_time	string (date-time)	The date and time the security configuration was created
name	string	The name of the security configuration. (pattern: <code>[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*</code>)
security_configuration	string	The security configuration details in JSON format.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
describe_security_configuration	select	region		Provides the details of a security configuration by returning the configuration JSON.
create_security_configuration	insert	region, SecurityConfiguration		Creates a security configuration, which is stored in the service and can be specified when a cluster is created.
delete_security_configuration	delete	region		Deletes a security configuration.
list_security_configurations	exec	region		Lists all the security configurations visible to this account, providing their creation dates and times, and their names. This call returns a maximum of 50 clusters per call, but returns a marker to track the paging of the cluster list across multiple ListSecurityConfigurations calls.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)

SELECT examples

describe_security_configuration

Provides the details of a security configuration by returning the configuration JSON.

SELECT
creation_date_time,
name,
security_configuration
FROM aws.emr.security_configurations
WHERE region = '{{ region }}' -- required
;

INSERT examples

create_security_configuration

Creates a security configuration, which is stored in the service and can be specified when a cluster is created.

INSERT INTO aws.emr.security_configurations (
Name,
SecurityConfiguration,
region
)
SELECT 
'{{ Name }}',
'{{ SecurityConfiguration }}' /* required */,
'{{ region }}'
RETURNING
creation_date_time,
name
;

Manifest

# Description fields are for documentation purposes
- name: security_configurations
props:
  - name: region
    value: "{{ region }}"
    description: Required parameter for the security_configurations resource.
  - name: Name
    value: "{{ Name }}"
    description: |
      The name of the security configuration.
  - name: SecurityConfiguration
    value: "{{ SecurityConfiguration }}"
    description: |
      The security configuration details in JSON format. For JSON parameters and examples, see Use Security Configurations to Set Up Cluster Security in the Amazon EMR Management Guide.

DELETE examples

delete_security_configuration

Deletes a security configuration.

DELETE FROM aws.emr.security_configurations
WHERE region = '{{ region }}' --required
;

Lifecycle Methods

list_security_configurations

Lists all the security configurations visible to this account, providing their creation dates and times, and their names. This call returns a maximum of 50 clusters per call, but returns a marker to track the paging of the cluster list across multiple ListSecurityConfigurations calls.

EXEC aws.emr.security_configurations.list_security_configurations 
@region='{{ region }}' --required 
@@json=
'{
"Marker": "{{ Marker }}"
}'
;