ListVpcPeerConnections による VPC ピアリング接続の一括クエリ - VPC

1 つ以上の VPC ピアリング接続の詳細をクエリします。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

vpc:ListVpcPeerConnections

list

*VpcPeer

acs:vpc:*:{#AccountId}:vpcpeer/{#InstanceId}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	任意	VPC ピアリング接続のリージョン ID。 DescribeRegions 操作を呼び出して、リージョン ID を取得できます。	cn-hangzhou
InstanceId	string	任意	VPC ピアリング接続の ID。	pcc-lnk0m24khwvtkm****
VpcId	array	任意	ピアリング接続内の VPC の ID。リクエスト元 VPC またはリクエスト先 VPC の ID を指定できます。 VPC ID を 1 つだけ指定した場合、クエリは指定された VPC に関連するすべてのピアリング接続を返します。
	string	任意	リクエスト元 VPC またはリクエスト先 VPC の ID。	vpc-bp1gsk7h12ew7oegk****
Name	string	任意	VPC ピアリング接続の名前。	vpcpeer
NextToken	string	任意	次のクエリに使用されるトークン。有効な値: 最初のリクエストでは、このパラメーターを指定しないでください。前のクエリから取得したトークンを NextToken の値として指定する必要があります。	FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResults	integer	任意	各ページに返すエントリ数。有効な値: 1～100。デフォルト値: 20。	20
Tags	array<object>	任意	タグ。
	object	任意	タグ。
Value	string	任意	タグの値。最大 20 個のタグ値を指定できます。タグ値は空の文字列にすることができます。値の長さは 128 文字までです。 `aliyun` または `acs:` で始めることはできず、`http://` または `https://` を含めることはできません。	FinanceJoshua
Key	string	任意	タグキー。最大 20 個のタグキーを指定できます。タグキーを空の文字列にすることはできません。キーの長さは 128 文字までです。 `aliyun` または `acs:` で始めることはできず、`http://` または `https://` を含めることはできません。	FinanceDept
ResourceGroupId	string	任意	リソースグループの ID。リソースグループの詳細については、「リソースグループとは」をご参照ください。	rg-acfmxazb4ph6aiy****

レスポンスフィールド

フィールド	型	説明	例
	object	リクエスト ID。
RequestId	string	リクエスト ID。	0ED8D006-F706-4D23-88ED-E11ED39DCAC0
TotalCount	integer	エントリ数。	1
MaxResults	integer	各ページに返すエントリ数。有効な値: 1～100。デフォルト値: 20。	20
NextToken	string	次のクエリに使用されるトークン。有効な値: NextToken が空の場合、それ以上の結果はありません。 NextToken に値が返された場合、その値は次のリクエストでより多くの結果を取得するために使用できるトークンです。	FFmyTO70tTpLG6I3FmYAXGKPd****
VpcPeerConnects	array<object>	VPC ピアリング接続の詳細。
	array<object>	VPC ピアリング接続の詳細。
AcceptingOwnerUid	integer	リクエスト先 VPC が属する Alibaba Cloud アカウントの ID。	25346073170691****
Status	string	VPC ピアリング接続のステータス。有効な値: Creating Accepting Updating Rejected Expired Activated Deleting Deleted VPC ピアリング接続のステータスの詳細については、「VPC ピアリング接続の概要」をご参照ください。	Activated
Description	string	VPC ピアリング接続の説明。	test
ResourceGroupId	string	リソースグループの ID。	rg-acfmxazb4ph6aiy****
InstanceId	string	VPC ピアリング接続の ID。	pcc-lnk0m24khwvtkm****
AcceptingRegionId	string	リクエスト先 VPC のリージョン ID。	cn-hangzhou
GmtModified	string	VPC ピアリング接続が変更された時刻。時刻は UTC で `YYYY-MM-DDThh:mm:ssZ` フォーマットで表示されます。	2022-04-24T19:20:45Z
Vpc	object	リクエスト元 VPC の詳細。
VpcId	string	リクエスト元 VPC の ID。	vpc-bp1gsk7h12ew7oegk****
Ipv6Cidrs	array	リクエスト元 VPC の IPv6 CIDR ブロック。
	string	リクエスト元 VPC の IPv6 CIDR ブロック。	2408:XXXX:3c5:6e00::/56
Ipv4Cidrs	array	リクエスト元 VPC の IPv4 CIDR ブロック。
	string	リクエスト元 VPC の IPv4 CIDR ブロック。	192.168.0.0/16
GmtExpired	string	VPC ピアリング接続の有効期限が切れる時刻。時刻は UTC で `YYYY-MM-DDThh:mm:ssZ` フォーマットで表示されます。このパラメーターは、VPC ピアリング接続が Accepting または Expired 状態の場合にのみ返されます。他のステータスの場合、このパラメーターは空です。	2022-05-01T09:02:36Z
Name	string	VPC ピアリング接続の名前。	vpcpeer
BizStatus	string	VPC ピアリング接続のビジネスステータス。有効な値: Normal FinancialLocked: VPC ピアリング接続は、支払い遅延のためロックされています。	Normal
GmtCreate	string	VPC ピアリング接続が作成された時刻。時刻は UTC で `YYYY-MM-DDThh:mm:ssZ` フォーマットで表示されます。	2022-04-24T09:02:36Z
OwnerId	integer	リクエスト元 VPC が属する Alibaba Cloud アカウントの ID。	25346073170691****
Bandwidth	integer	VPC ピアリング接続の帯域幅。単位: Mbit/s。値は 0 より大きい整数である必要があります。説明 -1 の値は、帯域幅に制限がないことを示します。デフォルト値: リージョン間 VPC ピアリング接続のデフォルト帯域幅は 1024 Mbit/s です。リージョン内 VPC ピアリング接続のデフォルト帯域幅は -1 です。この値は、帯域幅に制限がないことを示します。	1024
RegionId	string	リクエスト元 VPC のリージョン ID。	cn-hangzhou
AcceptingVpc	object	リクエスト先 VPC の詳細。
VpcId	string	リクエスト先 VPC の ID。	vpc-bp1vzjkp2q1xgnind****
Ipv6Cidrs	array	リクエスト先 VPC の IPv6 CIDR ブロック。
	string	リクエスト先 VPC の IPv6 CIDR ブロック。	2408:XXXX:3b8:3a00::/56
Ipv4Cidrs	array	リクエスト先 VPC の IPv4 CIDR ブロック。
	string	リクエスト先 VPC の IPv4 CIDR ブロック。	10.0.0.0/16
LinkType	string	VPC ピアリング接続のリンクタイプ。デフォルト値: リージョン間 VPC ピアリング接続のデフォルトのリンクタイプは Gold です。リージョン内 VPC ピアリング接続のデフォルトのリンクタイプは空です。	Gold
Tags	array<object>	タグ。
	object	タグ。
Value	string	タグの値。	FinanceJoshua
Key	string	タグキー。	FinanceDept
ManagedService	string	リソースが属する Alibaba Cloud サービス。	SWAS

例

成功レスポンス

JSONJSON

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED39DCAC0",
  "TotalCount": 1,
  "MaxResults": 20,
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "VpcPeerConnects": [
    {
      "AcceptingOwnerUid": 0,
      "Status": "Activated",
      "Description": "test",
      "ResourceGroupId": "rg-acfmxazb4ph6aiy****",
      "InstanceId": "pcc-lnk0m24khwvtkm****",
      "AcceptingRegionId": "cn-hangzhou",
      "GmtModified": "2022-04-24T19:20:45Z",
      "Vpc": {
        "VpcId": "vpc-bp1gsk7h12ew7oegk****",
        "Ipv6Cidrs": [
          "2408:XXXX:3c5:6e00::/56"
        ],
        "Ipv4Cidrs": [
          "192.168.0.0/16"
        ]
      },
      "GmtExpired": "2022-05-01T09:02:36Z",
      "Name": "vpcpeer",
      "BizStatus": "Normal",
      "GmtCreate": "2022-04-24T09:02:36Z",
      "OwnerId": 0,
      "Bandwidth": 1024,
      "RegionId": "cn-hangzhou",
      "AcceptingVpc": {
        "VpcId": "vpc-bp1vzjkp2q1xgnind****",
        "Ipv6Cidrs": [
          "2408:XXXX:3b8:3a00::/56"
        ],
        "Ipv4Cidrs": [
          "10.0.0.0/16"
        ]
      },
      "LinkType": "Gold",
      "Tags": [
        {
          "Value": "FinanceJoshua",
          "Key": "FinanceDept"
        }
      ],
      "ManagedService": "SWAS"
    }
  ]
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。