meraki

package
v0.4.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 17, 2025 License: Apache-2.0 Imports: 6 Imported by: 0

Documentation

Overview

A Pulumi package for creating and managing Cisco Meraki resources

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type GetDevicesArgs

type GetDevicesArgs struct {
	// configurationUpdatedAfter query parameter. Filter results by whether or not the device's configuration has been updated after the given timestamp
	ConfigurationUpdatedAfter *string `pulumi:"configurationUpdatedAfter"`
	// endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	EndingBefore *string `pulumi:"endingBefore"`
	// mac query parameter. Optional parameter to filter devices by MAC address. All returned devices will have a MAC address that contains the search term or is an exact match.
	Mac *string `pulumi:"mac"`
	// macs query parameter. Optional parameter to filter devices by one or more MAC addresses. All returned devices will have a MAC address that is an exact match.
	Macs []string `pulumi:"macs"`
	// model query parameter. Optional parameter to filter devices by model. All returned devices will have a model that contains the search term or is an exact match.
	Model *string `pulumi:"model"`
	// models query parameter. Optional parameter to filter devices by one or more models. All returned devices will have a model that is an exact match.
	Models []string `pulumi:"models"`
	// name query parameter. Optional parameter to filter devices by name. All returned devices will have a name that contains the search term or is an exact match.
	Name *string `pulumi:"name"`
	// networkIds query parameter. Optional parameter to filter devices by network.
	NetworkIds []string `pulumi:"networkIds"`
	// organizationId path parameter. Organization ID
	OrganizationId *string `pulumi:"organizationId"`
	// perPage query parameter. The number of entries per page returned. Acceptable range is 3 1000. Default is 1000.
	PerPage *int `pulumi:"perPage"`
	// productTypes query parameter. Optional parameter to filter devices by product type. Valid types are wireless, appliance, switch, systemsManager, camera, cellularGateway, and sensor.
	ProductTypes []string `pulumi:"productTypes"`
	// sensorAlertProfileIds query parameter. Optional parameter to filter devices by the alert profiles that are bound to them. Only applies to sensor devices.
	SensorAlertProfileIds []string `pulumi:"sensorAlertProfileIds"`
	// sensorMetrics query parameter. Optional parameter to filter devices by the metrics that they provide. Only applies to sensor devices.
	SensorMetrics []string `pulumi:"sensorMetrics"`
	// serial query parameter. Optional parameter to filter devices by serial number. All returned devices will have a serial number that contains the search term or is an exact match.
	Serial *string `pulumi:"serial"`
	// serials query parameter. Optional parameter to filter devices by one or more serial numbers. All returned devices will have a serial number that is an exact match.
	Serials []string `pulumi:"serials"`
	// startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	StartingAfter *string `pulumi:"startingAfter"`
	// tags query parameter. Optional parameter to filter devices by tags.
	Tags []string `pulumi:"tags"`
	// tagsFilterType query parameter. Optional parameter of value 'withAnyTags' or 'withAllTags' to indicate whether to return networks which contain ANY or ALL of the included tags. If no type is included, 'withAnyTags' will be selected.
	TagsFilterType *string `pulumi:"tagsFilterType"`
}

A collection of arguments for invoking getDevices.

type GetDevicesItem

type GetDevicesItem struct {
	// Physical address of the device
	Address string `pulumi:"address"`
	// Additional device information
	Details []GetDevicesItemDetail `pulumi:"details"`
	// Firmware version of the device
	Firmware string `pulumi:"firmware"`
	// IMEI of the device, if applicable
	Imei float64 `pulumi:"imei"`
	// LAN IP address of the device
	LanIp string `pulumi:"lanIp"`
	// Latitude of the device
	Lat float64 `pulumi:"lat"`
	// Longitude of the device
	Lng float64 `pulumi:"lng"`
	// MAC address of the device
	Mac string `pulumi:"mac"`
	// Model of the device
	Model string `pulumi:"model"`
	// Name of the device
	Name string `pulumi:"name"`
	// ID of the network the device belongs to
	NetworkId string `pulumi:"networkId"`
	// Notes for the device, limited to 255 characters
	Notes string `pulumi:"notes"`
	// Product type of the device
	ProductType string `pulumi:"productType"`
	// Serial number of the device
	Serial string `pulumi:"serial"`
	// List of tags assigned to the device
	Tags []string `pulumi:"tags"`
}

type GetDevicesItemArgs

type GetDevicesItemArgs struct {
	// Physical address of the device
	Address pulumi.StringInput `pulumi:"address"`
	// Additional device information
	Details GetDevicesItemDetailArrayInput `pulumi:"details"`
	// Firmware version of the device
	Firmware pulumi.StringInput `pulumi:"firmware"`
	// IMEI of the device, if applicable
	Imei pulumi.Float64Input `pulumi:"imei"`
	// LAN IP address of the device
	LanIp pulumi.StringInput `pulumi:"lanIp"`
	// Latitude of the device
	Lat pulumi.Float64Input `pulumi:"lat"`
	// Longitude of the device
	Lng pulumi.Float64Input `pulumi:"lng"`
	// MAC address of the device
	Mac pulumi.StringInput `pulumi:"mac"`
	// Model of the device
	Model pulumi.StringInput `pulumi:"model"`
	// Name of the device
	Name pulumi.StringInput `pulumi:"name"`
	// ID of the network the device belongs to
	NetworkId pulumi.StringInput `pulumi:"networkId"`
	// Notes for the device, limited to 255 characters
	Notes pulumi.StringInput `pulumi:"notes"`
	// Product type of the device
	ProductType pulumi.StringInput `pulumi:"productType"`
	// Serial number of the device
	Serial pulumi.StringInput `pulumi:"serial"`
	// List of tags assigned to the device
	Tags pulumi.StringArrayInput `pulumi:"tags"`
}

func (GetDevicesItemArgs) ElementType

func (GetDevicesItemArgs) ElementType() reflect.Type

func (GetDevicesItemArgs) ToGetDevicesItemOutput

func (i GetDevicesItemArgs) ToGetDevicesItemOutput() GetDevicesItemOutput

func (GetDevicesItemArgs) ToGetDevicesItemOutputWithContext

func (i GetDevicesItemArgs) ToGetDevicesItemOutputWithContext(ctx context.Context) GetDevicesItemOutput

type GetDevicesItemArray

type GetDevicesItemArray []GetDevicesItemInput

func (GetDevicesItemArray) ElementType

func (GetDevicesItemArray) ElementType() reflect.Type

func (GetDevicesItemArray) ToGetDevicesItemArrayOutput

func (i GetDevicesItemArray) ToGetDevicesItemArrayOutput() GetDevicesItemArrayOutput

func (GetDevicesItemArray) ToGetDevicesItemArrayOutputWithContext

func (i GetDevicesItemArray) ToGetDevicesItemArrayOutputWithContext(ctx context.Context) GetDevicesItemArrayOutput

type GetDevicesItemArrayInput

type GetDevicesItemArrayInput interface {
	pulumi.Input

	ToGetDevicesItemArrayOutput() GetDevicesItemArrayOutput
	ToGetDevicesItemArrayOutputWithContext(context.Context) GetDevicesItemArrayOutput
}

GetDevicesItemArrayInput is an input type that accepts GetDevicesItemArray and GetDevicesItemArrayOutput values. You can construct a concrete instance of `GetDevicesItemArrayInput` via:

GetDevicesItemArray{ GetDevicesItemArgs{...} }

type GetDevicesItemArrayOutput

type GetDevicesItemArrayOutput struct{ *pulumi.OutputState }

func (GetDevicesItemArrayOutput) ElementType

func (GetDevicesItemArrayOutput) ElementType() reflect.Type

func (GetDevicesItemArrayOutput) Index

func (GetDevicesItemArrayOutput) ToGetDevicesItemArrayOutput

func (o GetDevicesItemArrayOutput) ToGetDevicesItemArrayOutput() GetDevicesItemArrayOutput

func (GetDevicesItemArrayOutput) ToGetDevicesItemArrayOutputWithContext

func (o GetDevicesItemArrayOutput) ToGetDevicesItemArrayOutputWithContext(ctx context.Context) GetDevicesItemArrayOutput

type GetDevicesItemDetail

type GetDevicesItemDetail struct {
	// Additional property name
	Name string `pulumi:"name"`
	// Additional property value
	Value string `pulumi:"value"`
}

type GetDevicesItemDetailArgs

type GetDevicesItemDetailArgs struct {
	// Additional property name
	Name pulumi.StringInput `pulumi:"name"`
	// Additional property value
	Value pulumi.StringInput `pulumi:"value"`
}

func (GetDevicesItemDetailArgs) ElementType

func (GetDevicesItemDetailArgs) ElementType() reflect.Type

func (GetDevicesItemDetailArgs) ToGetDevicesItemDetailOutput

func (i GetDevicesItemDetailArgs) ToGetDevicesItemDetailOutput() GetDevicesItemDetailOutput

func (GetDevicesItemDetailArgs) ToGetDevicesItemDetailOutputWithContext

func (i GetDevicesItemDetailArgs) ToGetDevicesItemDetailOutputWithContext(ctx context.Context) GetDevicesItemDetailOutput

type GetDevicesItemDetailArray

type GetDevicesItemDetailArray []GetDevicesItemDetailInput

func (GetDevicesItemDetailArray) ElementType

func (GetDevicesItemDetailArray) ElementType() reflect.Type

func (GetDevicesItemDetailArray) ToGetDevicesItemDetailArrayOutput

func (i GetDevicesItemDetailArray) ToGetDevicesItemDetailArrayOutput() GetDevicesItemDetailArrayOutput

func (GetDevicesItemDetailArray) ToGetDevicesItemDetailArrayOutputWithContext

func (i GetDevicesItemDetailArray) ToGetDevicesItemDetailArrayOutputWithContext(ctx context.Context) GetDevicesItemDetailArrayOutput

type GetDevicesItemDetailArrayInput

type GetDevicesItemDetailArrayInput interface {
	pulumi.Input

	ToGetDevicesItemDetailArrayOutput() GetDevicesItemDetailArrayOutput
	ToGetDevicesItemDetailArrayOutputWithContext(context.Context) GetDevicesItemDetailArrayOutput
}

GetDevicesItemDetailArrayInput is an input type that accepts GetDevicesItemDetailArray and GetDevicesItemDetailArrayOutput values. You can construct a concrete instance of `GetDevicesItemDetailArrayInput` via:

GetDevicesItemDetailArray{ GetDevicesItemDetailArgs{...} }

type GetDevicesItemDetailArrayOutput

type GetDevicesItemDetailArrayOutput struct{ *pulumi.OutputState }

func (GetDevicesItemDetailArrayOutput) ElementType

func (GetDevicesItemDetailArrayOutput) Index

func (GetDevicesItemDetailArrayOutput) ToGetDevicesItemDetailArrayOutput

func (o GetDevicesItemDetailArrayOutput) ToGetDevicesItemDetailArrayOutput() GetDevicesItemDetailArrayOutput

func (GetDevicesItemDetailArrayOutput) ToGetDevicesItemDetailArrayOutputWithContext

func (o GetDevicesItemDetailArrayOutput) ToGetDevicesItemDetailArrayOutputWithContext(ctx context.Context) GetDevicesItemDetailArrayOutput

type GetDevicesItemDetailInput

type GetDevicesItemDetailInput interface {
	pulumi.Input

	ToGetDevicesItemDetailOutput() GetDevicesItemDetailOutput
	ToGetDevicesItemDetailOutputWithContext(context.Context) GetDevicesItemDetailOutput
}

GetDevicesItemDetailInput is an input type that accepts GetDevicesItemDetailArgs and GetDevicesItemDetailOutput values. You can construct a concrete instance of `GetDevicesItemDetailInput` via:

GetDevicesItemDetailArgs{...}

type GetDevicesItemDetailOutput

type GetDevicesItemDetailOutput struct{ *pulumi.OutputState }

func (GetDevicesItemDetailOutput) ElementType

func (GetDevicesItemDetailOutput) ElementType() reflect.Type

func (GetDevicesItemDetailOutput) Name

Additional property name

func (GetDevicesItemDetailOutput) ToGetDevicesItemDetailOutput

func (o GetDevicesItemDetailOutput) ToGetDevicesItemDetailOutput() GetDevicesItemDetailOutput

func (GetDevicesItemDetailOutput) ToGetDevicesItemDetailOutputWithContext

func (o GetDevicesItemDetailOutput) ToGetDevicesItemDetailOutputWithContext(ctx context.Context) GetDevicesItemDetailOutput

func (GetDevicesItemDetailOutput) Value

Additional property value

type GetDevicesItemInput

type GetDevicesItemInput interface {
	pulumi.Input

	ToGetDevicesItemOutput() GetDevicesItemOutput
	ToGetDevicesItemOutputWithContext(context.Context) GetDevicesItemOutput
}

GetDevicesItemInput is an input type that accepts GetDevicesItemArgs and GetDevicesItemOutput values. You can construct a concrete instance of `GetDevicesItemInput` via:

GetDevicesItemArgs{...}

type GetDevicesItemOutput

type GetDevicesItemOutput struct{ *pulumi.OutputState }

func (GetDevicesItemOutput) Address

Physical address of the device

func (GetDevicesItemOutput) Details

Additional device information

func (GetDevicesItemOutput) ElementType

func (GetDevicesItemOutput) ElementType() reflect.Type

func (GetDevicesItemOutput) Firmware

Firmware version of the device

func (GetDevicesItemOutput) Imei

IMEI of the device, if applicable

func (GetDevicesItemOutput) LanIp

LAN IP address of the device

func (GetDevicesItemOutput) Lat

Latitude of the device

func (GetDevicesItemOutput) Lng

Longitude of the device

func (GetDevicesItemOutput) Mac

MAC address of the device

func (GetDevicesItemOutput) Model

Model of the device

func (GetDevicesItemOutput) Name

Name of the device

func (GetDevicesItemOutput) NetworkId

ID of the network the device belongs to

func (GetDevicesItemOutput) Notes

Notes for the device, limited to 255 characters

func (GetDevicesItemOutput) ProductType

func (o GetDevicesItemOutput) ProductType() pulumi.StringOutput

Product type of the device

func (GetDevicesItemOutput) Serial

Serial number of the device

func (GetDevicesItemOutput) Tags

List of tags assigned to the device

func (GetDevicesItemOutput) ToGetDevicesItemOutput

func (o GetDevicesItemOutput) ToGetDevicesItemOutput() GetDevicesItemOutput

func (GetDevicesItemOutput) ToGetDevicesItemOutputWithContext

func (o GetDevicesItemOutput) ToGetDevicesItemOutputWithContext(ctx context.Context) GetDevicesItemOutput

type GetDevicesOutputArgs

type GetDevicesOutputArgs struct {
	// configurationUpdatedAfter query parameter. Filter results by whether or not the device's configuration has been updated after the given timestamp
	ConfigurationUpdatedAfter pulumi.StringPtrInput `pulumi:"configurationUpdatedAfter"`
	// endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	EndingBefore pulumi.StringPtrInput `pulumi:"endingBefore"`
	// mac query parameter. Optional parameter to filter devices by MAC address. All returned devices will have a MAC address that contains the search term or is an exact match.
	Mac pulumi.StringPtrInput `pulumi:"mac"`
	// macs query parameter. Optional parameter to filter devices by one or more MAC addresses. All returned devices will have a MAC address that is an exact match.
	Macs pulumi.StringArrayInput `pulumi:"macs"`
	// model query parameter. Optional parameter to filter devices by model. All returned devices will have a model that contains the search term or is an exact match.
	Model pulumi.StringPtrInput `pulumi:"model"`
	// models query parameter. Optional parameter to filter devices by one or more models. All returned devices will have a model that is an exact match.
	Models pulumi.StringArrayInput `pulumi:"models"`
	// name query parameter. Optional parameter to filter devices by name. All returned devices will have a name that contains the search term or is an exact match.
	Name pulumi.StringPtrInput `pulumi:"name"`
	// networkIds query parameter. Optional parameter to filter devices by network.
	NetworkIds pulumi.StringArrayInput `pulumi:"networkIds"`
	// organizationId path parameter. Organization ID
	OrganizationId pulumi.StringPtrInput `pulumi:"organizationId"`
	// perPage query parameter. The number of entries per page returned. Acceptable range is 3 1000. Default is 1000.
	PerPage pulumi.IntPtrInput `pulumi:"perPage"`
	// productTypes query parameter. Optional parameter to filter devices by product type. Valid types are wireless, appliance, switch, systemsManager, camera, cellularGateway, and sensor.
	ProductTypes pulumi.StringArrayInput `pulumi:"productTypes"`
	// sensorAlertProfileIds query parameter. Optional parameter to filter devices by the alert profiles that are bound to them. Only applies to sensor devices.
	SensorAlertProfileIds pulumi.StringArrayInput `pulumi:"sensorAlertProfileIds"`
	// sensorMetrics query parameter. Optional parameter to filter devices by the metrics that they provide. Only applies to sensor devices.
	SensorMetrics pulumi.StringArrayInput `pulumi:"sensorMetrics"`
	// serial query parameter. Optional parameter to filter devices by serial number. All returned devices will have a serial number that contains the search term or is an exact match.
	Serial pulumi.StringPtrInput `pulumi:"serial"`
	// serials query parameter. Optional parameter to filter devices by one or more serial numbers. All returned devices will have a serial number that is an exact match.
	Serials pulumi.StringArrayInput `pulumi:"serials"`
	// startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	StartingAfter pulumi.StringPtrInput `pulumi:"startingAfter"`
	// tags query parameter. Optional parameter to filter devices by tags.
	Tags pulumi.StringArrayInput `pulumi:"tags"`
	// tagsFilterType query parameter. Optional parameter of value 'withAnyTags' or 'withAllTags' to indicate whether to return networks which contain ANY or ALL of the included tags. If no type is included, 'withAnyTags' will be selected.
	TagsFilterType pulumi.StringPtrInput `pulumi:"tagsFilterType"`
}

A collection of arguments for invoking getDevices.

func (GetDevicesOutputArgs) ElementType

func (GetDevicesOutputArgs) ElementType() reflect.Type

type GetDevicesResult

type GetDevicesResult struct {
	// configurationUpdatedAfter query parameter. Filter results by whether or not the device's configuration has been updated after the given timestamp
	ConfigurationUpdatedAfter *string `pulumi:"configurationUpdatedAfter"`
	// endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	EndingBefore *string `pulumi:"endingBefore"`
	// The provider-assigned unique ID for this managed resource.
	Id   string         `pulumi:"id"`
	Item GetDevicesItem `pulumi:"item"`
	// Array of ResponseOrganizationsGetOrganizationDevices
	Items []GetDevicesItem `pulumi:"items"`
	// mac query parameter. Optional parameter to filter devices by MAC address. All returned devices will have a MAC address that contains the search term or is an exact match.
	Mac *string `pulumi:"mac"`
	// macs query parameter. Optional parameter to filter devices by one or more MAC addresses. All returned devices will have a MAC address that is an exact match.
	Macs []string `pulumi:"macs"`
	// model query parameter. Optional parameter to filter devices by model. All returned devices will have a model that contains the search term or is an exact match.
	Model *string `pulumi:"model"`
	// models query parameter. Optional parameter to filter devices by one or more models. All returned devices will have a model that is an exact match.
	Models []string `pulumi:"models"`
	// name query parameter. Optional parameter to filter devices by name. All returned devices will have a name that contains the search term or is an exact match.
	Name *string `pulumi:"name"`
	// networkIds query parameter. Optional parameter to filter devices by network.
	NetworkIds []string `pulumi:"networkIds"`
	// organizationId path parameter. Organization ID
	OrganizationId *string `pulumi:"organizationId"`
	// perPage query parameter. The number of entries per page returned. Acceptable range is 3 1000. Default is 1000.
	PerPage *int `pulumi:"perPage"`
	// productTypes query parameter. Optional parameter to filter devices by product type. Valid types are wireless, appliance, switch, systemsManager, camera, cellularGateway, and sensor.
	ProductTypes []string `pulumi:"productTypes"`
	// sensorAlertProfileIds query parameter. Optional parameter to filter devices by the alert profiles that are bound to them. Only applies to sensor devices.
	SensorAlertProfileIds []string `pulumi:"sensorAlertProfileIds"`
	// sensorMetrics query parameter. Optional parameter to filter devices by the metrics that they provide. Only applies to sensor devices.
	SensorMetrics []string `pulumi:"sensorMetrics"`
	// serial query parameter. Optional parameter to filter devices by serial number. All returned devices will have a serial number that contains the search term or is an exact match.
	Serial *string `pulumi:"serial"`
	// serials query parameter. Optional parameter to filter devices by one or more serial numbers. All returned devices will have a serial number that is an exact match.
	Serials []string `pulumi:"serials"`
	// startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	StartingAfter *string `pulumi:"startingAfter"`
	// tags query parameter. Optional parameter to filter devices by tags.
	Tags []string `pulumi:"tags"`
	// tagsFilterType query parameter. Optional parameter of value 'withAnyTags' or 'withAllTags' to indicate whether to return networks which contain ANY or ALL of the included tags. If no type is included, 'withAnyTags' will be selected.
	TagsFilterType *string `pulumi:"tagsFilterType"`
}

A collection of values returned by getDevices.

func GetDevices

func GetDevices(ctx *pulumi.Context, args *GetDevicesArgs, opts ...pulumi.InvokeOption) (*GetDevicesResult, error)

## Example Usage

type GetDevicesResultOutput

type GetDevicesResultOutput struct{ *pulumi.OutputState }

A collection of values returned by getDevices.

func (GetDevicesResultOutput) ConfigurationUpdatedAfter

func (o GetDevicesResultOutput) ConfigurationUpdatedAfter() pulumi.StringPtrOutput

configurationUpdatedAfter query parameter. Filter results by whether or not the device's configuration has been updated after the given timestamp

func (GetDevicesResultOutput) ElementType

func (GetDevicesResultOutput) ElementType() reflect.Type

func (GetDevicesResultOutput) EndingBefore

endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.

func (GetDevicesResultOutput) Id

The provider-assigned unique ID for this managed resource.

func (GetDevicesResultOutput) Item

func (GetDevicesResultOutput) Items

Array of ResponseOrganizationsGetOrganizationDevices

func (GetDevicesResultOutput) Mac

mac query parameter. Optional parameter to filter devices by MAC address. All returned devices will have a MAC address that contains the search term or is an exact match.

func (GetDevicesResultOutput) Macs

macs query parameter. Optional parameter to filter devices by one or more MAC addresses. All returned devices will have a MAC address that is an exact match.

func (GetDevicesResultOutput) Model

model query parameter. Optional parameter to filter devices by model. All returned devices will have a model that contains the search term or is an exact match.

func (GetDevicesResultOutput) Models

models query parameter. Optional parameter to filter devices by one or more models. All returned devices will have a model that is an exact match.

func (GetDevicesResultOutput) Name

name query parameter. Optional parameter to filter devices by name. All returned devices will have a name that contains the search term or is an exact match.

func (GetDevicesResultOutput) NetworkIds

networkIds query parameter. Optional parameter to filter devices by network.

func (GetDevicesResultOutput) OrganizationId

func (o GetDevicesResultOutput) OrganizationId() pulumi.StringPtrOutput

organizationId path parameter. Organization ID

func (GetDevicesResultOutput) PerPage

perPage query parameter. The number of entries per page returned. Acceptable range is 3 1000. Default is 1000.

func (GetDevicesResultOutput) ProductTypes

productTypes query parameter. Optional parameter to filter devices by product type. Valid types are wireless, appliance, switch, systemsManager, camera, cellularGateway, and sensor.

func (GetDevicesResultOutput) SensorAlertProfileIds

func (o GetDevicesResultOutput) SensorAlertProfileIds() pulumi.StringArrayOutput

sensorAlertProfileIds query parameter. Optional parameter to filter devices by the alert profiles that are bound to them. Only applies to sensor devices.

func (GetDevicesResultOutput) SensorMetrics

sensorMetrics query parameter. Optional parameter to filter devices by the metrics that they provide. Only applies to sensor devices.

func (GetDevicesResultOutput) Serial

serial query parameter. Optional parameter to filter devices by serial number. All returned devices will have a serial number that contains the search term or is an exact match.

func (GetDevicesResultOutput) Serials

serials query parameter. Optional parameter to filter devices by one or more serial numbers. All returned devices will have a serial number that is an exact match.

func (GetDevicesResultOutput) StartingAfter

func (o GetDevicesResultOutput) StartingAfter() pulumi.StringPtrOutput

startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.

func (GetDevicesResultOutput) Tags

tags query parameter. Optional parameter to filter devices by tags.

func (GetDevicesResultOutput) TagsFilterType

func (o GetDevicesResultOutput) TagsFilterType() pulumi.StringPtrOutput

tagsFilterType query parameter. Optional parameter of value 'withAnyTags' or 'withAllTags' to indicate whether to return networks which contain ANY or ALL of the included tags. If no type is included, 'withAnyTags' will be selected.

func (GetDevicesResultOutput) ToGetDevicesResultOutput

func (o GetDevicesResultOutput) ToGetDevicesResultOutput() GetDevicesResultOutput

func (GetDevicesResultOutput) ToGetDevicesResultOutputWithContext

func (o GetDevicesResultOutput) ToGetDevicesResultOutputWithContext(ctx context.Context) GetDevicesResultOutput

type GetNetworksArgs

type GetNetworksArgs struct {
	// configTemplateId query parameter. An optional parameter that is the ID of a config template. Will return all networks bound to that template.
	ConfigTemplateId *string `pulumi:"configTemplateId"`
	// endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	EndingBefore *string `pulumi:"endingBefore"`
	// isBoundToConfigTemplate query parameter. An optional parameter to filter config template bound networks. If configTemplateId is set, this cannot be false.
	IsBoundToConfigTemplate *bool `pulumi:"isBoundToConfigTemplate"`
	// networkId path parameter. Network ID
	NetworkId *string `pulumi:"networkId"`
	// organizationId path parameter. Organization ID
	OrganizationId *string `pulumi:"organizationId"`
	// perPage query parameter. The number of entries per page returned. Acceptable range is 3 100000. Default is 1000.
	PerPage *int `pulumi:"perPage"`
	// startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	StartingAfter *string `pulumi:"startingAfter"`
	// tags query parameter. An optional parameter to filter networks by tags. The filtering is case-sensitive. If tags are included, 'tagsFilterType' should also be included (see below).
	Tags []string `pulumi:"tags"`
	// tagsFilterType query parameter. An optional parameter of value 'withAnyTags' or 'withAllTags' to indicate whether to return networks which contain ANY or ALL of the included tags. If no type is included, 'withAnyTags' will be selected.
	TagsFilterType *string `pulumi:"tagsFilterType"`
}

A collection of arguments for invoking getNetworks.

type GetNetworksItem

type GetNetworksItem struct {
	// Enrollment string for the network
	EnrollmentString string `pulumi:"enrollmentString"`
	// Network ID
	Id string `pulumi:"id"`
	// If the network is bound to a config template
	IsBoundToConfigTemplate bool `pulumi:"isBoundToConfigTemplate"`
	// Network name
	Name string `pulumi:"name"`
	// Notes for the network
	Notes string `pulumi:"notes"`
	// Organization ID
	OrganizationId string `pulumi:"organizationId"`
	// List of the product types that the network supports
	ProductTypes []string `pulumi:"productTypes"`
	// Network tags
	Tags []string `pulumi:"tags"`
	// Timezone of the network
	TimeZone string `pulumi:"timeZone"`
	// URL to the network Dashboard UI
	Url string `pulumi:"url"`
}

type GetNetworksItemArgs

type GetNetworksItemArgs struct {
	// Enrollment string for the network
	EnrollmentString pulumi.StringInput `pulumi:"enrollmentString"`
	// Network ID
	Id pulumi.StringInput `pulumi:"id"`
	// If the network is bound to a config template
	IsBoundToConfigTemplate pulumi.BoolInput `pulumi:"isBoundToConfigTemplate"`
	// Network name
	Name pulumi.StringInput `pulumi:"name"`
	// Notes for the network
	Notes pulumi.StringInput `pulumi:"notes"`
	// Organization ID
	OrganizationId pulumi.StringInput `pulumi:"organizationId"`
	// List of the product types that the network supports
	ProductTypes pulumi.StringArrayInput `pulumi:"productTypes"`
	// Network tags
	Tags pulumi.StringArrayInput `pulumi:"tags"`
	// Timezone of the network
	TimeZone pulumi.StringInput `pulumi:"timeZone"`
	// URL to the network Dashboard UI
	Url pulumi.StringInput `pulumi:"url"`
}

func (GetNetworksItemArgs) ElementType

func (GetNetworksItemArgs) ElementType() reflect.Type

func (GetNetworksItemArgs) ToGetNetworksItemOutput

func (i GetNetworksItemArgs) ToGetNetworksItemOutput() GetNetworksItemOutput

func (GetNetworksItemArgs) ToGetNetworksItemOutputWithContext

func (i GetNetworksItemArgs) ToGetNetworksItemOutputWithContext(ctx context.Context) GetNetworksItemOutput

type GetNetworksItemArray

type GetNetworksItemArray []GetNetworksItemInput

func (GetNetworksItemArray) ElementType

func (GetNetworksItemArray) ElementType() reflect.Type

func (GetNetworksItemArray) ToGetNetworksItemArrayOutput

func (i GetNetworksItemArray) ToGetNetworksItemArrayOutput() GetNetworksItemArrayOutput

func (GetNetworksItemArray) ToGetNetworksItemArrayOutputWithContext

func (i GetNetworksItemArray) ToGetNetworksItemArrayOutputWithContext(ctx context.Context) GetNetworksItemArrayOutput

type GetNetworksItemArrayInput

type GetNetworksItemArrayInput interface {
	pulumi.Input

	ToGetNetworksItemArrayOutput() GetNetworksItemArrayOutput
	ToGetNetworksItemArrayOutputWithContext(context.Context) GetNetworksItemArrayOutput
}

GetNetworksItemArrayInput is an input type that accepts GetNetworksItemArray and GetNetworksItemArrayOutput values. You can construct a concrete instance of `GetNetworksItemArrayInput` via:

GetNetworksItemArray{ GetNetworksItemArgs{...} }

type GetNetworksItemArrayOutput

type GetNetworksItemArrayOutput struct{ *pulumi.OutputState }

func (GetNetworksItemArrayOutput) ElementType

func (GetNetworksItemArrayOutput) ElementType() reflect.Type

func (GetNetworksItemArrayOutput) Index

func (GetNetworksItemArrayOutput) ToGetNetworksItemArrayOutput

func (o GetNetworksItemArrayOutput) ToGetNetworksItemArrayOutput() GetNetworksItemArrayOutput

func (GetNetworksItemArrayOutput) ToGetNetworksItemArrayOutputWithContext

func (o GetNetworksItemArrayOutput) ToGetNetworksItemArrayOutputWithContext(ctx context.Context) GetNetworksItemArrayOutput

type GetNetworksItemInput

type GetNetworksItemInput interface {
	pulumi.Input

	ToGetNetworksItemOutput() GetNetworksItemOutput
	ToGetNetworksItemOutputWithContext(context.Context) GetNetworksItemOutput
}

GetNetworksItemInput is an input type that accepts GetNetworksItemArgs and GetNetworksItemOutput values. You can construct a concrete instance of `GetNetworksItemInput` via:

GetNetworksItemArgs{...}

type GetNetworksItemOutput

type GetNetworksItemOutput struct{ *pulumi.OutputState }

func (GetNetworksItemOutput) ElementType

func (GetNetworksItemOutput) ElementType() reflect.Type

func (GetNetworksItemOutput) EnrollmentString

func (o GetNetworksItemOutput) EnrollmentString() pulumi.StringOutput

Enrollment string for the network

func (GetNetworksItemOutput) Id

Network ID

func (GetNetworksItemOutput) IsBoundToConfigTemplate

func (o GetNetworksItemOutput) IsBoundToConfigTemplate() pulumi.BoolOutput

If the network is bound to a config template

func (GetNetworksItemOutput) Name

Network name

func (GetNetworksItemOutput) Notes

Notes for the network

func (GetNetworksItemOutput) OrganizationId

func (o GetNetworksItemOutput) OrganizationId() pulumi.StringOutput

Organization ID

func (GetNetworksItemOutput) ProductTypes

List of the product types that the network supports

func (GetNetworksItemOutput) Tags

Network tags

func (GetNetworksItemOutput) TimeZone

Timezone of the network

func (GetNetworksItemOutput) ToGetNetworksItemOutput

func (o GetNetworksItemOutput) ToGetNetworksItemOutput() GetNetworksItemOutput

func (GetNetworksItemOutput) ToGetNetworksItemOutputWithContext

func (o GetNetworksItemOutput) ToGetNetworksItemOutputWithContext(ctx context.Context) GetNetworksItemOutput

func (GetNetworksItemOutput) Url

URL to the network Dashboard UI

type GetNetworksOutputArgs

type GetNetworksOutputArgs struct {
	// configTemplateId query parameter. An optional parameter that is the ID of a config template. Will return all networks bound to that template.
	ConfigTemplateId pulumi.StringPtrInput `pulumi:"configTemplateId"`
	// endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	EndingBefore pulumi.StringPtrInput `pulumi:"endingBefore"`
	// isBoundToConfigTemplate query parameter. An optional parameter to filter config template bound networks. If configTemplateId is set, this cannot be false.
	IsBoundToConfigTemplate pulumi.BoolPtrInput `pulumi:"isBoundToConfigTemplate"`
	// networkId path parameter. Network ID
	NetworkId pulumi.StringPtrInput `pulumi:"networkId"`
	// organizationId path parameter. Organization ID
	OrganizationId pulumi.StringPtrInput `pulumi:"organizationId"`
	// perPage query parameter. The number of entries per page returned. Acceptable range is 3 100000. Default is 1000.
	PerPage pulumi.IntPtrInput `pulumi:"perPage"`
	// startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	StartingAfter pulumi.StringPtrInput `pulumi:"startingAfter"`
	// tags query parameter. An optional parameter to filter networks by tags. The filtering is case-sensitive. If tags are included, 'tagsFilterType' should also be included (see below).
	Tags pulumi.StringArrayInput `pulumi:"tags"`
	// tagsFilterType query parameter. An optional parameter of value 'withAnyTags' or 'withAllTags' to indicate whether to return networks which contain ANY or ALL of the included tags. If no type is included, 'withAnyTags' will be selected.
	TagsFilterType pulumi.StringPtrInput `pulumi:"tagsFilterType"`
}

A collection of arguments for invoking getNetworks.

func (GetNetworksOutputArgs) ElementType

func (GetNetworksOutputArgs) ElementType() reflect.Type

type GetNetworksResult

type GetNetworksResult struct {
	// configTemplateId query parameter. An optional parameter that is the ID of a config template. Will return all networks bound to that template.
	ConfigTemplateId *string `pulumi:"configTemplateId"`
	// endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	EndingBefore *string `pulumi:"endingBefore"`
	// The provider-assigned unique ID for this managed resource.
	Id string `pulumi:"id"`
	// isBoundToConfigTemplate query parameter. An optional parameter to filter config template bound networks. If configTemplateId is set, this cannot be false.
	IsBoundToConfigTemplate *bool           `pulumi:"isBoundToConfigTemplate"`
	Item                    GetNetworksItem `pulumi:"item"`
	// Array of ResponseOrganizationsGetOrganizationNetworks
	Items []GetNetworksItem `pulumi:"items"`
	// networkId path parameter. Network ID
	NetworkId *string `pulumi:"networkId"`
	// organizationId path parameter. Organization ID
	OrganizationId *string `pulumi:"organizationId"`
	// perPage query parameter. The number of entries per page returned. Acceptable range is 3 100000. Default is 1000.
	PerPage *int `pulumi:"perPage"`
	// startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	StartingAfter *string `pulumi:"startingAfter"`
	// tags query parameter. An optional parameter to filter networks by tags. The filtering is case-sensitive. If tags are included, 'tagsFilterType' should also be included (see below).
	Tags []string `pulumi:"tags"`
	// tagsFilterType query parameter. An optional parameter of value 'withAnyTags' or 'withAllTags' to indicate whether to return networks which contain ANY or ALL of the included tags. If no type is included, 'withAnyTags' will be selected.
	TagsFilterType *string `pulumi:"tagsFilterType"`
}

A collection of values returned by getNetworks.

func GetNetworks

func GetNetworks(ctx *pulumi.Context, args *GetNetworksArgs, opts ...pulumi.InvokeOption) (*GetNetworksResult, error)

## Example Usage

type GetNetworksResultOutput

type GetNetworksResultOutput struct{ *pulumi.OutputState }

A collection of values returned by getNetworks.

func (GetNetworksResultOutput) ConfigTemplateId

func (o GetNetworksResultOutput) ConfigTemplateId() pulumi.StringPtrOutput

configTemplateId query parameter. An optional parameter that is the ID of a config template. Will return all networks bound to that template.

func (GetNetworksResultOutput) ElementType

func (GetNetworksResultOutput) ElementType() reflect.Type

func (GetNetworksResultOutput) EndingBefore

endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.

func (GetNetworksResultOutput) Id

The provider-assigned unique ID for this managed resource.

func (GetNetworksResultOutput) IsBoundToConfigTemplate

func (o GetNetworksResultOutput) IsBoundToConfigTemplate() pulumi.BoolPtrOutput

isBoundToConfigTemplate query parameter. An optional parameter to filter config template bound networks. If configTemplateId is set, this cannot be false.

func (GetNetworksResultOutput) Item

func (GetNetworksResultOutput) Items

Array of ResponseOrganizationsGetOrganizationNetworks

func (GetNetworksResultOutput) NetworkId

networkId path parameter. Network ID

func (GetNetworksResultOutput) OrganizationId

func (o GetNetworksResultOutput) OrganizationId() pulumi.StringPtrOutput

organizationId path parameter. Organization ID

func (GetNetworksResultOutput) PerPage

perPage query parameter. The number of entries per page returned. Acceptable range is 3 100000. Default is 1000.

func (GetNetworksResultOutput) StartingAfter

startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.

func (GetNetworksResultOutput) Tags

tags query parameter. An optional parameter to filter networks by tags. The filtering is case-sensitive. If tags are included, 'tagsFilterType' should also be included (see below).

func (GetNetworksResultOutput) TagsFilterType

func (o GetNetworksResultOutput) TagsFilterType() pulumi.StringPtrOutput

tagsFilterType query parameter. An optional parameter of value 'withAnyTags' or 'withAllTags' to indicate whether to return networks which contain ANY or ALL of the included tags. If no type is included, 'withAnyTags' will be selected.

func (GetNetworksResultOutput) ToGetNetworksResultOutput

func (o GetNetworksResultOutput) ToGetNetworksResultOutput() GetNetworksResultOutput

func (GetNetworksResultOutput) ToGetNetworksResultOutputWithContext

func (o GetNetworksResultOutput) ToGetNetworksResultOutputWithContext(ctx context.Context) GetNetworksResultOutput

type GetOrganizationsArgs

type GetOrganizationsArgs struct {
	// endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	EndingBefore *string `pulumi:"endingBefore"`
	// organizationId path parameter. Organization ID
	OrganizationId *string `pulumi:"organizationId"`
	// perPage query parameter. The number of entries per page returned. Acceptable range is 3 9000. Default is 9000.
	PerPage *int `pulumi:"perPage"`
	// startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	StartingAfter *string `pulumi:"startingAfter"`
}

A collection of arguments for invoking getOrganizations.

type GetOrganizationsItem

type GetOrganizationsItem struct {
	// API related settings
	Api GetOrganizationsItemApi `pulumi:"api"`
	// Data for this organization
	Cloud GetOrganizationsItemCloud `pulumi:"cloud"`
	// Organization ID
	Id string `pulumi:"id"`
	// Licensing related settings
	Licensing GetOrganizationsItemLicensing `pulumi:"licensing"`
	// Information about the organization's management system
	Management GetOrganizationsItemManagement `pulumi:"management"`
	// Organization name
	Name string `pulumi:"name"`
	// Organization URL
	Url string `pulumi:"url"`
}

type GetOrganizationsItemApi

type GetOrganizationsItemApi struct {
	// Enable API access
	Enabled bool `pulumi:"enabled"`
}

type GetOrganizationsItemApiArgs

type GetOrganizationsItemApiArgs struct {
	// Enable API access
	Enabled pulumi.BoolInput `pulumi:"enabled"`
}

func (GetOrganizationsItemApiArgs) ElementType

func (GetOrganizationsItemApiArgs) ToGetOrganizationsItemApiOutput

func (i GetOrganizationsItemApiArgs) ToGetOrganizationsItemApiOutput() GetOrganizationsItemApiOutput

func (GetOrganizationsItemApiArgs) ToGetOrganizationsItemApiOutputWithContext

func (i GetOrganizationsItemApiArgs) ToGetOrganizationsItemApiOutputWithContext(ctx context.Context) GetOrganizationsItemApiOutput

type GetOrganizationsItemApiInput

type GetOrganizationsItemApiInput interface {
	pulumi.Input

	ToGetOrganizationsItemApiOutput() GetOrganizationsItemApiOutput
	ToGetOrganizationsItemApiOutputWithContext(context.Context) GetOrganizationsItemApiOutput
}

GetOrganizationsItemApiInput is an input type that accepts GetOrganizationsItemApiArgs and GetOrganizationsItemApiOutput values. You can construct a concrete instance of `GetOrganizationsItemApiInput` via:

GetOrganizationsItemApiArgs{...}

type GetOrganizationsItemApiOutput

type GetOrganizationsItemApiOutput struct{ *pulumi.OutputState }

func (GetOrganizationsItemApiOutput) ElementType

func (GetOrganizationsItemApiOutput) Enabled

Enable API access

func (GetOrganizationsItemApiOutput) ToGetOrganizationsItemApiOutput

func (o GetOrganizationsItemApiOutput) ToGetOrganizationsItemApiOutput() GetOrganizationsItemApiOutput

func (GetOrganizationsItemApiOutput) ToGetOrganizationsItemApiOutputWithContext

func (o GetOrganizationsItemApiOutput) ToGetOrganizationsItemApiOutputWithContext(ctx context.Context) GetOrganizationsItemApiOutput

type GetOrganizationsItemArgs

type GetOrganizationsItemArgs struct {
	// API related settings
	Api GetOrganizationsItemApiInput `pulumi:"api"`
	// Data for this organization
	Cloud GetOrganizationsItemCloudInput `pulumi:"cloud"`
	// Organization ID
	Id pulumi.StringInput `pulumi:"id"`
	// Licensing related settings
	Licensing GetOrganizationsItemLicensingInput `pulumi:"licensing"`
	// Information about the organization's management system
	Management GetOrganizationsItemManagementInput `pulumi:"management"`
	// Organization name
	Name pulumi.StringInput `pulumi:"name"`
	// Organization URL
	Url pulumi.StringInput `pulumi:"url"`
}

func (GetOrganizationsItemArgs) ElementType

func (GetOrganizationsItemArgs) ElementType() reflect.Type

func (GetOrganizationsItemArgs) ToGetOrganizationsItemOutput

func (i GetOrganizationsItemArgs) ToGetOrganizationsItemOutput() GetOrganizationsItemOutput

func (GetOrganizationsItemArgs) ToGetOrganizationsItemOutputWithContext

func (i GetOrganizationsItemArgs) ToGetOrganizationsItemOutputWithContext(ctx context.Context) GetOrganizationsItemOutput

type GetOrganizationsItemArray

type GetOrganizationsItemArray []GetOrganizationsItemInput

func (GetOrganizationsItemArray) ElementType

func (GetOrganizationsItemArray) ElementType() reflect.Type

func (GetOrganizationsItemArray) ToGetOrganizationsItemArrayOutput

func (i GetOrganizationsItemArray) ToGetOrganizationsItemArrayOutput() GetOrganizationsItemArrayOutput

func (GetOrganizationsItemArray) ToGetOrganizationsItemArrayOutputWithContext

func (i GetOrganizationsItemArray) ToGetOrganizationsItemArrayOutputWithContext(ctx context.Context) GetOrganizationsItemArrayOutput

type GetOrganizationsItemArrayInput

type GetOrganizationsItemArrayInput interface {
	pulumi.Input

	ToGetOrganizationsItemArrayOutput() GetOrganizationsItemArrayOutput
	ToGetOrganizationsItemArrayOutputWithContext(context.Context) GetOrganizationsItemArrayOutput
}

GetOrganizationsItemArrayInput is an input type that accepts GetOrganizationsItemArray and GetOrganizationsItemArrayOutput values. You can construct a concrete instance of `GetOrganizationsItemArrayInput` via:

GetOrganizationsItemArray{ GetOrganizationsItemArgs{...} }

type GetOrganizationsItemArrayOutput

type GetOrganizationsItemArrayOutput struct{ *pulumi.OutputState }

func (GetOrganizationsItemArrayOutput) ElementType

func (GetOrganizationsItemArrayOutput) Index

func (GetOrganizationsItemArrayOutput) ToGetOrganizationsItemArrayOutput

func (o GetOrganizationsItemArrayOutput) ToGetOrganizationsItemArrayOutput() GetOrganizationsItemArrayOutput

func (GetOrganizationsItemArrayOutput) ToGetOrganizationsItemArrayOutputWithContext

func (o GetOrganizationsItemArrayOutput) ToGetOrganizationsItemArrayOutputWithContext(ctx context.Context) GetOrganizationsItemArrayOutput

type GetOrganizationsItemCloud

type GetOrganizationsItemCloud struct {
	// Region info
	Region GetOrganizationsItemCloudRegion `pulumi:"region"`
}

type GetOrganizationsItemCloudArgs

type GetOrganizationsItemCloudArgs struct {
	// Region info
	Region GetOrganizationsItemCloudRegionInput `pulumi:"region"`
}

func (GetOrganizationsItemCloudArgs) ElementType

func (GetOrganizationsItemCloudArgs) ToGetOrganizationsItemCloudOutput

func (i GetOrganizationsItemCloudArgs) ToGetOrganizationsItemCloudOutput() GetOrganizationsItemCloudOutput

func (GetOrganizationsItemCloudArgs) ToGetOrganizationsItemCloudOutputWithContext

func (i GetOrganizationsItemCloudArgs) ToGetOrganizationsItemCloudOutputWithContext(ctx context.Context) GetOrganizationsItemCloudOutput

type GetOrganizationsItemCloudInput

type GetOrganizationsItemCloudInput interface {
	pulumi.Input

	ToGetOrganizationsItemCloudOutput() GetOrganizationsItemCloudOutput
	ToGetOrganizationsItemCloudOutputWithContext(context.Context) GetOrganizationsItemCloudOutput
}

GetOrganizationsItemCloudInput is an input type that accepts GetOrganizationsItemCloudArgs and GetOrganizationsItemCloudOutput values. You can construct a concrete instance of `GetOrganizationsItemCloudInput` via:

GetOrganizationsItemCloudArgs{...}

type GetOrganizationsItemCloudOutput

type GetOrganizationsItemCloudOutput struct{ *pulumi.OutputState }

func (GetOrganizationsItemCloudOutput) ElementType

func (GetOrganizationsItemCloudOutput) Region

Region info

func (GetOrganizationsItemCloudOutput) ToGetOrganizationsItemCloudOutput

func (o GetOrganizationsItemCloudOutput) ToGetOrganizationsItemCloudOutput() GetOrganizationsItemCloudOutput

func (GetOrganizationsItemCloudOutput) ToGetOrganizationsItemCloudOutputWithContext

func (o GetOrganizationsItemCloudOutput) ToGetOrganizationsItemCloudOutputWithContext(ctx context.Context) GetOrganizationsItemCloudOutput

type GetOrganizationsItemCloudRegion

type GetOrganizationsItemCloudRegion struct {
	// Name of region
	Name string `pulumi:"name"`
}

type GetOrganizationsItemCloudRegionArgs

type GetOrganizationsItemCloudRegionArgs struct {
	// Name of region
	Name pulumi.StringInput `pulumi:"name"`
}

func (GetOrganizationsItemCloudRegionArgs) ElementType

func (GetOrganizationsItemCloudRegionArgs) ToGetOrganizationsItemCloudRegionOutput

func (i GetOrganizationsItemCloudRegionArgs) ToGetOrganizationsItemCloudRegionOutput() GetOrganizationsItemCloudRegionOutput

func (GetOrganizationsItemCloudRegionArgs) ToGetOrganizationsItemCloudRegionOutputWithContext

func (i GetOrganizationsItemCloudRegionArgs) ToGetOrganizationsItemCloudRegionOutputWithContext(ctx context.Context) GetOrganizationsItemCloudRegionOutput

type GetOrganizationsItemCloudRegionInput

type GetOrganizationsItemCloudRegionInput interface {
	pulumi.Input

	ToGetOrganizationsItemCloudRegionOutput() GetOrganizationsItemCloudRegionOutput
	ToGetOrganizationsItemCloudRegionOutputWithContext(context.Context) GetOrganizationsItemCloudRegionOutput
}

GetOrganizationsItemCloudRegionInput is an input type that accepts GetOrganizationsItemCloudRegionArgs and GetOrganizationsItemCloudRegionOutput values. You can construct a concrete instance of `GetOrganizationsItemCloudRegionInput` via:

GetOrganizationsItemCloudRegionArgs{...}

type GetOrganizationsItemCloudRegionOutput

type GetOrganizationsItemCloudRegionOutput struct{ *pulumi.OutputState }

func (GetOrganizationsItemCloudRegionOutput) ElementType

func (GetOrganizationsItemCloudRegionOutput) Name

Name of region

func (GetOrganizationsItemCloudRegionOutput) ToGetOrganizationsItemCloudRegionOutput

func (o GetOrganizationsItemCloudRegionOutput) ToGetOrganizationsItemCloudRegionOutput() GetOrganizationsItemCloudRegionOutput

func (GetOrganizationsItemCloudRegionOutput) ToGetOrganizationsItemCloudRegionOutputWithContext

func (o GetOrganizationsItemCloudRegionOutput) ToGetOrganizationsItemCloudRegionOutputWithContext(ctx context.Context) GetOrganizationsItemCloudRegionOutput

type GetOrganizationsItemInput

type GetOrganizationsItemInput interface {
	pulumi.Input

	ToGetOrganizationsItemOutput() GetOrganizationsItemOutput
	ToGetOrganizationsItemOutputWithContext(context.Context) GetOrganizationsItemOutput
}

GetOrganizationsItemInput is an input type that accepts GetOrganizationsItemArgs and GetOrganizationsItemOutput values. You can construct a concrete instance of `GetOrganizationsItemInput` via:

GetOrganizationsItemArgs{...}

type GetOrganizationsItemLicensing

type GetOrganizationsItemLicensing struct {
	// Organization licensing model. Can be 'co-term', 'per-device', or 'subscription'.
	Model string `pulumi:"model"`
}

type GetOrganizationsItemLicensingArgs

type GetOrganizationsItemLicensingArgs struct {
	// Organization licensing model. Can be 'co-term', 'per-device', or 'subscription'.
	Model pulumi.StringInput `pulumi:"model"`
}

func (GetOrganizationsItemLicensingArgs) ElementType

func (GetOrganizationsItemLicensingArgs) ToGetOrganizationsItemLicensingOutput

func (i GetOrganizationsItemLicensingArgs) ToGetOrganizationsItemLicensingOutput() GetOrganizationsItemLicensingOutput

func (GetOrganizationsItemLicensingArgs) ToGetOrganizationsItemLicensingOutputWithContext

func (i GetOrganizationsItemLicensingArgs) ToGetOrganizationsItemLicensingOutputWithContext(ctx context.Context) GetOrganizationsItemLicensingOutput

type GetOrganizationsItemLicensingInput

type GetOrganizationsItemLicensingInput interface {
	pulumi.Input

	ToGetOrganizationsItemLicensingOutput() GetOrganizationsItemLicensingOutput
	ToGetOrganizationsItemLicensingOutputWithContext(context.Context) GetOrganizationsItemLicensingOutput
}

GetOrganizationsItemLicensingInput is an input type that accepts GetOrganizationsItemLicensingArgs and GetOrganizationsItemLicensingOutput values. You can construct a concrete instance of `GetOrganizationsItemLicensingInput` via:

GetOrganizationsItemLicensingArgs{...}

type GetOrganizationsItemLicensingOutput

type GetOrganizationsItemLicensingOutput struct{ *pulumi.OutputState }

func (GetOrganizationsItemLicensingOutput) ElementType

func (GetOrganizationsItemLicensingOutput) Model

Organization licensing model. Can be 'co-term', 'per-device', or 'subscription'.

func (GetOrganizationsItemLicensingOutput) ToGetOrganizationsItemLicensingOutput

func (o GetOrganizationsItemLicensingOutput) ToGetOrganizationsItemLicensingOutput() GetOrganizationsItemLicensingOutput

func (GetOrganizationsItemLicensingOutput) ToGetOrganizationsItemLicensingOutputWithContext

func (o GetOrganizationsItemLicensingOutput) ToGetOrganizationsItemLicensingOutputWithContext(ctx context.Context) GetOrganizationsItemLicensingOutput

type GetOrganizationsItemManagement

type GetOrganizationsItemManagement struct {
	// Details related to organization management, possibly empty. Details may be named 'MSP ID', 'IP restriction mode for API', or 'IP restriction mode for dashboard', if the organization admin has configured any.
	Details []GetOrganizationsItemManagementDetail `pulumi:"details"`
}

type GetOrganizationsItemManagementArgs

type GetOrganizationsItemManagementArgs struct {
	// Details related to organization management, possibly empty. Details may be named 'MSP ID', 'IP restriction mode for API', or 'IP restriction mode for dashboard', if the organization admin has configured any.
	Details GetOrganizationsItemManagementDetailArrayInput `pulumi:"details"`
}

func (GetOrganizationsItemManagementArgs) ElementType

func (GetOrganizationsItemManagementArgs) ToGetOrganizationsItemManagementOutput

func (i GetOrganizationsItemManagementArgs) ToGetOrganizationsItemManagementOutput() GetOrganizationsItemManagementOutput

func (GetOrganizationsItemManagementArgs) ToGetOrganizationsItemManagementOutputWithContext

func (i GetOrganizationsItemManagementArgs) ToGetOrganizationsItemManagementOutputWithContext(ctx context.Context) GetOrganizationsItemManagementOutput

type GetOrganizationsItemManagementDetail

type GetOrganizationsItemManagementDetail struct {
	// Name of management data
	Name string `pulumi:"name"`
	// Value of management data
	Value string `pulumi:"value"`
}

type GetOrganizationsItemManagementDetailArgs

type GetOrganizationsItemManagementDetailArgs struct {
	// Name of management data
	Name pulumi.StringInput `pulumi:"name"`
	// Value of management data
	Value pulumi.StringInput `pulumi:"value"`
}

func (GetOrganizationsItemManagementDetailArgs) ElementType

func (GetOrganizationsItemManagementDetailArgs) ToGetOrganizationsItemManagementDetailOutput

func (i GetOrganizationsItemManagementDetailArgs) ToGetOrganizationsItemManagementDetailOutput() GetOrganizationsItemManagementDetailOutput

func (GetOrganizationsItemManagementDetailArgs) ToGetOrganizationsItemManagementDetailOutputWithContext

func (i GetOrganizationsItemManagementDetailArgs) ToGetOrganizationsItemManagementDetailOutputWithContext(ctx context.Context) GetOrganizationsItemManagementDetailOutput

type GetOrganizationsItemManagementDetailArray

type GetOrganizationsItemManagementDetailArray []GetOrganizationsItemManagementDetailInput

func (GetOrganizationsItemManagementDetailArray) ElementType

func (GetOrganizationsItemManagementDetailArray) ToGetOrganizationsItemManagementDetailArrayOutput

func (i GetOrganizationsItemManagementDetailArray) ToGetOrganizationsItemManagementDetailArrayOutput() GetOrganizationsItemManagementDetailArrayOutput

func (GetOrganizationsItemManagementDetailArray) ToGetOrganizationsItemManagementDetailArrayOutputWithContext

func (i GetOrganizationsItemManagementDetailArray) ToGetOrganizationsItemManagementDetailArrayOutputWithContext(ctx context.Context) GetOrganizationsItemManagementDetailArrayOutput

type GetOrganizationsItemManagementDetailArrayInput

type GetOrganizationsItemManagementDetailArrayInput interface {
	pulumi.Input

	ToGetOrganizationsItemManagementDetailArrayOutput() GetOrganizationsItemManagementDetailArrayOutput
	ToGetOrganizationsItemManagementDetailArrayOutputWithContext(context.Context) GetOrganizationsItemManagementDetailArrayOutput
}

GetOrganizationsItemManagementDetailArrayInput is an input type that accepts GetOrganizationsItemManagementDetailArray and GetOrganizationsItemManagementDetailArrayOutput values. You can construct a concrete instance of `GetOrganizationsItemManagementDetailArrayInput` via:

GetOrganizationsItemManagementDetailArray{ GetOrganizationsItemManagementDetailArgs{...} }

type GetOrganizationsItemManagementDetailArrayOutput

type GetOrganizationsItemManagementDetailArrayOutput struct{ *pulumi.OutputState }

func (GetOrganizationsItemManagementDetailArrayOutput) ElementType

func (GetOrganizationsItemManagementDetailArrayOutput) Index

func (GetOrganizationsItemManagementDetailArrayOutput) ToGetOrganizationsItemManagementDetailArrayOutput

func (o GetOrganizationsItemManagementDetailArrayOutput) ToGetOrganizationsItemManagementDetailArrayOutput() GetOrganizationsItemManagementDetailArrayOutput

func (GetOrganizationsItemManagementDetailArrayOutput) ToGetOrganizationsItemManagementDetailArrayOutputWithContext

func (o GetOrganizationsItemManagementDetailArrayOutput) ToGetOrganizationsItemManagementDetailArrayOutputWithContext(ctx context.Context) GetOrganizationsItemManagementDetailArrayOutput

type GetOrganizationsItemManagementDetailInput

type GetOrganizationsItemManagementDetailInput interface {
	pulumi.Input

	ToGetOrganizationsItemManagementDetailOutput() GetOrganizationsItemManagementDetailOutput
	ToGetOrganizationsItemManagementDetailOutputWithContext(context.Context) GetOrganizationsItemManagementDetailOutput
}

GetOrganizationsItemManagementDetailInput is an input type that accepts GetOrganizationsItemManagementDetailArgs and GetOrganizationsItemManagementDetailOutput values. You can construct a concrete instance of `GetOrganizationsItemManagementDetailInput` via:

GetOrganizationsItemManagementDetailArgs{...}

type GetOrganizationsItemManagementDetailOutput

type GetOrganizationsItemManagementDetailOutput struct{ *pulumi.OutputState }

func (GetOrganizationsItemManagementDetailOutput) ElementType

func (GetOrganizationsItemManagementDetailOutput) Name

Name of management data

func (GetOrganizationsItemManagementDetailOutput) ToGetOrganizationsItemManagementDetailOutput

func (o GetOrganizationsItemManagementDetailOutput) ToGetOrganizationsItemManagementDetailOutput() GetOrganizationsItemManagementDetailOutput

func (GetOrganizationsItemManagementDetailOutput) ToGetOrganizationsItemManagementDetailOutputWithContext

func (o GetOrganizationsItemManagementDetailOutput) ToGetOrganizationsItemManagementDetailOutputWithContext(ctx context.Context) GetOrganizationsItemManagementDetailOutput

func (GetOrganizationsItemManagementDetailOutput) Value

Value of management data

type GetOrganizationsItemManagementInput

type GetOrganizationsItemManagementInput interface {
	pulumi.Input

	ToGetOrganizationsItemManagementOutput() GetOrganizationsItemManagementOutput
	ToGetOrganizationsItemManagementOutputWithContext(context.Context) GetOrganizationsItemManagementOutput
}

GetOrganizationsItemManagementInput is an input type that accepts GetOrganizationsItemManagementArgs and GetOrganizationsItemManagementOutput values. You can construct a concrete instance of `GetOrganizationsItemManagementInput` via:

GetOrganizationsItemManagementArgs{...}

type GetOrganizationsItemManagementOutput

type GetOrganizationsItemManagementOutput struct{ *pulumi.OutputState }

func (GetOrganizationsItemManagementOutput) Details

Details related to organization management, possibly empty. Details may be named 'MSP ID', 'IP restriction mode for API', or 'IP restriction mode for dashboard', if the organization admin has configured any.

func (GetOrganizationsItemManagementOutput) ElementType

func (GetOrganizationsItemManagementOutput) ToGetOrganizationsItemManagementOutput

func (o GetOrganizationsItemManagementOutput) ToGetOrganizationsItemManagementOutput() GetOrganizationsItemManagementOutput

func (GetOrganizationsItemManagementOutput) ToGetOrganizationsItemManagementOutputWithContext

func (o GetOrganizationsItemManagementOutput) ToGetOrganizationsItemManagementOutputWithContext(ctx context.Context) GetOrganizationsItemManagementOutput

type GetOrganizationsItemOutput

type GetOrganizationsItemOutput struct{ *pulumi.OutputState }

func (GetOrganizationsItemOutput) Api

API related settings

func (GetOrganizationsItemOutput) Cloud

Data for this organization

func (GetOrganizationsItemOutput) ElementType

func (GetOrganizationsItemOutput) ElementType() reflect.Type

func (GetOrganizationsItemOutput) Id

Organization ID

func (GetOrganizationsItemOutput) Licensing

Licensing related settings

func (GetOrganizationsItemOutput) Management

Information about the organization's management system

func (GetOrganizationsItemOutput) Name

Organization name

func (GetOrganizationsItemOutput) ToGetOrganizationsItemOutput

func (o GetOrganizationsItemOutput) ToGetOrganizationsItemOutput() GetOrganizationsItemOutput

func (GetOrganizationsItemOutput) ToGetOrganizationsItemOutputWithContext

func (o GetOrganizationsItemOutput) ToGetOrganizationsItemOutputWithContext(ctx context.Context) GetOrganizationsItemOutput

func (GetOrganizationsItemOutput) Url

Organization URL

type GetOrganizationsOutputArgs

type GetOrganizationsOutputArgs struct {
	// endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	EndingBefore pulumi.StringPtrInput `pulumi:"endingBefore"`
	// organizationId path parameter. Organization ID
	OrganizationId pulumi.StringPtrInput `pulumi:"organizationId"`
	// perPage query parameter. The number of entries per page returned. Acceptable range is 3 9000. Default is 9000.
	PerPage pulumi.IntPtrInput `pulumi:"perPage"`
	// startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	StartingAfter pulumi.StringPtrInput `pulumi:"startingAfter"`
}

A collection of arguments for invoking getOrganizations.

func (GetOrganizationsOutputArgs) ElementType

func (GetOrganizationsOutputArgs) ElementType() reflect.Type

type GetOrganizationsResult

type GetOrganizationsResult struct {
	// endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	EndingBefore *string `pulumi:"endingBefore"`
	// The provider-assigned unique ID for this managed resource.
	Id   string               `pulumi:"id"`
	Item GetOrganizationsItem `pulumi:"item"`
	// Array of ResponseOrganizationsGetOrganizations
	Items []GetOrganizationsItem `pulumi:"items"`
	// organizationId path parameter. Organization ID
	OrganizationId *string `pulumi:"organizationId"`
	// perPage query parameter. The number of entries per page returned. Acceptable range is 3 9000. Default is 9000.
	PerPage *int `pulumi:"perPage"`
	// startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
	StartingAfter *string `pulumi:"startingAfter"`
}

A collection of values returned by getOrganizations.

func GetOrganizations

func GetOrganizations(ctx *pulumi.Context, args *GetOrganizationsArgs, opts ...pulumi.InvokeOption) (*GetOrganizationsResult, error)

## Example Usage

type GetOrganizationsResultOutput

type GetOrganizationsResultOutput struct{ *pulumi.OutputState }

A collection of values returned by getOrganizations.

func (GetOrganizationsResultOutput) ElementType

func (GetOrganizationsResultOutput) EndingBefore

endingBefore query parameter. A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.

func (GetOrganizationsResultOutput) Id

The provider-assigned unique ID for this managed resource.

func (GetOrganizationsResultOutput) Item

func (GetOrganizationsResultOutput) Items

Array of ResponseOrganizationsGetOrganizations

func (GetOrganizationsResultOutput) OrganizationId

organizationId path parameter. Organization ID

func (GetOrganizationsResultOutput) PerPage

perPage query parameter. The number of entries per page returned. Acceptable range is 3 9000. Default is 9000.

func (GetOrganizationsResultOutput) StartingAfter

startingAfter query parameter. A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.

func (GetOrganizationsResultOutput) ToGetOrganizationsResultOutput

func (o GetOrganizationsResultOutput) ToGetOrganizationsResultOutput() GetOrganizationsResultOutput

func (GetOrganizationsResultOutput) ToGetOrganizationsResultOutputWithContext

func (o GetOrganizationsResultOutput) ToGetOrganizationsResultOutputWithContext(ctx context.Context) GetOrganizationsResultOutput

type Provider

type Provider struct {
	pulumi.ProviderResourceState

	// Cisco Meraki base URL, FQDN or IP. If not set, it uses the MERAKI_BASE_URL environment variable. Default is
	// (https://api.meraki.com/)
	MerakiBaseUrl pulumi.StringPtrOutput `pulumi:"merakiBaseUrl"`
	// Cisco Meraki merakiDashboardApiKey to authenticate. If not set, it uses the MERAKI_DASHBOARD_API_KEY environment
	// variable.
	MerakiDashboardApiKey pulumi.StringPtrOutput `pulumi:"merakiDashboardApiKey"`
	// Flag for Cisco Meraki to enable debugging. If not set, it uses the MERAKI_DEBUG environment variable defaults to
	// `false`.
	MerakiDebug pulumi.StringPtrOutput `pulumi:"merakiDebug"`
}

The provider type for the meraki package. By default, resources use package-wide configuration settings, however an explicit `Provider` instance may be created and passed during resource construction to achieve fine-grained programmatic control over provider settings. See the [documentation](https://www.pulumi.com/docs/reference/programming-model/#providers) for more information.

func NewProvider

func NewProvider(ctx *pulumi.Context,
	name string, args *ProviderArgs, opts ...pulumi.ResourceOption) (*Provider, error)

NewProvider registers a new resource with the given unique name, arguments, and options.

func (*Provider) ElementType

func (*Provider) ElementType() reflect.Type

func (*Provider) ToProviderOutput

func (i *Provider) ToProviderOutput() ProviderOutput

func (*Provider) ToProviderOutputWithContext

func (i *Provider) ToProviderOutputWithContext(ctx context.Context) ProviderOutput

type ProviderArgs

type ProviderArgs struct {
	// Cisco Meraki base URL, FQDN or IP. If not set, it uses the MERAKI_BASE_URL environment variable. Default is
	// (https://api.meraki.com/)
	MerakiBaseUrl pulumi.StringPtrInput
	// Cisco Meraki merakiDashboardApiKey to authenticate. If not set, it uses the MERAKI_DASHBOARD_API_KEY environment
	// variable.
	MerakiDashboardApiKey pulumi.StringPtrInput
	// Flag for Cisco Meraki to enable debugging. If not set, it uses the MERAKI_DEBUG environment variable defaults to
	// `false`.
	MerakiDebug pulumi.StringPtrInput
	// Flag requests per second allowed for client. Default is (10)
	MerakiRequestsPerSecond pulumi.IntPtrInput
}

The set of arguments for constructing a Provider resource.

func (ProviderArgs) ElementType

func (ProviderArgs) ElementType() reflect.Type

type ProviderInput

type ProviderInput interface {
	pulumi.Input

	ToProviderOutput() ProviderOutput
	ToProviderOutputWithContext(ctx context.Context) ProviderOutput
}

type ProviderOutput

type ProviderOutput struct{ *pulumi.OutputState }

func (ProviderOutput) ElementType

func (ProviderOutput) ElementType() reflect.Type

func (ProviderOutput) MerakiBaseUrl

func (o ProviderOutput) MerakiBaseUrl() pulumi.StringPtrOutput

Cisco Meraki base URL, FQDN or IP. If not set, it uses the MERAKI_BASE_URL environment variable. Default is (https://api.meraki.com/)

func (ProviderOutput) MerakiDashboardApiKey

func (o ProviderOutput) MerakiDashboardApiKey() pulumi.StringPtrOutput

Cisco Meraki merakiDashboardApiKey to authenticate. If not set, it uses the MERAKI_DASHBOARD_API_KEY environment variable.

func (ProviderOutput) MerakiDebug

func (o ProviderOutput) MerakiDebug() pulumi.StringPtrOutput

Flag for Cisco Meraki to enable debugging. If not set, it uses the MERAKI_DEBUG environment variable defaults to `false`.

func (ProviderOutput) ToProviderOutput

func (o ProviderOutput) ToProviderOutput() ProviderOutput

func (ProviderOutput) ToProviderOutputWithContext

func (o ProviderOutput) ToProviderOutputWithContext(ctx context.Context) ProviderOutput

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL