CreateSiteMonitor - - Alibaba Cloud Dokümantasyon Merkezi

Bu konuda, HanZhou_ECS1 adlı bir site izleme görevinin nasıl oluşturulacağına ilişkin bir örnek sunulmaktadır. Görev tarafından izlenen URL https://www.aliyun.com olup görev türü HTTPS şeklindedir.

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şlem örnek kodlarını dinamik olarak oluşturur.

İstek parametreleri

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateSiteMonitor	Gerçekleştirmek istediğiniz işlem. Değeri CreateSiteMonitor olarak ayarlayın.
Address	String	Yes	https://www.aliyun.com	Görev tarafından izlenen URL veya IP adresi.
TaskType	String	Yes	HTTPS	Site izleme görevinin türü. Geçerli değerler: HTTP, HTTPS, PING, TCP, UDP, DNS, SMTP, POP3 ve FTP.
TaskName	String	Yes	HanZhou_ECS1	Site izleme görevinin adı. Ad 4 ila 100 karakter uzunluğunda olmalı ve harf, rakam ile alt çizgi (_) içerebilir.
Interval	String	No	1	Algılama isteklerinin gönderilme aralığı. Geçerli değerler: 1, 5, 15, 30 ve 60. Birim: dakika. Varsayılan değer: 1.
IspCities	String	No	[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]	Algılama noktalarının bilgileri. Bu parametreyi boş bırakırsanız sistem rastgele üç algılama noktası seçer. Değer bir JSON dizisidir. Örnek: `[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]`. city alanının değerleri Pekin, Hangzhou ve Qingdao'yu belirtir. Algılama noktalarını elde etme hakkında bilgi için bkz. DescribeSiteMonitorISPCityList.
OptionsJson	String	No	{"time_out":5000}	Site izleme görevi tarafından kullanılan protokolün genişletilmiş seçenekleri. Seçenekler protokole göre değişir.
AlertIds	String	No	SystemDefault_acs_ecs_dashboard_InternetOutRate_Percent	Uyarı kuralının kimliği. Bir uyarı kuralının kimliğini elde etme hakkında bilgi için bkz. DescribeMetricRuleList.

Aşağıdaki tablolar, TaskType parametresi tarafından belirtilen HTTP, HTTPS, PING, TCP, UDP, DNS, SMTP, POP3 ve FTP protokollerinin genişletilmiş seçeneklerini açıklar.

HTTP veya HTTPS

Parameter	Type	Description
http_method	String	HTTP veya HTTPS istek yöntemi. Geçerli değerler: GET, POST ve HEAD. Varsayılan değer: GET.
header	String	Satır sonları (\n) ile ayrılmış özel HTTP başlıkları. Her başlık HTTP protokolüne uygun olmalıdır. Her başlık, anahtar ve değerin iki nokta üst üste işareti (:) ile ayrıldığı bir anahtar-değer çifti olmalıdır.
cookie	String	HTTP isteği standardına uygun olarak belirtilen HTTP çerezidir.
request_content	String	İsteğin içeriği. İçerik JSON veya form formatında olabilir. Bu parametre belirtilmezse istek gövdesi boş olur.
response_content	String	Beklenen yanıt içeriği. Site izleme sırasında HTTP sunucusu tarafından döndürülen içeriğin ilk 64 baytı kontrol edilir.
match_rule	String	0: Yanıt, response_content parametresi tarafından belirtilen içeriği içermiyorsa algılama başarılı olur. 1: Yanıt, response_content parametresi tarafından belirtilen içeriği içeriyorsa algılama başarılı olur.
username	String	username parametresi belirtilirse HTTP isteği temel kimlik doğrulama başlığını içerir.
password	String	HTTP veya HTTPS isteğini doğrulamak için kullanılan parola.
time_out	int	Zaman aşımı süresi. Birim: milisaniye. Varsayılan değer: 5.
max_redirect	int	Maksimum yönlendirme sayısı. Elastic Compute Service (ECS) örneğinde çalışan bir algılama noktası için varsayılan değer 5, operatör tarafından sağlanan bir algılama noktası için 2'dir. Yönlendirmeleri devre dışı bırakmak için değeri 0 olarak ayarlayın. Geçerli değerler: 0 ila 50.

PING

Parameter

Type

Description

failure_rate

Text

Başarısız ping oranı bu parametrenin değerini aşarsa algılama başarısız olur ve 610 veya 615 durum kodu döndürülür. 610 durum kodunun hata mesajı PingAllFail, 615 durum kodunun hata mesajı ise PingPartialFail'tir.

Varsayılan değer: 0,1.

ping_num

int

İzlenen adresin ping edilme sayısı. Varsayılan değer: 10.

Geçerli değerler: 1 ila 100.

DNS

Parameter	Type	Description
dns_server	string	Domain Name System (DNS) sunucusunun alan adı veya IP adresi.
dns_type	string	Sorgulanacak DNS kayıtlarının türü. Geçerli değerler: A, NS, CNAME, MX, TXT, ANY ve AAAA.
expect_value	string	Beklenen değerlerin listesi. Beklenen değerleri boşluk karakterleriyle ayırın.
match_rule	string	Beklenen değerler listesi ile DNS sonuçları listesi arasındaki ilişki. İki liste belirtilen ilişkiyi karşılamazsa algılama başarısız olur. Geçerli değerler: Boş dize veya 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.

FTP

Parameter	Type	Description
port	int	FTP sunucusunun bağlantı noktası numarası. Bu parametre belirtilmezse varsayılan değer kullanılır. FTP için varsayılan bağlantı noktası numarası 21, FTPS için 990'dır.
username	string	FTP sunucusunda oturum açmak için kullanılan kullanıcı adı. Bu parametre belirtilmezse anonim oturum açma kullanılır.
password	string	FTP sunucusunda oturum açmak için kullanılan parola.

POP3 veya SMTP

Parameter	Type	Description
port	int	POP3 veya SMTP sunucusunun bağlantı noktası numarası. POP3 için varsayılan bağlantı noktası numarası 110, POPS3 için 995 ve SMTP için 25'tir.
username	string	POP3 veya SMTP sunucusunda oturum açmak için kullanılan kullanıcı adı. POP3 veya SMTP sunucusunda oturum açmak için kullanıcı adı ve parola gereklidir.
password	string	POP3 veya SMTP sunucusunda oturum açmak için kullanılan parola. POP3 veya SMTP sunucusunda oturum açmak için kullanıcı adı ve parola gereklidir.

TCP veya UDP

Parameter	Type	Description
port	int	TCP veya UDP sunucusunun bağlantı noktası numarası.
request_content	string	İsteğin içeriği. request_format parametresi hex olarak ayarlanırsa request_content parametresinin değeri onaltılık biçimde ayrıştırılır.
request_format	string	request_format parametresi başka bir değere ayarlanırsa request_content parametresinin değeri TCP veya UDP sunucusuna normal bir dize olarak gönderilir.
response_content	string	Yanıtın içeriği. TCP veya UDP sunucusundan gelen yanıt, response_content parametresi tarafından belirtilen içeriği içermiyorsa algılama başarısız olur. response_format parametresi hex olarak ayarlanırsa response_content parametresinin değeri onaltılık biçimde ayrıştırılır. response_format parametresi başka bir değere ayarlanırsa response_content parametresinin değeri normal bir dize olarak ayrıştırılır.

Yanıt parametreleri

Parameter	Type	Example	Description
Code	String	200	HTTP durum kodu. Not 200 durum kodu çağrının başarılı olduğunu gösterir.
Message	String	Successful	Döndürülen mesaj.
RequestId	String	68192f5d-0d45-4b98-9724-892813f86c71	İsteğin kimliği.
Success	String	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.
Data	Object		Site izleme görevinin sonucu.
AttachAlertResult	Array of Contact		Mevcut uyarı kuralını site izleme göreviyle ilişkilendirdikten sonra döndürülen sonuç.
Contact
Code	String	200	Mevcut uyarı kuralını site izleme göreviyle ilişkilendirdikten sonra döndürülen durum kodu. Not 200 durum kodu çağrının başarılı olduğunu gösterir.
Message	String	successful	Mevcut uyarı kuralını site izleme göreviyle ilişkilendirdikten sonra döndürülen mesaj.
RequestId	String	5dd33455-4f65-4b0c-9200-33d66f3f340b	Mevcut uyarı kuralını site izleme göreviyle ilişkilendirmek için gönderilen isteğin kimliği.
Success	String	true	Mevcut uyarı kuralının site izleme göreviyle ilişkilendirilip ilişkilendirilmediğini gösterir. Geçerli değerler: true false
RuleId	String	SystemDefault_acs_ecs_dashboard_InternetOutRate_Percent	Uyarı kuralının kimliği.
CreateResultList	Array of CreateResultList		İsteğin sonucu. Bir site izleme görevi oluşturulursa sonuç döndürülür. Bir site izleme görevi oluşturulamazsa sonuç döndürülmez.
CreateResultList
TaskId	String	2c8dbdf9-a3ab-46a1-85a4-f094965e****	Site izleme görevinin kimliği.
TaskName	String	HanZhou_ECS1	Site izleme görevinin adı.

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=CreateSiteMonitor
&Address=https://www.aliyun.com
&TaskName=HanZhou_ECS1
&TaskType=HTTPS
&<Common request parameters>

Örnek başarılı yanıt

XML formatı

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

<CreateSiteMonitorResponse>
	<Message>successful</Message>
	<RequestId>68192f5d-0d45-4b98-9724-892813f86c71</RequestId>
	<Data>
		<AttachAlertResult>
			<Contact>
				<Message>successful</Message>
				<RequestId>5dd33455-4f65-4b0c-9200-33d66f3f340b</RequestId>
				<RuleId>SystemDefault_acs_ecs_dashboard_InternetOutRate_Percent</RuleId>
				<Code>200</Code>
				<Success>true</Success>
			</Contact>
		</AttachAlertResult>
	</Data>
	<Code>200</Code>
	<CreateResultList>
		<CreateResultList>
			<TaskId>2c8dbdf9-a3ab-46a1-85a4-f094965e****</TaskId>
			<TaskName>HanZhou_ECS1</TaskName>
		</CreateResultList>
	</CreateResultList>
	<Success>true</Success>
</CreateSiteMonitorResponse>

JSON formatı

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

{
  "Message" : "successful",
  "RequestId" : "68192f5d-0d45-4b98-9724-892813f86c71",
  "Data" : {
    "AttachAlertResult" : {
      "Contact" : [ {
        "Message" : "successful",
        "RequestId" : "5dd33455-4f65-4b0c-9200-33d66f3f340b",
        "RuleId" : "SystemDefault_acs_ecs_dashboard_InternetOutRate_Percent",
        "Code" : "200",
        "Success" : true
      } ]
    }
  },
  "Code" : "200",
  "CreateResultList" : {
    "CreateResultList" : [ {
      "TaskId" : "2c8dbdf9-a3ab-46a1-85a4-f094965e****",
      "TaskName" : "HanZhou_ECS1"
    } ]
  },
  "Success" : true
}

Hata kodları

Hata kodlarının listesi için bkz. Service error codes.