Capacities - Update

참조

서비스:: Power BI Embedded

API 버전:: 2021-01-01

지정된 전용 용량의 현재 상태를 업데이트.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerBIDedicated/capacities/{dedicatedCapacityName}?api-version=2021-01-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
dedicatedCapacityName	path	True	string	전용 용량의 이름입니다. 길이가 3자 이상이어야 하며 63자 이상이어야 합니다. regex 패턴: `^[a-z][a-z0-9]*$`
resourceGroupName	path	True	string	지정된 PowerBIDedicated 용량이 속한 Azure 리소스 그룹의 이름입니다. 이 이름은 길이가 1자 이상이어야 하며 90자 이상이어야 합니다. regex 패턴: `^[-\w\._]+$`
subscriptionId	path	True	string	Microsoft Azure 구독에 대한 고유 식별자입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다.
api-version	query	True	string	클라이언트 API 버전입니다.

요청 본문

Name	형식	Description
properties.administration	DedicatedCapacityAdministrators	전용 용량 관리자 컬렉션
properties.mode	Mode	Power BI Embedded 용량의 생성을 지정합니다. 값을 지정하지 않으면 기본값 'Gen2'가 사용됩니다. 자세한 내용
sku	CapacitySku	전용 용량 리소스의 SKU입니다.
tags	object	추가 프로비저닝 속성의 키-값 쌍입니다.

응답

Name	형식	Description
200 OK	DedicatedCapacity	정상
202 Accepted	DedicatedCapacity	수락됨
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	사용자 계정 가장

예제

Update capacity parameters

Update capacity to Generation 2

Update capacity parameters

샘플 요청

HTTP

PATCH https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest?api-version=2021-01-01

{
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {
    "testKey": "testValue"
  },
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    }
  }
}

샘플 응답

상태 코드:: 200

{
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest",
  "location": "West US",
  "name": "azsdktest",
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    },
    "provisioningState": "Provisioning",
    "state": "Provisioning"
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {
    "testKey": "testValue"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2021-01-01T00:00:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-01T00:00:19.1234567Z"
  }
}

상태 코드:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/providers/Microsoft.PowerBIDedicated/locations/westus/operationstatuses/7e4f488e-f071-4b1a-ae84-e25682d09e4c?api-version=2021-01-01
Location: https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/providers/Microsoft.PowerBIDedicated/locations/westus/operationresults/7e4f488e-f071-4b1a-ae84-e25682d09e4c?api-version=2021-01-01

{
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest",
  "location": "West US",
  "name": "azsdktest",
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    },
    "provisioningState": "Provisioning",
    "state": "Provisioning"
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {
    "testKey": "testValue"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2021-01-01T00:00:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-01T00:00:19.1234567Z"
  }
}

Update capacity to Generation 2

샘플 요청

HTTP

PATCH https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest?api-version=2021-01-01

{
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {
    "testKey": "testValue"
  },
  "properties": {
    "mode": "Gen2"
  }
}

샘플 응답

상태 코드:: 200

{
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest",
  "location": "West US",
  "name": "azsdktest",
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    },
    "mode": "Gen2",
    "provisioningState": "Provisioning",
    "state": "Provisioning"
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {
    "testKey": "testValue"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2021-01-01T00:00:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-01T00:00:19.1234567Z"
  }
}

상태 코드:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/providers/Microsoft.PowerBIDedicated/locations/westus/operationstatuses/7e4f488e-f071-4b1a-ae84-e25682d09e4c?api-version=2021-01-01
Location: https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/providers/Microsoft.PowerBIDedicated/locations/westus/operationresults/7e4f488e-f071-4b1a-ae84-e25682d09e4c?api-version=2021-01-01

{
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest",
  "location": "West US",
  "name": "azsdktest",
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    },
    "mode": "Gen2",
    "provisioningState": "Provisioning",
    "state": "Provisioning"
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {
    "testKey": "testValue"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2021-01-01T00:00:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-01T00:00:19.1234567Z"
  }
}

정의

Name	Description
CapacityProvisioningState	PowerBI Dedicated 리소스의 현재 배포 상태입니다. provisioningState는 리소스 프로비저닝 상태를 나타내는 것입니다.
CapacitySku	PowerBI Dedicated 용량 리소스에 대한 SKU 이름 및 Azure 가격 책정 계층을 나타냅니다.
CapacitySkuTier	SKU가 적용되는 Azure 가격 책정 계층의 이름입니다.
DedicatedCapacity	전용 용량 리소스의 instance 나타냅니다.
DedicatedCapacityAdministrators	관리자 사용자 ID의 배열
DedicatedCapacityUpdateParameters	프로비전 요청 사양
Error	오류 개체
ErrorResponse	오류 응답의 형식을 설명합니다.
IdentityType	리소스를 생성/수정한 ID의 형식입니다.
Mode	Power BI Embedded 용량의 생성을 지정합니다. 값을 지정하지 않으면 기본값 'Gen2'가 사용됩니다. 자세한 내용
State	PowerBI Dedicated 리소스의 현재 상태입니다. 상태는 리소스 프로비저닝 외부에서 더 많은 상태를 나타내는 것입니다.
SystemData	리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

CapacityProvisioningState

PowerBI Dedicated 리소스의 현재 배포 상태입니다. provisioningState는 리소스 프로비저닝 상태를 나타내는 것입니다.

Name	형식	Description
Deleting	string
Failed	string
Paused	string
Pausing	string
Preparing	string
Provisioning	string
Resuming	string
Scaling	string
Succeeded	string
Suspended	string
Suspending	string
Updating	string

CapacitySku

PowerBI Dedicated 용량 리소스에 대한 SKU 이름 및 Azure 가격 책정 계층을 나타냅니다.

Name	형식	Description
capacity	integer	SKU의 용량입니다.
name	string	SKU 수준의 이름입니다.
tier	CapacitySkuTier	SKU가 적용되는 Azure 가격 책정 계층의 이름입니다.

CapacitySkuTier

SKU가 적용되는 Azure 가격 책정 계층의 이름입니다.

Name	형식	Description
AutoPremiumHost	string
PBIE_Azure	string
Premium	string

DedicatedCapacity

전용 용량 리소스의 instance 나타냅니다.

Name	형식	Description
id	string	PowerBI Dedicated 리소스를 나타내는 식별자입니다.
location	string	PowerBI Dedicated 리소스의 위치입니다.
name	string	PowerBI Dedicated 리소스의 이름입니다.
properties.administration	DedicatedCapacityAdministrators	전용 용량 관리자 컬렉션
properties.friendlyName	string	용량 이름
properties.mode	Mode	Power BI Embedded 용량의 생성을 지정합니다. 값을 지정하지 않으면 기본값 'Gen2'가 사용됩니다. 자세한 내용
properties.provisioningState	CapacityProvisioningState	PowerBI Dedicated 리소스의 현재 배포 상태입니다. provisioningState는 리소스 프로비저닝 상태를 나타내는 것입니다.
properties.state	State	PowerBI Dedicated 리소스의 현재 상태입니다. 상태는 리소스 프로비저닝 외부에서 더 많은 상태를 나타내는 것입니다.
properties.tenantId	string	용량에 대한 테넌트 ID입니다. Pro Plus 용량을 만드는 데 사용됩니다.
sku	CapacitySku	PowerBI 전용 용량 리소스의 SKU입니다.
systemData	SystemData	리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
tags	object	추가 리소스 프로비저닝 속성의 키-값 쌍입니다.
type	string	PowerBI Dedicated 리소스의 형식입니다.

DedicatedCapacityAdministrators

관리자 사용자 ID의 배열

Name	형식	Description
members	string[]	관리자 사용자 ID의 배열입니다.

DedicatedCapacityUpdateParameters

프로비전 요청 사양

Name	형식	Description
properties.administration	DedicatedCapacityAdministrators	전용 용량 관리자 컬렉션
properties.friendlyName	string	용량 이름
properties.mode	Mode	Power BI Embedded 용량의 생성을 지정합니다. 값을 지정하지 않으면 기본값 'Gen2'가 사용됩니다. 자세한 내용
properties.tenantId	string	용량에 대한 테넌트 ID입니다. Pro Plus 용량을 만드는 데 사용됩니다.
sku	CapacitySku	전용 용량 리소스의 SKU입니다.
tags	object	추가 프로비저닝 속성의 키-값 쌍입니다.

Error

오류 개체

Name	형식	Description
code	string	오류 코드
message	string	작업이 실패한 이유를 나타내는 오류 메시지입니다.

ErrorResponse

오류 응답의 형식을 설명합니다.

Name	형식	Description
error	Error	오류 개체

IdentityType

리소스를 생성/수정한 ID의 형식입니다.

Name	형식	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Mode

Power BI Embedded 용량의 생성을 지정합니다. 값을 지정하지 않으면 기본값 'Gen2'가 사용됩니다. 자세한 내용

Name	형식	Description
Gen1	string
Gen2	string

State

PowerBI Dedicated 리소스의 현재 상태입니다. 상태는 리소스 프로비저닝 외부에서 더 많은 상태를 나타내는 것입니다.

Name	형식	Description
Deleting	string
Failed	string
Paused	string
Pausing	string
Preparing	string
Provisioning	string
Resuming	string
Scaling	string
Succeeded	string
Suspended	string
Suspending	string
Updating	string

SystemData

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

Name	형식	Description
createdAt	string	리소스 만들기의 타임스탬프(UTC)
createdBy	string	리소스를 만든 ID의 식별자
createdByType	IdentityType	리소스를 만든 ID 유형
lastModifiedAt	string	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID의 식별자
lastModifiedByType	IdentityType	리소스를 마지막으로 수정한 ID 유형

다음을 통해 공유

Capacities - Update

URI 매개 변수

요청 본문

응답

보안

azure_auth

범위

예제

Update capacity parameters

샘플 요청

샘플 응답

Update capacity to Generation 2

샘플 요청

샘플 응답

정의

CapacityProvisioningState

CapacitySku

CapacitySkuTier

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

IdentityType

Mode

State

SystemData

추가 리소스