pulumi-alicloud 3.75.0a1741324537__py3-none-any.whl → 3.76.0__py3-none-any.whl

pulumi_alicloud/esa/get_sites.py

@@ -0,0 +1,421 @@
+# coding=utf-8
+# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import copy
+import warnings
+import sys
+import pulumi
+import pulumi.runtime
+from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
+from .. import _utilities
+from . import outputs
+
+__all__ = [
+    'GetSitesResult',
+    'AwaitableGetSitesResult',
+    'get_sites',
+    'get_sites_output',
+]
+
+@pulumi.output_type
+class GetSitesResult:
+    """
+    A collection of values returned by getSites.
+    """
+    def __init__(__self__, access_type=None, coverage=None, id=None, ids=None, name_regex=None, names=None, only_enterprise=None, output_file=None, page_number=None, page_size=None, plan_subscribe_type=None, resource_group_id=None, site_name=None, site_search_type=None, sites=None, status=None, tags=None):
+        if access_type and not isinstance(access_type, str):
+            raise TypeError("Expected argument 'access_type' to be a str")
+        pulumi.set(__self__, "access_type", access_type)
+        if coverage and not isinstance(coverage, str):
+            raise TypeError("Expected argument 'coverage' to be a str")
+        pulumi.set(__self__, "coverage", coverage)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if ids and not isinstance(ids, list):
+            raise TypeError("Expected argument 'ids' to be a list")
+        pulumi.set(__self__, "ids", ids)
+        if name_regex and not isinstance(name_regex, str):
+            raise TypeError("Expected argument 'name_regex' to be a str")
+        pulumi.set(__self__, "name_regex", name_regex)
+        if names and not isinstance(names, list):
+            raise TypeError("Expected argument 'names' to be a list")
+        pulumi.set(__self__, "names", names)
+        if only_enterprise and not isinstance(only_enterprise, bool):
+            raise TypeError("Expected argument 'only_enterprise' to be a bool")
+        pulumi.set(__self__, "only_enterprise", only_enterprise)
+        if output_file and not isinstance(output_file, str):
+            raise TypeError("Expected argument 'output_file' to be a str")
+        pulumi.set(__self__, "output_file", output_file)
+        if page_number and not isinstance(page_number, int):
+            raise TypeError("Expected argument 'page_number' to be a int")
+        pulumi.set(__self__, "page_number", page_number)
+        if page_size and not isinstance(page_size, int):
+            raise TypeError("Expected argument 'page_size' to be a int")
+        pulumi.set(__self__, "page_size", page_size)
+        if plan_subscribe_type and not isinstance(plan_subscribe_type, str):
+            raise TypeError("Expected argument 'plan_subscribe_type' to be a str")
+        pulumi.set(__self__, "plan_subscribe_type", plan_subscribe_type)
+        if resource_group_id and not isinstance(resource_group_id, str):
+            raise TypeError("Expected argument 'resource_group_id' to be a str")
+        pulumi.set(__self__, "resource_group_id", resource_group_id)
+        if site_name and not isinstance(site_name, str):
+            raise TypeError("Expected argument 'site_name' to be a str")
+        pulumi.set(__self__, "site_name", site_name)
+        if site_search_type and not isinstance(site_search_type, str):
+            raise TypeError("Expected argument 'site_search_type' to be a str")
+        pulumi.set(__self__, "site_search_type", site_search_type)
+        if sites and not isinstance(sites, list):
+            raise TypeError("Expected argument 'sites' to be a list")
+        pulumi.set(__self__, "sites", sites)
+        if status and not isinstance(status, str):
+            raise TypeError("Expected argument 'status' to be a str")
+        pulumi.set(__self__, "status", status)
+        if tags and not isinstance(tags, dict):
+            raise TypeError("Expected argument 'tags' to be a dict")
+        pulumi.set(__self__, "tags", tags)
+
+    @property
+    @pulumi.getter(name="accessType")
+    def access_type(self) -> Optional[str]:
+        """
+        Access type. Value:-**NS**: Managed access via NS.-**CNAME**: access through CNAME.
+        """
+        return pulumi.get(self, "access_type")
+
+    @property
+    @pulumi.getter
+    def coverage(self) -> Optional[str]:
+        """
+        Acceleration area
+        """
+        return pulumi.get(self, "coverage")
+
+    @property
+    @pulumi.getter
+    def id(self) -> str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+    @property
+    @pulumi.getter
+    def ids(self) -> Sequence[str]:
+        """
+        A list of Site IDs.
+        """
+        return pulumi.get(self, "ids")
+
+    @property
+    @pulumi.getter(name="nameRegex")
+    def name_regex(self) -> Optional[str]:
+        return pulumi.get(self, "name_regex")
+
+    @property
+    @pulumi.getter
+    def names(self) -> Sequence[str]:
+        """
+        A list of name of Sites.
+        """
+        return pulumi.get(self, "names")
+
+    @property
+    @pulumi.getter(name="onlyEnterprise")
+    def only_enterprise(self) -> Optional[bool]:
+        return pulumi.get(self, "only_enterprise")
+
+    @property
+    @pulumi.getter(name="outputFile")
+    def output_file(self) -> Optional[str]:
+        return pulumi.get(self, "output_file")
+
+    @property
+    @pulumi.getter(name="pageNumber")
+    def page_number(self) -> Optional[int]:
+        return pulumi.get(self, "page_number")
+
+    @property
+    @pulumi.getter(name="pageSize")
+    def page_size(self) -> Optional[int]:
+        return pulumi.get(self, "page_size")
+
+    @property
+    @pulumi.getter(name="planSubscribeType")
+    def plan_subscribe_type(self) -> Optional[str]:
+        return pulumi.get(self, "plan_subscribe_type")
+
+    @property
+    @pulumi.getter(name="resourceGroupId")
+    def resource_group_id(self) -> Optional[str]:
+        """
+        The ID of the resource group
+        """
+        return pulumi.get(self, "resource_group_id")
+
+    @property
+    @pulumi.getter(name="siteName")
+    def site_name(self) -> Optional[str]:
+        """
+        Site Name
+        """
+        return pulumi.get(self, "site_name")
+
+    @property
+    @pulumi.getter(name="siteSearchType")
+    def site_search_type(self) -> Optional[str]:
+        return pulumi.get(self, "site_search_type")
+
+    @property
+    @pulumi.getter
+    def sites(self) -> Sequence['outputs.GetSitesSiteResult']:
+        """
+        A list of Site Entries. Each element contains the following attributes:
+        """
+        return pulumi.get(self, "sites")
+
+    @property
+    @pulumi.getter
+    def status(self) -> Optional[str]:
+        """
+        The status of the resource
+        """
+        return pulumi.get(self, "status")
+
+    @property
+    @pulumi.getter
+    def tags(self) -> Optional[Mapping[str, str]]:
+        return pulumi.get(self, "tags")
+
+
+class AwaitableGetSitesResult(GetSitesResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetSitesResult(
+            access_type=self.access_type,
+            coverage=self.coverage,
+            id=self.id,
+            ids=self.ids,
+            name_regex=self.name_regex,
+            names=self.names,
+            only_enterprise=self.only_enterprise,
+            output_file=self.output_file,
+            page_number=self.page_number,
+            page_size=self.page_size,
+            plan_subscribe_type=self.plan_subscribe_type,
+            resource_group_id=self.resource_group_id,
+            site_name=self.site_name,
+            site_search_type=self.site_search_type,
+            sites=self.sites,
+            status=self.status,
+            tags=self.tags)
+
+
+def get_sites(access_type: Optional[str] = None,
+              coverage: Optional[str] = None,
+              ids: Optional[Sequence[str]] = None,
+              name_regex: Optional[str] = None,
+              only_enterprise: Optional[bool] = None,
+              output_file: Optional[str] = None,
+              page_number: Optional[int] = None,
+              page_size: Optional[int] = None,
+              plan_subscribe_type: Optional[str] = None,
+              resource_group_id: Optional[str] = None,
+              site_name: Optional[str] = None,
+              site_search_type: Optional[str] = None,
+              status: Optional[str] = None,
+              tags: Optional[Mapping[str, str]] = None,
+              opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetSitesResult:
+    """
+    This data source provides Esa Site available to the user.[What is Site](https://next.api.alibabacloud.com/document/ESA/2024-09-10/CreateSite)
+
+    > **NOTE:** Available since v1.244.0.
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_alicloud as alicloud
+
+    config = pulumi.Config()
+    name = config.get("name")
+    if name is None:
+        name = "terraform-example"
+    default_i_eo_df_u = alicloud.esa.RatePlanInstance("defaultIEoDfU",
+        type="NS",
+        auto_renew=True,
+        period=1,
+        payment_type="Subscription",
+        coverage="overseas",
+        auto_pay=True,
+        plan_name="basic")
+    default_site = alicloud.esa.Site("default",
+        site_name="bcd.com",
+        coverage="overseas",
+        access_type="NS",
+        instance_id=default_i_eo_df_u.id)
+    default = alicloud.esa.get_sites_output(ids=[default_site.id],
+        name_regex=default_site.site_name,
+        site_name="bcd.com")
+    pulumi.export("alicloudEsaSiteExampleId", default.sites[0].id)
+    ```
+
+
+    :param str access_type: Access type. Value:-**NS**: Managed access via NS.-**CNAME**: access through CNAME.
+    :param str coverage: Acceleration area
+    :param Sequence[str] ids: A list of Site IDs.
+    :param str name_regex: A regex string to filter results by Group Metric Rule name.
+    :param bool only_enterprise: Only the Enterprise version, pass **true** when the table only queries the enterprise version of the site.
+    :param str output_file: File name where to save data source results (after running `pulumi preview`).
+    :param int page_number: Current page number.
+    :param int page_size: Number of records per page.
+    :param str plan_subscribe_type: Package subscription type. Value:-**basicplan**: Basic version.-**standardplan**: Standard version.-**advancedplan**: Advanced version.-**enterpriseplan**: Enterprise Edition.
+    :param str resource_group_id: The ID of the resource group
+    :param str site_name: Site Name
+    :param str site_search_type: The search match pattern for the site name. The default value is exact match. Valid values:-**prefix**: matches the prefix.-**suffix**: The suffix matches.-**exact**: exact match.-**fuzzy**: fuzzy match.
+    :param str status: The status of the resource
+    :param Mapping[str, str] tags: Resource tags
+    """
+    __args__ = dict()
+    __args__['accessType'] = access_type
+    __args__['coverage'] = coverage
+    __args__['ids'] = ids
+    __args__['nameRegex'] = name_regex
+    __args__['onlyEnterprise'] = only_enterprise
+    __args__['outputFile'] = output_file
+    __args__['pageNumber'] = page_number
+    __args__['pageSize'] = page_size
+    __args__['planSubscribeType'] = plan_subscribe_type
+    __args__['resourceGroupId'] = resource_group_id
+    __args__['siteName'] = site_name
+    __args__['siteSearchType'] = site_search_type
+    __args__['status'] = status
+    __args__['tags'] = tags
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('alicloud:esa/getSites:getSites', __args__, opts=opts, typ=GetSitesResult).value
+
+    return AwaitableGetSitesResult(
+        access_type=pulumi.get(__ret__, 'access_type'),
+        coverage=pulumi.get(__ret__, 'coverage'),
+        id=pulumi.get(__ret__, 'id'),
+        ids=pulumi.get(__ret__, 'ids'),
+        name_regex=pulumi.get(__ret__, 'name_regex'),
+        names=pulumi.get(__ret__, 'names'),
+        only_enterprise=pulumi.get(__ret__, 'only_enterprise'),
+        output_file=pulumi.get(__ret__, 'output_file'),
+        page_number=pulumi.get(__ret__, 'page_number'),
+        page_size=pulumi.get(__ret__, 'page_size'),
+        plan_subscribe_type=pulumi.get(__ret__, 'plan_subscribe_type'),
+        resource_group_id=pulumi.get(__ret__, 'resource_group_id'),
+        site_name=pulumi.get(__ret__, 'site_name'),
+        site_search_type=pulumi.get(__ret__, 'site_search_type'),
+        sites=pulumi.get(__ret__, 'sites'),
+        status=pulumi.get(__ret__, 'status'),
+        tags=pulumi.get(__ret__, 'tags'))
+def get_sites_output(access_type: Optional[pulumi.Input[Optional[str]]] = None,
+                     coverage: Optional[pulumi.Input[Optional[str]]] = None,
+                     ids: Optional[pulumi.Input[Optional[Sequence[str]]]] = None,
+                     name_regex: Optional[pulumi.Input[Optional[str]]] = None,
+                     only_enterprise: Optional[pulumi.Input[Optional[bool]]] = None,
+                     output_file: Optional[pulumi.Input[Optional[str]]] = None,
+                     page_number: Optional[pulumi.Input[Optional[int]]] = None,
+                     page_size: Optional[pulumi.Input[Optional[int]]] = None,
+                     plan_subscribe_type: Optional[pulumi.Input[Optional[str]]] = None,
+                     resource_group_id: Optional[pulumi.Input[Optional[str]]] = None,
+                     site_name: Optional[pulumi.Input[Optional[str]]] = None,
+                     site_search_type: Optional[pulumi.Input[Optional[str]]] = None,
+                     status: Optional[pulumi.Input[Optional[str]]] = None,
+                     tags: Optional[pulumi.Input[Optional[Mapping[str, str]]]] = None,
+                     opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetSitesResult]:
+    """
+    This data source provides Esa Site available to the user.[What is Site](https://next.api.alibabacloud.com/document/ESA/2024-09-10/CreateSite)
+
+    > **NOTE:** Available since v1.244.0.
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_alicloud as alicloud
+
+    config = pulumi.Config()
+    name = config.get("name")
+    if name is None:
+        name = "terraform-example"
+    default_i_eo_df_u = alicloud.esa.RatePlanInstance("defaultIEoDfU",
+        type="NS",
+        auto_renew=True,
+        period=1,
+        payment_type="Subscription",
+        coverage="overseas",
+        auto_pay=True,
+        plan_name="basic")
+    default_site = alicloud.esa.Site("default",
+        site_name="bcd.com",
+        coverage="overseas",
+        access_type="NS",
+        instance_id=default_i_eo_df_u.id)
+    default = alicloud.esa.get_sites_output(ids=[default_site.id],
+        name_regex=default_site.site_name,
+        site_name="bcd.com")
+    pulumi.export("alicloudEsaSiteExampleId", default.sites[0].id)
+    ```
+
+
+    :param str access_type: Access type. Value:-**NS**: Managed access via NS.-**CNAME**: access through CNAME.
+    :param str coverage: Acceleration area
+    :param Sequence[str] ids: A list of Site IDs.
+    :param str name_regex: A regex string to filter results by Group Metric Rule name.
+    :param bool only_enterprise: Only the Enterprise version, pass **true** when the table only queries the enterprise version of the site.
+    :param str output_file: File name where to save data source results (after running `pulumi preview`).
+    :param int page_number: Current page number.
+    :param int page_size: Number of records per page.
+    :param str plan_subscribe_type: Package subscription type. Value:-**basicplan**: Basic version.-**standardplan**: Standard version.-**advancedplan**: Advanced version.-**enterpriseplan**: Enterprise Edition.
+    :param str resource_group_id: The ID of the resource group
+    :param str site_name: Site Name
+    :param str site_search_type: The search match pattern for the site name. The default value is exact match. Valid values:-**prefix**: matches the prefix.-**suffix**: The suffix matches.-**exact**: exact match.-**fuzzy**: fuzzy match.
+    :param str status: The status of the resource
+    :param Mapping[str, str] tags: Resource tags
+    """
+    __args__ = dict()
+    __args__['accessType'] = access_type
+    __args__['coverage'] = coverage
+    __args__['ids'] = ids
+    __args__['nameRegex'] = name_regex
+    __args__['onlyEnterprise'] = only_enterprise
+    __args__['outputFile'] = output_file
+    __args__['pageNumber'] = page_number
+    __args__['pageSize'] = page_size
+    __args__['planSubscribeType'] = plan_subscribe_type
+    __args__['resourceGroupId'] = resource_group_id
+    __args__['siteName'] = site_name
+    __args__['siteSearchType'] = site_search_type
+    __args__['status'] = status
+    __args__['tags'] = tags
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('alicloud:esa/getSites:getSites', __args__, opts=opts, typ=GetSitesResult)
+    return __ret__.apply(lambda __response__: GetSitesResult(
+        access_type=pulumi.get(__response__, 'access_type'),
+        coverage=pulumi.get(__response__, 'coverage'),
+        id=pulumi.get(__response__, 'id'),
+        ids=pulumi.get(__response__, 'ids'),
+        name_regex=pulumi.get(__response__, 'name_regex'),
+        names=pulumi.get(__response__, 'names'),
+        only_enterprise=pulumi.get(__response__, 'only_enterprise'),
+        output_file=pulumi.get(__response__, 'output_file'),
+        page_number=pulumi.get(__response__, 'page_number'),
+        page_size=pulumi.get(__response__, 'page_size'),
+        plan_subscribe_type=pulumi.get(__response__, 'plan_subscribe_type'),
+        resource_group_id=pulumi.get(__response__, 'resource_group_id'),
+        site_name=pulumi.get(__response__, 'site_name'),
+        site_search_type=pulumi.get(__response__, 'site_search_type'),
+        sites=pulumi.get(__response__, 'sites'),
+        status=pulumi.get(__response__, 'status'),
+        tags=pulumi.get(__response__, 'tags')))

pulumi_alicloud/esa/http_request_header_modification_rule.py

@@ -30,12 +30,14 @@ class HttpRequestHeaderModificationRuleArgs:
         """
         The set of arguments for constructing a HttpRequestHeaderModificationRule resource.
         :param pulumi.Input[Sequence[pulumi.Input['HttpRequestHeaderModificationRuleRequestHeaderModificationArgs']]] request_header_modifications: The configurations of modifying request headers. You can add, delete, or modify a request header. See `request_header_modification` below.
-        :param pulumi.Input[int] site_id: The site ID, which can be obtained by calling the ListSites API.
-        :param pulumi.Input[str] rule: The rule content.
-        :param pulumi.Input[str] rule_enable: Rule switch. Value range:
-               on: Open.
-               off: off.
-        :param pulumi.Input[str] rule_name: Rule Name.
+        :param pulumi.Input[int] site_id: The site ID.
+        :param pulumi.Input[str] rule: Rule content, using conditional expressions to match user requests. When adding global configuration, this parameter does not need to be set. There are two usage scenarios:
+               - Match all incoming requests: value set to true
+               - Match specified request: Set the value to a custom expression, for example: (http.host eq \\"video.example.com\\")
+        :param pulumi.Input[str] rule_enable: Rule switch. When adding global configuration, this parameter does not need to be set. Value range:
+               - on: open.
+               - off: close.
+        :param pulumi.Input[str] rule_name: Rule name. When adding global configuration, this parameter does not need to be set.
         :param pulumi.Input[int] site_version: The version number of the website configurations.
         """
         pulumi.set(__self__, "request_header_modifications", request_header_modifications)
@@ -65,7 +67,7 @@ class HttpRequestHeaderModificationRuleArgs:
     @pulumi.getter(name="siteId")
     def site_id(self) -> pulumi.Input[int]:
         """
-        The site ID, which can be obtained by calling the ListSites API.
+        The site ID.
         """
         return pulumi.get(self, "site_id")
 
@@ -77,7 +79,9 @@ class HttpRequestHeaderModificationRuleArgs:
     @pulumi.getter
     def rule(self) -> Optional[pulumi.Input[str]]:
         """
-        The rule content.
+        Rule content, using conditional expressions to match user requests. When adding global configuration, this parameter does not need to be set. There are two usage scenarios:
+        - Match all incoming requests: value set to true
+        - Match specified request: Set the value to a custom expression, for example: (http.host eq \\"video.example.com\\")
         """
         return pulumi.get(self, "rule")
 
@@ -89,9 +93,9 @@ class HttpRequestHeaderModificationRuleArgs:
     @pulumi.getter(name="ruleEnable")
     def rule_enable(self) -> Optional[pulumi.Input[str]]:
         """
-        Rule switch. Value range:
-        on: Open.
-        off: off.
+        Rule switch. When adding global configuration, this parameter does not need to be set. Value range:
+        - on: open.
+        - off: close.
         """
         return pulumi.get(self, "rule_enable")
 
@@ -103,7 +107,7 @@ class HttpRequestHeaderModificationRuleArgs:
     @pulumi.getter(name="ruleName")
     def rule_name(self) -> Optional[pulumi.Input[str]]:
         """
-        Rule Name.
+        Rule name. When adding global configuration, this parameter does not need to be set.
         """
         return pulumi.get(self, "rule_name")
 
@@ -138,12 +142,14 @@ class _HttpRequestHeaderModificationRuleState:
         Input properties used for looking up and filtering HttpRequestHeaderModificationRule resources.
         :param pulumi.Input[int] config_id: Config Id
         :param pulumi.Input[Sequence[pulumi.Input['HttpRequestHeaderModificationRuleRequestHeaderModificationArgs']]] request_header_modifications: The configurations of modifying request headers. You can add, delete, or modify a request header. See `request_header_modification` below.
-        :param pulumi.Input[str] rule: The rule content.
-        :param pulumi.Input[str] rule_enable: Rule switch. Value range:
-               on: Open.
-               off: off.
-        :param pulumi.Input[str] rule_name: Rule Name.
-        :param pulumi.Input[int] site_id: The site ID, which can be obtained by calling the ListSites API.
+        :param pulumi.Input[str] rule: Rule content, using conditional expressions to match user requests. When adding global configuration, this parameter does not need to be set. There are two usage scenarios:
+               - Match all incoming requests: value set to true
+               - Match specified request: Set the value to a custom expression, for example: (http.host eq \\"video.example.com\\")
+        :param pulumi.Input[str] rule_enable: Rule switch. When adding global configuration, this parameter does not need to be set. Value range:
+               - on: open.
+               - off: close.
+        :param pulumi.Input[str] rule_name: Rule name. When adding global configuration, this parameter does not need to be set.
+        :param pulumi.Input[int] site_id: The site ID.
         :param pulumi.Input[int] site_version: The version number of the website configurations.
         """
         if config_id is not None:
@@ -189,7 +195,9 @@ class _HttpRequestHeaderModificationRuleState:
     @pulumi.getter
     def rule(self) -> Optional[pulumi.Input[str]]:
         """
-        The rule content.
+        Rule content, using conditional expressions to match user requests. When adding global configuration, this parameter does not need to be set. There are two usage scenarios:
+        - Match all incoming requests: value set to true
+        - Match specified request: Set the value to a custom expression, for example: (http.host eq \\"video.example.com\\")
         """
         return pulumi.get(self, "rule")
 
@@ -201,9 +209,9 @@ class _HttpRequestHeaderModificationRuleState:
     @pulumi.getter(name="ruleEnable")
     def rule_enable(self) -> Optional[pulumi.Input[str]]:
         """
-        Rule switch. Value range:
-        on: Open.
-        off: off.
+        Rule switch. When adding global configuration, this parameter does not need to be set. Value range:
+        - on: open.
+        - off: close.
         """
         return pulumi.get(self, "rule_enable")
 
@@ -215,7 +223,7 @@ class _HttpRequestHeaderModificationRuleState:
     @pulumi.getter(name="ruleName")
     def rule_name(self) -> Optional[pulumi.Input[str]]:
         """
-        Rule Name.
+        Rule name. When adding global configuration, this parameter does not need to be set.
         """
         return pulumi.get(self, "rule_name")
 
@@ -227,7 +235,7 @@ class _HttpRequestHeaderModificationRuleState:
     @pulumi.getter(name="siteId")
     def site_id(self) -> Optional[pulumi.Input[int]]:
         """
-        The site ID, which can be obtained by calling the ListSites API.
+        The site ID.
         """
         return pulumi.get(self, "site_id")
 
@@ -263,7 +271,7 @@ class HttpRequestHeaderModificationRule(pulumi.CustomResource):
         """
         Provides a ESA Http Request Header Modification Rule resource.
 
-        For information about ESA Http Request Header Modification Rule and how to use it, see [What is Http Request Header Modification Rule](https://www.alibabacloud.com/help/en/).
+        For information about ESA Http Request Header Modification Rule and how to use it, see [What is Http Request Header Modification Rule](https://www.alibabacloud.com/help/en/edge-security-acceleration/esa/api-esa-2024-09-10-createhttprequestheadermodificationrule).
 
         > **NOTE:** Available since v1.242.0.
 
@@ -316,12 +324,14 @@ class HttpRequestHeaderModificationRule(pulumi.CustomResource):
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[Sequence[pulumi.Input[Union['HttpRequestHeaderModificationRuleRequestHeaderModificationArgs', 'HttpRequestHeaderModificationRuleRequestHeaderModificationArgsDict']]]] request_header_modifications: The configurations of modifying request headers. You can add, delete, or modify a request header. See `request_header_modification` below.
-        :param pulumi.Input[str] rule: The rule content.
-        :param pulumi.Input[str] rule_enable: Rule switch. Value range:
-               on: Open.
-               off: off.
-        :param pulumi.Input[str] rule_name: Rule Name.
-        :param pulumi.Input[int] site_id: The site ID, which can be obtained by calling the ListSites API.
+        :param pulumi.Input[str] rule: Rule content, using conditional expressions to match user requests. When adding global configuration, this parameter does not need to be set. There are two usage scenarios:
+               - Match all incoming requests: value set to true
+               - Match specified request: Set the value to a custom expression, for example: (http.host eq \\"video.example.com\\")
+        :param pulumi.Input[str] rule_enable: Rule switch. When adding global configuration, this parameter does not need to be set. Value range:
+               - on: open.
+               - off: close.
+        :param pulumi.Input[str] rule_name: Rule name. When adding global configuration, this parameter does not need to be set.
+        :param pulumi.Input[int] site_id: The site ID.
         :param pulumi.Input[int] site_version: The version number of the website configurations.
         """
         ...
@@ -333,7 +343,7 @@ class HttpRequestHeaderModificationRule(pulumi.CustomResource):
         """
         Provides a ESA Http Request Header Modification Rule resource.
 
-        For information about ESA Http Request Header Modification Rule and how to use it, see [What is Http Request Header Modification Rule](https://www.alibabacloud.com/help/en/).
+        For information about ESA Http Request Header Modification Rule and how to use it, see [What is Http Request Header Modification Rule](https://www.alibabacloud.com/help/en/edge-security-acceleration/esa/api-esa-2024-09-10-createhttprequestheadermodificationrule).
 
         > **NOTE:** Available since v1.242.0.
 
@@ -450,12 +460,14 @@ class HttpRequestHeaderModificationRule(pulumi.CustomResource):
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[int] config_id: Config Id
         :param pulumi.Input[Sequence[pulumi.Input[Union['HttpRequestHeaderModificationRuleRequestHeaderModificationArgs', 'HttpRequestHeaderModificationRuleRequestHeaderModificationArgsDict']]]] request_header_modifications: The configurations of modifying request headers. You can add, delete, or modify a request header. See `request_header_modification` below.
-        :param pulumi.Input[str] rule: The rule content.
-        :param pulumi.Input[str] rule_enable: Rule switch. Value range:
-               on: Open.
-               off: off.
-        :param pulumi.Input[str] rule_name: Rule Name.
-        :param pulumi.Input[int] site_id: The site ID, which can be obtained by calling the ListSites API.
+        :param pulumi.Input[str] rule: Rule content, using conditional expressions to match user requests. When adding global configuration, this parameter does not need to be set. There are two usage scenarios:
+               - Match all incoming requests: value set to true
+               - Match specified request: Set the value to a custom expression, for example: (http.host eq \\"video.example.com\\")
+        :param pulumi.Input[str] rule_enable: Rule switch. When adding global configuration, this parameter does not need to be set. Value range:
+               - on: open.
+               - off: close.
+        :param pulumi.Input[str] rule_name: Rule name. When adding global configuration, this parameter does not need to be set.
+        :param pulumi.Input[int] site_id: The site ID.
         :param pulumi.Input[int] site_version: The version number of the website configurations.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -491,7 +503,9 @@ class HttpRequestHeaderModificationRule(pulumi.CustomResource):
     @pulumi.getter
     def rule(self) -> pulumi.Output[Optional[str]]:
         """
-        The rule content.
+        Rule content, using conditional expressions to match user requests. When adding global configuration, this parameter does not need to be set. There are two usage scenarios:
+        - Match all incoming requests: value set to true
+        - Match specified request: Set the value to a custom expression, for example: (http.host eq \\"video.example.com\\")
         """
         return pulumi.get(self, "rule")
 
@@ -499,9 +513,9 @@ class HttpRequestHeaderModificationRule(pulumi.CustomResource):
     @pulumi.getter(name="ruleEnable")
     def rule_enable(self) -> pulumi.Output[Optional[str]]:
         """
-        Rule switch. Value range:
-        on: Open.
-        off: off.
+        Rule switch. When adding global configuration, this parameter does not need to be set. Value range:
+        - on: open.
+        - off: close.
         """
         return pulumi.get(self, "rule_enable")
 
@@ -509,7 +523,7 @@ class HttpRequestHeaderModificationRule(pulumi.CustomResource):
     @pulumi.getter(name="ruleName")
     def rule_name(self) -> pulumi.Output[Optional[str]]:
         """
-        Rule Name.
+        Rule name. When adding global configuration, this parameter does not need to be set.
         """
         return pulumi.get(self, "rule_name")
 
@@ -517,7 +531,7 @@ class HttpRequestHeaderModificationRule(pulumi.CustomResource):
     @pulumi.getter(name="siteId")
     def site_id(self) -> pulumi.Output[int]:
         """
-        The site ID, which can be obtained by calling the ListSites API.
+        The site ID.
         """
         return pulumi.get(self, "site_id")