Welcome to the AWS Code Examples Repository. This repo contains code examples used in the AWS documentation, AWS SDK Developer Guides, and more. For more information, see the Readme.md file below.
|
<?php
|
||
|
|
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
||
|
|
// SPDX-License-Identifier: Apache-2.0
|
||
|
|
|
||
|
|
// snippet-start:[php.example_code.ec2.service.Ec2Service]
|
||
|
|
|
||
|
|
namespace Ec2;
|
||
|
|
|
||
|
|
use Aws\Ec2\Ec2Client;
|
||
|
|
use Aws\Ec2\Exception\Ec2Exception;
|
||
|
|
|
||
|
|
class EC2Service
|
||
|
|
{
|
||
|
|
protected Ec2Client $ec2Client;
|
||
|
|
protected string $region;
|
||
|
|
|
||
|
|
public function getRegion(): string
|
||
|
|
{
|
||
|
|
return $this->region;
|
||
|
|
}
|
||
|
|
|
||
|
|
public function __construct($client = null, $region = 'us-west-2', $version = 'latest', $profile = 'default')
|
||
|
|
{
|
||
|
|
if (gettype($client) == Ec2Client::class) {
|
||
|
|
$this->ec2Client = $client;
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
$this->ec2Client = new Ec2Client([
|
||
|
|
'region' => $region,
|
||
|
|
'version' => $version,
|
||
|
|
'profile' => $profile,
|
||
|
|
]);
|
||
|
|
$this->region = $region;
|
||
|
|
/* Inline declaration example
|
||
|
|
// snippet-start:[php.example_code.ec2.basics.createClient]
|
||
|
|
$ec2Client = new Ec2Client(['region' => 'us-west-2', 'version' => 'latest', 'profile' => 'default']);
|
||
|
|
// snippet-end:[php.example_code.ec2.basics.createClient]
|
||
|
|
*/
|
||
|
|
}
|
||
|
|
|
||
|
|
// snippet-start:[php.example_code.ec2.service.createVpcEndpoint]
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param string $serviceName
|
||
|
|
* @param string $vpcId
|
||
|
|
* @param array $routeTableIds
|
||
|
|
* @return array
|
||
|
|
*/
|
||
|
|
public function createVpcEndpoint(string $serviceName, string $vpcId, array $routeTableIds): array
|
||
|
|
{
|
||
|
|
try {
|
||
|
|
$result = $this->ec2Client->createVpcEndpoint([
|
||
|
|
'ServiceName' => $serviceName,
|
||
|
|
'VpcId' => $vpcId,
|
||
|
|
'RouteTableIds' => $routeTableIds,
|
||
|
|
]);
|
||
|
|
|
||
|
|
return $result["VpcEndpoint"];
|
||
|
|
} catch(Ec2Exception $caught){
|
||
|
|
echo "There was a problem creating the VPC Endpoint: {$caught->getAwsErrorMessage()}\n";
|
||
|
|
throw $caught;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
// snippet-end:[php.example_code.ec2.service.createVpcEndpoint]
|
||
|
|
|
||
|
|
// snippet-start:[php.example_code.ec2.service.createVpc]
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param string $cidr
|
||
|
|
* @return array
|
||
|
|
*/
|
||
|
|
public function createVpc(string $cidr): array
|
||
|
|
{
|
||
|
|
try {
|
||
|
|
$result = $this->ec2Client->createVpc([
|
||
|
|
"CidrBlock" => $cidr,
|
||
|
|
]);
|
||
|
|
return $result['Vpc'];
|
||
|
|
}catch(Ec2Exception $caught){
|
||
|
|
echo "There was a problem creating the VPC: {$caught->getAwsErrorMessage()}\n";
|
||
|
|
throw $caught;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
// snippet-end:[php.example_code.ec2.service.createVpc]
|
||
|
|
|
||
|
|
// snippet-start:[php.example_code.ec2.service.deleteVpc]
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param string $vpcId
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public function deleteVpc(string $vpcId)
|
||
|
|
{
|
||
|
|
try {
|
||
|
|
$this->ec2Client->deleteVpc([
|
||
|
|
"VpcId" => $vpcId,
|
||
|
|
]);
|
||
|
|
}catch(Ec2Exception $caught){
|
||
|
|
echo "There was a problem deleting the VPC: {$caught->getAwsErrorMessage()}\n";
|
||
|
|
throw $caught;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
// snippet-end:[php.example_code.ec2.service.deleteVpc]
|
||
|
|
|
||
|
|
// snippet-start:[php.example_code.ec2.service.deleteVpcEndpoint]
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param string $vpcEndpointId
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public function deleteVpcEndpoint(string $vpcEndpointId)
|
||
|
|
{
|
||
|
|
try {
|
||
|
|
$this->ec2Client->deleteVpcEndpoints([
|
||
|
|
"VpcEndpointIds" => [$vpcEndpointId],
|
||
|
|
]);
|
||
|
|
}catch (Ec2Exception $caught){
|
||
|
|
echo "There was a problem deleting the VPC Endpoint: {$caught->getAwsErrorMessage()}\n";
|
||
|
|
throw $caught;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
// snippet-end:[php.example_code.ec2.service.deleteVpcEndpoint]
|
||
|
|
|
||
|
|
// snippet-start:[php.example_code.ec2.service.describeRouteTables]
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param array $routeTableIds
|
||
|
|
* @param array $filters
|
||
|
|
* @return array
|
||
|
|
*/
|
||
|
|
public function describeRouteTables(array $routeTableIds = [], array $filters = []): array
|
||
|
|
{
|
||
|
|
$parameters = [];
|
||
|
|
if($routeTableIds){
|
||
|
|
$parameters['RouteTableIds'] = $routeTableIds;
|
||
|
|
}
|
||
|
|
if($filters){
|
||
|
|
$parameters['Filters'] = $filters;
|
||
|
|
}
|
||
|
|
try {
|
||
|
|
$paginator = $this->ec2Client->getPaginator("DescribeRouteTables", $parameters);
|
||
|
|
$contents = [];
|
||
|
|
foreach ($paginator as $result) {
|
||
|
|
foreach ($result['RouteTables'] as $object) {
|
||
|
|
$contents[] = $object['RouteTableId'];
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}catch (Ec2Exception $caught){
|
||
|
|
echo "There was a problem paginating the results of DescribeRouteTables: {$caught->getAwsErrorMessage()}\n";
|
||
|
|
throw $caught;
|
||
|
|
}
|
||
|
|
return $contents;
|
||
|
|
}
|
||
|
|
|
||
|
|
// snippet-end:[php.example_code.ec2.service.describeRouteTables]
|
||
|
|
|
||
|
|
// snippet-start:[php.example_code.ec2.service.waitForVpcAvailable]
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param string $VpcId
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public function waitForVpcAvailable(string $VpcId): void
|
||
|
|
{
|
||
|
|
try {
|
||
|
|
$waiter = $this->ec2Client->getWaiter("VpcAvailable", [
|
||
|
|
'VpcIds' => [$VpcId],
|
||
|
|
]);
|
||
|
|
|
||
|
|
$promise = $waiter->promise();
|
||
|
|
$promise->wait();
|
||
|
|
}catch(Ec2Exception $caught){
|
||
|
|
echo "There was a problem waiting for the VPC: {$caught->getAwsErrorMessage()}\n";
|
||
|
|
throw $caught;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
// snippet-end:[php.example_code.ec2.service.waitForVpcAvailable]
|
||
|
|
}
|
||
|
|
|
||
|
|
// snippet-end:[php.example_code.ec2.service.Ec2Service]
|