Tüm Ürünler
Search
Belge Merkezi

:DescribeRoleZoneInfo

Son Güncelleme:Oct 03, 2026

Bu işlemi, bir ApsaraDB for MongoDB örneğindeki düğümlerin rollerini ve alanlarını sorgulamak için kullanabilirsiniz.

Not

Daha fazla bilgi için bkz.

Bir düğümün alanını görüntüleme

.

Bu işlem yalnızca çoğaltma kümesi ve parçalanmış küme örneklerinde kullanılabilir; tek başına (standalone) örneklerde kullanılamaz.

Hata Ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer içinde çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlemin örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre

Tür

Gerekli

Örnek

Açıklama

Action

String

Evet

DescribeRoleZoneInfo

Gerçekleştirmek istediğiniz işlem. Değeri DescribeRoleZoneInfo olarak ayarlayın.

DBInstanceId

String

Evet

dds-bpxxxxxxxx

Örneğin ID'si.

RegionId

String

Hayır

cn-hangzhou

Örneğin bölge kimliği. Örneğin bölge kimliğini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

Yanıt parametreleri

Parametre Tür Örnek Açıklama
RequestId String 728B9A96-E262-4AE5-915E-3A51CCE2FDA9

İsteğin ID'si.

ZoneInfos Array

Alandaki düğümlerin bilgilerini içeren bir dizi.

ZoneInfo
InsName String dds-bpxxxxxxxx

Düğümün ID'si.

NodeType String normal

Düğüm türü. Geçerli değerler:

  • normal
  • configServer
  • shard
  • mongos
Not Çoğaltma kümesi örnekleri için geçerli değer: normal. Parçalanmış küme örnekleri için geçerli değerler: configServer, shard ve mongos.
RoleId String 83xxxxx

Rolün ID'si.

RoleType String Primary

Düğümün rolü. Geçerli değerler:

  • Primary
  • Secondary
  • Hidden
ZoneId String cn-hangzhou-e

Alan ID'si.

Örnekler

Örnek istek

http(s)://mongodb.aliyuncs.com/? Action=DescribeRoleZoneInfo
&DBInstanceId=dds-bpxxxxxxxx
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

<DescribeRoleZoneInfoResponse>
	  <ZoneInfos>
		    <ZoneInfo>
			      <RoleType>Primary</RoleType>
			      <NodeType>normal</NodeType>
			      <InsName>dds-bpxxxxxxxx</InsName>
			      <ZoneId>cn-hangzhou-e</ZoneId>
			      <RoleId>83xxxxx</RoleId>
		    </ZoneInfo>
		    <ZoneInfo>
			      <RoleType>Secondary</RoleType>
			      <NodeType>normal</NodeType>
			      <InsName>dds-bpxxxxxxxx</InsName>
			      <ZoneId>cn-hangzhou-f</ZoneId>
			      <RoleId>83xxxxx</RoleId>
		    </ZoneInfo>
		    <ZoneInfo>
			      <RoleType>Hidden</RoleType>
			      <NodeType>normal</NodeType>
			      <InsName>dds-bpxxxxxxxx</InsName>
			      <ZoneId>cn-hangzhou-b</ZoneId>
			      <RoleId>83xxxxx</RoleId>
		    </ZoneInfo>
	  </ZoneInfos>
	  <RequestId>728B9A96-E262-4AE5-915E-3A51CCE2FDA9</RequestId>
</DescribeRoleZoneInfoResponse>

JSON biçimi

{
	"ZoneInfos": {
		"ZoneInfo": [
			{
				"RoleType": "Primary",
				"NodeType": "normal",
				"InsName": "dds-bpxxxxxxxx",
				"ZoneId": "cn-hangzhou-e",
				"RoleId": "83xxxxx"
			},
			{
				"RoleType": "Secondary",
				"NodeType": "normal",
				"InsName": "dds-bpxxxxxxxx",
				"ZoneId": "cn-hangzhou-f",
				"RoleId": "83xxxxx"
			},
			{
				"RoleType": "Hidden",
				"NodeType": "normal",
				"InsName": "dds-bpxxxxxxxx",
				"ZoneId": "cn-hangzhou-b",
				"RoleId": "83xxxxx"
			}
		]
	},
	"RequestId": "728B9A96-E262-4AE5-915E-3A51CCE2FDA9"
}

Hata kodları

Hata kodlarının listesi için API Hata Merkezi sayfasını ziyaret edin.