PATH:
home
/
lab2454c
/
vaultchip.com
/
vendor
/
aws
/
aws-sdk-php
/
src
<?php namespace Aws; use Aws\Exception\AwsException; use GuzzleHttp\Promise; use GuzzleHttp\Promise\PromisorInterface; use GuzzleHttp\Promise\RejectedPromise; /** * "Waiters" are associated with an AWS resource (e.g., EC2 instance), and poll * that resource and until it is in a particular state. * The Waiter object produces a promise that is either a.) resolved once the * waiting conditions are met, or b.) rejected if the waiting conditions cannot * be met or has exceeded the number of allowed attempts at meeting the * conditions. You can use waiters in a blocking or non-blocking way, depending * on whether you call wait() on the promise. * The configuration for the waiter must include information about the operation * and the conditions for wait completion. */ class Waiter implements PromisorInterface { /** @var AwsClientInterface Client used to execute each attempt. */ private $client; /** @var string Name of the waiter. */ private $name; /** @var array Params to use with each attempt operation. */ private $args; /** @var array Waiter configuration. */ private $config; /** @var array Default configuration options. */ private static $defaults = ['initDelay' => 0, 'before' => null]; /** @var array Required configuration options. */ private static $required = [ 'acceptors', 'delay', 'maxAttempts', 'operation', ]; /** * The array of configuration options include: * * - acceptors: (array) Array of acceptor options * - delay: (int) Number of seconds to delay between attempts * - maxAttempts: (int) Maximum number of attempts before failing * - operation: (string) Name of the API operation to use for polling * - before: (callable) Invoked before attempts. Accepts command and tries. * * @param AwsClientInterface $client Client used to execute commands. * @param string $name Waiter name. * @param array $args Command arguments. * @param array $config Waiter config that overrides defaults. * * @throws \InvalidArgumentException if the configuration is incomplete. */ public function __construct( AwsClientInterface $client, $name, array $args = [], array $config = [] ) { $this->client = $client; $this->name = $name; $this->args = $args; // Prepare and validate config. $this->config = $config + self::$defaults; foreach (self::$required as $key) { if (!isset($this->config[$key])) { throw new \InvalidArgumentException( 'The provided waiter configuration was incomplete.' ); } } if ($this->config['before'] && !is_callable($this->config['before'])) { throw new \InvalidArgumentException( 'The provided "before" callback is not callable.' ); } } public function promise() { return Promise\coroutine(function () { $name = $this->config['operation']; for ($state = 'retry', $attempt = 1; $state === 'retry'; $attempt++) { // Execute the operation. $args = $this->getArgsForAttempt($attempt); $command = $this->client->getCommand($name, $args); try { if ($this->config['before']) { $this->config['before']($command, $attempt); } $result = (yield $this->client->executeAsync($command)); } catch (AwsException $e) { $result = $e; } // Determine the waiter's state and what to do next. $state = $this->determineState($result); if ($state === 'success') { yield $command; } elseif ($state === 'failed') { $msg = "The {$this->name} waiter entered a failure state."; if ($result instanceof \Exception) { $msg .= ' Reason: ' . $result->getMessage(); } yield new RejectedPromise(new \RuntimeException($msg)); } elseif ($state === 'retry' && $attempt >= $this->config['maxAttempts'] ) { $state = 'failed'; yield new RejectedPromise(new \RuntimeException( "The {$this->name} waiter failed after attempt #{$attempt}." )); } } }); } /** * Gets the operation arguments for the attempt, including the delay. * * @param $attempt Number of the current attempt. * * @return mixed integer */ private function getArgsForAttempt($attempt) { $args = $this->args; // Determine the delay. $delay = ($attempt === 1) ? $this->config['initDelay'] : $this->config['delay']; if (is_callable($delay)) { $delay = $delay($attempt); } // Set the delay. (Note: handlers except delay in milliseconds.) if (!isset($args['@http'])) { $args['@http'] = []; } $args['@http']['delay'] = $delay * 1000; return $args; } /** * Determines the state of the waiter attempt, based on the result of * polling the resource. A waiter can have the state of "success", "failed", * or "retry". * * @param mixed $result * * @return string Will be "success", "failed", or "retry" */ private function determineState($result) { foreach ($this->config['acceptors'] as $acceptor) { $matcher = 'matches' . ucfirst($acceptor['matcher']); if ($this->{$matcher}($result, $acceptor)) { return $acceptor['state']; } } return $result instanceof \Exception ? 'failed' : 'retry'; } /** * @param Result $result Result or exception. * @param array $acceptor Acceptor configuration being checked. * * @return bool */ private function matchesPath($result, array $acceptor) { return !($result instanceof ResultInterface) ? false : $acceptor['expected'] == $result->search($acceptor['argument']); } /** * @param Result $result Result or exception. * @param array $acceptor Acceptor configuration being checked. * * @return bool */ private function matchesPathAll($result, array $acceptor) { if (!($result instanceof ResultInterface)) { return false; } $actuals = $result->search($acceptor['argument']) ?: []; foreach ($actuals as $actual) { if ($actual != $acceptor['expected']) { return false; } } return true; } /** * @param Result $result Result or exception. * @param array $acceptor Acceptor configuration being checked. * * @return bool */ private function matchesPathAny($result, array $acceptor) { if (!($result instanceof ResultInterface)) { return false; } $actuals = $result->search($acceptor['argument']) ?: []; return in_array($acceptor['expected'], $actuals); } /** * @param Result $result Result or exception. * @param array $acceptor Acceptor configuration being checked. * * @return bool */ private function matchesStatus($result, array $acceptor) { if ($result instanceof ResultInterface) { return $acceptor['expected'] == $result['@metadata']['statusCode']; } if ($result instanceof AwsException && $response = $result->getResponse()) { return $acceptor['expected'] == $response->getStatusCode(); } return false; } /** * @param Result $result Result or exception. * @param array $acceptor Acceptor configuration being checked. * * @return bool */ private function matchesError($result, array $acceptor) { if ($result instanceof AwsException) { return $result->isConnectionError() || $result->getAwsErrorCode() == $acceptor['expected']; } return false; } }
[+]
..
[+]
ServiceQuotas
[+]
Crypto
[+]
ForecastService
[+]
EBS
[+]
CloudFormation
[+]
Sts
[+]
Athena
[-] RetryMiddleware.php
[edit]
[+]
WorkDocs
[+]
ClientSideMonitoring
[+]
DeviceFarm
[+]
ComprehendMedical
[+]
Rekognition
[+]
FIS
[+]
DAX
[+]
SageMaker
[+]
MTurk
[+]
ElasticLoadBalancing
[+]
Ecs
[+]
IdentityStore
[+]
LookoutEquipment
[-] StreamRequestPayloadMiddleware.php
[edit]
[+]
WellArchitected
[+]
Health
[-] HasDataTrait.php
[edit]
[+]
Ses
[+]
Schemas
[+]
MachineLearning
[+]
Route53RecoveryControlConfig
[+]
WorkMail
[-] ConfigurationProviderInterface.php
[edit]
[+]
IoTWireless
[+]
data
[-] HasMonitoringEventsTrait.php
[edit]
[+]
KinesisVideoMedia
[+]
Pinpoint
[+]
AppMesh
[+]
IoTFleetHub
[+]
AutoScaling
[+]
CodeGuruProfiler
[+]
MediaTailor
[+]
CodeCommit
[+]
GlueDataBrew
[-] CacheInterface.php
[edit]
[+]
Sqs
[+]
AutoScalingPlans
[+]
IoTEvents
[+]
MediaPackage
[+]
Budgets
[+]
IVS
[+]
ForecastQueryService
[+]
MarketplaceEntitlementService
[+]
AmplifyBackend
[+]
LicenseManager
[+]
CloudTrail
[+]
IoT1ClickProjects
[+]
IoTThingsGraph
[+]
SavingsPlans
[+]
CloudFront
[+]
ServerlessApplicationRepository
[+]
ElasticsearchService
[+]
DynamoDbStreams
[+]
DLM
[-] Sdk.php
[edit]
[+]
XRay
[+]
CloudSearchDomain
[+]
MarketplaceCatalog
[+]
CostExplorer
[+]
Chime
[-] MockHandler.php
[edit]
[-] JsonCompiler.php
[edit]
[+]
IoTJobsDataPlane
[-] HashingStream.php
[edit]
[+]
SSOAdmin
[+]
NimbleStudio
[+]
ResourceGroupsTaggingAPI
[-] PsrCacheAdapter.php
[edit]
[+]
LakeFormation
[+]
ChimeSDKMessaging
[+]
Iot
[+]
NetworkFirewall
[+]
Synthetics
[+]
IoTSecureTunneling
[+]
Glue
[+]
signer
[+]
kendra
[+]
CodeArtifact
[+]
OpenSearchService
[+]
LocationService
[+]
Sns
[+]
WorkLink
[+]
Api
[+]
MQ
[+]
Exception
[+]
WafRegional
[+]
ResourceGroups
[+]
S3Control
[+]
EventBridge
[+]
Appstream
[+]
CodeBuild
[+]
MediaLive
[+]
SesV2
[+]
Kinesis
[+]
MediaStoreData
[-] CommandInterface.php
[edit]
[+]
KafkaConnect
[+]
Kafka
[+]
EC2InstanceConnect
[+]
CodeGuruReviewer
[+]
CloudHsm
[+]
MarketplaceMetering
[+]
CloudDirectory
[+]
ImportExport
[+]
Route53RecoveryCluster
[+]
Route53Resolver
[+]
ChimeSDKIdentity
[+]
KinesisVideoSignalingChannels
[+]
ConfigService
[-] HandlerList.php
[edit]
[+]
KinesisAnalyticsV2
[+]
ElasticBeanstalk
[-] Waiter.php
[edit]
[+]
GroundStation
[+]
ElastiCache
[+]
KinesisVideoArchivedMedia
[+]
mgn
[+]
Efs
[+]
imagebuilder
[+]
AppConfig
[+]
QLDB
[+]
WAFV2
[+]
CloudSearch
[+]
Redshift
[+]
PinpointSMSVoice
[+]
QLDBSession
[+]
SecretsManager
[+]
EMRContainers
[+]
SSMIncidents
[+]
Lambda
[+]
Multipart
[+]
DatabaseMigrationService
[+]
AugmentedAIRuntime
[+]
DataExchange
[-] AbstractConfigurationProvider.php
[edit]
[+]
Proton
[+]
RedshiftDataAPIService
[-] InputValidationMiddleware.php
[edit]
[+]
CustomerProfiles
[+]
WorkMailMessageFlow
[-] ResultPaginator.php
[edit]
[+]
Route53Domains
[+]
CloudHSMV2
[-] RetryMiddlewareV2.php
[edit]
[+]
ApplicationDiscoveryService
[+]
Ec2
[+]
Shield
[+]
LexModelBuildingService
[+]
ElasticTranscoder
[+]
Handler
[+]
EndpointDiscovery
[+]
DynamoDb
[+]
CloudWatchLogs
[-] ResponseContainerInterface.php
[edit]
[+]
Inspector
[+]
Ecr
[+]
RDSDataService
[+]
DirectoryService
[+]
IoTAnalytics
[+]
CloudWatchEvents
[+]
RAM
[+]
FMS
[-] ClientResolver.php
[edit]
[+]
Signature
[+]
AccessAnalyzer
[-] Command.php
[edit]
[+]
PrometheusService
[+]
ConnectParticipant
[+]
ServiceCatalog
[+]
Ssm
[+]
IoT1ClickDevicesService
[+]
TimestreamWrite
[+]
ApplicationAutoScaling
[+]
CodePipeline
[-] History.php
[edit]
[+]
FSx
[+]
Batch
[+]
AlexaForBusiness
[+]
Braket
[+]
ACMPCA
[-] Middleware.php
[edit]
[+]
Personalize
[+]
Detective
[+]
ManagedBlockchain
[+]
SSOOIDC
[+]
Endpoint
[+]
SnowBall
[+]
Acm
[-] AwsClientInterface.php
[edit]
[+]
Kms
[+]
Iam
[+]
SSMContacts
[+]
AppIntegrationsService
[+]
ElasticInference
[-] Psr16CacheAdapter.php
[edit]
[+]
HealthLake
[+]
StorageGateway
[+]
Polly
[-] MultiRegionClient.php
[edit]
[+]
Honeycode
[+]
MediaStore
[+]
MWAA
[-] CommandPool.php
[edit]
[+]
S3Outposts
[+]
Swf
[+]
Mobile
[+]
ECRPublic
[+]
CognitoIdentityProvider
[+]
ApiGatewayV2
[+]
Backup
[+]
Route53RecoveryReadiness
[+]
IotDataPlane
[+]
CognitoSync
[+]
SnowDeviceManagement
[+]
LookoutMetrics
[-] HashInterface.php
[edit]
[+]
TranscribeService
[-] IdempotencyTokenMiddleware.php
[edit]
[+]
GlobalAccelerator
[+]
LookoutforVision
[+]
ApiGatewayManagementApi
[+]
SageMakerFeatureStoreRuntime
[+]
Cloud9
[+]
MemoryDB
[-] AwsClientTrait.php
[edit]
[+]
Macie2
[-] MonitoringEventsInterface.php
[edit]
[+]
AppRunner
[+]
OpsWorks
[+]
OpsWorksCM
[+]
AuditManager
[+]
Support
[-] TraceMiddleware.php
[edit]
[+]
Lightsail
[-] EndpointParameterMiddleware.php
[edit]
[+]
Arn
[+]
MigrationHub
[+]
Firehose
[+]
CostandUsageReportService
[+]
Credentials
[+]
Sms
[+]
DataPipeline
[+]
QuickSight
[+]
PI
[+]
Outposts
[+]
NetworkManager
[+]
RoboMaker
[+]
FinSpaceData
[+]
MarketplaceCommerceAnalytics
[+]
AppSync
[+]
CodeDeploy
[-] functions.php
[edit]
[+]
TimestreamQuery
[+]
ConnectContactLens
[+]
DirectConnect
[+]
CodeStarconnections
[+]
GuardDuty
[+]
LexRuntimeService
[+]
CognitoIdentity
[+]
ApplicationInsights
[+]
GreengrassV2
[+]
IoTDeviceAdvisor
[+]
WorkSpaces
[+]
ComputeOptimizer
[+]
Comprehend
[+]
Emr
[+]
CloudWatch
[+]
finspace
[+]
DocDB
[+]
IoTSiteWise
[+]
ApiGateway
[+]
Amplify
[+]
Greengrass
[+]
Connect
[+]
ApplicationCostProfiler
[-] PresignUrlMiddleware.php
[edit]
[-] AwsClient.php
[edit]
[+]
Macie
[+]
SagemakerEdgeManager
[+]
CodeStar
[+]
Appflow
[+]
Organizations
[+]
PersonalizeEvents
[+]
GameLift
[+]
KinesisVideo
[+]
Pricing
[+]
PinpointEmail
[-] Result.php
[edit]
[+]
Rds
[-] ResultInterface.php
[edit]
[+]
SageMakerRuntime
[+]
Waf
[+]
MigrationHubConfig
[+]
Translate
[-] WrappedHttpHandler.php
[edit]
[+]
Glacier
[+]
Retry
[+]
Neptune
[+]
AppRegistry
[+]
LexRuntimeV2
[+]
MediaConnect
[+]
SSO
[+]
IoTEventsData
[-] PhpHash.php
[edit]
[+]
CodeStarNotifications
[+]
SecurityHub
[+]
FraudDetector
[+]
Route53
[+]
PersonalizeRuntime
[+]
DataSync
[+]
Textract
[+]
MediaConvert
[+]
Transfer
[+]
LexModelsV2
[-] LruArrayCache.php
[edit]
[-] DoctrineCacheAdapter.php
[edit]
[+]
MediaPackageVod
[+]
S3
[+]
KinesisAnalytics
[+]
ServiceDiscovery
[+]
EKS
[+]
ElasticLoadBalancingV2
[+]
DevOpsGuru
[+]
Sfn