通过


你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Fleet Managed Namespaces - List By Fleet

按舰队分类的舰队管理命名空间资源列表

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/managedNamespaces?api-version=2026-02-01-preview

URI 参数

名称 必需 类型 说明
fleetName
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

资源组的名称。 此名称不区分大小写。

subscriptionId
path True

string (uuid)

目标订阅的 ID。 该值必须是 UUID。

api-version
query True

string

minLength: 1

用于此作的 API 版本。

响应

名称 类型 说明
200 OK

FleetManagedNamespaceListResult

Azure 运营顺利完成。

Other Status Codes

ErrorResponse

意外的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流程。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
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"
}

定义

名称 说明
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

算符表示键与该值的关系。 有效的算符是存在且相等。 默认为相等。 存在相当于值的通配符,因此ClusterResourcePlacement可以容忍特定类别的所有污点。

AdoptionPolicy

如果同名命名空间已经存在,则作。

说明
Never

如果命名空间已经存在,不要接管现有命名空间以供ARM管理。

IfIdentical

如果存在相同的命名空间,接管现有的命名空间,由ARM管理。

Always

始终接管现有的命名空间,以便由ARM管理,即使它们不完全相同。

createdByType

创建资源的标识的类型。

说明
User
Application
ManagedIdentity
Key

DeletePolicy

删除ARM管理命名空间的选项。

说明
Keep

删除ARM资源,但保留命名空间。

Delete

删除ARM资源和命名空间。

ErrorAdditionalInfo

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。

type

string

其他信息类型。

ErrorDetail

错误详细信息。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。

code

string

错误代码。

details

ErrorDetail[]

错误详细信息。

message

string

错误消息。

target

string

错误目标。

ErrorResponse

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

FleetManagedNamespace

一个由舰队管理的命名空间。

名称 类型 说明
eTag

string

如果在响应正文中提供了 eTag,则还可以根据正常的 etag 约定将其作为标头提供。 实体标记用于比较同一请求资源的两个或多个实体。 HTTP/1.1 在 etag(第 14.19 节)、If-Match(第 14.24 节)、If-None-Match(第 14.26 节)和 If-Range(第 14.27 节)标头字段中使用实体标记。

id

string (arm-id)

资源的完全限定资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”

location

string

资源所在的地理位置

name

string

资源的名称

properties

FleetManagedNamespaceProperties

此资源的资源特定属性。

systemData

systemData

包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。

tags

object

资源标记。

type

string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

FleetManagedNamespaceListResult

FleetManagedNamespace列表作的响应。

名称 类型 说明
nextLink

string (uri)

指向下一页项的链接

value

FleetManagedNamespace[]

本页的FleetManagedNamespace项目

FleetManagedNamespaceProperties

舰队管理命名空间的属性。

名称 类型 说明
adoptionPolicy

AdoptionPolicy

如果同名的管理命名空间已经存在,则作。 默认是“永远”。

deletePolicy

DeletePolicy

删除舰队管理命名空间的选项。 默认是保留。

managedNamespaceProperties

ManagedNamespaceProperties

舰队管理命名空间的命名空间属性。

portalFqdn

string

车队中心的 Azure 门户 FQDN。

propagationPolicy

PropagationPolicy

创建命名空间的传播轮廓。

provisioningState

FleetManagedNamespaceProvisioningState

上次操作的状态。

status

FleetManagedNamespaceStatus

舰队管理命名空间的最后一次作状态信息。

FleetManagedNamespaceProvisioningState

车队管理命名空间资源的配置状态

说明
Succeeded

已创建资源。

Failed

资源创建失败。

Canceled

资源创建已取消。

Creating

舰队管理命名空间的配置状态正在创建。

Updating

车队管理命名空间的配置状态正在更新。

Deleting

车队管理命名空间的配置状态正在被删除。

FleetManagedNamespaceStatus

舰队管理命名空间的状态信息。

名称 类型 说明
lastOperationError

ErrorDetail

舰队管理命名空间的最后一次作错误

lastOperationId

string

舰队管理命名空间的最后一个作ID

LabelSelectorOperator

运算符表示键与一组值的关系。 有效运算符为 In、NotIn、Exists 和 DoesNotExist。

说明
In

标签选择作符

NotIn

标签选择作符 NotIn

Exists

标签选择作符存在

DoesNotExist

标签选择作符不存在

ManagedNamespaceProperties

舰队管理命名空间的命名空间属性。

名称 类型 说明
annotations

object

舰队管理命名空间的注释。

defaultNetworkPolicy

NetworkPolicy

车队默认的网络策略是管理命名空间。

defaultResourceQuota

ResourceQuota

舰队管理命名空间的默认资源配额。

labels

object

舰队的标签管理命名空间。

Meta.V1.LabelSelector

标签选择器是对一组资源的标签查询。 matchLabels 和 matchExpressions 的结果为 ANDed。 空标签选择器与所有对象匹配。 null 标签选择器与任何对象匹配。

名称 类型 说明
matchExpressions

Meta.V1.LabelSelectorRequirement[]

matchExpressions 是标签选择器要求的列表。 要求是 ANDed。

matchLabels

object

matchLabels 是 {key,value} 对的映射。 matchLabels 映射中的单个 {key,value} 等效于 matchExpressions 的元素,其键字段为“key”,运算符为“In”,值数组仅包含“value”。 要求是 ANDed。

Meta.V1.LabelSelectorRequirement

标签选择器要求是一个选择器,其中包含值、键和与键和值相关的运算符。

名称 类型 说明
key

string

键是选择器应用于的标签键。

operator

LabelSelectorOperator

运算符表示键与一组值的关系。 有效运算符为 In、NotIn、Exists 和 DoesNotExist。

values

string[]

values 是字符串值的数组。 如果运算符为 In 或 NotIn,则值数组必须为非空。 如果运算符为 Exists 或 DoesNotExist,则值数组必须为空。 此数组在战略合并修补期间被替换。

NetworkPolicy

托管命名空间的网络策略。

名称 类型 说明
egress

PolicyRule

管理命名空间的退出策略。

ingress

PolicyRule

管理命名空间的入口策略。

Placement.V1.Affinity

亲和力是一组簇亲和调度规则。 还有更多内容需要补充。

名称 类型 说明
clusterAffinity

Placement.V1.ClusterAffinity

ClusterAffinity 包含选定资源的集群亲和调度规则。

Placement.V1.ClusterAffinity

ClusterAffinity 包含选定资源的集群亲和调度规则。

名称 类型 说明
requiredDuringSchedulingIgnoredDuringExecution

Placement.V1.ClusterSelector

如果在调度时未满足该字段指定的亲和力要求,资源将不会被调入集群。 如果该字段指定的亲和力要求在放置后某时停止满足(例如因更新),系统可能会尝试或不会尝试最终从集群中移除该资源。

Placement.V1.ClusterResourcePlacementSpec

ClusterResourcePlacementSpec 定义了 ClusterResourcePlacement 的期望状态。

名称 类型 说明
policy

Placement.V1.PlacementPolicy

策略定义了如何选择成员集群以放置所选资源。 如果未指定,则选择所有连接成员簇。

Placement.V1.ClusterSelector

集群选择器

名称 类型 说明
clusterSelectorTerms

Placement.V1.ClusterSelectorTerm[]

ClusterSelectorTerms是集群选择器术语的列表。 这些项为 ORed

Placement.V1.ClusterSelectorTerm

集群选择器术语

名称 类型 说明
labelSelector

Meta.V1.LabelSelector

LabelSelector 是对所有联合成员簇进行标签查询。 选择与查询匹配的聚类。 如果你在同一项中同时指定标签选择器和属性选择器,结果就是 AND。

propertySelector

Placement.V1.PropertySelector

PropertySelector 是对所有已连接成员簇进行的属性查询。 选择与查询匹配的聚类。 如果你在同一项中同时指定标签选择器和属性选择器,结果就是 AND。 目前,PropertySelector 只能与 RequiredDuringSchedulingIgnoredDuringExecution 亲和力项一起使用。 该场为贝塔级;它用于基于属性的调度功能,只有在部署中启用了属性提供者时才有效。

Placement.V1.PlacementPolicy

PlacementPolicy 包含选择目标成员集群以放置所选资源的规则。 注意,只有那些同时连接且满足规则的簇才会被选中。 你最多只能指定两个字段中的一个:ClusterNames 和 Affinity。 如果没有指定,则选择所有连接的簇。

名称 类型 说明
affinity

Placement.V1.Affinity

亲和性包含簇亲和调度规则。 定义了将选定资源放置哪些成员簇。 只有当投放类型是“PickAll”或“PickN”时才有效。

clusterNames

string[]

ClusterNames 包含 MemberCluster 名称列表,用于放置所选资源。 只有当放置类型是“PickFixed”时才有效

placementType

PlacementType

安置类型。 可以是“PickAll”、“PickN”或“PickFixed”。 默认是PickAll。

tolerations

Placement.V1.Toleration[]

如有指定,则为ClusterResourcePlacement的容忍度。 容忍不能更新或删除。 该字段为Beta级,用于污染和耐受特性。

Placement.V1.PropertySelector

PropertySelector 帮助用户在选择资源配置集群时指定属性需求。

名称 类型 说明
matchExpressions

Placement.V1.PropertySelectorRequirement[]

MatchExpressions 是 PropertySelectorRequirements 的数组。 要求是AND。

Placement.V1.PropertySelectorRequirement

PropertySelectorRequirement 是选择资源配置集群时的特定属性要求。

名称 类型 说明
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 容忍任何与三重<键、值、效果>匹配的污染,使用匹配算符<>作符。

名称 类型 说明
effect

TaintEffect

效果表示污染效果与之匹配。 空的意思是匹配所有污秽效果。 在指定情况下,唯一允许的值是 NoSchedule。

key

string

关键是容忍所适用的污染关键。 空的意思是所有污点键都匹配。 如果密钥为空,则算符必须是 Exists;这种组合意味着匹配所有值和所有键。

operator

TolerationOperator

算符表示键与该值的关系。 有效的算符是存在且相等。 默认为相等。 存在相当于值的通配符,因此ClusterResourcePlacement可以容忍特定类别的所有污点。

value

string

价值是容忍所匹配的污染值。 如果运算符是 Exists,则该值应为空,否则只需一个普通字符串。

PlacementProfile

默认配置配置文件 ClusterResourcePlacement 用于放置。

名称 类型 说明
defaultClusterResourcePlacement

Placement.V1.ClusterResourcePlacementSpec

默认的 ClusterResourcePlacement 策略配置。

PlacementType

安置类型。 可以是“PickAll”、“PickN”或“PickFixed”。 默认是PickAll。

说明
PickAll

PickAll会选择所有符合规则的集群。

PickFixed

PickFixed 选择一组固定的簇。

PolicyRule

可能的值代表不同的网络策略规则。

说明
AllowAll

允许所有网络流量。

DenyAll

拒绝所有网络流量。

AllowSameNamespace

允许同一命名空间内的流量。

PropagationPolicy

传播用于舰队中命名空间的供应。

名称 类型 说明
placementProfile

PlacementProfile

用于布置传播的轮廓。

type

PropagationType

所使用的保单类型。 默认是放置。

PropagationType

命名空间将在舰队成员间分配。

说明
Placement

使用 ClusterResourcePlacement。

PropertySelectorOperator

算符指定了簇中所观察到的指定属性值与需求中给出的值之间的关系。

说明
Gt

Gt 规定舰队在观察到的某一属性值大于需求指定值时选择集群。

Ge

Ge 规定 Fleet 选择簇,前提是其观察到的某一属性值大于或等于要求中指定的值。

Eq

方程要求Fleet选择簇,前提是其观察到的某一属性值等于要求中指定的值。

Ne

Ne 规定如果某一属性的观测值与要求中指定的值不符,舰队必须选择簇。

Lt

如果某一属性的观测值低于需求指定值,Fleet 要求选择集群。

Le

Le 规定 Fleet 选择簇,前提是其观察到的某属性值小于或等于要求中指定的值。

ResourceQuota

管理命名空间的资源配额。

名称 类型 说明
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

与创建和上次修改资源相关的元数据。

名称 类型 说明
createdAt

string (date-time)

资源创建时间戳(UTC)。

createdBy

string

创建资源的标识。

createdByType

createdByType

创建资源的标识的类型。

lastModifiedAt

string (date-time)

上次修改的资源时间戳(UTC)

lastModifiedBy

string

上次修改资源的标识。

lastModifiedByType

createdByType

上次修改资源的标识的类型。

TaintEffect

效果表示污染效果与之匹配。 空的意思是匹配所有污秽效果。 在指定情况下,唯一允许的值是 NoSchedule。

说明
NoSchedule

除非新Pod能容忍污染,否则不要让它们调度到节点,但允许所有提交给Kubelet且无需经过调度器的Pods开始运行,并允许所有已运行的Pod继续运行。 由排程员强制执行。

TolerationOperator

算符表示键与该值的关系。 有效的算符是存在且相等。 默认为相等。 存在相当于值的通配符,因此ClusterResourcePlacement可以容忍特定类别的所有污点。

说明
Exists

存在容忍算符

Equal

容忍算符相等