aws-sdk-euca 1.8.5
Sign up to get free protection for your applications and to get access to all the features.
- data/.yardopts +5 -0
- data/LICENSE.txt +12 -0
- data/README.rdoc +189 -0
- data/ca-bundle.crt +3895 -0
- data/lib/aws-sdk-euca.rb +79 -0
- data/lib/aws-sdk.rb +79 -0
- data/lib/aws.rb +14 -0
- data/lib/aws/api_config/AutoScaling-2011-01-01.yml +825 -0
- data/lib/aws/api_config/CloudFormation-2010-05-15.yml +322 -0
- data/lib/aws/api_config/CloudFront-2012-05-05.yml +2102 -0
- data/lib/aws/api_config/CloudSearch-2011-02-01.yml +681 -0
- data/lib/aws/api_config/CloudWatch-2010-08-01.yml +433 -0
- data/lib/aws/api_config/DataPipeline-2012-10-29.yml +422 -0
- data/lib/aws/api_config/DynamoDB-2011-12-05.yml +1160 -0
- data/lib/aws/api_config/EC2-2013-02-01.yml +4368 -0
- data/lib/aws/api_config/ELB-2012-06-01.yml +597 -0
- data/lib/aws/api_config/EMR-2009-03-31.yml +370 -0
- data/lib/aws/api_config/ElastiCache-2012-03-09.yml +777 -0
- data/lib/aws/api_config/ElastiCache-2012-11-15.yml +979 -0
- data/lib/aws/api_config/ElasticBeanstalk-2010-12-01.yml +823 -0
- data/lib/aws/api_config/ElasticTranscoder-2012-09-25.yml +1036 -0
- data/lib/aws/api_config/Glacier-2012-06-01.yml +618 -0
- data/lib/aws/api_config/IAM-2010-05-08.yml +1222 -0
- data/lib/aws/api_config/ImportExport-2010-06-01.yml +109 -0
- data/lib/aws/api_config/OpsWorks-2013-02-18.yml +1463 -0
- data/lib/aws/api_config/RDS-2012-09-17.yml +1861 -0
- data/lib/aws/api_config/RDS-2013-02-12.yml +2377 -0
- data/lib/aws/api_config/Redshift-2012-12-01.yml +1149 -0
- data/lib/aws/api_config/Route53-2012-02-29.yml +380 -0
- data/lib/aws/api_config/Route53-2012-12-12.yml +547 -0
- data/lib/aws/api_config/SNS-2010-03-31.yml +249 -0
- data/lib/aws/api_config/SQS-2012-11-05.yml +317 -0
- data/lib/aws/api_config/STS-2011-06-15.yml +81 -0
- data/lib/aws/api_config/SimpleDB-2009-04-15.yml +306 -0
- data/lib/aws/api_config/SimpleEmailService-2010-12-01.yml +346 -0
- data/lib/aws/api_config/SimpleWorkflow-2012-01-25.yml +2358 -0
- data/lib/aws/api_config/StorageGateway-2012-06-30.yml +748 -0
- data/lib/aws/auto_scaling.rb +164 -0
- data/lib/aws/auto_scaling/activity.rb +102 -0
- data/lib/aws/auto_scaling/activity_collection.rb +82 -0
- data/lib/aws/auto_scaling/client.rb +521 -0
- data/lib/aws/auto_scaling/config.rb +18 -0
- data/lib/aws/auto_scaling/errors.rb +22 -0
- data/lib/aws/auto_scaling/group.rb +420 -0
- data/lib/aws/auto_scaling/group_collection.rb +96 -0
- data/lib/aws/auto_scaling/group_options.rb +146 -0
- data/lib/aws/auto_scaling/instance.rb +192 -0
- data/lib/aws/auto_scaling/instance_collection.rb +63 -0
- data/lib/aws/auto_scaling/launch_configuration.rb +158 -0
- data/lib/aws/auto_scaling/launch_configuration_collection.rb +154 -0
- data/lib/aws/auto_scaling/notification_configuration.rb +89 -0
- data/lib/aws/auto_scaling/notification_configuration_collection.rb +184 -0
- data/lib/aws/auto_scaling/request.rb +29 -0
- data/lib/aws/auto_scaling/scaling_policy.rb +142 -0
- data/lib/aws/auto_scaling/scaling_policy_collection.rb +72 -0
- data/lib/aws/auto_scaling/scaling_policy_options.rb +64 -0
- data/lib/aws/auto_scaling/scheduled_action.rb +145 -0
- data/lib/aws/auto_scaling/scheduled_action_collection.rb +195 -0
- data/lib/aws/auto_scaling/tag.rb +59 -0
- data/lib/aws/auto_scaling/tag_collection.rb +112 -0
- data/lib/aws/cloud_formation.rb +272 -0
- data/lib/aws/cloud_formation/client.rb +369 -0
- data/lib/aws/cloud_formation/config.rb +18 -0
- data/lib/aws/cloud_formation/errors.rb +22 -0
- data/lib/aws/cloud_formation/request.rb +29 -0
- data/lib/aws/cloud_formation/stack.rb +255 -0
- data/lib/aws/cloud_formation/stack_collection.rb +209 -0
- data/lib/aws/cloud_formation/stack_event.rb +75 -0
- data/lib/aws/cloud_formation/stack_event_collection.rb +47 -0
- data/lib/aws/cloud_formation/stack_options.rb +72 -0
- data/lib/aws/cloud_formation/stack_output.rb +53 -0
- data/lib/aws/cloud_formation/stack_resource.rb +117 -0
- data/lib/aws/cloud_formation/stack_resource_collection.rb +84 -0
- data/lib/aws/cloud_formation/stack_resource_summary_collection.rb +64 -0
- data/lib/aws/cloud_formation/stack_summary_collection.rb +123 -0
- data/lib/aws/cloud_front.rb +73 -0
- data/lib/aws/cloud_front/client.rb +1307 -0
- data/lib/aws/cloud_front/config.rb +18 -0
- data/lib/aws/cloud_front/errors.rb +22 -0
- data/lib/aws/cloud_front/request.rb +44 -0
- data/lib/aws/cloud_search.rb +74 -0
- data/lib/aws/cloud_search/client.rb +558 -0
- data/lib/aws/cloud_search/config.rb +18 -0
- data/lib/aws/cloud_search/errors.rb +22 -0
- data/lib/aws/cloud_search/request.rb +23 -0
- data/lib/aws/cloud_watch.rb +119 -0
- data/lib/aws/cloud_watch/alarm.rb +272 -0
- data/lib/aws/cloud_watch/alarm_collection.rb +153 -0
- data/lib/aws/cloud_watch/alarm_history_item.rb +50 -0
- data/lib/aws/cloud_watch/alarm_history_item_collection.rb +84 -0
- data/lib/aws/cloud_watch/client.rb +247 -0
- data/lib/aws/cloud_watch/config.rb +18 -0
- data/lib/aws/cloud_watch/errors.rb +22 -0
- data/lib/aws/cloud_watch/metric.rb +135 -0
- data/lib/aws/cloud_watch/metric_alarm_collection.rb +160 -0
- data/lib/aws/cloud_watch/metric_collection.rb +131 -0
- data/lib/aws/cloud_watch/metric_statistics.rb +69 -0
- data/lib/aws/cloud_watch/request.rb +23 -0
- data/lib/aws/core.rb +587 -0
- data/lib/aws/core/async_handle.rb +90 -0
- data/lib/aws/core/autoloader.rb +64 -0
- data/lib/aws/core/cacheable.rb +78 -0
- data/lib/aws/core/client.rb +691 -0
- data/lib/aws/core/collection.rb +267 -0
- data/lib/aws/core/collection/simple.rb +82 -0
- data/lib/aws/core/collection/with_limit_and_next_token.rb +71 -0
- data/lib/aws/core/collection/with_next_token.rb +97 -0
- data/lib/aws/core/configuration.rb +546 -0
- data/lib/aws/core/credential_providers.rb +461 -0
- data/lib/aws/core/data.rb +247 -0
- data/lib/aws/core/http/curb_handler.rb +155 -0
- data/lib/aws/core/http/handler.rb +89 -0
- data/lib/aws/core/http/net_http_handler.rb +128 -0
- data/lib/aws/core/http/request.rb +263 -0
- data/lib/aws/core/http/response.rb +81 -0
- data/lib/aws/core/indifferent_hash.rb +88 -0
- data/lib/aws/core/inflection.rb +56 -0
- data/lib/aws/core/json_client.rb +47 -0
- data/lib/aws/core/json_parser.rb +76 -0
- data/lib/aws/core/json_request_builder.rb +35 -0
- data/lib/aws/core/json_response_parser.rb +79 -0
- data/lib/aws/core/lazy_error_classes.rb +90 -0
- data/lib/aws/core/log_formatter.rb +462 -0
- data/lib/aws/core/managed_file.rb +32 -0
- data/lib/aws/core/meta_utils.rb +45 -0
- data/lib/aws/core/model.rb +57 -0
- data/lib/aws/core/naming.rb +30 -0
- data/lib/aws/core/option_grammar.rb +735 -0
- data/lib/aws/core/options/json_serializer.rb +82 -0
- data/lib/aws/core/options/validator.rb +155 -0
- data/lib/aws/core/options/xml_serializer.rb +118 -0
- data/lib/aws/core/page_result.rb +75 -0
- data/lib/aws/core/policy.rb +916 -0
- data/lib/aws/core/query_client.rb +41 -0
- data/lib/aws/core/query_error_parser.rb +24 -0
- data/lib/aws/core/query_request_builder.rb +47 -0
- data/lib/aws/core/query_response_parser.rb +35 -0
- data/lib/aws/core/resource.rb +413 -0
- data/lib/aws/core/resource_cache.rb +40 -0
- data/lib/aws/core/response.rb +208 -0
- data/lib/aws/core/response_cache.rb +50 -0
- data/lib/aws/core/rest_error_parser.rb +24 -0
- data/lib/aws/core/rest_json_client.rb +40 -0
- data/lib/aws/core/rest_request_builder.rb +146 -0
- data/lib/aws/core/rest_response_parser.rb +66 -0
- data/lib/aws/core/rest_xml_client.rb +47 -0
- data/lib/aws/core/service_interface.rb +61 -0
- data/lib/aws/core/signature/version_2.rb +56 -0
- data/lib/aws/core/signature/version_3.rb +77 -0
- data/lib/aws/core/signature/version_3_https.rb +54 -0
- data/lib/aws/core/signature/version_4.rb +135 -0
- data/lib/aws/core/signer.rb +46 -0
- data/lib/aws/core/uri_escape.rb +44 -0
- data/lib/aws/core/xml/frame.rb +244 -0
- data/lib/aws/core/xml/frame_stack.rb +85 -0
- data/lib/aws/core/xml/grammar.rb +307 -0
- data/lib/aws/core/xml/parser.rb +70 -0
- data/lib/aws/core/xml/root_frame.rb +65 -0
- data/lib/aws/core/xml/sax_handlers/libxml.rb +47 -0
- data/lib/aws/core/xml/sax_handlers/nokogiri.rb +55 -0
- data/lib/aws/core/xml/sax_handlers/ox.rb +41 -0
- data/lib/aws/core/xml/sax_handlers/rexml.rb +43 -0
- data/lib/aws/core/xml/stub.rb +123 -0
- data/lib/aws/data_pipeline.rb +73 -0
- data/lib/aws/data_pipeline/client.rb +339 -0
- data/lib/aws/data_pipeline/config.rb +18 -0
- data/lib/aws/data_pipeline/errors.rb +20 -0
- data/lib/aws/data_pipeline/request.rb +26 -0
- data/lib/aws/dynamo_db.rb +206 -0
- data/lib/aws/dynamo_db/attribute_collection.rb +461 -0
- data/lib/aws/dynamo_db/batch_get.rb +213 -0
- data/lib/aws/dynamo_db/batch_write.rb +252 -0
- data/lib/aws/dynamo_db/binary.rb +35 -0
- data/lib/aws/dynamo_db/client.rb +904 -0
- data/lib/aws/dynamo_db/config.rb +24 -0
- data/lib/aws/dynamo_db/errors.rb +20 -0
- data/lib/aws/dynamo_db/expectations.rb +40 -0
- data/lib/aws/dynamo_db/item.rb +133 -0
- data/lib/aws/dynamo_db/item_collection.rb +852 -0
- data/lib/aws/dynamo_db/item_data.rb +31 -0
- data/lib/aws/dynamo_db/keys.rb +41 -0
- data/lib/aws/dynamo_db/primary_key_element.rb +48 -0
- data/lib/aws/dynamo_db/request.rb +26 -0
- data/lib/aws/dynamo_db/resource.rb +33 -0
- data/lib/aws/dynamo_db/table.rb +491 -0
- data/lib/aws/dynamo_db/table_collection.rb +165 -0
- data/lib/aws/dynamo_db/types.rb +111 -0
- data/lib/aws/ec2.rb +440 -0
- data/lib/aws/ec2/attachment.rb +140 -0
- data/lib/aws/ec2/attachment_collection.rb +54 -0
- data/lib/aws/ec2/availability_zone.rb +86 -0
- data/lib/aws/ec2/availability_zone_collection.rb +43 -0
- data/lib/aws/ec2/block_device_mappings.rb +53 -0
- data/lib/aws/ec2/client.rb +3621 -0
- data/lib/aws/ec2/collection.rb +36 -0
- data/lib/aws/ec2/config.rb +18 -0
- data/lib/aws/ec2/config_transform.rb +63 -0
- data/lib/aws/ec2/customer_gateway.rb +90 -0
- data/lib/aws/ec2/customer_gateway_collection.rb +73 -0
- data/lib/aws/ec2/dhcp_options.rb +106 -0
- data/lib/aws/ec2/dhcp_options_collection.rb +87 -0
- data/lib/aws/ec2/elastic_ip.rb +208 -0
- data/lib/aws/ec2/elastic_ip_collection.rb +97 -0
- data/lib/aws/ec2/errors.rb +32 -0
- data/lib/aws/ec2/export_task.rb +120 -0
- data/lib/aws/ec2/export_task_collection.rb +67 -0
- data/lib/aws/ec2/filtered_collection.rb +89 -0
- data/lib/aws/ec2/has_permissions.rb +44 -0
- data/lib/aws/ec2/image.rb +264 -0
- data/lib/aws/ec2/image_collection.rb +228 -0
- data/lib/aws/ec2/instance.rb +796 -0
- data/lib/aws/ec2/instance_collection.rb +372 -0
- data/lib/aws/ec2/internet_gateway.rb +122 -0
- data/lib/aws/ec2/internet_gateway/attachment.rb +78 -0
- data/lib/aws/ec2/internet_gateway_collection.rb +54 -0
- data/lib/aws/ec2/key_pair.rb +82 -0
- data/lib/aws/ec2/key_pair_collection.rb +99 -0
- data/lib/aws/ec2/network_acl.rb +256 -0
- data/lib/aws/ec2/network_acl/association.rb +56 -0
- data/lib/aws/ec2/network_acl/entry.rb +147 -0
- data/lib/aws/ec2/network_acl_collection.rb +64 -0
- data/lib/aws/ec2/network_interface.rb +228 -0
- data/lib/aws/ec2/network_interface/attachment.rb +100 -0
- data/lib/aws/ec2/network_interface_collection.rb +103 -0
- data/lib/aws/ec2/permission_collection.rb +174 -0
- data/lib/aws/ec2/region.rb +106 -0
- data/lib/aws/ec2/region_collection.rb +51 -0
- data/lib/aws/ec2/request.rb +21 -0
- data/lib/aws/ec2/reserved_instances.rb +56 -0
- data/lib/aws/ec2/reserved_instances_collection.rb +40 -0
- data/lib/aws/ec2/reserved_instances_offering.rb +60 -0
- data/lib/aws/ec2/reserved_instances_offering_collection.rb +39 -0
- data/lib/aws/ec2/resource.rb +161 -0
- data/lib/aws/ec2/resource_tag_collection.rb +211 -0
- data/lib/aws/ec2/route_table.rb +205 -0
- data/lib/aws/ec2/route_table/association.rb +119 -0
- data/lib/aws/ec2/route_table/route.rb +119 -0
- data/lib/aws/ec2/route_table_collection.rb +72 -0
- data/lib/aws/ec2/security_group.rb +484 -0
- data/lib/aws/ec2/security_group/ip_permission.rb +135 -0
- data/lib/aws/ec2/security_group/ip_permission_collection.rb +82 -0
- data/lib/aws/ec2/security_group_collection.rb +135 -0
- data/lib/aws/ec2/snapshot.rb +143 -0
- data/lib/aws/ec2/snapshot_collection.rb +132 -0
- data/lib/aws/ec2/subnet.rb +161 -0
- data/lib/aws/ec2/subnet_collection.rb +115 -0
- data/lib/aws/ec2/tag.rb +81 -0
- data/lib/aws/ec2/tag_collection.rb +107 -0
- data/lib/aws/ec2/tagged_collection.rb +53 -0
- data/lib/aws/ec2/tagged_item.rb +85 -0
- data/lib/aws/ec2/volume.rb +174 -0
- data/lib/aws/ec2/volume_collection.rb +101 -0
- data/lib/aws/ec2/vpc.rb +166 -0
- data/lib/aws/ec2/vpc_collection.rb +70 -0
- data/lib/aws/ec2/vpn_connection.rb +99 -0
- data/lib/aws/ec2/vpn_connection/telemetry.rb +49 -0
- data/lib/aws/ec2/vpn_connection_collection.rb +96 -0
- data/lib/aws/ec2/vpn_gateway.rb +123 -0
- data/lib/aws/ec2/vpn_gateway/attachment.rb +45 -0
- data/lib/aws/ec2/vpn_gateway_collection.rb +77 -0
- data/lib/aws/elastic_beanstalk.rb +50 -0
- data/lib/aws/elastic_beanstalk/client.rb +867 -0
- data/lib/aws/elastic_beanstalk/config.rb +18 -0
- data/lib/aws/elastic_beanstalk/errors.rb +22 -0
- data/lib/aws/elastic_beanstalk/request.rb +29 -0
- data/lib/aws/elastic_transcoder.rb +30 -0
- data/lib/aws/elastic_transcoder/client.rb +672 -0
- data/lib/aws/elastic_transcoder/config.rb +18 -0
- data/lib/aws/elastic_transcoder/errors.rb +23 -0
- data/lib/aws/elastic_transcoder/request.rb +30 -0
- data/lib/aws/elasticache.rb +50 -0
- data/lib/aws/elasticache/client.rb +920 -0
- data/lib/aws/elasticache/config.rb +18 -0
- data/lib/aws/elasticache/errors.rb +22 -0
- data/lib/aws/elasticache/request.rb +23 -0
- data/lib/aws/elb.rb +67 -0
- data/lib/aws/elb/availability_zone_collection.rb +138 -0
- data/lib/aws/elb/backend_server_policy_collection.rb +139 -0
- data/lib/aws/elb/client.rb +500 -0
- data/lib/aws/elb/config.rb +18 -0
- data/lib/aws/elb/errors.rb +26 -0
- data/lib/aws/elb/instance_collection.rb +173 -0
- data/lib/aws/elb/listener.rb +190 -0
- data/lib/aws/elb/listener_collection.rb +113 -0
- data/lib/aws/elb/listener_opts.rb +45 -0
- data/lib/aws/elb/load_balancer.rb +281 -0
- data/lib/aws/elb/load_balancer_collection.rb +134 -0
- data/lib/aws/elb/load_balancer_policy.rb +93 -0
- data/lib/aws/elb/load_balancer_policy_collection.rb +208 -0
- data/lib/aws/elb/request.rb +29 -0
- data/lib/aws/emr.rb +86 -0
- data/lib/aws/emr/client.rb +330 -0
- data/lib/aws/emr/config.rb +18 -0
- data/lib/aws/emr/errors.rb +22 -0
- data/lib/aws/emr/instance_group.rb +138 -0
- data/lib/aws/emr/instance_group_collection.rb +82 -0
- data/lib/aws/emr/job_flow.rb +306 -0
- data/lib/aws/emr/job_flow_collection.rb +185 -0
- data/lib/aws/emr/request.rb +23 -0
- data/lib/aws/errors.rb +162 -0
- data/lib/aws/glacier.rb +80 -0
- data/lib/aws/glacier/archive.rb +56 -0
- data/lib/aws/glacier/archive_collection.rb +146 -0
- data/lib/aws/glacier/client.rb +286 -0
- data/lib/aws/glacier/config.rb +19 -0
- data/lib/aws/glacier/errors.rb +22 -0
- data/lib/aws/glacier/request.rb +34 -0
- data/lib/aws/glacier/resource.rb +30 -0
- data/lib/aws/glacier/vault.rb +145 -0
- data/lib/aws/glacier/vault_collection.rb +75 -0
- data/lib/aws/glacier/vault_notification_configuration.rb +29 -0
- data/lib/aws/iam.rb +420 -0
- data/lib/aws/iam/access_key.rb +180 -0
- data/lib/aws/iam/access_key_collection.rb +128 -0
- data/lib/aws/iam/account_alias_collection.rb +79 -0
- data/lib/aws/iam/client.rb +1092 -0
- data/lib/aws/iam/collection.rb +83 -0
- data/lib/aws/iam/config.rb +18 -0
- data/lib/aws/iam/errors.rb +22 -0
- data/lib/aws/iam/group.rb +111 -0
- data/lib/aws/iam/group_collection.rb +132 -0
- data/lib/aws/iam/group_policy_collection.rb +47 -0
- data/lib/aws/iam/group_user_collection.rb +84 -0
- data/lib/aws/iam/login_profile.rb +99 -0
- data/lib/aws/iam/mfa_device.rb +52 -0
- data/lib/aws/iam/mfa_device_collection.rb +127 -0
- data/lib/aws/iam/policy.rb +46 -0
- data/lib/aws/iam/policy_collection.rb +188 -0
- data/lib/aws/iam/request.rb +29 -0
- data/lib/aws/iam/resource.rb +62 -0
- data/lib/aws/iam/server_certificate.rb +141 -0
- data/lib/aws/iam/server_certificate_collection.rb +138 -0
- data/lib/aws/iam/signing_certificate.rb +169 -0
- data/lib/aws/iam/signing_certificate_collection.rb +131 -0
- data/lib/aws/iam/user.rb +205 -0
- data/lib/aws/iam/user_collection.rb +133 -0
- data/lib/aws/iam/user_group_collection.rb +98 -0
- data/lib/aws/iam/user_policy.rb +90 -0
- data/lib/aws/iam/user_policy_collection.rb +45 -0
- data/lib/aws/iam/virtual_mfa_device.rb +139 -0
- data/lib/aws/iam/virtual_mfa_device_collection.rb +73 -0
- data/lib/aws/import_export.rb +73 -0
- data/lib/aws/import_export/client.rb +109 -0
- data/lib/aws/import_export/config.rb +19 -0
- data/lib/aws/import_export/errors.rb +22 -0
- data/lib/aws/import_export/request.rb +23 -0
- data/lib/aws/ops_works.rb +30 -0
- data/lib/aws/ops_works/client.rb +713 -0
- data/lib/aws/ops_works/config.rb +18 -0
- data/lib/aws/ops_works/errors.rb +20 -0
- data/lib/aws/ops_works/request.rb +27 -0
- data/lib/aws/rails.rb +195 -0
- data/lib/aws/rds.rb +71 -0
- data/lib/aws/rds/client.rb +2228 -0
- data/lib/aws/rds/config.rb +18 -0
- data/lib/aws/rds/db_instance.rb +205 -0
- data/lib/aws/rds/db_instance_collection.rb +75 -0
- data/lib/aws/rds/db_snapshot.rb +163 -0
- data/lib/aws/rds/db_snapshot_collection.rb +89 -0
- data/lib/aws/rds/errors.rb +22 -0
- data/lib/aws/rds/request.rb +23 -0
- data/lib/aws/record.rb +116 -0
- data/lib/aws/record/abstract_base.rb +701 -0
- data/lib/aws/record/attributes.rb +384 -0
- data/lib/aws/record/conversion.rb +38 -0
- data/lib/aws/record/dirty_tracking.rb +285 -0
- data/lib/aws/record/errors.rb +143 -0
- data/lib/aws/record/exceptions.rb +48 -0
- data/lib/aws/record/hash_model.rb +161 -0
- data/lib/aws/record/hash_model/attributes.rb +197 -0
- data/lib/aws/record/hash_model/finder_methods.rb +172 -0
- data/lib/aws/record/hash_model/scope.rb +108 -0
- data/lib/aws/record/model.rb +427 -0
- data/lib/aws/record/model/attributes.rb +379 -0
- data/lib/aws/record/model/finder_methods.rb +232 -0
- data/lib/aws/record/model/scope.rb +213 -0
- data/lib/aws/record/naming.rb +31 -0
- data/lib/aws/record/scope.rb +199 -0
- data/lib/aws/record/validations.rb +712 -0
- data/lib/aws/record/validator.rb +246 -0
- data/lib/aws/record/validators/acceptance.rb +51 -0
- data/lib/aws/record/validators/block.rb +38 -0
- data/lib/aws/record/validators/confirmation.rb +43 -0
- data/lib/aws/record/validators/count.rb +108 -0
- data/lib/aws/record/validators/exclusion.rb +43 -0
- data/lib/aws/record/validators/format.rb +57 -0
- data/lib/aws/record/validators/inclusion.rb +56 -0
- data/lib/aws/record/validators/length.rb +107 -0
- data/lib/aws/record/validators/method.rb +33 -0
- data/lib/aws/record/validators/numericality.rb +138 -0
- data/lib/aws/record/validators/presence.rb +45 -0
- data/lib/aws/redshift.rb +52 -0
- data/lib/aws/redshift/client.rb +1291 -0
- data/lib/aws/redshift/config.rb +18 -0
- data/lib/aws/redshift/errors.rb +22 -0
- data/lib/aws/redshift/request.rb +29 -0
- data/lib/aws/route_53.rb +87 -0
- data/lib/aws/route_53/change_batch.rb +159 -0
- data/lib/aws/route_53/change_info.rb +72 -0
- data/lib/aws/route_53/client.rb +387 -0
- data/lib/aws/route_53/config.rb +18 -0
- data/lib/aws/route_53/errors.rb +22 -0
- data/lib/aws/route_53/hosted_zone.rb +111 -0
- data/lib/aws/route_53/hosted_zone_collection.rb +100 -0
- data/lib/aws/route_53/request.rb +23 -0
- data/lib/aws/route_53/resource_record_set.rb +237 -0
- data/lib/aws/route_53/resource_record_set_collection.rb +110 -0
- data/lib/aws/s3.rb +155 -0
- data/lib/aws/s3/access_control_list.rb +257 -0
- data/lib/aws/s3/acl_object.rb +264 -0
- data/lib/aws/s3/acl_options.rb +204 -0
- data/lib/aws/s3/bucket.rb +742 -0
- data/lib/aws/s3/bucket_collection.rb +160 -0
- data/lib/aws/s3/bucket_lifecycle_configuration.rb +458 -0
- data/lib/aws/s3/bucket_tag_collection.rb +109 -0
- data/lib/aws/s3/bucket_version_collection.rb +77 -0
- data/lib/aws/s3/cipher_io.rb +119 -0
- data/lib/aws/s3/client.rb +1700 -0
- data/lib/aws/s3/client/xml.rb +231 -0
- data/lib/aws/s3/config.rb +36 -0
- data/lib/aws/s3/cors_rule.rb +106 -0
- data/lib/aws/s3/cors_rule_collection.rb +192 -0
- data/lib/aws/s3/data_options.rb +185 -0
- data/lib/aws/s3/encryption_utils.rb +139 -0
- data/lib/aws/s3/errors.rb +94 -0
- data/lib/aws/s3/multipart_upload.rb +320 -0
- data/lib/aws/s3/multipart_upload_collection.rb +68 -0
- data/lib/aws/s3/object_collection.rb +355 -0
- data/lib/aws/s3/object_metadata.rb +96 -0
- data/lib/aws/s3/object_upload_collection.rb +77 -0
- data/lib/aws/s3/object_version.rb +148 -0
- data/lib/aws/s3/object_version_collection.rb +89 -0
- data/lib/aws/s3/paginated_collection.rb +75 -0
- data/lib/aws/s3/policy.rb +74 -0
- data/lib/aws/s3/prefix_and_delimiter_collection.rb +47 -0
- data/lib/aws/s3/prefixed_collection.rb +81 -0
- data/lib/aws/s3/presigned_post.rb +555 -0
- data/lib/aws/s3/request.rb +201 -0
- data/lib/aws/s3/s3_object.rb +1690 -0
- data/lib/aws/s3/tree.rb +118 -0
- data/lib/aws/s3/tree/branch_node.rb +68 -0
- data/lib/aws/s3/tree/child_collection.rb +104 -0
- data/lib/aws/s3/tree/leaf_node.rb +94 -0
- data/lib/aws/s3/tree/node.rb +22 -0
- data/lib/aws/s3/tree/parent.rb +87 -0
- data/lib/aws/s3/uploaded_part.rb +80 -0
- data/lib/aws/s3/uploaded_part_collection.rb +84 -0
- data/lib/aws/s3/website_configuration.rb +102 -0
- data/lib/aws/simple_db.rb +219 -0
- data/lib/aws/simple_db/attribute.rb +154 -0
- data/lib/aws/simple_db/attribute_collection.rb +231 -0
- data/lib/aws/simple_db/client.rb +287 -0
- data/lib/aws/simple_db/config.rb +20 -0
- data/lib/aws/simple_db/consistent_read_option.rb +42 -0
- data/lib/aws/simple_db/delete_attributes.rb +62 -0
- data/lib/aws/simple_db/domain.rb +121 -0
- data/lib/aws/simple_db/domain_collection.rb +86 -0
- data/lib/aws/simple_db/domain_metadata.rb +110 -0
- data/lib/aws/simple_db/errors.rb +55 -0
- data/lib/aws/simple_db/expect_condition_option.rb +45 -0
- data/lib/aws/simple_db/item.rb +93 -0
- data/lib/aws/simple_db/item_collection.rb +649 -0
- data/lib/aws/simple_db/item_data.rb +73 -0
- data/lib/aws/simple_db/put_attributes.rb +60 -0
- data/lib/aws/simple_db/request.rb +23 -0
- data/lib/aws/simple_email_service.rb +428 -0
- data/lib/aws/simple_email_service/client.rb +276 -0
- data/lib/aws/simple_email_service/config.rb +19 -0
- data/lib/aws/simple_email_service/email_address_collection.rb +69 -0
- data/lib/aws/simple_email_service/errors.rb +22 -0
- data/lib/aws/simple_email_service/identity.rb +209 -0
- data/lib/aws/simple_email_service/identity_collection.rb +81 -0
- data/lib/aws/simple_email_service/quotas.rb +64 -0
- data/lib/aws/simple_email_service/request.rb +27 -0
- data/lib/aws/simple_workflow.rb +228 -0
- data/lib/aws/simple_workflow/activity_task.rb +173 -0
- data/lib/aws/simple_workflow/activity_task_collection.rb +123 -0
- data/lib/aws/simple_workflow/activity_type.rb +131 -0
- data/lib/aws/simple_workflow/activity_type_collection.rb +93 -0
- data/lib/aws/simple_workflow/client.rb +1204 -0
- data/lib/aws/simple_workflow/config.rb +18 -0
- data/lib/aws/simple_workflow/count.rb +49 -0
- data/lib/aws/simple_workflow/decision_task.rb +603 -0
- data/lib/aws/simple_workflow/decision_task_collection.rb +225 -0
- data/lib/aws/simple_workflow/domain.rb +122 -0
- data/lib/aws/simple_workflow/domain_collection.rb +169 -0
- data/lib/aws/simple_workflow/errors.rb +20 -0
- data/lib/aws/simple_workflow/history_event.rb +276 -0
- data/lib/aws/simple_workflow/history_event_collection.rb +76 -0
- data/lib/aws/simple_workflow/option_formatters.rb +82 -0
- data/lib/aws/simple_workflow/request.rb +33 -0
- data/lib/aws/simple_workflow/resource.rb +94 -0
- data/lib/aws/simple_workflow/type.rb +89 -0
- data/lib/aws/simple_workflow/type_collection.rb +140 -0
- data/lib/aws/simple_workflow/workflow_execution.rb +386 -0
- data/lib/aws/simple_workflow/workflow_execution_collection.rb +617 -0
- data/lib/aws/simple_workflow/workflow_type.rb +177 -0
- data/lib/aws/simple_workflow/workflow_type_collection.rb +91 -0
- data/lib/aws/sns.rb +76 -0
- data/lib/aws/sns/client.rb +266 -0
- data/lib/aws/sns/config.rb +18 -0
- data/lib/aws/sns/errors.rb +22 -0
- data/lib/aws/sns/has_delivery_policy.rb +68 -0
- data/lib/aws/sns/policy.rb +47 -0
- data/lib/aws/sns/request.rb +23 -0
- data/lib/aws/sns/subscription.rb +144 -0
- data/lib/aws/sns/subscription_collection.rb +78 -0
- data/lib/aws/sns/topic.rb +403 -0
- data/lib/aws/sns/topic_collection.rb +62 -0
- data/lib/aws/sns/topic_subscription_collection.rb +54 -0
- data/lib/aws/sqs.rb +81 -0
- data/lib/aws/sqs/client.rb +258 -0
- data/lib/aws/sqs/config.rb +18 -0
- data/lib/aws/sqs/errors.rb +101 -0
- data/lib/aws/sqs/policy.rb +48 -0
- data/lib/aws/sqs/queue.rb +764 -0
- data/lib/aws/sqs/queue_collection.rb +174 -0
- data/lib/aws/sqs/received_message.rb +181 -0
- data/lib/aws/sqs/received_sns_message.rb +116 -0
- data/lib/aws/sqs/request.rb +67 -0
- data/lib/aws/storage_gateway.rb +73 -0
- data/lib/aws/storage_gateway/client.rb +472 -0
- data/lib/aws/storage_gateway/config.rb +18 -0
- data/lib/aws/storage_gateway/errors.rb +22 -0
- data/lib/aws/storage_gateway/request.rb +28 -0
- data/lib/aws/sts.rb +163 -0
- data/lib/aws/sts/client.rb +157 -0
- data/lib/aws/sts/config.rb +18 -0
- data/lib/aws/sts/errors.rb +22 -0
- data/lib/aws/sts/federated_session.rb +56 -0
- data/lib/aws/sts/policy.rb +30 -0
- data/lib/aws/sts/request.rb +29 -0
- data/lib/aws/sts/session.rb +48 -0
- data/lib/aws/version.rb +18 -0
- data/lib/net/http/connection_pool.rb +226 -0
- data/lib/net/http/connection_pool/connection.rb +189 -0
- data/lib/net/http/connection_pool/session.rb +126 -0
- data/rails/init.rb +15 -0
- metadata +632 -0
@@ -0,0 +1,18 @@
|
|
1
|
+
# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
2
|
+
#
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License"). You
|
4
|
+
# may not use this file except in compliance with the License. A copy of
|
5
|
+
# the License is located at
|
6
|
+
#
|
7
|
+
# http://aws.amazon.com/apache2.0/
|
8
|
+
#
|
9
|
+
# or in the "license" file accompanying this file. This file is
|
10
|
+
# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
|
11
|
+
# ANY KIND, either express or implied. See the License for the specific
|
12
|
+
# language governing permissions and limitations under the License.
|
13
|
+
|
14
|
+
AWS::Core::Configuration.module_eval do
|
15
|
+
|
16
|
+
add_service 'SQS', 'sqs', 'sqs.us-east-1.amazonaws.com'
|
17
|
+
|
18
|
+
end
|
@@ -0,0 +1,101 @@
|
|
1
|
+
# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
2
|
+
#
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License"). You
|
4
|
+
# may not use this file except in compliance with the License. A copy of
|
5
|
+
# the License is located at
|
6
|
+
#
|
7
|
+
# http://aws.amazon.com/apache2.0/
|
8
|
+
#
|
9
|
+
# or in the "license" file accompanying this file. This file is
|
10
|
+
# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
|
11
|
+
# ANY KIND, either express or implied. See the License for the specific
|
12
|
+
# language governing permissions and limitations under the License.
|
13
|
+
|
14
|
+
module AWS
|
15
|
+
class SQS
|
16
|
+
module Errors
|
17
|
+
|
18
|
+
extend Core::LazyErrorClasses
|
19
|
+
|
20
|
+
# @private
|
21
|
+
def self.error_class(code)
|
22
|
+
super(code.sub(/^AWS\.SimpleQueueService\./, ''))
|
23
|
+
end
|
24
|
+
|
25
|
+
# Raised when one or more messages fail to delete during a
|
26
|
+
# batch delete operation.
|
27
|
+
#
|
28
|
+
# See {#failures} for a complete list of failures.
|
29
|
+
#
|
30
|
+
class BatchDeleteError < StandardError
|
31
|
+
|
32
|
+
def initialize failures
|
33
|
+
@failures = failures
|
34
|
+
super("Failed to delete #{failures.size} messages")
|
35
|
+
end
|
36
|
+
|
37
|
+
# @return [Array<Hash>] Returns a list of hashes. Each hash
|
38
|
+
# contains information about one message that failed to delete.
|
39
|
+
# Hash keys include:
|
40
|
+
#
|
41
|
+
# * +:error_code+
|
42
|
+
# * +:error_message+
|
43
|
+
# * +:sender_fault+
|
44
|
+
# * +:receipt_handle+
|
45
|
+
#
|
46
|
+
attr_reader :failures
|
47
|
+
|
48
|
+
end
|
49
|
+
|
50
|
+
# Raised from a batch change message visibility call when one or more
|
51
|
+
# of the updates fail.
|
52
|
+
#
|
53
|
+
# See {#failures} for a complete list of failures.
|
54
|
+
#
|
55
|
+
class BatchChangeVisibilityError < StandardError
|
56
|
+
|
57
|
+
def initialize failures
|
58
|
+
@failures = failures
|
59
|
+
super("Failed to change visibility for #{failures.size} messages")
|
60
|
+
end
|
61
|
+
|
62
|
+
# @return [Array<Hash>] Returns a list of hashes. Each hash
|
63
|
+
# contains information about one message that failed to change
|
64
|
+
# visibility. Hash keys include:
|
65
|
+
#
|
66
|
+
# * +:error_code+
|
67
|
+
# * +:error_message+
|
68
|
+
# * +:sender_fault+
|
69
|
+
# * +:receipt_handle+
|
70
|
+
#
|
71
|
+
attr_reader :failures
|
72
|
+
|
73
|
+
end
|
74
|
+
|
75
|
+
class BatchSendError < StandardError
|
76
|
+
|
77
|
+
def initialize sent, failures
|
78
|
+
@sent = sent
|
79
|
+
@failures = failures
|
80
|
+
super("Failed to send #{failures.size} messages")
|
81
|
+
end
|
82
|
+
|
83
|
+
# @return [Array<Queue::SentMessage>] Returns a list of
|
84
|
+
# {Queue::SentMessage} objects.
|
85
|
+
attr_reader :sent
|
86
|
+
|
87
|
+
# @return [Array<Hash>] Returns a list of hashes. Each hash
|
88
|
+
# contains information about one message that failed to change
|
89
|
+
# visibility. Hash keys include:
|
90
|
+
#
|
91
|
+
# * +:error_code+
|
92
|
+
# * +:error_message+
|
93
|
+
# * +:sender_fault+
|
94
|
+
# * +:receipt_handle+
|
95
|
+
#
|
96
|
+
attr_reader :failures
|
97
|
+
|
98
|
+
end
|
99
|
+
end
|
100
|
+
end
|
101
|
+
end
|
@@ -0,0 +1,48 @@
|
|
1
|
+
# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
2
|
+
#
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License"). You
|
4
|
+
# may not use this file except in compliance with the License. A copy of
|
5
|
+
# the License is located at
|
6
|
+
#
|
7
|
+
# http://aws.amazon.com/apache2.0/
|
8
|
+
#
|
9
|
+
# or in the "license" file accompanying this file. This file is
|
10
|
+
# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
|
11
|
+
# ANY KIND, either express or implied. See the License for the specific
|
12
|
+
# language governing permissions and limitations under the License.
|
13
|
+
|
14
|
+
module AWS
|
15
|
+
class SQS
|
16
|
+
|
17
|
+
# (see Core::Policy)
|
18
|
+
class Policy < Core::Policy
|
19
|
+
|
20
|
+
class Statement < Core::Policy::Statement
|
21
|
+
|
22
|
+
ACTION_MAPPING = {
|
23
|
+
:add_permission => 'sqs:AddPermission',
|
24
|
+
:change_message_visibility => 'sqs:ChangeMessageVisibility',
|
25
|
+
:create_queue => 'sqs:CreateQueue',
|
26
|
+
:delete_message => 'sqs:DeleteMessage',
|
27
|
+
:delete_queue => 'sqs:DeleteQueue',
|
28
|
+
:get_queue_attributes => 'sqs:GetQueueAttributes',
|
29
|
+
:list_queues => 'sqs:ListQueues',
|
30
|
+
:receive_message => 'sqs:ReceiveMessage',
|
31
|
+
:remove_permission => 'sqs:RemovePermission',
|
32
|
+
:send_message => 'sqs:SendMessage',
|
33
|
+
:set_queue_attributes => 'sqs:SetQueueAttributes',
|
34
|
+
}
|
35
|
+
|
36
|
+
protected
|
37
|
+
def resource_arn resource
|
38
|
+
case resource
|
39
|
+
when Queue then URI.parse(resource.url).path
|
40
|
+
else resource.to_s
|
41
|
+
end
|
42
|
+
end
|
43
|
+
|
44
|
+
end
|
45
|
+
|
46
|
+
end
|
47
|
+
end
|
48
|
+
end
|
@@ -0,0 +1,764 @@
|
|
1
|
+
# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
2
|
+
#
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License"). You
|
4
|
+
# may not use this file except in compliance with the License. A copy of
|
5
|
+
# the License is located at
|
6
|
+
#
|
7
|
+
# http://aws.amazon.com/apache2.0/
|
8
|
+
#
|
9
|
+
# or in the "license" file accompanying this file. This file is
|
10
|
+
# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
|
11
|
+
# ANY KIND, either express or implied. See the License for the specific
|
12
|
+
# language governing permissions and limitations under the License.
|
13
|
+
|
14
|
+
module AWS
|
15
|
+
class SQS
|
16
|
+
|
17
|
+
# Represents an Amazon SQS Queue.
|
18
|
+
#
|
19
|
+
# @example Sending a message
|
20
|
+
# msg = queue.send_message("HELLO")
|
21
|
+
# puts "Sent message: #{msg.id}"
|
22
|
+
#
|
23
|
+
# @example Polling for messages indefinitely
|
24
|
+
# queue.poll do |msg|
|
25
|
+
# puts "Got message: #{msg.body}"
|
26
|
+
# end
|
27
|
+
#
|
28
|
+
class Queue
|
29
|
+
|
30
|
+
# The default number of seconds to wait between polling requests for
|
31
|
+
# new messages.
|
32
|
+
# @deprecated No longer used by {#poll}
|
33
|
+
DEFAULT_POLL_INTERVAL = 1
|
34
|
+
|
35
|
+
# The default number of seconds to pass in as the SQS long polling
|
36
|
+
# value (+:wait_time_seconds+) in {#receive_message}.
|
37
|
+
#
|
38
|
+
# @since 1.8.0
|
39
|
+
DEFAULT_WAIT_TIME_SECONDS = 15
|
40
|
+
|
41
|
+
include Core::Model
|
42
|
+
|
43
|
+
# @return [String] The queue URL.
|
44
|
+
attr_reader :url
|
45
|
+
|
46
|
+
# @private
|
47
|
+
def initialize(url, opts = {})
|
48
|
+
@url = url
|
49
|
+
super
|
50
|
+
end
|
51
|
+
|
52
|
+
# Deletes the queue, regardless of whether it is empty.
|
53
|
+
#
|
54
|
+
# When you delete a queue, the deletion process takes up to 60
|
55
|
+
# seconds. Requests you send involving that queue during the
|
56
|
+
# 60 seconds might succeed. For example, calling
|
57
|
+
# {#send_message} might succeed, but after the 60 seconds, the
|
58
|
+
# queue and that message you sent no longer exist.
|
59
|
+
#
|
60
|
+
# Also, when you delete a queue, you must wait at least 60 seconds
|
61
|
+
# before creating a queue with the same name.
|
62
|
+
# @return [nil]
|
63
|
+
def delete
|
64
|
+
client.delete_queue(:queue_url => url)
|
65
|
+
nil
|
66
|
+
end
|
67
|
+
|
68
|
+
# Represents a message sent using {Queue#send_message}.
|
69
|
+
class SentMessage
|
70
|
+
|
71
|
+
# @return [String] Returns the message ID.
|
72
|
+
attr_accessor :message_id
|
73
|
+
|
74
|
+
alias_method :id, :message_id
|
75
|
+
|
76
|
+
# @return [String] Returns an MD5 digest of the message body
|
77
|
+
# string. You can use this to verify that SQS received your
|
78
|
+
# message correctly.
|
79
|
+
attr_accessor :md5
|
80
|
+
|
81
|
+
end
|
82
|
+
|
83
|
+
# Delivers a message to this queue.
|
84
|
+
#
|
85
|
+
# @param [String] body The message to send. The maximum
|
86
|
+
# allowed message size is 64 KB. The message may only
|
87
|
+
# contain Unicode characters from the following list,
|
88
|
+
# according to the W3C XML specification (for more
|
89
|
+
# information, go to
|
90
|
+
# http://www.w3.org/TR/REC-xml/#charsets). If you send any
|
91
|
+
# characters not included in the list, your request will be
|
92
|
+
# rejected.
|
93
|
+
#
|
94
|
+
# * #x9
|
95
|
+
# * #xA
|
96
|
+
# * #xD
|
97
|
+
# * #x20 to #xD7FF
|
98
|
+
# * #xE000 to #xFFFD
|
99
|
+
# * #x10000 to #x10FFFF
|
100
|
+
#
|
101
|
+
# @param [Hash] options
|
102
|
+
#
|
103
|
+
# @option options [Integer] :delay_seconds The number of seconds to
|
104
|
+
# delay the message. The message will become available for
|
105
|
+
# processing after the delay time has passed.
|
106
|
+
# If you don't specify a value, the default value for the
|
107
|
+
# queue applies. Should be from 0 to 900 (15 mins).
|
108
|
+
#
|
109
|
+
# @return [SentMessage] An object containing information about
|
110
|
+
# the message that was sent.
|
111
|
+
#
|
112
|
+
def send_message body, options = {}
|
113
|
+
|
114
|
+
client_opts = options.dup
|
115
|
+
client_opts[:queue_url] = url
|
116
|
+
client_opts[:message_body] = body
|
117
|
+
|
118
|
+
response = client.send_message(client_opts)
|
119
|
+
|
120
|
+
msg = SentMessage.new
|
121
|
+
msg.message_id = response[:message_id]
|
122
|
+
msg.md5 = response[:md5_of_message_body]
|
123
|
+
msg
|
124
|
+
|
125
|
+
end
|
126
|
+
|
127
|
+
# Retrieves one or more messages. When a block is given, each
|
128
|
+
# message is yielded to the block and then deleted as long as
|
129
|
+
# the block exits normally. When no block is given, you must
|
130
|
+
# delete the message yourself using {ReceivedMessage#delete}.
|
131
|
+
#
|
132
|
+
# @note Due to the distributed nature of the queue, a weighted
|
133
|
+
# random set of machines is sampled on a ReceiveMessage
|
134
|
+
# call. That means only the messages on the sampled machines
|
135
|
+
# are returned. If the number of messages in the queue is
|
136
|
+
# small (less than 1000), it is likely you will get fewer
|
137
|
+
# messages than you requested per call to
|
138
|
+
# {#receive_message}. If the number of messages in the queue
|
139
|
+
# is extremely small, you might not receive any messages.
|
140
|
+
# To poll continually for messages, use the {#poll} method,
|
141
|
+
# which automatically retries the request after a
|
142
|
+
# configurable delay.
|
143
|
+
#
|
144
|
+
# @param [Hash] opts Options for receiving messages.
|
145
|
+
#
|
146
|
+
# @option opts [Integer] :limit The maximum number of messages
|
147
|
+
# to receive. By default this is 1, and the return value is
|
148
|
+
# a single message object. If this options is specified and
|
149
|
+
# is not 1, the return value is an array of message objects;
|
150
|
+
# however, the array may contain fewer objects than you
|
151
|
+
# requested. Valid values: integers from 1 to 10.
|
152
|
+
#
|
153
|
+
# Not necessarily all the messages in the queue are returned
|
154
|
+
# (for more information, see the preceding note about
|
155
|
+
# machine sampling).
|
156
|
+
#
|
157
|
+
# @option opts [Integer] :wait_time_seconds The number of seconds
|
158
|
+
# the service should wait for a response when requesting a new message.
|
159
|
+
# Defaults to the {#wait_time_seconds} attribute defined on the queue.
|
160
|
+
# See {#wait_time_seconds} to set the global long poll setting
|
161
|
+
# on the queue.
|
162
|
+
#
|
163
|
+
# @option opts [Integer] :visibilitiy_timeout The duration (in
|
164
|
+
# seconds) that the received messages are hidden from
|
165
|
+
# subsequent retrieve requests. Valid values: integer from
|
166
|
+
# 0 to 43200 (maximum 12 hours)
|
167
|
+
#
|
168
|
+
# @option opts [Array<Symbol, String>] :attributes The
|
169
|
+
# attributes to populate in each received message. Valid values:
|
170
|
+
#
|
171
|
+
# * +:all+ (to populate all attributes)
|
172
|
+
# * +:sender_id+
|
173
|
+
# * +:sent_at+
|
174
|
+
# * +:receive_count+
|
175
|
+
# * +:first_received_at+
|
176
|
+
#
|
177
|
+
# See {ReceivedMessage} for documentation on each
|
178
|
+
# attribute's meaning.
|
179
|
+
#
|
180
|
+
# @yieldparam [ReceivedMessage] message Each message that was received.
|
181
|
+
#
|
182
|
+
# @return [ReceivedMessage] Returns the received message (or messages)
|
183
|
+
# only if a block is not given to this method.
|
184
|
+
#
|
185
|
+
def receive_message(opts = {}, &block)
|
186
|
+
resp = client.receive_message(receive_opts(opts))
|
187
|
+
|
188
|
+
messages = resp[:messages].map do |m|
|
189
|
+
ReceivedMessage.new(self, m[:message_id], m[:receipt_handle],
|
190
|
+
:body => m[:body],
|
191
|
+
:md5 => m[:md5_of_body],
|
192
|
+
:attributes => m[:attributes])
|
193
|
+
end
|
194
|
+
|
195
|
+
if block
|
196
|
+
call_message_block(messages, block)
|
197
|
+
elsif opts[:limit] && opts[:limit] != 1
|
198
|
+
messages
|
199
|
+
else
|
200
|
+
messages.first
|
201
|
+
end
|
202
|
+
end
|
203
|
+
alias_method :receive_messages, :receive_message
|
204
|
+
|
205
|
+
# Polls continually for messages. For example, you can use
|
206
|
+
# this to poll indefinitely:
|
207
|
+
#
|
208
|
+
# queue.poll { |msg| puts msg.body }
|
209
|
+
#
|
210
|
+
# Or, to poll indefinitely for the first message and then
|
211
|
+
# continue polling until no message is received for a period
|
212
|
+
# of at least ten seconds:
|
213
|
+
#
|
214
|
+
# queue.poll(:initial_timeout => false,
|
215
|
+
# :idle_timeout => 10) { |msg| puts msg.body }
|
216
|
+
#
|
217
|
+
# As with the block form of {#receive_message}, this method
|
218
|
+
# automatically deletes the message then the block exits
|
219
|
+
# normally.
|
220
|
+
#
|
221
|
+
# @yieldparam [ReceivedMessage] message Each message that was received.
|
222
|
+
#
|
223
|
+
# @param [Hash] opts Options for polling.
|
224
|
+
#
|
225
|
+
# @option opts [Integer] :wait_time_seconds The number of seconds
|
226
|
+
# the service should wait for a response when requesting a new message.
|
227
|
+
# Defaults to {DEFAULT_WAIT_TIME_SECONDS}. Use +nil+ to
|
228
|
+
# use the queue's global long polling wait time setting.
|
229
|
+
# See {#wait_time_seconds} to set the global long poll setting
|
230
|
+
# on the queue.
|
231
|
+
#
|
232
|
+
# @option opts [Integer] :idle_timeout The maximum number of
|
233
|
+
# seconds to spend polling while no messages are being
|
234
|
+
# returned. By default this method polls indefinitely
|
235
|
+
# whether messages are received or not.
|
236
|
+
#
|
237
|
+
# @option opts [Integer] :initial_timeout The maximum number
|
238
|
+
# of seconds to spend polling before the first message is
|
239
|
+
# received. This option defaults to the value of
|
240
|
+
# +:idle_timeout+. You can specify +false+ to poll
|
241
|
+
# indefinitely for the first message when +:idle_timeout+ is
|
242
|
+
# set.
|
243
|
+
#
|
244
|
+
# @option opts [Integer] :batch_size The maximum number of
|
245
|
+
# messages to retrieve in a single request. By default
|
246
|
+
# messages are received one at a time. Valid values:
|
247
|
+
# integers from 1 to 10.
|
248
|
+
#
|
249
|
+
# @option opts [Integer] :visibilitiy_timeout The duration (in
|
250
|
+
# seconds) that the received messages are hidden from
|
251
|
+
# subsequent retrieve requests. Valid values: integer from
|
252
|
+
# 0 to 43200 (maximum 12 hours)
|
253
|
+
#
|
254
|
+
# @option opts [Array<Symbol, String>] :attributes The
|
255
|
+
# attributes to populate in each received message. Valid values:
|
256
|
+
#
|
257
|
+
# * +:all+ (to populate all attributes)
|
258
|
+
# * +:sender_id+
|
259
|
+
# * +:sent_at+
|
260
|
+
# * +:receive_count+
|
261
|
+
# * +:first_received_at+
|
262
|
+
#
|
263
|
+
# See {ReceivedMessage} for documentation on each
|
264
|
+
# attribute's meaning.
|
265
|
+
#
|
266
|
+
# @option opts [Float, Integer] :poll_interval As of
|
267
|
+
# v1.7.2, this option is no longer used. See the
|
268
|
+
# +:wait_time_seconds+ option for long polling instead.
|
269
|
+
#
|
270
|
+
# @return [nil]
|
271
|
+
def poll(opts = {}, &block)
|
272
|
+
opts[:limit] = opts.delete(:batch_size) if
|
273
|
+
opts.key?(:batch_size)
|
274
|
+
|
275
|
+
opts[:wait_time_seconds] = DEFAULT_WAIT_TIME_SECONDS unless
|
276
|
+
opts.has_key?(:wait_time_seconds)
|
277
|
+
|
278
|
+
last_message_at = Time.now
|
279
|
+
got_first = false
|
280
|
+
loop do
|
281
|
+
got_msg = false
|
282
|
+
receive_messages(opts) do |message|
|
283
|
+
got_msg = got_first = true
|
284
|
+
last_message_at = Time.now
|
285
|
+
yield(message)
|
286
|
+
end
|
287
|
+
unless got_msg
|
288
|
+
return if hit_timeout?(got_first, last_message_at, opts)
|
289
|
+
end
|
290
|
+
end
|
291
|
+
nil
|
292
|
+
end
|
293
|
+
|
294
|
+
# @return [Integer] The approximate number of visible messages
|
295
|
+
# in a queue. For more information, see {Resources Required
|
296
|
+
# to Process
|
297
|
+
# Messages}[http://docs.amazonwebservices.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/IntroductionArticle.html#ApproximateNumber]
|
298
|
+
# in the Amazon SQS Developer Guide.
|
299
|
+
def approximate_number_of_messages
|
300
|
+
get_attribute("ApproximateNumberOfMessages").to_i
|
301
|
+
end
|
302
|
+
alias_method :visible_messages, :approximate_number_of_messages
|
303
|
+
|
304
|
+
# @return [Integer] The approximate number of messages that
|
305
|
+
# are not timed-out and not deleted. For more information,
|
306
|
+
# see {Resources Required to Process
|
307
|
+
# Messages}[http://docs.amazonwebservices.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/IntroductionArticle.html#ApproximateNumber]
|
308
|
+
# in the Amazon SQS Developer Guide.
|
309
|
+
def approximate_number_of_messages_not_visible
|
310
|
+
get_attribute("ApproximateNumberOfMessagesNotVisible").to_i
|
311
|
+
end
|
312
|
+
alias_method :invisible_messages, :approximate_number_of_messages_not_visible
|
313
|
+
|
314
|
+
# @return [Integer] Returns the visibility timeout for the
|
315
|
+
# queue. For more information about visibility timeout, see
|
316
|
+
# {Visibility
|
317
|
+
# Timeout}[http://docs.amazonwebservices.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/IntroductionArticle.html#AboutVT]
|
318
|
+
# in the Amazon SQS Developer Guide.
|
319
|
+
def visibility_timeout
|
320
|
+
get_attribute("VisibilityTimeout").to_i
|
321
|
+
end
|
322
|
+
|
323
|
+
# Sets the visibility timeout for the queue.
|
324
|
+
#
|
325
|
+
# @param [Integer] timeout The length of time (in seconds)
|
326
|
+
# that a message received from a queue will be invisible to
|
327
|
+
# other receiving components when they ask to receive
|
328
|
+
# messages. Valid values: integers from 0 to 43200 (12
|
329
|
+
# hours).
|
330
|
+
#
|
331
|
+
# @return Returns the value passed as a timeout.
|
332
|
+
def visibility_timeout=(timeout)
|
333
|
+
set_attribute("VisibilityTimeout", timeout.to_s)
|
334
|
+
timeout
|
335
|
+
end
|
336
|
+
|
337
|
+
# @return [Time] The time when the queue was created.
|
338
|
+
def created_timestamp
|
339
|
+
Time.at(get_attribute("CreatedTimestamp").to_i)
|
340
|
+
end
|
341
|
+
|
342
|
+
# @return [Time] The time when the queue was last changed.
|
343
|
+
def last_modified_timestamp
|
344
|
+
Time.at(get_attribute("LastModifiedTimestamp").to_i)
|
345
|
+
end
|
346
|
+
|
347
|
+
# @return [Integer] The limit of how many bytes a message can
|
348
|
+
# contain before Amazon SQS rejects it.
|
349
|
+
def maximum_message_size
|
350
|
+
get_attribute("MaximumMessageSize").to_i
|
351
|
+
end
|
352
|
+
|
353
|
+
# Sets the maximum message size for the queue.
|
354
|
+
#
|
355
|
+
# @param [Integer] size The limit of how many bytes a message
|
356
|
+
# can contain before Amazon SQS rejects it. This must be an
|
357
|
+
# integer from 1024 bytes (1KB) up to 65536 bytes
|
358
|
+
# (64KB). The default for this attribute is 8192 (8KB).
|
359
|
+
# @return Retuns the passed size argument.
|
360
|
+
def maximum_message_size=(size)
|
361
|
+
set_attribute("MaximumMessageSize", size.to_s)
|
362
|
+
end
|
363
|
+
|
364
|
+
# @return [Integer] The number of seconds Amazon SQS retains a
|
365
|
+
# message.
|
366
|
+
def message_retention_period
|
367
|
+
get_attribute("MessageRetentionPeriod").to_i
|
368
|
+
end
|
369
|
+
|
370
|
+
# Sets the message retention period for the queue
|
371
|
+
#
|
372
|
+
# @param [Integer] period The number of seconds Amazon SQS
|
373
|
+
# retains a message. Must be an integer from 3600 (1 hour)
|
374
|
+
# to 1209600 (14 days). The default for this attribute is
|
375
|
+
# 345600 (4 days).
|
376
|
+
# @return Returns the passed period argument.
|
377
|
+
def message_retention_period=(period)
|
378
|
+
set_attribute("MessageRetentionPeriod", period.to_s)
|
379
|
+
period
|
380
|
+
end
|
381
|
+
|
382
|
+
# @return [Integer] Gets the current default delay for messages sent
|
383
|
+
# to the queue.
|
384
|
+
def delay_seconds
|
385
|
+
get_attribute("DelaySeconds").to_i
|
386
|
+
end
|
387
|
+
|
388
|
+
# Sets the default delay for messages sent to the queue.
|
389
|
+
# @param [Integer] seconds How many seconds a message will be delayed.
|
390
|
+
def delay_seconds= seconds
|
391
|
+
set_attribute("DelaySeconds", seconds.to_s)
|
392
|
+
end
|
393
|
+
|
394
|
+
# @return [Integer] Gets the number of seconds the service will wait
|
395
|
+
# for a response when requesting a new message
|
396
|
+
# @since 1.8.0
|
397
|
+
def wait_time_seconds
|
398
|
+
get_attribute("ReceiveMessageWaitTimeSeconds").to_i
|
399
|
+
end
|
400
|
+
|
401
|
+
# Sets the number of seconds that the service should wait for a response
|
402
|
+
# when requesting a new message
|
403
|
+
# @param [Integer] seconds How many seconds to wait for a response
|
404
|
+
# @since 1.8.0
|
405
|
+
def wait_time_seconds= seconds
|
406
|
+
set_attribute("ReceiveMessageWaitTimeSeconds", seconds.to_s)
|
407
|
+
end
|
408
|
+
|
409
|
+
# @return [Integer] Returns an approximate count of messages delayed.
|
410
|
+
def approximate_number_of_messages_delayed
|
411
|
+
get_attribute("ApproximateNumberOfMessagesDelayed").to_i
|
412
|
+
end
|
413
|
+
|
414
|
+
# @return [String] The queue's Amazon resource name (ARN).
|
415
|
+
def arn
|
416
|
+
@arn ||= get_attribute("QueueArn")
|
417
|
+
end
|
418
|
+
|
419
|
+
# @return [Boolean] True if the queue exists.
|
420
|
+
#
|
421
|
+
# @note This may raise an exception if you don't have
|
422
|
+
# permission to access the queue attributes. Also, it may
|
423
|
+
# return true for up to 60 seconds after a queue has been
|
424
|
+
# deleted.
|
425
|
+
def exists?
|
426
|
+
client.get_queue_attributes(:queue_url => url,
|
427
|
+
:attribute_names => ["QueueArn"])
|
428
|
+
rescue Errors::NonExistentQueue, Errors::InvalidAddress
|
429
|
+
false
|
430
|
+
else
|
431
|
+
true
|
432
|
+
end
|
433
|
+
|
434
|
+
# @private
|
435
|
+
module PolicyProxy
|
436
|
+
|
437
|
+
attr_accessor :queue
|
438
|
+
|
439
|
+
def change
|
440
|
+
yield(self)
|
441
|
+
queue.policy = self
|
442
|
+
end
|
443
|
+
|
444
|
+
def delete
|
445
|
+
queue.client.send(:set_attribute, 'Policy', '')
|
446
|
+
end
|
447
|
+
|
448
|
+
end
|
449
|
+
|
450
|
+
# @return [Policy] Returns the current queue policy if there is one.
|
451
|
+
# Returns +nil+ otherwise.
|
452
|
+
def policy
|
453
|
+
if policy_json = get_attribute('Policy')
|
454
|
+
policy = SQS::Policy.from_json(policy_json)
|
455
|
+
policy.extend(PolicyProxy)
|
456
|
+
policy.queue = self
|
457
|
+
policy
|
458
|
+
else
|
459
|
+
nil
|
460
|
+
end
|
461
|
+
end
|
462
|
+
|
463
|
+
# Set the policy on this queue.
|
464
|
+
#
|
465
|
+
# If you pass nil or an empty string then it will have the same
|
466
|
+
# effect as deleting the policy.
|
467
|
+
#
|
468
|
+
# @param policy The policy to set. This policy can be a {Policy} object,
|
469
|
+
# a json policy string, or any other object that responds with a policy
|
470
|
+
# string when it received #to_json.
|
471
|
+
#
|
472
|
+
# @return [nil]
|
473
|
+
#
|
474
|
+
def policy= policy
|
475
|
+
policy_string = case policy
|
476
|
+
when nil, '' then ''
|
477
|
+
when String then policy
|
478
|
+
else policy.to_json
|
479
|
+
end
|
480
|
+
set_attribute('Policy', policy_string)
|
481
|
+
nil
|
482
|
+
end
|
483
|
+
|
484
|
+
# Sends a batch of up to 10 messages in a single request.
|
485
|
+
#
|
486
|
+
# queue.send_messages('message-1', 'message-2')
|
487
|
+
#
|
488
|
+
# You can also set an optional delay for all of the messages:
|
489
|
+
#
|
490
|
+
# # delay all messages 1 hour
|
491
|
+
# queue.batch_send(msg1, msg2, :delay_seconds => 3600)
|
492
|
+
#
|
493
|
+
# If you need to set a custom delay for each message you can pass
|
494
|
+
# hashes:
|
495
|
+
#
|
496
|
+
# messages = []
|
497
|
+
# messages << { :message_body => 'msg1', :delay_seconds => 60 }
|
498
|
+
# messages << { :message_body => 'msg2', :delay_seconds => 30 }
|
499
|
+
#
|
500
|
+
# queue.batch_send(messages)
|
501
|
+
#
|
502
|
+
# @param [String,Hash] messages A list of messages. Each message
|
503
|
+
# should be a string, or a hash with a +:message_body+,
|
504
|
+
# and optionally +:delay_seconds+.
|
505
|
+
#
|
506
|
+
# @raise [Errors::BatchSendError] Raises this error when one or more
|
507
|
+
# of the messages failed to send, but others did. On the raised
|
508
|
+
# object you can access a list of the messages that failed, and
|
509
|
+
# a list of messages that succeeded.
|
510
|
+
#
|
511
|
+
# @return [Array<SentMessage>] Returns an array of sent message objects.
|
512
|
+
# Each object responds to #message_id and #md5_of_message_body.
|
513
|
+
# The message id is generated by Amazon SQS.
|
514
|
+
#
|
515
|
+
def batch_send *messages
|
516
|
+
|
517
|
+
entries = messages.flatten
|
518
|
+
|
519
|
+
unless entries.first.is_a?(Hash)
|
520
|
+
options = entries.last.is_a?(Hash) ? entries.pop : {}
|
521
|
+
entries = entries.collect{|msg| { :message_body => msg } }
|
522
|
+
if delay = options[:delay_seconds]
|
523
|
+
entries.each {|entry| entry[:delay_seconds] = delay }
|
524
|
+
end
|
525
|
+
end
|
526
|
+
|
527
|
+
entries.each_with_index {|entry,n| entry[:id] = n.to_s }
|
528
|
+
|
529
|
+
client_opts = {}
|
530
|
+
client_opts[:queue_url] = url
|
531
|
+
client_opts[:entries] = entries
|
532
|
+
|
533
|
+
response = client.send_message_batch(client_opts)
|
534
|
+
|
535
|
+
failed = batch_failures(entries, response)
|
536
|
+
|
537
|
+
sent = response[:successful].collect do |sent|
|
538
|
+
msg = SentMessage.new
|
539
|
+
msg.message_id = sent[:message_id]
|
540
|
+
msg.md5 = sent[:md5_of_message_body]
|
541
|
+
msg
|
542
|
+
end
|
543
|
+
|
544
|
+
raise Errors::BatchSendError.new(sent, failed) unless failed.empty?
|
545
|
+
|
546
|
+
sent
|
547
|
+
|
548
|
+
end
|
549
|
+
|
550
|
+
# @param [ReceivedMessage,String] messages A list of up to 10 messages
|
551
|
+
# to delete. Each message should be a {ReceivedMessage} object
|
552
|
+
# or a received message handle (string).
|
553
|
+
#
|
554
|
+
# @raise [Errors::BatchDeleteSend] Raised when one or more of the
|
555
|
+
# messages failed to delete. The raised error has a list
|
556
|
+
# of the failures.
|
557
|
+
#
|
558
|
+
# @return [nil]
|
559
|
+
#
|
560
|
+
def batch_delete *messages
|
561
|
+
|
562
|
+
entries = []
|
563
|
+
messages.flatten.each_with_index do |msg,n|
|
564
|
+
handle = msg.is_a?(ReceivedMessage) ? msg.handle : msg
|
565
|
+
entries << { :id => n.to_s, :receipt_handle => handle }
|
566
|
+
end
|
567
|
+
|
568
|
+
response = client.delete_message_batch(
|
569
|
+
:queue_url => url, :entries => entries)
|
570
|
+
|
571
|
+
failures = batch_failures(entries, response)
|
572
|
+
|
573
|
+
raise Errors::BatchDeleteError.new(failures) unless failures.empty?
|
574
|
+
|
575
|
+
nil
|
576
|
+
|
577
|
+
end
|
578
|
+
|
579
|
+
# @overload batch_change_visibility(visibility_timeout, *messages)
|
580
|
+
#
|
581
|
+
# Accepts a single +:visibility_timeout+ value and a list of
|
582
|
+
# messages ({ReceivedMessage} objects or receipt handle strings).
|
583
|
+
# This form of the method is useful when you want to set the same
|
584
|
+
# timeout value for each message.
|
585
|
+
#
|
586
|
+
# queue.batch_change_visibility(10, messages)
|
587
|
+
#
|
588
|
+
# @param [Integer] visibility_timeout The new value for the message's
|
589
|
+
# visibility timeout (in seconds).
|
590
|
+
#
|
591
|
+
# @param [ReceivedMessage,String] message A list of up to 10 messages
|
592
|
+
# to change the visibility timeout for.
|
593
|
+
#
|
594
|
+
# @raise [BatchChangeVisibilityError] Raises this error when one
|
595
|
+
# or more of the messages failed the visibility update.
|
596
|
+
#
|
597
|
+
# @return [nil]
|
598
|
+
#
|
599
|
+
# @overload batch_change_visibility(*messages_with_timeouts)
|
600
|
+
#
|
601
|
+
# Accepts a list of hashes. Each hash should provide the visibility
|
602
|
+
# timeout and message (a {ReceivedMessage} object or the recipt handle
|
603
|
+
# string).
|
604
|
+
#
|
605
|
+
# Use this form when each message needs a different visiblity timeout.
|
606
|
+
#
|
607
|
+
# messages = []
|
608
|
+
# messages << { :message => 'handle1', :visibility_timeout => 5 }
|
609
|
+
# messages << { :message => 'handle2', :visibility_timeout => 10 }
|
610
|
+
#
|
611
|
+
# queue.batch_change_visibility(*messages)
|
612
|
+
#
|
613
|
+
# @param [Hash] message A list hashes, each with a +:visibility_timeout+
|
614
|
+
# and a +:message+.
|
615
|
+
#
|
616
|
+
# @raise [BatchChangeVisibilityError] Raises this error when one
|
617
|
+
# or more of the messages failed the visibility update.
|
618
|
+
#
|
619
|
+
# @return [nil]
|
620
|
+
#
|
621
|
+
def batch_change_visibility *args
|
622
|
+
|
623
|
+
args = args.flatten
|
624
|
+
|
625
|
+
if args.first.is_a?(Integer)
|
626
|
+
timeout = args.shift
|
627
|
+
messages = args.collect{|m| [m, timeout] }
|
628
|
+
else
|
629
|
+
messages = args.collect{|m| [m[:message], m[:visibility_timeout]] }
|
630
|
+
end
|
631
|
+
|
632
|
+
entries = []
|
633
|
+
messages.each do |msg,timeout|
|
634
|
+
handle = msg.is_a?(ReceivedMessage) ? msg.handle : msg
|
635
|
+
entries << {
|
636
|
+
:id => entries.size.to_s,
|
637
|
+
:receipt_handle => handle,
|
638
|
+
:visibility_timeout => timeout,
|
639
|
+
}
|
640
|
+
end
|
641
|
+
|
642
|
+
response = client.change_message_visibility_batch(
|
643
|
+
:queue_url => url, :entries => entries)
|
644
|
+
|
645
|
+
failures = batch_failures(entries, response)
|
646
|
+
|
647
|
+
raise Errors::BatchChangeVisibilityError.new(failures) unless
|
648
|
+
failures.empty?
|
649
|
+
|
650
|
+
nil
|
651
|
+
|
652
|
+
end
|
653
|
+
|
654
|
+
# @return [Boolean] Returns true if the other queue has the same
|
655
|
+
# url.
|
656
|
+
def ==(other)
|
657
|
+
other.kind_of?(Queue) and other.url == url
|
658
|
+
end
|
659
|
+
alias_method :eql?, :==
|
660
|
+
|
661
|
+
# @private
|
662
|
+
def inspect
|
663
|
+
"<#{self.class}:#{url}>"
|
664
|
+
end
|
665
|
+
|
666
|
+
protected
|
667
|
+
def batch_failures entries, response
|
668
|
+
response[:failed].inject([]) do |failures, failure|
|
669
|
+
|
670
|
+
entry = entries.find{|e| e[:id] == failure[:id] }
|
671
|
+
|
672
|
+
details = {
|
673
|
+
:error_code => failure[:code],
|
674
|
+
:error_message => failure[:message],
|
675
|
+
:sender_fault => failure[:sender_fault],
|
676
|
+
}
|
677
|
+
|
678
|
+
if handle = entry[:receipt_handle]
|
679
|
+
details[:receipt_handle] = handle
|
680
|
+
end
|
681
|
+
|
682
|
+
failures << details
|
683
|
+
|
684
|
+
end
|
685
|
+
end
|
686
|
+
|
687
|
+
# @private
|
688
|
+
protected
|
689
|
+
def hit_timeout?(got_first, last_message_at, opts)
|
690
|
+
initial_timeout = opts[:initial_timeout]
|
691
|
+
idle_timeout = opts[:idle_timeout]
|
692
|
+
|
693
|
+
timeout = (got_first ||
|
694
|
+
# if initial_timeout is false (as opposed
|
695
|
+
# to nil) then we skip the branch and poll
|
696
|
+
# indefinitely until the first message
|
697
|
+
# comes
|
698
|
+
(!initial_timeout && initial_timeout != false) ?
|
699
|
+
idle_timeout :
|
700
|
+
initial_timeout) and
|
701
|
+
Time.now - last_message_at > timeout
|
702
|
+
end
|
703
|
+
|
704
|
+
# @private
|
705
|
+
protected
|
706
|
+
def receive_opts(opts)
|
707
|
+
receive_opts = { :queue_url => url }
|
708
|
+
receive_opts[:visibility_timeout] = opts[:visibility_timeout] if
|
709
|
+
opts[:visibility_timeout]
|
710
|
+
receive_opts[:max_number_of_messages] = opts[:limit] if
|
711
|
+
opts[:limit]
|
712
|
+
receive_opts[:wait_time_seconds] = opts[:wait_time_seconds] if
|
713
|
+
opts[:wait_time_seconds]
|
714
|
+
|
715
|
+
if names = opts[:attributes]
|
716
|
+
receive_opts[:attribute_names] = names.map do |name|
|
717
|
+
name = ReceivedMessage::ATTRIBUTE_ALIASES[name.to_sym] if
|
718
|
+
ReceivedMessage::ATTRIBUTE_ALIASES.key?(name.to_sym)
|
719
|
+
name = Core::Inflection.class_name(name.to_s) if name.kind_of?(Symbol)
|
720
|
+
name
|
721
|
+
end
|
722
|
+
end
|
723
|
+
receive_opts
|
724
|
+
end
|
725
|
+
|
726
|
+
# @private
|
727
|
+
protected
|
728
|
+
def call_message_block(messages, block)
|
729
|
+
result = nil
|
730
|
+
messages.each do |message|
|
731
|
+
begin
|
732
|
+
result = block.call(message)
|
733
|
+
rescue Exception => e
|
734
|
+
raise
|
735
|
+
else
|
736
|
+
message.delete
|
737
|
+
end
|
738
|
+
end
|
739
|
+
result
|
740
|
+
end
|
741
|
+
|
742
|
+
# @private
|
743
|
+
protected
|
744
|
+
def get_attribute(name)
|
745
|
+
resp = client.get_queue_attributes(:queue_url => url,
|
746
|
+
:attribute_names =>
|
747
|
+
[name, "QueueArn"].uniq)
|
748
|
+
@arn ||= resp.attributes["QueueArn"]
|
749
|
+
resp.attributes[name]
|
750
|
+
end
|
751
|
+
|
752
|
+
# @private
|
753
|
+
protected
|
754
|
+
def set_attribute(name, value)
|
755
|
+
client.set_queue_attributes({
|
756
|
+
:queue_url => url,
|
757
|
+
:attributes => { name => value },
|
758
|
+
})
|
759
|
+
end
|
760
|
+
|
761
|
+
end
|
762
|
+
|
763
|
+
end
|
764
|
+
end
|