共用方式為


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
fleetName
path True

string

minLength: 1
maxLength: 63
pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

Fleet 資源的名稱。

resourceGroupName
path True

string

minLength: 1
maxLength: 90

資源群組的名稱。 名稱不區分大小寫。

subscriptionId
path True

string (uuid)

目標訂用帳戶的標識碼。 此值必須是 UUID。

api-version
query True

string

minLength: 1

用於此作業的 API 版本。

回應

名稱 類型 Description
200 OK

FleetManagedNamespaceListResult

Azure 運作順利完成。

Other Status Codes

ErrorResponse

未預期的錯誤回應。

安全性

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
AdoptionPolicy

如果同名命名空間已經存在,則該動作。

createdByType

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

DeletePolicy

刪除 ARM 管理命名空間的選項。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應

FleetManagedNamespace

一個由艦隊管理的命名空間。

FleetManagedNamespaceListResult

FleetManagedNamespace 清單操作的回應。

FleetManagedNamespaceProperties

艦隊管理命名空間的特性。

FleetManagedNamespaceProvisioningState

艦隊管理命名空間資源的配置狀態

FleetManagedNamespaceStatus

艦隊管理命名空間的狀態資訊。

LabelSelectorOperator

運算子代表索引鍵與一組值的關聯性。 有效運算子為 In、NotIn、Exists 和 DoesNotExist。

ManagedNamespaceProperties

艦隊管理的命名空間屬性。

Meta.V1.LabelSelector

標籤選取器是一組資源的標籤查詢。 matchLabels 和 matchExpressions 的結果為 ANDed。 空白標籤選取器符合所有物件。 Null 標籤選取器不符任何物件。

Meta.V1.LabelSelectorRequirement

卷標選取器需求是一種選取器,其中包含值、索引鍵,以及關聯索引鍵和值的運算符。

NetworkPolicy

管理命名空間的網路政策。

Placement.V1.Affinity

親和力是一組叢集親和力排程規則。 還有更多內容要補充。

Placement.V1.ClusterAffinity

ClusterAffinity 包含所選資源的叢集親和力排程規則。

Placement.V1.ClusterResourcePlacementSpec

ClusterResourcePlacementSpec 定義了 ClusterResourcePlacement 的期望狀態。

Placement.V1.ClusterSelector

叢集選擇器

Placement.V1.ClusterSelectorTerm

叢集選擇詞

Placement.V1.PlacementPolicy

PlacementPolicy 包含選擇目標成員叢集以放置所選資源的規則。 請注意,只有同時連結且符合規則的叢集才會被選擇。 你最多只能指定兩個欄位中的一個:ClusterNames 和 Affinity。 若未指定,則選取所有相連叢集。

Placement.V1.PropertySelector

PropertySelector 協助使用者在選擇資源配置叢集時指定屬性需求。

Placement.V1.PropertySelectorRequirement

PropertySelectorRequirement 是選擇資源擺放叢集時的特定屬性要求。

Placement.V1.Toleration

容忍讓 ClusterResourcePlacement 能容忍任何符合三重 <鍵、值、效果> 的污染,使用匹配運算 <子運算子>。

PlacementProfile

預設配置檔 ClusterResourcePlacement 配置檔。

PlacementType

安置類型。 可以是「PickAll」、「PickN」或「PickFixed」。 預設是 PickAll。

PolicyRule

這些可能的值代表不同的網路政策規則。

PropagationPolicy

傳播用於艦隊間的命名空間供應。

PropagationType

命名空間將在艦隊成員間分配。

PropertySelectorOperator

運算子指定叢集所觀察到的指定屬性值與需求中給定值之間的關係。

ResourceQuota

管理命名空間的資源配額。

systemData

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

TaintEffect

效果表示污穢效果與之相符。 空的意思是符合所有污穢效果。 在指定時,唯一允許的值是 NoSchedule。

TolerationOperator

運算子代表鍵與該值的關係。 有效的運算子為 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

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳情

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

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

FleetManagedNamespaceProperties

此資源的資源特定屬性。

systemData

systemData

Azure Resource Manager 包含 createdBy 與 modifiedBy 資訊的元資料。

tags

object

資源標籤。

type

string

資源的類型。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

FleetManagedNamespaceListResult

FleetManagedNamespace 清單操作的回應。

名稱 類型 Description
nextLink

string (uri)

專案下一頁的連結

value

FleetManagedNamespace[]

本頁的 FleetManagedNamespace 項目

FleetManagedNamespaceProperties

艦隊管理命名空間的特性。

名稱 類型 Description
adoptionPolicy

AdoptionPolicy

如果已管理的命名空間已存在,則操作。 預設是「永遠不會」。

deletePolicy

DeletePolicy

刪除艦隊管理命名空間的選項。 預設是保留。

managedNamespaceProperties

ManagedNamespaceProperties

艦隊管理的命名空間屬性。

portalFqdn

string

艦隊中樞的 Azure 入口網站 FQDN。

propagationPolicy

PropagationPolicy

建立命名空間的傳播輪廓。

provisioningState

FleetManagedNamespaceProvisioningState

上次作業的狀態。

status

FleetManagedNamespaceStatus

艦隊管理命名空間上一次行動的狀態資訊。

FleetManagedNamespaceProvisioningState

艦隊管理命名空間資源的配置狀態

Description
Succeeded

資源已建立。

Failed

資源建立失敗。

Canceled

資源建立已取消。

Creating

正在建立一個由艦隊管理命名空間的配置狀態。

Updating

車隊管理命名空間的配置狀態正在更新。

Deleting

車隊管理命名空間的配置狀態被刪除。

FleetManagedNamespaceStatus

艦隊管理命名空間的狀態資訊。

名稱 類型 Description
lastOperationError

ErrorDetail

艦隊管理命名空間的最後一次操作錯誤

lastOperationId

string

艦隊最後的操作識別碼是管理命名空間

LabelSelectorOperator

運算子代表索引鍵與一組值的關聯性。 有效運算子為 In、NotIn、Exists 和 DoesNotExist。

Description
In

標籤選擇操作符 In

NotIn

標籤選擇操作符 NotIn

Exists

標籤選擇操作符存在

DoesNotExist

標籤選擇操作符DoesNotExist

ManagedNamespaceProperties

艦隊管理的命名空間屬性。

名稱 類型 Description
annotations

object

艦隊的註解管理命名空間。

defaultNetworkPolicy

NetworkPolicy

車隊管理的預設網路政策是命名空間。

defaultResourceQuota

ResourceQuota

艦隊管理命名空間的預設資源配額。

labels

object

車隊的標籤則管理命名空間。

Meta.V1.LabelSelector

標籤選取器是一組資源的標籤查詢。 matchLabels 和 matchExpressions 的結果為 ANDed。 空白標籤選取器符合所有物件。 Null 標籤選取器不符任何物件。

名稱 類型 Description
matchExpressions

Meta.V1.LabelSelectorRequirement[]

matchExpressions 是標籤選取器需求的清單。 需求為 ANDed。

matchLabels

object

matchLabels 是一個 {key,value} 對的映射。 matchLabels 對應中的單一 {key,value} 相當於 matchExpressions 的專案,其索引鍵字段為 “key”,運算符為 “In”,而值數組只包含 “value”。 需求為 ANDed。

Meta.V1.LabelSelectorRequirement

卷標選取器需求是一種選取器,其中包含值、索引鍵,以及關聯索引鍵和值的運算符。

名稱 類型 Description
key

string

key 是選取器所套用的標籤索引鍵。

operator

LabelSelectorOperator

運算子代表索引鍵與一組值的關聯性。 有效運算子為 In、NotIn、Exists 和 DoesNotExist。

values

string[]

values 是字串值的陣列。 如果運算子為 In 或 NotIn,則值陣列必須是非空白的。 如果運算子為 Exists 或 DoesNotExist,則值陣列必須是空的。 此陣列會在策略式合併修補期間取代。

NetworkPolicy

管理命名空間的網路政策。

名稱 類型 Description
egress

PolicyRule

管理命名空間的出口政策。

ingress

PolicyRule

管理命名空間的入口政策。

Placement.V1.Affinity

親和力是一組叢集親和力排程規則。 還有更多內容要補充。

名稱 類型 Description
clusterAffinity

Placement.V1.ClusterAffinity

ClusterAffinity 包含所選資源的叢集親和力排程規則。

Placement.V1.ClusterAffinity

ClusterAffinity 包含所選資源的叢集親和力排程規則。

名稱 類型 Description
requiredDuringSchedulingIgnoredDuringExecution

Placement.V1.ClusterSelector

若此欄位指定的親和力需求在排程時未被滿足,該資源將不會被排程到叢集上。 若此欄位指定的親和力需求在放置後某時停止滿足(例如因更新),系統可能會嘗試或不會嘗試最終移除該資源。

Placement.V1.ClusterResourcePlacementSpec

ClusterResourcePlacementSpec 定義了 ClusterResourcePlacement 的期望狀態。

名稱 類型 Description
policy

Placement.V1.PlacementPolicy

政策定義如何選擇成員叢集以放置所選資源。 若未指定,則選取所有結合成員叢集。

Placement.V1.ClusterSelector

叢集選擇器

名稱 類型 Description
clusterSelectorTerms

Placement.V1.ClusterSelectorTerm[]

ClusterSelectorTerms 是一個叢集選擇詞的清單。 這些項為 ORed

Placement.V1.ClusterSelectorTerm

叢集選擇詞

名稱 類型 Description
labelSelector

Meta.V1.LabelSelector

LabelSelector 是對所有已合併成員叢集進行標籤查詢的。 選取與查詢相符的叢集。 如果你在同一項中同時指定標籤選擇器和屬性選擇器,結果就會被 AND。

propertySelector

Placement.V1.PropertySelector

PropertySelector 是對所有已連接成員叢集進行屬性查詢的程式碼。 選取與查詢相符的叢集。 如果你在同一項中同時指定標籤選擇器和屬性選擇器,結果就會被 AND。 目前,PropertySelector 只能用於 RequiredDuringSchedulingIgnoredDuringExecution 親和力詞。 此場為貝塔級;它是用於基於屬性的排程功能,且僅在部署中啟用屬性提供者時才會運作。

Placement.V1.PlacementPolicy

PlacementPolicy 包含選擇目標成員叢集以放置所選資源的規則。 請注意,只有同時連結且符合規則的叢集才會被選擇。 你最多只能指定兩個欄位中的一個:ClusterNames 和 Affinity。 若未指定,則選取所有相連叢集。

名稱 類型 Description
affinity

Placement.V1.Affinity

Affinity 包含叢集親和力排程規則。 定義要放置選定資源的成員叢集。 只有當置入類型是「PickAll」或「PickN」時才有效。

clusterNames

string[]

ClusterNames 包含 MemberCluster 的名稱清單,用以放置所選資源。 只有當放置類型為「PickFixed」時才有效

placementType

PlacementType

安置類型。 可以是「PickAll」、「PickN」或「PickFixed」。 預設是 PickAll。

tolerations

Placement.V1.Toleration[]

如有指定,則為 ClusterResourcePlacement 的容忍度。 容忍不能更新或刪除。 此欄位為 beta 級,用於污染與耐受特性。

Placement.V1.PropertySelector

PropertySelector 協助使用者在選擇資源配置叢集時指定屬性需求。

名稱 類型 Description
matchExpressions

Placement.V1.PropertySelectorRequirement[]

MatchExpressions 是一個 PropertySelectorRequirements 的陣列。 要求是 AND。

Placement.V1.PropertySelectorRequirement

PropertySelectorRequirement 是選擇資源擺放叢集時的特定屬性要求。

名稱 類型 Description
name

string

名稱即為該物業的名稱;應該是 Kubernetes 的標籤名稱。

operator

PropertySelectorOperator

運算子指定叢集所觀察到的指定屬性值與需求中給定值之間的關係。

values

string[]

數值是指定屬性的數值清單,艦隊將依照指定操作員與個別成員群集的觀察值進行比較。 此時,每個值都應該是 Kubernetes 的數量。 如需詳細資訊,請參閱https://pkg.go.dev/k8s.io/apimachinery/pkg/api/resource#Quantity。 若算符為 Gt(大於 )、Ge(大於等於)、Lt(小於或等於)、 Le Eq(等於 或 )、或 Ne(ne),則列表中必須指定一個值。

Placement.V1.Toleration

容忍讓 ClusterResourcePlacement 能容忍任何符合三重 <鍵、值、效果> 的污染,使用匹配運算 <子運算子>。

名稱 類型 Description
effect

TaintEffect

效果表示污穢效果與之相符。 空的意思是符合所有污穢效果。 在指定時,唯一允許的值是 NoSchedule。

key

string

關鍵是容忍所適用的污染關鍵。 空的意思是所有污點鍵都符合。 若鍵為空,運算符必須為 Exists;此組合意指匹配所有值與所有鍵。

operator

TolerationOperator

運算子代表鍵與該值的關係。 有效的運算子為 Exists 與 Equal。 預設為相等。 存在等同於價值的萬用字元,因此 ClusterResourcePlacement 可以容忍特定類別的所有污點。

value

string

價值是容忍所匹配的污染值。 若運算子為 Exists,值應為空,否則則為一般字串。

PlacementProfile

預設配置檔 ClusterResourcePlacement 配置檔。

名稱 類型 Description
defaultClusterResourcePlacement

Placement.V1.ClusterResourcePlacementSpec

預設的 ClusterResourcePlacement 政策設定。

PlacementType

安置類型。 可以是「PickAll」、「PickN」或「PickFixed」。 預設是 PickAll。

Description
PickAll

PickAll選擇所有符合規則的叢集。

PickFixed

PickFixed 選擇固定的叢集集合。

PolicyRule

這些可能的值代表不同的網路政策規則。

Description
AllowAll

允許所有網路流量。

DenyAll

拒絕所有網路流量。

AllowSameNamespace

允許相同命名空間內的流量。

PropagationPolicy

傳播用於艦隊間的命名空間供應。

名稱 類型 Description
placementProfile

PlacementProfile

用於放置的傳播型譜。

type

PropagationType

所使用的保單類型。 預設是放置。

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

createdByType

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

lastModifiedAt

string (date-time)

上次修改的資源時間戳 (UTC)

lastModifiedBy

string

上次修改資源的身分識別。

lastModifiedByType

createdByType

上次修改資源的身分識別類型。

TaintEffect

效果表示污穢效果與之相符。 空的意思是符合所有污穢效果。 在指定時,唯一允許的值是 NoSchedule。

Description
NoSchedule

除非新 pod 能容忍污染,否則不要讓它們排程到節點,但允許所有提交給 Kubelet 的 Pod 在未經排程器的情況下開始運行,並允許所有已運行的 Pod 繼續運行。 由排程員強制執行。

TolerationOperator

運算子代表鍵與該值的關係。 有效的運算子為 Exists 與 Equal。 預設為相等。 存在等同於價值的萬用字元,因此 ClusterResourcePlacement 可以容忍特定類別的所有污點。

Description
Exists

存在容忍算符

Equal

容忍算符相等