你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Container Apps - List Custom Host Name Analysis
分析容器应用的自定义主机名
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/containerApps/{containerAppName}/listCustomHostNameAnalysis?api-version=2024-03-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/containerApps/{containerAppName}/listCustomHostNameAnalysis?customHostname={customHostname}&api-version=2024-03-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
container
|
path | True |
string |
容器应用的名称。 |
resource
|
path | True |
string |
资源组的名称。 此名称不区分大小写。 |
subscription
|
path | True |
string |
目标订阅的 ID。 |
api-version
|
query | True |
string |
要用于此操作的 API 版本。 |
custom
|
query |
string |
自定义主机名。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
确定 |
|
Other Status Codes |
常见错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 流
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
Analyze Custom Hostname
示例请求
示例响应
{
"hostName": "my.name.corp",
"isHostnameAlreadyVerified": true,
"customDomainVerificationTest": "Passed",
"customDomainVerificationFailureInfo": {},
"hasConflictOnManagedEnvironment": false,
"conflictingContainerAppResourceId": "",
"cNameRecords": [
"cNameRecord1",
"cNameRecord2"
],
"txtRecords": [
"txtRecord1",
"txtRecord2"
],
"aRecords": [
"aRecord1",
"aRecord2"
],
"alternateCNameRecords": [
"cNameRecord1",
"cNameRecord2"
],
"alternateTxtRecords": [
"txtRecord1",
"txtRecord2"
]
}
定义
名称 | 说明 |
---|---|
Custom |
DNS 验证失败时的原始故障信息。 |
Custom |
自定义域分析。 |
Default |
App 服务错误响应。 |
Details |
详细信息或错误 |
Dns |
DNS 验证测试结果。 |
Error |
错误模型。 |
CustomDomainVerificationFailureInfo
DNS 验证失败时的原始故障信息。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
用于以编程方式识别错误的标准化字符串。 |
details |
Details[] |
详细信息或错误 |
message |
string |
详细的错误说明和调试信息。 |
target |
string |
详细的错误说明和调试信息。 |
CustomHostnameAnalysisResult
自定义域分析。
名称 | 类型 | 说明 |
---|---|---|
aRecords |
string[] |
此主机名可见的记录。 |
alternateCNameRecords |
string[] |
此主机名可见的备用 CName 记录。 |
alternateTxtRecords |
string[] |
此主机名可见的备用 TXT 记录。 |
cNameRecords |
string[] |
CName 记录对此主机名可见。 |
conflictWithEnvironmentCustomDomain |
boolean |
|
conflictingContainerAppResourceId |
string |
托管环境中冲突的容器应用的名称(如果它位于同一订阅中)。 |
customDomainVerificationFailureInfo |
DNS 验证失败时的原始故障信息。 |
|
customDomainVerificationTest |
DNS 验证测试结果。 |
|
hasConflictOnManagedEnvironment |
boolean |
|
hostName |
string |
已分析的主机名 |
isHostnameAlreadyVerified |
boolean |
|
txtRecords |
string[] |
此主机名可见的 TXT 记录。 |
DefaultErrorResponse
App 服务错误响应。
名称 | 类型 | 说明 |
---|---|---|
error |
错误模型。 |
Details
详细信息或错误
名称 | 类型 | 说明 |
---|---|---|
code |
string |
用于以编程方式识别错误的标准化字符串。 |
message |
string |
详细的错误说明和调试信息。 |
target |
string |
详细的错误说明和调试信息。 |
DnsVerificationTestResult
DNS 验证测试结果。
名称 | 类型 | 说明 |
---|---|---|
Failed |
string |
|
Passed |
string |
|
Skipped |
string |
Error
错误模型。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
用于以编程方式识别错误的标准化字符串。 |
details |
Details[] |
详细信息或错误 |
innererror |
string |
调试错误的详细信息。 |
message |
string |
详细的错误说明和调试信息。 |
target |
string |
详细的错误说明和调试信息。 |