OnsInstanceBaseInfo - - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Mesaj yayınlamak ve bu mesajlara abone olmak için istemcinin bir Message Queue for Apache RocketMQ örneğine uç nokta üzerinden bağlanması gerekir. Bu işlemi çağırarak örneğin uç noktalarını sorgulayabilirsiniz.

İstek sınırları

Bu işlemi her Alibaba Cloud hesabı için saniyede en fazla 50 kez çağırabilirsiniz. Saniye başına yapılan çağrı sayısı sınırı aşarsa kısıtlama (throttling) uygulanır; bu durum iş süreçlerinizi etkileyebilir. Bu işlemi çağırırken söz konusu sınıra dikkat etmenizi öneririz. Daha fazla bilgi için bkz. İstek sınırları.

Yetkilendirme

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

API	Action	Resource
OnsInstanceBaseInfo	mq:QueryInstanceBaseInfo	acs:mq:::{instanceId}

İstek parametreleri

Parametre	Tür	Zorunlu	Örnek	Açıklama
Action	String	Evet	OnsInstanceBaseInfo	Gerçekleştirmek istediğiniz işlem. Değeri OnsInstanceBaseInfo olarak ayarlayın.
InstanceId	String	Evet	MQ_INST_138015630679****_BAAy1Hac	Sorgulamak istediğiniz örneğin kimliği.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
InstanceBaseInfo	Object		Örnek bilgileri.
Endpoints	Object		Farklı protokollere karşılık gelen uç noktalar.
TcpEndpoint	String	http://MQ_INST_138015630679****_BAAy1Hac.cn-chengdu.mq-internal.aliyuncs.com:8080	Örneğin özel TCP uç noktası.
TcpInternetEndpoint	String	http://MQ_INST_138015630679****_BAAy1Hac.mq.cn-chengdu.aliyuncs.com:80	Örneğin genel TCP uç noktası. Yalnızca Çin (Chengdu), Çin (Qingdao) veya Çin (Shenzhen) bölgelerindeki örnekler genel TCP uç noktalarını destekler. Genel bir TCP uç noktası kullanmadan önce istemci SDK'sını ilgili sürüme yükseltin: Java için TCP istemci SDK'sı: V2.0.0.Final veya üzeri. Daha fazla bilgi için bkz. Java SDK sürüm notları. C++ için TCP istemci SDK'sı: V3.0.0 veya üzeri. Daha fazla bilgi için bkz. C++ SDK sürüm notları. Genel bir TCP uç noktası kullandığınızda veri aktarım maliyetini ödemeniz gerekir. Daha fazla bilgi için bkz. Veri aktarım maliyeti.
HttpInternetEndpoint	String	http://138015630679****.mqrest.cn-chengdu.aliyuncs.com	Örneğin genel HTTP uç noktası.
HttpInternalEndpoint	String	http://138015630679****.mqrest.cn-chengdu-internal.aliyuncs.com	Örneğin özel HTTP uç noktası.
HttpInternetSecureEndpoint	String	https://138015630679****.mqrest.cn-chengdu.aliyuncs.com	Örneğin genel HTTPS uç noktası.
IndependentNaming	Boolean	true	Örnek için bir ad alanı yapılandırılıp yapılandırılmadığını belirtir. Geçerli değerler: true: Örnek için ayrı bir ad alanı yapılandırılır. Her kaynağın adı örnekte benzersiz olmalıdır. Farklı örneklerdeki kaynakların adları aynı olabilir. false: Örnek için ayrı bir ad alanı yapılandırılmaz. Her kaynağın adı tüm örnekler arasında genel olarak benzersiz olmalıdır.
MaxTps	Long	10000	Mesaj yayınlama ve abonelik için maksimum saniye başına işlem sayısı (TPS). Geçerli değerler: 5000, 10000, 20000, 50000, 100000, 200000, 300000, 500000, 800000 ve 1000000. Daha fazla bilgi için satın alma sayfasındaki açıklamaya bakın. Not Bu parametre yalnızca Message Queue for Apache RocketMQ Enterprise Platinum Edition örnekleri için kullanılabilir.
Remark	String	onspre-cn-m7r1r5f****	Örneğin açıklaması.
InstanceName	String	test	Örneğin adı. Ad 3 ila 64 karakter uzunluğunda olmalı ve harfler, rakamlar, tire (-) ve alt çizgi (_) içerebilir.
ReleaseTime	Long	1603555200000	Enterprise Platinum Edition örneğinin sona erme zamanı.
TopicCapacity	Integer	50	Örnek üzerinde oluşturulabilecek maksimum konu sayısı. Geçerli değerler: 25, 50, 100, 300 ve 500. Not Bu parametre yalnızca Message Queue for Apache RocketMQ Enterprise Platinum Edition örnekleri için kullanılabilir.
InstanceStatus	Integer	5	Örneğin durumu. Geçerli değerler: 0: Örnek dağıtılıyor. Bu değer yalnızca Enterprise Platinum Edition örnekleri için geçerlidir. 2: Örneğin süresi dolmuş veya ödeme gecikmesi var. Bu değer Standard Edition örnekleri için geçerlidir. 5: Örnek çalışıyor. 7: Örnek yükseltiliyor ve çalışıyor. Bu değer yalnızca Enterprise Platinum Edition örnekleri için geçerlidir.
InstanceId	String	MQ_INST_138015630679****_BAAy1Hac	Örneğin kimliği.
InstanceType	Integer	2	Örneğin sürümü. Geçerli değerler: 1: Standard Edition (kullandıkça öde) 2: Enterprise Platinum Edition (abonelik) Message Queue for Apache RocketMQ örnek sürümleri ve teknik özellikleri hakkında bilgi için bkz. Örnek sürümleri.
RequestId	String	6CC46974-65E8-4C20-AB07-D20D102E****	İsteğin kimliği. Sistem her istek için benzersiz bir kimlik oluşturur. Sorun giderme işlemlerini istek kimliğini kullanarak yapabilirsiniz.

Örnekler

Örnek istekler

http(s)://ons.cn-chengdu.aliyuncs.com/?Action=OnsInstanceBaseInfo
&InstanceId=MQ_INST_138015630679****_BAAy1Hac
&Common request parameters

Başarılı yanıt örnekleri

XML biçimi

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

<OnsInstanceBaseInfoResponse>
    <InstanceBaseInfo>
        <Endpoints>
            <TcpEndpoint>http://MQ_INST_138015630679****_BAAy1Hac.cn-chengdu.mq-internal.aliyuncs.com:8080</TcpEndpoint>
            <HttpInternetEndpoint>http://138015630679****.mqrest.cn-chengdu.aliyuncs.com</HttpInternetEndpoint>
            <HttpInternalEndpoint>http://138015630679****.mqrest.cn-chengdu-internal.aliyuncs.com</HttpInternalEndpoint>
            <HttpInternetSecureEndpoint>https://138015630679****.mqrest.cn-chengdu.aliyuncs.com</HttpInternetSecureEndpoint>
            <TcpInternetEndpoint>http://MQ_INST_138015630679****_BAAy1Hac.mq.cn-chengdu.aliyuncs.com:80</TcpInternetEndpoint>
        </Endpoints>
        <IndependentNaming>true</IndependentNaming>
        <MaxTps>10000</MaxTps>
        <Remark>onspre-cn-m7r1r5f****</Remark>
        <InstanceName>test</InstanceName>
        <ReleaseTime>1603555200000</ReleaseTime>
        <TopicCapacity>50</TopicCapacity>
        <InstanceStatus>5</InstanceStatus>
        <InstanceId>MQ_INST_138015630679****_BAAy1Hac</InstanceId>
        <InstanceType>2</InstanceType>
    </InstanceBaseInfo>
    <RequestId>6CC46974-65E8-4C20-AB07-D20D102E****</RequestId>
</OnsInstanceBaseInfoResponse>

JSON biçimi

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

{
  "InstanceBaseInfo" : {
    "Endpoints" : {
      "TcpEndpoint" : "http://MQ_INST_138015630679****_BAAy1Hac.cn-chengdu.mq-internal.aliyuncs.com:8080",
      "HttpInternetEndpoint" : "http://138015630679****.mqrest.cn-chengdu.aliyuncs.com",
      "HttpInternalEndpoint" : "http://138015630679****.mqrest.cn-chengdu-internal.aliyuncs.com",
      "HttpInternetSecureEndpoint" : "https://138015630679****.mqrest.cn-chengdu.aliyuncs.com",
      "TcpInternetEndpoint" : "http://MQ_INST_138015630679****_BAAy1Hac.mq.cn-chengdu.aliyuncs.com:80"
    },
    "IndependentNaming" : true,
    "MaxTps" : 10000,
    "Remark" : "onspre-cn-m7r1r5f****",
    "InstanceName" : "test",
    "ReleaseTime" : 1603555200000,
    "TopicCapacity" : 50,
    "InstanceStatus" : 5,
    "InstanceId" : "MQ_INST_138015630679****_BAAy1Hac",
    "InstanceType" : 2
  },
  "RequestId" : "6CC46974-65E8-4C20-AB07-D20D102E****"
}

Hata kodları

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