ListTagResources - - Alibaba Cloud Dokümantasyon Merkezi

Not

ListTagResources işlemini çağırırken istekte aşağıdaki parametrelerden en az birini belirtmelisiniz: Tag.N.Key ve ResourceId.N. Belirtilen kaynağa ekli tüm etiketleri sorgulamak için kaynak kimliği belirtebilirsiniz. Ayrıca, bir etiket anahtarı belirterek etiket değerini ve etiketin eklendiği kaynağı da sorgulayabilirsiniz.

İstekte Tag.N.Key parametresini belirtirseniz etiket değerini ve etiketin bağlı olduğu kaynağın kimliğini elde edebilirsiniz.
İstekte ResourceId.N parametresini belirtirseniz belirtilen kaynağa ekli tüm etiketlerin anahtarlarını ve değerlerini elde edebilirsiniz.

QPS sınırı

Her Alibaba Cloud hesabı bu işlemi saniyede en fazla 10 kez çağırabilir. Bir saniye içinde bu işlem için gönderilen istek sayısı saniyedeki sorgu sayısını (QPS) aşarsa kısıtlama tetiklenir. Bu durum iş süreçlerinizi kesintiye uğratabilir. Her işlemin QPS sınırı hakkında bilgi için bkz. API oran sınırları.

Yetkilendirme

Varsayılan olarak Alibaba Cloud hesapları bu işlemi çağırabilir. Bir Resource Access Management (RAM) kullanıcısı yalnızca gerekli izinler verildikten sonra bu işlemi çağırabilir. Aşağıdaki tabloda, bu işlemi çağırmak için bir RAM kullanıcısına verilmesi gereken izinler açıklanmaktadır. İzinlerin nasıl verileceği hakkında bilgi için bkz. İlkeler.

API

Action

Resource

ListTagResources

mq:QueryInstanceBaseInfo

mq:ListTagResources

acs:mq:::*

acs:mq:::{InstanceId}

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	ListTagResources	Gerçekleştirmek istediğiniz işlem. Değeri ListTagResources olarak ayarlayın.
InstanceId	String	Hayır	MQ_INST_188077086902****_BXSuW61e	Etiketlerini sorgulamak istediğiniz kaynağın ait olduğu Message Queue for Apache RocketMQ örneğinin kimliği. Not Bu parametre, bir konu veya grubun etiketlerini sorgularken gereklidir.
ResourceType	String	Evet	TOPIC	Etiketlerini sorgulamak istediğiniz kaynağın türü. Değer bir numaralandırılmış değerdir. Geçerli değerler: INSTANCE TOPIC GROUP
NextToken	String	Hayır	caeba0****be03f84eb48b699f0a4883	Sonraki sayfayı sorgulamak için kullanılan belirteç.
Tag.N.Key	String	Hayır	CartService	Sorgulamak istediğiniz etiketin anahtarı. N değeri 1 ile 20 arasında bir sayı olabilir. Bu parametreyi bir isteğe dahil ederseniz bu parametrenin değeri boş bir dize olamaz. Bu parametrenin değeri en fazla 128 karakter uzunluğunda olabilir ve acs: veya aliyun ile başlayamaz ya da http:// veya https:// içeremez.
Tag.N.Value	String	Hayır	ServiceA	Sorgulamak istediğiniz etiketin değeri. N değeri 1 ile 20 arasında bir sayı olabilir. Bu parametrenin değeri boş bir dize olabilir. Bu parametrenin değeri en fazla 128 karakter uzunluğunda olabilir ve acs: veya aliyun ile başlayamaz ya da http:// veya https:// içeremez.
ResourceId.N	String	Hayır	test	Etiketlerini sorgulamak istediğiniz kaynağın kimliği. Kaynak bir Message Queue for Apache RocketMQ örneği ise örneğin kimliğini belirtin. Kaynak bir konu ise konunun adını belirtin. Kaynak bir grup ise grubun kimliğini belirtin.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
NextToken	String	caeba0****be03f84eb48b699f0a4883	Sonraki sayfayı sorgulamak için kullanılan belirteç.
RequestId	String	301D2CBE-66F8-403D-AEC0-82582478****	İsteğin kimliği. Sistem her istek için benzersiz bir kimlik oluşturur. Sorunları istek kimliğine göre giderebilirsiniz.
TagResources	Array of TagResource		Kaynak kimliği, kaynak türü ve etiketlerin anahtarları ile değerleri dahil olmak üzere kaynak ve etiketlerin ayrıntıları.
ResourceType	String	ALIYUN::MQ::TOPIC	Kaynağın türü. ALIYUN::MQ::INSTANCE: Kaynağın bir Message Queue for Apache RocketMQ örneği olduğunu gösterir. ALIYUN::MQ::TOPIC: Kaynağın bir konu olduğunu gösterir. ALIYUN::MQ::GROUP: Kaynağın bir grup olduğunu gösterir.
InstanceId	String	MQ_INST_188077086902****_BXSuW61e	Kaynağın ait olduğu Message Queue for Apache RocketMQ örneğinin kimliği.
TagValue	String	ServiceA	Etiketin değeri.
ResourceId	String	TopicA	Kaynağın kimliği.
TagKey	String	CartService	Etiketin anahtarı.

Örnekler

Örnek istekler

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=ListTagResources
&ResourceType=TOPIC
&ResourceId.1=TopicA
&InstanceId=MQ_INST_188077086902****_BXSuW61e
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTagResourcesResponse>
<RequestId>301D2CBE-66F8-403D-AEC0-82582478****</RequestId>
<NextToken>caeba0****be03f84eb48b699f0a4883</NextToken>
<TagResources>
    <ResourceId>TopicA</ResourceId>
    <InstanceId>MQ_INST_188077086902****_BXSuW61e</InstanceId>
    <TagKey>CartService</TagKey>
    <ResourceType>ALIYUN::MQ::TOPIC</ResourceType>
    <TagValue>ServiceA</TagValue>
</TagResources>
</ListTagResourcesResponse>

JSON biçimi

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "301D2CBE-66F8-403D-AEC0-82582478****",
  "NextToken" : "caeba0****be03f84eb48b699f0a4883",
  "TagResources" : {
    "ResourceId" : "TopicA",
    "InstanceId" : "MQ_INST_188077086902****_BXSuW61e",
    "TagKey" : "CartService",
    "ResourceType" : "ALIYUN::MQ::TOPIC",
    "TagValue" : "ServiceA"
  }
}

Hata kodları

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

Konsolda bir kaynağın etiketlerini görüntüleme

Message Queue for Apache RocketMQ konsolu üzerinde bir kaynağa ekli etiketleri görüntüleyebilirsiniz. Daha fazla bilgi için bkz. Etiketleri yönetme.