全部產品
Search
文件中心

Serverless App Engine:使用saectl工具管理命名空間Namespace

更新時間:Jan 16, 2026

SAE的命名空間對應於Kubernetes的Namespace資源類型。本文介紹如何使用saectl工具管理SAE命名空間,並提供相關的K8s YAML設定檔樣本。

前提條件

已安裝saectl工具,並配置AccessKey ID、AccessKey Secret、應用部署地區,詳見安裝與配置saectl工具

管理命名空間

saectl工具支援建立、查看、刪除命名空間,但不支援更新命名空間。

建立命名空間

  1. 編寫設定檔namespace.yaml。設定檔的樣本如下,各配置項的詳細資料請參考K8s YAML配置項說明

    apiVersion: v1
    kind: Namespace
    metadata:
      annotations:
        sae.aliyun.com/vpc-id: vpc-xxxxxxxxxxxxxxxxxxxx # VPC ID
      name: demo # 命名空間ID
    spec: {}
  2. namespace.yaml檔案所在路徑執行以下命令,實現建立命名空間。

    saectl apply -f namespace.yaml

查看命名空間列表

saectl get ns

輸出結果的欄位說明如下:

欄位

說明

NAME

命名空間ID,default 表示預設命名空間。

STATUS

命名空間的狀態,Active 表示可用。

REGION

命名空間所在地區。

查看命名空間詳情

saectl工具支援使用getdescribe命令查看命名空間詳情。返回結果中包含命名空間的配置項,詳情請參考K8s YAML配置項說明

通過get命令查看命名空間的配置資訊

執行以下命令,查看指定命名空間的配置資訊。

saectl get ns ${namespace} -o {yaml | json}
# ${namespace}為命名空間ID
# -o參數指定返回結果的格式

通過describe命令查看命名空間詳情

執行以下命令,查看指定命名空間詳情。

saectl describe ns ${namespace}
# ${namespace}為命名空間ID

刪除命名空間

執行以下命令,刪除指定命名空間。

saectl delete ns ${namespace}
# ${namespace}為命名空間ID

K8s YAML配置項說明

SAE的命名空間對應於Kubernetes的Namespace資源類型。相關K8s YAML配置項說明詳見下表。

配置參數

說明

metadata.name

命名空間ID。

建立時必須指定此配置項。

metadata.annotations:

sae.aliyun.com/region

命名空間所在的地區。

建立時不支援此配置項。

metadata.annotations:

sae.aliyun.com/vpc-id

命名空間關聯的VPC ID。

建立時必須指定此配置項。

status.phase

命名空間的狀態。

建立時不支援此配置項。