Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Paws::OpsWorks::CreateUserkContributed Perl DocuPaws::OpsWorks::CreateStack(3)

NAME
       Paws::OpsWorks::CreateStack - Arguments for method CreateStack on
       Paws::OpsWorks

DESCRIPTION
       This class represents the parameters used for calling the method
       CreateStack on the AWS OpsWorks service.	Use the	attributes of this
       class as	arguments to method CreateStack.

       You shouln't make instances of this class. Each attribute should	be
       used as a named argument	in the call to CreateStack.

       As an example:

	 $service_obj->CreateStack(Att1	=> $value1, Att2 => $value2, ...);

       Values for attributes that are native types (Int, String, Float,	etc)
       can passed as-is	(scalar	values). Values	for complex Types (objects)
       can be passed as	a HashRef. The keys and	values of the hashref will be
       used to instance	the underlying object.

ATTRIBUTES
   AgentVersion	=> Str
       The default AWS OpsWorks	agent version. You have	the following options:

       o   Auto-update - Set this parameter to "LATEST". AWS OpsWorks
	   automatically installs new agent versions on	the stack's instances
	   as soon as they are available.

       o   Fixed version - Set this parameter to your preferred	agent version.
	   To update the agent version,	you must edit the stack	configuration
	   and specify a new version. AWS OpsWorks then	automatically installs
	   that	version	on the stack's instances.

       The default setting is "LATEST".	To specify an agent version, you must
       use the complete	version	number,	not the	abbreviated number shown on
       the console. For	a list of available agent version numbers, call
       DescribeAgentVersions.

       You can also specify an agent version when you create or	update an
       instance, which overrides the stack's default setting.

   Attributes => Paws::OpsWorks::StackAttributes
       One or more user-defined	key-value pairs	to be added to the stack
       attributes.

   ChefConfiguration =>	Paws::OpsWorks::ChefConfiguration
       A "ChefConfiguration" object that specifies whether to enable Berkshelf
       and the Berkshelf version on Chef 11.10 stacks. For more	information,
       see Create a New	Stack.

   ConfigurationManager	=> Paws::OpsWorks::StackConfigurationManager
       The configuration manager. When you clone a stack we recommend that you
       use the configuration manager to	specify	the Chef version: 0.9, 11.4,
       or 11.10. The default value is currently	11.4.

   CustomCookbooksSource => Paws::OpsWorks::Source
   CustomJson => Str
       A string	that contains user-defined, custom JSON. It can	be used	to
       override	the corresponding default stack	configuration attribute	values
       or to pass data to recipes. The string should be	in the following
       escape characters such as '"':

       "{\"key1\": \"value1\", \"key2\": \"value2\",...}"

       For more	information on custom JSON, see	Use Custom JSON	to Modify the
       Stack Configuration Attributes.

   DefaultAvailabilityZone => Str
       The stack's default Availability	Zone, which must be in the specified
       region. For more	information, see Regions and Endpoints.	If you also
       specify a value for "DefaultSubnetId", the subnet must be in the	same
       zone. For more information, see the "VpcId" parameter description.

   REQUIRED DefaultInstanceProfileArn => Str
       The Amazon Resource Name	(ARN) of an IAM	profile	that is	the default
       profile for all of the stack's EC2 instances. For more information
       about IAM ARNs, see Using Identifiers.

   DefaultOs =>	Str
       The stack's default operating system, which is installed	on every
       instance	unless you specify a different operating system	when you
       create the instance. You	can specify one	of the following.

       o   A supported Linux operating system: An Amazon Linux version,	such
	   as "Amazon Linux 2015.03", "Red Hat Enterprise Linux	7", "Ubuntu
	   12.04 LTS", or "Ubuntu 14.04	LTS".

       o   "Microsoft Windows Server 2012 R2 Base".

       o   A custom AMI: "Custom". You specify the custom AMI you want to use
	   when	you create instances. For more information, see	Using Custom
	   AMIs.

       The default option is the current Amazon	Linux version. For more
       information on the supported operating systems, see AWS OpsWorks
       Operating Systems.

   DefaultRootDeviceType => Str
       The default root	device type. This value	is the default for all
       instances in the	stack, but you can override it when you	create an
       instance. The default option is "instance-store". For more information,
       see Storage for the Root	Device.

   DefaultSshKeyName =>	Str
       A default Amazon	EC2 key	pair name. The default value is	none. If you
       specify a key pair name,	AWS OpsWorks installs the public key on	the
       instance	and you	can use	the private key	with an	SSH client to log in
       to the instance.	For more information, see Using	SSH to Communicate
       with an Instance	and Managing SSH Access. You can override this setting
       by specifying a different key pair, or no key pair, when	you create an
       instance.

   DefaultSubnetId => Str
       The stack's default VPC subnet ID. This parameter is required if	you
       specify a value for the "VpcId" parameter. All instances	are launched
       into this subnet	unless you specify otherwise when you create the
       instance. If you	also specify a value for "DefaultAvailabilityZone",
       the subnet must be in that zone.	For information	on default values and
       when this parameter is required,	see the	"VpcId"	parameter description.

   HostnameTheme => Str
       The stack's host	name theme, with spaces	replaced by underscores. The
       theme is	used to	generate host names for	the stack's instances. By
       default,	"HostnameTheme"	is set to "Layer_Dependent", which creates
       host names by appending integers	to the layer's short name. The other
       themes are:

       o   "Baked_Goods"

       o   "Clouds"

       o   "Europe_Cities"

       o   "Fruits"

       o   "Greek_Deities"

       o   "Legendary_creatures_from_Japan"

       o   "Planets_and_Moons"

       o   "Roman_Deities"

       o   "Scottish_Islands"

       o   "US_Cities"

       o   "Wild_Cats"

       To obtain a generated host name,	call "GetHostNameSuggestion", which
       returns a host name based on the	current	theme.

   REQUIRED Name => Str
       The stack name.

   REQUIRED Region => Str
       The stack's AWS region, such as "us-east-1". For	more information about
       Amazon regions, see Regions and Endpoints.

   REQUIRED ServiceRoleArn => Str
       The stack's AWS Identity	and Access Management (IAM) role, which	allows
       AWS OpsWorks to work with AWS resources on your behalf. You must	set
       this parameter to the Amazon Resource Name (ARN)	for an existing	IAM
       role. For more information about	IAM ARNs, see Using Identifiers.

   UseCustomCookbooks => Bool
       Whether the stack uses custom cookbooks.

   UseOpsworksSecurityGroups =>	Bool
       Whether to associate the	AWS OpsWorks built-in security groups with the
       stack's layers.

       AWS OpsWorks provides a standard	set of built-in	security groups, one
       for each	layer, which are associated with layers	by default. With
       "UseOpsworksSecurityGroups" you can instead provide your	own custom
       security	groups.	"UseOpsworksSecurityGroups" has	the following
       settings:

       o   True	- AWS OpsWorks automatically associates	the appropriate	built-
	   in security group with each layer (default setting).	You can
	   associate additional	security groups	with a layer after you create
	   it, but you cannot delete the built-in security group.

       o   False - AWS OpsWorks	does not associate built-in security groups
	   with	layers.	You must create	appropriate EC2	security groups	and
	   associate a security	group with each	layer that you create.
	   However, you	can still manually associate a built-in	security group
	   with	a layer	on creation; custom security groups are	required only
	   for those layers that need custom settings.

       For more	information, see Create	a New Stack.

   VpcId => Str
       The ID of the VPC that the stack	is to be launched into.	The VPC	must
       be in the stack's region. All instances are launched into this VPC. You
       cannot change the ID later.

       o   If your account supports EC2-Classic, the default value is "no
	   VPC".

       o   If your account does	not support EC2-Classic, the default value is
	   the default VPC for the specified region.

       If the VPC ID corresponds to a default VPC and you have specified
       either the "DefaultAvailabilityZone" or the "DefaultSubnetId" parameter
       only, AWS OpsWorks infers the value of the other	parameter.  If you
       specify neither parameter, AWS OpsWorks sets these parameters to	the
       first valid Availability	Zone for the specified region and the
       corresponding default VPC subnet	ID, respectively.

       If you specify a	nondefault VPC ID, note	the following:

       o   It must belong to a VPC in your account that	is in the specified
	   region.

       o   You must specify a value for	"DefaultSubnetId".

       For more	information on how to use AWS OpsWorks with a VPC, see Running
       a Stack in a VPC. For more information on default VPC and EC2-Classic,
       see Supported Platforms.

SEE ALSO
       This class forms	part of	Paws, documenting arguments for	method
       CreateStack in Paws::OpsWorks

BUGS and CONTRIBUTIONS
       The source code is located here:	https://github.com/pplu/aws-sdk-perl

       Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues

perl v5.24.1			  2015-08-06	Paws::OpsWorks::CreateStack(3)

NAME | DESCRIPTION | ATTRIBUTES | SEE ALSO | BUGS and CONTRIBUTIONS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Paws::OpsWorks::CreateStack&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help