DescribeScheduledTasks - - Alibaba Cloud Dokümantasyon Merkezi

Zamanlanmış görevlerin ayrıntılarını sorgular. Zamanlanmış görev, işlem kaynaklarını otomatik olarak ölçeklendirmek için belirtilen bir zamanda belirli bir ölçeklendirme kuralını çalıştıran önceden ayarlanmış bir görevdir. Bir zamanlanmış görev oluşturduktan sonra, tetikleme zamanı, zamanlanmış görevlerin toplam sayısı ve zamanlanmış görevi çalıştıran ölçeklendirme grubunun kimliği gibi ayrıntılarını sorgulamak için DescribeScheduledTasks işlemini çağırabilirsiniz.

Operation description

Zamanlanmış görevleri zamanlanmış görev kimliğine, zamanlanmış görev adına veya zamanlanmış görev tarafından çalıştırılan ölçeklendirme kuralına göre sorgulayabilirsiniz.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ess:DescribeScheduledTasks

get

*Ölçeklendirme grubu.

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

None

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	Zamanlanmış görevin ait olduğu ölçeklendirme grubunun bölge kimliği.	cn-qingdao
PageNumber	integer	No	Döndürülecek zamanlanmış görevlerin sayfa numarası. Sayfalar 1'den başlar. Varsayılan değer: 1.	1
PageSize	integer	No	Sayfalı sorgularda sayfa başına giriş sayısı. Maksimum değer: 50. Varsayılan değer: 10.	50
ScalingGroupId	string	No	Zamanlanmış görevi çalıştıran ölçeklendirme grubunun kimliği.	asg-bp1bo5tca4m56nap****
ScheduledActions	array	No	Zamanlanmış görevler tetiklendiğinde çalıştırılan ölçeklendirme kuralları. Bu parametre yalnızca zamanlanmış görevler için ölçeklendirme kuralları belirtildiğinde geçerlidir.
	string	No	Zamanlanmış görev tetiklendiğinde kullanılan ölçeklendirme kuralı. Bu parametre yalnızca zamanlanmış görev için bir ölçeklendirme kuralı belirtildiğinde geçerlidir. Değer, ölçeklendirme kuralının benzersiz tanımlayıcısıdır (ScalingRuleAri).	ari:acs:ess:cn-hangzhou:1406926474**:scalingrule/asr-bp1id5rhu8edp7kd**
ScheduledTaskIds	array	No	Sorgulanacak zamanlanmış görevlerin kimlikleri.
	string	No	Sorgulanacak zamanlanmış görevlerin kimlikleri.	edRtShc57WGXdt8TlPbr****
ScheduledTaskNames	array	No	Sorgulanacak zamanlanmış görevlerin adları.
	string	No	Sorgulanacak zamanlanmış görevlerin adları.	scheduled****
TaskName	string	No	Görev adı. Anahtar kelimeyle esnek eşleştirme desteklenir.	scheduled****
RecurrenceType	string	No	Zamanlanmış görevin yineleme türü. Geçerli değerler: Daily: Zamanlanmış görev, belirtilen gün sayısında bir kez çalıştırılır. Weekly: Zamanlanmış görev, her haftanın belirtilen günlerinde çalıştırılır. Monthly: Zamanlanmış görev, her ayın belirtilen günlerinde çalıştırılır. Cron: Zamanlanmış görev, belirtilen bir cron ifadesine göre çalıştırılır.	Weekly
RecurrenceValue	string	No	Zamanlanmış görevin yineleme değeri. Bu parametre yalnızca RecurrenceType değeri Weekly olarak ayarlandığında geçerlidir. Virgül (,) ile ayrılmış birden fazla değer belirtebilirsiniz. Örneğin, Pazar, Pazartesi, Salı, Çarşamba, Perşembe, Cuma ve Cumartesi için değerler sırasıyla 0, 1, 2, 3, 4, 5 ve 6'dır.	1,2,3
TaskEnabled	boolean	No	Zamanlanmış görevin başlatılıp başlatılmadığını belirtir. Geçerli değerler: true: Görev başlatılır. false: Görev durdurulur.	true

Response elements

Element	Type	Description	Example
	object
RequestId	string	İstek kimliği.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
PageNumber	integer	Geçerli sayfa numarası.	1
PageSize	integer	Sayfa başına giriş sayısı.	50
TotalCount	integer	Zamanlanmış görevlerin toplam sayısı.	1
ScheduledTasks	array<object>	Zamanlanmış görevler.
	object	Zamanlanmış görevler.
TaskEnabled	boolean	Zamanlanmış görevin başlatılıp başlatılmadığını gösterir. Geçerli değerler: true: Görev başlatılır. false: Görev durdurulur. Varsayılan değer: true.	true
RecurrenceValue	string	Zamanlanmış görevin tetiklenmesine yönelik yineleme değeri.	1
RecurrenceType	string	Zamanlanmış görevin tetiklenmesine yönelik yineleme türü.	Daily
MaxValue	integer	Ölçeklendirme grubundaki maksimum örnek sayısı. Bu parametre, zamanlanmış görevin ölçeklendirme yöntemi ölçeklendirme grubundaki örnek sayısını ayarlayacak şekilde ayarlandığında döndürülür.	10
ScheduledTaskName	string	Zamanlanmış görevin adı.	scheduled****
RecurrenceEndTime	string	Zamanlanmış görevin tetiklenmesine yönelik yinelemenin bitiş zamanı. Zaman UTC cinsinden gösterilir ve YYYY-MM-DDTHH:mmZ formatında ISO 8601 standardını izler.	2014-08-20T16:55Z
DesiredCapacity	integer	Ölçeklendirme grubundaki beklenen örnek sayısı. Bu parametre, zamanlanmış görevin ölçeklendirme yöntemi ölçeklendirme grubundaki örnek sayısını ayarlayacak şekilde ayarlandığında döndürülür.	10
ScheduledTaskId	string	Zamanlanmış görevin kimliği.	edRtShc57WGXdt8TlPbr****
MinValue	integer	Ölçeklendirme grubundaki minimum örnek sayısı. Bu parametre, zamanlanmış görevin ölçeklendirme yöntemi ölçeklendirme grubundaki örnek sayısını ayarlayacak şekilde ayarlandığında döndürülür.	0
ScalingGroupId	string	Zamanlanmış görevi çalıştıran ölçeklendirme grubunun kimliği.	asg-bp1bo5tca4m56nap****
LaunchExpirationTime	integer	Zamanlanmış görev tetiklenemedikten sonraki yeniden deneme süresi. Birim: saniye. Geçerli değerler: 0 ile 21600 arası.	600
Description	string	Zamanlanmış görevin açıklaması.	Test scheduled task.
ScheduledAction	string	Zamanlanmış görev tetiklendiğinde çalıştırılan ölçeklendirme kuralı. Bu parametre yalnızca zamanlanmış görev için bir ölçeklendirme kuralı belirtildiğinde döndürülür.	ari:acs:ess:cn-hangzhou:1406926474**:scalingrule/asr-bp1id5rhu8edp7kd**
LaunchTime	string	Zamanlanmış görevin tetiklendiği zaman. Zaman UTC cinsinden gösterilir ve YYYY-MM-DDTHH:mmZ formatında ISO 8601 standardını izler.	2014-08-18T10:52Z

Examples

Success response

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber": 1,
  "PageSize": 50,
  "TotalCount": 1,
  "ScheduledTasks": [
    {
      "TaskEnabled": true,
      "RecurrenceValue": "1",
      "RecurrenceType": "Daily",
      "MaxValue": 10,
      "ScheduledTaskName": "scheduled****",
      "RecurrenceEndTime": "2014-08-20T16:55Z",
      "DesiredCapacity": 10,
      "ScheduledTaskId": "edRtShc57WGXdt8TlPbr****",
      "MinValue": 0,
      "ScalingGroupId": "asg-bp1bo5tca4m56nap****",
      "LaunchExpirationTime": 600,
      "Description": "Test scheduled task.",
      "ScheduledAction": "ari:acs:ess:cn-hangzhou:1406926474****:scalingrule/asr-bp1id5rhu8edp7kd****",
      "LaunchTime": "2014-08-18T10:52Z"
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.