Datasets - Update Parameters In Group

Referencia

Service:: Power BI REST APIs

API Version:: v1.0

Novedades los valores de parámetros del conjunto de datos especificado del área de trabajo especificada.

Nota

Se recomienda usar metadatos de conjunto de datos mejorados con esta llamada API.

Importante

Si usa metadatos mejorados del conjunto de datos, actualice el conjunto de datos para aplicar los nuevos valores de parámetro.
Si no usa metadatos de conjunto de datos mejorados, espere 30 minutos hasta que finalice la operación de actualización de orígenes de datos y, a continuación, actualice el conjunto de datos.

Permisos

El usuario debe ser el propietario del conjunto de datos.
Un perfil de entidad de servicio puede llamar a esta llamada API. Para obtener más información, consulte: Perfiles de entidad de servicio en Power BI Embedded.

Ámbito requerido

Dataset.ReadWrite.All

Limitaciones

No se admiten los conjuntos de datos creados o modificados mediante el punto de conexión XMLA público. Para realizar cambios en esos conjuntos de datos, el administrador debe usar la biblioteca cliente Azure Analysis Services para el modelo de objetos tabulares.
Las conexiones DirectQuery solo se admiten con metadatos de conjunto de datos mejorados.
No se admiten conjuntos de datos con conexiones dinámicas Azure Analysis Services.
Máximo de 100 parámetros por solicitud.
Todos los parámetros especificados deben existir en el conjunto de datos.
Los valores de parámetros deben ser del tipo esperado.
La lista de parámetros no puede estar vacía ni incluir parámetros duplicados.
Los nombres de parámetros distinguen mayúsculas de minúsculas.
El parámetro IsRequired debe tener un valor no vacío.
Los tipos Any de parámetro y Binary no se pueden actualizar.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
datasetId	path	True	string
groupId	path	True	string uuid	Identificador del área de trabajo

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
updateDetails	True	UpdateMashupParameterDetails[]	Lista de parámetros de conjunto de datos que se van a actualizar

Respuestas

Nombre	Tipo	Description
200 OK		Aceptar

Ejemplos

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

Definiciones

Nombre	Description
UpdateMashupParameterDetails	Los detalles de actualización de un parámetro de conjunto de datos de Power BI
UpdateMashupParametersRequest	Solicitud de actualización para un parámetro de conjunto de datos de Power BI

UpdateMashupParameterDetails

Los detalles de actualización de un parámetro de conjunto de datos de Power BI

Nombre	Tipo	Description
name	string	Nombre del parámetro
newValue	string	Nuevo valor para el parámetro

UpdateMashupParametersRequest

Solicitud de actualización para un parámetro de conjunto de datos de Power BI

Nombre	Tipo	Description
updateDetails	UpdateMashupParameterDetails[]	Lista de parámetros de conjunto de datos que se van a actualizar