GetEdgeContainerAppVersion擷取邊緣容器應用版本資訊API參考-邊緣安全加速-阿里雲

擷取邊緣容器應用的版本資訊，通過版本資訊選擇某個版本進行發布。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

esa:GetEdgeContainerAppVersion

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
AppId	string	是	應用 ID，可使用 ListEdgeContainerApps 介面擷取應用 ID。	app-88068867578379****
VersionId	string	是	版本 ID，可使用 ListEdgeContainerAppVersions 介面擷取版本 ID。	ver-87962637161651****

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	04F0F334-1335-436C-A1D7-6C044FE73368
Version	object	版本資訊。
LastPublishTime	string	版本上次發布時間，日期格式按照 ISO8601 標記法，並使用 UTC 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。	2023-07-25T04:58:05Z
PublishTime	string	發布時間，日期格式按照 ISO8601 標記法，並使用 UTC 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。	2022-11-14T02:04:03Z
Status	string	目前的版本的狀態。取值： created：建立成功。 failed：建立失敗。 creating：建立中。	created
CreateTime	string	版本建立時間，日期格式按照 ISO8601 標記法，並使用 UTC 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。	2022-07-01T09:32:33Z
AppId	string	應用 ID。	app-88068867578379****
VersionId	string	返回建立的版本的 ID。	ver-87962637161651****
Name	string	版本名稱。	test
UpdateTime	string	版本的上次修改時間。日期格式按照 ISO8601 標記法，並使用 UTC 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。	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, 標識儲存空間，取值範圍（0.5G \| 10G \| 20G \| 30G）
IsACRImage	boolean	是否為 ACR 鏡像。	false
ACRImageInfo	object	ACR 鏡像資訊。
Domain	string	ACR 鏡像網域名稱。	*.mooc.seewo.com
InstanceId	string	ACR 網站執行個體 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	ACR 鏡像標籤地址。	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	容器啟動前執行命令。	sh poststart.sh "echo hello world"
ProbeContent	object	探針內容。
SuccessThreshold	integer	健全狀態檢查連續成功次數。	1
Host	string	健全狀態檢查的網域名稱。	test.com
HttpHeaders	string	HTTP 要求頭。	[{\"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

樣本

正常返回樣本

JSON格式

{
  "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 status code	錯誤碼	錯誤資訊	描述
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.	傳入的應用ID格式不正確，可使用ListEdgeContainerApps介面擷取應用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.	VersionId參數無效。請檢查VersionId參數，你有可能未輸入該參數或者，參數並未以ver-字串開頭，請進行修改後，重新調用介面。
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.	您傳入的應用ID對應的應用不存在，請檢查後重試。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。