Microsof.app 2022 01 01 preview/add custom domains

specification/app/resource-manager/Microsoft.App/preview/2022-01-01-preview/ContainerApps.json

@@ -309,6 +309,53 @@
           }
         }
       }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/containerApps/{name}/analyzeCustomHostName": {
+      "get": {
+        "tags" : [
+          "ContainerApps"
+        ],
+        "summary" : "Analyzes a custom hostname for a Container App",
+        "operationId": "ContainerAppsRevisions_AnalyzeCustomHostName",
+        "parameters" :[
+          {
+            "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "containerAppName",
+            "in": "path",
+            "description": "Name of the Container App.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "hostName",
+            "in": "query",
+            "description": "Custom hostname.",
+            "type": "string"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/CustomHostnameAnalysisResult"
+            }
+          },
+          "default": {
+            "description": "Common error response.",
+            "schema": {
+              "$ref": "./CommonDefinitions.json#/definitions/DefaultErrorResponse"
+            }
+          }
+        }
+      }
     }
   },
   "definitions": {
@@ -400,6 +447,11 @@
               "type": "string",
               "readOnly": true
             },
+            "customDomainVerificationId": {
+              "description": "Id used to verify domain name ownership",
+              "type": "string",
+              "readOnly": true
+            },
             "configuration": {
               "$ref": "#/definitions/Configuration",
               "description": "Non versioned Container App configuration properties."
@@ -489,6 +541,13 @@
             "revisionName"
           ]
         },
+        "customDomains": {
+          "description": "custom domain bindings for Container Apps' hostnames.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CustomDomain"
+          }
+        },
         "allowInsecure": {
           "description": "Bool indicating if HTTP connections to is allowed. If set to false HTTP connections are automatically redirected to HTTPS connections",
           "type": "boolean"
@@ -551,6 +610,141 @@
           "type": "boolean"
         }
       }
+    },
+    "CustomDomain": {
+      "description": "Custom Domain of a Container App",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Hostname.",
+          "type": "string"
+        },
+        "bindingType": {
+          "description": "Custom Domain binding type.",
+          "enum": [
+            "Disabled",
+            "SniEnabled",
+            "IpBasedEnabled"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "bindingType",
+            "modelAsString": false
+          }
+        },
+        "virtualIP": {
+          "description": "Virtual IP address assigned to the hostname if IP based binding is enabled.",
+          "type": "string"
+        },
+        "certificateName": {
+          "description": "Name of the Certificate to be bound to this hostname. Must exist in the Managed Environment.",
+          "type": "string"
+        },
+        "hostType": {
+          "description": "Indicates whether the hostname is a standard or repository hostname.",
+          "enum": [
+            "Standard",
+            "Repository"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "HostType",
+            "modelAsString": false
+          }
+        }
+      }
+    },
+    "CustomHostnameAnalysisResult": {
+      "description": "Custom domain analysis.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "./CommonDefinitions.json#/definitions/ProxyOnlyResource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "description": "CustomHostnameAnalysisResult resource specific properties",
+          "type": "object",
+          "properties": {
+            "isHostnameAlreadyVerified": {
+              "description": "<code>true</code> if hostname is already verified; otherwise, <code>false</code>.",
+              "type": "boolean",
+              "readOnly": true
+            },
+            "customDomainVerificationTest": {
+              "description": "DNS verification test result.",
+              "enum": [
+                "Passed",
+                "Failed",
+                "Skipped"
+              ],
+              "type": "string",
+              "readOnly": true,
+              "x-ms-enum": {
+                "name": "DnsVerificationTestResult",
+                "modelAsString": false
+              }
+            },
+            "customDomainVerificationFailureInfo": {
+              "$ref": "./CommonDefinitions.json#/definitions/DefaultErrorResponse",
+              "description": "Raw failure information if DNS verification fails.",
+              "readOnly": true
+            },
+            "hasConflictOnManagedEnvironment": {
+              "description": "<code>true</code> if there is a conflict on the Container App's managed environment; otherwise, <code>false</code>.",
+              "type": "boolean",
+              "readOnly": true
+            },
+            "hasConflictAcrossSubscription": {
+              "description": "<code>true</code> if there is a conflict across subscriptions; otherwise, <code>false</code>.",
+              "type": "boolean",
+              "readOnly": true
+            },
+            "conflictingAppResourceId": {
+              "description": "Name of the conflicting Container App on the Managed Environment if it's within the same subscription.",
+              "type": "string",
+              "readOnly": true
+            },
+            "cNameRecords": {
+              "description": "CName records visible for this hostname.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "txtRecords": {
+              "description": "TXT records visible for this hostname.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "aRecords": {
+              "description": "A records visible for this hostname.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "alternateCNameRecords": {
+              "description": "Alternate CName records visible for this hostname.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "alternateTxtRecords": {
+              "description": "Alternate TXT records visible for this hostname.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "x-ms-client-flatten": true
+        }
+      }
     }
   },
   "securityDefinitions": {

specification/app/resource-manager/Microsoft.App/preview/2022-01-01-preview/ManagedEnvironments.json

@@ -443,6 +443,13 @@
             "appLogsConfiguration": {
               "$ref": "#/definitions/AppLogsConfiguration",
               "description": "Cluster configuration which enables the log daemon to export\napp logs to a destination. Currently only \"log-analytics\" is\nsupported"
+            },
+            "certificates": {
+              "description": "Hostname binding Certificates available to container apps in the Managed Environment",
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/Certificate"
+              }
             }
           },
           "x-ms-client-flatten": true
@@ -501,6 +508,132 @@
           "x-ms-secret": true
         }
       }
+    },
+    "Certificate": {
+      "description": "Certificate used for Custom Domain bindings of Container Apps in a Managed Environment",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "../../../../../common-types/resource-management/v3/types.json#/definitions/TrackedResource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "description": "Certificate resource specific properties",
+          "type": "object",
+          "properties": {
+            "provisioningState": {
+              "description": "Provisioning state of the Certificate.",
+              "enum": [
+                "Succeeded",
+                "Failed"
+              ],
+              "type": "string",
+              "readOnly": true,
+              "x-ms-enum": {
+                "name": "CertificateProvisioningState",
+                "modelAsString": true
+              }
+            },
+            "password": {
+              "description": "Certificate password.",
+              "type": "string",
+              "x-ms-mutability": [
+                "create"
+              ]
+            },
+            "name": {
+              "description": "Friendly name of the certificate.",
+              "type": "string",
+              "readOnly": true
+            },
+            "subjectName": {
+              "description": "Subject name of the certificate.",
+              "type": "string",
+              "readOnly": true
+            },
+            "value": {
+              "format": "byte",
+              "description": "PFX or PEM blob",
+              "type": "string",
+              "x-ms-mutability": [
+                "create"
+              ]
+            },
+            "issuer": {
+              "description": "Certificate issuer.",
+              "type": "string",
+              "readOnly": true
+            },
+            "issueDate": {
+              "format": "date-time",
+              "description": "Certificate issue Date.",
+              "type": "string",
+              "readOnly": true
+            },
+            "expirationDate": {
+              "format": "date-time",
+              "description": "Certificate expiration date.",
+              "type": "string",
+              "readOnly": true
+            },
+            "thumbprint": {
+              "description": "Certificate thumbprint.",
+              "type": "string",
+              "readOnly": true
+            },
+            "valid": {
+              "description": "Is the certificate valid?.",
+              "type": "boolean",
+              "readOnly": true
+            },
+            "publicKeyHash": {
+              "description": "Public key hash.",
+              "type": "string",
+              "readOnly": true
+            },
+            "keyVaultId": {
+              "description": "Key Vault Csm resource Id.",
+              "type": "string"
+            },
+            "keyVaultSecretName": {
+              "description": "Key Vault secret name.",
+              "type": "string"
+            },
+            "keyVaultSecretStatus": {
+              "description": "Status of the Key Vault secret.",
+              "enum": [
+                "Initialized",
+                "WaitingOnCertificateOrder",
+                "Succeeded",
+                "CertificateOrderFailed",
+                "OperationNotPermittedOnKeyVault",
+                "AzureServiceUnauthorizedToAccessKeyVault",
+                "KeyVaultDoesNotExist",
+                "KeyVaultSecretDoesNotExist",
+                "UnknownError",
+                "ExternalPrivateKey",
+                "Unknown"
+              ],
+              "type": "string",
+              "readOnly": true,
+              "x-ms-enum": {
+                "name": "KeyVaultSecretStatus",
+                "modelAsString": false
+              }
+            },
+            "canonicalName": {
+              "description": "CNAME of the certificate to be issued via free certificate",
+              "type": "string"
+            },
+            "domainValidationMethod": {
+              "description": "Method of domain validation for free cert",
+              "type": "string"
+            }
+          },
+          "x-ms-client-flatten": true
+        }
+      }
     }
   },
   "securityDefinitions": {

specification/app/resource-manager/Microsoft.App/preview/2022-01-01-preview/examples/ContainerApps_CreateOrUpdate.json

@@ -11,7 +11,19 @@
         "configuration": {
           "ingress": {
             "external": true,
-            "targetPort": 3000
+            "targetPort": 3000,
+            "customDomains": [
+              {
+                "name": "www.my-name.com",
+                "bindingType": "SniEnabled",
+                "certificateName": "my-certificate-for-my-name-dot-com"
+              },
+              {
+                "name": "www.my--other-name.com",
+                "bindingType": "SniEnabled",
+                "certificateName": "my-certificate-for-my-other-name-dot-com"
+              }
+            ]
           }
         },
         "template": {