azure_power_bi_dataset_datasources resource

Use the azure_power_bi_dataset_datasources Chef InSpec audit resource to test the properties of all Azure Power BI dataset data sources.

Azure REST API version, endpoint, and HTTP client parameters

This resource interacts with API versions supported by the resource provider. You can specify the api_version as a resource parameter to use a specific version of the Azure REST API. If you don’t specify an API version, this resource uses the latest version available. For more information about API versioning, see the azure_generic_resource.

By default, this resource uses the azure_cloud global endpoint and default HTTP client settings. You can override these settings if you need to connect to a different Azure environment (such as Azure Government or Azure China). For more information about configuration options, see the resource pack README.

Syntax

An azure_power_bi_dataset_datasources resource block returns all Azure Power BI dataset data sources.

describe azure_power_bi_dataset_datasources(dataset_id: 'DATASET_ID') do
  #...
end

Parameters

dataset_id (required)

The dataset ID.

group_id (optional)

The workspace ID.

Properties

datasourceIds

List of all Power BI data source IDs.

Field: datasourceId

gatewayIds

List of all the bound gateway IDs.

Field: gatewayId

datasourceTypes

List of the data source types.

Field: datasourceType

connectionDetails

List of the data source connection details.

Field: connectionDetails

Also, see the Azure documentation for other available properties.

Examples

Verify that a Power BI dataset data source for a server exists:

describe azure_power_bi_dataset_datasources(dataset_id: 'DATASET_ID').where{ connectionDetails[:server] == 'CONNECTION_SERVER' } do
  it { should exist }
end

Matchers

This Chef InSpec audit resource has the following special matchers. For a full list of available matchers, please visit our Universal Matchers page.

exists

Verify that a Power BI dataset data source is not present.

describe azure_power_bi_dataset_datasources(dataset_id: 'DATASET_ID') do
  it { should_not exist }
end

not_exists

Verify that at least one Power BI dataset data source exists.

describe azure_power_bi_dataset_datasources(dataset_id: 'DATASET_ID') do
  it { should exist }
end

Azure permissions

Your service principal must have the Dataset.Read.All role on the Azure Power BI data set you wish to test.