你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Container Apps Diagnostics - Get Revision

获取容器应用的修订。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/containerApps/{containerAppName}/detectorProperties/revisionsApi/revisions/{revisionName}?api-version=2024-03-01

URI 参数

名称 必需 类型 说明
containerAppName
path True

string

容器应用的名称。

resourceGroupName
path True

string

资源组的名称。 此名称不区分大小写。

revisionName
path True

string

容器应用修订版的名称。

subscriptionId
path True

string

目标订阅的 ID。

api-version
query True

string

要用于此操作的 API 版本。

响应

名称 类型 说明
200 OK

Revision

确定

Other Status Codes

DefaultErrorResponse

常见错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

Get Container App's revision

示例请求

GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerApp0/detectorProperties/revisionsApi/revisions/testcontainerApp0-pjxhsye?api-version=2024-03-01

示例响应

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.AppcontainerApps/testcontainerApp0/revisions/testcontainerApp0-pjxhsye",
  "name": "testcontainerApp0-pjxhsye",
  "type": "Microsoft.App/containerApps/revisions",
  "properties": {
    "createdTime": "2021-05-24T21:24:22+00:00",
    "lastActiveTime": "2021-05-24T21:24:22+00:00",
    "fqdn": "testcontainerApp0-pjxhsye.politehill-ab123456.eastus.azurecontainerapps.io",
    "template": {
      "containers": [
        {
          "image": "repo/testcontainerApp0:v2",
          "name": "testcontainerApp0",
          "resources": {
            "cpu": 0.2,
            "memory": "100Mi"
          }
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 5,
        "rules": [
          {
            "name": "httpscalingrule",
            "http": {
              "metadata": {
                "concurrentRequests": "50"
              }
            }
          }
        ]
      }
    },
    "trafficWeight": 80,
    "active": true,
    "replicas": 1,
    "runningState": "Running"
  }
}

定义

名称 说明
Container

容器应用容器定义

ContainerAppProbe

探测描述针对容器执行的运行状况检查,以确定容器是处于活动状态还是已准备好接收流量。

ContainerResources

容器应用容器资源要求。

createdByType

创建资源的标识类型。

CustomScaleRule

容器应用容器自定义缩放规则。

DefaultErrorResponse

App 服务错误响应。

Details

详细信息或错误

EnvironmentVar

容器应用容器环境变量。

Error

错误模型。

HttpGet

HTTPGet 指定要执行的 http 请求。

HttpHeaders

在请求中设置的自定义标头。 HTTP 允许重复标头。

HttpScaleRule

容器应用容器 Http 缩放规则。

InitContainer

容器应用初始化容器定义

QueueScaleRule

容器应用容器基于 Azure 队列的缩放规则。

Revision

容器应用修订。

RevisionHealthState

修订的当前运行状况

RevisionProvisioningState

修订的当前预配状态

RevisionRunningState

修订的当前运行状态

Scale

容器应用缩放配置。

ScaleRule

容器应用容器缩放规则。

ScaleRuleAuth

缩放规则的身份验证机密

Scheme

用于连接到主机的方案。 默认为 HTTP。

SecretVolumeItem

要添加到卷中的机密。

ServiceBind

用于将 ContainerApp 绑定到开发 ContainerApp 服务的配置

StorageType

卷的存储类型。 如果未提供,请使用 EmptyDir。

systemData

与资源的创建和上次修改相关的元数据。

TcpScaleRule

容器应用容器 Tcp 缩放规则。

TcpSocket

TCPSocket 指定涉及 TCP 端口的操作。 尚不支持 TCP 挂钩。

Template

容器应用版本控制的应用程序定义。 定义不可变修订的所需状态。 对此部分所做的任何更改都将导致创建新的修订

Type

探测的类型。

Volume

容器应用的卷定义。

VolumeMount

容器应用的卷装载。

Container

容器应用容器定义

名称 类型 说明
args

string[]

容器启动命令参数。

command

string[]

容器启动命令。

env

EnvironmentVar[]

容器环境变量。

image

string

容器映像标记。

name

string

自定义容器名称。

probes

ContainerAppProbe[]

容器的探测列表。

resources

ContainerResources

容器资源要求。

volumeMounts

VolumeMount[]

容器卷装载。

ContainerAppProbe

探测描述针对容器执行的运行状况检查,以确定容器是处于活动状态还是已准备好接收流量。

名称 类型 说明
failureThreshold

integer

在成功后,要视为探测失败的最小连续失败次数。 默认值为 3。 最小值为 1。 最大值为 10。

httpGet

HttpGet

HTTPGet 指定要执行的 http 请求。

initialDelaySeconds

integer

启动容器后,启动运行情况探测前的秒数。 最小值为 1。 最大值为 60。

periodSeconds

integer

执行探测的频率(以秒为单位)。 默认值为 10 秒。 最小值为 1。 最大值为 240。

successThreshold

integer

探测在失败后被视为成功的最小连续成功。 默认值为 1。 对于活跃度和启动,必须为 1。 最小值为 1。 最大值为 10。

tcpSocket

TcpSocket

TCPSocket 指定涉及 TCP 端口的操作。 尚不支持 TCP 挂钩。

terminationGracePeriodSeconds

integer

可选持续时间(以秒为单位)在探测失败时 Pod 需要正常终止。 宽限期是向 Pod 中运行的进程发送终止信号之后的持续时间(以秒为单位)以及进程被强行停止并发出终止信号的时间。 请将此值设置为大于你的进程的预期清理时间。 如果此值为 nil,将使用 Pod 的 terminationGracePeriodSeconds。 否则,此值将替代 Pod 规范提供的值。值必须是非负整数。 值零表示通过终止信号立即停止, (没有机会关闭) 。 这是一个 alpha 字段,需要启用 ProbeTerminationGracePeriod 功能门。 最大值为 3600 秒 (1 小时)

timeoutSeconds

integer

探测超时的秒数。默认为 1 秒。 最小值为 1。 最大值为 240。

type

Type

探测的类型。

ContainerResources

容器应用容器资源要求。

名称 类型 说明
cpu

number

核心中所需的 CPU,例如 0.5

ephemeralStorage

string

临时存储,例如“1Gi”

memory

string

所需的内存,例如“250Mb”

createdByType

创建资源的标识类型。

名称 类型 说明
Application

string

Key

string

ManagedIdentity

string

User

string

CustomScaleRule

容器应用容器自定义缩放规则。

名称 类型 说明
auth

ScaleRuleAuth[]

自定义缩放规则的身份验证机密。

metadata

object

描述自定义缩放规则的元数据属性。

type

string

自定义缩放规则的类型,例如:azure-servicebus、redis 等。

DefaultErrorResponse

App 服务错误响应。

名称 类型 说明
error

Error

错误模型。

Details

详细信息或错误

名称 类型 说明
code

string

标准化字符串,用于以编程方式标识错误。

message

string

详细的错误说明和调试信息。

target

string

详细的错误说明和调试信息。

EnvironmentVar

容器应用容器环境变量。

名称 类型 说明
name

string

环境变量名称。

secretRef

string

要从中提取环境变量值的容器应用机密的名称。

value

string

非机密环境变量值。

Error

错误模型。

名称 类型 说明
code

string

标准化字符串,用于以编程方式标识错误。

details

Details[]

详细信息或错误

innererror

string

调试错误的详细信息。

message

string

详细的错误说明和调试信息。

target

string

详细的错误说明和调试信息。

HttpGet

HTTPGet 指定要执行的 http 请求。

名称 类型 说明
host

string

要连接到的主机名,默认为 Pod IP。 你可能想要改为在 httpHeaders 中设置“主机”。

httpHeaders

HttpHeaders[]

在请求中设置的自定义标头。 HTTP 允许重复标头。

path

string

在 HTTP 服务器上访问的路径。

port

integer

要在容器上访问的端口的名称或编号。 数字必须在 1 到 65535 的范围内。 名称必须是IANA_SVC_NAME。

scheme

Scheme

用于连接到主机的方案。 默认为 HTTP。

HttpHeaders

在请求中设置的自定义标头。 HTTP 允许重复标头。

名称 类型 说明
name

string

标头字段名称

value

string

标头字段值

HttpScaleRule

容器应用容器 Http 缩放规则。

名称 类型 说明
auth

ScaleRuleAuth[]

自定义缩放规则的身份验证机密。

metadata

object

用于描述 http 缩放规则的元数据属性。

InitContainer

容器应用初始化容器定义

名称 类型 说明
args

string[]

容器启动命令参数。

command

string[]

容器启动命令。

env

EnvironmentVar[]

容器环境变量。

image

string

容器映像标记。

name

string

自定义容器名称。

resources

ContainerResources

容器资源要求。

volumeMounts

VolumeMount[]

容器卷装载。

QueueScaleRule

容器应用容器基于 Azure 队列的缩放规则。

名称 类型 说明
auth

ScaleRuleAuth[]

队列缩放规则的身份验证机密。

queueLength

integer

队列长度。

queueName

string

队列名称。

Revision

容器应用修订。

名称 类型 说明
id

string

资源的完全限定的资源 ID。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

资源的名称

properties.active

boolean

描述修订是否处于活动状态的布尔值

properties.createdTime

string

描述控制器创建修订的时间戳

properties.fqdn

string

修订的完全限定域名

properties.healthState

RevisionHealthState

修订的当前运行状况

properties.lastActiveTime

string

描述修订上次处于活动状态的时间戳。 仅在修订处于非活动状态时才有意义

properties.provisioningError

string

可选字段 - 平台错误消息

properties.provisioningState

RevisionProvisioningState

修订的当前预配状态

properties.replicas

integer

当前为此修订版运行的 Pod 数

properties.runningState

RevisionRunningState

修订的当前运行状态

properties.template

Template

容器应用修订模板,其中包含所有可能的设置和默认值(如果用户未提供)。 默认值在创建时按原样填充

properties.trafficWeight

integer

分配给此修订版的流量权重

systemData

systemData

包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。

type

string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

RevisionHealthState

修订的当前运行状况

名称 类型 说明
Healthy

string

None

string

Unhealthy

string

RevisionProvisioningState

修订的当前预配状态

名称 类型 说明
Deprovisioned

string

Deprovisioning

string

Failed

string

Provisioned

string

Provisioning

string

RevisionRunningState

修订的当前运行状态

名称 类型 说明
Degraded

string

Failed

string

Processing

string

Running

string

Stopped

string

Unknown

string

Scale

容器应用缩放配置。

名称 类型 默认值 说明
maxReplicas

integer

10

可选。 容器副本的最大数目。 如果未设置,则默认为 10。

minReplicas

integer

可选。 最小容器副本数。

rules

ScaleRule[]

缩放规则。

ScaleRule

容器应用容器缩放规则。

名称 类型 说明
azureQueue

QueueScaleRule

基于 Azure 队列的缩放。

custom

CustomScaleRule

自定义缩放规则。

http

HttpScaleRule

基于 HTTP 请求的缩放。

name

string

缩放规则名称

tcp

TcpScaleRule

基于 Tcp 请求的缩放。

ScaleRuleAuth

缩放规则的身份验证机密

名称 类型 说明
secretRef

string

要从中提取身份验证参数的机密的名称。

triggerParameter

string

使用机密的触发器参数

Scheme

用于连接到主机的方案。 默认为 HTTP。

名称 类型 说明
HTTP

string

HTTPS

string

SecretVolumeItem

要添加到卷中的机密。

名称 类型 说明
path

string

将机密投影到的路径。 如果未提供路径,则 path 默认为 secretRef 中列出的机密名称。

secretRef

string

要从中提取机密值的容器应用机密的名称。

ServiceBind

用于将 ContainerApp 绑定到开发 ContainerApp 服务的配置

名称 类型 说明
name

string

服务绑定的名称

serviceId

string

目标服务的资源 ID

StorageType

卷的存储类型。 如果未提供,请使用 EmptyDir。

名称 类型 说明
AzureFile

string

EmptyDir

string

Secret

string

systemData

与资源的创建和上次修改相关的元数据。

名称 类型 说明
createdAt

string

资源创建时间戳 (UTC) 。

createdBy

string

创建资源的标识。

createdByType

createdByType

创建资源的标识类型。

lastModifiedAt

string

资源上次修改的时间戳 (UTC)

lastModifiedBy

string

上次修改资源的标识。

lastModifiedByType

createdByType

上次修改资源的标识类型。

TcpScaleRule

容器应用容器 Tcp 缩放规则。

名称 类型 说明
auth

ScaleRuleAuth[]

tcp 缩放规则的身份验证机密。

metadata

object

描述 tcp 缩放规则的元数据属性。

TcpSocket

TCPSocket 指定涉及 TCP 端口的操作。 尚不支持 TCP 挂钩。

名称 类型 说明
host

string

可选:要连接到的主机名,默认为 Pod IP。

port

integer

要在容器上访问的端口的编号或名称。 数字必须在 1 到 65535 的范围内。 名称必须是IANA_SVC_NAME。

Template

容器应用版本控制的应用程序定义。 定义不可变修订的所需状态。 对此部分所做的任何更改都将导致创建新的修订

名称 类型 说明
containers

Container[]

容器应用的容器定义列表。

initContainers

InitContainer[]

在应用容器之前运行的专用容器列表。

revisionSuffix

string

追加到修订名称的用户友好后缀

scale

Scale

容器应用的缩放属性。

serviceBinds

ServiceBind[]

绑定到应用的容器应用服务列表

terminationGracePeriodSeconds

integer

容器应用实例需要正常终止的可选持续时间(以秒为单位)。 值必须是非负整数。 值 0 指示通过终止信号立即停止, (没有机会关闭) 。 如果此值为 nil,则将改用默认宽限期。 请将此值设置为大于你的进程的预期清理时间。 默认值为 30 秒。

volumes

Volume[]

容器应用的卷定义列表。

Type

探测的类型。

名称 类型 说明
Liveness

string

Readiness

string

Startup

string

Volume

容器应用的卷定义。

名称 类型 说明
mountOptions

string

装载 AzureFile 时使用的装载选项。 必须是逗号分隔的字符串。

name

string

卷名。

secrets

SecretVolumeItem[]

要添加到卷中的机密列表。 如果未提供机密,则集合中的所有机密都将添加到卷中。

storageName

string

存储资源的名称。 无需提供 EmptyDir 和 Secret。

storageType

StorageType

卷的存储类型。 如果未提供,请使用 EmptyDir。

VolumeMount

容器应用的卷装载。

名称 类型 说明
mountPath

string

应装载卷的容器中的路径。不得包含“:”。

subPath

string

应从中装载容器卷的卷中的路径。 默认为“” (卷的根) 。

volumeName

string

这必须与卷的名称匹配。