Datasets - Update Parameters

Servicio:: Power BI REST APIs

Versión de la API:: v1.0

Actualiza los valores de parámetros del conjunto de datos especificado de Mi área de trabajo.

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 a que se complete la operación de actualización de orígenes de datos y, a continuación, actualice el conjunto de datos.

Permissions

El usuario debe ser el propietario del conjunto de datos.

Á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 de 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 de 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/datasets/{datasetId}/Default.UpdateParameters

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
datasetId	path	True	string	Identificador del conjunto de datos

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		OK

Ejemplos

Example

Solicitud de ejemplo

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateParameters

Cuerpo de la solicitud

{
  "updateDetails": [
    {
      "name": "DatabaseName",
      "newValue": "NewDB"
    },
    {
      "name": "MaxId",
      "newValue": "5678"
    }
  ]
}

Respuesta de muestra

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

Object

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