すべてのプロダクト
Search

このプロダクト

    Edge Security Acceleration:GetEdgeContainerAppVersion

    ドキュメントセンター

    Edge Security Acceleration:GetEdgeContainerAppVersion

    最終更新日:Mar 20, 2026

    コンテナ化アプリケーションのバージョン情報を照会します。照会したバージョン情報に基づき、リリース対象のアプリケーションバージョンを選択できます。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    esa:GetEdgeContainerAppVersion

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    AppId

    string

    必須

    アプリケーション ID。これは、ListEdgeContainerApps 操作を呼び出すことで取得できます。

    app-88068867578379****
    VersionId

    string

    必須

    バージョン ID。これは、ListEdgeContainerAppVersions 操作を呼び出すことで取得できます。

    ver-87962637161651****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

    04F0F334-1335-436C-A1D7-6C044FE73368
    Version

    object

    バージョンに関する情報。

    LastPublishTime

    string

    当該バージョンが最後にリリースされた時刻。ISO 8601 標準（YYYY-MM-DDThh:mm:ss 形式）に従い、協定世界時 (UTC) で表示されます。

    2023-07-25T04:58:05Z
    PublishTime

    string

    当該バージョンがリリースされた時刻。ISO 8601 標準（YYYY-MM-DDThh:mm:ss 形式）に従い、協定世界時 (UTC) で表示されます。

    2022-11-14T02:04:03Z
    Status

    string

    当該バージョンのステータス。有効な値は以下のとおりです。

    • created：バージョンが作成済みです。

    • failed：バージョンの作成に失敗しました。

    • creating：バージョンが作成中です。

    created
    CreateTime

    string

    当該バージョンが作成された時刻。ISO 8601 標準（yyyy-MM-ddTHH:mm:ssZ 形式）に従い、協定世界時 (UTC) で表示されます。

    2022-07-01T09:32:33Z
    AppId

    string

    アプリケーション ID。

    app-88068867578379****
    VersionId

    string

    作成されたバージョンの ID。

    ver-87962637161651****
    Name

    string

    バージョン名。

    test
    UpdateTime

    string

    当該バージョンが最後に変更された時刻。ISO 8601 標準（YYYY-MM-DDThh:mm:ss 形式）に従い、協定世界時 (UTC) で表示されます。

    2021-12-03T10:52:52Z
    Remarks

    string

    備考。

    aaa
    Containers

    array<object>

    当該バージョンにデプロイされたコンテナイメージ。

    array<object>

    当該バージョンにデプロイされたコンテナイメージの詳細情報。

    EnvVariables

    string

    環境変数。

    ENV=prod
    Args

    string

    コンテナ起動コマンドに渡される引数。

    -c /path/config.toml
    Spec

    string

    コンピューティング仕様。

    1C2G
    Storage

    string

    コンテナのストレージ容量。有効な値：0.5G、10G、20G、30G。

    0.5G, 标识存储空间，取值范围（0.5G | 10G | 20G | 30G）
    IsACRImage

    boolean

    イメージが Container Registry イメージであるかどうかを示します。

    false
    ACRImageInfo

    object

    Container Registry イメージに関する情報。

    Domain

    string

    Container Registry イメージのドメイン名。

    *.mooc.seewo.com
    InstanceId

    string

    Container Registry インスタンスの ID。

    xcdn-9ak2thl14z5s
    RegionId

    string

    リージョン ID。

    cn-hangzhou
    RepoId

    string

    イメージリポジトリの ID。

    crr-zeu0xyk28alyxozh
    RepoName

    string

    イメージリポジトリの名前。

    test_1
    RepoNamespace

    string

    イメージリポジトリが属する名前空間。

    wpy1
    Tag

    string

    タグ値。

    test-healthy-100-soa-1710987653
    TagUrl

    string

    Container Registry イメージタグの URL。

    registry-vpc.cn-shenzhen.aliyuncs.com/lihetech/easywits_server_exam:3.40.2
    IsEnterpriseRegistry

    boolean

    イメージがエンタープライズレベルのイメージであるかどうかを示します。

    false
    Image

    string

    イメージアドレス。

    nginx:1.14.0
    Command

    string

    コンテナを起動するために使用されるコマンド。

    sh abc.sh 1 2 3
    ProbeType

    string

    プローブタイプ。

    httpGet
    Name

    string

    バージョン名。

    version01
    PreStop

    string

    コンテナ停止前に実行されるコマンド。

    sh prestop.sh "echo hello world"

    PostStart

    string

    コンテナ起動前に実行されるコマンド。フォーマット例：{"exec":{"command":\["cat","/etc/group"\]}}。この設定を無効にする場合は、パラメーター値を "" または {} に設定してください。パラメーターを指定しない場合、この設定は無視されます。

    sh poststart.sh "echo hello world"

    ProbeContent

    object

    プローブコンテンツ。

    SuccessThreshold

    integer

    コンテナが健全と見なされるために必要な、連続成功ヘルスチェックの回数。

    1
    Host

    string

    ヘルスチェックに使用されるドメイン名。

    test.com
    HttpHeaders

    string

    コンテナヘルスチェック要求に含まれるリクエストヘッダー。

    [{\"Content-Type\":\"application/json
    Scheme

    string

    コンテナヘルスチェック要求で使用されるプロトコル。

    http
    InitialDelaySeconds

    integer

    コンテナプローブの初期化遅延時間。

    20
    Command

    string

    プローブコマンド。

    sh test.sh
    FailureThreshold

    integer

    コンテナが不健全と見なされるために必要な、連続失敗ヘルスチェックの回数。

    3
    TimeoutSeconds

    integer

    コンテナヘルスチェックのタイムアウト期間。

    5
    Path

    string

    コンテナヘルスチェックのパス。

    /health_check
    Port

    integer

    コンテナヘルスチェックのポート。有効な値： 1 ～ 65535。

    80
    PeriodSeconds

    integer

    コンテナヘルスチェックの間隔。

    5

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "Version": {
    "LastPublishTime": "2023-07-25T04:58:05Z",
    "PublishTime": "2022-11-14T02:04:03Z",
    "Status": "created",
    "CreateTime": "2022-07-01T09:32:33Z",
    "AppId": "app-88068867578379****",
    "VersionId": "ver-87962637161651****",
    "Name": "test",
    "UpdateTime": "2021-12-03T10:52:52Z",
    "Remarks": "aaa",
    "Containers": [
      {
        "EnvVariables": "ENV=prod",
        "Args": "-c /path/config.toml",
        "Spec": "1C2G",
        "Storage": "0.5G, 标识存储空间，取值范围（0.5G | 10G | 20G | 30G）",
        "IsACRImage": false,
        "ACRImageInfo": {
          "Domain": "*.mooc.seewo.com",
          "InstanceId": "xcdn-9ak2thl14z5s",
          "RegionId": "cn-hangzhou",
          "RepoId": "crr-zeu0xyk28alyxozh",
          "RepoName": "test_1",
          "RepoNamespace": "wpy1",
          "Tag": "test-healthy-100-soa-1710987653",
          "TagUrl": "registry-vpc.cn-shenzhen.aliyuncs.com/lihetech/easywits_server_exam:3.40.2",
          "IsEnterpriseRegistry": false
        },
        "Image": "nginx:1.14.0",
        "Command": "sh abc.sh 1 2 3",
        "ProbeType": "httpGet",
        "Name": "version01",
        "PreStop": "sh prestop.sh \"echo hello world\" ",
        "PostStart": "sh poststart.sh \"echo hello world\" ",
        "ProbeContent": {
          "SuccessThreshold": 1,
          "Host": "test.com",
          "HttpHeaders": "[{\\\"Content-Type\\\":\\\"application/json",
          "Scheme": "http",
          "InitialDelaySeconds": 20,
          "Command": "sh test.sh",
          "FailureThreshold": 3,
          "TimeoutSeconds": 5,
          "Path": "/health_check",
          "Port": 80,
          "PeriodSeconds": 5
        }
      }
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParameter The specified parameter is invalid.
    400 InvalidParameter.appid The format of the application ID is invalid. You can call ListEdgeContainerApps to obtain the application ID.
    400 InvalidVersion.NotFound The version does not exist.
    400 InvalidParameter.VersionId The specified VersionId is invalid.  Please check the VersionId parameter. You may not have entered the parameter or the parameter does not start with ver-string. Please modify it and call the interface again.
    500 InternalError Failed to call the service. Try again later or contact technical support.
    404 InvalidApp.NotFound The application does not exist. Check whether the application ID you specified is correct and try again.

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。