Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::ESA::EdgeContainerApp

Última atualização: Jun 27, 2026

Use o tipo de recurso ALIYUN::ESA::EdgeContainerApp para crie uma aplicação de contêiner de borda.

Sintaxe

{
  "Type": "ALIYUN::ESA::EdgeContainerApp",
  "Properties": {
    "EdgeContainerAppName": String,
    "ServicePort": Integer,
    "TargetPort": Integer,
    "HealthCheckFailTimes": Integer,
    "HealthCheckInterval": Integer,
    "HealthCheckUri": String,
    "HealthCheckHost": String,
    "HealthCheckTimeout": Integer,
    "HealthCheckSuccTimes": Integer,
    "HealthCheckMethod": String,
    "HealthCheckPort": Integer,
    "HealthCheckHttpCode": String,
    "HealthCheckType": String,
    "Remarks": String
  }
}

Propriedades

Nome da propriedade

Tipo

Obrigatório

Atualização permitida

Descrição

Restrições

EdgeContainerAppName

String

Sim

Não

Nome da aplicação.

O nome deve começar com letra minúscula e pode conter letras minúsculas, dígitos e hifens (-). Deve ter de 6 a 128 caracteres.

ServicePort

Integer

Sim

Não

Número da porta de serviço.

O valor deve estar no intervalo de 1 a 65535.

TargetPort

Integer

Sim

Não

Porta de backend.

Porta de serviço da aplicação. O valor deve estar no intervalo de 1 a 65535.

HealthCheckFailTimes

Integer

Não

Não

Número de verificações de integridade consecutivas com falha.

Quantidade de falhas consecutivas necessárias para considerar uma aplicação íntegra como não íntegra.

  • Valores válidos: 1 a 10.

  • Valor padrão: 5.

HealthCheckInterval

Integer

Não

Não

Intervalo entre verificações de integridade.

Valores válidos: 1 a 50.

  • Valor padrão: 5.

  • Unidade: segundos.

HealthCheckUri

String

Não

Não

URI para verificações de integridade.

  • Deve ter de 1 a 80 caracteres.

  • Valor padrão: /.

HealthCheckHost

String

Não

Não

Nome de domínio para verificações de integridade.

Este parâmetro está vazio por padrão.

HealthCheckTimeout

Integer

Não

Não

Tempo de espera pela resposta da verificação de integridade.

Se uma instância ECS de backend não responder dentro do tempo especificado, a verificação de integridade falhará.

  • Valores válidos: 1 a 100.

  • Valor padrão: 3.

  • Unidade: segundos.

HealthCheckSuccTimes

Integer

Não

Não

Número de verificações de integridade consecutivas bem-sucedidas.

Quantidade de sucessos consecutivos necessários para considerar uma aplicação não íntegra como íntegra.

  • Valores válidos: 1 a 10.

  • Valor padrão: 2.

HealthCheckMethod

String

Não

Não

Método de verificação de integridade para listeners HTTP.

Valores válidos:

  • HEAD (padrão): solicita apenas o cabeçalho da página.

  • GET: solicita as informações da página especificada e retorna o corpo da entidade.

HealthCheckPort

Integer

Não

Não

Porta para verificações de integridade.

  • Valores válidos: 1 a 65535.

  • Valor padrão: 80.

HealthCheckHttpCode

String

Não

Não

Código de status HTTP para verificação de integridade bem-sucedida.

Valores válidos:

  • http_2xx (padrão)

  • http_3xx

HealthCheckType

String

Não

Não

Tipo de verificação de integridade.

Inclui sondagens de Camada 4 e Camada 7. Este parâmetro está vazio por padrão.

Valores válidos:

  • l4: sonda de Camada 4.

  • l7: sonda de Camada 7.

Remarks

String

Não

Não

Observações.

Este parâmetro está vazio por padrão.

Valores de retorno

Fn::GetAtt

  • HealthCheckFailTimes: número de verificações de integridade consecutivas com falha.

  • ServicePort: número da porta de serviço.

  • HealthCheckInterval: intervalo entre verificações de integridade.

  • AppStatus: status da aplicação.

  • TargetPort: porta de backend.

  • DomainName: nome de domínio associado à aplicação.

  • HealthCheckUri: URI para verificações de integridade.

  • HealthCheckHost: nome de domínio para verificações de integridade.

  • CreateTime: momento de criação da aplicação.

  • GatewayType: tipo de gateway.

  • HealthCheckTimeout: tempo limite para resposta da verificação de integridade.

  • HealthCheckSuccTimes: número de verificações de integridade consecutivas bem-sucedidas.

  • QuicCid: indica se o suporte a QUIC está ativado.

  • Remarks: descrição da aplicação.

  • VersionCount: número de versões da aplicação.

  • HealthCheckMethod: método de verificação de integridade para listeners HTTP.

  • UpdateTime: momento da última modificação da aplicação.

  • HealthCheckPort: porta para verificações de integridade.

  • EdgeContainerAppName: nome da aplicação.

  • HealthCheckHttpCode: código de status HTTP para verificação de integridade bem-sucedida.

  • HealthCheckType: tipo de verificação de integridade.

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  ServicePort:
    Type: Number
    Description:
      en: 'The server port. Valid values: 1 to 65535.'
    Required: true
    MinValue: 1
    MaxValue: 65535
  TargetPort:
    Type: Number
    Description:
      en: 'The backend port, which is also the service port of the application. Valid values: 1 to 65535.'
    Required: true
    MinValue: 1
    MaxValue: 65535
  EdgeContainerAppName:
    Type: String
    Description:
      en: The name of the application. The name must start with a lowercase letter and can contain lowercase letters, digits, and hyphens (-). The name must be 6 to 128 characters in length.
    Required: true
Resources:
  ExtensionResource:
    Type: ALIYUN::ESA::EdgeContainerApp
    Properties:
      ServicePort:
        Ref: ServicePort
      TargetPort:
        Ref: TargetPort
      EdgeContainerAppName:
        Ref: EdgeContainerAppName
Outputs:
  HealthCheckFailTimes:
    Description: The number of consecutive failed health checks required for an application to be considered as unhealthy.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - HealthCheckFailTimes
  ServicePort:
    Description: The server port.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - ServicePort
  HealthCheckInterval:
    Description: 'The interval between health checks. Unit: seconds.'
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - HealthCheckInterval
  AppStatus:
    Description: The status of the application.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - AppStatus
  TargetPort:
    Description: The backend port, which is also the service port of the application.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - TargetPort
  DomainName:
    Description: The domain name that is attached to the application. If no domain name is attached, this value is empty.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - DomainName
  HealthCheckUri:
    Description: The URI for health checks.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - HealthCheckUri
  HealthCheckHost:
    Description: The domain name for health checks.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - HealthCheckHost
  CreateTime:
    Description: The time when the application was created.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - CreateTime
  GatewayType:
    Description: The type of the gateway.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - GatewayType
  HealthCheckTimeout:
    Description: The timeout period of a health check response.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - HealthCheckTimeout
  HealthCheckSuccTimes:
    Description: 'The number of consecutive successful health checks required for an unhealthy application to be considered healthy.'
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - HealthCheckSuccTimes
  QuicCid:
    Description: Indicates whether QUIC is enabled.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - QuicCid
  Remarks:
    Description: The remarks. This parameter is empty by default.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - Remarks
  VersionCount:
    Description: The number of application versions.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - VersionCount
  HealthCheckMethod:
    Description: The HTTP request method for health checks.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - HealthCheckMethod
  UpdateTime:
    Description: The time when the application was last modified. The time follows the ISO 8601 standard in the YYYY-MM-DDThh:mm:ss format. The time is displayed in UTC.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - UpdateTime
  HealthCheckPort:
    Description: 'The port for health checks. Valid values: 1 to 65535. Default value: 80.'
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - HealthCheckPort
  EdgeContainerAppName:
    Description: 'The application name.'
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - EdgeContainerAppName
  HealthCheckHttpCode:
    Description: The HTTP status code for a successful health check.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - HealthCheckHttpCode
  HealthCheckType:
    Description: The health check type.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - HealthCheckType
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "ServicePort": {
      "Type": "Number",
      "Description": {
        "en": "The server port. Valid values: 1 to 65535."
      },
      "Required": true,
      "MinValue": 1,
      "MaxValue": 65535
    },
    "TargetPort": {
      "Type": "Number",
      "Description": {
        "en": "The backend port, which is also the service port of the application. Valid values: 1 to 65535."
      },
      "Required": true,
      "MinValue": 1,
      "MaxValue": 65535
    },
    "EdgeContainerAppName": {
      "Type": "String",
      "Description": {
        "en": "The name of the application. The name must start with a lowercase letter and can contain lowercase letters, digits, and hyphens (-). The name must be 6 to 128 characters in length."
      },
      "Required": true
    }
  },
  "Resources": {
    "ExtensionResource": {
      "Type": "ALIYUN::ESA::EdgeContainerApp",
      "Properties": {
        "ServicePort": {
          "Ref": "ServicePort"
        },
        "TargetPort": {
          "Ref": "TargetPort"
        },
        "EdgeContainerAppName": {
          "Ref": "EdgeContainerAppName"
        }
      }
    }
  },
  "Outputs": {
    "HealthCheckFailTimes": {
      "Description": "The number of consecutive failed health checks required for an application to be considered as unhealthy.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "HealthCheckFailTimes"
        ]
      }
    },
    "ServicePort": {
      "Description": "The server port.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "ServicePort"
        ]
      }
    },
    "HealthCheckInterval": {
      "Description": "The interval between health checks. Unit: seconds.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "HealthCheckInterval"
        ]
      }
    },
    "AppStatus": {
      "Description": "The status of the application.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "AppStatus"
        ]
      }
    },
    "TargetPort": {
      "Description": "The backend port, which is also the service port of the application.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "TargetPort"
        ]
      }
    },
    "DomainName": {
      "Description": "The domain name that is attached to the application. If no domain name is attached, this value is empty.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "DomainName"
        ]
      }
    },
    "HealthCheckUri": {
      "Description": "The URI for health checks.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "HealthCheckUri"
        ]
      }
    },
    "HealthCheckHost": {
      "Description": "The domain name for health checks.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "HealthCheckHost"
        ]
      }
    },
    "CreateTime": {
      "Description": "The time when the application was created.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "CreateTime"
        ]
      }
    },
    "GatewayType": {
      "Description": "The type of the gateway.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "GatewayType"
        ]
      }
    },
    "HealthCheckTimeout": {
      "Description": "The timeout period of a health check response.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "HealthCheckTimeout"
        ]
      }
    },
    "HealthCheckSuccTimes": {
      "Description": "The number of consecutive successful health checks required for an unhealthy application to be considered healthy.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "HealthCheckSuccTimes"
        ]
      }
    },
    "QuicCid": {
      "Description": "Indicates whether QUIC is enabled.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "QuicCid"
        ]
      }
    },
    "Remarks": {
      "Description": "The remarks. This parameter is empty by default.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "Remarks"
        ]
      }
    },
    "VersionCount": {
      "Description": "The number of application versions.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "VersionCount"
        ]
      }
    },
    "HealthCheckMethod": {
      "Description": "The HTTP request method for health checks.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "HealthCheckMethod"
        ]
      }
    },
    "UpdateTime": {
      "Description": "The time when the application was last modified. The time follows the ISO 8601 standard in the YYYY-MM-DDThh:mm:ss format. The time is displayed in UTC.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "UpdateTime"
        ]
      }
    },
    "HealthCheckPort": {
      "Description": "The port for health checks. Valid values: 1 to 65535. Default value: 80.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "HealthCheckPort"
        ]
      }
    },
    "EdgeContainerAppName": {
      "Description": "The application name.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "EdgeContainerAppName"
        ]
      }
    },
    "HealthCheckHttpCode": {
      "Description": "The HTTP status code for a successful health check.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "HealthCheckHttpCode"
        ]
      }
    },
    "HealthCheckType": {
      "Description": "The health check type.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "HealthCheckType"
        ]
      }
    }
  }
}