github.com/rhenning/terraform@v0.8.0-beta2/builtin/providers/aws/provider.go (about)

     1  package aws
     2  
     3  import (
     4  	"bytes"
     5  	"fmt"
     6  	"log"
     7  
     8  	"github.com/hashicorp/terraform/helper/hashcode"
     9  	"github.com/hashicorp/terraform/helper/mutexkv"
    10  	"github.com/hashicorp/terraform/helper/schema"
    11  	"github.com/hashicorp/terraform/terraform"
    12  )
    13  
    14  // Provider returns a terraform.ResourceProvider.
    15  func Provider() terraform.ResourceProvider {
    16  	// TODO: Move the validation to this, requires conditional schemas
    17  	// TODO: Move the configuration to this, requires validation
    18  
    19  	// The actual provider
    20  	return &schema.Provider{
    21  		Schema: map[string]*schema.Schema{
    22  			"access_key": {
    23  				Type:        schema.TypeString,
    24  				Optional:    true,
    25  				Default:     "",
    26  				Description: descriptions["access_key"],
    27  			},
    28  
    29  			"secret_key": {
    30  				Type:        schema.TypeString,
    31  				Optional:    true,
    32  				Default:     "",
    33  				Description: descriptions["secret_key"],
    34  			},
    35  
    36  			"profile": {
    37  				Type:        schema.TypeString,
    38  				Optional:    true,
    39  				Default:     "",
    40  				Description: descriptions["profile"],
    41  			},
    42  
    43  			"assume_role": assumeRoleSchema(),
    44  
    45  			"shared_credentials_file": {
    46  				Type:        schema.TypeString,
    47  				Optional:    true,
    48  				Default:     "",
    49  				Description: descriptions["shared_credentials_file"],
    50  			},
    51  
    52  			"token": {
    53  				Type:        schema.TypeString,
    54  				Optional:    true,
    55  				Default:     "",
    56  				Description: descriptions["token"],
    57  			},
    58  
    59  			"region": {
    60  				Type:     schema.TypeString,
    61  				Required: true,
    62  				DefaultFunc: schema.MultiEnvDefaultFunc([]string{
    63  					"AWS_REGION",
    64  					"AWS_DEFAULT_REGION",
    65  				}, nil),
    66  				Description:  descriptions["region"],
    67  				InputDefault: "us-east-1",
    68  			},
    69  
    70  			"max_retries": {
    71  				Type:        schema.TypeInt,
    72  				Optional:    true,
    73  				Default:     11,
    74  				Description: descriptions["max_retries"],
    75  			},
    76  
    77  			"allowed_account_ids": {
    78  				Type:          schema.TypeSet,
    79  				Elem:          &schema.Schema{Type: schema.TypeString},
    80  				Optional:      true,
    81  				ConflictsWith: []string{"forbidden_account_ids"},
    82  				Set:           schema.HashString,
    83  			},
    84  
    85  			"forbidden_account_ids": {
    86  				Type:          schema.TypeSet,
    87  				Elem:          &schema.Schema{Type: schema.TypeString},
    88  				Optional:      true,
    89  				ConflictsWith: []string{"allowed_account_ids"},
    90  				Set:           schema.HashString,
    91  			},
    92  
    93  			"dynamodb_endpoint": {
    94  				Type:        schema.TypeString,
    95  				Optional:    true,
    96  				Default:     "",
    97  				Description: descriptions["dynamodb_endpoint"],
    98  			},
    99  
   100  			"kinesis_endpoint": {
   101  				Type:        schema.TypeString,
   102  				Optional:    true,
   103  				Default:     "",
   104  				Description: descriptions["kinesis_endpoint"],
   105  			},
   106  
   107  			"endpoints": endpointsSchema(),
   108  
   109  			"insecure": {
   110  				Type:        schema.TypeBool,
   111  				Optional:    true,
   112  				Default:     false,
   113  				Description: descriptions["insecure"],
   114  			},
   115  
   116  			"skip_credentials_validation": {
   117  				Type:        schema.TypeBool,
   118  				Optional:    true,
   119  				Default:     false,
   120  				Description: descriptions["skip_credentials_validation"],
   121  			},
   122  
   123  			"skip_requesting_account_id": {
   124  				Type:        schema.TypeBool,
   125  				Optional:    true,
   126  				Default:     false,
   127  				Description: descriptions["skip_requesting_account_id"],
   128  			},
   129  
   130  			"skip_metadata_api_check": {
   131  				Type:        schema.TypeBool,
   132  				Optional:    true,
   133  				Default:     false,
   134  				Description: descriptions["skip_metadata_api_check"],
   135  			},
   136  
   137  			"s3_force_path_style": {
   138  				Type:        schema.TypeBool,
   139  				Optional:    true,
   140  				Default:     false,
   141  				Description: descriptions["s3_force_path_style"],
   142  			},
   143  		},
   144  
   145  		DataSourcesMap: map[string]*schema.Resource{
   146  			"aws_acm_certificate":          dataSourceAwsAcmCertificate(),
   147  			"aws_ami":                      dataSourceAwsAmi(),
   148  			"aws_availability_zone":        dataSourceAwsAvailabilityZone(),
   149  			"aws_availability_zones":       dataSourceAwsAvailabilityZones(),
   150  			"aws_billing_service_account":  dataSourceAwsBillingServiceAccount(),
   151  			"aws_caller_identity":          dataSourceAwsCallerIdentity(),
   152  			"aws_cloudformation_stack":     dataSourceAwsCloudFormationStack(),
   153  			"aws_ebs_volume":               dataSourceAwsEbsVolume(),
   154  			"aws_ecs_container_definition": dataSourceAwsEcsContainerDefinition(),
   155  			"aws_elb_service_account":      dataSourceAwsElbServiceAccount(),
   156  			"aws_iam_policy_document":      dataSourceAwsIamPolicyDocument(),
   157  			"aws_ip_ranges":                dataSourceAwsIPRanges(),
   158  			"aws_prefix_list":              dataSourceAwsPrefixList(),
   159  			"aws_redshift_service_account": dataSourceAwsRedshiftServiceAccount(),
   160  			"aws_region":                   dataSourceAwsRegion(),
   161  			"aws_s3_bucket_object":         dataSourceAwsS3BucketObject(),
   162  			"aws_subnet":                   dataSourceAwsSubnet(),
   163  			"aws_security_group":           dataSourceAwsSecurityGroup(),
   164  			"aws_vpc":                      dataSourceAwsVpc(),
   165  		},
   166  
   167  		ResourcesMap: map[string]*schema.Resource{
   168  			"aws_alb":                                      resourceAwsAlb(),
   169  			"aws_alb_listener":                             resourceAwsAlbListener(),
   170  			"aws_alb_listener_rule":                        resourceAwsAlbListenerRule(),
   171  			"aws_alb_target_group":                         resourceAwsAlbTargetGroup(),
   172  			"aws_alb_target_group_attachment":              resourceAwsAlbTargetGroupAttachment(),
   173  			"aws_ami":                                      resourceAwsAmi(),
   174  			"aws_ami_copy":                                 resourceAwsAmiCopy(),
   175  			"aws_ami_from_instance":                        resourceAwsAmiFromInstance(),
   176  			"aws_ami_launch_permission":                    resourceAwsAmiLaunchPermission(),
   177  			"aws_api_gateway_account":                      resourceAwsApiGatewayAccount(),
   178  			"aws_api_gateway_api_key":                      resourceAwsApiGatewayApiKey(),
   179  			"aws_api_gateway_authorizer":                   resourceAwsApiGatewayAuthorizer(),
   180  			"aws_api_gateway_base_path_mapping":            resourceAwsApiGatewayBasePathMapping(),
   181  			"aws_api_gateway_client_certificate":           resourceAwsApiGatewayClientCertificate(),
   182  			"aws_api_gateway_deployment":                   resourceAwsApiGatewayDeployment(),
   183  			"aws_api_gateway_domain_name":                  resourceAwsApiGatewayDomainName(),
   184  			"aws_api_gateway_integration":                  resourceAwsApiGatewayIntegration(),
   185  			"aws_api_gateway_integration_response":         resourceAwsApiGatewayIntegrationResponse(),
   186  			"aws_api_gateway_method":                       resourceAwsApiGatewayMethod(),
   187  			"aws_api_gateway_method_response":              resourceAwsApiGatewayMethodResponse(),
   188  			"aws_api_gateway_model":                        resourceAwsApiGatewayModel(),
   189  			"aws_api_gateway_resource":                     resourceAwsApiGatewayResource(),
   190  			"aws_api_gateway_rest_api":                     resourceAwsApiGatewayRestApi(),
   191  			"aws_app_cookie_stickiness_policy":             resourceAwsAppCookieStickinessPolicy(),
   192  			"aws_appautoscaling_target":                    resourceAwsAppautoscalingTarget(),
   193  			"aws_appautoscaling_policy":                    resourceAwsAppautoscalingPolicy(),
   194  			"aws_autoscaling_attachment":                   resourceAwsAutoscalingAttachment(),
   195  			"aws_autoscaling_group":                        resourceAwsAutoscalingGroup(),
   196  			"aws_autoscaling_notification":                 resourceAwsAutoscalingNotification(),
   197  			"aws_autoscaling_policy":                       resourceAwsAutoscalingPolicy(),
   198  			"aws_autoscaling_schedule":                     resourceAwsAutoscalingSchedule(),
   199  			"aws_cloudformation_stack":                     resourceAwsCloudFormationStack(),
   200  			"aws_cloudfront_distribution":                  resourceAwsCloudFrontDistribution(),
   201  			"aws_cloudfront_origin_access_identity":        resourceAwsCloudFrontOriginAccessIdentity(),
   202  			"aws_cloudtrail":                               resourceAwsCloudTrail(),
   203  			"aws_cloudwatch_event_rule":                    resourceAwsCloudWatchEventRule(),
   204  			"aws_cloudwatch_event_target":                  resourceAwsCloudWatchEventTarget(),
   205  			"aws_cloudwatch_log_group":                     resourceAwsCloudWatchLogGroup(),
   206  			"aws_cloudwatch_log_metric_filter":             resourceAwsCloudWatchLogMetricFilter(),
   207  			"aws_cloudwatch_log_stream":                    resourceAwsCloudWatchLogStream(),
   208  			"aws_cloudwatch_log_subscription_filter":       resourceAwsCloudwatchLogSubscriptionFilter(),
   209  			"aws_autoscaling_lifecycle_hook":               resourceAwsAutoscalingLifecycleHook(),
   210  			"aws_cloudwatch_metric_alarm":                  resourceAwsCloudWatchMetricAlarm(),
   211  			"aws_codedeploy_app":                           resourceAwsCodeDeployApp(),
   212  			"aws_codedeploy_deployment_group":              resourceAwsCodeDeployDeploymentGroup(),
   213  			"aws_codecommit_repository":                    resourceAwsCodeCommitRepository(),
   214  			"aws_codecommit_trigger":                       resourceAwsCodeCommitTrigger(),
   215  			"aws_customer_gateway":                         resourceAwsCustomerGateway(),
   216  			"aws_db_event_subscription":                    resourceAwsDbEventSubscription(),
   217  			"aws_db_instance":                              resourceAwsDbInstance(),
   218  			"aws_db_option_group":                          resourceAwsDbOptionGroup(),
   219  			"aws_db_parameter_group":                       resourceAwsDbParameterGroup(),
   220  			"aws_db_security_group":                        resourceAwsDbSecurityGroup(),
   221  			"aws_db_subnet_group":                          resourceAwsDbSubnetGroup(),
   222  			"aws_directory_service_directory":              resourceAwsDirectoryServiceDirectory(),
   223  			"aws_dynamodb_table":                           resourceAwsDynamoDbTable(),
   224  			"aws_ebs_volume":                               resourceAwsEbsVolume(),
   225  			"aws_ecr_repository":                           resourceAwsEcrRepository(),
   226  			"aws_ecr_repository_policy":                    resourceAwsEcrRepositoryPolicy(),
   227  			"aws_ecs_cluster":                              resourceAwsEcsCluster(),
   228  			"aws_ecs_service":                              resourceAwsEcsService(),
   229  			"aws_ecs_task_definition":                      resourceAwsEcsTaskDefinition(),
   230  			"aws_efs_file_system":                          resourceAwsEfsFileSystem(),
   231  			"aws_efs_mount_target":                         resourceAwsEfsMountTarget(),
   232  			"aws_eip":                                      resourceAwsEip(),
   233  			"aws_eip_association":                          resourceAwsEipAssociation(),
   234  			"aws_elasticache_cluster":                      resourceAwsElasticacheCluster(),
   235  			"aws_elasticache_parameter_group":              resourceAwsElasticacheParameterGroup(),
   236  			"aws_elasticache_replication_group":            resourceAwsElasticacheReplicationGroup(),
   237  			"aws_elasticache_security_group":               resourceAwsElasticacheSecurityGroup(),
   238  			"aws_elasticache_subnet_group":                 resourceAwsElasticacheSubnetGroup(),
   239  			"aws_elastic_beanstalk_application":            resourceAwsElasticBeanstalkApplication(),
   240  			"aws_elastic_beanstalk_configuration_template": resourceAwsElasticBeanstalkConfigurationTemplate(),
   241  			"aws_elastic_beanstalk_environment":            resourceAwsElasticBeanstalkEnvironment(),
   242  			"aws_elasticsearch_domain":                     resourceAwsElasticSearchDomain(),
   243  			"aws_elastictranscoder_pipeline":               resourceAwsElasticTranscoderPipeline(),
   244  			"aws_elastictranscoder_preset":                 resourceAwsElasticTranscoderPreset(),
   245  			"aws_elb":                                      resourceAwsElb(),
   246  			"aws_elb_attachment":                           resourceAwsElbAttachment(),
   247  			"aws_emr_cluster":                              resourceAwsEMRCluster(),
   248  			"aws_emr_instance_group":                       resourceAwsEMRInstanceGroup(),
   249  			"aws_flow_log":                                 resourceAwsFlowLog(),
   250  			"aws_glacier_vault":                            resourceAwsGlacierVault(),
   251  			"aws_iam_access_key":                           resourceAwsIamAccessKey(),
   252  			"aws_iam_account_password_policy":              resourceAwsIamAccountPasswordPolicy(),
   253  			"aws_iam_group_policy":                         resourceAwsIamGroupPolicy(),
   254  			"aws_iam_group":                                resourceAwsIamGroup(),
   255  			"aws_iam_group_membership":                     resourceAwsIamGroupMembership(),
   256  			"aws_iam_group_policy_attachment":              resourceAwsIamGroupPolicyAttachment(),
   257  			"aws_iam_instance_profile":                     resourceAwsIamInstanceProfile(),
   258  			"aws_iam_policy":                               resourceAwsIamPolicy(),
   259  			"aws_iam_policy_attachment":                    resourceAwsIamPolicyAttachment(),
   260  			"aws_iam_role_policy_attachment":               resourceAwsIamRolePolicyAttachment(),
   261  			"aws_iam_role_policy":                          resourceAwsIamRolePolicy(),
   262  			"aws_iam_role":                                 resourceAwsIamRole(),
   263  			"aws_iam_saml_provider":                        resourceAwsIamSamlProvider(),
   264  			"aws_iam_server_certificate":                   resourceAwsIAMServerCertificate(),
   265  			"aws_iam_user_policy_attachment":               resourceAwsIamUserPolicyAttachment(),
   266  			"aws_iam_user_policy":                          resourceAwsIamUserPolicy(),
   267  			"aws_iam_user_ssh_key":                         resourceAwsIamUserSshKey(),
   268  			"aws_iam_user":                                 resourceAwsIamUser(),
   269  			"aws_iam_user_login_profile":                   resourceAwsIamUserLoginProfile(),
   270  			"aws_instance":                                 resourceAwsInstance(),
   271  			"aws_internet_gateway":                         resourceAwsInternetGateway(),
   272  			"aws_key_pair":                                 resourceAwsKeyPair(),
   273  			"aws_kinesis_firehose_delivery_stream":         resourceAwsKinesisFirehoseDeliveryStream(),
   274  			"aws_kinesis_stream":                           resourceAwsKinesisStream(),
   275  			"aws_kms_alias":                                resourceAwsKmsAlias(),
   276  			"aws_kms_key":                                  resourceAwsKmsKey(),
   277  			"aws_lambda_function":                          resourceAwsLambdaFunction(),
   278  			"aws_lambda_event_source_mapping":              resourceAwsLambdaEventSourceMapping(),
   279  			"aws_lambda_alias":                             resourceAwsLambdaAlias(),
   280  			"aws_lambda_permission":                        resourceAwsLambdaPermission(),
   281  			"aws_launch_configuration":                     resourceAwsLaunchConfiguration(),
   282  			"aws_lb_cookie_stickiness_policy":              resourceAwsLBCookieStickinessPolicy(),
   283  			"aws_load_balancer_policy":                     resourceAwsLoadBalancerPolicy(),
   284  			"aws_load_balancer_backend_server_policy":      resourceAwsLoadBalancerBackendServerPolicies(),
   285  			"aws_load_balancer_listener_policy":            resourceAwsLoadBalancerListenerPolicies(),
   286  			"aws_lb_ssl_negotiation_policy":                resourceAwsLBSSLNegotiationPolicy(),
   287  			"aws_main_route_table_association":             resourceAwsMainRouteTableAssociation(),
   288  			"aws_nat_gateway":                              resourceAwsNatGateway(),
   289  			"aws_network_acl":                              resourceAwsNetworkAcl(),
   290  			"aws_default_network_acl":                      resourceAwsDefaultNetworkAcl(),
   291  			"aws_default_route_table":                      resourceAwsDefaultRouteTable(),
   292  			"aws_network_acl_rule":                         resourceAwsNetworkAclRule(),
   293  			"aws_network_interface":                        resourceAwsNetworkInterface(),
   294  			"aws_opsworks_application":                     resourceAwsOpsworksApplication(),
   295  			"aws_opsworks_stack":                           resourceAwsOpsworksStack(),
   296  			"aws_opsworks_java_app_layer":                  resourceAwsOpsworksJavaAppLayer(),
   297  			"aws_opsworks_haproxy_layer":                   resourceAwsOpsworksHaproxyLayer(),
   298  			"aws_opsworks_static_web_layer":                resourceAwsOpsworksStaticWebLayer(),
   299  			"aws_opsworks_php_app_layer":                   resourceAwsOpsworksPhpAppLayer(),
   300  			"aws_opsworks_rails_app_layer":                 resourceAwsOpsworksRailsAppLayer(),
   301  			"aws_opsworks_nodejs_app_layer":                resourceAwsOpsworksNodejsAppLayer(),
   302  			"aws_opsworks_memcached_layer":                 resourceAwsOpsworksMemcachedLayer(),
   303  			"aws_opsworks_mysql_layer":                     resourceAwsOpsworksMysqlLayer(),
   304  			"aws_opsworks_ganglia_layer":                   resourceAwsOpsworksGangliaLayer(),
   305  			"aws_opsworks_custom_layer":                    resourceAwsOpsworksCustomLayer(),
   306  			"aws_opsworks_instance":                        resourceAwsOpsworksInstance(),
   307  			"aws_opsworks_user_profile":                    resourceAwsOpsworksUserProfile(),
   308  			"aws_opsworks_permission":                      resourceAwsOpsworksPermission(),
   309  			"aws_placement_group":                          resourceAwsPlacementGroup(),
   310  			"aws_proxy_protocol_policy":                    resourceAwsProxyProtocolPolicy(),
   311  			"aws_rds_cluster":                              resourceAwsRDSCluster(),
   312  			"aws_rds_cluster_instance":                     resourceAwsRDSClusterInstance(),
   313  			"aws_rds_cluster_parameter_group":              resourceAwsRDSClusterParameterGroup(),
   314  			"aws_redshift_cluster":                         resourceAwsRedshiftCluster(),
   315  			"aws_redshift_security_group":                  resourceAwsRedshiftSecurityGroup(),
   316  			"aws_redshift_parameter_group":                 resourceAwsRedshiftParameterGroup(),
   317  			"aws_redshift_subnet_group":                    resourceAwsRedshiftSubnetGroup(),
   318  			"aws_route53_delegation_set":                   resourceAwsRoute53DelegationSet(),
   319  			"aws_route53_record":                           resourceAwsRoute53Record(),
   320  			"aws_route53_zone_association":                 resourceAwsRoute53ZoneAssociation(),
   321  			"aws_route53_zone":                             resourceAwsRoute53Zone(),
   322  			"aws_route53_health_check":                     resourceAwsRoute53HealthCheck(),
   323  			"aws_route":                                    resourceAwsRoute(),
   324  			"aws_route_table":                              resourceAwsRouteTable(),
   325  			"aws_route_table_association":                  resourceAwsRouteTableAssociation(),
   326  			"aws_ses_active_receipt_rule_set":              resourceAwsSesActiveReceiptRuleSet(),
   327  			"aws_ses_receipt_filter":                       resourceAwsSesReceiptFilter(),
   328  			"aws_ses_receipt_rule":                         resourceAwsSesReceiptRule(),
   329  			"aws_ses_receipt_rule_set":                     resourceAwsSesReceiptRuleSet(),
   330  			"aws_s3_bucket":                                resourceAwsS3Bucket(),
   331  			"aws_s3_bucket_policy":                         resourceAwsS3BucketPolicy(),
   332  			"aws_s3_bucket_object":                         resourceAwsS3BucketObject(),
   333  			"aws_s3_bucket_notification":                   resourceAwsS3BucketNotification(),
   334  			"aws_default_security_group":                   resourceAwsDefaultSecurityGroup(),
   335  			"aws_security_group":                           resourceAwsSecurityGroup(),
   336  			"aws_security_group_rule":                      resourceAwsSecurityGroupRule(),
   337  			"aws_simpledb_domain":                          resourceAwsSimpleDBDomain(),
   338  			"aws_ssm_activation":                           resourceAwsSsmActivation(),
   339  			"aws_ssm_association":                          resourceAwsSsmAssociation(),
   340  			"aws_ssm_document":                             resourceAwsSsmDocument(),
   341  			"aws_spot_datafeed_subscription":               resourceAwsSpotDataFeedSubscription(),
   342  			"aws_spot_instance_request":                    resourceAwsSpotInstanceRequest(),
   343  			"aws_spot_fleet_request":                       resourceAwsSpotFleetRequest(),
   344  			"aws_sqs_queue":                                resourceAwsSqsQueue(),
   345  			"aws_sqs_queue_policy":                         resourceAwsSqsQueuePolicy(),
   346  			"aws_sns_topic":                                resourceAwsSnsTopic(),
   347  			"aws_sns_topic_policy":                         resourceAwsSnsTopicPolicy(),
   348  			"aws_sns_topic_subscription":                   resourceAwsSnsTopicSubscription(),
   349  			"aws_subnet":                                   resourceAwsSubnet(),
   350  			"aws_volume_attachment":                        resourceAwsVolumeAttachment(),
   351  			"aws_vpc_dhcp_options_association":             resourceAwsVpcDhcpOptionsAssociation(),
   352  			"aws_vpc_dhcp_options":                         resourceAwsVpcDhcpOptions(),
   353  			"aws_vpc_peering_connection":                   resourceAwsVpcPeeringConnection(),
   354  			"aws_vpc":                                      resourceAwsVpc(),
   355  			"aws_vpc_endpoint":                             resourceAwsVpcEndpoint(),
   356  			"aws_vpn_connection":                           resourceAwsVpnConnection(),
   357  			"aws_vpn_connection_route":                     resourceAwsVpnConnectionRoute(),
   358  			"aws_vpn_gateway":                              resourceAwsVpnGateway(),
   359  			"aws_vpn_gateway_attachment":                   resourceAwsVpnGatewayAttachment(),
   360  			"aws_waf_byte_match_set":                       resourceAwsWafByteMatchSet(),
   361  			"aws_waf_ipset":                                resourceAwsWafIPSet(),
   362  			"aws_waf_rule":                                 resourceAwsWafRule(),
   363  			"aws_waf_size_constraint_set":                  resourceAwsWafSizeConstraintSet(),
   364  			"aws_waf_web_acl":                              resourceAwsWafWebAcl(),
   365  			"aws_waf_xss_match_set":                        resourceAwsWafXssMatchSet(),
   366  			"aws_waf_sql_injection_match_set":              resourceAwsWafSqlInjectionMatchSet(),
   367  		},
   368  		ConfigureFunc: providerConfigure,
   369  	}
   370  }
   371  
   372  var descriptions map[string]string
   373  
   374  func init() {
   375  	descriptions = map[string]string{
   376  		"region": "The region where AWS operations will take place. Examples\n" +
   377  			"are us-east-1, us-west-2, etc.",
   378  
   379  		"access_key": "The access key for API operations. You can retrieve this\n" +
   380  			"from the 'Security & Credentials' section of the AWS console.",
   381  
   382  		"secret_key": "The secret key for API operations. You can retrieve this\n" +
   383  			"from the 'Security & Credentials' section of the AWS console.",
   384  
   385  		"profile": "The profile for API operations. If not set, the default profile\n" +
   386  			"created with `aws configure` will be used.",
   387  
   388  		"shared_credentials_file": "The path to the shared credentials file. If not set\n" +
   389  			"this defaults to ~/.aws/credentials.",
   390  
   391  		"token": "session token. A session token is only required if you are\n" +
   392  			"using temporary security credentials.",
   393  
   394  		"max_retries": "The maximum number of times an AWS API request is\n" +
   395  			"being executed. If the API request still fails, an error is\n" +
   396  			"thrown.",
   397  
   398  		"dynamodb_endpoint": "Use this to override the default endpoint URL constructed from the `region`.\n" +
   399  			"It's typically used to connect to dynamodb-local.",
   400  
   401  		"kinesis_endpoint": "Use this to override the default endpoint URL constructed from the `region`.\n" +
   402  			"It's typically used to connect to kinesalite.",
   403  
   404  		"iam_endpoint": "Use this to override the default endpoint URL constructed from the `region`.\n",
   405  
   406  		"ec2_endpoint": "Use this to override the default endpoint URL constructed from the `region`.\n",
   407  
   408  		"elb_endpoint": "Use this to override the default endpoint URL constructed from the `region`.\n",
   409  
   410  		"s3_endpoint": "Use this to override the default endpoint URL constructed from the `region`.\n",
   411  
   412  		"insecure": "Explicitly allow the provider to perform \"insecure\" SSL requests. If omitted," +
   413  			"default value is `false`",
   414  
   415  		"skip_credentials_validation": "Skip the credentials validation via STS API. " +
   416  			"Used for AWS API implementations that do not have STS available/implemented.",
   417  
   418  		"skip_requesting_account_id": "Skip requesting the account ID. " +
   419  			"Used for AWS API implementations that do not have IAM/STS API and/or metadata API.",
   420  
   421  		"skip_medatadata_api_check": "Skip the AWS Metadata API check. " +
   422  			"Used for AWS API implementations that do not have a metadata api endpoint.",
   423  
   424  		"s3_force_path_style": "Set this to true to force the request to use path-style addressing,\n" +
   425  			"i.e., http://s3.amazonaws.com/BUCKET/KEY. By default, the S3 client will\n" +
   426  			"use virtual hosted bucket addressing when possible\n" +
   427  			"(http://BUCKET.s3.amazonaws.com/KEY). Specific to the Amazon S3 service.",
   428  
   429  		"assume_role_role_arn": "The ARN of an IAM role to assume prior to making API calls.",
   430  
   431  		"assume_role_session_name": "The session name to use when assuming the role. If omitted," +
   432  			" no session name is passed to the AssumeRole call.",
   433  
   434  		"assume_role_external_id": "The external ID to use when assuming the role. If omitted," +
   435  			" no external ID is passed to the AssumeRole call.",
   436  	}
   437  }
   438  
   439  func providerConfigure(d *schema.ResourceData) (interface{}, error) {
   440  	config := Config{
   441  		AccessKey:               d.Get("access_key").(string),
   442  		SecretKey:               d.Get("secret_key").(string),
   443  		Profile:                 d.Get("profile").(string),
   444  		CredsFilename:           d.Get("shared_credentials_file").(string),
   445  		Token:                   d.Get("token").(string),
   446  		Region:                  d.Get("region").(string),
   447  		MaxRetries:              d.Get("max_retries").(int),
   448  		DynamoDBEndpoint:        d.Get("dynamodb_endpoint").(string),
   449  		KinesisEndpoint:         d.Get("kinesis_endpoint").(string),
   450  		Insecure:                d.Get("insecure").(bool),
   451  		SkipCredsValidation:     d.Get("skip_credentials_validation").(bool),
   452  		SkipRequestingAccountId: d.Get("skip_requesting_account_id").(bool),
   453  		SkipMetadataApiCheck:    d.Get("skip_metadata_api_check").(bool),
   454  		S3ForcePathStyle:        d.Get("s3_force_path_style").(bool),
   455  	}
   456  
   457  	assumeRoleList := d.Get("assume_role").(*schema.Set).List()
   458  	if len(assumeRoleList) == 1 {
   459  		assumeRole := assumeRoleList[0].(map[string]interface{})
   460  		config.AssumeRoleARN = assumeRole["role_arn"].(string)
   461  		config.AssumeRoleSessionName = assumeRole["session_name"].(string)
   462  		config.AssumeRoleExternalID = assumeRole["external_id"].(string)
   463  		log.Printf("[INFO] assume_role configuration set: (ARN: %q, SessionID: %q, ExternalID: %q)",
   464  			config.AssumeRoleARN, config.AssumeRoleSessionName, config.AssumeRoleExternalID)
   465  	} else {
   466  		log.Printf("[INFO] No assume_role block read from configuration")
   467  	}
   468  
   469  	endpointsSet := d.Get("endpoints").(*schema.Set)
   470  
   471  	for _, endpointsSetI := range endpointsSet.List() {
   472  		endpoints := endpointsSetI.(map[string]interface{})
   473  		config.IamEndpoint = endpoints["iam"].(string)
   474  		config.Ec2Endpoint = endpoints["ec2"].(string)
   475  		config.ElbEndpoint = endpoints["elb"].(string)
   476  		config.S3Endpoint = endpoints["s3"].(string)
   477  	}
   478  
   479  	if v, ok := d.GetOk("allowed_account_ids"); ok {
   480  		config.AllowedAccountIds = v.(*schema.Set).List()
   481  	}
   482  
   483  	if v, ok := d.GetOk("forbidden_account_ids"); ok {
   484  		config.ForbiddenAccountIds = v.(*schema.Set).List()
   485  	}
   486  
   487  	return config.Client()
   488  }
   489  
   490  // This is a global MutexKV for use within this plugin.
   491  var awsMutexKV = mutexkv.NewMutexKV()
   492  
   493  func assumeRoleSchema() *schema.Schema {
   494  	return &schema.Schema{
   495  		Type:     schema.TypeSet,
   496  		Optional: true,
   497  		MaxItems: 1,
   498  		Elem: &schema.Resource{
   499  			Schema: map[string]*schema.Schema{
   500  				"role_arn": {
   501  					Type:        schema.TypeString,
   502  					Optional:    true,
   503  					Description: descriptions["assume_role_role_arn"],
   504  				},
   505  
   506  				"session_name": {
   507  					Type:        schema.TypeString,
   508  					Optional:    true,
   509  					Description: descriptions["assume_role_session_name"],
   510  				},
   511  
   512  				"external_id": {
   513  					Type:        schema.TypeString,
   514  					Optional:    true,
   515  					Description: descriptions["assume_role_external_id"],
   516  				},
   517  			},
   518  		},
   519  		Set: assumeRoleToHash,
   520  	}
   521  }
   522  
   523  func assumeRoleToHash(v interface{}) int {
   524  	var buf bytes.Buffer
   525  	m := v.(map[string]interface{})
   526  	buf.WriteString(fmt.Sprintf("%s-", m["role_arn"].(string)))
   527  	buf.WriteString(fmt.Sprintf("%s-", m["session_name"].(string)))
   528  	buf.WriteString(fmt.Sprintf("%s-", m["external_id"].(string)))
   529  	return hashcode.String(buf.String())
   530  }
   531  
   532  func endpointsSchema() *schema.Schema {
   533  	return &schema.Schema{
   534  		Type:     schema.TypeSet,
   535  		Optional: true,
   536  		Elem: &schema.Resource{
   537  			Schema: map[string]*schema.Schema{
   538  				"iam": {
   539  					Type:        schema.TypeString,
   540  					Optional:    true,
   541  					Default:     "",
   542  					Description: descriptions["iam_endpoint"],
   543  				},
   544  
   545  				"ec2": {
   546  					Type:        schema.TypeString,
   547  					Optional:    true,
   548  					Default:     "",
   549  					Description: descriptions["ec2_endpoint"],
   550  				},
   551  
   552  				"elb": {
   553  					Type:        schema.TypeString,
   554  					Optional:    true,
   555  					Default:     "",
   556  					Description: descriptions["elb_endpoint"],
   557  				},
   558  				"s3": {
   559  					Type:        schema.TypeString,
   560  					Optional:    true,
   561  					Default:     "",
   562  					Description: descriptions["s3_endpoint"],
   563  				},
   564  			},
   565  		},
   566  		Set: endpointsToHash,
   567  	}
   568  }
   569  
   570  func endpointsToHash(v interface{}) int {
   571  	var buf bytes.Buffer
   572  	m := v.(map[string]interface{})
   573  	buf.WriteString(fmt.Sprintf("%s-", m["iam"].(string)))
   574  	buf.WriteString(fmt.Sprintf("%s-", m["ec2"].(string)))
   575  	buf.WriteString(fmt.Sprintf("%s-", m["elb"].(string)))
   576  	buf.WriteString(fmt.Sprintf("%s-", m["s3"].(string)))
   577  
   578  	return hashcode.String(buf.String())
   579  }