update azure_rm_autoscale document (#56388)

This commit is contained in:
Fred-sun 2019-05-14 17:10:59 +08:00 committed by Yunge Zhu
commit 49ecfdbc10
2 changed files with 111 additions and 89 deletions

View file

@ -17,7 +17,7 @@ DOCUMENTATION = '''
---
module: azure_rm_autoscale
version_added: "2.7"
short_description: Manage Azure autoscale setting.
short_description: Manage Azure autoscale setting
description:
- Create, delete an autoscale setting.
options:
@ -28,10 +28,12 @@ options:
- It also could be a dict contains the C(name), C(subscription_id), C(namespace), C(types), C(resource_group) of the resource.
resource_group:
required: true
description: resource group of the resource.
description:
- Resource group of the resource.
enabled:
type: bool
description: Specifies whether automatic scaling is enabled for the resource.
description:
- Specifies whether automatic scaling is enabled for the resource.
default: true
profiles:
description:
@ -40,21 +42,25 @@ options:
suboptions:
name:
required: true
description: the name of the profile.
description:
- The name of the profile.
count:
required: true
description:
- The number of instances that will be set if metrics are not available for evaluation.
- The default is only used if the current instance count is lower than the default.
min_count:
description: the minimum number of instances for the resource.
description:
- The minimum number of instances for the resource.
max_count:
description: the maximum number of instances for the resource.
description:
- The maximum number of instances for the resource.
- The actual maximum number of instances is limited by the cores that are available in the subscription.
recurrence_frequency:
default: None
description:
- How often the schedule profile should take effect.
- If this value is Week, meaning each week will have the same set of profiles.
- If this value is C(Week), meaning each week will have the same set of profiles.
- This element is not used if the FixedDate element is used.
choices:
- None
@ -100,7 +106,8 @@ options:
suboptions:
time_aggregation:
default: Average
description: How the data that is collected should be combined over time.
description:
- How the data that is collected should be combined over time.
choices:
- Average
- Minimum
@ -114,22 +121,26 @@ options:
- This value must be greater than the delay in metric collection, which can vary from resource-to-resource.
- Must be between 5 ~ 720.
direction:
description: Whether the scaling action increases or decreases the number of instances.
description:
- Whether the scaling action increases or decreases the number of instances.
choices:
- Increase
- Decrease
metric_name:
required: true
description: The name of the metric that defines what the rule monitors.
description:
- The name of the metric that defines what the rule monitors.
metric_resource_uri:
description: The resource identifier of the resource the rule monitors.
description:
- The resource identifier of the resource the rule monitors.
value:
description:
- The number of instances that are involved in the scaling action.
- This value must be 1 or greater.
operator:
default: GreaterThan
description: The operator that is used to compare the metric data and the threshold.
description:
- The operator that is used to compare the metric data and the threshold.
choices:
- Equals
- NotEquals
@ -149,7 +160,8 @@ options:
- Must be between 1 ~ 720.
statistic:
default: Average
description: How the metrics from multiple instances are combined.
description:
- How the metrics from multiple instances are combined.
choices:
- Average
- Min
@ -157,37 +169,47 @@ options:
- Sum
threshold:
default: 70
description: The threshold of the metric that triggers the scale action.
description:
- The threshold of the metric that triggers the scale action.
type:
description: The type of action that should occur when the scale rule fires.
description:
- The type of action that should occur when the scale rule fires.
choices:
- PercentChangeCount
- ExactCount
- ChangeCount
notifications:
description: the collection of notifications.
description:
- The collection of notifications.
suboptions:
custom_emails:
description: the custom e-mails list. This value can be null or empty, in which case this attribute will be ignored.
description:
- The custom e-mails list. This value can be null or empty, in which case this attribute will be ignored.
send_to_subscription_administrator:
type: bool
description: A value indicating whether to send email to subscription administrator.
description:
- A value indicating whether to send email to subscription administrator.
webhooks:
description: The list of webhook notifications service uri.
description:
- The list of webhook notifications service uri.
send_to_subscription_co_administrators:
type: bool
description: A value indicating whether to send email to subscription co-administrators.
description:
- A value indicating whether to send email to subscription co-administrators.
state:
default: present
description: Assert the state of the virtual network. Use C(present) to create or update and C(absent) to delete.
description:
- Assert the state of the virtual network. Use C(present) to create or update and C(absent) to delete.
choices:
- present
- absent
location:
description: location of the resource.
description:
- location of the resource.
name:
required: true
description: name of the resource.
description:
- name of the resource.
extends_documentation_fragment:

View file

@ -17,7 +17,7 @@ DOCUMENTATION = '''
---
module: azure_rm_autoscale_facts
version_added: "2.7"
short_description: Get Azure Auto Scale Setting facts.
short_description: Get Azure Auto Scale Setting facts
description:
- Get facts of Auto Scale Setting.