Managed Namespaces - Create Or Update

サービス:: AKS

API バージョン:: 2025-05-02-preview

指定したマネージドクラスターでマネージド名前空間を作成または更新します。

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

URI パラメーター

名前	/	必須	型	説明
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)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求本文

名前	型	説明
location	string	名前空間の場所。
properties	NamespaceProperties	名前空間のプロパティ。
tags	object	マネージドクラスター名前空間に保持されるタグ。

応答

名前	型	説明
200 OK	ManagedNamespace	既存の名前空間が正常に更新されました。
201 Created	ManagedNamespace	新しい名前空間が正常に作成されました。
Other Status Codes	ErrorResponse	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

Create/Update Managed Namespace

要求のサンプル

HTTP

PUT 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"
  },
  "properties": {
    "labels": {
      "kubernetes.io/metadata.name": "true"
    },
    "annotations": {
      "annatationKey": "annatationValue"
    },
    "defaultResourceQuota": {
      "cpuRequest": "3m",
      "cpuLimit": "3m",
      "memoryRequest": "5Gi",
      "memoryLimit": "5Gi"
    },
    "defaultNetworkPolicy": {
      "ingress": "AllowSameNamespace",
      "egress": "AllowAll"
    },
    "adoptionPolicy": "IfIdentical",
    "deletePolicy": "Keep"
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/managedNamespaces/namespace1",
  "name": "namespace1",
  "type": "Microsoft.ContainerService/managedClusters/managedNamespaces",
  "location": "eastus2",
  "tags": {
    "tagKey1": "tagValue1"
  },
  "properties": {
    "labels": {
      "kubernetes.io/metadata.name": "true"
    },
    "annotations": {
      "annatationKey": "annatationValue"
    },
    "provisioningState": "Succeeded",
    "defaultResourceQuota": {
      "cpuRequest": "3m",
      "cpuLimit": "3m",
      "memoryRequest": "5Gi",
      "memoryLimit": "5Gi"
    },
    "defaultNetworkPolicy": {
      "ingress": "AllowSameNamespace",
      "egress": "AllowAll"
    },
    "adoptionPolicy": "IfIdentical",
    "deletePolicy": "Keep"
  }
}

状態コード:: 201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/managedNamespaces/namespace1",
  "name": "namespace1",
  "type": "Microsoft.ContainerService/managedClusters/managedNamespaces",
  "location": "eastus2",
  "tags": {
    "tagKey1": "tagValue1"
  },
  "properties": {
    "labels": {
      "kubernetes.io/metadata.name": "true"
    },
    "annotations": {
      "annatationKey": "annatationValue"
    },
    "provisioningState": "Updating",
    "defaultResourceQuota": {
      "cpuRequest": "3m",
      "cpuLimit": "3m",
      "memoryRequest": "5Gi",
      "memoryLimit": "5Gi"
    },
    "defaultNetworkPolicy": {
      "ingress": "AllowSameNamespace",
      "egress": "AllowAll"
    },
    "adoptionPolicy": "IfIdentical",
    "deletePolicy": "Keep"
  }
}

定義

名前	説明
AdoptionPolicy	同じ名前の Kubernetes 名前空間が既に存在する場合のアクション。
createdByType	リソースを作成した ID の種類。
DeletePolicy	名前空間の削除オプション。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
ManagedNamespace	ARM によって管理される名前空間。
NamespaceProperties	ARM によって管理される名前空間のプロパティ
NamespaceProvisioningState	名前空間の現在のプロビジョニング状態。
NetworkPolicies	名前空間の既定のネットワークポリシー。イングレスルールとエグレスルールを指定します。
PolicyRule	さまざまなネットワークポリシー規則を表す列挙型。
ResourceQuota	名前空間のリソースクォータ。
systemData	リソースの作成と最後の変更に関連するメタデータ。

AdoptionPolicy

列挙

同じ名前の Kubernetes 名前空間が既に存在する場合のアクション。

値	説明
Never	名前空間が既に Kubernetes に存在する場合、ARM で同じ名前空間を作成しようとすると失敗します。
IfIdentical	違いがない場合は、ARM によって管理される既存の名前空間を引き継ぐ。
Always	ARM によって管理される既存の名前空間を常に引き継ぐと、一部のフィールドが上書きされる可能性があります。

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

DeletePolicy

列挙

名前空間の削除オプション。

値	説明
Keep	ARM リソースのみを削除し、Kubernetes 名前空間を保持します。 ManagedByARM ラベルも削除します。
Delete	ARM リソースと Kubernetes 名前空間の両方を一緒に削除します。

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

ManagedNamespace

Object

ARM によって管理される名前空間。

名前	型	説明
eTag	string	オプティミスティックコンカレンシーを実装するために使用される一意の読み取り専用文字列。リソースが更新されると、eTag 値が変更されます。通常の etag 規則に従ってオプティミスティックコンカレンシーを有効にするには、後続の要求の eTag 値を持つ if-match ヘッダーまたは if-none-match ヘッダーを指定します。
id	string	リソース ID。
location	string	名前空間の場所。
name	string	リソースグループ内で一意であるリソースの名前。この名前は、リソースへのアクセスに使用できます。
properties	NamespaceProperties	名前空間のプロパティ。
systemData	systemData	このリソースに関連するシステムメタデータ。
tags	object	マネージドクラスター名前空間に保持されるタグ。
type	string	リソースの種類

NamespaceProperties

Object

ARM によって管理される名前空間のプロパティ

名前	型	説明
adoptionPolicy	AdoptionPolicy	同じ名前の Kubernetes 名前空間が既に存在する場合のアクション。
annotations	object	マネージド名前空間の注釈。
defaultNetworkPolicy	NetworkPolicies	名前空間に適用される既定のネットワークポリシー。お客様は、名前空間の下に他の Kubernetes ネットワークポリシーオブジェクトを持つことができます。すべてのネットワークポリシーが適用されます。
defaultResourceQuota	ResourceQuota	名前空間に適用される既定のリソースクォータ。お客様は、名前空間の下に他の Kubernetes リソースクォータオブジェクトを持つことができます。すべてのリソースクォータが適用されます。
deletePolicy	DeletePolicy	名前空間の削除オプション。
labels	object	マネージド名前空間のラベル。
portalFqdn	string	マネージドクラスターにアクセスするために Azure Portal によって使用される特別な FQDN。この FQDN は Azure Portal でのみ使用されるため、他のクライアントでは使用しないでください。 Azure Portal では、一部の応答で特定のクロスオリジンリソース共有 (CORS) ヘッダーを送信する必要があります。このヘッダーは、Kubernetes APIServer では既定では処理されません。この特殊な FQDN は CORS をサポートし、Azure Portal が正常に機能できるようにします。
provisioningState	NamespaceProvisioningState	名前空間の現在のプロビジョニング状態。

NamespaceProvisioningState

列挙

名前空間の現在のプロビジョニング状態。

値	説明
Updating
Deleting
Creating
Succeeded
Failed
Canceled

NetworkPolicies

Object

名前空間の既定のネットワークポリシー。イングレスルールとエグレスルールを指定します。

名前	型	規定値	説明
egress	PolicyRule	AllowAll	ネットワークのエグレスポリシー。
ingress	PolicyRule	AllowSameNamespace	ネットワークのイングレスポリシー。

PolicyRule

列挙

さまざまなネットワークポリシー規則を表す列挙型。

値	説明
DenyAll	すべてのネットワークトラフィックを拒否します。
AllowAll	すべてのネットワークトラフィックを許可します。
AllowSameNamespace	同じ名前空間内のトラフィックを許可します。

ResourceQuota

Object

名前空間のリソースクォータ。

名前	型	説明
cpuLimit	string	1000 分の 1 の CPU 形式での名前空間の CPU 制限。詳細については、 CPU リソースユニットを参照してください。
cpuRequest	string	1000 番目の CPU 形式の名前空間の CPU 要求。詳細については、 CPU リソースユニットを参照してください。
memoryLimit	string	2 乗の形式の名前空間のメモリ制限: Ei、Pi、Ti、Gi、Mi、Ki。詳細については、メモリリソースユニットを参照してください。
memoryRequest	string	2 の累乗形式の名前空間のメモリ要求: Ei、Pi、Ti、Gi、Mi、Ki。詳細については、メモリリソースユニットを参照してください。

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

次の方法で共有

Managed Namespaces - Create Or Update

URI パラメーター

要求本文

応答

セキュリティ

azure_auth

スコープ

例

Create/Update Managed Namespace

要求のサンプル

応答のサンプル

定義

AdoptionPolicy

createdByType

DeletePolicy

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedNamespace

NamespaceProperties

NamespaceProvisioningState

NetworkPolicies

PolicyRule

ResourceQuota

systemData