ListTransitRouterPeerAttachments - - Alibaba Cloud Dokümantasyon Merkezi

ListTransitRouterPeerAttachments işlemini çağırarak Cloud Enterprise Network aktarım yönlendiricisi altındaki bölgeler arası bağlantıların ayrıntılarını sorgular.

Operation description

Cloud Enterprise Network aktarım yönlendiricisi altındaki bölgeler arası bağlantıları aşağıdaki yollarla sorgulayabilirsiniz:

Aktarım yönlendiricisi örnek kimliğini belirterek bir Cloud Enterprise Network aktarım yönlendiricisi altındaki tüm bölgeler arası bağlantıları sorgulayın.
Cloud Enterprise Network (CEN) örnek kimliğini ve Cloud Enterprise Network aktarım yönlendiricisi örneğinin bölge kimliğini belirterek bir Cloud Enterprise Network aktarım yönlendiricisi altındaki tüm bölgeler arası bağlantıları sorgulayın.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

cen:ListTransitRouterPeerAttachments

get

*CenInstance

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

TransitRouterPeerAttachment

acs:cen:*:{#accountId}:centransitrouterattachment/*

TransitRouterPeerAttachment

acs:cen:*:{#accountId}:centransitrouterattachment/{#centransitrouterattachmentId}

None

Request parameters

Parameter	Type	Required	Description	Example
CenId	string	No	CEN örnek kimliği.	cen-j3jzhw1zpau2km****
RegionId	string	No	Cloud Enterprise Network aktarım yönlendiricisi örneğinin bölge kimliği. Bölge kimliğini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.	cn-hangzhou
TransitRouterAttachmentId	string	No	Bölgeler arası bağlantı kimliği.	tr-attach-5u4qbayfv2io5v****
TransitRouterId	string	No	Cloud Enterprise Network aktarım yönlendiricisi örnek kimliği.	tr-bp1su1ytdxtataupl****
MaxResults	integer	No	Sayfalanmış bir sorgu için sayfa başına giriş sayısı. Varsayılan değer: 20. Maksimum değer: 100.	20
NextToken	string	No	Sorgunun başlangıç noktasını belirleyen belirteç. Geçerli değerler: Bu ilk sorguysa veya sonraki bir sorgu gönderilmeyecekse, bu parametreyi belirtmenize gerek yoktur. Sonraki bir sorgu gönderilecekse, değeri önceki API çağrısında döndürülen NextToken değerine ayarlayın.	1
Tag	array<object>	No	Etiket bilgileri. Tek seferde en fazla 20 etiket belirtebilirsiniz.
	object	No
Key	string	No	Kaynağın etiket anahtarı. Belirtildikten sonra etiket anahtarı boş bir dize olamaz. Etiket anahtarı en fazla 64 karakter uzunluğunda olabilir ve `aliyun` veya `acs:` ile başlayamaz. `http://` veya `https://` içeremez. Tek seferde en fazla 20 etiket anahtarı belirtebilirsiniz.	tagtest
Value	string	No	Kaynağın etiket değeri. Etiket değeri boş bir dize olabilir veya en fazla 128 karakter uzunluğunda olabilir. `aliyun` veya `acs:` ile başlayamaz ve `http://` veya `https://` içeremez. Her etiket anahtarı bir etiket değerine karşılık gelir. Tek seferde en fazla 20 etiket değeri belirtebilirsiniz.	tagtest

Response elements

Element	Type	Description	Example
	object	Yanıt parametreleri.
NextToken	string	Sonraki sorgunun başlangıç noktasını belirleyen belirteç. Geçerli değerler: NextToken boşsa, sonraki bir sorgu gönderilmeyecektir. NextToken döndürülürse, değer sonraki sorgu için belirteci gösterir.	dd20****
RequestId	string	İstek kimliği.	AA97AFA3-8E48-4BD7-9F3E-A9F6176018A0
TotalCount	integer	Döndürülen toplam giriş sayısı.	1
MaxResults	integer	Sayfalanmış bir sorgu için sayfa başına giriş sayısı.	20
TransitRouterAttachments	array<object>	Bölgeler arası bağlantıların listesi.
	array<object>	Bölgeler arası bağlantı bilgileri.
CreationTime	string	Bölgeler arası bağlantının oluşturulduğu zaman. Zaman, UTC cinsinden ISO 8601 standardında görüntülenir. Biçim: `YYYY-MM-DDThh:mmZ`.	2021-06-16T02:50Z
Status	string	Bölgeler arası bağlantının durumu. Attached: eklendi. Attaching: ekleniyor. Detaching: ayrılıyor. Detached: ayrıldı.	Attached
TransitRouterAttachmentId	string	Bölgeler arası bağlantı kimliği.	tr-attach-5u4qbayfv2io5v****
BandwidthType	string	Bant genişliği tahsis yöntemi. Geçerli değerler: BandwidthPackage: Bant genişliği bir bant genişliği paketinden tahsis edilir. DataTransfer: Bölgeler arası bağlantıya bant genişliği tahsis edilmez. Veri aktarımı kullandıkça öde şeklindedir.	BandwidthPackage
CenBandwidthPackageId	string	Bölgeler arası bağlantıyla ilişkili bant genişliği paketinin kimliği.	cenbwp-3xrxupouolw5ou****
TransitRouterAttachmentDescription	string	Bölgeler arası bağlantının açıklaması.	testdesc
RegionId	string	Cloud Enterprise Network aktarım yönlendiricisinin bölge kimliği.	cn-hangzhou
PeerTransitRouterId	string	Karşı aktarım yönlendiricisinin örnek kimliği.	tr-m5eq27g6bndum7e88****
TransitRouterId	string	Cloud Enterprise Network aktarım yönlendiricisi örnek kimliği.	tr-bp1su1ytdxtataupl****
PeerTransitRouterRegionId	string	Karşı aktarım yönlendiricisi örneğinin bölge kimliği.	cn-qingdao
ResourceType	string	Bağlantıyla ilişkili kaynağın türü. VPC: sanal özel bulut (VPC) örneği. CCN: Cloud Connect Network örneği. VBR: sanal sınır yönlendiricisi (VBR) örneği. TR: aktarım yönlendiricisi örneği.	TR
Bandwidth	integer	Bölgeler arası bağlantının bant genişliği değeri. Birim: Mbit/s. BandwidthType, BandwidthPackage olarak ayarlanmışsa, bu parametre bölgeler arası bağlantının kullanabileceği bant genişliğini gösterir. BandwidthType, DataTransfer olarak ayarlanmışsa, bu parametre bölgeler arası bağlantının bant genişliği sınırını gösterir.	2
GeographicSpanId	string	Bant genişliği paketinin bağladığı bölgeler.	china_china
PeerTransitRouterOwnerId	integer	Karşı aktarım yönlendiricisi örneğinin ait olduğu hesabın kimliği.	253460731706911258
AutoPublishRouteEnabled	boolean	Cloud Enterprise Network aktarım yönlendiricisi örneğinin, bölgeler arası bağlantının rotalarını karşı bölgeye otomatik olarak duyurup duyurmadığını gösterir. false (varsayılan): Hayır. true: Evet.	false
TransitRouterAttachmentName	string	Bölgeler arası bağlantının adı.	test
Tags	array<object>	Etiket listesi.
	object
Key	string	Etiket anahtarı.	tag_A1
Value	string	Etiket değeri.	test
CenId	string	CEN örnek kimliği.	cen-j3jzhw1zpau2km****
DefaultLinkType	string	Varsayılan bağlantı türü. Gold (varsayılan): altın. Platinum: platin.	Gold

Examples

Success response

JSON format

{
  "NextToken": "dd20****",
  "RequestId": "AA97AFA3-8E48-4BD7-9F3E-A9F6176018A0",
  "TotalCount": 1,
  "MaxResults": 20,
  "TransitRouterAttachments": [
    {
      "CreationTime": "2021-06-16T02:50Z",
      "Status": "Attached",
      "TransitRouterAttachmentId": "tr-attach-5u4qbayfv2io5v****",
      "BandwidthType": "BandwidthPackage",
      "CenBandwidthPackageId": "cenbwp-3xrxupouolw5ou****",
      "TransitRouterAttachmentDescription": "testdesc",
      "RegionId": "cn-hangzhou",
      "PeerTransitRouterId": "tr-m5eq27g6bndum7e88****",
      "TransitRouterId": "tr-bp1su1ytdxtataupl****",
      "PeerTransitRouterRegionId": "cn-qingdao",
      "ResourceType": "TR",
      "Bandwidth": 2,
      "GeographicSpanId": "china_china",
      "PeerTransitRouterOwnerId": 253460731706911260,
      "AutoPublishRouteEnabled": false,
      "TransitRouterAttachmentName": "test",
      "Tags": [
        {
          "Key": "tag_A1",
          "Value": "test"
        }
      ],
      "CenId": "cen-j3jzhw1zpau2km****\n",
      "DefaultLinkType": "Gold"
    }
  ]
}

Error codes

HTTP status code	Error code	Error message	Description
400	IllegalParam.NextToken	The specified NextToken is invalid.	The error message returned because the NextToken parameter is set to an invalid value.
400	IllegalParam.TrInstance	The specified TransitRouter is invalid.	The error message returned because the TransitRouter parameter is set to an invalid value.
400	IllegalParam.Region	The specified Region is invalid.	The error message returned because the specified region is invalid.
400	IllegalParam.CenId	The specified CenId is invalid.	The error message returned because the ID of the CEN instance is invalid.
400	IllegalParam.TransitRouterId	The specified TransitRouterId is invalid.	The error message returned because the specified transit router ID is invalid.
400	IllegalParam.RegionIdOrTransitRouterId	The specified TransitRouterId or RegionId is invalid.	The error message returned because the specified transit router ID or region is invalid.
400	IllegalParam.CenIdOrRegionId	The specified CenId or RegionId is invalid.	The error message returned because the specified CEN instance ID or region ID is invalid.
400	IllegalParam.TagKey	The tag keys are not valid.	The error message returned because the specified tag key is invalid.
400	IllegalParam.TagValue	The tag values are not valid.	The error message returned because the specified tag value is invalid.
400	IllegalParam.MaxResults	The specified MaxResults is invalid.	The MaxResults value is invalid.
400	InvalidParameter	Invalid parameter.	The error message returned because the parameter is set to an invalid value.
400	Unauthorized	The AccessKeyId is unauthorized.	The error message returned because you do not have the permissions to perform this operation.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.