すべてのプロダクト
Search
ドキュメントセンター

:GetVpcPeerConnectionAttribute

最終更新日:Dec 07, 2025

指定された 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:GetVpcPeerConnectionAttribute

get

*PeerConnection

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

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

InstanceId

string

必須

VPC ピアリング接続の ID。

pcc-lnk0m24khwvtkm****

レスポンスフィールド

フィールド

説明

object

リクエスト ID。

RequestId

string

リクエスト ID。

473469C7-AA6F-4DC5-B3DB-A3AC0DE3C83E

InstanceId

string

VPC ピアリング接続の ID。

pcc-lnk0m24khwvtkm****

GmtCreate

string

VPC ピアリング接続が作成された時刻。時刻は、YYYY-MM-DDThh:mm:ssZ フォーマットの UTC で表示されます。

2022-04-24T09:02:36Z

GmtModified

string

VPC ピアリング接続が最後に変更された時刻。時刻は、YYYY-MM-DDThh:mm:ssZ フォーマットの UTC で表示されます。

2022-04-24T19:20:45Z

Name

string

VPC ピアリング接続の名前。

vpcpeer

Description

string

VPC ピアリング接続の説明。

test

OwnerId

integer

リクエスト元 VPC が属する Alibaba Cloud アカウントの ID。

25346073170691****

AcceptingOwnerUid

integer

リクエスト先 VPC が属する Alibaba Cloud アカウントの ID。

28311773240248****

RegionId

string

リクエスト元 VPC のリージョン ID。

cn-hangzhou

AcceptingRegionId

string

リクエスト先 VPC のリージョン ID。

cn-hangzhou

Bandwidth

integer

VPC ピアリング接続の帯域幅。単位: Mbps。値は 0 より大きい整数である必要があります。

説明

-1 の値は、帯域幅に制限がないことを示します。

デフォルト値:

  • リージョン間 VPC ピアリング接続のデフォルト帯域幅は 1,024 Mbps です。

  • リージョン内 VPC ピアリング接続のデフォルト帯域幅は -1 Mbps です。これは、帯域幅に制限がないことを示します。

1024

Status

string

VPC ピアリング接続のステータス。有効な値:

  • Creating

  • Accepting

  • Updating

  • Rejected

  • Expired

  • Activated

  • Deleting

  • Deleted

詳細については、「VPC ピアリング接続の概要」をご参照ください。

Activated

BizStatus

string

VPC ピアリング接続のビジネスステータス。有効な値:

  • Normal

  • FinancialLocked: 支払い遅延により VPC ピアリング接続がロックされています。

Normal

GmtExpired

string

VPC ピアリング接続の有効期限が切れる時刻。

このパラメーターは、VPC ピアリング接続の StatusAccepting または Expired の場合にのみ返されます。他のステータスの場合、戻り値は null です。

2022-05-01T09:02:36Z

ResourceGroupId

string

リソースグループの ID。

rg-acfmxazb4ph6aiy****

Vpc

object

リクエスト元 VPC の詳細。

VpcId

string

リクエスト元 VPC の ID。

vpc-bp1gsk7h12ew7oegk****

Ipv4Cidrs

array

リクエスト元 VPC の IPv4 CIDR ブロック。

string

リクエスト元 VPC の IPv4 CIDR ブロック。

192.168.0.0/16

Ipv6Cidrs

array

リクエスト元 VPC の IPv6 CIDR ブロック。

string

リクエスト元 VPC の IPv6 CIDR ブロック。

2408:XXXX:3c5:6e00::/56

AcceptingVpc

object

リクエスト先 VPC の詳細。

VpcId

string

リクエスト先 VPC の ID。

vpc-bp1vzjkp2q1xgnind****

Ipv4Cidrs

array

リクエスト先 VPC の IPv4 CIDR ブロック。

string

リクエスト先 VPC の IPv4 CIDR ブロック。

10.0.0.0/16

Ipv6Cidrs

array

リクエスト先 VPC の IPv6 CIDR ブロック。

string

リクエスト先 VPC の IPv6 CIDR ブロック。

2408:XXXX:3b8:3a00::/56

Tags

array<object>

タグのリスト。

object

タグのリスト。

Key

string

タグキー。

FinanceDept

Value

string

タグの値。

FinanceJoshua

LinkType

string

VPC ピアリング接続のリンクタイプ。

デフォルト値:

  • リージョン間 VPC ピアリング接続のデフォルトのリンクタイプは Gold です。

  • リージョン内 VPC ピアリング接続のデフォルトのリンクタイプは空です。

Gold

ManagedService

string

リソースが属する Alibaba Cloud サービス。

SWAS

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 ResourceNotFound.InstanceId The specified resource of %s is not found.

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

変更履歴

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