2025-09-01-p

Author: JingnanXu

Commands/afd/custom-domain/_create.md

@@ -83,3 +83,19 @@ Create a new domain within the specified profile.
     ```bash
         afd custom-domain create -g group --custom-domain-name example-custom-domain --profile-name profile --host-name www.contoso.com --minimum-tls-version TLS12 --certificate-type CustomerCertificate --secret secretName
     ```
+
+### [2025-09-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jZG4vcHJvZmlsZXMve30vY3VzdG9tZG9tYWlucy97fQ==/2025-09-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.cdn/profiles/{}/customdomains/{} 2025-09-01-preview -->
+
+#### examples
+
+- Create a custom domain that uses AFD managed certificate for SSL/TLS encryption.
+    ```bash
+        afd custom-domain create -g group --custom-domain-name customDomain --profile-name profile --host-name www.contoso.com --minimum-tls-version TLS12 --certificate-type ManagedCertificate
+    ```
+
+- Create a custom domain that uses your own certificate for SSL/TLS encryption, the certificate is stored in Azure Key Vault and referenced by an AFD secret.
+    ```bash
+        afd custom-domain create -g group --custom-domain-name customDomain --profile-name profile --host-name www.contoso.com --minimum-tls-version TLS12 --certificate-type CustomerCertificate --secret secretName
+    ```

Commands/afd/custom-domain/_delete.md

@@ -58,3 +58,14 @@ Delete an existing AzureFrontDoor domain with the specified domain name under th
     ```bash
         afd custom-domain delete -g group --profile-name profile  --custom-domain-name customDomainName
     ```
+
+### [2025-09-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jZG4vcHJvZmlsZXMve30vY3VzdG9tZG9tYWlucy97fQ==/2025-09-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.cdn/profiles/{}/customdomains/{} 2025-09-01-preview -->
+
+#### examples
+
+- Delete a custom domain.
+    ```bash
+        afd custom-domain delete -g group --profile-name profile  --custom-domain-name customDomainName
+    ```

Commands/afd/custom-domain/_list.md

@@ -58,3 +58,14 @@ List existing AzureFrontDoor domains.
     ```bash
         afd custom-domain list -g group --profile-name profile
     ```
+
+### [2025-09-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jZG4vcHJvZmlsZXMve30vY3VzdG9tZG9tYWlucw==/2025-09-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.cdn/profiles/{}/customdomains 2025-09-01-preview -->
+
+#### examples
+
+- List all the custom domains within the specified profile.
+    ```bash
+        afd custom-domain list -g group --profile-name profile
+    ```

Commands/afd/custom-domain/_regenerate-validation-token.md

@@ -47,3 +47,14 @@ Updates the domain validation token.
     ```bash
         afd custom-domain regenerate-validation-token -g MyResourceGroup --profile-name MyProfle --custom-domain-name MyCustomDomain
     ```
+
+### [2025-09-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jZG4vcHJvZmlsZXMve30vY3VzdG9tZG9tYWlucy97fS9yZWZyZXNodmFsaWRhdGlvbnRva2Vu/2025-09-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.cdn/profiles/{}/customdomains/{}/refreshvalidationtoken 2025-09-01-preview -->
+
+#### examples
+
+- Regenerate the domain validation token.
+    ```bash
+        afd custom-domain regenerate-validation-token -g MyResourceGroup --profile-name MyProfle --custom-domain-name MyCustomDomain
+    ```

Commands/afd/custom-domain/_show.md

@@ -58,3 +58,14 @@ Get an existing AzureFrontDoor domain with the specified domain name under the s
     ```bash
         afd custom-domain show -g group --profile-name profile  --custom-domain-name customDomainName
     ```
+
+### [2025-09-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jZG4vcHJvZmlsZXMve30vY3VzdG9tZG9tYWlucy97fQ==/2025-09-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.cdn/profiles/{}/customdomains/{} 2025-09-01-preview -->
+
+#### examples
+
+- show details of the custom domain within the specified profile.
+    ```bash
+        afd custom-domain show -g group --profile-name profile  --custom-domain-name customDomainName
+    ```

Commands/afd/custom-domain/_update.md

@@ -83,3 +83,19 @@ Update a new domain within the specified profile.
     ```bash
         afd custom-domain update -g group --custom-domain-name customDomain --profile-name profile --certificate-type ManagedCertificate
     ```
+
+### [2025-09-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jZG4vcHJvZmlsZXMve30vY3VzdG9tZG9tYWlucy97fQ==/2025-09-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.cdn/profiles/{}/customdomains/{} 2025-09-01-preview -->
+
+#### examples
+
+- Update the custom domain's supported minimum TLS version.
+    ```bash
+        afd custom-domain update -g group --custom-domain-name customDomain --profile-name profile --minimum-tls-version TLS12
+    ```
+
+- Update the custom domain's certificate type to AFD managed certificate.
+    ```bash
+        afd custom-domain update -g group --custom-domain-name customDomain --profile-name profile --certificate-type ManagedCertificate
+    ```

Commands/afd/endpoint/_create.md

@@ -47,3 +47,14 @@ Create a new AzureFrontDoor endpoint with the specified endpoint name under the
     ```bash
         afd endpoint create -g group --endpoint-name endpoint1 --profile-name profile --enabled-state Enabled
     ```
+
+### [2025-09-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jZG4vcHJvZmlsZXMve30vYWZkZW5kcG9pbnRzL3t9/2025-09-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.cdn/profiles/{}/afdendpoints/{} 2025-09-01-preview -->
+
+#### examples
+
+- Creates an enabled endpoint
+    ```bash
+        afd endpoint create -g group --endpoint-name endpoint1 --profile-name profile --enabled-state Enabled
+    ```

Commands/afd/endpoint/_delete.md

@@ -47,3 +47,14 @@ Delete an existing AzureFrontDoor endpoint with the specified endpoint name unde
     ```bash
         afd endpoint delete -g group --profile-name profile --endpoint-name endpoint1
     ```
+
+### [2025-09-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jZG4vcHJvZmlsZXMve30vYWZkZW5kcG9pbnRzL3t9/2025-09-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.cdn/profiles/{}/afdendpoints/{} 2025-09-01-preview -->
+
+#### examples
+
+- Delete an endpoint named endpoint1.
+    ```bash
+        afd endpoint delete -g group --profile-name profile --endpoint-name endpoint1
+    ```

Commands/afd/endpoint/_list.md

@@ -47,3 +47,14 @@ List existing AzureFrontDoor endpoints.
     ```bash
         afd endpoint list -g group --profile-name profile
     ```
+
+### [2025-09-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jZG4vcHJvZmlsZXMve30vYWZkZW5kcG9pbnRz/2025-09-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.cdn/profiles/{}/afdendpoints 2025-09-01-preview -->
+
+#### examples
+
+- List all the endpoints within the specified profile.
+    ```bash
+        afd endpoint list -g group --profile-name profile
+    ```

Commands/afd/endpoint/_purge.md

@@ -47,3 +47,14 @@ Removes a content from AzureFrontDoor.
     ```bash
         afd endpoint purge -g group --profile-name profile --domains www.contoso.com --content-paths '/scripts/*'
     ```
+
+### [2025-09-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jZG4vcHJvZmlsZXMve30vYWZkZW5kcG9pbnRzL3t9L3B1cmdl/2025-09-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.cdn/profiles/{}/afdendpoints/{}/purge 2025-09-01-preview -->
+
+#### examples
+
+- Remove all cached contents under directory "/script" for domain www.contoso.com
+    ```bash
+        afd endpoint purge -g group --profile-name profile --domains www.contoso.com --content-paths '/scripts/*'
+    ```