Amazon Elastic Compute Cloud

このガイドは、 Amazon Elastic Compute Cloud のためのニフティクラウド SDK for PHP クライアントにフォーカスしています。 このガイドでは、 ニフティクラウド SDK for PHPをダウンロードしインストールが既に終わっていると想定しています。 はじめる場合のより詳細な情報は インストール を参照して下さい。

利用可能な操作

利用可能なすべてのメソッドおよび入出力の記述についてのより詳細な情報を得るためには ニフティクラウド API リファレンス または Amazon Elastic Compute Cloud クライアント API リファレンス を参照して下さい。

ActivateLicense AllocateAddress
AssignPrivateIpAddresses AssociateAddress
AssociateDhcpOptions AssociateRouteTable
AttachInternetGateway AttachNetworkInterface
AttachVolume AttachVpnGateway
AuthorizeSecurityGroupEgress AuthorizeSecurityGroupIngress
BundleInstance CancelBundleTask
CancelConversionTask CancelExportTask
CancelReservedInstancesListing CancelSpotInstanceRequests
ConfirmProductInstance CopyImage
CopySnapshot CreateCustomerGateway
CreateDhcpOptions CreateImage
CreateInstanceExportTask CreateInternetGateway
CreateKeyPair CreateNetworkAcl
CreateNetworkAclEntry CreateNetworkInterface
CreatePlacementGroup CreateReservedInstancesListing
CreateRoute CreateRouteTable
CreateSecurityGroup CreateSnapshot
CreateSpotDatafeedSubscription CreateSubnet
CreateTags CreateVolume
CreateVpc CreateVpnConnection
CreateVpnConnectionRoute CreateVpnGateway
DeactivateLicense DeleteCustomerGateway
DeleteDhcpOptions DeleteInternetGateway
DeleteKeyPair DeleteNetworkAcl
DeleteNetworkAclEntry DeleteNetworkInterface
DeletePlacementGroup DeleteRoute
DeleteRouteTable DeleteSecurityGroup
DeleteSnapshot DeleteSpotDatafeedSubscription
DeleteSubnet DeleteTags
DeleteVolume DeleteVpc
DeleteVpnConnection DeleteVpnConnectionRoute
DeleteVpnGateway DeregisterImage
DescribeAccountAttributes DescribeAddresses
DescribeAvailabilityZones DescribeBundleTasks
DescribeConversionTasks DescribeCustomerGateways
DescribeDhcpOptions DescribeExportTasks
DescribeImageAttribute DescribeImages
DescribeInstanceAttribute DescribeInstanceStatus
DescribeInstances DescribeInternetGateways
DescribeKeyPairs DescribeLicenses
DescribeNetworkAcls DescribeNetworkInterfaceAttribute
DescribeNetworkInterfaces DescribePlacementGroups
DescribeRegions DescribeReservedInstances
DescribeReservedInstancesListings DescribeReservedInstancesModifications
DescribeReservedInstancesOfferings DescribeRouteTables
DescribeSecurityGroups DescribeSnapshotAttribute
DescribeSnapshots DescribeSpotDatafeedSubscription
DescribeSpotInstanceRequests DescribeSpotPriceHistory
DescribeSubnets DescribeTags
DescribeVolumeAttribute DescribeVolumeStatus
DescribeVolumes DescribeVpcAttribute
DescribeVpcs DescribeVpnConnections
DescribeVpnGateways DetachInternetGateway
DetachNetworkInterface DetachVolume
DetachVpnGateway DisableVgwRoutePropagation
DisassociateAddress DisassociateRouteTable
EnableVgwRoutePropagation EnableVolumeIO
GetConsoleOutput GetPasswordData
ImportInstance ImportKeyPair
ImportVolume ModifyImageAttribute
ModifyInstanceAttribute ModifyNetworkInterfaceAttribute
ModifyReservedInstances ModifySnapshotAttribute
ModifyVolumeAttribute ModifyVpcAttribute
MonitorInstances PurchaseReservedInstancesOffering
RebootInstances RegisterImage
ReleaseAddress ReplaceNetworkAclAssociation
ReplaceNetworkAclEntry ReplaceRoute
ReplaceRouteTableAssociation ReportInstanceStatus
RequestSpotInstances ResetImageAttribute
ResetInstanceAttribute ResetNetworkInterfaceAttribute
ResetSnapshotAttribute RevokeSecurityGroupEgress
RevokeSecurityGroupIngress RunInstances
StartInstances StopInstances
TerminateInstances UnassignPrivateIpAddresses
UnmonitorInstances  

クライアントの作成

まず以下のような方法のいずれかで、クライアントオブジェクトを作成しなければなりません。

Factory method

Aws\Ec2\Ec2Client::factory() メソッドを利用することで、最も簡単に立ち上げ速やかに動かすことができます。その際にクレデンシャル (key and secret) を提供して下さい。

region パラメータも必須で、以下の値のいずれかをセットしなければなりません。: us-east-1, ap-northeast-1, sa-east-1, ap-southeast-1, ap-southeast-2, us-west-2, us-gov-west-1, us-west-1, eu-west-1

use Aws\Ec2\Ec2Client;

$client = Ec2Client::factory(array(
    'key'    => '<aws access key>',
    'secret' => '<aws secret key>',
    'region' => '<region name>'
));

先の例のようにしてアクセスキーをセットすることができます。また、もし、 AWS Identity and Access Management (IAM) roles for EC2 instances を利用しているか、環境変数 AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEY からクレデンシャル情報を利用できるのであれば、これらの設定を省略することも可能です。

サービスロケータ

より確実に Amazon Elastic Compute Cloud に接続する方法はサービスロケータを通す方法です。 設定ファイルの中でクレデンシャルと設定値を指定することができます。 これらの設定はすべてのクライアントで共有されるので一度だけ設定を行えばよくなります。

use Aws\Common\Aws;

// Create a service builder using a configuration file
$aws = Aws::factory('/path/to/my_config.json');

// Get the client from the builder by namespace
$client = $aws->get('Ec2');

このガイドは不完全です

このガイドは、完成しておりません。もし、 SDK や AWS PHP コミュニティのへのよい貢献方法を探しているならば、 手始めにドキュメントを書く手助けをすることはとてもよい方法です。 ガイドは ReStructuredText で記述され、 Sphinx を用いて生成されています。 気兼ねなくドキュメントにコンテンツを追加し、 https://github.com/aws/aws-sdk-php まで pull request を 送って下さい。 ドキュメントのソースは https://github.com/aws/aws-sdk-php/tree/master/docs で見ることが可能です。