この記事では、AccessKey を準備した後の ECS SDK の使用方法を、具体的な手順に焦点を当てて紹介します。この記事の内容は、何かを得ることができれば幸いです。
ECS SDK の使用例
SDK の新しいバージョンのファイル名は通常、aliyun-XXXX-sdk で始まり、その後に ECS などの製品名が続き、次のようなパッケージ名が形成されます。 aliyun-java-sdk-ecs 。コア パッケージ aliyun-java-sdk-core があり、これは、IClientProfile クラス、IAcsClient クラス、例外クラスなど、すべての製品の SDK で使用されるいくつかのクラスをカプセル化します。製品関連のクラスは、製品ごとに異なる名前の Jar パッケージにパッケージ化されます。
前提条件
プロファイルを作成するための出力用に AccessKey を準備する必要があります。
Java SDK 使用例
ECS Java SDK メソッド DescribeImages を使用して利用可能な画像リソースをクエリする例を取り上げ、完全な使用プロセスを紹介します。 SDK のうち、IClientProfile と IAcsClient の 2 つのクラスは aliyun-java-sdk-core パッケージに含まれており、他のクラスは aliyun-java-sdk-ecs パッケージに含まれています。 ######プロフィール作成。 AccessKeyID、AccessKeySecret、および例の cn-hangzhou などのデフォルトのリージョン情報を保存する IClientProfile のオブジェクト プロファイルを生成します。リージョンの詳細については、「リージョンとアベイラビリティーゾーン」を参照してください。
IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", ak, aks); #ak は AccessKey、aks は AccessKeySecret
クライアントを作成します。 IAcsClient オブジェクト クライアントは IClientProfile クラスから再生成され、その後の応答は IClientProfile から取得する必要があります。
IAcsClient client = new DefaultAcsClient(profile);
リクエストを作成します。メソッドに対応するリクエストを作成します。クラスの命名規則は通常、API メソッド名に「Request」を加えたものになります。たとえば、画像リストを取得する API メソッドの名前は DescribeImages で、対応するリクエスト クラス名は DescribeImagesRequest になります。コンストラクターを直接生成してデフォルトのクラスを記述します。
DescribeImagesRequest describe = new DescribeImagesRequest();
リクエストのパラメータを設定します。リクエストクラスを生成したら、リクエストクラスのsetXxxメソッドで必要な情報、つまりAPIパラメータに指定する必要がある情報を設定する必要があります。 DescribeImagesのAPIメソッドで指定する必要があるパラメータは次のとおりです。この値は、IClientProfile ですでに提供されているため、省略できます。たとえば、setXxx メソッドを使用して他のオプションのパラメーターを設定することもできます。 ImageOwnerAlias を自分自身に設定します。これは、カスタム イメージをクエリすることを意味します。
describe.setImageOwnerAlias("self");
パラメータを設定すると、対応するリクエストに対する応答が IAcsClient オブジェクトを通じて取得されます。
DescribeImagesResponse response = client.getAcsResponse(describe);
レスポンスで返されたパラメータ値を取得します。その後、対応する getXxx メソッドを呼び出して、特定の画像の名前を取得するなど、返されたパラメーター値を取得できます。 API メソッドによっては、返される情報に複数の階層の情報が含まれる場合があります。たとえば、ミラー リストを取得するメソッドでは、返される情報内のミラーはコレクションで表され、そのコレクションには各ミラーの情報が格納されます。 Java の場合 SDK に関する限り、イメージ情報はリストに格納されます。まず getImages() を通じて Image オブジェクトのコレクションを取得し、次にトラバーサルやその他のメソッドを通じてイメージの 1 つの情報を取得する必要があります。次に、getXxx メソッドを呼び出して特定の情報を取得します。
for(Image image:response.getImages()) { System.out.println(image.getImageId()); System.out.println(image.getImageName()); }
この時点で、完全な通話が完了します。
PHP SDK の注意事項PHP SDK と Java SDK の使用の類似点は次のように要約できます:
プロファイルの作成。
クライアントを作成します。
リクエストを作成します。
リクエストのパラメータを設定します。
クライアントの対応するメソッドを使用してリクエストを渡し、レスポンスを取得します。
レスポンスで返されたパラメータ値を取得します。
Python SDK ノートPython SDK を使用すると、プロファイルを作成する手順が省略され、クライアントを直接作成してから、次の手順を実行します。 。
以上がAccessKeyを用意した後のECS SDKの使い方の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。