Managed Namespaces - List By Managed Cluster

Serviço:: AKS

Versão da API:: 2025-04-02-preview

Obtém uma lista de namespaces gerenciados no cluster gerenciado especificado.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
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]$	O nome do recurso de cluster gerenciado.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	ManagedNamespaceListResult	OKEY
Other Status Codes	CloudError	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

List namespaces by Managed Cluster

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/managedNamespaces/namespace1",
      "name": "namespace1",
      "type": "Microsoft.ContainerService/managedClusters/managedNamespaces",
      "tags": {
        "tagKey1": "tagValue1"
      },
      "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"
      }
    }
  ]
}

Definições

Nome	Description
AdoptionPolicy	Ação se o namespace do Kubernetes com o mesmo nome já existir.
CloudError	Uma resposta de erro do serviço contêiner.
CloudErrorBody	Uma resposta de erro do serviço contêiner.
createdByType	O tipo de identidade que criou o recurso.
DeletePolicy	Excluir opções de um namespace.
ManagedNamespace	Namespace gerenciado pelo ARM.
ManagedNamespaceListResult	O resultado de uma solicitação para listar namespaces gerenciados em um cluster gerenciado.
NamespaceProperties	Propriedades de um namespace gerenciado pelo ARM
NamespaceProvisioningState	O estado de provisionamento atual do namespace.
NetworkPolicies	Política de rede padrão do namespace, especificando regras de entrada e saída.
PolicyRule	Enumeração que representa diferentes regras de política de rede.
ResourceQuota	Cota de recursos para o namespace.
systemData	Metadados relativos à criação e última modificação do recurso.

AdoptionPolicy

Enumeração

Ação se o namespace do Kubernetes com o mesmo nome já existir.

Valor	Description
Always	Sempre assuma o namespace existente a ser gerenciado pelo ARM, alguns campos podem ser substituídos.
IfIdentical	Assuma o namespace existente a ser gerenciado pelo ARM, se não houver diferença.
Never	Se o namespace já existir no Kubernetes, as tentativas de criar esse mesmo namespace no ARM falharão.

CloudError

Objeto

Uma resposta de erro do serviço contêiner.

Nome	Tipo	Description
error	CloudErrorBody	Detalhes sobre o erro.

CloudErrorBody

Objeto

Uma resposta de erro do serviço contêiner.

Nome	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.
details	CloudErrorBody[]	Uma lista de detalhes adicionais sobre o erro.
message	string	Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.
target	string	O destino do erro específico. Por exemplo, o nome da propriedade em erro.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
Application
Key
ManagedIdentity
User

DeletePolicy

Enumeração

Excluir opções de um namespace.

Valor	Description
Delete	Exclua o recurso arm e o namespace do Kubernetes juntos.
Keep	Exclua apenas o recurso arm, mantenha o namespace do Kubernetes. Exclua também o rótulo ManagedByARM.

ManagedNamespace

Objeto

Namespace gerenciado pelo ARM.

Nome	Tipo	Description
eTag	string	Cadeia de caracteres somente leitura exclusiva usada para implementar simultaneidade otimista. O valor da eTag será alterado quando o recurso for atualizado. Especifique um cabeçalho if-match ou if-none-match com o valor eTag para uma solicitação subsequente para habilitar a simultaneidade otimista de acordo com a convenção de etag normal.
id	string	ID do recurso.
location	string	O local do namespace.
name	string	O nome do recurso exclusivo em um grupo de recursos. Esse nome pode ser usado para acessar o recurso.
properties	NamespaceProperties	Propriedades de um namespace.
systemData	systemData	Os metadados do sistema relacionados a esse recurso.
tags	object	As marcas a serem mantidas no namespace do cluster gerenciado.
type	string	Tipo de recurso

ManagedNamespaceListResult

Objeto

O resultado de uma solicitação para listar namespaces gerenciados em um cluster gerenciado.

Nome	Tipo	Description
nextLink	string	O URI para buscar a próxima página de resultados, se houver.
value	ManagedNamespace[]	A lista de namespaces gerenciados.

NamespaceProperties

Objeto

Propriedades de um namespace gerenciado pelo ARM

Nome	Tipo	Description
adoptionPolicy	AdoptionPolicy	Ação se o namespace do Kubernetes com o mesmo nome já existir.
annotations	object	As anotações do namespace gerenciado.
defaultNetworkPolicy	NetworkPolicies	A política de rede padrão imposta no namespace. Os clientes podem ter outros objetos de política de rede do Kubernetes no namespace. Todas as políticas de rede serão impostas.
defaultResourceQuota	ResourceQuota	A cota de recursos padrão imposta no namespace. Os clientes podem ter outros objetos de cota de recursos do Kubernetes no namespace. Todas as cotas de recursos serão impostas.
deletePolicy	DeletePolicy	Excluir opções de um namespace.
labels	object	Os rótulos do namespace gerenciado.
provisioningState	NamespaceProvisioningState	O estado de provisionamento atual do namespace.

NamespaceProvisioningState

Enumeração

O estado de provisionamento atual do namespace.

Valor	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

NetworkPolicies

Objeto

Política de rede padrão do namespace, especificando regras de entrada e saída.

Nome	Tipo	Valor padrão	Description
egress	PolicyRule	AllowAll	Política de saída para a rede.
ingress	PolicyRule	AllowSameNamespace	Política de entrada para a rede.

PolicyRule

Enumeração

Enumeração que representa diferentes regras de política de rede.

Valor	Description
AllowAll	Permitir todo o tráfego de rede.
AllowSameNamespace	Permitir o tráfego no mesmo namespace.
DenyAll	Negar todo o tráfego de rede.

ResourceQuota

Objeto

Cota de recursos para o namespace.

Nome	Tipo	Description
cpuLimit	string	Limite de CPU do namespace no milésimo formulário de CPU. Consulte as unidades de recursos da CPU para obter mais detalhes.
cpuRequest	string	Solicitação de CPU do namespace no milésimo formulário de CPU. Consulte as unidades de recursos da CPU para obter mais detalhes.
memoryLimit	string	Limite de memória do namespace na forma de potência de dois equivalentes: Ei, Pi, Ti, Gi, Mi, Ki. Consulte unidades de recursos de memória para obter mais detalhes.
memoryRequest	string	Solicitação de memória do namespace no formato power-of-two equivalentes: Ei, Pi, Ti, Gi, Mi, Ki. Consulte unidades de recursos de memória para obter mais detalhes.

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Compartilhar via

Managed Namespaces - List By Managed Cluster

Parâmetros de URI

Respostas

Segurança

azure_auth

Escopos

Exemplos

List namespaces by Managed Cluster

Solicitação de exemplo

Resposta de exemplo

Definições

AdoptionPolicy

CloudError

CloudErrorBody

createdByType

DeletePolicy

ManagedNamespace

ManagedNamespaceListResult

NamespaceProperties

NamespaceProvisioningState

NetworkPolicies

PolicyRule

ResourceQuota

systemData