Use-CfnGetAZsFunction

NAME Use-CfnGetAZsFunction



SYNOPSIS

The intrinsic function Fn::GetAZs returns an array that lists Availability Zones for a specified region.





SYNTAX

Use-CfnGetAZsFunction [[-Region] <Object>] [<CommonParameters>]





DESCRIPTION

Because customers have access to different Availability Zones, the intrinsic function Fn::GetAZs enables template

authors to write templates that adapt to the calling user's access. That way you don't have to hard-code a full

list of Availability Zones for a specified region.



Note

For the EC2-Classic platform, the Fn::GetAZs function returns all Availability Zones for a region. For the EC2-VPC

platform, the Fn::GetAZs function returns only Availability Zones that have a default subnet unless none of the

Availability Zones has a default subnet; in that case, all Availability Zones are returned.



IAM permissions



The permissions that you need in order to use the Fn::GetAZs function depend on the platform in which you're

launching Amazon EC2 instances. For both platforms, you need permissions to the Amazon EC2

DescribeAvailabilityZones and DescribeAccountAttributes actions. For EC2-VPC, you also need permissions to the

Amazon EC2 DescribeSubnets action.





PARAMETERS

-Region <Object>



Required? false

Position? 1

Default value

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS





RELATED LINKS

http://docs.aws.amazon.com/AWSCloudForm ... yzones.htm

l