Managed Namespaces - Update

服務:: AKS

API 版本:: 2025-05-02-preview

更新託管命名空間上的標籤。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/managedNamespaces/{managedNamespaceName}?api-version=2025-05-02-preview

URI 參數

名稱	位於	必要	類型	Description
managedNamespaceName	path	True	string minLength: 1 maxLength: 63 pattern: [a-z0-9]([-a-z0-9]*[a-z0-9])?	託管命名空間的名稱。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	資源群組的名稱。名稱不區分大小寫。
resourceName	path	True	string minLength: 1 maxLength: 63 pattern: ^[a-zA-Z0-9]$\|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$	受控叢集資源的名稱。
subscriptionId	path	True	string (uuid)	目標訂用帳戶的標識碼。此值必須是 UUID。
api-version	query	True	string minLength: 1	要用於這項作業的 API 版本。

要求本文

名稱	類型	Description
tags	object	資源標籤。

回應

名稱	類型	Description
200 OK	ManagedNamespace	還行
Other Status Codes	CloudError	說明作業為何失敗的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 流

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

Update Managed Namespace Tags

範例要求

HTTP

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/managedNamespaces/namespace1?api-version=2025-05-02-preview

{
  "tags": {
    "tagKey1": "tagValue1",
    "tagKey2": "tagValue2"
  }
}

範例回覆

狀態碼:: 200

{
  "tags": {
    "tagKey1": "tagValue1",
    "tagKey2": "tagValue2"
  },
  "location": "eastus2",
  "properties": {
    "labels": {
      "kubernetes.azure.com/managedByArm": "true"
    },
    "annotations": {
      "annatationKey": "annatationValue"
    },
    "provisioningState": "Succeeded",
    "defaultResourceQuota": {
      "cpuRequest": "3m",
      "cpuLimit": "3m",
      "memoryRequest": "5Gi",
      "memoryLimit": "5Gi"
    },
    "defaultNetworkPolicy": {
      "ingress": "AllowSameNamespace",
      "egress": "AllowAll"
    },
    "adoptionPolicy": "IfIdentical",
    "deletePolicy": "Keep"
  }
}

定義

名稱	Description
AdoptionPolicy	如果 Kubernetes 命名空間已有相同名稱，則為動作。
CloudError	來自容器服務的錯誤回應。
CloudErrorBody	來自容器服務的錯誤回應。
createdByType	建立資源的身分識別類型。
DeletePolicy	刪除命名空間的選項。
ManagedNamespace	由 ARM 管理的命名空間。
NamespaceProperties	ARM 所管理之命名空間的屬性
NamespaceProvisioningState	命名空間的目前布建狀態。
NetworkPolicies	命名空間的預設網路原則，指定輸入和輸出規則。
PolicyRule	代表不同網路原則規則的列舉。
ResourceQuota	命名空間的資源配額。
systemData	與建立和上次修改資源相關的元數據。
TagsObject	修補作業的標記物件。

AdoptionPolicy

列舉型別

如果 Kubernetes 命名空間已有相同名稱，則為動作。

值	Description
Never	如果命名空間已存在於 Kubernetes 中，嘗試在 ARM 中建立相同的命名空間將會失敗。
IfIdentical	如果沒有差異，請接管由ARM管理的現有命名空間。
Always	一律接管現有命名空間，由ARM管理，可能會覆寫某些欄位。

CloudError

Object

來自容器服務的錯誤回應。

名稱	類型	Description
error	CloudErrorBody	錯誤的詳細數據。

CloudErrorBody

Object

來自容器服務的錯誤回應。

名稱	類型	Description
code	string	錯誤的識別碼。程序代碼是不變的，而且是要以程序設計方式取用。
details	CloudErrorBody[]	錯誤的其他詳細數據清單。
message	string	描述錯誤的訊息，適用於在使用者介面中顯示。
target	string	特定錯誤的目標。例如，錯誤中的屬性名稱。

createdByType

列舉型別

建立資源的身分識別類型。

值	Description
User
Application
ManagedIdentity
Key

DeletePolicy

列舉型別

刪除命名空間的選項。

值	Description
Keep	只刪除 ARM 資源，保留 Kubernetes 命名空間。同時刪除ManagedByARM標籤。
Delete	同時刪除 ARM 資源和 Kubernetes 命名空間。

ManagedNamespace

Object

由 ARM 管理的命名空間。

名稱	類型	Description
eTag	string	用來實作開放式並行存取的唯一隻讀字串。更新資源時，eTag 值將會變更。針對後續要求指定 if-match 或 if-none-match 標頭，以針對後續要求指定 if-match 或 if-none-match 標頭，以根據一般 etag 慣例啟用開放式並行存取。
id	string	資源標識碼。
location	string	命名空間的位置。
name	string	資源群組內唯一的資源名稱。此名稱可用來存取資源。
properties	NamespaceProperties	命名空間的屬性。
systemData	systemData	與此資源相關的系統元數據。
tags	object	要保存在受控叢集命名空間上的標記。
type	string	資源類型

NamespaceProperties

Object

ARM 所管理之命名空間的屬性

名稱	類型	Description
adoptionPolicy	AdoptionPolicy	如果 Kubernetes 命名空間已有相同名稱，則為動作。
annotations	object	Managed 命名空間的批注。
defaultNetworkPolicy	NetworkPolicies	在命名空間上強制執行的預設網路原則。客戶可以在命名空間下擁有其他 Kubernetes 網路原則物件。將會強制執行所有網路原則。
defaultResourceQuota	ResourceQuota	在命名空間上強制執行的預設資源配額。客戶可以在命名空間下有其他 Kubernetes 資源配額物件。所有資源配額都會強制執行。
deletePolicy	DeletePolicy	刪除命名空間的選項。
labels	object	Managed 命名空間的標籤。
portalFqdn	string	Azure 入口網站用來存取受控叢集的特殊 FQDN。此 FQDN 僅供 Azure 入口網站使用，不應供其他用戶端使用。 Azure 入口網站需要某些跨原始來源資源分享（CORS）標頭以某些回應傳送，Kubernetes APIServer 預設不會處理這些標頭。這個特殊的 FQDN 支援 CORS，讓 Azure 入口網站能夠正常運作。
provisioningState	NamespaceProvisioningState	命名空間的目前布建狀態。

NamespaceProvisioningState

列舉型別

命名空間的目前布建狀態。

值	Description
Updating
Deleting
Creating
Succeeded
Failed
Canceled

NetworkPolicies

Object

命名空間的預設網路原則，指定輸入和輸出規則。

名稱	類型	預設值	Description
egress	PolicyRule	AllowAll	網路的輸出原則。
ingress	PolicyRule	AllowSameNamespace	網路的輸入原則。

PolicyRule

列舉型別

代表不同網路原則規則的列舉。

值	Description
DenyAll	拒絕所有網路流量。
AllowAll	允許所有網路流量。
AllowSameNamespace	允許相同命名空間內的流量。

ResourceQuota

Object

命名空間的資源配額。

名稱	類型	Description
cpuLimit	string	命名空間的CPU限制為一千個CPU格式。如需詳細資訊，請參閱 CPU 資源單位。
cpuRequest	string	命名空間的CPU要求，格式為一千個CPU。如需詳細資訊，請參閱 CPU 資源單位。
memoryLimit	string	命名空間的記憶體限制，格式為：Ei、Pi、Ti、Gi、Mi、Ki。如需詳細資訊，請參閱記憶體資源單位。
memoryRequest	string	命名空間的記憶體要求，格式為：Ei、Pi、Ti、Gi、Mi、Ki。如需詳細資訊，請參閱記憶體資源單位。

systemData

Object

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string (date-time)	資源建立的時間戳（UTC）。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string (date-time)	上次修改的資源時間戳（UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

TagsObject

Object

修補作業的標記物件。

名稱	類型	Description
tags	object	資源標籤。

共用方式為

Managed Namespaces - Update

URI 參數

要求本文

回應

安全性

azure_auth

範圍

範例

Update Managed Namespace Tags

範例要求

範例回覆

定義

AdoptionPolicy

CloudError

CloudErrorBody

createdByType

DeletePolicy

ManagedNamespace

NamespaceProperties

NamespaceProvisioningState

NetworkPolicies

PolicyRule

ResourceQuota

systemData

TagsObject