Query Requests and Response

Description

このセクションでは、クエリリクエストについて説明します。 クエリリクエストは、HTTP メソッド（GET または POST）とクエリパラメータ Action で記述する HTTP または HTTPS リクエストです。

Contents

Query Requests

クエリリクエストは以下で構成されています。

  • エンドポイント

    ウェブサービスのエントリポイントとして機能する URL。

  • アクション

    実行するアクション。

    パラメータの1つで、Action=<アクション>のように指定します。

  • パラメータ

    各パラメータは、アンパサンド（&）で区切ります。

    パラメータの中にはリスト構造のものがあります。

    これらのリストは param.n の表記法で指定されます。

    n は 1 から始まる整数です。

Query Request Example

以下の例では、「https://loadbalancing.(リージョン名).cloud.global.fujitsu.com/」 がエンドポイント、「CreateLoadBalancer」がアクション、それ以外がパラメータとなります。


https://loadbalancing.(リージョン名).cloud.global.fujitsu.com/?LoadBalancerName=MyLB01
&Listeners.member.1.LoadBalancerPort=80
&Listeners.member.1.InstancePort=80
&Listeners.member.1.Protocol=http
&Listeners.member.1.InstanceProtocol=http
&Scheme=internal
&Subnets.member.1=subnet-3561b05d
&Version=2014-11-01
&Action=CreateLoadBalancer

Query Response

クエリレスポンスの構造は、オペレーションによって固有です。

すべてのレスポンスのrequestId要素に、リクエストIDが含まれます。

リクエストIDは問題のトラブルシューティングを行うために必要になります。

「DescribeLoadBalancerAttributes」、「DescribeLoadBalancerPolicies」、「DescribeLoadBalancers」以外のAPIを実行し、ステータスコードが200 正常応答した場合、「DescribeLoadBalancers」で結果およびStateを確認してください。StateがInServiceになっていることを確認してから、次のAPIを実行してください。StateがErrorになっている場合、ErrorDescriptionの情報を確認してください。

  • ErrorDescriptionが"No more IP addresses available on Subnet '_subnet_id_'"の場合、SubnetのIPアドレスが不足しています。Subnetに割り当て可能なIPアドレスを確保してから、直前のオペレーションを再実行してください。
  • ErrorDescriptionが"No more Floating IP available on Network '_network_id_'"の場合、NetworkのFloating IPが不足しています。ErrorDescriptionの情報を運用管理者に通知し、調査を依頼してください。
  • ErrorDescriptionが上記以外の場合、直前のオペレーションを再実行してください。ただし、直前のオペレーションが「AttachLoadBalancerToSubnets」、「CreateLoadBalancer」、「DeregisterInstancesFromLoadBalancer」であった場合、以下の手順に従ってください。 再実行してもStateが変更されない場合、ErrorDescriptionの情報を運用管理者に通知し、調査を依頼してください。

APIを実行した結果、ステータスコードが200 以外の場合は、「Common Errors」もしくは、実行したAPIのErrorsを参考に原因を取り除いてください。

Query Response Example

以下の例では、「1549581b-12b7-11e3-895e-1334aEXAMPLE」がリクエストIDになります。


{
  "CreateLoadBalancerResponse": {
    "CreateLoadBalancerResult": {
      "DNSName": "MyLB01-3b9c2b0f028f40e09d6306887646c28b.elb.tps5.fujitsu.com"
    },
    "ResponseMetadata": {
      "RequestId": "1549581b-12b7-11e3-895e-1334aEXAMPLE"
    }
  }
}