다음을 통해 공유


Cluster Pools - Create Or Update

클러스터 풀을 만들거나 업데이트합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusterpools/{clusterPoolName}?api-version=2023-11-01-preview

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
clusterPoolName
path True

string

클러스터 풀의 이름입니다.

resourceGroupName
path True

string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.

subscriptionId
path True

string

uuid

대상 구독의 ID입니다. 값은 UUID여야 합니다.

api-version
query True

string

이 작업에 사용할 API 버전입니다.

요청 본문

Name 필수 형식 Description
location True

string

리소스가 있는 지리적 위치

properties.computeProfile True

ComputeProfile

CLuster 풀 컴퓨팅 프로필입니다.

properties.clusterPoolProfile

ClusterPoolProfile

CLuster 풀 프로필.

properties.logAnalyticsProfile

LogAnalyticsProfile

AKS 클러스터에 OMS 에이전트를 사용하도록 설정하는 클러스터 풀 로그 분석 프로필입니다.

properties.managedResourceGroupName

string

고객을 대신하여 RP에서 만든 리소스를 보관하기 위해 RP에서 만든 리소스 그룹입니다. 또한 패턴별로 aksManagedResourceGroupName을 생성하는 데 사용됩니다. MC_{managedResourceGroupName}{clusterPoolName}{region}. 리소스 그룹 이름 제한을 충족하는지 확인하세요.

properties.networkProfile

NetworkProfile

클러스터 풀 네트워크 프로필.

tags

object

리소스 태그.

응답

Name 형식 Description
200 OK

ClusterPool

업데이트에 성공했습니다.

201 Created

ClusterPool

ClusterPool이 만들어집니다.

Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

ClusterPoolPut
ClusterPoolPutWithPrivateAks
ClusterPoolPutWithUDRAks

ClusterPoolPut

샘플 요청

PUT https://management.azure.com/subscriptions/10e32bab-26da-4cc4-a441-52b318f824e6/resourceGroups/hiloResourcegroup/providers/Microsoft.HDInsight/clusterpools/clusterpool1?api-version=2023-11-01-preview

{
  "location": "West US 2",
  "properties": {
    "clusterPoolProfile": {
      "clusterPoolVersion": "1.2"
    },
    "computeProfile": {
      "vmSize": "Standard_D3_v2"
    }
  }
}

샘플 응답

{
  "id": "/subscriptions/subid/resourceGroups/hiloResourcegroup/providers/Microsoft.HDInsight/clusterPools/clusterpool1",
  "name": "clusterpool1",
  "type": "Microsoft.HDInsight/clusterPools",
  "properties": {
    "provisioningState": "Succeeded",
    "deploymentId": "45cd32aead6e4a91b079a0cdbfac8c36",
    "managedResourceGroupName": "hdi-45cd32aead6e4a91b079a0cdbfac8c36",
    "clusterPoolProfile": {
      "clusterPoolVersion": "1.2"
    },
    "computeProfile": {
      "vmSize": "Standard_D3_v2",
      "count": 3
    },
    "aksClusterProfile": {
      "aksVersion": "1.24",
      "aksClusterAgentPoolIdentityProfile": {
        "msiResourceId": "/subscriptions/subid/resourceGroups/hdi-45cd32aead6e4a91b079a0cdbfac8c36/providers/Microsoft.ManagedIdentity/userAssignedIdentities/clusterpool1-agentpool",
        "msiClientId": "a89fb478-2a84-4d9b-8f18-3e8c4d1db3eb",
        "msiObjectId": "dc7ef861-8b55-4ffb-9003-20885cd895a9"
      },
      "aksClusterResourceId": "/subscriptions/subid/resourceGroups/hdi-45cd32aead6e4a91b079a0cdbfac8c36/providers/Microsoft.ContainerService/managedClusters/clusterpool1"
    }
  },
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2020-02-03T01:01:01.1075056Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-02-04T02:03:01.1974346Z"
  },
  "location": "West US 2"
}
{
  "id": "/subscriptions/subid/resourceGroups/hiloResourcegroup/providers/Microsoft.HDInsight/clusterPools/clusterpool1",
  "name": "clusterpool1",
  "type": "Microsoft.HDInsight/clusterPools",
  "properties": {
    "provisioningState": "Accepted",
    "deploymentId": "45cd32aead6e4a91b079a0cdbfac8c36",
    "managedResourceGroupName": "hdi-45cd32aead6e4a91b079a0cdbfac8c36",
    "clusterPoolProfile": {
      "clusterPoolVersion": "1.2"
    },
    "computeProfile": {
      "vmSize": "Standard_D3_v2",
      "count": 3
    },
    "aksClusterProfile": {
      "aksVersion": "1.24",
      "aksClusterAgentPoolIdentityProfile": {
        "msiResourceId": "/subscriptions/subid/resourceGroups/hdi-45cd32aead6e4a91b079a0cdbfac8c36/providers/Microsoft.ManagedIdentity/userAssignedIdentities/clusterpool1-agentpool",
        "msiClientId": "a89fb478-2a84-4d9b-8f18-3e8c4d1db3eb",
        "msiObjectId": "dc7ef861-8b55-4ffb-9003-20885cd895a9"
      },
      "aksClusterResourceId": "/subscriptions/subid/resourceGroups/hdi-45cd32aead6e4a91b079a0cdbfac8c36/providers/Microsoft.ContainerService/managedClusters/clusterpool1"
    }
  },
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2020-02-03T01:01:01.1075056Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-02-04T02:03:01.1974346Z"
  },
  "location": "West US 2"
}

ClusterPoolPutWithPrivateAks

샘플 요청

PUT https://management.azure.com/subscriptions/10e32bab-26da-4cc4-a441-52b318f824e6/resourceGroups/hiloResourcegroup/providers/Microsoft.HDInsight/clusterpools/clusterpool1?api-version=2023-11-01-preview

{
  "location": "West US 2",
  "properties": {
    "clusterPoolProfile": {
      "clusterPoolVersion": "1.2"
    },
    "computeProfile": {
      "vmSize": "Standard_D3_v2"
    },
    "networkProfile": {
      "subnetId": "/subscriptions/subid/resourceGroups/hiloResourcegroup/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
      "enablePrivateApiServer": true
    }
  }
}

샘플 응답

{
  "id": "/subscriptions/subid/resourceGroups/hiloResourcegroup/providers/Microsoft.HDInsight/clusterPools/clusterpool1",
  "name": "clusterpool1",
  "type": "Microsoft.HDInsight/clusterPools",
  "properties": {
    "provisioningState": "Succeeded",
    "deploymentId": "45cd32aead6e4a91b079a0cdbfac8c36",
    "managedResourceGroupName": "hdi-45cd32aead6e4a91b079a0cdbfac8c36",
    "clusterPoolProfile": {
      "clusterPoolVersion": "1.2"
    },
    "computeProfile": {
      "vmSize": "Standard_D3_v2",
      "count": 3
    },
    "aksClusterProfile": {
      "aksVersion": "1.24",
      "aksClusterAgentPoolIdentityProfile": {
        "msiResourceId": "/subscriptions/subid/resourceGroups/hdi-45cd32aead6e4a91b079a0cdbfac8c36/providers/Microsoft.ManagedIdentity/userAssignedIdentities/clusterpool1-agentpool",
        "msiClientId": "a89fb478-2a84-4d9b-8f18-3e8c4d1db3eb",
        "msiObjectId": "dc7ef861-8b55-4ffb-9003-20885cd895a9"
      },
      "aksClusterResourceId": "/subscriptions/subid/resourceGroups/hdi-45cd32aead6e4a91b079a0cdbfac8c36/providers/Microsoft.ContainerService/managedClusters/clusterpool1"
    },
    "networkProfile": {
      "subnetId": "/subscriptions/subid/resourceGroups/hiloResourcegroup/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
      "enablePrivateApiServer": true
    }
  },
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2020-02-03T01:01:01.1075056Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-02-04T02:03:01.1974346Z"
  },
  "location": "West US 2"
}
{
  "id": "/subscriptions/subid/resourceGroups/hiloResourcegroup/providers/Microsoft.HDInsight/clusterPools/clusterpool1",
  "name": "clusterpool1",
  "type": "Microsoft.HDInsight/clusterPools",
  "properties": {
    "provisioningState": "Accepted",
    "deploymentId": "45cd32aead6e4a91b079a0cdbfac8c36",
    "managedResourceGroupName": "hdi-45cd32aead6e4a91b079a0cdbfac8c36",
    "clusterPoolProfile": {
      "clusterPoolVersion": "1.2"
    },
    "computeProfile": {
      "vmSize": "Standard_D3_v2",
      "count": 3
    },
    "aksClusterProfile": {
      "aksVersion": "1.24",
      "aksClusterAgentPoolIdentityProfile": {
        "msiResourceId": "/subscriptions/subid/resourceGroups/hdi-45cd32aead6e4a91b079a0cdbfac8c36/providers/Microsoft.ManagedIdentity/userAssignedIdentities/clusterpool1-agentpool",
        "msiClientId": "a89fb478-2a84-4d9b-8f18-3e8c4d1db3eb",
        "msiObjectId": "dc7ef861-8b55-4ffb-9003-20885cd895a9"
      },
      "aksClusterResourceId": "/subscriptions/subid/resourceGroups/hdi-45cd32aead6e4a91b079a0cdbfac8c36/providers/Microsoft.ContainerService/managedClusters/clusterpool1"
    },
    "networkProfile": {
      "subnetId": "/subscriptions/subid/resourceGroups/hiloResourcegroup/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
      "enablePrivateApiServer": true
    }
  },
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2020-02-03T01:01:01.1075056Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-02-04T02:03:01.1974346Z"
  },
  "location": "West US 2"
}

ClusterPoolPutWithUDRAks

샘플 요청

PUT https://management.azure.com/subscriptions/10e32bab-26da-4cc4-a441-52b318f824e6/resourceGroups/hiloResourcegroup/providers/Microsoft.HDInsight/clusterpools/clusterpool1?api-version=2023-11-01-preview

{
  "location": "West US 2",
  "properties": {
    "clusterPoolProfile": {
      "clusterPoolVersion": "1.2"
    },
    "computeProfile": {
      "vmSize": "Standard_D3_v2"
    },
    "networkProfile": {
      "subnetId": "/subscriptions/subid/resourceGroups/hiloResourcegroup/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
      "outboundType": "userDefinedRouting"
    }
  }
}

샘플 응답

{
  "id": "/subscriptions/subid/resourceGroups/hiloResourcegroup/providers/Microsoft.HDInsight/clusterPools/clusterpool1",
  "name": "clusterpool1",
  "type": "Microsoft.HDInsight/clusterPools",
  "properties": {
    "provisioningState": "Succeeded",
    "deploymentId": "45cd32aead6e4a91b079a0cdbfac8c36",
    "managedResourceGroupName": "hdi-45cd32aead6e4a91b079a0cdbfac8c36",
    "clusterPoolProfile": {
      "clusterPoolVersion": "1.2"
    },
    "computeProfile": {
      "vmSize": "Standard_D3_v2",
      "count": 3
    },
    "aksClusterProfile": {
      "aksVersion": "1.24",
      "aksClusterAgentPoolIdentityProfile": {
        "msiResourceId": "/subscriptions/subid/resourceGroups/hdi-45cd32aead6e4a91b079a0cdbfac8c36/providers/Microsoft.ManagedIdentity/userAssignedIdentities/clusterpool1-agentpool",
        "msiClientId": "a89fb478-2a84-4d9b-8f18-3e8c4d1db3eb",
        "msiObjectId": "dc7ef861-8b55-4ffb-9003-20885cd895a9"
      },
      "aksClusterResourceId": "/subscriptions/subid/resourceGroups/hdi-45cd32aead6e4a91b079a0cdbfac8c36/providers/Microsoft.ContainerService/managedClusters/clusterpool1"
    },
    "networkProfile": {
      "subnetId": "/subscriptions/subid/resourceGroups/hiloResourcegroup/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
      "outboundType": "userDefinedRouting"
    }
  },
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2020-02-03T01:01:01.1075056Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-02-04T02:03:01.1974346Z"
  },
  "location": "West US 2"
}
{
  "id": "/subscriptions/subid/resourceGroups/hiloResourcegroup/providers/Microsoft.HDInsight/clusterPools/clusterpool1",
  "name": "clusterpool1",
  "type": "Microsoft.HDInsight/clusterPools",
  "properties": {
    "provisioningState": "Accepted",
    "deploymentId": "45cd32aead6e4a91b079a0cdbfac8c36",
    "managedResourceGroupName": "hdi-45cd32aead6e4a91b079a0cdbfac8c36",
    "clusterPoolProfile": {
      "clusterPoolVersion": "1.2"
    },
    "computeProfile": {
      "vmSize": "Standard_D3_v2",
      "count": 3
    },
    "aksClusterProfile": {
      "aksVersion": "1.24",
      "aksClusterAgentPoolIdentityProfile": {
        "msiResourceId": "/subscriptions/subid/resourceGroups/hdi-45cd32aead6e4a91b079a0cdbfac8c36/providers/Microsoft.ManagedIdentity/userAssignedIdentities/clusterpool1-agentpool",
        "msiClientId": "a89fb478-2a84-4d9b-8f18-3e8c4d1db3eb",
        "msiObjectId": "dc7ef861-8b55-4ffb-9003-20885cd895a9"
      },
      "aksClusterResourceId": "/subscriptions/subid/resourceGroups/hdi-45cd32aead6e4a91b079a0cdbfac8c36/providers/Microsoft.ContainerService/managedClusters/clusterpool1"
    },
    "networkProfile": {
      "subnetId": "/subscriptions/subid/resourceGroups/hiloResourcegroup/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
      "outboundType": "userDefinedRouting"
    }
  },
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2020-02-03T01:01:01.1075056Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-02-04T02:03:01.1974346Z"
  },
  "location": "West US 2"
}

정의

Name Description
AksClusterAgentPoolIdentityProfile

AKS 클러스터 에이전트 풀 MSI의 ID 속성

AksClusterProfile

기본 AKS 클러스터의 속성입니다.

ClusterPool

클러스터 풀.

ClusterPoolProfile

CLuster 풀 프로필.

ComputeProfile

CLuster 풀 컴퓨팅 프로필입니다.

createdByType

리소스를 만든 ID 유형입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

LogAnalyticsProfile

AKS 클러스터에 OMS 에이전트를 사용하도록 설정하는 클러스터 풀 로그 분석 프로필입니다.

NetworkProfile

클러스터 풀 네트워크 프로필.

outboundType

아웃바운드(송신) 라우팅 메서드입니다.

ProvisioningStatus

리소스의 프로비전 상태입니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

AksClusterAgentPoolIdentityProfile

AKS 클러스터 에이전트 풀 MSI의 ID 속성

Name 형식 Description
msiClientId

string

MSI의 ClientId입니다.

msiObjectId

string

MSI의 ObjectId입니다.

msiResourceId

string

MSI의 ResourceId입니다.

AksClusterProfile

기본 AKS 클러스터의 속성입니다.

Name 형식 Description
aksClusterAgentPoolIdentityProfile

AksClusterAgentPoolIdentityProfile

AKS 클러스터 에이전트 풀 MSI의 ID 속성

aksClusterResourceId

string

AKS 클러스터의 ARM 리소스 ID

aksVersion

string

이 ClusterPool의 AKS 컨트롤 플레인 및 기본 노드 풀 버전

ClusterPool

클러스터 풀.

Name 형식 Description
id

string

리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

리소스가 있는 지리적 위치

name

string

리소스의 이름입니다.

properties.aksClusterProfile

AksClusterProfile

기본 AKS 클러스터의 속성입니다.

properties.aksManagedResourceGroupName

string

AKS에서 만든 리소스 그룹은 고객을 대신하여 AKS에서 만든 인프라 리소스를 보유합니다. 클러스터 풀 이름 및 관리되는 리소스 그룹 이름에 의해 패턴별로 생성됩니다. MC_{managedResourceGroupName}{clusterPoolName}{region}

properties.clusterPoolProfile

ClusterPoolProfile

CLuster 풀 프로필.

properties.computeProfile

ComputeProfile

CLuster 풀 컴퓨팅 프로필입니다.

properties.deploymentId

string

리소스를 식별하기 위해 RP에서 생성된 고유 ID입니다.

properties.logAnalyticsProfile

LogAnalyticsProfile

AKS 클러스터에 OMS 에이전트를 사용하도록 설정하는 클러스터 풀 로그 분석 프로필입니다.

properties.managedResourceGroupName

string

고객을 대신하여 RP에서 만든 리소스를 보관하기 위해 RP에서 만든 리소스 그룹입니다. 또한 패턴별로 aksManagedResourceGroupName을 생성하는 데 사용됩니다. MC_{managedResourceGroupName}{clusterPoolName}{region}. 리소스 그룹 이름 제한을 충족하는지 확인하세요.

properties.networkProfile

NetworkProfile

클러스터 풀 네트워크 프로필.

properties.provisioningState

ProvisioningStatus

리소스의 프로비전 상태입니다.

properties.status

string

리소스의 비즈니스 상태입니다.

systemData

systemData

클러스터 풀의 SystemData입니다.

tags

object

리소스 태그.

type

string

리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

ClusterPoolProfile

CLuster 풀 프로필.

Name 형식 Description
clusterPoolVersion

string

클러스터 풀 버전은 2부로 구성된 버전입니다.

ComputeProfile

CLuster 풀 컴퓨팅 프로필입니다.

Name 형식 Description
count

integer

가상 머신의 수입니다.

vmSize

string

가상 머신 SKU입니다.

createdByType

리소스를 만든 ID 유형입니다.

Name 형식 Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

Error 개체.

LogAnalyticsProfile

AKS 클러스터에 OMS 에이전트를 사용하도록 설정하는 클러스터 풀 로그 분석 프로필입니다.

Name 형식 Description
enabled

boolean

클러스터 풀에 대해 로그 분석을 사용하도록 설정하면 True이고, 그렇지 않으면 false입니다.

workspaceId

string

OMS 에이전트와 연결할 Log Analytics 작업 영역입니다.

NetworkProfile

클러스터 풀 네트워크 프로필.

Name 형식 Default value Description
apiServerAuthorizedIpRanges

string[]

AKS API 서버에 액세스할 수 있는 권한이 부여된 IP 범위입니다.
IP 범위는 CIDR 형식으로 지정됩니다(예: 137.117.106.88/29). 이 기능은 프라이빗 AKS 클러스터와 호환되지 않습니다. 따라서 enablePrivateApiServer를 true로 설정하고 apiServerAuthorizedIpRanges를 동시에 설정할 수 없습니다. 현재 이 속성은 지원되지 않으며 사용하지 마세요.

enablePrivateApiServer

boolean

ClusterPool은 AKS 클러스터를 기반으로 합니다. AKS 클러스터는 기본적으로 공용 인터넷에 API 서버를 노출합니다. 이 속성을 true로 설정하면 프라이빗 AKS 클러스터가 만들어지고 공용 인터넷에 노출되지 않는 프라이빗 apiserver를 사용합니다.

outboundType

outboundType

loadBalancer

아웃바운드(송신) 라우팅 메서드입니다.
클러스터 풀을 만들 때만 설정할 수 있으며 나중에 변경할 수 없습니다.

subnetId

string

클러스터 풀 서브넷 리소스 ID입니다.

outboundType

아웃바운드(송신) 라우팅 메서드입니다.

Name 형식 Description
loadBalancer

string

부하 분산 장치는 AKS 할당 공용 IP를 통해 송신하는 데 사용됩니다. 이렇게 하면 'loadBalancer' 형식의 Kubernetes 서비스가 지원됩니다.

userDefinedRouting

string

송신 경로는 사용자가 정의해야 합니다. 이 시나리오는 고급 시나리오이며 적절한 네트워크 구성이 필요합니다.

ProvisioningStatus

리소스의 프로비전 상태입니다.

Name 형식 Description
Accepted

string

Canceled

string

Failed

string

Succeeded

string

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string

UTC(리소스 만들기)의 타임스탬프입니다.

createdBy

string

리소스를 만든 ID입니다.

createdByType

createdByType

리소스를 만든 ID 유형입니다.

lastModifiedAt

string

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID 유형입니다.