Fleet Managed Namespaces - List By Fleet
FleetManagedNamespace 資源列表
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/managedNamespaces?api-version=2026-02-01-preview
URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
fleet
|
path | True |
string minLength: 1maxLength: 63 pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ |
Fleet 資源的名稱。 |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
資源群組的名稱。 名稱不區分大小寫。 |
|
subscription
|
path | True |
string (uuid) |
目標訂用帳戶的標識碼。 此值必須是 UUID。 |
|
api-version
|
query | True |
string minLength: 1 |
用於此作業的 API 版本。 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
Azure 運作順利完成。 |
|
| Other Status Codes |
未預期的錯誤回應。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
範圍
| 名稱 | Description |
|---|---|
| user_impersonation | 模擬您的用戶帳戶 |
範例
FleetManagedNamespaces_ListByFleet
範例要求
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgfleets/providers/Microsoft.ContainerService/fleets/fleet1/managedNamespaces?api-version=2026-02-01-preview
範例回覆
{
"value": [
{
"properties": {
"provisioningState": "Succeeded",
"managedNamespaceProperties": {
"labels": {
"key1": "value1"
},
"annotations": {
"key2": "value2"
},
"defaultResourceQuota": {
"cpuRequest": "1",
"cpuLimit": "1",
"memoryRequest": "10Gi",
"memoryLimit": "32Gi"
},
"defaultNetworkPolicy": {
"ingress": "AllowSameNamespace",
"egress": "AllowAll"
}
},
"adoptionPolicy": "Never",
"deletePolicy": "Keep",
"propagationPolicy": {
"type": "Placement",
"placementProfile": {
"defaultClusterResourcePlacement": {
"policy": {
"placementType": "PickAll",
"affinity": {
"clusterAffinity": {
"requiredDuringSchedulingIgnoredDuringExecution": {
"clusterSelectorTerms": [
{
"labelSelector": {
"matchLabels": {
"gpu": "true"
},
"matchExpressions": [
{
"key": "region",
"operator": "In",
"values": [
"production1",
"production2"
]
}
]
},
"propertySelector": {
"matchExpressions": [
{
"name": "zones",
"operator": "Gt",
"values": [
"1"
]
}
]
}
}
]
}
}
},
"tolerations": [
{
"key": "AIWorkloadOnly",
"operator": "Exists",
"value": "true",
"effect": "NoSchedule"
}
]
}
}
}
},
"status": {
"lastOperationError": {}
},
"portalFqdn": "fleet1-namespace1-abc123.flt.eastus.azmk8s.io"
},
"eTag": "\"EtagValue\"",
"tags": {
"tag1": "tagValue1"
},
"location": "eastus",
"id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/fleets/fleet1/managedNamespaces/namespace1",
"name": "namespace1",
"type": "Microsoft.ContainerService/fleets/managedNamespaces",
"systemData": {
"createdBy": "someUser",
"createdByType": "User",
"createdAt": "2025-08-23T05:40:40.657Z",
"lastModifiedBy": "someOtherUser",
"lastModifiedByType": "User",
"lastModifiedAt": "2025-08-23T05:40:40.657Z"
}
}
],
"nextLink": "https://nextlink.sausage.com"
}
定義
| 名稱 | Description |
|---|---|
|
Adoption |
如果同名命名空間已經存在,則該動作。 |
|
created |
建立資源的身分識別類型。 |
|
Delete |
刪除 ARM 管理命名空間的選項。 |
|
Error |
資源管理錯誤其他資訊。 |
|
Error |
錯誤詳細數據。 |
|
Error |
錯誤回應 |
|
Fleet |
一個由艦隊管理的命名空間。 |
|
Fleet |
FleetManagedNamespace 清單操作的回應。 |
|
Fleet |
艦隊管理命名空間的特性。 |
|
Fleet |
艦隊管理命名空間資源的配置狀態 |
|
Fleet |
艦隊管理命名空間的狀態資訊。 |
|
Label |
運算子代表索引鍵與一組值的關聯性。 有效運算子為 In、NotIn、Exists 和 DoesNotExist。 |
|
Managed |
艦隊管理的命名空間屬性。 |
|
Meta. |
標籤選取器是一組資源的標籤查詢。 matchLabels 和 matchExpressions 的結果為 ANDed。 空白標籤選取器符合所有物件。 Null 標籤選取器不符任何物件。 |
|
Meta. |
卷標選取器需求是一種選取器,其中包含值、索引鍵,以及關聯索引鍵和值的運算符。 |
|
Network |
管理命名空間的網路政策。 |
|
Placement. |
親和力是一組叢集親和力排程規則。 還有更多內容要補充。 |
|
Placement. |
ClusterAffinity 包含所選資源的叢集親和力排程規則。 |
|
Placement. |
ClusterResourcePlacementSpec 定義了 ClusterResourcePlacement 的期望狀態。 |
|
Placement. |
叢集選擇器 |
|
Placement. |
叢集選擇詞 |
|
Placement. |
PlacementPolicy 包含選擇目標成員叢集以放置所選資源的規則。 請注意,只有同時連結且符合規則的叢集才會被選擇。 你最多只能指定兩個欄位中的一個:ClusterNames 和 Affinity。 若未指定,則選取所有相連叢集。 |
|
Placement. |
PropertySelector 協助使用者在選擇資源配置叢集時指定屬性需求。 |
|
Placement. |
PropertySelectorRequirement 是選擇資源擺放叢集時的特定屬性要求。 |
|
Placement. |
容忍讓 ClusterResourcePlacement 能容忍任何符合三重 <鍵、值、效果> 的污染,使用匹配運算 <子運算子>。 |
|
Placement |
預設配置檔 ClusterResourcePlacement 配置檔。 |
|
Placement |
安置類型。 可以是「PickAll」、「PickN」或「PickFixed」。 預設是 PickAll。 |
|
Policy |
這些可能的值代表不同的網路政策規則。 |
|
Propagation |
傳播用於艦隊間的命名空間供應。 |
|
Propagation |
命名空間將在艦隊成員間分配。 |
|
Property |
運算子指定叢集所觀察到的指定屬性值與需求中給定值之間的關係。 |
|
Resource |
管理命名空間的資源配額。 |
|
system |
與建立和上次修改資源相關的元數據。 |
|
Taint |
效果表示污穢效果與之相符。 空的意思是符合所有污穢效果。 在指定時,唯一允許的值是 NoSchedule。 |
|
Toleration |
運算子代表鍵與該值的關係。 有效的運算子為 Exists 與 Equal。 預設為相等。 存在等同於價值的萬用字元,因此 ClusterResourcePlacement 可以容忍特定類別的所有污點。 |
AdoptionPolicy
如果同名命名空間已經存在,則該動作。
| 值 | Description |
|---|---|
| Never |
如果命名空間已經存在,請不要接管現有的命名空間讓 ARM 管理。 |
| IfIdentical |
如果有相同的命名空間,則接管現有的命名空間,由 ARM 管理。 |
| Always |
即使名稱空間不完全相同,也一定要接管現有的命名空間,讓 ARM 管理。 |
createdByType
建立資源的身分識別類型。
| 值 | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DeletePolicy
刪除 ARM 管理命名空間的選項。
| 值 | Description |
|---|---|
| Keep |
刪除 ARM 資源,但保留命名空間。 |
| Delete |
刪除 ARM 資源和命名空間。 |
ErrorAdditionalInfo
資源管理錯誤其他資訊。
| 名稱 | 類型 | Description |
|---|---|---|
| info |
object |
其他資訊。 |
| type |
string |
其他信息類型。 |
ErrorDetail
錯誤詳細數據。
| 名稱 | 類型 | Description |
|---|---|---|
| additionalInfo |
錯誤其他資訊。 |
|
| code |
string |
錯誤碼。 |
| details |
錯誤詳情 |
|
| message |
string |
錯誤訊息。 |
| target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
| 名稱 | 類型 | Description |
|---|---|---|
| error |
error 物件。 |
FleetManagedNamespace
一個由艦隊管理的命名空間。
| 名稱 | 類型 | Description |
|---|---|---|
| eTag |
string |
如果在回應本文中提供 eTag,它也可以根據一般 etag 慣例提供作為標頭。 實體標籤用於比較來自相同要求資源的兩個或多個實體。 HTTP/1.1 會在 etag(第 14.19 節)、If-Match(第 14.24 節)、If-None-Match (section 14.26) 和 If-Range (第 14.27 節) 標頭字段中使用實體標記。 |
| id |
string (arm-id) |
資源的完整資源標識碼。 例如 “/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}” |
| location |
string |
資源所在的地理位置 |
| name |
string |
資源的名稱 |
| properties |
此資源的資源特定屬性。 |
|
| systemData |
Azure Resource Manager 包含 createdBy 與 modifiedBy 資訊的元資料。 |
|
| tags |
object |
資源標籤。 |
| type |
string |
資源的類型。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts” |
FleetManagedNamespaceListResult
FleetManagedNamespace 清單操作的回應。
| 名稱 | 類型 | Description |
|---|---|---|
| nextLink |
string (uri) |
專案下一頁的連結 |
| value |
本頁的 FleetManagedNamespace 項目 |
FleetManagedNamespaceProperties
艦隊管理命名空間的特性。
| 名稱 | 類型 | Description |
|---|---|---|
| adoptionPolicy |
如果已管理的命名空間已存在,則操作。 預設是「永遠不會」。 |
|
| deletePolicy |
刪除艦隊管理命名空間的選項。 預設是保留。 |
|
| managedNamespaceProperties |
艦隊管理的命名空間屬性。 |
|
| portalFqdn |
string |
艦隊中樞的 Azure 入口網站 FQDN。 |
| propagationPolicy |
建立命名空間的傳播輪廓。 |
|
| provisioningState |
上次作業的狀態。 |
|
| status |
艦隊管理命名空間上一次行動的狀態資訊。 |
FleetManagedNamespaceProvisioningState
艦隊管理命名空間資源的配置狀態
| 值 | Description |
|---|---|
| Succeeded |
資源已建立。 |
| Failed |
資源建立失敗。 |
| Canceled |
資源建立已取消。 |
| Creating |
正在建立一個由艦隊管理命名空間的配置狀態。 |
| Updating |
車隊管理命名空間的配置狀態正在更新。 |
| Deleting |
車隊管理命名空間的配置狀態被刪除。 |
FleetManagedNamespaceStatus
艦隊管理命名空間的狀態資訊。
| 名稱 | 類型 | Description |
|---|---|---|
| lastOperationError |
艦隊管理命名空間的最後一次操作錯誤 |
|
| lastOperationId |
string |
艦隊最後的操作識別碼是管理命名空間 |
LabelSelectorOperator
運算子代表索引鍵與一組值的關聯性。 有效運算子為 In、NotIn、Exists 和 DoesNotExist。
| 值 | Description |
|---|---|
| In |
標籤選擇操作符 In |
| NotIn |
標籤選擇操作符 NotIn |
| Exists |
標籤選擇操作符存在 |
| DoesNotExist |
標籤選擇操作符DoesNotExist |
ManagedNamespaceProperties
艦隊管理的命名空間屬性。
| 名稱 | 類型 | Description |
|---|---|---|
| annotations |
object |
艦隊的註解管理命名空間。 |
| defaultNetworkPolicy |
車隊管理的預設網路政策是命名空間。 |
|
| defaultResourceQuota |
艦隊管理命名空間的預設資源配額。 |
|
| labels |
object |
車隊的標籤則管理命名空間。 |
Meta.V1.LabelSelector
標籤選取器是一組資源的標籤查詢。 matchLabels 和 matchExpressions 的結果為 ANDed。 空白標籤選取器符合所有物件。 Null 標籤選取器不符任何物件。
| 名稱 | 類型 | Description |
|---|---|---|
| matchExpressions |
matchExpressions 是標籤選取器需求的清單。 需求為 ANDed。 |
|
| matchLabels |
object |
matchLabels 是一個 {key,value} 對的映射。 matchLabels 對應中的單一 {key,value} 相當於 matchExpressions 的專案,其索引鍵字段為 “key”,運算符為 “In”,而值數組只包含 “value”。 需求為 ANDed。 |
Meta.V1.LabelSelectorRequirement
卷標選取器需求是一種選取器,其中包含值、索引鍵,以及關聯索引鍵和值的運算符。
| 名稱 | 類型 | Description |
|---|---|---|
| key |
string |
key 是選取器所套用的標籤索引鍵。 |
| operator |
運算子代表索引鍵與一組值的關聯性。 有效運算子為 In、NotIn、Exists 和 DoesNotExist。 |
|
| values |
string[] |
values 是字串值的陣列。 如果運算子為 In 或 NotIn,則值陣列必須是非空白的。 如果運算子為 Exists 或 DoesNotExist,則值陣列必須是空的。 此陣列會在策略式合併修補期間取代。 |
NetworkPolicy
管理命名空間的網路政策。
| 名稱 | 類型 | Description |
|---|---|---|
| egress |
管理命名空間的出口政策。 |
|
| ingress |
管理命名空間的入口政策。 |
Placement.V1.Affinity
親和力是一組叢集親和力排程規則。 還有更多內容要補充。
| 名稱 | 類型 | Description |
|---|---|---|
| clusterAffinity |
ClusterAffinity 包含所選資源的叢集親和力排程規則。 |
Placement.V1.ClusterAffinity
ClusterAffinity 包含所選資源的叢集親和力排程規則。
| 名稱 | 類型 | Description |
|---|---|---|
| requiredDuringSchedulingIgnoredDuringExecution |
若此欄位指定的親和力需求在排程時未被滿足,該資源將不會被排程到叢集上。 若此欄位指定的親和力需求在放置後某時停止滿足(例如因更新),系統可能會嘗試或不會嘗試最終移除該資源。 |
Placement.V1.ClusterResourcePlacementSpec
ClusterResourcePlacementSpec 定義了 ClusterResourcePlacement 的期望狀態。
| 名稱 | 類型 | Description |
|---|---|---|
| policy |
政策定義如何選擇成員叢集以放置所選資源。 若未指定,則選取所有結合成員叢集。 |
Placement.V1.ClusterSelector
叢集選擇器
| 名稱 | 類型 | Description |
|---|---|---|
| clusterSelectorTerms |
ClusterSelectorTerms 是一個叢集選擇詞的清單。 這些項為 |
Placement.V1.ClusterSelectorTerm
叢集選擇詞
| 名稱 | 類型 | Description |
|---|---|---|
| labelSelector |
LabelSelector 是對所有已合併成員叢集進行標籤查詢的。 選取與查詢相符的叢集。 如果你在同一項中同時指定標籤選擇器和屬性選擇器,結果就會被 AND。 |
|
| propertySelector |
PropertySelector 是對所有已連接成員叢集進行屬性查詢的程式碼。 選取與查詢相符的叢集。 如果你在同一項中同時指定標籤選擇器和屬性選擇器,結果就會被 AND。 目前,PropertySelector 只能用於 |
Placement.V1.PlacementPolicy
PlacementPolicy 包含選擇目標成員叢集以放置所選資源的規則。 請注意,只有同時連結且符合規則的叢集才會被選擇。 你最多只能指定兩個欄位中的一個:ClusterNames 和 Affinity。 若未指定,則選取所有相連叢集。
| 名稱 | 類型 | Description |
|---|---|---|
| affinity |
Affinity 包含叢集親和力排程規則。 定義要放置選定資源的成員叢集。 只有當置入類型是「PickAll」或「PickN」時才有效。 |
|
| clusterNames |
string[] |
ClusterNames 包含 MemberCluster 的名稱清單,用以放置所選資源。 只有當放置類型為「PickFixed」時才有效 |
| placementType |
安置類型。 可以是「PickAll」、「PickN」或「PickFixed」。 預設是 PickAll。 |
|
| tolerations |
如有指定,則為 ClusterResourcePlacement 的容忍度。 容忍不能更新或刪除。 此欄位為 beta 級,用於污染與耐受特性。 |
Placement.V1.PropertySelector
PropertySelector 協助使用者在選擇資源配置叢集時指定屬性需求。
| 名稱 | 類型 | Description |
|---|---|---|
| matchExpressions |
MatchExpressions 是一個 PropertySelectorRequirements 的陣列。 要求是 AND。 |
Placement.V1.PropertySelectorRequirement
PropertySelectorRequirement 是選擇資源擺放叢集時的特定屬性要求。
| 名稱 | 類型 | Description |
|---|---|---|
| name |
string |
名稱即為該物業的名稱;應該是 Kubernetes 的標籤名稱。 |
| operator |
運算子指定叢集所觀察到的指定屬性值與需求中給定值之間的關係。 |
|
| values |
string[] |
數值是指定屬性的數值清單,艦隊將依照指定操作員與個別成員群集的觀察值進行比較。 此時,每個值都應該是 Kubernetes 的數量。 如需詳細資訊,請參閱https://pkg.go.dev/k8s.io/apimachinery/pkg/api/resource#Quantity。 若算符為 Gt(大於 )、Ge(大於等於)、Lt(小於或等於)、 |
Placement.V1.Toleration
容忍讓 ClusterResourcePlacement 能容忍任何符合三重 <鍵、值、效果> 的污染,使用匹配運算 <子運算子>。
| 名稱 | 類型 | Description |
|---|---|---|
| effect |
效果表示污穢效果與之相符。 空的意思是符合所有污穢效果。 在指定時,唯一允許的值是 NoSchedule。 |
|
| key |
string |
關鍵是容忍所適用的污染關鍵。 空的意思是所有污點鍵都符合。 若鍵為空,運算符必須為 Exists;此組合意指匹配所有值與所有鍵。 |
| operator |
運算子代表鍵與該值的關係。 有效的運算子為 Exists 與 Equal。 預設為相等。 存在等同於價值的萬用字元,因此 ClusterResourcePlacement 可以容忍特定類別的所有污點。 |
|
| value |
string |
價值是容忍所匹配的污染值。 若運算子為 Exists,值應為空,否則則為一般字串。 |
PlacementProfile
預設配置檔 ClusterResourcePlacement 配置檔。
| 名稱 | 類型 | Description |
|---|---|---|
| defaultClusterResourcePlacement |
預設的 ClusterResourcePlacement 政策設定。 |
PlacementType
安置類型。 可以是「PickAll」、「PickN」或「PickFixed」。 預設是 PickAll。
| 值 | Description |
|---|---|
| PickAll |
PickAll選擇所有符合規則的叢集。 |
| PickFixed |
PickFixed 選擇固定的叢集集合。 |
PolicyRule
這些可能的值代表不同的網路政策規則。
| 值 | Description |
|---|---|
| AllowAll |
允許所有網路流量。 |
| DenyAll |
拒絕所有網路流量。 |
| AllowSameNamespace |
允許相同命名空間內的流量。 |
PropagationPolicy
傳播用於艦隊間的命名空間供應。
| 名稱 | 類型 | Description |
|---|---|---|
| placementProfile |
用於放置的傳播型譜。 |
|
| type |
所使用的保單類型。 預設是放置。 |
PropagationType
命名空間將在艦隊成員間分配。
| 值 | Description |
|---|---|
| Placement |
使用 ClusterResourcePlacement。 |
PropertySelectorOperator
運算子指定叢集所觀察到的指定屬性值與需求中給定值之間的關係。
| 值 | Description |
|---|---|
| Gt |
Gt 規定 Fleet 若某屬性的觀察值大於需求中指定的值,則選擇叢集。 |
| Ge |
Ge 規定 Fleet 若某屬性的觀察值大於或等於需求中指定的值,則選擇叢集。 |
| Eq |
方程式指示 Fleet 選擇叢集,前提是該屬性的觀察值與需求中指定的值相同。 |
| Ne |
Ne 規定 Fleet 若觀察到的某屬性值與需求中指定的值不符,則選擇叢集。 |
| Lt |
Lt 規定 Fleet 若觀察到的某屬性值低於需求指定值,則選擇叢集。 |
| Le |
Le 規定 Fleet 若觀察到的某屬性值小於或等於需求中指定的值,則選擇叢集。 |
ResourceQuota
管理命名空間的資源配額。
| 名稱 | 類型 | Description |
|---|---|---|
| cpuLimit |
string |
管理命名空間的 CPU 限制。 查看更多 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#meaning-of-cpu |
| cpuRequest |
string |
CPU 對受管理命名空間的請求。 查看更多 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#meaning-of-cpu |
| memoryLimit |
string |
管理命名空間的記憶體限制。 查看更多 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#meaning-of-memory |
| memoryRequest |
string |
管理命名空間的記憶體請求。 查看更多 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#meaning-of-memory |
systemData
與建立和上次修改資源相關的元數據。
| 名稱 | 類型 | Description |
|---|---|---|
| createdAt |
string (date-time) |
資源建立的時間戳(UTC)。 |
| createdBy |
string |
建立資源的身分識別。 |
| createdByType |
建立資源的身分識別類型。 |
|
| lastModifiedAt |
string (date-time) |
上次修改的資源時間戳 (UTC) |
| lastModifiedBy |
string |
上次修改資源的身分識別。 |
| lastModifiedByType |
上次修改資源的身分識別類型。 |
TaintEffect
效果表示污穢效果與之相符。 空的意思是符合所有污穢效果。 在指定時,唯一允許的值是 NoSchedule。
| 值 | Description |
|---|---|
| NoSchedule |
除非新 pod 能容忍污染,否則不要讓它們排程到節點,但允許所有提交給 Kubelet 的 Pod 在未經排程器的情況下開始運行,並允許所有已運行的 Pod 繼續運行。 由排程員強制執行。 |
TolerationOperator
運算子代表鍵與該值的關係。 有效的運算子為 Exists 與 Equal。 預設為相等。 存在等同於價值的萬用字元,因此 ClusterResourcePlacement 可以容忍特定類別的所有污點。
| 值 | Description |
|---|---|
| Exists |
存在容忍算符 |
| Equal |
容忍算符相等 |