Datasets - Update Parameters In Group

Service:

Power BI REST APIs

API Version:

v1.0

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

참고

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

중요

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

사용 권한

• 사용자는 데이터 세트 소유자여야 합니다.
• 이 API 호출은 서비스 주체 프로필에서 호출할 수 있습니다. 자세한 내용은 Power BI Embedded 서비스 주체 프로필을 참조하세요.

필수 범위

Dataset.ReadWrite.All

제한 사항

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

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
datasetId	path	True	string
groupId	path	True	string uuid	작업 영역 ID

요청 본문

Name	필수	형식	Description
updateDetails	True	UpdateMashupParameterDetails[]	업데이트할 데이터 세트 매개 변수 목록

응답

Name	형식	Description
200 OK		정상

예제

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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[]	업데이트할 데이터 세트 매개 변수 목록