다음을 통해 공유

Datasets - Update Parameters

  • 참조
Service:
Power BI REST APIs
API Version:
v1.0

내 작업 영역에서 지정된 데이터 세트에 대한 매개 변수 값을 업데이트.

참고

이 API 호출 과 함께 향상된 데이터 세트 메타데이터 를 사용하는 것이 좋습니다.

중요

  • 향상된 데이터 세트 메타데이터를 사용하는 경우 데이터 세트를 새로 고쳐 새 매개 변수 값을 적용합니다.
  • 향상된 데이터 세트 메타데이터를 사용하지 않는 경우 업데이트 데이터 원본 작업이 완료될 때까지 30분 동안 기다린 다음 데이터 세트를 새로 고칩니다.

사용 권한

사용자는 데이터 세트 소유자여야 합니다.

필수 범위

Dataset.ReadWrite.All

제한 사항

  • 공용 XMLA 엔드포인트 를 사용하여 만들거나 수정한 데이터 세트는 지원되지 않습니다. 이러한 데이터 세트를 변경하려면 관리자는 테이블 형식 개체 모델에 Azure Analysis Services 클라이언트 라이브러리를 사용해야 합니다.
  • DirectQuery 연결은 향상된 데이터 세트 메타데이터에서만 지원됩니다.
  • Azure Analysis Services 라이브 연결이 있는 데이터 세트는 지원되지 않습니다.
  • 요청당 최대 100 매개 변수입니다.
  • 지정된 모든 매개 변수가 데이터 세트에 있어야 합니다.
  • 매개 변수 값은 예상 형식이어야 합니다.
  • 매개 변수 목록은 비어 있거나 중복 매개 변수를 포함할 수 없습니다.
  • 매개 변수 이름은 대/소문자를 구분합니다.
  • 매개 변수 IsRequired 에는 비어 있지 않은 값이 있어야 합니다.
  • 매개 변수 형식 Any 및 Binary 은 업데이트할 수 없습니다. 

POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.UpdateParameters

URI 매개 변수

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

string

데이터 세트 ID

요청 본문

Name 필수 형식 Description
updateDetails True

UpdateMashupParameterDetails[]

업데이트할 데이터 세트 매개 변수 목록

응답

Name 형식 Description
200 OK

정상

예제

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateParameters
Request Body
{
  "updateDetails": [
    {
      "name": "DatabaseName",
      "newValue": "NewDB"
    },
    {
      "name": "MaxId",
      "newValue": "5678"
    }
  ]
}

Sample Response

Status code:
200

정의

Name Description
UpdateMashupParameterDetails

Power BI 데이터 세트 매개 변수에 대한 업데이트 세부 정보
UpdateMashupParametersRequest

Power BI 데이터 세트 매개 변수에 대한 업데이트 요청

UpdateMashupParameterDetails

Power BI 데이터 세트 매개 변수에 대한 업데이트 세부 정보

Name 형식 Description
name

string

매개 변수 이름
newValue

string

매개 변수의 새 값

UpdateMashupParametersRequest

Power BI 데이터 세트 매개 변수에 대한 업데이트 요청

Name 형식 Description
updateDetails

UpdateMashupParameterDetails[]

업데이트할 데이터 세트 매개 변수 목록