automatic_tape_creation_policies

Creates, updates, deletes, gets or lists an automatic_tape_creation_policies resource.

Overview

Name	automatic_tape_creation_policies
Type	Resource
Id	aws.storagegateway.automatic_tape_creation_policies

Fields

The following fields are returned by SELECT queries:

list_automatic_tape_creation_policies

Name	Datatype	Description
automatic_tape_creation_policy_infos	array	Gets a listing of information about the gateway's automatic tape creation policies, including the automatic tape creation rules and the gateway that is using the policies.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_automatic_tape_creation_policies	select	region		Lists the automatic tape creation policies for a gateway. If there are no automatic tape creation policies for the gateway, it returns an empty list. This operation is only supported for tape gateways.
update_automatic_tape_creation_policy	update	region, AutomaticTapeCreationRules, GatewayARN		Updates the automatic tape creation policy of a gateway. Use this to update the policy with a new set of automatic tape creation rules. This is only supported for tape gateways. By default, there is no automatic tape creation policy. A gateway can have only one automatic tape creation policy.
delete_automatic_tape_creation_policy	delete	region		Deletes the automatic tape creation policy of a gateway. If you delete this policy, new virtual tapes must be created manually. Use the Amazon Resource Name (ARN) of the gateway in your request to remove the policy.

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

list_automatic_tape_creation_policies

Lists the automatic tape creation policies for a gateway. If there are no automatic tape creation policies for the gateway, it returns an empty list. This operation is only supported for tape gateways.

SELECT
automatic_tape_creation_policy_infos
FROM aws.storagegateway.automatic_tape_creation_policies
WHERE region = '{{ region }}' -- required
;

UPDATE examples

update_automatic_tape_creation_policy

Updates the automatic tape creation policy of a gateway. Use this to update the policy with a new set of automatic tape creation rules. This is only supported for tape gateways. By default, there is no automatic tape creation policy. A gateway can have only one automatic tape creation policy.

UPDATE aws.storagegateway.automatic_tape_creation_policies
SET 
AutomaticTapeCreationRules = '{{ AutomaticTapeCreationRules }}',
GatewayARN = '{{ GatewayARN }}'
WHERE 
region = '{{ region }}' --required
AND AutomaticTapeCreationRules = '{{ AutomaticTapeCreationRules }}' --required
AND GatewayARN = '{{ GatewayARN }}' --required
RETURNING
gateway_arn;

DELETE examples

delete_automatic_tape_creation_policy

Deletes the automatic tape creation policy of a gateway. If you delete this policy, new virtual tapes must be created manually. Use the Amazon Resource Name (ARN) of the gateway in your request to remove the policy.

DELETE FROM aws.storagegateway.automatic_tape_creation_policies
WHERE region = '{{ region }}' --required
;