DescribeSiteMonitorAttribute - - Alibaba Cloud Dokümantasyon Merkezi

Bu konuda, ID'si cc641dff-c19d-45f3-ad0a-818a0c4f**** olan bir site izleme görevinin ayrıntılarının nasıl sorgulanacağına ilişkin bir örnek verilmektedir. Dönüş sonucu; görev adının test123, görev tarafından izlenen adresin https://aliyun.com ve taşıyıcı adının Alibaba olduğunu gösterir.

Hata Ayıklama

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

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	DescribeSiteMonitorAttribute	Gerçekleştirmek istediğiniz işlem. Değeri DescribeSiteMonitorAttribute olarak ayarlayın.
TaskId	String	Evet	cc641dff-c19d-45f3-ad0a-818a0c4f****	Site izleme görevinin ID'si.
IncludeAlert	Boolean	Hayır	false	Site izleme görevi için yapılandırılan uyarı kurallarının bilgilerinin döndürülüp döndürülmeyeceğini belirtir. Geçerli değerler: true: Sistem, site izleme görevi için yapılandırılan uyarı kurallarının bilgilerini döndürür. false: Sistem, site izleme görevi için yapılandırılan uyarı kurallarının bilgilerini döndürmez. Varsayılan değer: false.

Ortak istek parametreleri hakkında daha fazla bilgi için bkz. Ortak parametreler.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
RequestId	String	D17DF650-7EBD-54D0-903A-1D4E624D7402	İsteğin ID'si.
Code	String	200	HTTP durum kodu. Not 200 durum kodu, çağrının başarılı olduğunu gösterir.
Success	Boolean	true	Çağrının başarılı olup olmadığını gösterir. Geçerli değerler: true: Çağrı başarılı oldu. false: Çağrı başarısız oldu.
SiteMonitors	Struct		Site izleme görevinin ayrıntıları.
Address	String	https://aliyun.com	Site izleme görevi tarafından izlenen adres.
Interval	String	1	Site izleme görevinin çalıştırılma aralığı. Birim: dakika. Geçerli değerler: 1, 5, 15, 30 ve 60.
IspCities	Array of IspCity		Algılama noktalarının bilgileri. Bilgiler, algılama noktalarını sağlayan taşıyıcıları ve algılama noktalarının bulunduğu şehirleri içerir.
IspCity
City	String	738	Şehrin ID'si.
CityName	String	Beijing	Şehrin adı.
Isp	String	465	Taşıyıcının ID'si.
IspName	String	Alibaba	Taşıyıcının adı.
OptionJson	Struct		Site izleme görevinin genişletilmiş seçenekleri. Seçenekler belirtilen protokole göre değişir. Daha fazla bilgi için bkz. CreateSiteMonitor.
attempts	Long	3	DNS hatası oluştuğunda yapılan yeniden deneme sayısı.
authentication	Integer	1	Güvenlik kimlik doğrulama özelliğinin etkin olup olmadığını gösterir. Geçerli değerler: 0: Güvenlik kimlik doğrulama özelliği devre dışı bırakılır. 1: Güvenlik kimlik doğrulama özelliği etkinleştirilir.
cookie	String	lang=en	HTTP isteğinin çerez (cookie) bilgisi.
dns_match_rule	String	IN_DNS	Beklenen takma ad veya IP adresi listesi ile DNS sonuçları listesi arasındaki ilişki. Geçerli değerler: IN_DNS: Beklenen değerler listesi, DNS sonuçları listesinin bir alt kümesidir. DNS_IN: DNS sonuçları listesi, beklenen değerler listesinin bir alt kümesidir. EQUAL: DNS sonuçları listesi, beklenen değerler listesiyle aynıdır. ANY: DNS sonuçları listesi, beklenen değerler listesiyle kesişir.
dns_server	String	192.168.XX.XX	DNS sunucusunun IP adresi. Not Bu parametre yalnızca TaskType parametresi DNS olarak ayarlandığında döndürülür.
dns_type	String	A	DNS kaydı türü. Bu parametre yalnızca TaskType parametresi DNS olarak ayarlandığında döndürülür. Geçerli değerler: A: Varsayılan ad. Bu değer, belirtilen ana bilgisayar adına veya etki alanı adına ilişkin bir IP adresini belirten bir kaydı ifade eder. CNAME: Birden çok etki alanı adını bir etki alanı adına eşleyen bir kayıt. NS: Etki alanı adlarını çözümlemek için kullanılan bir DNS sunucusunu belirten bir kayıt. MX: Etki alanı adlarını bir posta sunucusunun adresine bağlayan bir kayıt. TXT: Ana bilgisayar adı veya etki alanı adlarının metin bilgilerini depolayan bir kayıt. Metin 1 ila 512 bayt uzunluğunda olmalıdır. TXT kaydı, spam ile mücadele etmek için Gönderen Politikası Çerçevesi (SPF) kaydı olarak hizmet verir.
expect_value	String	dns_server	Çözümlenecek etki alanı adı veya takma ad. Not Bu parametre yalnızca TaskType parametresi DNS olarak ayarlandığında döndürülür.
failure_rate	Float	0,4	Paket kaybı oranı. Not Bu parametre yalnızca TaskType parametresi PING olarak ayarlandığında döndürülür.
header	String	testKey:testValue	HTTP isteğinin üstbilgisi.
http_method	String	get	HTTP istek yöntemi. Geçerli değerler: get post head
isBase64Encode	String	true	`password` parametresinin değerinin Base64 ile kodlanıp kodlanmadığını gösterir. true: Parola parametresinin değeri Base64 ile kodlanır. false: Parola parametresinin değeri Base64 ile kodlanmaz.
match_rule	Integer	1	Uyarı kuralının dahil edilip edilmediğini gösterir. Geçerli değerler: 0: Uyarı kuralı dahildir. 1: Uyarı kuralı dahil değildir.
password	String	123****	SMTP, POP3 veya FTP protokolünün parolası.
ping_num	Integer	29	PING protokolünün kalp atışı (heartbeat).
port	Integer	110	TCP, UDP, SMTP veya POP3 protokolünün bağlantı noktası numarası.
protocol	String	TCP	İsteği göndermek için kullanılan protokol.
request_content	String	aa=bb	HTTP isteğinin içeriği.
request_format	String	txt	HTTP isteğinin biçimi. Geçerli değerler: hex: onaltılık txt: metin
response_content	String	txt	HTTP isteğine verilen yanıt.
response_format	String	txt	Yanıtın biçimi. Geçerli değerler: hex: onaltılık txt: metin
time_out	Long	3	Zaman aşımı süresi. Birim: milisaniye.
username	String	testUser	FTP, SMTP veya POP3 protokolünün kullanıcı adı.
TaskId	String	cc641dff-c19d-45f3-ad0a-818a0c4f****	Site izleme görevinin ID'si.
TaskName	String	test123	Site izleme görevinin adı.
TaskState	String	1	Site izleme görevinin durumu. Geçerli değerler: 1: Görev etkinleştirildi. 2: Görev devre dışı bırakıldı.
TaskType	String	HTTP	Site izleme görevi tarafından kullanılan protokol. Geçerli değerler: HTTP, HTTPS, PING, TCP, UDP, DNS, SMTP, POP3 ve FTP.
MetricRules	Array of MetricRule		Site izleme görevi için yapılandırılan uyarı kurallarının bilgileri.
MetricRule
ActionEnable	String	true	Uyarı kuralının etkin olup olmadığını gösterir. Geçerli değerler: true: Uyarı kuralı etkinleştirildi. false: Uyarı kuralı devre dışı bırakıldı.
AlarmActions	String	CloudMonitor	Uyarı bildirimlerinin gönderildiği uyarı iletişim grubu.
ComparisonOperator	String	GreaterThanYesterday	Uyarı kuralında kullanılan karşılaştırma işleci. Geçerli değerler: `>=` `>` `<=` `<` `=` `!=` GreaterThanYesterday: Dün aynı zamandaki ölçüm değerinden büyük LessThanYesterday: Dün aynı zamandaki ölçüm değerinden küçük GreaterThanLastWeek: Geçen hafta aynı zamandaki ölçüm değerinden büyük LessThanLastWeek: Geçen hafta aynı zamandaki ölçüm değerinden küçük GreaterThanLastPeriod: Son izleme döngüsündeki ölçüm değerinden büyük LessThanLastPeriod: Son izleme döngüsündeki ölçüm değerinden küçük
Dimensions	String	[{"taskId": "cc641dff-c19d-45f3-ad0a-818a0c4f****" }]	Uyarı kuralının boyutu.
EvaluationCount	String	3	Bir uyarı tetiklenmeden önce ölçüm değerinin art arda ölçüldüğü ardışık sayı.
Expression	String	$Availability=30	Uyarıları tetiklemek için kullanılan ifade.
Level	String	2	Uyarının önem düzeyi. Geçerli değerler: 1: kritik 2: uyarı 3: bilgi
MetricName	String	Availability	Ölçümün adı.
Namespace	String	acs_networkmonitor	Cloud hizmetinin ad alanı.
OkActions	String	[ "CloudMonitor"]	Uyarı bildirimlerinin gönderildiği uyarı iletişim grupları.
Period	String	15s	İzleme verilerinin sorgulanma aralığı. Değer, ölçüm verilerinin raporlanma aralığıyla aynıdır. Birim: saniye. Not Uyarı kuralı için bir istatistiksel dönem belirtirseniz ham veriler istatistiksel döneme göre sorgulanır.
RuleId	String	bf071ae_7b7aec3817b0fdf****	Uyarı kuralının ID'si.
RuleName	String	rule1	Uyarı kuralının adı.
StateValue	String	OK	Uyarının durumu. Geçerli değerler: OK: normal. ALARM: Uyarı tetiklendi.
Statistics	String	Availability	Uyarı kuralının istatistiksel yöntemi. Geçerli değerler: Availability: Kullanılabilir algılama noktalarının yüzdesi AvailableNumber: Kullanılabilir algılama noktalarının sayısı ErrorCodeMaximum: Bir uyarı için durum kodu ErrorCodeMinimum: Bir dizi uyarı için tüm durum kodları Average: Yanıt süresi
Threshold	String	30	Uyarı eşiği.
Message	String	successful	Dönen mesaj.

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=DescribeSiteMonitorAttribute
&TaskId=cc641dff-c19d-45f3-ad0a-818a0c4f****
&<Common request parameters>

Örnek başarılı yanıtlar

XML biçimi

<DescribeSiteMonitorAttributeResponse>
	  <MetricRules>
		    <MetricRule>
			      <ComparisonOperator>GreaterThanYesterday</ComparisonOperator>
			      <RuleId>bf071ae_7b7aec3817b0fdf****</RuleId>
			      <Period>15s</Period>
			      <EvaluationCount>3</EvaluationCount>
			      <Dimensions>
				        <taskId>cc641dff-c19d-45f3-ad0a-818a0c4f****</taskId>
			      </Dimensions>
			      <Statistics>Availability</Statistics>
			      <Namespace>acs_networkmonitor</Namespace>
			      <AlarmActions>CloudMonitor</AlarmActions>
			      <MetricName>Availability</MetricName>
			      <OkActions>CloudMonitor</OkActions>
			      <Expression>$Availability=30</Expression>
			      <ActionEnable>true</ActionEnable>
			      <StateValue>OK</StateValue>
			      <Level>2</Level>
			      <RuleName>rule1</RuleName>
			      <Threshold>30</Threshold>
		    </MetricRule>
	  </MetricRules>
	  <Message>successful</Message>
	  <RequestId>D17DF650-7EBD-54D0-903A-1D4E624D7402</RequestId>
	  <Code>200</Code>
	  <Success>true</Success>
	  <SiteMonitors>
		    <OptionJson>
			      <time_out>30000</time_out>
			      <http_method>get</http_method>
		    </OptionJson>
		    <TaskId>cc641dff-c19d-45f3-ad0a-818a0c4f****</TaskId>
		    <Address>https://aliyun.com</Address>
		    <TaskName>test123</TaskName>
		    <TaskType>HTTP</TaskType>
		    <IspCities>
			      <IspCity>
				        <IspName>Alibaba</IspName>
				        <Isp>465</Isp>
				        <CityName>Beijing</CityName>
				        <City>738</City>
			      </IspCity>
		    </IspCities>
		    <TaskState>1</TaskState>
		    <Interval>1</Interval>
	  </SiteMonitors>
</DescribeSiteMonitorAttributeResponse>

JSON biçimi

{
    "MetricRules": {
        "MetricRule": [
            {
                "ComparisonOperator": "GreaterThanYesterday",
                "RuleId": "bf071ae_7b7aec3817b0fdf****",
                "Period": "15s",
                "EvaluationCount": 3,
                "Dimensions": [
                    {
                        "taskId": "cc641dff-c19d-45f3-ad0a-818a0c4f****"
                    }
                ],
                "Statistics": "Availability",
                "Namespace": "acs_networkmonitor",
                "AlarmActions": [
                    "CloudMonitor"
                ],
                "MetricName": "Availability",
                "OkActions": [
                    "CloudMonitor"
                ],
                "Expression": "$Availability=30",
                "ActionEnable": true,
                "StateValue": "OK",
                "Level": 2,
                "RuleName": "rule1",
                "Threshold": "30"
            }
        ]
    },
    "Message": "successful",
    "RequestId": "D17DF650-7EBD-54D0-903A-1D4E624D7402",
    "Code": "200",
    "Success": true,
    "SiteMonitors": {
        "OptionJson": {
            "time_out": 30000,
            "http_method": "get"
        },
        "TaskId": "cc641dff-c19d-45f3-ad0a-818a0c4f****",
        "Address": "https://aliyun.com",
        "TaskName": "test123",
        "TaskType": "HTTP",
        "IspCities": {
            "IspCity": [
                {
                    "IspName": "Alibaba",
                    "Isp": "465",
                    "CityName": "Beijing",
                    "City": "738"
                }
            ]
        },
        "TaskState": 1,
        "Interval": 1
    }
}

Hata kodları

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